STM32 HAL库轮询驱动AS5600磁编码器实战指南

简介这份资源面向使用STM32 HAL库进行嵌入式开发的初学者与进阶工程师聚焦I2C总线读取AS5600磁编码器角度数据的实现方案采用不加DMA的轮询方式便于理解底层时序与寄存器操作逻辑。压缩包共111个文件以73个.h头文件与26个.c源文件为核心涵盖STM32F4系列HAL驱动、I2C与定时器外设配置另含.ioc工程配置、.uvprojx与.uvoptx Keil工程文件、.hex烧录固件及.bat辅助脚本整体约1016KB结构完整可直接编译运行。示例代码通过AS5600_Read_DMA接口读取角度寄存器串口打印角度值与圈数方便对照调试。目前已有1071人学习下载适合需要快速搭建编码器采集环境、掌握I2C通信与角度换算思路的开发者参考借鉴。1. 磁编码器选型与I2C轮询方案的取舍AS5600 这颗磁编码器在电机控制、旋钮交互和云台角度反馈里出现频率很高12 位分辨率、非接触式测量、I2C 接口价格也不贵。但很多人第一次把它接到 STM32 上用 HAL 库的 I2C 轮询方式读取时会发现数据要么全是 0要么偶尔跳变甚至读几次就卡死在HAL_I2C_Master_Transmit里。问题往往不在 AS5600 本身而在于对 I2C 时序、寄存器地址和 HAL 库阻塞机制的理解偏差。这篇笔记只讲一件事不加 DMA纯轮询方式用 STM32 HAL 库把 AS5600 的角度数据稳定读出来。适合手头有 STM32 开发板、想快速验证磁编码器方案、又不想一上来就折腾 DMA 和中断的工程师。不加 DMA 意味着 CPU 会阻塞在 I2C 传输上但换来的是逻辑简单、调试直观、不依赖中断优先级配置。对于读取频率要求不高比如 100Hz 以内的场景这个方案完全够用而且更容易排查问题。我一般会先确认三个前提I2C 引脚是否接了对的上拉电阻、AS5600 的供电是否稳定在 3.3V、HAL 库的 I2C 初始化里时钟频率是否设成了 100kHz 或 400kHz。这三个条件不满足后面所有代码都是白写。2. AS5600 的寄存器映射与 HAL I2C 轮询读写2.1 先搞清楚 AS5600 的寄存器地址和读时序AS5600 的 I2C 从机地址是 0x367 位地址这一点在数据手册里写得很清楚但 HAL 库的HAL_I2C_Master_Transmit函数要求传入的是左移一位后的地址也就是 0x6C。这个细节不注意示波器上能看到 START 条件发出去了但从机就是不 ACK读回来的全是 0xFF。角度数据存放在两个寄存器里RAW_ANGLE 在 0x0C 和 0x0DANGLE 在 0x0E 和 0x0F。RAW_ANGLE 是未经线性化处理的原始值ANGLE 是经过内部校准后的值。大多数场景下读 ANGLE 就够了但如果你要做多圈累计或者发现角度跳变RAW_ANGLE 更有参考价值。读时序是标准的 I2C 寄存器读先发寄存器地址写操作再发从机地址加读位读操作然后连续读两个字节。HAL 库提供了HAL_I2C_Mem_Read函数可以直接指定寄存器地址和读取长度比手动拼 Transmit 和 Receive 更省事。// AS5600 寄存器定义 #define AS5600_I2C_ADDR (0x36 1) // HAL库要求左移一位 #define AS5600_REG_RAW_ANGLE 0x0C #define AS5600_REG_ANGLE 0x0E #define AS5600_REG_STATUS 0x0B // 读取角度值返回0-4095对应0-360度 uint16_t AS5600_ReadAngle(I2C_HandleTypeDef *hi2c) { uint8_t buf[2] {0}; HAL_StatusTypeDef ret; // 使用Mem_Read直接读取两个字节寄存器地址自动发送 ret HAL_I2C_Mem_Read(hi2c, AS5600_I2C_ADDR, AS5600_REG_ANGLE, I2C_MEMADD_SIZE_8BIT, buf, 2, 100); if (ret ! HAL_OK) { return 0xFFFF; // 错误标志调用者需判断 } // 高字节在前低字节在后拼成12位数据 return ((uint16_t)buf[0] 8) | buf[1]; }这段代码里I2C_MEMADD_SIZE_8BIT表示寄存器地址是 8 位AS5600 确实只用 8 位寄存器地址。超时参数设了 100ms实际在 100kHz 时钟下两个字节的传输远小于这个值设大一点是为了防止偶发的总线仲裁丢失导致死等。返回值用 0xFFFF 表示错误因为正常角度值最大是 4095不会冲突。2.2 HAL 库 I2C 初始化的几个关键参数用 CubeMX 生成 I2C 初始化代码时有几个参数直接决定轮询读取能不能稳定工作。时钟速度建议先设 100kHz等读通了再尝试 400kHz。占空比在 100kHz 下用 2:1 就行400kHz 时用 16:9 能获得更宽的高电平时间。模拟滤波器使能可以滤掉一些毛刺但会引入额外延迟如果总线很短、干扰小关掉也行。// I2C1 初始化100kHz7位地址模式 hi2c1.Instance I2C1; hi2c1.Init.ClockSpeed 100000; hi2c1.Init.DutyCycle I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 0; hi2c1.Init.AddressingMode I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode I2C_DUALADDRESS_DISABLE; hi2c1.Init.OwnAddress2 0; hi2c1.Init.GeneralCallMode I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode I2C_NOSTRETCH_DISABLE; if (HAL_I2C_Init(hi2c1) ! HAL_OK) { Error_Handler(); }NoStretchMode要设成 DISABLE允许从机拉低 SCL 做时钟拉伸。AS5600 在内部转换时会短暂拉伸时钟如果主机不允许拉伸读出来的数据可能错位。这个坑我在某次调试中踩过现象是角度值每隔几次就跳一下后来用逻辑分析仪抓波形才发现 SCL 被从机拉低了但主机没等。2.3 轮询读取的完整流程和状态判断实际使用中不能只读角度寄存器还要判断磁铁是否在位、是否太弱或太强。AS5600 的 STATUS 寄存器0x0B里有 MD、ML、MH 三个标志位分别表示磁铁检测、磁铁太弱、磁铁太强。上电后先读一次 STATUS确认 MD 为 1 且 ML、MH 为 0再开始读角度。// 检查磁铁状态返回0表示正常 uint8_t AS5600_CheckMagnet(I2C_HandleTypeDef *hi2c) { uint8_t status 0; HAL_I2C_Mem_Read(hi2c, AS5600_I2C_ADDR, AS5600_REG_STATUS, I2C_MEMADD_SIZE_8BIT, status, 1, 100); if ((status 0x20) 0) return 1; // MD0没检测到磁铁 if (status 0x10) return 2; // ML1磁场太弱 if (status 0x08) return 3; // MH1磁场太强 return 0; }主循环里先调AS5600_CheckMagnet返回 0 再读角度。如果磁铁没放好读出来的角度是随机的这时候去调 PID 或者做角度闭环就是给自己挖坑。我一般会在初始化阶段加一个 while 循环等磁铁状态正常了再往下走调试阶段可以加个串口打印提示。3. 不加 DMA 时怎么把读取周期压到 1ms 以内3.1 轮询方式的实际耗时测算不加 DMA 的情况下每次读角度都要走一遍完整的 I2C 传输START、发送从机地址写、发送寄存器地址、重复 START、发送从机地址读、读两个字节、STOP。在 100kHz 时钟下每个 bit 占 10us整个传输大约 25 个 bit 加上 ACK 位算下来差不多 300us 左右。如果主循环里还有其他任务实际读取周期可能到 500us 甚至更长。用 400kHz 时钟可以把单次传输压到 80us 以内但前提是总线上拉电阻合适、走线短、没有其他慢速设备。我实测过在 400kHz 下连续读 AS5600每次耗时约 75us加上函数调用开销1ms 内读 10 次没问题。但如果你的板子上 I2C 挂了多个设备或者走线比较长400kHz 可能不稳定这时候老老实实用 100kHz。// 简单的周期读取用SysTick做时间基准 uint32_t last_tick 0; uint16_t angle 0; while (1) { if (HAL_GetTick() - last_tick 1) { // 1ms周期 last_tick HAL_GetTick(); angle AS5600_ReadAngle(hi2c1); if (angle ! 0xFFFF) { // 角度有效转成0-360度浮点数 float deg angle * 360.0f / 4096.0f; // 这里可以做后续处理 } } // 其他任务 }HAL_GetTick()默认是 1ms 递增所以最小周期就是 1ms。想更快的话得用定时器做微秒级计时但轮询方式下没必要因为 I2C 传输本身就占了几百微秒再快也快不到哪去。3.2 用定时器触发轮询读取的写法如果不想在主循环里用HAL_GetTick()判断可以配一个基本定时器比如 TIM6每 500us 产生一次更新中断在中断里置个标志位主循环检测到标志位就去读 I2C。这样读取周期更稳定不受主循环其他任务影响。// TIM6 中断回调500us周期 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM6) { i2c_read_flag 1; } } // 主循环 while (1) { if (i2c_read_flag) { i2c_read_flag 0; angle AS5600_ReadAngle(hi2c1); // 处理角度 } }注意不要在定时器中断里直接调HAL_I2C_Mem_Read因为 HAL 库的 I2C 函数内部有超时等待在中断里阻塞会打乱其他中断的响应。标志位法虽然多了一次判断但安全得多。3.3 读取失败时的重试策略I2C 总线受干扰时偶尔会 NACK 或者超时这时候不能直接放弃也不能无限重试。我一般设 3 次重试每次间隔 1ms3 次都失败就标记传感器离线等下一周期再试。uint16_t AS5600_ReadAngleWithRetry(I2C_HandleTypeDef *hi2c, uint8_t retries) { uint16_t val 0xFFFF; for (uint8_t i 0; i retries; i) { val AS5600_ReadAngle(hi2c); if (val ! 0xFFFF) break; HAL_Delay(1); } return val; }HAL_Delay在中断上下文里不能用所以这个重试函数只能在主循环里调。如果是在定时器标志位触发的读取流程里把重试逻辑放在主循环处理标志位的那段代码里就行。4. 避坑AS5600 轮询读取的五个血泪教训4.1 现象读回来全是 0xFF示波器上看不到 ACK原因从机地址没左移。HAL 库的HAL_I2C_Mem_Read第一个参数要求是 8 位地址AS5600 的 7 位地址 0x36 左移一位是 0x6C。直接传 0x36 的话HAL 库会把它当成 8 位地址发出去从机根本不认。解决确认代码里用的是0x36 1或者直接写 0x6C。用逻辑分析仪抓一下波形看第一个字节是不是 0x6C。4.2 现象角度值每隔一段时间跳变一次幅度不大但很规律原因AS5600 内部有自动增益控制磁场强度变化时会短暂调整期间角度输出可能不稳定。另外如果电源纹波大也会导致内部 ADC 抖动。解决在电源引脚旁边加 100nF 和 10uF 电容磁铁和芯片的距离保持在 0.5mm 到 3mm 之间。软件上可以对连续读到的角度做滑动平均比如取 4 次读数的中间值。4.3 现象程序跑几分钟后卡死在 I2C 传输里原因I2C 总线被干扰后从机把 SDA 拉低不放主机等不到总线空闲。HAL 库的超时机制在某些情况下不会触发因为HAL_I2C_Mem_Read内部的超时判断依赖于HAL_GetTick()如果 SysTick 中断被更高优先级中断屏蔽了超时就不生效。解决给 I2C 传输设一个外部看门狗或者在主循环里检测HAL_I2C_GetState返回值发现异常就调HAL_I2C_DeInit再HAL_I2C_Init重新初始化总线。更彻底的办法是用硬件 I2C 复位功能但 STM32 的 I2C 外设复位需要手动操作寄存器。4.4 现象CubeMX 里配了 400kHz实际波形只有 100kHz 左右原因I2C 时钟源配置不对。STM32 的 I2C 时钟来自 APB1如果 APB1 分频系数太大I2C 外设的输入时钟不够就算寄存器里设了 400kHz实际输出也达不到。解决检查 SystemClock 配置里 APB1 的频率确保它至少是 I2C 目标时钟的 4 倍以上。比如要跑 400kHzAPB1 最好在 16MHz 以上。4.5 现象读到的角度和实际磁铁角度对不上偏差固定原因AS5600 的零位没有校准。芯片出厂时有一个默认零位但磁铁的安装角度和芯片的相对位置会导致零点偏移。解决把磁铁转到你想要的零位读一次 ANGLE 值把这个值存到变量里作为偏移量后续读数都减去这个偏移。或者用 AS5600 的 ZPOS 寄存器0x01 和 0x02写入零位但写寄存器需要先解除写保护操作稍麻烦。5. 用串口打印和滑动平均验证读取稳定性5.1 串口打印角度值的格式和频率验证读取是否稳定最直接的办法是把角度值打到串口助手上看。格式用printf(%.2f\n, deg)每 10ms 打一次这样一秒钟 100 行串口助手能实时刷新又不会刷太快看不清。如果角度值在磁铁静止时跳动超过 0.5 度说明要么电源有噪声要么磁铁没固定好。// 每10ms打印一次角度 if (HAL_GetTick() - last_print 10) { last_print HAL_GetTick(); uint16_t raw AS5600_ReadAngle(hi2c1); if (raw ! 0xFFFF) { float deg raw * 360.0f / 4096.0f; printf(ANGLE: %.2f\n, deg); } else { printf(I2C ERROR\n); } }printf重定向到串口需要实现fputc函数这个在 CubeMX 生成的代码里加一段就行。注意printf本身耗时在 115200 波特率下打印一行大概 1ms所以打印频率不能太高否则会影响读取周期。5.2 滑动平均滤波的参数选择如果角度值有轻微跳动加一个滑动平均滤波就能压下去。窗口大小取 4 或 8太大响应会变慢。用环形缓冲区实现每次新数据覆盖最旧的数据然后求平均。#define FILTER_WIN 4 uint16_t angle_buf[FILTER_WIN] {0}; uint8_t buf_idx 0; uint16_t AS5600_FilteredAngle(I2C_HandleTypeDef *hi2c) { uint16_t raw AS5600_ReadAngle(hi2c); if (raw 0xFFFF) return 0xFFFF; angle_buf[buf_idx] raw; buf_idx (buf_idx 1) % FILTER_WIN; uint32_t sum 0; for (uint8_t i 0; i FILTER_WIN; i) { sum angle_buf[i]; } return sum / FILTER_WIN; }这个滤波对静态抖动有效但如果磁铁在快速旋转窗口太大会导致角度滞后。窗口取 4 时在 1kHz 读取频率下滞后约 2ms对大多数电机控制场景够用。如果转速很高要么减小窗口要么换更复杂的滤波算法。5.3 用已知角度验证线性度拿一个分度盘或者自己画个角度刻度把磁铁转到 0 度、90 度、180 度、270 度看串口打印的值和实际角度差多少。AS5600 的线性度在数据手册里标的是 ±0.5 度以内如果偏差超过 2 度检查磁铁是不是偏心或者倾斜了。磁铁和芯片表面的平行度对精度影响很大歪一点误差就上去了。我一般会在产品组装前用这个方法快速筛一遍把偏差大的先挑出来免得装到整机上再返工。这个习惯帮我省过不少后悔药。5.4 长时间运行的老化观察让设备连续跑几个小时串口记录角度值看有没有偶发的 0xFFFF 或者跳变。如果有统计一下发生频率和间隔判断是电源问题还是总线干扰。我遇到过某批次板子跑 2 小时后开始偶发 NACK最后查出来是 I2C 上拉电阻用的是 10k换成 4.7k 就稳了。上拉电阻这个参数在短走线下 10k 能用但长时间运行或者温度变化后裕量就不够了。希望帮到你。本文还有配套的精品资源点击获取