1. 先想清楚：电子指南针到底要解决什么问题

做 HiChatBox 这个终端的时候，电子指南针功能一开始在需求表上只有一行字——“能显示方向”。真动手做才发现，这一行字背后藏着传感器选型、磁场校准、姿态补偿、干扰识别、UI 刷新策略五摊子事，任何一摊没处理好，用户拿在手里看到的就是一个乱转的指针。电子指南针功能开发最容易被低估的地方在于：它不是“读一个寄存器然后算个角度”这么简单，而是要把一个受环境严重影响的物理量，稳定地翻译成一个用户敢信的方向。

我先把结论摆前面：一个能用的电子指南针，本质上是一套“磁力计 + 加速度计 + 校准参数 + 干扰判定 + 滤波策略”的组合系统，算法只占其中三成工作量，剩下七成在标定、验证和异常处理上。这篇文章我会把 HiChatBox 上这套功能的完整开发路径拆开讲，包括为什么这么选、参数怎么算、代码怎么写、坑在哪里。适合正在做类似终端产品的固件工程师、做传感器应用的开发者，也适合刚接触磁力计、想搞明白“为什么我的指南针总是歪十几度”的同学。

先对齐几个基础概念，不然后面全是天书。磁力计测的是所在位置的三轴磁场强度，单位微特斯拉（μT）。地球本身有个磁场，水平分量指向磁北，垂直分量随纬度变化——在赤道附近几乎水平，在高纬度地区几乎垂直向下。磁力计读到的原始值 = 地磁 + 硬磁干扰（设备自身永磁体、扬声器、磁铁螺丝造成的固定偏移）+ 软磁干扰（金属结构把磁场“扭曲”造成的方向和比例畸变）+ 随机噪声。电子指南针要做的，就是从这一堆混着干扰的数字里，把“水平面上指向磁北的那个方向”拎出来。

再说明一点，磁北和真北不是一回事，两者之间差一个磁偏角，这个值随地理位置变化，国内不同区域能差好几度。HiChatBox 这类带卫星定位的终端可以直接用定位模块给出的位置反查磁偏角，也可以离线内置一张粗粒度的偏角表按经纬度网格查。这一步不做，方向显示永远比地图上的路偏那么一点，用户感知很明显。

1.1 从用户场景倒推功能边界

需求不能凭空写，我习惯先把使用场景列出来。HiChatBox 是手持带屏终端，指南针的核心场景大概四类：一是户外徒步时判断行进方向，要求静态精度高、指向稳；二是配合地图做朝向指示，要求响应快、跟手；三是给拍照/测距类功能提供参考朝向，要求短时间内的相对角度准；四是纯好玩，用户拿着转圈看指针转。四类场景对指标的要求完全不同——第一类要精度优先，第二类要响应优先，第三类要重复性优先，第四类要视觉流畅度优先。

倒推下来，功能边界就清楚了：静态航向误差控制在 ±3° 以内（校准良好、无干扰环境下），动态跟随延迟不超过 300ms，方向刷新率不低于 10Hz，磁干扰时必须有明确提示而不是硬撑着显示。这几个数字不是拍脑袋来的，±3° 是消费级终端的通行水准，再往上做要上更高等级的传感器和更严格的产线标定，成本不划算；300ms 延迟是人眼开始觉得“有点滞后”的门槛附近；10Hz 是屏幕刷新和肉眼舒适度的平衡点。

还有一个容易被漏掉的边界：什么时候不该显示方向。我的做法是设一道门槛，当检测到磁场总强度严重偏离当地理论值，或者三轴数据剧烈跳变时，直接把指针置灰并提示“附近有磁场干扰，请远离金属或磁铁”。宁可告诉用户不知道，也不要给一个错的方向——这是所有传感器类功能的通用原则，也是最容易被产品经理忽略的一条。

1.2 硬件与软件的责任怎么分

开发初期最容易吵起来的就是这个：精度不够是硬件的问题还是算法的问题。我的划分方式很明确——传感器本身的噪声、温漂、零点稳定性归硬件；固定偏移、形变畸变、姿态补偿、动态滤波归软件。硬磁偏移和软磁畸变虽然在物理上来自硬件结构，但它们是可以被标定掉的，所以归软件侧的校准模块处理。

具体到 HiChatBox 上，磁力计和加速度计是分开的两颗芯片，磁力计负责测磁场，加速度计负责测重力方向，两者数据在固件里做时间对齐后一起送进姿态解算。为什么不用六轴 IMU 里自带的磁力计？因为一体封装虽然省事，但芯片紧贴着主板上的大电流走线和扬声器，磁干扰环境更恶劣，反而不好处理。分开布局，磁力计可以放到板边远离干扰源的位置，灵活性高得多。

软件分层也顺手定下来了：底层是传感器驱动层，负责配置采样率、量程、读取原始数据；中间是校准与解算层，负责应用校准参数、做倾斜补偿、算航向角、跑滤波；上层是业务层，负责干扰判定、单位转换、UI 数据推送。这样分层的好处是，将来换传感器型号，只需要改驱动层，校准参数格式和解算逻辑不用动。

1.3 指标定义：精度、响应、功耗三条线

指标必须量化，否则没法验收。我列了一张表，把三条线的验收标准固定下来，后面所有测试都围绕它跑。

这张表里“倾斜 30° 时误差”是我特意加的。很多初版指南针在设备平放时挺准，一抬起来就歪到姥姥家——因为没做倾斜补偿，只用了水平面两个轴。用户在户外看指南针几乎不会把设备端得水平，这一项不过关，功能等于废的。

2. 传感器选型与硬件设计要点

选型这一步我没有一上来就翻参数手册，而是先把“不能接受什么”列清楚：不能接受需要频繁手动校准、不能接受温漂大到冬天和夏天差 10°、不能接受在扬声器工作时方向乱跳、不能接受功耗把整机续航拉垮。带着这几条去筛，范围就窄多了。

2.1 磁力计与加速度计的搭配逻辑

磁力计的核心参数看四个：分辨率、噪声密度、量程、内置校正能力。分辨率决定最小可分辨的角度变化，一般要求能在 0.15μT 级别分辨，对应大约 0.5° 的角度变化；噪声密度越低，静态时指针越稳，不用靠重度滤波硬压，压得越狠响应越慢；量程要覆盖地磁总场（大多数地区在 25μT 到 65μT 之间）加上干扰余量，选 ±1300μT 或 ±4900μT 这类档位都行，量程大一点抗饱和能力强，代价是分辨率略降；部分传感器内置了硬磁偏移寄存器，可以做粗校正，能省一点软件工作量，但别指望它替代完整校准。

加速度计这边要求低得多，能分辨 1° 左右的倾角就够用，重点看噪声和低功耗模式下的可用性。我当时的搭配思路是：磁力计选噪声优先的型号，加速度计选低功耗优先的型号，两者都用 SPI 或 I²C 挂到主控上，共用一条总线省引脚。为什么磁力计不选低功耗优先？因为指南针是间歇工作的，功耗压力没那么大，而噪声是每时每刻都在影响体验的，取舍很明确。

这里补一句选型的经验：别迷信规格书上的“航向精度 ±1°”。那个数字通常是在理想实验室环境、经过精密转台标定之后测出来的，跟你板子上的实际表现能差三倍。规格书看趋势，实测才算数。

2.2 布局布线与干扰源规避

磁力计的布局是整块板子最考验功底的地方。我先列了一份“嫌疑犯清单”：扬声器（永磁体，头号杀手）、振动马达（同样有磁体）、大电流走线（工作时产生的磁场随电流变化）、金属屏蔽罩（软磁材料，会扭曲磁场）、电池（部分电芯外壳有磁性）、螺丝和卡扣（有些合金带弱磁性）、屏幕背光升压电路（高频开关，产生交变磁场）。

处理顺序是：先挪位置，再改结构，最后才考虑软件补偿。HiChatBox 上磁力计最终放在主板右上角，距扬声器 22mm，距振动马达 30mm，距最近的电源走线 8mm 以上，且走线方向避开磁力计的敏感轴。屏蔽罩我特意在磁力计正上方开了一个窗口——因为铁质屏蔽罩会把地磁“吸”进去，造成严重的软磁畸变，开着窗口虽然牺牲一点电磁兼容性，但指南针精度提升明显。

注意：给磁力计做屏蔽是反直觉的操作。很多人第一反应是加金属罩“保护”它，结果地磁被屏蔽罩引导，读数直接失真。磁力计需要的是“远离干扰”，不是“隔绝干扰”。

还有一个细节值得说：HiChatBox 的外壳上有磁吸配件接口。这个设计一开始让指南针功能几乎报废——用户一吸附件，磁场强度直接翻几倍。后来在软件里加了磁吸检测，一旦识别到强磁吸附，界面自动切换到“指南针不可用”状态，并在配件移除后触发自动重新校准。产品形态决定了功能边界，这话一点不假。

2.3 电源与温度漂移的考量

磁力计的零点会随温度漂移，这是物理特性，没法根除，只能补偿。HiChatBox 的工作温度范围标称 -10℃ 到 45℃，实测下来从冷启动到整机升温稳定，磁力计零点能漂 1μT 到 3μT，折算成航向误差大概 2° 到 6°——足以让原本达标的精度掉出验收线。

处理办法是建温度补偿表。做法不复杂：把整机放进温箱，从 -10℃ 到 50℃ 每隔 5℃ 设一个点，每个温度点恒温 30 分钟后采集一组完整旋转数据，拟合出该温度下的硬磁偏移量，存成一张 13 点的表。运行时读片上温度传感器，落在两个点之间就做线性插值，把偏移量减掉。这张表在产线一次性写入，之后不用再动。

电源方面还有个坑：磁力计和屏幕背光共用一路 LDO 时，背光亮度变化会导致供电电压波动，间接影响读数。后来单独给传感器加了一颗低噪声 LDO，问题消失。这类问题排查起来非常费劲，因为现象是“调亮度指南针就偏”，很难第一时间联想到电源。

3. 核心算法：从三轴磁场到可信的航向角

算法部分是整个功能的心脏，我把它拆成三步走：先做倾斜补偿把设备姿态的影响消掉，再做校准把硬磁软磁的影响消掉，最后做滤波把噪声压下去。顺序不能乱，尤其是校准必须在倾斜补偿之后做归一化，否则拟合出来的椭球参数是错的。

3.1 倾斜补偿：为什么平放准、抬起就歪

只用 Mx 和 My 算角度，本质上是假设设备严格水平。一旦设备倾斜，重力方向的分量就会“漏”进水平分量里，算出来的角度自然错。倾斜补偿的思路是：先用加速度计算出当前姿态（俯仰角和横滚角），再把磁力计的三轴读数旋转回水平面，最后在水平面上算角度。

具体公式推导不复杂。设加速度三轴为 Ax、Ay、Az，磁力计三轴为 Mx、My、Mz，约定设备坐标系为 X 向右、Y 向前、Z 向上。俯仰角 pitch = asin(-Ax/g)，横滚角 roll = atan2(Ay, Az)，其中 g 是重力加速度模值。然后做旋转：

Xh = Mx·cos(pitch) + My·sin(roll)·sin(pitch) + Mz·cos(roll)·sin(pitch) Yh = My·cos(roll) - Mz·sin(roll) heading = atan2(-Yh, Xh) // 结果转成 0~360°

这几个式子我在纸上推了三遍才对上号，关键在坐标系定义——不同厂家的传感器轴向定义不一样，有的 Z 轴朝下，有的朝上，公式里的符号会全部反过来。判断方法很简单：设备平放、屏幕朝上，磁力计 Z 轴读数应该是负的（北半球地磁垂直分量向下）。如果是正的，说明轴向定义反了，公式要相应调整。

实际写代码时，atan2的入参顺序和符号最容易出错，建议先用已知角度验证：把设备指向正北，读出的 heading 应该接近 0°；转 90° 指向东，应该接近 90°。对不上就调整符号，别硬猜。

3.2 椭球拟合校准：把畸变的磁场“拉”回球面

理想情况下，设备在空中任意方向旋转，磁力计三轴读数应该落在一个以原点为球心、半径等于地磁总场强度的球面上。实际上，硬磁干扰把球心推离原点，软磁干扰把球压成椭球。校准要做的就是求出这个椭球的中心和形状，然后把读数映射回标准球面。

工程上有两种做法。极值法最简单：让用户转几圈，记录每个轴的最大最小值，偏移取 (max+min)/2，缩放取 (max-min)/2，然后归一化。优点是计算量小、可以在 MCU 上实时跑；缺点是只能处理轴对齐的干扰，遇到斜向的软磁畸变就抓瞎，而且对采样覆盖度要求高，用户转得不到位误差就大。

椭球拟合法准确得多。椭球的一般方程是：

a·x² + b·y² + c·z² + 2d·xy + 2e·xz + 2f·yz + 2g·x + 2h·y + 2i·z = 1

把每个采样点代入，得到一个超定线性方程组，用最小二乘解出九个参数，再反解出球心（硬磁偏移）和 3×3 变换矩阵（软磁校正矩阵）。我在产线校准和 App 端校准都用这套。下面是我在上位机验证时用的 Python 实现，跑通之后再翻译成 C：

import numpy as np def fit_ellipsoid(samples): # samples: N x 3 数组 x, y, z = samples[:, 0], samples[:, 1], samples[:, 2] D = np.column_stack([ x*x, y*y, z*z, 2*x*y, 2*x*z, 2*y*z, 2*x, 2*y, 2*z ]) ones = np.ones(len(samples)) # 最小二乘解 D @ p = 1 p, *_ = np.linalg.lstsq(D, ones, rcond=None) a, b, c, d, e, f, g, h, i = p A = np.array([[a, d, e], [d, b, f], [e, f, c]]) center = -np.linalg.solve(A, np.array([g, h, i])) # 变换到球： (s - center)^T A (s - center) = 1 + center^T A center k = 1.0 + center @ A @ center # 求 A 的“平方根”，得到把椭球拉成球的线性变换 w, v = np.linalg.eigh(A / k) T = v @ np.diag(np.sqrt(w)) @ v.T return center, T

校正时对每个原始读数做s_corr = T @ (s_raw - center)，得到的向量模值应该接近 1（或者说接近当地地磁总场强度，取决于归一化方式）。我在固件里把 T 存成 9 个 float，center 存成 3 个 float，一共 48 字节，塞进参数区绰绰有余。

提示：拟合前一定要剔除异常点。用户在转动过程中如果经过金属桌面或靠近磁铁，那些点的模值会明显偏离，混进最小二乘里会把整个椭球带歪。我的做法是先算所有点的模值中位数，剔除偏离中位数超过 30% 的点，再做拟合。这一步能把校准成功率从七成提到九成以上。

3.3 滤波与融合：让指针稳而不僵

校准解决的是“准不准”，滤波解决的是“稳不稳”。原始航向角数据叠加了传感器噪声和量化误差，直接显示会肉眼可见地抖，尤其是设备静止时。

第一层用滑动窗口平均，窗口长度取 5 到 8 个采样点。为什么不用更长？因为窗口越长延迟越大——按 10Hz 采样、窗口 8 点算，平均延迟就是 400ms，已经超出验收线了。这一层的目标是把高频噪声压到 ±0.5° 以内就行。

第二层做角度域的滤波要注意“跨零问题”。航向角在 0°/360° 边界处会跳变，直接做算术平均会在正北附近产生严重错误（比如 359° 和 1° 平均成 180°）。解决办法是先把角度转成向量（cos、sin 分别滤波）再转回角度，或者先算与参考角的最小角差再平均。我用的后者，实现简单、计算量小。

如果设备上还配了陀螺仪，可以做互补滤波，效果会更好：陀螺仪短期响应快、无干扰，但会积分漂移；磁力计长期稳定、但有噪声和干扰。用陀螺仪做高频分量、磁力计做低频校正，融合出来的角度既跟手又稳。HiChatBox 上有陀螺仪，我把这个融合也做了，实测动态跟随延迟从 350ms 降到 200ms 以内，代价是增加了约 0.3mA 的电流。

下面是固件里实际跑的航向角计算核心，去掉业务逻辑后的骨架：

typedef struct { float center[3]; float T[3][3]; float last_heading; float buf[8]; int idx; int cnt; } compass_t; static float wrap180(float a) { while (a > 180.0f) a -= 360.0f; while (a < -180.0f) a += 360.0f; return a; } float compass_update(compass_t *c, const float mag[3], const float acc[3]) { // 1. 去硬磁偏移并应用软磁校正 float m[3]; for (int i = 0; i < 3; i++) { m[i] = 0.0f; for (int j = 0; j < 3; j++) m[i] += c->T[i][j] * (mag[j] - c->center[j]); } // 2. 倾斜补偿 float g = sqrtf(acc[0]*acc[0] + acc[1]*acc[1] + acc[2]*acc[2]); float pitch = asinf(-acc[0] / g); float roll = atan2f(acc[1], acc[2]); float sp = sinf(pitch), cp = cosf(pitch); float sr = sinf(roll), cr = cosf(roll); float xh = m[0]*cp + m[1]*sr*sp + m[2]*cr*sp; float yh = m[1]*cr - m[2]*sr; float raw = atan2f(-yh, xh) * 180.0f / (float)M_PI; if (raw < 0.0f) raw += 360.0f; // 3. 角度域滑动平均，基于最小角差，规避跨零跳变 c->buf[c->idx] = raw; c->idx = (c->idx + 1) % 8; if (c->cnt < 8) c->cnt++; float ref = c->buf[(c->idx + 8 - c->cnt) % 8]; float sum = 0.0f; for (int i = 0; i < c->cnt; i++) { float v = c->buf[(c->idx + 8 - c->cnt + i) % 8]; sum += wrap180(v - ref); } float out = ref + sum / (float)c->cnt; if (out < 0.0f) out += 360.0f; if (out >= 360.0f) out -= 360.0f; c->last_heading = out; return out; }

这段代码有两个地方值得单独说。第一，ref取的是窗口里最老的那个点而不是固定参考，这样窗口整体跟进时不会产生系统性偏移。第二，校正矩阵 T 和偏移 center 是先算好存下来的，运行时不参与任何拟合计算，MCU 上只做乘加，开销可以忽略。

3.4 干扰判定：什么时候必须“认怂”

干扰判定的原理不复杂：校准好的数据，三轴模值应该基本稳定在当地地磁总场强度附近。一旦这个模值明显偏离，说明混进了额外磁场。工程实现上有两个细节：一是当地磁场强度从哪来，我的做法是用卫星定位的经纬度查一张内置的低分辨率世界地磁模型表，粗到 5°×5° 网格就够用，能查出总场强度的近似值；二是阈值怎么定，实测在无干扰环境下，模值波动在 ±3μT 以内，所以我把第一级阈值设在偏离 20%，触发“轻微干扰”提示；第二级设在偏离 50%，直接禁用指南针。

另外还加了一个动态判据：连续 5 帧内航向角变化超过 45° 且加速度没检测到旋转（说明不是用户在转设备），判定为磁场跳变，同样触发提示。这个判据能抓出“放在金属桌上突然乱转”这类场景，补上了纯模值判定的盲区。

4. 校准流程设计：从用户交互到产线实现

校准这件事，做得好不好直接决定用户第一次开箱的体验。我的原则是：能自动做的绝不麻烦用户，必须用户做的要把动作讲清楚到傻瓜级别。

4.1 八字校准的交互设计

消费级产品最常用的校准方式就是转八字（或者叫翻网球），原理是通过多个方向的旋转让采样点覆盖整个椭球面。看起来简单，实际体验差异巨大，关键在引导。

第一版我们做得很粗糙：弹个框说“请转动设备完成校准”，然后开始计时 15 秒。结果测试时十个人里有七个失败，原因是大部分人只是左右晃了两下，采样点几乎全在一个小区域，拟合出来的椭球完全不可信。

第二版改成实时反馈：屏幕上画一个进度环，把椭球分布简化成正交的三个轴，每覆盖一个区域就点亮一段，并附上具体的动作提示——“先绕竖直轴转两圈”，进度到 50% 后变成“再绕水平轴翻转两次”。用户照着做，成功率提到九成以上。核心改动不是算法，而是把“我需要什么数据”翻译成了“你该做什么动作”。

采样点的数量要求也测过：最低 80 个点能拟合，但误差大；150 个点开始稳定；200 个点以上收益递减。我把目标定在 200 点，硬件采样率 50Hz，正常转动 6 到 8 秒就够。

注意：校准过程一定要检测并拒绝异常点。用户如果在转动时靠近了铁桌，那一段数据模值会异常，直接喂给最小二乘会把结果毁掉。我们的做法是实时算模值，偏离均值超过 40% 的点直接丢弃并提示“检测到干扰，请换个位置”。宁可让用户多转两圈，也不要存一组错参数。

4.2 产线一次性校准与参数存储

用户校准是兜底方案，产线校准才是精度的基础。每台机器在产线上用自动转台做一次完整的三轴旋转（俯仰、横滚、偏航各两圈），采集 2000 个点，做高精度椭球拟合，把 center 和 T 写进参数区，并附带一个校准版本号和 CRC 校验。

这里有个细节：产线参数不能直接把用户校准覆盖掉，要分层存储。我的设计是三层——出厂层（产线写入，不可修改）、用户层（用户校准结果）、临时层（每次上电的快速自检偏差）。运行时优先用用户层，用户层无效则回落到出厂层。这样即使用户校准失败，也不会把机器搞到不可用。

存储格式我用了定长二进制结构，48 字节的变换参数 + 12 字节的偏移 + 4 字节温度补偿表索引 + 4 字节 CRC32 = 68 字节，对齐后 72 字节。用 CRC 而不是简单校验和，是因为参数区偶尔会遇到写入中断，CRC32 的检错能力强得多。上电时先校验 CRC，不通过就自动回落到出厂参数并提示用户重新校准。

4.3 温度补偿表的生成与使用

温度补偿表不是每个型号都值得做，我先算了一笔账：HiChatBox 的目标使用环境温度跨度约 55℃，不做补偿时最大误差 6°，做补偿后能压到 2° 以内。这个收益值得多花产线 40 秒的恒温时间，所以做了。

表的生成方式前面提过，13 个温度点，每个点存一组三轴偏移量（不是三个角度的偏移，是三轴的磁场偏移，这样更通用）。运行时用片上温度传感器的读数做区间判断，线性插值得到当前偏移，在椭球校正之前先减掉。

有个坑要提：片上温度传感器测的是芯片温度，不是环境温度，两者在设备刚开机时能差 10℃ 以上。所以补偿表的触发要做延时，开机前 60 秒不做温度补偿，用默认室温参数，等热平衡之后再启用。这个细节不处理，冷启动时反而会因为补偿过头而偏得更厉害。

5. 实测验证与常见问题排查实录

功能写完只是开始，验证才是最耗时间的部分。我大概花了两周时间在测试上，比开发还长。这一段把我踩过的坑整理出来，希望能帮后面的人少走弯路。

5.1 测试环境怎么搭

没有转台也能测，但要有方法。我的测试环境分三块：

静态精度测试用一块平整的非金属台面（木质桌面，测之前用磁力计扫一遍确认无磁），画一个 15° 一格的角度盘，把设备按格放置，每次记录读数和真实角度的差值。每个位置停留 10 秒取平均，跑完整圈 24 个点，算 RMS 误差。这一步能快速暴露校准问题和轴向定义错误。

动态跟随测试用手持匀速旋转配合摄像记录，视频里同时拍到设备屏幕和背景参照物，后期逐帧比对。精度不如转台，但足够判断延迟是否超标。

干扰测试准备几样道具：一块小磁铁（模拟磁吸配件）、一把不锈钢尺（模拟软磁干扰）、一台工作中的音箱（模拟交变磁场）、一部手机（模拟日常干扰源）。逐个靠近到不同距离，记录触发提示的距离和恢复时间。

恢复距离故意设得比触发距离大，是为了避免用户在边界附近时提示反复闪烁，体验很差。

5.2 常见问题速查表

下面这张表是我两个星期里遇到的所有典型问题，按现象、原因、处理方式整理，遇到类似症状可以直接对号入座。

5.3 三个踩得最深的坑

坑一：屏蔽罩的“保护”反而毁了精度。初版硬件为了电磁兼容性，在磁力计上方盖了一整块铁质屏蔽罩。结果地磁被屏蔽罩引导，设备转过 90°，读数只变了 40° 左右，而且不同方向的畸变程度还不一样。这个问题困扰了我们将近一周，因为软件上怎么看都像是校准没做好，反复重跑拟合都没用。最后是拿霍尔探头在板子上扫了一圈，才发现屏蔽罩本身的磁化状态在跟着外部磁场变化。换成开窗设计后，问题当天解决。这个教训让我记住：磁力计的一切硬件改动，都要先想“它会不会改变磁场的走向”。

坑二：角度跨零的隐藏 bug。滑动平均写完后，大部分方向都正常，唯独指向正北时指针会突然甩到南边。查了半天发现是 359° 和 1° 算术平均成了 180°。这个问题很典型，而且只在特定角度出现，测试时如果没覆盖到正北就会漏掉。修复方案就是前面代码里那个基于最小角差的平均。后来我把“8 个方位点加 4 个边界点”写进了测试用例标准，边界点就是 359°、0°、1°、180° 这几个，专门用来抓这类 bug。

坑三：磁吸配件让功能近乎报废。这个坑是产品形态带来的。外壳设计磁吸接口的时候，没人意识到它和指南针天然冲突。用户吸上磁吸支架，磁场强度直接从 48μT 跳到 200μT 以上，传感器虽然没饱和但完全失真。前期的处理方式很简单——检测到强磁就提示“移除配件后使用”。后来做了两件事让体验好一些：一是把磁吸检测的阈值和指南针干扰判定分开，磁吸时直接切到不可用状态而不走干扰提示流程；二是移除配件后自动触发一次轻量校准（用已存参数做偏移修正），让用户不用手动转圈就能恢复。这两个改动把“功能不可用”变成了“短暂不可用后自动恢复”，用户投诉明显减少。

6. 低功耗与工程化收尾

功能能跑通之后，剩下的是把它变成一个“能长期待在系统里”的模块。这部分的坑不像算法那么显眼，但直接影响整机体验。

6.1 采样率与功耗的平衡

磁力计的功耗跟采样率基本成正比。我们测过三档：50Hz 时传感器电流约 1.1mA，10Hz 时约 0.25mA，1Hz 时几乎可以忽略。指南针不需要一直全速跑，我的策略是分场景动态切换：

关键在“后台运行”这一档。有些功能（比如拍摄时的方向记录、运动轨迹的方向标记）需要后台也知道朝向，但精度要求低，2Hz 采样加 1Hz 输出足够了。从 20Hz 降到 2Hz，功耗降了一个数量级，这个优化是必须做的。

还有一个技巧：采样率切换后要丢弃前 3 帧数据。传感器从低功耗模式切到正常模式时，前几帧的输出还没稳定，直接用会有跳变。

6.2 与界面联动的策略

最后说一下 UI 层。指南针这类功能的“手感”很大程度上由 UI 决定，不只是数据准不准。

指针动画必须做插值过渡，不能每帧直接赋值。10Hz 的数据直接映射到 60Hz 的屏幕上，会看到明显的台阶感。我的做法是在 UI 层做角速度限制的插值，每帧向目标角度靠近一定比例，同时限制最大转动速度，这样即使数据有小幅抖动，视觉上也是平滑的。但插值不能过度，否则会在快速转动时产生“拖影”，实测插值系数在 0.3 到 0.5 之间比较合适。

另外，方位文字（北、东北、东……）的切换要加一个 3° 的滞回带，否则在 22.5° 这种分界点附近，文字会来回闪。这个细节很小，但不做的话用户会觉得设备“不稳定”。

最后再分享一个我在整个开发过程中体会最深的经验：电子指南针这个功能，最值钱的部分不在算法，而在“诚实地告诉用户现在不可信”。指针乱转的时候，用户会认为设备坏了；指针置灰并给出明确提示的时候，用户会认为设备很聪明。同一个精度水平，两种处理方式带来的评价天差地别。这个思路后来被我用到了其他所有传感器功能上，包括光线感应和接近检测，效果都很好。