SOEM（EtherCAT）主站API整理

1. 适配器管理

• ec_adaptert * ec_find_adapters(void); * 作用：该程序将搜索并提供系统内所有可用EtherCAT适配器的信息。
• 返回值：该函数将返回一个指向适配器列表信息的指针。若未找到相关适配器，则返回NULL。
  • void ec_free_adapters(ec_adaptert * adapter); * 功能：该过程旨在释放ec_find_adapters所分配的相关资源。
    • 参数：其中adapter将指向先前获取的所有适配器列表的信息。

2. 邮箱（MBX）管理

• uint8 ec_nextmbxcnt(uint8 cnt); 该函数的作用是计算出下一封电子邮件所需的字节数。
• 参数说明：参数 cnt 表示消息的数据长度。
• 返回结果：该函数返回的结果包含所有必要的头信息在内的总字节数。
• void ec_clearmbx(ec_mbxbuft *Mbx); 该函数的功能是清空指定的邮件缓冲区域。
  • 输入条件：输入参数 Mbx 用于指向需要清空的邮件缓冲区。

3. 错误处理

• **`ecx_pusherror(ecx_contextt *context, const ec_