📚 课程目录第4章 EtherCAT主站开发环境搭建

4. EtherCAT主站开发环境搭建

EtherCAT主站开发的第一步不是写代码，而是选对主站栈并让它在正确的实时内核上跑起来。主站栈决定了API风格、许可成本、诊断能力和可移植性；实时内核决定了周期抖动能否稳定在微秒级。两者选错，后续所有应用层优化都会被底层抖动吃掉。本节先建立选型判断框架，再以Linux平台最常用的IgH EtherCAT Master为例，完整走通“内核准备—编译安装—网卡绑定—主站启动—从站扫描—周期抖动观测”的闭环。

一、四类主站栈的定位与选型依据

IgH EtherCAT Master是开源GPL方案，运行在Linux内核态，提供字符设备接口和用户态库，支持分布式时钟、DC同步、冗余和热插拔，适合自研控制器、运动控制卡和需要深度定制的场景。SOEM（Simple Open EtherCAT Master）是开源轻量方案，纯用户态、跨平台、代码量小，适合快速原型、嵌入式Linux和教学验证，但它对DC同步和复杂拓扑的支持弱于IgH，实时性依赖应用层线程调度。TwinCAT是Beckhoff的Windows实时方案，与TwinCAT PLC、Scope、XAE深度集成，开发效率高，但绑定Windows实时扩展和Beckhoff生态，授权成本随规模上升。Acontis（EC-Master）是商业跨平台方案，支持Windows、Linux、VxWorks、QNX、RTOS，提供完整DC、冗余、线缆冗余和诊断，适合产品化且需要多OS复用的团队，但需商业授权。

选型时按四个维度打分：实时性要求（周期≤250μs且抖动≤10μs优先IgH或Acontis）、操作系统约束（Windows优先TwinCAT，多OS优先Acontis）、开发成本（原型优先SOEM，产品化优先商业栈）、功能需求（DC同步、冗余、热插拔、诊断深度）。教学与自研控制器场景下，IgH + PREEMPT_RT是性价比最高的组合。

二、实时内核配置：PREEMPT_RT的编译与验证

IgH主站本身不提供实时性，它依赖内核调度。标准Linux内核在中断、自旋锁和软中断路径上存在不可抢占区，周期抖动常在数百微秒到毫秒级。PREEMPT_RT补丁将大部分自旋锁转为可睡眠的rt_mutex，把中断处理线程化，使高优先级EtherCAT线程能在微秒级被唤醒。配置流程如下：

# 1. 获取内核与RT补丁（示例版本，实际按项目锁定）
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.6.tar.xz
wget https://cdn.kernel.org/pub/linux/kernel/projects/rt/6.6/patch-6.6-rt15.patch.xz
tar -xf linux-6.6.tar.xz && cd linux-6.6
xz -d ../patch-6.6-rt15.patch.xz && patch -p1 < ../patch-6.6-rt15.patch

# 2. 配置内核关键项
make menuconfig
# General setup -> Preemption Model -> Fully Preemptible Kernel (RT)
# Processor type -> High Resolution Timer Support = Y
# CPU Power Management -> CPU Frequency scaling = N（关闭变频，避免抖动）
# Device Drivers -> Network device support -> 保留目标网卡驱动

# 3. 编译安装
make -j$(nproc) && make modules_install && make install
update-grub && reboot

重启后执行 uname -a，若版本号带 -rt 后缀即表示RT内核生效。随后用 cyclictest 验证：cyclictest -t1 -p80 -n -i1000 -l100000，观察Max列。在关闭变频、隔离CPU、无重负载的示例环境下，Max通常可落在20～50μs；若超过100μs，需检查是否开启了C-State、是否运行了桌面环境或网络中断是否集中在同一核。

三、IgH EtherCAT Master编译与网卡绑定

IgH源码从官方仓库获取后，先安装依赖 autoconf automake libtool pkg-config，再执行：

./bootstrap
./configure --prefix=/opt/etherlab \
  --with-linux-dir=/usr/src/linux-6.6 \
  --enable-generic --enable-8139too=no \
  --disable-eoe
make && make modules && make install
depmod
cp /opt/etherlab/etc/sysconfig/ethercat /etc/sysconfig/ethercat

关键配置在 /etc/sysconfig/ethercat：MASTER0_DEVICE 填目标网卡MAC（如 00:1b:21:3c:4d:5e），DEVICE_MODULES 填 generic。generic驱动不接管网卡，而是通过raw socket收发，适合大多数Intel网卡；若追求更低延迟，可改用 igb 或 e1000e 原生驱动，但需确认内核版本匹配。加载模块并启动：

modprobe ec_master
/etc/init.d/ethercat start
ethercat master
ethercat slaves

ethercat master 应显示 Phase: Idle 或 Operation，ethercat slaves 应列出从站位置、名称和状态。若显示 No slaves found，依次检查：网卡是否被NetworkManager占用（需 nmcli dev set eth0 managed no）、MAC是否写对、从站供电与EtherCAT IN/OUT方向是否正确、网线是否为标准RJ45而非交叉线。

四、从站扫描与周期抖动观测

以一台Beckhoff EK1100耦合器加EL1008数字输入、EL2008数字输出为例，上电后执行 ethercat slaves，预期输出类似：

0  0:0  PREOP  +  EK1100 EtherCAT Coupler (2A E-Bus)
1  0:1  PREOP  +  EL1008 8Ch. Dig. Input 24V, 3ms
2  0:2  PREOP  +  EL2008 8Ch. Dig. Output 24V, 0.5A

状态从INIT到PREOP说明从站已被识别，但尚未进入OP。进入OP需要主站配置PDO映射并启动周期任务。教学阶段可先用 ethercat cstruct 导出从站配置，再用 ethercat config 加载，观察状态迁移到OP。此时用 ethercat pdos 可查看每个从站的PDO条目，确认输入输出字节数。

周期抖动观测分两层：内核层用 cyclictest 看调度抖动，应用层在主站周期回调中打时间戳，统计相邻周期差值的最大值。示例目标：1ms周期下，应用层抖动≤50μs，内核层Max≤30μs。若应用层抖动远大于内核层，问题通常在用户态缓冲区拷贝、内存分配或日志输出，应把周期任务中的 printf、malloc 全部移除，改用预分配环形缓冲。

选型没有绝对最优：教学和自研控制器优先IgH+PREEMPT_RT；Windows产线优先TwinCAT；多OS产品化优先Acontis；快速验证协议行为优先SOEM。先锁定实时内核，再选主站栈，顺序反了会反复返工。

五、常见配置陷阱与排查顺序

第一，网卡被NetworkManager或dhclient接管，导致EtherCAT帧被系统协议栈丢弃，表现为从站时有时无。第二，内核未关闭CPU变频和C-State，cyclictest的Max随负载跳变。第三，IgH的generic驱动与原生驱动混用，同一网卡被两个模块争抢。第四，从站拓扑中IN/OUT接反，扫描不到任何从站。第五，主站启动顺序错误：必须先加载ec_master，再启动ethercat服务，最后上电从站。排查时按“内核RT生效→网卡独占→主站Phase→从站PREOP→PDO映射→OP→抖动”逐层推进，每层用对应命令确认，不要跳层猜测。