Live Flight Controls/Remote Control

2025-03-05
No Rating

Overview

Pilot access to the cloud adds the remote control functionality, the cloud can forward data through Pilot and remotely control the aircraft.

The cloud needs to be authorized by the remote controller before it can be controlled. When the cloud initiates a remote control request, a pop-up window will pop up on the remote controller. The cloud can only operate after the user agrees to the cloud control.

For Mavic 3 Enterprise Series and DJI Matrice 4 Series, flight and payload control rights are not distinguished.

For Mavic 3 Enterprise Series, only cloud control of payloads is supported, which can control gimbal rotation, zoom, infrared operation and other functions. During cloud remote control, the remote controller can continue to fly through the joystick.

For DJI Matrice 4 Series, cloud control of flight and payload is supported. In addition to payload commands, flight control, pointing flight, and orbiting flight are also supported. During cloud remote control, the dial, joystick, return home, emergency stop and other buttons on the remote controller will be invalid.

The command flight API can be divided into: flight control class (DRC), payload control class, flyto command and one-key takeoff command.

  • Flight control commands (DRC commands)

    Drone Remote Control (DRC) uses MQTT protocol and add two new topics to represents upward link and downward link. MQTT Topic Definitionopen in new window provides introduction and example of drc Topic structure. After the server and device successfully build MQTT link, an EMQX Broker will be distributed to the DRC communication link from server to device for faster transmission and response. To use DRC commands, the live flight controls control mode should be entered in advanced. DRC commands usually do not limited by flight control authority, but the DRC-Stick Control Method: sitck_control must need the flight control authority.

Figure. DRC link

  • flyto command and one-key takeoff command: Both flyto command and one-key takeoff command are used to make the aircraft fly to the target point and hover. The difference is that the former is used for the scene where the aircraft is in the air, and the latter is used for the scene where the aircraft is in the airport. After flying to the target point through the one-key takeoff command, the aircraft can continue to execute the flyto command. Currently only supports a single target point.

Interaction Sequence Diagram

Note: To avoid the drone damage, executing the control authority seizure is recommended before issue the live flight controls APIs.

Web PageCloud ServerMQTT BrokerDJI Pilot 2Pilot user clicks the authority grabbing buttonweb user releases the cloud controlRequest remote controller to authorize the cloud controlRequest remote controller to authorize the cloud control Topic: thing/product/{gateway_sn}/services Method: cloud_control_auth_requestRemote controller agrees to tht cloud controlReply to agree to the authorization Topic: thing/product/{gateway_sn}/services_reply Method: cloud_control_auth_requestReport authorization state Topic: thing/product/{gateway_sn}/state is_cloud_control_auth = trueRequest to establish remote control linkIssue MQTT connection information Topic: thing/product/{gateway_sn}/services Method: drc_mode_enterBuild MQTT connectionIssue MQTT connection informationBuild MQTT connectionSend control command Topic: thing/product/{gateway_sn}/drc/downSend control command Topic: thing/product/{gateway_sn}/drc/downUpload information Topic: thing/product/{gateway_sn}/drc/upUpload informationCancel the authorizationReport the authorization state Topic: thing/product/{gateway_sn}/state is_cloud_control_auth = falseRelease the cloud controlRelease the authorization Topic: thing/product/{gateway_sn}/services cloud_control_releaseWeb PageCloud ServerMQTT BrokerDJI Pilot 2

Detailed API Realization

Note: Only when the "Media File Upload" is opened on Pilot, the media files generated by the payload control commands will be pushed by the media management function. For how to open the "Media File Upload" on Pilot, please refer to the Media File Library chapter of DJI FlightHub 2 User Manualopen in new window.

Live Flight Controlsopen in new window

  • Flight control commands (DRC commands)
  • Payload control commands

Remote Controlopen in new window

If you have any comments or confusion about our documentation, you can click here to give feedback and we will get back to you as soon as possible.