Device Property List

pushMode:
- 0: Stable frequency data. Device will report in the frequency of 0.5HZ. (Topic:thing/product/{sn}/osd)
- 1: State data. It is reported when the state changes. (Topic:thing/product/{sn}/state)
accessMode:
- r: Property can only be read
- rw: Property can be read and written (Topic:thing/product/{sn}/property/set)

Column

Name

Type

constraint

Description

accessMode

pushMode

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":"Auto 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","18":"Airborne RTK fixing mode","19":"Dock address selecting"}

Dock address selection, indicating the aircraft hovers in the air for dock address selection and checking RTK signal quality

camera_watermark_settings

Camera watermark settings

struct

User configuration for watermarks on photos and video files taken by the camera. Currently, live stream watermarks are not supported.

»global_enable

Watermark display global enable switch

enum_int

{"0":"Disable","1":"Enable"}

Watermark display requires global enable switch

»drone_type_enable

Aircraft model display switch

enum_int

{"0":"Disable","1":"Enable"}

»drone_sn_enable

Aircraft serial number display switch

enum_int

{"0":"Disable","1":"Enable"}

»datetime_enable

Date and time display switch

enum_int

{"0":"Disable","1":"Enable"}

Time zone defaults to local time zone

»gps_enable

Latitude, longitude and altitude display switch

enum_int

{"0":"Disable","1":"Enable"}

»user_custom_string_enable

Custom text display switch

enum_int

{"0":"Disable","1":"Enable"}

»user_custom_string

Custom text content

text

Up to 250 bytes can be displayed

»layout

Position of the watermark in the frame

enum_int

{"0":"Top-left","1":"Bottom-left","2":"Top-right","3":"Bottom-right"}

cameras

Aircraft camera information

array

{"size": -, "item_type": struct}

»remain_photo_num

Remaining number of photos to take

int

Remaining number of photos to take

»remain_record_duration

Remaining recording time

int

{"unit_name":"Seconds / s"}

Remaining recording time

»record_time

Video recording duration

int

{"unit_name":"Seconds / s"}

Video recording duration

»payload_index

Payload index

text

Payload index. Camera enumeration values. Non-standard device_mode_key, formatted as {type-subtype-gimbalindex}. Please refer to Product Supported

»camera_mode

Camera mode

enum_int

{"0":"Capturing","1":"Recording","2":"Smart low-light","3":"Panoramic photography","-1":"Not supported mode"}

Camera mode

»photo_state

Capturing state

enum_int

{"0":"Idle","1":"Capturing photo"}

Capturing state

»screen_split_enable

Is split screen enabled

bool

{"false":"Disable split screen","true":"Enable split screen"}

»recording_state

Recording state

enum_int

{"0":"Idle","1":"Recording"}

Recording state

»zoom_factor

Zoom factor

float

{"max":200,"min":2}

»ir_zoom_factor

Infrared zoom factor

float

{"max":20,"min":2}

Infrared zoom factor

»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

Top-left corner's starting point on the y-axis

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

»photo_storage_settings

Photo storage settings collection

array

{"size": -, "item_type": enum_string}

Value range {current, vision, ir}

»video_storage_settings

Collection of video storage settings

array

{"size": -, "item_type": enum_string}

Value range {current, vision, ir}

»wide_exposure_mode

Exposure mode of wide lens

enum_int

{"1":"Auto","2":"Shutter priority","3":"Aperture priority","4":"Manual exposure"}

Currently configured exposure mode of wide lens

»wide_iso

ISO of wide lens

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"}

Currently configured ISO of wide lens

»wide_shutter_speed

Shutter wpeed of wide lens

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"}

Currently configured shutter speed of wide lens

»wide_exposure_value

Exposure value of wide lens

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"}

Currently configured exposure value of wide lens

»zoom_exposure_mode

Exposure mode of zoom lens

enum_int

{"1":"Auto","2":"Shutter priority","3":"Aperture priority","4":"Manual exposure"}

Currently configured exposure mode of zoom lens

»zoom_iso

ISO of zoom lens

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"}

Currently configured ISO of zoom lens

»zoom_shutter_speed

Shutter speed of zoom lens

enum_int

Currently configured shutter speed of zoom lens

»zoom_exposure_value

Exposure value of zoom lens

enum_int

Currently configured exposure value of zoom lens

»zoom_focus_mode

Focus mode of zoom lens

enum_int

{"0":"MF","1":"AFS","2":"AFC"}

»zoom_focus_value

Focus value of zoom lens

int

»zoom_max_focus_value

Maximum focus value of zoom lens

int

»zoom_min_focus_value

Minimum focus value of zoom lens

int

»zoom_calibrate_farthest_focus_value

The farthest focusing value calibrated by zoom lens

int

The clearest and farthest focusing value

»zoom_calibrate_nearest_focus_value

The closest focusing value calibrated by zoom lens

int

The clearest and closest focusing value

»zoom_focus_state

Zoom lens focusing state

enum_int

{"0":"Idle","1":"Focusing","2":"Focus successful","3":"Focus failed"}

»ir_metering_mode

Infrared temperature measurement mode

enum_int

{"0":"Close temperature measurement","1":"Point temperature measurement","2":"Area temperature measurement"}

»ir_metering_point

Infrared temperature measurement point

struct

Related information of the infrared temperature measurement point

»»x

Temperature measurement point coordinate x

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The horizontal direction is x.

»»y

Temperature measurement point coordinate y

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The vertical direction is y.

»»temperature

Temperature of the measurement point

double

»ir_metering_area

Infrared temperature measurement area

struct

Related information of the infrared temperature measurement area

»»x

Coordinate x of the left and upper corner of the temperature measurement area

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The horizontal direction is x.

»»y

Coordinate y of the left and upper corner of the temperature measurement area

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The vertical direction is y.

»»width

Width of the temperature measurement area

double

{"max":1,"min":0}

Width of the temperature measurement area

»»height

Height of the temperature measurement area

double

{"max":1,"min":0}

Height of the temperature measurement area

»»aver_temperature

Average temperature of the measurement area

double

Average temperature of the measurement area

»»min_temperature_point

The lowest temperature point in the measurement area

struct

Related information of the lowest temperature point in the measurement area

»»»x

Coordinate x of the lowest temperature point

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The horizontal direction is x.

»»»y

Coordinate y of the lowest temperature point

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The vertical direction is y.

»»»temperature

Temperature of the lowest temperature point

double

Temperature of the lowest temperature point

»»max_temperature_point

Hightest temperature point in the measurement area

struct

Related information of the hightest temperature point in the measurement area

»»»x

Coordinate x of the highest temperature point

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The horizontal direction is x.

»»»y

Coordinate y of the highest temperature point

double

{"max":1,"min":0}

The left and upper corner of the lens is the coordinate center. The vertical direction is y.

»»»temperature

Temperature of the highest temperature point

double

Temperature of the highest temperature point

commander_mode_lost_action

To-point flight loss of control action

enum_int

{"0":"Continue with the to-point flight mission","1":"Exit the to-point flight mission and perform normal loss of control behavior"}

Loss of control during to-point flight, choose to continue and complete mission or perform normal loss of control behavior

commander_flight_mode

To-point mode setting value

enum_int

{"0":"Optimal height flight","1":"Preset height flight"}

To-point mode setting value

current_commander_flight_mode

Current value of the to-point flight mode

enum

{"0":"Optimal height flight","1":"Preset height flight"}

Current value of the to-point flight mode

commander_flight_height

To-point height

float

{"max":3000,"min":2,"step":0.1,"unit_name":"Meters / m"}

Height relative to the (dock) takeoff point, relative high ALT

mode_code_reason

The reason the aircraft entered the current state

enum_int

{"0":"No meaning","1":"Insufficient battery power (return, landing)","2":"Insufficient battery voltage (return, landing)","3":"Severely low voltage (return, landing)","4":"Requested by remote controller buttons (takeoff, return, landing)","5":"Requested by App (takeoff, return, landing)","6":"Loss of remote controller signal (return, landing, hover)","7":"Triggered by external devices such as navigation, SDK, etc. (takeoff, return, landing)","8":"Entered the dock GEO Zone (landing)","9":"Although a return was triggered, it was too close to the Home point (landing)","10":"Although a return was triggered, it was too far from the Home point (landing)","11":"Requested when executing waypoint missions (takeoff)","12":"Requested after reaching above the Home point in the return phase (landing)","13":"Continued descent after the aircraft's height dropped to 0.7m from the ground (second-stage descent limit) leading to (landing)","14":"Forced breakthrough of low altitude protection by devices like App, SDK (landing)","15":"Requested due to passing flights in the vicinity (returning, landing)","16":"Requested due to height control failure (return, landing)","17":"Entered after intelligent low battery return (landing)","18":"AP controls the flight mode (manual flight)","19":"Hardware abnormally (return, landing)","20":"End of anti-collision protection (landing)","21":"Return canceled (hover)","22":"Encountered obstacles during the return (landing)","23":"Triggered by strong winds in the dock scene (return)"}

gear

Gear

enum_int

{"0":"A","1":"P","2":"NAV","3":"FPV","4":"FARM","5":"S","6":"F","7":"M","8":"G","9":"T"}

firmware_version

Firmware version

text

{"length":"64"}

compatible_status

Firmware consistency

enum_int

{"0":"No consistency upgrade required","1":"Consistency upgrade required"}

Consistent firmware update means a consistent firmware update is required when the firmware versions of some modules of the aircraft are inconsistent with the compatible version of the system. For example, the aircraft and RC have been updated to newest version, but the used batteries is not updated. Then the Consistent firmware update will be prompted. Normal firmware update means developers update all modules of aircraft to selected firmware version.

firmware_upgrade_status

Firmware upgrade state

enum_int

{"0":"Not upgraded","1":"Upgrading"}

horizontal_speed

Horizontal speed

float

vertical_speed

Vertical speed

float

{"unit_name":"Meters per second / m/s"}

longitude

Longitude of the current position

float

{"max":"3.4028235E38","min":"-1.4E-45","step":"0.1"}

latitude

Current latitude

float

{"max":"3.4028235E38","min":"-1.4E-45","step":"0.1"}

height

Absolute height

float

Relative to the Earth ellipsoid height. Calculation is height relative to takeoff point + ellipsoid height of takeoff point

elevation

Relative takeoff point altitude

float

attitude_pitch

Pitch axis angle

float

attitude_roll

Roll axis angle

float

attitude_head

Yaw axis angle

int

Yaw axis angle with true north angle (longitude). Positive values from 0 to 6 o'clock direction, negative values from 6 to 12 o'clock direction.

home_longitude

Home point longitude

float

home_latitude

Home point latitude

float

home_distance

Distance from the Home point

float

wind_speed

Wind speed

float

Estimated wind speed, calculated based on the aircraft's attitude with some margin of error. It is for reference only and should not be used as meteorological data.

wind_direction

Current wind direction

enum_int

{"1":"True North","2":"Northeast","3":"East","4":"Southeast","5":"South","6":"Southwest","7":"West","8":"Northwest"}

control_source

Current control source

text

Can be a device or a browser. Devices use A/B to represent A control and B control, while browsers use a self-generated UUID as an identifier.

low_battery_warning_threshold

Low battery warning

int

User-set battery low battery warning percentage

serious_low_battery_warning_threshold

Critical low battery warning

int

User-set battery critically low warning percentage

total_flight_time

Accumulated total flight time of the aircraft

float

{"unit_name":"Seconds / s"}

total_flight_distance

Accumulated total mileage of the aircraft

float

{"unit_name":"Meters / m"}

battery

Aircraft battery information

struct

»capacity_percent

Total remaining battery capacity

int

{"max":100,"min":0}

»remain_flight_time

Remaining flight time

int

{"unit_name":"Seconds / s"}

»return_home_power

Percentage of power required for return home

int

{"max":100,"min":0}

»landing_power

Forced landing battery percentage

int

{"max":100,"min":0}

»batteries

Battery details

array

{"size": -, "item_type": struct}

»»capacity_percent

Remaining battery capacity

int

{"max":100,"min":0}

»»index

Battery serial number

int

{"min":"0"}

»»sn

Battery serial number (SN)

text

»»type

Battery type

enum_int

{}

»»sub_type

Battery subtype

enum_int

{}

»»firmware_version

Firmware version

text

»»loop_times

Battery cycle count

int

»»voltage

Voltage

int

{"unit_name":"Millivolts / mV"}

»»temperature

Temperature

float

{"unit_name":"Celsius / °C"}

Retain one decimal place

»»high_voltage_storage_days

High voltage storage days

int

{"unit_name":"Days / day"}

storage

Storage capacity

struct

»total

Total capacity

int

{"unit_name":"Kilobytes / KB"}

»used

Used capacity

int

{"unit_name":"Kilobytes / KB"}

position_state

Satellite search state

struct

»is_fixed

Whether is Fixed

enum_int

{"0":"Not started","1":"Fixing","2":"Fixing successful","3":"Fixing failed"}

»quality

Satellite acquisition mode

enum_int

{"1":"Gear 1","2":"Gear 2","3":"Gear 3","4":"Gear 4","5":"Gear 5","10":"RTK fixed"}

»gps_number

Number of GPS satellites

int

»rtk_number

Number of RTK satellite acquisitions

int

track_id

Track ID

text

{"length":"64"}

{type-subtype-gimbalindex}

Payload index

struct

Consistent with the numerical value of the 'payload_index' field.

»gimbal_pitch

Gimbal pitch axis angle

double

{"max":"180","min":"-180","step":0.1,"unit_name":"Degrees / °"}

»gimbal_roll

Gimbal roll axis angle

double

{"max":"180","min":"-180","step":0.1,"unit_name":"Degrees / °"}

»gimbal_yaw

Gimbal yaw axis angle

double

{"max":"180","min":"-180","step":0.1,"unit_name":"Degrees / °"}

»payload_index

Payload index. The format is {type-subtype-gimbalindex}

text

»zoom_factor

Zoom factor

double

total_flight_sorties

Accumulated total sorties of the aircraft

int

{"max":"2147483647","min":"0","step":"1"}

maintain_status

Maintenance information

struct

»maintain_status_array

Maintenance information array

array

{"size": -, "item_type": struct}

»»state

Maintenance state

enum_int

{"0":"No maintenance","1":"With maintenance"}

»»last_maintain_type

Last maintenance type

enum_int

{"1":"Basic maintenance of the aircraft","2":"Regular maintenance of the aircraft","3":"Deep maintenance of the aircraft"}

»»last_maintain_time

Last maintenance time

date

{"unit_name":"Seconds / s"}

»»last_maintain_flight_time

Last maintenance flight hours

int

{"unit_name":"Hours / h"}

»»last_maintain_flight_sorties

Last maintenance flight sorties

int

{"max":"2147483647","min":"0","step":"1"}

activation_time

Aircraft activation time (Unix timestamp)

int

{"unit_name":"Seconds / s"}

night_lights_state

Aircraft night lights state

enum_int

{"0":"Disable","1":"On"}

height_limit

Aircraft height limit

int

{"max":"1500","min":"20","step":"1","unit_name":"Meters / m"}

is_near_height_limit

Whether approaching the set height limit

enum_int

{"0":"Not reaching the set height limit","1":"Approaching the set height limit"}

is_near_area_limit

Whether approaching the GEO Zone

enum_int

{"0":"Not reaching the GEO Zone","1":"Approaching the GEO Zone"}

obstacle_avoidance

Aircraft obstacle sensing state

struct

»horizon

Horizontal obstacle sensing state

enum_int

{"0":"Disable","1":"Enable"}

»upside

Upward obstacle sensing state

enum_int

{"0":"Disable","1":"Enable"}

»downside

Downward obstacle sensing state

enum_int

{"0":"Disable","1":"Enable"}

rth_mode

Return home altitude mode setting value

enum_int

{"0":"Intelligent altitude","1":"Preset altitude"}

In intelligent return home mode, the aircraft will automatically plan the optimal return home altitude. The DJI dock currently does not support setting the return home altitude mode and can only choose the 'Preset Altitude' mode. When the environment or lighting does not meet the requirements of the visual system (such as direct sunlight in the evening, weak or no light at night), the aircraft will use the return home altitude you set for straight-line return home.

current_rth_mode

Current value of the return-to-home altitude mode

enum_int

{"0":"Intelligent altitude","1":"Preset altitude"}

Actual return-to-home altitude mode currently used by DJI Dock

dongle_infos

4G Dongle information

array

{"size": -, "item_type": struct}

»imei

dongle imei

text

Unique identifier for the Dongle

»dongle_type

Dongle type

enum_int

{"6":"Old Dongle","10":"New Dongle with eSIM support"}

Dongle type

»eid

dongle eid

text

Unique identifier for eSIM, used for public account query of plans and service purchase

»esim_activate_state

eSIM activation state

enum_int

{"0":"Not activated","1":"Activated"}

Requires activation to use

»sim_card_state

SIM card state

enum_int

{"0":"Not inserted","1":"Inserted"}

Insertion state of the physical SIM card in the dongle

»sim_slot

SIM card slot enable state

enum_int

{"0":"Unknown","1":"Physical SIM card","2":"eSIM"}

Identifies the SIM card slot currently in use by the dongle

»esim_infos

eSIM information

array

{"size": -, "item_type": struct}

»»telecom_operator

Supported operators

enum_int

{"0":"Unknown","1":"Mobile","2":"China Unicom","3":"Telecommunications"}

Telecom operators supported by eSIM

»»enabled

eSIM enable state

bool

{"false":"Not in use","true":"In use"}

Only one eSIM can be enabled at a time

»»iccid

SIM ICCID

text

Unique identifier for the SIM card, can be used for purchasing packages for physical SIM cards

»sim_info

SIM card information

struct

Information about the physical SIM card that can be inserted into the dongle

»»telecom_operator

Supported operators

enum_int

{"0":"Unknown","1":"Mobile","2":"China Unicom","3":"Telecommunications"}

Telecom operator supported by the SIM card

»»sim_type

SIM card type

enum_int

{"0":"Unknown","1":"Other regular SIM card","2":"Three-network card"}

Type of physical SIM card

»»iccid

SIM ICCID

text

Unique identifier for the SIM card, can be used for purchasing packages for physical SIM cards

offline_map_enable

Offline map switch

bool

When the offline map is turned off, offline map synchronization will no longer be automatically performed

PreviousDevice Property List Next20.dock

Last updated 1 year ago