查询设备信息，可分为查询当前开发者的所有设备信息，或查询当前开发者的某个设备信息

符号 数值 描述
QUERY_DEV_INFOS 15 查询当前用户的所有设备信息
DEV_INFOS 16 响应QUERY_DEV_INFOS的查询指令，数据在info中
QUERY_DEV_INFO 17 查询当前用户的某个设备信息
DEV_INFO 18 响应QUERY_DEV_INFO的查询指令，数据在info中

跳转到info说明

  • 查询当前开发者的所有设备信息
    客户端发送查询指令QUERY_DEV_INFOS
    1. {
    2.   "userKey":"AAAAABBBBBCCCCCDDDDD",
    3.   "msgCode":15
    4. }

    服务端响应DEV_INFOS，注意这里的info是一个数组
    1. {
    2.   "userKey":"AAAAABBBBBCCCCCDDDDD",
    3.   "msgCode":16,
    4.   "info":[ #info说明在最后面
    5.       {
    6.           "devSn": "VQKtTt5YbDu8TnXale4w",
    7.           "devType": "TCP-KP-LC1A",
    8.           "protocolVer": "1",
    9.           "firmwareVersion": "TCP-KP-LC1A-VER16.6",
    10.           "isOnline": 0,
    11.           "lastOnlineTime": 1690257859000,
    12.           "doNum": 1,
    13.           "diNum": 1,
    14.           "buttonNum": 0,
    15.           "aiNum": 0,
    16.           "pcssNum": 0,
    17.           "pingNum": 0,
    18.           "dcNum": 0,
    19.           "gwNum": 0,
    20.           "gps": 0,
    21.           "alarmApparatus": 0,
    22.           "tts": 0,
    23.           "uart": 0,
    24.           "eDate": "2100-01-01",
    25.           "netType": 0,
    26.           "sign": 0,
    27.           "imsi": "",
    28.           "imei": "",
    29.           "iccId": "",
    30.           "bindTime": "2024-10-24 11:59:59",
    31.           "battery": 0,
    32.           "batteryPower": 0,
    33.           "batteryVol": 0,
    34.           "powerState": 0,
    35.           "tpsState": 0,
    36.           "devPageType": 0
    37.       },
    38.       {
    39.           "devSn": "ltC2luw5LXbmeoAx6fLM",
    40.           "devType": "NR-4G-IO808",
    41.           "protocolVer": "1",
    42.           "firmwareVersion": "NR-4G-IO808-VER10.12-UIEN",
    43.           "isOnline": 0,
    44.           "lastOnlineTime": 1709549599000,
    45.           "doNum": 8,
    46.           "diNum": 8,
    47.           "buttonNum": 0,
    48.           "aiNum": 0,
    49.           "pcssNum": 0,
    50.           "pingNum": 0,
    51.           "dcNum": 0,
    52.           "gwNum": 0,
    53.           "gps": 0,
    54.           "alarmApparatus": 0,
    55.           "tts": 0,
    56.           "uart": 0,
    57.           "eDate": "2100-01-01",
    58.           "netType": 2,
    59.           "sign": 18,
    60.           "imsi": "460082076402182",
    61.           "imei": "",
    62.           "iccId": "898604A0102180202182",
    63.           "bindTime": "2024-03-26 17:46:01",
    64.           "battery": 0,
    65.           "batteryPower": 0,
    66.           "batteryVol": 0,
    67.           "powerState": 0,
    68.           "tpsState": 0,
    69.           "devPageType": 0
    70.       }
    71.   ]
    72. }
  • 查询当前开发都的某个设备信息
    客户端发送查询指令QUERY_DEV_INFO
    1. {
    2.   "userKey":"AAAAABBBBBCCCCCDDDDD",
    3.   "msgCode":17,
    4.   "info":"ltC2luw5LXbmeoAx6fLM" #此时info的数据类型为 String
    5. }
    服务端响应DEV_INFO
    1. {
    2.   "userKey":"AAAAABBBBBCCCCCDDDDD",
    3.   "msgCode":18,
    4.   "info":{ #info说明在最后面
    5.       "devSn": "ltC2luw5LXbmeoAx6fLM",
    6.       "devType": "NR-4G-IO808",
    7.       "protocolVer": "1",
    8.       "firmwareVersion": "NR-4G-IO808-VER10.12-UIEN",
    9.       "isOnline": 0,
    10.       "lastOnlineTime": 1709549599000,
    11.       "doNum": 8,
    12.       "diNum": 8,
    13.       "buttonNum": 0,
    14.       "aiNum": 0,
    15.       "pcssNum": 0,
    16.       "pingNum": 0,
    17.       "dcNum": 0,
    18.       "gwNum": 0,
    19.       "gps": 0,
    20.       "alarmApparatus": 0,
    21.       "tts": 0,
    22.       "uart": 0,
    23.       "eDate": "2100-01-01",
    24.       "netType": 2,
    25.       "sign": 18,
    26.       "imsi": "460082076402182",
    27.       "imei": "",
    28.       "iccId": "898604A0102180202182",
    29.       "bindTime": "2024-03-26 17:46:01",
    30.       "battery": 0,
    31.       "batteryPower": 0,
    32.       "batteryVol": 0,
    33.       "powerState": 0,
    34.       "tpsState": 0,
    35.       "devPageType": 0
    36.   }
    37. }
  • info中的数据说明
字段名 数据类型(java) 描述
devSn String 设备二维码信息，也是设备的唯一识别码，所以客户端也需要使用此信息作为设备的唯一识别码
devType String 设备型号
protocolVer String 协议版本，用于识别设备的功能
firmwareVersion String 固件版本号
isOnline int 在线状态，0为离线，1为在线
lastOnlineTime Date 最后在线时间
doNum int 设备所支持的DO通道数量，0为不支持，>0即为通道数量
diNum int 设备所支持的DI通道数量，0为不支持，>0即为通道数量
buttonNum int 设备所支持的按键数量，0为不支持，>0即为通道数量
aiNum int 设备所支持的模拟量采集通道数量，0为不支持，>0即为通道数量
pcssNum int 设备所支持的开关机通道数量，0为不支持，>0即为通道数量
pingNum int 设备所支持的ping通道数量，0为不支持，>0即为通道数量
dcNum int 设备所支持的直流源检测通道数量，0为不支持，>0即为通道数量
gwNum int 设备所支持的网关任务数量，0为不支持，>0即为任务数量
gps int 设备是否支持GPS功能，0不支持，1支持
alarmApparatus int 设备是否支持警笛报警功能，0不支持，1支持
tts int 设备是否支持tts语音功能，0不支持，1支持
uart int 设备所支持的串口/RS485通道数，0为不支持，>0即为通道数量
eDate String 设备在服务端的有效期，格式为yyyy-MM-dd，“2100-01-01”与“0000-00-00”均表示长期有效
netType int 设备通讯接口的网络类型，0为网口，1为4G，2为WIFI
sign int 信号强度，对于网口设备此值为0，只有4G与WIFI的设备才有值，取值范围为0-31
imsi String 4G设备的imsi码
imei String 4G设备的imei码
iccId String 4G设备的电话书识别码
bindTime Date 设备在服务端绑定到开发者账号下的时刻
battery int 设备是否支持电池供电，0不支持，1支持
batteryPower int 电池电量，范围0-100
batteryVol int 电池电压，单位mV
powerState int 供电电源状态，0正常，1停电，2来电(可当正常处理)
tpsState int 三相电状态，目前只有380V停电报警器才支持此值，默认为0，0为正常，1为缺相，2为错相，3为恢复(可当正常处理)
devPageType int 专用设备标志，0为普通设备，1为停电报警器，2为电脑开关机板卡
文档更新时间: 2025-06-09 09:26   作者：wky