用ESP32做个蓝牙MIDI键盘，手把手教你连接手机库乐队弹奏（附完整代码）

用ESP32打造蓝牙MIDI键盘：从硬件搭建到库乐队演奏全指南

在创客圈里，音乐与硬件的结合总能碰撞出令人兴奋的火花。想象一下，用自己亲手制作的蓝牙MIDI键盘，随时随地连接手机库乐队进行创作——这不仅是电子爱好者的乐趣，更是音乐技术入门的最佳实践项目。ESP32作为一款兼具性价比与强大功能的微控制器，其内置的蓝牙功能为DIY MIDI设备提供了绝佳的平台。本文将带你从零开始，完成硬件选型、电路搭建、代码编写到最终的音乐演奏全流程。

1. 项目准备与硬件选型

1.1 核心组件清单

制作蓝牙MIDI键盘需要以下核心部件：

• ESP32开发板：推荐使用ESP32-WROOM-32D，其蓝牙4.2支持足以满足MIDI传输需求
• 机械键盘矩阵：可采用8x8矩阵布局的机械轴开关（青轴或红轴手感较佳）
• 电阻与二极管：1N4148二极管用于防鬼影，10kΩ电阻用于上拉
• 连接线材：杜邦线、排针等基础连接件
• 电源模块：建议使用18650锂电池配合TP4056充电模块

提示：若追求便携性，可选用ESP32-S2 Mini等紧凑型开发板，但需确认蓝牙功能支持

1.2 硬件连接原理

键盘矩阵的连接需要遵循以下原则：

# 伪代码表示矩阵扫描原理 for row in rows: set_row_low(row) for col in cols: if read_column(col) == LOW: register_key_press(row, col) set_row_high(row)

对应的物理连接方式如下表所示：

2. 蓝牙MIDI服务配置

2.1 BLE MIDI协议核心参数

蓝牙MIDI需要严格遵循苹果制定的服务规范：

// BLE MIDI服务UUID定义 #define MIDI_SERVICE_UUID "03B80E5A-EDE8-4B33-A751-6CE34EC4C700" #define MIDI_CHARACTERISTIC_UUID "7772E5DB-3868-4112-A1A9-F2669D106BF3"

特性属性必须包含以下三项：

• Read：允许读取MIDI状态
• Write：支持写入控制命令
• Notify：启用MIDI事件通知

2.2 ESP32蓝牙初始化代码

以下是使用Arduino框架的典型配置代码：

#include <BLEDevice.h> #include <BLEUtils.h> #include <BLEServer.h> BLEServer *pServer; BLEService *pService; BLECharacteristic *pCharacteristic; void setupBLE() { BLEDevice::init("ESP32-MIDI"); pServer = BLEDevice::createServer(); pService = pServer->createService(MIDI_SERVICE_UUID); pCharacteristic = pService->createCharacteristic( MIDI_CHARACTERISTIC_UUID, BLECharacteristic::PROPERTY_READ | BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_NOTIFY ); pService->start(); BLEAdvertising *pAdvertising = pServer->getAdvertising(); pAdvertising->start(); }

3. MIDI消息处理与键盘映射

3.1 MIDI消息结构解析

标准MIDI消息由以下部分组成：

3.2 键盘扫描与MIDI转换

实现键盘扫描的核心逻辑：

void scanKeys() { for(int row=0; row<ROW_COUNT; row++) { digitalWrite(rows[row], LOW); for(int col=0; col<COL_COUNT; col++) { if(digitalRead(cols[col]) == LOW) { uint8_t midiNote = keyMap[row][col]; sendMidiNoteOn(midiNote, 127); } } digitalWrite(rows[row], HIGH); delayMicroseconds(100); // 防抖延迟 } }

对应的键盘映射表示例：

4. 库乐队连接与演奏优化

4.1 iOS设备配对流程

1. 打开ESP32电源，等待蓝牙广播
2. 进入iOS设置 → 蓝牙，找到"ESP32-MIDI"设备
3. 打开库乐队，创建新项目
4. 在音轨设置中选择"外部MIDI"作为输入源

4.2 常见问题排查

• 连接不稳定：检查ESP32供电是否充足，建议使用稳压电源
• 音符延迟：优化蓝牙广播间隔，调整为20-50ms
• 按键无响应：用逻辑分析仪检查矩阵扫描时序

注意：库乐队对MIDI通道1有特殊优化，建议将默认通道设置为1

4.3 进阶功能扩展

可通过以下方式增强MIDI键盘功能：

• 添加电位器作为弯音轮或调制轮
• 实现力度敏感按键（需使用压力传感器）
• 增加OLED显示屏显示当前音高和状态

// 弯音轮示例代码 void readPitchBend() { int bendValue = analogRead(POT_PIN); uint8_t midiMsg[3] = {0xE0, bendValue & 0x7F, (bendValue >> 7) & 0x7F}; pCharacteristic->setValue(midiMsg, 3); pCharacteristic->notify(); }

在完成所有硬件组装和代码烧录后，建议先用MIDI监控软件测试信号输出是否正常。实际演奏时，库乐队的智能乐器功能会自动匹配最适合的音色，从钢琴到电子合成器都能完美响应。我在多次迭代中发现，将机械轴换成静音红轴能显著提升演奏体验，特别是在夜间练习时。