STM32F103+LAN9252 EtherCAT从站开发实战：SPI模式与XML配置

简介：这份文档面向嵌入式开发工程师与工业以太网学习者，聚焦用STM32F103配合LAN9252构建EtherCAT从站这一典型方案，解决从硬件选型、协议栈移植到TwinCAT联调的完整落地问题。内容围绕LAN9252的四种工作模式展开，重点讲解SPI串口模式的选用理由，并梳理XML设备描述文件生成、SSC工具使用、EEPROM烧录、原理图与PCB设计、协议栈代码移植等关键环节，还给出HW_Init、MainInit、MainLoop的骨架拆解与GPIO、定时器、外部中断的配置要点。资源包仅含1个docx文档，约1.75MB，以图文笔记形式集中呈现项目流程与调试经验。目前已有2921人学习，适合具备一定嵌入式基础、希望快速上手EtherCAT从站开发的读者参考，可据此理解主从通信流程、少走移植弯路。

1. 从一块买来的学习板说起：STM32F103 加 LAN9252 怎么把 EtherCAT 从站跑起来

手上拿到一份《STM32 与 LAN9252 的连接》文档，外加一块从网上淘来的 EtherCAT 学习板，第一反应往往不是兴奋，而是懵：协议栈几万行、XML 好几兆、TwinCAT 里点来点去，到底从哪下手。这个项目的目标其实很朴素——用 STM32F103 加 LAN9252 做一个 EtherCAT 从站，周期交互 64 路输入、64 路输出，主站是一台装 TwinCAT2.0 的 ARM 架构工控 PC，从站做成一块键盘加 LED 的 IO 面板，跟主站 PLC 对通。适合谁？适合已经会点 STM32、想第一次把工业以太网从站真正跑通的嵌入式开发者，也适合手上有个从站需求、需要评估 LAN9252 这颗 PHY 方案的人。它不教你写操作系统，也不讲电机控制，就是把「协议栈怎么塞进 MCU、XML 怎么配、SPI 怎么对接」这条链路走一遍。

2. 方案选型与整体架构：LAN9252 到底替 MCU 扛了哪些活

2.1 四种工作模式里为什么选 SPI

LAN9252 这颗芯片在方案里的定位，决定了后面所有代码的写法。按芯片手册，它一共有四种工作模式：数字 IO 模式（8 入 8 出，芯片自己当简易从站）、SPI 串口模式（4 线串行，或升级到 SQI 六线高速）、并行通信模式 HBI（16/8 位数据总线）、扩展模式（MCU 走 SPI，同时对外再给一组 MII 接另一颗 PHY，多挂一个 RJ45）。这个项目选 SPI，理由很实际：STM32F103 的引脚和总线资源有限，并行 HBI 要占掉十几个 IO，划不来；数字 IO 模式又太死，只有 8 进 8 出，满足不了 64+64 的需求；扩展模式是给需要三个网口或者特殊拓扑的场景准备的，这里用不上。SPI 四根线（SCK、MISO、MOSI、CS）就能把数据通道打通，标准模式时钟最高 30MHz，切到高速 SPI 能到 80MHz，对 64+64 字节级别的周期数据完全够用。

这里有个容易被忽略的点：LAN9252 不是简单的 PHY。它在整个体系里同时干三件事。第一是 PHY，所有跟 RJ45 打交道的电气层、编码解码都归它；第二是网络交换，EtherCAT 要求从站具备一拖一的能力，不能终结总线，LAN9252 的 2 端口/3 端口模式在芯片内部就做了交换，数据从入口进来、从出口出去，同时抄一份给自己；第三是数据解析加 SPI 从机，MCU 作为 SPI 主模式去读它内部的寄存器和过程数据区，这个交互流程在协议栈里封装得很深，一开始读不懂是正常的，别硬啃。

2.2 协议栈骨架：三个函数撑起整个从站

整个 EtherCAT 从站协议栈看起来像天书，但入口极其干净。从main()进去，剥掉初始化，骨架就是三个东西：

int main(void) { /* CubeMX 生成的 HAL 初始化、时钟、GPIO、SPI、定时器 */ HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_SPI1_Init(); MX_TIM2_Init(); /* 协议栈硬件抽象层初始化：SPI 读写函数、EEPROM 访问等 */ HW_Init(); /* 协议栈内部状态机、对象字典、邮箱初始化 */ MainInit(); while (1) { /* 协议栈主循环：处理状态机迁移、邮箱通信、过程数据刷新 */ MainLoop(); } }

HW_Init()是硬件适配层，协议栈通过它去调用你写的 SPI 读写、EEPROM 读写；MainInit()把从站状态机、对象字典、邮箱缓冲全部置到初始态；MainLoop()是个永不返回的循环，EtherCAT 的状态迁移（INIT → PREOP → SAFEOP → OP）、邮箱收发、看门狗喂狗都在里面推进。移植的本质，就是把这三个函数依赖的底层接口，用 STM32 的 HAL 实现一遍。理解这一点，后面看几千行协议栈代码就不会慌——你不需要读懂它，只需要喂饱它。

2.3 硬件资源清单与中断分工

MCU 侧要准备的外设不多，但每一个都不能配错：

中断优先级建议 2 bit 抢先、2 bit 响应：ECAT_CheckTimer和PDI_Isr配 1 抢先 0 响应，Sync0_Isr、Sync1_Isr配 2 抢先 0 响应。这个分配不是玄学，是保证主中断和定时器不被同步中断打断，同时同步中断之间能互相抢占。中断服务函数里干的事很薄，就是把活转交给协议栈：

void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if (GPIO_Pin == LAN9252_IRQ_Pin) { PDI_Isr(); /* EtherCAT 主中断：处理 AL 事件、邮箱、过程数据 */ return; } if (GPIO_Pin == LAN9252_SYC0_Pin) { DISABLE_ESC_INT(); /* 进同步中断前先关 ESC 中断，防止嵌套 */ Sync0_Isr(); ENABLE_ESC_INT(); return; } if (GPIO_Pin == LAN9252_SYC1_Pin) { DISABLE_ESC_INT(); Sync1_Isr(); ENABLE_ESC_INT(); return; } }

DISABLE_ESC_INT()/ENABLE_ESC_INT()这对宏是协议栈提供的，作用是同步中断执行期间屏蔽 ESC 主中断，避免两个中断互相踩状态。这个细节文档里写了，但很多人移植时会漏，漏了之后表现就是偶发丢帧、状态机莫名回退。

3. 从 XML 到 EEPROM：SSC 生成配置文件的完整链路

3.1 用 SSC 建工程并填 Excel 定义 IO 点位

XML 是这个项目里最容易被低估的部分。它是对从站设备的完整描述，作用类似 Profinet 的 GSD 文件，TwinCAT 靠它识别设备、组态、把关键特征烧进 LAN9252 挂的 EEPROM。手写几兆的 XML 不现实，正确姿势是用 SSC（Slave Stack Code Tool）。打开 SSC，File → New，模板别选默认的，选 Custom 下拉里的EL9800 | 8Bit Digital I/O, 16Bit Analog Input，这个模板就是给 SPI 从站准备的，设备描述指向SlaveStackCode.xml，跟我们的场景对得上。

建完工程，Tool → Application → Create New，先存盘，然后会弹出一个 Excel。这份 Excel 就是 IO 点位的定义表，//0x6nnx段是输入、//0x7nnx段是输出，按 64 入 64 出把条目批量拖出来填好，最后把Maximum number of modules改成 3。保存 Excel 后 SSC 会自动弹导入对话框，点 OK 导入，再走 Project → Create new Slave Files，协议栈源码和 XML 就一起生成了。这一步的性价比极高——64+64 个 Entry 如果手工录进 XML，工作量恐怖且极易出错，SSC 几秒钟搞定。

3.2 XML 里真正要动手改的三处

生成的 XML 大部分不用碰，但有三处必须改。第一处是设备基础信息：Vendor下的id和name来自 EtherCAT 会员企业信息，Descriptions → Devices → Device → Type下的ProductCode和RevisionNo是 TwinCAT 识别设备唯一性的依据，两份 XML 这两个字段一样，放同一目录下只会认一个，产品迭代时版本号记得跟着升。第二处是Physics节点，YY表示两个 RJ45 一进一出，别改成K（那是倍福专用 EBUS 口）。第三处也是最关键的，ConfigData这 14 个字节。

SSC 默认按 ET1100 生成，值是050E03440A0000000000这类；换成 LAN9252 后，按芯片迁移手册改成800E00CC8813F0000000800000。第一个字节80直接对应 LAN9252 的0140h寄存器（Process Data Interface），配成80h就是 SPI 模式，跟我们选的架构严丝合缝。后面那些字节分别管中断极性、EEPROM 大小、PDI 时序等，暂时不理解就保持手册默认值，别自作主张改。这 14 字节最终会被 TwinCAT 烧进 EEPROM，LAN9252 每次上电靠它给自己配工作方式——换句话说，XML 写错，芯片上电就配错，后面代码再对也连不上。

3.3 EEPROM 选型与烧录路径

XML 里EEPROM节点的ByteSize一般写 2048，但物理芯片建议直接上 512Kbit 的 24FC512。原因很实在：IO 点位以后要扩，XML 会变大，2KByte 的片子很快就塞不下；而且文档里明确提了一句，EEPROM 尽量用 ATMEL 家的 24FC512，换别的型号有概率出现连接困难，这种硬件层的玄学，踩过一次就记住了。烧录路径是：XML 放进 TwinCAT 安装目录的/Io/EtherCAT下，TwinCAT 扫描到设备后把配置写进 EEPROM，之后设备独立上电也能自配置。

4. STM32 侧 SPI 适配：把 HAL 接口接到协议栈的期望函数上

4.1 CubeMX 配置要点与生成代码的坑

CubeMX 里新建 STM32F103ZExx 工程，配 SPI1 为 4 线全双工主模式，先按较低分频跑通再提速；配一个 1ms 定时器；配三个 GPIO 外部中断。NVIC 这里有个反直觉的操作：CubeMX 里三个外部中断和定时器中断都勾上 enable，生成代码友好，但生成完之后必须去gpio.c、tim.c的初始化函数末尾，把最后那行使能语句注释掉。原因在文档里说得很直白——什么时候开中断、什么时候关中断，必须由协议栈的状态机决定，一上电就开外部中断，基本连不上。这是移植阶段最高频的翻车点，没有之一。

SPI 本身不需要配中断。SPI 的时序是读的同时写、写的同时读，读写不分离，用阻塞式或 DMA 都行，中断反而添乱。生成工程后先编译一遍，确认零警告零错误，再开始往里塞协议栈。

4.2 封装协议栈要的 SPI 读写函数

协议栈不关心你用的是 HAL 还是寄存器，它只认几个固定名字的函数。常见做法是在HW_Init()所在的文件里，把 SPI 收发封装成协议栈期望的接口：

/* LAN9252 寄存器读：先发命令字，再读数据，CS 全程拉低 */ uint8_t HW_EepromRead / SPI_ReadReg(...) 之类的适配函数 { uint8_t tx[4], rx[4]; /* 命令字：地址 + 读标志，具体位定义查 LAN9252 手册 12 章 */ tx[0] = CMD_READ; tx[1] = (addr >> 8) & 0xFF; tx[2] = addr & 0xFF; HAL_GPIO_WritePin(SPI_CS_PORT, SPI_CS_PIN, GPIO_PIN_RESET); HAL_SPI_TransmitReceive(&hspi1, tx, rx, 3, 100); /* 发命令同时收无效字节 */ HAL_SPI_TransmitReceive(&hspi1, tx, rx, 1, 100); /* 再收一个有效数据字节 */ HAL_GPIO_WritePin(SPI_CS_PORT, SPI_CS_PIN, GPIO_PIN_SET); return rx[0]; }

这段代码的逻辑是：LAN9252 的 SPI 协议是「命令 + 数据」两段式，CS 必须在整个事务期间保持低电平，中间不能抬起来，否则芯片会把事务截断。HAL_SPI_TransmitReceive一次调用同时完成发和收，正好匹配 SPI 全双工特性。参数上，超时给 100ms 足够，实际单次事务微秒级；地址是 16 位，分高低字节发。写寄存器同理，只是命令字换成写标志、数据段换成待写值。EEPROM 读写如果挂在 LAN9252 侧，也走类似的 SPI 间接访问，具体命令字查手册 EEPROM 章节。

4.3 中断使能入口交给协议栈

前面注释掉的使能语句，不是删掉，而是挪到协议栈回调里。协议栈在状态机迁移到合适阶段时，会调用你提供的ENABLE_ESC_INT()、定时器启停这类钩子，你在钩子里再调HAL_NVIC_EnableIRQ()或HAL_TIM_Base_Start_IT()。这样上电顺序就是：协议栈初始化完成 → 状态机进入可通信态 → 才打开中断 → 开始收 PDI 事件。顺序反了，中断在协议栈没准备好时就进来，PDI_Isr()访问未初始化的结构体，轻则丢事件，重则 HardFault。这套「谁初始化谁使能」的约定，是 EtherCAT 从站移植的通用规矩，不只是这个项目。

5. 避坑与排查：连不上主站时先看这几条

5.1 上电就使能中断导致连接失败

现象：TwinCAT 扫描不到设备，或者扫到但状态卡在 INIT 上不去。原因：CubeMX 生成的代码里外部中断和定时器中断默认使能，协议栈还没初始化完中断就进来了。解决：把gpio.c、tim.c初始化函数末尾的HAL_NVIC_EnableIRQ和HAL_TIM_Base_Start_IT注释掉，改由协议栈的使能钩子调用。这条是文档反复强调的，也是新手最容易忽略的。

5.2 ConfigData 没改成 LAN9252 的值

现象：设备能扫到，但 PDI 不工作，SPI 读回全 0 或全 FF。原因：SSC 默认按 ET1100 生成ConfigData，第一个字节不是80，LAN9252 上电后没配成 SPI 模式。解决：按迁移手册把 14 字节改成800E00CC8813F0000000800000，重新烧 EEPROM。改完用示波器看 SPI 线上有没有波形，有波形说明 PDI 通了。

5.3 EEPROM 型号不对导致偶发连接困难

现象：大部分时候能连，偶尔扫描失败，重启几次又好了。原因：换用了非 24FC512 的 EEPROM，上电时序或页写特性不匹配。解决：老老实实换回 24FC512，别在这颗几毛钱的芯片上省。文档里那句「尽量使用 ATMEL 家的 24FC512」不是广告，是血泪经验。

5.4 SPI 时钟一上来就拉满

现象：低速能通，提速后数据错位、CRC 报错。原因：PCB 走线长、LAN9252 侧时序余量不够，直接上 30MHz 甚至 80MHz 高速模式。解决：先在几 MHz 下把整条链路跑通，确认状态机能到 OP，再逐级提频；提频后如果出错，查 CS 到 SCK 的建立保持时间，必要时加串阻或缩短走线。

5.5 同步中断里没关 ESC 主中断

现象：启用分布式时钟后，运行一段时间偶发状态回退或数据跳变。原因：Sync0_Isr/Sync1_Isr执行期间被PDI_Isr打断，两边同时改 ESC 状态。解决：按文档在同步中断前后加DISABLE_ESC_INT()/ENABLE_ESC_INT()，把临界区保护起来。

6. 二次开发：把 64+64 的 IO 面板改成你自己的从站

跑通之后，真正的工作才开始——把这个键盘 LED 面板改成你项目要的从站。改造路径我一般分三步走。第一步改 IO 定义：回到 SSC 那份 Excel，把//0x6nnx、0x7nnx的条目按新需求重填，比如加模拟量、改点位数量，重新生成 XML 和协议栈文件，ConfigData那 14 字节记得再核对一遍没被覆盖。第二步改对象字典映射：SSC 生成的SSC-DeviceObjects.h里，每个对象跟 XML 的Profile → Objects一一对应，你要加自定义对象（比如设备序列号、标定参数），在这里加结构体定义，再在 XML 的DataType/Objects节点补描述，两边必须同步，否则 TwinCAT 组态时找不到对象。第三步改应用层：过程数据的输入输出最终落在协议栈的 PDO 缓冲上，你的业务代码在MainLoop()前后读写这块缓冲即可，别去动协议栈内部状态机。

验证方法上，我习惯用 TwinCAT 的在线值监控先看 PDO 映射对不对，再用一个最小 PLC 程序周期性写输出、读输入，确认 64 路每一位都能独立翻转。有个具体技巧：改完 XML 后，把ProductCode或RevisionNo升一位，强制 TwinCAT 重新识别设备，避免它拿旧缓存组态，这个坑我吃过一次，查了半天以为是代码问题，其实是主站用了旧描述。

还有一点值得说：SSC 生成的协议栈代码不能直接编译进你的工程，它依赖一堆它自己的硬件抽象，正确做法是把对象字典相关的.c/.h摘出来参考移植，SPI、定时器、中断这些底层自己用 HAL 重写。别想着整包塞进去，塞进去也是一堆链接错误。从那以后我每次移植新板子，都强制先只跑HW_Init+MainInit+ 空MainLoop，确认 SPI 能读到 LAN9252 的 ID 寄存器，再往上叠功能，一层一层验证，比一次性全接上再 debug 省太多时间。希望帮到你。

本文还有配套的精品资源，点击获取