get_lte_all_info 获取4G LTE全部信息
POST /api/v1/network/get_lte_all_info
描述
获取4G LTE全部信息接口,用于获取设备的4G LTE全部信息。
访问权限
需要登录,具备以下权限:
network:get_lte_status
JSON参数
请求参数如下:
{}
响应结果
请求返回的HTTP状态码为200
返回结果为JSON格式的数据,您可以通过解析JSON数据来获取API调用的结果信息。结构如下:
{
"success": true|false,
"data"?: {
"moduleInfo": {
"manufacturer": string, // 模块制造商,如Quectel
"model": string, // 模块型号,如EC20F
"firmware": string, // 模块固件版本号,如EC20CEHDLGR08A06M1G
"IMEI": string // 国际移动设备识别码,如860982087294367
},
"simInfo": {
"status": string, // SIM卡状态,如READY NOT INSERTED等
"ICCID": string, // 集成电路卡识别码,如89861125203092894764
"IMSI": string, // 国际移动用户识别码,如460113999817886
"phone": string, // SIM卡关联的电话号码,如None或具体号码
"MCC": string, // 移动国家代码,如460
"MNC": string, // 移动网络代码,如11
"operatorName": string // 运营商名称,如China Telecom
},
"networkStatus": {
"operatorName": string, // 当前注册的运营商名称,如CHN-CT
"accessTech": string, // 当前使用的接入技术,如LTE
"epsStatus": string, // EPS注册状态,如Registered, home network
"csStatus": string, // CS注册状态,如Registered, home network
"netMode": string, // 网络工作模式,如FDD LTE
"band": string, // 当前使用的LTE频段,如LTE BAND 3
"channel": string // 当前使用的LTE频道编号,如1825
},
"signalQuality": {
"mode": string, // 信号测量的网络制式,如LTE
"level": integer, // 信号强度等级,0-5整数
"levelLabel": string, // 信号强度的文字描述,如Fair
"RSRP": string, // 参考信号接收功率,如-99 dBm
"RSRQ": string, // 参考信号接收质量,如-14 dB
"SINR": string, // 信噪比,如5.4 dB
"RSCP": string, // UMTS信号强度,非LTE时可能有值,否则为空字符串
"EcIo": string, // UMTS信号质量,非LTE时可能有值,否则为空字符串
"RSSI": string // 接收信号强度指示,如-62 dBm
},
"dataConnection": {
"APN": string, // 访问点名称,如CTNET
"ipv4Addr": string, // IPv4地址,如
"ipv4Mask": string, // IPv4子网掩码,如
"ipv4Gateway": string, // IPv4网关,如
"dnsPrimary": string, // 首选DNS服务器,如
"dnsSecondary": string, // 备用DNS服务器,如
"ipv6Addr": string // IPv6地址,如
},
"trafficStats": {
"rxBytes": integer, // 接收的总字节数,如2448
"txBytes": integer, // 发送的总字节数,如7784
"rxHuman": string, // 接收字节数的人类可读格式,如2.39 KB
"txHuman": string, // 发送字节数的人类可读格式,如7.60 KB
"ATRxBytes": integer, // AT命令接收的字节数,如1854
"ATTxBytes": integer, // AT命令发送的字节数,如5337
"ATRxHuman": string, // AT命令接收字节数的人类可读格式,如1.81 KB
"ATTxHuman": string // AT命令发送字节数的人类可读格式,如5.21 KB
},
"temperature": {
"cpuCelsius": integer, // CPU温度,单位摄氏度,如33
"status": string // 温度状态,如Normal
},
"online": boolean, // 4G模块是否存在,如true
"pollCount": integer, // 监控线程累积执行的查询次数,如30
"updatedAt": integer, // 最后一次查询的Unix时间戳,如1774402758
"configState": string // 4G模块的启用/禁用配置状态,如disabled
},
"errorCode"?: "option string",
"errorMessage"?: "option string",
"showType"?: 0|1|2|4|9,
"traceId"?: "option string"
}
例子:
// 禁用4G LTE模块(模块实际存在,可以正常查询硬件模块信息,但网络连接信息为空)
{
"success": true,
"data": {
"moduleInfo": {
"manufacturer": "Quectel",
"model": "EC20F",
"firmware": "EC20CEHDLGR08A06M1G",
"IMEI": "860982087294367"
},
"simInfo": {
"status": "READY",
"ICCID": "89861125203092894764",
"IMSI": "460113999817886",
"phone": "None",
"MCC": "460",
"MNC": "11",
"operatorName": "China Telecom"
},
"networkStatus": {
"operatorName": "CHN-CT",
"accessTech": "LTE",
"epsStatus": "Registered, home network",
"csStatus": "Registered, home network",
"netMode": "FDD LTE",
"band": "LTE BAND 3",
"channel": "1825"
},
"signalQuality": {
"mode": "LTE",
"level": 3,
"levelLabel": "Fair",
"RSRP": "-99 dBm",
"RSRQ": "-14 dB",
"SINR": "5.4 dB",
"RSCP": "",
"EcIo": "",
"RSSI": "-62 dBm"
},
"dataConnection": {
"APN": "",
"ipv4Addr": "",
"ipv4Mask": "",
"ipv4Gateway": "",
"dnsPrimary": "",
"dnsSecondary": "",
"ipv6Addr": ""
},
"trafficStats": {
"rxBytes": 2448,
"txBytes": 7784,
"rxHuman": "2.39 KB",
"txHuman": "7.60 KB",
"ATRxBytes": 1854,
"ATTxBytes": 5337,
"ATRxHuman": "1.81 KB",
"ATTxHuman": "5.21 KB"
},
"temperature": {
"cpuCelsius": 33,
"status": "Normal"
},
"online": true,
"pollCount": 30,
"updatedAt": 1774402758,
"configState": "disabled"
}
}
// 启用4G LTE模块(包含动态获取的网络连接信息)
{
"success": true,
"data": {
"moduleInfo": {
"manufacturer": "Quectel",
"model": "EC20F",
"firmware": "EC20CEHDLGR08A06M1G",
"IMEI": "860982087294367"
},
"simInfo": {
"status": "READY",
"ICCID": "89861125203092894764",
"IMSI": "460113999817886",
"phone": "None",
"MCC": "460",
"MNC": "11",
"operatorName": "China Telecom"
},
"networkStatus": {
"operatorName": "CHN-CT",
"accessTech": "LTE",
"epsStatus": "Registered, home network",
"csStatus": "Registered, home network",
"netMode": "FDD LTE",
"band": "LTE BAND 3",
"channel": "1825"
},
"signalQuality": {
"mode": "LTE",
"level": 3,
"levelLabel": "Fair",
"RSRP": "-92 dBm",
"RSRQ": "-14 dB",
"SINR": "6.8 dB",
"RSCP": "",
"EcIo": "",
"RSSI": "-62 dBm"
},
"dataConnection": {
"APN": "CTNET",
"ipv4Addr": "10.71.152.60",
"ipv4Mask": "255.255.255.248",
"ipv4Gateway": "10.71.152.61",
"dnsPrimary": "219.141.157.113",
"dnsSecondary": "219.141.157.114",
"ipv6Addr": "fe80::2569:a1e9:5285:30f8"
},
"trafficStats": {
"rxBytes": 3060,
"txBytes": 9372,
"rxHuman": "2.99 KB",
"txHuman": "9.15 KB",
"ATRxBytes": 1854,
"ATTxBytes": 5417,
"ATRxHuman": "1.81 KB",
"ATTxHuman": "5.29 KB"
},
"temperature": {
"cpuCelsius": 34,
"status": "Normal"
},
"online": true,
"pollCount": 92,
"updatedAt": 1774406536,
"configState": "enabled"
}
}
4G LTE模块信息API字段说明
本文档详细说明lte:get_lte_all_info接口返回的JSON各字段含义、取值范围、常见结果及状态变化。
顶级字段
configState (string)
- 含义:4G模块的启用/禁用配置状态(用户上次设置的状态,开机后恢复)
- 取值:
"enabled"|"disabled" - 说明:
"enabled":用户启用4G模块,quectel-cm服务运行,可建立数据连接"disabled":用户禁用4G模块,quectel-cm服务已停止,不建立数据连接- 此状态由
lte:save_state接口修改,持久化到/coolshark_config/configs/lte_config.json
online (boolean)
- 含义:4G模块是 否存在
- 取值:
true|false - 说明:
true:4G模块对应的网络接口存在,禁用4G模块时也为true(禁用时接口也存在,只是被link down)false:系统没有正确识别到4G模块的网络接口,可能模块硬件故障或未正确连接,驱动程序问题导致无法识别模块
pollCount (integer)
- 含义:监控线程累积执行的查询次数(一般调试用)
- 取值:非负整数
- 说明:
- 从系统启动后开始计数
- 监控线程每60秒执行一次查询,此计数增加1
- 可用于验证监控线程是否正常运行(pollCount应稳定增长)
updatedAt (integer)
- 含义:最后一次查询的Unix时间戳(秒)
- 取值:Unix timestamp,正整数
- 说明:
- 表示当前返回的所有字段数据是在此时刻获取的
- 可用于判断数据的实时性(当前时刻 - updatedAt 应接近0,最多不超过60秒)
moduleInfo - 模块硬件信息
manufacturer (string)
- 含义:模块制造商
- 取值:
"Quectel"等 - 说明:固定值,表示模块由移远(Quectel)制造
model (string)
- 含义:模块型号
- 取值:
"EC20F"、"EC20-CE"等 - 说明:用于识别具体的模块硬件版本
firmware (string)
- 含义:模块固件版本号
- 取值:格式如
"EC20CEHDLGR08A06M1G" - 说明:
- 由制造商提供,标识模块运行的固件版本
- 固件升级时此值会变化
- 若出现兼容性问题,需参考此版本号
IMEI (string)
- 含义:国际移动设备识别码 (International Mobile Equipment Identity)
- 取值:15位数字,例如
"860982087294367" - 说明: