Query Device control items
for example: http://api.shinemonitor.com/public/?sign=7f220b6f21d0b52d0452d9c66ffe1f4f84635b81&salt=2337424845041575962&token=91a6c87e89acbfb2fa482f3b02ee071ee58ea0293dd92f243a88ee51415f497f&action=queryDeviceCtrlField&pn=J1817101731142&devcode=752&devaddr=1&sn=687484400018&i18n=zh_CN&source=0&_app_client_=android&_app_id_=com.demo.test&_app_version_=3.6.2.1
| Parameter |
Description |
Required |
| action |
queryDeviceCtrlField |
True |
| pn |
Datalogger number |
True |
| devcode |
Device protocol encoding |
True |
| devaddr |
Device address (485 bus) |
True |
| sn |
Device serial number |
True |
| i18n |
Internationalized language, refer to Multi-Language Support |
True |
response:
| Parameter |
Description |
Required |
| field[x].id |
Unique identifier of control item |
True |
| field[x].name |
Internationalization Description |
True |
| field[x].unit |
Some fields to be set have units, while others do not, such as the power factor of the Inverter, in units of '%' |
False |
| field[x].hint |
input prompt |
False |
| field[x].item[y].key |
Valid only when the field is of enumeration type, representing the value of the enumeration field |
False |
| field[x].item[y].val |
Valid only when the field is of enumeration type, indicating the internationalization description of the enumeration field |
False |
{
"err":0,
"desc":"ERR_NONE",
"dat":{
"field":[
{
"id":"charger_from_grid_start_time",
"name":"充电开始时间(小时:分钟)",
"unit":"Hour:Minute",
"hint":"23:59"
},
{
"id":"charger_from_grid_end_time",
"name":"充电结束时间(小时:分钟)",
"unit":"Hour:Minute",
"hint":"23:59"
},
{
"id":"inverter_charger_from_grid_enable",
"name":"逆变器电网充电使能",
"item":[
{
"key":"0",
"val":"失能"
},
{
"key":"1",
"val":"使能"
}
]
}
]
}
}
Possible errors:
| Response error code |
Description |
Details |
| 0x0001 |
ERR_FAIL |
Failed (no device protocol) |
| 0x0006 |
ERR_FORMAT_ERROR |
Parameter error |
| 0x000C |
ERR_NO_RECORD |
No records (there may not be visible control fields or templates in the protocol) |
| 0x0102 |
ERR_NOT_FOUND_DEVICE |
Device not found |