功能介绍

OTA(Over-the-Air Technology)即空中下载技术,是设备平台的一项基础功能。您可使用云鲸设备平台的OTA升级功能,对分布在全球各地的IoT设备进行OTA升级。本文介绍一些OTA基本概念。

适用场景

📢 注意:面向 C端用户 进行灰度与全量升级,存在严格的版本号规则限制,不支持”降级“。

OTA升级流程

  1. 设备端开发OTA升级功能:接入设备OTA升级功能,以确保设备具备远程OTA升级能力。

  2. 添加大版本:为产品添加OTA升级的大版本并设置生效范围。

  3. 添加固件包:为大版本添加固件包。

  4. 灰度发布(必选):用于验证升级功能或针对部分设备进行升级。

  5. 正式发布:设备平台向设备批量下发升级相关信息。

  6. 设备端OTA升级:设备端获取设备平台发起的OTA升级相关信息,使用升级包URL下载升级包,完成OTA升级。

  7. 查看发布详情:创建灰度/正式发布任务后,您可以在控制台内查看固件包的升级结果统计、升级任务的任务状态、升级设备的升级状态及状态详情等。

  8. 版本分布与版本统计:查看产品下相关所有设备的固件版本分布情况。

已支持功能

固件升级目前支持以下功能:

功能名称 说明
整包升级 在任意版本系统上的完成OTA
增量包升级 在指定版本系统上的增量OTA。
灰度发布 针对大版本升级范围内的部分设备推送升级包
正式发布 针对大版本升级范围内的所有设备推送升级包
自动升级/静默升级 设备端升级方式的一种。是指设备主动向平台发起请求,获取可升级的固件包相关配置参数,需要用户在App端打开 自动升级开关
强制升级 设备端升级方式的一种。是指设备主动向平台发起请求,设备端获取到 强制升级 配置后,将 忽略自动升级开关立即升级
强制升级+忽略约束条件 设备端升级方式的一种。是指设备主动向平台发起请求,获取已发布的固件包相关配置参数,设备端获取到强制升级+忽略约束条件配置后,将忽略自动升级开关忽略判断是否满足自身升级条件立即升级
App升级 设备端升级方式的一种。是指用户在App端主动触发的升级,将忽略自动升级开关立即升级

相关API

接口名称 接口地址 描述
设备固件升级检测v1 /open-platform-manage-ota/api/v1/ota/check 1. 用于 [设备] 进行 “OTA固件版本检测”,获取可升级的固件包下载链接,并更新设备当前固件版本;
2. 不支持根据语言代码返回多语言升级文案
设备固件升级检测v2 /open-platform-manage-ota/v1/iot-platform/ota/check 1. 用于 [设备] 进行 “OTA固件版本检测”,获取可升级的固件包下载链接,并更新设备当前固件版本;
2. 支持根据语言代码返回多语言升级文案
设备上报固件升级状态 /robots/ota/upgrade/status 用于 [设备] 上报升级状态
APP固件升级检测接口 /app-ota-server/v2/firmware/upgrade/check 1. 用于 [APP端] 进行设备固件版本检测;
2. 支持根据语言代码返回多语言升级文案
APP更新自动升级状态 /app-ota-server/v1/auto/upgrade/state 用于 [APP端] 开启/关闭设备自动升级策略
APP获取当前固件版本描述 /app-ota-server/v1/firmware/current/version/describe 1. 用于 [APP端] 获取当前固件版本的升级文案;
2. 支持根据语言代码返回多语言升级文案
 创建时间:2023-03-31 15:43
最后编辑:陈勇琦  更新时间:2024-10-18 16:29