树莓派Pico实战：用无源蜂鸣器做个简易电子琴（附完整代码）

树莓派Pico音乐编程实战：用无源蜂鸣器打造迷你电子琴

第一次听到无源蜂鸣器发出《小星星》旋律时，那种成就感至今难忘。作为树莓派Pico玩家，我们往往止步于点亮LED或读取按钮状态，却忽略了这片拇指大小的开发板能创造的艺术可能性。本文将带你跨越基础GPIO操作，用Python代码教会Pico演奏音乐——从音阶原理到完整曲目实现，最终打造出可交互的迷你电子琴。

1. 无源蜂鸣器的音乐基因

那个躺在零件盒里的银色圆柱体，远比你想象的更有趣。与通电即响的有源蜂鸣器不同，无源蜂鸣器需要我们用PWM（脉冲宽度调制）赋予它声音的灵魂。其核心原理在于：

• 频率决定音高：每秒500次振动产生500Hz音调，对应钢琴上的B4音符
• 占空比影响音色：50%的方波最接近纯净音，调整这个参数可以模拟不同乐器
• 持续时间控制节拍：每个音符的时值通过代码中的延时实现

音乐与代码的映射关系如下表所示：

提示：实际演奏时建议使用整数频率值，人耳几乎无法分辨1-2Hz的细微差别

2. 硬件连接与基础驱动

准备以下材料：

• 树莓派Pico开发板
• 无源蜂鸣器（标记为"Passive Buzzer"）
• 面包板和跳线
• 220Ω电阻（保护GPIO引脚）

连接方式非常简单：

1. 蜂鸣器正极（通常标"+"）接Pico的GP15引脚
2. 蜂鸣器负极接220Ω电阻后接地
3. 使用Micro USB线为Pico供电

测试驱动的核心代码片段：

import machine import utime buzzer = machine.PWM(machine.Pin(15)) def play_tone(frequency, duration): buzzer.freq(frequency) buzzer.duty_u16(32768) # 50%占空比 utime.sleep_ms(duration) buzzer.duty_u16(0) # 停止发声 # 演奏中音C调 play_tone(261, 500)

3. 音阶系统实现

要让蜂鸣器真正成为乐器，需要构建完整的音阶系统。我们采用面向对象的方式封装音符逻辑：

class MusicBox: def __init__(self, pin=15): self.buzzer = machine.PWM(machine.Pin(pin)) self.notes = { 'C4': 261, 'D4': 293, 'E4': 329, 'F4': 349, 'G4': 392, 'A4': 440, 'B4': 494, 'C5': 523 } def play(self, note, duration=300): if note in self.notes: self.buzzer.freq(self.notes[note]) self.buzzer.duty_u16(32768) utime.sleep_ms(duration) self.buzzer.duty_u16(0) def play_song(self, song): for note, duration in song: self.play(note, duration) utime.sleep_ms(50) # 音符间短暂间隔

经典旋律《欢乐颂》的编码实现：

song = [ ('E4', 400), ('E4', 400), ('F4', 400), ('G4', 400), ('G4', 400), ('F4', 400), ('E4', 400), ('D4', 400), ('C4', 400), ('C4', 400), ('D4', 400), ('E4', 600), ('E4', 200), ('D4', 400), ('D4', 800) ] music = MusicBox() music.play_song(song)

4. 交互式电子琴制作

现在升级为可弹奏的电子琴，需要添加按钮矩阵。准备4-8个轻触开关，按以下方式连接：

按钮1 -> GP0 按钮2 -> GP1 ... 按钮8 -> GP7 (每个按钮另一端接地)

完整电子琴代码架构：

from machine import Pin, PWM import utime class MiniPiano: def __init__(self): self.buzzer = PWM(Pin(15)) self.buttons = [ Pin(0, Pin.IN, Pin.PULL_UP), Pin(1, Pin.IN, Pin.PULL_UP), # 添加更多按钮引脚... ] self.notes = ['C4', 'D4', 'E4', 'F4', 'G4', 'A4', 'B4', 'C5'] def check_buttons(self): for i, btn in enumerate(self.buttons): if not btn.value(): # 按钮按下 self.play(self.notes[i]) while not btn.value(): # 等待释放 utime.sleep_ms(10) def run(self): while True: self.check_buttons() utime.sleep_ms(20)

优化建议：

• 添加LED指示灯随音符亮起
• 增加录音/回放功能
• 通过电位器调节音量（改变PWM占空比）
• 使用RGB LED显示不同音阶颜色

5. 高级技巧与性能优化

当项目复杂度增加时，这些技巧能提升体验：

多任务处理技巧

import _thread def play_background(tune): _thread.start_new_thread(play_song, (tune,))

节拍器实现

def metronome(bpm=60): interval = 60000 // bpm # 毫秒/拍 while True: play_tone(880, 50) # 高音提示 utime.sleep_ms(interval)

频率平滑过渡

def glide(start, end, step=5, delay=20): for freq in range(start, end, step if end>start else -step): buzzer.freq(freq) utime.sleep_ms(delay)

硬件层面的优化方案：

• 使用MOSFET管驱动更大功率蜂鸣器
• 添加电容滤波消除电流噪声
• 通过I2S接口连接数字音频模块扩展功能

6. 创意扩展方向

突破简单电子琴的局限，尝试这些有趣创意：

音乐可视化系统

import math def visualize_music(): fft_data = get_audio_spectrum() # 伪代码，需实际实现 for freq, amp in fft_data: hue = freq_to_hue(freq) # 频率映射到HSV颜色空间 set_led_color(hue, 1, amp)

体感音乐控制器

• 用加速度传感器控制音高
• 陀螺仪数据映射到音效参数
• 压力传感器调整音量

AI音乐生成

# 简化的马尔可夫链音乐生成 def generate_melody(chain): current_note = random.choice(list(chain.keys())) while True: yield current_note current_note = random.choices( list(chain[current_note].keys()), weights=list(chain[current_note].values()) )[0]

从第一次让蜂鸣器发出"滴滴"声，到完整演奏《卡农》片段，这个过程教会我的不仅是技术实现，更是一种将抽象数学（频率）转化为艺术表达的思维方式。当朋友按下那些按钮，惊讶于Pico能发出如此丰富的声音时，那种分享创造的快乐，才是创客项目的真正价值所在。