简介：本资源是一份面向工业自动化工程师与CODESYS初学者的运动控制专项技术文档，聚焦电子齿轮同步控制这一核心场景，解决多轴协同运动中速比调节、相位补偿及主从轴动态响应等实际问题。文档以《CODESYS运动控制之MC_Power》为基础，系统讲解MC_GearIn功能块的配置逻辑，涵盖双虚拟轴（X/Y1）建模、模数1模式设置、速比（如1/2）与相位偏移参数设定，并结合MC_MoveVelocity与MC_Power实现主轴定速运行与从轴使能跟随，辅以时序图直观呈现同步关系。资源为单文件DOC格式，共1个文档，大小134KB，内容结构清晰，含8步实操流程与关键变量声明说明，便于快速理解与代码复用。目前已有2156人学习下载，适合需掌握SoftMotion电子齿轮应用、调试多轴联动或备考PLC运动控制认证的工程技术人员。
1. MC_GearIn 不是“加个功能块就同步”：它背后藏着一个实时相位锁存器，而多数人连它的触发边沿都设错了
你写完MC_GearIn(Enable := TRUE, MasterAxis := X, SlaveAxis := Y, Ratio := 0.5)，下载运行，发现从轴 Y 确实动了，速度也接近 50 —— 但一测位置误差，稳态下跳变 ±32768 脉冲；用示波器抓编码器信号，主从轴在加速段明显“错齿”，减速时甚至反向滑脱。这不是配置漏了参数，而是你根本没意识到：MC_GearIn 的本质不是速比计算器，而是一个带相位预补偿的闭环位置跟随器，其使能瞬间的 MasterAxis 当前位置值，会被硬锁存为 GearIn 的零点基准。这个锁存动作发生在 Enable 信号上升沿的第一个 PLC 周期采样点，而非你认为的“调用那一刻”。如果你在 Enable 置位前没确保主轴已稳定在目标速度（比如刚启动就触发），锁存的位置就是加速过程中的任意点，后续所有“1:0.5”的齿轮关系，都是基于这个错误零点推演的——就像给钟表装齿轮时，把分针卡在 12:07 的位置再拧紧，之后每转一圈，时针永远慢 7 分钟。这份《CODESYS运动控制之MC_GearIn.doc》文档里那张“主从轴时序图”之所以看起来完美，是因为它隐去了最关键的锁存时刻标注；而真正决定系统能否稳定同步的，恰恰是这 1 个 PLC 周期内的位置采样时机、轴模式配置、以及 Enable 信号与主轴运动状态的严格时序对齐。搞懂这个锁存机制，你才能把电子齿轮从“玄学同步”变成可复现、可测量、可调试的确定性行为。
2. 电子齿轮不是数学比例，而是位置环的动态重映射：MC_GearIn 如何把 Master 的位置值实时喂给 Slave 的位置环
2.1 位置映射公式：从SlavePos = MasterPos × Ratio + Offset到SlavePosCmd = f(MasterPosActual, Ratio, PhaseOffset, GearInState)
很多人以为 MC_GearIn 就是执行一个简单的乘法：Y_pos_cmd = X_pos_actual × 0.5。这是典型误解。真实逻辑远比这复杂——它不是在每次扫描周期做一次标量乘法，而是将 MasterAxis 的实际位置值（ActualPosition），经由一个带状态机的位置重映射函数，生成 SlaveAxis 的位置指令值（PositionCommand），并直接注入到 Slave 的位置环输入端。这个函数的核心输出是：
// CODESYS SoftMotion 内部等效逻辑（非用户代码，示意原理） FUNCTION_BLOCK MC_GearIn VAR // 输入 Enable: BOOL; MasterAxis: AXIS_REF; SlaveAxis: AXIS_REF; Ratio: REAL; // 速比，可正可负，支持小数如 0.333 或 3.0 PhaseOffset: LREAL; // 相位偏移，单位：脉冲（或工程单位，取决于轴配置） // 内部状态 bIsEngaged: BOOL; // 是否已成功锁存初始相位 lMasterPosAtEngage: LINT; // 锁存时刻的 Master 实际位置（关键！） lSlavePosAtEngage: LINT; // 锁存时刻的 Slave 实际位置（用于计算初始误差） // 输出 Status: MC_STATUS; // 包含 ErrorID、Busy、Error 等 END_VAR // 伪代码：位置指令生成核心逻辑 IF Enable AND NOT bIsEngaged THEN // 关键锁存点：仅在 Enable 上升沿且未锁存时执行 lMasterPosAtEngage := MasterAxis.ActualPosition; lSlavePosAtEngage := SlaveAxis.ActualPosition; bIsEngaged := TRUE; ELSIF Enable AND bIsEngaged THEN // 已锁存后，位置指令 = 锁存时 Slave 位置 + (当前 Master 位置 - 锁存时 Master 位置) × Ratio + PhaseOffset SlaveAxis.PositionCommand := lSlavePosAtEngage + (MasterAxis.ActualPosition - lMasterPosAtEngage) * Ratio + PhaseOffset; END_IF提示：
PhaseOffset并非简单加在最终指令上，而是作为“初始相位差补偿”参与锁存后的增量计算。它的物理意义是：当 Master 从锁存点移动 ΔM 时，Slave 应移动ΔM × Ratio + PhaseOffset。若PhaseOffset = 0，则两轴在锁存点完全对齐；若PhaseOffset = 1000，则 Slave 永远比 Master “超前”1000脉冲（按速比缩放后）。
2.2 模数1（Modulo 1）模式为何是电子齿轮的刚需：避免整数溢出导致的相位突跳
文档中强调“轴的模式设置为模数1”，这不是为了简化演示，而是解决一个底层硬件缺陷：编码器计数器和位置寄存器的位宽有限（常见32位有符号整型，范围±2147483647）。当主轴高速长距离运行时，ActualPosition可能累积到接近2^31，此时MasterAxis.ActualPosition - lMasterPosAtEngage的差值计算极易因整数溢出变为负极大值，导致SlaveAxis.PositionCommand瞬间跳变数百万脉冲——从轴直接飞车。
模数1（Modulo 1）模式强制将位置值归一化到[0, 1)区间（即一个机械周期内），内部用浮点运算维护高精度位置，对外暴露的是归一化后的LREAL值。此时Ratio和PhaseOffset的单位也自动切换为“周期比例”和“周期偏移”，彻底规避整数溢出。例如：
- 主轴一圈 10000 脉冲 → 模数1下，位置 0.0 表示 0 脉冲，0.5 表示 5000 脉冲，0.9999 表示 9999 脉冲；
Ratio := 0.5→ 从轴转半圈，主轴转一圈；PhaseOffset := 0.25→ 从轴初始相位比主轴超前 1/4 圈。
这才是文档要求“模数1”的真实原因：它不是教学妥协，而是电子齿轮在工业现场长期稳定运行的数学基石。
2.3 GearIn 的使能状态机：从Idle到Engaged的三阶段跃迁
MC_GearIn 并非布尔开关，而是一个五状态机（CODESYS SoftMotion v3.5+），但对用户关键的是前三阶段：
| 状态 | 条件 | 行为 | 对位置环的影响 |
|---|---|---|---|
| Idle | Enable = FALSE或首次上电 | 不锁存，不输出指令 | Slave 位置环接收原指令（如MC_MoveAbsolute的目标值）或保持静止 |
| Engaging | Enable上升沿触发，开始锁存 | 读取MasterAxis.ActualPosition和SlaveAxis.ActualPosition，校验轴使能状态 | Slave 位置环指令被冻结，等待锁存完成 |
| Engaged | 锁存成功，且Enable = TRUE | 启动实时位置映射计算，持续输出PositionCommand | Slave 位置环完全由 GearIn 驱动，原运动指令被屏蔽 |
注意：
Engaging阶段耗时固定为1 个 PLC 周期（非毫秒级，取决于你的任务周期，如 2ms 任务则为 2ms）。在此期间，若 MasterAxis 或 SlaveAxis 任一未使能（MC_Power.Status.Enabled = FALSE），状态机将卡在Engaging并置Status.ErrorID := 16#8001（Axis not enabled）。这意味着：MC_Power 必须在触发 MC_GearIn 前至少 1 个周期完成使能，否则 GearIn 永远无法进入Engaged状态。
3. 为什么 MC_MoveVelocity 是主轴的“定速引擎”，而非“启动按钮”：速度环与位置环的耦合真相
3.1 MC_MoveVelocity 的真实角色：它不发位置指令，而是接管速度环的设定值
MC_MoveVelocity常被误认为“让轴动起来的功能块”，但它真正的技术定位是：一个直接向轴的速度环（Velocity Controller）注入设定值（VelocitySetpoint）的接口。它绕过了位置环（Position Controller），不生成任何PositionCommand，而是将VelocitySetpoint直接送入速度环的输入端。其等效内部逻辑如下：
// MC_MoveVelocity 伪代码（SoftMotion 内部） FUNCTION_BLOCK MC_MoveVelocity VAR Enable: BOOL; Axis: AXIS_REF; Velocity: LREAL; // 目标速度，单位：工程单位/秒（如 mm/s） Acceleration: LREAL; // 加速率，单位：工程单位/秒² Deceleration: LREAL; // 减速率，同上 // 内部状态 bRamping: BOOL; // 是否处于加/减速阶段 rCurrentVel: LREAL; // 当前速度设定值（用于斜坡发生器） END_VAR IF Enable THEN IF NOT bRamping THEN // 初始启动：从 0 开始斜坡加速到 Velocity rCurrentVel := RAMP(rCurrentVel, Velocity, Acceleration, TaskCycleTime); IF ABS(rCurrentVel - Velocity) < 0.1 THEN bRamping := FALSE; END_IF; ELSE // 已达目标，维持恒速 rCurrentVel := Velocity; END_IF; // 关键：直接写入速度环设定值，不碰位置环！ Axis.VelocitySetpoint := rCurrentVel; ELSE // 停止：斜坡减速至 0 rCurrentVel := RAMP(rCurrentVel, 0.0, Deceleration, TaskCycleTime); Axis.VelocitySetpoint := rCurrentVel; END_IF关键结论：
MC_MoveVelocity输出的是VelocitySetpoint，而MC_GearIn输出的是PositionCommand。两者驱动的是轴控制器的不同层级——速度环 vs 位置环。当MC_GearIn进入Engaged状态后，它会强制将SlaveAxis.PositionCommand设为自己的计算值，此时 Slave 的位置环被接管；但 Slave 的速度环仍由其自身闭环调节，根据PositionCommand与ActualPosition的误差生成所需速度。因此，主轴用MC_MoveVelocity定速，是从源头保证MasterAxis.ActualPosition的变化率稳定，从而让MC_GearIn的PositionCommand计算具备可预测性。
3.2 为什么必须先让主轴“稳速”再触发 GearIn：斜坡阶段的位置导数不可控
假设主轴 X 正在用MC_MoveVelocity(Velocity := 100)启动，当前ActualVelocity = 30，ActualPosition正以非线性斜坡增长。此时若触发MC_GearIn.Enable := TRUE：
- 锁存的
lMasterPosAtEngage是斜坡中某点（如位置 12345）； - 但
MC_GearIn后续计算SlaveAxis.PositionCommand时，期望MasterAxis.ActualPosition以恒定速率100增长； - 然而实际
MasterAxis.ActualPosition在加速段是二阶曲线（s = 0.5×a×t²），其导数（速度）从 0 增至 100； - 导致
SlaveAxis.PositionCommand的生成速率与MasterAxis.ActualPosition的实际变化率严重失配，从轴 Y 出现明显滞后或超调。
这就是文档步骤 6 强调“速度达到 100 时，按固定速度 100 运行”后再触发 GearIn 的根本原因：只有主轴进入稳态恒速区，ActualPosition才是时间的线性函数（s = v×t + s₀），MC_GearIn的位置映射才具备数学上的可微性与可预测性。否则，电子齿轮就成了“猜位置游戏”。
3.3 MC_Power 的使能时序：它不仅是通电，更是位置环的“唤醒令”
MC_Power功能块常被当作“给轴上电”的开关，但它在 SoftMotion 中的真实作用是：初始化轴控制器的所有环路（位置、速度、电流），并释放位置环的使能锁（Position Loop Enable Lock）。其关键状态Status.Enabled为TRUE时，意味着：
- 轴驱动器已上电，编码器信号已锁定；
- 位置环、速度环的 PID 参数已加载；
Axis.PositionCommand输入端口已开放，可接收外部指令（如MC_GearIn的输出）；- 若此前
Axis.PositionCommand为 0，轴将保持静止；一旦有非零指令，位置环立即响应。
因此，步骤 5 “对 X、Y 轴使能” 是硬性前提。若MC_Power未执行或失败（如驱动器故障、编码器断线），MC_GearIn即便Enable := TRUE，也会因SlaveAxis位置环未就绪而卡在Engaging状态，Status.ErrorID返回16#8001。这不是 GearIn 的 bug，而是 SoftMotion 的安全设计：绝不允许向未使能的轴发送位置指令。
4. 避坑：MC_GearIn 同步翻车的 4 个血泪现场与根因诊断
4.1 现象：从轴 Y 启动后抖动剧烈，示波器显示位置指令呈锯齿状高频震荡
原因：MC_GearIn的Ratio参数使用了REAL类型变量（如rRatio: REAL := 0.5;），而该变量在 PLC 任务中被其他逻辑频繁修改（如 HMI 写入），导致每个扫描周期Ratio值微小波动（如 0.4999→0.5001）。由于MC_GearIn内部位置计算是ΔM × Ratio，微小Ratio波动被放大为位置指令的周期性跳变。
解决：Ratio必须声明为CONSTANT或使用FB的IN引脚传入，并确保调用侧逻辑不会在 GearIn 运行中动态改写。若需在线调整，应通过MC_GearOut先退出，修改后重新MC_GearIn。
4.2 现象：主轴 X 停止后，从轴 Y 继续惯性滑行一段距离才停，且停止位置每次不同
原因：MC_GearIn仅控制PositionCommand，但未干预SlaveAxis的减速行为。当主轴停止，MasterAxis.ActualPosition恒定，MC_GearIn输出恒定PositionCommand，此时从轴靠自身位置环的 P 增益“拖住”目标位置。若 P 增益过小或负载惯量大，就会出现滑行。
解决：在主轴停止前，主动触发MC_GearIn.Enable := FALSE，让从轴恢复原运动指令（如MC_MoveVelocity的减速指令）；或在MC_GearIn后串联MC_MoveVelocity，用其Deceleration参数控制从轴减速。
4.3 现象：更换不同型号电机后，同样Ratio := 0.5，但从轴 Y 的实际速比变成 0.48 或 0.52
原因：Ratio是纯数学比例，但实际速比受电机编码器分辨率、电子齿轮模式（模数1 vs 绝对位置）、以及MC_GearIn内部插补周期影响。若新电机编码器线数不同（如原 2500 线，新 5000 线），而轴配置未同步更新EncoderResolution参数，SoftMotion 计算ActualPosition时存在量化误差，导致ΔM累积偏差。
解决：务必在轴配置中精确设置EncoderResolution（每转脉冲数），并在MC_GearIn前用MC_ReadStatus读取Axis.Status.ActualPosition验证其数值合理性（如一圈是否接近理论值）。
4.4 现象：HMI 上点击“启动 GearIn”按钮，PLC 日志显示MC_GearIn.Status.ErrorID = 16#8005（Invalid parameter）
原因：PhaseOffset参数超出 SoftMotion 允许范围。PhaseOffset在模数1模式下应为[0.0, 1.0)，但 HMI 传入了1.0或-0.1；在绝对位置模式下，PhaseOffset应小于EncoderResolution，但传入了超大值。
解决：在调用MC_GearIn前，添加参数校验逻辑：
IF AxisMode = MODULO_1 THEN IF PhaseOffset >= 1.0 OR PhaseOffset < 0.0 THEN PhaseOffset := 0.0; // 重置为默认对齐 END_IF; ELSIF AxisMode = ABSOLUTE THEN IF ABS(PhaseOffset) > EncoderResolution THEN PhaseOffset := 0.0; END_IF; END_IF;5. GearIn 的“相位补偿”不是调零，而是构建虚拟主轴：一个被忽略的底层设计哲学
5.1 PhaseOffset 的本质：它在 Master 和 Slave 之间插入了一个“虚拟主轴”
教科书式解释PhaseOffset是“初始位置偏移”，这没错，但太浅。深入看，MC_GearIn的完整位置映射公式是：
SlavePosCmd = SlavePosAtEngage + (MasterPosActual - MasterPosAtEngage) × Ratio + PhaseOffset将SlavePosAtEngage和MasterPosAtEngage视为常量，整理得：
SlavePosCmd = (MasterPosActual × Ratio) + [PhaseOffset + SlavePosAtEngage - MasterPosAtEngage × Ratio]方括号内是常量C，所以SlavePosCmd = MasterPosActual × Ratio + C。
这个C就是PhaseOffset的物理意义：它定义了当MasterPosActual = 0时，SlavePosCmd的值。但MasterPosActual = 0在模数1下是“一圈起点”，在绝对模式下是“机械零点”。MC_GearIn并不关心这个零点在哪，它只关心：从锁存时刻起，Slave 的运动轨迹是 Master 轨迹的线性变换。
因此，PhaseOffset的真正价值，是让你在不改动机械安装的前提下，用软件定义一个“虚拟主轴”。例如：
- 实际主轴 X 的编码器零点与齿轮箱物理零点偏差 15°；
- 你不想拆机校准，只需在
MC_GearIn中设PhaseOffset := -15.0 / 360.0（模数1下），即可让从轴 Y 的运动完全对齐物理零点。
这揭示了 SoftMotion 的设计哲学：电子齿轮不是模拟机械，而是用数学重构运动关系。机械齿轮的齿隙、背隙、热变形，全被抽象为Ratio和PhaseOffset两个可在线修正的参数。这才是它比机械方案更灵活的根本原因。
5.2 为什么 GearIn 不提供“相位微调”功能块？因为相位是锁存时刻的快照
有人问：“能否在 GearIn 运行中动态微调PhaseOffset？”答案是不能，且不应设计成能。原因在于PhaseOffset不是独立变量，而是SlavePosAtEngage - MasterPosAtEngage × Ratio的体现。一旦 GearIn 启动，MasterPosAtEngage和SlavePosAtEngage就已固化为锁存时刻的快照。若允许运行中修改PhaseOffset，相当于强行扭曲已建立的位置映射关系，导致从轴位置指令突变，引发冲击。
正确的做法是：用MC_GearOut退出，调整PhaseOffset，再MC_GearIn重新锁存。这看似麻烦，实则是保证运动确定性的必要约束。SoftMotion 的设计者清楚知道：在运动控制领域，“可预测的停顿”远胜于“不可预测的平滑”。
5.3 从那以后我每次配置 MC_GearIn，都强制走一遍“三步锁存验证法”
第一步：静态锁存验证
在主轴 X 静止时（MC_MoveVelocity.Velocity = 0），触发MC_GearIn.Enable := TRUE，立即读取MC_GearIn.Status，确认ErrorID = 0且Status.State = ENGAGED；再读SlaveAxis.ActualPosition，记为P_slave_static；计算理论值P_master_static × Ratio + PhaseOffset，对比误差应 < 1 脉冲。第二步：动态锁存验证
让主轴 X 以低速（如 10 单位/秒）匀速运行，待速度稳定后触发MC_GearIn，用MC_ReadStatus读取连续 100 个周期的SlaveAxis.PositionCommand，绘制曲线，应为完美直线，斜率 =10 × Ratio。第三步：扰动恢复验证
GearIn 运行中，短暂切断主轴使能（MC_Power.Enable := FALSE100ms），再恢复；观察从轴 Y 是否在 2 个 PLC 周期内恢复同步，位置误差峰值 <5 × Ratio脉冲。
这套方法源于某次产线调试：客户抱怨“同步偶尔失锁”，我们发现是MC_Power使能信号有 5ms 抖动，导致MC_GearIn在Engaging阶段收到干扰。从此，我把“锁存时刻的信号质量”列为 GearIn 配置的最高优先级检查项。希望帮到你。
本文还有配套的精品资源，点击获取
