简介：面向使用 JY901 与 MPU9050 惯性测量模块的嵌入式开发者，这份 docx 文档聚焦磁场与加速度的现场校准，适合需要提升姿态解算精度、排查零偏和安装误差的初中级硬件调试人员。压缩包仅含 1 个 docx，大小约 16KB，篇幅紧凑，便于随工程资料归档和快速查阅。内容围绕磁场校准、加速度校准和寄存器读取展开，说明了平面校准与三维校准的适用场景、偏移值取最大值与最小值中点的方法、水平放置时三轴加速度期望值换算，以及指令间隔、配置保存和寄存器回读的数据包格式。文中还给出三轴偏移寄存器写入指令、加速度常值偏差计算和 READADDR 回读方式，可帮助读者对照模块输出定位校准异常。已有 702 人学习，可作为模块初次标定、二次校准和通信指令核对的操作参考。

1. 硬铁偏移不是噪声：为什么 JY901 校准算法要先「清零再采样」

JY901 校准算法配 MPU9050 这类九轴模块，最反直觉的一点是：它根本不改善噪声。你把磁力计三轴偏移写成 0 再采一遍数据，会发现抖动幅度一模一样，只是数据的中心点从偏离原点的位置被搬回了原点。很多人第一次做校准，盯着串口曲线以为能看到「变平滑」，结果什么都没变，于是怀疑算法没生效——其实它生效了，只是它治的不是这个病。传感器输出的漂移里，有很大一块是固定的常数项：PCB 上的扬声器、螺丝、走线电流在磁力计上叠了一个恒定磁场，芯片本身的零点也有几十个 LSB 的偏差。常数项不清掉，姿态解算会把一个固定的错误当成真实姿态，航向随时间单向跑偏，这就是玄学漂移的主要来源。搞懂这套校准，等于搞懂「零偏」和「噪声」是两件必须分开处理的事。

2. 寄存器协议：五字节指令帧和 READADDR 回读到底怎么走

这套校准全部建立在一条极简的串口协议上：写寄存器、读寄存器、保存。理解协议层的帧结构，后面所有的校准步骤才不会变成「照着指令表抄」。

2.1 五字节定长帧与 100ms 间隔的物理原因

写寄存器的帧是定长 5 字节：0xff 0xaa ADDR DATAL DATAH。前两字节是帧头，第三字节是寄存器地址，后两字节是 16 位数据，低字节在前。整个写指令没有校验和，靠的是帧头同步——0xff不会出现在地址位（寄存器表最大到 0x63），所以模块在字节流里找0xff 0xaa就能可靠地对齐帧边界。

100ms 的间隔不是拍脑袋定的。模块主循环里串口接收是轮询式的，收到一帧要解析、更新内部变量，写偏移类寄存器还可能触发一次非易失存储的准备动作。两条指令背靠背发出去，第二条很容易落在模块还没处理完第一条的窗口里，被当成上一帧的残余字节丢掉，或者直接粘成一包导致后续所有帧错位。指令表里反复强调「每条指令需间隔 100ms」，本质是给模块留一个确定性的处理窗口。

提示：间隔是下限不是建议值。用上位机手工点发送时人眼间隔天然够，一旦改成脚本批量发，就必须显式 sleep。

2.2 READADDR 回读：一次拿到连续四个寄存器的窗口

读寄存器走的是另一条路径。先往READADDR(0x27)写一个起始地址，比如要读AXOFFSET(0x05)，就发0xff 0xaa 0x27 0x05 0x00。模块回一个 11 字节的包：

0x55 0x5f D1L D1H D2L D2H D3L D3H D4L D4H SUM

D1是你指定的那个寄存器，D2、D3、D4是它后面连续三个。这个设计很讲究：寄存器表本身就是连续布局，AXOFFSET 0x05、AYOFFSET 0x06、AZOFFSET 0x07、GXOFFSET 0x08正好四个一组，一次回读就能原子地看到一整组三轴偏移加一个相邻量，不用分四次读、也就不会读到「改了一半」的中间态。SUM是前面所有字节累加取低 8 位，常见的实现思路是这样，用来挡住串口误码。

回读的窗口是「起始地址往后连续四个」，不能随便跳。想读HXOFFSET(0x0b)就得以 0x0b 为起点，拿到的 D2、D3 是 0x0c、0x0d，正好凑成磁三轴，这也是为什么校准步骤里检查磁场偏移时总是从 0x0b 起读。

2.3 把收发封装成可复现的代码

手工发指令验证一次可以，做校准必须脚本化。下面这层封装把帧构造、字节序、间隔全吃掉：

import struct import time SOF = b"\xff\xaa" # 固定帧头，模块靠它做帧同步 SAVE_ADDR = 0x00 # 保存配置寄存器 READADDR = 0x27 # 回读起始地址寄存器 def write_reg(ser, addr, value, gap=0.1): """写单个 16 位寄存器。value 可为负，按小端 int16 打包。""" frame = SOF + bytes([addr]) + struct.pack("<h", value) ser.write(frame) ser.flush() time.sleep(gap) # 给模块留处理窗口，低于 0.1s 有丢帧风险 def read_regs(ser, addr, gap=0.1): """从 addr 起连续读 4 个寄存器，返回 4 个 int16。""" ser.write(SOF + bytes([READADDR, addr, 0x00])) ser.flush() time.sleep(gap) buf = ser.read(11) # 包头2 + 数据8 + 校验1 if len(buf) != 11 or buf[0] != 0x55 or buf[1] != 0x5F: raise IOError("回读帧异常: %s" % buf.hex()) payload = buf[2:10] return list(struct.unpack("<4h", payload)) # 四个小端 int16

struct.pack("<h", value)里的<表示小端、h表示有符号 16 位，这一步替掉了手写HxOffsetL/HxOffsetH的拆字节工作，也顺手避免了一个高频翻车点：负偏移拆字节。比如 -312 写成小端是0xC8 0xFE，只要你把高低字节顺序搞反，模块读到的就是一个 +65 左右的正数，偏移直接错一个量级。

read_regs里先校验帧头再解包，是因为串口缓冲区里可能残留上一次的响应，不校验就解包会解出看起来「合理」的垃圾值。

3. 磁场校准：最大最小值中点法为什么能吃掉硬铁误差

磁力计校准是整套流程里最需要理解几何图像的部分。不理解为什么转一圈就能算出偏移，步骤就只是动作。

3.1 硬铁与软铁：中点法只负责椭球的圆心

理想情况下，模块在空间中任意姿态下测得的三轴磁场，矢量模长应该是一个常数——采样点分布在一个以原点为球心的球面上。现实中两类误差会破坏这个球。

硬铁误差来自固定磁源：板载的磁性元件、附近的结构件、大电流走线，它们在模块位置叠加了一个方向和大小都不随姿态变化的恒定磁场。数学上就是球心从原点平移到了某个位置(bx, by, bz)。你转模块时，采样点仍然是一个球，只是球心歪了。

软铁误差来自高导磁材料对磁场的畸变，它和姿态相关，会把球拉成椭球、还可能旋转主轴。中点法(Max+Min)/2无论怎么转都只能求出一个平移量，对椭球的拉伸和旋转无能为力。这是这套算法明确的能力边界，不是缺陷。

明白了这一点，HxOffset = (HxMax + HxMin) / 2的含义就清楚了：在所有姿态里，X 轴读数的最大值和最小值分别出现在球心两侧的对称位置，两者相加除以二，恰好就是球心在 X 轴上的坐标。三个轴各算一次，就得到了偏移向量的三个分量。

3.2 平面校准与三维校准：采样几何决定了 Z 轴有没有被激励

两种校准方式的区别，不是精度高低，而是你的采样几何能不能覆盖三个轴。

平面校准把模块放平，绕 Z 轴缓慢旋转 360°。这个动作里 X、Y 分量在水平面内画了一个完整的圆，HxMax/HxMin和HyMax/HyMin都能被充分激励，中点可信。但 Z 分量在这个过程中几乎不变——重力方向没变，模块相对地磁场的倾角没变，所以HzMax和HzMin相差极小，中点算出来基本等于当时的Hz读数本身。换句话说，平面校准对 Z 轴偏移的估计是无效的。它适用于俯仰和滚转都在小角度范围内变化的场景，此时 Z 轴偏移错误对航向的影响被姿态矩阵压得很小；一旦倾斜角变大，这个未校准的 Z 轴偏移就会被放大到航向输出上，表现为「平放很准，一倾斜航向就跳」。

三维校准则是绕 X 转 360°、绕 Y 转 360°、绕 Z 转 360°，最后再随意转几圈。前三个动作各自把一个轴的采样范围拉满，最后「随意转几圈」是补漏——让采样点尽量均匀地铺满整个球面，这样极值才真正是极值，而不是某个方向还没被转到就停止统计。

判断采样是否充分的判据原文给得很直接：最大值与最小值不再发生变化。实操上这个判据要打个折扣，因为噪声会让极值一直小幅跳动。更稳的做法是给一个稳定窗口，连续若干轮统计里极值变化小于阈值就认为收敛。

3.3 偏移计算、写回与采样循环的实现

采样阶段的代码结构就是一个持续跑的极值跟踪器，中间靠人工或判据决定何时收尾：

def track_extremes(ser, read_mag, rounds=600, stable_rounds=50, eps=2): """持续读取磁场，跟踪三轴极值，连续 stable_rounds 轮无变化则认为收敛。""" ext = {"x": [32767, -32768], "y": [32767, -32768], "z": [32767, -32768]} still = 0 for _ in range(rounds): hx, hy, hz = read_mag(ser) # 读 HX/HY/HZ（0x3a~0x3c） for k, v in zip("xyz", (hx, hy, hz)): ext[k][0] = min(ext[k][0], v) # 记最小值 ext[k][1] = max(ext[k][1], v) # 记最大值 if all(ext[k][1] - ext[k][0] > 0 for k in "xyz"): still += 1 if still >= stable_rounds: break offset = {k: (ext[k][0] + ext[k][1]) // 2 for k in "xyz"} # 中点即球心 span = {k: ext[k][1] - ext[k][0] for k in "xyz"} # 跨度用于判断采样质量 return offset, span

offset就是三个轴要写回的值，span是副作用但很有用的诊断量：正常三维校准后三个轴的跨度应该在同一量级（地球磁场模长在各轴上的投影范围）。如果 Z 轴的span明显小于 X、Y，说明模块基本没被翻转过，采到的其实是平面数据，此时应当退回平面校准的结论或者重做。

写回时按 0x0b、0x0c、0x0d 三个地址依次发，每条间隔 100ms，最后必须发0xff 0xaa 0x00 0x00 0x00保存。这一步是断电保留的唯一途径，不发的话所有偏移只活在 RAM 里，重新上电全部归零。

4. 加速度校准：单点 1g 参考为什么就够用

加速度的校准比磁场简单得多，简单到容易被误解成「随便点点」。它的成立条件其实很明确，一旦越过条件就会出问题。

4.1 2048 LSB/g 的来历与单点参考的成立条件

模块水平静止放置时，三轴加速度的理论输出是[0g, 0g, 1g]。换算成传感器原始值就是[0, 0, 2048]，这个 2048 来自量程：16 位有符号输出的满量程是 32768，对应 ±16g 的加速度量程，32768 / 16 = 2048，也就是 1g 对应 2048 个 LSB。所以水平面上 Z 轴读到 2048 附近才算正常。

校准过程是：先把三轴偏移写 0，水平放稳，多次读取取平均得到(ax0, ay0, az0)，然后算e = (ax0, ay0, az0 - 2048)。这个e就是常值偏差，把它写回 0x05、0x06、0x07，模块后续输出会自动把它减掉。

这里面藏着一个硬前提：2048 这个基准值只在量程配置没被动过的时候成立。如果之前改过ACCRANGE(0x21)寄存器，把量程调到了别的档位，每 g 对应的 LSB 数就不再是 2048，照原样算出来的ez会是一个巨大的错误值，写进去之后 Z 轴输出直接废掉。校准时用到的所有物理常数，都必须和当前配置匹配。

第二个前提是「水平」这两个字要当真。桌面本身不水平、模块外壳有装配公差、PCB 焊在壳里有倾角，都会让重力分量漏到 X、Y 轴上。X、Y 的理论值是 0，所以任何一点倾角都会被当成零偏计算进去，校准后模块在真正水平时反而读出一个固定的假倾斜。

4.2 多次读取取平均：把量化噪声压到偏移量以下

单次读取的量化步长是 1 LSB，对 16g 量程来说约等于 0.49mg，看起来很细。但实际噪声远大于量化步长——电源纹波、板子振动、人手触碰都会带来几个到几十个 LSB 的抖动。取平均的目的就是把这个抖动压下去，让估出来的零偏主要反映真实偏差而不是这一次采样的运气。

样本量的选择不用太纠结，一百到两百次足够。有意思的是采样的分布特征：如果平均值和最小值、最大值之间的差距仍然很大，说明采样期间模块被碰了或者台面在震，这批数据就不该用。

def read_acc_avg(ser, read_acc, n=128): """连续读 n 次加速度求均值，用于抑制随机抖动。""" sx = sy = sz = 0 for _ in range(n): ax, ay, az = read_acc(ser) # 读 AX/AY/AZ（0x34~0x36） sx += ax; sy += ay; sz += az return sx // n, sy // n, sz // n def acc_calibrate(ser, read_acc): for addr in (0x05, 0x06, 0x07): # 先清零，否则采到的是被补偿过的值 write_reg(ser, addr, 0) ax0, ay0, az0 = read_acc_avg(ser) ex, ey, ez = ax0, ay0, az0 - 2048 # 理想水平输出为 (0,0,2048) for addr, val in ((0x05, ex), (0x06, ey), (0x07, ez)): write_reg(ser, addr, val) write_reg(ser, 0x00, 0) # SAVE，落到非易失存储 return ex, ey, ez

函数开头的清零不能省，原因在第 5 章会展开——这是最高频的翻车点。写回的ex、ey、ez直接调write_reg，小端打包和间隔都在封装里处理掉了。

4.3 零偏校准的能力边界：只搬零点，不动斜率

这套加速度校准只做了一件事：把一个常数平移量减掉。它不修正灵敏度误差（每个轴每 g 对应多少个 LSB 的实际偏差），也不修正轴间对准误差（X 轴对 Y 轴的串扰），更不修正温漂。

灵敏度误差在实践中确实存在，典型表现是：水平校准做得很干净，模块静止时输出完美，但翻转 90° 让某个轴承受到 1g 时，读数偏离 2048 有百分之几。这种误差单点校准是分离不出来的，因为一个方程里塞了两个未知数——零偏和斜率。要分离它们，至少得让这个轴经历两个不同的已知加速度状态，也就是常说的多面法：把模块分别以六个面朝下放置，每个面记录一组数据，用正反两个姿态解出零偏和斜率。

温漂更麻烦，它是随时间缓慢变化的量，出厂校一次、用户校一次都挡不住。工程上的常见做法是开机静置时做一次快速自校准，或者用温度传感器建模补偿。这套算法没有涉及，属于设计取舍的一部分。

5. 常见问题排查：校准做完了航向还是漂，问题出在哪

以下五条是从实际调试记录里收出来的高频问题，每条按现象、原因、解决三步写。校准本身不难，难的是每一步都有静默失败的余地。

5.1 采样阶段：清零遗漏与环境干扰

第 1 条：没清零就采样，越校越偏。

现象：写回偏移后，航向偏差比校准前更大，而且偏移寄存器的数值明显偏离预期。

原因：偏移寄存器的值是「模块当前正在使用的补偿量」。不清零直接采样，读到的数据已经是补偿过的，再算一次中点，等于把旧偏移又算了一遍，写回去就变成了双重补偿。

解决：严格按流程先把目标三轴偏移写0x0000，等 100ms 生效后再开始采样。判断是否清零成功最直接的办法是回读该寄存器，确认读回值是 0 再往下走。

第 2 条：采样环境里有铁磁干扰，极值被拉偏。

现象：校准后静止航向稳定，但模块一靠近某个位置（比如靠近桌面边缘、靠近设备外壳某侧）航向就跳；或者同一台设备两次校准得到的偏移值相差很大。

原因：极值统计对异常值极其敏感。采样过程中如果附近有电机、扬声器、螺丝刀、手机，磁场极值会被这些外来磁源拉走，算出来的中点跟着偏。

解决：采样时把模块从设备上拆下来单独做，远离金属台面和大电流线缆；校准完装回去之后再验证。装回后如果航向有明显偏移，说明安装位置本身有恒定干扰，应该在最终安装姿态下重做一次。

5.2 写入与保存阶段：间隔、字节序和 SAVE

第 3 条：指令发太快，只有部分轴生效。

现象：回读三个偏移寄存器，发现只有一个或两个变成了新值，第三个还是旧的；或者写完之后姿态数据出现跳变。

原因：连续发送间隔不足 100ms，模块解析队列来不及处理，后续帧被丢弃或错位对齐。写指令没有校验和，错了也不会报错，只会静默失败。

解决：所有写操作之间强制 sleep 100ms 以上；每次写完后用READADDR回读该地址确认值正确。回读验证是唯一可靠的确认手段，不能省。

第 4 条：字节序写反，偏移变成巨大正数。

现象：回读偏移寄存器得到一个很大的正数（几千到几万），姿态输出随即失控。

原因：HxOffsetL是低字节、HxOffsetH是高字节，顺序写反相当于把值乘了 256 再做符号扩展。负偏移尤其容易出问题，因为补码表示下高低字节差异巨大。

解决：用struct.pack("<h", value)统一处理，不要手写拆字节；写完必须回读比对，回读值和计算值不等就重发。这条我吃过一次亏，一个 -300 多的偏移被写成正数之后，航向表现得像罗盘被磁铁吸住一样。

第 5 条：忘了发 SAVE，断电全丢。

现象：校准完当场测试一切正常，设备断电重启后航向回到校准前的水平，偏移寄存器读回全是 0。

原因：偏移写入只改了运行时的寄存器，没有写入非易失存储。保存必须显式发0xff 0xaa 0x00 0x00 0x00。

解决：把 SAVE 作为校准流程的最后一步固定下来，写在函数里而不是靠人记。保存后重新上电回读一次，才算真正完成。

5.3 验证阶段：怎么判断校准真的生效

校准做完不等于做对。最有效的验证判据是磁模长：把模块在空间中随意翻转若干圈，记录每次的sqrt(Hx² + Hy² + Hz²)，如果硬铁校准到位且环境干净，这个值应该基本恒定，波动幅度就是残余误差。波动大的时候，要么是软铁误差没被处理（中点法本来就处理不了），要么是采样极值没收全。

第二个判据看倾斜一致性：把模块平放记录一次航向，再倾斜 45° 记录一次，两次的航向差应该很小。如果倾斜后偏差明显变大，几乎可以断定是 Z 轴磁场偏移没校准好——平面校准做出来的数据就是这个特征。

加速度的验证更直接：水平静止时看三轴输出是否接近(0, 0, 2048)，把某个轴翻到朝下看是否接近 -2048，两头都对得上说明零偏基本干净。

6. 设计取舍：为什么是极值中点法，而不是椭球拟合

把整套算法拆完，会发现它的每一个选择都在往「确定性」上靠，而不是往「理论最优」上靠。

极值中点法在数学上确实粗糙。它对异常值零容忍，采样时旁边有个磁源就能把结果带偏；它也无法处理软铁误差，椭球的拉伸和旋转完全没被修正。相比之下，椭球拟合能同时解出偏移、缩放和旋转九个参数，理论上限高得多。但椭球拟合要求采样点在整个球面上均匀分布，还要解一个非线性最小二乘。让一个普通用户拿着设备「随意转几圈」，转出来的点在球面上是极度不均匀的——大部分集中在几个常见姿态附近，拟合出来的参数在没采到数据的区域可能比不拟合还离谱。中点法虽然只解三个参数，但它对采样分布不敏感，只要每个轴的极值被采到过，结果就是对的。这是个典型的用鲁棒性换精度的取舍，在用户端校准这个场景里换得值。

加速度只做零偏校准也是同一个逻辑。六面法能解出零偏和灵敏度，代价是用户必须精确地把六个面分别朝下，还得保证每个面都真的水平。这一步对产线可行，对现场使用不现实。而零偏恰恰是误差里最大的那一项，先把它搬走，剩下的灵敏度误差在消费级应用里通常可以接受。

这套方案还隐含了一个假设：误差是常数。温度变了、装到别的设备上了、附近多了个磁源，之前的校准就全部作废。它没有温度补偿，没有在线估计，就是一锤子买卖。所以真正要提升精度，路径不是在这套算法里加参数，而是把它当成基线——先保证零偏干净，再考虑加温度建模或者在应用层做航向的在线修正。

我现在的习惯是，任何一次校准之后都强制走一遍「回读偏移 + 磁模长波动 + 倾斜一致性」这三项验证，不管当时多赶。有一次为了省时间跳过了回读，结果字节序写反的偏移安静地躺在寄存器里，直到设备装到机器上跑了一整天才被发现，返工的时间远超那一次验证的十秒钟。校准这件事，最贵的从来不是算法本身，而是「你以为它生效了」。希望帮到你。

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