Device Management

Overview

The Device Management functionality supports reporting device topology information to the cloud, pushing device attributes, and allowing the cloud to set device properties. This enables users to view and adjust device status from the cloud, making operations more efficient and convenient.

Interaction Sequence Diagram

Detailed Interface Implementation

• Drone Device Properties

• Commands are issued to the drone through the virtual docking station, where the virtual docking station's serial number is DOCK + aircraft serial number, for example, DOCK1748xxxxxxx

• Device Management (MQTT)

  • Device Topology Update
    When the gateway device detects a connection or disconnection with the sub-device, it reports the sub-device's online or offline status to the cloud. The type and sub_type values in the protocol can be referenced in the Product Support section for corresponding values.

  • Device Property Push
    Device properties are divided into fixed-frequency data (OSD) and status data (State). The OSD properties are reported at a fixed frequency of 0.5 Hz, while the State properties are reported when there is a change. Different device properties are handled with different strategies, using separate topics for reporting. The device properties are detailed in the following sections: Drone Device Properties, Base Station Device Properties, and Remote Controller Device Properties.

  • Device Property Setting
    

    • Currently, the ability to set device properties is not fully implemented; more coverage will be added in future updates.
    • In the Device Properties section, the "accessMode" field indicates the read/write status of a property. If marked as "rw," the property can be set.
    • Device property setting only supports setting individual property fields. For example, the Drone Distance Limit Status (distance_limit_status) property includes both Enable Distance Limit (state) and Distance Limit (distance-limit) fields. When setting the drone distance limit status, the command needs to be sent twice.