基于CircuitPython的16步鼓机音序器DIY：从MIDI协议到嵌入式音乐创作

1. 项目概述与核心思路

如果你玩过电子音乐，尤其是硬件合成器或鼓机，那么对“步进音序器”这个概念一定不陌生。它就像是音乐的时间网格，把一段循环的节奏均匀地切成若干等份，每一份就是一个“步进”。你只需要决定在哪个格子里“点亮”一个音符，机器就会在对应的时间点精准地触发它。这种直观、可视化的编程方式，是塑造Techno、House等电子音乐律动骨架的灵魂工具。经典的Roland TR-808鼓机之所以成为传奇，其标志性的16步红色按钮矩阵功不可没。

今天，我们不谈昂贵的古董设备，而是动手做一个属于你自己的、完全开源的16步鼓机音序器。这个项目的核心目标，是打造一个能通过USB MIDI协议与你电脑上的音乐制作软件（如Ableton Live, GarageBand等）实时通信的硬件控制器。你用它编排节奏，它负责向软件发送触发信号，驱动虚拟鼓机或采样器发声。整个系统基于CircuitPython开发，这意味着你不需要复杂的C/C++编译环境，用Python脚本就能控制所有硬件，极大地降低了嵌入式音乐设备开发的门槛。

整个音序器由一块Adafruit KB2040（基于RP2040芯片）主控板驱动，它负责核心逻辑和USB MIDI通信。16个带LED的步进开关用于编排节奏，一个AW9523 GPIO扩展芯片专门驱动这些LED，释放主控的IO压力。一个四位数码管显示当前速度（BPM）或选中的鼓音色，一个旋转编码器则用于调节这两个参数。所有部件通过面包板连接，无需焊接PCB，非常适合原型验证和初学者学习。通过这个项目，你不仅能得到一个实用的音乐制作工具，更能深入理解MIDI协议、实时音序调度、多外围设备协同工作等嵌入式开发的核心概念。

2. 硬件选型与电路设计解析

2.1 核心控制器：为什么是KB2040？

主控板选择了Adafruit的KB2040。这块板子基于树莓派RP2040双核ARM Cortex-M0+处理器，外形兼容Arduino Pro Micro，但性能更强，原生支持CircuitPython。我选择它有几个关键理由：首先，它内置了USB MIDI支持，在CircuitPython中只需几行代码就能将板子变成一个标准的MIDI设备，操作系统即插即用，无需额外驱动。其次，RP2040有充足的GPIO引脚（KB2040引出了23个）来连接我们的16个开关和其他外设。最后，Adafruit为其提供了极其完善的CircuitPython库生态，从显示驱动到IO扩展，都有经过验证的库支持，能节省大量底层调试时间。

注意：虽然很多开发板都支持CircuitPython，但并非所有都原生支持usb_midi库。确保你选择的板子在CircuitPython官方支持列表中，并且明确支持usb_midi功能。KB2040、ItsyBitsy RP2040、Feather RP2040等都是可靠的选择。

2.2 GPIO扩展与LED驱动：AW9523的双重角色

16个步进开关，每个都需要一个独立的LED来指示状态（开启/关闭/当前播放位置）。如果直接用KB2040的GPIO驱动，需要占用16个引脚用于LED输出，这还不算开关输入和显示、编码器。引脚资源立刻捉襟见肘。因此，引入I2C GPIO扩展芯片是必须的。

这里选用AW9523，它不仅仅是一个简单的IO扩展器。它内置了16个恒流LED驱动通道，每个通道的电流可以独立编程（0-37mA）。这意味着你可以直接连接LED，无需外接限流电阻，并且能通过代码精确控制LED亮度，实现“当前步进高亮”、“激活步进常亮”、“未激活熄灭”三种状态的亮度区分。我们将所有16个LED的阴极（负极）连接到AW9523的IO口，由它进行灌电流驱动（Sink Mode），这是一种更安全、更规范的驱动方式。

接线要点：AW9523通过一个短STEMMA QT电缆（I2C）连接到KB2040的STEMMA QT接口。务必焊接板上的两个地址选择跳线帽，将其I2C地址设置为0x5B。这个操作至关重要，它确保了芯片上电时所有IO口处于已知的高阻态，防止LED在程序初始化前全部意外点亮。

2.3 人机交互模块：开关、编码器与显示

1. 步进开关：我们使用PB-86型带灯自锁开关。这种开关手感清晰，按下后保持状态，非常适合步进音序器的“编程”操作。由于其引脚排列特殊，无法直接插入面包板，因此需要配合专用的分线板使用。每个开关有6个引脚：一对常开（NO）、一对常闭（NC）、一个LED阳极（+）和一个LED阴极（-）。我们只使用常开触点和LED部分。
2. 旋转编码器：我们选用集成了SEESAW芯片的STEMMA QT编码器模块。SEESAW芯片是一个协处理器，它通过I2C与主控通信，将编码器的旋转和按键动作转化为易于读取的数据，这样我们只需要占用主控的两个I2C引脚，就能获得一个带按键的编码器，节省了宝贵的IO和中断资源。编码器用于调节BPM和选择鼓音色。
3. 显示模块：采用Adafruit的0.54英寸红色四位数码管模块，同样带有I2C接口。它用于直观显示当前的BPM数值（如“120”）或选中的鼓音色缩写（如“BASS”、“SNAR”）。其I2C地址默认为0x71，与AW9523的0x5B不冲突，可以挂载在同一I2C总线上。

2.4 电路连接规划与电源管理

整个系统的电路连接可以划分为几个功能区：

• 电源总线：在面包板两侧建立清晰的3.3V和GND电源轨。KB2040的3V和GND引脚分别连接到这些电源轨，为整个系统供电。
• 开关矩阵：16个开关的常开端点，分别连接到KB2040的16个独立数字输入引脚（如TX, RX, D2-D10, A0, A1等）。所有开关的另一端并联接到GND。KB2040内部配置上拉电阻，因此开关按下时，输入引脚从高电平被拉低到GND。
• LED矩阵：16个开关的LED阳极（+）并联接到3.3V电源轨。每个LED的阴极（-）则分别连接到AW9523的16个IO口（P0-P15）。AW9523配置为恒流输出模式，通过控制每个IO口的电流大小（0-255）来控制LED亮度。
• I2C总线：KB2040的STEMMA QT接口（SDA, SCL）通过电缆连接到AW9523。再从AW9523的另一个STEMMA QT接口引出，串联连接到数码管显示模块，最后连接到旋转编码器模块。这是一种典型的I2C链式连接。
• 播放/暂停按钮：一个独立的轻触开关，一端接GND，另一端接KB2040的一个数字输入引脚（如A2），并启用内部上拉。

布线技巧：面对16个开关和LED的密集布线，强烈建议采用“颜色分区”和“阶段性测试”策略。例如，所有GND线用黑色，3.3V线用红色，开关信号线用黄色，LED控制线用绿色。每焊接/连接完一行（如底部8个开关），就用一段简单的测试程序验证这8个开关和LED是否工作正常，然后再进行下一行。这样可以避免全部完成后，面对数十根线无从下手的调试噩梦。

3. 软件架构与CircuitPython代码深度剖析

3.1 开发环境搭建与项目初始化

首先，你需要为KB2040刷入最新的CircuitPython固件。访问 circuitpython.org ，下载对应的.uf2文件。按住KB2040上的BOOTSEL按钮不放，同时插入USB线，电脑上会出现一个名为RPI-RP2的U盘。将下载的.uf2文件拖入，板子会自动重启，并出现一个名为CIRCUITPY的新盘符，这意味着CircuitPython系统已就绪。

代码编辑推荐使用Mu Editor或任何纯文本编辑器（如VS Code）。将整个项目文件包（包含code.py和lib文件夹）复制到CIRCUITPY盘的根目录。lib文件夹内必须包含以下关键库文件：

• adafruit_aw9523.mpy: AW9523驱动库。
• adafruit_ht16k33.mpy: 数码管显示驱动库。
• adafruit_seesaw.mpy: 旋转编码器驱动库。
• adafruit_debouncer.mpy: 按键消抖库。
• adafruit_ticks.mpy: 高精度时间管理库。

3.2 核心变量与状态机定义

程序的开头定义了整个音序器的核心参数和状态。理解这些变量是理解代码逻辑的关键。

num_steps = 16 # 步进总数，固定为16 num_drums = 11 # 鼓音色轨道数，这里使用了11种808经典音色 bpm = 120 # 初始速度，单位是拍每分钟 beat_time = 60 / bpm # 每拍的时间长度（秒） steps_per_beat = 4 # 每拍细分为多少步，4代表16分音符 steps_millis = (beat_time * 1000) / steps_per_beat # 每一步的实际时长（毫秒） sequence_length = 16 # 序列长度，通常等于num_steps step_counter = 0 # 当前播放到的步进索引（0-15） curr_drum = 0 # 当前正在编辑的鼓音色轨道索引 playing = False # 播放/停止状态标志

sequence列表是这个音序器的大脑。它是一个二维列表（列表的列表）。第一维索引[k]代表第k个鼓音色轨道（0是底鼓，1是军鼓...），第二维索引[j]代表该轨道的第j个步进（0-15）。值为1表示在该步进触发，0表示不触发。代码中预置了一个经典的808风格节奏型。

时间管理的艺术：音乐时序要求极高的精确性。我们使用adafruit_ticks库提供的ticks_ms()函数来获取毫秒级的时间戳。核心逻辑是：记录上一次触发步进的时间last_step，在循环中不断检查当前时间now与last_step的差值是否超过了steps_millis。一旦超过，就执行“触发当前步进上所有鼓音色”的动作，然后更新last_step并递增step_counter。这种基于时间差而非固定延时的方式，能有效避免代码执行时间累积带来的时序漂移。

3.3 外设初始化与通信协议

开关扫描：我们没有为16个开关使用16个独立的中断，而是使用了keypad库。它将一组GPIO引脚定义为一个“键盘矩阵”，在后台自动进行扫描和消抖，并通过事件队列switches.events.get()来报告按键事件。这种方式效率高，且不阻塞主循环。

switch_pins = (board.TX, board.RX, board.D2, board.D3, ...) # 16个引脚 switches = keypad.Keys(switch_pins, value_when_pressed=False, pull=True)

AW9523 LED驱动：初始化后，需要将16个IO口全部设置为恒流输出模式。

leds = adafruit_aw9523.AW9523(i2c, address=0x5B) leds.LED_modes = 0xFFFF # 所有引脚设为LED驱动（恒流）模式 leds.directions = 0xFFFF # 所有引脚设为输出方向 for led in range(num_steps): leds.set_constant_current(led, 0) # 初始亮度设为0（熄灭）

MIDI消息发送：通用MIDI（GM）标准规定，通道10（对应十六进制0x99）专用于打击乐。每个音符编号对应一种特定的打击乐音色。play_drum(note)函数构造了一个三字节的MIDI Note On消息[0x99, note, velocity]，紧跟着发送一个Note Off消息[0x89, note, 0]。虽然也可以只发Note On，然后依靠DAW自动结束，但立即发送Note Off是更严谨的做法，能避免某些音源出现音符粘连。

3.4 主循环逻辑与用户交互处理

主程序是一个永不退出的while True循环，它需要高效、无阻塞地处理四件事：1) 播放时序；2) 按钮检查；3) 开关检查；4) 编码器检查。

1. 播放/暂停按钮：使用Debouncer库处理消抖。当检测到按钮按下（fell事件），首先翻转playing状态。如果是从播放状态切换到停止，则调用print_sequence()函数，将当前的节奏型以Python列表格式打印到串行终端，方便你复制保存。然后重置step_counter为0，并更新时间基准last_step。

2. 播放时序引擎：当playing为True时，执行播放逻辑。核心就是前面提到的时间差检查。触发时，先调用light_beat(step_counter)让当前步进的LED高亮一下，然后遍历所有11个鼓轨道，如果sequence[i][step_counter]为1，就调用play_drum()发送对应的MIDI音符。最后，将该步进LED恢复为编辑状态下的亮度，并将step_counter加1（超过15则归零）。

3. 步进开关编辑：无论是否在播放状态，都持续检查开关事件。当某个开关被按下，我们获取其编号i，然后执行sequence[curr_drum][i] = not sequence[curr_drum][i]。这句代码非常巧妙，它直接对当前值进行逻辑取反：如果是0就变成1（激活），如果是1就变成0（关闭）。同时，调用light_steps()同步更新对应LED的状态。

4. 编码器交互：编码器有两个功能：旋转调节BPM，或旋转切换鼓轨道。按下编码器按键则在两种模式间切换（edit_mode_toggle()）。程序通过比较本次读取的编码器位置encoder_pos与上一次的位置last_encoder_pos，计算出变化量encoder_delta。根据当前的edit_mode，这个变化量被用于增加/减少BPM（并重新计算steps_millis），或者在11个鼓轨道间循环。在切换鼓轨道时，程序会立即更新16个LED，显示新轨道的节奏型。

实操心得：在主循环中，对于编码器位置的读取和开关事件的获取，我放在了不同的条件分支里。当播放时，只在完成一个步进触发后的短暂间隙读取编码器位置和检查其按键。这是因为播放时序循环对时间非常敏感，而编码器扫描（特别是通过I2C读取SEESAW）需要一定时间。如果放在播放时序判断的同一层级，可能会干扰节奏的稳定性。当停止时，则可以持续检查。这是一种保证时序优先级的常见设计。

4. 系统搭建与调试全流程

4.1 硬件组装步骤详解

1. 焊接与准备：

   • 为KB2040和AW9523焊接排针，并插入面包板中部靠上的位置。
   • 关键一步：使用焊锡连接AW9523板上的两个I2C地址跳线点，将其地址固定为0x5B。
   • 将步进开关的分线板剪下，焊接5针排针，然后将开关本身焊接在分线板上。重复16次。这个过程需要耐心，确保开关安装平整，所有引脚焊接牢固无虚焊。

2. 电源与基础布线：

   • 用短线将面包板左右两侧的电源轨对应连接（正极连正极，负极连负极）。
   • 将KB2040的3V引脚连接到正极轨，GND连接到负极轨。
   • 将AW9523的VIN和GND也连接到电源轨。

3. 开关矩阵布线：

   • 将16个开关模块分成两排，每排8个，插入面包板。
   • LED供电：将所有16个开关的LED阳极（+）引脚，用导线并联到正极电源轨（3.3V）。
   • LED控制：将每个开关的LED阴极（-）引脚，依次连接到AW9523的P0至P15引脚。建议从P0开始，按顺序连接，并在纸上做好记录，避免混乱。
   • 开关信号：将每个开关的常开（NO）引脚，依次连接到KB2040的16个预定IO口（如TX, RX, D2...A1）。同样，保持顺序一致。
   • 开关接地：将所有开关的公共端（COM）或另一个开关引脚（如果COM未使用，则用常闭NC端）用导线并联到负极电源轨（GND）。

4. 外设连接：

   • 用一根短STEMMA QT线连接KB2040和AW9523。
   • 将数码管显示模块插在AW9523的另一个STEMMA QT口上。由于其位置可能悬空，可以用剪短的排针做成“支架”，将其固定在面包板边缘。
   • 用另一根STEMMA QT线从显示模块连接到旋转编码器模块。将编码器模块焊接上排针后插入面包板。
   • 将播放/暂停按钮插入面包板，一端接GND，另一端接KB2040的A2引脚。

4.2 软件烧录与功能验证

1. 将组装好的设备通过USB-C线连接电脑。确保CIRCUITPY盘出现。
2. 将下载的项目包中的code.py和整个lib文件夹复制到CIRCUITPY盘根目录。如果系统询问是否覆盖，选择“是”。
3. 复制完成后，板子会自动重启并运行新代码。此时，你应该看到16个步进开关的LED依次以低亮度快速点亮一次（启动动画），然后数码管会滚动显示“Drum Trigger 2040”和初始BPM“120”。
4. 基础功能测试：
   • 播放/停止：按下播放按钮，数码管应显示BPM。此时，第一个步进的LED（对应step 0）应该开始以高亮度闪烁，指示播放位置。同时，你的电脑应该能检测到一个新的MIDI输入设备（名称可能包含“CircuitPython”或“KB2040”）。
   • 编辑节奏：按动几个步进开关，对应的LED应点亮（中等亮度）。按下播放，当播放头经过你点亮的步进时，应该能听到电脑DAW里对应的鼓声被触发（需提前在DAW中设置好）。
   • 切换音轨：按下编码器按键，数码管显示应从BPM数字变为“BASS”（底鼓）。旋转编码器，显示应在“BASS”、“SNAR”、“LTOM”等11个音色间切换。同时，16个LED会显示当前选中音轨的节奏型。你可以为不同音轨编辑不同的节奏。
   • 调节速度：再次按下编码器按键，切换回BPM模式。旋转编码器，BPM数值应随之增减，播放速度也会立即改变。

4.3 在数字音频工作站（DAW）中的配置

这里以macOS自带的GarageBand为例，其他DAW如Ableton Live、FL Studio逻辑类似。

1. 打开GarageBand，创建新项目，选择“软件乐器”轨道。
2. 在轨道区域的左侧，点击“音库”按钮，选择一个鼓机音源。例如，可以在“电子鼓”分类下选择“复古机器鼓”，这是一个模拟808/909的经典鼓机。
3. 确保GarageBand能接收到MIDI信号。点击菜单栏“GarageBand” -> “设置” -> “音频/MIDI”，在“MIDI状态”下，你应该能看到“CircuitPython”或类似设备已连接。
4. 在刚创建的软件乐器轨道上，点击“智能控制”按钮（圆圈内带i的图标），确保轨道处于“已启用录音”状态（红色R按钮未点亮时，也能接收MIDI输入）。
5. 现在，当你按下硬件音序器的播放键，并点亮某些步进，就应该能在GarageBand中听到对应的鼓声了。你可以在GarageBand的钢琴卷帘窗或“音乐键入”窗口中看到MIDI音符的输入。

重要提示：通用MIDI鼓映射是标准化的。代码中drum_notes列表定义的音符编号（36=底鼓，38=军鼓等）必须与DAW中鼓音源映射的音符一致。大多数现代鼓机插件都遵循GM标准，但有些采样库或合成器鼓可能有自定义映射。如果某个步进触发的声音不对，你可能需要在DAW中重新映射音符，或者修改代码中的drum_notes列表。

5. 进阶优化与故障排查指南

5.1 功能扩展思路

这个基础版本已经是一个完全可用的音序器，但你可以通过修改代码轻松扩展它：

• 保存/加载节奏型：目前节奏型断电即失。可以引入storage模块，将sequence列表以JSON格式保存到KB2040的闪存中。甚至可以定义多个“歌曲模式”，存储多套不同的节奏。
• 增加节奏变化：引入“摇摆”（Swing）因子。修改steps_millis的计算，让偶数步或奇数步有微小的延迟，产生更人性化的律动。
• 实现音符力度：目前所有音符的力度（Velocity）是固定的120。你可以将sequence列表从0/1二进制，改为0-127的力度值。在触发时，将力度值填入MIDI消息。甚至可以配合另一个电位器或编码器来实时调节当前轨道的力度。
• 扩展步进数：虽然硬件只有16个按钮，但你可以通过编码器按键组合（如长按）进入“模式切换”，让16个按钮控制16-31步，实现32步的序列。显示上可以增加一个点来指示当前处于哪一组16步。

5.2 常见问题与解决方案

下表列出了搭建和使用过程中可能遇到的典型问题及解决方法：

5.3 调试技巧与工具

• 串行输出（Print）是你的好朋友：在代码关键位置添加print()语句，是调试嵌入式程序最直接的方法。你可以打印BPM、当前步进、编码器位置、开关事件等。使用Mu Editor的串行监视器或VS Code的串行插件来查看输出。
• 逻辑分析仪或示波器：如果遇到棘手的时序问题，可以用逻辑分析仪抓取开关引脚或LED控制引脚的电平变化，直观看到程序响应时间。
• 分模块测试：不要一次性写完所有代码。可以先写一个测试程序，只让AW9523循环点亮LED。再写一个测试程序，只读取编码器并打印数值。最后再将所有功能整合。硬件上也应分阶段测试。
• 利用REPL（交互式解释器）：当板子通过USB连接时，你可以按Ctrl+C进入CircuitPython的REPL。在这里，你可以直接导入模块、操作对象、检查变量，进行实时交互式调试。例如，输入import board; dir(board)可以查看所有可用引脚。

这个项目最迷人的地方在于，它既是一个能立即投入音乐创作的实用工具，也是一个完美的嵌入式系统学习平台。所有代码开源且易于修改，硬件模块清晰分明。当你亲手按下开关，看到LED律动，听到自己编排的节奏从音箱中迸发时，那种软硬件结合创造的成就感，是单纯购买商品设备无法比拟的。从理解一个if diff >= steps_millis:的条件判断开始，你实际上已经掌握了数字音乐心脏的跳动原理。