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

payloads

Payload state

array

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

»control_source

Payload control authority

text

»payload_index

Payload index

text

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

»firmware_version

Firmware version

text

»sn

Payload serial number (SN)

text

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","20":"POI"}

distance_limit_status

Aircraft distance limit state

struct

»state

Whether to enable the limit distance

enum_int

{"0":"Not set","1":"Already set"}

»distance_limit

Limited distance

int

{"max":"8000","min":"15","step":"1","unit_name":"Meters / m"}

»is_near_distance_limit

Whether approaching the set distance limit

enum_int

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

wpmz_version

Aircraft's Wayline Mission Library (WPMZ) version

text

If the aircraft's firmware version is too low, querying may result in an exception. The dock will push version 1.0.2 of WPMZ to the cloud.

rth_altitude

Return home altitude

int

{"max":500,"min":20,"unit_name":"Meters / m"}

Return home altitude

rc_lost_action

Remote controller lost control action

enum_int

{"0":"Hovering","1":"Landing","2":"Returning to home"}

Remote controller lost control action

exit_wayline_when_rc_lost

[Deprecated] Wayline lost control action

enum_int

{"0":"Continue executing the wayline mission","1":"Exit wayline mission, execute remote controller lost control action"}

Lost control during wayline execution, choose to continue the wayline or execute the remote control lost controller action

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":"Panorama","-1":"Unsupported 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, wide, zoom, ir}

»video_storage_settings

Collection of video storage settings

array

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

Value range {current, wide, zoom, 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 menasurement point

struct

Related information of the infrared temperature menasurement 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 menasurement area

struct

Related information of the infrared temperature menasurement 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

country

Country area code

text

rid_state

RID operational state

bool

{"false":"Abnormal","true":"Normal"}

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

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

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

vertical_speed

Vertical speed

float

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

longitude

Longitude of the current position

float

latitude

Current latitude

float

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

»measure_target_longitude

Laser ranging target longitude

double

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

»measure_target_latitude

Laser ranging target latitude

double

{"max":"90","min":"-90","unit_name":"Degrees / °"}

»measure_target_altitude

Laser ranging target altitude

double

{"unit_name":"Meters / m"}

»measure_target_distance

Laser ranging distance

double

{"unit_name":"Meters / m"}

»measure_target_error_state

Laser ranging state

enum_int

{"0":"NORMAL","1":"TOO_CLOSE","2":"TOO_FAR","3":"NO_SIGNAL"}

»payload_index

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

text

»zoom_factor

Zoom factor

double

»thermal_current_palette_style

Palette style

enum_int

{"0":"WHITE_HOT","1":"BLACK_HOT","2":"RED_HOT","3":"GREEN_HOT","5":"RAINBOW","6":"IRONBOW1","8":"ICE_FIRE","11":"COLOR1","12":"COLOR2","13":"RAIN"}

The infrared camera offers various color styles, allowing users to choose different color palettes based on different scenes for clearer visibility of targets

»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_name":"Celsius / °C"}

Effective only when Isotherm is enabled

»thermal_isotherm_lower_limit

Lower limit of the temperature range for isotherm

int

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

Effective only when Isotherm is enabled

»thermal_global_temperature_min

Minimum temperature measured in the overall view

float

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

»thermal_global_temperature_max

Maximum temperature measured in the overall view

float

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

total_flight_sorties

Accumulated total sorties of the aircraft

int

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

current_rth_mode

Current value of the return-to-home altitude mode

enum_int

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

DJI Dock currently only uses the 'Preset height' mode

psdk_ui_resource

PSDK UI resource package

array

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

»psdk_index

PSDK payload device index

int

{"min":0}

»psdk_ready

PSDK readiness state

enum_int

{"0":"Not ready","1":"Ready"}

»object_key

OSS object

text

psdk_widget_values

PSDK payload device attribute values

array

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

»psdk_index

PSDK payload device index

int

{"min":0}

»psdk_name

Device name

text

»psdk_sn

Device serial number

text

»psdk_version

Device firmware version

text

»psdk_lib_version

PSDK lib version

text

»speaker

Speaker state

struct

»»work_mode

Speaker working mode

enum_int

{"0":"TTS payload mode","1":"Recording and speaking"}

»»play_mode

Speaker playback mode

enum_int

{"0":"Single play","1":"Loop play (single track)"}

»»play_volume

Speaker volume

int

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

»»system_state

Speaker state

enum_int

{"0":"Idle","1":"Transmitting (from dock to aircraft)","2":"Playing","3":"Abnormal","4":"TTS text conversion in progress","99":"Downloading (from dock to cloud)"}

»»play_file_name

The file name of the last played file by the speaker

text

{"length":128,"unit_name":"Bytes / B"}

»»play_file_md5

MD5 checksum of the file recently played by the speaker

text

»values

PSDK widget value list

array

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

»»index

Control number

int

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

»»value

Widget value

int

{}

Previous10.aircraft NextDevice Property List

Last updated 1 year ago