MOBILE (4G 模组信息查询) 指令
对应源码:
components/airlink/src/luat_airlink_cmds.c启用宏:
LUAT_USE_AIRLINK_EXEC_MOBILE
MOBILE 指令用于主机查询从机 4G 模组的标识信息 (IMEI/IMSI/ICCID/MUID). 注意: 这些字段大部分已经在 基础指令 - 设备信息 (0x10) 的 dev_info 通知中包含, 本组指令主要用于按需主动查询最新值.
通用 payload 头
所有 driver 指令的 data 字段前 8 字节是 seq_id (uint64_t, 小端, 单调递增), 用于匹配 cmd 0x08 result 回调. 详见 指令层描述.
指令列表
| cmd | 名称 | 方向 | 说明 |
|---|---|---|---|
| 0x800 | mobile_imei | 主→从 | 查询 IMEI |
| 0x801 | mobile_imsi | 主→从 | 查询 IMSI |
| 0x802 | mobile_iccid | 主→从 | 查询 ICCID |
| 0x803 | mobile_muid | 主→从 | 查询 MUID |
各指令详细定义
mobile_imei (0x800)
查询 4G 模组的 IMEI (15 位数字).
| 字段 | 长度 | 含义 |
|---|---|---|
| seq_id | 8B | 序列号 |
结果通过 cmd 0x08 回调:
| 字段 | 长度 | 含义 |
|---|---|---|
| req_pkgid | 8B | 对应请求的 seq_id |
| result_code | 2B | 0 = 成功, 负值 = 错误 |
| imei | 16B | IMEI 字符串 (15 位 + \0) |
mobile_imsi (0x801)
查询 IMSI (SIM 卡 IMSI).
| 字段 | 长度 | 含义 |
|---|---|---|
| seq_id | 8B | 序列号 |
结果通过 cmd 0x08 回调, payload 为 16 字节 IMSI 字符串.
前提: SIM 卡必须就绪 (
LUAT_MOBILE_SIM_READY).
mobile_iccid (0x802)
查询 ICCID (SIM 卡序列号).
| 字段 | 长度 | 含义 |
|---|---|---|
| seq_id | 8B | 序列号 |
结果通过 cmd 0x08 回调, payload 为 20 字节 ICCID 字符串.
前提: SIM 卡必须就绪 (
LUAT_MOBILE_SIM_READY).
mobile_muid (0x803)
查询 MUID (模组唯一 ID).
| 字段 | 长度 | 含义 |
|---|---|---|
| seq_id | 8B | 序列号 |
结果通过 cmd 0x08 回调, payload 由 BSP 实现决定 (通常与 unique_id 字段对应).
关联文档
- 基础指令 - 设备信息 (0x10) — 被动接收, 上电/状态变化时由从机主动推送
- 本组指令 — 主动查询, 任何时候可发, 但前提是 4G 模组已初始化 (
LUAT_USE_AIRLINK_EXEC_MOBILE已启用)