1. 项目缘起为什么用树莓派Pico做一台钢琴几年前我还在为一个创客项目寻找一块合适的微控制器既要便宜、易上手又要能处理一些简单的音频任务。当时市面上常见的Arduino Uno在模拟信号处理和内存上有些捉襟见肘而更强大的开发板又超出了预算。直到树莓派基金会推出了那款售价仅4美元的RP2040芯片和基于它的Pico开发板局面才豁然开朗。它双核的Cortex-M0处理器、264KB的SRAM以及那个可编程的PIO可编程输入输出子系统让我立刻意识到用它来做一个能真正发声的电子乐器是完全可行的。这个“Piano using pi pico”项目的核心就是利用这块小小的开发板从头搭建一个简易的、可交互的数字钢琴。它不仅仅是让蜂鸣器哔哔叫而是要实现复音虽然有限、可调节的音色并且通过物理按键提供真实的弹奏触感。对于硬件爱好者、音乐科技初学者或者只是想给孩子做一个有趣STEM玩具的朋友来说这个项目融合了嵌入式编程、基础电路设计和数字音频原理是一个绝佳的练手机会。你会发现用几十块钱的成本和一下午的时间就能创造出一件能与你互动的“乐器”这种成就感是单纯的代码练习无法比拟的。2. 核心硬件选型与电路设计思路一台电子钢琴无论多么简易都离不开三个核心部分处理大脑、发声单元和输入界面。我们的选型全部围绕树莓派Pico展开。2.1 主控树莓派Pico的独特优势为什么一定是Pico而不是其他更常见的开发板关键在于RP2040芯片的两个特性PIO和充足的RAM。首先可编程输入输出PIO是RP2040的“秘密武器”。你可以把它理解为芯片内部一个完全独立的小型协处理器专门用来处理高速、精确的时序相关IO操作。对于音频生成我们需要产生频率极其稳定的方波、PWM波或更复杂的波形。如果使用主CPU通过软件循环来翻转GPIO引脚产生波形很容易被中断或其他任务干扰导致音调不准、有杂音。而PIO程序是硬件级执行的不受主程序影响可以确保输出波形的频率和占空比分毫不差这对于乐器的音准至关重要。其次264KB的SRAM在微控制器领域算得上是“大内存”了。这允许我们在程序中预存或实时计算一些音频样本数据例如一个周期的正弦波、三角波数据表用于生成比简单方波更悦耳的音色。相比之下Arduino Uno只有2KB的RAM做多音色复音就非常困难。2.2 发声方案从无源蜂鸣器到音频放大发声单元的选择决定了这台钢琴的“嗓音”。这里有几种性价比方案无源蜂鸣器/压电陶瓷片这是最简单、最廉价的方案成本仅需几毛钱。它内部没有振荡电路需要外部输入特定频率的方波信号才能发声。我们可以直接用Pico的GPIO口通过PIO输出对应音高的方波来驱动它。优点是电路极其简单缺点是音量小、音色单一只有方波且声音比较刺耳。有源蜂鸣器不推荐。它有内置振荡电路一通电就以其固定频率鸣响无法通过程序控制音高不适合做乐器。小型扬声器 放大电路这是追求更好音质的方案。Pico的GPIO输出电流和电压有限直接驱动扬声器声音会非常微弱。我们需要一个简单的放大电路。最经典的是使用一个NPN三极管如8050或一个专用的音频功放芯片如PAM8403这类D类功放模块。后者效率高、音质相对更好且模块化接线方便。通过PWM或DAC数模转换输出模拟音频信号给功放就能驱动扬声器发出更饱满的声音。注意Pico本身没有真正的模拟DAC引脚但我们可以利用其PWM功能通过低通滤波器来模拟模拟电压输出或者直接使用PWM驱动扬声器音质会差一些。对于入门项目直接使用PWM驱动无源蜂鸣器或连接功放模块的PWM输入是平衡复杂度和效果的好方法。我的方案选择为了兼顾可玩性和效果我建议采用“无源蜂鸣器初步验证 PAM8403功放模块驱动小扬声器”的路径。先用蜂鸣器快速验证代码和按键逻辑成功后再接入功放和扬声器提升体验。PAM8403模块仅需几元钱通过排针与Pico连接非常方便。2.3 输入界面矩阵键盘与按键消抖我们需要至少一个八度12个半音键7个白键5个黑键的键盘。如果每个按键单独占用一个GPIO口Pico的26个GPIO口很快就会用完。因此采用矩阵键盘是标准做法。将按键排列成行和列通过扫描行列来检测哪个键被按下。一个4x4的矩阵键盘只需要8个GPIO口4行4列就能管理16个按键足够我们做一个八度再加几个控制键如音色切换、八度升降。硬件消抖是关键。机械按键在闭合和断开的瞬间会产生物理抖动导致单片机在几毫秒内检测到多次通断从而误判为多次按键。解决方法有硬件消抖在每个按键两端并联一个0.1uF左右的电容成本低效果不错。软件消抖在代码中检测到按键按下后延时10-20毫秒再次检测如果状态依然为按下则确认为有效按键。这是最常用的方法。在布线时将矩阵键盘的行或列通过电阻如10kΩ上拉到VCC3.3V然后将检测引脚设置为内部上拉输入模式是稳定可靠的配置。3. 固件开发音调生成与复音实现这是项目的软件核心我们将使用MicroPython进行开发因为它交互性强库丰富适合快速原型开发。3.1 开发环境搭建与基础库首先将最新的MicroPython固件刷入Pico。然后我们需要一个代码编辑器Thonny是一个对新手非常友好的选择它集成了REPL交互式环境和文件管理可以直接在Pico上运行和保存脚本。核心的音频生成我们将用到两个MicroPython模块machine.PWM用于生成特定频率和占空比的PWM波驱动蜂鸣器或作为功放的输入信号。rp2这是RP2040特有的模块用于编写和加载PIO程序实现高精度、不占CPU的波形输出。3.2 单音生成原理与代码实现一个音调对应一个特定的频率。例如中央CC4的频率是261.63 Hz。我们要做的就是让一个GPIO引脚以这个频率输出方波。使用PWM生成方波from machine import Pin, PWM import time # 初始化PWM连接到蜂鸣器或功放输入的引脚 buzzer PWM(Pin(15)) def play_tone(frequency, duration_ms): # 设置频率和占空比50%的占空比是标准的方波 buzzer.freq(frequency) buzzer.duty_u16(32768) # 65536 / 2 32768 即50%占空比 time.sleep_ms(duration_ms) buzzer.duty_u16(0) # 停止发声占空比为0 # 播放中央C 1秒钟 play_tone(262, 1000)这段代码简单明了但有一个严重问题time.sleep_ms()是阻塞的。在播放一个音时整个程序会卡住无法检测其他按键这意味着无法实现同时按下两个键的复音效果。3.3 使用PIO实现非阻塞复音生成为了实现复音我们必须让音频生成在后台独立运行。这时RP2040的PIO就派上用场了。我们可以编写一个PIO程序让它自动、不间断地生成方波而主程序只负责告诉它“开始以XX频率发声”或“停止发声”。思路是为每个可能的音调或每个发声通道准备一个PIO状态机SM。RP2040有8个独立的PIO状态机两个PIO块各4个。我们可以用其中一个状态机来生成声音主程序通过向该状态机的FIFO先入先出队列写入目标频率值来控制音高。下面是一个简化的PIO方波生成程序示例# pio_tone.py - PIO程序用于生成指定频率的方波 import rp2 from machine import Pin rp2.asm_pio(set_initrp2.PIO.OUT_LOW, autopullTrue) def tone(): wrap_target() pull(noblock) .side(0) # 尝试从FIFO拉取频率值非阻塞 mov(x, osr) # 将拉取的值频率周期数移动到X寄存器 jmp(not_x, “skip”) # 如果X为0表示静音跳过发声 label(“high”) set(pins, 1) .side(1) # 设置引脚为高电平 jmp(x_dec, “high”) # 延迟X个周期 mov(x, osr) # 重新加载周期数 label(“low”) set(pins, 0) .side(0) # 设置引脚为低电平 jmp(x_dec, “low”) # 延迟X个周期 wrap() label(“skip”) nop() [31] # 如果静音执行空操作等待 wrap()在主程序中我们初始化这个PIO状态机并计算每个音高对应的周期值与频率成反比。当检测到按键按下时就将对应频率的周期值推入状态机的FIFO。状态机会自动读取并开始以该频率振荡。当按键释放时我们向FIFO推入0状态机检测到0就会进入静音循环。这样主循环就可以持续扫描键盘而发声完全由硬件PIO状态机在后台处理。理论上我们可以初始化多个这样的状态机连接到同一个或不同的引脚来实现真正的多复音同时发多个音。但受限于GPIO和状态机数量通常实现2-4个复音是比较实际的。3.4 键盘扫描与事件处理我们需要一个非阻塞的主循环来持续扫描矩阵键盘。这里采用状态机的思想来管理每个按键keys [ [‘C’, ‘C#’, ‘D’, ‘D#’], [‘E’, ‘F’, ‘F#’, ‘G’], [‘G#’, ‘A’, ‘A#’, ‘B’], [‘C5’, ‘CTRL1’, ‘CTRL2’, ‘CTRL3’] # 下一个八度的C和一些控制键 ] key_state {} # 记录每个键当前的状态0释放1按下 key_debounce {} # 记录每个键的消抖时间戳 def scan_keyboard(): current_time time.ticks_ms() for row_idx, row_pin in enumerate(row_pins): # 将当前行设置为低电平其他行设置为高电平输入模式 row_pin.value(0) for col_idx, col_pin in enumerate(col_pins): key_name keys[row_idx][col_idx] is_pressed (col_pin.value() 0) # 列被拉低表示按键按下 if key_name not in key_state: key_state[key_name] 0 key_debounce[key_name] 0 # 软件消抖逻辑 if is_pressed ! key_state[key_name]: if time.ticks_diff(current_time, key_debounce[key_name]) 20: # 消抖延时20ms key_state[key_name] is_pressed key_debounce[key_name] current_time # 触发按键事件 if is_pressed: handle_key_press(key_name) else: handle_key_release(key_name) row_pin.value(1) # 扫描完一行恢复为高电平 def handle_key_press(key): if key in note_freq_map: # note_freq_map是音名到频率的字典 freq note_freq_map[key] # 将频率对应的周期值推入PIO状态机的FIFO触发发声 tone_sm.put(cycle_count_from_freq(freq)) def handle_key_release(key): # 当按键释放我们可以选择停止该音推入0 # 或者在一个简单的复音系统中可能不立即停止而是交给音源包络处理。 # 这里演示立即停止 tone_sm.put(0)主循环就是不断地调用scan_keyboard()并可以同时处理其他任务如读取旋钮用于调节音量或音色、更新显示屏等。4. 从方波到更丰富的音色如果只是方波那这台“钢琴”的声音会像老式电子游戏机一样单调。我们可以通过一些方法改善音色。4.1 波表合成入门波表合成的思想很简单预计算一个周期内某种波形如正弦波、三角波、锯波的幅度样本存储在一个数组中波表。播放时PIO或PWM按照当前音高所需的速率循环遍历这个波表并将样本值输出。例如我们创建一个包含256个样本的正弦波表import math SAMPLE_COUNT 256 sine_table [int((math.sin(2 * math.pi * i / SAMPLE_COUNT) 1) * 32767 / 2) for i in range(SAMPLE_COUNT)]这个列表中的值范围在0到32767之间对应PWM的duty_u16范围0-65535。播放时我们需要一个“相位累加器”。每次定时器中断或在一个快速循环中相位累加器增加一个“相位增量”该增量由目标频率决定。用相位累加器的高位例如高8位作为索引从sine_table中查找对应的PWM占空比值并输出。相位增量越大遍历波表的速度越快产生的音高就越高。在RP2040上我们可以用PIO来高效地完成这件事一个状态机负责根据频率计算相位并读取波表另一个状态机负责以固定速率例如44.1kHz将样本值输出到PWM的占空比寄存器。这需要更复杂的PIO编程但能产生质量高得多的声音。4.2 利用PWM模拟DAC与低通滤波即使我们生成了漂亮的波形样本如果直接用PWM输出由于PWM是高频数字开关会带来大量高频谐波噪声声音听起来很“脏”。解决方法是在PWM输出引脚和功放输入之间加入一个低通滤波器。一个简单的一阶RC低通滤波器一个电阻串联一个电容对地就足够。它的截止频率计算公式是 f_c 1 / (2πRC)。我们需要让截止频率略高于我们想听到的最高音频频率比如20kHz以保留音质同时又能有效滤除PWM本身的高频开关噪声通常几十到几百kHz。例如选择R1kΩ C0.01uF截止频率约为16kHz这是一个合理的起点。4.3 动态控制音量与包络真实的乐器声音不是一按下键就立刻以最大音量响起松开就立刻消失。它有起音Attack、衰减Decay、持续Sustain、释放Release四个阶段合称ADSR包络。我们可以在软件中模拟一个简单的ADSR包络。为每个正在发声的音符维护一个“音量”状态0.0到1.0。在handle_key_press时音量不是立刻跳到1.0而是按照“起音时间”线性或指数增长到1.0在按键持续期间音量先“衰减”到一个较低的“持续”电平当handle_key_release时音量再按照“释放时间”衰减到0。在每次更新PWM占空比时将波表样本值乘以当前的音量值就能实现动态的音量变化让声音更自然。5. 系统集成、调试与优化心得将硬件焊接或插接好代码编写完毕后真正的挑战才刚刚开始。以下是我在集成调试过程中积累的一些关键心得。5.1 供电与噪声处理数字电路尤其是Pico和功放模块是噪声大户。如果使用同一个电源比如一个USB口同时为Pico和功放供电很可能会在音频中引入明显的“嗡嗡”底噪或数字切换噪声。解决方案星型接地将所有模块的GND地线都接到电源的一个点上避免形成地线环路。电源去耦在Pico的VBUS和GND引脚之间尽可能靠近引脚的地方焊接一个10uF的电解电容和一个0.1uF的陶瓷电容并联。这能为芯片瞬间的大电流需求提供本地储能并滤除高频噪声。独立供电如果条件允许用两个独立的USB电源分别给Pico和功放模块供电并确保它们的地线是共接的。这是消除共模噪声最有效的方法。信号隔离在Pico的音频输出引脚和功放输入之间串联一个100Ω左右的小电阻有时能减弱数字噪声的耦合。5.2 复音冲突与“偷音”策略当我们的复音数有限比如只用了2个PIO状态机而用户同时按下了3个键时就需要一个“音符分配”策略。最简单的策略是“先到先得”后来的按键无法发声。更友好的策略是“偷音”即当所有发音通道都被占用时新按下的键会抢占最早发声的那个通道。实现“偷音”需要一个活跃音符列表。每个通道记录它正在播放的音符和开始时间。当新按键到来且无空闲通道时就找出开始时间最早的那个通道将其停止并将新音符分配给它。5.3 性能优化与内存管理MicroPython虽然方便但效率不如C/C。如果发现键盘扫描有延迟或者复音数增加时出现爆音可以考虑以下优化将关键函数用Viper或Native装饰器编译MicroPython支持将部分函数编译成更高效的机器码。使用array模块代替list存储波表array存储数字更紧凑访问更快。避免在音频生成循环中动态分配内存如创建新列表、字符串格式化这会导致垃圾回收引起音频中断。如果追求极致性能最终可以考虑使用C SDK开发。RP2040的C SDK可以完全发挥PIO和硬件的能力实现更复杂、更流畅的音频合成。5.4 扩展玩法MIDI接口与录音回放让这个小钢琴不再孤单。我们可以通过Pico的UART接口添加一个MIDI输入例如通过5针DIN口或TRS接口让它能接收来自其他MIDI键盘或电脑的音符信号这样Pico就变成了一个硬件音源。更进一步可以利用Pico的Flash存储空间2MB实现简单的录音和回放功能。将PIO状态机输出的音频样本经过ADSR包络处理后的以较低的采样率如8kHz存入一个环形缓冲区并定期写入到Flash的文件系统中。回放时再从文件中读取数据通过另一个PIO状态机播放出来。这虽然音质有限但作为一个演示功能非常有趣。完成这个项目后你得到的不仅仅是一个能响的玩具。你深入理解了从机械振动到数字音频的链条掌握了微控制器中处理实时任务和非阻塞编程的思想还实践了硬件设计中关于噪声和稳定性的重要考量。下次当你听到任何电子设备发出声音时你大概都能在脑海里勾勒出它内部的代码和电流是如何协作的——这种透过现象看本质的能力才是创客项目带给我们的最大财富。如果想让声音更好听下一步可以尝试接入一个更好的DAC模块或者用Pico驱动一个开源的声音合成芯片那又将是一片新的天地。