16.16 常见误区与避坑
下表列出设备端新手与中级工程师高频误区,每条含误区、为什么会卡在这里、正确做法。
| # | 误区 | 为什么会卡在这里 | 正确做法 |
|---|---|---|---|
| 1 | 先啃三个月数据手册再动手 | 怕寄存器看不懂、怕做错 | 先买开发板跑通点灯,用到哪个外设再查对应章节 |
| 2 | 靠 printf 猜 bug | 没装调试器、怕看寄存器 | 用 SWD + GDB/RTT,HardFault 看栈帧现场 |
| 3 | I2C 引脚配成推挽 | 以为输出都一样 | I2C 用开漏 + 外部上拉 |
| 4 | 在 ISR 里做长任务/printf | 图省事直接写 | ISR 只置标志,处理移到任务 |
| 5 | 共享变量不加 volatile | 编译优化把它优化没 | ISR 与任务共享变量加 volatile |
| 6 | 所有任务设成同优先级 | 以为 RTOS 自动安排 | 按紧急度分优先级,高优先级要有阻塞点 |
| 7 | 中断里调普通 FreeRTOS API | 不知道有 FromISR | 中断只用 ...FromISR 系列 |
| 8 | 用信号量当锁 | 觉得都能阻塞等待 | 用带优先级继承的 Mutex |
| 9 | 栈开刚好够 | 看平时能跑就行 | 看栈水线,留 30% 余量 |
| 10 | 动态分配到处用 | 习惯了 PC 的 malloc | 产品固件静态分配/内存池,防碎片 |
| 11 | Wi-Fi 设备一直连着 | 以为联网就该保持 | 电池设备 BLE 广播或周期上报,报完即睡 |
| 12 | 断线就 while 死连 | 以为能连上就行 | 状态机 + 指数退避 + 心跳保活 |
| 13 | 全用 MQTT QoS 2 | 以为越高越可靠 | 遥测 QoS 0/1,关键命令才 QoS 2 |
| 14 | 不配遗嘱/保活 | 以为连接不会断 | 配 LWT 与 keepalive,云端才知离线 |
| 15 | 不量电流就说续航一年 | 没有功耗数据 | 串电流表量剖面,按占空比算日均电流 |
| 16 | CPU 从来不睡 | 主循环忙等、HAL_Delay 阻塞 | 进 Stop/Standby,开 tickless idle |
| 17 | 醒来跑飞 | 睡眠前关了 PLL 没重配 | 唤醒后重配 SystemClock |
| 18 | 看门狗在中断里喂 | 觉得喂得勤快 | 确认各任务健康后在主循环喂 |
| 19 | 所有设备共用一个密钥 | 产线图省事 | 一机一密,一台被破不全军覆没 |
| 20 | 只校验 CRC 就上安全启动 | 以为完整性=安全 | 用私钥签名、公钥验,防伪造 |
| 21 | 单分区 OTA | 实现简单 | 必须 A/B 双分区,写新不动旧 |
| 22 | 升级不做启动确认 | 以为下载完就成功 | 新固件要 confirm,否则看门狗回滚 |
| 23 | 全量推送新版本 | 灰度麻烦 | 分批放量,失败率熔断 |
| 24 | 量产忘了锁调试口 | 调试方便 | 产线 checklist 强制锁 SWD |
| 25 | 硬编码云端地址/密钥 | 快 | 移到安全存储,启动打印版本与 commit |
| 26 | 设备离线数据全丢 | 没本地缓存 | 环形缓冲,上线限速补发 |
| 27 | 日志全量 DEBUG 上报 | 以为数据越多越好 | 分级限流,按需开 DEBUG 并自动关 |
| 28 | 网关同步轮询不超时 | 从站异常时整网拖死 | 加超时与异常从站隔离 |
| 29 | 单分区 Flash 频繁写同一处 | 数据就写一处 | 磨损均衡/轮换扇区 |
| 30 | 把 Linux 当硬实时 | 上了系统就以为实时 | PREEMPT_RT 是软实时,硬实时交 MCU |
误区分类
- 工具与调试类(1、2、25):先动手、用调试器、别硬编码。
- 外设与中断类(3、4、5):开漏、ISR 要短、volatile。
- RTOS 设计类(6、7、8、9、10):优先级、FromISR、Mutex、栈、静态分配。
- 联网与弱网类(11、12、13、14、26):省电连接、退避、QoS、遗嘱、缓存。
- 功耗与可靠性类(15、16、17、18、29):测电流、睡眠、喂狗、磨损。
- 安全与 OTA 类(19、20、21、22、23、24):一机一密、验签、A/B、确认、灰度、锁口。
- 运维与架构类(27、28、30):日志限流、网关隔离、实时性边界。