MT6701磁编码器SSI接口调试：CRC-6校验实现与避坑指南

MT6701这颗磁编芯片我是在做一款小型伺服关节时选上的原因很简单14位分辨率、支持多种输出方式价格还不到主流编码器的三分之一。当时为了省事直接选了SSI接口想着不就四根线的事结果一个CRC-6校验码让我整整折腾了三天。这三天里我几乎把能踩的坑全踩了一遍从时序参数到字节序从CRC多项式到Keil调试窗口里看变量每一步都在跟自己的惯性思维较劲。这篇文章我会把MT6701的SSI调试过程完整拆开重点是CRC-6校验的实现和排错思路。文章会覆盖硬件接线、SSI时序、CRC-6的位运算实现、常见坑点排查并附上可直接复用的代码。不管你是第一次用磁编芯片还是正在被CRC卡住照着我的路子走应该能少走不少弯路。1. 为什么用MT6701还要死磕SSI1.1 这颗芯片到底便宜在哪先说说选型背景。当时项目需要一个绝对角度传感器要求分辨率不低于12位响应速度要够快而且成本必须压住。搜了一圈MT6701确实是很能打的选择内置霍尔传感器不需要外加磁铁以外的机械结构14位分辨率也就是0.022度单圈绝对角度输出延迟也在微秒级。关键是这颗芯片输出方式特别灵活SPI、SSI、ABZ、PWM、UVW都有。我最开始看中的是SPI接口因为平时用STM32聊SPI聊惯了。但仔细一看数据手册里的管脚复用表发现SPI需要占用四个引脚而且和SSI是部分复用的关系选择哪种输出方式还影响上电默认状态。考虑到主控引脚的余量我选了SSI——严格来说SSI在电气时序上就是SPI模式的一种变体本质上也是SCK加DATA两根线但只需要一路单向读取比标准SPI更省事。这里要补充一句SSI全称是Synchronous Serial Interface在很多工业编码器上都挺常见它是一个主机发时钟、从机在时钟边沿吐出数据的同步串行协议。MT6701的SSI输出格式是一帧固定24位前14位是角度数据然后是两位状态位最后是6位CRC校验加起来一共22位但帧头帧尾还有一些时钟间隔实际一帧是24个时钟周期。第一次看这个帧结构的人很容易懵因为角度数据不在最前面而且CRC位置在最后面你读到的原始值必须经过位拆分才能用。1.2 SSI接口的适用场景其实SSI在电机控制和机器人关节里非常常见。它最大的优势是抗干扰能力强差分形式可以走很长的线单端形式在短距离内也够稳。另一个优势是主从关系简单主机只管发时钟从机按节拍吐数据不需要像SPI那样关心模式配置、片选信号之类的额外逻辑。但SSI也有个不那么友好的地方几乎所有厂商都在帧尾塞了一个CRC校验。这就意味着你除了要处理时序还要把CRC算法写对否则读回来的数据根本没办法验证对不对。MT6701用的是CRC-6多项式是x^6x1也就是0x03初始值是0x00。这个参数如果不仔细看数据手册很容易先入为主以为和别的芯片一样用CRC-8或者CRC-16结果算出来怎么都对不上这就是我踩的第一个大坑。所以如果你也在用MT6701我建议先把数据手册里关于SSI的部分打印出来放在手边尤其是第5页的帧格式说明和倒数几页的CRC校验附录那几页就是整个调试过程的核心参考资料。2. 硬件连接与时序先把基础打牢2.1 接线和上拉电阻硬件部分看起来简单但细节不少。MT6701的SSI需要三根线SCLK时钟、SSI_DATA数据、GND。注意这个芯片的SSI_DATA是双向的主机发时钟的同时从机在数据线上送数据所以数据线必须接对方向。我当时用STM32F103的GPIO模拟时序把SSI_DATA配置成浮空输入模式然后在读取过程中动态切换方向。这里有个重要经验MT6701的数据手册里明确写了SSI_DATA需要接上拉电阻推荐值在1k到10k之间。我第一次搭板时偷懒没接上拉结果数据线在高阻态时电平飘忽不定读出来的角度值偶尔跳变后来接了一个4.7k的上拉电阻才稳定下来。如果你用的是现成开发板板子上大概率已经带上拉了但自己画板子的话千万别省这颗电阻。另外供电也要注意。MT6701支持3.3V和5V供电但SSI接口的电平是跟随VDD的。如果主控是3.3V芯片也是3.3V供电直接连没问题。如果芯片用了5V供电数据线上就要考虑电平匹配否则可能把主控引脚打坏。我习惯统一用3.3V省事又安全。2.2 SSI时序时钟极性和采样边沿SSI时序是这次调试的第二个坑。MT6701的数据手册里给了一张时序图空闲状态时SCLK为低电平数据在SCLK的下降沿更新上升沿采样。也就是说主机应该在时钟上升沿读取数据线上的电平。这类似于SPI的CPOL0、CPHA1模式。但如果你看到手册里说“数据在下降沿移出上升沿锁存”很容易误以为要用CPOL1、CPHA0之类的配置特别是在用硬件SPI的时候。我最初就是图省事想直接用STM32的硬件SPI去读折腾了半天发现数据完全不对最后老老实实换成GPIO模拟才把问题定位清楚。后来想明白了硬件SPI的模式配置里涉及片选信号和数据的相对关系和SSI这种不带片选的单纯时钟驱动协议还是有点差异GPIO模拟反而更可控。实操中我用的模拟时序大概是这样的uint8_t MT6701_ReadFrame(uint16_t *angle, uint8_t *flag, uint8_t *crc) { uint32_t raw 0; uint8_t bit; // 拉低时钟进入通信状态 SSI_CLK_LOW(); delay_us(2); // 发送22个时钟脉冲一位一位读数据 for (bit 0; bit 22; bit) { SSI_CLK_HIGH(); delay_us(1); raw 1; if (SSI_DATA_READ()) { raw | 1; } SSI_CLK_LOW(); delay_us(1); } // 最后的第23个脉冲用于释放数据线 SSI_CLK_HIGH(); delay_us(1); SSI_CLK_LOW(); *angle (raw 8) 0x3FFF; *flag (raw 6) 0x03; *crc raw 0x3F; return 1; }注意上面这个代码里我把一帧数据读成了22位。这是根据MT6701的帧结构来的14位角度2位状态6位CRC22位实际通信时钟里还有额外的时钟沿。如果读24位要小心多余位把数据顶出去。这个细节原本我以为不会出问题结果恰恰是它在第三天又坑了我一次。3. CRC-6校验原理、实现、坑3.1 CRC-6到底算的是什么如果只是把角度读出来前面那些时序就够了根本不需要CRC。但MT6701的SSI帧里带了6位CRC你拿到的原始数据必须经过校验才能算有效。这个CRC-6的用途就相当于一个简单的“数据完整性指纹”检测传输过程中有没有位翻转或者时钟错位。MT6701用的CRC-6参数是这样的多项式0x03即x^6 x 1初始值0x00输入数据顺序MSB first也就是先处理高位输出结果6位直接映射到帧的最后6位这里特别要注意的是“先处理高位”这个说法。CRC计算时是把14位角度数据和2位状态位拼成一个16位数然后按位从高位到低位喂给CRC6的移位寄存器。很多人包括我一开始默认的是LSB first结果算出来的CRC和芯片吐出来的永远对不上。我们不妨用手算一遍来加深理解。假设我们前面读到的角度位是二进制1001状态位是00那么喂给CRC的数据就是100100。初始寄存器为000000多项式为0000110x03的6位表示。处理过程是寄存器左移一位读入第一个数据位1寄存器变成000001因为最高位不是1所以不异或多项式。继续左移读入第二位0寄存器变成000010最高位不是1不异或。依此类推直到处理完所有16位数据。最后寄存器里的6位值就是CRC码。这个手算过程在调试时非常有用可以先拿一个已知的角度值在纸上把CRC推一遍再和芯片输出的CRC对比确认理解是否正确。我建议每个被CRC折磨的人都这么干一次比盯着代码看半天管用多了。3.2 标准位序实现我在Keil里写的CRC-6实现是这样的uint8_t crc6_update(uint8_t crc, uint8_t data, uint8_t bits) { uint8_t i; for (i 0; i bits; i) { // 取出当前最高位 uint8_t bit (data (bits - 1 - i)) 0x01; // 寄存器最高位 uint8_t msb (crc 5) 0x01; crc (crc 1) | bit; if (msb) { crc ^ 0x03; // 多项式 x^6x1 } crc 0x3F; // 保留6位 } return crc; }调用方式是把角度和状态位拼成16位数据然后逐字节喂进去uint16_t data (angle 2) | status; uint8_t crc 0; crc crc6_update(crc, (data 8) 0xFF, 8); crc crc6_update(crc, data 0xFF, 8); if (crc ! received_crc) { // 校验失败丢弃这一帧 }这里面有个非常容易犯的错很多人会把CRC的输入搞成“角度数据状态位CRC自己”把芯片吐出来的整帧22位全都拿去算那结果当然对不上。CRC只覆盖前面的16位数据CRC字段本身不参与计算。另一个容易犯的错是位顺序。在硬件上MT6701的SSI数据是高位先出这和我们上面MSB first的实现是对应的。但有些人可能因为看了别的文章以为所有CRC都是从低位开始算结果一整帧数据校准好了CRC却永远差那么几位。3.3 查表法工程上更推荐上面的逐位运算是讲原理用的实际工程里我更推荐查表法因为速度快且不容易写错。CRC-6的查表表只有64项很小我可以直接把生成表的过程写出来uint8_t crc6_table[64]; void crc6_init_table(void) { uint8_t i, j, crc; for (i 0; i 64; i) { crc i; for (j 0; j 8; j) { if (crc 0x20) { crc ((crc 1) ^ 0x03) 0x3F; } else { crc (crc 1) 0x3F; } } crc6_table[i] crc; } } uint8_t crc6_calc(uint16_t data) { uint8_t crc 0; crc crc6_table[crc ^ ((data 8) 0xFF)] 0x3F; crc crc6_table[crc ^ (data 0xFF)] 0x3F; return crc; }查表法的核心思想就是一次处理一个字节用当前寄存器值的高6位去查表再和字节异或。这样做出来和逐位法的结果必须完全一样我两个都写过用于交叉验证。如果你在移植过程中发现查表法和逐位法结果不一致那肯定是移位方向或者多项式定义搞错了。还有一个细节CRC的寄存器宽度只有6位所以查表索引和异或结果都要记得和0x3F做与操作否则计算结果会被高位置上的脏数据污染。这个和操作在逐位实现里可能不显眼但查表法里特别容易被漏掉。4. 三天调试踩坑实录4.1 第一天数据全乱怀疑人生第一天我犯了一个典型的错误直接用逻辑分析仪抓波形以为波形对了数据就对了。逻辑分析仪上看到SCLK和DATA确实有反应用解码器试着解了SPI模式出来的数据一会儿是0x3FFF一会儿是0x0000完全稳定不下来。当时心想芯片是不是坏了又怀疑是不是供电不稳甚至在数据线上加了一堆滤波电容。现在回头看那天的本质问题其实是两个一是数据线没接上拉电阻导致高电平时电平不规范二是逻辑分析仪的解码配置没有按SSI的“下降沿更新、上升沿锁存”来设置直接把MSB顺序搞反了。后来我用GPIO模拟加串口打印的方式在STM32的调试窗口里逐步打点才意识到角度值其实能读出来只是偶发跳变。这个认知让第二天的排查方向变清晰了很多。这里有一个方法论上的教训遇到数据异常不要一上来就怀疑硬件先想办法把原始电平变成可读的数据。用串口调试助手或者Keil的变量观察窗口把原始值打出来比看波形图更直观。4.2 第二天角度对了CRC却怎么都不对第二天我把上拉电阻补上又花了半天时间把SSI时序调稳角度数据终于可以稳定读出来了。正当我准备庆祝时发现CRC校验永远失败。我试着把读到的CRC值打印出来和实际帧里的CRC对比发现它们偶尔接近但总差几个bit完全找不到规律。这半天我几乎把CRC6的算法改了无数遍换多项式初值换异或方式换位顺序甚至怀疑是不是MT6701的CRC多项式其实是0x05而不是0x03。后来灵光一闪决定先不管代码把芯片输出的一帧原始值拆成二进制自己手算一遍CRC。这一算就发现问题了我实际读取的帧位顺序和我在代码里组装给CRC计算函数的顺序完全是相反的。原因很简单我的GPIO模拟读取函数是每读到一个bit就往变量最高位移入一个bitraw (raw 1) | bit这样读到的第一bit会变成变量的最高位。但我在提取角度和状态时直接用移位和与操作提取这一步没错。错就错在我把提取后的角度拼成(angle 2) | status后喂给CRC函数时又按字节顺序从高字节开始处理导致分析的数据位顺序和物理时序上的数据位顺序不一致。简单说我把“高字节在前”和“MSB first”这两件事搞混了。这个坑很有代表性。我建议大家在调试CRC时先把一帧数据完整打印出来人工标出每个bit的物理顺序再对照代码里的数据组装逻辑确保从物理bit到算法输入的顺序完全一致再来谈CRC多项式对不对。4.3 第三天一位一位数出来的真相第三天我实在没辙了把MT6701数据手册里关于SSI帧格式的图放大到200%打印出来然后对着逻辑分析仪抓的波形一位一位地把整帧数据数出来。数了几帧之后我发现芯片实际吐出的帧结构跟我以为的22位不同它在数据输出之前还有一个起始位而且整个帧的实际周期是24个时钟。具体来说MT6701的SSI帧从第一个脉冲开始会先输出1个起始位然后是14位角度数据然后是1个零位接着是1个磁场诊断位和1个错误标志位最后是6位CRC总共就是11412624位。而我第一天的代码只读了22位把起始位和零位当成了帧数据的一部分导致后面的角度和CRC全部错位。这个问题如果不看手册只靠逻辑分析仪数波形真的很难发现。很多人被CRC折腾了很久其实根源不在CRC算法本身而在帧结构没对齐。所以在写代码之前一定要非常认真地确认起始位要不要读、哪些位属于状态位、CRC覆盖哪些位每个细节都不能想当然。修正后的读取逻辑是这样uint8_t MT6701_ReadAngle(uint16_t *angle, uint8_t *crc) { uint32_t raw 0; uint8_t i; uint8_t start_bit; uint8_t zero_bit; uint8_t status; SSI_CLK_LOW(); delay_us(2); // 第一个脉冲读起始位 SSI_CLK_HIGH(); delay_us(1); start_bit SSI_DATA_READ(); SSI_CLK_LOW(); delay_us(1); // 接下来14位是角度 for (i 0; i 14; i) { SSI_CLK_HIGH(); delay_us(1); *angle (*angle 1) | SSI_DATA_READ(); SSI_CLK_LOW(); delay_us(1); } // 第16位是固定的零 SSI_CLK_HIGH(); delay_us(1); zero_bit SSI_DATA_READ(); SSI_CLK_LOW(); delay_us(1); // 第17、18位是状态 for (i 0; i 2; i) { SSI_CLK_HIGH(); delay_us(1); status (status 1) | SSI_DATA_READ(); SSI_CLK_LOW(); delay_us(1); } // 最后6位是CRC for (i 0; i 6; i) { SSI_CLK_HIGH(); delay_us(1); *crc (*crc 1) | SSI_DATA_READ(); SSI_CLK_LOW(); delay_us(1); } // 释放时钟 SSI_CLK_HIGH(); delay_us(1); SSI_CLK_LOW(); return start_bit 1; // 起始位应为1否则认为帧无效 }这段代码虽然看起来比第一版啰嗦但每一步都和物理时序一一对应调试的时候能省很多力气。从那之后CRC校验就再也没出过问题。5. 常见问题速查与工具心得5.1 问题速查表我把这三天的经验整理成了一张速查表适合已经读完代码、准备上板调试的人对照使用。表中的“症状”是从现场反馈倒推的不一定覆盖所有情况但覆盖面已经相当大。症状可能原因排查方法角度数据跳变不定数据线上拉缺失加4.7k上拉电阻到VDD角度值稳定但CRC偶尔失败时钟频率太高把时钟周期放到2us以上角度值看起来正确但CRC固定不对CRC输入位顺序错误打印一帧原始值手工标注bit顺序角度值完全不对起始位/帧长度理解错误重新读帧格式确认起始位和位宽读到的CRC与计算CRC总是差固定bit多项式或位序错误用0x03多项式MSB first逐位对照读取一帧的时间太长无考虑DMA或硬件SPI但要注意模式表格里我特意写了“时钟频率太高”这一条。MT6701的SSI最高时钟频率在数据手册里有标注大概在几个MHz量级但如果你用的是GPIO模拟受限于代码执行速度2us一个周期已经很快了。我实际测试下来1us周期也能跑但余量太小线上干扰一上来就容易出错。5.2 工具与技巧调试这类接口我建议准备三样工具逻辑分析仪、串口调试助手、以及一块能快速改代码的开发板。逻辑分析仪用来抓波形确定帧结构串口调试助手或者调试器的变量观察窗口用来打印数据开发板用来快速迭代。Keil调试窗口这块可以多说一句。很多人问怎么在Keil的debug模式里看结构体变量其实就是在调试状态下把变量拖动到Watch窗口或者直接在Memory窗口里输入变量名的地址。但如果你用的是代码里的局部变量没优化的话可能要在变量声明前加volatile关键字才能稳定看到值。我当时就是因为变量被优化了导致明明数据更新了调试窗口里却看不到新值误以为读取函数没跑通白浪费了半天。另一个技巧是使用串口打印配合串口调试助手。这个看起来老土但对排查时序类问题非常有效。我的习惯是在每一帧读取结束后把原始值、角度值、CRC计算值和CRC接收值全部通过串口发出去格式大概是这样RAW: 0x3FC1A2 ANG: 1234 ST:1 CRC_RX:0x2A CRC_CAL:0x2A这样跑起来以后哪一步错了肉眼就能看出来。尤其是CRC_RX和CRC_CAL两个值如果它们之间呈现某种稳定的差值那大概率是位序问题如果完全乱来就要怀疑帧结构没对齐。5.3 模拟还是硬件SPI最后聊聊GPIO模拟和硬件SPI的选择。很多新手会问既然SSI类似SPI直接用SPI外设不是更快更稳吗我的答案是可以但前提是你对该芯片的时序理解非常透彻且愿意处理硬件SPI带来的模式配置问题。硬件SPI适合长时间高速读取比如伺服环路里需要1kHz甚至10kHz刷新率GPIO模拟在那种场景下会烧掉大量CPU时间。但硬件SPI的坑在于MT6701的SSI帧结构和标准SPI不完全一致你需要在传输中处理起始位、位宽和CRC稍有不慎整个帧就乱了。我的建议是第一版调试先用GPIO模拟把算法和时序跑通确认无误后再考虑换硬件SPI提升速度这样定位问题会容易得多。如果你确实要上硬件SPI记得把SPI配置为CPOL0、CPHA1数据宽度设为8位然后按帧长度手动拼接读取结果不要指望一次读24位因为STM32的SPI数据寄存器最大只支持16位。6. 写在最后的实操体会MT6701的SSI接口调试让我最深的体会是很多看起来高深的问题根源往往是一些特别基础的细节。比如CRC-6校验算不对最后发现是帧结构里多了一个起始位比如角度数据跳变最后发现是少了一颗上拉电阻。做嵌入式调试最怕的不是问题难而是爱把问题想复杂结果绕了一大圈才发现手册第一页早就写明白了。这里我再说一个降低调试成本的小技巧第一次接触新芯片时别急着写完整驱动先做一个最小验证程序只读原始数据并打印配合逻辑分析仪把波形和手册里的时序图逐段对照确认无误以后再开始写协议解析和算法。这个过程看似多花半天实际上能省下后面好几天。另外建议备一个手写的CRC计算器——不是电脑上的软件而是自己用笔算的那种。每次算法调不通的时候拿一个已知的帧在纸上一步步推一遍往往很快就能发现代码里的位序问题。这个习惯我后来用在了很多带CRC的传感器上几乎屡试不爽。如果你最近也在调MT6701或者其他带CRC的SSI接口传感器希望这篇记录能帮你少踩几个坑。按我最后一版代码和速查表来操作应该很快就能跑通数据读取和校验。