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}		r	1
»control_source	Payload control authority	text			r	1
»payload_index	Payload index	text		Payload index. The format is {type-subtype-gimbalindex}	r	1
»firmware_version	Firmware version	text			r	1
»sn	Payload serial number (SN)	text			r	1
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":"Panoramic photography","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"}		r	0
distance_limit_status	Aircraft distance limit state	struct			rw	0
»state	Whether to enable the limit distance	enum_int	{"0":"Not set","1":"Already set"}			0
»distance_limit	Limited distance	int	{"max":"8000","min":"15","step":"1","unit_name":"Meters / m"}			0
»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"}		r	0
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.	r	1
rth_altitude	Return home altitude	int	{"max":500,"min":20,"unit_name":"Meters / m"}	Return home altitude	rw	0
rc_lost_action	Remote controller lost control action	enum_int	{"0":"Hovering","1":"Landing","2":"Returning to home"}	Remote controller lost control action	rw	0
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	rw	0
cameras	Aircraft camera information	array	{"size": -, "item_type": struct}		r	0
»remain_photo_num	Remaining number of photos to take	int		Remaining number of photos to take	r	0
»remain_record_duration	Remaining recording time	int	{"unit_name":"Seconds / s"}	Remaining recording time	r	0
»record_time	Video recording duration	int	{"unit_name":"Seconds / s"}	Video recording duration	r	0
»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		0
»camera_mode	Camera mode	enum_int	{"0":"Shooting","1":"Recording"}	Camera mode		0
»photo_state	Shooting state	enum_int	{"0":"Idle","1":"Shooting photo"}	Shooting state		0
»screen_split_enable	Is split screen enabled	bool	{"false":"Disable split screen","true":"Enable split screen"}			0
»recording_state	Recording state	enum_int	{"0":"Idle","1":"Recording"}	Recording state		0
»zoom_factor	Zoom factor	int	{"max":200,"min":2}	Matrice 300 RTK will not report this field		0
»ir_zoom_factor	Infrared zoom factor	float	{"max":20,"min":2}	Infrared zoom factor		0
»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.		0
»»left	X-axis starting point in the top-left corner	float		X-axis starting point in the top-left corner	r	0
»»top	Top-left corner's starting point on the y-axis	float		Top-left corner's starting point on the y-axis	r	0
»»right	Starting point of the x-axis in the bottom right corner	float		Starting point of the x-axis in the bottom right corner	r	0
»»bottom	Y-axis starting point in the lower right corner	float		Y-axis starting point in the lower right corner	r	0
»photo_storage_settings	Photo storage settings collection	array	{"size": -, "item_type": enum_string}	Value range {current, wide, zoom, ir}	r	0
»video_storage_settings	Collection of video storage settings	array	{"size": -, "item_type": enum_string}	Value range {current, wide, zoom, ir}	r	0
country	Country area code	text			r	0
rid_state	RID operational state	bool	{"false":"Abnormal","true":"Normal"}		r	0
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	rw	1
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	r	1
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	rw	1
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)"}		r	1
gear	Gear	enum_int	{"0":"A","1":"P","2":"NAV","3":"FPV","4":"FARM","5":"S","6":"F","7":"M","8":"G","9":"T"}		r	0
firmware_version	Firmware version	text	{"length":"64"}		r	1
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.	r	1
firmware_upgrade_status	Firmware upgrade state	enum_int	{"0":"Not upgraded","1":"Upgrading"}		r	1
horizontal_speed	Horizontal speed	float	{"unit_name":"Meters per second / m/s"}		r	0
vertical_speed	Vertical speed	float	{"unit_name":"Meters per second / m/s"}		r	0
longitude	Longitude of the current position	float			r	0
latitude	Current latitude	float			r	0
height	Absolute height	float		Relative to the Earth ellipsoid height. Calculation is height relative to takeoff point + ellipsoid height of takeoff point	r	0
elevation	Relative takeoff point altitude	float			r	0
attitude_pitch	Pitch axis angle	float			r	0
attitude_roll	Roll axis angle	float			r	0
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.	r	0
home_longitude	Home point longitude	float			r	1
home_latitude	Home point latitude	float			r	1
home_distance	Distance from the Home point	float			r	0
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.	r	0
wind_direction	Current wind direction	enum_int	{"1":"True North","2":"Northeast","3":"East","4":"Southeast","5":"South","6":"Southwest","7":"West","8":"Northwest"}		r	0
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.	r	1
low_battery_warning_threshold	Low battery warning	int		User-set battery low battery warning percentage	r	1
serious_low_battery_warning_threshold	Critical low battery warning	int		User-set battery critically low warning percentage	r	1
total_flight_time	Accumulated total flight time of the aircraft	float	{"unit_name":"Seconds / s"}		r	0
total_flight_distance	Accumulated total mileage of the aircraft	float	{"unit_name":"Meters / m"}		r	0
battery	Aircraft battery information	struct			r	0
»capacity_percent	Total remaining battery capacity	int	{"max":100,"min":0}			0
»remain_flight_time	Remaining flight time	int	{"unit_name":"Seconds / s"}			0
»return_home_power	Percentage of power required for return home	int	{"max":100,"min":0}			0
»landing_power	Forced landing battery percentage	int	{"max":100,"min":0}			0
»batteries	Battery details	array	{"size": -, "item_type": struct}			0
»»capacity_percent	Remaining battery capacity	int	{"max":100,"min":0}			0
»»index	Battery serial number	int	{"min":"0"}			0
»»sn	Battery serial number (SN)	text				0
»»type	Battery type	enum_int	{}			0
»»sub_type	Battery subtype	enum_int	{}			0
»»firmware_version	Firmware version	text				0
»»loop_times	Battery cycle count	int				0
»»voltage	Voltage	int	{"unit_name":"Millivolts / mV"}			0
»»temperature	Temperature	float	{"unit_name":"Celsius / °C"}	Retain one decimal place		0
»»high_voltage_storage_days	High voltage storage days	int	{"unit_name":"Days / day"}			0
storage	Storage capacity	struct		kb	r	0
»total	Total capacity	int	{"unit_name":"Kilobytes / KB"}			0
»used	Used capacity	int	{"unit_name":"Kilobytes / KB"}			0
position_state	Satellite search state	struct			r	0
»is_fixed	Whether is Fixed	enum_int	{"0":"Not started","1":"Fixing","2":"Fixing successful","3":"Fixing failed"}			0
»quality	Satellite acquisition mode	enum_int	{"1":"Gear 1","2":"Gear 2","3":"Gear 3","4":"Gear 4","5":"Gear 5","10":"RTK fixed"}			0
»gps_number	Number of GPS satellites	int				0
»rtk_number	Number of RTK satellite acquisitions	int				0
track_id	Track ID	text	{"length":"64"}		r	0
{type-subtype-gimbalindex}	Payload index	struct		Consistent with the numerical value of the 'payload_index' field.	r	0
»gimbal_pitch	Gimbal pitch axis angle	double	{"max":"180","min":"-180","step":0.1,"unit_name":"Degrees / °"}		r	0
»gimbal_roll	Gimbal roll axis angle	double	{"max":"180","min":"-180","step":0.1,"unit_name":"Degrees / °"}		r	0
»gimbal_yaw	Gimbal yaw axis angle	double	{"max":"180","min":"-180","step":0.1,"unit_name":"Degrees / °"}		r	0
»measure_target_longitude	Laser ranging target longitude	double	{"max":"180","min":"-180","unit_name":"Degrees / °"}		r	0
»measure_target_latitude	Laser ranging target latitude	double	{"max":"90","min":"-90","unit_name":"Degrees / °"}		r	0
»measure_target_altitude	Laser ranging target altitude	double	{"unit_name":"Meters / m"}		r	0
»measure_target_distance	Laser ranging distance	double	{"unit_name":"Meters / m"}		r	0
»measure_target_error_state	Laser ranging state	enum_int	{"0":"NORMAL","1":"TOO_CLOSE","2":"TOO_FAR","3":"NO_SIGNAL"}		r	0
»payload_index	Payload index. The format is {type-subtype-gimbalindex}	text			r	1
»zoom_factor	Zoom factor	double			r	0
»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	rw	0
»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	r	1
»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.	rw	0
»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.	rw	0
»thermal_isotherm_upper_limit	Upper limit of the temperature range for isotherm	int	{"unit_name":"Celsius / °C"}	Effective only when Isotherm is enabled	rw	0
»thermal_isotherm_lower_limit	Lower limit of the temperature range for isotherm	int	{"unit_name":"Celsius / °C"}	Effective only when Isotherm is enabled	rw	0
»thermal_global_temperature_min	Minimum temperature measured in the overall view	float	{"unit_name":"Celsius / °C"}		r	0
»thermal_global_temperature_max	Maximum temperature measured in the overall view	float	{"unit_name":"Celsius / °C"}		r	0
total_flight_sorties	Accumulated total sorties of the aircraft	int			r	0
maintain_status	Maintenance information	struct			r	0
»maintain_status_array	Maintenance information array	array	{"size": -, "item_type": struct}			0
»»state	Maintenance state	enum_int	{"0":"No maintenance","1":"With maintenance"}			0
»»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"}			0
»»last_maintain_time	Last maintenance time	date	{"unit_name":"Seconds / s"}			0
»»last_maintain_flight_time	Last maintenance flight hours	int	{"unit_name":"Hours / h"}			0
»»last_maintain_flight_sorties	Last maintenance flight sorties	int	{"max":"2147483647","min":"0","step":"1"}			0
activation_time	Aircraft activation time (Unix timestamp)	int	{"unit_name":"Seconds / s"}		r	0
night_lights_state	Aircraft night lights state	enum_int	{"0":"Disable","1":"On"}		rw	0
height_limit	Aircraft height limit	int	{"max":"1500","min":"20","step":"1","unit_name":"Meters / m"}		rw	0
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"}		r	0
is_near_area_limit	Whether approaching the GEO Zone	enum_int	{"0":"Not reaching the GEO Zone","1":"Approaching the GEO Zone"}		r	0
obstacle_avoidance	Aircraft obstacle sensing state	struct			rw	0
»horizon	Horizontal obstacle sensing state	enum_int	{"0":"Disable","1":"Enable"}			0
»upside	Upward obstacle sensing state	enum_int	{"0":"Disable","1":"Enable"}			0
»downside	Downward obstacle sensing state	enum_int	{"0":"Disable","1":"Enable"}			0
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	r	1
psdk_ui_resource	PSDK UI resource package	array	{"size": -, "item_type": struct}		r	1
»psdk_index	PSDK payload device index	int	{"min":0}		r	1
»psdk_ready	PSDK readiness state	enum_int	{"0":"Not ready","1":"Ready"}		r	1
»object_key	OSS object	text			r	1
psdk_widget_values	PSDK payload device attribute values	array	{"size": -, "item_type": struct}		r	1
»psdk_index	PSDK payload device index	int	{"min":0}		r	1
»psdk_name	Device name	text			r	1
»psdk_sn	Device serial number	text			r	1
»psdk_version	Device firmware version	text			r	1
»psdk_lib_version	PSDK lib version	text			r	1
»speaker	Speaker state	struct			r	1
»»work_mode	Speaker working mode	enum_int	{"0":"TTS payload mode","1":"Recording and speaking"}		r	1
»»play_mode	Speaker playback mode	enum_int	{"0":"Single play","1":"Loop play (single track)"}		r	1
»»play_volume	Speaker volume	int	{"max":100,"min":0,"step":1}		r	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)"}		r	1
»»play_file_name	The file name of the last played file by the speaker	text	{"length":128,"unit_name":"Bytes / B"}		r	1
»»play_file_md5	MD5 checksum of the file recently played by the speaker	text			r	1
»values	PSDK widget value list	array	{"size": -, "item_type": struct}		r	1
»»index	Control number	int	{"min":0,"step":1}		r	1
»»value	Widget value	int	{}		r	1