Skip to main content

Device Management

Feature Overview

The device management feature allows devices to report topology information to the cloud, push device properties, and lets the cloud set device properties. This enables users to view and adjust device status in the cloud, making it easier to carry out their work.

Interaction Sequence Diagram

Interface Implementation Details

  • Aircraft Device Properties
  • Dock Device Properties
  • Device Management (MQTT)
    • Device Topology Update
      When the gateway device detects the connection or disconnection of communication with a sub-device, it reports the sub-device's online/offline status to the cloud. For the values of type and sub_type in the protocol, please refer to the Device Types and Aircraft Model List section for the mapping.
    • Device Property Push
      Device properties are divided into fixed frequency data (osd) and state data (state). The osd properties are reported at a fixed frequency of 2 HZ, while the state properties are reported when a property changes. We provide different handling strategies for different device properties and report them using different topics. The device properties are described separately in the Aircraft Device Properties, Dock Device Properties, and Remote Controller Device Properties sections.
    • Device Property Set
      • The setting of device properties is not yet fully covered; we will implement it gradually in the future.
      • In the device properties sections, the read/write status of a property is indicated by "accessMode". A value of "rw" indicates that the property can be set.
      • Device property setting only supports setting a single property field. For example, the aircraft distance limit status (distance_limit_status) property includes two fields: whether distance limit is enabled (state) and distance limit (distance-limit). When setting the aircraft distance limit status property, the set command needs to be sent twice.