去年做一台桌面级激光打标机时我被XY2-100振镜通信折腾了整整两天。示波器上CLOCK和DATA两根线看着挺简单但真要自己把位置数据按时序喂给驱动器才发现这个协议跟I2C、UART完全不一样——没有地址、没有应答就是一根时钟线加一根数据线按固定位宽把位置刷过去。更麻烦的是X、Y两轴还要同时更新帧率又不能低用GPIO逐bit去翻转CPU根本扛不住。后来我换了个思路XY2-100的时序本质上和SPI高度一致STM32的SPI主模式完全可以拿来当协议发生器用再用DMA把拼好的帧数据连续搬出去CPU从头到尾几乎不用管。这个方案我后来在好几个项目里复用稳定性和实时性都很好。这篇文章就把这套方案完整拆开从协议帧怎么拼、SPI模式为什么选Mode 0、DMA怎么配、双通道怎么处理到实际调试中踩过的坑一次讲清楚。适合正在做激光控制、振镜子系统或者想深入玩SPIDMA的开发者参考。1. XY2-100协议拆解看似吓人的20位帧其实就是一串固定时序1.1 帧结构与数据编码XY2-100是振镜驱动器的标准控制协议物理层走RS-422差分信号协议层由一对信号组成CLOCK时钟和DATA数据。发送端不断给出CLOCK脉冲在指定边沿把位置数据以串行方式送出去接收端振镜驱动板在CLOCK的上升沿锁存DATA电平一个脉冲采一个bit采完一帧就更新一次振镜位置。一帧数据里包含的核心内容是16位位置信息这16位采用二进制补码编码最高位是符号位后15位是数值位也就是能表示-32768到32767的范围。很多资料里把它描述成“符号位1位数据位15位”也有的直接写“16位补码”这两种说法其实是一回事因为补码的最高位天然就是符号位。在16位数据之外协议通常还会带2位标志位这两位一般置0但在部分驱动板上被复用为错误反馈或通道选择具体要看驱动器手册。为了工程实现方便我采用的帧组织方式是“12位同步头 16位位置数据 2位标志位 2位填充位”总共32位正好4字节。有同学会问同步头不是只要4个CLOCK吗为什么给12个这是有意为之——多出来的同步周期能给驱动器更充裕的识别时间实测兼容性更好而且1220刚好凑成4字节方便DMA搬运。举个例子想让X轴振镜走到10000的位置16位补码就是0x2710符号位为0、数值位是10000。配合12位全1的同步头和2位0标志、2位0填充拼出来的32位帧长这样bit31 - bit20 : 0xFFF同步头全1 bit19 - bit4 : 0x2710位置数据符号位15位数值 bit3 - bit2 : 0标志位 bit1 - bit0 : 0填充位这里有两个关键点。第一同步头必须是1它代表DATA线在同步阶段保持高电平第二填充位最后两位为0能确保一帧发完后DATA线自动回到低电平给驱动器一个清晰的帧边界。这两个细节如果处理不好后面会出现振镜不动或者位置跳变的怪问题。1.2 时序参数与关键边沿XY2-100的时序要求是CLOCK空闲为低电平DATA在CLOCK下降沿之后发生变化在CLOCK上升沿时保持稳定接收端在上升沿采样。这是一句非常关键的话因为它直接对应SPI的一种工作模式。把SPI的四种模式过一遍Mode 0CPOL0, CPHA0是时钟空闲低、第一个边沿采样。由于时钟从低到高的第一个边沿就是上升沿所以Mode 0的数据采样发生在上升沿数据更新发生在下降沿和XY2-100完全吻合。选Mode 1也不是不能用但你要额外做数据处理或者容忍采样点不理想而Mode 0是天然契合连时序补偿都不用做。再说发送顺序。XY2-100要求从最高位开始逐bit串行发送所以SPI要配置成MSB First。数据宽度用8bit一帧4字节就是32个CLOCK脉冲正好把同步头和数据段一次发完。再说说帧率。假设SPI时钟配成10MHz一帧32位就是3.2μs理论上最大帧率大约312kHz这远高于振镜控制的实际需求——激光打标、切割这类应用振镜位置环更新率通常在20kHz到100kHz就非常好了。就算用1MHz的SPI时钟32μs一帧也能达到31kHz的帧率性能完全够用。所以SPI分频不用激进稳妥优先。1.3 同步头、标志位和帧间隙的处理细节同步头本质上是“DATA线保持高电平的CLOCK周期”协议要求至少4个。我们用SPI发送0xFFMOSI就会在整个字节期间保持高电平同时SCK产生8个脉冲这就是8个同步周期。为了凑成4字节我把同步头扩展到了12位前8位来自第一个字节0xFF后4位来自第二个字节的高4位。这样拼出来的效果是CLOCK持续翻转DATA先高一段时间然后无缝衔接到数据位驱动器的同步检测电路很容易识别。标志位和填充位默认置0。如果你手上的驱动器手册明确标志位有特殊功能比如用于选择扫描头或报告错误状态那就按手册改这两个bit。填充位纯粹是为了凑字节对齐而存在的永远置0即可。帧间隙是很多人忽略的坑。如果DMA发送完一帧后MOSI停在低电平那下一帧开始前DATA本来就是低驱动器就能明确知道这一帧结束了。但如果帧最后一位是1MOSI会一直保持高电平下一帧的同步头接在上一个高电平后面等于同步头被“吃掉”了一段整个帧的数据位置就会错位。所以拼帧时我特意把最后2位填充为0就是为了保证帧结束后DATA拉低。2. SPIDMA架构设计为什么这么配以及单双通道怎么选2.1 用SPI模拟XY2-100的底层逻辑SPI主模式在发送数据时硬件会自动产生SCK时钟同时把MOSI上的数据按MSB First一位一位送出去。每发1字节就产生8个SCK脉冲MOSI电平随数据位切换。这个行为跟XY2-100的CLOCK和DATA几乎一模一样。不一定非要用硬件NSS很多人在CubeMX里看到NSS就纠结。XY2-100没有片选概念NSS引脚直接配置为软件管理并置高或者干脆禁用别让它参与逻辑。如果NSS被配置为硬件模式又没接上拉SPI状态机会误判导致发送异常这是个容易踩的坑。对比GPIO逐bit模拟SPI的优势非常明显。普通GPIO翻转要做到10MHz级别的时钟需要极短的延时控制且受中断影响产生抖动帧间时间不稳定而SPI外设的SCK由硬件分频产生波形稳定不占用CPU。之前用GPIO模拟时振镜低速动一动还行一旦跑连续轨迹或圆弧插补位置明显发飘换成SPI后波形干净利落问题直接消失。2.2 单通道方案4字节拼帧DMA发送单通道指的是只驱动一个振镜轴。这种场景在单轴扫描、激光测距转镜、实验室设备里很常见用来学习和验证协议也最合适。流程很简单主循环或定时器里更新位置变量调用拼帧函数把16位位置数据、标志位和同步头拼成4字节然后调用一次HAL_SPI_Transmit_DMA(hspi1, txBuf, 4)。DMA会把4字节连续搬进SPI数据寄存器每字节触发8个CLOCK发完一帧产生完成中断CPU全程不参与bit搬运。单通道方案里没有同步问题最值得关注的是DMA的启动和复位。HAL_SPI_Transmit_DMA是异步函数一帧发完后需要等SPI的TXE发送寄存器空状态复位并且DMA通道状态也要恢复到READY否则第二次调用会返回HAL_BUSY。这个细节放在第6节详细说。2.3 双通道方案X/Y两轴怎么同时更新双轴激光振镜需要同时更新X和Y两个位置这里有个很多人第一次没想明白的点一路SPI只能输出一路DATAMOSI没法直接同时给X和Y各送一路数据。常见的解决办法有三种各有取舍。方案A两路SPI并行。SPI1送给X驱动SPI2送给Y驱动CubeMX里把两个SPI配置成完全一样的参数然后让它们各自独立发送。这个方案的问题在于两个SPI外设很难做到“同一时刻开始、同一时刻结束”即使同时调用发送函数也会有几微秒到几十微秒的启动差异X/Y轨迹会出现肉眼可见的台阶。除非你的应用对双轴同步要求很低否则不推荐。方案B单SPI外部锁存器。SPI先把X的4字节帧移入74HC595这类移位寄存器给一个锁存信号X通道更新再发Y帧锁存Y通道。这个办法成本低、接线简单但X和Y两次更新之间存在一个帧周期的时间差适合低速扫描或演示场合。方案C定时器触发DMA直接驱动GPIO。把X_DATA和Y_DATA分别接到两个GPIO引脚预先按CLOCK节拍把每一拍的电平组合编码成GPIO的BSRR寄存器值DMA在定时器触发下把这些值逐一写入BSRR同时由定时器的PWM输出作CLOCK。这个方案能做到X/Y严格同步且帧率可以很高但编码逻辑和调试复杂度都上来了适合对性能有硬性要求的场景。我的建议是如果只是学协议、做单轴控制直接用单SPI方案做正经双轴振镜系统优先考虑专用振镜控制卡它的同步性能是MCU方案难以替代的在必须用MCU且要求双轴同步时再上方案C并做好时序验证。2.4 DMA配置的核心要点DMA传输模式建议用Normal每帧发完就停下一帧重新触发。Circular模式虽然能连续循环发送同一帧但缓冲区如果更新不及时会把新数据和旧数据混在一起形成撕裂帧调试阶段很难查。CubeMX里配置DMA时要留意“Continuous Requests”这个选项。SPI的DMA请求默认是单次模式如果没选ContinuousDMA完成一次传输后请求会被清除下次再调用HAL_SPI_Transmit_DMA可能不触发。这个坑在STM32F1系列上特别明显F4和G4稍好一些但统一勾上最保险。内存地址递增必须开启因为帧数据是数组形式连续存放的外设地址固定指向SPI数据寄存器不需要递增。数据宽度统一用Byte别半路改成Half Word容易和SPI配置打架。3. 硬件搭建与信号转换别让3.3V TTL直接怼长线3.1 器件清单与引脚规划我建议用STM32F103C8T6或者F401/F407这类常见型号任何带SPI和DMA的型号都行。引脚分配上SPI1的SCK和MOSI优先因为PA5和PA7这个组合在很多开发板上直接引出了方便接线。信号MCU引脚对接目标说明CLOCKPA5 (SPI1_SCK)驱动器CLOCK/-经差分芯片转换DATAPA7 (SPI1_MOSI)驱动器DATA/-经差分芯片转换GNDGND驱动器GND必须共地如果你的板子PA5和PA7被其它功能占了也可以换到SPI2的PB13和PB15但CubeMX里记得把SPI2的时钟和GPIO配置好。NSS引脚建议配置成GPIO输出并拉高或者设为软件NSS。3.2 差分电平转换电路XY2-100的物理层标准是RS-422差分信号AC电压摆幅通常在±2V到±5V之间而STM32的GPIO只能输出0到3.3V的单端信号。短距离、实验环境下直接连3.3V TTL偶尔能跑动但振镜驱动器工作现场往往有伺服电机、开关电源、高压变压器等强干扰源一旦线长超过半米波形畸变和共模干扰会让人怀疑人生。标准做法是加一颗差分发送芯片比如TI的DS26C31或者国产兼容型号AM26LV31。以DS26C31为例MCU的PA5接到它的D1输入Y1和Z1输出接到驱动器的CLOCK和CLOCK-PA7接到D2输入Y2和Z2接到DATA和DATA-。使能端EN一般拉高或者接3.3V具体看芯片手册。芯片供电端记得放0.1μF陶瓷电容加10μF电解电容紧贴芯片电源脚。差分输出端的终端电阻按照驱动器手册要求接一般是100Ω到120Ω用来匹配线缆阻抗、减小反射。3.3 布局与布线注意点CLOCK和DATA的差分线尽量短两线之间保持等长这是差分信号的基本素养。线束要远离电机驱动线、变压器和开关电源线避免耦合噪声。控制板与振镜驱动板之间必须可靠共地。差分传输不意味着可以不共地RS-422接收端的共模输入范围通常只有-7V到12V如果两块板子的地电位差过大轻则信号误判重则损坏芯片。如果你打算直接单端连接做快速验证线长控制在10cm以内且只在实验室环境使用那可以临时跑通。但产品化或者正式调试一定加差分芯片这个投资非常值。4. CubeMX配置与初始化代码参数怎么设一次说透4.1 CubeMX关键参数我用CubeMX生成工程核心参数如下其他默认即可。配置项参数说明SPI ModeMaster主机模式CPOLLow时钟空闲低CPHA1 Edge第一个边沿采样Data Size8 Bit8位数据First BitMSB First先发高位Prescaler32或64先降到1MHz级别调试DMA TXNormal, Byte, Mem Inc发送通道配置时钟分频这一项我强烈建议先配置成32分频或64分频把SPI时钟压到1MHz左右让逻辑分析仪能清晰抓包。逻辑分析仪采样率不够的时候10MHz的SPI波形抓出来糊成一团根本看不清上升沿和DATA的关系。等协议验证通过再逐步把分频降低比如降到8分频或16分频看振镜在高帧率下的表现。中断优先级方面SPI全局中断和DMA中断都要使能优先级建议比普通外设高一点但别高于系统滴答定时器。如果还有定时器做帧率控制需要把定时器中断、DMA中断和SPI中断的优先级想清楚避免优先级反转导致波形毛刺。4.2 初始化代码的关键点CubeMX生成的代码里HAL_SPI_MspInit会完成SPI时钟使能、GPIO复用和DMA句柄关联。手动移植时最容易漏的是DMA句柄的关联忘了给hspi1.hdmatx赋值HAL_SPI_Transmit_DMA会直接跑到硬件错误。检查方法就是在HAL_SPI_MspInit里确认有类似这一行hspi1.hdmatx hdma_spi1_tx;还有一处是GPIO复用。PA5和PA7要配置成AF_PP复用推挽输出时钟使能别忘了打开GPIOA的时钟。CubeMX生成的代码一般没问题但如果你是从别的工程改过来的这地方经常出乱子。初始化完成后SPI外设的State是HAL_SPI_STATE_READYDMA通道状态也是READY。可以先用一个简单的测试函数直接发送一帧固定数据用逻辑分析仪看波形确认CLOCK有输出、MOSI数据和预期一致再往下走。5. 核心代码实现拼帧、DMA发送与联调步骤5.1 拼帧函数与位操作拼帧是整个方案的核心把16位位置数据转换成4字节SPI发送缓冲区。直接看代码uint8_t txBuf[4]; // pos16位带符号位置数据 // flags2位标志位默认填0 // buf输出缓冲区4字节 void XY2_FramePrepare(int16_t pos, uint8_t flags, uint8_t *buf) { uint32_t frame 0xFFF00000u; // bit31-bit2012位同步头全1 uint32_t data (uint32_t)pos 0xFFFFu; // 取低16位补码 frame | (data 4); // bit19-bit416位位置数据 frame | ((uint32_t)flags 2); // bit3-bit22位标志位 // bit1-bit0 默认0确保帧结束 DATA 拉低 buf[0] (uint8_t)(frame 24); buf[1] (uint8_t)(frame 16); buf[2] (uint8_t)(frame 8); buf[3] (uint8_t)(frame); }解释一下最关键的移位逻辑。32位帧里bit31到bit20是同步头占12位bit19到bit4是位置数据占16位。数据要放进bit19到bit4就得左移4位。这样做的原因是给同步头留出完整的12位空间让拼出来的帧序是连续的先12位1再16位位置数据再标志位和填充位。之前我试过在字节层面手动拼接结果位序绕来绕去非常容易把符号位放错位置换成这种一次移位搞定后清爽多了。再验证一下负数的编码。想让振镜走到-10000C语言里int16_t就是-10000强制转换成uint32_t后自动得到补码0xD8F0。左移4位后符号位bit15落到bit19正好是数据段的最高位。接收端按补码解码-10000就能正确还原。测试时可以用一个递增序列验证拼帧是否正确比如把pos从0递增到1000每帧加1逻辑分析仪上应该看到DATA线上有规律跳变的位流。5.2 DMA发送与回调机制单帧发送只要一行HAL_SPI_Transmit_DMA(hspi1, txBuf, 4);调用后CPU立即返回DMA在后台把4字节陆续搬运到SPI数据寄存器。4字节发完后硬件会触发DMA传输完成中断HAL库会回调到应用层void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi) { if (hspi-Instance SPI1) { // 一帧发完的标志置位即可不要在这里直接发下一帧 xy2_frame_complete 1; } }这里有个非常容易翻车的地方不要在TxCpltCallback里直接再次调用HAL_SPI_Transmit_DMA。HAL库的DMA状态机在回调时刻可能还没完全复位连续嵌套调用容易触发HAL_BUSY或者状态错乱。正确做法是置一个标志位让主循环或定时器里看到标志后再启动下一帧。如果要做定频刷新比如10kHz帧率可以把发送放到定时器中断里定时器周期100μs每次中断更新位置变量并调用HAL_SPI_Transmit_DMA。这样帧间隔是精确的振镜运动更平滑。位置数据的计算和运动规划放在主循环里定时器只负责“拍照发送”。5.3 联调步骤先抓波形再上设备第一次上电测试我强烈建议按这个顺序来。第一步逻辑分析仪挂PA5和PA7调用一次拼帧和发送函数抓一帧波形。正常看到的应该是一段高电平的同步头、紧接着一串有规律跳变的数据位、然后回到低电平。数一下时钟个数32个就对了。这时候重点看上升沿时MOSI上的电平是否稳定如果数据切换边沿和上升沿太接近说明SPI模式可能配错了。第二步接上DS26C31差分芯片用示波器量差分输出端Y/Z之间的波形。RS-422标准的差分摆幅应该有几百毫伏到几伏如果幅度太低检查终端电阻和电源滤波。第三步接上振镜驱动器。先给一个很小位置值比如100观察振镜是否有微小偏转。如果完全不动优先检查同步头宽度够不够、差分线有没有接反、SPI模式是不是Mode 0。如果振镜动了但位置不对大概率是位序问题回去重新数一遍拼帧移位。我实测时还遇到过一种情况逻辑分析仪抓到的帧完全正确但驱动器就是不认。最后发现是同步头前面的时钟电平不对——SPI时钟空闲期间SCK有毛刺导致驱动器把毛刺当成了采样边沿。解决办法是在SPI初始化前先把SCK引脚拉低并且开启内部上下拉让空闲电平稳定。6. 常见问题排查与避坑技巧实录6.1 问题速查表现象可能原因排查方法振镜完全不动差分线接反、SPI模式不是Mode 0、同步头不足、DMA没真正发送先抓波形确认SCK和DATA再查差分接线振镜能微动但位置错乱位序错误、拼帧移位不对、符号位丢失用递增位置序列抓包逐bit对照位置随机跳变帧结束后DATA没拉低、SPI时钟过高、受干扰确认帧最后2位是0降低SPI分频检查屏蔽双轴运动出现台阶两路SPI启动时间差太大改用定时器同步触发或方案CHAL_SPI_Transmit_DMA返回HAL_BUSY上次DMA传输未复位手动复位DMA状态和SPI状态发送一帧后SCK持续输出SPI没有真正停止DMA缓冲区长度不够检查DMA配置确认发送字节数6.2 DMA复位与二次发送Normal模式下一次DMA完成后DMA通道状态会变成READY吗不一定至少在一些HAL版本里会卡在BUSY。经验做法是在发送函数前做一次强制复位void XY2_SendFrame(uint8_t *buf, uint16_t len) { // 复位DMA状态防止连续发送时返回HAL_BUSY __HAL_DMA_DISABLE(hspi1.hdmatx); hspi1.hdmatx-State HAL_DMA_STATE_READY; hspi1.hdmatx-XferCpltCallback NULL; hspi1.hdmatx-XferErrorCallback NULL; HAL_SPI_Transmit_DMA(hspi1, buf, len); }这段代码我在F1和F4上都验证过能稳定解决连续调用发送函数偶发失败的问题。要是不加这步程序跑几分钟后突然某帧没发出去振镜会莫名其妙跳一下排查起来非常费劲。6.3 逻辑分析仪采样率不够怎么办便宜的逻辑分析仪采样率只有24MHz抓10MHz的SPI波形会严重失真甚至完全看不出边沿。解决办法是在调试阶段把SPI预分频调大让SPI时钟降到1MHz这样逻辑分析仪每周期能采24个点波形还原度很高。等协议调通后再把分频调高。如果必须用高时钟抓波形那就得靠示波器了至少100MHz带宽探头用最短的地线夹避免探头地线太长引入振铃。6.4 帧率与CPU占用率的平衡SPIDMA方案把CPU从bit搬运中解放出来但并不意味着CPU可以完全躺平。拼帧操作本身很轻但如果你在每次发送前调用HAL_SPI_Transmit_DMA要注意这个函数内部有临界区保护和状态判断调用频率太高会有一定开销。实测10kHz帧率下这部分开销可以忽略但如果你的位置环跑到50kHz以上建议直接操作寄存器来启动DMA传输绕过HAL库的状态机开销。另外如果用了双通道方案C建议把预排好的电平序列放在内存里一次性交给DMA不要在中断里现场计算每一位的电平否则CPU占用率会瞬间拉满。6.5 缓冲区撕裂与Circular模式的坑如果你图省事用了Circular模式让DMA循环发送同一帧位置数据更新时就要格外小心。假设DMA正在搬运第2个字节你突然把缓冲区改成了新位置数据那这一帧就是新旧数据混合的产物驱动器收到后会做出一个随机位置指令重则振镜猛跳。解决办法是更新缓冲区前先关DMA中断或者直接用Normal模式等修改完成后再重新启动发送。Normal模式没有这个烦恼因为每帧发送在DMA完成后完全停止你更新缓冲区再重新触发永远不会撕裂。这也是我推荐Normal模式的首要原因。最后再分享一个调试心得整个方案跑通之后我最大的体会是XY2-100这类协议一点都不神秘它就是SPI的一个特化时序难点不在协议本身而在你没有意识到“SPI外设就是天然协议发生器”。很多人卡了几天跑去手写GPIO逐bit模拟其实绕了一大圈。调试时候的节奏也很重要。先降频、抓波形、再上设备这个顺序能帮你省下大量时间。振镜驱动器不便宜烧一个就是几大百别在没确认波形正确的情况下直接怼上去。先把协议跑稳再优化速度稳扎稳打才能少走弯路。这套SPIDMA的设计思路后续还可以扩展很多玩法。比如用定时器DMA突发模式做多段同步输出或者在DMA完成中断里联动下一个控制周期的计算甚至把PID位置环和振镜前馈融合进去。底层的通信管道稳定了上层算法才有发挥空间。
