Query device information
| parameter | description | required |
|---|---|---|
| action | queryDeviceInfo | true |
| device | Data collector number, device protocol code, device address (485 bus), Device serial number(pn,devcode,devaddr,sn), separated by Multiple uses numbers "; ", Supports up to 256 at a time | true |
response:
| parameter | description | required |
|---|---|---|
| device[x].pn | Digital collector number | true |
| device[x].devcode | Device protocol encoding | true |
| device[x].devaddr | device address (485 bus) | true |
| device[x].sn | Device serial number | true |
| device[x].alias | Device alias | false |
| device[x].timezone | The time zone in which the device is located (seconds relative to zone zero) | true |
| device[x].status | Device status | true |
| device[x].uid | The ID of the owner of the power station to which the equipment belongs, It is possible that the equipment does not belong to any power plant owner | false |
| device[x].pid | The ID of the power station to which the device belongs, It is possible that the equipment does not belong to any power station | false |
notice, The interface is failing quickly: If a device information is considered to be incorrect, the interface will immediately return an error.
besides, The order of the devices returned may differ from the order passed at query time.
{
"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
}
]
}
}
possible error:
| Returns an error code | description | detailed description |
|---|---|---|
| 0x0006 | ERR_FORMAT_ERROR | parameter error |
| 0x000B | ERR_NO_PERMISSION | No permission (the current data collector is not the user) |
| 0x000D | ERR_OVER_LIMIT | over limit |
| 0x0101 | ERR_NOT_FOUND_COLLECTOR | The data collector not found |
| 0x0102 | ERR_NOT_FOUND_DEVICE | device not found |
| 0x0104 | ERR_NOT_FOUND_PLANT | Power station not found |