Query Device information
| Parameter | Description | Required |
|---|---|---|
| action | queryDeviceInfo | True |
| device | Datalogger number, Device protocol code, Device address (485 bus), Device serial number (pn, devcode, devaddr, sn), multiple separated by ";" signs , supporting up to 256 at a time | True |
response:
| Parameter | Description | Required |
|---|---|---|
| device[x].pn | Datalogger number | True |
| device[x].devcode | Device protocol code | 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 (in seconds relative to zero time zone) | True |
| device[x].status | Device status | True |
| device[x].uid | Owner ID of the Plant to which the Device belongs, The Device may not belong to any Plant owner | False |
| device[x].pid | id of the Plant to which the Device belongs, The Device may not belong to any Plant | False |
It should be noted that interfaces fail quickly: that is, if a Device information is considered incorrect, the interface will immediately return an error. Additionally, the order of returned devices may differ from the order passed during the query.
{
"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 errors:
| Response error code | Description | Details |
|---|---|---|
| 0x0006 | ERR_FORMAT_ERROR | Parameter error |
| 0x000B | ERR_NO_PERMISSION | No permission (the current Datalogger is not owned by this user) |
| 0x000D | ERR_OVER_LIMIT | EXCEEDS LIMIT |
| 0x0101 | ERR_NOT_FOUND_COLLECTOR | Datalogger not found |
| 0x0102 | ERR_NOT_FOUND_DEVICE | Device not found |
| 0x0104 | ERR_NOT_FOUND_PLANT | Plant not found |