Skip to content

Firmware Deployment Service – Basics

State Machine

The Firmware Deployment Service uses the Deployment Workflow Service to instantiate the software installation workflow. This sets up a state machine to track the installation progress and requires the device to send status messages while executing the firmware installation task. The history of the task status is recorded by the Firmware Deployment Service.

State Machine

Required Device Messages

For proper progress tracking, it is necessary, that the device sends status messages to the backend. It should send messages in the following cases:

  • It has started a task. This triggers the state machine to transition to DOWNLOADING, INSTALLING, or ACTIVATING. It may send status updates about the progress of the specific task.
  • It has finished a task. This triggers the state machine to transition to DOWNLOADED, INSTALLED, or ACTIVATED.
  • A task has failed. This triggers the state machine to transition to FAILED.
  • A task has been canceled, e.g. due to a timeout. This triggers the state machine to transition to CANCELED. Do not trigger this transition, if an error occurred, as the backend might unnecessarily retry the operation in this case.

Last update: April 25, 2019

Except where otherwise noted, content on this site is licensed under the Development License Agreement.