物联网平台 OTA 命令升级
<p>[TOC]</p>
<h3>接口简述</h3>
<ul>
<li>该升级接口仅适用于自己接入物联网平台(中国电信、中国移动)的客户使用</li>
<li>这里 OTA 升级,需要自己提供 OTA 升级包(如果没有,可向我司索取,需提供现有设备版本号,版本号设备里面可查询)</li>
<li>只有涉及到重大问题的时候,才建议使用 OTA 升级功能;其他时候,不建议使用</li>
<li>说明:这里的升级命令是针对<code>801,802,803</code>开头的命令内容,进行的升级操作</li>
</ul>
<h3>升级流程</h3>
<ol>
<li>锁端管理员进入菜单页面,选择“<code>系统管理</code>”-->“<code>系统升级</code>” 菜单,进行 OTA 数据申请</li>
<li>贵公司收到物联网平台上报的内容后,直接调用该接口</li>
<li>该接口返回物联网平台所需的相关命令数据(这里为单条或多条)</li>
<li>通过该接口返回的命令数据,直接自行下发物联网命令到自己锁端即可</li>
<li>持续进行2~4步操作,大约十几分钟,会提示升级成功;升级成功后,物联网平台也会返回 <code>804</code>数据</li>
</ol>
<h3>请求URL</h3>
<ul>
<li><code>commercial/device/ota</code></li>
</ul>
<h3>请求方式</h3>
<ul>
<li><code>PUT</code></li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>buttPlatformType</td>
<td>是</td>
<td>Integer</td>
<td>对接平台类型(0:中国电信;1:OneNET)</td>
</tr>
<tr>
<td>filePath</td>
<td>是</td>
<td>String</td>
<td>OTA 文件路径</td>
</tr>
<tr>
<td>content</td>
<td>是</td>
<td>String</td>
<td>命令上报内容</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>{
"buttPlatformType": 0,
"filePath": "https://prod-read.oss-cn-shanghai.aliyuncs.com/ota/YY_OC_SY1_NB701_000_210812.bin",
"content": "801"
}</code></pre>
<h3>返回参数(中国电信)</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>serviceId</td>
<td>是</td>
<td>String</td>
<td>服务 id</td>
</tr>
<tr>
<td>method</td>
<td>是</td>
<td>String</td>
<td>方法</td>
</tr>
<tr>
<td>paras</td>
<td>是</td>
<td>String</td>
<td>具体的命令内容</td>
</tr>
</tbody>
</table>
<h3>返回示例(中国电信)</h3>
<pre><code>{
"code": 0,
"message": "成功",
"data": [
{
"method": "otaDown",
"paras": {
"data": "801YY_OC_SY1_NB701_000_210812"
},
"serviceId": "ota"
}
]
}</code></pre>
<hr />
<h3>返回参数(OneNET)</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>obj_inst_id</td>
<td>是</td>
<td>String</td>
<td>对象实例 id</td>
</tr>
<tr>
<td>ds_id</td>
<td>是</td>
<td>String</td>
<td>ds id</td>
</tr>
<tr>
<td>val</td>
<td>是</td>
<td>String</td>
<td>具体的命令内容</td>
</tr>
</tbody>
</table>
<h3>返回示例(OneNET)</h3>
<pre><code>{
"code": 0,
"message": "成功",
"data": [
{
"val": "801YY_ON_SY1_NB700_000_200501",
"obj_inst_id": 13
}
]
}</code></pre>