【低功耗蓝牙】④ 蓝牙MIDI协议：从ESP32 MicroPython代码到智能乐器DIY

1. 蓝牙MIDI协议入门：从音乐小白到智能乐器开发者

第一次听说蓝牙MIDI协议时，我正盯着桌上的ESP32开发板发呆。作为一个只会弹几个和弦的编程爱好者，完全没想到自己能用代码"演奏"音乐。蓝牙MIDI就像音乐世界的通用语言，它不传输实际的声音波形，而是记录"按下C键、力度80"这样的动作指令。这让我想起小时候玩的电子琴，连接电脑后就能变成音乐制作工具——只不过现在连数据线都不需要了。

传统MIDI设备需要专门的5针DIN接口，就像老式键盘的PS/2接口一样麻烦。2014年苹果公司把MIDI搬到了蓝牙上，从此音乐创作变得像配对手环一样简单。我实测用ESP32开发的MIDI控制器，从开机到被手机识别平均只要3秒，比很多专业音频设备的握手时间还快。对于想DIY智能乐器的开发者，最棒的是MIDI协议的数据格式极其精简，一个音符事件只需要5个字节，这让资源有限的单片机也能流畅处理。

2. 硬件准备与开发环境搭建

2.1 ESP32开发板选型指南

手头这块ESP32-WROOM-32D开发板是我在电商平台花39元买的，带蓝牙4.2协议栈完全够用。如果追求更低功耗，可以选用ESP32-S3系列，但要注意某些型号的GPIO数量会减少。有次贪便宜买了山寨板，结果蓝牙信号隔堵墙就断连，后来换了安信可的官方模组再没出过问题。除了开发板，你还需要：

• 若干轻触开关（我用的是6x6mm贴片式）
• 1KΩ电阻（防抖用）
• 面包板和杜邦线（原型阶段必备）
• 可选：电位器（做弯音轮用）

2.2 MicroPython环境配置

推荐使用Thonny IDE，它的文件管理和REPL交互特别适合MicroPython开发。刷固件时有个坑要注意：必须选择带BLE支持的版本，我用的v1.20.0固件直接从MicroPython官网下载。首次运行记得初始化flash存储：

import uos uos.mkfs('/flash') # 格式化内部存储

蓝牙相关库ubluetooth是内置的，但需要手动启用：

import ubluetooth ble = ubluetooth.BLE() ble.active(True) # 这个操作会消耗约80KB内存

3. 蓝牙MIDI协议深度解析

3.1 协议栈解剖图

蓝牙MIDI实际上是在GATT层包装的传统MIDI数据。就像用快递盒寄送CD光盘，外包装是蓝牙标准（快递盒），内容物仍是MIDI指令（CD）。关键是要在广播包里声明两个魔法数字：

• 服务UUID：03B80E5A-EDE8-4B33-A751-6CE34EC4C700
• 特征UUID：7772E5DB-3868-4112-A1A9-F2669D106BF3

我在代码里把它们定义成常量：

MIDI_SERVER_UUID = ubluetooth.UUID('03B80E5A-EDE8-4B33-A751-6CE34EC4C700') MIDI_CHAR_UUID = ubluetooth.UUID('7772E5DB-3868-4112-A1A9-F2669D106BF3')

3.2 MIDI指令的二进制艺术

一个完整的Note On指令如80 80 90 3C 64可以拆解为：

• 前导码：0x80 0x80（时间戳占位符）
• 状态字：0x90（9表示通道1，0表示Note On）
• 音符编号：0x3C（中央C音）
• 力度值：0x64（100力度值）

钢琴键盘与MIDI编号的对应关系很有意思：每个半音对应一个数字，中央C是60，每升高八度加12。我整理了这个速查表：

4. 多按键控制器实战开发

4.1 GPIO扩展方案

用74HC165移位寄存器可以只用3个GPIO控制8个按键，特别适合需要多个琴键的场景。我的接线方案是：

• 时钟引脚接GPIO18
• 数据引脚接GPIO23
• 锁存引脚接GPIO5

读取按键状态的代码片段：

def read_keys(): latch.value(0) latch.value(1) return [data.value() for _ in range(8)]

4.2 音符映射与和弦触发

通过字典实现按键自定义映射：

key_mapping = { 0: 60, # 按键0对应中央C 1: 62, # D音 2: 64, # E音 3: 65 # F音 }

实现三和弦触发的小技巧：

def send_chord(root_note, chord_type): notes = { 'major': [0, 4, 7], 'minor': [0, 3, 7] } for offset in notes[chord_type]: send_midi_note(root_note + offset, velocity=100)

5. 手机端联调技巧

5.1 常见配对问题排查

遇到手机搜不到设备时，先检查广播数据格式：

adv_data = ( b'\x02\x01\x05' # 标准广播头 b'\x11\x07\x00\xC7\xC4\x4E\xE3\x6C\x51\xA7\x33\x4B\xE8\xEd\x5A\x0E\xB8\x03' # 128位UUID b'\x05\x09\x4D\x49\x44\x49' # 设备名"MIDI" )

5.2 主流音乐APP实测

在安卓上调试泡泡钢琴时发现一个坑：APP会缓存设备列表，修改设备名后需要重启手机蓝牙。iOS的库乐队相对稳定，但要注意首次连接需要授权MIDI访问权限。测试过的APP延迟对比：

6. 进阶改造思路

给控制器加上陀螺仪模块（如MPU6050），就能实现摇杆效果。我通过加速度计Z轴数据控制弯音轮：

pitch_bend = int((accel_z + 1) * 8192) # 映射到0-16383范围 msg = bytes([0x80, 0x80, 0xE0, pitch_bend & 0x7F, (pitch_bend >> 7) & 0x7F])

电位器实现音量调节更简单：

volume = int(pot.read() / 4095 * 127) ble.gatts_notify(0, char_midi, bytes([0x80, 0x80, 0xB0, 0x07, volume]))

7. 项目优化与调试

当按键数量增加到8个以上时，会出现明显的"鬼键"问题。我的解决方案是：

1. 在每个按键上并联104电容
2. 软件防抖采用状态机机制：

class Debouncer: def __init__(self, pin): self.state = 0 self.pin = pin def update(self): self.state = (self.state << 1) | self.pin.value() return self.state == 0x7F # 连续7次低电平才判定为按下

功耗优化方面，把广播间隔从100ms调整到500ms后，整体电流从18mA降到了5mA。如果使用ESP32的深度睡眠模式，配合外部中断唤醒，待机电流可以控制在0.5mA以下。