EtherCAT 错误的三大分类与硬核诊断指南

 错误总览：三大核心类别

      Category 1 — 网络启动阶段的永久性错误（Permanent errors during network startup）
      特点：这类错误直接阻止网络进入 Operational（OP）状态，在主站应用程序启动时就会立刻暴露。
      常见原因：ENI 配置文件丢失、物理拓扑与规划不符、或从站（SubDevice）拒绝初始化命令。

      Category 2 — 网络运行中的永久性错误（Permanent errors during operation）
      特点：网络本来运行正常，但中途发生突发状况（如网线被拔、从站掉电、固件崩溃）。
      常见原因：属于硬件或物理链路的断开，问题不会自动消失，必须进行人工或程序干预。

      Category 3 — 运行中的间歇性错误（Intermittent errors during operation）
      特点：网络仍在运行，但不够完美（存在丢包或周期性过程数据的 Working Counter 不匹配）。
      常见原因：通常由电磁干扰（EMI）、劣质线缆等瞬态问题引起，往往最难排查。

 第一类：启动错误 — 当网络无法正常上电升至 OP 态

      1. 缺失 ENI 配置文件
      最简单的故障：EtherCAT Network Information 文件不在应用程序期望的路径下。现象为 EC-Master 报错 Configuration not found (0x98110070)，演示程序直接退出。

      2. 拓扑不匹配（Topology Mismatch）
      ENI 文件中配置了 5 个从站，但物理上只连接了 3 个（例如两个从站之间的网线被拔掉了）。EC-Master 扫描总线，将发现的设备与配置进行比对，并精确报错指出不匹配的位置。

      3. 从站位置颠倒（Swapped SubDevices）
      一个更隐蔽的问题：5 个从站全都在，但其中一个被物理移动到了链条中的其他位置。从站总数虽然对得上，但拓扑顺序错了。EC-Master 在特定位置检测到了非预期的设备类型。排查时可使用 EC-Engineer 的 Network Mismatch Analyzer（通过 Network -> Network Mismatch Analyzer 进入），它会以并排对比的方式展示「配置的设备 vs 实际发现的设备」，并将不匹配项用红色高亮显示。

      4. IN/OUT 端口接反 — 危险的布线错误
      该场景对伺服驱动器等设备尤其危险。例如在 Bosch Rexroth ctrlX DRIVE 上，EtherCAT 的 IN 接口在单元底部。如果有人把驱动器上的 IN 和 OUT 网线接反，第三轴可能会被识别为第二轴，从而静默地将机器人的 Y 轴和 Z 轴反向，这极容易造成严重的物理设备损坏。EC-Engineer 的 Line Crossed Analyzer 会将接错的从站用红色标出，使问题一目了然。

      5. 从站初始化失败（SubDevice Initialization Failures）
      当从站的 Sync Manager（同步管理器）配置或 PDO 映射与其固件期望的不一致时，它会拒绝从 PREOP 状态转换到 SAFEOP 状态。现象为带有特定错误码的 AL Status Error（例如：Invalid Output Configuration (0x001D) 或 Object does not exist in object dictionary (0x9811004A)）。根本原因通常源于 ESI（EtherCAT SubDevice Information）文件、ENI 配置文件以及实际从站固件版本之间的不匹配。

 第二类：运行时错误 — 当正常的网络突然中断

      1. 主站断开与重连（MainDevice Disconnect & Reconnect）
      断开：拔掉主站的以太网线会瞬间切断所有通信。EC-Master 检测到链路断开（link-down）状态，上报丢包错误，并将所有从站标记为「缺席（absent）」。重连：重新连接后，EC-Master 检测到链路恢复，重新扫描总线，并提示所有从站重新在线。注意：部分从站在此期间可能会掉落到 SAFEOP 状态，应用程序必须显式地重新下发命令将其拉回 OP 状态。

      2. 从站断开与重连（SubDevice Disconnect & Reconnect）
      断开：断开从站之间的网线更加微妙——只有断开点下游的设备会丢失。EC-Master 会在受影响的过程数据命令上报 WKC（Working Counter）错误，并精准识别出哪些从站已经缺席。重连后，EC-Master 的自动总线扫描会检测到拓扑变化并通知应用程序。设计原则：EC-Master 不会自动将从站恢复到 OP 状态，这是一个刻意的设计决策——应用程序必须自行判断此时恢复运行是否安全。

      3. 掉电与恢复（Power Failure & Recovery）
      当从站掉电时，其行为类似于网线断开，但有一个重要区别：当电源恢复时，从站会从 INIT 状态（而不是之前的状态）重新启动。应用程序必须引导它们重新走完完整的状态机。

      4. 从站意外状态降级（Unexpected SubDevice State）
      由于内部错误，从站可能会自主降级到较低状态。模拟测试通过 EC-Training Disturber 模拟时，会上报同步错误（0x1A）并从 OP 跌落到 SAFEOP ERROR。EC-Master 通过 EC_NOTIFY_SLAVE_ERROR_STATUS_INFO 检测 AL 状态变化，并将具体错误码提供给应用程序。

      5. 从站故障导致的完全丢包（Total Frame Loss）
      这是最具挑战性的场景之一：某个从站完全停止转发报文，但其 Link 状态依然保持活跃（Active）。由于上游从站没有检测到 Link-Down，它无法自动闭环，导致所有报文全部丢失——甚至连链条中排在前面的健康从站也无法通信。EC-Master 的 ecatRescueScan() API 正是为了这种极端情况设计的。它会逐个探测从站以确定哪个设备阻断了报文转发，从而在正常通信彻底中断时也能揪出故障设备。

      6. 接入了未知的非预期从站（Unexpected SubDevice Connected）
      连接了不属于 ENI 配置的设备会触发总线配置不匹配通知。EC-Master 识别出意外设备并上报其 Vendor ID 和产品代码。该未知从站将保持在 INIT 状态，不与其交换任何过程数据。为防止未知设备干扰通信，EC-Master 提供了「Border Close（边界关闭）」API，用于关闭最后一个配置从站上未使用的端口，从而拒绝任何新接入的设备。

      7. PDI 看门狗 — 固件崩溃检测（PDI Watchdog）
      如果从站固件崩溃并停止访问其过程数据接口（PDI），EtherCAT 从站控制器（ESC）硬件会通过 PDI Watchdog 定时器检测到这一情况。EC-Master 读取此状态并通知应用程序。恢复需要通过 INIT 循环重启从站并使其返回 OP 态。

 第三类：间歇性错误 — 那些「隐蔽的杀手」

      1. 工作计数器错误（Working Counter, WKC Errors）
      每一个周期的 EtherCAT 帧都携带一个 Working Counter，每有一个成功处理该命令的从站，WKC 就会自增。如果实际 WKC 与预期值不符，说明至少有一个从站没有正确处理该命令。EC-Master 在每个周期比对 WKC 值，并通过 EC_NOTIFY_CYCCMD_WKC_ERROR 上报不匹配情况，包括命令类型、逻辑地址以及期望与实际的 WKC 值。

      2. 偶发性丢帧与物理链路劣化
      EC-Training Disturber 可以选择性地丢弃报文，以此模拟 EMI（电磁干扰）或劣质线缆。排查手段方面，EC-Master 持续追踪发送的每个报文，并标记未能在预期时间内返回的报文；连续读取从站错误寄存器（寄存器 0x0300 ff.）以定位网络中发生错误的具体位置；emGetSlaveStatistics() API 暴露出这些计数器；EC-Engineer 的 Extended Diagnosis（扩展诊断）选项卡按从站、按端口展示这些统计数据——显示无效帧/CRC 错误、RX 错误、丢链计数（Lost Link counts）以及转发 RX 错误。

盟通科技有限公司     

      盟通科技专注于实时现场总线技术及工业通讯技术的研发、推广及技术支持服务，与多家行业领先的商业伙伴合作，致力于为工业自动化领域的客户提供优质服务。公司现有多款适用于工业自动化支持的软件协议栈及开发所需的正版授权软件，同时，经验丰富的技术团队也可以帮助客户设计与调试并提供必要的技术支持。