1. 项目概述为什么动XML就能改PDO1.1 AX58100从站开发到底在做什么做AX58100从站开发的人早晚都会撞上这个需求主站能扫描到设备过程数据却对不上查到最后十有八九是XML文件里的PDO映射和STM32固件没对齐。这篇文章我就把修改XML配置PDO映射的完整流程捋一遍连同STM32端的收发代码一起讲清楚给刚接触EtherCAT从站的工程师一条能直接照着走的路线。先交代背景。AX58100是ASIX推出的一款两端口EtherCAT从站控制器ESC芯片内部集成了两个百兆PHY和一套完整的EtherCAT协议处理引擎外部只需要挂一颗MCU做应用层控制就行。和常见的LAN9252相比AX58100在国内的生态更偏买芯片送SDK这一路很多国产伺服、I/O模块、步进驱动器都在用。MCU这边STM32几乎是标配便宜、资料多、工程师熟悉拿着标准SPI接口就能和AX58100通信。这个项目要解决的核心问题很简单让从站按我们需要的格式收发过程数据。从站不是只管把数据一股脑传上来就完事主站必须知道哪几个字节是控制字、哪几个字节是目标位置才能正确组帧、配置FMMU、建立过程数据映像。这些信息不是写在STM32的代码里而是写在ESIEtherCAT Slave InformationXML文件里。所以每次改过程数据第一步不是打开Keil而是打开XML。1.2 PDO映射和XML是什么关系PDO映射全称Process Data Object Mapping描述的是从站要收哪些对象、要发哪些对象、每个对象占多少位、按什么顺序排。比如一个伺服轴的RxPDO可能是这样的先2字节控制字再4字节目标位置再1字节运行模式。主站拿到这个顺序就会把过程数据帧里的数据按这个布局填进去ESC芯片再按同步管理器SM的配置把收到的数据放到DPRAM的固定地址STM32最后从这些地址读出来。整个链路可以拿小区快递柜做类比主站是快递分拣中心AX58100是楼下的快递柜STM32是你本人。XML不是快递单而是快递柜上贴的柜格说明哪个格子能放多大东西SM长度哪个格子对应什么内容RxPDO条目。主站发货之前先看这张说明来装箱AX58100按柜格编号把东西放进对应格子STM32只要知道目标位置在0x1100这个格子就能稳定取件。如果你改了柜格说明但固件忘了自己录的格子位置自然什么都取不到。所以修改XML配置PDO映射这件事本质上是在跟主站对暗号。XML里写的每一个Entry、每一个BitLen、每一个SM地址最终都要和ESC寄存器、DPRAM布局、STM32结构体三者完全一致数据链路才通。理解了这层关系后面所有操作都不会盲目。2. ESI/XML文件结构逐层拆解2.1 ESI文件是主站认识从站的身份证ESI文件不是普通的配置文件它是主站识别、配置从站的第一手资料。EtherCAT主站不管是TwinCAT、SOEM还是CODESYS扫描到从站之后第一步就是根据从站上报的Vendor ID和Product Code到本地的ESI库里找对应的XML文件然后用里面的定义去初始化SM、FMMU、邮箱和过程数据。在TwinCAT里ESI文件默认放在C:\TwinCAT\3.1\Config\Io\EtherCAT这个目录改完XML放到这里重新扫描才生效。这里有个新手最常见的坑文件名、Vendor ID、Product Code三者只要有一个对不上主站就会提示Device not found或者直接当成未知设备处理。另外XML文件描述的是这台从站长什么样它不代表固件里的真实实现。如果XML写的是一套、固件跑的是另一套主站照样会按XML来配置最后表现出来就是数据错乱或者状态切不过去。所以从项目第一天起XML就必须跟固件当成同一个模块来管理改任何一个都要一起评审、一起发版。2.2 必须看懂的5个关键节点拿到一个AX58100的ESI模板第一眼会被一堆节点吓到但其实核心就五个Vendor、Device Info、Dictionary、RxPdo/TxPdo、Sm。整体结构大致是?xml version1.0 encodingUTF-8? EtherCATInfo xmlnshttp://www.ethercat.org/ns/ESI Vendor Id#x00000ABC/Id NameDemo Motion/Name /Vendor Descriptions Devices Device Info TypeAX58100-Servo/Type NameAX58100 Servo/Name /Info Profile ProcessData !-- RxPdo / TxPdo 在这里 -- /ProcessData /Profile Dictionary !-- 对象字典在这里 -- /Dictionary Sm !-- SM0~SM3在这里 -- /Sm /Device /Devices /Descriptions /EtherCATInfo各个节点的作用我整理成了一张表排查问题的时候先对着这张表定位节点作用和固件对不上会怎样Vendor / Info厂商ID、产品编码、设备名主站凭这个匹配XML扫描不到或识别成Unknown DeviceDictionary对象字典SDO对象、PDO条目定义主站解析PDO时报错SDO访问不到对象RxPdo / TxPdo过程数据映射条目、顺序、位宽过程数据布局错位数据全部错乱Sm同步管理器物理地址、长度、类型、控制字报文收发地址错乱状态机卡住Mailbox邮箱的起始地址和长度通常SM0/SM1进不了PREOPSDO/CoE无法工作这几个节点是互相咬合的。RxPdo里每条Entry的Index必须能在Dictionary里找到同Index的Object定义Sm里的StartAddress必须落在DPRAM范围内而且SM2的长度不能小于RxPdo所有Entry的BitLen之和按字节对齐后的值。改一个不动另一个主站配置阶段就会立刻报错。3. 手把手修改XML配置PDO映射3.1 先把PDO映射这账算清楚动手改之前建议先把目标映射画出来。以最常见的一个伺服轴加数字量输入输出场景为例我这次要配成下面这样RxPDO主站发给从站8字节0x6040 Controlword16位控制字0x607A Target position32位目标位置0x6060 Modes of operation8位运行模式TxPDO从站发给主站8字节0x6041 Statusword16位状态字0x6064 Position actual value32位实际位置0x6061 Modes of operation display8位当前模式显示算一下BitLenRxPDO一共1632856位EtherCAT的PDO是逐条顺序排列的从bit0开始排不预留空隙但最后一个条目排完之后要补齐到整字节。56位补到64位也就是8字节。TxPDO同理也是8字节。这一步一定要先算清楚后面SM长度、STM32结构体直接照这个来。这里有一个容易忽略的点EtherCAT的PDO条目虽然在XML里不写起始位但顺序就是位顺序你不能在中途插入一个8位对象再指望32位对象自动对齐到32位边界。很多从站开发新手在这里栽跟头以为主站会像C语言结构体一样自动做对齐实际上主站完全按顺序排不做任何对齐。解决这种问题的唯一办法就是在纸上先把位分配画出来再落到XML和代码里。3.2 实际操作从备份到落地第一步备份原始XML。这是老生常谈但真的重要特别是厂家给的是带大量默认对象的模板手一抖删错一个节点可能整个文件就解析失败了。我习惯直接把这个文件丢进git管起来每次修改都留diff记录后续排查版本问题会省很多事。第二步用编辑器打开XML。推荐用VSCode或者Notepad别用记事本直接改。记事本默认编码和缩进都可能给你搞出问题。文件编码务必保持UTF-8无BOM有些主站解析器对BOM非常敏感会直接拒绝加载界面上却只显示一句含糊的ESI file invalid。提示XML里Index写法有0x和#x两种风格保持和模板原来的一致就好但整个文件里不要混用某些解析器对格式混用很敏感。第三步找到Profile下面的ProcessData节点把RxPdo改成这样RxPdo Fixedtrue Index0x1600/Index NameServo RxPDO/Name Entry Index0x6040/Index SubIndex0x00/SubIndex BitLen16/BitLen NameControlword/Name DataTypeUINT/DataType /Entry Entry Index0x607A/Index SubIndex0x00/SubIndex BitLen32/BitLen NameTarget position/Name DataTypeUDINT/DataType /Entry Entry Index0x6060/Index SubIndex0x00/SubIndex BitLen8/BitLen NameModes of operation/Name DataTypeUSINT/DataType /Entry /RxPdoFixedtrue表示这是一组固定PDO主站不能在线修改。如果你希望主站能动态调整映射这里就改成Fixedfalse但那样必须额外实现CoE的PDO assign功能复杂度会高不少项目初期不建议这么干。TxPdo类似改成TxPdo Fixedtrue Index0x1A00/Index NameServo TxPDO/Name Entry Index0x6041/Index SubIndex0x00/SubIndex BitLen16/BitLen NameStatusword/Name DataTypeUINT/DataType /Entry Entry Index0x6064/Index SubIndex0x00/SubIndex BitLen32/BitLen NamePosition actual value/Name DataTypeUDINT/DataType /Entry Entry Index0x6061/Index SubIndex0x00/SubIndex BitLen8/BitLen NameModes of operation display/Name DataTypeUSINT/DataType /Entry /TxPdo第四步检查Dictionary里面有没有对应对象。对象字典是PDO条目的户口本0x6040、0x607A这些对象必须已经在Dictionary中有定义。如果模板里没有需要补上以0x6040为例Object Index0x6040/Index NameControlword/Name TypeVAR/Type BitSize16/BitSize SubObjects SubObject SubIndex0x00/SubIndex NameControlword/Name BitSize16/BitSize DataTypeUINT/DataType Accessrw/Access /SubObject /SubObjects /ObjectBitSize这一栏必须和RxPdo里的BitLen一致主站校验的时候会拿这两处做比对。不一致的错误提示往往很含糊像PDO length mismatch排查半天才发现是Dictionary里写错了。还有一类对象容易被忽略CoE的PDO分配对象0x1C12和0x1C13。如果从站支持CoE主站在PREOP阶段会去读这两个对象看看有哪些PDO被默认分配。0x1C12对应RxPDO分配子索引1写0x16000x1C13对应TxPDO分配子索引1写0x1A00。你要是改了PDO的Index而这两个分配对象没同步主站可能还是会按旧的PDO配置走。第五步改Sm节点。这是整个配置里最物理的一环它决定数据到底落在DPRAM的哪个地址。我这次用的布局是Sm Index0/Index NameMailbox Out/Name TypeMailbox/Type StartAddress0x1000/StartAddress ControlByte0x26/ControlByte DefaultSize128/DefaultSize /Sm Sm Index1/Index NameMailbox In/Name TypeMailbox/Type StartAddress0x1080/StartAddress ControlByte0x26/ControlByte DefaultSize128/DefaultSize /Sm Sm Index2/Index NameProcess Data Out/Name TypeProcessData/Type StartAddress0x1100/StartAddress ControlByte0x34/ControlByte DefaultSize8/DefaultSize /Sm Sm Index3/Index NameProcess Data In/Name TypeProcessData/Type StartAddress0x1108/StartAddress ControlByte0x34/ControlByte DefaultSize8/DefaultSize /Sm这里几个值的含义要讲清楚。SM0和SM1是邮箱通道分别对应主站发给从站和从站发给主站的CoE报文地址0x1000和0x1080各占128字节。SM2是过程数据输出通道主站到从站起始地址0x1100长度8字节正好等于RxPDO对齐后的长度SM3是过程数据输入通道从站到主站起始0x1108也是8字节。ControlByte沿用厂家模板的值就行mailbox类型一般是0x26process data类型一般是0x34不要自己乱改。3.3 改完之后的验证XML改完先别急着上机先在PC端做三层检查。第一层确认XML是well-formed。直接用浏览器打开这个XML如果浏览器能正常渲染成树状结构基本语法没问题。或者用VSCode装个XML插件做语法校验。这一步能过滤掉90%的复制粘贴错误。第二层把XML放进TwinCAT的ESI目录然后让主站重新扫描。注意TwinCAT对ESI有缓存放进去之后需要右键EtherCAT设备选择重新扫描或者干脆重启一下TwinCAT系统服务。扫描到之后双击从站打开Process Data选项卡如果列表里出现的是你刚添加的Controlword、Target position、Modes of operation说明解析正常。第三层上电后用Wireshark抓包验证。EtherCAT帧在数据链路层上用Wireshark加EtherCAT解析插件可以看到主站下发的FMMU配置和SM配置。对照XML里的SM地址确认主站把0x1100和0x1108写进了从站的SM寄存器。有一个非常实用的小技巧TwinCAT的从站在线窗口里能看到SM寄存器的实时值。如果你怀疑XML没生效直接把0x0800附近的SM寄存器原始值展开看看StartAddress是不是0x1100长度是不是8。如果还是旧值那就是ESI没刷新不是XML的问题。4. STM32端代码实现与联调4.1 硬件接线与SPI初始化AX58100和STM32之间用的是SPI从机接口接线相当标准。以STM32F407和SPI1为例STM32引脚AX58100引脚说明PA5 / SPI1_SCKSCLKSPI时钟速度按芯片手册来PA6 / SPI1_MISOMISO从站输出数据PA7 / SPI1_MOSIMOSI主站输出数据PA4 / GPIOCS片选低电平有效PA8 / GPIOIRQ从站事件中断可选NRST / GPIORESETn复位控制建议用GPIO控制AX58100的SPI从机模式是靠上电时PDI配置引脚的状态来锁定的板子画板时就要把对应的配置引脚拉好。SPI速率我一般起步用10MHz跑通之后再考虑往上提一上来就上20MHz结果数据乱码的概率不低尤其是用杜邦线飞线调试的时候。SPI模式CPOL/CPHA要看芯片手册和PDI配置常见的是模式0但稳妥做法是上电后读一下PDI配置寄存器0x0150确认。初始化代码用STM32CubeMX生成就行关键是把SPI配成主机全双工数据帧格式8位MSB先行。CS引脚必须用软件控制不能让SPI硬件自动拉CS因为AX58100的SPI命令格式里没有标准的寄存器地址自动增加机制需要你自己控制片选完成每一次完整事务。4.2 寄存器读写和状态机切换先给最基本的寄存器读写函数。AX58100的SPI命令格式大致是第一个字节包含读写标志和地址高6位第二个字节是地址低8位后面才是数据字节。不同版本的数据手册和SDK里命令字的具体位定义略有差异我见过用0x40表示读、0x00表示写的也见过用bit7区分读写的。所以下面代码里我把两个宏单独列出来拿到官方SDK后先做一次对比确认再往下走#define ESC_CMD_READ 0x40 // 读命令实际以你的SDK为准 #define ESC_CMD_WRITE 0x00 // 写命令实际以你的SDK为准读寄存器uint8_t ESC_ReadReg8(uint16_t addr) { uint8_t tx[3]; uint8_t rx[3] {0}; tx[0] (uint8_t)(ESC_CMD_READ | ((addr 8) 0x3F)); tx[1] (uint8_t)(addr 0xFF); tx[2] 0x00; ESC_CS_LOW(); HAL_SPI_TransmitReceive(hspi1, tx, rx, 3, HAL_MAX_DELAY); ESC_CS_HIGH(); return rx[2]; } uint16_t ESC_ReadReg16(uint16_t addr) { uint8_t tx[4]; uint8_t rx[4] {0}; tx[0] (uint8_t)(ESC_CMD_READ | ((addr 8) 0x3F)); tx[1] (uint8_t)(addr 0xFF); tx[2] 0x00; tx[3] 0x00; ESC_CS_LOW(); HAL_SPI_TransmitReceive(hspi1, tx, rx, 4, HAL_MAX_DELAY); ESC_CS_HIGH(); return (uint16_t)((rx[2] 8) | rx[3]); }写寄存器类似只是把命令字换成写命令后面的字节换成要写的数据。写之前如果碰到0x0920的写保护寄存器需要先把写保护关掉否则寄存器写不进去。这个0x0920是ESC Write Protection默认状态可能是禁止写的代码里要先写0x00解除保护。注意0x0920写保护不解除所有寄存器写操作都会静默失败调试时最容易漏也是明明写了却没生效的高发原因。从站状态机是EtherCAT很核心的一个概念。主站要让从站在INIT、PREOP、SAFEOP、OP四个状态之间切换靠的是写AL Control寄存器0x0120从站当前状态和错误指示在AL Status寄存器0x0130。应用层可以不参与状态切换过程但你必须会读状态因为在OP之前做任何过程数据读写都是没有意义的。状态判断代码uint16_t al_status ESC_ReadReg16(0x0130); switch (al_status 0x0F) { case 0x01: // INIT break; case 0x02: // PREOP break; case 0x04: // SAFEOP break; case 0x08: // OP // 只有这里才允许过程数据读写 break; default: break; }特别注意al_status的高位bit4到bit6是错误指示比如bit5置位表示从站有应用层错误。要是状态卡着不进OP先把高位的值记录下来对照芯片手册看是什么错误。4.3 PDO数据收发核心代码现在到了最关键的部分把XML里定义的PDO映射翻译成STM32能读写的结构体。我的做法是直接照着XML的Entry顺序定义一个打包结构体并且一定要显式packed#pragma pack(push, 1) typedef struct { uint16_t controlword; // 0x6040:00 Controlword int32_t target_position; // 0x607A:00 Target position uint8_t modes_of_operation; // 0x6060:00 Modes of operation uint8_t pad; // 对齐占位对应PDO最后的补齐位 } RxPDO_t; typedef struct { uint16_t statusword; // 0x6041:00 Statusword int32_t actual_position; // 0x6064:00 Position actual value uint8_t modes_of_operation_display; // 0x6061:00 Modes of operation display uint8_t pad; } TxPDO_t; #pragma pack(pop) static RxPDO_t g_rx_pdo; static TxPDO_t g_tx_pdo;结构体成员顺序必须和XML里的Entry顺序一致不能因为C语言里int32_t会自动对齐到4字节边界就偷懒。上面这个结构体加了pack(1)确保target_position从第2字节开始modes_of_operation在第6字节pad在第7字节总共8字节和XML里的64位完全吻合。如果不加pack编译器会在controlword后面塞2字节填充整个映射全乱。过程数据交换函数void ProcessData_Exchange(void) { // 从SM2起始地址读取主站下发的RxPDO ESC_ReadDPRAM(SM2_PDATA_START, (uint8_t *)g_rx_pdo, RX_PDO_SIZE); // 这里放应用逻辑比如根据controlword更新状态字 g_tx_pdo.statusword 0x0231; g_tx_pdo.actual_position g_motor_position; g_tx_pdo.modes_of_operation_display g_rx_pdo.modes_of_operation; // 把TxPDO写到SM3起始地址 ESC_WriteDPRAM(SM3_PDATA_START, (uint8_t *)g_tx_pdo, TX_PDO_SIZE); }对应的DPRAM块读写函数本质就是寄存器读写的批量版CS拉低后连续传N个字节void ESC_ReadDPRAM(uint16_t addr, uint8_t *buf, uint16_t len) { uint8_t tx[2]; tx[0] (uint8_t)(ESC_CMD_READ | ((addr 8) 0x3F)); tx[1] (uint8_t)(addr 0xFF); ESC_CS_LOW(); HAL_SPI_Transmit(hspi1, tx, 2, HAL_MAX_DELAY); HAL_SPI_Receive(hspi1, buf, len, HAL_MAX_DELAY); ESC_CS_HIGH(); } void ESC_WriteDPRAM(uint16_t addr, uint8_t *buf, uint16_t len) { uint8_t tx[2]; tx[0] (uint8_t)(ESC_CMD_WRITE | ((addr 8) 0x3F)); tx[1] (uint8_t)(addr 0xFF); ESC_CS_LOW(); HAL_SPI_Transmit(hspi1, tx, 2, HAL_MAX_DELAY); HAL_SPI_Transmit(hspi1, buf, len, HAL_MAX_DELAY); ESC_CS_HIGH(); }SM2_PDATA_START和SM3_PDATA_START这两个宏必须和XML里Sm节点的StartAddress一致。我这次是0x1100和0x1108你在自己项目里改XML的时候这两个值要同步改这是从站开发里最容易出bug的一处也是整个项目里我最想强调的配置一致性。主循环里最简单的做法是轮询while (1) { uint16_t al_status ESC_ReadReg16(0x0130); if ((al_status 0x0F) 0x08) { ProcessData_Exchange(); } else if ((al_status 0x0F) 0x04) { // SAFEOP模式下可以读取RxPDO但不能写TxPDO的下发数据 ESC_ReadDPRAM(SM2_PDATA_START, (uint8_t *)g_rx_pdo, RX_PDO_SIZE); } // 其他任务比如SDO处理、故障检测等 }这个轮询版本能跑通整个链路但不适合要求抖动控制的运动控制场景。真要做伺服类产品建议把AX58100的SYNC0或SYNC1接到STM32的外部中断由EtherCAT同步信号触发周期任务抖动会小一个数量级。项目初期先把轮询版本调通再做同步优化风险最小。还有一个坑必须讲AX58100内部有PDI看门狗对应寄存器是0x0410。它的逻辑是如果应用处理器长时间不去访问DPRAM中的过程数据芯片会认为应用已经死掉自动把输出清零并跳回安全状态。所以你的主循环里必须周期性地执行ProcessData_Exchange哪怕数据还没准备好也要先读一下、写一下把心跳续上。默认看门狗时间一般有几百毫秒但实际项目里我会把过程数据周期压到1ms以下和主站周期对齐基本不会触发这个保护。5. 常见问题与排查技巧实录5.1 从站进不了OP问题出在哪我见过最多的现象就是从站能扫描到也能进PREOP但一进OP就失败或者卡在SAFEOP死活不动。有一个真实案例问题出在SM2的DefaultSize写的是16字节但RxPDO只有8字节。主站在配置阶段把FMMU映射到16字节的SM区域从站应用却只读前8字节行为上看起来就是数据有时候对有时候不对非常迷惑。最后把XML和固件里的长度统一成8字节才解决。另一个典型问题是改了PDO之后主站报PDO mapping not supported。这种情况十有八九是Dictionary里没有对应的Object定义或者BitSize写错。TwinCAT对这类配置校验做得挺细会拿Dictionary和PDO做交叉检查。解决办法就是回到第3.2节把几个关键点对着过一遍对象索引、子索引、位宽、数据类型、访问权限。还有一类情况藏在大小端里。EtherCAT过程数据在ESC和主站之间的字节序取决于ESC实现和主站配置很多初学者在SPI读出数据之后看到一个字节序不对就怀疑是接线问题。我的排查办法很简单先在TxPDO里写一个固定的0x12345678让主站在线监控里看收到的值然后拿XML里的定义去比对一次就能看出是结构体排错还是字节序问题。5.2 现象排查速查表把前面讲到的坑整理成一张速查表现场排查直接对照现象可能原因处理办法主站扫描不到从站ESI没放对目录/文件编码错误/Vendor Id不匹配检查TwinCAT的ESI目录确认UTF-8无BOM一直停在INIT邮箱SM0/SM1没配对或ESC没识别到Mailbox检查SM寄存器的ACT位确认邮箱地址卡在PREOP进不了SAFEOP邮件收发正常但SM2/SM3配置有误对比XML和从站SM寄存器实际值卡在SAFEOP进不了OP过程数据SM地址越界/长度不匹配核对SM StartAddress、DefaultSize、PDO总长OP下数据错位PDO条目顺序和结构体不一致重新对齐XML Entry和C结构体顺序数据高低字节颠倒SPI字节序/大小端处理用固定值0x12345678测试收发方向运行中无故回SAFEOPPDI看门狗超时/主站看门狗超时确认OP循环周期检查0x0410看门狗时间改了XML主站不认ESI缓存/在线PDO覆盖了默认值清缓存重扫区分Online配置和XML默认值这个表做完之后我后面所有从站项目的联调都省了很多时间。出现异常先把现象定位到表里的某一行再对症下药比漫无目的改XML高效得多。再分享一个调试习惯不管是Keil还是IAR把SM2和SM3的起始地址、长度、当前AL状态这三个变量加到自定义Watch窗口里。每次联调只看这三个值基本能判断出问题是在主站侧、ESC侧还是应用侧。如果AL状态跑到了OP但数据不对看一眼SM寄存器的值和XML是否一致如果AL状态根本没到OP就不要纠结PDO先解决状态机问题。还有一点AX58100的IRQ引脚不要忽略。把IRQ接到STM32的外部中断并连上ESC的SM中断使能这样当主站写入新的过程数据、或者邮箱到达时你会立刻收到中断。虽然轮询也能跑但联调时有个中断能让你在逻辑分析仪上清楚看到事件发生的时刻定位问题快很多。特别是排查数据更新时机不对这类问题有IRQ和没有IRQ完全是两个效率水平。这个项目做完我最大的体会是AX58100从站调试八成时间不是花在写代码上而是花在对齐配置上。XML、固件结构体、SM物理地址、BitLen——这几样东西但凡有一个没对齐表现出来就是各种匪夷所思的灵异现象。所以我现在每次改映射第一件事不是打开编辑器而是先建一个表格把RxPDO/TxPDO每个条目在XML里的顺序、BitLen、在结构体里的成员、在SM里的偏移全部列出来确认一致后再动手。这个小习惯帮我省了无数次加班排查的时间也分享给你们。
