现象(第一批修复后): 模块成功注网(IP_READY 10.38.28.79)并连上 MQTT(conack nil nil /
suback true 0), 随即在组装 initialize 报文时崩溃:
E/user.coroutine.resume link_info.lua:29: attempt to call a nil value (field 'msisdn')
link_info.lua:29 in 'link_info.get'
app_iot.lua:34 in upvalue 'build_initialize'
app_iot.lua:65 in function 'app_iot.on_connected'
E/main Lua VM exit!! reboot in 15000ms
根因: mobile.msisdn() 在 Air780EPM 上不存在。LuatOS 各固件 API 面不一致, 且字段不存在时
"直接调用 = 抛异常崩 VM"(不是返回 nil) —— 与 mstick() 同性质。手机号官方 API 是
mobile.number(simid)(见 demo/mobile/mobile_test.lua), 物联卡普遍也无机号。
修复(防御性, 两层):
1. link_info.lua: 新增 safe(fn, ...) 助手(type(fn)=="function" 判断 + pcall), 所有 mobile.*
调用统一走它 → 字段缺失/调用异常一律返回 nil、不再抛出; msisdn 改用 safe(mobile.number, 0);
csq 兼容 table 返回
2. app_iot.lua: 新增 get_link() 兜底(内部 pcall + 失败时返回全空 link 表), inject_link 与
build_initialize 均改用它 → link 采集失败绝不影响上行, 更不允许崩 VM
自检增强 + 反向验证:
- tools/sim_load_test.lua 的 mobile 桩改为"只含官方 demo 证实存在的 API"(移除 msisdn):
桩面必须与真实固件一致 —— "想当然"多写的桩会掩盖真实 bug
- 反向验证: 把 mobile.msisdn() 注射回代码 → 自检精确报
"✗ link_info.get() [link_info.lua:53: attempt to call a nil value (field 'msisdn')]"(exit 1);
还原后 exit 0 → 该自检可拦住整类"API 面假设错误"
验证: luac5.3 -p 全绿; Lua 离线自检通过; Python 帧协议验证通过; readme 表格列数 0 异常
文档: readme §8 补第二批修复记录, 修正 link.msisdn 字段来源说明
如需查阅文档, 请访问 合宙Docs网站
本目录为合宙 主推模组 的代码中心, 包括内核固件(.soc), demo(.lua),完整方案代码(project)等;
本目录包含的模组型号有:
Air780Exx系列:Air780EPM Air780EHM Air780EHV Air780EGH
Air8000系列:Air8000 Air8000A Air8000W Air8000T Air8000G Air8000D
Air8101系列:Air8101 Air8101A
SPEC: LuatOS 涉及到的各类规范,报文协议等。
每个模组型号的文件夹,至少包含如下内容:
core:描述改模组型号的LuatOS内核固件(.soc)的下载地址
demo:关于该模组型号的通用demo(.lua),合宙基于该模组设计的产品,如开发板、核心板、整机开发板等,都可以使用
project:合宙基于该模组型号设计的产品,如开发板、核心板+配件板、整机开发板等,所使用的demo代码或者解决方案代码都放置于此
授权协议
MIT License
print("感谢您使用LuatOS ^_^")
print("Thank you for using LuatOS ^_^")