Arduino BLE-MIDI 传输库
Arduino-BLE-MIDI
项目简介
Arduino的BLE-MIDI 1.0，通过蓝牙低功耗传输MIDI。
Arduino BLE-MIDI 是一个专为 Arduino 平台设计的蓝牙低功耗 MIDI 传输层开源库。它作为 FortySevenEffects Arduino MIDI 库的扩展，解决了传统有线 MIDI 连接在物理空间和布线上的限制，让 Arduino 设备能够通过 BLE 无线方式与手机、平板、电脑或其他 BLE-MIDI 设备进行 MIDI 通信。核心功能是提供一个简洁的 API，开发者只需包含头文件并调用 `BLEMIDI_CREATE_DEFAULT_INSTANCE()` 或 `BLEMIDI_CREATE_INSTANCE("自定义名称", MIDI)` 即可快速创建 BLE-MIDI 实例，随后通过标准的 `MIDI.begin()`、`MIDI.read()` 等函数收发 MIDI 消息，几乎无需学习额外协议。技术栈上，该库基于 Arduino MIDI Library 构建，支持多种硬件平台，包括 ESP32（可使用原生 BLE 或更高效的 NimBLE 协议栈）、Arduino NANO 33 BLE 和 Arduino NANO RP2040 Connect。它还提供了连接状态回调功能，例如在连接时点亮 LED 灯，方便用户进行状态指示。该库的适用场景非常广泛，包括无线音乐控制器、可穿戴 MIDI 乐器、智能家居音乐交互装置、教育用电子乐器原型等。对于 ESP32 用户，推荐使用 NimBLE 以获得更好的性能和内存管理；对于 Arduino NANO 系列，则需安装 ArduinoBLE 库。此外，该库与作者提供的 AppleMIDI、USB-MIDI、ipMIDI 等传输层共享相同的 API 设计，开发者可以轻松切换不同的通信方式而无需修改业务逻辑。
标签
项目特点
技术规格
| 协议 | BLE-MIDI 1.0 |
|---|---|
| 依赖库 | FortySevenEffects Arduino MIDI Library |
| 支持平台 | ESP32 (OOB BLE & NimBLE), Arduino NANO 33 BLE, Arduino NANO RP2040 Connect |
| 可选依赖 | NimBLE-Arduino (ESP32), ArduinoBLE (NANO 33 BLE / RP2040 Connect) |
| API 风格 | 与 AppleMIDI、USB-MIDI、ipMIDI 传输层一致 |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| ESP32 开发板 | 1 | — | 或 Arduino NANO 33 BLE / RP2040 Connect |
| Arduino IDE | 1 | — | 用于编程 |
| Arduino MIDI Library | 1 | — | 必需依赖 |
| NimBLE-Arduino (可选) | 1 | — | ESP32 使用 NimBLE 时需安装 |
| ArduinoBLE (可选) | 1 | — | NANO 33 BLE / RP2040 Connect 需安装 |