设备控制/下发
<p><strong>日志：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">版本</th>
<th style="text-align: left;">修改人</th>
<th style="text-align: left;">修改内容</th>
<th style="text-align: left;">修改时间</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Va 1.0.0</td>
<td style="text-align: left;">lee</td>
<td style="text-align: left;">创建</td>
<td style="text-align: left;">2018-11-30 08:00:00</td>
</tr>
<tr>
<td style="text-align: left;">Va 1.1.0</td>
<td style="text-align: left;">lee</td>
<td style="text-align: left;">增加了设备操作密码</td>
<td style="text-align: left;">2023-11-01 09:32:28 星期三</td>
</tr>
</tbody>
</table>
<p><strong>简要描述：</strong> </p>
<ul>
<li>设备控制接口，需要具有控制设备的权限</li>
</ul>
<p><strong>注意：</strong> </p>
<ul>
<li>此接口为通用下发接口，接口返回成功<strong>只代表命令已成功下发</strong>，某些设备由于自身原因接收到控制命令时不会给响应回执，故是否下发成功要根据实际情况判断</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://www.zsdcloud.cn:8443/openApi/equipment/control.action</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">keyCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>设备标识码</td>
</tr>
<tr>
<td style="text-align: left;">setInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">JSONString</td>
<td>下发内容为JSON字符串 <br />下发类型分为: <br /><strong>1：设备控制</strong>，JSON的key 暂固定为 <code>device_control</code> ，值固定为下列几种：<br />消音 - <code>mute</code> ；<br/>复位 - <code>reset</code>；<br>重启 - <code>reboot</code> ； <br/>断电(DO闭合) - <code>open</code>，此参数只有部分设备支持 ；<br/>上电(DO断开) - <code>close</code>，此参数只有部分设备支持；<br/>eg: <code>{&quot;device_control&quot;:&quot;reset&quot;}</code><br/><br/><strong>2： 参数设置</strong> ，此时JSON的key代表需要设置的参数，value为需要设置的值， eg：<code>{&quot;Status&quot;:1,&quot;I_TR&quot;:100}</code>。value的值类型请根据[获取设备可控制的属性](<a href="https://www.showdoc.com.cn/382341824968230/3595091407649932">https://www.showdoc.com.cn/382341824968230/3595091407649932</a> "获取设备可控制的属性")中<br/>返回属性的<code>DataType</code>来传递</td>
</tr>
<tr>
<td style="text-align: left;">childDeviceKey</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>子设备标识码，多个子设备用英文逗号分割。<strong>对于网关-子设备类型，此参数必传</strong>，例如：智能配电箱、智能照明</td>
</tr>
<tr>
<td style="text-align: left;">operationPassword</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>设备操作密码，由物联网平台设置的操作密码MD5后的32位大写密码，如果在物联网平台设置了操作密码则此参数必传</td>
</tr>
<tr>
<td style="text-align: left;">channels</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>子设备下的通道号，每一个通道即为每一个灯。多个通道用英文逗号分割。<strong>此参数暂只有智能照明设备类型支持</strong></td>
</tr>
<tr>
<td style="text-align: left;">recordNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>配方号。<strong>此参数暂只有智能照明设备类型支持</strong></td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
&quot;statusCode&quot;: 200,
&quot;message&quot;: &quot;已下发&quot;
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>智能配电箱（断路器）控制合分闸的操作指令为：<code>{&quot;Status&quot;:1}</code>，值1为合闸，0为分闸</li>
<li>智能照明控制开关灯的操作指令为：<code>{&quot;Status&quot;:1}</code>，值1为开灯，0为关灯。控制开关灯eg: ：<code>childDeviceKey</code>传<code>1</code>, <code>channels</code> 传 <code>1,2,3</code>，setInfo传：<code>{&quot;Status&quot;:1}</code>，代表控制modbus地址1的1,2,3通道开灯</li>
</ul>