阿里云OTA升级指南

阿里云OTA升级指南

OTA简介

OTA是Over-The-Air的缩写，中文意为“通过空中传输”。在计算机和通信技术领域中，OTA指的是通过无线网络等方式将软件、固件、配置文件等更新、下载、安装到设备上的一种技术手段。它可以实现远程升级和管理设备的软件和配置，无需物理连接设备，提高了设备管理的效率和灵活性。

OTA技术的应用非常广泛，在智能手机、智能电视、智能家居、智能汽车等领域都有广泛应用。通过OTA技术，厂商可以远程修复设备的软件漏洞或错误，升级设备的功能和性能，提供新的服务和功能，以及进行设备配置和管理等操作。同时，用户也可以通过OTA技术方便地更新设备的软件版本，享受到更好的用户体验。

总之，OTA技术通过无线传输方式实现设备软件和配置的远程升级和管理，为设备厂商和用户提供了方便和灵活性，有助于提升设备的功能和性能。

前提概要

本次操作流程目的是想借助MQTT协议使用ESP32给设备进行OTA升级，操作使用上位机软件进行测试，之后再移植到ESP32程序中去

使用软件

MQTTX

阿里云OTA升级

OTA升级-设备基础信息操作

这里需要注意的是每个需要升级的设备必要反馈给平台该设备当前的软件版本号，否则在后期升级的时候会导致选中设备

设备端通过MQTT协议推送当前设备OTA模块版本号到Topic： /ota/device/inform/{YourProductKey}/{YourDeviceName}。消息格式如下：

{
    "id": "123",
    "params": {
        "version": "1.0.1",
        "module": "MCU"
    }
}

参数	类型	说明
id	String	消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
version	String	OTA模块版本。
module	String	OTA模块名。说明上报默认（default）模块的版本号时，可以不上报module参数。设备的默认（default）模块的版本号代表整个设备的固件版本号。

当设备给平台发送相应信息后我们找到设备的详情就可以看到我们设备版本号就有信息了

这样设备的基础信息功能我们就弄好了，接下来我们就需要操作OTA的部分了

OTA升级-升级包操作

在添加升级包之前，我们还需要订阅升级的Topic
设备端订阅Topic：/ota/device/upgrade/{YourProductKey}/{YourDeviceName}。物联网平台对设备发起OTA升级请求后，设备端会通过该Topic收到升级包的存储地址URL。

{
    "id": "123",
    "code": 200,
    "data":{
        "size":432945,
        "digestsign":"A4WOP***SYHJ6DDDJD9***",
        "version":"2.0.0",
        "isDiff":1,
        "signMethod":"MD5",
        "dProtocol":"mqtt",
        "streamId":1397345,
        "streamFileId":1,
        "md5":"93230c3bde***",
        "sign":"93230c3bde42***",
        "module":"MCU",
        "extData":{
            "key1":"value1",
            "key2":"value2"
        }
    }
}

这里需要注意的是注意在选择升级包模块的时候，默认的情况只有default，所以我们就需要添加对应的模块名称

订阅信息获取升级包信息
/sys/{productKey}/{deviceName}/thing/ota/firmware/get_reply

订阅MQTT分片下载请求
请求Topic：/sys/{productKey}/{deviceName}/thing/file/download
响应Topic：/sys/{productKey}/{deviceName}/thing/file/download_reply

{
    "id": "123456",
    "version": "1.0",
    "params": {
        "fileToken":"1bb8***",
        "fileInfo":{
            "streamId":1234565,
            "fileId":1
        },
        "fileBlock":{
            "size":256,
            "offset":2
        }
    }
}

这里的一些数据信息根据之前云平台下发的包信息进行更改

参数	类型	说明
id	String	消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
version	String	协议版本，固定为1.0。
params	Object	请求参数。
fileToken	String	文件的唯一标识Token，非必填参数。支持数字、英文字母、下划线（_）和英文句号（.），不超过16个字符。使用说明：若传入该参数，物联网平台响应设备请求时，会返回该参数，便于您在设备端多文件下载场景下，从响应消息中确认下载的对应文件。若确认设备端在下载文件的请求和响应周期内，不需要对其他文件发起下载请求，可不设置该参数。
fileInfo	Object	OTA升级包文件信息。
streamId	Long	通过MQTT协议下载OTA升级包时的唯一标识。
fileId	Integer	单个升级包文件的唯一标识。
fileBlock	Object	文件分片信息。
size	Integer	请求下载的文件分片大小，单位字节，取值范围为256131072。若为最后一个文件分片，取值范围为1131072。
offset	Integer	文件分片对应字节的起始地址。取值范围为0~16777216。

这样升级包里面的所有数据流都可以一次性下载下来啦

OTA升级-上报升级进度

建议设置设备端上报进度频率为3秒内最多一次。若设备上报进度频繁，在物联网平台控制台的OTA升级包详情的批次详情中，可能无法查看到上报的全部进度。

• 设备发布消息到Topic：/ota/device/progress/$YourProductKey/${YourDeviceName}

{
    "id": "123",
    "params": {
        "step": "-1",
        "desc": "OTA升级失败，请求不到升级包信息。",
        "module": "MCU"
    }
}

如果要显示升级成功，就需要上报当前固件的软件版本

按照上述操作完成了OTA升级的完整流程