1. 为什么要在STM32F4上跑SOEM主站1.1 一个被忽略的现实需求大多数EtherCAT主站方案都跑在带标准网卡的Linux系统上比如用IGH主站或者SOEM配合实时内核补丁。这套方案成熟、生态好但代价也很明显你需要一颗能跑Linux的处理器外加DDR、Flash、电源管理芯片整块板子的成本和功耗都上去了。对于很多只需要控制几个从站、周期在1ms左右的小型设备来说这完全是杀鸡用牛刀。我第一次接触这个需求是给一台小型多轴运动控制器做方案。客户要求控制6个伺服从站通信周期1ms整机成本要压到很低而且希望用裸机方案不要操作系统。当时第一反应是这不可能因为EtherCAT主站需要精确的时钟同步、需要处理复杂的报文调度裸机怎么搞后来仔细研究了SOEM的源码结构发现它本身对操作系统的依赖其实很薄主要就是网络收发、定时器和线程这几块。把这几块用STM32的HAL库和裸机调度替换掉理论上完全可行。实测下来STM32F4系列我用的是STM32F407168MHz主频带MAC外设跑SOEM主站控制6个从站、1ms周期CPU占用率大概在40%左右完全能接受。这个方案后来成了我们的一条产品线稳定运行了两年多。1.2 SOEM到底依赖操作系统什么在动手移植之前必须先把SOEM对OS的依赖摸清楚。我把SOEM的源码翻了一遍归纳下来主要是四类依赖网络收发SOEM通过osal层调用网卡驱动Linux下用的是原始套接字raw socket裸机下需要自己实现MAC层的收发。定时器用于周期任务调度和超时检测Linux下用clock_gettime和nanosleep裸机下用STM32的定时器。线程/锁SOEM在多线程场景下用互斥锁保护共享数据裸机单线程下这些可以简化成空实现。时间戳用于计算DC分布式时钟同步需要高精度时间裸机下用定时器计数器实现。这四类依赖SOEM都通过osalOS Abstraction Layer和oshwOS Hardware两层抽象隔离出来了。移植的核心工作就是针对STM32F4实现这两层接口。1.3 移植前必须想清楚的三个问题第一个问题用哪个网卡STM32F4自带MAC外设但需要外接PHY芯片。我选的是LAN8720RMII接口成本低、资料多。注意STM32F4的MAC只支持10/100MEtherCAT正好是100M全双工完美匹配。如果你用的是F429或者F7系列MAC外设是一样的移植方法通用。第二个问题用中断还是轮询收包EtherCAT对实时性要求高我建议用中断收包轮询发送的方式。中断里只做最轻量的操作把报文搬到一个环形缓冲区主循环里再处理。这样既保证实时性又不会在中断里做太多事导致丢包。第三个问题DC同步怎么处理如果你的从站不需要DC同步比如普通IO模块可以先用FreeRun模式跑通再考虑DC。如果从站是伺服必须做DC同步。STM32F4的定时器可以输出精确的周期信号配合SOEM的DC算法能做到亚微秒级的同步精度。2. 把SOEM源码拆开看哪些文件必须改哪些可以不动2.1 SOEM的目录结构与移植边界SOEM的源码结构很清晰主要分三个目录soem/ ├── soem/ # 核心协议栈与平台无关 ├── osal/ # OS抽象层Linux/Win32/RTK等 │ ├── linux/ │ ├── win32/ │ └── ... ├── oshw/ # 硬件抽象层网卡驱动 │ ├── linux/ │ ├── win32/ │ └── ...核心协议栈soem目录完全不用改这是SOEM设计得最好的地方。所有平台相关的代码都被隔离在osal和oshw里。我们要做的就是新建一个osal/stm32和oshw/stm32目录实现对应的接口。2.2 osal层需要实现的函数清单osal层需要实现的函数不多我列一下关键的函数名作用STM32实现方式osal_timer_start启动定时器配置TIM定时器osal_timer_stop停止定时器关闭TIMosal_timer_is_expired判断超时读计数器比较osal_current_time获取当前时间读TIM计数器osal_usleep微秒延时空循环或TIM延时osal_mutex_lock加锁空实现单线程osal_mutex_unlock解锁空实现注意osal_current_time返回的是纳秒级时间戳STM32F4的TIM2是32位168MHz下约25.6秒溢出一次。我的做法是用一个软件计数器记录溢出次数组合成64位时间戳。2.3 oshw层网卡驱动的核心逻辑oshw层是移植的重头戏核心是实现oshw_send和oshw_recv两个函数。Linux下用raw socketSTM32下要直接操作MAC外设。发送流程等待MAC的TX描述符可用把SOEM传来的帧数据拷贝到TX缓冲区设置描述符的OWN位触发发送等待发送完成接收流程MAC收到帧后触发中断中断里检查RX描述符的OWN位把帧数据拷贝到环形缓冲区释放描述符等待下一帧这里有个坑STM32F4的MAC在RMII模式下需要正确配置PHY的时钟。LAN8720需要25MHz时钟输入可以从STM32的MCO引脚输出也可以用外部晶振。我建议用外部晶振稳定性更好。2.4 一个容易被忽略的细节字节序EtherCAT报文是大端序Big-Endian而STM32是小端序Little-Endian。SOEM内部已经处理了大部分字节序转换但在网卡驱动层你需要确保发送和接收的数据不做额外的字节序处理。我一开始在发送前手动做了字节序转换结果从站完全没响应排查了半天才发现是画蛇添足。提示SOEM的ecx_send_processdata等函数内部已经处理了字节序网卡驱动层只需要原样搬运数据即可。3. STM32F4裸机环境的搭建从时钟到MAC3.1 系统时钟配置168MHz不是随便设的STM32F4的MAC外设需要至少25MHz的时钟而RMII模式下PHY需要50MHz参考时钟。STM32F407的时钟树配置如下HSE8MHz外部晶振PLLM8, N336, P2, Q7SYSCLK168MHzAHB168MHzAPB284MHzMAC时钟通过MCO1输出25MHz给PHY这里的关键是MCO1的配置。MCO1可以选择HSE、PLLCLK、HSI等作为输出源分频系数可调。要输出25MHz可以用PLLCLK168MHz除以6.72但分频系数只能是整数。我的做法是用HSE8MHz经过PLL的Q分频Q7得到48MHz再经过MCO预分频除以2得到24MHz接近25MHz但不够精确。更稳妥的方案是用外部25MHz晶振直接给PHY供时钟STM32的MCO不输出。这样PHY的时钟最稳定MAC和PHY之间的RMII通信也最可靠。3.2 MAC外设初始化描述符环的搭建STM32F4的MAC使用DMA描述符环来收发数据。每个描述符包含状态、控制、缓冲区地址等信息。初始化步骤如下// 定义描述符数量 #define ETH_TXBUFNB 4 #define ETH_RXBUFNB 4 // 描述符结构体 typedef struct { volatile uint32_t Status; uint32_t ControlBufferSize; uint32_t Buffer1Addr; uint32_t Buffer2NextDescAddr; } ETH_DMADescTypeDef; // 分配描述符和缓冲区 ETH_DMADescTypeDef DMARxDscrTab[ETH_RXBUFNB] __attribute__((aligned(4))); ETH_DMADescTypeDef DMATxDscrTab[ETH_TXBUFNB] __attribute__((aligned(4))); uint8_t Rx_Buff[ETH_RXBUFNB][ETH_MAX_PACKET_SIZE] __attribute__((aligned(4))); uint8_t Tx_Buff[ETH_TXBUFNB][ETH_MAX_PACKET_SIZE] __attribute__((aligned(4)));描述符必须4字节对齐缓冲区建议也4字节对齐否则DMA可能出错。我踩过一次坑缓冲区没对齐大部分时候正常但偶尔会收到错帧排查了很久才发现是对齐问题。3.3 中断优先级别让网卡中断被其他中断打断EtherCAT对实时性要求高网卡中断的优先级要设得足够高。我的配置是ETH中断抢占优先级1定时器中断用于周期调度抢占优先级2串口中断调试用抢占优先级3这样网卡中断能及时响应不会被其他中断延迟。注意STM32F4的中断优先级分组要设成NVIC_PRIORITYGROUP_4全部用于抢占优先级。3.4 一个实用的调试技巧用GPIO翻转测时间移植过程中最头疼的是不知道时间花在哪里了。我的做法是在关键位置翻转GPIO用示波器看波形。比如进入网卡中断时拉高GPIO退出时拉低测中断处理时间发送报文前拉高发送完成后拉低测发送耗时主循环开始时拉高结束时拉低测循环周期这个方法比任何软件计时都直观而且不影响实时性。我用它发现了一个问题中断处理时间偶尔会超过50微秒原因是中断里做了浮点运算。把浮点运算移到主循环后中断时间稳定在5微秒以内。4. 网卡驱动的实现从描述符到环形缓冲区4.1 发送函数的完整实现oshw_send函数的实现逻辑如下int oshw_send(void *port, void *data, int length) { // 1. 找到可用的TX描述符 ETH_DMADescTypeDef *txdesc DMATxDscrTab[tx_index]; // 2. 等待描述符空闲OWN位为0 uint32_t timeout 100000; while ((txdesc-Status ETH_DMATXDESC_OWN) timeout--); if (timeout 0) return 0; // 超时 // 3. 拷贝数据到缓冲区 memcpy((void *)txdesc-Buffer1Addr, data, length); // 4. 设置描述符控制位 txdesc-ControlBufferSize length ETH_DMATXDESC_TBS1; txdesc-Status ETH_DMATXDESC_OWN | ETH_DMATXDESC_TCH | ETH_DMATXDESC_IC; // 5. 触发DMA发送 ETH-DMATPDR 0; // 6. 更新索引 tx_index (tx_index 1) % ETH_TXBUFNB; return length; }这里的关键是ETH_DMATXDESC_IC位它表示发送完成后触发中断。如果你不需要发送中断可以去掉这一位减少中断次数。4.2 接收中断的处理越轻量越好接收中断的处理原则是快进快出只做最必要的操作void ETH_IRQHandler(void) { // 1. 检查中断标志 if (ETH-DMASR ETH_DMASR_RS) { // 2. 清除标志 ETH-DMASR ETH_DMASR_RS; // 3. 处理接收到的帧 while (!(DMARxDscrTab[rx_index].Status ETH_DMARXDESC_OWN)) { // 获取帧长度 uint32_t length (DMARxDscrTab[rx_index].Status ETH_DMARXDESC_FL) 16; // 拷贝到环形缓冲区 ringbuf_write(eth_rx_ring, (void *)DMARxDscrTab[rx_index].Buffer1Addr, length); // 释放描述符 DMARxDscrTab[rx_index].Status ETH_DMARXDESC_OWN; ETH-DMARPDR 0; // 更新索引 rx_index (rx_index 1) % ETH_RXBUFNB; } } }环形缓冲区的大小建议至少能存8帧每帧最大1518字节。我用的是16帧的缓冲区约24KB内存STM32F407的192KB RAM完全够用。4.3 接收函数的实现从环形缓冲区取数据oshw_recv函数从环形缓冲区取一帧数据int oshw_recv(void *port, void *buf, int *len) { // 从环形缓冲区读取一帧 int ret ringbuf_read(eth_rx_ring, buf, len); if (ret 0) { *len 0; return 0; } return *len; }注意SOEM调用oshw_recv时期望的是非阻塞返回。如果没有数据返回0即可SOEM会在下一次循环再试。4.4 一个必须处理的细节帧过滤EtherCAT主站需要接收所有EtherCAT帧包括广播帧和特定从站的帧。STM32F4的MAC支持多种过滤模式我建议配置成接收所有广播帧接收目的MAC地址匹配的帧接收EtherCAT以太网类型0x88A4的帧如果过滤配置不对可能会漏收某些帧导致从站扫描失败。我一开始只开了广播过滤结果扫描不到从站后来加上EtherCAT类型过滤才正常。5. 周期任务与DC同步让主站跑起来5.1 主循环的调度逻辑裸机下没有操作系统主循环的调度逻辑要自己写。我的做法是用一个定时器产生1ms的周期中断在中断里设置标志位主循环检测到标志位后执行EtherCAT任务volatile uint8_t ecat_tick 0; void TIM3_IRQHandler(void) { if (TIM3-SR TIM_SR_UIF) { TIM3-SR ~TIM_SR_UIF; ecat_tick 1; } } int main(void) { // 初始化 SystemInit(); ETH_Init(); SOEM_Init(); while (1) { if (ecat_tick) { ecat_tick 0; // 发送过程数据 ecx_send_processdata(ctx); // 接收过程数据 ecx_receive_processdata(ctx, EC_TIMEOUTRET); // 处理从站数据 process_slave_data(ctx); } // 处理非周期任务 handle_non_periodic_tasks(); } }这里的关键是ecx_send_processdata和ecx_receive_processdata的调用时机。发送要在周期开始时立即执行接收要在发送后尽快执行中间不要插入耗时操作。5.2 DC同步的实现从FreeRun到DC如果你的从站支持DC建议先用FreeRun模式跑通再切换到DC模式。FreeRun模式下主站按自己的节奏发送报文从站被动接收。DC模式下主站和从站共享一个时钟同步精度更高。DC同步的核心是计算主站时钟和从站时钟的偏移然后调整主站的发送时刻。SOEM提供了ecx_configdc和ecx_dcsync0等函数来处理DC。在STM32上你需要提供一个高精度的时钟源我用的TIM2的计数器168MHz下分辨率约6纳秒足够DC同步使用。5.3 实测数据1ms周期下的性能我用STM32F407LAN8720控制6个伺服从站实测数据如下指标数值通信周期1ms过程数据长度32字节CPU占用率约40%同步精度±100ns丢包率0连续运行72小时这个性能对于大多数小型设备来说完全够用。如果你需要更短的周期可以优化中断处理或者换用STM32F7/H7系列主频更高性能余量更大。5.4 一个实用的优化减少内存拷贝SOEM在收发过程中会有多次内存拷贝每次拷贝都会消耗CPU时间。我的优化做法是发送时直接把SOEM的缓冲区地址设置到TX描述符避免拷贝接收时如果环形缓冲区足够大可以直接用描述符的缓冲区避免拷贝这个优化能把CPU占用率降低约10%。但要注意直接使用描述符缓冲区时要确保SOEM在处理完数据前描述符不会被复用。6. 踩过的坑与排查过程6.1 从站扫描不到一个MAC地址引发的血案第一次跑通网卡驱动后我迫不及待地调用ecx_config_init扫描从站结果返回0个从站。用Wireshark抓包发现主站发出的广播帧从站收到了但从站的响应帧主站没收到。排查过程检查MAC过滤配置确认广播和EtherCAT类型都开了用示波器看PHY的RX引脚有信号检查RX描述符发现OWN位一直是1说明DMA没把数据搬过来查STM32F4参考手册发现MAC的RX DMA在RMII模式下需要正确配置ETH_DMABMR寄存器的RDP位最后发现是ETH_DMABMR的RDPRx DMA PBL配置成了0导致DMA不工作。改成32后从站扫描正常。6.2 周期通信偶尔丢包中断优先级惹的祸跑通周期通信后发现偶尔会丢一帧概率大概千分之一。用GPIO翻转法测中断响应时间发现偶尔会超过100微秒。排查过程检查所有中断的优先级配置发现串口中断的优先级设得比网卡中断高串口中断里有一个printf耗时较长把串口中断优先级降低printf移到主循环改完后连续运行72小时无丢包。6.3 DC同步不收敛时间戳的精度问题切换到DC模式后发现同步误差在±10微秒左右远达不到亚微秒级。排查过程检查osal_current_time的实现发现用的是TIM2的计数器TIM2是32位168MHz下约25.6秒溢出溢出处理有bug导致时间戳偶尔跳变修复溢出处理用软件计数器记录溢出次数修复后同步误差降到±100纳秒。6.4 一个隐蔽的坑PHY的自动协商LAN8720默认开启自动协商协商过程中PHY会短暂断开连接。如果主站在协商完成前就开始发送EtherCAT报文会丢包。解决方法在初始化PHY后等待自动协商完成读PHY的BSR寄存器等待Link Up位再启动EtherCAT通信。或者直接配置PHY为100M全双工固定模式跳过自动协商。7. 代码组织与工程配置7.1 目录结构建议我的工程目录结构如下project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ ├── stm32f4xx_it.c │ └── ... ├── Drivers/ │ ├── STM32F4xx_HAL_Driver/ │ └── CMSIS/ ├── SOEM/ │ ├── soem/ │ ├── osal/ │ │ └── stm32/ │ └── oshw/ │ └── stm32/ ├── App/ │ ├── eth_driver.c │ ├── ecat_app.c │ └── ringbuf.c └── MDK-ARM/ └── project.uvprojx把SOEM的源码直接放进工程不要编译成库。这样调试时能直接看到源码方便定位问题。7.2 编译配置要点优化等级建议用-O2-O3可能导致某些时序问题浮点运算如果从站数据涉及浮点开启FPU但注意中断里不要用浮点堆栈大小主栈至少4KBSOEM的某些函数递归较深链接脚本确保描述符和缓冲区4字节对齐7.3 一个实用的调试工具SOEM自带的ethercatdbgSOEM自带一个ethercatdbg工具可以打印从站信息、过程数据、DC状态等。在裸机上你可以把它的输出重定向到串口方便调试。我把它精简了一下只保留关键信息通过串口打印不影响实时性。8. 从能跑到好用几个进阶优化方向8.1 用DMA减轻CPU负担STM32F4的MAC自带DMA但SOEM的数据处理还是在CPU里做。如果CPU占用率过高可以考虑用DMA把过程数据直接搬到内存CPU只做必要的处理。这个优化比较复杂需要对SOEM的源码有深入理解。8.2 支持热插拔EtherCAT支持热插拔但从站掉线后重新上线主站需要重新配置。在裸机上实现热插拔需要定期检查从站状态发现掉线后重新扫描。这个功能对于工业现场很实用但会增加代码复杂度。8.3 多主站冗余如果你的应用对可靠性要求极高可以考虑双主站冗余。两个STM32F4主站同时运行一个主站故障时另一个接管。这需要两个主站之间同步状态实现起来有一定难度。8.4 一个我个人的经验不要过度优化移植初期我花了很多时间优化性能想把CPU占用率降到最低。后来发现对于大多数应用40%的CPU占用率完全够用过度优化反而引入了bug。我的建议是先跑通再优化优化要有明确的性能目标不要为了优化而优化。9. 移植完成后的验证清单移植完成后我建议按以下清单逐项验证验证项方法通过标准网卡收发ping测试或抓包能正常收发从站扫描ecx_config_init扫描到所有从站过程数据读写从站IO数据正确周期通信连续运行无丢包DC同步读从站DC状态误差1微秒异常恢复拔插网线能自动恢复长时间运行72小时连续无异常这个清单是我从多个项目中总结出来的每次移植新平台都按这个清单走能覆盖绝大多数问题。10. 一些零散但重要的经验关于PHY的选择LAN8720便宜好用但要注意它的RMII模式需要50MHz时钟。如果你的STM32主频不是168MHz可能需要调整时钟配置。DP83848是另一个选择性能更稳定但价格稍贵。关于PCB布局RMII的时钟线要等长差分线要阻抗匹配。我见过一个项目因为PCB布局问题EtherCAT通信不稳定换了三版板子才解决。如果你的项目对成本不敏感建议用四层板。关于电源PHY的电源要干净建议用LDO单独供电。MAC和PHY的电源要隔离避免数字噪声干扰模拟电路。关于散热STM32F407在168MHz全速运行时发热明显如果环境温度高建议加散热片。我有个项目在密闭机箱里跑夏天偶尔会死机加了散热片后稳定了。关于代码版本管理SOEM的版本更新较快建议锁定一个稳定版本不要频繁升级。我用的是SOEM 1.4.0稳定运行了两年多。关于文档移植过程中遇到的问题和解决方案一定要记录下来。我养成了一个习惯每解决一个问题就在代码注释里写清楚原因和解决方法。这样下次遇到类似问题能快速定位。关于测试不要只测正常情况要测异常情况。比如网线拔掉、从站断电、电源波动等。这些异常情况在实际现场经常遇到提前测过现场就不会慌。关于成本STM32F407LAN8720的方案BOM成本大概在30元左右比带Linux的方案便宜很多。如果你的产量大成本优势更明显。关于开发效率用STM32CubeMX生成初始化代码能省很多时间。但要注意CubeMX生成的MAC初始化代码可能需要调整特别是描述符和缓冲区的配置。关于社区SOEM的社区很活跃遇到问题可以在GitHub上提issue或者查已有的issue。我很多问题都是在社区里找到答案的。关于心态移植协议栈是个细致活不要急。我前后花了大概两周时间才把整个方案跑稳定。中间遇到很多问题但每解决一个对协议栈的理解就深一层。这个过程虽然辛苦但收获很大。
STM32F4裸机移植SOEM EtherCAT主站实战指南
1. 为什么要在STM32F4上跑SOEM主站1.1 一个被忽略的现实需求大多数EtherCAT主站方案都跑在带标准网卡的Linux系统上比如用IGH主站或者SOEM配合实时内核补丁。这套方案成熟、生态好但代价也很明显你需要一颗能跑Linux的处理器外加DDR、Flash、电源管理芯片整块板子的成本和功耗都上去了。对于很多只需要控制几个从站、周期在1ms左右的小型设备来说这完全是杀鸡用牛刀。我第一次接触这个需求是给一台小型多轴运动控制器做方案。客户要求控制6个伺服从站通信周期1ms整机成本要压到很低而且希望用裸机方案不要操作系统。当时第一反应是这不可能因为EtherCAT主站需要精确的时钟同步、需要处理复杂的报文调度裸机怎么搞后来仔细研究了SOEM的源码结构发现它本身对操作系统的依赖其实很薄主要就是网络收发、定时器和线程这几块。把这几块用STM32的HAL库和裸机调度替换掉理论上完全可行。实测下来STM32F4系列我用的是STM32F407168MHz主频带MAC外设跑SOEM主站控制6个从站、1ms周期CPU占用率大概在40%左右完全能接受。这个方案后来成了我们的一条产品线稳定运行了两年多。1.2 SOEM到底依赖操作系统什么在动手移植之前必须先把SOEM对OS的依赖摸清楚。我把SOEM的源码翻了一遍归纳下来主要是四类依赖网络收发SOEM通过osal层调用网卡驱动Linux下用的是原始套接字raw socket裸机下需要自己实现MAC层的收发。定时器用于周期任务调度和超时检测Linux下用clock_gettime和nanosleep裸机下用STM32的定时器。线程/锁SOEM在多线程场景下用互斥锁保护共享数据裸机单线程下这些可以简化成空实现。时间戳用于计算DC分布式时钟同步需要高精度时间裸机下用定时器计数器实现。这四类依赖SOEM都通过osalOS Abstraction Layer和oshwOS Hardware两层抽象隔离出来了。移植的核心工作就是针对STM32F4实现这两层接口。1.3 移植前必须想清楚的三个问题第一个问题用哪个网卡STM32F4自带MAC外设但需要外接PHY芯片。我选的是LAN8720RMII接口成本低、资料多。注意STM32F4的MAC只支持10/100MEtherCAT正好是100M全双工完美匹配。如果你用的是F429或者F7系列MAC外设是一样的移植方法通用。第二个问题用中断还是轮询收包EtherCAT对实时性要求高我建议用中断收包轮询发送的方式。中断里只做最轻量的操作把报文搬到一个环形缓冲区主循环里再处理。这样既保证实时性又不会在中断里做太多事导致丢包。第三个问题DC同步怎么处理如果你的从站不需要DC同步比如普通IO模块可以先用FreeRun模式跑通再考虑DC。如果从站是伺服必须做DC同步。STM32F4的定时器可以输出精确的周期信号配合SOEM的DC算法能做到亚微秒级的同步精度。2. 把SOEM源码拆开看哪些文件必须改哪些可以不动2.1 SOEM的目录结构与移植边界SOEM的源码结构很清晰主要分三个目录soem/ ├── soem/ # 核心协议栈与平台无关 ├── osal/ # OS抽象层Linux/Win32/RTK等 │ ├── linux/ │ ├── win32/ │ └── ... ├── oshw/ # 硬件抽象层网卡驱动 │ ├── linux/ │ ├── win32/ │ └── ...核心协议栈soem目录完全不用改这是SOEM设计得最好的地方。所有平台相关的代码都被隔离在osal和oshw里。我们要做的就是新建一个osal/stm32和oshw/stm32目录实现对应的接口。2.2 osal层需要实现的函数清单osal层需要实现的函数不多我列一下关键的函数名作用STM32实现方式osal_timer_start启动定时器配置TIM定时器osal_timer_stop停止定时器关闭TIMosal_timer_is_expired判断超时读计数器比较osal_current_time获取当前时间读TIM计数器osal_usleep微秒延时空循环或TIM延时osal_mutex_lock加锁空实现单线程osal_mutex_unlock解锁空实现注意osal_current_time返回的是纳秒级时间戳STM32F4的TIM2是32位168MHz下约25.6秒溢出一次。我的做法是用一个软件计数器记录溢出次数组合成64位时间戳。2.3 oshw层网卡驱动的核心逻辑oshw层是移植的重头戏核心是实现oshw_send和oshw_recv两个函数。Linux下用raw socketSTM32下要直接操作MAC外设。发送流程等待MAC的TX描述符可用把SOEM传来的帧数据拷贝到TX缓冲区设置描述符的OWN位触发发送等待发送完成接收流程MAC收到帧后触发中断中断里检查RX描述符的OWN位把帧数据拷贝到环形缓冲区释放描述符等待下一帧这里有个坑STM32F4的MAC在RMII模式下需要正确配置PHY的时钟。LAN8720需要25MHz时钟输入可以从STM32的MCO引脚输出也可以用外部晶振。我建议用外部晶振稳定性更好。2.4 一个容易被忽略的细节字节序EtherCAT报文是大端序Big-Endian而STM32是小端序Little-Endian。SOEM内部已经处理了大部分字节序转换但在网卡驱动层你需要确保发送和接收的数据不做额外的字节序处理。我一开始在发送前手动做了字节序转换结果从站完全没响应排查了半天才发现是画蛇添足。提示SOEM的ecx_send_processdata等函数内部已经处理了字节序网卡驱动层只需要原样搬运数据即可。3. STM32F4裸机环境的搭建从时钟到MAC3.1 系统时钟配置168MHz不是随便设的STM32F4的MAC外设需要至少25MHz的时钟而RMII模式下PHY需要50MHz参考时钟。STM32F407的时钟树配置如下HSE8MHz外部晶振PLLM8, N336, P2, Q7SYSCLK168MHzAHB168MHzAPB284MHzMAC时钟通过MCO1输出25MHz给PHY这里的关键是MCO1的配置。MCO1可以选择HSE、PLLCLK、HSI等作为输出源分频系数可调。要输出25MHz可以用PLLCLK168MHz除以6.72但分频系数只能是整数。我的做法是用HSE8MHz经过PLL的Q分频Q7得到48MHz再经过MCO预分频除以2得到24MHz接近25MHz但不够精确。更稳妥的方案是用外部25MHz晶振直接给PHY供时钟STM32的MCO不输出。这样PHY的时钟最稳定MAC和PHY之间的RMII通信也最可靠。3.2 MAC外设初始化描述符环的搭建STM32F4的MAC使用DMA描述符环来收发数据。每个描述符包含状态、控制、缓冲区地址等信息。初始化步骤如下// 定义描述符数量 #define ETH_TXBUFNB 4 #define ETH_RXBUFNB 4 // 描述符结构体 typedef struct { volatile uint32_t Status; uint32_t ControlBufferSize; uint32_t Buffer1Addr; uint32_t Buffer2NextDescAddr; } ETH_DMADescTypeDef; // 分配描述符和缓冲区 ETH_DMADescTypeDef DMARxDscrTab[ETH_RXBUFNB] __attribute__((aligned(4))); ETH_DMADescTypeDef DMATxDscrTab[ETH_TXBUFNB] __attribute__((aligned(4))); uint8_t Rx_Buff[ETH_RXBUFNB][ETH_MAX_PACKET_SIZE] __attribute__((aligned(4))); uint8_t Tx_Buff[ETH_TXBUFNB][ETH_MAX_PACKET_SIZE] __attribute__((aligned(4)));描述符必须4字节对齐缓冲区建议也4字节对齐否则DMA可能出错。我踩过一次坑缓冲区没对齐大部分时候正常但偶尔会收到错帧排查了很久才发现是对齐问题。3.3 中断优先级别让网卡中断被其他中断打断EtherCAT对实时性要求高网卡中断的优先级要设得足够高。我的配置是ETH中断抢占优先级1定时器中断用于周期调度抢占优先级2串口中断调试用抢占优先级3这样网卡中断能及时响应不会被其他中断延迟。注意STM32F4的中断优先级分组要设成NVIC_PRIORITYGROUP_4全部用于抢占优先级。3.4 一个实用的调试技巧用GPIO翻转测时间移植过程中最头疼的是不知道时间花在哪里了。我的做法是在关键位置翻转GPIO用示波器看波形。比如进入网卡中断时拉高GPIO退出时拉低测中断处理时间发送报文前拉高发送完成后拉低测发送耗时主循环开始时拉高结束时拉低测循环周期这个方法比任何软件计时都直观而且不影响实时性。我用它发现了一个问题中断处理时间偶尔会超过50微秒原因是中断里做了浮点运算。把浮点运算移到主循环后中断时间稳定在5微秒以内。4. 网卡驱动的实现从描述符到环形缓冲区4.1 发送函数的完整实现oshw_send函数的实现逻辑如下int oshw_send(void *port, void *data, int length) { // 1. 找到可用的TX描述符 ETH_DMADescTypeDef *txdesc DMATxDscrTab[tx_index]; // 2. 等待描述符空闲OWN位为0 uint32_t timeout 100000; while ((txdesc-Status ETH_DMATXDESC_OWN) timeout--); if (timeout 0) return 0; // 超时 // 3. 拷贝数据到缓冲区 memcpy((void *)txdesc-Buffer1Addr, data, length); // 4. 设置描述符控制位 txdesc-ControlBufferSize length ETH_DMATXDESC_TBS1; txdesc-Status ETH_DMATXDESC_OWN | ETH_DMATXDESC_TCH | ETH_DMATXDESC_IC; // 5. 触发DMA发送 ETH-DMATPDR 0; // 6. 更新索引 tx_index (tx_index 1) % ETH_TXBUFNB; return length; }这里的关键是ETH_DMATXDESC_IC位它表示发送完成后触发中断。如果你不需要发送中断可以去掉这一位减少中断次数。4.2 接收中断的处理越轻量越好接收中断的处理原则是快进快出只做最必要的操作void ETH_IRQHandler(void) { // 1. 检查中断标志 if (ETH-DMASR ETH_DMASR_RS) { // 2. 清除标志 ETH-DMASR ETH_DMASR_RS; // 3. 处理接收到的帧 while (!(DMARxDscrTab[rx_index].Status ETH_DMARXDESC_OWN)) { // 获取帧长度 uint32_t length (DMARxDscrTab[rx_index].Status ETH_DMARXDESC_FL) 16; // 拷贝到环形缓冲区 ringbuf_write(eth_rx_ring, (void *)DMARxDscrTab[rx_index].Buffer1Addr, length); // 释放描述符 DMARxDscrTab[rx_index].Status ETH_DMARXDESC_OWN; ETH-DMARPDR 0; // 更新索引 rx_index (rx_index 1) % ETH_RXBUFNB; } } }环形缓冲区的大小建议至少能存8帧每帧最大1518字节。我用的是16帧的缓冲区约24KB内存STM32F407的192KB RAM完全够用。4.3 接收函数的实现从环形缓冲区取数据oshw_recv函数从环形缓冲区取一帧数据int oshw_recv(void *port, void *buf, int *len) { // 从环形缓冲区读取一帧 int ret ringbuf_read(eth_rx_ring, buf, len); if (ret 0) { *len 0; return 0; } return *len; }注意SOEM调用oshw_recv时期望的是非阻塞返回。如果没有数据返回0即可SOEM会在下一次循环再试。4.4 一个必须处理的细节帧过滤EtherCAT主站需要接收所有EtherCAT帧包括广播帧和特定从站的帧。STM32F4的MAC支持多种过滤模式我建议配置成接收所有广播帧接收目的MAC地址匹配的帧接收EtherCAT以太网类型0x88A4的帧如果过滤配置不对可能会漏收某些帧导致从站扫描失败。我一开始只开了广播过滤结果扫描不到从站后来加上EtherCAT类型过滤才正常。5. 周期任务与DC同步让主站跑起来5.1 主循环的调度逻辑裸机下没有操作系统主循环的调度逻辑要自己写。我的做法是用一个定时器产生1ms的周期中断在中断里设置标志位主循环检测到标志位后执行EtherCAT任务volatile uint8_t ecat_tick 0; void TIM3_IRQHandler(void) { if (TIM3-SR TIM_SR_UIF) { TIM3-SR ~TIM_SR_UIF; ecat_tick 1; } } int main(void) { // 初始化 SystemInit(); ETH_Init(); SOEM_Init(); while (1) { if (ecat_tick) { ecat_tick 0; // 发送过程数据 ecx_send_processdata(ctx); // 接收过程数据 ecx_receive_processdata(ctx, EC_TIMEOUTRET); // 处理从站数据 process_slave_data(ctx); } // 处理非周期任务 handle_non_periodic_tasks(); } }这里的关键是ecx_send_processdata和ecx_receive_processdata的调用时机。发送要在周期开始时立即执行接收要在发送后尽快执行中间不要插入耗时操作。5.2 DC同步的实现从FreeRun到DC如果你的从站支持DC建议先用FreeRun模式跑通再切换到DC模式。FreeRun模式下主站按自己的节奏发送报文从站被动接收。DC模式下主站和从站共享一个时钟同步精度更高。DC同步的核心是计算主站时钟和从站时钟的偏移然后调整主站的发送时刻。SOEM提供了ecx_configdc和ecx_dcsync0等函数来处理DC。在STM32上你需要提供一个高精度的时钟源我用的TIM2的计数器168MHz下分辨率约6纳秒足够DC同步使用。5.3 实测数据1ms周期下的性能我用STM32F407LAN8720控制6个伺服从站实测数据如下指标数值通信周期1ms过程数据长度32字节CPU占用率约40%同步精度±100ns丢包率0连续运行72小时这个性能对于大多数小型设备来说完全够用。如果你需要更短的周期可以优化中断处理或者换用STM32F7/H7系列主频更高性能余量更大。5.4 一个实用的优化减少内存拷贝SOEM在收发过程中会有多次内存拷贝每次拷贝都会消耗CPU时间。我的优化做法是发送时直接把SOEM的缓冲区地址设置到TX描述符避免拷贝接收时如果环形缓冲区足够大可以直接用描述符的缓冲区避免拷贝这个优化能把CPU占用率降低约10%。但要注意直接使用描述符缓冲区时要确保SOEM在处理完数据前描述符不会被复用。6. 踩过的坑与排查过程6.1 从站扫描不到一个MAC地址引发的血案第一次跑通网卡驱动后我迫不及待地调用ecx_config_init扫描从站结果返回0个从站。用Wireshark抓包发现主站发出的广播帧从站收到了但从站的响应帧主站没收到。排查过程检查MAC过滤配置确认广播和EtherCAT类型都开了用示波器看PHY的RX引脚有信号检查RX描述符发现OWN位一直是1说明DMA没把数据搬过来查STM32F4参考手册发现MAC的RX DMA在RMII模式下需要正确配置ETH_DMABMR寄存器的RDP位最后发现是ETH_DMABMR的RDPRx DMA PBL配置成了0导致DMA不工作。改成32后从站扫描正常。6.2 周期通信偶尔丢包中断优先级惹的祸跑通周期通信后发现偶尔会丢一帧概率大概千分之一。用GPIO翻转法测中断响应时间发现偶尔会超过100微秒。排查过程检查所有中断的优先级配置发现串口中断的优先级设得比网卡中断高串口中断里有一个printf耗时较长把串口中断优先级降低printf移到主循环改完后连续运行72小时无丢包。6.3 DC同步不收敛时间戳的精度问题切换到DC模式后发现同步误差在±10微秒左右远达不到亚微秒级。排查过程检查osal_current_time的实现发现用的是TIM2的计数器TIM2是32位168MHz下约25.6秒溢出溢出处理有bug导致时间戳偶尔跳变修复溢出处理用软件计数器记录溢出次数修复后同步误差降到±100纳秒。6.4 一个隐蔽的坑PHY的自动协商LAN8720默认开启自动协商协商过程中PHY会短暂断开连接。如果主站在协商完成前就开始发送EtherCAT报文会丢包。解决方法在初始化PHY后等待自动协商完成读PHY的BSR寄存器等待Link Up位再启动EtherCAT通信。或者直接配置PHY为100M全双工固定模式跳过自动协商。7. 代码组织与工程配置7.1 目录结构建议我的工程目录结构如下project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ ├── stm32f4xx_it.c │ └── ... ├── Drivers/ │ ├── STM32F4xx_HAL_Driver/ │ └── CMSIS/ ├── SOEM/ │ ├── soem/ │ ├── osal/ │ │ └── stm32/ │ └── oshw/ │ └── stm32/ ├── App/ │ ├── eth_driver.c │ ├── ecat_app.c │ └── ringbuf.c └── MDK-ARM/ └── project.uvprojx把SOEM的源码直接放进工程不要编译成库。这样调试时能直接看到源码方便定位问题。7.2 编译配置要点优化等级建议用-O2-O3可能导致某些时序问题浮点运算如果从站数据涉及浮点开启FPU但注意中断里不要用浮点堆栈大小主栈至少4KBSOEM的某些函数递归较深链接脚本确保描述符和缓冲区4字节对齐7.3 一个实用的调试工具SOEM自带的ethercatdbgSOEM自带一个ethercatdbg工具可以打印从站信息、过程数据、DC状态等。在裸机上你可以把它的输出重定向到串口方便调试。我把它精简了一下只保留关键信息通过串口打印不影响实时性。8. 从能跑到好用几个进阶优化方向8.1 用DMA减轻CPU负担STM32F4的MAC自带DMA但SOEM的数据处理还是在CPU里做。如果CPU占用率过高可以考虑用DMA把过程数据直接搬到内存CPU只做必要的处理。这个优化比较复杂需要对SOEM的源码有深入理解。8.2 支持热插拔EtherCAT支持热插拔但从站掉线后重新上线主站需要重新配置。在裸机上实现热插拔需要定期检查从站状态发现掉线后重新扫描。这个功能对于工业现场很实用但会增加代码复杂度。8.3 多主站冗余如果你的应用对可靠性要求极高可以考虑双主站冗余。两个STM32F4主站同时运行一个主站故障时另一个接管。这需要两个主站之间同步状态实现起来有一定难度。8.4 一个我个人的经验不要过度优化移植初期我花了很多时间优化性能想把CPU占用率降到最低。后来发现对于大多数应用40%的CPU占用率完全够用过度优化反而引入了bug。我的建议是先跑通再优化优化要有明确的性能目标不要为了优化而优化。9. 移植完成后的验证清单移植完成后我建议按以下清单逐项验证验证项方法通过标准网卡收发ping测试或抓包能正常收发从站扫描ecx_config_init扫描到所有从站过程数据读写从站IO数据正确周期通信连续运行无丢包DC同步读从站DC状态误差1微秒异常恢复拔插网线能自动恢复长时间运行72小时连续无异常这个清单是我从多个项目中总结出来的每次移植新平台都按这个清单走能覆盖绝大多数问题。10. 一些零散但重要的经验关于PHY的选择LAN8720便宜好用但要注意它的RMII模式需要50MHz时钟。如果你的STM32主频不是168MHz可能需要调整时钟配置。DP83848是另一个选择性能更稳定但价格稍贵。关于PCB布局RMII的时钟线要等长差分线要阻抗匹配。我见过一个项目因为PCB布局问题EtherCAT通信不稳定换了三版板子才解决。如果你的项目对成本不敏感建议用四层板。关于电源PHY的电源要干净建议用LDO单独供电。MAC和PHY的电源要隔离避免数字噪声干扰模拟电路。关于散热STM32F407在168MHz全速运行时发热明显如果环境温度高建议加散热片。我有个项目在密闭机箱里跑夏天偶尔会死机加了散热片后稳定了。关于代码版本管理SOEM的版本更新较快建议锁定一个稳定版本不要频繁升级。我用的是SOEM 1.4.0稳定运行了两年多。关于文档移植过程中遇到的问题和解决方案一定要记录下来。我养成了一个习惯每解决一个问题就在代码注释里写清楚原因和解决方法。这样下次遇到类似问题能快速定位。关于测试不要只测正常情况要测异常情况。比如网线拔掉、从站断电、电源波动等。这些异常情况在实际现场经常遇到提前测过现场就不会慌。关于成本STM32F407LAN8720的方案BOM成本大概在30元左右比带Linux的方案便宜很多。如果你的产量大成本优势更明显。关于开发效率用STM32CubeMX生成初始化代码能省很多时间。但要注意CubeMX生成的MAC初始化代码可能需要调整特别是描述符和缓冲区的配置。关于社区SOEM的社区很活跃遇到问题可以在GitHub上提issue或者查已有的issue。我很多问题都是在社区里找到答案的。关于心态移植协议栈是个细致活不要急。我前后花了大概两周时间才把整个方案跑稳定。中间遇到很多问题但每解决一个对协议栈的理解就深一层。这个过程虽然辛苦但收获很大。
