设备固件管理

设备固件管理

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

固件管理

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

新增

操作步骤

进入系统: 设备管理-固件升级-新建。
输入固件版本信息。
点击确定进行保存。

编辑

操作步骤

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

删除

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

操作流程

创建固件信息

进入系统: 设备管理-固件升级-新建。
输入固件版本信息。
点击确定进行保存。

发布升级任务

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

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

3.创建任务信息

发布任务

注意：

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

推送固件消息

在发布任务界面，等待升级框中选择推送升级。
任务将自动跳转到升级中。

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

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

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

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

平台修改进度信息

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

推送更新

固件相关消息

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

上报固件信息

消息类型: ReportFirmwareMessage

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

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

设备拉取固件更新

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

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

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

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

平台推送固件更新

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

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

设备上报固件更新结果

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

更新结果(进度)消息:

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

设备固件更新