1. WEBAPI
RCD 系列支持 HTTP 协议用 GET 方式调用 URL 进行控制,本设备返回标准的
JSON 数据。包括.NET 在内的所有主流编程语言均支持该方式。
1.1 命令格式
调用 URL 的格式如下表所示:
http://ip 地址
(必须)
http://192.168.1.25
资源路径
(必须)
/pwr/relays
密码
(必须)
?ac=123456
参数
(可选)
&value=15
1.2 错误代码
设备通过 HTTP 状态码来标识错误。
当设备收到非 GET 请求的 URL 调用时将返回 405 Method Not Allowed。
当访问密码不正确时,设备将返回 401 Unauthorized。
当访问的资源不存在时,设备将返回 404 Not Found。
当 URL 中参数不正确时,设备将返回 400 Bad Request。
1.3 获取全部继电器状态
资源路径:/pwr/relays
返回参数说明: 包括全部继电器状态的数组, 数组中每个字节的二进制码表示继电器
的状态,
0 表示释放,1 表示闭合。
1.4 设置全部继电器状态
资源路径:/pwr/relays
参数:value={#}
参数说明:需要设置的继电器状态,十进制表示,数据的二进制的位表示继电器的状态。
比如 value=15,15的二进制为0b1111,即表示设置1~4号继电器为闭合,其它继电器
为释放。value=128,二进制表示为0b10000000,即表示设置继电器8为闭合,其它继电器全为释放。
返回参数说明:包括全部继电器状态的数组
示例:http://192.168.1.25/pwr/relays?ac=123456&value=3855
示例说明:将 RCD1610 型号控制器的 1~4 号\9~12 号继电器设备为闭合。
返回:{"v":[15, 15]}
1.5 获取单个继电器状态
资源路径:/pwr/relay/{n},n 表示继电器编号。
返回参数说明:返回的值为 1,表示继电器闭合,0 表示继电器释放。
示例:http://192.168.1.25/pwr/relays/3?ac=123456
示例说明:获取 3 号继电器的状态。
示例返回:{"v":1}
1.6 设置指定继电器状态
资源路径:/pwr/relay/{n},n 表示继电器编号。
参数:value={?}
参数说明:1 表示闭合继电器,0 表示释放继电器。
返回参数说明:返回的值为 1,表示继电器闭合,0 表示继电器释放。
示例:http://192.168.1.25/pwr/relays/16?ac=123456&value=0
示例说明:将继电器 16 设置为释放
示例返回:{"v":0}
1.7 点动模式
资源路径:/gpio/ts/{n},n 表示继电器编号
参数:delay={#}
参数说明:{#}表示延时时间,范围为 2~200 秒 。
示例:http://192.168.1.25/gpio/ts/2?ac=123456&delay=10
示例说明:继电器 2 闭合 10 秒后自动释放
返回:{"v":10}