简介：面向使用STM32 HAL库开发角度测量应用的嵌入式工程师，提供一套基于硬件SPI接口读取TLE5012B角度传感器的完整工程资源。压缩包内共有170个文件，源码、头文件等占比最高，同时包含Keil工程配置、编译中间文件、PDF数据手册及说明文档，整体仅5.5MB，便于下载和学习二次开发。工程严格遵循TLE5012B数据帧格式，通过HAL库的SPI_Transmit与SPI_Receive函数完成命令发送和数据接收，并对16位返回数据进行角度值换算，还利用传感器内置诊断功能监测运行状态，已针对STM32F4系列完成适配。目前已有1179人学习，适合需要快速在STM32平台上实现高精度旋转位置检测的开发者。读者可参照该工程完成驱动移植、SPI参数配置、数据校验逻辑验证，也可直接嵌入电动汽车、工业自动化等需要监测旋转角度的系统中。整套工程结构清晰，从SPI初始化、寄存器操作到角度解析均有对应代码，能够帮助开发者少走弯路，快速验证传感器性能。 不用看手册翻来覆去也能把 TLE5012B 用起来，这件事本身并不难，真正折磨人的是时序细节。项目标题里这几个词拆开看都没什么门槛——STM32 HAL 库、硬件 SPI、TLE5012B，但合在一起，你会在 CS 拉低之后的那几百微秒里把 STM32 的 SPI 外设、TLE5012B 的帧格式、HAL 库的收发机制全部重新认识一遍。这篇文章就以我实际调通的工程为蓝本，把硬件 SPI 读取 TLE5012B 的完整链路拆开讲清楚，包括 CubeMX 配置、帧结构分析、代码实现、以及我踩过的几个典型坑。合适的人群：想用 STM32 读角度传感器做电机控制、云台、旋钮、机器人关节反馈的开发者，以及对 HAL 库 SPI 时序控制还不太熟练的朋友。
1. 项目概述与整体设计思路
1.1 为什么选 TLE5012B 和硬件 SPI
TLE5012B 是英飞凌的一款 GMR 角度传感器，360° 范围内精度能做到 0.1° 级别，抗磁场干扰能力也不错，最关键的是它直接输出数字角度，不需要 ADC 采样、不需要自己标定磁铁角度。相比 AS5047P 这类同样常用的角度传感器，TLE5012B 价格更友好，而且 SPI 读取的逻辑更加直观，适合快速上手。
读取接口上有两种选择：硬件 SPI 和软件模拟 SPI。软件模拟 SPI 的优点是引脚随便选、时序自己掌控，缺点是占用 CPU、速度受限，而且一旦主循环里来了中断，时序容易被拉乱。硬件 SPI 的优势是速度快、不占 CPU、配合 DMA 更是可以把读取频率拉到很高，适合对实时性有要求的应用。既然标题里明确说了硬件 SPI，那我们就老老实实用 SPI 外设来做，我这里用的是 STM32F103C8T6，HAL 库版本 1.8.0，跑的是 72MHz 主频，SPI 时钟配到 4.5MHz，实测非常稳定。
1.2 TLE5012B 的 SPI 帧结构，这是理解一切的钥匙
TLE5012B 的 SPI 命令帧是 16 位。Bit15 是读写标志位，读操作为 1；Bit14 是锁存位，我们需要在读取角度时保证角度数据在某一时刻被锁存；Bit13 和 Bit12 是更新位，决定了传感器在命令之后如何更新数据；Bit11 到 Bit0 是寄存器地址。
读取角度数据的寄存器是 0x03，所以读命令就是 0x8003。帧结构是：主机先发送 16 位命令，然后 TLE5012B 返回 16 位状态字 + 16 位角度数据。这里需要注意的是，TLE5012B 的 SPI 模式是 Mode 3，即 CPOL = 1、CPHA = 1。很多人第一次读全是 0xFFFF，就是因为把 SPI 模式配成了 Mode 0，时序完全对不上。
还有一个很关键的点：TLE5012B 返回的角度数据是左移了一位的。也就是说寄存器里的原始数值需要右移一位才是真实角度。如果你的代码里直接拿原始值换算角度，转一圈会得到两倍的角度值，这个坑特别隐蔽。
2. 硬件接线与 CubeMX 配置要点
2.1 接线方式和片选选择
TLE5012B 的标准接法需要 4 根线：SCK、MOSI、MISO、CS。这里我强烈建议 CS 用普通的 GPIO 引脚控制，不要用 SPI 的硬件 NSS。原因有两个：第一，TLE5012B 的帧是“命令 + 数据”两段式结构，CS 必须在整个帧传输期间保持低电平，硬件 NSS 的自动拉高时机比较难精准控制，容易出现帧错位；第二，如果以后一个 SPI 总线上挂多个传感器，用 GPIO 做片选可以灵活切换，不受外设 NSS 限制。
我这边实际接线是：PA5 接 SCK，PA7 接 MOSI，PA6 接 MISO，PB12 接 CS，全部直连，没有加外部上拉电阻。TLE5012B 工作在 3.3V，STM32F103 也是 3.3V 系统，电压匹配没问题。
2.2 CubeMX 配置中的关键参数
CubeMX 配置这块我直接列出我实际使用的参数：
- SPI 模式：Full-Duplex Master
- 数据大小：8 Bit（不是 16 Bit）
- 时钟极性 CPOL：High
- 时钟相位 CPHA：2 Edge
- NSS：Disable（软件控制）
- 波特率分频：16（72MHz / 16 = 4.5MHz）
- 首 bit：MSB First
有几个容易出问题的细节我必须单独拎出来讲。第一，数据大小建议选 8 Bit，不要选 16 Bit。TLE5012B 的帧虽然是 16 位对齐的，但实际读取过程需要你连续发送多个字节，用 8 位模式配合数组发送，控制上更灵活，后续解析数据也方便。第二，波特率分频不要选太小，TLE5012B 的最高 SPI 时钟是 8MHz，加上布线寄生电容和飞线的影响，我建议先在 4.5MHz 或者更低频率下调通逻辑，再慢慢把频率加上去。第三，NSS 一定要 Disable，否则 SPI 外设会试图控制片选引脚，和你的软件片选逻辑冲突。
这里还需要提一下 CubeMX 生成代码之后，在 main 函数里要记得调用 MX_SPI1_Init()，并且确认 GPIO 初始化里 PB12 被配置为 Output Push Pull。如果用的是标准库，初始化方式略有不同，但思路完全一致。
3. 核心代码实现与角度换算
3.1 HAL 库 SPI 收发函数的正确打开方式
HAL 库的 SPI 收发函数是 HAL_SPI_TransmitReceive()，它是全双工同时收发。这个函数有一个需要注意的细节：发送缓冲区和接收缓冲区的长度必须一致，而且接收缓冲区的前几个字节对应的是你发送出去的命令内容，不是传感器返回的数据。
针对 TLE5012B，我定义了一个固定的命令帧格式：发送 4 个字节，前两个字节是读命令 0x80、0x03，后两个字节是填充字节 0x00、0x00。接收缓冲区也是 4 个字节，前两个字节是命令回显，后两个字节才是真正的角度数据。代码如下：
uint8_t spi_tx_buf[4] = {0x80, 0x03, 0x00, 0x00}; uint8_t spi_rx_buf[4] = {0}; void TLE5012B_ReadAngleRaw(uint16_t *raw_angle) { HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_RESET); HAL_SPI_TransmitReceive(&hspi1, spi_tx_buf, spi_rx_buf, 4, 10); HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_SET); *raw_angle = (spi_rx_buf[2] << 8) | spi_rx_buf[3]; }这段代码的执行流程是：CS 拉低，启动一次 4 字节的全双工交换，完成之后 CS 拉高。所谓全双工，就是 STM32 在发送命令字节的同时，也在从 MISO 上收集 TLE5012B 返回的数据。因为 TLE5012B 是边接收命令边准备数据，所以在发完命令之后继续发送两个填充字节，正好可以把传感器返回的剩余数据完整收回来。
3.2 角度数据换算，这里必须向右移一位
拿到原始数据之后，角度换算公式是：
float TLE5012B_GetAngle(void) { uint16_t raw = 0; TLE5012B_ReadAngleRaw(&raw); raw = raw >> 1; // 去掉最低位，角度数据左移了一位 float angle = (float)raw * 360.0f / 32768.0f; return angle; }除以 32768 是因为角度数据分布在 15 个 bit 上，也就是 0 到 32767 对应 0° 到 360°。0x00 对应 0°，0x8000（右移后是 0x4000）对应 180°，0xFFFF（右移后是 0x7FFF）对应的角度接近 360°。
我的实测数据：把磁铁固定在传感器正上方，手动旋转 90 度，程序读到的角度从 0.4° 变到 90.2°，重复精度在 0.1° 左右，对于大多数应用场景完全够用。这里我建议你在使用之前先做一次偏移校准，把传感器安装到机械中位时读到的角度存为偏移量，后续角度值都减去这个偏移量，这样能消除贴片和磁铁安装带来的初始误差。
4. 常见问题与排查实录
4.1 读回来一直是 0xFFFF 或者 0x0000
这个是最常见的问题，我在第一次调试时候也遇到了。0xFFFF 通常意味着 MISO 上没有有效数据，原因一般有两个：SPI 模式不对，或者接线有问题。先检查 CubeMX 里的 CPOL 和 CPHA 是不是 Mode 3，也就是 CPOL = High、CPHA = 2 Edge。如果配置正确，再用示波器或者逻辑分析仪抓一下 MISO 引脚，看看 CS 拉低期间 MISO 上有没有波形。没有波形就是接线松了或者传感器没上电，有波形但全是高电平，大概率是 SPI 模式还是不匹配。
还有一种情况是读出来 0x0000，这个大概率是你在解析时没有跳过命令回显。如果你只发送 2 个字节就收工，接收缓冲区第一个字节是命令回显，第二个字节才是数据的高字节。如果你的代码里用的是(rx_buf[0] << 8) | rx_buf[1]，拿到的就是命令回显和状态字节，换算出来当然不是正常角度。
4.2 角度值翻倍，转一圈变成了 720 度
这个问题在第一次把传感器转起来的时候很容易懵。角度值随旋转变化没错，但转满一圈数值走到了 720° 对应的码值。原因我在前面说过，TLE5012B 返回的原始数据是左移了一位的，你没有右移一位就直接乘了 360/32768。
排查方法很简单：把传感器缓慢旋转 90 度，如果读数值变化量接近 180 度的码值，那就说明确实忘掉右移了。加了一句raw >>= 1;之后，所有问题迎刃而解。这个坑属于那种查手册查不到、看例程又容易忽略的类型，分享出来希望后面的人少走弯路。
4.3 SPI 时钟频率过高导致数据偶发跳动
如果 SPI 时钟分频配得太狠，比如 72MHz 主频直接 2 分频得到 36MHz，远超 TLE5012B 的 8MHz 上限，读出来的角度数据就会偶发跳变，而且跳变毫无规律。这是因为传感器输出数据还没准备好，SCK 时钟就已经把它采样走了，拿到的自然是不完整的字节。
我建议先用 4.5MHz 验证整套逻辑，稳定之后可以尝试 8MHz，但不建议超过这个值。TLE5012B 的数据手册明确写了最大 SCK 频率，超出后没有任何保证。另外，如果使用了杜邦线连接，线长超过 10cm，建议把频率降到 2MHz 左右，或者换用屏蔽线。高速 SPI 对信号完整性是有要求的，不要小看这几根线。
4.4 硬件 NSS 与软件片选的取舍细节
我还见过一种写法是开启 SPI 的硬件 NSS 功能，把 CS 接到 NSS 引脚上。理论上可行，但实际效果并不好。HAL 库对硬件 NSS 的控制时机在某些场景下和 TLE5012B 要求的帧时序匹配不上，特别是当你连续读取角度数据时，CS 拉高的时间窗口稍微偏一点，下一帧解析就会错位。
所以我强烈建议用软件片选，也就是 GPIO 手动控制 CS。这个选择不仅适用于 TLE5012B，很多 SPI 传感器都建议这样处理。毕竟软件片选只是多一条 GPIO 控制语句，却能省掉 NSS 时序不匹配的排查时间，这笔账很划算。
5. 进一步优化：DMA 读取与连续采样
5.1 用 DMA 释放 CPU 占用
如果你的应用需要高频读取角度，比如电机 FOC 控制中要 10kHz 以上的采样率，那么 CPU 轮询发送的方式就有点吃力了。HAL_SPI_TransmitReceive() 是阻塞式函数，4 字节的交换长度虽然不长，但在高主频下也意味着几百个时钟周期的等待。改成 DMA 方式后，CPU 只要启动一次传输，就可以去处理其他任务，传输完成后再触发中断通知你取数据。
DMA 配置流程：CubeMX 里把 SPI1 的 TX 和 RX 都加上 DMA，优先级设成 Medium，模式设为 Normal。代码里在每次读取角度时调用 HAL_SPI_TransmitReceive_DMA()，然后在传输完成回调函数里解析数据。需要注意的是，DMA 模式下缓冲区必须是全局变量或者 static 变量，不能用局部数组，因为 DMA 是后台传输，函数退出后局部数组就被回收了，会造成不可预期的错误。
5.2 如何把采样率拉高
实测下来，4.5MHz SPI 时钟 + 4 字节帧，单次读取需要的时间大约是 8 微秒。这个速度对于大部分应用来说已经非常快了。如果你追求极限，可以把 SPI 时钟提到 8MHz，单次读取时间能压到 4 微秒左右，配合 DMA 不间断传输，理论上采样率可以做到 100kHz 以上。但这时候要注意磁铁的转速——如果转速过快，TLE5012B 内部的角度锁存可能跟不上，读出来的角度会滞后真实位置，这种滞后在高转速下是无法完全消除的，只能通过算法补偿。
如果是做低速云台或者旋钮，那我建议不要追求极限频率，稳定优先。用 4.5MHz SPI 时钟，搭配 1kHz 的读取速率，CPU 占用率几乎可以忽略不计，系统的鲁棒性也高很多。
我个人的经验是，TLE5012B 这个传感器本身非常皮实，只要 SPI 模式配对了、CS 时序没毛病，基本不会出大问题。真正需要花心思的是后续的数据处理——滤波、偏移校准、零位标定，这些才是让角度数据真正好用起来的关键。先从最基本的读角度开始，跑通了再往上加功能，这个节奏是最适合新手的。
本文还有配套的精品资源，点击获取
