前阵子调试一套多轴运动控制系统从站老是刚进入OP状态就掉线折腾到半夜才发现是DC时钟的参考时钟选错导致的。回头整理这几个月用南京研旭YXDSP-F28388D一体板跑EtherCAT的完整过程从硬件电路到软件配置再到调试定位写出来给同样拿这块板子做从站开发的工程师参考。别的不说这片子最大的价值就是内部直接集成了EtherCAT从站控制器ESC不用再外挂ET1100之类的芯片电路设计和软件栈都能省不少事。这篇内容适合两类人一是刚接触EtherCAT、想用F28388D快速跑通一个可用从站的开发者二是已经在做运动控制或伺服驱动项目准备把传统的脉冲接口方案升级到EtherCAT总线方案的工程师。文章不会把所有寄存器都列一遍重点放在为什么这么配置和出问题去哪查。1. 硬件底子网口、电源与复位电路的检查要点1.1 一体板的供电结构为什么EtherCAT对电源纹波敏感研旭这块一体板把电源、仿真器、串口、扩展IO都集成在了一块板子上比之前用核心板加底板的组合省了排针连接的麻烦。拿到板子先别急着插网线第一步是确认供电结构。板上一般有5V输入口通过板载DCDC转换为3.3V和1.2V两路其中3.3V给IO和PHY供电1.2V给F28388D内核供电。EtherCAT对电源纹波比普通串口应用敏感得多因为PHY芯片工作在100Mbps收发时钟对供电噪声的容忍度有限如果纹波超过50mV左右跑低速测试没问题一上高速周期通信就容易丢帧。我的习惯是先用示波器测一下3.3V供电轨在网口收发数据时的纹波值。如果纹波偏大重点检查输入端的共模电感或磁珠是否贴装完整以及DCDC反馈电阻是否焊接正常。另外F28388D的模拟电源引脚VDDA建议加LC滤波虽然它不直接影响EtherCAT逻辑但会影响片内ADC采样精度运动控制项目里ADC和EtherCAT往往是联动的这个细节容易被忽略。1.2 两个RJ45网口背后的PHY与隔离电路F28388D内部集成了双口EtherCAT从站控制器所以在板卡上能看到两个RJ45网口分别对应EtherCAT的IN口和OUT口。物理连接路径是DSP片内ESC的MII接口连接外部PHY芯片PHY再通过网络变压器接到RJ45。常见的PHY选型是TI的DP83822I或类似工业级百兆PHYMII接口工作在25MHz时钟下。选PHY要注意一个容易踩的坑MII接口的电压域。F28388D的IO口是3.3V所以PHY的IO电源也要选3.3V版本千万别用1.8V版本的PHY然后靠电平转换那样MII时序很容易出问题。网络变压器推荐带中心抽头的百兆变压器RJ45集成变压器接口是自带还是外置取决于板卡封装调试时看丝印确认即可。如果板子是自己画的网口走线一定要做到差分对内等长、对间长度差控制在5mm以内RJ45外壳通过电容接地或者直接接地不然EMC测试过不了。两种方案的优劣对比如下对比项F28388D内置ESC方案外部ET1100/ET1200方案从站控制器片内集成不额外占空间需要外挂芯片占用主控IO或总线协议栈运行CM4核独立运行不影响C28x通常需要主控MCU外挂处理电路复杂度双网口PHY加变压器相对简单芯片供电、总线、中断一大堆调试门槛内部DPRAM访问直观CCS一套走完依赖芯片厂商驱动多一层抽象成本芯片贵点但综合成本可控芯片便宜外围器件成本更高1.3 复位电路与硬件看门狗的建议F28388D的复位引脚要求上电后保持低电平至少若干个毫秒等电源稳定后再释放这个时序在板卡上一般用RC延时或者复位IC实现。我建议直接用专门的复位监控IC比如SP706S比纯RC电路可靠得多尤其在上电瞬间电源爬坡比较慢的场合。还有个容易被忽视的是硬件看门狗电路。工业现场总线上从站程序跑飞会导致输出失控EtherCAT主站即使还在发有效数据也没用。研旭板卡预留了看门狗接口焊接上专用看门狗芯片后DSP程序需要周期喂狗。调试阶段建议先把看门狗超时调到3秒以上甚至禁用不然程序在CCS里单步执行时看门狗会一直复位芯片干扰排查。跑稳定后再把超时时间调回200ms左右保证异常情况下能快速复位。2. 软件栈ESC初始化、从站状态机与PDO映射2.1 从站协议栈代码是怎么运作起来的F28388D的EtherCAT从站协议栈直接改造TI官方提供的从站例子效率最高。代码结构典型分为底层ESC驱动、CoE邮箱处理、对象字典和状态机控制器几个模块。不要被一堆文件吓到核心逻辑就两条一是正确响应主站的命令帧二是维护自己的状态机状态。ESC底层驱动负责读写片内DPRAM主站通过以太网帧访问从站寄存器时底层驱动把收到的报文内容映射到对应寄存器地址。应用层的对象字典则是把控制参数比如目标位置、控制字映射到PDO数据区。刚开始调试时很多人直接改代码其实应该先把示例工程原样编译烧录一遍确认从站能被主站识别再动自己的应用逻辑。这样出了问题至少知道范围在代码改动部分。2.2 CM4核上跑协议栈的初始化顺序F28388D有C28x双核和CM4核TI官方推荐的架构是CM4独立跑EtherCAT协议栈C28x核跑实时控制算法两个核之间通过IPC中断通信。这样做的好处是协议栈的实时响应不会被控制算法阻塞EtherCAT最差周期能做到几百微秒级别C28x那边照样200MHz跑控制环。CM4的初始化顺序我按以下步骤来做先配置系统时钟然后使能ESC模块的时钟和MII接口接着注册PF1中断作为EtherCAT帧接收中断最后启动协议栈主循环。关键点是CM4中断优先级要配置好PF1中断必须设为最高优先级之一否则帧来了处理不及时主站侧看就是从站丢帧。协议栈跑起来后串口会输出状态迁移日志那个日志就是后面调试的第一手线索。初始化过程中还要注意EEPROM的烧录。从站EEPROM存了厂商信息和从站地址如果EEPROM是空的或者校验失败主站扫描时会提示未知设备。研旭板子在出厂前一般会烧好但如果你改过PDO映射重新生成了ESI文件就需要同步更新EEPROM。可以用主站通过FoE方式写入也可以在CCS里直接调用EEPROM烧写函数两种方式我都试过FoE方式更贴近实际生产流程。2.3 状态机切换与PDO映射配置EtherCAT从站状态机在INIT、PRE-OP、SAFE-OP、OP四个状态之间迁移主站控制迁移从站负责确认。每个状态迁移都有前置条件INIT到PRE-OP需要完成邮箱通道配置SM0/SM1让主站和从站能通过CoE进行SDO通信。PRE-OP到SAFE-OP需要配置过程数据通道SM2/SM3并且从站要正确初始化PDO映射。SAFE-OP到OP主站开始周期性发送有效过程数据从站输出使能同时看门狗生效。我调试时遇到最多的就是卡在PRE-OP到SAFE-OP这步原因是生成的PDO映射和主站XML里的映射不一致。解决方法是重新用SSC工具配置PDO长度和个数重新生成代码并导出ESI文件保证从站固件和主站XML指向同一份配置。千万别手动改代码里的PDO映射表容易改漏。PDO映射的本质就是把对象字典里的变量按固定顺序排布到过程数据区。比如CSP模式一个典型的TXPDO包含状态字和实际位置共8字节RXPDO包含控制字、目标位置和模式切换也是8~16字节。主站下发时按这个顺序填充数据从站收到后直接映射到应用变量不需要解析逻辑。所以PDO映射的排布顺序很重要主站XML里怎么排从站对象字典就得怎么写。3. 主站联动TwinCAT扫描、DC时钟同步与CSP模式3.1 ESI设备文件与TwinCAT扫描从站侧准备好之后主站测试我用的TwinCAT 3。先把从站生成的ESI文件XML格式复制到TwinCAT安装目录下的EtherCAT配置文件夹里然后在TwinCAT的Device列表中添加EtherCAT主站选择对应的网卡再执行扫描从站操作。扫描之前有个前提主站网卡必须是TwinCAT支持的Intel千兆网卡或者使用官方支持的EtherCAT网卡。用普通Realtek网卡会报无有效网卡或者扫描超时。研旭板子的两个RJ45网口是链式拓扑的IN和OUT主站网线要接到从站的IN口别接反了接反的话从站不会把帧转发给主站扫描自然失败。扫描成功后TwinCAT会列出从站并识别厂商ID和产品码同时在IO窗口出现这个从站的PDO映射。如果这里显示的是未知设备大概率是ESI文件没放对位置或者EEPROM里的从站信息与ESI不匹配。先检查文件路径再查EEPROM烧录内容。3.2 DC分布式时钟同步的过程拆解EtherCAT最值钱的功能之一就是DCDistributed Clock分布式时钟同步。在做多轴同步运动控制时如果每个从站用自己的本地时钟触发采样轴与轴之间的指令时间差会达到几十微秒甚至毫秒级动态性能根本没法保证。DC同步的过程分为三个阶段第一阶段是参考时钟选择。主站自动选择链路上第一个支持DC的从站作为参考时钟其他从站都以这个时钟为基准。如果链路上第一个从站不支持DC主站会跳过它继续选。所以如果你的系统里有多个从站建议让支持DC功能的从站尽量靠近主站否则参考时钟经过的转发链路越长同步误差会相应增大。第二阶段是传播延时测量。主站通过测量从站IN端口收到帧的时间差计算每个从站相对于参考时钟的链路延时然后把延时值写入从站的系统时间偏移寄存器。这个阶段完成后所有从站在同一时刻对齐到参考时钟。第三阶段是运行时的漂移补偿。晶振频率总有微小差异即使初始对齐了运行几分钟后也会产生漂移。EtherCAT协议通过周期性发送同步报文来校准主站给每个从站发送真实系统时间从站把它和本地时钟比较动态调整时钟频率。实际效果是各从站SYNC0中断的相位差能控制在亚微秒级别。正确配置DC后从站会产生SYNC0中断信号这个信号用于触发应用层任务。在项目里我们直接把控制周期的任务挂到SYNC0中断里保证所有从站在同一时刻采样和输出。如果SYNC0配置不对从站也能进OP但轴与轴之间会有肉眼可见的不同步现象。3.3 CSP位置模式下的PDO配置CSP周期同步位置模式是CiA402标准里的标准运动控制模式多轴插补场景很常用。主站每个周期下发目标位置从站内部完成位置环计算实现平滑的点到点运动。在F28388D上跑CSP需要把对象字典里的运行模式切换为CSP并正确配置目标位置、实际位置等PDO对象。我常用的做法是在PDO里加入以下对象RXPDO包含控制字0x6040、目标位置0x607ATXPDO包含状态字0x6041、实际位置0x6064。PDO数据映射顺序必须和主站XML一致这里建议在SSC工具里勾选Generate ESI file时一并生成PDO配置避免手写漏字段。CSP模式还有个容易忽略的点从站实际位置反馈的数据类型是32位有符号整数单位取决于电子齿轮比和编码器分辨率。F28388D的EQEP模块读到的编码器计数值要经过换算再填到实际位置变量里不然主站侧看到的位置反馈会跳变。我遇到过反馈数据在正负最大之间来回跳排查半天发现是数据类型定义成了16位这种低级错误在调试阶段很浪费时间。4. 调试实录从扫描不到到高速掉线的完整排查4.1 扫描不到从站先查物理层再查地址扫描不到从站是EtherCAT开发最常见的第一个坎。排查顺序我建议固定为网线顺序、PHY状态、EEPROM地址。网线顺序的判断方法很简单在TwinCAT扫描时观察从站网口的link指示灯主站网线插IN口如果能从OUT口用另一根网线串联到电脑或者下一个从站整个链路就通了一半。指示灯不亮就换网线不要直接怀疑DSP程序。网线OK后看PHY时钟。F28388D的MII接口需要PHY提供25MHz时钟如果PHY没有成功锁相从站网口link灯也是亮的但主站发出来的帧从来不会被正确接收。用示波器测PHY的TX_CLK引脚确认有25MHz方波再往下走。最后看EEPROM。F28388D内置ESC上电时会读取外部EEPROM里的配置信息如果EEPROM里没有有效数据ESC会用默认配置运行但主站无法识别从站地址。研旭一体板的EEPROM里默认烧录了从站信息但你如果买的是二手板或者自己画的板子这个问题就很常见。在CCS里可以直接调用EEPROM初始化函数烧一遍烧完断电重启再扫描。4.2 状态机不迁移用串口调试助手看日志定位从站能被扫描到但状态机卡住不迁移这事的排查效率完全取决于日志。我一般在从站代码里把状态迁移日志串口输出波特率230400用串口调试助手比如SSCOM实时看。这比在CCS断点调试方便太多因为EtherCAT是实时协议断点一停主站立刻报从站丢失没法断点调试状态机。日志里重点看两类信息一类是主站下发的状态请求比如请求PREOP、SAFEOP、OP另一类是从站返回的错误码。常见错误码包括邮箱配置错误、PDO映射长度不匹配、看门狗配置无效等。根据错误码去查对象字典配置效率最高的路径是先查Sync Manager配置再查PDO映射。如果卡在PREOP到SAFEOP十有八九是SM2/SM3的配置和主站期望的不一致。打开ESI里的SM配置和实际生成代码里的SM地址对比不一致就改SSC工具配置重新生成。这里别跳过直接改代码虽然也能跑但以后每次重新生成都会被覆盖留下隐患。4.3 运行中高速掉线抓包和波形双管齐下能进OP但跑高速就掉线这个现象最考验综合排查能力。我把它拆成两半来处理一边用Wireshark抓EtherCAT帧一边用示波器盯SYNC0波形。EtherCAT帧的EtherType是0x88A4Wireshark装好就能解析不需要额外插件。抓包时注意如果用的是普通PCIe网卡抓到的帧可能被网卡过滤掉一部分但EtherCAT帧一般能抓到。重点看主站周期性下发的过程数据帧是否得到从站的正常响应如果过程中出现大量重发帧说明从站处理超时了优先检查CM4中断优先级和应用层任务负载。如果帧一直正常但掉线依旧那就是看门狗或者DC的问题。DC问题用示波器看SYNC0引脚最直观。把两三个从站的SYNC0引脚分别接到示波器的不同通道正常情况各通道脉冲上升沿之间的偏差应该在1微秒以内。如果发现SYNC0脉冲间隔忽长忽短说明漂移补偿没生效检查是否把从站System Time相关的寄存器配置正确。这里要特别提醒SYNC0脉冲是很多项目的应用任务触发源脉冲抖动会直接反映到控制输出上别忽视。4.4 一个真实案例从OP掉到SAFEOP的完整排查链路举个实际例子我调试四轴平台时三号轴运行约10秒后自动从OP掉到SAFEOP其他轴正常。第一反应查主站日志显示三号轴丢失过程数据说明三号轴没有按周期更新输出数据或从站主动切状态。串口日志显示三号轴在掉线前的一个周期内SYNC0中断没有被执行导致看门狗超时。进一步用CCS的Expressions窗口监控协议栈运行计数值发现CM4核的SYNC0中断服务函数运行时间偶尔会超过500微秒而EtherCAT周期是1毫秒理论上够用。但排查发现应用层在中断里写了一条耗时较长的循环用于处理编码器数据滤波这个循环在特定位置反馈值时会走一个极端分支耗时翻倍。修复方案很简单把编码器滤波从SYNC0中断挪到C28x核上处理CM4中断里只做数据搬运和状态更新。改完再测SYNC0中断最差运行时间降到100微秒以内连续跑两个多小时没掉线。这个案例想说明的是EtherCAT掉线不一定是总线问题从站应用层任务超时导致主站看门狗超时是非常隐蔽但又很常见的根因。最后再分享一个细节调试阶段一定要固定上电顺序。先给从站板子上电等从站系统启动完成串口日志输出状态机初始化完成再启动主站扫描。反过来先启动TwinCAT再给从站上电虽然多数情况下也能扫描成功但在严苛的工业现场会被视为非法上电可能导致从站进入异常状态。养成这个习惯后我在现场调试省了一大半无头绪的问题。EtherCAT的精髓之一就是确定性调试过程本身也值得用确定性的流程来对待。
