查询设备信息
| 参数 | 描述 | 必选 |
|---|---|---|
| action | queryDeviceInfo | 是 |
| device | 数采器编号, 设备协议编码, 设备地址(485总线), 设备序列号(pn,devcode,devaddr,sn), 多个用";"号隔开, 一次最多支持256个 | 是 |
响应:
| 参数 | 描述 | 必选 |
|---|---|---|
| device[x].pn | 数采器编号 | 是 |
| device[x].devcode | 设备协议编码 | 是 |
| device[x].devaddr | 设备地址(485总线) | 是 |
| device[x].sn | 设备序列号 | 是 |
| device[x].alias | 设备别名 | 否 |
| device[x].timezone | 设备所在时区(相对零时区的秒数) | 是 |
| device[x].status | 设备状态 | 是 |
| device[x].uid | 设备所属电站业主id, 设备有可能不属于任何电站业主 | 否 |
| device[x].pid | 设备所属电站id, 设备有可能不属于任何电站 | 否 |
需要注意是, 接口是快速失败的: 即, 如果有一个设备信息被认为有误, 接口将立即返回错误.
另外, 返回的设备顺序可能与查询时传递的顺序不同.
{
"err":0,
"desc":"ERR_NONE",
"dat":{
"device":[
{
"pn":"COLLECTOR0001",
"devcode":512,
"devaddr":1,
"sn":"687489900018",
"timezone":28800,
"status":1,
"uid":1,
"pid":1
},
{
"pn":"COLLECTOR0002",
"devcode":512,
"devaddr":1,
"sn":"687489900018",
"timezone":28800,
"status":1,
"uid":1,
"pid":1
}
]
}
}
可能出现的错误:
| 返回错误码 | 描述 | 详细描述 |
|---|---|---|
| 0x0006 | ERR_FORMAT_ERROR | 参数错误 |
| 0x000B | ERR_NO_PERMISSION | 没权限(当前数采器不是该用户的) |
| 0x000D | ERR_OVER_LIMIT | 超出限制 |
| 0x0101 | ERR_NOT_FOUND_COLLECTOR | 找不到数采器 |
| 0x0102 | ERR_NOT_FOUND_DEVICE | 找不到设备 |
| 0x0104 | ERR_NOT_FOUND_PLANT | 找不到电站 |