3. 开发环境搭建

在动手编写 EtherCAT 主站代码之前，必须先搭建一套能够支撑实时通信的开发环境。EtherCAT 主站与普通网络应用最大的区别在于：它要求操作系统在确定的微秒级时间内完成帧的发送与接收处理。如果环境选型不当，后续无论代码写得多么精巧，都可能出现周期性抖动、丢帧甚至从站失控等问题。本节将围绕硬件选型、软件工具链、操作系统实时性配置三个层面，给出可落地的搭建方案。

3.1 硬件平台选型：主站控制器的核心要求

EtherCAT 主站硬件需要具备两个基本能力：一是提供标准以太网 MAC/PHY 接口，二是能够产生高精度时间戳并支持 DMA 批量传输。常见的硬件平台有三类：

• 工业 PC + 板载/独立 Intel 网卡：最灵活，适合学习与原型验证。推荐使用 Intel I210/I211/I350 系列网卡，它们对 EtherCAT 帧的接收时间戳支持较好，且驱动生态成熟。
• 嵌入式 ARM 平台：如 TI AM335x、NXP i.MX6/8 系列，需确认其内部以太网 MAC 是否支持 IEEE 1588 时间戳功能。适合产品化但调试难度较高。
• FPGA + 软核/硬核：用于对抖动要求极高的场景（如 < 1 µs 抖动），但开发周期长，不适合作为入门首选。

对于本课程后续的代码实验，建议采用 x86_64 架构的工业 PC 或普通台式机 + Intel I210 网卡。内存不低于 4 GB，硬盘使用 SSD 以减少日志写入对实时性的干扰。需要特别注意的是：不要使用 USB 转以太网适配器，其中断延迟和驱动路径无法保证实时性。

3.2 操作系统与实时性补丁：选择与配置

EtherCAT 主站对操作系统的要求集中在两点：任务调度延迟可控和中断响应时间可预测。普通 Linux 内核（如 Ubuntu 默认内核）的调度延迟可能达到几十毫秒，无法满足 1 ms 周期通信。因此需要引入实时性增强方案。

目前主流的方案有三种，按推荐优先级排列：

对于本课程实验，推荐使用 PREEMPT_RT 补丁内核。以 Ubuntu 22.04 为例，安装实时内核只需执行：

sudo apt-get install linux-lowlatency   # 或 linux-realtime（若仓库可用）
# 验证当前内核是否支持实时调度
uname -r
# 若输出包含 -rt 或 -lowlatency，则说明已启用实时特性

安装完成后，还需要调整系统启动参数，在 /etc/default/grub 的 GRUB_CMDLINE_LINUX 中添加：

GRUB_CMDLINE_LINUX="isolcpus=2,3 nohz_full=2,3 rcu_nocbs=2,3"
# 将 CPU 2/3 从普通调度中隔离，专用于实时任务
sudo update-grub && sudo reboot

隔离 CPU 后，主站周期任务可以绑定到 CPU 2 或 3 上运行，避免被其他进程抢占。同时建议关闭 CPU 频率调节和节能模式：

sudo cpupower frequency-set -g performance

3.3 软件工具链：从编译器到调试工具

EtherCAT 主站开发通常基于 C 语言，因此工具链以 GCC 为核心。但仅有编译器还不够，还需要一套完整的辅助工具来生成代码、分析总线状态和调试时序。

推荐的软件清单如下：

• 编译工具链：gcc、make、cmake（版本不低于 3.16）。
• 版本管理：git，用于管理主站源码和从站描述文件（ESI）。
• EtherCAT 主站协议栈：本课程使用 SOEM（Simple Open EtherCAT Master），它轻量、跨平台，且支持 Linux 实时模式。也可选用 IgH EtherCAT Master，但 SOEM 更便于阅读源码。
• 从站配置工具：EtherCAT Slave Explorer（Windows 下使用）或 ethercat 命令行工具（IgH 提供），用于扫描从站拓扑和读写 SDO 对象。
• 抓包分析工具：tcpdump 或 Wireshark，需要开启网卡的混杂模式并安装 EtherCAT 解析插件。
• 实时性测试工具：cyclictest（来自 rt-tests 包），用于验证系统实时性能是否达标。

安装这些工具的命令如下：

sudo apt-get install build-essential git cmake
sudo apt-get install libtool autoconf pkg-config
sudo apt-get install rt-tests   # 提供 cyclictest
sudo apt-get install tcpdump wireshark

SOEM 源码可以从 GitHub 克隆：

git clone https://github.com/OpenEtherCATsociety/SOEM.git
cd SOEM
mkdir build && cd build
cmake ..
make -j$(nproc)
sudo make install

编译安装完成后，SOEM 会提供 simple_test 等示例程序，可用于验证主站能否扫描到从站。

3.4 实时性验证：用数据确认环境达标

环境搭建是否成功，不能凭感觉判断，必须用工具量化验证。推荐使用 cyclictest 测量系统调度延迟。在隔离的 CPU 2 上运行：

sudo cyclictest -t1 -p 99 -i 1000 -l 100000 -q -C 2

该命令创建一个优先级为 99 的实时线程，每 1 ms 唤醒一次，共测试 100000 次。输出结果中重点关注 Max 值：

T: 0 ( 1234) P:99 I:1000 C: 100000 Min:      3 Act:    5 Avg:    4 Max:     47

如果 Max 值小于 100 µs，说明系统实时性基本满足 EtherCAT 1 ms 周期通信要求。若 Max 超过 500 µs，则需要检查是否有内核线程干扰、中断负载过高或 BIOS 中未关闭 C-State 节能。

3.5 案例：从零搭建一套可用的实验环境

下面以一个具体案例串联整个搭建流程。假设硬件为：Intel I210 网卡的工控机 + 一台带有 2 个数字量输入模块的从站（如 EK1100 耦合器 + EL1008 端子）。

步骤一：安装实时内核并验证

sudo apt-get install linux-realtime
sudo reboot
uname -r   # 输出如 5.15.0-91-rt64

步骤二：配置 GRUB 隔离 CPU

编辑 /etc/default/grub，设置 isolcpus=2,3，更新并重启。重启后执行 taskset -c 2 cyclictest 验证 CPU 2 上无其他普通任务。

步骤三：编译 SOEM 并运行扫描测试

cd SOEM/build
./simple_test   # 需要 root 权限
# 若输出 "Slave 1: EL1008" 等字样，说明主站已成功识别从站

步骤四：抓包确认帧交换

sudo tcpdump -i enp3s0 -c 100 -w ethercat.pcap
# 用 Wireshark 打开 pcap 文件，过滤 ecat 协议，观察周期性过程数据帧

通过以上四个步骤，即可确认从硬件到软件的全链路已经打通。后续章节的代码实验都将基于这套环境运行。

3.6 误区与复盘：环境搭建中的典型问题

根据过往项目经验，环境搭建阶段最容易出现以下三类问题：

• 误区一：使用板载 Realtek 网卡。Realtek 网卡虽然也能收发 EtherCAT 帧，但其驱动在中断合并和 DMA 描述符管理上不如 Intel 网卡高效，导致周期抖动偏大。复盘结论：主站网卡应优先选择 Intel I210/I350，若条件受限，至少要在驱动层关闭中断合并（ethtool -C eth0 rx-usecs 0）。
• 误区二：忽略内存锁页。实时任务若触发页面缺页异常，会产生不可预测的延迟。应在主站代码中调用 mlockall(MCL_CURRENT | MCL_FUTURE) 锁定内存。复盘结论：环境搭建时就要预留内存锁页的测试用例。
• 误区三：将主站任务与 GUI 放在同一 CPU。图形界面会产生大量调度中断，严重干扰实时循环。复盘结论：务必使用 isolcpus 隔离专用 CPU，并通过 sched_setaffinity 将主站线程绑定到隔离核。

环境搭建是 EtherCAT 主站开发中最容易被低估的一环。一个经过验证的实时环境，能让后续的协议栈调试、DC 同步分析和运动控制实验事半功倍。建议读者在完成本节操作后，保存一份 cyclictest 的测试报告作为基线数据，后续若发现通信异常，可先对比基线判断是否为环境劣化所致。