从零开发 EtherCAT 主站五SOEM 框架源码解析一个例程带你读懂整个主站文章目录从零开发 EtherCAT 主站五SOEM 框架源码解析一个例程带你读懂整个主站一、SOEM 是什么二、为什么选择 SOEM三、先看一个最简单的例程四、ec_init()初始化底层网络接口五、ec_config_init()扫描并识别从站六、ec_config_map()构建过程数据映射七、状态机切换检查 SAFE-OP → 请求 OP八、周期发送和接收 PDO九、把整个流程串起来十、SOEM 源码到底应该怎么看十一、一个真正的 EtherCAT 主站并没有想象中复杂十二、下一篇预告系列文章导航前面四篇我们完成了 EtherCAT 基础知识的学习EtherCAT 基本原理 → 数据帧与 WKC → 从站状态机 → PDO / Mailbox / CoE / FoE从这一篇开始正式进入SOEM 入门篇。不再单纯讲协议而是直接结合代码看看一个真正的 EtherCAT Master 是怎么工作的。本文不会一上来就分析 SOEM 的所有源码而是先通过一个最简单的示例把整个主站运行流程串起来。一、SOEM 是什么SOEM 全称Simple Open EtherCAT Master是一个开源的 EtherCAT Master 协议栈。相比商业主站它的代码量小、结构清晰非常适合学习 EtherCAT 主站的实现原理。SOEM 本身不是完整的应用软件而是底层通信核心。我们后续的开发会以 SOEM 为基础在它之上构建 Qt 上位机、从站管理、SDO 工具、FoE 升级等功能Qt 上位机 │ ┌─────────┼─────────┐ │ │ │ 从站管理 SDO工具 FoE升级 │ │ │ └─────────┼─────────┘ │ SOEM │ EtherCAT二、为什么选择 SOEM源码简单比大型工业级主站容易阅读适合学习跨平台支持 Windows、Linux、嵌入式平台功能较完整Slave Scan、PDO、SDO、Mailbox、CoE、FoE、DC、状态机、过程数据均有支持三、先看一个最简单的例程学习 SOEM建议先看 Demo再反过来看源码。否则容易陷入一堆结构体和函数中完全找不到头绪。一个最精简的 SOEM 主站程序可以简化为#includeethercat.hintmain(intargc,char*argv[]){if(!ec_init(argv[1]))return-1;if(ec_config_init(FALSE)0)return-1;ec_config_map(IOmap);ec_statecheck(0,EC_STATE_SAFE_OP,EC_TIMEOUTSTATE);ec_slave[0].stateEC_STATE_OPERATIONAL;ec_writestate(0);while(1){ec_send_processdata();ec_receive_processdata(EC_TIMEOUTRET);}return0;}实际 SOEM Demo 会更复杂但这段代码已经包含了一个 EtherCAT Master 最核心的流程。下面我们逐一拆解每个 API 的作用。四、ec_init()初始化底层网络接口ec_init(eth0);// Linux 下指定网卡名作用初始化 EtherCAT 主站的底层网络接口即打开网卡、准备好发送 EtherCAT 帧的能力。注意ec_init()并不会扫描从站它只是让主站具备通信能力。五、ec_config_init()扫描并识别从站ec_config_init(FALSE);这一步负责扫描 EtherCAT 网络上的所有从站读取它们的 Vendor ID、Product Code、Revision、Serial Number 等基本信息并保存到ec_slave[]数组中。SOEM 使用ec_slave[]保存所有从站信息其中ec_slave[0]比较特殊代表主站自身的逻辑信息真正的从站从ec_slave[1]开始for(i1;iec_slavecount;i){// 遍历所有从站}六、ec_config_map()构建过程数据映射ec_config_map(IOmap);这个函数非常重要根据从站的 PDO 配置将各个从站的过程数据映射到主站的IOmap中。IOmap是一块连续的内存区域主站周期通信时直接操作这块内存即可IOmap ┌─────────────────────────────────────┐ │ Slave 1 PDO │ Slave 2 PDO │ Slave 3 │ └─────────────────────────────────────┘七、状态机切换检查 SAFE-OP → 请求 OPec_statecheck(0,EC_STATE_SAFE_OP,EC_TIMEOUTSTATE);等待所有从站进入SAFE-OP状态输入可用输出处于安全状态。然后主站请求进入OPec_slave[0].stateEC_STATE_OPERATIONAL;ec_writestate(0);ec_statecheck(0,EC_STATE_OPERATIONAL,EC_TIMEOUTSTATE);八、周期发送和接收 PDO进入 OP 之后真正的实时通信开始ec_send_processdata();// 发送输出 PDOec_receive_processdata(EC_TIMEOUTRET);// 接收输入 PDO通常放在周期任务中如 1ms 周期不断循环。这是 EtherCAT 最核心的实时数据交换过程。九、把整个流程串起来现在回头再看那段精简代码流程变得非常清晰ec_init() → 初始化网卡 ↓ ec_config_init() → 扫描从站填充 ec_slave[] ↓ ec_config_map() → 构建 IOmap 映射 ↓ ec_statecheck(SAFE_OP) → 等待从站进入 SAFE-OP ↓ ec_writestate(OP) → 请求从站进入 OP ↓ while (1) { ec_send_processdata() ec_receive_processdata() } → 周期 PDO 通信十、SOEM 源码到底应该怎么看不建议从头到尾按文件顺序阅读。更高效的方法是先看 Demo找到核心 API进入 API 源码追踪其实现继续向下追踪底层函数理解关键数据结构最后回头看整体架构例如看到ec_config_init()就深入它的内部实现看它如何发送 Datagram、读取 EEPROM、识别从站。SOEM 的核心模块大致如下不同版本略有差异SOEM ├── ethercatmain → 主站核心 API ├── ethercatbase → 基础 EtherCAT 操作 ├── ethercatconfig → 从站配置 ├── ethercatcoe → CoE / SDO ├── ethercatfoe → FoE ├── ethercatdc → 分布式时钟 ├── ethercatprint → 调试输出 └── ethercat.h → 对外 API十一、一个真正的 EtherCAT 主站并没有想象中复杂EtherCAT 主站的核心流程可以浓缩为① 初始化网卡 ② 扫描从站 ③ 配置从站PDO、FMMU、SyncManager ④ 进入 SAFE-OP ⑤ 进入 OP ⑥ 周期交换 PDO ⑦ 监控 WKC 和从站状态真正复杂的地方并不是这几个 API 本身而是它们背后到底做了什么——例如ec_config_init()到底发送了哪些 DatagramEEPROM 是怎么访问的PDO Mapping 如何配置FMMU 和 SyncManager 如何参与这些正是后续文章要深入分析的内容。十二、下一篇预告本篇通过一个 SOEM Demo 把 EtherCAT Master 的整体流程串了起来。下一篇将正式深入源码《从零开发 EtherCAT 主站六SOEM 初始化流程详解主站是如何发现所有从站的》重点分析ec_init()→ec_config_init()→ Slave Scan → EtherCAT Frame → EEPROM → Vendor ID / Product Code / Revision →ec_slave[]看看 SOEM 到底是怎么把“插在网线上的几个设备”一步一步识别成 EtherCAT 从站的。系列文章导航章节标题状态第一篇EtherCAT 为什么能成为工业实时通信的主流✔第二篇EtherCAT 通信原理详解✔第三篇EtherCAT 状态机ESM完整解析✔第四篇PDO、Mailbox、CoE、FoE 到底是什么✔第五篇SOEM 框架源码解析本文✔第六篇SOEM 初始化流程详解待更新参考链接 从零开发 EtherCAT 主站（五）：SOEM 框架源码解析，一个例程带你读懂整个主站
从零开发 EtherCAT 主站五SOEM 框架源码解析一个例程带你读懂整个主站文章目录从零开发 EtherCAT 主站五SOEM 框架源码解析一个例程带你读懂整个主站一、SOEM 是什么二、为什么选择 SOEM三、先看一个最简单的例程四、ec_init()初始化底层网络接口五、ec_config_init()扫描并识别从站六、ec_config_map()构建过程数据映射七、状态机切换检查 SAFE-OP → 请求 OP八、周期发送和接收 PDO九、把整个流程串起来十、SOEM 源码到底应该怎么看十一、一个真正的 EtherCAT 主站并没有想象中复杂十二、下一篇预告系列文章导航前面四篇我们完成了 EtherCAT 基础知识的学习EtherCAT 基本原理 → 数据帧与 WKC → 从站状态机 → PDO / Mailbox / CoE / FoE从这一篇开始正式进入SOEM 入门篇。不再单纯讲协议而是直接结合代码看看一个真正的 EtherCAT Master 是怎么工作的。本文不会一上来就分析 SOEM 的所有源码而是先通过一个最简单的示例把整个主站运行流程串起来。一、SOEM 是什么SOEM 全称Simple Open EtherCAT Master是一个开源的 EtherCAT Master 协议栈。相比商业主站它的代码量小、结构清晰非常适合学习 EtherCAT 主站的实现原理。SOEM 本身不是完整的应用软件而是底层通信核心。我们后续的开发会以 SOEM 为基础在它之上构建 Qt 上位机、从站管理、SDO 工具、FoE 升级等功能Qt 上位机 │ ┌─────────┼─────────┐ │ │ │ 从站管理 SDO工具 FoE升级 │ │ │ └─────────┼─────────┘ │ SOEM │ EtherCAT二、为什么选择 SOEM源码简单比大型工业级主站容易阅读适合学习跨平台支持 Windows、Linux、嵌入式平台功能较完整Slave Scan、PDO、SDO、Mailbox、CoE、FoE、DC、状态机、过程数据均有支持三、先看一个最简单的例程学习 SOEM建议先看 Demo再反过来看源码。否则容易陷入一堆结构体和函数中完全找不到头绪。一个最精简的 SOEM 主站程序可以简化为#includeethercat.hintmain(intargc,char*argv[]){if(!ec_init(argv[1]))return-1;if(ec_config_init(FALSE)0)return-1;ec_config_map(IOmap);ec_statecheck(0,EC_STATE_SAFE_OP,EC_TIMEOUTSTATE);ec_slave[0].stateEC_STATE_OPERATIONAL;ec_writestate(0);while(1){ec_send_processdata();ec_receive_processdata(EC_TIMEOUTRET);}return0;}实际 SOEM Demo 会更复杂但这段代码已经包含了一个 EtherCAT Master 最核心的流程。下面我们逐一拆解每个 API 的作用。四、ec_init()初始化底层网络接口ec_init(eth0);// Linux 下指定网卡名作用初始化 EtherCAT 主站的底层网络接口即打开网卡、准备好发送 EtherCAT 帧的能力。注意ec_init()并不会扫描从站它只是让主站具备通信能力。五、ec_config_init()扫描并识别从站ec_config_init(FALSE);这一步负责扫描 EtherCAT 网络上的所有从站读取它们的 Vendor ID、Product Code、Revision、Serial Number 等基本信息并保存到ec_slave[]数组中。SOEM 使用ec_slave[]保存所有从站信息其中ec_slave[0]比较特殊代表主站自身的逻辑信息真正的从站从ec_slave[1]开始for(i1;iec_slavecount;i){// 遍历所有从站}六、ec_config_map()构建过程数据映射ec_config_map(IOmap);这个函数非常重要根据从站的 PDO 配置将各个从站的过程数据映射到主站的IOmap中。IOmap是一块连续的内存区域主站周期通信时直接操作这块内存即可IOmap ┌─────────────────────────────────────┐ │ Slave 1 PDO │ Slave 2 PDO │ Slave 3 │ └─────────────────────────────────────┘七、状态机切换检查 SAFE-OP → 请求 OPec_statecheck(0,EC_STATE_SAFE_OP,EC_TIMEOUTSTATE);等待所有从站进入SAFE-OP状态输入可用输出处于安全状态。然后主站请求进入OPec_slave[0].stateEC_STATE_OPERATIONAL;ec_writestate(0);ec_statecheck(0,EC_STATE_OPERATIONAL,EC_TIMEOUTSTATE);八、周期发送和接收 PDO进入 OP 之后真正的实时通信开始ec_send_processdata();// 发送输出 PDOec_receive_processdata(EC_TIMEOUTRET);// 接收输入 PDO通常放在周期任务中如 1ms 周期不断循环。这是 EtherCAT 最核心的实时数据交换过程。九、把整个流程串起来现在回头再看那段精简代码流程变得非常清晰ec_init() → 初始化网卡 ↓ ec_config_init() → 扫描从站填充 ec_slave[] ↓ ec_config_map() → 构建 IOmap 映射 ↓ ec_statecheck(SAFE_OP) → 等待从站进入 SAFE-OP ↓ ec_writestate(OP) → 请求从站进入 OP ↓ while (1) { ec_send_processdata() ec_receive_processdata() } → 周期 PDO 通信十、SOEM 源码到底应该怎么看不建议从头到尾按文件顺序阅读。更高效的方法是先看 Demo找到核心 API进入 API 源码追踪其实现继续向下追踪底层函数理解关键数据结构最后回头看整体架构例如看到ec_config_init()就深入它的内部实现看它如何发送 Datagram、读取 EEPROM、识别从站。SOEM 的核心模块大致如下不同版本略有差异SOEM ├── ethercatmain → 主站核心 API ├── ethercatbase → 基础 EtherCAT 操作 ├── ethercatconfig → 从站配置 ├── ethercatcoe → CoE / SDO ├── ethercatfoe → FoE ├── ethercatdc → 分布式时钟 ├── ethercatprint → 调试输出 └── ethercat.h → 对外 API十一、一个真正的 EtherCAT 主站并没有想象中复杂EtherCAT 主站的核心流程可以浓缩为① 初始化网卡 ② 扫描从站 ③ 配置从站PDO、FMMU、SyncManager ④ 进入 SAFE-OP ⑤ 进入 OP ⑥ 周期交换 PDO ⑦ 监控 WKC 和从站状态真正复杂的地方并不是这几个 API 本身而是它们背后到底做了什么——例如ec_config_init()到底发送了哪些 DatagramEEPROM 是怎么访问的PDO Mapping 如何配置FMMU 和 SyncManager 如何参与这些正是后续文章要深入分析的内容。十二、下一篇预告本篇通过一个 SOEM Demo 把 EtherCAT Master 的整体流程串了起来。下一篇将正式深入源码《从零开发 EtherCAT 主站六SOEM 初始化流程详解主站是如何发现所有从站的》重点分析ec_init()→ec_config_init()→ Slave Scan → EtherCAT Frame → EEPROM → Vendor ID / Product Code / Revision →ec_slave[]看看 SOEM 到底是怎么把“插在网线上的几个设备”一步一步识别成 EtherCAT 从站的。系列文章导航章节标题状态第一篇EtherCAT 为什么能成为工业实时通信的主流✔第二篇EtherCAT 通信原理详解✔第三篇EtherCAT 状态机ESM完整解析✔第四篇PDO、Mailbox、CoE、FoE 到底是什么✔第五篇SOEM 框架源码解析本文✔第六篇SOEM 初始化流程详解待更新参考链接