4、环境搭建与编译：Linux内核准备、实时性配置（PREEMPT_RT）、IgH源码获取、编译选项、安装与加载主站模块

EtherCAT主站系统的搭建，本质上是在通用Linux平台上构建一个具备硬实时能力的工业控制节点。IgH主站（EtherLab IgH）作为应用最广泛的开源EtherCAT主站实现，其编译与运行高度依赖内核特性、实时补丁和用户态工具链。本章将围绕从内核准备到主站模块加载的完整链路展开，帮助读者建立一套可复现、可排障的环境搭建方法论。需要特别强调的是，环境搭建的成败往往不取决于单个命令的正确性，而在于内核配置选项、实时补丁版本与IgH源码版本三者之间的兼容性匹配。

IgH EtherCAT主站环境搭建与编译链路 ① Linux内核准备 内核源码 + 配置工具 ② PREEMPT_RT补丁 内核实时化配置 ③ IgH源码获取 Git仓库 / 版本选择 ④ 编译配置 configure / make ⑤ 安装与加载主站模块 make modules_install / modprobe ec_master 内核关键配置 • CONFIG_PREEMPT_RT=y • CONFIG_HIGH_RES_TIMERS=y • CONFIG_MODULES=y • CONFIG_IP_MULTICAST=y 实时性验证 • /usr/bin/cyclictest • 最大延迟 < 100μs • uname -a 查看PREEMPT_RT • 内核版本与补丁匹配 编译链路与依赖关系 内核源码(linux-x.y.z.tar.xz) + PREEMPT_RT补丁(patch-x.y.z-rtN.patch) → 配置内核(make menuconfig) → 编译安装(make && make modules_install) IgH源码(ethercat-1.5.2.tar.bz2) → ./configure --enable-rtdm → make && make modules → make install && modprobe ec_master 版本不匹配 → 编译失败

上图展示了从内核准备到主站模块加载的完整工程链路。整个流程中，内核版本与PREEMPT_RT补丁的严格对应关系是最容易出错的环节，而IgH主站模块的编译则依赖于内核头文件和实时补丁提供的接口。下面我们将按照实际操作顺序，逐步拆解每个环节的具体做法与判断标准。

4.1 Linux内核准备：版本选择与源码编译

核心原理

IgH主站以内核模块的形式运行，因此必须与当前运行的内核版本完全一致。内核源码的获取方式有两种：一是直接下载官方内核源码包，二是使用发行版提供的带实时补丁的内核源码。对于工业现场应用，推荐使用官方内核源码加上PREEMPT_RT补丁的方式，因为这样能精确控制内核配置，避免发行版内核中不必要的驱动和功能干扰实时性。

操作流程

  1. 确定内核版本：执行 uname -r 查看当前内核版本，例如 5.15.32-rt30。IgH 1.5.2版本官方支持到内核5.10 LTS，建议使用5.10.x系列。
  2. 下载内核源码：从 kernel.org 下载对应版本的源码包，例如 linux-5.10.100.tar.xz。
  3. 解压并准备配置：将源码解压至 /usr/src 目录，并复制当前内核的配置文件作为基础：
tar -xf linux-5.10.100.tar.xz -C /usr/src
cd /usr/src/linux-5.10.100
cp /boot/config-$(uname -r) .config
make menuconfig

关键配置项

配置项推荐值说明
CONFIG_PREEMPT_RTy启用完全实时抢占，这是IgH实时性的基础
CONFIG_HIGH_RES_TIMERSy高精度定时器，EtherCAT周期通信必需
CONFIG_MODULESy支持内核模块加载
CONFIG_IP_MULTICASTyIgH使用多播进行EtherCAT帧收发
CONFIG_NET_SCHEDy网络调度支持，用于实时网络队列
风险提示：如果内核配置中启用了大量无关驱动（如显卡、声卡、WiFi），会显著增加内核编译时间和内存占用，且可能引入不可预测的中断延迟。建议在 make menuconfig 中关闭所有不需要的硬件驱动，仅保留网卡驱动和必要的文件系统支持。

案例拆解：内核编译失败排查

某工程师在编译内核时遇到 undefined reference to 'xxx' 错误。经排查发现，其使用了发行版自带的 .config 文件，该文件启用了大量模块化驱动，而编译环境缺少对应的依赖库。解决方法是使用 make localmodconfig 生成精简配置，仅保留当前系统加载的模块，编译时间从40分钟缩短至12分钟，且未再出现链接错误。

4.2 实时性配置：PREEMPT_RT补丁应用与验证

核心原理

PREEMPT_RT补丁将Linux内核改造为完全可抢占内核，使中断线程化和实时任务调度成为可能。IgH主站依赖该特性确保EtherCAT周期任务在微秒级精度内执行。补丁的版本必须与内核版本严格匹配，例如 patch-5.10.100-rt54.patch 只能应用于 linux-5.10.100 源码。

补丁应用流程

cd /usr/src/linux-5.10.100
xz -d ../patch-5.10.100-rt54.patch.xz
patch -p1 < ../patch-5.10.100-rt54.patch
# 检查补丁是否干净应用
git apply --check ../patch-5.10.100-rt54.patch 2>&1 || echo "补丁应用成功"

实时性验证方法

  • 内核启动日志：dmesg | grep -i preempt 应显示 Preemption: voluntary full 或类似信息。
  • 系统调用验证：uname -a 输出中应包含 PREEMPT_RT 字样。
  • cyclictest测试：运行 cyclictest -t1 -p 99 -i 1000 -l 100000，最大延迟应小于100微秒，典型值在20-50微秒之间。
经验提醒：如果cyclictest最大延迟超过200微秒，首先检查BIOS中是否禁用了CPU电源管理（C-States）和超线程。在工业控制场景中，建议在GRUB启动参数中添加 intel_idle.max_cstate=0 processor.max_cstate=0 来禁用深度睡眠状态。

4.3 IgH源码获取与版本选择

源码获取方式

IgH主站源码托管在GitLab上，官方仓库地址为 https://gitlab.com/etherlab.org/ethercat。推荐使用稳定版本，目前最新稳定版为1.5.2（2019年发布），该版本支持内核5.10及以下版本。对于新内核（5.15+），需要从master分支获取最新代码，但需注意API可能发生变化。

git clone https://gitlab.com/etherlab.org/ethercat.git
cd ethercat
git checkout stable-1.5
# 或者下载tar包
wget https://gitlab.com/etherlab.org/ethercat/-/archive/stable-1.5/ethercat-stable-1.5.tar.bz2

版本兼容性矩阵

IgH版本支持内核范围实时补丁要求备注
1.5.22.6.32 - 5.10PREEMPT_RT最稳定，推荐生产使用
1.6.0（开发版）5.10 - 6.1PREEMPT_RT支持新内核，但API有变化
master分支6.1+PREEMPT_RT仅用于开发测试

4.4 编译选项配置与模块编译

configure脚本关键选项

./configure --prefix=/opt/etherlab \
            --enable-rtdm \
            --enable-generic \
            --enable-e1000e \
            --disable-e1000 \
            --disable-r8169
  • --enable-rtdm：启用RTDM接口，用于用户态实时应用。
  • --enable-generic：启用通用网卡驱动，适用于大多数Intel网卡。
  • --enable-e1000e：启用Intel千兆网卡专用驱动，性能更优。
  • --disable-xxx：禁用不需要的网卡驱动，减少模块体积。

编译与安装

make
sudo make modules_install
sudo make install
sudo depmod -a
编译优化建议：在 make 前设置 export CFLAGS="-O2 -march=native" 可以针对当前CPU优化指令集，提升主站处理效率。但需注意，如果目标部署机器与编译机器CPU不同，应使用 -march=x86-64 保证兼容性。

4.5 安装与加载主站模块

模块加载流程

# 加载主站模块
sudo modprobe ec_master
# 查看加载状态
lsmod | grep ec_
# 查看主站信息
dmesg | tail -20
# 使用ethercat工具查看
sudo /opt/etherlab/sbin/ethercat master

开机自动加载配置

# 创建模块配置文件
echo "ec_master" | sudo tee /etc/modules-load.d/ethercat.conf
# 设置主站参数（可选）
echo "options ec_master main_devices=00:11:22:33:44:55" | sudo tee /etc/modprobe.d/ethercat.conf

常见加载失败排查

错误现象可能原因解决方案
modprobe: ERROR: could not insert 'ec_master': Exec format error内核版本与模块编译版本不一致重新编译IgH，确保与当前内核匹配
Unknown symbol in module内核配置缺少必要选项检查CONFIG_PREEMPT_RT和CONFIG_HIGH_RES_TIMERS
No such device网卡驱动未加载或网卡不支持检查网卡型号，加载对应驱动模块
重要提醒：加载主站模块前，务必确认网卡未被其他网络服务占用。如果使用eth0作为EtherCAT网口，需要先执行 sudo ip link set eth0 down 释放网卡，否则主站模块会加载失败。

4.6 实战案例：从零搭建实时EtherCAT主站

背景与约束：某自动化设备厂商需要在一台基于Intel i5-8500的工控机上搭建EtherCAT主站，控制6个伺服驱动器，要求周期为1ms，抖动小于50μs。操作系统为Ubuntu 20.04 LTS，内核版本5.4.0。

实施步骤：

  1. 下载内核源码 linux-5.4.104.tar.xz 和对应实时补丁 patch-5.4.104-rt54.patch.xz。
  2. 应用补丁并配置内核，启用PREEMPT_RT和HIGH_RES_TIMERS，关闭所有无关驱动。
  3. 编译安装内核，重启后验证 uname -a 显示 PREEMPT_RT。
  4. 运行cyclictest测试，最大延迟为38μs，满足要求。
  5. 克隆IgH stable-1.5分支，执行 ./configure --enable-rtdm --enable-e1000e。
  6. 编译安装后，加载ec_master模块，使用 ethercat master 命令确认主站状态为 ACTIVE。

结果对比：使用非实时内核时，EtherCAT周期抖动达到300μs，导致伺服运行不平滑；切换PREEMPT_RT内核后，抖动降至15μs以内，系统性能显著提升。

风险与代价：整个搭建过程耗时约3小时，其中内核编译占2小时。如果使用预编译的RT内核（如Ubuntu的 linux-lowlatency 或 linux-realtime 包），可以节省编译时间，但需要验证IgH模块的兼容性。

复盘经验：版本匹配是最大的坑。建议在项目开始时，先确定内核版本和IgH版本的组合，并记录在项目文档中。同时，建议将编译好的内核和模块备份，以便快速恢复系统。

← 上一章 📖 返回目录 下一章 →