智能照明数据示例
<h3>1. [智能照明对外推送数据示例](<a href="https://www.showdoc.com.cn/382341824968230/5021435483577429">https://www.showdoc.com.cn/382341824968230/5021435483577429</a> "智能照明对外推送数据示例")</h3>
<h4>数据推送原则：设备上报即推送的原则。即对外推送设备当时上报的数据，如果某个数据设备实际上报时没有包含，则不会推送</h4>
<h4>注：数据推送的current 内的属性释义和实时数据查询接口返回的Identifier一致，其属性中中包含了通道号，来标识其是哪个通道的数据：</h4>
<pre><code> {
&quot;keyCode&quot;: &quot;869861064957108&quot;,
&quot;equipmentTypeId&quot;: &quot;103&quot;,
&quot;generateTime&quot;: 1595985607000,
&quot;current&quot;: {
&quot;Status1&quot;: 1,
&quot;Status2&quot;: 1,
&quot;Status3&quot;: 1,
&quot;Ua1&quot;: 220,
&quot;Ua2&quot;: 221,
&quot;Ua3&quot;: 220,
&quot;Ia1&quot;: 16,
&quot;Ia2&quot;: 15.8,
&quot;Ia3&quot;: 16,
&quot;Pa1&quot;: 1000,
&quot;Pa2&quot;: 1000,
&quot;Pa3&quot;: 1000,
&quot;EpA1&quot;: 1000,
&quot;EpA2&quot;: 1000,
&quot;EpA3&quot;: 1000
}
}
</code></pre>
<h3>2. 智能照明实时数据接口返回示例</h3>
<h4>接口：[<a href="https://www.zsdcloud.cn:8443/openApi/equipment/select.action](https://www.showdoc.com.cn/382341824968230/2217337700681456">https://www.zsdcloud.cn:8443/openApi/equipment/select.action](https://www.showdoc.com.cn/382341824968230/2217337700681456</a> "<a href="https://www.zsdcloud.cn:8443/openApi/equipment/select.action"">https://www.zsdcloud.cn:8443/openApi/equipment/select.action"</a>;)</h4>
<h4>注意：智能照明由于属性众多，其Identifer中包含了通道号，来标识其是哪个通道的数据；其childList中的channelNum代表此子设备有几个通道，即几个灯</h4>
<table>
<thead>
<tr>
<th>实时数据属性</th>
<th>释义</th>
</tr>
</thead>
<tbody>
<tr>
<td>Status</td>
<td>灯状态， eg: <code>Status1</code>、<code>Status2</code> 分别代表灯1、灯2的状态，值1开，值0关</td>
</tr>
<tr>
<td>Ua</td>
<td>电压，需要设备支持 ，eg：<code>Ua1</code>、<code>Ua2</code>分别代表灯1、灯2的电压，需要设备上报才会返回</td>
</tr>
<tr>
<td>Ia</td>
<td>电流，需要设备支持，eg：<code>Ia1</code>、<code>Ia2</code>分别代表灯1、灯2的电流，需要设备上报才会返回</td>
</tr>
<tr>
<td>Pa</td>
<td>功率，需要设备支持 ，eg：<code>Pa1</code>、<code>Pa2</code>分别代表灯1、灯2的功率，需要设备上报才会返回</td>
</tr>
<tr>
<td>EpA</td>
<td>电能，需要设备支持，eg：<code>EpA1</code>、<code>EpA2</code>分别代表灯1、灯2的总电能，需要设备上报才会返回</td>
</tr>
</tbody>
</table>
<h4>接口返回示例：</h4>
<pre><code> {
&quot;statusCode&quot;: 200,
&quot;message&quot;: &quot;Success&quot;,
&quot;result&quot;: {
&quot;equipmentInfo&quot;: {
&quot;equipmentTypeId&quot;: &quot;103&quot;,
&quot;keyCode&quot;: &quot;869861064957108&quot;,
&quot;keyType&quot;: &quot;5&quot;,
&quot;typeName&quot;: &quot;light-system&quot;,
&quot;typeRemark&quot;: &quot;智能照明控制器&quot;,
&quot;installAdd&quot;: &quot;二楼中转仓库&quot;,
&quot;createTime&quot;: 1572577776000,
&quot;sellEndTime&quot;: 1604200176000,
&quot;status&quot;: 0,
&quot;protocolName&quot;: &quot;LC_MQTT&quot;,
&quot;protocolId&quot;: &quot;426&quot;
},
&quot;childList&quot;: [
{
&quot;equipmentId&quot;: &quot;1722123290220904448&quot;,
&quot;childDeviceStatus&quot;: 3,
&quot;childDeviceId&quot;: &quot;1722123632564207616&quot;,
&quot;childDeviceKey&quot;: &quot;1&quot;,
&quot;childInstallAdd&quot;: &quot;3路照明控制器&quot;,
&quot;channelNum&quot;:3,
&quot;valueList&quot;: [
{
&quot;Identifier&quot;: &quot;Status1&quot;,
&quot;IdentifierDis&quot;:&quot;1&quot;, // 如果Identifer的IdentiferDis相同，代表属于同一通道灯的数据
&quot;ShowKey&quot;: &quot;Status1&quot;,
&quot;Name&quot;: &quot;灯1状态&quot;,
&quot;DataType&quot;: &quot;bool&quot;,
&quot;Unit&quot;: &quot;&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;0.0&quot;,
&quot;DataSpecsList&quot;: [
{
&quot;dataType&quot;: &quot;INT&quot;,
&quot;name&quot;: &quot;关&quot;,
&quot;value&quot;: &quot;0&quot;
},
{
&quot;dataType&quot;: &quot;INT&quot;,
&quot;name&quot;: &quot;开&quot;,
&quot;value&quot;: &quot;1&quot;
}
],
&quot;Alias&quot;: &quot;通道1&quot;
},
{
&quot;Identifier&quot;: &quot;Ua1&quot;,
&quot;IdentifierDis&quot;:&quot;1&quot;,
&quot;ShowKey&quot;: &quot;Ua1&quot;,
&quot;Name&quot;: &quot;灯1电压&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;V&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;220.0&quot;,
&quot;Alias&quot;: &quot;通道1&quot;
},
{
&quot;Identifier&quot;: &quot;Ia1&quot;,
&quot;IdentifierDis&quot;:&quot;1&quot;,
&quot;ShowKey&quot;: &quot;Ia1&quot;,
&quot;Name&quot;: &quot;灯1电流&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;A&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;16.0&quot;,
&quot;Alias&quot;: &quot;通道1&quot;
},
{
&quot;Identifier&quot;: &quot;Pa1&quot;,
&quot;IdentifierDis&quot;:&quot;1&quot;,
&quot;ShowKey&quot;: &quot;Pa1&quot;,
&quot;Name&quot;: &quot;灯1功率&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;W&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;1000&quot;,
&quot;Alias&quot;: &quot;通道1&quot;
},
{
&quot;Identifier&quot;: &quot;EpA1&quot;,
&quot;IdentifierDis&quot;:&quot;1&quot;,
&quot;ShowKey&quot;: &quot;EpA1&quot;,
&quot;Name&quot;: &quot;灯1电能&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;kW·h&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;1000&quot;,
&quot;Alias&quot;: &quot;通道1&quot;
},
{
&quot;Identifier&quot;: &quot;Status2&quot;,
&quot;IdentifierDis&quot;:&quot;2&quot;,
&quot;ShowKey&quot;: &quot;Status2&quot;,
&quot;Name&quot;: &quot;灯2状态&quot;,
&quot;DataType&quot;: &quot;bool&quot;,
&quot;Unit&quot;: &quot;&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;0.0&quot;,
&quot;DataSpecsList&quot;: [
{
&quot;dataType&quot;: &quot;INT&quot;,
&quot;name&quot;: &quot;关&quot;,
&quot;value&quot;: &quot;0&quot;
},
{
&quot;dataType&quot;: &quot;INT&quot;,
&quot;name&quot;: &quot;开&quot;,
&quot;value&quot;: &quot;1&quot;
}
],
&quot;Alias&quot;: &quot;通道2&quot;
},
{
&quot;Identifier&quot;: &quot;Ua2&quot;,
&quot;IdentifierDis&quot;:&quot;2&quot;,
&quot;ShowKey&quot;: &quot;Ua2&quot;,
&quot;Name&quot;: &quot;灯2电压&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;V&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;220.0&quot;,
&quot;Alias&quot;: &quot;通道2&quot;
},
{
&quot;Identifier&quot;: &quot;Ia2&quot;,
&quot;IdentifierDis&quot;:&quot;2&quot;,
&quot;ShowKey&quot;: &quot;Ia2&quot;,
&quot;Name&quot;: &quot;灯2电流&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;A&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;16.0&quot;,
&quot;Alias&quot;: &quot;通道2&quot;
},
{
&quot;Identifier&quot;: &quot;Pa2&quot;,
&quot;IdentifierDis&quot;:&quot;2&quot;,
&quot;ShowKey&quot;: &quot;Pa2&quot;,
&quot;Name&quot;: &quot;灯2功率&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;W&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;1000&quot;,
&quot;Alias&quot;: &quot;通道2&quot;
},
{
&quot;Identifier&quot;: &quot;EpA2&quot;,
&quot;IdentifierDis&quot;:&quot;2&quot;,
&quot;ShowKey&quot;: &quot;EpA2&quot;,
&quot;Name&quot;: &quot;灯2电能&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;kW·h&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;1000&quot;,
&quot;Alias&quot;: &quot;通道2&quot;
},
{
&quot;Identifier&quot;: &quot;Status3&quot;,
&quot;IdentifierDis&quot;:&quot;3&quot;,
&quot;ShowKey&quot;: &quot;Status3&quot;,
&quot;Name&quot;: &quot;灯3状态&quot;,
&quot;DataType&quot;: &quot;bool&quot;,
&quot;Unit&quot;: &quot;&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;0.0&quot;,
&quot;DataSpecsList&quot;: [
{
&quot;dataType&quot;: &quot;INT&quot;,
&quot;name&quot;: &quot;关&quot;,
&quot;value&quot;: &quot;0&quot;
},
{
&quot;dataType&quot;: &quot;INT&quot;,
&quot;name&quot;: &quot;开&quot;,
&quot;value&quot;: &quot;1&quot;
}
],
&quot;Alias&quot;: &quot;通道3&quot;
},
{
&quot;Identifier&quot;: &quot;Ua3&quot;,
&quot;IdentifierDis&quot;:&quot;3&quot;,
&quot;ShowKey&quot;: &quot;Ua3&quot;,
&quot;Name&quot;: &quot;灯3电压&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;V&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;220.0&quot;,
&quot;Alias&quot;: &quot;通道3&quot;
},
{
&quot;Identifier&quot;: &quot;Ia3&quot;,
&quot;IdentifierDis&quot;:&quot;3&quot;,
&quot;ShowKey&quot;: &quot;Ia3&quot;,
&quot;Name&quot;: &quot;灯3电流&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;A&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;16.0&quot;,
&quot;Alias&quot;: &quot;通道3&quot;
},
{
&quot;Identifier&quot;: &quot;Pa3&quot;,
&quot;IdentifierDis&quot;:&quot;3&quot;,
&quot;ShowKey&quot;: &quot;Pa3&quot;,
&quot;Name&quot;: &quot;灯3功率&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;W&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;1000&quot;,
&quot;Alias&quot;: &quot;通道3&quot;
},
{
&quot;Identifier&quot;: &quot;EpA3&quot;,
&quot;IdentifierDis&quot;:&quot;3&quot;,
&quot;ShowKey&quot;: &quot;EpA3&quot;,
&quot;Name&quot;: &quot;灯3电能&quot;,
&quot;DataType&quot;: &quot;double&quot;,
&quot;Unit&quot;: &quot;kW·h&quot;,
&quot;Time&quot;: &quot;1699421282880&quot;,
&quot;Value&quot;: &quot;1000&quot;,
&quot;Alias&quot;: &quot;通道3&quot;
}
],
&quot;matchKey&quot;: &quot;1&quot;
}
]
}
}
</code></pre>
<h3>3. 智能照明-获取可设置的参数示例</h3>
<h4>接口：[<a href="https://www.zsdcloud.cn:8443/openApi/equipmentTemplateConfig/queryDeviceDesiredTemplateConfig.action](https://www.showdoc.com.cn/382341824968230/10705384983141691">https://www.zsdcloud.cn:8443/openApi/equipmentTemplateConfig/queryDeviceDesiredTemplateConfig.action](https://www.showdoc.com.cn/382341824968230/10705384983141691</a> "<a href="https://www.zsdcloud.cn:8443/openApi/equipmentTemplateConfig/queryDeviceDesiredTemplateConfig.action"">https://www.zsdcloud.cn:8443/openApi/equipmentTemplateConfig/queryDeviceDesiredTemplateConfig.action"</a>;)</h4>
<h3>4. 智能照明控制接口下发示例</h3>
<h4>接口：[<a href="https://www.zsdcloud.cn:8443/openApi/equipment/control.action](https://www.showdoc.com.cn/382341824968230/2216799121381121">https://www.zsdcloud.cn:8443/openApi/equipment/control.action](https://www.showdoc.com.cn/382341824968230/2216799121381121</a> "<a href="https://www.zsdcloud.cn:8443/openApi/equipment/control.action"">https://www.zsdcloud.cn:8443/openApi/equipment/control.action"</a>;)</h4>
<h4>注意：控制智能照明时，接口的<code>childDeviceKey</code>, <code>channels</code>必传，智能照明控制开关灯的操作指令setInfo为：<code>{&quot;Status&quot;:1}</code>，值1为开灯，0为关灯。</h4>
<h4>数据示例：</h4>
<ul>
<li>控制开关灯：<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>
<li>控制保护设置参数： <code>childDeviceKey</code>传<code>1</code>, <code>channels</code> 传 <code>1,2,3</code>，setInfo传：<code>{&quot;Over_I&quot;:16,&quot;Over_I_RD&quot;:0.5}</code>，代表控制modbus地址1的1,2,3通道的过载保护值为16A，过载保护回差值为0.5A</li>
<li>控制配方设置参数 <code>childDeviceKey</code>传<code>1</code>, <code>recordNo</code> 传 <code>1</code>，setInfo传：<code>{&quot;Enable&quot;:1,&quot;Iillu_Enable&quot;:1,&quot;S_Year&quot;:2023,&quot;S_Month&quot;:11,&quot;S_Day&quot;:30,&quot;S_Hour&quot;:18,&quot;S_Minute&quot;:30,&quot;E_Year&quot;:2023,&quot;E_Month&quot;:12,&quot;E_Day&quot;:30,&quot;E_Hour&quot;:6,&quot;E_Minute&quot;:30,&quot;Monday&quot;:1,&quot;Tuesday&quot;:1,&quot;Wednesday&quot;:1,&quot;Thursday&quot;:1,&quot;Friday&quot;:1,&quot;Saturday&quot;:0,&quot;Sunday&quot;:0,&quot;Enable_Light&quot;:&quot;[1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0]&quot;,&quot;S_Mode&quot;:0,&quot;E_Mode&quot;:0}</code>，代表控制modbus地址1的设备，开启配方1,开启光照功能，在2023-11-30 ~ 2023-12-30 的时间内，每周一、二、三、四、五,18:30开灯，06:30熄灯，启用的通道为通道1和通道2</li>
</ul>