AS5600磁编码器实战：I2C寄存器配置、磁路自检与多圈标定

简介：面向嵌入式开发者以及机器人、自动化方向学习者的AS5600磁编码器开发资料包，围绕角度测量与位置检测需求，整理中英文手册及STM32、Arduino两套示例源码，可用于传感器通信调试、数据读取与项目集成练习。压缩包共606个文件、约11.81MB，以C语言源文件、头文件、汇编启动文件为主，辅以工程配置、库文件及两份PDF手册，覆盖STM32F0工程与Arduino示例等内容，便于按平台查找参考。已有2997人学习下载。读者可结合手册理解硬件结构、电气特性、接口协议与噪声处理思路，并从源码中参考初始化、数据读取、中断处理等实现方式，用于智能小车、无人机导航或精密机械的位置检测方案验证与二次开发。

1. 从一颗 SSOP-16 到 0.0879 度：AS5600 磁编码器能解决什么问题

调云台或者小功率无刷电机的时候，最难受的不是 PID 调不出来，而是反馈本身就不可信：电机锁得住，一加负载角度就慢慢漂，示波器上看驱动波形干干净净，问题全藏在位置反馈里。AS5600 就是在这种场景里被大量拿来救场的器件——非接触式磁角度传感器，12 位分辨率，一圈切 4096 份，单步折合 0.0879 度，I2C 直接读角度寄存器，另外还有 PWM 和模拟电压两路输出兜底，主控换成 STM32 还是 Arduino 都不影响接线逻辑。它适合做旋钮、关节、舵机、云台这类中低速角度反馈，不适合拿去做高速电机的换相环，这一点后面还会展开。这套中英文手册加 STM32、Arduino 双份源码的资料包，价值不在代码有多长，而在寄存器表和时序图能让你少走弯路。

2. 资源包结构拆解：中英文手册、STM32 工程与 Arduino 示例各自管什么

拿到一个资料包，先别急着打开 IDE 编译。我一般的习惯是先花十分钟把目录翻一遍，搞清楚哪部分负责“查”、哪部分负责“跑”、哪部分负责“改”。这个 AS5600 包的结构大致是下面这个形状，不同整理版本在文件夹命名上会有出入，但分层逻辑基本一致。

AS5600_资料/ ├── datasheet/ # 查：一切以这里为准 │ ├── AS5600_DS_CN.pdf # 中文手册，寄存器表在这 │ ├── AS5600_DS_EN.pdf # 英文原版，中文有歧义时对照 │ └── AS5600_AN_Magnet.pdf # 磁铁选型与安装应用笔记 ├── stm32/ │ └── AS5600_F103/ # 跑：HAL 库工程，Keil/CubeIDE 可直接开 │ ├── Core/Inc/as5600.h # 寄存器地址、宏定义 │ ├── Core/Src/as5600.c # 读角度、读状态、写配置 │ └── Core/Src/main.c # 串口打印角度的最小例程 ├── arduino/ │ ├── AS5600_BasicRead/ # 最短路径，验证硬件死活 │ ├── AS5600_SerialPlot/ # 带滤波的串口示波器输出 │ └── AS5600_MultiTurn/ # 多圈计数示例 └── tools/ └── i2c_scan_note.txt # 扫描地址和常见故障排查记录

2.1 手册部分：寄存器表比源码更值钱

真要把这颗芯片用稳，中文手册里那几张表要反复翻：寄存器映射表（0x00 到 0x0D 这一段）、CONF 寄存器的位定义表、STATUS 寄存器的三位状态标志。源码里的宏和函数只是把这些表翻译成 C 语言，表看不懂，代码抄过去也只是照猫画虎。

英文版别当摆设。中文手册在“慢滤波”“快速滤波阈值”这类描述上偶尔会有翻译得比较绕的句子，比如 SF 位对应的 2x/4x/8x/16x 到底放大的是采样次数还是延迟时间，两边对着看一遍比猜快得多。应用笔记那份讲磁铁选型和气隙的文档，实际调试时的参考价值甚至高于数据手册正文，因为绝大多数读数为啥跳、为啥 AGC 值飘，答案都在磁路那一侧，而不在代码里。

2.2 STM32 工程：从 HAL 初始化到角度读取的调用链

STM32 那份源码是标准的 HAL 结构，I2C 外设初始化交给 CubeMX 生成的MX_I2C1_Init()，业务部分被单独抽到as5600.c里，头文件只暴露寄存器地址和几个函数原型。这种拆法的好处是你把它挪到自己工程里时，只需要改一个I2C_HandleTypeDef指针的入参，别的基本不动。

调用链很短：main()里初始化 I2C，然后循环调用as5600_read_angle()，拿到 0 到 4095 的原始计数，乘 360 除 4096 换成角度，printf打到串口。这份工程真正值得抄的是错误处理——I2C 读失败返回 0xFFFF 这种哨兵值，调用方必须判，不判就会出现“角度突然变成 359 度”的幽灵现象，这一点第 5 章会专门讲。

2.3 Arduino 示例：最短路径验证硬件是否活着

Arduino 那三个示例的价值是“五分钟判断硬件有没有焊错”。AS5600_BasicRead里没有滤波、没有标定，就是Wire.begin()加两次传输读 0x0E/0x0F，串口监视器里能看到角度随磁铁转动连续变化，说明接线、上拉、地址全对，剩下的事再去 STM32 上做。

SerialPlot那个示例加了滑动平均，配合 Arduino IDE 自带的串口绘图器，能直观看出静止时的抖动幅度，是判断滤波参数够不够的第一个依据。MultiTurn示例则是给需要连续转多圈的应用准备的，用相邻两次采样的差值判断过零方向，逻辑简单但边界条件处理得比较细。

提示：先用 Arduino 把硬件跑通，再上 STM32 做产品代码，这个顺序能省掉大量“到底是硬件问题还是固件问题”的扯皮。

3. 硬件落地：SSOP-16 接线、磁铁安装与第一次 I2C 扫描

软件写得再漂亮，磁铁装偏了照样白搭。这一章按“先通电、再通磁、最后通信”的顺序走，每一步都有可以量化的判据。

3.1 引脚定义与最小系统接线

AS5600 是 SSOP-16 封装，真正需要接的其实只有五六根线，剩下的引脚要么是多个地，要么是给不同电压域准备的。下面这张表是我自己画板子时贴在原理图旁边的版本，接线时照着对一遍。

两根 I2C 线的上拉电阻别省，很多模块板子上自带了 10k，走线稍长就会出现读写偶发失败。上拉值我习惯用 4.7k，速率 100kHz 起步，跑通了再试 400kHz。供电必须干净，芯片旁边放一颗 100nF 加一颗 1uF，电机驱动板旁边取电的话尤其要注意，电源纹波会直接变成角度噪声。

DIR 脚是个容易被忽略的细节：它决定的是芯片内部角度增加的方向，而不是你代码里的符号。板子上把它硬接 GND 之后，磁铁逆时针转角度是增大还是减小就固定了，后面软件里想反一下，要么改 DIR 的接法，要么在计算时做4095 - raw，两种方式别混用。

3.2 磁铁怎么装：轴向距离、偏心与 DIR 方向

AS5600 检测的是芯片正上方磁场的旋转，所以磁铁必须是径向充磁的圆柱或方块磁铁，放在芯片中心正上方，轴向距离一般在 0.5mm 到 3mm 之间。距离太远磁场弱，AGC 会自动加大增益，噪声跟着放大；太近磁场强，STATUS 里的 MH 位会亮起来。

偏心比距离更致命。磁铁圆心和芯片中心偏差超过 0.5mm，读出来的角度就会呈现明显的正弦形误差，转一圈误差能到好几度，这种误差在代码里根本修不掉。我的做法是先用一个简单夹具把磁铁固定在芯片上方的轴心上，用手转一圈看串口数据，角度曲线平不平滑基本就能判断机械装配过没过关。

方向问题也要在装配阶段定死。磁铁装反（N/S 面对调）不会烧芯片，但角度会整体反相；磁铁用轴向充磁而不是径向充磁，读数会变得极其不稳定甚至完全不变化。这两个坑我在不同项目里各踩过一次，判断方法是看 STATUS 寄存器里的 MD 位（检测到磁铁）——MD 不为 1，说明磁场强度根本没进窗口，先别怀疑代码。

3.3 上电自检：用 STATUS / AGC / MAGNITUDE 判断信号健康度

上电之后的第一件事不是读角度，而是读三个体检指标：STATUS（0x0B）、AGC（0x1A）、MAGNITUDE（0x1B/0x1C）。STATUS 的最低三位分别对应 MH（磁场过强）、ML（磁场过弱）、MD（检测到磁铁），正常工作时 MD 为 1、MH 和 ML 为 0。

AGC 是一个自动增益值，磁铁位置合适时它应该稳定在一个中间区间，磁铁远了会往高处走，近了往低处走，数值大幅跳动说明磁路不稳定。MAGNITUDE 是原始磁场强度，只用来做相对比较，绝对值没有绝对意义，但同一块板子上静止时它应该是稳定的，抖动超过十几个 LSB 就说明供电或者磁铁有问题。

/* 上电自检：三个指标一次读完，先判健康再谈精度 */ uint8_t as5600_selfcheck(I2C_HandleTypeDef *hi2c) { uint8_t status = 0, agc = 0, mag[2] = {0}; if (HAL_I2C_Mem_Read(hi2c, AS5600_ADDR_W, AS5600_REG_STATUS, I2C_MEMADD_SIZE_8BIT, &status, 1, 10) != HAL_OK) return 1; /* I2C 都没通 */ if ((status & 0x20) == 0) return 2; /* MD 位为 0：没检测到磁铁 */ if (status & 0x08) return 3; /* MH：磁场过强，磁铁太近 */ if (status & 0x10) return 4; /* ML：磁场过弱，磁铁太远 */ HAL_I2C_Mem_Read(hi2c, AS5600_ADDR_W, AS5600_REG_AGC, I2C_MEMADD_SIZE_8BIT, &agc, 1, 10); HAL_I2C_Mem_Read(hi2c, AS5600_ADDR_W, AS5600_REG_MAGNITUDE, I2C_MEMADD_SIZE_8BIT, mag, 2, 10); if (agc < 0x20 || agc > 0xC0) return 5; /* 增益跑到两端，磁路不合格 */ return 0; /* 全部通过 */ }

这段函数的返回值直接对应一张故障表：1 查接线和上拉，2 查磁铁在不在、极性对不对，3 和 4 查气隙，5 查磁铁偏心或者供电。把返回值打到串口上，现场调试效率比盲猜高一个量级。STATUS 的位定义在不同版本的手册里顺序一致，但中文排版容易看串行，对照英文版确认一次比较稳。

4. 寄存器级代码拆解：CONF 配置、ANGLE 读取与零位标定

这一章是整份资料包的核心，STM32 和 Arduino 两份源码做的事本质上一样，只是 HAL 和 Wire 的封装不同。把这三段代码吃透，换成任何主控都能自己写。

4.1 读角度：0x0E/0x0F 两字节怎么拼

ANGLE 寄存器占两个字节，0x0E 是高字节，0x0F 是低字节，拼接之后只有低 12 位有效，高 4 位是保留位。I2C 读的时候要点是“先写寄存器指针，再读两字节”，并且这两个字节必须在同一次传输里连续读出，分两次读会出现高低字节来自不同采样时刻的问题，角度会跳。

/* 读一次角度，返回 0..4095；失败返回 0xFFFF 作为错误标记 */ uint16_t as5600_read_angle(I2C_HandleTypeDef *hi2c) { uint8_t buf[2] = {0}; if (HAL_I2C_Mem_Read(hi2c, AS5600_ADDR_W, AS5600_REG_ANGLE, I2C_MEMADD_SIZE_8BIT, buf, 2, 10) != HAL_OK) return 0xFFFF; /* 让调用方一定能看见错误 */ return (uint16_t)(((uint16_t)buf[0] << 8) | buf[1]) & 0x0FFF; } /* 换算成角度，错误直接传播出去 */ float as5600_read_deg(I2C_HandleTypeDef *hi2c) { uint16_t raw = as5600_read_angle(hi2c); if (raw == 0xFFFF) return -1.0f; /* 负角度表示本次读取无效 */ return raw * 360.0f / 4096.0f; }

AS5600_ADDR_W是左移一位之后的 8 位地址，HAL 库要的是这一版，Arduino 的 Wire 库要的是 7 位原值，这个差异在第 5 章会单独拎出来讲。超时参数给 10ms 是保守值，100kHz 下传两个字节远用不了这么久，给宽一点可以避免总线被拉低时的死等。0x0FFF这个掩码不能省，磁铁位置不好的时候高四位偶尔会读出非零值，不掩会把错误数据带进角度换算里。

Arduino 侧的等价实现更短，但坑一样：endTransmission(false)里的 false 表示不发停止位，让总线保持占用状态紧接着做requestFrom，这个参数写错就会读回全 0xFF。

#include <Wire.h> static const uint8_t AS5600_ADDR = 0x36; /* Arduino 用 7 位地址，不左移 */ uint16_t readAngle() { Wire.beginTransmission(AS5600_ADDR); Wire.write(0x0E); /* 指向 ANGLE 高字节 */ if (Wire.endTransmission(false) != 0) return 0xFFFF; /* false：不发 STOP */ if (Wire.requestFrom(AS5600_ADDR, (uint8_t)2) != 2) return 0xFFFF; uint16_t hi = Wire.read(); uint16_t lo = Wire.read(); return ((hi << 8) | lo) & 0x0FFF; }

4.2 配 CONF：滤波、迟滞与输出级怎么取舍

CONF 是 16 位寄存器，拆成 0x07 高字节和 0x08 低字节两次写。高字节管四件事：电源模式 PM、迟滞 HYST、输出级 OUTS、PWM 频率 PWMF。低字节管慢滤波 SF、快速滤波阈值 FTH 和看门狗 WD，位序以手册的 CONF 表为准，动手前对一遍表比背下来可靠。

迟滞是个双刃剑：加 1 LSB 能让静止时的读数不来回跳一个字，但会带来约 0.088 度的死区，闭环控制里死区会直接体现成稳态误差。我的做法是先在 HYST 为 0 的情况下测静止抖动，抖动在 ±1 LSB 以内就不加迟滞，靠软件滑动平均解决；抖动超过 ±3 LSB 说明是磁路或者电源的问题，加迟滞只是把症状盖住。

电源模式同理。LPM 系列会降低内部采样率，静态功耗下来了，但响应变慢、噪声变大，只有电池供电的旋钮类产品才值得考虑。电机控制场景一律 PM=00，别为了省几毫安把反馈质量搭进去。

/* CONF 只改高字节，低字节保持默认，写完立刻回读验证 */ uint8_t as5600_config(I2C_HandleTypeDef *hi2c) { uint8_t conf = (0u << 0) /* PM = 00 正常功耗 */ | (1u << 2) /* HYST= 01 迟滞 1LSB */ | (0u << 4) /* OUTS= 00 模拟满量程，I2C 场景不影响 */ | (3u << 6); /* PWMF= 11 920Hz，用 PWM 输出时才生效 */ if (HAL_I2C_Mem_Write(hi2c, AS5600_ADDR_W, AS5600_REG_CONF_H, I2C_MEMADD_SIZE_8BIT, &conf, 1, 10) != HAL_OK) return 1; uint8_t back = 0; if (HAL_I2C_Mem_Read(hi2c, AS5600_ADDR_W, AS5600_REG_CONF_H, I2C_MEMADD_SIZE_8BIT, &back, 1, 10) != HAL_OK) return 2; return (back == conf) ? 0 : 3; /* 3 表示写进去了但回读不一致 */ }

回读这一步别嫌啰嗦。CONF 是易失寄存器，上电默认值能用但未必适合你的场景，而写入失败又不会报错，只有回读才能确认。这套“写—回读—比对”的模式在后面写 ZPOS 时同样要用。

4.3 零位与行程：ZPOS / MPOS 的用法和 OTP 烧写边界

ZPOS（0x01/0x02）和 MPOS（0x03/0x04）构成一个可编程的角度窗口：ZPOS 是窗口起点对应的原始计数，MPOS 是终点。ANGLE 寄存器输出的是经过这个窗口处理后的值，RAW ANGLE 则是没处理过的原始值。做机械限位或者把某个安装位置定义为 0 度时，改 ZPOS 比在软件里减偏移更干净，因为下游拿到的就是已经对齐的角度。

/* 把当前位置设为 0 度：写 ZPOS，不烧 OTP，掉电丢失 */ uint8_t as5600_set_zero(I2C_HandleTypeDef *hi2c) { uint16_t cur = as5600_read_angle(hi2c); if (cur == 0xFFFF) return 1; uint8_t d[2] = { (uint8_t)(cur >> 8), (uint8_t)(cur & 0xFF) }; if (HAL_I2C_Mem_Write(hi2c, AS5600_ADDR_W, AS5600_REG_ZPOS, I2C_MEMADD_SIZE_8BIT, d, 2, 10) != HAL_OK) return 2; HAL_Delay(10); /* 给内部逻辑一点时间生效 */ uint16_t after = as5600_read_angle(hi2c); return (after < 32 || after > 4064) ? 0 : 3; /* 期望落在 0 附近 */ }

这段代码有两个边界必须清楚。第一，ZPOS 写入是易失的，断电重启回到默认值，如果产品需要出厂即对齐，得用 OTP 烧写，而 OTP 的烧写次数是有上限的（手册里明确写了次数，别拿它当普通寄存器反复试），烧之前一定先用易失方式验证参数对不对。第二，写 ZPOS 之后 RAW ANGLE 不变、ANGLE 变，验证时要读 0x0E 而不是 0x0C，读错寄存器会以为标定没生效。

MANG（0x05/0x06）是最大角度，配合 MPOS 可以把输出范围压缩到比如 0 到 180 度，超出的部分输出会被钳位。做有限转角的关节时这个功能很实用，省掉软件里的限幅判断，但要注意钳位之后角度不再单调，闭环里如果依赖角度连续性做微分，钳位区间会产生假的速度尖峰。

5. 避坑与排查：五个让我返工的 AS5600 现场问题

这一章全是真实踩过的坑，按“现象 → 原因 → 解决”组织，能对号入座就别自己再试一遍。

5.1 通信类：读回全 0xFF 或者干脆扫不到设备

现象：Arduino 上requestFrom返回 0 或者读回全是 0xFF，STM32 上HAL_I2C_Mem_Read返回 HAL_ERROR，逻辑分析仪上看 SDA 一直是被拉低的状态。

原因：最常见的是地址搞错了位宽。芯片的 7 位地址是 0x36，Arduino 的 Wire 库接收 7 位地址，直接写 0x36；STM32 HAL 库要 8 位地址，必须写成0x36 << 1也就是 0x6C。把 0x36 直接喂给 HAL，读出来必然是错的。第二常见的是上拉电阻缺失或阻值太大，模块自带的 10k 在长导线上上升沿太缓，100kHz 都跑不稳。

解决：先用 I2C 扫描程序确认总线上能看到 0x36，扫不到就别往下走。扫到了但读失败，把速率降到 100kHz、上拉换成 4.7k 再试。还不行就查 PGO 引脚，它被误接到 VDD 时芯片进编程模式，正常读写行为会变。

5.2 磁路类：角度线性度差、AGC 值满量程跑

现象：用手匀速转一圈，串口打出来的角度不是线性增长，而是明显带正弦波动，误差一两度；同时 AGC 值要么贴着上限要么贴着下限，MAGNITUDE 抖动很大。

原因：磁铁偏心了，或者气隙超出了推荐范围。偏心带来的是一次谐波误差，靠软件标定很难压到 0.1 度以内；气隙不对则让 AGC 进入非线性区，增益本身就在制造噪声。还有一种情况是用了轴向充磁的磁铁，磁场方向和芯片检测方向不匹配，读数会变得毫无规律。

解决：先换径向充磁磁铁，再用夹具把磁铁圆心对到芯片中心，偏差控制在 0.5mm 以内，气隙从 1mm 开始试。判断标准是 AGC 落在中间区间且静止时不跳，MAGNITUDE 的峰峰值小于十几个 LSB。机械这一关不过，后面所有软件滤波都是白忙。

5.3 数据类：静止时读数来回跳一个字，闭环里听得到啸叫

现象：电机静止，角度在相邻两个 LSB 之间反复横跳，速度环算出来的速度在 ±1 之间抖，电机发出轻微的高频声。

原因：12 位分辨率下 1 LSB 就是 0.0879 度，静止时噪声让读数在量化边界上翻转是正常物理现象，不是芯片坏了。另外 I2C 读取频率太高（比如 10kHz 轮询）会把电源和总线上的噪声更多地耦合进来。

解决：软件侧做 4 到 8 点的滑动平均，或者用过零判断加死区，代价是引入几毫秒延迟；硬件侧在芯片电源脚旁边补 100nF，I2C 走线远离电机相线。用速度环的时候，速度不要用相邻两次采样的差值直接除，采样间隔太短会把量化噪声放大十几倍，改成 5ms 或 10ms 固定窗口做差分，噪声立刻下来。

5.4 标定类：写完 ZPOS 以为生效了，重启又回到原样

现象：现场标定完，角度确实归零了，设备断电再上电，零位又偏了回去。

原因：ZPOS 写的是易失寄存器，掉电即失效。想永久保存必须走 OTP 烧写流程，而烧写需要把 PGO 拉高、按特定时序写 BURN 命令，且次数有限。另一个隐蔽原因是标定时读的是 RAW ANGLE，写 ZPOS 后验证却读了 ANGLE，两个值本来就不一样，误判成没写进去。

解决：区分“临时标定”和“出厂标定”两条路径。临时标定就在上电初始化时读一次当前角度写进软件偏移量，简单可靠；出厂标定才走 OTP，且必须先用易失方式把参数验证充分，确认无误再烧。验证统一读 ANGLE 寄存器 0x0E，别混着读。

5.5 集成类：换到 STM32 之后角度方向反了、量程不对

现象：同一套机械结构，Arduino 上角度顺时针增大，换到 STM32 工程里变成顺时针减小；或者读数只在 0 到 180 度之间变化。

原因：方向反了多半是 DIR 引脚接法不同，或者代码里一处做了4095 - raw另一处没做，两边叠加。量程不对则通常是 MANG 或 MPOS 被上一版程序写过还没恢复，芯片里留了旧配置。

解决：把方向处理收敛到一个地方，要么硬件 DIR 固定、软件不做反相，要么硬件固定一个方向、软件统一做反相，绝不允许两处都改。接手别人的板子时，上电先读一遍 ZPOS、MPOS、MANG、CONF 四个寄存器并打日志，确认芯片里没有历史遗留配置，这一步花三十秒，能省掉半天的困惑。

注意：这五类问题里有四类的根因不在代码。养成“先读 STATUS 和 AGC，再看角度”的排查顺序，能少走很多弯路。

6. 二次开发：把 AS5600 塞进闭环控制与批量标定流程

单圈角度读通之后，真正要落地还得解决两件事：连续多圈怎么计数，以及批量生产时零位和方向怎么统一。

多圈计数不要用浮点累加，用整数增量最稳。核心是利用 12 位计数的回绕特性：相邻两次采样差值超过半圈就认为是跨零，圈数加一或减一。下面这段是我在几个项目里都用过的写法，采样周期固定在 1ms 到 5ms 之间，太快会把噪声当跨界。

/* 多圈计数：raw 为本次角度，last 为上次角度，turns 为圈数 */ static uint16_t last_raw = 0; static int32_t turns = 0; int32_t as5600_multiturn_update(uint16_t raw) { if (raw == 0xFFFF) return turns * 4096 + last_raw; /* 读失败保持上次 */ if (last_raw > 3072 && raw < 1024) turns++; /* 正向跨零 */ else if (last_raw < 1024 && raw > 3072) turns--; /* 反向跨零 */ last_raw = raw; return turns * 4096 + raw; /* 连续计数，单位仍是 LSB */ }

3072和1024这两个阈值对应 3/4 圈和 1/4 圈，留出了 1/4 圈的容差，正常转速下不会误判。返回值是 LSB 单位的连续位置，乘360.0f / 4096.0f就得到连续角度，直接喂给位置环。速度环用它的差分，窗口取 10ms，比单圈差分干净得多。

批量标定走的是另一条路。产线上每台设备的磁铁安装角度都有几度偏差，靠人工调机械不现实，标准做法是在工装里放一个已知的基准位置，设备上电后自动执行一次标定：转到基准位，读当前 RAW 值，把这个值写进 ZPOS（易失），同时把方向标志写进 MCU 的 Flash 配置区，下次上电直接加载。这样 OTP 一次都不用烧，返修也不用担心烧写次数耗尽。

/* 产线标定：把基准位写进 ZPOS，方向存 Flash，不动 OTP */ typedef struct { uint16_t zero_pos; /* 基准位对应的原始计数 */ uint8_t direction; /* 0 正向，1 反向 */ uint16_t crc; /* 简单校验，防止 Flash 空片误读 */ } as5600_cal_t;

结构体里那个crc别省。Flash 空片读出来是全 0xFF，不校验就会把 0xFFFF 当成合法零位，表现是设备一出厂角度就整体偏了半圈，这种故障在实验室复现不了，到客户现场才爆发，属于典型的后悔药没处买。

还有个细节值得提前想清楚：如果产品既要 I2C 读数又要模拟输出给外部设备，OUTS 位得设成模拟模式，但这不影响 I2C 侧的行为，两者可以同时用。反过来，如果只需要 PWM 输出接一个简单的下位机，把 OUTS 设成 PWM、PWMF 选 920Hz，接收端用一个简单的定时器捕获就能解出角度，省掉一颗 MCU 的 I2C 外设。

最后说个我自己的教训。早期做一个关节模组，硬件同事把 DIR 直接接了 VDD，我在软件里又按“顺时针增大”写了控制逻辑，两处叠加导致方向反了，调试时怎么改 PID 都振荡。从那以后我每次接手新板子，第一件事都是把磁铁正转半圈、反转半圈，把 RAW ANGLE、ANGLE、STATUS、AGC 四个值打成一张表，确认方向和量程跟预期一致，才开始写控制代码。这个习惯帮我省下的返工时间，比任何滤波算法都值。希望帮到你。

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