安圣二开设备(开放式硬件)

本项目是安圣信息科技二开设备(开放式硬件)的资料文档,因产品不断迭代,因此资料同步更新,请产看使用最新版本


订单命令

<p>[TOC]</p> <table> <thead> <tr> <th>4G喇叭</th> <th>4G开关</th> <th>WiFi喇叭</th> <th>WiFi开关</th> </tr> </thead> <tbody> <tr> <td>&lt;font color=&quot;red&quot;&gt;<strong>&amp;times;</strong>&lt;/font&gt;</td> <td>&lt;font color=&quot;green&quot;&gt;<strong>&amp;radic;</strong>&lt;/font&gt;</td> <td>&lt;font color=&quot;red&quot;&gt;<strong>&amp;times;</strong>&lt;/font&gt;</td> <td>&lt;font color=&quot;green&quot;&gt;<strong>&amp;radic;</strong>&lt;/font&gt;</td> </tr> </tbody> </table> <p>支持此功能的设备类型:&lt;font color=&quot;green&quot;&gt;<strong>&amp;radic;</strong>&lt;/font&gt;-支持 &lt;font color=&quot;red&quot;&gt;<strong>&amp;times;</strong>&lt;/font&gt;-不支持</p> <h2>订单任务说明</h2> <p>开关设备每个插槽可以启动一个订单任务,订单任务可以是计时、计量,remark可以用来记录订单编号,作为唯一标识。 订单开始会打开插槽开关,订单结束后会自动关闭插槽开关。 订单状态可以用getDevStatus命令获取。 订单结束后会主动上报getDevStatus应答和orderUp应答(orderUp WiFi开关暂不支持)。</p> <h2>启动订单任务(start)</h2> <p><strong>简要描述</strong> 启动订单任务。 <strong>特别注意,使用此功能命令时,会与实时开关命令,订单任务相关命令相冲突,必须关闭其任务后,独立启动该任务</strong></p> <p><strong>命令参数</strong></p> <table> <thead> <tr> <th>参数名</th> <th>必须</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>method</td> <td>是</td> <td>string</td> <td>start</td> </tr> <tr> <td>slotNum</td> <td>是</td> <td>int</td> <td>插槽编号,从1开始</td> </tr> <tr> <td>type</td> <td>是</td> <td>string</td> <td>订单类型,<code>TIME</code>-计时;<code>POWER</code>-计量</td> </tr> <tr> <td>timeSec</td> <td>是</td> <td>int</td> <td>计时秒数。该参数在<code>type</code>为<code>TIME</code>时有效</td> </tr> <tr> <td>powerKwh</td> <td>是</td> <td>double</td> <td>计量电量,单位度。该参数在<code>type</code>为<code>POWER</code>时有效</td> </tr> <tr> <td>powerMaxSec</td> <td>是</td> <td>int</td> <td>计量最大秒数,总运行秒数到达计量最大秒数,任务停止。0为不限制。该参数在<code>type</code>为<code>POWER</code>时有效</td> </tr> <tr> <td>maxPower</td> <td>是</td> <td>int</td> <td>最大功率,单位W。超过最大功率,任务自动停止。<code>0</code>为使用设备默认值1400(不同设备有不同默认值)</td> </tr> <tr> <td>pullOutStop</td> <td>是</td> <td>bool</td> <td>拔出自停。<code>true</code>-启用;<code>false</code>-禁用</td> </tr> <tr> <td>pullOutStopPower</td> <td>是</td> <td>int</td> <td>拔出自停功率,在拔出自停启用,且当前功率小于拔出自停功率时,任务自动停止。<code>0</code>为使用设备默认拔出自停功率3(不同设备有不同默认值)</td> </tr> <tr> <td>pullOutStopStartSec</td> <td>是</td> <td>int</td> <td>订单启动后拔出自停开始判断秒数,默认0秒</td> </tr> <tr> <td>chargeFullStop</td> <td>是</td> <td>bool</td> <td>充满自停。<code>true</code>-启用;<code>false</code>-禁用</td> </tr> <tr> <td>chargeFullStopPower</td> <td>是</td> <td>int</td> <td>充满自停功率。<code>0</code>为使用设备默认值5(不同设备有不同默认值)</td> </tr> <tr> <td>chageFullStopSec</td> <td>是</td> <td>int</td> <td>充满自停秒数,在充满自停启用,且当前功率小于充满自停功率并持续充满自停秒数后,任务自动停止。<code>0</code>为使用设备默认值60(不同设备有不同默认值)</td> </tr> <tr> <td>chargeFullStopStartSec</td> <td>是</td> <td>int</td> <td>订单启动后充满自停开始判断秒数,默认0秒</td> </tr> <tr> <td>remark</td> <td>否</td> <td>string</td> <td>订单备注,启动订单时传入,可用于记录订单编号</td> </tr> <tr> <td>frameId</td> <td>否</td> <td>string</td> <td>帧ID</td> </tr> </tbody> </table> <p><strong>命令示例</strong></p> <pre><code> { &amp;quot;method&amp;quot;: &amp;quot;start&amp;quot;, &amp;quot;slotNum&amp;quot;: 1, &amp;quot;type&amp;quot;: &amp;quot;TIME&amp;quot;, &amp;quot;maxPower&amp;quot;: 2000, &amp;quot;pullOutStop&amp;quot;: false, &amp;quot;pullOutStopPower&amp;quot;: 5, &amp;quot;pullOutStopStartSec&amp;quot;: 0, &amp;quot;chargeFullStop&amp;quot;: false, &amp;quot;chargeFullStopPower&amp;quot;: 10, &amp;quot;chargeFullStopSec&amp;quot;: 60, &amp;quot;chargeFullStopStartSec&amp;quot;: 0, &amp;quot;remark&amp;quot;: &amp;quot;12332123&amp;quot;, &amp;quot;timeSec&amp;quot;: 600, &amp;quot;frameId&amp;quot;: &amp;quot;1745462466369&amp;quot; }</code></pre> <p><strong>应答参数说明</strong></p> <table> <thead> <tr> <th>参数名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>method</td> <td>string</td> <td>start</td> </tr> <tr> <td>result</td> <td>string</td> <td>返回结果。<code>ok</code>-成功;其他-具体失败原因</td> </tr> <tr> <td>slotNum</td> <td>int</td> <td>插槽编号,从1开始</td> </tr> <tr> <td>remark</td> <td>string</td> <td>订单备注,启动订单时传入,可用于记录订单编号</td> </tr> <tr> <td>imei</td> <td>string</td> <td>设备imei</td> </tr> <tr> <td>frameId</td> <td>string</td> <td>同命令<code>frameId</code></td> </tr> <tr> <td>timestamp</td> <td>int</td> <td>秒级时间戳,WiFi款不支持</td> </tr> </tbody> </table> <p><strong>应答示例</strong></p> <pre><code>{ &amp;quot;timestamp&amp;quot;: 1745462466, &amp;quot;imei&amp;quot;: &amp;quot;864536072949900&amp;quot;, &amp;quot;remark&amp;quot;: &amp;quot;12332123&amp;quot;, &amp;quot;method&amp;quot;: &amp;quot;start&amp;quot;, &amp;quot;slotNum&amp;quot;: 1, &amp;quot;result&amp;quot;: &amp;quot;ok&amp;quot;, &amp;quot;frameId&amp;quot;: &amp;quot;1745462466369&amp;quot; }</code></pre> <p><strong>备注</strong> 无</p> <h2>结束订单任务(stop)</h2> <p><strong>简要描述</strong> 结束订单任务。</p> <p><strong>命令参数</strong></p> <table> <thead> <tr> <th>参数名</th> <th>必须</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>method</td> <td>是</td> <td>string</td> <td>stop</td> </tr> <tr> <td>slotNum</td> <td>是</td> <td>int</td> <td>插槽编号,从1开始</td> </tr> <tr> <td>frameId</td> <td>否</td> <td>string</td> <td>帧ID</td> </tr> </tbody> </table> <p><strong>命令示例</strong></p> <pre><code>{ &amp;quot;method&amp;quot;: &amp;quot;stop&amp;quot;, &amp;quot;slotNum&amp;quot;: 1, &amp;quot;frameId&amp;quot;: &amp;quot;1745456483900&amp;quot; }</code></pre> <p><strong>应答参数说明</strong></p> <table> <thead> <tr> <th>参数名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>method</td> <td>string</td> <td>stop</td> </tr> <tr> <td>result</td> <td>string</td> <td>返回结果。<code>ok</code>-成功;其他-具体失败原因</td> </tr> <tr> <td>slotNum</td> <td>int</td> <td>插槽编号,从1开始</td> </tr> <tr> <td>imei</td> <td>string</td> <td>设备imei</td> </tr> <tr> <td>frameId</td> <td>string</td> <td>同命令<code>frameId</code></td> </tr> <tr> <td>timestamp</td> <td>int</td> <td>秒级时间戳,WiFi款不支持</td> </tr> </tbody> </table> <p><strong>应答示例</strong></p> <pre><code>{ &amp;quot;method&amp;quot;: &amp;quot;stop&amp;quot;, &amp;quot;result&amp;quot;: &amp;quot;ok&amp;quot;, &amp;quot;slotNum&amp;quot;: 1, &amp;quot;timestamp&amp;quot;: 1745456483, &amp;quot;imei&amp;quot;: &amp;quot;864536072949900&amp;quot;, &amp;quot;frameId&amp;quot;: &amp;quot;1745456483900&amp;quot; }</code></pre> <p><strong>备注</strong> 无</p> <h2>获取订单信息(orderUp)</h2> <p><strong>简要描述</strong> 获取订单信息。(<strong>WiFi开关暂不支持</strong>)</p> <p><strong>命令参数</strong></p> <table> <thead> <tr> <th>参数名</th> <th>必须</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>method</td> <td>是</td> <td>string</td> <td>orderUp</td> </tr> <tr> <td>slotNum</td> <td>是</td> <td>int</td> <td>插槽编号,从1开始</td> </tr> <tr> <td>frameId</td> <td>否</td> <td>string</td> <td>帧ID</td> </tr> </tbody> </table> <p><strong>命令示例</strong></p> <pre><code>{ &amp;quot;method&amp;quot;: &amp;quot;orderUp&amp;quot;, &amp;quot;slotNum&amp;quot;: 1, &amp;quot;frameId&amp;quot;: &amp;quot;1745456483900&amp;quot; }</code></pre> <p><strong>应答参数说明</strong></p> <table> <thead> <tr> <th>参数名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>method</td> <td>string</td> <td>orderUp</td> </tr> <tr> <td>result</td> <td>string</td> <td>返回结果。<code>ok</code>-成功;其他-具体失败原因</td> </tr> <tr> <td>slotNum</td> <td>int</td> <td>插槽编号,从1开始</td> </tr> <tr> <td>type</td> <td>string</td> <td>订单类型,<code>TIME</code>-计时;<code>POWER</code>-计量</td> </tr> <tr> <td>status</td> <td>string</td> <td>订单状态,<code>idle</code>-空闲/结束;<code>working</code>-进行中</td> </tr> <tr> <td>timeSec</td> <td>int</td> <td>计时秒数。该参数在<code>type</code>为<code>TIME</code>时有效</td> </tr> <tr> <td>powerKwh</td> <td>double</td> <td>计量电量,单位度。该参数在<code>type</code>为<code>POWER</code>时有效</td> </tr> <tr> <td>powerMaxSec</td> <td>int</td> <td>计量最大秒数,总运行秒数到达计量最大秒数,任务停止。<code>0</code>为不限制。该参数在type为POWER时有效</td> </tr> <tr> <td>maxPower</td> <td>int</td> <td>最大功率,单位W。超过最大功率,任务自动停止。<code>0</code>为使用设备默认值1400(不同设备有不同默认值)</td> </tr> <tr> <td>pullOutStop</td> <td>bool</td> <td>拔出自停。<code>true</code>-启用;<code>false</code>-禁用</td> </tr> <tr> <td>pullOutStopPower</td> <td>int</td> <td>拔出自停功率,在拔出自停启用,且当前功率小于拔出自停功率时,任务自动停止。<code>0</code>为使用设备默认拔出自停功率3(不同设备有不同默认值)</td> </tr> <tr> <td>pullOutStopStartSec</td> <td>int</td> <td>订单启动后拔出自停开始判断秒数,默认0秒</td> </tr> <tr> <td>chargeFullStop</td> <td>bool</td> <td>充满自停。<code>true</code>-启用;<code>false</code>-禁用</td> </tr> <tr> <td>chargeFullStopPower</td> <td>int</td> <td>充满自停功率。<code>0</code>为使用设备默认值5(不同设备有不同默认值)</td> </tr> <tr> <td>chageFullStopSec</td> <td>int</td> <td>充满自停秒数,在充满自停启用,且当前功率小于充满自停功率并持续充满自停秒数后,任务自动停止。<code>0</code>为使用设备默认值60(不同设备有不同默认值)</td> </tr> <tr> <td>chargeFullStopStartSec</td> <td>int</td> <td>订单启动后充满自停开始判断秒数,默认0秒</td> </tr> <tr> <td>remark</td> <td>string</td> <td>订单备注,启动订单时传入,可用于记录订单编号</td> </tr> <tr> <td>closeReason</td> <td>string</td> <td>关闭原因</td> </tr> <tr> <td>totalSec</td> <td>int</td> <td>总运行秒数</td> </tr> <tr> <td>totalKwh</td> <td>double</td> <td>总运行度数</td> </tr> <tr> <td>details</td> <td>array</td> <td>24小时分时段用电量统计详情。数组长度48,从0时0分开始记录每半小时的用电量统计,单位:度。此命令依赖于实时时间,请使用[设置时间(setTime)](<a href="https://www.showdoc.com.cn/asopen/11558676688625780">https://www.showdoc.com.cn/asopen/11558676688625780</a> &quot;设置时间(setTime)&quot;)命令同步终端与服务器的时间。跨天的电量是累加的,比如 昨天的00:00 - 00:30 和 今天的00:00 - 00:30 的电量是累加在一起的。新订单启动会清空累计电量。</td> </tr> <tr> <td>imei</td> <td>string</td> <td>设备imei</td> </tr> <tr> <td>frameId</td> <td>string</td> <td>同命令<code>frameId</code></td> </tr> <tr> <td>timestamp</td> <td>int</td> <td>秒级时间戳,WiFi款不支持</td> </tr> </tbody> </table> <p><strong>应答示例</strong></p> <pre><code>{ &amp;quot;chargeFullStop&amp;quot;: false, &amp;quot;closeReason&amp;quot;: &amp;quot;CLOSED&amp;quot;, &amp;quot;method&amp;quot;: &amp;quot;orderUp&amp;quot;, &amp;quot;status&amp;quot;: &amp;quot;idle&amp;quot;, &amp;quot;timestamp&amp;quot;: 1745463066, &amp;quot;details&amp;quot;: [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0], &amp;quot;slotNum&amp;quot;: 1, &amp;quot;imei&amp;quot;: &amp;quot;864536072949900&amp;quot;, &amp;quot;frameId&amp;quot;: 1745463065, &amp;quot;totalKwh&amp;quot;: &amp;quot;0.0000&amp;quot;, &amp;quot;pullOutStop&amp;quot;: false, &amp;quot;chargeFullStopSec&amp;quot;: 60, &amp;quot;type&amp;quot;: &amp;quot;TIME&amp;quot;, &amp;quot;remark&amp;quot;: &amp;quot;12332123&amp;quot;, &amp;quot;endTime&amp;quot;: 1745463065, &amp;quot;result&amp;quot;: &amp;quot;ok&amp;quot;, &amp;quot;startTime&amp;quot;: 1745462466, &amp;quot;timeSec&amp;quot;: 600, &amp;quot;totalSec&amp;quot;: 600, &amp;quot;pullOutStopStartSec&amp;quot;: 0, &amp;quot;pullOutStopPower&amp;quot;: 5, &amp;quot;chargeFullStopStartSec&amp;quot;: 0, &amp;quot;chargeFullStopPower&amp;quot;: 10, &amp;quot;maxPower&amp;quot;: 2000 }</code></pre> <p><strong>备注</strong> 无</p>

页面列表

ITEM_HTML