Files
mobile_comm/luatos/air780epm/module
wangfq 2f75f5abff fix(vd960Air): 修复 initialize 组装崩溃(mobile.msisdn 不存在) + link 采集兜底
现象(第一批修复后): 模块成功注网(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 字段来源说明
2026-09-10 15:44:47 +08:00
..

如需查阅文档, 请访问 合宙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 ^_^")