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

country

Country area code

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":"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","18":"Airborne RTK fixing mode"}

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

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

{"max":"","min":"","step":"","unit_name":"Seconds / s"}

Remaining recording time

»record_time

Video recording duration

int

{"max":"","min":"","step":"","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":"Shooting","1":"Recording","2":"Smart low-light","3":"Panoramic photography"}

Camera mode

»photo_state

Photo capturing status

enum_int

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

»screen_split_enable

Is split screen enabled

bool

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

»recording_state

Recording state

enum_int

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

Recording state

»zoom_factor

Zoom factor

float

{"max":200,"min":2,"step":"","unit_name":null}

»ir_zoom_factor

Infrared zoom factor

float

{"max":20,"min":2,"step":"","unit_name":null}

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

Wide-angle lens exposure mode

enum_int

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

Current configuration of 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 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 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 wide-angle lens exposure value

»zoom_exposure_mode

Zoom lens exposure mode

enum_int

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

Current configuration of 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 zoom lens ISO

»zoom_shutter_speed

Zoom lens shutter speed

enum_int

Current configuration of zoom lens shutter speed

»zoom_exposure_value

Zoom lens exposure value

enum_int

Current configuration of zoom lens exposure value

»zoom_focus_mode

Zoom lens focus mode

enum_int

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

»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

Farthest position with the clearest focus

»zoom_calibrate_nearest_focus_value

Zoom lens calibrated nearest focus value

int

Nearest position with the clearest focus

»zoom_focus_state

Zoom lens focus state

enum_int

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

»ir_metering_mode

Infrared metering mode

enum_int

{"0":"Temperature measurement off","1":"Spot temperature measurement","2":"Area temperature measurement"}

»ir_metering_point

Infrared metering point

struct

Information related to the infrared metering point

»»x

Metering point coordinate x

double

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

The horizontal coordinate x with the top left corner of the lens as the origin

»»y

Metering point coordinate y

double

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

The vertical coordinate y with the top left corner of the lens as the origin

»»temperature

Temperature of the metering point

double

»ir_metering_area

Infrared metering area

struct

Information related to the infrared metering area

»»x

Top-left corner coordinate x of the metering area

double

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

The horizontal coordinate x with the top left corner of the lens as the origin

»»y

Top-left corner coordinate y of the metering area

double

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

The vertical coordinate y with the top left corner of the lens as the origin

»»width

Width of the metering area

double

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

Width of the metering area

»»height

Height of the metering area

double

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

Height of the metering area

»»aver_temperature

Average temperature of the metering area

double

Average temperature of the metering area

»»min_temperature_point

Lowest temperature point in the metering area

struct

Information related to the lowest temperature point in the metering area

»»»x

Coordinate x of the lowest temperature point

double

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

The horizontal coordinate x with the top left corner of the lens as the origin

»»»y

Coordinate y of the lowest temperature point

double

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

The vertical coordinate y with the top left corner of the lens as the origin

»»»temperature

Temperature of the lowest temperature point

double

Temperature of the lowest temperature point

»»max_temperature_point

Highest temperature point in the metering area

struct

Information related to the highest temperature point in the metering area

»»»x

Coordinate x of the highest temperature point

double

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

The horizontal coordinate x with the top left corner of the lens as the origin

»»»y

Coordinate y of the highest temperature point

double

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

The vertical coordinate y with the top left corner of the lens as the origin

»»»temperature

Temperature of the highest temperature point

double

Temperature of the highest temperature point

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

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

is_near_area_limit

Whether approaching the GEO Zone

enum_int

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

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

height_limit

Aircraft height limit

int

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

night_lights_state

Aircraft night lights state

enum_int

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

activation_time

Aircraft activation time (Unix timestamp)

int

{"unit_name":"Seconds / s"}

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

total_flight_sorties

Accumulated total sorties of the aircraft

int

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

track_id

Track ID

text

{"length":"64"}

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

»gps_number

Number of GPS satellites

int

»rtk_number

Number of RTK satellite acquisitions

int

storage

Storage capacity

struct

»total

Total capacity

int

{"unit_name":"Kilobytes / KB"}

»used

Used capacity

int

{"unit_name":"Kilobytes / KB"}

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

total_flight_distance

Accumulated total mileage of the aircraft

float

{"unit_name":"Meters / m"}

total_flight_time

Accumulated total flight time of the aircraft

int

{"unit_name":"Seconds / s"}

serious_low_battery_warning_threshold

Critical low battery warning

int

User-set battery critically low warning percentage

low_battery_warning_threshold

Low battery warning

int

User-set battery low battery warning percentage

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.

wind_direction

Current wind direction

enum_int

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

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.

home_distance

Distance from the Home point

float

home_latitude

Home point latitude

float

home_longitude

Home point longitude

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.

attitude_roll

Roll axis angle

float

attitude_pitch

Pitch axis angle

float

elevation

Relative takeoff point altitude

float

height

Absolute height

float

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

latitude

Current latitude

float

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

longitude

Longitude of the current position

float

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

vertical_speed

Vertical speed

float

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

horizontal_speed

Horizontal speed

float

firmware_upgrade_status

Firmware upgrade state

enum_int

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

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_version

Firmware version

text

{"length":"64"}

gear

Gear

enum_int

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

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

Previous10.m3-series Next20.rc-pro

Last updated 1 year ago