查询设备控制项
例, 请求: 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
| 参数 |
描述 |
必选 |
| action |
queryDeviceCtrlField |
是 |
| pn |
数采器编号 |
是 |
| devcode |
设备协议编码 |
是 |
| devaddr |
设备地址(485总线) |
是 |
| sn |
设备序列号 |
是 |
| i18n |
国际化语言, 见多语言支持 |
是 |
响应:
| 参数 |
描述 |
必选 |
| field[x].id |
控制项唯一标识 |
是 |
| field[x].name |
国际化描述 |
是 |
| field[x].unit |
一些要设置的字段有单位, 而另一些则没有, 如逆变器的功率因数, 单位为'%' |
否 |
| field[x].hint |
输入提示 |
否 |
| field[x].item[y].key |
仅在字段为枚举类型时有效, 表示枚举字段的值 |
否 |
| field[x].item[y].val |
仅在字段为枚举类型时有效, 表示枚举字段的国际化描述 |
否 |
{
"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":"使能"
}
]
}
]
}
}
可能出现的错误:
| 返回错误码 |
描述 |
详细描述 |
| 0x0001 |
ERR_FAIL |
失败(无设备协议) |
| 0x0006 |
ERR_FORMAT_ERROR |
参数错误 |
| 0x000C |
ERR_NO_RECORD |
无记录(协议中可能没有可见的控制字段或没有模板) |
| 0x0102 |
ERR_NOT_FOUND_DEVICE |
找不到设备 |