查询 LTE 网络信息（即将推出）
查询设备的 LTE 网络信息，用于定位设备联网质量、网络注册和现场通信问题。
能力预告
该接口尚未开放调用。以下内容用于介绍计划支持的场景，正式接口以发布时的文档为准。
计划响应字段
接口将返回标准响应外层结构，以下字段位于 data。除 deviceId、systemMode 和 collectedAt 外，设备未注册网络、当前无服务或模块不支持相应数据时，字段可能为 null 或不返回。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
deviceId | string | 是 | 设备 ID |
systemMode | string | 是 | 当前网络制式，见下方枚举 |
operationMode | string | 否 | 通信模块当前工作模式，见下方枚举 |
registrationStatus | string | 否 | LTE 网络注册状态，见下方枚举 |
mcc | string | 否 | 移动国家码，保留前导零 |
mnc | string | 否 | 移动网络码，保留前导零 |
trackingAreaCode | string | 否 | LTE 跟踪区代码，使用不带 0x 前缀的十六进制字符串 |
servingCellId | string | 否 | 当前服务小区 ID；使用字符串避免整数精度丢失 |
physicalCellId | integer | 否 | LTE 物理小区 ID |
currentBand | integer | 否 | 当前驻留的 LTE Band 编号，例如 Band 3 返回 3 |
earfcn | integer | 否 | E-UTRA 绝对无线频率信道号 |
signal | object | 否 | 当前可用的信号测量值 |
signal.csq | integer | 否 | 模块信号质量等级：0 至 31；99 表示未知或无法检测 |
signal.bitErrorRateLevel | integer | 否 | 误码率等级：0 至 7；99 表示未知 |
signal.rsrpDbm | number | 否 | LTE 参考信号接收功率，单位 dBm |
signal.rsrqDb | number | 否 | LTE 参考信号接收质量，单位 dB |
signal.rssiDbm | number | 否 | 接收信号强度，单位 dBm |
collectedAt | string | 是 | 本次数据采集时间，RFC3339 UTC |
csq 是模块定义的离散等级，不是百分比。客户端不应将 99 当作高信号值，也不应只根据一个信号指标判断连接质量。
operationMode 表示蜂窝通信模块的工作模式，不等同于 OpenAPI 设备对象的在线或离线状态。判断设备连接状态时，应使用设备接口返回的 status 或 WebSocket 连接事件。
systemMode
| 值 | 说明 |
|---|---|
NO_SERVICE | 当前无可用网络服务 |
GSM | 当前网络制式为 GSM |
WCDMA | 当前网络制式为 WCDMA |
LTE | 当前网络制式为 LTE |
operationMode
| 值 | 说明 |
|---|---|
UNKNOWN | 模块未提供可识别的工作模式 |
ONLINE | 正常在线模式 |
OFFLINE | 离线模式 |
FACTORY_TEST | 工厂测试模式 |
RESET | 正在复位 |
LOW_POWER | 低功耗模式 |
FLIGHT | 飞行模式 |
registrationStatus
| 值 | 说明 |
|---|---|
NOT_REGISTERED | 未注册，当前未搜索网络 |
REGISTERED_HOME | 已注册到归属网络 |
SEARCHING | 正在搜索或尝试注册网络 |
DENIED | 网络注册被拒绝 |
UNKNOWN | 注册状态未知或当前不在覆盖范围内 |
REGISTERED_ROAMING | 已注册到漫游网络 |
SMS_ONLY_HOME | 仅短信服务，归属网络 |
SMS_ONLY_ROAMING | 仅短信服务，漫游网络 |
EMERGENCY_ONLY | 仅紧急承载服务 |
不同设备、通信模块或固件支持的信息范围可能不同。正式接口不会用 0 或空字符串代替模块没有返回的数据。
计划使用方式
该能力主要用于：
- 设备联网异常诊断
- 运维页面展示最近一次蜂窝网络状态
- 对比设备离线前后的网络信息
- 在执行网络配置操作前确认当前状态
调用方只需处理 OpenAPI 返回的标准化字段。
数据时效
设备网络信息可能来自最近一次设备上报，也可能由平台主动查询。正式接口会明确说明：
- 数据更新方式和采集时间
- 设备离线时的返回规则
- 主动查询的限流、超时和重试方式
字段依据
上述字段来自 SIMCom A76XX 对网络系统、LTE 注册、小区和信号测量数据的正式定义。OpenAPI 会完成枚举命名、信号单位换算和缺失值处理，不会把厂商原始编码直接交给调用方。
未纳入首版响应的厂商字段不会在实现前提前承诺。例如，未确认可稳定换算单位的信号值和仅表示模块内部配置的带宽编码，不会以猜测值加入文档。