桌面多功能时钟项目里有两个需求看起来很小,做下去才发现全是暗坑:显示“当地”天气和待机省电但闹钟必须响。这篇把两条线的坑一次说完。项目是 EC600M-CNLE + QuecPython + LVGL(ST7789 240×240),三页暗色仪表盘,先看效果:
“当地天气”的第一个跟头:API 不认经纬度
需求很朴素:时钟显示所在城市的天气。手里 GNSS 明明吐着实时经纬度,直接调高德天气 API——400。查文档才明白:高德天气 API 只接受 city 或 adcode,不接受经纬度。想显示“当地”,得自己把经纬度“翻译”成城市。
完整链路:
GNSS(WGS84 经纬度)
│ ① 坐标转换:WGS84 → GCJ02(火星坐标)
▼
高德逆地理编码 regeo(location="经度,纬度")
│ ② 拿 adcode + 格式化地址
▼
高德天气 API(city=adcode)
▼
UI:温度 / 天气现象 / 风力
两个文档不会主动告诉你的暗坑:
- 必须转 GCJ02。高德用 GCJ02 坐标系,GNSS 输出 WGS84。国内不转换,逆地理编码能偏出几百米——在郊区可能就“定位到隔壁市”了。转换是纯数学,几十行 Python,但你必须知道要转。
- regeo 的 location 参数是“经度,纬度”。顺序反了不报错,只是默默返回错误结果,很阴险。
三级回退:GNSS 不是每次都在
GNSS 冷启动按分钟算,室内甚至定不到。定位做了三级回退,原则是“永远有天气可显示,但不假显示”:
第一级:GNSS 缓存(上次定位成功的时间和坐标,带有效期)
第二级:基站定位(cellLocator,4G 基站信息 → 大致位置)
第三级:config 固定城市(兜底)
两个工程细节值得说:
- 禁同步等 GNSS。主循环 100ms 都不能卡,何况 GNSS 冷启动按分钟算。定位全丢后台线程:线程只写“定位结果缓存”,主循环回来拿。没定位上之前,天气页显示“定位中…”,绝不拿假位置显示天气。
_ever_fix防刷屏。定位成功后地址可能逐秒微动(GNSS 抖动),每次变都重绘 UI 会闪屏。加一个标志:只有第一次成功定位才刷新地址栏,之后除非城市真的变了,否则不动 UI。
第二战场:为了“闹钟到点必须响”,我把 PSM 关了
时钟要睡觉(低功耗),但铁需求是闹钟到点必须响。这两个需求一碰,差点送走。
PSM(Power Saving Mode)看起来就是为低功耗量身定做的:模组周期性睡,网络定时器到点唤醒。我一开始直接用 pm.set_psm_time,然后查到两个事实:
- 官方明确这个 API 只有 BC25 / ECX00U / ECX00E 支持,EC600M 所属的 M 系列不在列——调了也没效果;
- 就算支持,PSM 的唤醒由网络侧定时器决定,什么时候醒你说了不算。闹钟设 7:00,网络 7:03 才唤醒你,钟就没意义了。
“闹钟必响”是硬需求,PSM 天然不符合,放弃。探测代码留在 code/usr/_probe_pm.py,后来的人不用再查一遍。
正解是三件套:pm.autosleep() + wakelock + 主动手动待机。组合键(K1+K2 长按 200ms)进待机:黑屏、停 UI 刷新、停采样、长睡;任意键唤醒;闹钟到点自动亮屏并退出待机。
最反直觉的一条:LVGL 的周期性刷新会阻止模组进入休眠(官方 FAQ 明示)。UI 线程一直在跑,系统认为你“还有活要干”——待机代码写好了功耗就是下不来,原因在这。所以待机时必须停掉 LVGL 刷新任务,不只是黑屏。想要省电,就得接受“睡觉时没有画面”。
两个附带坑
上电解码后乱响。 蜂鸣器/功放使能脚(GPIO9)在上电瞬间可能被拉成有效电平,开机“滴”一声吓人。加 mute_at_boot:启动无条件静音钳,等用户真的设了闹钟再解除。
光照公式写反了。 光敏电阻分压电路,环境越强输出电压越低——我一开始按“越强越高”写,大中午背光反而最暗,半夜灯光下最刺眼。实测标定后修正(R10=217360,ADC 读数一个个对出来的,别问为什么是这个数)。闹钟铃声是 2000Hz“响 200ms、停 150ms”无缝循环的 wav,用 tools/make_beep_wav.py 自己生成,频率时长可调。
心得
- 云 API 的“输入格式”是显性的,“为什么不接受你的输入”是隐性的。经纬度明明更精确,高德就是只认 adcode——这种取舍只能踩了才知道。
- 低功耗不是“调个 API”,是和一整套系统行为对着干:UI 要刷新、网络要心跳、传感器要采样,每个都在阻止休眠。先列清楚“谁在阻止你睡觉”,再决定关掉谁——但闹钟的唤醒路径必须留活路。
- “绝不显示假值”要贯彻到底。定位不到就显示“定位中”,天气拿不到就显示“–”,UI 可以笨,状态不能假。
硬件接线图(全部排针连接,不用烙铁):

