自制Mach3有线CNC手摇轮：从硬件选型到Modbus通信全解析
作为数控操作者，我对Mach3控制的机器上那台键盘鼠标的笨拙深有体会。加工时手忙脚乱地去点屏幕上的方向按钮，或者在键盘上找切换键，分分钟就会出岔子。所以很多老车间的机器旁边，都会放一个手摇轮（Pendant），不管是调试对刀，还是手动铣个外形，手轮的直觉操控感是键盘永远给不了的。Mach3作为国内玩雕刻机和铣床最常见的数控软件，官方也支持手轮，但市售成品手轮要么价格偏高，要么按键布局和倍率档位不完全符合自己的使用习惯。这篇文章就把我自做一个Mach3有线CNC手摇轮（Pendant）的全过程记录下来，包含硬件选型、通信方式、固件思路和踩坑实录，给想复刻或者想用其他方案实现同样功能的朋友一个参考。
1. 为什么数控加工还需要一个“落后”的手摇轮
1.1 对刀和试切时，键盘鼠标有多难用
不少刚开始接触数控的朋友会觉得，控制软件明明有按键可以控制方向，也有鼠标可以拖动，为什么还要花精力做一个Pendant？这个疑问我第一次做小雕刻机的时候也有过。直到有一次加工一个需要精确对刀的零件，我右手握着鼠标点“Y+”按钮，眼睛盯着坐标显示，结果手一抖过头了零点几毫米，整个对刀基准就废了。键盘上的方向键配合“连续移动”模式也不是不行，但那个感觉就像用螺丝刀拧螺母，能用，但就是别扭。
手动操作这件事，核心需求并不只是“能动”，而是“动得精准、动得可控”。对刀时你需要以0.01毫米甚至0.001毫米的度去移动坐标轴，试切第一个零件时需要眼睛盯着刃具和工件的接触情况，同时随时能停下来。键盘和鼠标的问题在于：你很难通过“手感”来控制移动速度，按键按下瞬间就是固定进给率，松开就停，中间没有任何比例关系。而手摇轮的本质是增量编码器，你摇多少，轴就走多少，摇得快就走得快，摇得慢就走得慢，完全由你的手来决定。这种“人机耦合”的感觉，用键盘是练不出来的。
1.2 市售Pendant为什么贵、为什么不一定顺手
市面上Mach3用的Pendant其实不少，有线的、无线的，几百到上千都有。功能上大同小异，无非是手轮加一组方向按键和倍率开关。但问题是市售产品往往面向“通用场景”，按键布局是人家定的，倍率档位是固定的x1/x10/x100，急停位置可能不符合你的使用习惯，有些无线版本还要考虑电池充电和信号延迟。
更关键的是，很多市售Pendant的通信接口是直接走Mach3的“插件”通道，安装配置虽然不难，但如果你的Mach3版本是老的3.043，或者用的是某些国产汉化版，插件兼容性经常出问题。我身边有人花了大几百买回来，结果发现自己的电脑串口不稳定，控制信号频繁断开，最后只能退货。与其被这些不确定性折腾，不如自己做一个，硬件和固件全都掌握在自己手里，坏了修起来也方便，还顺便把原理吃透了。
1.3 自制方案的定位与目标
我给自己定的项目目标是：做一个有线的MPG手轮，自带倍率切换和轴选择，能控制X/Y/Z三轴，带急停接口，并且通信方式采用Mach3原生支持的Modbus。这里说明一下，为什么不用看起来更简单的键盘映射方案？后面有专门的一节来分析。先看整体架构：手轮用国产通用的机械式增量编码器，主控用Arduino Nano，编码器的A/B相信号接主控的GPIO，主控通过串口转RS485/RS232与电脑通信，电脑端通过Mach3的Modbus插件读取寄存器数据，再映射到手轮移动命令。整个系统不复杂，但每个环节都有细节需要注意。
2. 硬件选型：MPG手轮、按钮与主控芯片的搭配逻辑
2.1 机械式MPG手轮怎么挑
MPG（Manual Pulse Generator）手摇脉冲发生器是市场上很成熟的标准件，国产的几十块一个，进口的如Fagor之类要贵很多。从功能角度看，机械式的手轮本质上就是一个带双相输出的增量旋转编码器加一个固定刻度盘，常见规格有每转25个脉冲、100个脉冲和200个脉冲几种。我最终选的是100脉冲/转的型号，因为配Mach3时，100脉冲在x1倍率下换算成0.001mm步进量比较合理，计算方便，手感也好。
选的时候要注意手轮的输出形式，大多数是差分输出或者推挽输出。Arduino的GPIO能承受5V，所以最好选5V推挽输出的型号，直接接上去就能用，不需要额外的电平转换电路。如果买到的是12V供电的版本，那就要加光耦隔离和电平转换，会麻烦不少。另外，手轮的轴径和安装孔位也要提前量好，因为这个手轮是要装在一个手持小盒子里的，如果孔距不对，后面装上去会很丑。
2.2 主控选型：Arduino还是STM32
主控的选择主要有两个方向。第一是Arduino Nano/Uno系列，优点是开发环境简单，网上资料多，库成熟，GPIO中断配置容易，适合第一次做这种项目的朋友。缺点是性能一般，如果你以后想往上加屏幕、加更多按键，可能力不从心。第二是STM32系列，比如便宜的BluePill开发板，性能强，支持真正的正交编码器硬件定时器，但开发环境相对复杂，对新手不友好。
我的建议是：第一版务必用Arduino Nano，因为它的外部中断能非常方便地读取编码器A/B相信号，而且Modbus通信库也成熟，整个项目从零到跑通，一个晚上就够了。后面如果想升级，可以把同样的编码器逻辑移植到STM32上，反正核心解码算法是通用的。我这个项目最终用了Arduino Nano，成本不到二十块钱，性能绰绰有余。
2.3 按钮、倍率开关和急停的硬件处理
手轮上除了编码器，还需要轴选择旋钮、倍率旋钮和几个方向按键（有的Pendant还会加入启动暂停）。轴选择用单刀多掷波段开关，比如3档分别对应X/Y/Z，直接接Arduino的数字输入引脚，读取时做下拉电阻处理。倍率也用类似的多档开关，我用的4档，对应x1、x10、x100和OFF。按键部分，我装了三个点动按钮，分别控制“连续正转”“连续反转”和“回零”，这几个功能在调试时非常实用。
这里有一个关键细节：按键和旋钮的公共端如果直接接地，会跟编码器的信号线形成共地干扰。所以我专门把所有开关量输入都接到一个独立的接线段子上，然后通过Arduino的GND统一处理。急停不是直接接在Arduino上的，而是串联在机器控制柜的急停回路里，通过航空插头的常闭触点引出。因为手轮是手持的，万一加工中出问题，急停才是保命的东西，不能依赖单片机程序来处理。
2.4 供电与走线的注意事项
Arduino Nano的供电选择很多，USB口5V是最常见的，但手持设备里用USB供电不方便，我直接用了一个12V转5V的DC-DC模块，从控制柜的开关电源取12V，再接一个1000uF电解电容做滤波，实测纹波控制在几十毫伏以内。要注意的是，如果电源来自变频器附近，必须做好隔离，否则手轮的读数会乱跳。这个我在后面的抗干扰章节会继续讲。
手持盒内部走线也不能乱来。编码器信号线、开关线、电源线这三类我做了物理区分，信号线全部用屏蔽线，屏蔽层单端接地，避免形成地环路。盒子选的是市面上那种塑料防水接线盒，尺寸大约是200x120x60毫米，内部用铜柱固定Arduino和端子排，尽量让线缆短而有序。
3. 和Mach3通信：从插件到Modbus的方案取舍
3.1 三种常见通信方案对比
让Mach3识别手轮输入，常见方案有三种：键盘映射插件、宏泵DDE、Modbus。键盘映射插件最简单，安装后在Mach3里把某个按键映射到手轮的某个动作上，适合只做方向控制的场景。但它的致命缺点是：手轮的增量脉冲无法和键盘按键的“连续行为”完美对应，你摇一格，它最多模拟一次按键按下，同时键盘缓冲区还会造成延迟，反应很肉。
宏泵DDE方案是在Mach3的宏目录里放一个宏文件，通过DDE接口和外部程序交换数据，可以做得很灵活，但配置过程非常繁琐，而且Mach3的DDE接口在较新版本上支持不稳定。我自己折腾了一次就放弃了。
Modbus方案是三者中最“专业”的，也是Mach3原生支持最好的方式。Mach3的Modbus插件支持RTU和TCP两种模式，可以在配置界面直接设定从站地址、寄存器类型和地址映射。手轮数据通过寄存器读取，Mach3的加工程序引擎会按周期轮询，响应速度和可靠性都远胜键盘模拟。
3.2 Modbus RTU接线与配置步骤
我采用的物理层是RS485半双工，因为抗干扰能力强，距离可以在几十米外正常工作。Arduino Nano串口TXD/RXD接一个便宜的MAX485模块，转换成RS485差分信号，再接一个USB转RS485适配器插到电脑上。电脑端安装好USB转串口驱动后，在设备管理器里找到新增的COM口，记下它的编号，这个后面要填到Mach3里。
Mach3侧配置Modbus插件的过程分三步。第一步，打开Mach3菜单“配置”下的“插件”，勾选Modbus插件并进入配置页面。第二步，添加一个新的Modbus从站，填写从站地址和通信参数：波特率我设的是19200，8数据位，无校验，1停止位。第三步，定义寄存器映射，把从站里保存手轮数据的寄存器地址和Mach3的PLC寄存器关联起来。具体怎么关联，我在下一节详写。
3.3 寄存器映射：手轮数据怎么变成轴移动
Mach3的Modbus插件提供了一系列内部寄存器，可以映射到外部Modbus从站的保持寄存器。我定义Arduino侧每50毫秒刷新一次数据缓冲区，缓冲区里包含轴选择、倍率、手轮累计脉冲增量和按键状态，以两个16位寄存器加一个16位状态字的形式组织。轴选择值放在寄存器0，倍率值放在寄存器1，脉冲增量放在寄存器2和3（分高位低位），按键状态放在寄存器4。
Mach3侧则通过一个名为“MBR”的变量体系来读取这些寄存器，并把它和“OEMDRO”关联起来。Mach3官方的Pendant功能是通过OEMDRO 71到73来读取手轮位置的，所以我在Mach3的PLC脚本里写了两行逻辑，把Modbus寄存器值赋给对应的OEMDRO，再配合Mach3的“手轮模式”选项，就能自然识别。这一点是网上很多教程没讲透的，很多朋友卡在这里，以为配置完插件就能动，其实必须把寄存器映射到OEMDRO上。
4. 固件逻辑：编码器读取、倍率映射与按键防抖
4.1 正交编码器的读取原理
机械式MPG编码器输出A相和B相两路方波信号，两路信号相位相差90度。当手轮正转时，A相超前B相；反转时B相超前A相。Arduino上最直接的读取方式是把A相接外部中断引脚（Nano上是D2和D3），A相触发中断后读取B相的电平状态，如果B相为高，说明正转，计数器加1；如果为低，说明反转，计数器减1。这是最经典的单倍频读取方式，对于100脉冲/转的手轮来说，转一圈就能采到100个变化沿，配合倍率挡位足够用了。
如果想获得更高分辨率，也可以用两路中断做四倍频解码，转一圈采到400个沿。但Mach3的坐标单位换算会跟着变复杂，而且手轮的物理精度也没到需要四倍频的程度，所以我没有采用。重要提示：Arduino的外部中断服务函数要尽量短，不要在中断里做任何延时或者串口打印操作，否则会丢失脉冲。我的做法是中断里只更新计数器变量，然后把计数增量的计算放在主循环里处理。
4.2 倍率切换与脉冲增量计算逻辑
手轮上一个脉冲对应轴移动多少距离，取决于倍率挡位和Mach3的步进设置。比如机器上如果设置为每毫米100个脉冲，那么x1倍率下，手轮转一圈（100个脉冲）轴移动1毫米，一个脉冲对应0.01毫米。对于精对刀来说，0.01毫米还是太大，所以还需要x0.1或者更小的倍率，这取决于你的Mach3步进分辨率。
固件里倍率逻辑的关键点在于“不丢脉冲”。当倍率从x10切到x1时，之前已经产生但还没发送给Mach3的脉冲怎么处理？我采取的做法是：把倍率切换的瞬间作为清零点，清空累积未发送的脉冲，这样虽然会丢掉几个脉冲，但避免了Mach3端脉冲累积导致的突然位移。如果你的使用场景不允许丢脉冲，可以把倍率变换前残存的脉冲按当前倍率先发送出去，然后再切换倍率，这样更平滑但代码复杂度会增加不少。我第一版先用了清零方案，后来实际对刀根本不在乎这几个脉冲，就保持清零方案了。
4.3 按键处理和防抖的实用方法
手轮上的方向按键、回零按键和模式切换按键，在电气上都存在抖动问题。简单靠硬件RC滤波也是一种方案，但参数调起来麻烦，我选择了软件防抖。Arduino的开关量读取加一个20毫秒的延时判断，通过记录上一次稳定状态实现状态变化检测。注意：防抖的延时不能阻塞主循环，否则会影响编码器数据处理，我用了基于millis()的非阻塞检测方式，也就是读到电平变化后记录一个时间戳，20毫秒后再确认一次，确认通过才视为有效按键事件。
按键动作和手轮动作的优先级也需要考虑。我最初的设计是手轮计数和按键事件都在主循环里按顺序处理，结果发现在快速摇手轮的同时按方向键，偶尔会出现按键事件丢失。后来调整为主循环内先处理按键事件，再处理脉冲增量事件，因为按键是离散的慢速事件，丢不得；手轮脉冲是连续的快速事件，晚处理几个毫秒没有影响。这个顺序问题，有实时系统开发经验的朋友应该会觉得很熟悉，但不少Arduino初学者很容易忽略。
5. 组装、屏蔽与现场抗干扰的实战经验
5.1 手持盒内部布局和固定
硬件开发板、端子排和开关全部装在一个塑料接线盒里之后，布局是否合理就非常影响使用体验。我的布局思路是：左上角装手轮，左下角装轴选择旋钮，右侧上半部分装倍率旋钮，右侧下方三个方向按钮横排，底部留一个航空插座接入控制柜线缆。内部用热熔胶固定板子，编码器和开关全部焊接在端子排上，方便以后拆装更换。所有线缆都留出适当的松弛长度，防止开盒维修时把焊点扯断。
5.2 信号屏蔽和接地的重要性
手持设备最大的敌人不是元件本身，而是干扰。数控机床旁边往往有变频器、主轴驱动器和开关电源，这些设备会产生很强的电磁干扰。手轮的编码器信号如果走普通跳线，很容易被干扰造成误计数。我在这块做了三件事：一是编码器信号线和倍率/按键信号线全部用屏蔽线，屏蔽层在Arduino的GND端单点接地；二是电源输入端加了共模电感和一个反向二极管，防止电源反接和尖峰；三是从控制柜到手持盒的电缆选用带屏蔽层的多芯航空线，屏蔽层同样只在控制柜端接地。
做到这三点之后，我实际测试过在主轴启动和变频器调速的情况下，手动摇手轮300个脉冲，Mach3坐标显示稳定，没有额外跳数。这个结果我很满意，说明屏蔽措施是有效果的。
5.3 预设的故障排查口
我在外壳上预留了一个小窗口，直接露出Arduino的USB口，平时用橡胶塞堵上。这样做有两个好处：一是调试时可以直接用USB供电跑程序，不用开壳接线；二是如果软件上怀疑某个按钮或编码器有问题，可以在不拆机的情况下连电脑串口监视器看输出数据。这个细节在设计初期可能觉得无所谓，但等你调完固件之后会发现，它节省了大量拆装孔的时间。
6. 实测调试记录与踩坑复盘
6.1 第一次通电，手轮数据完全不动
我的第一版固件烧录后，电脑端串口监视器里能看到Arduino的数据在刷新，说明通信链路没问题，但不管我怎么转手轮，脉冲增量始终是0。排查过程：先用万用表测编码器供电，5V正常；再用示波器看A相输出，发现手轮转动时A相有方波输出，说明编码器硬件没问题；最后怀疑是Arduino引脚配置问题，把A相和B相从D2/D3挪到D3/D4测试，结果正常了。
原因其实是我把A相接到了D2，B相接到了D3，但D3同时也是中断0的引脚，配置代码里两个引脚都用了attachInterrupt，但D3的通道被D2的attachInterrupt覆盖掉了。这是一个非常低级的错误，也提醒大家：Arduino Nano上D2和D3虽然都能外部中断，但attachInterrupt函数使用的是中断号而非引脚号，D2是中断0，D3是中断1，两个都能独立使用，我第一版却把D2的配置写成了中断1，导致D3的中断被占用。所以中断配置一定要写对中断号，建议代码开头的注释里标注清楚。
6.2 手轮方向反向的修正
硬件和通信都跑通之后，我又发现摇手轮时Mach3里轴的移动方向和手轮转动方向相反。这是很多自制Pendant都会遇到的问题，原因很简单：编码器的A/B两相信号，在物理接线上A相接到了D2，B相接到了D3，但机械手轮的默认方向可能和Mach3的坐标正方向定义正好相反。
修正方法有两种：第一是软件上在中断解码时把加减法反过来，代码一行就搞定；第二是硬件上把A相和B相接线对调，一样有效。我个人倾向软件修正，因为保留了换线的灵活性，万一以后换手轮，不用动线缆。当然，还有一种更完美的做法是在固件里加一个“方向反转”的配置变量，通过一个拨码开关来控制，这样就不需要每次改代码重新烧录了。
6.3 按键误触发的处理
使用一段时间后，我发现倍率旋钮在某些位置会导致Mach3的手轮移动速度突然变化，偶尔还会出现按下方向按钮没反应的情况。排查后发现原因是倍率旋钮这种多档开关在切换档位的瞬间，触点有时候会短暂断开再接上，而这个毛刺被Arduino当成了一次有效的档位变化，进而改变了脉冲计数倍率。解决方式是给倍率开关的读取加上了50毫秒的稳定判断，并且在判断为档位变化时，自动清空待发送脉冲缓冲。这样即使切换瞬间产生了毛刺，也不会造成坐标轴突然窜动。
6.4 整机效果与使用感受
经过三轮调试之后，这个自制Pendant在我自己的小雕刻机和一台老式铣床上都投入了实际使用。使用感受最明显的有三点：第一，对刀效率提升非常大，以前用键盘控制要反复微调好几分钟，现在摇几圈手轮就能精确到0.01毫米，甚至0.005毫米都没问题；第二，手轮的手感和响应速度比想象中好，没有延迟感，摇起来很跟手；第三，急停串在控制柜回路里，安全感比软件急停强得多。整体成本核算下来，所有硬件加起来不到150元（不含人工），对比市售几百元的成品，性价比确实很高，更重要的是以后想加功能，改固件就行，不用重新买设备。
7. 如果再做一版，我会改哪些地方
手头这个Pendant用了有几个月，整体稳定，但也积累了一些改进想法。第一，我想把Arduino Nano换成带CAN接口的STM32，然后把通信方式升级为以太网Modbus TCP，这样电脑远离机器也没有长距离RS485布线的烦恼。第二，想加一块OLED屏幕，在手轮上直接显示当前坐标、倍率和轴状态，不用低头看电脑屏幕。第三，把按键布局改成更符合左手持握习惯的对称式布局，因为现在用久了右手会有轻微疲劳感。第四，加一个USB口的固件升级功能，不用拆壳就能更新程序。这些都不是必须的，但正是DIY的好处，随时可以迭代。
如果你也想复刻这个项目，我建议从一版最简单的方案开始：Arduino Nano + 100PPR编码器 + 3个旋钮 + 3个按键，先不接按键功能，只把手轮的轴移动跑通，再一步步加功能。这样每一步的成果都能验证，不会出问题的时候到处找原因。我自己当时就是先用手轮控制一个轴，确认方向、倍率和通信都对，才继续扩展的。整个过程中最值得学习的其实不是那几行固件代码，而是“手工操作精密机械”这种场景对实时性、可靠性和抗干扰性的高要求，这才是CNC周边开发有意思的地方。