概念介绍
大约 3 分钟deviceota
OTA升级概述
OTA（Over-The-Air）升级是物联网设备实现远程固件更新的核心技术。BladeX物联网平台提供企业级OTA升级解决方案，通过标准化的升级流程和完善的安全机制，让设备固件更新变得简单、安全、可控。
核心价值：
- 远程更新：无需物理接触设备，通过网络即可完成固件更新，大幅降低运维成本
- 批量管理：一键批量升级多台设备，实时监控每台设备升级状态，提升运维效率
- 安全可靠：MD5完整性校验、数字签名验证、HTTPS加密传输，确保升级过程安全可控
- 统一管控：集中化版本管理，可视化升级进度监控，完整的操作日志追溯
一、升级模式
BladeX物联网平台支持两种主要的OTA升级模式，灵活满足不同业务场景的升级需求。
1. 推送模式（Push Mode）
平台主动向设备推送升级任务，适用于紧急修复、批量升级等场景。
2. 拉取模式（Pull Mode）
设备主动查询平台获取升级信息，适用于设备自主升级、定期检查等场景。
二、状态管理体系
OTA升级采用完整的状态机制，精确跟踪升级全生命周期，确保每个环节可控可追溯。
| 状态 | 状态码 | 描述 | 下一状态 |
|---|---|---|---|
| 待升级 | "pending" | 设备收到升级任务，等待开始 | 下载中/已取消 |
| 下载中 | "downloading" | 正在下载固件包 | 下载完成/失败/超时 |
| 下载完成 | "downloaded" | 固件包下载成功，准备安装 | 验证中/升级失败 |
| 验证中 | "verifying" | 正在验证固件包完整性 | 升级中/升级失败 |
| 升级中 | "upgrading" | 正在执行固件升级 | 升级成功/升级失败 |
| 升级成功 | "success" | 固件升级成功完成 | - |
| 升级失败 | "failed" | 升级过程出现错误 | - |
| 已取消 | "cancelled" | 用户或系统取消升级 | - |
| 超时 | "timeout" | 升级过程超时 | - |
三、参数体系说明
系统采用标准化的参数体系，确保升级过程的精确控制和状态追踪。
1. 设备标识参数
设备三元组是OTA升级过程中的唯一身份标识：
| 参数 | 说明 | 示例 |
|---|---|---|
| productKey | 产品标识 | PK_SENSOR_001 |
| deviceName | 设备名称 | DEV_20240101_001 |
| deviceSecret | 设备密钥 | xxxxxxxxxxxxxx |
2. 升级任务参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | Long | 是 | 升级任务唯一标识（数字） |
| version | String | 是 | 目标固件版本号 |
| url | String | 是 | 固件下载地址 |
| size | Long | 是 | 固件包大小（字节） |
| sign | String | 是 | 固件包签名值 |
| signMethod | String | 否 | 签名算法（默认Md5） |
| module | String | 否 | 升级模块名称（默认main） |
| extData | Object | 否 | 扩展数据 |
3. 进度监控参数
参数定义：
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| taskId | Long | 升级任务ID | 20240301001 |
| step | String | 进度值或错误码 | "45" |
| desc | String | 进度描述 | "45%" |
| extData | Object | 扩展数据（可选） | 错误详情等 |
进度值定义：
| 进度值 | 类型 | 说明 | 备注 |
|---|---|---|---|
| 1-50 | 正常 | 下载阶段 | 按实际下载进度映射 |
| 51-99 | 正常 | 安装阶段 | 按实际安装进度映射 |
| 100 | 完成 | 升级成功 | 立即上报新版本 |
错误码定义：
| 错误码 | 说明 | 处理建议 |
|---|---|---|
| -1 | 升级失败 | 检查设备日志 |
| -2 | 下载失败 | 检查网络连接 |
| -3 | 校验失败 | 重新下载固件 |
| -4 | 烧录失败 | 检查存储空间 |