用ESP32和MicroPython做个蓝牙MIDI键盘，连接手机就能弹（附完整代码）

用ESP32打造你的专属蓝牙MIDI键盘从零到演奏的全流程指南在创客圈里音乐与硬件的结合总能碰撞出令人兴奋的火花。想象一下用自己亲手制作的设备控制手机上的钢琴应用无论是即兴创作还是学习演奏都变得触手可及。ESP32开发板凭借其出色的蓝牙功能和MicroPython的易用性成为了实现这一想法的完美选择。本文将带你一步步完成从硬件组装到软件编程的全过程最终打造出一个完全由你掌控的蓝牙MIDI控制器。1. 项目准备与硬件搭建1.1 所需材料清单要开始这个项目你需要准备以下基础组件ESP32开发板推荐ESP32-WROOM-32D性价比高且兼容性好微动按钮6-12个数量取决于你想制作的琴键规模面包板和跳线用于原型搭建USB数据线用于供电和编程电阻10kΩ用于按键下拉如果想让你的MIDI键盘更专业还可以考虑3D打印或激光切割的外壳带有力度感应的压力传感器替代普通按钮旋钮编码器用于控制音量、音效等参数1.2 硬件连接示意图将按钮按照钢琴键盘的布局连接到ESP32的GPIO引脚。每个按钮需要连接一端接GPIO引脚另一端接GND通过下拉电阻典型的连接方式如下表示例按钮编号ESP32 GPIO引脚对应MIDI音符按钮1GPIO13C4 (60)按钮2GPIO12D4 (62)按钮3GPIO14E4 (64)按钮4GPIO27F4 (65)按钮5GPIO26G4 (67)提示实际连接时建议使用不同颜色的跳线区分各个按钮方便后续调试。2. MicroPython环境配置2.1 固件烧录步骤下载最新的MicroPython固件支持BLE的版本wget https://micropython.org/resources/firmware/esp32-ble-20220618-v1.19.1.bin使用esptool.py工具刷写固件esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x1000 esp32-ble-20220618-v1.19.1.bin验证安装import ubluetooth ble ubluetooth.BLE() ble.active(True) print(BLE初始化成功!)2.2 必要库安装通过MicroPython的包管理工具upip安装依赖import upip upip.install(micropython-ubluetooth)3. 蓝牙MIDI核心代码实现3.1 BLE服务配置蓝牙MIDI设备需要特定的UUID和服务配置才能被手机识别。以下是关键部分的实现import ubluetooth from machine import Pin import time # BLE初始化 ble ubluetooth.BLE() ble.active(True) # MIDI服务UUID定义 MIDI_SERVICE_UUID ubluetooth.UUID(03B80E5A-EDE8-4B33-A751-6CE34EC4C700) MIDI_CHAR_UUID ubluetooth.UUID(7772E5DB-3868-4112-A1A9-F2669D106BF3) # 特性配置 midi_char ( MIDI_CHAR_UUID, ubluetooth.FLAG_READ | ubluetooth.FLAG_WRITE | ubluetooth.FLAG_NOTIFY, ) # 服务定义 midi_service ( MIDI_SERVICE_UUID, (midi_char,), ) services (midi_service,) ((char_midi,),) ble.gatts_register_services(services)3.2 广播数据设置正确的广播数据是设备被识别为MIDI控制器的关键# 广播数据组成 adv_data ( b\x02\x01\x05 # Flags b\x11\x07 # 128-bit UUID列表 bytes(reversed(bytes.fromhex(03B80E5AEDE84B33A7516CE34EC4C700))) b\x05\x09MIDI # 设备名称 ) ble.gap_advertise(100, adv_dataadv_data)3.3 按键处理与MIDI消息发送每个按钮按下/释放时都需要发送对应的MIDI消息# 定义按键与音符映射 notes { 13: 60, # C4 12: 62, # D4 14: 64, # E4 27: 65, # F4 26: 67, # G4 } # 初始化所有按键 buttons {pin: Pin(pin, Pin.IN, Pin.PULL_UP) for pin in notes.keys()} last_states {pin: buttons[pin].value() for pin in notes.keys()} while True: for pin in buttons: current_state buttons[pin].value() if current_state ! last_states[pin]: last_states[pin] current_state note notes[pin] if current_state 0: # 按下 msg bytes([0x80, 0x80, 0x90, note, 0x64]) # 力度100 else: # 释放 msg bytes([0x80, 0x80, 0x80, note, 0x00]) ble.gatts_notify(0, char_midi, msg) time.sleep_ms(10)4. 手机端连接与调试技巧4.1 推荐应用列表不同平台的优质MIDI应用推荐应用名称平台特色功能价格泡泡钢琴Android丰富的音色库学习模式免费内购GarageBandiOS专业级录音和编辑功能免费MIDI Tool跨平台MIDI信号监控与调试付费4.2 连接问题排查当设备无法被识别时可以按照以下步骤检查确认广播数据正确使用nRF Connect等BLE调试工具检查广播包验证是否包含完整的MIDI服务UUID检查服务配置print(服务UUID:, ble.gatts_services()) print(特性列表:, ble.gatts_characteristics(char_midi))手机端权限设置确保应用有蓝牙权限部分国产手机需要手动开启定位权限才能使用BLE信号干扰问题尝试远离WiFi路由器等2.4GHz设备修改广播间隔上述代码中的100参数4.3 性能优化建议降低功耗在不使用时进入深度睡眠模式import machine machine.deepsleep(10000) # 10秒后唤醒消抖处理避免按键抖动导致重复消息from machine import Timer def debounce(pin): tim Timer(-1) tim.init(modeTimer.ONE_SHOT, period50, callbacklambda t: check_pin(pin)) def check_pin(pin): state buttons[pin].value() # 处理状态变化...多按键支持使用中断代替轮询for pin in buttons: buttons[pin].irq(triggerPin.IRQ_FALLING | Pin.IRQ_RISING, handlerdebounce)5. 项目扩展与进阶玩法基础版本完成后你可以考虑以下增强功能力度敏感键盘使用FSR压力传感器替代普通按钮根据按压力度动态调整MIDI速度值控制面板增强添加旋钮控制弯音轮和调制轮OLED屏幕显示当前音色和设置# 示例旋钮控制弯音轮 from machine import ADC pitch_bend ADC(Pin(34)) pitch_bend.atten(ADC.ATTN_11DB) while True: value pitch_bend.read() bend_value int((value / 4095) * 16383) msg bytes([0x80, 0x80, 0xE0, bend_value 0x7F, (bend_value 7) 0x7F]) ble.gatts_notify(0, char_midi, msg) time.sleep_ms(20)无线MIDI桥接通过WiFi将蓝牙MIDI信号转发至电脑DAW实现跨设备的MIDI信号路由外壳设计与人体工学3D打印符合手掌弧度的外壳添加硅胶按键提升触感RGB LED背光指示按键状态在实际项目中我发现最影响用户体验的往往是按键的触感和响应速度。经过几次迭代后采用机械键盘的轴体配合自定义的消抖算法可以大幅提升演奏的跟手度。另外合理布局GPIO引脚可以减少飞线数量使内部结构更整洁。