如何使用Ecat EnableKit开发IGH EtherCAT主站ENI解析应用层?
摘要:本系列文章介绍 Ecat EnableKit —— intel 开源的一个基于 IGH EtherCAT 主站协议栈构建的应用层开发框架,提供igh ENI、ESI解析、简化的运动控制 API。
Ecat EnableKit 博客文章索引
本系列文章介绍 Ecat EnableKit —— intel 开源的一个基于 IGH EtherCAT 主站协议栈构建的应用层开发框架,提供igh ENI、ESI解析、简化的运动控制 API。
Ecat EnableKit
概述
Ecat EnableKit 提供了一套全面的工具与 API,旨在简化 EtherCAT 系统的配置与开发流程。它大幅降低了 EtherCAT 主站、从站及网络拓扑的搭建难度,使开发者能专注于应用逻辑而非底层配置细节。借助 Ecat EnableKit,构建高可靠性的 EtherCAT 应用将变得更加高效快捷。
github地址:https://github.com/open-edge-platform/edge-ai-libraries/tree/main/libraries/edge-control-libraries/fieldbus/ecat-enablekit
主要特性
基于 IgH EtherCAT 主站协议栈构建
支持 Preempt-RT 和 Xenomai/Dovetail 实时框架
提供解析 EtherCAT 网络信息(ENI)文件的实用工具
包含解析 EtherCAT 从站信息(ESI)文件的工具
提供友好的 API,加速 EtherCAT 应用开发
附带控制 EtherCAT IO 从站的示例代码
包含操作 EtherCAT CoE 从站的示例代码(暂不支持 SOE)
文章列表
1. Ecat EnableKit 项目介绍
项目概述和主要特性
软件架构
依赖项和安装
快速入门指南
常用命令
2. Ecat EnableKit 开发者指南
架构设计详解
目录结构说明
核心模块详解
API 参考手册
运行流程和使用示例
编译安装指南
常见问题解答
3. Ecat EnableKit API 参考
主站管理 API
域管理 API
从站配置 API
PDO 偏移量获取
数据读写宏
周期性处理
分布式时钟
SDO 配置
运动控制
CIA402 状态机
4. Ecat EnableKit 架构说明
整体软件架构图
初始化流程时序图
周期性任务流程图
数据流图
单域 vs 多域模式
CIA402 状态机图
核心数据结构关系
模块依赖关系
5. ENI 文件格式详解
ENI 文件结构
主站配置 (Master)
从站配置 (Slave)
SyncManager 配置
初始化命令
周期性配置
过程镜像配置
分布式时钟配置
示例 ENI 文件
ENI 文件生成工具
阅读建议
新手入门:
先阅读 项目介绍 了解整体概况
参考 开发者指南 中的使用示例
查阅 API 参考 快速查找函数
深入理解:
阅读 架构说明 了解系统架构
参考 ENI 文件格式 了解配置文件规范
关于 Ecat EnableKit
Ecat EnableKit 是基于 IGH EtherCAT 主站协议栈构建的应用层开发框架,主要特性:
基于 IgH EtherCAT Master Stack 构建
支持 Preempt-RT 和 Xenomai/Dovetail 实时框架
提供 ENI/ESI 文件解析工具
用户友好的 API 设计
丰富的示例代码
许可证: LGPL v2.1
整理时间: 2025-03
