简介Drumidy 是一套基于 STM32 NucleoG431 核板的 MIDI 鼓模块完整工程源码以 C/C 代码为核心主要面向嵌入式开发者、电子音乐 DIY 爱好者和单片机课程设计学习者可实现 18 路鼓垫输入并通过 USB 输出标准 MIDI 信号。整套资源以 zip 压缩包提供共 132 个文件、约 1.2MB核心为 38 个 .c 源文件与 67 个 .h 头文件另含 CubeIDE 工程配置.ioc、.cproject、.launch、编译脚本makefile、.mk、.ld以及可直接烧录的 .bin 固件等文件结构清晰便于按模块查阅。已有 196 人浏览学习适合希望参考完整项目布局、底层驱动写法和 USB-MIDI 协议栈的读者。代码使用 CubeIDE v1.6.0 编写详细展示了 USB-MIDI 设备枚举、HAL/LL 库下定时器、ADC、UART 等外设的初始化与回调处理固件将 PA11/PA12 配置为 USB 数据线板载 USB 用作配置调试接口向核板发送任意字符即可进入配置例程。同时工程说明了为启用全部 18 路输入所需的跳线修改移除 SB2/SB3、添加 SB8/SB11并附带 .md 说明和链接、启动文件方便快速理解并移植到其他 STM32G4 系列板卡。 最近在折腾一个挺有意思的东西——Drumidy基于STM32 Nucleo的MIDI鼓模块。简单说就是把几个鼓垫PAD接在Nucleo板上用鼓棒击打单片机能检测到击打的力度和时机然后转换成标准MIDI信号发给电脑里的软音源或者直接连硬件音源立刻就能听到架子鼓的声音。如果你一直想练鼓但怕扰民或者觉得电子鼓价格劝退又或者本身就是搞嵌入式想过把音乐和硬件结合起来的瘾这个项目都值得研究一下。整个项目涉及到的技术栈也比较典型GPIO、ADC、DMA、USB设备类、MIDI协议外加一点信号调理电路的知识全部跑通之后收获会非常大。1. 项目整体设计与思路拆解1.1 为什么做这个项目传统架子鼓体积大、噪音大像我这种住在小区的练鼓基本等于扰民。电子鼓虽然能解决音量问题但一套入门级的也要一千多临时用来练习多少有点肉疼。其实换个思路电子鼓的核心就是“鼓垫触发信号 音源模块”而音源模块完全可以用电脑上的软音源代替。只要我做一个能把鼓垫触发转换为MIDI消息的硬件模块再通过USB插到电脑上用DAW加载一套鼓音源就组成了一套低成本的电子鼓。这个方案的好处是省钱、便携而且所有软音源都可以换鼓皮手感也能自己微调。更关键的是作为单片机玩家这种项目可以把“模拟信号采集”和“数字协议通信”这两块知识串起来非常锻炼人。1.2 为什么选STM32 Nucleo而不是Arduino一开始我也考虑过Arduino Mega毕竟网上资料多很多人做过USB MIDI鼓。但对比下来STM32 Nucleo的优势太明显了对比项STM32 Nucleo (F446RE)Arduino Mega板载调试器ST-Link免额外下载器没有需另外买USB转串口ADC精度12位分辨率高10位误差较大USB功能原生USB-FSHAL库有MIDI类需要自定义或外扩USB库GPIO数量足够扩展十几个鼓垫勉强够用但ADC通道少定时器精度丰富且精确一般我实际用的是Nucleo-F446RE板子很便宜性能对于处理8路鼓垫绰绰有余。而且STM32的HAL库已经内置了USB MIDI设备类只要在CubeMX里勾选一下就能把开发板认成标准MIDI设备不需要写一层协议栈省了不少事。1.3 功能拆解与工作流程整个模块的工作流程可以拆成四步鼓垫上的压电传感器把敲击振动转化为电信号信号调理电路钳位、滤波后送入STM32的ADC固件对ADC采样值做峰值检测和消抖计算出触发力度Velocity固件组装MIDI Note On/Note Off消息通过USB发送到PC或音源。另外我加了一个LED反馈敲击时对应通道的LED会闪一下方便调试时确认是否触发。后面我还想在硬件上加一个OLED屏显示音色号和灵敏度这个后面再讲。2. 硬件设计与连接细节2.1 鼓垫触发原理与信号调理电路鼓垫最核心的传感器是压电陶瓷片Piezo现在很多电子鼓触发器都用它。它的原理很简单陶瓷片受力弯曲时两个电极之间会产生电压敲击力度越大峰值电压越高。但这个电压很“野”轻敲可能只有0.1V重敲可能超过15V直接接MCU的引脚肯定会烧芯片所以必须先做信号调理。我的调理电路是这样设计的压电正极经过一个10kΩ电阻与地形成分压把高压脉冲压到3.3V以内再反向并联一个1N4148二极管正向端朝地用来吸收负向的尖峰防止负压损坏引脚引脚上再串一个220Ω电阻接0.1μF电容到地构成一个低通滤波滤掉高频抖动。做出来之后实测重敲时ADC读到的电压大概能到3V左右轻敲也有0.2V以上线性度还不错。如果你只想快速验证也可以直接用一个按键开关接GPIO但那样就只能检测“敲没敲”没法做力度分级可玩性就差太多了。2.2 硬件连接与供电Nucleo板直接用USB口给STM32和传感器电路供电就行官方板上自带3.3V稳压。这里有一个容易踩的坑压电传感器的地线必须和Nucleo的GND共地否则触发电平会飘出现乱触发或者不触发的现象。我的接法是所有压电传感器的负极都汇总到GND正极分别接到ADC引脚LED的正极接GPIO负极串330Ω电阻到GND。这样每个鼓垫只有一根信号线接线比较清爽。实际做的时候建议把信号线尽量短实在要延长就加一层屏蔽线否则进入ADC的是几十毫伏级的模拟信号很容易受电源纹波和线路串扰影响。2.3 引脚分配参考我规划的引脚分配可以给大家参考设备引脚功能鼓垫1PA0 (ADC1_IN0)底鼓鼓垫2PA1 (ADC1_IN1)军鼓鼓垫3PA4 (ADC1_IN4)嗵嗵1鼓垫4PA5 (ADC1_IN5)嗵嗵2鼓垫5PB0 (ADC1_IN8)踩镲鼓垫6PB1 (ADC1_IN9)开镲LED1-6PC0-PC5触发指示USB D/D-PA11/PA12USB MIDI这里要注意PA11和PA12是USB专用引脚别拿去接鼓垫否则USB功能就废了。3. 软件实现与核心代码解析3.1 CubeMX初始化关键配置软件部分我用STM32CubeMX生成基础工程IDE用STM32CubeIDE也可以用Keil。关键配置有这么几个时钟外部HSE 8MHz晶振通过PLL倍频到168MHz同时保证USB外设的48MHz时钟。USB对时钟非常敏感频率不对会导致PC枚举失败。ADC选择ADC1开启ScanConvMode启用DMA循环模式采样时间我设了84个ADC时钟周期这个值可以稍微大一点防止采不到峰值。USB在Middleware里勾选USB_Device类选择MIDI。CubeMX会自动生成usbd_midi.c和usbd_midi.h以及一个1152字节的接收缓冲区。有一点要特别注意CubeMX生成的默认MIDI类只有一个双向端点发送缓冲区大小是1字节实际用的时候要确认“USBD_MIDI_SetTxBuffer”和“USBD_MIDI_Send”这两个函数存在我在某些版本的HAL库上遇到过函数名不同的问题报错的话去usbd_midi.c里搜一下函数原型就好。3.2 峰值检测与消抖逻辑鼓垫信号是瞬态脉冲如果用单次ADC读取很容易错过峰值所以我用DMA循环采样。DMA循环缓冲区里维护着每一路的最近8次采样值主循环里每次取最大值作为该路的“当前峰值”。消抖逻辑也很重要。鼓手敲击时压电会因为机械振动产生多次震荡如果不做消抖一个敲击可能被识别成好几次触发声音会乱成一团。我的办法是当某一路峰值超过阈值并触发后给该通道设置一个20ms的锁定时间锁定时间内即使再次检测到高电平也不处理。20ms这个值是我根据实际试用调整出来的既不会丢掉快速连击又能防止单次敲击的多余震荡。核心代码大致是这个形状// 假设 adc_buffer 是 DMA 循环采样缓冲每个通道 8 个采样点 #define THRESHOLD 300 // 触发阈值根据调试调整 #define DEBOUNCE_MS 20 // 消抖锁定时间 uint16_t adc_buffer[6 * 8]; uint8_t debounce_remaining[6] {0}; uint8_t midi_note[6] {36, 38, 50, 48, 42, 46}; // MIDI音高Kick, Snare, Tom1, Tom2, HH, OH void process_pads(void) { static uint32_t last_tick 0; uint32_t now HAL_GetTick(); for (int i 0; i 6; i) { if (debounce_remaining[i] 0) { // 锁定中衰减计时 if (now - last_tick 1) { debounce_remaining[i]--; last_tick now; } continue; } // 取当前这一路采样的最大值做峰值 uint16_t peak 0; for (int j 0; j 8; j) { if (adc_buffer[i * 8 j] peak) peak adc_buffer[i * 8 j]; } if (peak THRESHOLD) { uint8_t velocity map_velocity(peak); // 发送 Note On稍后自动发送 Note Off midi_send_note(0x90, midi_note[i], velocity); debounce_remaining[i] DEBOUNCE_MS; } } }注意这里为了展示逻辑忽略了时间戳的精确递减实际项目用HAL_GetTick做一个计数器会更可靠。3.3 MIDI消息发送实现MIDI消息非常简洁一个Note On消息是三个字节状态字节、音高、力度。比如底鼓就是0x90 0x24 0x64其中0x90表示“通道1的Note On”0x24是36号音Kick Drum0x64是力度100。USB MIDI的发送函数一般长这样void midi_send(uint8_t status, uint8_t data1, uint8_t data2) { uint8_t msg[3]; msg[0] status; msg[1] data1; msg[2] data2; USBD_MIDI_Send(hUsbDeviceFS, msg, 3, 1); }发送完Note On后要隔一点时间发送Note Off否则音源会一直响下去。我的做法是每敲一下先发Note On同时在程序里登记“等到15ms后发Note Off”。我试过直接连续发有的音源会因为Note Off跟在Note On后面间隔太短导致不出声所以至少间隔10ms以上。力度映射我这里用了最简单的线性映射uint8_t map_velocity(uint16_t peak) { // 阈值300对应最小力度1满量程4095对应最大力度127 int v (peak - THRESHOLD) * 127 / (4095 - THRESHOLD); if (v 1) v 1; if (v 127) v 127; return (uint8_t)v; }实际感觉线性映射在轻敲时有点“虚”后面我换成了平方根映射手感更自然这个细节放到第5章细说。4. 实操过程与踩坑实录4.1 烧录和调试的注意事项Nucleo板最大的优势是板载ST-Link插上USB线电脑就能识别直接用STM32CubeIDE烧录。但这个过程我第一次用的时候就翻过车——报错信息大致是error: no stm32 target found! if your product embedsdebug authentication, please disable it and re-plug the probe.这个报错的原因主要有三类一是ST-Link驱动被其他IDE占用比如同时开着两个工程二是板和调试器之间接触不良拔插一下就好三是代码里把SWD引脚复用成了GPIO比如把SWDIO或SWCLK接到别的东西上导致调试器连不上目标芯片。最后一种比较坑因为一旦程序把SWD引脚占用了下次烧录就进不了调试模式解决方法是按住Nucleo板上的NRST复位键在烧录开始的瞬间松开让MCU处于复位状态时连接调试器。4.2 USB识别与驱动问题排查当我把固件烧进去插上USB线Windows第一次会弹出“安装设备驱动程序”的提示正常情况下会识别为“MIDI Interface”。如果你在设备管理器里看到的是带感叹号的“Virtual COM Port”或者直接显示“Unknown Device”90%是时钟配置有问题。USB外设必须工作在48MHz如果PLL配错了设备枚举就会失败。另一个容易忽视的问题是USB线。有些充电线只有电源线没有数据线插上之后能供电但枚举不成功。这种问题很迷惑因为板子上的LED都亮了看起来一切正常结果就是识别不了。我的建议是直接换一根已知能传数据的短线排除法最省时间。4.3 触发灵敏度与延迟调优触发灵敏度可以通过阈值和ADC采样时间一起调。阈值设太低轻轻碰到鼓垫就会误触发阈值设太高力度小的十六分音符直接被吞掉。我最终把阈值定在300左右12位ADC满量程4095。延迟方面最大的敌人是主循环里的HAL_Delay()。早期版本我在主循环里加了50ms的LED闪烁延时结果敲一下鼓要等到天荒地老才出声音。后来把所有发送逻辑都改成了基于时间戳的状态机主循环一次循环时间控制在1ms以内实测下来从敲击到听到声音约10-20ms人耳完全感觉不到延迟。4.4 常见问题速查表现象可能原因快速排查ST-Link连不上ST-Link被占用、SWD引脚被占用拔插USB按住NRST再烧录USB不识别/感叹号USB 48MHz时钟不对、线材问题检查PLL配置换数据线MIDI声音延迟大主循环有长阻塞延时删除HAL_Delay改用状态机鼓垫乱触发阈值低、消抖时间短提高THRESHOLD增加DEBOUNCE_MS某个鼓垫没反应信号线虚接、ADC通道配置错万用表量压电电压核对CubeMX引脚两个鼓垫同时触发共地接触不良、线缆串扰检查GND连接信号线加屏蔽5. 性能优化与扩展方向5.1 力度曲线映射刚开始用线性映射时轻敲出来的力度值太低音色很“瘦”重敲又很容易到127封顶动态范围很窄。后来我改成平方根映射uint8_t map_velocity(uint16_t peak) { if (peak THRESHOLD) return 0; float normalized (float)(peak - THRESHOLD) / (4095 - THRESHOLD); int v (int)(sqrtf(normalized) * 127); if (v 1) v 1; if (v 127) v 127; return (uint8_t)v; }别看只是多了一个平方根手感差别非常明显。小力度更容易控制在低力度区间敲击的动态层次好很多。如果你用的鼓手特别大力还可以尝试指数映射这个完全看个人喜好把曲线调试做成上位机界面是高级玩法。5.2 扩展更多鼓垫与蓝牙MIDINucleo-F446的GPIO和ADC通道足够多扩展到16路鼓垫在硬件上是没问题的。但ADC通道不够的话要外接模拟开关或串行ADC软件复杂度会明显上升。我的建议是先用6路把整个流程跑通再根据实际需求扩展。蓝牙MIDI也是很多人问的方向。最简单的方法是在UART上接一个HC-06蓝牙模块把MIDI消息转成串口数据配合手机上的BT MIDI应用使用。不过延迟会比USB高一些大概30-50ms做练习还行想要演奏级低延迟还是USB可靠。5.3 后续升级计划我接下来打算做这几件事一是把灵敏度设置保存到Flash这样每次开机不用重新调二是在板上加一个小OLED屏显示当前音色号和力度值三是试试FreeRTOS用一个任务专门采集ADC和做峰值检测另一个任务负责USB发送避免极端情况下互相影响。另外我还在研究把鼓垫的触发时间戳记录下来做成一个简单的MIDI录音器敲完一段直接通过U盘接口导出MIDI文件学习打谱的时候特别方便。说一下我做完这个项目最大的体会MIDI鼓模块的难点其实不在MIDI协议本身而在“实时”这两个字。ADC采样速度、消抖策略、USB发送时机任何一个环节处理不好都会直接体现在手感上。如果你也想做一个我强烈建议先从一个鼓垫开始把灵敏度调到舒服再慢慢叠加。这个过程挺上瘾的我光是调力度曲线就调了一个晚上。等你的模块能稳定敲出一段节奏那种把硬件和音乐连接起来的满足感是真的会上头。本文还有配套的精品资源点击获取