1. 项目概述当物理旋钮遇见数字暗房如果你和我一样是个重度Lightroom用户同时又对硬件DIY有点手痒那你肯定也经历过这种纠结用鼠标和键盘调整照片的曝光、对比度、色调总觉得少了点“手感”。那种精准、顺滑、带有物理反馈的调节体验是屏幕滑块永远给不了的。市面上当然有专业的调色台比如Loupedeck、TourBox但它们要么价格不菲要么功能固定很难完全贴合你个人的工作流。于是一个念头就冒出来了为什么不自己做一个这就是“Schwurbler”项目的由来。Schwurbler这个词在德语里大概有“旋转”、“搅动”的意思非常形象地描绘了它的核心——一堆可以让你“旋”起来的物理控制器。本质上它是一个基于Arduino的DIY MIDI控制器专门为Adobe Lightroom Classic设计。通过几个旋钮、推子和按钮你可以将最常用的图像调整参数映射到实体控件上实现更直观、更高效的后期处理。这个项目适合谁首先你得是Lightroom的活跃用户对它的基本调整面板如基本、色调曲线、HSL操作熟练。其次你需要具备一点动手能力和学习的耐心毕竟涉及到简单的电路焊接和代码上传。但别怕它不需要你成为电子工程师或编程大神。Arduino生态的友好之处就在于有大量现成的库和社区支持让硬件小白也能一步步跟着做出能用的东西。最后也是最重要的你得享受这种“创造工具”的乐趣。自己做的控制器每一个旋钮的阻尼手感、每一颗按钮的布局都完全由你定义这种成就感和定制化是买成品无法比拟的。2. 核心思路与方案选型为什么是Arduino MIDI在动手之前我们先得把设计思路理清楚。做一个Lightroom控制器技术路径有好几种为什么最终主流方案都落在了“Arduino模拟MIDI设备”这条路上这背后是成本、复杂度、兼容性和可扩展性的综合考量。2.1 主流方案对比与取舍最直接的想法可能是让Arduino直接通过USB模拟键盘或鼠标发送快捷键。比如转动旋钮就相当于按键盘上的“↑”和“↓”。这个方案简单粗暴但问题很大首先它独占你的键盘输入你在调整时没法打字其次控制精度低很难实现细腻的、带加速的连续调节最后功能单一一个旋钮只能绑定一个固定操作缺乏灵活性。另一种方案是让Arduino通过串口Serial直接与Lightroom通信。这需要Lightroom有开放的API并且你需要编写复杂的插件来桥接。对于个人DIY项目来说这个门槛太高且稳定性存疑。而MIDI协议原本是为音乐设备设计的但它“控制改变Control Change CC”消息的机制完美契合了图像参数调节的需求。一个CC消息包含一个控制器编号0-127和一个值0-127转动旋钮就是连续发送不同值的CC消息。Lightroom本身并不原生支持MIDI但有一个强大的桥梁软件——MIDI2LR。这个免费开源软件的作用就是监听电脑上的MIDI输入并将其映射为Lightroom的具体操作如增加曝光度、调整色温等。因此我们的技术栈就明确了Arduino硬件核心 MIDI库通信协议 MIDI2LR软件桥接 Lightroom最终应用。这个组合的优势非常明显低成本与高可玩性Arduino Uno板子几十块钱电位器、编码器、按钮等元件更是白菜价总成本可以轻松控制在百元以内。高兼容性与易用性MIDI是跨平台的通用协议macOS和Windows都完美支持。MIDI2LR软件成熟稳定配置界面直观。高自由度与可扩展性你可以决定控制器的尺寸、形状、控件数量和布局。今天我做6个旋钮明天我就能加一排按钮和一个小屏幕。即插即用一旦配置好Arduino会被电脑识别为一个标准的MIDI设备插上USB就能用无需每次启动都进行复杂设置。2.2 硬件核心Arduino的选型考量“Arduino”是一个大家族对于Schwurbler这样的项目最常见的选择是Arduino Uno R3。选择它理由很充分引脚数量14个数字IO6个模拟输入对于初版控制器绰绰有余USB接口是标准的Type-B连接稳定社区支持最广泛任何你遇到的问题几乎都能找到答案。它的性能处理几十个模拟输入和MIDI数据流完全不在话下。如果你的设计非常紧凑或者想做成无线版本那么Arduino Leonardo或Pro Micro是更好的选择。它们使用的ATmega32U4芯片原生支持USB通信可以直接被识别为“键盘”、“鼠标”或“MIDI设备”无需额外的USB转MIDI芯片电路更简洁。但对于初学者Uno的稳定性和易调试性仍是首选。至于网络热词中提到的ESP32它性能更强且自带Wi-Fi/蓝牙更适合做物联网或需要无线传输的复杂项目。对于单纯的USB MIDI控制器Uno的简单可靠就是最大的优点杀鸡无需用牛刀。2.3 输入设备旋钮、编码器与按钮这是决定手感和功能的关键。电位器模拟旋钮最基础的模拟输入元件。它输出的是模拟电压0-5VArduino通过模拟引脚读取并转换为0-1023的数字值。它的优点是价格极低电路简单。缺点是物理上有旋转范围限制通常300度且是模拟信号可能存在轻微的抖动噪声。适合用于曝光、对比度这种需要绝对位置感的参数。旋转编码器数字旋钮它输出的是脉冲信号告诉你“向左转了一格”或“向右转了一格”没有物理终点可以无限旋转。通过代码可以轻松实现加速功能转得快变化快。手感更接近高级调音台的无极旋钮。电路和代码比电位器稍复杂但能提供更现代的控制体验非常适合快速浏览照片、调整HSL等操作。按钮与开关用于触发动作如切换前后对比Y键、复制粘贴设置、切换工具等。选择带帽的轻触开关即可注意选择常开型。实操心得对于最重要的几个参数如曝光、对比度我强烈建议使用高品质的电位器例如ALPS或国产同等级别的产品。劣质电位器用久了会有噪音和跳值严重影响体验。编码器则可以选择带按键功能的型号按下旋钮本身也是一个按钮节省空间实现更多功能。3. 电路设计与核心代码解析有了方案我们就进入实战环节。我们先从最经典、最稳定的“Arduino Uno 模拟电位器”组合开始这是理解整个系统的最佳起点。3.1 基础电路搭建从第一个旋钮开始假设我们先做三个旋钮分别控制Lightroom的曝光度Exposure、对比度Contrast和高光Highlights。所需材料清单Arduino Uno R3 开发板 x110kΩ 线性电位器B型x3面包板 x1 及若干杜邦线公对公USB A to B 数据线 x1电路连接这是关键每个电位器有三个引脚。我们将电位器看作一个可调电阻分压器。左侧引脚连接到Arduino的5V引脚。右侧引脚连接到Arduino的GND接地引脚。中间引脚滑片这是信号输出端连接到Arduino的模拟输入引脚。例如分别连接到A0, A1, A2。 这样当旋转旋钮时中间引脚的电压会在0V到5V之间线性变化对应Arduino读取的模拟值从0到1023。注意务必使用线性电位器B型而不是指数型A型或对数型C型。音频设备常用指数型电位器来符合人耳听觉特性但我们需要的是旋转角度与电阻值电压值呈线性关系这样才能保证旋钮转动和参数变化是均匀的。3.2 核心代码实现让Arduino“说”MIDI语言要让Arduino发送MIDI信息我们需要借助一个库。最常用的是MIDIUSB库适用于Leonardo/Pro Micro等原生USB芯片或Arduino MIDI Library。对于Uno我们通常使用后者并结合电脑端的“Hairless MIDI”这类串口转MIDI桥接软件。但这里我介绍一个更“干净”的方案使用MIDIUSB库和一款叫HIDUINO的固件或使用LUFA库可以将Uno直接模拟为USB MIDI设备免去桥接软件的麻烦。不过这对新手稍复杂。为了最快速上手我们采用“Arduino Uno Arduino MIDI Library Hairless MIDI”这条经典路径。虽然多了一个软件环节但稳定性极高且易于调试。第一步安装库在Arduino IDE中点击“工具” - “管理库...”搜索“MIDI Library”找到由 Francois Best维护的版本并安装。第二步编写并上传代码#include MIDI.h // 引入MIDI库 // 创建MIDI接口实例通过硬件串口Serial发送数据 MIDI_CREATE_DEFAULT_INSTANCE(); // 定义三个旋钮连接的模拟引脚 const int potPin1 A0; // 曝光度 const int potPin2 A1; // 对比度 const int potPin3 A2; // 高光 // 存储每个旋钮上一次读取的值用于检测变化 int lastPotValue1 0; int lastPotValue2 0; int lastPotValue3 0; // 设置一个阈值防止电位器微小抖动误触发 const int threshold 4; void setup() { // 初始化MIDI通信速率通常为31250 bps但通过串口桥接时常用9600或115200 // 我们先用115200方便调试在Hairless软件中需设置相同速率 Serial.begin(115200); MIDI.begin(); // 初始化MIDI库 } void loop() { // 读取所有电位器的当前值0-1023 int potValue1 analogRead(potPin1); int potValue2 analogRead(potPin2); int potValue3 analogRead(potPin3); // 将0-1023的值映射到MIDI的0-127范围 int midiValue1 map(potValue1, 0, 1023, 0, 127); int midiValue2 map(potValue2, 0, 1023, 0, 127); int midiValue3 map(potValue3, 0, 1023, 0, 127); // 检查旋钮1的值是否有显著变化 if (abs(midiValue1 - lastPotValue1) threshold) { // 发送MIDI控制改变消息通道1控制器编号10可任意设定需与MIDI2LR对应当前值 MIDI.sendControlChange(10, midiValue1, 1); lastPotValue1 midiValue1; // 更新上一次的值 } // 同理处理旋钮2和3使用不同的控制器编号 if (abs(midiValue2 - lastPotValue2) threshold) { MIDI.sendControlChange(11, midiValue2, 1); lastPotValue2 midiValue2; } if (abs(midiValue3 - lastPotValue3) threshold) { MIDI.sendControlChange(12, midiValue3, 1); lastPotValue3 midiValue3; } // 短暂延迟降低CPU占用也避免MIDI消息洪水 delay(10); }代码关键点解析map()函数这是核心它将模拟读数的宽广范围1024级压缩到MIDI的标准范围128级。虽然精度有损失但对于图像调整的128级精度完全足够且符合协议标准。threshold阈值模拟电位器会有信号噪声阈值过滤能确保只有真实的用户操作才触发MIDI消息避免界面数值“跳舞”。MIDI.sendControlChange(controller, value, channel)这是发送指令的函数。controller控制器编号是我们在MIDI2LR里用来区分不同旋钮的ID可以设为0-127任意值。channel通道通常设为1。第三步配置桥接软件Hairless MIDI下载并运行Hairless MIDI。在“Serial Port”中选择你的Arduino串口如COM3或/dev/tty.usbmodemXXX。将“Serial Baud Rate”设置为与代码中一致的115200。在“MIDI Out”中选择“MIDI2LR Virtual Input”或你的DAW/其他MIDI软件。点击“Pair”按钮建立连接。此时转动旋钮你应该能在Hairless界面看到MIDI消息日志。3.3 引入旋转编码器无限旋转与加速功能电位器有物理终点调整大范围参数时需要来回拧。旋转编码器则没有这个限制。我们以常见的增量式编码器带方向信号A、B和接地GND为例。电路连接编码器一般有5个引脚CLKA相、DTB相、SW按键、、GND。CLK (A)和DT (B)分别连接到Arduino的数字引脚例如 2 和 3。这两个引脚需要启用内部上拉电阻。SW如果存在连接到另一个数字引脚如4。连接到5V。GND连接到GND。代码实现使用Encoder库#include MIDI.h #include Encoder.h // 需要安装Encoder库 MIDI_CREATE_DEFAULT_INSTANCE(); // 初始化编码器连接引脚2和3 Encoder myEncoder(2, 3); long oldPosition -999; // 存储旧位置 void setup() { Serial.begin(115200); MIDI.begin(); } void loop() { // 读取编码器当前位置每转一格变化4 long newPosition myEncoder.read() / 4; // 除以4得到更直观的“格数” if (newPosition ! oldPosition) { // 计算变化量 long change newPosition - oldPosition; oldPosition newPosition; // 将变化量映射到MIDI值变化这里实现一个简单的加速逻辑 int midiChange change; // 基础变化量 if (abs(change) 3) { // 如果转动很快增大变化量 midiChange change * 2; } // 假设我们用一个变量来跟踪当前的MIDI值0-127 static int currentMidiValue 64; // 初始值在中间 currentMidiValue midiChange; // 确保值在0-127范围内 currentMidiValue constrain(currentMidiValue, 0, 127); // 发送MIDI CC消息假设控制器编号为20 MIDI.sendControlChange(20, currentMidiValue, 1); // 串口打印调试信息 Serial.print(Encoder Pos: ); Serial.print(newPosition); Serial.print( | MIDI Value: ); Serial.println(currentMidiValue); } delay(5); }这段代码实现了编码器的基本读取和加速逻辑。Encoder库帮我们处理了A、B相的抖动和方向判断。加速逻辑可以根据转动速度动态调整参数变化步长这在快速调整色温或色调时非常实用。4. 软件桥接与映射MIDI2LR深度配置硬件和固件只是半边天让Lightroom听懂MIDI指令全靠MIDI2LR。它的配置逻辑是核心中的核心。4.1 MIDI2LR安装与基本连接从GitHub下载MIDI2LR的最新版本并安装。启动MIDI2LR它会常驻在系统托盘Windows或菜单栏macOS。确保你的Arduino通过Hairless MIDI已被识别为MIDI输入设备。在MIDI2LR的“MIDI Inputs”中应该能看到它并确保其被勾选。启动Lightroom Classic。MIDI2LR会自动检测并连接。4.2 创建个性化映射配置文件MIDI2LR的界面左侧是Lightroom的所有可映射命令从基本的曝光度、对比度到局部调整画笔、渐变滤镜的流量、密度甚至是可以执行自定义快捷键的“按钮”命令一应俱全。映射步骤在MIDI2LR主界面找到你想映射的命令例如“Exposure”。用鼠标点击“Exposure”这一行右侧的“Learn”按钮按钮会变成红色并显示“Learning...”。立即去转动你想要绑定的那个物理旋钮。MIDI2LR会捕捉到Arduino发送的MIDI CC消息。捕捉成功后“Learn”按钮恢复原状并且该命令右侧会显示绑定的MIDI通道和控制器编号如“Ch.1 CC10”。重复这个过程绑定所有旋钮和按钮。高级配置技巧相对模式 vs. 绝对模式对于编码器你需要在命令上右键选择“Relative”模式。这样编码器发送的“增加”或“减少”信号才会被正确解读。对于电位器则使用默认的“Absolute”绝对模式。加速曲线在命令上右键可以设置“Acceleration”。对于编码器设置一个加速曲线可以让快速转动时参数变化更快提高效率。按钮的触发模式将按钮映射到“按钮”命令如“Toggle Before/After”切换前后对比时通常使用“Momentary”瞬时模式按下触发松开不动作。也可以设置为“Toggle”开关模式。配置文件管理配置完成后务必通过“File - Save Profile”保存你的映射文件。这样重装系统或换电脑时只需加载这个文件即可。实操心得我的建议是先映射你最核心的10-12个参数形成一个肌肉记忆。我的核心布局通常是左手区电位器控制曝光、对比、高光、阴影、白色色阶、黑色色阶右手区编码器控制色温、色调、鲜艳度、饱和度一排按钮负责裁剪、污点去除、渐变滤镜、径向滤镜、Y键对比、复制设置、粘贴设置。这个布局覆盖了80%的日常操作。5. 外壳设计与制作从面包板到正式产品当所有功能在面包板上测试无误后就该考虑给它一个“家”了。一个好的外壳不仅能保护电路更能极大提升使用体验和专业感。5.1 设计考量与材料选择布局与人体工学根据你的操作习惯左撇子/右撇子、桌面空间和常用参数规划旋钮和按钮的位置。最常用的旋钮如曝光应该放在最顺手的位置。考虑旋钮的高度和间距避免误触。尺寸与结构内部需要容纳Arduino主板、面包板或定制PCB、以及所有连接线。确保有足够的空间并考虑散热和走线。外壳通常分为上盖面板和下盖底座。材料亚克力激光切割最流行的DIY选择。设计好图纸在淘宝找店家切割成本低效果美观精度高。可以叠加多层不同颜色的亚克力来制造层次感。3D打印PLA/ABS自由度最高可以制作出复杂曲面和内部卡扣结构。需要学习简单的3D建模如Tinkercad, Fusion 360。缺点是表面质感可能不如亚克力光滑需要打磨处理。木材如果你有木工工具和技能木质外壳会有独特的温润质感。但加工精度要求高且不便于开孔。5.2 面板制作与元件固定这是最考验耐心和细心的环节。开孔根据电位器/编码器的轴径和按钮的直径在面板上精确开孔。对于亚克力可以在激光切割图纸上直接画出圆孔。对于3D打印在模型里预留孔位。孔径最好比轴径略小约0.1-0.2mm这样元件才能卡紧不晃动。固定元件电位器通常自带螺母。将电位器从面板正面插入背面用配套的螺母和垫片拧紧固定。可以在面板和电位器之间加一个装饰垫圈更美观。编码器同样用螺母固定。注意编码器底部可能有多个引脚确保面板厚度不会导致引脚顶到内部电路板。按钮轻触开关一般需要焊接在电路板上其按钮帽从面板孔中伸出。内部走线与组装从面包板迁移到穿孔板或定制PCB为了稳固建议将电路焊接在万用穿孔板洞洞板上或者更进一步设计一块简单的PCB嘉立创等平台打样非常便宜。这能极大提升可靠性。使用排线和接插件不要将所有线直接焊死在Arduino上。使用排线母座和杜邦线连接方便日后维修和升级。理线与固定使用扎带或热熔胶将内部线材整理固定避免松动导致短路或接触不良。5.3 美化与标识面板标识可以用雕刻机在亚克力上刻字或者用3D打印做出凸起文字。更简单的方法是使用标签打印机打印出精致的标签贴上去或者购买现成的旋钮帽上面通常已经印有参数名称。旋钮帽选择不同颜色、形状和材质的旋钮帽不仅能提升颜值还能通过触觉快速区分不同功能。例如曝光旋钮用大的、带凹槽的金属帽对比度用中等大小的塑料帽。6. 进阶优化与功能扩展基础版控制器工作后你可以根据自己的需求进行各种升级让它变得更强大、更智能。6.1 增加视觉反馈状态指示灯与OLED屏幕物理旋钮的缺点是不知道参数的当前绝对值除非看屏幕。我们可以增加反馈。LED指示灯例如用一个RGB LED环套在旋钮上通过颜色表示参数范围如蓝色表示负值绿色表示中间红色表示正值。这需要额外的PWM引脚和控制代码。小型OLED屏幕I2C接口这是终极解决方案。一块0.96寸的OLED屏幕可以显示当前激活的控制组、旋钮对应的参数名和实时数值。当你在Lightroom中切换模块如从“基本”切换到“色调曲线”时屏幕内容可以随之改变。这需要编写更复杂的代码来与Lightroom通信MIDI2LR支持发送反馈信息但需要配置实现双向通信。6.2 实现“Bank”切换用有限控件控制无限参数控制器面板空间有限不可能放下所有Lightroom参数。这时可以引入“Bank”库/组切换功能。增加两个按钮标记为“Bank Up”和“Bank Down”。在代码中定义多个“控件映射表”。例如Bank 1时旋钮1-6映射曝光、对比度等基本参数按下“Bank Down”切换到Bank 2此时同样的6个旋钮映射为HSL色相、饱和度、明亮度中的红色、橙色、黄色控制。通过OLED屏幕或LED指示灯显示当前处于哪个Bank。 这样你的6旋钮控制器就拥有了控制数十个参数的能力。6.3 提升手感与稳定性硬件层面的打磨更换高品质编码器廉价的编码器手感生涩、有顿挫感。更换为ALPS、博世等品牌的编码器手感顺滑寿命更长。添加电容滤波在每个电位器的信号线和地线之间并联一个0.1uF的陶瓷电容可以显著滤除高频噪声使读数更稳定。使用屏蔽线如果控制器体积较大内部连线较长对于模拟信号线使用屏蔽线可以防止干扰。电源净化如果使用外部电源非USB供电考虑增加稳压模块为模拟电路部分提供更干净的电源。7. 常见问题排查与调试心得实录DIY过程中你一定会遇到各种各样的问题。这里记录了我踩过的坑和解决方法。问题现象可能原因排查步骤与解决方案MIDI2LR检测不到设备1. Hairless MIDI未正确连接或设置。2. Arduino代码串口波特率与Hairless设置不一致。3. 系统MIDI驱动问题。1. 检查Hairless串口选择是否正确“Pair”是否点亮MIDI Out是否指向MIDI2LR2. 核对代码Serial.begin()与Hairless的“Serial Baud Rate”是否完全相同如115200。3. 重启MIDI2LR和Lightroom。在macOS的“音频MIDI设置”或Windows的“MIDI-OX”软件中查看是否有设备出现。旋钮控制不跟手有延迟1. 代码中delay()时间过长。2. 电位器质量差噪声大阈值(threshold)设得太高。3. MIDI消息发送过于频繁。1. 减少loop()中的delay尝试改为5ms或更短。2. 尝试降低threshold值如从4改为2或在硬件上并联滤波电容。3. 确保只在模拟值变化时才发送MIDI消息代码中已实现。旋钮跳到最大值或最小值1. 电位器接线错误或接触不良。2. 代码中map()函数范围错误。3. 模拟引脚未启用内部上拉仅对某些电路。1. 用万用表检查电位器两端电压是否为稳定的5V和0V中间引脚电压是否随旋转平滑变化。2. 检查map(potValue, 0, 1023, 0, 127)参数是否正确。3. 对于分压电路通常不需要启用内部上拉。编码器读数混乱正转反转识别错误1. 编码器A、B相引脚接反。2.Encoder库初始化引脚顺序错误。3. 编码器质量差信号抖动。1. 交换连接编码器CLK和DT的引脚。2. 检查Encoder myEncoder(pinA, pinB);确保pinA、pinB与实际接线对应。3. 尝试在代码中增加去抖动延迟或更换质量更好的编码器。Lightroom中参数变化不线性1. 使用了错误的电位器指数型。2. MIDI2LR中命令的响应曲线未设置为“Linear”。1.确认你使用的是B型线性电位器。这是最常见的原因。2. 在MIDI2LR中右键点击该命令检查“Profile”是否为线性。按钮按下无反应1. 按钮未正确接地或接电源。2. 数字引脚模式未设置为INPUT_PULLUP。3. MIDI2LR中命令类型设置错误应为Button。1. 检查按钮电路确保一端接引脚另一端通过电阻接地或使用内部上拉。2. 在setup()中使用pinMode(buttonPin, INPUT_PULLUP);启用内部上拉电阻。3. 在MIDI2LR中确保将按钮映射到“按钮”类命令而不是CC命令。调试心法分而治之不要一次性焊接所有元件。先接一个电位器上传最简单的测试代码只读取串口打印数值确保它工作正常。然后再添加第二个、第三个。善用串口监视器Arduino IDE的串口监视器是你最好的朋友。把关键的变量值如原始模拟值、映射后的MIDI值打印出来可以直观地看到硬件是否正常工作逻辑是否正确。先硬件后软件遇到问题首先怀疑硬件连接。用万用表通断档检查所有连线确保没有虚焊、短路。硬件确认无误后再深入调试代码和软件配置。保持耐心DIY就是不断遇到问题和解决问题的过程。每次成功解决一个bug你对整个系统的理解就会加深一层。最终当你亲手制作的控制器流畅地控制着Lightroom那种满足感是无与伦比的。这个从无到有、将想法变为实物的过程正是Schwurbler项目最吸引人的地方。 基于Arduino与MIDI协议自制Lightroom物理控制器全攻略
1. 项目概述当物理旋钮遇见数字暗房如果你和我一样是个重度Lightroom用户同时又对硬件DIY有点手痒那你肯定也经历过这种纠结用鼠标和键盘调整照片的曝光、对比度、色调总觉得少了点“手感”。那种精准、顺滑、带有物理反馈的调节体验是屏幕滑块永远给不了的。市面上当然有专业的调色台比如Loupedeck、TourBox但它们要么价格不菲要么功能固定很难完全贴合你个人的工作流。于是一个念头就冒出来了为什么不自己做一个这就是“Schwurbler”项目的由来。Schwurbler这个词在德语里大概有“旋转”、“搅动”的意思非常形象地描绘了它的核心——一堆可以让你“旋”起来的物理控制器。本质上它是一个基于Arduino的DIY MIDI控制器专门为Adobe Lightroom Classic设计。通过几个旋钮、推子和按钮你可以将最常用的图像调整参数映射到实体控件上实现更直观、更高效的后期处理。这个项目适合谁首先你得是Lightroom的活跃用户对它的基本调整面板如基本、色调曲线、HSL操作熟练。其次你需要具备一点动手能力和学习的耐心毕竟涉及到简单的电路焊接和代码上传。但别怕它不需要你成为电子工程师或编程大神。Arduino生态的友好之处就在于有大量现成的库和社区支持让硬件小白也能一步步跟着做出能用的东西。最后也是最重要的你得享受这种“创造工具”的乐趣。自己做的控制器每一个旋钮的阻尼手感、每一颗按钮的布局都完全由你定义这种成就感和定制化是买成品无法比拟的。2. 核心思路与方案选型为什么是Arduino MIDI在动手之前我们先得把设计思路理清楚。做一个Lightroom控制器技术路径有好几种为什么最终主流方案都落在了“Arduino模拟MIDI设备”这条路上这背后是成本、复杂度、兼容性和可扩展性的综合考量。2.1 主流方案对比与取舍最直接的想法可能是让Arduino直接通过USB模拟键盘或鼠标发送快捷键。比如转动旋钮就相当于按键盘上的“↑”和“↓”。这个方案简单粗暴但问题很大首先它独占你的键盘输入你在调整时没法打字其次控制精度低很难实现细腻的、带加速的连续调节最后功能单一一个旋钮只能绑定一个固定操作缺乏灵活性。另一种方案是让Arduino通过串口Serial直接与Lightroom通信。这需要Lightroom有开放的API并且你需要编写复杂的插件来桥接。对于个人DIY项目来说这个门槛太高且稳定性存疑。而MIDI协议原本是为音乐设备设计的但它“控制改变Control Change CC”消息的机制完美契合了图像参数调节的需求。一个CC消息包含一个控制器编号0-127和一个值0-127转动旋钮就是连续发送不同值的CC消息。Lightroom本身并不原生支持MIDI但有一个强大的桥梁软件——MIDI2LR。这个免费开源软件的作用就是监听电脑上的MIDI输入并将其映射为Lightroom的具体操作如增加曝光度、调整色温等。因此我们的技术栈就明确了Arduino硬件核心 MIDI库通信协议 MIDI2LR软件桥接 Lightroom最终应用。这个组合的优势非常明显低成本与高可玩性Arduino Uno板子几十块钱电位器、编码器、按钮等元件更是白菜价总成本可以轻松控制在百元以内。高兼容性与易用性MIDI是跨平台的通用协议macOS和Windows都完美支持。MIDI2LR软件成熟稳定配置界面直观。高自由度与可扩展性你可以决定控制器的尺寸、形状、控件数量和布局。今天我做6个旋钮明天我就能加一排按钮和一个小屏幕。即插即用一旦配置好Arduino会被电脑识别为一个标准的MIDI设备插上USB就能用无需每次启动都进行复杂设置。2.2 硬件核心Arduino的选型考量“Arduino”是一个大家族对于Schwurbler这样的项目最常见的选择是Arduino Uno R3。选择它理由很充分引脚数量14个数字IO6个模拟输入对于初版控制器绰绰有余USB接口是标准的Type-B连接稳定社区支持最广泛任何你遇到的问题几乎都能找到答案。它的性能处理几十个模拟输入和MIDI数据流完全不在话下。如果你的设计非常紧凑或者想做成无线版本那么Arduino Leonardo或Pro Micro是更好的选择。它们使用的ATmega32U4芯片原生支持USB通信可以直接被识别为“键盘”、“鼠标”或“MIDI设备”无需额外的USB转MIDI芯片电路更简洁。但对于初学者Uno的稳定性和易调试性仍是首选。至于网络热词中提到的ESP32它性能更强且自带Wi-Fi/蓝牙更适合做物联网或需要无线传输的复杂项目。对于单纯的USB MIDI控制器Uno的简单可靠就是最大的优点杀鸡无需用牛刀。2.3 输入设备旋钮、编码器与按钮这是决定手感和功能的关键。电位器模拟旋钮最基础的模拟输入元件。它输出的是模拟电压0-5VArduino通过模拟引脚读取并转换为0-1023的数字值。它的优点是价格极低电路简单。缺点是物理上有旋转范围限制通常300度且是模拟信号可能存在轻微的抖动噪声。适合用于曝光、对比度这种需要绝对位置感的参数。旋转编码器数字旋钮它输出的是脉冲信号告诉你“向左转了一格”或“向右转了一格”没有物理终点可以无限旋转。通过代码可以轻松实现加速功能转得快变化快。手感更接近高级调音台的无极旋钮。电路和代码比电位器稍复杂但能提供更现代的控制体验非常适合快速浏览照片、调整HSL等操作。按钮与开关用于触发动作如切换前后对比Y键、复制粘贴设置、切换工具等。选择带帽的轻触开关即可注意选择常开型。实操心得对于最重要的几个参数如曝光、对比度我强烈建议使用高品质的电位器例如ALPS或国产同等级别的产品。劣质电位器用久了会有噪音和跳值严重影响体验。编码器则可以选择带按键功能的型号按下旋钮本身也是一个按钮节省空间实现更多功能。3. 电路设计与核心代码解析有了方案我们就进入实战环节。我们先从最经典、最稳定的“Arduino Uno 模拟电位器”组合开始这是理解整个系统的最佳起点。3.1 基础电路搭建从第一个旋钮开始假设我们先做三个旋钮分别控制Lightroom的曝光度Exposure、对比度Contrast和高光Highlights。所需材料清单Arduino Uno R3 开发板 x110kΩ 线性电位器B型x3面包板 x1 及若干杜邦线公对公USB A to B 数据线 x1电路连接这是关键每个电位器有三个引脚。我们将电位器看作一个可调电阻分压器。左侧引脚连接到Arduino的5V引脚。右侧引脚连接到Arduino的GND接地引脚。中间引脚滑片这是信号输出端连接到Arduino的模拟输入引脚。例如分别连接到A0, A1, A2。 这样当旋转旋钮时中间引脚的电压会在0V到5V之间线性变化对应Arduino读取的模拟值从0到1023。注意务必使用线性电位器B型而不是指数型A型或对数型C型。音频设备常用指数型电位器来符合人耳听觉特性但我们需要的是旋转角度与电阻值电压值呈线性关系这样才能保证旋钮转动和参数变化是均匀的。3.2 核心代码实现让Arduino“说”MIDI语言要让Arduino发送MIDI信息我们需要借助一个库。最常用的是MIDIUSB库适用于Leonardo/Pro Micro等原生USB芯片或Arduino MIDI Library。对于Uno我们通常使用后者并结合电脑端的“Hairless MIDI”这类串口转MIDI桥接软件。但这里我介绍一个更“干净”的方案使用MIDIUSB库和一款叫HIDUINO的固件或使用LUFA库可以将Uno直接模拟为USB MIDI设备免去桥接软件的麻烦。不过这对新手稍复杂。为了最快速上手我们采用“Arduino Uno Arduino MIDI Library Hairless MIDI”这条经典路径。虽然多了一个软件环节但稳定性极高且易于调试。第一步安装库在Arduino IDE中点击“工具” - “管理库...”搜索“MIDI Library”找到由 Francois Best维护的版本并安装。第二步编写并上传代码#include MIDI.h // 引入MIDI库 // 创建MIDI接口实例通过硬件串口Serial发送数据 MIDI_CREATE_DEFAULT_INSTANCE(); // 定义三个旋钮连接的模拟引脚 const int potPin1 A0; // 曝光度 const int potPin2 A1; // 对比度 const int potPin3 A2; // 高光 // 存储每个旋钮上一次读取的值用于检测变化 int lastPotValue1 0; int lastPotValue2 0; int lastPotValue3 0; // 设置一个阈值防止电位器微小抖动误触发 const int threshold 4; void setup() { // 初始化MIDI通信速率通常为31250 bps但通过串口桥接时常用9600或115200 // 我们先用115200方便调试在Hairless软件中需设置相同速率 Serial.begin(115200); MIDI.begin(); // 初始化MIDI库 } void loop() { // 读取所有电位器的当前值0-1023 int potValue1 analogRead(potPin1); int potValue2 analogRead(potPin2); int potValue3 analogRead(potPin3); // 将0-1023的值映射到MIDI的0-127范围 int midiValue1 map(potValue1, 0, 1023, 0, 127); int midiValue2 map(potValue2, 0, 1023, 0, 127); int midiValue3 map(potValue3, 0, 1023, 0, 127); // 检查旋钮1的值是否有显著变化 if (abs(midiValue1 - lastPotValue1) threshold) { // 发送MIDI控制改变消息通道1控制器编号10可任意设定需与MIDI2LR对应当前值 MIDI.sendControlChange(10, midiValue1, 1); lastPotValue1 midiValue1; // 更新上一次的值 } // 同理处理旋钮2和3使用不同的控制器编号 if (abs(midiValue2 - lastPotValue2) threshold) { MIDI.sendControlChange(11, midiValue2, 1); lastPotValue2 midiValue2; } if (abs(midiValue3 - lastPotValue3) threshold) { MIDI.sendControlChange(12, midiValue3, 1); lastPotValue3 midiValue3; } // 短暂延迟降低CPU占用也避免MIDI消息洪水 delay(10); }代码关键点解析map()函数这是核心它将模拟读数的宽广范围1024级压缩到MIDI的标准范围128级。虽然精度有损失但对于图像调整的128级精度完全足够且符合协议标准。threshold阈值模拟电位器会有信号噪声阈值过滤能确保只有真实的用户操作才触发MIDI消息避免界面数值“跳舞”。MIDI.sendControlChange(controller, value, channel)这是发送指令的函数。controller控制器编号是我们在MIDI2LR里用来区分不同旋钮的ID可以设为0-127任意值。channel通道通常设为1。第三步配置桥接软件Hairless MIDI下载并运行Hairless MIDI。在“Serial Port”中选择你的Arduino串口如COM3或/dev/tty.usbmodemXXX。将“Serial Baud Rate”设置为与代码中一致的115200。在“MIDI Out”中选择“MIDI2LR Virtual Input”或你的DAW/其他MIDI软件。点击“Pair”按钮建立连接。此时转动旋钮你应该能在Hairless界面看到MIDI消息日志。3.3 引入旋转编码器无限旋转与加速功能电位器有物理终点调整大范围参数时需要来回拧。旋转编码器则没有这个限制。我们以常见的增量式编码器带方向信号A、B和接地GND为例。电路连接编码器一般有5个引脚CLKA相、DTB相、SW按键、、GND。CLK (A)和DT (B)分别连接到Arduino的数字引脚例如 2 和 3。这两个引脚需要启用内部上拉电阻。SW如果存在连接到另一个数字引脚如4。连接到5V。GND连接到GND。代码实现使用Encoder库#include MIDI.h #include Encoder.h // 需要安装Encoder库 MIDI_CREATE_DEFAULT_INSTANCE(); // 初始化编码器连接引脚2和3 Encoder myEncoder(2, 3); long oldPosition -999; // 存储旧位置 void setup() { Serial.begin(115200); MIDI.begin(); } void loop() { // 读取编码器当前位置每转一格变化4 long newPosition myEncoder.read() / 4; // 除以4得到更直观的“格数” if (newPosition ! oldPosition) { // 计算变化量 long change newPosition - oldPosition; oldPosition newPosition; // 将变化量映射到MIDI值变化这里实现一个简单的加速逻辑 int midiChange change; // 基础变化量 if (abs(change) 3) { // 如果转动很快增大变化量 midiChange change * 2; } // 假设我们用一个变量来跟踪当前的MIDI值0-127 static int currentMidiValue 64; // 初始值在中间 currentMidiValue midiChange; // 确保值在0-127范围内 currentMidiValue constrain(currentMidiValue, 0, 127); // 发送MIDI CC消息假设控制器编号为20 MIDI.sendControlChange(20, currentMidiValue, 1); // 串口打印调试信息 Serial.print(Encoder Pos: ); Serial.print(newPosition); Serial.print( | MIDI Value: ); Serial.println(currentMidiValue); } delay(5); }这段代码实现了编码器的基本读取和加速逻辑。Encoder库帮我们处理了A、B相的抖动和方向判断。加速逻辑可以根据转动速度动态调整参数变化步长这在快速调整色温或色调时非常实用。4. 软件桥接与映射MIDI2LR深度配置硬件和固件只是半边天让Lightroom听懂MIDI指令全靠MIDI2LR。它的配置逻辑是核心中的核心。4.1 MIDI2LR安装与基本连接从GitHub下载MIDI2LR的最新版本并安装。启动MIDI2LR它会常驻在系统托盘Windows或菜单栏macOS。确保你的Arduino通过Hairless MIDI已被识别为MIDI输入设备。在MIDI2LR的“MIDI Inputs”中应该能看到它并确保其被勾选。启动Lightroom Classic。MIDI2LR会自动检测并连接。4.2 创建个性化映射配置文件MIDI2LR的界面左侧是Lightroom的所有可映射命令从基本的曝光度、对比度到局部调整画笔、渐变滤镜的流量、密度甚至是可以执行自定义快捷键的“按钮”命令一应俱全。映射步骤在MIDI2LR主界面找到你想映射的命令例如“Exposure”。用鼠标点击“Exposure”这一行右侧的“Learn”按钮按钮会变成红色并显示“Learning...”。立即去转动你想要绑定的那个物理旋钮。MIDI2LR会捕捉到Arduino发送的MIDI CC消息。捕捉成功后“Learn”按钮恢复原状并且该命令右侧会显示绑定的MIDI通道和控制器编号如“Ch.1 CC10”。重复这个过程绑定所有旋钮和按钮。高级配置技巧相对模式 vs. 绝对模式对于编码器你需要在命令上右键选择“Relative”模式。这样编码器发送的“增加”或“减少”信号才会被正确解读。对于电位器则使用默认的“Absolute”绝对模式。加速曲线在命令上右键可以设置“Acceleration”。对于编码器设置一个加速曲线可以让快速转动时参数变化更快提高效率。按钮的触发模式将按钮映射到“按钮”命令如“Toggle Before/After”切换前后对比时通常使用“Momentary”瞬时模式按下触发松开不动作。也可以设置为“Toggle”开关模式。配置文件管理配置完成后务必通过“File - Save Profile”保存你的映射文件。这样重装系统或换电脑时只需加载这个文件即可。实操心得我的建议是先映射你最核心的10-12个参数形成一个肌肉记忆。我的核心布局通常是左手区电位器控制曝光、对比、高光、阴影、白色色阶、黑色色阶右手区编码器控制色温、色调、鲜艳度、饱和度一排按钮负责裁剪、污点去除、渐变滤镜、径向滤镜、Y键对比、复制设置、粘贴设置。这个布局覆盖了80%的日常操作。5. 外壳设计与制作从面包板到正式产品当所有功能在面包板上测试无误后就该考虑给它一个“家”了。一个好的外壳不仅能保护电路更能极大提升使用体验和专业感。5.1 设计考量与材料选择布局与人体工学根据你的操作习惯左撇子/右撇子、桌面空间和常用参数规划旋钮和按钮的位置。最常用的旋钮如曝光应该放在最顺手的位置。考虑旋钮的高度和间距避免误触。尺寸与结构内部需要容纳Arduino主板、面包板或定制PCB、以及所有连接线。确保有足够的空间并考虑散热和走线。外壳通常分为上盖面板和下盖底座。材料亚克力激光切割最流行的DIY选择。设计好图纸在淘宝找店家切割成本低效果美观精度高。可以叠加多层不同颜色的亚克力来制造层次感。3D打印PLA/ABS自由度最高可以制作出复杂曲面和内部卡扣结构。需要学习简单的3D建模如Tinkercad, Fusion 360。缺点是表面质感可能不如亚克力光滑需要打磨处理。木材如果你有木工工具和技能木质外壳会有独特的温润质感。但加工精度要求高且不便于开孔。5.2 面板制作与元件固定这是最考验耐心和细心的环节。开孔根据电位器/编码器的轴径和按钮的直径在面板上精确开孔。对于亚克力可以在激光切割图纸上直接画出圆孔。对于3D打印在模型里预留孔位。孔径最好比轴径略小约0.1-0.2mm这样元件才能卡紧不晃动。固定元件电位器通常自带螺母。将电位器从面板正面插入背面用配套的螺母和垫片拧紧固定。可以在面板和电位器之间加一个装饰垫圈更美观。编码器同样用螺母固定。注意编码器底部可能有多个引脚确保面板厚度不会导致引脚顶到内部电路板。按钮轻触开关一般需要焊接在电路板上其按钮帽从面板孔中伸出。内部走线与组装从面包板迁移到穿孔板或定制PCB为了稳固建议将电路焊接在万用穿孔板洞洞板上或者更进一步设计一块简单的PCB嘉立创等平台打样非常便宜。这能极大提升可靠性。使用排线和接插件不要将所有线直接焊死在Arduino上。使用排线母座和杜邦线连接方便日后维修和升级。理线与固定使用扎带或热熔胶将内部线材整理固定避免松动导致短路或接触不良。5.3 美化与标识面板标识可以用雕刻机在亚克力上刻字或者用3D打印做出凸起文字。更简单的方法是使用标签打印机打印出精致的标签贴上去或者购买现成的旋钮帽上面通常已经印有参数名称。旋钮帽选择不同颜色、形状和材质的旋钮帽不仅能提升颜值还能通过触觉快速区分不同功能。例如曝光旋钮用大的、带凹槽的金属帽对比度用中等大小的塑料帽。6. 进阶优化与功能扩展基础版控制器工作后你可以根据自己的需求进行各种升级让它变得更强大、更智能。6.1 增加视觉反馈状态指示灯与OLED屏幕物理旋钮的缺点是不知道参数的当前绝对值除非看屏幕。我们可以增加反馈。LED指示灯例如用一个RGB LED环套在旋钮上通过颜色表示参数范围如蓝色表示负值绿色表示中间红色表示正值。这需要额外的PWM引脚和控制代码。小型OLED屏幕I2C接口这是终极解决方案。一块0.96寸的OLED屏幕可以显示当前激活的控制组、旋钮对应的参数名和实时数值。当你在Lightroom中切换模块如从“基本”切换到“色调曲线”时屏幕内容可以随之改变。这需要编写更复杂的代码来与Lightroom通信MIDI2LR支持发送反馈信息但需要配置实现双向通信。6.2 实现“Bank”切换用有限控件控制无限参数控制器面板空间有限不可能放下所有Lightroom参数。这时可以引入“Bank”库/组切换功能。增加两个按钮标记为“Bank Up”和“Bank Down”。在代码中定义多个“控件映射表”。例如Bank 1时旋钮1-6映射曝光、对比度等基本参数按下“Bank Down”切换到Bank 2此时同样的6个旋钮映射为HSL色相、饱和度、明亮度中的红色、橙色、黄色控制。通过OLED屏幕或LED指示灯显示当前处于哪个Bank。 这样你的6旋钮控制器就拥有了控制数十个参数的能力。6.3 提升手感与稳定性硬件层面的打磨更换高品质编码器廉价的编码器手感生涩、有顿挫感。更换为ALPS、博世等品牌的编码器手感顺滑寿命更长。添加电容滤波在每个电位器的信号线和地线之间并联一个0.1uF的陶瓷电容可以显著滤除高频噪声使读数更稳定。使用屏蔽线如果控制器体积较大内部连线较长对于模拟信号线使用屏蔽线可以防止干扰。电源净化如果使用外部电源非USB供电考虑增加稳压模块为模拟电路部分提供更干净的电源。7. 常见问题排查与调试心得实录DIY过程中你一定会遇到各种各样的问题。这里记录了我踩过的坑和解决方法。问题现象可能原因排查步骤与解决方案MIDI2LR检测不到设备1. Hairless MIDI未正确连接或设置。2. Arduino代码串口波特率与Hairless设置不一致。3. 系统MIDI驱动问题。1. 检查Hairless串口选择是否正确“Pair”是否点亮MIDI Out是否指向MIDI2LR2. 核对代码Serial.begin()与Hairless的“Serial Baud Rate”是否完全相同如115200。3. 重启MIDI2LR和Lightroom。在macOS的“音频MIDI设置”或Windows的“MIDI-OX”软件中查看是否有设备出现。旋钮控制不跟手有延迟1. 代码中delay()时间过长。2. 电位器质量差噪声大阈值(threshold)设得太高。3. MIDI消息发送过于频繁。1. 减少loop()中的delay尝试改为5ms或更短。2. 尝试降低threshold值如从4改为2或在硬件上并联滤波电容。3. 确保只在模拟值变化时才发送MIDI消息代码中已实现。旋钮跳到最大值或最小值1. 电位器接线错误或接触不良。2. 代码中map()函数范围错误。3. 模拟引脚未启用内部上拉仅对某些电路。1. 用万用表检查电位器两端电压是否为稳定的5V和0V中间引脚电压是否随旋转平滑变化。2. 检查map(potValue, 0, 1023, 0, 127)参数是否正确。3. 对于分压电路通常不需要启用内部上拉。编码器读数混乱正转反转识别错误1. 编码器A、B相引脚接反。2.Encoder库初始化引脚顺序错误。3. 编码器质量差信号抖动。1. 交换连接编码器CLK和DT的引脚。2. 检查Encoder myEncoder(pinA, pinB);确保pinA、pinB与实际接线对应。3. 尝试在代码中增加去抖动延迟或更换质量更好的编码器。Lightroom中参数变化不线性1. 使用了错误的电位器指数型。2. MIDI2LR中命令的响应曲线未设置为“Linear”。1.确认你使用的是B型线性电位器。这是最常见的原因。2. 在MIDI2LR中右键点击该命令检查“Profile”是否为线性。按钮按下无反应1. 按钮未正确接地或接电源。2. 数字引脚模式未设置为INPUT_PULLUP。3. MIDI2LR中命令类型设置错误应为Button。1. 检查按钮电路确保一端接引脚另一端通过电阻接地或使用内部上拉。2. 在setup()中使用pinMode(buttonPin, INPUT_PULLUP);启用内部上拉电阻。3. 在MIDI2LR中确保将按钮映射到“按钮”类命令而不是CC命令。调试心法分而治之不要一次性焊接所有元件。先接一个电位器上传最简单的测试代码只读取串口打印数值确保它工作正常。然后再添加第二个、第三个。善用串口监视器Arduino IDE的串口监视器是你最好的朋友。把关键的变量值如原始模拟值、映射后的MIDI值打印出来可以直观地看到硬件是否正常工作逻辑是否正确。先硬件后软件遇到问题首先怀疑硬件连接。用万用表通断档检查所有连线确保没有虚焊、短路。硬件确认无误后再深入调试代码和软件配置。保持耐心DIY就是不断遇到问题和解决问题的过程。每次成功解决一个bug你对整个系统的理解就会加深一层。最终当你亲手制作的控制器流畅地控制着Lightroom那种满足感是无与伦比的。这个从无到有、将想法变为实物的过程正是Schwurbler项目最吸引人的地方。