OneNET物联网平台 平台介绍 入门手册 设备开发指南 应用开发指南
API
API使用 API列表 SDK MQTT LwM2M EDP Modbus TCP
消息队列MQ HTTP推送
常见问题 发布公告

OTA服务使用说明

远程升级OTA功能面向终端提供远程升级的能力,可对终端的模组固件升级和MCU应用软件升级,目前OneNET平台的通用OTA服务提供升级包版本管理和差分生成、设备分组管理、升级包任务策略配置、升级任务状态修改、设备升级状态查看等功能。平台配置后需要终端配合执行相关任务才能完成检查升级任务,拉取升级文件和上报升级状态等操作。 dmp首页

以上如有问题,如需技术支持请先填写企业及项目信息申请

页面操作步骤:

step1. 注册/登录OneNET平台https://open.iot.10086.cn

step2. 点击设备管理模块,进入MDP管理模块。 dmp首页

step3. 左侧导航栏选择OTA升级,点击FOTA升级。 ota

step4. 选择固件管理,点击添加固件版本,在添加固件对话框中,输入固件信息,上传固件等信息。 ota

说明:

    a)根据设备使用的模组选择对应的厂商名称、模组型号(如在下拉框中没有你所使用的,可以联系18883296390或者选择其他)
    b)目标版本,固件版本号,仅支持英文字母、数字、点号、连接符和下划线,长度在1~50字符。
    c)版本整包:可选,完整包名不能包含中文字符。

ota

step5. 添加差分包,选择在某个固件包下单击“添加差分包”,在添加差分包对话框,选择初始版本号,上传升级包。 ota

说明:(差分包升级的情况下)

    a)初始版本:需要升级的设备当前的版本号;
    b)目标版本:设备升级成功后的版本号;
    c)上传升级包:如果用户手里有差分包,可以选择直接上传(此时设备端拿到差分包,还原成完整包需要用户自行实现);
    如果用户没有差分包,可以选择在线差分,此时设备下载升级包后需要使用OneNET平台提供SDK进行差分还原。

ota

step6. 添加升级任务:选择升级任务管理,单击“添加升级任务”,在添加升级任务对话框中,选择需要升级的设备、升级包和升级策略等信息。 ota

说明:

    a)升级名称:支持中文、数字、字母、空格已经-!@#¥%……&*等符号;
    b)选择升级包:这里可以选择完整包(初始版本为“Before Version”),也可以选择差分包(初始版本非“Before Version”);
    c)下拉选择升级的产品;
    d)选择设备,可以选择指定的设备或群组;
    e)下拉选择信号强度:这个数值将在检查任务成功返回给设备,有设备来决定当前设备信号是否满足升级要求;
    f)下拉剩余电量百分比:这个数值将在检查任务成功返回给设备,有设备来决定当前设备电量是否满足升级要求;
    g)重试策略:这个数值将在检查任务成功返回给设备,有设备来决定当前设备判断是否进行重试;
    h)执行策略:有启动执行和自定义时间两个选项,启动执行需要手动点击启动任务;自定义时间是指定时间,到时候是自动启动任务。
    i)截止时间:任务终止时间,当任务截止时间到达是,将终止所有设备的升级。

step7. 点击启动任务:如果在添加升级任务时,选择的执行策略为“启动执行”,需要在页面点击启动任务。 ota 到此已经完成升级任务的创建,下一步就需要设备来检测升级任务,拉取升级包进行升级等操作。

设备端操作

下面的操作是设备端进行(南向)

设备与平台采用HTTP协议RESTful标准格式进行数据交互,接口通过Authorization来鉴权,Authorization获取见安全鉴权章节。

step8. 检测升级任务

[检测升级任务接口](/book/device-develop/OTA/南向API接口/1检测升级任务.md)

step9. token校验

如果上一步成功检查到升级任务,得到任务和升级包相关信息,设备拉取升级包时,OneNET平台通过token进行校验,并且上一步返回的token只有48小时的有效期,所以这里客户在使用时最好提前校验一下token是否有效,如下接口为校验接口:
[token校验接口](/book/device-develop/OTA/南向API接口/2token校验.md)

step10. 拉取升级包

token检测成功,那下一步就从平台获取升级包,如下接口完成升级包下载,支持分片下载。

获取资源接口

step11. 上报升级状态

在升级的过程中,设备需要主动上报升级状态,使用如下接口
[上报升级状态接口](/book/device-develop/OTA/南向API接口/4上报升级状态.md)

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “