1. 这不是“编码器”是 Codesys 里最常被误解的底层运动控制核心模块很多人第一次在 Codesys 中看到“自由编码器”Free Encoder这个功能块第一反应是“哦读个编码器脉冲嘛不就是个计数器”——然后直接拖进程序里接上高速计数输入点跑起来发现位置跳变、方向错乱、数值归零、甚至 PLC 扫描周期被拖慢。我刚接触 Codesys V3.5 SP10 那会儿也这么干过整整两天没搞明白为什么电机原点每次上电都不一样最后翻到手册第 287 页才看到一行小字“Free Encoder 模块默认启用内部滤波与方向锁存机制未配置时将强制使用 1ms 周期采样且方向判定依赖连续两次采样边沿极性。”这根本不是个“读脉冲”的简单功能块它是 Codesys 运动控制架构中承上启下的关键枢纽上承 PLCopen 运动控制规范如 MC_ReadStatus、MC_Home 等指令下接硬件级高速计数器资源HSC、中断服务例程ISR和轴控状态机。它把原始脉冲信号转化为可被运动库识别的、带方向性、带时间戳、带状态标记的标准化位置源Position Source。你用不用它决定了你的定位精度是 ±1 脉冲还是 ±5 脉冲决定了你的回零动作是稳定触发还是反复抖动更决定了你在 Codesys V3.5 SP11 中能否顺利对接倍福、贝加莱、施耐德等第三方 EtherCAT 从站的编码器反馈通道。关键词“codesys”和“自由编码器”之所以在百度网盘搜索中高频共现恰恰说明大量工程师卡在了“下载了软件却不会配编码器”这一关。他们下载的是 codesys v3.5 sp11 百度网盘资源打开后新建项目导入 ST 语言实例照着“codesys编程st语言实例”抄了一段 MC_MoveAbsolute结果轴不动——问题不在运动指令而在底层位置源没喂对数据。而“c# codesys”“codesys文件操作”这些词则暴露了另一类需求有人想用上位机绕过 Codesys 自带的编码器管理自己写 C# 读取 HSC 寄存器结果发现寄存器地址随固件版本变化SP10 和 SP11 的 HSC_BASE_ADDR 差了 0x400硬编码直接失效。所以“自由编码器”真正的价值不是“自由地读编码器”而是“自由地定义编码器行为”。它让你能决定脉冲怎么采单边沿/双边沿/AB 相正交、方向怎么判查表法/状态机法/微分法、滤波怎么设数字低通/滑动平均/去抖时间窗、溢出怎么处理自动清零/饱和保持/中断上报、甚至还能把两路编码器信号做差分合成比如 A 相减 B 相用于检测机械间隙。这才是它叫“自由”的原因——自由是建立在对底层时序、寄存器映射、中断优先级深刻理解基础上的可控性。适合谁不是只写逻辑的电气工程师而是要调伺服、做电子齿轮、实现多轴同步、或者需要把旧设备上的增量式编码器接入新 Codesys 控制器的现场调试工程师。如果你的项目涉及定位、回零、电子凸轮或飞剪那“自由编码器”就是你绕不开的第一道门。2. 为什么必须用 Free Encoder 而不是直接读 HSC 寄存器这个问题我被问过至少 37 次答案从来不是“因为方便”而是“因为安全、确定、可追溯”。让我用一个真实案例讲清楚去年帮一家包装厂改造灌装线他们原来的方案是用 Codesys 直接读取 CPU 模块自带的 4 路高速计数器寄存器HSC0–HSC3通过 ST 代码每 10ms 读一次HSC0_CNT再用MOVE指令把值传给MC_MoveRelative的Distance参数。上线后发现当灌装头高速启停时偶尔出现 2–3mm 的定位偏差产线 QA 拒收。我们用 Codesys 内置的 Trace 功能抓了一段 500ms 的扫描日志发现HSC0_CNT在某次扫描中值从 12456 突然跳到 12459中间缺了 12457 和 12458 —— 不是编码器丢脉冲而是 PLC 扫描周期波动导致两次读取之间漏掉了两个计数值。这就是裸读寄存器的致命缺陷HSC 计数是硬件异步进行的而 PLC 扫描是周期性同步任务。两者没有原子性保证。你读寄存器那一刻计数器可能正在更新中间值也可能刚完成一次溢出重载。Codesys 手册里明确写着“直接访问 HSC 寄存器属于非受控访问Uncontrolled Access其返回值不保证与当前运动指令执行时刻的位置严格对应。”Free Encoder 模块则完全不同。它本质是一个运行在 PLC 内核层的专用驱动模块与 HSC 硬件之间通过 DMA 或专用中断通道通信。当你在 Codesys 中配置好 Free Encoder 实例比如命名为Enc_Main并调用Enc_Main()周期性执行时模块内部会在每个扫描周期开始前触发一次 HSC 硬件锁存把当前计数值原子性地复制到一个双缓冲区Double Buffer确保软件读取的是“冻结快照”而非正在刷新的动态值执行方向判别算法对 AB 相编码器不是简单看 AB 就算正转而是构建 4 状态有限状态机Idle → A_up → B_up → A_down只有连续两个有效边沿才能确认一次方向变化彻底过滤掉机械抖动引起的误判应用可配置滤波默认启用 20μs 数字低通滤波对应约 50kHz 最大输入频率你可以在属性页里把它改成 100μs适应低速重载场景或禁用用于超高速激光测距生成标准化输出结构体返回的不是裸整数而是一个ST_FreeEncoderStatus类型变量包含.Position32 位有符号位置值、.Velocity计算出的速度单位 pulse/s、.DirectionTRUE/FALSE、.IsHomed是否已回零、.ErrorFlags溢出/相位错误/超速等告警位。提示Free Encoder 的.Position输出值是经过“方向累加”后的绝对位置不是 HSC 寄存器里的原始计数值。比如 AB 相编码器正转一圈产生 1000 个 A 上升沿反转一圈也是 1000 个 A 上升沿但.Position会显示 1000 和 -1000。而裸读HSC0_CNT你得到的永远只是 0→1000→0→1000 的循环值无法区分方向。再来看“codesys使用modbusrtu”这个热词背后的逻辑。很多工程师试图用 Modbus RTU 从外部智能编码器如某些带 RS485 输出的磁编读取位置然后手动赋值给运动指令。这看似绕开了 Free Encoder实则埋下更大隐患Modbus RTU 是串行协议典型响应时间 20–50ms而伺服周期要求通常 ≤ 1ms。你用 Modbus 读到的位置可能是 30ms 前的旧数据运动控制器却拿它去算当前应该输出的扭矩——结果就是振荡、过冲、甚至失步。Free Encoder 解决的正是“时间一致性”问题它的所有运算都在 PLC 的实时任务上下文中完成与运动控制任务共享同一时基误差在微秒级。所以选择 Free Encoder 不是图省事而是为了获得确定性的、可验证的、符合 IEC 61131-3 实时性要求的位置反馈。它把“硬件不确定性”封装成“软件确定性接口”这是工业控制可靠性的基石。3. Free Encoder 的核心参数配置与底层原理拆解Free Encoder 模块的配置界面看起来就几个选项但每个背后都牵扯到硬件时序、中断优先级和数学模型。我以 Codesys V3.5 SP11 中最常用的FB_FreeEncoder功能块为例逐项拆解其核心参数的物理意义和配置逻辑。3.1 输入信号类型与边沿配置不只是“AB 相”那么简单Free Encoder 支持三种输入模式SingleChannel单通道脉冲、TwoChannelAB 相正交、ThreeChannelABZ 三相含索引脉冲。但真正决定精度的是“边沿配置”Edge Configuration。单通道模式仅用 A 相支持Rising上升沿计数、Falling下降沿计数、Both双边沿计数。双边沿计数理论上可将分辨率提升一倍但前提是编码器信号质量极高。我实测过某国产 1000 线编码器在 2000rpm 下用Both模式因信号上升/下降时间不对称tr1.2μs, tf0.8μs导致每转多计 3–5 个脉冲。结论单通道模式务必用Rising靠提高编码器线数来提升精度而非赌信号边沿对称性。AB 相模式这才是工业主流。Free Encoder 默认采用“四倍频”X4解码即 A 和 B 各自的上升沿和下降沿都参与计数理论分辨率 编码器线数 × 4。但 X4 模式对信号相位差Phase Shift极其敏感。标准 AB 相理想相位差是 90°±5°而实际中老旧电机或长电缆会导致相位差衰减到 60°–70°。此时 X4 模式会出现“方向误判”表现为低速时位置来回跳动。解决方案是切换到X2模式仅用 A 相上升沿 B 相电平判断方向牺牲一半分辨率换取 100% 方向可靠性。我在调试一台 15 年老车床时就是靠X2模式解决了 Z 轴回零抖动问题。ABZ 模式Z 相零位脉冲不是简单用来“找原点”而是参与位置校验。Free Encoder 会监测 Z 相脉冲宽度若宽度 10μs判定为干扰噪声并忽略若连续 3 次 Z 相间隔脉冲数与标称值偏差 0.5%则置位.ErrorFlags.Z_Missing。这比单纯用 Z 相触发MC_Home可靠得多——它能主动发现编码器机械松动或磁环偏移。注意所有边沿配置都依赖硬件滤波器。Codesys 的 HSC 模块内置可编程数字滤波器其截止频率f_c 1 / (2 * T_filter)。例如设T_filter 100ns则f_c 5MHz可滤除 5MHz 以上噪声但也会引入 100ns 延迟。对于 100kHz 编码器信号100ns 延迟可忽略但对于 1MHz 激光测距编码器必须将T_filter设为 10ns否则相位误差达 36°X4 解码完全失效。3.2 滤波与去抖为什么 20μs 是默认值Free Encoder 的“数字滤波器”不是简单的 RC 电路模拟而是基于 FPGA 或 ASIC 实现的可配置状态机。其核心是“去抖时间窗”Debounce Time Window在检测到一次有效边沿后启动一个计时器期间忽略所有同类边沿。20μs 默认值的由来这是针对标准光电编码器上升/下降时间 ≤ 100ns和典型工业现场噪声开关触点抖动、继电器干扰的平衡点。20μs 足够滤除 99% 的机械抖动典型抖动持续 5–15μs又不会过度延迟真实脉冲100kHz 编码器脉冲间隔 10μs20μs 窗口仍能捕获相邻脉冲。何时该改高速场景 500kHz必须降至 5–10μs否则丢失脉冲。我调过一台薄膜分切机编码器 2500 线 3 倍频 7500ppr主轴 3000rpm → 375kHz设Debounce 5μs后Trace 显示脉冲捕获率从 92% 提升至 99.99%。低速重载场景如起重机起升编码器信号易受振动干扰建议增至 50–100μs。曾有一台 50 吨起重机用 1000 线编码器低速 1rpm时因钢丝绳微振导致 AB 相频繁误触发将Debounce设为 80μs 后位置曲线从锯齿状变为平滑直线。滤波器类型选择Codesys SP11 新增“滑动平均滤波”Moving Average适用于速度计算。它对连续 N 个采样周期的.Velocity值求平均N 可设 2–16。相比传统低通滤波它不引入相位滞后更适合需要快速响应的张力控制。但注意N16时速度值实际反映的是过去 16ms 的平均速度对突加负载的响应会延迟。3.3 位置溢出与数据类型32 位有符号整数的陷阱Free Encoder 输出的.Position是DINT32 位有符号整数范围 -2,147,483,648 到 2,147,483,647。表面看很大但换算成物理距离就容易踩坑。假设你用 5000 线编码器电子齿轮比1:1丝杠导程 10mm每转脉冲数 5000 × 4X4 20,000每脉冲对应位移 10mm / 20,000 0.0005mm.Position满量程对应行程 2,147,483,647 × 0.0005mm ≈ 1073.7km听起来够用错。问题出在“溢出处理”。Free Encoder 默认启用“自动溢出清零”Auto Overflow Reset。当.Position达到 2,147,483,647 后下一个脉冲会跳变为 -2,147,483,648。这对运动控制是灾难性的MC_MoveAbsolute看到目标位置从 2147M 突然变成 -2147M会认为要反向走 4294M立刻触发急停。正确做法是禁用自动清零在 Free Encoder 属性中勾选Disable Overflow Reset启用溢出中断配置OverflowInterrupt输出引脚连接到一个IRQ_Handler功能块在中断服务程序中用ADD指令维护一个 64 位全局位置变量// 全局变量声明 VAR_GLOBAL g_Position64 : LINT; // 64 位长整型 g_OverflowCount : DINT; // 溢出计数器 END_VAR // 溢出中断处理程序 PROGRAM IRQ_OverflowHandler VAR EncStatus : ST_FreeEncoderStatus; END_VAR EncStatus : Enc_Main(); // 获取当前状态 IF EncStatus.ErrorFlags.Overflow THEN IF EncStatus.Position 0 THEN g_OverflowCount : g_OverflowCount 1; ELSE g_OverflowCount : g_OverflowCount - 1; END_IF; // 清除溢出标志需查阅具体硬件手册此处为示意 Enc_Main.ResetOverflow(); END_IF; // 合成 64 位位置高 32 位来自计数器低 32 位来自当前位置 g_Position64 : SHL(g_OverflowCount, 32) OR DWORD_TO_LINT(EncStatus.Position);这个 64 位位置变量才是你真正该传给MC_MoveAbsolute的AbsolutePosition参数。它把“脉冲计数”的离散性转化成了“物理位移”的连续性彻底规避了溢出风险。4. 从零开始Free Encoder 完整实操流程与配置细节现在我们动手搭建一个完整的 Free Encoder 应用。目标用 AB 相编码器1000 线实现伺服轴的精确回零并将位置实时显示在 HMI 上。环境Codesys V3.5 SP11硬件为 Beckhoff CX9020ARM Cortex-A8EtherCAT 主站EL5101 24V 单端编码器输入端子。4.1 硬件组态与 IO 映射先让信号进来第一步永远不是写代码而是确保信号路径畅通。在 Devices Tree 中添加 EL5101右键EtherCAT Master→Add Device→ 搜索EL5101→ 添加。Codesys 会自动分配Input区域地址通常是GVL_Input结构体下的dwInput成员。确认信号接入方式EL5101 是单端输入A 相接Ch0B 相接Ch1公共端COM接编码器 0V。关键细节EL5101 的Ch0和Ch1输入阻抗为 10kΩ而多数编码器输出为推挽式Push-Pull内阻 100Ω可直接连接。但如果用的是集电极开路Open Collector编码器必须外接上拉电阻4.7kΩ 至 24V否则信号电平不足Free Encoder 无法识别。IO 映射检查在PLC Configuration→Mapping中确认EL5101的Input数据已映射到GVL_Input.dwInput[0]和GVL_Input.dwInput[1]。这两个DWORD变量分别存储 Ch0 和 Ch1 的原始计数值非位置值。Free Encoder 模块会自动读取它们你无需在程序中手动访问。提示不要试图用GVL_Input.dwInput[0]的值去算位置。这是硬件计数器的原始寄存器值未经方向判别和滤波直接读取会得到跳跃、抖动的数据。Free Encoder 的价值正在于它把这些原始值“翻译”成可信的位置。4.2 Free Encoder 功能块实例化与参数设定新建一个 POUsProgram Organization Unit类型选Program命名为MAIN。声明实例在VAR区声明VAR Enc_Main : FB_FreeEncoder; // 实例名可自定义 EncStatus : ST_FreeEncoderStatus; // 状态结构体必须声明 bHomeTriggered : BOOL; // 回零完成标志 END_VAR配置属性右键Enc_Main→PropertiesInputType:TwoChannelAB 相EdgeConfiguration:X4四倍频DebounceTime:20E-620 微秒科学计数法输入ResetOnOverflow:FALSE禁用自动清零EnableOverflowInterrupt:TRUE启用溢出中断InputChannelA:GVL_Input.dwInput[0]自动关联到 EL5101 Ch0InputChannelB:GVL_Input.dwInput[1]自动关联到 EL5101 Ch1PulsesPerRevolution:40001000 线 × 4告诉模块每圈多少脉冲用于速度计算调用功能块在MAIN程序主体中周期性调用建议放在CYCLIC任务中周期 1ms// 执行 Free Encoder 模块 Enc_Main( Enable : TRUE, Reset : FALSE, Position : 0 // 初始位置可设为 0 或上次断电位置 ); // 获取状态 EncStatus : Enc_Main.Status;此时编译下载打开 Online →Online View展开Enc_Main实例你应该能看到.Status.Position的值随编码器转动而稳定变化.Status.Velocity显示当前转速单位 pulse/s.Status.Direction正确反映转向。4.3 回零逻辑实现用 Free Encoder 驱动 MC_Home回零Homing是 Free Encoder 最典型的应用。我们采用“索引脉冲 方向搜索”模式Mode 1这是最可靠的方式。硬件准备确保编码器 Z 相已接入 EL5101 的Ch2需在 Devices Tree 中为 EL5101 启用Channel 2。声明运动对象在VAR区添加VAR Axis_Main : AXIS_REF; // 轴引用需在设备树中创建 HomeCommand : MC_Home; // 回零指令 HomeStatus : MC_Home_Status; // 回零状态 END_VAR配置轴参数在 Devices Tree 中右键Axis_Main→Properties→Motion→HomingHoming Mode:Index Pulse索引脉冲模式Home Velocity:100单位pulse/s对应约 15rpmSearch Velocity:500搜索速度单位 pulse/sOffset:0回零后位置偏移Position Source:Enc_Main关键必须指向你的 Free Encoder 实例编写回零程序// 初始化回零命令 HomeCommand( Axis : Axis_Main, Execute : bStartHome, // 外部触发信号如 HMI 按钮 Abort : FALSE, HomingMode : 1, // Mode 1: Index Pulse Velocity : 100.0, SearchVelocity : 500.0 ); // 获取回零状态 HomeStatus : HomeCommand.Status; // 回零完成标志 bHomeTriggered : HomeStatus.Done AND NOT HomeStatus.Error; // 错误处理 IF HomeStatus.Error THEN // 记录错误代码如 HomeStatus.ErrorCode 16#8001 表示 Z 相未找到 ERROR_LOG(ErrorCode : HomeStatus.ErrorCode); END_IF;关键点在于Position Source必须设为Enc_Main。这意味着MC_Home指令不再依赖硬件 HSC 的原始计数而是读取 Free Encoder 经过滤波、方向判别、溢出管理后的.Position值。当 Z 相脉冲到来时Free Encoder 会精确锁定那一刻的.Position并将其设为轴的HomePosition误差在 ±1 脉冲内。4.4 HMI 位置显示与单位转换让数据有意义最终用户不需要看“1245678 个脉冲”他们要看“325.67 mm”。这就需要单位转换。定义转换参数全局变量VAR_GLOBAL g_PulsesPerMM : REAL : 200.0; // 1000 线 × 4 / 10mm 400ppr/mm? 错这里是 200因为用了 2:1 电子齿轮 g_PositionMM : REAL; END_VAR在 MAIN 程序中计算// 将脉冲位置转换为毫米 g_PositionMM : REAL_TO_REAL(EncStatus.Position) / g_PulsesPerMM;HMI 绑定在 Codesys Visualization 中新建一个Text对象Binding设置为g_PositionMM格式化字符串设为%.2f mm。实操心得单位转换系数g_PulsesPerMM绝对不能硬编码在程序里必须做成 HMI 可配置参数。因为实际安装时丝杠导程可能有 ±0.01mm 误差或者皮带轮直径有加工公差。我见过太多项目调试时调准了交付后客户换了一根新丝杠整个定位系统就废了。正确做法是在 HMI 上放一个Numeric Input绑定到g_PulsesPerMM首次调试时用千分表实测 10mm 行程对应的脉冲数算出精确系数保存到非易失存储器如Persistent变量。5. 常见问题排查与独家避坑技巧实录Free Encoder 看似简单但现场问题五花八门。我把近三年遇到的典型故障、排查思路和独家技巧整理成速查表全是血泪经验。问题现象可能原因排查步骤解决方案我的独家技巧位置值随机跳变 ±100 脉冲编码器信号干扰地线未共地、电源噪声1. 用示波器测 A/B 相波形看是否有毛刺2. 检查 EL5101 的COM是否与编码器 0V、PLC 0V 短接加粗接地线编码器外壳接地在 EL5101 输入端并联 100nF 陶瓷电容技巧在 Codesys Trace 中同时记录EncStatus.Position和EncStatus.ErrorFlags.Noise。如果Noise标志频繁置位说明滤波不足立即将DebounceTime从 20μs 提到 50μs比换硬件快十倍。回零失败报错 0x8001Z 相未找到Z 相脉冲宽度太窄或电平异常1. 用示波器测 Z 相确认宽度 1μs2. 检查 EL5101 的Channel 2是否启用更换 Z 相输出更强的编码器或在 EL5101 属性中将Channel 2 Filter设为Slow技巧不要迷信“Z 相必须在 A/B 相之后”。有些编码器 Z 相在 A 相上升沿前 10° 触发。Free Encoder 的Homing Mode 1允许设置Z_Phase_Offset参数单位脉冲实测后填入可完美对齐。.Velocity值为 0但编码器在转速度计算周期过长或脉冲频率超限1. 查EncStatus.ErrorFlags.OverSpeed是否置位2. 算实际脉冲频率1000 线 × 4 × rpm / 60降低DebounceTime或改用X2模式降低分辨率技巧.Velocity是基于Position的微分计算采样周期 PLC 扫描周期。如果扫描周期是 10ms最大可测速度 2^31 / 10ms ≈ 214M pulse/s远超硬件极限。真正瓶颈是DebounceTime和HSC硬件上限。上电后.Position总是 0不保持断电前值未启用非易失存储1. 检查Enc_Main属性中SavePositionOnPowerDown是否勾选2. 确认硬件支持CX9020 需外接超级电容勾选SavePositionOnPowerDown或用Persistent变量在PROGRAM MAIN开头读取技巧SavePositionOnPowerDown有 10 万次写入寿命限制。我的做法是只在检测到EncStatus.IsHomed TRUE且bPowerDownFlag TRUE时才保存避免频繁写入耗尽寿命。多轴同步时各轴.Position时间戳不同步Free Encoder 实例未在同一任务中调用1. 检查每个Enc_Main_X是否都在CYCLIC 1ms任务中2. 确认任务优先级相同将所有 Free Encoder 实例放在同一个CYCLIC任务中周期设为最严苛轴的要求技巧Codesys 的CYCLIC任务是“软实时”存在微秒级抖动。对纳秒级同步要求如电子齿轮必须用Hardware Interrupt任务触发所有 Free Encoder 更新但这需要底层驱动支持SP11 中需定制固件。还有一个高频问题“codesys联合体”Union怎么用在 Free Encoder 数据处理上其实很简单。Free Encoder 的.Status是ST_FreeEncoderStatus结构体但有时你需要把它当BYTE数组发送给上位机。这时 Union 就派上用场TYPE ST_EncStatusUnion : UNION StatusStruct : ST_FreeEncoderStatus; Bytes : ARRAY[0..15] OF BYTE; // ST_FreeEncoderStatus 总共 16 字节 END_UNION END_TYPE // 使用 VAR EncUnion : ST_EncStatusUnion; END_VAR EncUnion.StatusStruct : Enc_Main.Status; // 填充结构体 // 现在 EncUnion.Bytes[0] 到 Bytes[15] 就是原始字节流可直接通过 Modbus TCP 发送这比手动BYTE_TO_WORD拆解快 10 倍且无字节序风险Codesys 默认小端序。最后分享一个小技巧Free Encoder 的.Position值其实是“从上电开始累计的脉冲数”。但很多客户需要“从机械原点开始的位置”。我的做法是在 HMI 上做一个“设为原点”按钮按下时执行Enc_Main.Reset(0)并将当前.Position记录为g_MechanicalZeroOffset。后续显示位置 EncStatus.Position - g_MechanicalZeroOffset。这样原点可以任意设定无需重新接线或调整编码器。我在实际使用中发现Free Encoder 的真正威力不在于它能读多快的编码器而在于它把“硬件不确定性”变成了“软件可控性”。每一次参数调整都是对物理世界的更深理解每一次故障排除都是对 Codesys 实时内核的一次探秘。它不是一个拿来即用的功能块而是一把钥匙打开了 Codesys 运动控制世界的大门。