YM2149声卡芯片实战：用Arduino复刻《Frogger》经典游戏音效

上个周末整理元件盒的时候，我从一块旧主板上吹下来一颗YM2149，顺手插到面包板上。芯片通电的一瞬间，我脑子里冒出来的不是“写个音序器”，而是一个更具体的目标：让1981年《青蛙过河》（Frogger）那几声标志性的“Hop”“噗通”和卡车喇叭，重新从这颗芯片里响起来。

这颗YM2149属于 Programmable Sound Generator（可编程声音发生器，简称PSG）。在采样回放还没普及的年代，街机厅里的音乐、音效几乎全靠这种芯片现场“算”出来。Frogger的声音尤其有代表性——青蛙起跳、落水、被车撞、汽车鸣笛、引擎轰鸣，全是程序实时控制振荡器生成的。如今想复刻这种声音，PSG仍然是最对味的方案。这篇文章就来完整走一遍：原理、芯片选型、硬件接线、寄存器操作、完整代码，以及我实际调试时踩过的坑。适合想进入芯片音乐、复古游戏音频复刻领域的硬件爱好者，也适合手里刚好有AY-3-8910或YM2149、不知道怎么下手的同学。

1. 先搞清楚：Frogger 的声音到底是什么

1.1 1981年的街机音频系统长什么样

Frogger当年运行的街机基板，音频部分没有一个“放歌”的模块。它的音频子系统由独立的声音CPU控制，CPU按游戏事件去改写一组振荡器电路的状态。也就是说，你听到的每一个效果音，都是程序在实时改变分频器、计数器和门控开关后直接产出的波形，没有任何一段声音是提前录好的。

正因为这样，Frogger的声音有非常鲜明的“机器感”：青蛙跳是频率快速下滑又上挑的方波，卡车引擎是低频方波和噪声的混合体，背景音乐则是一条单薄但清晰的主旋律配简单的和声。那个年代的游戏音频工程师练就了一项本事：用最少的寄存器变化，捏出最有辨识度的声音。

这个思路，跟后来的 MIDI 音源完全不同。MIDI 是“告诉设备弹哪个音符”，而 PSG 是直接告诉芯片“振荡器分频多少、噪声周期多少、音量多大”。它更底层，也更接近声音的物理生成过程。

1.2 为什么不用录音回放，而要重新合成

现在想还原一个复古音效，最笨的办法是直接从原机录音，然后当音频文件放出来。但这条路有几个问题：一是原版街机音频经过功放、喇叭、房间反射后被“染色”了；二是录音文件一旦压缩，听感就变了；三是这样做没有可玩性。比如我想把青蛙跳的音高调低一点、把速度放慢一点，录音文件就没法灵活处理。

重新合成则完全不一样。声音的每一个参数都被拆成了可编程的数值：音高是分频器值，音量是衰减器的值，音色是方波与噪声的配比。改一个寄存器，音高就变了；改一个时序，节奏就变了。这就是标题里“Programmable”这个词的核心含义。

打个比方：录音是照相，PSG是画肖像画。照相很忠实，但画肖像画可以让你抓住“神韵”并且随心所欲地调整。复刻Frogger音频，本质上就是做一张“声音肖像画”，而不是冲印一张老照片。

1.3 PSG的基础发声结构：三个方波加一个噪声源

我用的YM2149，核心结构可以概括成三块：

• 三个音调通道，每个通道有一个12位的分频寄存器，输出一个方波；
• 一个噪声发生器，用一个5位寄存器控制伪随机序列的更新速率；
• 三个音量寄存器（4位），每个通道一个，可以手动设置音量，也可以切换到包络模式。

每个音调通道的工作原理很简单：芯片内部有一个计数器，每个主时钟周期加1，当它计数到分频寄存器指定的值时，输出电平翻转一次，同时计数器清零。因此输出方波的频率由公式决定：

通道输出频率 = 主时钟频率 / (16 × 寄存器值)

比如主时钟是2MHz，寄存器值设为284，那么输出频率就是：

2000000 / (16 × 284) ≈ 440Hz

而噪声通道则是另一个路数：它输出一个伪随机序列，噪声周期的寄存器值越大，噪声听起来越“闷”，越小越“沙”。把方波通道和噪声通道混在一起用，就能做出从引擎轰鸣到爆炸冲击的一大类音效。

2. 方案选型：我为什么锁定 YM2149

2.1 YM2149 / AY-3-8910 的核心规格

YM2149是雅马哈对AY-3-8910的兼容替换型号，引脚和寄存器基本一致，市面上也更容易买到。它的核心参数如下：

选择它而不是其它方案，主要原因是：它的寄存器数量和发声模型正好覆盖Frogger音效需要的那几种声音类型。三个音调通道可以分别负责旋律、低音和某个音效，噪声通道则用来做引擎和撞击声。单芯片就能跑完整个片段，不用搞复杂的音频中断调度。

2.2 可选的PSG芯片和替代方案对比

如果你手头没有YM2149，也可以考虑下面这些方案：

我最终选了YM2149。原因很简单：它能买到、供电要求低、有完整的并行总线，直接用Arduino的GPIO就能驱动，不需要额外的读写时序芯片。而且它的声音确实自带1980年代街机味，那种略显尖锐、边缘有点粗糙的方波，正是Frogger音色的一部分。

2.3 从寄存器数值到耳机里的声音

YM2149有三个独立的模拟输出引脚，分别是A、B、C通道的输出。它内部有DAC，输出的是模拟电压，不是数字PWM。实测输出幅度大概在几伏特，不能直接驱动耳机或音响，需要加一级放大和滤波。

常见的做法是把三个通道的输出各串一个1kΩ电阻，并联到一起，形成混合信号。然后接一个10kΩ电位器做音量调节，再经过一个100nF隔直电容，输出给后级功放或声卡。如果想简单一点，甚至可以直接把这个信号接到电脑声卡的线路输入，用软件来监听和录制，只是幅度偏小，需要开大增益。

3. 把Frogger的声音拆成寄存器操作

3.1 先听，再拆：复刻音效的方法论

拿到一个复古音效，不要急着写代码。先反复听原版音频，把声音拆成几个维度：音高大概多高、有没有滑音、音量是骤减还是持续、有没有噪声成分、声音持续时间多长。Frogger的“青蛙跳”就是很好的例子。

我反复听了十几遍后判断，这个音效的核心特征是一个快速的向上滑音，伴随音量迅速衰减。滑音在PSG上很容易做：连续修改某个通道的音调寄存器值，从低频对应的较大寄存器值，逐步递减到高频对应的较小寄存器值，每一步之间间隔极短。这就是“从下往上滑”的效果。

3.2 青蛙跳跃“Hop”音效的合成思路

实现一个类似Frogger青蛙跳的音效，核心动作是连续改写通道A的音调寄存器。以2MHz主时钟为例，从寄存器值900开始，每隔几毫秒减20，减到200左右停止，同时音量从15降到0。

寄存器值的变化过程和音高的关系是反比：值越大音越低，值越小音越高。所以从900到200就是从低音滑向高音。这个轨迹如果画出来，是一条在对数坐标下近似线性的上升曲线，人耳听起来就像“wop”一样有弹性。

我用Arduino循环实现这个逻辑：

void sfx_hop() { for (uint16_t i = 900; i > 200; i -= 8) { set_tone(0, i); set_volume(0, 15); delay(2); } set_volume(0, 0); }

这段代码非常朴素，但已经能还原出七八成味道。如果想要更柔和的开头，可以在前几步把音量从10渐变到15；想要更急促的跳跃感，就把步长从8增加到15。这正体现了“Programmable”的乐趣：所有参数都可以调。

3.3 卡车引擎声和喇叭声：方波加噪声的混音

Frogger里的车流声分为两类。卡车和汽车引擎是持续性的低频轰鸣，听感像“嗡嗡”中夹杂着粗糙的“沙沙”声。这种声音用PSG做，就是让A通道输出一个80Hz左右的方波，同时打开噪声通道，并且把噪声周期寄存器设到一个中等偏小的值，让噪声不至于太沙哑。

喇叭声相对简单，原版里更像一串短促、尖锐的“哔哔”声。我直接用一个900Hz左右的方波，以50ms开关间隔连续响三到四次。如果想让它更刺耳，可以在方波上叠加一个小音量的噪声，但幅度要控制好，否则容易糊在一起。

引擎声的音量不需要始终满格。模拟真实引擎由远及近的感觉，可以在播放过程中把音量从8逐渐加到15再降回来。这个渐变的操作在PSG上就是一个for循环，逐次写音量寄存器。

3.4 背景旋律如何转换成音高序列

Frogger的标题画面有一段跳跃感很强的旋律。如果只是复刻几个音效，不写背景音乐，总感觉少了点什么。我采用的做法是把旋律拆成音符序列，每个音符对应一个频率值，再用前面提到的公式反算寄存器值。

以C5（523.25Hz）为例，在2MHz主时钟下计算：

寄存器值 = 2000000 / (16 × 523.25) ≈ 238.9，取239

取整后反推实际频率：

2000000 / (16 × 239) ≈ 523.0Hz

这个误差只有0.2Hz，人耳完全无法分辨。所有需要播放的旋律音符都可以编成一张频率表，然后转换成寄存器值直接写入。用这个办法，我拼了一段十分钟左右的背景循环，听感已经和原版标题曲很接近了。

4. 实操：Arduino 驱动 YM2149 跑起来

4.1 最小硬件接线

我用的主控是Arduino UNO，芯片是YM2149。接线方式如下：

复位引脚直接接高电平时，芯片在上电瞬间需要一小段时间稳定。实际上我发现仅接10kΩ到VCC还不够可靠，最稳的做法是接一个0.1uF电容到地，形成一个上电延时复位。这个细节在后面调试时会救你一命。

如果不想自己搭那么多飞线，也可以买现成的AY-3-8910/YM2149模块，上面通常已经带好了时钟晶振、滤波电路和3.5mm音频插座。接线只剩电源、地、控制线、数据线。我建议第一次做的朋友直接买模块，先把声音弄响，再考虑自己设计板子。

4.2 寄存器读写：最基本的驱动函数

YM2149的总线控制依靠BDIR和BC1的组合。最常用的两个操作是“锁存寄存器地址”和“写入寄存器数据”。时序上，先把数据线设置为地址值，BDIR置高、BC1置低，芯片记录当前要操作的寄存器号；然后把数据线改为数据值，BC1置高，芯片把数据写入刚才锁存的寄存器。

我用Arduino写出最简驱动：

#define BDIR 4 #define BC1 5 // 数据脚用 D6~D13 void setDataBits(uint8_t v) { for (int i = 0; i < 8; i++) { digitalWrite(6 + i, (v >> i) & 1); } } void psg_write(uint8_t reg, uint8_t val) { // 锁存寄存器地址 setDataBits(reg); digitalWrite(BDIR, HIGH); digitalWrite(BC1, LOW); delayMicroseconds(1); // 写入数据 setDataBits(val); digitalWrite(BC1, HIGH); delayMicroseconds(1); // 回到空闲状态 digitalWrite(BDIR, LOW); digitalWrite(BC1, LOW); delayMicroseconds(1); }

这段代码看起来简单，但有一条关键经验：写完数据后一定要有一段空闲时间，让芯片总线状态彻底复位。如果前一条写操作的结束状态还没稳定，就立刻开始下一条写操作，偶尔会出现寄存器地址错乱的现象，表现就是某一个声音参数莫名其妙跳变。这个坑我在第5部分会详细讲。

4.3 初始化：把芯片调到可发声状态

上电后芯片内部寄存器值随机，必须先复位并初始化：

void psg_init() { for (int r = 0; r <= 13; r++) { psg_write(r, 0); } // 设置混音：默认让三个通道的音调都使能，噪声全部关闭 // R7: bit0~2 = 0 表示A/B/C通道tone开启 // bit3~5 = 1 表示A/B/C通道noise关闭 psg_write(7, 0x38); // 三个通道音量先设为0 psg_write(8, 0); psg_write(9, 0); psg_write(10, 0); }

注意这里R7的写法：0x38对应二进制00111000，也就是bit3、bit4、bit5为1，关闭三个通道的噪声；bit0、bit1、bit2为0，使能三个通道的音调输出。如果之后需要使用噪声，再单独修改bit3~bit5。

4.4 核心辅助函数：设置音调和音量

有了底层写寄存器函数，再封装几个常用操作，写音序就舒服多了：

void set_tone(uint8_t ch, uint16_t period) { uint8_t base = ch * 2; // ch0: R0/R1, ch1: R2/R3, ch2: R4/R5 psg_write(base, period & 0xFF); psg_write(base + 1, (period >> 8) & 0x0F); } void set_volume(uint8_t ch, uint8_t vol) { psg_write(8 + ch, vol); // R8/R9/R10分别对应A/B/C } void set_noise_period(uint8_t period) { psg_write(6, period & 0x1F); } void set_mixer(uint8_t value) { psg_write(7, value); }

set_tone接收的是分频周期值，不是频率。为了方便，我再写一个转换函数：

uint16_t freq_to_period(uint32_t freq) { if (freq == 0) return 0; return (uint16_t)(2000000UL / (16UL * freq)); }

这个函数在计算时会用整数除法取整，虽然会带来最多约半个寄存器的误差，对音乐音高来说完全没问题。

4.5 完整示例：播放“Hop、引擎、喇叭”三段音效

把上面的函数拼起来，Arduino的loop里依次播放三个音效，就能还原一个类似Frogger场景的音频短剧：

void sfx_hop() { for (uint16_t p = 900; p > 200; p -= 8) { set_mixer(0x38); // 仅A通道tone，关闭噪声 set_tone(0, p); set_volume(0, 15); delay(2); } set_volume(0, 0); delay(100); } void sfx_engine() { // A通道80Hz方波 + 噪声，模拟引擎轰鸣 set_mixer(0x36); // 使能A通道tone和noise，关闭B/C set_tone(0, freq_to_period(80)); set_noise_period(6); for (int v = 6; v < 15; v++) { set_volume(0, v); delay(15); } for (int v = 15; v >= 6; v--) { set_volume(0, v); delay(30); } set_volume(0, 0); } void sfx_horn() { set_mixer(0x38); // 只开A通道tone set_tone(0, freq_to_period(900)); for (int i = 0; i < 4; i++) { set_volume(0, 15); delay(50); set_volume(0, 0); delay(30); } } void loop() { sfx_hop(); delay(200); sfx_engine(); delay(200); sfx_horn(); delay(500); }

4.6 背景音乐：三个通道同时用起来

如果只播放单个音效，三个通道确实浪费了。为了让项目更像样，我把背景旋律放到A通道，低音放到B通道，C通道留给打击乐。三个通道互相独立，只要循环里依次更新寄存器即可。

写一个简单的音序数组：

const uint16_t melody[] = { 523, 659, 784, 659, 523, 392, 659, 784, 880, 784, 659, 523, 587, 659, 784, 880 }; void play_melody() { uint8_t len = sizeof(melody) / sizeof(melody[0]); for (uint8_t i = 0; i < len; i++) { set_tone(0, freq_to_period(melody[i])); set_volume(0, 12); delay(180); set_volume(0, 0); delay(20); } }

这只是个演示框架。真正要写一首完整的曲子，可以用结构体把音符、时长、通道、音量都封装起来，做成事件表。这比在loop里写死逻辑清晰得多，也方便后续调整。

5. 调试实录与避坑指南

5.1 所有音调整体偏高的排查

我第一次焊好电路，播放C5音符，用手机频率计App一测，实际输出是548Hz，比预期高了近25Hz。当时第一反应是公式算错了，但反复检查后确认公式没错，于是怀疑主时钟有问题。

果然，我用的“2MHz晶振”实际是一个没有标注频率的拆机件，测出来是1.875MHz。把代码里的时钟频率常量从2000000改成实际值后，频率误差立刻降到0.5Hz以内。

所以调试音准类问题时，先别怀疑代码，拿示波器或频率计测一下主时钟输入是否精确。没有仪器的话，可以写一个播放1000Hz方波的测试程序，用耳朵和手机App对比。这一步能排除掉一大半的“音不准”问题。

5.2 噪声通道一直是“沙沙”声或者完全不响

噪声通道的排查点有两个：混音器R7是否正确使能了噪声，以及噪声周期寄存器R6是否写入了非零值。刚开始我只改了R7，把R6忘掉了。上电之后R6默认是0，噪声输出表现为一个几乎不可闻的直流电平，听起来就像没有反应。

R6的值决定了噪声的“沙哑程度”。值越小噪声越亮，值越大越闷。调试时从5开始逐步往上加，会比较快找到一个合适的区间。如果R7设置正确但噪声仍然不响，检查是不是把噪声混到音量寄存器之前，音量本身是0。音量寄存器写0时，通道完全静音，自然听不到噪声。

5.3 声音特别小，旋钮开满也只有一点点

YM2149的模拟输出引脚是小电流输出，直接驱动耳机或者小喇叭会力不从心。我最初把它直接接到一个8Ω小喇叭上，声音弱得可怜。

正确的做法是在输出后面加一级放大。手头有LM386的话，搭一个最小增益电路，10分钟就能解决；没有功放芯片，也可以用电脑声卡线路输入来监听，声卡前级的增益通常能把这个信号放大到正常响度。无论哪种方案，输出端都要串联一个电容隔直，防止直流电平损坏后级设备。

5.4 总线写太快导致声音参数乱跳

这是我踩得最深的一个坑。同样的代码在Arduino UNO上运行正常，换到一颗主频更高的开发板（比如Teensy）上就出现音量随机变化、音符偶尔错乱。查到最后发现是总线空闲时间不够。

YM2149的数据手册里，对总线信号的建立时间、保持时间都有明确要求。ArduinodigitalWrite本身速度比较慢，反而掩盖了这个问题。换成更快的MCU后，两条写指令之间间隔过短，芯片状态没有完全复位，导致下一个寄存器地址被错误锁存。

解决办法是在每次psg_write末尾加一个大于2微秒的延时，让总线彻底空闲。我在实际工程中统一加了delayMicroseconds(10)，稳定性和兼容性都好了很多。

digitalWrite(BDIR, LOW); digitalWrite(BC1, LOW); delayMicroseconds(10); // 给足总线复位时间

5.5 上电后有杂音、频率漂移的修复

YM2149的时钟建议用有源晶振直接驱动，不要用Arduino的digitalWrite模拟方波。Arduino模拟出来的方波抖动很大，尤其是内部还有其它中断在运行时，声音会出现轻微的“颤音”效果。早期实验时我为了省一个晶振，用Arduino的PWM来输出时钟，结果音高一直在漂，后来换成独立有源晶振问题就消失了。

如果你不想买有源晶振，也可以用Arduino的定时器在特定引脚上输出精确方波，但要注意关掉所有可能产生中断的功能。相比起来，一颗几块钱的有源晶振是最省心的选择。

6. 这个项目还能往哪里延伸

芯片音乐这个东西，一旦上手就很难停下来。做完这个Frogger复刻项目后，我又尝试了几个方向，效果都不错，分享给你参考。

一个是在PC上用Python模拟整个YM2149，写一个逐时钟周期的仿真器，把Arduino代码改成Python生成WAV文件。这样调音高、调包络、设计新音效都可以在电脑上快速迭代，不用反复烧录固件。仿真器的代码量不算大，关键就是维护好3个音调计数器、1个噪声计数器和包络状态机。

另一个方向是给音频加上一条“事件驱动的播放器”。我在Arduino上用一个定时器中断，每1ms检查一次当前音效事件表，这样就实现了多通道并行播放：A通道放旋律，B通道负责低音，C通道随时可以被音效打断。要做到这一点，代码会复杂一些，但这是从“能响”走向“能玩”的关键一步。

还有一个特别有意思的方向是给芯片“换脸”。把YM2149的寄存器读写抽象成通用接口，然后替换成SN76489甚至FPGA内核。同一套音效逻辑，跑在不同PSG上会产生完全不同的音色。我试过把Frogger的“Hop”放到SN76489上，声音变得更硬、更锋利，别有一番风味。

最后说一个让我印象很深的小细节。如果你拿示波器去看YM2149输出的方波，会发现它并不是教材里那种完美的矩形波，边沿有轻微的过冲和不对称。正是这种模拟层面的“瑕疵”，让八九十年代的游戏音乐有了一种难以复制的鲜活感。现代FPGA方案可以精确还原频率，但很难还原这种硅片本身的手气。所以我的建议是，条件允许的话，去收一颗真实的芯片回来焊，哪怕只是为了听一听它那一点点不完美。