设备固件管理

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

flow

固件管理

用于设备固件新建、编辑、查看、删除、发布升级任务、推送固件消息。

新增

操作步骤

  1. 进入系统: 设备管理-固件升级-新建

  2. 输入固件版本信息。

  3. 点击确定进行保存。
    固件新增

编辑

操作步骤

  1. 进入系统: 设备管理-固件升级,在操作列点击编辑
  2. 编辑固件版本信息。
  3. 点击确定进行保存。
    固件编辑

删除

操作步骤 进入系统: 设备管理-固件升级,在操作列点击删除

固件编辑

操作流程

创建固件信息

  1. 进入系统: 设备管理-固件升级-新建

  2. 输入固件版本信息。

  3. 点击确定进行保存。
    固件新增

发布升级任务

1.在固件升级列表页选择需要升级的固件,单击操作列中查看
查看详情

2.在固件详情页面单击升级任务-新建
新建任务

3.创建任务信息
创建任务

  1. 发布任务 发布任务

注意:

发布任务时可以选择所有设备或者指定部分设备。

推送固件消息

  1. 在发布任务界面,等待升级框中选择推送升级
    发布任务
  2. 任务将自动跳转到升级中
    升级中

可在此框中点击查看各升级任务详情
升级历史

  1. 升级完成或升级失败。
    升级完成后任务会跳转到升级完成框,升级失败的任务则跳转到升级失败中。

自定义协议解析发送到设备

推送的升级任务通过协议解析后发送到设备,参考自定义协议开发

平台修改进度信息

设备收到升级任务指令后发起并推送更新进度。
任务升级完成或升级失败后,在任务升级界面任务会跳转到升级完成框,升级失败的任务则跳转到升级失败中。

任务完成

推送更新

固件相关消息

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

上报固件信息

消息类型: ReportFirmwareMessage

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

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

设备拉取固件更新

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

  1. {
  2. "headers":{
  3. "force":false, //是否强制拉取更新. 为true时强制拉取固件更新信息
  4. "latest":false //是否拉取最新的固件,false为从头开始拉取
  5. },
  6. "deviceId":"设备ID",
  7. "timestampe":"毫秒时间戳",
  8. "messageId":"消息ID",
  9. "requestVersion":"请求更新的版本"//可留空
  10. }

平台收到此消息后, 会获取更新任务中对应的固件更新记录.找出对应设备等待升级的固件信息. 并发送消息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. }