跳到主要内容

Firmware Upgrade

Overview​

To facilitate the maintenance of device firmware versions, the Cloud API supports firmware upgrades for docking stations and aircraft via the cloud. Users can perform single and batch upgrades, upgrade prompts, and display upgrade progress, among other functions.

To implement the firmware upgrade feature, users need to download the required firmware installation package in advance. Users must maintain the firmware installation package, firmware version, and other information on the cloud server. The firmware attribute information reported by the device is compared with the firmware package information on the cloud to determine if a firmware upgrade is needed. When issuing a firmware upgrade command in the cloud, it is necessary to supplement the protocol with the serial number of the upgrade device, the firmware version number, the storage address of the firmware upgrade file, and the type of firmware upgrade. Devices can obtain the progress and current step of the firmware upgrade through the percent and step_key parameters in the firmware upgrade progress command. For specifics, please refer to the Detailed Interface Implementation in the Cloud API.

Note:

  • By uploading through the firmware upgrade model property, comparing firmware_version with the latest firmware version number can be used to determine if a regular upgrade is needed.

Interactive Timing Diagram​

Detailed API Realization​

  • Docking Station Model Properties

  • Firmware Upgrade

    • Firmware Attribute Reporting
      The firmware upgrade function will report the device firmware version number - firmware_version property field. Comparing firmware_version with the latest firmware version number can be used to determine if a regular upgrade is needed.

    • Firmware Upgrade Task Issuance
      The cloud-issued firmware upgrade API needs to fill in the device's serial number, information related to the firmware upgrade package, and the type of firmware upgrade.

    • Firmware Upgrade Progress
      The device reports the firmware upgrade progress to the cloud, and through field acquisition, key information such as upgrade progress, upgrade percentage, and current upgrade step can be presented on the cloud visualization interface. The ota_progress field in the Firmware Upgrade Progress API is used to determine if an upgrade is in progress.