树莓派CircuitPython环境下usb_midi模块导入失败求助

问题背景 #

在树莓派上完成CircuitPython安装后，可正常导入board、digitalio及adafruit_midi模块，但导入usb_midi时抛出如下错误：

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'usb_midi'

解决方案 #

1. 确认CircuitPython版本兼容性 #

usb_midi模块在较旧的CircuitPython版本中可能未内置，先检查当前版本：

import sys
print(sys.version)

建议使用CircuitPython 7.0及以上版本，若版本过低，重新安装对应版本的CircuitPython即可。

2. 通过Circup安装USB MIDI库 #

usb_midi属于Adafruit独立维护的库，需用Circup包管理器安装：

• 先安装Circup工具：

  pip3 install circup
  

• 连接树莓派的CircuitPython设备后，执行安装命令：

  circup install adafruit-usb-midi
  

3. 启用USB MIDI功能 #

安装完成后，需在boot.py中启用USB MIDI设备支持，示例代码：

import usb_midi

# 启用USB MIDI功能
usb_midi.enable()

保存boot.py后重启CircuitPython设备，再尝试导入模块。

4. 验证导入效果 #

重新进入CircuitPython REPL，执行：

import usb_midi

若无报错，说明模块已成功导入。

内容的提问来源于stack exchange，提问作者Ryan LeRoy