Skip to content

Firmware Deployment Service

构想

该服务为安装固件到设备提供接口。

扩展性

Firmware Deployment Service确保将遵循API规范中定义的合同条款,将返回指定的字段。但可能引入其他字段作为API向后兼容的扩展。

请确保您的客户可以很好地处理这些扩展。.

信息

Firmware Deployment Service目前仅在Europe 1适用。

访问

要访问此服务,您需要具有Firmware Deployment Service角色和范围中列出的相应角色。

下载URIs

安装任务中指定的下载URIs必须包含内置的凭证或引用公共的资源。设备直接访问这些URIs而无需使用MindSphere凭证。

基础知识

Firmware Deployment Service追踪固件安装任务的状态。在设备上安装固件的一般工作流程为:

  1. 用户通过用户接口选择一个已发布的固件版本。
  2. 用户会看到相关的条款和条件声明文档。
  3. 用户需接受给出的条款和条件。可以使用Firmware Deployment Service来保存和查询此信息。
  4. 接受条款和条件声明后,用户可通过用户接口启动固件的安装。
  5. Firmware Deployment Service会自动验证用户的设备类型是否正确,并将任务发送给设备。
  6. 设备接收到任务。
  7. 设备执行固件更新,并发送状态消息到Firmware Deployment Service。同时,可通过用户接口更新或取消任务。
  8. Firmware Deployment Service接收任务执行结果并记录设备上当前固件的版本信息。

状态机

Firmware Deployment Service使用状态机来追踪安装进度。欲了解详情,请参考基础.

定期轮询

设备需要使用以下端点对服务的任务执行进行定期轮询:

GET /api/firmwaredeployment/v3/devices/{deviceId}/installation/jobs

功能

Firmware Deployment Service为执行以下任务开放API:

  • 在设备上安装固件版本
  • 管理固件安装任务
  • 记录用户对条款和条件的接受情况

限制

  • 设备访问提供的下载URI。因此,URI中必须包含MindSphere凭证,或者资源必须是可公开访问的。
  • 超过90天的固件安装任务将自动清除。

受控内容

禁止上传、下载和发布受控内容到MindSphere。用户应对使用Edge Services发布的文件内容负责。

示例场景

某传感器生产商将其数据上传到MindSphere,并希望定期向客户提供固件的新版本。他们开发了一个应用,使用Firmware Deployment Service上传固件到设备。服务会自动验证固件是否与用户的设备兼容。安装前,应用会要求用户接受某个版本的条款和条件声明,并使用Firmware Deployment Service记录用户的接受情况。因此,当对同一类型的设备进行多次更新时,不会再要求用户接受条款和条件声明。

相关链接

还有问题?

向社区提问


除非另行声明,该网站内容遵循MindSphere开发许可协议.


Last update: July 11, 2019