基于Arduino的Farfisa电子手风琴MIDI改造全攻略

1. 项目概述：当手风琴遇见单片机

几年前，我在一个旧货市场淘到了一台老旧的Farfisa Syntaccordion电子手风琴。它造型复古，音色独特，但最大的问题是它那套早已过时的模拟音源系统，不仅音色库有限，而且无法与任何现代音乐制作设备对话。看着这台充满时代感的乐器，一个想法冒了出来：能不能让它“重生”，把它独特的演奏手感与现代的MIDI协议连接起来？于是，就有了这个用Arduino读取Farfisa Syntaccordion并生成MIDI信号的项目。

这个项目的核心目标，是赋予一台老式电子乐器全新的数字生命。它不仅仅是简单的信号转换，更涉及到对乐器内部电气结构的逆向工程、对演奏者意图的精确捕捉，以及将物理动作实时、无感地翻译成数字音乐语言。最终，你可以用这台老琴控制任何软音源或硬件合成器，演奏出从古典管弦乐到前沿电子音色的任何声音。无论你是热衷于硬件改造的极客，还是想挖掘老乐器潜力的音乐人，这个项目都能带你深入硬件与音乐交互的迷人领域。

2. 核心思路与系统架构设计

2.1 逆向工程：理解你的“病人”

动手之前，最关键的一步是彻底了解Farfisa Syntaccordion的工作原理。这类老式电子手风琴通常采用矩阵扫描电路来检测按键。

1. 琴键与风箱系统解析：

• 琴键（右手部分）：通常是一个8x8或类似的按键矩阵。当你按下某个键时，它会连接对应的“行线”和“列线”，形成一个闭合电路。控制器（通常是琴内一块古老的专用芯片或逻辑电路）会周期性地扫描每一行，并检测哪些列被拉低，从而确定被按下的键位。
• 贝司按钮（左手部分）：原理类似，但矩阵规模更大（例如6x20），结构更紧凑，是改造的难点之一。
• 风箱：这是手风琴的灵魂。在老式电子琴上，风箱可能连接着一个电位器或一个压力传感器，用于产生呼吸控制器或调制轮类似的连续信号，控制音量或表情。

2. 信号提取策略：我们的目标不是干扰琴原有的发声电路（甚至可以保留它作为备用），而是“窃听”它的按键扫描信号。有两种主流思路：

• 直接读取矩阵线：这是最彻底的方法。找到琴键矩阵的行线和列线，直接连接到Arduino的GPIO上，由我们自己的程序来执行扫描。这需要完全理解原琴的扫描时序，但能获得最高的可靠性和灵活性。
• 拦截原始音频/控制信号：有些型号的Syntaccordion会为每个键输出一个独立的模拟电压或频率信号。我们可以用Arduino的模拟输入或频率检测库来读取这些信号。这种方法可能更简单，但延迟和抗干扰能力是挑战。

对于本项目，我推荐直接读取矩阵线。因为它不依赖于琴内部可能已经老化或不稳定的模拟电路，让我们对整个过程有完全的控制权。

2.2 硬件架构选型与搭建

1. 主控板选择：

• Arduino Uno/Mega：入门首选。Uno的GPIO数量（14个数字I/O）可能不足以应对庞大的贝司按钮矩阵，这时就需要使用Mega（54个数字I/O）或多路复用器。
• Arduino Leonardo/Micro/Pro Micro：这是更专业的选择。它们原生支持USB MIDI设备协议，可以被电脑或硬件音源直接识别为标准的MIDI键盘，无需额外的MIDI接口，极大地简化了系统连接。本项目后续将以Pro Micro为例进行说明。

2. 关键外围电路：

• 多路复用器（如74HC4051/CD4051）：这是扩展GPIO口的关键芯片。一个4051可以用3个控制引脚选择8个信号通道中的1个进行读取。通过级联，可以轻松管理数十个琴键信号。例如，读取一个8x8矩阵，理论上只需要8（行）+ 3（控制列多路复用器）= 11个GPIO，而不是64个。
• 电平转换与保护：老琴的工作电压可能是5V、9V甚至12V。务必使用万用表测量！如果高于Arduino的5V逻辑电平，必须使用电平转换模块（如TXS0108E）或简单的电阻分压电路，防止烧毁单片机。
• 风箱传感器接口：如果原风箱是电位器，直接连接到Arduino的模拟输入引脚（A0-A2）。如果是压力传感器，可能需要额外的信号放大电路。

3. 系统连接框图（逻辑描述）：

Farfisa Syntaccordion内部矩阵 | | (行线: Row0-Row7, 列线: Col0-Col7) | v 电平转换/保护电路 | | (安全的5V逻辑电平) | v Arduino Pro Micro GPIO (行线直连，列线通过74HC4051多路复用器连接) | v USB Cable | v 计算机 (识别为USB-MIDI键盘) / MIDI硬件音源

注意：在焊接任何线路之前，务必使用万用表的通断档，在按下和松开琴键时，仔细绘制出完整的按键矩阵电路图。这是整个项目最基础、也最容易出错的一步。

3. 核心细节解析与实操要点

3.1 琴体拆解与电路测绘实战

这是最需要耐心和细心的环节。准备好万用表、电烙铁、吸锡器、放大镜和标签纸。

1. 安全拆解：

• 断开所有电源，取出电池。
• 使用合适的螺丝刀，小心移除琴体背板。注意隐藏的卡扣。
• 用手机或相机从多个角度拍摄内部高清照片，记录每根线缆的连接位置。

2. 定位矩阵电路板：

• 找到连接右手键盘和左手贝司按钮的排线。它们通常会连接到一块较大的主控板或一个专用的扫描电路板上。
• 这块板子上往往有规律排列的焊点，可能就是矩阵的行线和列线。

3. 绘制矩阵图：

• 找到“公共端”：将万用表一支表笔固定在某一个你认为可能是“行”或“列”的焊点上，另一支表笔依次去触碰其他焊点。同时用手按下不同的琴键。当按下某个键万用表鸣响时，这两个焊点就是该键连接的两端。
• 系统化测绘：假设一个8x8矩阵。你可以先假定8个焊点是行（R0-R7），另外8个是列（C0-C7）。通过测试每个按键按下时连接了哪一对（R?, C?），绘制出一个完整的映射表。用一个Excel表格或纸笔记录非常有效。

实操心得：

• 老琴的焊点可能氧化，导致接触不良。测试时稍微用力压住表笔。
• 有些琴的矩阵可能带有二极管（防止鬼键），测绘时需要注意二极管的方向，这会影响我们后续的读取逻辑。
• 给每一根线贴上标签！这是血泪教训。一旦线多了，很容易混淆，贴好标签能节省大量后期调试时间。

3.2 多路复用器与Arduino的电路连接

我们以最常用的74HC4051为例，讲解如何扩展读取8条列线。

1. 74HC4051引脚说明：

• Y0-Y7: 信号输入/输出通道（连接琴的列线）。
• S0, S1, S2: 通道选择引脚（连接Arduino的数字引脚，用于选择Y0-Y7中的哪一个）。
• Z: 公共输入/输出端（连接Arduino的一个数字引脚，用于读取被选中的通道状态）。
• E(Enable): 使能引脚，低电平有效（通常接地）。
• VCC、GND: 电源（5V）、地。
• VEE: 通常接地（当信号为0-5V时）。

2. 连接方法：

• 将琴的8根列线（C0-C7）分别连接到4051的Y0-Y7。
• 将4051的S0、S1、S2分别连接到Arduino的3个数字引脚（例如D2, D3, D4）。
• 将4051的Z引脚连接到Arduino的一个数字输入引脚（例如D5）。
• 将4051的E引脚接地，VCC接5V，GND接地，VEE也接地。
• 琴的8根行线（R0-R7）直接连接到Arduino的另外8个数字引脚（例如D6-D13）。

3. 扫描逻辑：Arduino的程序会依次设置S0-S2的值（从000到111），从而在逻辑上“接通”Y0到Y7中的一列到Z端。然后，程序再依次将每一根行线设置为低电平，并读取Z端的状态。如果Z端为低电平，说明当前选中的列与当前设置为低电平的行通过一个被按下的按键连接在了一起，从而定位到具体的按键。

3.3 风箱信号的处理与校准

风箱的改造是让MIDI化手风琴富有表现力的关键。

1. 信号获取：

• 如果原风箱使用线性电位器，其两端接琴内部的电源（如+5V和GND），中间滑臂输出0-5V的模拟电压。我们直接将滑臂线断开，连接到Arduino的模拟输入引脚（如A0）。
• 重要：必须在Arduino这边为这个电位器提供稳定的5V和GND，形成一个独立的回路，避免与琴内原有电路冲突。

2. 软件校准：风箱推拉的范围和静止位置因人而异。必须在代码中加入校准例程。

// 伪代码示例 int bellowsPin = A0; int bellowsMin = 1023; // 初始化最小值 int bellowsMax = 0; // 初始化最大值 int bellowsRest = 512; // 初始化静止值 void calibrateBellows() { Serial.println("请完全关闭风箱（推到底），保持3秒..."); delay(3000); bellowsMin = analogRead(bellowsPin); Serial.println("请完全拉开风箱，保持3秒..."); delay(3000); bellowsMax = analogRead(bellowsPin); Serial.println("请将风箱置于自然静止位置，保持3秒..."); delay(3000); bellowsRest = analogRead(bellowsPin); // 存储这些值到EEPROM，下次开机无需重复校准 }

3. 映射为MIDI信息：校准后，将读取的模拟值映射到MIDI控制器的范围（0-127）。通常，我们会将风箱信号映射为MIDI CC#7（主音量）或CC#11（表情控制器），后者在音乐软件中更为常用。

int raw = analogRead(bellowsPin); // 将模拟值限制在校准范围内 raw = constrain(raw, bellowsMin, bellowsMax); // 映射到0-127 int ccValue = map(raw, bellowsMin, bellowsMax, 0, 127); // 发送MIDI CC信息，例如CC#11，通道1 usbMIDI.sendControlChange(11, ccValue, 1);

4. 软件实现与核心代码解析

4.1 开发环境与核心库

我们使用Arduino IDE进行开发。关键库是用于USB-MIDI通信的MIDIUSB库（对于标准Arduino如Uno）或 Arduino Leonardo/Micro 系列自带的USB-MIDI功能。对于Pro Micro，我们可以直接使用Arduino IDE中内置的Keyboard和Mouse库的变体，但更专业的是使用MIDIUSB库或Arduino Core提供的MIDI功能。

实际上，对于基于ATmega32U4的板子（如Pro Micro, Leonardo），我们可以将其直接模拟成USB-MIDI设备。一个更简单强大的方法是使用Arduino MIDI Library 4.0及以上版本，它完美支持USB-MIDI和传统串口MIDI。

1. 安装库：在Arduino IDE中，点击“项目” -> “加载库” -> “管理库”，搜索“MIDI Library”，由François Bèlanger维护的版本，安装它。

2. 库的优势：

• 统一的API，兼容多种MIDI接口（USB， 硬件串口， DIN-5接口）。
• 自动处理MIDI消息的组包和发送。
• 提供丰富的示例代码。

4.2 矩阵扫描与消抖算法

可靠的按键检测是MIDI键盘的基石。下面是一个结合了多路复用器的扫描函数示例。

1. 引脚定义与初始化：

#include <MIDI.h> MIDI_CREATE_DEFAULT_INSTANCE(); // 创建默认MIDI实例（使用硬件串口，对于USB需稍作修改） // 定义行引脚 const int rowPins[8] = {6, 7, 8, 9, 10, 11, 12, 13}; // 定义多路复用器控制引脚 (S0, S1, S2) const int muxS0 = 2; const int muxS1 = 3; const int muxS2 = 4; // 定义多路复用器公共端Z的读取引脚 const int muxZ = 5; // 定义按键状态数组 [行][列] bool keyState[8][8] = {false}; bool lastKeyState[8][8] = {false}; // 消抖计时器数组 unsigned long debounceTime[8][8] = {0}; const unsigned long debounceDelay = 5; // 5毫秒消抖时间 void setup() { MIDI.begin(MIDI_CHANNEL_OMNI); // 初始化MIDI，监听所有通道 // 对于USB-MIDI，可能需要使用 MIDI_CREATE_INSTANCE(HardwareSerial, Serial, MIDI); 并调用 MIDI.begin()，具体看板型 // 初始化行引脚为输出，并置高（内部上拉或设为INPUT_PULLUP模式更佳，但这里是主动扫描） for (int i = 0; i < 8; i++) { pinMode(rowPins[i], OUTPUT); digitalWrite(rowPins[i], HIGH); // 默认设为高电平 } // 初始化多路复用器控制引脚为输出 pinMode(muxS0, OUTPUT); pinMode(muxS1, OUTPUT); pinMode(muxS2, OUTPUT); // 初始化Z引脚为输入，并启用内部上拉电阻 pinMode(muxZ, INPUT_PULLUP); }

2. 核心扫描与消抖函数：

void scanMatrix() { for (int col = 0; col < 8; col++) { // 选择多路复用器的当前列 digitalWrite(muxS0, bitRead(col, 0)); digitalWrite(muxS1, bitRead(col, 1)); digitalWrite(muxS2, bitRead(col, 2)); // 微小延迟，让多路复用器信号稳定 delayMicroseconds(10); for (int row = 0; row < 8; row++) { // 将当前行拉低 digitalWrite(rowPins[row], LOW); delayMicroseconds(10); // 稳定时间 // 读取Z端状态。由于启用了内部上拉，按键按下时应为LOW bool currentState = (digitalRead(muxZ) == LOW); // 将当前行恢复为高电平 digitalWrite(rowPins[row], HIGH); // 消抖逻辑 if (currentState != lastKeyState[row][col]) { debounceTime[row][col] = millis(); } if ((millis() - debounceTime[row][col]) > debounceDelay) { if (currentState != keyState[row][col]) { keyState[row][col] = currentState; // 触发MIDI事件 int noteNumber = calculateNoteNumber(row, col); // 根据行列计算对应的MIDI音符编号 if (keyState[row][col] == true) { // 发送 Note On， 通道1， 力度127 MIDI.sendNoteOn(noteNumber, 127, 1); } else { // 发送 Note Off， 通道1， 力度0 (或发送Note On with velocity 0) MIDI.sendNoteOff(noteNumber, 0, 1); } } } lastKeyState[row][col] = currentState; } } } int calculateNoteNumber(int row, int col) { // 这是一个映射函数，你需要根据自己绘制的矩阵图来定义 // 例如：右手键盘从C4（MIDI编号60）开始 int baseNote = 60; int noteOffset = row * 8 + col; // 简单的线性映射，实际可能不是线性的 return baseNote + noteOffset; }

3. 主循环：

void loop() { scanMatrix(); // 这里可以添加风箱信号的读取和发送 // readAndSendBellowsCC(); MIDI.read(); // 处理可能的传入MIDI消息（如果需要） }

注意：上面的MIDI.sendNoteOn是使用经典的硬件串口MIDI库的发送方式。如果你使用的是Pro Micro 并希望直接作为USB-MIDI设备，你需要使用usbMIDI库（如果板子支持）或配置MIDI Library使用USB接口。一个更直接的方法是使用Arduino IDE对32U4板子的原生支持，结合MIDIUSB库。代码需要相应调整，例如：

#include <MIDIUSB.h> // 发送Note On midiEventPacket_t noteOn = {0x09, 0x90 | channel, note, velocity}; MidiUSB.sendMIDI(noteOn); MidiUSB.flush();

具体用法请参考MIDIUSB库的示例。使用MIDI Library时，可以在初始化时选择Serial作为接口，而在32U4板子上，Serial就是USB虚拟串口，配合电脑端的虚拟MIDI驱动（如loopMIDI on Windows, IAC Driver on Mac）也能实现USB-MIDI功能。

4.3 左手贝司系统的特殊处理

左手贝司按钮通常排列复杂（斯特拉德拉系统），可能包含和弦按钮和低音按钮。其矩阵可能更庞大（例如12x6）。处理逻辑与右手类似，但需要注意：

1. 音符映射：贝司按钮的每个键通常对应一个固定的低音音符或一个和弦（大三、小三、属七等）。你需要在calculateNoteNumber函数或类似的映射函数中，为每个按钮位置预定义其发送的MIDI音符。一个和弦按钮可能需要同时发送3-4个Note On消息。
2. 多路复用器级联：如果需要读取的列线超过8条，可以将两个4051级联，或者使用更大通道的多路复用器（如74HC4067， 16通道）。
3. 压力感应（可选高阶改造）：如果想实现力度感应，需要在每个按键下安装力敏电阻或薄膜压力传感器，并通过模拟输入读取，这将是另一个维度的复杂工程。

5. 系统调试、优化与问题排查

5.1 常见问题与解决方案速查表

5.2 性能优化与功能增强

1. 降低扫描延迟：

• 减少延时：将delayMicroseconds(10)调整到最小稳定值（如2-5μs）进行测试。
• 并行化读取：如果GPIO充足，可以同时读取多根行线（例如，将8根行线连接到Arduino的同一个端口寄存器，如PORTD），通过直接读写寄存器来一次性设置或读取多个引脚的状态，这比digitalWrite/Read快一个数量级。
• 中断驱动（高阶）：可以为每一行或列连接一个二极管到中断引脚，当有任何按键按下时触发中断，然后再进行扫描定位。这能实现极低的按键延迟，但电路和代码更复杂。

2. 增加表现力控制：

• 触后（Aftertouch）：难度极高，需要在每个琴键下安装压力传感器。
• 滑音轮与调制轮：可以在琴体侧面加装两个标准电位器，连接到Arduino的模拟输入，映射为MIDI CC#1（调制）和CC#5（滑音时间）。
• 自定义控制器：利用多余的模拟或数字引脚，添加按钮、旋钮，映射为其他MIDI CC信息，控制效果器参数等。

3. 固化程序与美化：

• 调试完成后，将最终的校准参数（如风箱最小/最大值）保存到Arduino的EEPROM中，实现开机自动加载。
• 为改造后的琴内部做好线缆整理，使用热缩管、扎带，确保牢固可靠。
• 设计一个美观的外接接口面板，安装MIDI输出接口（DIN-5）、电源开关等，让改造看起来更专业。

完成这一切后，这台沉寂多年的Farfisa Syntaccordion将不再是孤立的古董。通过一根USB线，它便能融入你现代化的数字音乐工作流，在DAW中化身为任何你想要的乐器。从拆解测绘时的小心翼翼，到第一声MIDI音符从电脑音箱中响起的激动，整个过程充满了硬件黑客与音乐创客独有的乐趣。最大的挑战往往不是代码本身，而是对那个陌生电路板的耐心探索和理解。当你成功的那一刻，你会觉得这一切都是值得的。