Thingsboard3.4-OTA升级
- thingsboard
- 时间：2023-05-04 18:26
- 3761人已阅读
简介
背景在做设备端对接thingsboard平台得时候，去研究设备端对接平台的过程中，花了不少时间，在此之前也没有找到相关的文档，于是出于减少大家去研究的时间，写了这篇博客，希望大家能够点赞和收藏。注意：OTA功能是从3.3版本才开始支持的。参考英文文档地址：https://thingsboard.io/docs/user-guide/ota-updates/1.设备事先订阅这些topic主题v1/d
🔔🔔🔔好消息!好消息!🔔🔔🔔
有需要的朋友👉:联系凯哥
背景
1. 设备事先订阅这些topic主题
v1/devices/me/attributes v1/devices/me/attributes/response/+ v1/devices/me/rpc/request/+ v1/devices/me/rpc/response/+ v2/fw/response/+/chunk/+
2. 更新过程的状态变化，需要上传遥测数据到平台
DOWNLOADING 收到关于新固件/软件更新的通知，设备开始下载更新包 DOWNLOADED 设备已完成更新包的下载 VERIFIED 设备已验证下载包的校验和。 UPDATING 设备已启动固件/软件更新。通常在设备重新启动或服务重新启动之前发送 UPDATED 固件已成功更新到下一版本 FAILED -未验证校验和，或设备更新失败。
topic：
v1/devices/me/telemetry
发送消息格式：
//收到软件升级通知发送该格式
{
"current_fw_title": "Initial", //设备当前标题
"current_fw_version": "v0",//设备当前版本号
"fw_state": "DOWNLOADING" //固件升级状态，一共刘总，参考上述说明
}{
"current_fw_title": "Initial", //设备当前标题
"current_fw_version": "v0",//设备当前版本号
}3. 设备主动检查更新
v1/devices/me/attributes/request/${requestId}
${requestId} - 请求id,从1开始递增{
"sharedKeys": "fw_version,fw_checksum_algorithm,fw_checksum,fw_size,fw_title,fw_version"
}v1/devices/me/attributes/response/1
返回消息示例：
{"shared":{"fw_checksum":"17ae291d08837890026d562e5b666f88d6389fe71d1183d6ed7eeee7505cc209","fw_size":421320,"fw_title":"f","fw_checksum_algorithm":"SHA256","fw_version":"1.2"}}fw_checksum 校验和 fw_size 文件大小，以字节为单位 fw_title 标题 fw_checksum_algorithm 校验和算法，默认SHA256 fw_version 版本
4. 平台批量更新设备 会下发升级消息给所有使用该设备配置的所有设备，个别设备单独设置了版本不会进行升级。
平台会主动推送当前最新版本信息给设备，设备可与当前版本判断，如不同，进行更新。
注意：设备需要首先把设备的当前版本信息推送给平台，平台才会修改版本信息下发通知版本升级信息给设备端，设备收到版本信息后必须对其进行处理，最后上传版本成功或失败消息给平台，平台才会下发下一次的版本升级消息给设备，相当于一个设备升级完成后才能进入下一次的升级。
接收消息topic:
v1/devices/me/attributes
{
"fw_title": "f",
"fw_version": "1.0",
"fw_tag": "f 1.0",
"fw_size": 128537,
"fw_checksum_algorithm": "SHA256",
"fw_checksum": "67f3b40ba0cbb7d289a9cf6f3f75e6c319f12bdc82d5c35ecc2f51515a13e5cc"
}
属性key 描述
fw_checksum 校验和
fw_size 文件大小，以字节为单位
fw_title 标题
fw_checksum_algorithm 校验和算法，默认SHA256
fw_version 版本5. 设备请求获取安装包文件 只能获取平台设置的目标版本的安装包文件，请求和获取方式如下： 设备端发送消息topic:
v2/fw/request/${requestId}/chunk/${chunkNum}1230
${requestId}- 请求id从1开始
${chunkNum}- 请求块号，必须从0开始，每次递增1。发送内容为每次接收的字节数，该值不能超过65535，块号递增次数=文件总字节数/每次接收字节数 然后再向上取整，保证安装包文件的能够取完整。
安装包文件数据返回topic：
v2/fw/response/${requestId}/chunk/${chunkNum}安装包文件返回内容：
为文件的字节数据，每次返回1230个字节数据，最后一次一般小于1230个字节数据，可以当作文件接收的结束标志。接收完整个文件后，采用sha256进行文件的校验，如果校验和和第4步中的校验和相等，视为数据完整。