EtherCAT 开源主站 IGH 在 linux 开发板的移植和伺服通信测试

手边有一套正点原子linux开发板imax6ul，一直在吃灰，周末业余时间无聊，把EtherCAT的开源IGH主站移植到开发板上玩玩儿，搞点事情做。顺便学习研究下EtherCAT总线协议及其对伺服驱动器的运动控制过程。实验很有意思，这里总结下实验过程，分享给有需要的小伙伴。

前言

igh EtherCAT Master是一个用于控制EtherCAT网络的软件模块，它提供了主站功能。主站负责与从站进行通信和同步，控制从站的操作。igh EtherCAT Master具有丰富的功能和灵活的配置选项，可以满足不同应用场景的需求。它提供了一系列的API和工具，使得开发者可以方便地进行EtherCAT网络的开发和调试。

igh EtherCAT Master是用的最多且实时性最好的 EtherCAT 开源主站。很多公司项目软件主站都是用的它，有很多软件专利可以挖掘。一些公司的机器人主控四肢电机驱动器通信和运动板卡，采用的也是IgH 。基于IgH作产品开发，基本能满足大部分使用场景。

关于EtherCAT主站协议栈，目前有两大主流开源代码为SOEM（即支持Linux，又支持windows ）和IgH EtherCAT Master只支持Linux ）。

本文以IgH最新稳定版本1.6来移植，简单记录下IgH EtherCAT Master在嵌入式系统中的移植过程及主从站伺服驱动器通信测试。（ [Linux 内核版本：Linux-4.1.15] ）。

IgH官方介绍：

EtherCAT-Master | EtherLab

整个交叉编译过程很顺利，没遇到一点儿报错。本次移植仅是测试，简单起见使用通用的网卡驱动，性能上肯定不是最好。要想高性能一方面需要给内核打实时性补丁，一方面还需对特定的网卡驱动进行优化适配。源码里自带了一些网卡驱动，如8139和e1000网卡驱动，Igb（Intel Gigabit ）以太网驱动程序。

8139和e1000是两种常见的网卡芯片，分别由Realtek和Intel生产。Realtek 8139（也称为RTL8139）是Realtek生产的一款常用的乙太网网卡芯片，广泛应用于早期的计算机和嵌入式系统中。Intel e1000系列是Intel生产的一组高性能千兆位乙太网控制器芯片，包括e1000、e1000e和82574等型号，适用于桌面计算机、服务器和嵌入式系统。这两种网卡芯片均具有集成的MAC（Media Access Control）功能，用于管理数据链路层的访问和控制，以及PHY（Physical Layer）功能，用于处理物理层的信号传输和解调。它们同时具备MAC和PHY功能。

移植准备

IGH最新稳定版1.6源码下载地址：

https://gitlab.com/etherlab.org/ethercat/-/archive/stable-1.6/ethercat-stable-1.6.tar.gz

准备Linux-4.1.15内核源码，（编译驱动模块需要) 我的路径：

/root/test/imax6ul/linux

开发板提供的gcc交叉编译工具链：

/opt/fsl-imx-x11/4.1.15-2.1.0/environment-setup-cortexa7hf-neon-poky-linux-gnueabi

如果还想要给内核打上实时性补丁包，可以在这找到：Index of /pub/linux/kernel/projects/rt/4.14/

#为内核源码打上实时补丁cd linuxpatch -p 1 -i ../patch-4.10.199-rt97.patch

至此，准备工作完成。 

源码编译过程

先加载编译环境变量，直接执行以下指令即可。

source /opt/fsl-imx-x11/4.1.15-2.1.0/environment-setup-cortexa7hf-neon-poky-linux-gnueabi

执行完成后， arm-poky-linux-gnueabi-gcc已经加入到环境变量中了。可以在命令行输出echo $CC试试看，输出了arm-poky-linux-gnueabi-gcc，说明环境已经生效了。

 编译主站程序和协议栈

# EtherCAT 源码存放目录为：/root/test/ethercat/ethercat-stable-1.6# Linux-4.1.15 源码存放目录为：/root/test/imax6ul/linux/ linux-4.1.15tar -zxvf ethercat-stable-1.6.tar.gz# 解压源码 /root/test/ethercat/ethercat-stable-1.6cd ethercat-stable-1.6# --prefix是指定你下面make install时的安装目录，--with-linux-dir是指定你的linux内核目录./configure --prefix=/root/test/ethercat/output --with-linux-dir=/root/test/imax6ul/linux --enable-8139too=no --enable-generic=yes --host=arm-poky-linux-gnueabimake# 编译主站和协议栈源码make install #安装到指定目录

经过上面的交叉编译，只是编译出了主站协议栈库和自带主站工具及程序，但是这还不算完。

ethercat：可执行程序是用于配置和管理 EtherCAT 主站（IGH 主站）的命令行工具。

ethercatctl：是一个用于控制 EtherCAT Master 运行状态的命令行工具。它提供了启动、停止、重启 EtherCAT Master 等操作的命令，用于管理 EtherCAT Master 的运行。

经过上面的编译，编译出来的内容如下图所示：

库和头文件： 

linux内核驱动模块还没出来，所以直接是运行不起来的，还需要编译出内核网络驱动模块。

编译内核驱动模块

#编译网卡驱动模块# 指定交叉编译工具，编译modulesmake ARCH=arm CROSS_COMPILE=arm-poky-linux-gnueabi- modules # 编译通过会对应生成ethercat-stable-1.6/devices/ec_generic.ko和ethercat-stable-1.6/master/ec_master.kosudo make install# 在该目录下生成output目录

成功编译出了ec_master.ko 和 ec_generic.ko的linux驱动模块。 

ec_master.ko：用于支持 EtherCAT 主站运行的 Linux 内核模块。它实现了 EtherCAT 主站协议栈，允许在 Linux 系统上与 EtherCAT 从站设备进行实时通信和数据交换。主要负责存储一些ethercat从站信息，管理domains域，管理从站配置等有关于ethercat系统的资源,在/etc/sysconfig/ethercat中配置的MASTER0_DEVICE会作为该模块参数传入主站模块，最终成为主站模块的mac使用网络地址，即master->macs；

ec_generic.ko，经由系统网络栈利用标准以太网 (Ethernet) 的网络驱动程序。

ec_generic，这个通用的驱动文件是在TCP/IP协议栈接口之上进行调用的，所以会走TCP/IP协议栈，会影响实时性。正式用应优化网卡驱动，在网卡驱动上直接支持IgH接口。

放到板子上运行

复制ec_generic.ko和ec_master.ko到/lib/modules/内核版本号，复制ethercat到usr/local/bin目录下。安装通用网卡驱动，配置rules,创建设备号。

操作步骤

# 在/root/test/ethercat目录下创建modules文件夹，并复制ec_generic.ko和ec_master.ko到modules下mkdir -p output/modulescp devices/ec_generic.ko output/modules/cp master/ec_master.ko output/modules/# 将output文件夹打包，传输到开发板（nfs/tftp/scp）tar -cjf output.tar.bz2 output/-------------------------------------------------------------------------------------------------------------------------------------# 开发板上执行tar -jxvf output.tar.bz2cp output/modules/ec_generic.ko /lib/modules/4.1.15# 复制ec_master.ko到/lib/modules/内核版本号/ cp output/modules/ec_master.ko /lib/modules/4.1.15 # 内核版本可以通过uname -r 查看depmodln -fs output/etc/init.d/ethercat /etc/init.d/ # 创建链接，相比于复制节省内存空间ln -fs output/bin/ethercat /usr/local/bin/mkdir /etc/sysconfigln -fs output/etc/sysconfig/ethercat /etc/sysconfig/# 配置rules,创建设备号echo KERNEL==\"EtherCAT[0-9]*\", MODE=\"0664\" > /etc/udev/rules.d/99-EtherCAT.rules# 获取板子MAC地址ifconfig# eth2  Link encap:以太网  硬件地址 00:0c:29:01:69:aa-------------------------------------------------------------------------------------------------------------------------------------# 启动EtherCAT# 配置主站的MAC地址modprobe ec_master main_devices=1E:ED:19:27:1A:B3 # 启动ethercat/etc/init.d/ethercat start# 安装通用网卡驱动insmod  output/modules/ec_generic.ko# 通过ethercat查看信息Ethercat --help

运行测试

通过网线直连ethercat主从站，从站启动完成后，启动ethercat。

/etc/init.d/ethercat start

下面就可以使用 ethercat 工具来进行一些操作了。

sudo ethercat cstruct

ethercat 命令行

EtherCAT 命令行在 《EtherCAT IGH 1.52.pdf》中的 <7.1 Command-line Tool> 也有很详细的一个介绍。在编译和安装IGH的时候，如果不修改默认的编译参数，那么就是会提供 EtherCAT 命令行工具的。每个主站的实例都有生成一个字符设备，名字为：/dev/EtherCATx, 其中 x ∈ {0 . . . n}为主站实例的索引。

常用命令介绍

ethercat master

该命令行用来显示主站和以太网设备信息。

列出主站状态：

ethercat slaves

列出连接的从站：

ethercat cstruct

ethercat sdos

该命令行用来输出当前驱动器支持的所有的SDO信息。

举例：

@:~$ ethercat upload 0x2001 0x00000x03e8 1000

解析：读取从站0中索引号为 0x2001（16位），子索引号为00（8位）的SDO条目。返回的参数值为 1000。

注意：必须有从站连接才能使用此命令，不运行应用程序也可以使用。

 ethercat download

该命令行用以向指定的从站 SDO 中的子索引中写入相应的参数值。

例子:

向从站0的索引号为0x6060（16位），子索引号为00（8位）的地址写入参数值"0x08"。

@:~$ sudo ethercat download -t int16 -p 0 0x6060 00 08

有的SDO 可能是由于厂家的限制，不能写入参数。

@:~$ sudo ethercat download -t uint16 0x2008 0x0000 0x000fSDO transfer aborted with code 0x08000021: Data cannot be transferred or stored to the application because of local control

注意：必须有从站连接才能使用此命令，不运行应用程序也可以使用。 

@:~$ ethercat sdosSDO 0x1000, "Device type"  0x1000:00, r-r-r-, uint32, 32 bit, "Device type"SDO 0x1001, "Error register"  0x1001:00, r-r-r-, uint8, 8 bit, "Error register"SDO 0x1008, "Device name"  0x1008:00, r-r-r-, string, 72 bit, "Device name"SDO 0x1009, "Hardware version"  0x1009:00, r-r-r-, string, 24 bit, "Hardware version"SDO 0x100a, "Software version"  0x100a:00, r-r-r-, string, 32 bit, "Software version"SDO 0x1010, "store parameters"  0x1010:00, r-r-r-, uint8, 8 bit, "SubIndex 000"  0x1010:01, rwrwrw, uint32, 32 bit, "save all parameters"  0x1010:02, rwrwrw, uint32, 32 bit, "save communication parameters"  0x1010:03, rwrwrw, uint32, 32 bit, "save application parameters"  0x1010:04, rwrwrw, uint32, 32 bit, "save manufacturer defined parameters"..............SDO 0x6007, "Abort_connection_option_code"  0x6007:00, rwrwrw, int16, 16 bit, "Abort_connection_option_code"SDO 0x603f, "errorcode"  0x603f:00, r-r-r-, uint16, 16 bit, "errorcode"SDO 0x6040, "controlword"  0x6040:00, rwrwrw, uint16, 16 bit, "controlword"SDO 0x6041, "statusword"  0x6041:00, r-r-r-, uint16, 16 bit, "statusword"..............

ethercat pdos

该命令行用来显示出同步管理器的参数和PDO分配和映射信息。

ethercat upload

该命令行用以读取指定从站相应PDO设定的参数值。

其他一些命令，参考：EtherCAT IGH 命令行介绍_igh ethercat-CSDN博客

@:~$ ethercat --help  alias      Write alias addresses.  config     Show slave configurations.  crc        CRC error register diagnosis.  cstruct    Generate slave PDO information in C language.  data       Output binary domain process data.  debug      Set the master's debug level.  domains    Show configured domains.  download   Write an SDO entry to a slave.  eoe        Display Ethernet over EtherCAT statictics.  foe_read   Read a file from a slave via FoE.  foe_write  Store a file on a slave via FoE.  graph      Output the bus topology as a graph.  ip         Set EoE IP parameters.  master     Show master and Ethernet device information.  pdos       List Sync managers, PDO assignment and mapping.  reg_read   Output a slave's register contents.  reg_write  Write data to a slave's registers.  rescan     Rescan the bus.  sdos       List SDO dictionaries.  sii_read   Output a slave's SII contents.  sii_write  Write SII contents to a slave.  slaves     Display slaves on the bus.  soe_read   Read an SoE IDN from a slave.  soe_write  Write an SoE IDN to a slave.  states     Request application-layer states.  upload     Read an SDO entry from a slave.  version    Show version information.  xml        Generate slave information XML.Global options:  --master  -m <master>  Comma separated list of masters                         to select, ranges are allowed.                         Examples: '1,3', '5-7,9', '-3'.                         Default: '-' (all).  --force   -f           Force a command.  --quiet   -q           Output less information.  --verbose -v           Output more information.  --help    -h           Show this help.Numerical values can be specified either with decimal (noprefix), octal (prefix '0') or hexadecimal (prefix '0x') base.Call 'ethercat <COMMAND> --help' for command-specific help.

测试效果

网上有一组测试效果，连接五个从站，主站单次收发数据的平均耗时以及实时性。测试主站单次收发数据的平均耗时的程序每隔 100 μs 发送并接收一次过程数据，如此每循环 10000 次记录一下当前时间，相邻两次记录的时间间隔减去其间空闲时间 100 μs × 10000 = 1 s 再除以收发次数 10000 便得到单次收发数据的平均耗时，使用三种不同的网卡驱动，三种情形下的大致结果如下表：

主站测试代码

#include <errno.h>#include <signal.h>#include <stdio.h>#include <string.h>#include <sys/resource.h>#include <sys/time.h>#include <sys/types.h>#include <unistd.h>/****************************************************************************/#include "ecrt.h"/****************************************************************************/// Application parameters#define FREQUENCY 100#define PRIORITY 1// Optional features#define CONFIGURE_PDOS  1/****************************************************************************/// EtherCATstatic ec_master_t *master = NULL;static ec_master_state_t master_state = {};static ec_domain_t *domain1 = NULL;static ec_domain_state_t domain1_state = {};static ec_domain_t *domain2 = NULL;static ec_domain_state_t domain2_state = {};static ec_slave_config_t *sc;static ec_slave_config_state_t sc_ana_in_state = {};// Timerstatic unsigned int sig_alarms = 0;static unsigned int user_alarms = 0;/****************************************************************************/// process datastatic uint8_t *domain1_pd = NULL;static uint8_t *domain2_pd = NULL;#define BusCouplerPos  0, 0#define TI_AM3359ICE    0xE000059D, 0x54490001// offsets for PDO entriesstatic unsigned int off_dig_out2;static unsigned int off_dig_in2;static unsigned int counter = 0;static unsigned int blink = 0x00;/*****************************************************************************/#if CONFIGURE_PDOSec_pdo_entry_info_t slave_0_pdo_entries[] = {{0x7010, 0x00, 32},{0x6000, 0x00, 4*8},};ec_pdo_info_t slave_0_pdos[] = {{0x1601, 1, slave_0_pdo_entries + 0},{0x1a00, 1, slave_0_pdo_entries + 1},};static ec_sync_info_t slave_0_pdo_syncs[] = {{2, EC_DIR_OUTPUT, 1, slave_0_pdos + 0},    {3, EC_DIR_INPUT,  1, slave_0_pdos + 1},    {0xff}};#endif/*****************************************************************************/void check_domain1_state(void){    ec_domain_state_t ds;    ecrt_domain_state(domain1, &ds);    if (ds.working_counter != domain1_state.working_counter)        printf("Domain1: WC %u.\n", ds.working_counter);    if (ds.wc_state != domain1_state.wc_state)        printf("Domain1: State %u.\n", ds.wc_state);    domain1_state = ds;}/*****************************************************************************/void check_domain2_state(void){    ec_domain_state_t ds;    ecrt_domain_state(domain2, &ds);    if (ds.working_counter != domain2_state.working_counter)        printf("Domain2: WC %u.\n", ds.working_counter);    if (ds.wc_state != domain2_state.wc_state)        printf("Domain2: State %u.\n", ds.wc_state);    domain2_state = ds;}/*****************************************************************************/void check_master_state(void){    ec_master_state_t ms;    ecrt_master_state(master, &ms);    if (ms.slaves_responding != master_state.slaves_responding)        printf("%u slave(s).\n", ms.slaves_responding);    if (ms.al_states != master_state.al_states)        printf("AL states: 0x%02X.\n", ms.al_states);    if (ms.link_up != master_state.link_up)        printf("Link is %s.\n", ms.link_up ? "up" : "down");    master_state = ms;}/*****************************************************************************/void check_slave_config_states(void){    ec_slave_config_state_t s;    ecrt_slave_config_state(sc, &s);    if (s.al_state != sc_ana_in_state.al_state)        printf("AnaIn: State 0x%02X.\n", s.al_state);    if (s.online != sc_ana_in_state.online)        printf("AnaIn: %s.\n", s.online ? "online" : "offline");    if (s.operational != sc_ana_in_state.operational)        printf("AnaIn: %soperational.\n",                s.operational ? "" : "Not ");    sc_ana_in_state = s;}/*****************************************************************************/void cyclic_task(){    // receive process data    ecrt_master_receive(master);    ecrt_domain_process(domain1);ecrt_domain_process(domain2);    // check process data state (optional)    check_domain1_state();check_domain2_state();//    if (counter) {//        counter--;//    } else { // do this at 1 Hz        counter = FREQUENCY;        // calculate new process datablink ++;        // check for master state (optional)        check_master_state();        // check for islave configuration state(s) (optional)        check_slave_config_states();//printf("AnaIn: value=0x%x\n", EC_READ_U32(domain2_pd + off_dig_in2));printf("AnaIn: value=0x%x\n", EC_READ_U32(domain2_pd + off_dig_in2));//printf("AnaIn: value=0x%x\n", EC_READ_U32(domain2_pd + off_dig_in2 + 4));EC_WRITE_U32(domain1_pd + off_dig_out2, blink);//printf("AnaIn: value=0x%x\n", EC_READ_U32(domain1_pd + off_dig_out2));//    }    // send process dataecrt_domain_queue(domain1);ecrt_domain_queue(domain2);    ecrt_master_send(master);}/****************************************************************************/void signal_handler(int signum) {    switch (signum) {        case SIGALRM:            sig_alarms++;            break;    }}/****************************************************************************/int main(int argc, char **argv){    struct sigaction sa;    struct itimerval tv;    master = ecrt_request_master(0);    if (!master)        return -1;    domain1 = ecrt_master_create_domain(master);    if (!domain1)        return -1;domain2 = ecrt_master_create_domain(master);    if (!domain2)        return -1;#if CONFIGURE_PDOSif (!(sc = ecrt_master_slave_config(master, BusCouplerPos, TI_AM3359ICE))) {fprintf(stderr, "Failed to get slave configuration.\n");return -1;}    if (ecrt_slave_config_pdos(sc, EC_END, slave_0_pdo_syncs)) {        fprintf(stderr, "Failed to configure PDOs.\n");        return -1;    }printf("Configuring PDOs...\n");    // Create configuration for bus coupleroff_dig_out2 = ecrt_slave_config_reg_pdo_entry(sc,0x7010, 0, domain1, NULL);if (off_dig_out2 < 0)return -1;off_dig_in2 = ecrt_slave_config_reg_pdo_entry(sc,0x6000, 0, domain2, NULL);if (off_dig_in2 < 0)return -1; #endif    printf("Activating master...\n");    if (ecrt_master_activate(master))        return -1;    if (!(domain1_pd = ecrt_domain_data(domain1))) {        return -1;    }if (!(domain2_pd = ecrt_domain_data(domain2))) {        return -1;    }sa.sa_handler = signal_handler;    sigemptyset(&sa.sa_mask);    sa.sa_flags = 0;    if (sigaction(SIGALRM, &sa, 0)) {        fprintf(stderr, "Failed to install signal handler!\n");        return -1;    }    printf("Starting timer...\n");    tv.it_interval.tv_sec = 0;    tv.it_interval.tv_usec = 1000000 / FREQUENCY;    tv.it_value.tv_sec = 0;    tv.it_value.tv_usec = 2000;    if (setitimer(ITIMER_REAL, &tv, NULL)) {        fprintf(stderr, "Failed to start timer: %s\n", strerror(errno));        return 1;    }    printf("Started.\n");    while (1) {        pause();        while (sig_alarms != user_alarms) {            cyclic_task();            user_alarms++;        }    }    return 0;}/****************************************************************************//***********IGH demo编译*****************/arm-linux-gnueabi-gcc main.c -o ethercat_test -I../../ethercat/include/ -L../..ethercat/lib -lethercat

IGH在Linux应用空间的其他使用

参考EtherCAT源码下的example。

git clone https://gitee.com/wllw7176/MyEthercat-IGH-1.5.2.git

 参考EtherCAT二次开发的源代码

其他资源

EtherCAT使用与解析-ethercat系统内核模块加载与初始化操作_ec_generic.ko-CSDN博客

https://www.cnblogs.com/wujingcqu/p/16295570.html

https://blog.51cto.com/u_15858333/6406909

IgH详解 一、概述-CSDN博客

EtherCAT设备协议详解二、EtherCAT状态机及配置流程-CSDN博客

在x86-64和arm64 Linux上调试IgH EtherCAT主站软件以及实现星形走线连接多从站 - 知乎

ethercatpack/mytest/test_ethercat.c · wllw7176_gitee/MyEthercat-IGH 1.5.2 - Gitee.com

https://pwl999.blog.csdn.net/article/details/109397917

IgH EtherCAT主站开发案例分享——基于NXP i.MX 8M Mini - 知乎

开源工业以太网现场总线协议栈汇总_soes从站模拟器-CSDN博客

raspberry pi RT-Linux平台搭建IgH环境_一种用于igh的网络驱动系统及方法与流程-CSDN博客

EtherCAT主站IgH解析(一)--主站初始化、状态机与EtherCAT报文_igh ethercat-CSDN博客

EtherCAT IGH 命令行介绍_igh ethercat-CSDN博客

LinuxCNC搭配Igh EtherCat Master开源Ethercat主站通讯控制测试_linuxcnc igh-CSDN博客

【虹科干货】使用Profishark进行EtherCAT主站性能测试 – 宏网络安全信息门户网站2

基于Zynq平台的igh EtherCAT主站的配置和使用方法，包括Preempt RT和Xenomai两种实时内核的介绍和配置示例_ethercat1.5.2中文-CSDN博客

https://www.cnblogs.com/tdyizhen1314/p/17628400.html

本文链接：https://www.kjpai.cn/news/2024-04-19/160427.html，文章来源：网络cs，作者：晨起，版权归作者所有，如需转载请注明来源和作者，否则将追究法律责任！