STM32G474 SPI读取MT6816绝对角度实战与避坑指南

简介：针对使用STM32G474微控制器通过SPI接口读取MT6816磁性角度传感器绝对角度的开发者，这份PDF配置指南聚焦器件特性、接口连接、通信命令与软硬件协同设计。内容涵盖MT6816基于AMR技术的14位核心分辨率、25,000 RPM最高转速、小于2微秒输出传播延迟及-40~125℃工业温度范围，并详细讲解3线/4线SPI的四个基本命令（读角度、写配置、读状态、写状态）的寄存器地址与时序参数，帮助读者正确配置引脚、初始化SPI并解析角度数据。硬件部分给出低功耗组件的接口设计要点与抗干扰注意事项，针对BLDC、伺服、步进电机及光学编码器替换等应用场景提供信号处理建议。资源包内含1个PDF文件，大小约641KB，适合刚接触该传感器或需要快速完成驱动移植的嵌入式工程师。目前已有614人学习，可用于对照数据手册快速搭建STM32G474与MT6816的通信环境，减少排查时间。

1. 为什么用 SPI 从 MT6816 读绝对角度：从三相电机控制说起

做过无刷电机 FOC 的工程师都懂，转子初始位置错了，电流环给多大都没用，轻则抖一下不动，重则直接过流报警。常见做法是装霍尔或者反电动势估位置，但这两个方案低速性能都一般，尤其是零速启动那一下，没有绝对角度就只能撞大运。MT6816 这类磁编码器芯片，核心价值就是上电就能告诉你转子在哪，绝对角度一次到位，不用反复找零。而在它的几种输出里，SPI 是唯一能同时拿到高分辨率、高刷新率、还能带 CRC 校验的通道，比 PWM 占空比输出和 ABZ 增量输出都更适合直接喂给 FOC 电流环。这篇内容围绕一个目标展开：用 STM32G474 的 SPI 外设，把 MT6816 里的绝对角度稳定读回来，再换算成 0 到 2π 的浮点角度。适合正在做伺服驱动器、云台、机械臂关节模组，或者纯粹想把编码器读数从“能亮”做到“能打”的嵌入式工程师。

2. MT6816 的 SPI 协议与 G474 硬件接线：先看懂时序再写代码

2.1 MT6816 支持哪几种输出模式，为什么 SPI 最省心

MT6816 不是只有 SPI，它还提供 PWM 输出、增量 ABZ 输出以及 UVW 换向信号，具体启用哪一路由芯片引脚配置决定。很多开发者图省事直接选 PWM 模式，因为只需要一根信号线，量一下高电平占空比就能换算角度。但 PWM 模式有几个天然短板：一来分辨率受计数器时钟限制，常用 1kHz 到 1MHz 载波，能做到 12bit 已经不错；二来实时性差，一个 PWM 周期才更新一次，速度环跑到几千赫兹的时候带宽明显不够；三来没有校验机制，线上干扰啃掉一个脉宽，角度直接跳几度。

ABZ 增量模式则只能给出相对变化量，断电再上电，零位没了，必须配合外部绝对位置标定。对单圈绝对角度需求来说，SPI 是四选一里最合适的：12bit 角度一次读回，最高支持若干 MHz 时钟，数据帧里还带 CRC 校验位，读出来直接就是绝对角度，不用自己数脉冲。另一个实际优点是 SPI 可以做到连续读取，在 1MHz 时钟下，读一次完整帧大概十几微秒，FOC 的 10kHz 电流环完全来得及在每次中断里现取现用。如果你已经在用 G474 的片上运放和比较器做电流采样，同一颗芯片顺手把编码器也接了，布局和成本上都划算。

2.2 SPI 帧格式与 CS 时序要点

MT6816 的 SPI 从机帧格式看起来简单，但细节决定成败。一次完整传输是 16bit：主机发 8bit 命令，从机回 8bit 数据，然后再跟 8bit 校验，总共三个字节。不同批次芯片命令字可能不一样，常见的是 0x00 或 0x04 用于读角度寄存器，具体以手头芯片规格书为准。返回的第二个字节低 4 位是角度高位，第三个字节是角度低位，合起来就是 12bit 原始角度，范围从 0 到 4095 对应 0 到 360 度。如果数据帧里带了 CRC 位，需要单独解析帧尾的效验位，而不是简单把三个字节全塞进一个变量。

CS 片选时序是另一个容易忽略的点。MT6816 要求 CS 拉低后至少等待一小段时间再给时钟，传输结束后也要保持一段时间的低电平，不能在最后一 bit 刚采完就立刻拉高。为什么？因为内部移位寄存器和角度锁存器是异步的，CS 拉高瞬间才把当前角度锁存到输出寄存器里，如果拉高太快，读回来的其实是上一次的角度。更麻烦的是，若主机在 CS 拉低瞬间还没等内部逻辑稳定就发时钟，第一 bit 很可能被吃掉，整个数据帧左移一位，角度值变成完全对不上的数。我一般会在 CS 拉低后延时几十纳秒到几百纳秒，视 GPIO 翻转速度而定，G474 主频 170MHz，用几个 NOP 或者一个空循环就够了。

2.3 给 STM32G474 分配引脚：我常用的接线表和 3V3 电平注意

G474 的 SPI 外设不止一个，SPI1、SPI2、SPI3 都行，但要先确认引脚有没有被其它外设占用。在主流封装里，SPI1 的 SCK 和 MOSI 常用 PA5、PA7，MISO 用 PA6，CS 我习惯随便挑一个 GPIO 而不是用硬件 NSS，因为硬件 NSS 在 multi-slave 场景容易闹脾气。MT6816 的 SDO 是推挽输出，直接接到 MCU 的 MISO 上没问题，但前提是两者电平匹配。MT6816 供电可以选 3.3V 或 5V，如果给它供 5V，SDO 的高电平可能是 5V，G474 的引脚不一定耐 5V，稳妥做法是加电平转换，或者干脆把编码器也跑 3.3V，省事。

还有一点很多人第一版会忽略：MT6816 的 SCLK 和 MOSI 输入脚内部有施密特触发器，但对毛刺的容忍不是无限的，走线长了、和功率线贴太近，就容易误触发。我的习惯是 SPI 时钟线串一个 33Ω 到 100Ω 的电阻，放在靠近 MCU 一侧，能有效抑制振铃，成本几乎为零。下面这张表是我在一个云台关节测试板上用的接法，仅供参考，具体封装不同引脚位置要查对应数据手册。

3. 从零配置 STM32G474 SPI 外设：初始化代码与读角度最小用例

3.1 用配置工具快速生成 SPI 初始化参数表

手写 G474 的 SPI 寄存器不是不行，但先用图形化配置工具把时钟树和外设参数导出来，再手工改几行，效率最高。打开配置工具，新建一个基于 G474 的工程，RCC 里把 HSE 打开，主频配到 170MHz，APB2 分频器保持默认，这样 SPI1 的时钟就是 170MHz。SPI 外设选择 Full-Duplex Master，这几项是必填的：

• 数据长度：要特别注意，MT6816 的协议按位看是 8bit 为单位传输，但一次完整交互要 24bit。最简单的方式是配成 8bit 数据，手动控制 CS，连发三个字节。配成 16bit 反而麻烦，因为帧边界和 CS 拉高时机不好对齐。
• 时钟极性 CPOL = 0，时钟相位 CPHA = 1，也就是第二个边沿采样。MT6816 手册一般标称 SPI Mode 1，这个组合必须核对，配反了读出来全是花数据。
• 波特率预分频：SPI 时钟先压到 1MHz 验证通信，确认无误之后再往上提。G474 的 SPI 跑十几 MHz 没问题，但编码器侧不一定扛得住，而且走线质量决定上限，我一般保守用 2MHz 到 4MHz。
• 帧格式 MSB First，标准 SPI，不要动成 LSB First。
• 软件 NSS 管理，把 NSS 引脚设为 GPIO 输出，手动控制。

生成工程后，进代码把 SPI 句柄里的参数看一眼，确认 BaudRatePrescaler 是 SPI_BAUDRATEPRESCALER_64 左右，对应 170M/64 ≈ 2.656MHz，这个速率对 MT6816 来说相当稳。CubeMX 生成的初始化函数是 MX_SPI1_Init()，里面会把 SPI 的 CR1、CR2 寄存器配好，但默认并不开启 SPI，真正要发数据前记得调用 HAL_SPI_Start 或者直接 __HAL_SPI_ENABLE。

3.2 SPI 发送接收代码：如何在 24bit 帧下读出 12bit 角度

MT6816 的一次完整读操作需要 MCU 先发命令字节，再收两个数据字节。我的做法是使用一个 3 字节的缓冲区，第一个字节放命令 0x00，后两个字节填空，然后发送并接收，最后从缓冲区里提取角度。用 HAL 库实现的话，HAL_SPI_TransmitReceive 可以参考下面的写法：

uint8_t spi_buf[3]; uint16_t angle_raw; uint8_t crc; uint32_t tmp; spi_buf[0] = 0x00; // 角度寄存器读取命令，具体以芯片手册为准 spi_buf[1] = 0x00; spi_buf[2] = 0x00; HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_RESET); // 拉低片选后给编码器内部逻辑一点稳定时间 for (volatile int i = 0; i < 8; i++); HAL_SPI_TransmitReceive(&hspi1, spi_buf, spi_buf, 3, 100); for (volatile int i = 0; i < 8; i++); HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_SET); // 解析 12bit 绝对角度 angle_raw = ((uint16_t)(spi_buf[1] & 0x0F) << 8) | spi_buf[2]; crc = (spi_buf[1] & 0xF0) >> 4; // 部分芯片 CRC 在高半字节

先解释一下缓冲区设计：HAL_SPI_TransmitReceive 支持同一缓冲区同时作发送和接收，发送时把 spi_buf[0] 发出去，同时从 MISO 线采样到 spi_buf[0]。这里的三个字节分别是：命令返回字节、角度高字节、角度低字节。MT6816 的角度寄存器返回格式通常是第一个字节是命令回显或状态字，第二个字节的低 4 位是角度高 4 位，第三个字节是整个 8 位角度低 8 位，合起来 12bit。如果规格书不一样，就按实际位段偏移重新组合。

关于超时时间，HAL_SPI_TransmitReceive 最后一个参数设成 100ms 是下限值，正常一次传输在 1MHz 下只要 24us，100ms 已经非常充裕。如果用了 RTOS，这个参数也可以直接设成 HAL_MAX_DELAY，但对于裸机裸跑，建议给个具体超时，防止 SPI 卡死把整个中断挂住。还要注意这段代码如果放在 FOC 中断里执行，CS 拉低后的延时和 SPI 阻塞传输会占用中断时间，要核算一下是否超过电流环预算，后面会专门聊这个。

3.3 验证读到的角度是否合理：串口打印与单步调试两种手段

代码写完后先不要接电机，单独验证角度数据。把 MT6816 装在一个可以手动旋转的转台上，用串口打印角度值。G474 有多个 UART，随便用一个空闲的就行，9600 波特率可能偏慢，115200 比较合适。打印的时候不要每读一次就打印一次，否则会因为串口阻塞影响采样实时性。正确的做法是维护一个角度缓存，在主循环里每 100ms 打印一次，或者用 DMA 发送，把最近几次读到的角度值周期性地吐出去。

单步调试时，注意观察 spi_buf[1] 和 spi_buf[2] 的值变化。如果手动旋转编码器转子，这两个字节应该呈现线性增长或减少。如果读到的一直是 0xFF 或 0x00，大概率是命令字没对上，或者 SPI 模式配错了。把调试器挂在 HAL_SPI_TransmitReceive 返回之后，断点停在解析那行，手动转一圈转子，比较 angle_raw 是否覆盖 0 到 4095。还有一个值得做的测试：把转台停在某个确定角度，重复读 100 次，看读数的抖动范围。正常情况下抖动应该不超过 ±2 LSB，如果抖动达到几十 LSB，基本可以肯定是电源纹波或者 SPI 信号质量问题。

4. MT6816 调试避坑：基于 STM32G474 的 4 个高频翻车点

4.1 读回来全是 0xFF 或 0x00：命令字和帧格式错配是最常见原因

现象是 angle_raw 永远是一个固定值，要么全 1 要么全 0，电机转不转读数都没变化。我一开始也遇到过，复制了网上的示例代码，寄存器地址对不上，读回来的当然不对。原因是 MT6816 不同型号、不同固件版本对命令字的定义不完全一样，有的用 0x00 表示直接读角度，有的必须带寄存器地址前缀。解决方法是翻自己的芯片批次数据手册，找到 Read Register 对应的指令码，然后按位组织命令字节。另外检查 SPI 数据帧长度是不是被配置成了 16bit 模式，如果配成 16bit 再传三个字节，实际发出去的是两帧半，接收缓冲区错位，解析自然全乱。这类问题我一般通过在 CubeMX 里把数据帧格式改回 8bit 来解决。

4.2 片选拉高太快导致的数据错位：一个 nop 的事，血泪经验

现象比较隐蔽：读到的角度曲线整体像被切了一刀，每转一圈会出现一次跳变，好像数据少了 4bit 的精度。这往往不是芯片坏了，而是 CS 时序不满足。HAL_SPI_TransmitReceive 最后一个字节传输完成后，硬件 SPI 已经采样完 MISO，但 MT6816 内部此时还没把数据完全锁存。如果 CS 立刻拉高，锁存器抓到的数据可能还停留在前一次传输。解决方法是 CS 拉低前后各加延时，甚至可以在 CS 拉高后加一个小的延时再拉低进行下一次传输。我在量产板上会用一个定时器引脚来模拟 CS，通过调节比较寄存器精确控制时间，但原型验证阶段加几个 NOP 就够。

4.3 G474 的 SPI 时钟极性与相位不匹配：Angle 数据呈周期性错误

现象是两个相邻角度之间读数像镜像，比如从 0 到 90 度读数先升后降，或者出现明显的正弦波动偏差。这个一般是 SPI 的 CPOL/CPHA 组合不对。MT6816 的 SDO 在 SCK 的第一个边沿更新数据，第二个边沿采样，这对应 Mode 1，也就是 CPOL=0，CPHA=1。如果配成了 CPOL=1，SCK 空闲电平是高，波形完全反相，数据照样能出来，但就是不对。把 SPI 配置里 ClockPolarity 改成 Low，ClockPhase 改成 2Edge，重新生成代码，再转一下转子验证。遇到时钟问题不要玄学调参，直接用示波器同时抓 SCK 和 SDO，看数据变化沿和采样沿之间的关系，一眼就能看出来。

4.4 把 12bit 原始值直接当角度用，换算错了单位

现象是一切都正常，但角度反馈到 FOC 后电流波形怪异，带载后噪声大。很多人读完寄存器直接左移或右移几位，想对齐到 0-36000 这样的协议值，结果符号位偏移出错。MT6816 的 12bit 值代表的是单圈 0-4095，对应 0-360 度，不是 0-65535，也不是 0-3600。如果控制算法需要 0.1 度分辨率，用 12bit 本身就够，但千万别把它塞进一个 int16 里再做归一化，那样符号位会溢出。正确做法是先转成 uint16_t 或 uint32_t，再乘以 360.0f 除以 4096.0f，得到浮点角度。一个最简单换算公式：float angle_deg = (float)angle_raw / 4096.0f * 360.0f;注意 4096 对应 12bit 满量程，不是 4095，虽然 4095 和 4096 在实际换算中误差极小，但严格按芯片量程取 4096，后面做椭圆误差补偿时一致性更好。

float mt6816_get_angle_deg(void) { uint16_t raw; float deg; raw = mt6816_read_raw_angle(); deg = (float)raw / 4096.0f * 360.0f; return deg; }

这里有个容易忽略的点：如果需要的是连续多圈角度，单圈绝对角度本身不够，必须在应用层做圈数累加。判断方法很简单，当角度从 350 度跳变到 10 度时，认为是正向越过了 0 点，圈数加一；反向则圈数减一。但如果 SPI 读回来的原始值本身有跳动，在零点附近抖动可能导致圈数误判。建议每次角度计算后先做一次低通或迟滞比较，再做越界判断，否则多圈角度会出现累加误差。这块的细节做 FOC 的朋友应该深有体会，零位附近的抖动是圈数计数翻车的重灾区。

5. 把原始角度换算成可用绝对角度：零位校准与滤波实现

5.1 绝对角度与机械角度的映射：齿轮比和安装偏心补偿

MT6816 测得的是磁铁旋转角度，和电机转子机械角度之间存在一个映射关系。直驱场景系数是 1:1，但如果编码器安装在齿轮箱输出端，或者磁铁装在后端透过联轴器带动，就要考虑齿轮比。如果输出端转了 10 圈，编码器才转了 1 圈，那角度换算就要把编码器角度除以 10 才是输出端角度。安装偏心问题也会导致角度偏差：磁铁中心没有对准芯片中心时，角度曲线会混入一个一阶谐波误差，旋转一圈读出来的角度会忽快忽慢。这个误差用软件补偿的思路是：让电机匀速转一圈，记录实际角度和理论角度的差值表，存到 Flash 里运行时查表插值。

我一般不建议一开始就上误差补偿，先把原始角度和直驱映射做好，在示波器上对比电角度和反电动势相位。如果相位偏差是固定值，那只是零位问题，直接在软件里加一个偏移量即可。如果偏差随转子位置变化，才需要考虑偏心补偿。MT6816 是单芯片磁编码器，内部没有复杂的自校准算法，所以外部机械安装精度直接决定最终精度，这一点是它和更高端磁编芯片的差距。

5.2 零位校准的两种做法：机械对齐和软件置零

电机控制里，电角度零位通常希望与电机 A 相反电动势的过零点对齐。实际操作中有两种常见方案。第一种是机械对齐：把转子转到指定位置，然后锁死联轴器，再安装编码器磁铁，让芯片输出 0 度正好对应这个位置。优点是简单可靠，但换一颗电机就要重新装一次，量产效率不高。第二种是软件置零：任意安装编码器，然后通过程序把当前位置设为零位，后面每次读角度都减去这个偏移量。软件置零方便，但有一个前提——编码器必须输出绝对角度，否则断电再上电零位就丢了。MT6816 的绝对角度特点在这里正好派上用场。

#define ANGLE_ZERO_OFFSET 2300.0f // 实测零位偏移量，单位 LSB float mt6816_get_angle_with_offset(void) { float raw_deg; raw_deg = mt6816_get_angle_deg(); raw_deg -= ANGLE_ZERO_OFFSET / 4096.0f * 360.0f; if (raw_deg < 0.0f) raw_deg += 360.0f; return raw_deg; }

校准偏移量的获取方式有两种，一种是上电时用电流注入的方式让电机转子锁到一个已知位置，然后读一次编码器值记下来；另一种是手动转动电机到对齐位置，用调试器读取角度值，填到这个宏里。第二种方式做原型验证很方便，但量产时最好改成上电自动校准，否则每一台都得手动填参数，售后麻烦。这个偏移量一般放在 NVM 里而不是编译期常量，这样现场还可以通过命令动态修正，某个模拟项目的现场调试就靠这个留了条后路。

5.3 针对 G474 的轻量滤波：滑动平均与一阶低通对比

写 FOC 控制时，角度滤波必须谨慎，过强的低通滤波会给速度估算引入延迟，电流环带宽再高也被角度延迟拖垮。MT6816 本身输出的 12bit 角度噪声一般不大，所以滤波主要针对的是电磁干扰引入的偶发毛刺。我常用两种方法。第一种是滑动平均，连续取 4 个原始角度取平均，这个对偶发毛刺效果很好，但会引入约 1.5 个采样周期的延迟。第二种是一阶低通，angle_filtered += alpha * (angle_raw - angle_filtered)，alpha 取 0.3 到 0.5 之间，延迟更小但高频噪声抑制不如滑动平均。还有第三种是限幅滤波，也就是判断两次采样值之差超过某个阈值时直接丢弃本次数据，这个对毛刺效果最好，但角度快速变化时也会误杀。

#define ANGLE_ERR_LIMIT 20.0f // 最大允许跳变，单位 度 float mt6816_filtered_angle(float new_angle, float last_angle) { float delta; delta = new_angle - last_angle; if (delta > 180.0f) delta -= 360.0f; else if (delta < -180.0f) delta += 360.0f; if (delta > ANGLE_ERR_LIMIT || delta < -ANGLE_ERR_LIMIT) return last_angle; // 视为毛刺，保持上一帧 return new_angle; }

限幅滤波的判断逻辑要处理好角度环绕，否则在 0 度附近会把正常跨越误判成毛刺。上面这个函数把差值先映射到 -180 到 180 范围内，再做阈值比较，就能避开环绕问题。实际使用时可以把限幅后的值再做一次一阶低通，先剔除野值再平滑，效果比单一滤波好很多。G474 的 FPU 是单精度硬件浮点，跑一个 4 点滑动平均加限幅，在 170MHz 下开销非常小，放电流环中断里也毫无压力。

6. 进阶验证：用角度数据校准电流环前馈与过采样技巧

当你能稳定读出绝对角度后，下一步不是急着调 PID，而是验证角度数据本身够不够喂给电流环前馈。我习惯用一个简单测试：在速度模式下让电机恒速转 5 圈，记录角度和速度观测值，把速度环输出里的角度项和电流反馈波形对比。正常情况下，角度曲线应该平滑，速度观测值不会出现周期性的毛刺。如果速度波形上叠加了一个与机械转速同频的波动，那很可能是编码器安装偏心或者零位偏差，这时候去调 PID 只会把参数带偏。

过采样的思路也值得试一下。MT6816 的 SPI 单次读数很快，但角度更新率受片选周期限制。在 FOC 中断里强制每次中断读一次，能拿到接近电流环频率的角度更新率，这时候速度估算可以只用相邻两次角度差除以时间，省掉一个观测器。注意这个方法只适用于转速不太高的场合，转速过高时，每中断周期的角度增量会小于量化噪声，速度反馈量化误差大，反而更糟。

最后说一次让我印象深刻的翻车。项目某次联调，电流环表现始终不对，带载后 200Hz 附近有明显啸叫。我花了一整天检查 PI 参数、MOSFET 驱动、采样电阻，最后用示波器对比 SDO 波形才发现，是 SPI 的 CS 引脚被复用到了定时器通道上，导致每次定时器更新都拉低一次片选，编码器角度周期性跳变，电流环拿到错误位置自然发疯。从那以后我养成了一个习惯：初始化之后先把所有外设的复用功能表打出来核对一遍，尤其是 GPIO 重映射，绝不只依赖配置工具的默认图形。有些坑是示波器都难抓的，靠的是代码审查习惯。希望这几条踩坑经验能帮你少走弯路。

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