ESI 文件

什么是 ESI?

ESI (EtherCAT Slave Information) 是描述从站设备特性的 XML 格式描述文件。

每个 EtherCAT 从站设备都有对应的 ESI 文件，它就像是设备的"身份证"和"使用说明书"，包含了设备的完整配置信息。

ESI 文件的核心信息

ESI 文件包含以下关键信息：

信息类型	说明	示例
设备身份	厂商 ID 和产品代码	Beckhoff EL2008, ID: 0x00000002
通信协议	支持的邮箱协议	CoE, FoE, EoE
过程数据	输入/输出 PDO 定义	8路数字输出, 每路1位
同步模式	支持的同步方式	自由运行、SM同步、DC同步
分布式时钟	DC 配置参数	SYNC0 周期、偏移时间
状态机	状态转换配置	Init → PreOP → SafeOP → OP
对象字典	CoE 对象定义	索引、子索引、数据类型
诊断信息	错误代码和描述	0x001A - Invalid Mailbox Config

ESI 的关键作用

零配置启动

有了 ESI 文件，主站可以自动完成：

• PDO 映射配置
• 同步管理器设置
• FMMU 映射
• 分布式时钟配置

无需手动编写复杂的配置代码。

兼容性保证

遵循 ETG 标准的 ESI 文件确保：

• 不同厂商主站都能识别
• 不同版本设备向下兼容
• 标准化的配置流程

诊断和调试

ESI 文件提供：

• 详细的错误代码说明
• 参数取值范围
• 状态机转换条件
• 帮助文档链接

ESI 文件的来源

从哪里获取 ESI?

• 设备厂商官网 — 最新、最准确的 ESI
• ETG 官方网站 — 认证设备的标准 ESI
• 配置工具自带 — TwinCAT 等工具内置
• 设备附带光盘 — 随设备提供

常见问题

ESI 文件缺失怎么办?

• 联系设备厂商获取最新 ESI 文件
• 查看 ETG 网站是否有认证设备的 ESI
• 使用 SDK 自带的通用从站自动配置功能(支持绝大部分从站,无需ESI也可自动配置设备)

ESI 版本不匹配?

• ESI 文件有版本号，确保使用与固件版本匹配的 ESI
• 寻找并使用厂商提供的最匹配的版本
• 错误的ESI可能导致配置失败或运行异常, 请务必确认版本匹配
• 删掉错误的ESI文件, 使用 SDK 的自动配置功能