推送格式和数据释义
<p><strong>1. 简介：</strong> </p>
<ul>
<li>本文介绍物联网云平台数据推送的格式和字段释义</li>
</ul>
<p><strong> 2. 注意：</strong></p>
<ul>
<li><strong>数据推送的原则为：设备上报即推送。即平台对外推送设备当时实际上报的数据，如果某个数据设备上报时没有包含，则不会推送；平台也不会定时推送设备数据</strong></li>
</ul>
<p><strong> 3. 数据格式：</strong></p>
<pre><code> {
&quot;keyCode&quot;: &quot;900001&quot;,
&quot;equipmentTypeId&quot;: &quot;7&quot;,
&quot;generateTime&quot;: 1595985607000,
&quot;current&quot;: {
&quot;RSSI&quot;: &quot;-101&quot;,
&quot;fault_type&quot;: 2
}
}
</code></pre>
<table>
<thead>
<tr>
<th style="text-align: left;">字段名</th>
<th style="text-align: left;">值类型</th>
<th>释义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">equipmentTypeId</td>
<td style="text-align: left;">String</td>
<td>设备类型标识，值释义参考[附录](<a href="https://www.showdoc.com.cn/382341824968230/5064811332473317">https://www.showdoc.com.cn/382341824968230/5064811332473317</a> "附录")</td>
</tr>
<tr>
<td style="text-align: left;">keyCode</td>
<td style="text-align: left;">String</td>
<td>设备 / 网关的唯一识别码</td>
</tr>
<tr>
<td style="text-align: left;">generateTime</td>
<td style="text-align: left;">Long</td>
<td>云端收到消息时的毫秒级时间戳</td>
</tr>
<tr>
<td style="text-align: left;">current</td>
<td style="text-align: left;"><strong>JSONObject</strong></td>
<td>设备的实时消息组成的JSON</td>
</tr>
</tbody>
</table>
<p><strong> 4. 设备实时消息(上述current)会推送的内容：</strong></p>
<ul>
<li><strong>公共字段，对所有设备类型都适用</strong></li>
</ul>
<table>
<thead>
<tr>
<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;">LineNo</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">子设备标识码，释义同部分接口的childDeviceKey</td>
</tr>
<tr>
<td style="text-align: left;"><strong>fault_type</strong></td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">设备状态，约定值为 <strong>0表示正常，1表示故障，2表示报警，3表示离线</strong>。设备状态变化时，会推送该字段</td>
</tr>
<tr>
<td style="text-align: left;">device_status_desc</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">设备状态描述</td>
</tr>
<tr>
<td style="text-align: left;">exception_type / exceptionType</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">设备异常类型，具体值释义请查看[附录](<a href="https://www.showdoc.com.cn/382341824968230/5064811332473317">https://www.showdoc.com.cn/382341824968230/5064811332473317</a> "附录")</td>
</tr>
<tr>
<td style="text-align: left;">life_time</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">设备的心跳周期，单位分钟</td>
</tr>
<tr>
<td style="text-align: left;">RSSI</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">无线电信号强度</td>
</tr>
<tr>
<td style="text-align: left;">link_utilization</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">链路利用率</td>
</tr>
<tr>
<td style="text-align: left;">cell_id</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">定位技术</td>
</tr>
<tr>
<td style="text-align: left;">BatteryLevel</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">电池电量，百分比</td>
</tr>
<tr>
<td style="text-align: left;">temperature_value</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">温度值，单位摄氏度</td>
</tr>
</tbody>
</table>
<ul>
<li><strong>特有字段，某个设备类型独有的</strong></li>
<li>对于<strong>智慧安全用电</strong></li>
</ul>
<table>
<thead>
<tr>
<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;">opt_count</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">通道数量</td>
</tr>
<tr>
<td style="text-align: left;">opt_config</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道配置，eg: 1223333336，从左至右代表第1个至第N个通道的通道类型，约定1代表漏电，2代表温度，3-5代表电流，6代表电压，0代表此通道关闭</td>
</tr>
<tr>
<td style="text-align: left;">opt<strong>[N]</strong>enable</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">通道N使能，暂时N的范围为 1- 20，即最多可能至20个通道，eg: <code>{&quot;opt10enable&quot;:1}</code>, 值1代表开启，0代表关闭</td>
</tr>
<tr>
<td style="text-align: left;">opt<strong>[N]</strong>name</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N名称</td>
</tr>
<tr>
<td style="text-align: left;">sensor<strong>[N]</strong>value</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N实时值</td>
</tr>
<tr>
<td style="text-align: left;">sensor<strong>[N]</strong>units</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N单位</td>
</tr>
<tr>
<td style="text-align: left;">sensor<strong>[N]</strong>alarm_value</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N报警值</td>
</tr>
<tr>
<td style="text-align: left;">sensor<strong>[N]</strong>ALH</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N报警上限值</td>
</tr>
<tr>
<td style="text-align: left;">sensor<strong>[N]</strong>ALO</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N报警下限值</td>
</tr>
<tr>
<td style="text-align: left;">sensor<strong>[N]</strong>VLH</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N测量上限值</td>
</tr>
<tr>
<td style="text-align: left;">sensor<strong>[N]</strong>VLO</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">通道N测量下限值</td>
</tr>
</tbody>
</table>
<ul>
<li>对于<strong>智能配电箱</strong></li>
</ul>
<table>
<thead>
<tr>
<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;">LineNo</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">回路号</td>
</tr>
<tr>
<td style="text-align: left;">fKWHsum / Eptotal</td>
<td style="text-align: left;">float</td>
<td style="text-align: left;">回路总电能</td>
</tr>
</tbody>
</table>
<ul>
<li>对于<strong>烟感、可燃气、门磁开关、温湿度</strong></li>
</ul>
<table>
<thead>
<tr>
<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;">measured_value/measuredValue</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">烟感表示烟雾浓度值，可燃气代表燃气浓度值，门磁开关表示门的开关状态，温湿度代表湿度</td>
</tr>
</tbody>
</table>
<ul>
<li>对于<strong>水压、液位、消火栓</strong></li>
</ul>
<table>
<thead>
<tr>
<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;">measured_value/measuredValue</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">水压表示压力值，液位表示当前液位值，消火栓表示当前压力值/采集值</td>
</tr>
<tr>
<td style="text-align: left;">sensor_units</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">单位</td>
</tr>
</tbody>
</table>
<ul>
<li>对于<strong>火灾报警主机</strong> / <strong>用户信息传输装置</strong></li>
</ul>
<table>
<thead>
<tr>
<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;">extension</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">分机号</td>
</tr>
<tr>
<td style="text-align: left;">busNumber</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">总线号/回路号</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">地址号</td>
</tr>
<tr>
<td style="text-align: left;">evenName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">事件名称</td>
</tr>
<tr>
<td style="text-align: left;">installAdd</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">安装位置</td>
</tr>
<tr>
<td style="text-align: left;">equipmentTypeName</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">设备类型</td>
</tr>
<tr>
<td style="text-align: left;">childKeyCode</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">子设备号</td>
</tr>
</tbody>
</table>
<ul>
<li>对于<strong>可燃气体控制器</strong> / <strong>气体主机</strong></li>
</ul>
<table>
<thead>
<tr>
<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;">LineNo</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">探测器编号</td>
</tr>
<tr>
<td style="text-align: left;">GasType</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">气体类型</td>
</tr>
<tr>
<td style="text-align: left;">sensor_units</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">单位</td>
</tr>
<tr>
<td style="text-align: left;">measuredValue</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">气体浓度</td>
</tr>
<tr>
<td style="text-align: left;">gasState/status</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">探测器状态 0 正常 1 故障 2 报警 3 离线</td>
</tr>
<tr>
<td style="text-align: left;">DO1</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">继电器状态 0 断开 1 闭合</td>
</tr>
</tbody>
</table>