180.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
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
}Night flight light setting
"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_night_lights_state_set
Data:
night_lights_state
State
enum_int
{"0":"Disable","1":"Enable"}
Example:
{
"data": {
"night_lights_state": 0
},
"method": "drc_night_lights_state_set",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_night_lights_state_set
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drc_night_lights_state_set",
"seq": 1
}Flight control - stealth mode
Setting the aircraft to stealth mode, which turns off all aircraft lights. ("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_stealth_state_set
Data:
stealth_state
Stealth mode
enum_int
{"0":"Disable","1":"Enable"}
Stealth mode state
Example:
{
"data": {
"stealth_state": 0
},
"method": "drc_stealth_state_set",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_stealth_state_set
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drc_stealth_state_set",
"seq": 1
}Payload control - camera aperture
"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_camera_aperture_value_set
Data:
payload_index
Camera enumeration
text
Camera enumeration values. Non-standard device_mode_key, formatted as {type-subtype-gimbalindex}. Please refer to Product Supported
camera_type
Camera type
enum_string
{"wide":"Wide-angle","zoom":"Zoom"}
Camera type enumeration
aperture_value
Aperture value
enum_int
{"0":"F_AUTO","50":"F0_5","70":"F0_7","80":"F0_8","90":"F0_9","95":"F0_95","100":"F1_0","110":"F1_1","120":"F1_2","140":"F1_4","160":"F1_6","170":"F1_7","180":"F1_8","200":"F2","220":"F2_2","240":"F2_4","250":"F2_5","280":"F2_8","320":"F3_2","330":"F3_3","340":"F3_4","350":"F3_5","400":"F4","440":"F4_4","450":"F4_5","480":"F4_8","500":"F5","560":"F5_6","630":"F6_3","670":"F6_7","680":"F6_8","710":"F7_1","800":"F8","900":"F9","950":"F9_5","960":"F9_6","1000":"F10","1100":"F11","1300":"F13","1400":"F14","1600":"F16","1800":"F18","1900":"F19","2000":"F20","2200":"F22","2500":"F25","2700":"F27","2900":"F29","3200":"F32","3600":"F36","3800":"F38","4000":"F40","4500":"F45","5100":"F51","5400":"F54","5700":"F57","6400":"F64","7200":"F72","7600":"F76","8000":"F80","9000":"F90","10700":"F107","12800":"F128","18000":"F180","25600":"F256"}
Depending on the aircraft model, the range may vary.
Example:
{
"data": {
"aperture_value": 5,
"camera_type": "zoom",
"payload_index": "39-0-7"
},
"method": "drc_camera_aperture_value_set",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_camera_aperture_value_set
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drc_camera_aperture_value_set",
"seq": 1
}Payload control - camera shutter
"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_camera_shutter_set
Data:
payload_index
Camera enumeration
text
Camera enumeration values. Non-standard device_mode_key, formatted as {type-subtype-gimbalindex}. Please refer to Product Supported
camera_type
Camera type
enum_string
{"wide":"Wide-angle","zoom":"Zoom"}
Camera type enumeration
shutter_value
Shutter speed setting
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","60":"Auto"}
Depending on the aircraft model, the range may vary.
Example:
{
"data": {
"aperture_value": 5,
"camera_type": "zoom",
"payload_index": "39-0-7"
},
"method": "drc_camera_aperture_value_set",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_camera_shutter_set
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drc_camera_shutter_set",
"seq": 1
}Payload control - ISO setting
"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_camera_iso_set
Data:
payload_index
Camera enumeration
text
Camera enumeration values. Non-standard device_mode_key, formatted as {type-subtype-gimbalindex}. Please refer to Product Supported
camera_type
Camera type
enum_string
{"wide":"Wide-angle","zoom":"Zoom"}
Camera type enumeration
iso_value
ISO value
enum_int
{"0":"ISO_AUTO","2":"ISO_50","3":"ISO_100","4":"ISO_200","5":"ISO_400","6":"ISO_800","7":"ISO_1600","8":"ISO_3200","9":"ISO_6400","10":"ISO_12800","11":"ISO_25600","12":"ISO_51200","13":"ISO_102400","255":"ISO_FIXED"}
Depending on the aircraft model, the range may vary.
Example:
{
"data": {
"camera_type": "zoom",
"iso_value": 5,
"payload_index": "39-0-7"
},
"method": "drc_camera_iso_set",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_camera_iso_set
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drc_camera_iso_set",
"seq": 1
}Payload control - mechanical shutter
Support for users to manually close the mechanical shutter to prolong the lifespan of the equipment. Mechanical shutter switch for Matrice 3D wide-angle mode. ("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_camera_mechanical_shutter_set
Data:
payload_index
Camera enumeration
text
Camera enumeration values. Non-standard device_mode_key, formatted as {type-subtype-gimbalindex}. Please refer to Product Supported
camera_type
Camera type
enum_string
{"wide":"Wide-angle"}
Camera type enumeration
dewarping_state
Whether to enable mechanical shutter
enum_int
{"0":"Disable","1":"Enable"}
Enable or disable mechanical shutter
Example:
{
"data": {
"camera_type": "wide",
"mechanical_shutter_state": 1,
"payload_index": "39-0-7"
},
"method": "drc_camera_mechanical_shutter_set",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_camera_mechanical_shutter_set
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drc_camera_mechanical_shutter_set",
"seq": 1
}Payload control - lens distortion correction
Enable users to eliminate vignetting in wide-angle view. Lens distortion correction for Matrice 3D wide-angle mode.("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_camera_dewarping_set
Data:
payload_index
Camera enumeration
text
Camera enumeration values. Non-standard device_mode_key, formatted as {type-subtype-gimbalindex}. Please refer to Product Supported
camera_type
Camera type
enum_string
{"wide":"Wide-angle"}
Camera type enumeration
dewarping_state
Whether to enable lens distortion correction
enum_int
{"0":"Disable","1":"Enable"}
Enable or disable lens distortion correction
Example:
{
"data": {
"camera_type": "wide",
"dewarping_state": 1,
"payload_index": "39-0-7"
},
"method": "drc_camera_dewarping_set",
"seq": 1
}Topic: thing/product/{gateway_sn}/drc/up
Direction: up
Method: drc_camera_dewarping_set
Data:
result
Return code
int
Non-zero represents an error
Example:
{
"data": {
"result": 0
},
"method": "drc_camera_dewarping_set",
"seq": 1
}Last updated