EtherCAT从站XML文件框架深度解读

前言：每个EtherCAT从站设备均需提供专属的设备描述——EtherCAT从站信息（ESI，EtherCAT Slave Information），该信息以可扩展标记语言（XML，Extensible Markup Language）文件形式承载，专门用于描述EtherCAT从站的核心特性与配置参数。将该XML文件烧录至从站的EEPROM（电可擦可编程只读存储器）后，EtherCAT主站可快速识别从站设备、完成配置流程，并实现与从站的稳定通信。
 

在实际应用中，当用户需要自定义从站设备或开发新增功能时，往往需要修改现有XML文件或创建全新文件，此时深入理解XML文件的框架结构就显得尤为关键。本文以5.13版本SSC（Slave Stack Code，从站协议栈代码）工具生成的FCE1353_SPI_0x82型号XML文件为实例，全面拆解XML文件的核心框架与配置逻辑。

一、ESI文件概述

1. ESI文件的定义与作用

ESI即EtherCAT从站设备信息，其载体是遵循EtherCAT技术协会（ETG）规范格式的标准化XML文件。该文件烧录至从站EEPROM后，将向EtherCAT主站传递从站的关键信息，包括设备特性、支持的通信方式、PDO（Process Data Object，过程数据对象）/SDO（Service Data Object，服务数据对象）配置、同步机制参数等。ESI文件通常与从站协议栈程序通过SSC工具同步生成，二者存在严格的对应关系，确保协议栈运行与设备描述的一致性。

2. XML文件与ESI文件的关联

ESI是从功能角度对设备描述的定义，核心作用是实现主从站的信息交互与适配；

XML是一种通用的数据描述语言，作为ESI文件的合法载体，ESI文件必须严格遵循EtherCAT协会定义的规则，采用XML语法编写。
 

简单来说，ESI是“内容核心”，XML是“呈现形式”，二者结合形成主站可识别的从站设备描述文件。

二、基于SSC工具的XML文件生成流程

文件生成：工程配置无误后，点击SSC工具菜单栏的「Project」→「Create new Slave Files」（快捷键F5），工具将自动生成两类文件： EtherCAT 协议栈程序和 XML 文件。

三、XML文件框架核心解读
 

本节以5.13版本SSC工具生成的FCE1353_SPI_0x82普通IO型XML文件为分析对象（文件通过Visual Studio Code打开），从节点结构、配置参数、逻辑关联三个维度拆解框架细节。

1. Vendor节点：厂商信息定义

ID：设备商唯一标识；

Name：设备商全称；

ImageData16x14：设备商Logo数据（尺寸为16×14像素，用于可视化识别）。

2. Groups节点：设备分组类别定义

SortOrder：分组排列序号（决定分组在主站识别列表中的显示顺序）；

Type：分组标签（用于程序层面的分组标识，需唯一）；

Name：分组名称（中文/英文均可，便于人工识别）；

ImageData16x14：分组Logo数据。

3. Devices节点：从站设备核心配置

Physics：物理接口类型（Y代表MII接口，K代表LVDS接口）；

Type：产品标签（包含ProductCode产品编号、RevisionNo版本号）；

Name：产品名称（支持多语言标识，1033对应英文，1031对应德文）；

GroupType：分组标签（关联Groups节点的Type属性，明确设备所属分组）；

Profile：对象字典（包含数据类型定义与数据结构描述）；

Fmmu：FMMU（Fieldbus Memory Management Unit，现场总线内存管理单元）通道配置；

Sm：SM（Sync Manager，同步管理器）通道配置（负责数据传输的同步控制）；

RxPdo：从站接收主站数据的映射配置（以从站为参考系，接收主站下发的控制数据）；

TxPdo：从站发送至主站数据的映射配置（以从站为参考系，上传设备状态或采集数据）；

Dc：同步模式配置（保障主从站数据传输的时间同步精度）；

ConfigData：ESC（EtherCAT Slave Controller，EtherCAT从站控制器）特定寄存器配置信息（适配控制器硬件参数）；

ImageData16x14：设备Logo数据。

4. Profile-Dictionary节点：对象字典配置

对象字典是数据交互的“数据手册”，定义了所有传输数据的类型与结构，分为两个子项：

DataTypes：数据类型定义（仅需添加新增或差异化数据类型，已存在的重复类型无需重复定义）；

Objects：数据结构字典。

5. Sm节点：同步管理器通道配置

核心配置项为DefaultSize，代表输入输出数据的总字节长度，需统计RxPdo和TxPdo中所有数据的BitLen（位长度）总和，转换为字节（1byte=8bit）后填入。示例计算：RxPdo包含8个1bit数据+1个8bit数据，总长度16bit=2byte；TxPdo包含两组数据，第一组16bit=2byte，第二组32bit=4byte，合计6byte，因此对应Sm通道的DefaultSize分别配置为2和6。

6. RxPdo节点：接收数据映射配置

核心功能：将输出数据结构字典中的数据映射至RxPdo，封装到SM2通道进行传输；

关键要求：由于FCE1353的DPRAM（双端口RAM）为16位架构，所有映射数据必须保证16位对齐，长度不足时需通过空变量补齐，避免数据传输错位。

7. TxPdo节点：发送数据映射配置

核心功能：将输入数据结构字典中的数据映射至TxPdo，封装到SM3通道进行传输；

关键要求：与RxPdo一致，需遵循16位数据对齐规则，不足16位的部分通过空变量补齐，确保数据传输的完整性与准确性。

补充说明

XML文件的语法需严格遵循XML规范与ETG协会要求，示例文件的根节点为，包含xmlns:xsd（XML Schema定义）、Version（文件版本）等属性，所有节点需保持正确的嵌套关系与标签闭合（如示例中需修正Inputs/Fmmu>为Inputs），否则将导致主站无法识别文件。

审核编辑 黄宇