【免费下载】 SOEM项目教程：EtherCAT主站开发实践指南

1. SOEM概述

SOEM（Simple Open EtherCAT Master）是一个轻量级的EtherCAT主站库，专为嵌入式系统设计。它为用户应用程序提供了发送和接收EtherCAT帧的能力，同时将以下职责留给应用程序：

• 读写要与SOEM交换的过程数据
• 保持本地IO数据与全局IO映射同步
• 检测和处理SOEM报告的错误

2. 基础配置与初始化

2.1 主程序结构

典型的SOEM应用程序结构如下：

int main(void)
{
   rprintp("SOEM (Simple Open EtherCAT Master)\nSimple test\n");
   task_spawn("simpletest", simpletest, 9, 8192, NULL);
}

2.2 网络接口初始化

使用ec_init()函数初始化网络接口：

if (ec_init(ifname) > 0) {
   // 初始化成功
}

对于支持电缆冗余的系统，可以使用ec_init_redundant()。

2.3 从站自动配置

ec_config_init()函数会：

1. 通过广播读取地址0来发现所有从站
2. 为支持邮箱的从站设置邮箱
3. 将所有从站设置为PRE_OP状态

if (ec_config_init(FALSE) > 0) {
   rprintp("%d slaves found and configured.\n", ec_slavecount);
}

2.4 网络配置验证

建议验证发现的从站是否符合预期：

#define EK1100_1           1
#define EL4001_1           2
// ...其他从站定义

uint32 network_configuration(void)
{
   if (ec_slavecount < NUMBER_OF_SLAVES)
      return 0;
   
   if (strcmp(ec_slave[EK1100_1].name,"EK1100"))
      return 0;
   // ...其他从站验证
   
   return 1;
}

3. IO映射与状态管理

3.1 IO映射配置

char IOmap[128];
int usedmem;
usedmem = ec_config_map(&IOmap);
if (usedmem <= sizeof(IOmap)) {
   // 映射成功
}

SOEM会尽量压缩逻辑过程映像，将位导向的从站组合在单个字节中。

3.2 状态转换

进入OP状态前需要发送有效数据：

ec_send_processdata();
wkc = ec_receive_processdata(EC_TIMEOUTRET);
ec_writestate(0);
ec_statecheck(0, EC_STATE_OPERATIONAL, EC_TIMEOUTSTATE);

4. 高级配置选项

4.1 自定义PDO配置

可以在PreOP到SafeOP转换时进行自定义配置：

int EL7031setup(uint16 slave)
{
    uint16 map_1c12[4] = {0x0003, 0x1601, 0x1602, 0x1604};
    retval += ec_SDOwrite(slave, 0x1c12, 0x00, TRUE, sizeof(map_1c12), &map_1c12, EC_TIMEOUTSAFE);
    // ...其他配置
}

// 在初始化时关联配置函数
ec_slave[slc].PO2SOconfig = EL7031setup;

4.2 IO映射模式

SOEM支持两种IO映射模式：

1. 传统模式：直接发送IO映射数据
2. 重叠模式：为每个从站重用逻辑地址，适合TI ESC等设备

4.3 从站分组

可以将从站分组以实现不同的更新速率：

for (cnt = 1; cnt <= ec_slavecount; cnt++) {
   if (<some condition>) {
      ec_slave[cnt].group = X;
   } else {
      ec_slave[cnt].group = Y;
   }
}

分组后需要分别处理各组数据：

ec_send_processdata_group(X);
ec_receive_processdata_group(X, EC_TIMEOUTRET);

5. 数据访问与错误处理

5.1 通过IOmap访问数据

// 处理对齐问题的16位输出设置
void set_output_int16(uint16 slave_no, uint8 module_index, int16 value)
{
   uint8 *data_ptr = ec_slave[slave_no].outputs;
   data_ptr += module_index * 2;
   *data_ptr++ = (value >> 0) & 0xFF;
   *data_ptr++ = (value >> 8) & 0xFF;
}

5.2 错误检测与处理

工作计数器(WKC)是检测错误的关键：

wkc = ec_receive_processdata(EC_TIMEOUTRET);
expectedWKC = (ec_group[0].outputsWKC * 2) + ec_group[0].inputsWKC;

if(inOP && ((wkc < expectedWKC) || ec_group[currentgroup].docheckstate)) {
   // 错误处理逻辑
   ec_readstate();
   for (slave = 1; slave <= ec_slavecount; slave++) {
      // 检查每个从站状态并采取相应措施
   }
}

6. SDO与PDO访问

6.1 SDO访问

使用ecx_SDOread()和ecx_SDOwrite()函数：

uint16 u16val = 1200; // 示例值
ec_SDOwrite(slave, 0x8010, 0x01, FALSE, sizeof(u16val), &u16val, EC_TIMEOUTSAFE);

6.2 PDO访问

大多数情况下可以使用与SDO相同的函数访问PDO。对于标记为"PDO only"的对象，只能通过IOmap访问。

7. 总结

本教程介绍了使用SOEM开发EtherCAT主站应用的基本流程和关键技术点。通过合理配置IO映射、状态管理和错误处理，可以构建稳定可靠的EtherCAT控制系统。SOEM的轻量级特性使其特别适合嵌入式应用场景。