智能定位的器心得体会


智能定位器

这个项目涉及到大量外设的调通,使用了大量测试代码以保证功能正常。

一、项目管理

启动:先读 PRD 的 F1–F9,把每一条翻译成可验收的口径,再决定做什么。这一步的产出是一句话——“关键项只有五个:Config / LCD / Keys / Network / Cloud,任一失败才进 FAULT,其余失败只记录不阻断”。这句"分级降级而不是一票否决"的判断,是启动阶段就该定的,不是写代码时临时决定的。

规划:六份文档(PRD、架构、LVGL 页面规格、阿里云物模型、引脚映射、灯效定义),配三条"唯一真源"纪律——引脚只在 bsp/pins.py、用户参数只在 config/user.py、凭据只在 config/local.py。文档多了容易变成摆设,所以每一条真源都由脚本强制。

执行:M1/M2/M3 三个里程碑,每个里程碑结束跑一遍校验和单测,不绿不往下走。

监控:这是我最花力气的一段。9 类静态校验用 ast 解析(不是正则,否则 docstring 里的伪导入会误报),拦的是分层反向依赖、引脚裸数字、循环依赖、以及 "".join(resp.text) 这种"CPython 正常、模组必崩"的写法。227 个用例跑在主机侧,靠 harness.py 造一个等价的 usr 包,不改工程代码。

收尾:这一步是我认为最有价值的管理动作——把知识进行总结。由于此项目涉及外设众多,调通外设后有利于后续项目对外设的使用,故总结开发经验,这一步有利于减少后续的工作量。

质量管理上还有一条的教训。在bug修复时我只针对代码修改,没验证现象是否消失。所以后来我对修复也必须被验证,否则只是改了一行代码。

二、AI 编码工具

这个项目我主要让它写测试和检查器

收益最大的三件事:

  1. 生成 227 个用例的骨架:把每个模块的公开函数、失败路径列出来,让它按"正常 / 边界 / 异常"三组生成,我再逐个核对断言是否真的能失败。
  2. 生成 15 个固件桩:machine.I2C、ql_fs、aLiYun、utime 这些在 PC 上不存在,桩写得好不好直接决定测试有没有意义。
  3. 写 check.py 的 9 类规则:分层依赖、引脚唯一真源、循环依赖(三色标记 DFS,能打出完整环路径)、MicroPython 陷阱。

但这里有一个 AI 的系统性偏差,AI 写桩的时候会不自觉地"宽容"。

它倾向于让测试通过,于是桩会"友好"一点。三个真实例子:

  • ql_fs.touch() 只把数据存进内存,不做序列化 → 掩盖了配置从未落盘;
  • machine.I2C 失败时抛异常,而真机是返回错误码 → 测不出"调用方不检查错误码";
  • aLiYun.getAliyunSta() 未 start 时"友好地"返回 -1,而真机会直接抛 'NoneType' has no attribute 'getsocketsta' → 掩盖了每次开机都打的那条误导性告警。

另一个坑是版本:LVGL 字体全部失效。AI 按 v8 命名写,固件是 v7 顶层命名且只编了 14 号一个字号。表现和"固件没编字体"完全一样,我在这上面耗了很久,最后靠一个探测脚本(先探测固件有什么,再就近取用)才收敛。这件事让我形成习惯:涉及第三方库的行为,先写十行探测代码问硬件,不要问 AI。

三、项目构建:把架构约束变成可执行断言

这个项目的构建有一个和前两个本质不同的点:它不靠自觉,靠机器。

分层在目录上表达,但目录本身拦不住 drivers/ 反向 import services/。只要没有校验,分层会在几次迭代后退化成"随便放"。所以我把架构约束写成 check.py 的规则,改完先跑 py scripts/check.py,再跑 py tests/run.py,两条都绿才打包。

运行时结构上,我做了三个决定:

  1. 20ms 协作式主循环,11 步固定顺序,模块零常驻线程。 全工程只有 5 处线程,且全是短命线程(LED 闪烁、网络轮询、录音看门狗、天气请求、云端重连),靠"一次性 + 防重入标志"避免重复启动。规则一句话:需要阻塞超过约 50ms 的网络或外设操作,一律不许放在主循环。
  2. 三类上下文三条红线。 主循环里什么都能做;MQTT 接收线程只能置标志或调线程安全的模块级函数;dataCall 中断里只能置标志位。原因很具体:在 MQTT 回调里 switch_to_page() 会 clean() 并重建整棵 LVGL 控件树,而主循环正在渲染同一棵树——use-after-free,轻则花屏重则 hard fault。
  3. 标志位和队列按语义选。 云端改主题是幂等的,同一轮连发 5 次只需重建一次,用标志位合并;云端控制录音不能合并,每条都要执行,用 defer 队列。这个区分不是风格问题,是"合并会不会丢语义"的问题。

构建过程中最值得讲的一个技术判断是 SOS 的 4.6 秒。原实现用 4 次 sleep_ms 串起提示音序列,累计阻塞 4.6 秒——这期间按键不响应、GNSS 不解析。对告警场景这是致命的:用户按了没反应,会以为设备坏了。改成时间戳步骤机后,trigger() 只做红屏和 LED 就返回,后续按相对时刻推进;还补了 _MIN_STEP_GAP_MS = 1000,因为主循环一旦卡顿超过 4.6 秒,恢复时会把所有到期步骤一次性执行完,三段 TTS 互相打断,告警录音里几乎没有告警声。