跳到主要内容

Firmware Upgrade

Overview​

To maintain the firmware versions of devices, the cloud API supports users in upgrading firmware for docking stations and drones via the cloud. Users can perform single or batch upgrades, receive upgrade prompts, and view upgrade progress.

To implement the firmware upgrade functionality, users must first download the required firmware packages. Firmware packages, versions, and other relevant information must be maintained on the cloud server by the user. The firmware properties reported by the device are compared to the firmware package information on the cloud to determine whether a firmware upgrade is necessary. When issuing a "Firmware Upgrade" command from the cloud, the serial number of the device, firmware version, firmware package storage location, and the type of firmware upgrade must be provided in the protocol. The device can track the progress and current step of the firmware upgrade using the percent and step_key parameters within the "Firmware Upgrade Progress" command. Refer to the "Interface Implementation Details" section for more information in the cloud API documentation.

  • Note:
    • By comparing the firmware_version uploaded in the firmware upgrade device model with the latest firmware version, you can determine if a regular upgrade is required.

Interaction Sequence Diagram​

Detailed Interface Implementation​

  • Docking Station Model Properties

  • Firmware Upgrade

    • Firmware Properties Reporting
      The firmware upgrade functionality reports the firmware_version property field, which contains the device's firmware version. By comparing firmware_version with the latest firmware version available on the cloud, the system can determine if a regular upgrade is needed.

    • Issuing Firmware Upgrade Task
      The cloud-based firmware upgrade API requires filling in details such as the device's serial number, relevant firmware upgrade package information, and the type of firmware upgrade. This information is essential for initiating the firmware upgrade process.

    • Reporting Firmware Upgrade Progress
      The device reports its firmware upgrade progress to the cloud. The data gathered from these reports allows the cloud to display key information on the visual interface, such as upgrade progress, percentage completed, and the current upgrade step. The ota_progress field in the "Firmware Upgrade Progress" API is used to determine if the device is actively undergoing an upgrade.