40.remote-control
Event
Aircraft state information reporting
"seq" is an incrementing sequence number, ensuring commands are executed in order, at the same level as "data".
Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_drone_state_push
Data:
stealth_state
Stealth mode state
bool
{"0":"Disable","1":"Enable"}
night_lights_state
Night flight lights state
bool
{"0":"Disable","1":"Enable"}
mode_code
Aircraft state
enum_int
{"0":"Standby","1":"Takeoff preparation","2":"Takeoff preparation completed","3":"Manual flight","4":"Automatic takeoff","5":"Wayline flight","6":"Panorama","7":"Intelligent tracking","8":"ADS-B avoidance","9":"Automatic returning to home","10":"Automatic landing","11":"Forced landing","12":"Three-blade landing","13":"Upgrading","14":"Not connected","15":"APAS","16":"Virtual stick state","17":"Live flight Controls"}
Example:
{
"data": {
"mode_code": 0,
"night_lights_state": 0,
"stealth_state": 0
},
"method": "drc_drone_state_push",
"seq": 1
}Camera osd Push
Used for pushing camera related information. The "seq" is an incrementing sequence number, ensuring commands are executed in order, at the same level as "data".
Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_camera_osd_info_push
Data:
payload_index
Camera enumeration
text
Camera enumeration values. Non-standard device_mode_key, formatted as {type-subtype-gimbalindex}. Please refer to Product Supported
wide_lense
Wide-angle lens info
struct
» wide_exposure_mode
Wide-angle lens exposure mode
enum_int
{"1":"Auto","2":"Shutter Priority","3":"Aperture Priority","4":"Manual"}
Current configuration of the wide-angle lens exposure mode
» wide_iso
Wide-angle lens ISO
enum_int
{"0":"Auto","1":"Auto (High Sense)","2":"50","3":"100","4":"200","5":"400","6":"800","7":"1600","8":"3200","9":"6400","10":"12800","11":"25600","255":"FIXED"}
Current configuration of the wide-angle lens ISO
» wide_shutter_speed
Wide-angle lens shutter speed
enum_int
{"0":"1/8000 s","1":"1/6400 s","2":"1/6000 s","3":"1/5000 s","4":"1/4000 s","5":"1/3200 s","6":"1/3000 s","7":"1/2500 s","8":"1/2000 s","9":"1/1600 s","10":"1/1500 s","11":"1/1250 s","12":"1/1000 s","13":"1/800 s","14":"1/725 s","15":"1/640 s","16":"1/500 s","17":"1/400 s","18":"1/350 s","19":"1/320 s","20":"1/250 s","21":"1/240 s","22":"1/200 s","23":"1/180 s","24":"1/160 s","25":"1/125 s","26":"1/120 s","27":"1/100 s","28":"1/90 s","29":"1/80 s","30":"1/60 s","31":"1/50 s","32":"1/40 s","33":"1/30 s","34":"1/25 s","35":"1/20 s","36":"1/15 s","37":"1/12.5 s","38":"1/10 s","39":"1/8 s","40":"1/6.25 s","41":"1/5 s","42":"1/4 s","43":"1/3 s","44":"1/2.5 s","45":"1/2 s","46":"1/1.67 s","47":"1/1.25 s","48":"1.0 s","49":"1.3 s","50":"1.6 s","51":"2.0 s","52":"2.5 s","53":"3.0 s","54":"3.2 s","55":"4.0 s","56":"5.0 s","57":"6.0 s","58":"7.0 s","59":"8.0 s","65534":"Auto"}
Current configuration of the wide-angle lens shutter speed
» wide_exposure_value
Wide-angle lens exposure value
enum_int
{"1":"-5.0EV","2":"-4.7EV","3":"-4.3EV","4":"-4.0EV","5":"-3.7EV","6":"-3.3EV","7":"-3.0EV","8":"-2.7EV","9":"-2.3EV","10":"-2.0EV","11":"-1.7EV","12":"-1.3EV","13":"-1.0EV","14":"-0.7EV","15":"-0.3EV","16":"0EV","17":"0.3EV","18":"0.7EV","19":"1.0EV","20":"1.3EV","21":"1.7EV","22":"2.0EV","23":"2.3EV","24":"2.7EV","25":"3.0EV","26":"3.3EV","27":"3.7EV","28":"4.0EV","29":"4.3EV","30":"4.7EV","31":"5.0EV","255":"FIXED"}
Current configuration of the wide-angle lens exposure value
» wide_aperture_value
Aperture value
enum_int
{"280":"F2.8","320":"F3.2","350":"F3.5","400":"F4","450":"F4.5","500":"F5","560":"F5.6","630":"F6.3","710":"F7.1","800":"F8","900":"F9","1000":"F10","1100":"F11"}
zoom_lense
Zoom lens info
struct
» zoom_exposure_mode
Zoom lens exposure mode
enum_int
{"1":"Auto","2":"Shutter Priority","3":"Aperture Priority","4":"Manual"}
Current configuration of the zoom lens exposure mode
» zoom_iso
Zoom lens ISO
enum_int
{"0":"Auto","1":"Auto (High Sense)","2":"50","3":"100","4":"200","5":"400","6":"800","7":"1600","8":"3200","9":"6400","10":"12800","11":"25600","255":"FIXED"}
Current configuration of the zoom lens ISO
» zoom_shutter_speed
Zoom lens shutter speed
enum_int
{"0":"1/8000 s","1":"1/6400 s","2":"1/6000 s","3":"1/5000 s","4":"1/4000 s","5":"1/3200 s","6":"1/3000 s","7":"1/2500 s","8":"1/2000 s","9":"1/1600 s","10":"1/1500 s","11":"1/1250 s","12":"1/1000 s","13":"1/800 s","14":"1/725 s","15":"1/640 s","16":"1/500 s","17":"1/400 s","18":"1/350 s","19":"1/320 s","20":"1/250 s","21":"1/240 s","22":"1/200 s","23":"1/180 s","24":"1/160 s","25":"1/125 s","26":"1/120 s","27":"1/100 s","28":"1/90 s","29":"1/80 s","30":"1/60 s","31":"1/50 s","32":"1/40 s","33":"1/30 s","34":"1/25 s","35":"1/20 s","36":"1/15 s","37":"1/12.5 s","38":"1/10 s","39":"1/8 s","40":"1/6.25 s","41":"1/5 s","42":"1/4 s","43":"1/3 s","44":"1/2.5 s","45":"1/2 s","46":"1/1.67 s","47":"1/1.25 s","48":"1.0 s","49":"1.3 s","50":"1.6 s","51":"2.0 s","52":"2.5 s","53":"3.0 s","54":"3.2 s","55":"4.0 s","56":"5.0 s","57":"6.0 s","58":"7.0 s","59":"8.0 s","65534":"Auto"}
Current configuration of the zoom lens shutter speed
» zoom_exposure_value
Zoom lens exposure value
enum_int
{"1":"-5.0EV","2":"-4.7EV","3":"-4.3EV","4":"-4.0EV","5":"-3.7EV","6":"-3.3EV","7":"-3.0EV","8":"-2.7EV","9":"-2.3EV","10":"-2.0EV","11":"-1.7EV","12":"-1.3EV","13":"-1.0EV","14":"-0.7EV","15":"-0.3EV","16":"0EV","17":"0.3EV","18":"0.7EV","19":"1.0EV","20":"1.3EV","21":"1.7EV","22":"2.0EV","23":"2.3EV","24":"2.7EV","25":"3.0EV","26":"3.3EV","27":"3.7EV","28":"4.0EV","29":"4.3EV","30":"4.7EV","31":"5.0EV","255":"FIXED"}
Current configuration of the zoom lens exposure value
» zoom_focus_mode
Zoom lens focus mode
enum_int
{"0":"MF","1":"AFS","2":"AFC"}
Current configuration of the zoom lens focus mode
» zoom_focus_value
Zoom lens focus value
int
» zoom_max_focus_value
Zoom lens maximum focus value
int
» zoom_min_focus_value
Zoom lens minimum focus value
int
» zoom_calibrate_farthest_focus_value
Zoom lens calibrated farthest focus value
int
Focused value at the farthest clear position
» zoom_calibrate_nearest_focus_value
Zoom lens calibrated nearest focus value
int
Focused value at the nearest clear position
» zoom_focus_state
Zoom lens focus state
int
» zoom_factor
Zoom factor
int
» zoom_aperture_value
Zoom lens aperture value
enum_int
{"440":"F4.4"}
measure_target
Target ranging and height measurement
struct
» measure_target_longitude
Laser ranging target longitude
double
{"max":"180","min":"-180","unit":"Degrees / °"}
» measure_target_latitude
Laser ranging target latitude
double
{"max":"90","min":"-90","unit":"Degrees / °"}
» measure_target_altitude
Laser ranging target altitude
double
{"unit":"Meters / m"}
» measure_target_distance
Laser ranging distance
double
{"unit":"Meters / m"}
ir_lense
Infrared information
struct
» screen_split_enable
Whether split screen is enabled
bool
{"false":"Disable split screen","true":"Enable split screen"}
» ir_zoom_factor
Infrared zoom factor
float
{"max":20,"min":2}
Infrared zoom factor
» thermal_supported_palette_styles
Collection of supported palette styles by the device
array
{"size": -,"item_type": enum_int}
The capability of supported styles varies for different devices
» thermal_gain_mode
Gain Mode
enum_int
{"0":"Auto","1":"Low Gain. Temperature Range is from 0°C to 500°C","2":"High Gain. Temperature Range is from -20°C to 150°C"}
Low gain provides a larger temperature measurement range, while high gain offers higher temperature measurement accuracy.
» thermal_isotherm_state
Whether isotherm is enabled
enum_int
{"0":"Disable","1":"Enable"}
Isotherm allows users to observe the content of temperature ranges of interest, making objects in the temperature range more prominent.
» thermal_isotherm_upper_limit
Upper limit of the temperature range for isotherm
int
{"unit":"Celsius / °C"}
Effective only when Isotherm is enabled
» thermal_isotherm_lower_limit
Lower limit of the temperature range for isotherm
int
{"unit":"Celsius / °C"}
Effective only when Isotherm is enabled
» thermal_global_temperature_min
Minimum temperature measured in the overall view
float
{"unit":"Celsius / °C"}
» thermal_global_temperature_max
Maximum temperature measured in the overall view
float
{"unit":"Celsius / °C"}
liveview
Live view area information
struct
» liveview_world_region
Field of view (FOV) region in liveview
struct
The field of view angle of the zoom camera relative to the wide-angle camera or infrared camera may differ in liveview. The coordinate origin is the upper-left corner of the lens.
»» left
X-axis starting point in the top-left corner
float
X-axis starting point in the top-left corner
»» top
Y-axis starting point in the top-left corner
float
Top-left corner's starting point on the y-axis
»» right
Starting point of the x-axis in the bottom right corner
float
Starting point of the x-axis in the bottom right corner
»» bottom
Y-axis starting point in the lower right corner
float
Y-axis starting point in the lower right corner
Example:
{
"data": {
"ir_lense": {
"ir_zoom_factor": 2,
"screen_split_enable": false,
"thermal_current_palette_style": 11,
"thermal_gain_mode": 2,
"thermal_global_temperature_max": 40.0373764038086,
"thermal_global_temperature_min": 31.65154457092285,
"thermal_isotherm_lower_limit": -20,
"thermal_isotherm_state": 0,
"thermal_isotherm_upper_limit": 150
},
"liveview": {
"liveview_world_region": {
"bottom": 0.5609484910964966,
"left": 0.43238765001297,
"right": 0.5639060735702515,
"top": 0.433199942111969
}
},
"measure_target": {
"measure_target_altitude": 34.60000228881836,
"measure_target_distance": 0,
"measure_target_error_state": 1,
"measure_target_latitude": 22.907619920797877,
"measure_target_longitude": 113.70345426744846
},
"payload_index": "81-0-0",
"wide_lense": {
"wide_aperture_value": 10,
"wide_exposure_mode": 1,
"wide_exposure_value": 16,
"wide_iso": 8,
"wide_shutter_speed": 45
},
"zoom_lense": {
"zoom_aperture_value": 10,
"zoom_calibrate_farthest_focus_value": 34,
"zoom_calibrate_nearest_focus_value": 64,
"zoom_exposure_mode": 1,
"zoom_exposure_value": 16,
"zoom_factor": 6.999994214380596,
"zoom_focus_mode": 0,
"zoom_focus_state": 0,
"zoom_focus_value": 34,
"zoom_iso": 8,
"zoom_max_focus_value": 64,
"zoom_min_focus_value": 33,
"zoom_shutter_speed": 45
}
},
"method": "drc_camera_osd_info_push",
"seq": 1
}Service
Enter DRC link
DRC link configuration issuance. ("seq" is an incrementing sequence number, ensuring commands are executed in order, at the same level as "data".)
Topic: thing/product/{gateway_sn}/drc/down
Direction: down
Method: drc_mode_enter
Data:
mqtt_broker
DRC Connection Information
struct
Issue DRC link configuration, mqtt
»address
Server connection address
text
Server connection address, for example, 192.0.2.1:8883, mqtt.dji.com:8883
»client_id
Client ID
text
Customizable MQTT client ID. It is recommended to use the device's serial number (SN code). It can also be combined with a meaningful prefix, such as drc-4J4R101
»username
User name
text
Username used when establishing a connection
»password
Password
text
Password required for authentication when establishing a connection
»expire_time
Authentication information expiration time
int
Authentication information can be reused within the validity period. The expiration of authentication information does not affect devices that have already established a connection.
»enable_tls
Whether to enable TLS
bool
Enable TLS, i.e., encrypt the MQTT link
osd_frequency
OSD frequency
int
{"max":30,"min":1,"step":"","unit_name":null}
Set OSD reporting frequency
hsi_frequency
HSI frequency
int
{"max":30,"min":1,"step":"","unit_name":null}
Set HSI reporting frequency
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"hsi_frequency": 1,
"mqtt_broker": {
"address": "mqtt.dji.com:8883",
"client_id": "sn_a",
"enable_tls": true,
"expire_time": 1672744922,
"password": "jwt_token",
"username": "sn_a_username"
},
"osd_frequency": 10
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_mode_enter
Data:
result
Return code
int
Non-zero indicates an error. Exceptional cases include loss of flight control, lack of virtual joystick permission, incorrect packet sequence number, etc.
Example:
{
"data": {
"result": 0
},
"method": "drc_mode_enter",
"seq": 1
}Initial state subscription for DRC
"seq" is an incrementing sequence number, ensuring commands are executed in order, at the same level as "data".
Topic: thing/product/{gateway_sn}/drc/down
Direction: down
Method: drc_initial_state_subscribe
Data:
null
null
double
Example:
{
"data": {},
"method": "drc_initial_state_subscribe",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_initial_state_subscribe
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drone_emergency_stop",
"seq": 1
}Last updated