本文以正运动技术具备专用手轮接口的运动控制器ZMC408CE为例，介绍手轮、手轮的作用及原理、控制器手轮接口接线以及手轮程序配置。

上节讲解了使用正运动basic语言进行手轮应用配置， 本节主要讲解C++调用API函数库接口实现手轮配置。

01 手轮作用及原理

手轮也称手摇脉冲发生器，主要用于数控机床、立体加工中心、卧式加工中心、龙门加工中心等数控设备。当手轮旋转时，编码器产生与手轮运动相对应的信号，通过数控系统选定座标并对座标进行定位。

手动脉冲发生器它中心有轴的光电码盘，其上有环形通、暗的刻线，摇动手轮后，由光电发射和接收器件读取，获得2组正弦波信号HA、HB，每个正弦波相差90度相位差。由于HA、HB两信号相差90度，可通过A相在前还是B相在前，给出正转脉冲或反转脉冲去控制伺服电机正转或反转。

02 手轮介绍

1. 通过手轮上的“轴选择旋钮”选择需要移动的坐标轴；

2. 通过“倍率选择旋钮”选择合适的移动倍（×1/×10/×100）；

3. 旋转“手轮摇柄”移动坐标轴。顺时针旋转为正向移动，逆时针旋转为负向移动，旋转速度快慢可以控制坐标轴的运动速度；

4.按钮“急停”，紧急停止手轮运动；

5.控制器手轮接口为双排标准DB15母头，需要手轮接头为双排标准DB15公头。

03 控制器手轮接口接线

1.硬件介绍

案例采用ZMC408CE运动控制器，具备专用的手轮接口。

ZMC408CE是正运动技术推出的一款高性能EtherCAT总线运动控制器，核心技术采用了先进的FPGA技术，实现硬件位置比较输出、精准输出功能，保证连续轨迹加工的出色性能和稳定性，以及动态数据捕获的实时性，从而实现更加精准控制和提高生产效率和品质。

ZMC408CE支持EtherCAT总线轴 + 脉冲轴混合插补，可脱机或联机运行，可控电机轴数8轴，特殊型号提供16或32轴可选，支持ZDevelop + 多种高级上位机混合编程，可以实现点位运动、电子凸轮、直线插补、圆弧插补、连续轨迹加工和30+种机器人模型的控制。

ZMC408CE产品亮点

1.高性能处理器，提升运算速度、响应时间和扫描周期等；

2.一维/二维/三维、多通道视觉飞拍，高速高精；

3.位置同步输出PSO，连续轨迹加工中对精密点胶胶量控制和激光能量控制等；

4.多轴同步控制，多坐标系独立控制等；

5.EtherCAT同步周期可快至125us；

6.EtherCAT总线和脉冲轴混合插补；

7.直线插补、任意空间圆弧插补、螺旋插补、样条插补等；

8.应用灵活，可PC上位机开发，也可脱机独立运行 ；

2.控制器手轮接口MPG定义

3.手轮接线参考

4.注意事项

手轮编码器轴接口接线原理如上图所示，手轮厂家的设计多种多样，请先查看手轮内部的设计图后与运动控制器确认正确后谨慎接线；请使用双绞屏蔽线，尤其是环境恶劣的场合，务必使屏蔽层充分接地。

04 函数接口指令说明

使用ZAux_Direct_Connect命令，将手轮连接到运动轴，指令说明如下表。

05 C++程序配置

1.配置步骤

（1）参考以上 手轮接线示意图正确连接手轮和控制器；

（2）扫描文章末尾二维码，下载例程，使用Visual Studio 2022，打开C++手轮运动例程，运行之后根据型号选择EtherNET、串口、PCI、LOCAL任意一种接口连接控制器。

（3）配置轴号；不同控制器型号，手轮轴号，倍率和轴选择IN编号不一样，详情请参考控制器用户手册，本例程使用控制器型号为ZMC408CE，手轮接口轴号为8，该控制器手轮接口无可用默认AXIS轴号，必须进行映射才可以使用，映射避开脉冲轴号，此例程是将手轮映射到轴10。

（4）配置IO；根据需要赋予轴选（HSX，HSY，HSZ，HSU）和倍率（HX1，HX10，HX100）以及紧急停止 （HEMGN）功能；这些信号本质为数字输入信号，有固定的编号，但无固定的功能，需要ZDevelop开发；其名称为推荐配置的功能，轴选即为connect同步运动的被连接轴，倍率即connect比率。

（5）完成以上配置即可开始使用手轮。

2.程序运行界面

程序运行成功后会显示以下界面，未连接控制器之前，轴坐标和手轮轴坐标默认为0，手轮状态为“未连接”，手轮轴号为10，链接倍率为1，手轮轴脉冲方式为“脉冲+方向”，链接轴为“未选择”。

3.控制器链接

选择IP、串口，链接到控制器ZMC408CE ，链接成功，手轮测试则会变成“已连接”，若失败则会有弹窗“链接失败”点击确定关闭弹窗，检查IP地址或串口地址重新链接。

（链接成功）

（链接失败）

4.手轮轴操作

程序链接上控制器成功之后，会获取轴坐标和手轮轴位置。通过手轮的“轴选择”旋转按钮选择链接轴，如果链接成功，手轮链接状态会变成“已链接”，链接轴也会显示出所链接的轴号和链接倍率。

如果想要切换连接轴和链接倍率，只需要旋转手轮“轴选择”按钮和“倍率选择”按钮即可。点击停止按钮之后，会自动断开链接，此时手轮的“轴选择”和“倍率选择”按钮处于无效状态，只有点击继续后才会重新链接， 建议在链接轴之前先选好链接倍率，否则可能会出撞机的危险，点击坐标清零则会将X、Y、Z、手轮的坐标全部清零。

5.手轮轴轴号修改

此例程的手轮轴轴号绑定到轴10，如果要进行修改，可以在手轮设置中的手轮轴号，直接进行更改，手轮脉冲方式也是在此处进行修改。

6.手轮轴号映射

不同控制器的默认手轮轴接口不同，具体需要参考控制器手册，相同点是不管使用哪个型号的控制器都需要重新进行轴映射将手轮轴映射到其他轴号去。

在控制器手册中找到默认手轮接口轴号，使用ZAux_Direct_SetAtype（handle，重映射的轴号，0）将重映射的轴类型设置为0，还原轴设置，ZAux_Direct_SetAtype（handle，要修改的本地脉冲轴号,0）将要修改的本地脉冲轴号轴类型也设置为0，低版本不设置会报错。

使用本地轴映射指令ZAux_Direct_SetAxisAddress{ handle，重映射的轴号，(-1<<16) +要修改的本地脉冲轴号 }。

7. 手轮轴参数配置

轴号映射参数修改完后，接着使用ZAux_Direct_SetAtype （handle，手轮轴轴号，3/6） 进行修改手轮轴的类型，ATYPE=3正交编码器，ATYPE=6脉冲方向方式的编码器，设置好之后可在运行主界面进行切换。

使用ZAux_Direct_SetUnits （g_handle，手轮轴号，脉冲当量） 根据实际需求修改手轮轴的脉冲当量。

8.建立手轮链接

查询控制器手册，找到手轮对应轴输入信号、倍率信号、急停信号，使用ZAux_Direct_GetIn （g_handle，输入口编号，&获取输入口的状态值） 进行IO信号读取，这里运动轴是X、Y、Z对应控制器的0、1、2轴。

通过IO信号的判断使用同步运动指令ZAux_Direct_Connect （g_handle，链接比率，手轮轴，运动轴） ，进行轴的链接、绑定，使用单轴运动停止指令ZAux_Direct_Single_Cancel （g_handle，运动轴，停止模式） ，断开轴链接。

9.手轮轴位置获取、清零

建立链接之后，需要使用ZAux_Direct_GetMpos （g_handle，手轮轴号，&showpos[手轮轴号]） 来获取，手轮轴的当前位置，并显示在界面上。

使用ZAux_Direct_SetMpos （g_handle，手轮轴号，0） 进行手轮坐标清零。

本次，正运动技术 EtherCAT运动控制器在数控加工手轮随动中的应用之C++， 就分享到这里 。

更多精彩内容请关注“ 正运动小助手 ”公众号，需要相关开发环境与例程代码，请咨询正运动技术销售工程师：400-089-8936。

本文由正运动技术原创，欢迎大家转载，共同学习，一起提高中国智能制造水平。文章版权归正运动技术所有，如有转载请注明文章来源。

正运动技术专注于运动控制技术研究和通用运动控制软硬件产品的研发，是国家级高新技术企业。正运动技术汇集了来自华为、中兴等公司的优秀人才，在坚持自主创新的同时，积极联合各大高校协同运动控制基础技术的研究，是国内工控领域发展最快的企业之一，也是国内少有、完整掌握运动控制核心技术和实时工控软件平台技术的企业。主要业务有：运动控制卡_运动控制器_EtherCAT运动控制卡_EtherCAT控制器_运动控制系统_视觉控制器__运动控制PLC_运动控制_机器人控制器_视觉定位_XPCIe/XPCI系列运动控制卡等等。