设备固件管理

jetlinks专业版在>=1.2中提供了固件管理功能,提供对设备固件升级,以及获取固件信息等操作.

flow

操作流程

创建固件信息 -> 发布升级任务 -> 推送固件消息 -> 自定义协议解析发送到设备 -> 设备更新 -> 设备推送更新进度 -> 平台修改进度信息.

TODO

固件管理

TODO

升级任务

TODO

推送更新

固件相关消息

消息协议解析设备上报的消息为指定的类型即触发对应的操作.

上报固件信息

消息类型: ReportFirmwareMessage

  1. {
  2.     "deviceId":"设备ID",
  3.     "version":"固件版本号",
  4.     "properties":{"key":"value"}, //其他拓展信息
  5.     "timestampe":"毫秒时间戳",
  6. }

上报固件信息后,会更新设备固件信息记录.

设备拉取固件更新

前提: 消息协议解析设备上报的消息为:RequestFirmwareMessage.

  1. {
  2.     "deviceId":"设备ID",
  3.     "timestampe":"毫秒时间戳",
  4.     "messageId":"消息ID",
  5.     "requestVersion":"请求更新的版本"//可留空
  6. }

平台收到此消息后, 会获取更新任务中对应的固件更新记录.找出对应设备等待升级的固件信息. 并发送消息RequestFirmwareMessageReply给协议包解析并发送到设备.

  1. {
  2.     "sign": "文件签名",
  3.     "signMethod": "文件签名方式",
  4.     "messageId": "消息ID",//与拉取固件中到消息ID一致
  5.     "deviceId": "设备ID",
  6.     "version": "版本号",
  7.     "url": "固件文件下载地址",
  8.     "parameters": {},//其他拓展参数
  9.     "timestamp": 1589277368209 //毫秒时间戳
  10. }

平台推送固件更新

平台可推送固件更新给设备,需要消息协议处理消息:UpgradeFirmwareMessage.

  1. {
  2.     "sign": "文件签名",
  3.     "signMethod": "文件签名方式",
  4.     "deviceId": "设备ID",
  5.     "version": "版本号",
  6.     "url": "固件文件下载地址",
  7.     "success": true,
  8.     "parameters": {},//其他拓展参数
  9.     "timestamp": 1589277368209 //毫秒时间戳
  10. }

设备上报固件更新结果

设备可以上报固件更新进度以及更新结果. 消息类型:UpgradeFirmwareProgressMessage

更新结果(进度)消息:

  1. {
  2.     "success": true, //是否成功
  3.     "message":"失败时传的消息",
  4.     "progress": 10, //更新进度: 0-100
  5.     "complete": false,//是否完成,如果只是上报进度,则设置为false,完成更新则设置为true
  6.     "deviceId": "设备ID",
  7.     "version": "1.0", //更新的版本号(必填)
  8.     "timestamp": 1589277369268
  9. }