从零打造无线蓝牙MIDI控制器：3D打印与开源硬件的音乐创客实践

1. 项目概述与核心价值

如果你和我一样，既是个音乐爱好者，又喜欢鼓捣硬件，那么“自己做一把能无线连接电脑的MIDI吉他”这个念头，肯定不止一次在脑子里闪过。市面上的MIDI控制器要么太贵，要么功能固定，总感觉少了点“自己说了算”的乐趣。这次，我们就来把这个念头变成现实，用3D打印和开源硬件，从头打造一把完全属于你自己的无线蓝牙MIDI控制器吉他。

这个项目的核心，是利用Adafruit的EZ-Key蓝牙模块和FLORA微控制器，将物理按钮的按压动作，转换成标准的MIDI信号，并通过蓝牙无线发送给电脑、平板甚至手机。整个外壳通过3D打印完成，你可以自由设计按钮的布局、数量，甚至外观。控制器上集成了炫酷的NeoPixels LED灯带和麦克风电平表，让演奏不仅有声音，更有视觉反馈。最终成品不仅是一个功能齐全的MIDI控制器，可以映射到任何DAW（数字音频工作站）或软音源上，还能变身成为游戏手柄或DJ控制器，可玩性极高。

整个制作过程，你会接触到3D建模与打印、电路焊接、嵌入式编程（主要是烧录固件和配置）以及MIDI协议的基础应用。无论你是想深入学习硬件开发，还是单纯想拥有一个独一无二的音乐玩具，这个项目都能给你带来满满的成就感和实用价值。接下来，我就把我从设计到调试的完整过程，以及踩过的那些坑，毫无保留地分享给你。

2. 核心硬件选型与设计思路拆解

在动手之前，理清整个系统的设计思路和为什么选择这些组件至关重要。这能让你在后续焊接和调试时，清楚地知道每一根线、每一个元件的作用，出了问题也能快速定位。

2.1 系统架构与信号流

这把无线MIDI吉他的核心逻辑其实很清晰：物理输入 -> 微控制器采集 -> 蓝牙发送 -> 电脑接收并映射为MIDI信号 -> 软音源发声。

1. 物理输入层：包括4个大尺寸的街机按钮和6个带LED的轻触开关。它们就是你的“琴弦”和“品格”，负责产生原始的触发信号。
2. 核心处理层：以FLORA微控制器为中心。它负责两件事：一是读取所有按钮的状态；二是驱动NeoPixels LED和麦克风放大器，实现灯光效果。但请注意，FLORA在这里不直接处理MIDI协议，它更像一个高效的“信号采集与转发员”。
3. 无线传输层：Adafruit Bluefruit EZ-Key模块是真正的明星。它被预先编程为一种蓝牙HID（人机接口设备）键盘。FLORA将哪个按钮被按下的信息，通过简单的电平信号告诉EZ-Key，EZ-Key则将其模拟为电脑键盘上某个键的按下动作（比如按下‘A’键）。
4. 软件映射层：在电脑端，我们需要一个“翻译官”，将接收到的键盘按键信号，转换成标准的MIDI信息（如“中央C音符开，力度100”）。这就是VMPK这类虚拟MIDI键盘软件的工作。
5. 音频输出层：DAW或独立软音源接收MIDI信息，生成对应的音频，通过你的声卡或电脑扬声器播放出来。

选择这种架构（EZ-Key模拟键盘）而非让FLORA直接通过USB或蓝牙发送MIDI，最大的好处是极致的兼容性和简便性。任何支持蓝牙键盘的设备（Windows, macOS, iOS, Android）都能即插即用，无需安装额外的驱动，大大降低了软件层面的门槛。

2.2 关键组件深度解析

为什么是这些元件？我们来逐一拆解：

• Adafruit Bluefruit EZ-Key：这是项目的无线心脏。它内部集成了蓝牙4.0（BLE）模块和预编程的键盘仿真固件。你只需要给它供电，并将按钮信号连接到其12个输入引脚（0-11）上，它就能在按钮按下时，向已配对的设备发送一个可配置的键盘按键码。其Vin引脚支持3V-16V宽电压输入，非常适合用3节或4节AAA电池供电。
• Adafruit FLORA：选择FLORA而非更常见的Arduino Uno或Pro Micro，主要基于三点：一是其圆形设计和缝纫孔，非常适合嵌入到这种不规则形状的穿戴或手持设备中，方便固定和走线；二是它原生支持3.3V逻辑电平，与EZ-Key和NeoPixels完美匹配，无需逻辑电平转换器；三是它体积小巧，功能足够（驱动LED、读取模拟麦克风信号）。
• NeoPixels & 麦克风放大器：这是营造氛围感的利器。4颗NeoPixels RGB LED可以编程实现任何灯光效果，如流水、呼吸、频谱响应。麦克风放大器（MAX4466）将环境声音或你演奏的音乐转换为模拟电压信号，FLORA读取后可以实时控制LED的亮度或颜色变化，形成一个随声音跳动的电平表，视觉效果拉满。
• 按钮的选择：4个30mm大号街机按钮用于和弦或主要触发，手感清脆，反馈明确；6个12mm带灯轻触开关用于旋律或功能键。带灯按钮的LED需要单独供电和控制，这里我们简化设计，让它们的LED常亮作为背光，由FLORA的3.3V引脚通过限流电阻供电。

注意：供电设计的考量。整个系统有两套供电：电池组通过拨动开关为整个系统供电。FLORA和EZ-Key都需要3V左右的电压。FLORA可以直接连接电池（VBat引脚），而EZ-Key连接电池的Vin引脚。NeoPixels和按钮LED对电流需求较大，尤其是全白光亮起时。3节AAA碱性电池（约4.5V）能提供约1A的瞬时电流，但长期使用建议用3节AAA镍氢充电电池（约3.6V）或一个小的3.7V锂电池，这对NeoPixels更友好，也更持久。务必确保电池盒的正负极连接正确，接反很可能瞬间烧毁微控制器或模块。

3. 3D建模、打印与外壳组装实战

外壳不仅是保护壳，更是决定手感、外观和内部布局的关键。原设计为左手习惯，我们需要将其改为右手习惯，并确保所有元件都能严丝合缝地安装。

3.1 使用Tinkercad进行右手化改造

原设计文件是STL格式，我们可以用免费的在线工具Tinkercad进行修改，无需掌握复杂的专业软件。

1. 导入与分解：首先，将下载的Base Frame.stl（琴身框架）和Neck Frame.stl（琴颈框架）分别导入Tinkercad。注意，一次只处理一个模型，保持工作区清晰。
2. 镜像操作：选中Base Frame模型，点击右上角工具栏的“调整”图标，选择“镜像”。你会看到模型周围出现三个带箭头的操纵杆。点击左右方向（红色）的箭头，模型会水平翻转。这就是将左手布局改为右手布局的全部操作。琴颈框架是对称的，通常无需修改。
3. 检查与导出：翻转后，仔细检查按钮孔位是否到了你舒适的另一侧。确认无误后，点击右上角“导出”，选择“下载用于3D打印的STL文件”。对琴颈框架也进行导出操作。

实操心得：按钮布局自定义。如果你觉得默认的按钮间距不适合你的手型，完全可以自定义。导入原始的、没有开孔的“空白”框架STL文件（通常原作者会提供），然后在Tinkercad中创建圆柱体作为“孔”对象，调整其直径与你实际购买的按钮尺寸完全一致（建议用游标卡尺精确测量），并将其设置为“空心”。将这些空心圆柱体移动到框架上你想要的任何位置，然后与框架模型“组合”，就能打出全新的孔位。这是发挥创造力的好机会，比如为拇指增加一个额外的控制键。

3.2 3D打印参数与技巧

打印质量直接影响到按钮的顺滑度和外壳的强度。以下是经过实测的推荐参数（以PLA材料为例）：

• 为什么用裙边不用底座(Raft)：底座虽然附着牢固，但会在模型底部留下一层粗糙的网格，很难清理，影响外观和贴合度。裙边只在模型外围打印一圈薄层，既能增加附着防止翘边，又易于剥离，能获得更光滑的底面。
• 现场调平(Live Leveling)：这是个高级技巧但非常有效。在打印第一层时，仔细观察挤出的塑料线是否均匀地压在平台上，既不能太扁（导致喷嘴刮擦），也不能太圆（附着不牢）。如果发现某一边隙过大或过小，可以极其轻微地旋转打印平台下方的调平旋钮进行微调。这需要一点耐心，但能极大提升首层成功率。
• 取下打印件：等待平台完全冷却后，使用塑料铲或专用铲刀，从边角小心地切入模型与平台之间。切忌用金属工具生撬，极易划伤平台涂层。对于大面积打印件，可以尝试轻轻弯曲柔性构建板（如果有），让模型自行剥离。

3.3 外壳清理、组装与磁吸设计

打印完成后，支撑材料（如果用了）和裙边需要仔细清除。用指甲钳或精细镊子处理细小部分。

1. 框架拼接：琴身和琴颈框架通过侧面的4个螺丝孔对齐，用4颗M3*10mm的自攻螺丝或带螺母的机械螺丝固定。先不要拧得太紧，对齐所有孔位后再逐一上紧。确保两个框架连接后成一条直线。
2. 磁铁安装：这是实现盖板快拆的精华设计。你需要准备12颗直径6mm，厚度2-3mm的钕铁硼强磁铁（每对框架和盖板需要3对，共6对）。
   • 步骤：先在框架的磁铁柱凹槽内点一滴超级胶（氰基丙烯酸酯），然后迅速将一颗磁铁按入，N极或S极朝外均可，但必须记录朝向。
   • 极性测试：将对应的盖板拿过来，用另一颗磁铁在盖板的凹槽处试探。确保盖板上的磁铁与框架上的磁铁是异极相对（相互吸引）。一旦确认，立即用同样方法将磁铁粘在盖板上。务必逐个配对进行，否则一旦全部粘完发现极性反了，撬下来会非常困难。
   • 技巧：可以用马克笔在框架和盖板的磁铁旁做上相同的极性标记（如“+”代表此面为N极），避免混乱。

避坑指南：按钮安装测试。在焊接任何电路之前，务必把所有按钮（4个大街机按钮和6个带灯小按钮）先安装到打印好的面板上试试。有时候打印收缩会导致孔位略小，按钮塞不进去。这时可以用小圆锉刀或砂纸轻轻打磨孔的内壁，切忌用力过猛或使用刀具削，容易导致孔洞变形或破裂。确保所有按钮都能稳固卡住或拧紧。

4. 电路焊接与内部布线全流程

这是最需要耐心和细心的环节。总共70多个焊点，规划好顺序和走线能让你事半功倍。

4.1 焊接前的规划与测试

“谋定而后动”在电子制作中永远是金科玉律。

1. 分模块测试：千万不要把所有元件焊死再通电。务必分两步测试：
   • 蓝牙模块与按钮测试：在面包板上，仅连接EZ-Key模块、一个按钮和电池。将按钮一端接EZ-Key的某个输入引脚（如#0），另一端接地。给EZ-Key通电，用手机或电脑蓝牙搜索并配对“Adafruit EZ-Key”。打开一个记事本，按下按钮，看是否输出了默认的按键（如方向键）。这验证了无线传输和按钮通路是好的。
   • FLORA与灯效测试：在另一个面包板上，连接FLORA、一颗NeoPixel、麦克风模块和电池。通过USB线将FLORA连接到电脑，用Arduino IDE上传一个简单的NeoPixel测试程序（如Adafruit NeoPixel库中的示例代码），并上传麦克风电平表示例代码。这验证了FLORA的主控功能和传感器输入输出是正常的。
2. 线材测量与标记：使用30AWG的硅胶线，它柔软、耐热、不易短路。根据元件在壳体内的实际位置，估算每条连接线的长度，并留出约2-3厘米的余量以便后期整理。用不同颜色的线区分正极（红色）、负极（黑色/蓝色）和数据信号线（黄色/绿色等）。剪好线后，立即用标签纸或胶带标记每根线的两端（如“Neo1-DIN”、“Btn1-LED+”），这是后期排查错误的生命线。

4.2 分步焊接详解

建议按以下顺序焊接，从内到外，从核心到外围：

第一步：焊接琴颈部分（NeoPixels与麦克风）

1. 将4颗NeoPixels按顺序焊接在一起：第一颗的DIN（数据输入）接FLORA的D6引脚，DOUT（数据输出）接第二颗的DIN，以此类推。最后一颗的DOUT悬空。所有NeoPixels的VCC（5V）并联后接FLORA的VBat（或3V，但亮度会稍低），所有GND并联后接FLORA的GND。注意数据流方向不要接反。
2. 焊接麦克风放大器：VCC接FLORA的3V，GND接GND，OUT接模拟引脚A9（在FLORA上标记为D9）。
3. 将焊好的NeoPixels条和麦克风模块，按照琴颈框架内部的卡槽位置放置，可以用一点点热熔胶固定。

第二步：焊接LED按钮

1. 6个带灯按钮，每个都有4个引脚：两个是开关引脚，两个是LED引脚（正负极）。用万用表蜂鸣档区分。
2. LED部分：将所有按钮的LED正极（通常较长或标有“+”）并联，然后通过一个220欧姆的限流电阻，连接到FLORA的VBat（或3V）引脚。将所有LED负极并联，连接到FLORA的一个GND引脚。这样只要FLORA通电，按钮灯就会常亮。
3. 开关部分：每个按钮的一个开关引脚并联后，接到一个公共的GND（可以复用LED的GND，或接EZ-Key的GND）。每个按钮的另一个开关引脚，则分别用独立的导线，准备连接到EZ-Key的输入引脚#0到#5。

第三步：安装核心主板（FLORA与EZ-Key）

1. 固定：在琴身框架中部的凹槽和上部的凹槽里，分别贴上双面泡沫胶，然后将FLORA和EZ-Key模块粘上去。泡沫胶既能固定又能减震。
2. 供电连接：
   • 将电池盒的正极（红线）连接到拨动开关的中间引脚。
   • 将拨动开关的一个外侧引脚，用两根线分别连接到FLORA的VBat和EZ-Key的Vin。这就是供电正极。
   • 将电池盒的负极（黑线）和拨动开关的另一个外侧引脚（如果需要）直接连接到FLORA的一个GND引脚，并从这个GND引出一根线到EZ-Key的GND。确保整个系统共地。
3. 信号连接：
   • 将6个LED按钮开关的信号线（来自第二步），分别焊接到EZ-Key的#0至#5引脚。
   • 将4个大街机按钮的信号线（每个按钮一脚接公共GND，另一脚作为信号），分别焊接到EZ-Key的#6至#9引脚。
   • 关键：EZ-Key的#10和#11引脚是预留的，你可以选择接更多按钮，或者像我的做法一样，将#10连接到FLORA的一个数字引脚（如D10），这样你可以在代码中让FLORA检测这个按钮，用来切换NeoPixels的灯光模式。

第四步：整合与走线所有线缆应从琴颈框架和琴身框架连接处的预留通道穿过。用扎带或胶带将线束捆扎整齐，避免杂乱。确保盖板合上时，不会压到或挤压任何电线或元件。

焊接核心技巧：先镀锡，再对接。焊接时，先在元件的焊盘和导线的线头上各自单独上一层薄薄的焊锡（称为“镀锡”）。然后将两者对准接触，用烙铁头同时加热两者，待原有的焊锡熔化流动在一起后移开烙铁。这样得到的焊点牢固、光滑，避免虚焊。焊接EZ-Key和FLORA的引脚时，烙铁温度控制在320°C-350°C，速度要快，避免长时间加热损坏芯片。

5. 软件配置与MIDI映射终极指南

硬件组装完毕，只是成功了一半。让它在电脑上“唱起歌来”才是最终目标。

5.1 重映射EZ-Key按键编码

默认情况下，EZ-Key的12个按钮被映射为方向键、回车、空格等。这些键位可能与你的DAW快捷键冲突，或者不适合触发音符。我们需要将其重映射为普通的字母键。

1. 进入配置模式：确保EZ-Key已断电。用一根导线，短暂连接其DFU引脚到GND引脚，然后上电。此时EZ-Key上的LED会快速闪烁，表示进入“配置模式”。
2. 蓝牙连接配置：用电脑或手机搜索蓝牙设备，会发现一个名为“Adafruit EZ-Key Config”的设备，配对连接（无需密码）。
3. 使用配置工具：Adafruit提供了网页版和桌面版的配置工具。我推荐使用网页版，打开浏览器访问其指定页面（教程中有链接），页面会自动通过Web Bluetooth API连接你的EZ-Key。
4. 修改键值：在配置界面，你会看到12个输入通道（Pin #0 - #11）的映射表。将每个通道的“Key”值修改为你想要的字母。例如，我习惯将#0-#9映射为字母A-J。你还可以设置“Modifier”（如Ctrl、Shift）和触发模式。修改后，点击“Write”写入模块。
5. 重启测试：断开EZ-Key电源，移除DFU和GND之间的短路线，重新上电。现在它应该以普通“Adafruit EZ-Key”的名称出现，重新配对后，按下按钮，在记事本里输入的应该就是你设置的字母了。

5.2 搭建虚拟MIDI桥梁：VMPK详解

VMPK是一个免费开源的虚拟MIDI键盘软件，它的作用就是将键盘按键转化为MIDI信号。

1. 安装与基础设置：从官网下载安装VMPK。打开后，首先在菜单栏的Edit -> Preferences中，确保“MIDI Output”选择了一个可用的虚拟端口（如Windows的“Microsoft GS Wavetable Synth”或“VMPK Output”，macOS的“IAC Driver Bus 1”）。这个端口将是MIDI信号的出口。
2. 键盘映射：点击File -> Keyboard Map，打开映射编辑器。界面左侧是一排钢琴键，右侧是映射表。假设你的EZ-Key按钮#0现在对应键盘字母A。你想让按下A时触发中央C（MIDI音符编号60）。找到映射表中“Key”为A（或对应的键码）的那一行，双击“Note”列下的数字，将其改为60。依次类推，将B-J映射为你想要的音阶音符（如61, 62, ...）。
3. 通道与力度：你还可以设置每个键触发的MIDI通道（通常为1）和默认力度值（建议设为100，代表中等响度）。
4. 保存配置：映射完成后，点击“Save as XML”保存你的配置文件。这样下次换一首歌或换一套音色时，可以直接加载，无需重新设置。

5.3 在DAW中完成闭环

现在，MIDI信号已经从你的硬件吉他，通过蓝牙，被VMPK转换，并从虚拟端口输出了。最后一步是在DAW中接收它。

1. 创建MIDI轨道：在你的DAW（如Ableton Live, FL Studio, Logic Pro等）中，新建一条MIDI轨道。
2. 设置输入：在该轨道的输入设置中，选择VMPK输出的那个虚拟MIDI端口（如“VMPK Output”）。
3. 加载乐器：在该轨道上加载一个你喜欢的软件乐器（VSTi, AU插件等）。
4. 尽情演奏！现在，按下你吉他上的按钮，DAW里的软音源就应该发出对应的声音了。如果没声音，请依次检查：蓝牙是否连接、VMPK的MIDI输出端口是否选对、DAW的MIDI轨道输入是否选对、轨道监听是否打开、乐器插件是否加载成功。

高级技巧：映射控制变化（CC）信息。除了触发音符，你还可以让按钮发送控制信号。在VMPK的键盘映射中，将“Note”模式改为“CC”（控制变化），并指定一个CC编号（如1是调制轮，7是音量）。然后在DAW中，你可以将这个CC信息映射到任何参数上，比如滤波器截止频率、效果器混响大小等，让你的吉他瞬间变成一个动态控制器。

6. 故障排查与性能优化实录

制作过程中，你几乎一定会遇到一些问题。这里是我遇到的和可能遇到的典型问题及解决方案。

6.1 硬件故障排查表

6.2 软件与通信问题

• DAW收不到MIDI信号：这是最常见的问题。90%的原因出在MIDI路由上。请严格按照以下链条检查：
  1. 硬件按钮 -> 触发键盘按键（用记事本测试）。
  2. VMPK是否正确接收到了该键盘按键（按下按钮时，VMPK界面对应的虚拟键应高亮）。
  3. VMPK的MIDI输出端口是否已选择并开启。
  4. DAW的MIDI轨道输入，是否选择了VMPK输出的那个端口。
  5. 该MIDI轨道的“监听”或“输入启用”按钮是否打开。 可以尝试在DAW中打开“MIDI输入指示器”，看是否有信号进入，这是最直接的诊断方法。
• 蓝牙连接不稳定或延迟大：确保吉他和使用设备之间没有过多的金属物体或强Wi-Fi信号干扰。尽量在开阔无遮挡的环境下使用。对于专业演出，如果延迟无法接受，可以考虑未来升级为使用ESP32等支持低延迟蓝牙音频（BLE Audio）或专用2.4GHz无线方案的模块。

6.3 结构与耐用性优化

• 按钮松动：如果打印的按钮孔稍大，可以在按钮卡扣的边缘缠绕一两圈电工胶带，再卡进去，增加摩擦力。
• 线材磨损：所有穿过框架连接处的线缆，最好用热缩管或螺旋缠绕管进行保护，避免外壳反复开合磨损线皮导致短路。
• 提升手感：对于街机按钮，可以尝试更换不同克数的微动开关。对于轻触按钮，可以在内部粘贴一小块海绵或橡胶垫，改变按下的触感和声音。

完成所有步骤后，你拥有的不仅仅是一个控制器，而是一个可无限扩展的平台。你可以为FLORA编写更复杂的灯光程序，让它随音乐节奏变化；可以增加陀螺仪，用倾斜角度控制弯音；甚至可以增加一个屏幕来显示当前音色。这把由你亲手创造的吉他，其边界只取决于你的想象力。