跳到主要内容

Lyra PLC EtherCAT 使用教程

本教程面向首次使用 Lyra PLC 连接 EtherCAT 运动控制设备的用户。

信息

本文档验证环境:Rockchip RK3506B,Linux 6.1.99; 配套主站协议栈:IgH EtherCAT Master 1.6.10; 测试从站:iRDT Driver。

1. Lyra PLC EtherCAT 主站软件组成​

Lyra PLC 基于 IgH EtherCAT Master 完成 EtherCAT 主站通信功能。

Lyra PLC 的 IgH EtherCAT 主站架构

图1-1 Lyra PLC 的 IgH EtherCAT 主站架构

上层控制程序调用ecrt应用接口完成从站注册、PDO 映射配置,并创建Domain作为周期过程映像缓冲区。IgH 主站内核模块负责 EtherCAT 报文收发;控制程序在固定实时周期内读取输入反馈、执行业务逻辑、写入输出指令并下发下一周期报文。

2. Lyra PLC 使用前准备​

2.1 项目软件包适用环境​

配置项配置值
主站设备Lyra PLC
CPU 架构armv7l,32位 ARM
Linux 内核6.1.99,SMP PREEMPT
EtherCAT 主站IgH EtherCAT Master 1.6.10
用户空间 ABIARM EABI5 hard-float
默认 EtherCAT 接口eth1

部署业务程序前,请在 Lyra‑PLC 终端校验平台环境:

uname -r
uname -m
ethercat version
ip -br link

执行显示:

校验要求:内核版本、CPU 架构、IgH 主站版本必须和软件包匹配,且 EtherCAT 专用网口存在。内核模块与系统环境强绑定,跨平台编译产物不可直接安装运行。

2.2 硬件与设备资料​

设备当前项目使用的型号用途与注意事项
EtherCAT 主站Lyra PLC运行 IgH EtherCAT Master 与上层控制应用
EtherCAT 从站iRDT Driver,在线设备名 iRDT_CIA402由 LAN9252 ESC 从站控制器 + STM32G474 电机控制 MCU 构成
电机三相无刷直流电机U/V/W 三相接入 iRDT 驱动器;首次上电务必空载调试;核对电机铭牌额定电压、电流、功率、转速、极对数参数

当前示例程序依靠从站身份码进行匹配校验:Vendor ID 0x00000009、Product Code 0x26483052、Revision 0x00010211。更新驱动器固件或更换硬件型号后,必须重新核对该组标识。

完整数据流路径:

  • 控制下行路径:Lyra PLC → EtherCAT 总线 → LAN9252 → SPI → STM32G474 → 三相 PWM 输出 → 三相无刷直流电机
  • 反馈上行路径:MT6701 编码器 → STM32G474 → SPI → LAN9252 → EtherCAT 总线 → Lyra PLC

3. Lyra PLC 主站启动与从站确认​

3.1 硬件接线与从站上电​

Lyra PLC 与 iRDT Driver 接线

图3-1 Lyra PLC 与 iRDT Driver 接线

确认供电电压、极性、电机接线无误,依次给 iRDT 驱动器、Lyra‑PLC 上电。

链路检测命令:

cat /sys/class/net/eth1/carrier
cat /sys/class/net/eth1/speed

执行显示:

链路返回正常,100Mbps是EtherCAT标准通信速率。

3.2 上传控制程序​

通过 SSH 将演示程序上传至 PLC:

ssh root@<PLC管理口IP> "mkdir -p /root/ethercat-app"
scp ethercat_csv_test root@<PLC管理口IP>:/root/ethercat-app/

上传完成后,赋予可执行权限并校验动态依赖库:

chmod +x /root/ethercat-app/ethercat_csv_test
ldd /root/ethercat-app/ethercat_csv_test

执行显示:

3.3 检查主站软件​

在Lyra‑PLC 上执行下述命令校验IgH EtherCAT 主站组件:

which ethercat
ethercat version

执行显示:

3.4 启动 EtherCAT 主站​

使用产品配套脚本ec.sh启动主站;本项目 EtherCAT 默认绑定网口eth1:

EC_IF=eth1 . ec.sh start
. ec.sh status

执行显示:

说明:扫描后从站状态为PREOP仅表示主站成功发现从站;启动周期控制程序后方可将从站切换至OP运行状态。 主站启动成功判定条件:

  • EtherCAT 专用网口链路为 UP;
  • 字符设备文件 /dev/EtherCAT0 创建成功;
  • 总线扫描从站数量与实际硬件一致;
  • 从站名称为iRDT_CIA402,状态标识无错误标记E。

主站启动成功后,禁止重复手动加载同一批内核模块。

3.5 主站与从站状态检查​

ls -l /dev/EtherCAT0
ethercat master
ethercat slaves
ethercat slaves -v

核查重点:主站绑定网口、链路 Link 状态、在线从站总数;校验从站 Vendor‑ID、Product‑Code、Revision 版本号、设备名称、端口状态。

执行显示:

3.6 从站 PDO 映射确认​

进入PREOP状态后读取从站实际 PDO 配置:

ethercat pdos -p 0

当前 iRDT 驱动器固件采用固定 PDO 映射:

RxPDO 0x1602:
0x6040:00 / 16 bit Control Word
0x60FF:00 / 32 bit Target Velocity

TxPDO 0x1A02:
0x6041:00 / 16 bit Status Word
0x6064:00 / 32 bit Position Actual Value

3.7 SDO 参数读取​

从站处于PREOP阶段,可通过 SDO 通道执行只读诊断:

ethercat upload -p 0 -t uint16 0x6041 0
ethercat upload -p 0 -t int8 0x6061 0
ethercat upload -p 0 -t uint16 0x603F 0

执行显示:

返回值全部为 0 含义:

  • Status Word = 0x0000 → 驱动器尚未进入使能流程,处于上电初始状态
  • Mode Display = 0 → 运动控制模式未配置
  • Error Code = 0x0000 → 驱动器无故障报警

4. 电机控制与通信验证​

4.1 零输出通信测试​

确认电机空载、外部急停回路有效,启动演示程序开启周期通信:

/root/ethercat-app/ethercat_csv_test

执行显示:

该程序开启周期通信链路,不会下发电机使能指令。新开终端窗口监控总线状态:

ethercat slaves
ethercat domains -d 0 -v

执行显示:

日志解读示例:

Domain0: Size 12, WorkingCounter 3/3 ← 周期通信链路正常

Output(主站→从站): 00 00 00 00 00 00
0x6040 Control Word = 0x0000 ← 电机未使能
0x60FF Target Velocity = 0 ← 目标速度原始值为 0

Input(从站→主站): 21 12 00 00 00 00
0x6041 Status Word = 0x1221 ← 使用 0x006F 掩码后为 0x0021,驱动器处于 Ready to switch on 状态
0x6064 Position Actual Value = 0 ← 当前收到的位置反馈原始值为 0

4.2 电机低速试转​

零输出通信测试验证无误后,按下Ctrl‑C终止程序,执行带使能控制命令:

/root/ethercat-app/ethercat_csv_test --enable --velocity 50 --strategy standard

示例程序通信周期固定为 2 ms;程序先发送一段零输出报文,再依据 CiA‑402 状态字逐级切换驱动器运行状态。

CiA 402 驱动器使能过程

图4-1 CiA 402 驱动器使能过程

驱动器进入Operation enabled运行状态后,程序下发非零速度目标值。 执行显示:

调试核查项:

  1. 电机旋转方向和预期一致;
  2. 驱动器状态字进入运行使能状态,无 Fault 故障标志;
  3. 下发目标速度由 0 变为 50;
  4. TxPDO 反馈数据随电机运动实时刷新;
  5. Domain 工作计数器 WKC 保持完整匹配。

速度单位提示:数值50并不默认等于 50 rpm;当前演示数值适配 iRDT 驱动器固件约定;更换其他品牌伺服驱动器,必须查阅设备手册完成速度单位换算。

4.3 安全停止​

按下Ctrl‑C终止控制程序,应用程序应优先下发零速度指令、撤销电机使能,随后释放 EtherCAT 主站资源。 电机完全停止后方可关闭主站服务:

EC_IF=eth1 . ec.sh stop

禁止在电机高速运行阶段直接拔掉 EtherCAT 网线作为停机手段。普通 EtherCAT 通信程序无法替代独立急停回路、安全继电器、驱动器内置安全功能;设备安全停机方案需单独设计。

4.4 控制应用周期处理流程​

EtherCAT 控制应用处理流程

图4-2 EtherCAT 控制应用处理流程

5. 常用命令​

5.1 主站管理脚本​

命令使用时机
EC_IF=eth1 . ec.sh start指定 EtherCAT 网口,启动 IgH 主站
EC_IF=eth1 . ec.sh status查询链路状态、主站设备、在线从站概况
EC_IF=eth1 . ec.sh stop电机安全停机后关闭 EtherCAT 主站

5.2 IgH 诊断命令​

命令用途
ethercat master查询主站实例、绑定网口、链路状态与收发统计信息
ethercat slaves查看从站位置编号、通信状态、错误标记
ethercat slaves -v读取从站身份、端口配置、邮箱与 DC 分布式时钟能力
ethercat pdos -p 0获取 0 号从站当前生效的 PDO 映射
ethercat domains -d 0 -v查看激活 Domain 域、WKC 工作计数器、原始过程数据
ethercat upload -p 0 -t uint16 0x6041 0读取 0 号从站 CiA‑402 状态字
ethercat xml -p 0基于在线扫描信息生成从站 ESI 描述 XML 文件
ethercat cstruct -p 0导出 PDO 映射对应的 C 语言结构体参考代码

提示:ethercat sii_read输出原始二进制数据,不可直接打印到终端,需重定向保存至文件:

ethercat sii_read -p 0 > /tmp/slave0_sii.bin

6. 故障排查​

6.1 ec.sh start 报链路超时​

ip -br link
cat /sys/class/net/eth1/carrier
cat /sys/class/net/eth1/speed

排查顺序:从站供电、IN 端口接线方向、网线品质、EtherCAT 网口选择。carrier=0链路断开时优先修复物理层,不要修改 PDO 配置。

6.2 /dev/EtherCAT0 字符设备不存在​

lsmod | grep '^ec_'
dmesg | grep -i ethercat | tail -50
modinfo /lib/modules/$(uname -r)/extra/ec_master.ko | grep vermagic

根因:内核模块未加载、加载顺序错误、内核版本不匹配、字符设备创建失败。

6.3 主站启动成功,扫描不到从站​

ethercat master
cat /sys/class/net/eth1/address
ethercat slaves

校验主站绑定 MAC 地址是否与 EtherCAT 专用网口一致;检查从站 IN/OUT 接线、供电状态。

6.4 从站状态停留在 INIT / PREOP / SAFEOP​

ethercat slaves -v
ethercat pdos -p 0
dmesg | grep -i ethercat | tail -80
  • INIT:排查邮箱初始化、SII 信息读取失败、底层链路故障
  • PREOP:确认控制应用已启动、从站身份匹配、PDO 映射配置被从站接受
  • SAFEOP:核查 PDO 配置、同步管理器、WKC、输出看门狗超时
  • 状态后附带E错误标记:读取 AL 状态码、内核日志定位故障;禁止反复执行ethercat state -p 0 OP强制跳转状态

注意:手动下发ethercat state -p 0 OP命令仅用于故障诊断;不可替代应用程序完成 Domain、PDO、周期报文配置。

6.5 报错:PDO 已映射或映射不支持修改​

故障一般由从站采用固定 PDO 映射、应用注册的 PDO 列表和从站实际映射不一致造成。

ethercat pdos -p 0
ethercat cstruct -p 0

解决方案:控制程序注册的对象索引、子索引、数据位宽必须与从站在线 PDO 配置完全匹配。

6.6 WKC 工作计数器不完整​

ethercat domains -d 0 -v
ethercat slaves

排查方向:从站掉线、从站数量变更、Domain 过程数据长度不匹配、网线间歇性断开、应用周期发送逻辑异常、从站输出看门狗触发。

6.7 持续出现 TIMED OUT、UNMATCHED报错​

应用启动 / 释放主站瞬间少量警告属于正常现象;高频持续报错为异常。排查清单:

  • 末端从站 OUT 端口误回接主站网口;
  • 同一总线同时运行 2 个 IgH 主站实例或 2 份周期控制程序;
  • 周期运行过程中频繁执行 SDO 读写、状态修改等 CLI 命令;
  • 实时周期线程长时间阻塞;
  • 网卡、网线、从站供电不稳定。

故障定位方法:停止控制应用,保持主站后台空闲扫描。若报错消失,则问题出在上层应用周期调度;报错依旧则排查物理链路与总线拓扑。

6.8 EtherCAT 链路 OP 状态正常,但电机不运转​

排查顺序,请勿直接增大速度目标值:

  1. EtherCAT 从站通信状态是否为OP;
  2. Domain WKC 计数器是否完整;
  3. 对象0x603F故障码是否为 0;
  4. 控制模式对象0x6061配置正确;
  5. CiA‑402 状态字0x6041进入Operation enabled;
  6. Domain 输出缓冲区中控制字、目标速度值已经刷新;
  7. 驱动器本地按键、串口控制台是否抢占 EtherCAT 控制权;
  8. 电机、编码器供电、固件运动控制模式匹配。

重要提示:从站进入 OP 仅代表 EtherCAT 周期数据链路就绪;不等于 CiA‑402 驱动器已经完成电机使能。

6.9 电机旋转,反馈值恒为零或解析异常​

ethercat pdos -p 0
ethercat domains -d 0 -v
ethercat upload -p 0 -t int32 0x6064 0

核查项:TxPDO 映射对象索引(0x6064实际位置 /0x606C实际速度);上层应用 PDO 偏移地址、数据位宽、有符号解析、字节序是否正确;从站固件是否实时刷新反馈对象;编码器硬件与驱动器内环是否正常工作。

故障定位:Domain 原始字节数据变化、应用显示反馈为 0 → 主站上层应用解析逻辑出错;原始反馈字节始终为 0、驱动器本地控制电机运转正常 → 故障点位于从站固件反馈数据更新逻辑。