Firmware Deployment Service
构想
该服务为安装固件到设备提供接口。
扩展性
Firmware Deployment Service确保将遵循API规范中定义的合同条款,将返回指定的字段。但可能引入其他字段作为API向后兼容的扩展。
请确保您的客户可以很好地处理这些扩展。.
信息
Firmware Deployment Service目前仅在Europe 1适用。
访问
要访问此服务,您需要具有Firmware Deployment Service角色和范围中列出的相应角色。
下载URIs
安装任务中指定的下载URIs必须包含内置的凭证或引用公共的资源。设备直接访问这些URIs而无需使用MindSphere凭证。
基础知识
Firmware Deployment Service追踪固件安装任务的状态。在设备上安装固件的一般工作流程为:
- 用户通过用户接口选择一个已发布的固件版本。
- 用户会看到相关的条款和条件声明文档。
- 用户需接受给出的条款和条件。可以使用Firmware Deployment Service来保存和查询此信息。
- 接受条款和条件声明后,用户可通过用户接口启动固件的安装。
- Firmware Deployment Service会自动验证用户的设备类型是否正确,并将任务发送给设备。
- 设备接收到任务。
- 设备执行固件更新,并发送状态消息到Firmware Deployment Service。同时,可通过用户接口更新或取消任务。
- 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开发许可协议.