EVO III Device Properties
Device Attribute List
-
pushMode:
- 0: Device sends periodic data at a frequency of 0.5Hz (Topic: thing/product/{device_sn}/osd)
- 1: Device sends state data upon state changes (Topic: thing/product/{device_sn}/state)
-
accessMode:
- r: Read-only attribute
- rw: Read and write attribute (Topic: thing/product/{gateway_sn}/property/set)
| Column | Name | Type | constraint | Description | accessMode | pushMode |
|---|---|---|---|---|---|---|
| payloads | Payload Status | array | {"size": -, "item_type": struct} | List of payload devices currently mounted on the aircraft | r | 1 |
| »payload_index | Payload Index | text | Payload index, format is {type-subtype-gimbalindex} | r | 1 | |
| »sn | Payload Serial Number (SN) | text | Unique identifier of the payload device | r | 1 | |
| »payload_id | Payload ID | int | ID assigned to the payload by the agent | r | 1 | |
| »payload_type | Payload Type | int | {5: Light-and-speaker combo, 6: Speaker} | PSDK payload type; other values are defined by the SDK | r | 1 |
| »payload_position | Payload Position | int | {0: Unknown, 1: Front, 2: Rear, 3: Left, 4: Right, 5: Top, 6: Bottom} | Mounting position of the payload on the airframe | r | 1 |
| »is_online | Online Status | int | {0: Offline, 1: Online} | Whether the payload is currently online | r | 1 |
| »last_active_time | Last Active Time | long | Timestamp of the payload's last activity; not populated for PSDK payloads in the current firmware | r | 1 | |
| »control_source | Payload Control Source | text | {"A": Control A, "B": Control B} | The side that currently holds control of this payload | r | 1 |
| »firmware_version | Payload Firmware Version | text | Firmware version of the payload device | r | 1 | |
| »psdklib_version | PSDK Library Version | text | PSDK library version of the payload | r | 1 | |
| »payload_version | Payload Version | text | Firmware version of the PSDK payload | r | 1 | |
| mode_code | Drone status | enum_int | {"0":"Standby","1":"Takeoff preparation","2":"Ready for takeoff","3":"Manual flight","4":"Automatic takeoff","5":"Waypoint flight","6":"Panorama photo","7":"Smart follow","8":"ADS-B avoidance", "9":"Automatic return","10":"Automatic landing","11":"Forced landing","12":"Three propeller landing","13":"Upgrading","14":"Not connected","15":"APAS","16":"Virtual joystick mode", "17":"Rectangle","18":"Polygon","19":"Tilt photography","20":"Reserved","21":"Precision shooting","22":"Time-lapse photography","23":"Orbit","25":"Spiral","26":"Ultra HD", "27":"Intelligent transmission marking mode","28":"Infrared tracking","29":"Intelligent mission waypoint flight","30":"Intelligent mission polygon terrain following","31":"Intelligent mission single orbit","32":"Panorama smart detection","33":"Security smart detection", "34":"GPS escape mode","35":"Abnormal mode state (when planner process crashes)","36":"Swarm formation mode","37":"Quick task","38":"Modeling ring mode","39":"KML waypoint mode", "40":"Area search", "71":"Tracking - target detection", "72":"Tracking - gimbal lock", "73":"Tracking - orbit tracking"} | Current aircraft flight status code | r | 0 |
| distance_limit_status | Drone distance limit status | struct | Overall status of the aircraft distance limit function | rw | 0 | |
| »state | Distance limit enabled | enum_int | {"0":"Not set","1":"Set"} | Distance limit switch status | 0 | |
| »distance_limit | Distance limit | int | {"max":"8000","min":"15","step":"1","unit_name":"meters / m"} | Maximum flight distance setting | 0 | |
| »is_near_distance_limit | Approaching the set distance limit | enum_int | {"0":"Not reached","1":"Approaching limit"} | Whether the aircraft is approaching the distance limit | r | 0 |
| cameras | Drone camera information | array | {"size": -, "item_type": struct} | List of current aircraft camera statuses | r | 0 |
| »[array_item] | Elements in array | struct | Individual camera information | |||
| »»payload_index | Payload index | text | 10902-0-0 | Payload index, camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, refer to the product support page | r | 0 |
| »»camera_mode | Camera mode | enum_int | {"0":"Photo","1":"Video"} | Camera mode | r | 0 |
| »»zoom_factor | Zoom factor | float | {"max":160,"min":1} | Current zoom lens magnification | r | 0 |
| »»wide_factor | Wide-angle zoom factor | float | {"max":160,"min":1} | Current wide-angle lens zoom factor | r | 0 |
| »»night_factor | Night vision zoom factor | float | {"max":160,"min":1} | Current night vision lens zoom factor | r | 0 |
| »»ir_zoom_factor | Infrared zoom factor | float | {"max":16,"min":1} | Current infrared lens zoom factor | r | 0 |
| »»photo_storage_settings | Photo storage capabilities | String in array | {"zoom": Zoom, "wide": Wide-angle, "ir": Infrared, "NightVision": Night vision } | List of lens types that support photo capture | 0 | |
| »»video_storage_settings | Video storage capabilities | String in array | {"zoom": Zoom, "wide": Wide-angle, "ir": Infrared, "NightVision": Night vision } | List of lens types that support video recording | 0 | |
| »»photo_state | Photo state | enum_int | {"0":"Idle","1":"Working"} | Current photo capture status of the camera | r | 0 |
| »»record_time | Current recording duration | int | {"unit_name":"seconds / s"} | Duration of the current video being recorded | r | 0 |
| »»recording_state | Recording state | enum_int | {"0":"Idle","1":"Working"} | Current video recording status of the camera | r | 0 |
| »»remain_photo_num | Remaining photo count | long | Remaining photo capacity on storage card | r | 0 | |
| »»remain_record_duration | Remaining recording duration | int | {"unit_name":"seconds / s"} | Remaining recording duration on storage card | r | 0 |
| »»screen_split_enable | Screen split toggle | int | {"0":"Off","1":"On"} | Screen split display toggle status | r | 0 |
| »»ir_metering_mode | Infrared metering mode | int | {"0":"Metering off","1":"Spot metering","2":"Area metering"} | Operating mode of the infrared camera temperature metering function | r | 0 |
| »»ir_metering_point | Infrared spot metering data | struct | Data available when ir_metering_mode == 1 | r | 0 | |
| »»»x | Metering point X coordinate | double | Normalized X coordinate of the spot metering target | r | 0 | |
| »»»y | Metering point Y coordinate | double | Normalized Y coordinate of the spot metering target | r | 0 | |
| »»»temperature | Metering point temperature | double | Temperature value of the spot metering target | r | 0 | |
| »»ir_metering_area | Infrared area metering data | struct | Data available when ir_metering_mode == 2 | r | 0 | |
| »»»x | Metering area X coordinate | double | Normalized X coordinate of the area metering top-left corner | r | 0 | |
| »»»y | Metering area Y coordinate | double | Normalized Y coordinate of the area metering top-left corner | r | 0 | |
| »»»width | Metering area width | double | Normalized width of the area metering region | r | 0 | |
| »»»height | Metering area height | double | Normalized height of the area metering region | r | 0 | |
| »»»aver_temperature | Average temperature of the area | double | Average temperature within the area metering region | r | 0 | |
| »»»min_temperature_point | Minimum temperature point | struct | Location and value of the minimum temperature in the area | r | 0 | |
| »»»»x | X coordinate | double | Normalized X coordinate of the minimum temperature point | r | 0 | |
| »»»»y | Y coordinate | double | Normalized Y coordinate of the minimum temperature point | r | 0 | |
| »»»»temperature | Temperature | double | Minimum temperature value in the area | r | 0 | |
| »»»max_temperature_point | Maximum temperature point | struct | Location and value of the maximum temperature in the area | r | 0 | |
| »»»»x | X coordinate | double | Normalized X coordinate of the maximum temperature point | r | 0 | |
| »»»»y | Y coordinate | double | Normalized Y coordinate of the maximum temperature point | r | 0 | |
| »»»»temperature | Temperature | double | Maximum temperature value in the area | r | 0 | |
| »»zoom_fov_h | Zoom horizontal field of view | float | Horizontal FOV of the zoom lens | r | 0 | |
| »»zoom_fov_v | Zoom vertical field of view | float | Vertical FOV of the zoom lens | r | 0 | |
| »»zoom_focal_length | Zoom focal length | float | Current focal length of the zoom lens | r | 0 | |
| »»wide_fov_h | Wide-angle horizontal field of view | float | Horizontal FOV of the wide-angle lens | r | 0 | |
| »»wide_fov_v | Wide-angle vertical field of view | float | Vertical FOV of the wide-angle lens | r | 0 | |
| »»wide_focal_length | Wide-angle focal length | float | Current focal length of the wide-angle lens | r | 0 | |
| »»ir_fov_h | Infrared horizontal field of view | float | Horizontal FOV of the infrared lens | r | 0 | |
| »»ir_fov_v | Infrared vertical field of view | float | Vertical FOV of the infrared lens | r | 0 | |
| »»ir_focal_length | Infrared focal length | float | Current focal length of the infrared lens | r | 0 | |
| »»nightvision_fov_h | Night vision horizontal field of view | float | Horizontal FOV of the night vision lens | r | 0 | |
| »»nightvision_fov_v | Night vision vertical field of view | float | Vertical FOV of the night vision lens | r | 0 | |
| »»nightvision_focal_length | Night vision focal length | float | Current focal length of the night vision lens | r | 0 | |
| »»arm_light | Arm Light Status | int | {0: Off, 1: On} | On/off state of the arm light | r | 0 |
| »»brightness_value | Brightness Value | int | Brightness of the visible-light image | r | 0 | |
| »»defog_mode | Defog Mode | int | {0: Off, 1: On} | Camera defog switch | r | 0 |
| »»gimbal_dehaze_enable | Gimbal Dehaze Enable | int | {0: Off, 1: On} | Gimbal-side dehaze enhancement switch | r | 0 |
| »»exposure_compensation | Exposure Compensation | int | Current exposure compensation step | r | 0 | |
| »»min_exposure_compensation | Min Exposure Compensation | int | Lower bound of exposure compensation | r | 0 | |
| »»max_exposure_compensation | Max Exposure Compensation | int | Upper bound of exposure compensation | r | 0 | |
| »»linkage_zoom_mode | Linkage Zoom Mode | int | {0: Off, 1: On} | Multi-lens linked zoom switch | r | 0 |
| »»ultra_pixel_mode | Ultra Pixel Mode | int | {0: Off, 1: On} | Ultra-resolution photo mode switch | r | 0 |
| »»video_encode_settings | Video Encode Settings | int | {0: H264, 1: H265} | Current video encoding format | r | 0 |
| »»video_format_settings | Video Format Settings | int | {0: MOV, 1: MP4, 2: TIFF} | Current video container format | r | 0 |
| »»video_subtitle_mode | Video Subtitle Mode | int | {0: Off, 1: On} | Video subtitle overlay switch | r | 0 |
| »»zoom_focus_mode | Zoom Focus Mode | enum_int | {1: Auto Focus (AF), 2: Manual Focus (MF)} | Focus mode of the zoom lens | r | 0 |
| »»zoom_focus_value | Zoom Focus Value | int | Current focus position of the zoom lens | r | 0 | |
| »»zoom_iso_mode | Zoom ISO Mode | int | {0: Auto, 1: Manual} | ISO control mode of the zoom lens | r | 0 |
| »»zoom_iso | Zoom ISO | int | Current ISO of the zoom lens | r | 0 | |
| »»zoom_shutter_mode | Zoom Shutter Mode | int | {0: Auto, 1: Manual} | Shutter control mode of the zoom lens | r | 0 |
| »»zoom_shutter_speed | Zoom Shutter Speed | float | {"unit_name":"seconds / s"} | Current shutter time of the zoom lens | r | 0 |
| »»zoom_white_balance_mode | Zoom White Balance Mode | int | {0: Auto, 1: Manual} | White balance mode of the zoom lens | r | 0 |
| »»zoom_white_balance_value | Zoom White Balance Value | int | {"unit_name":"Kelvin / K"} | Current white balance color temperature of the zoom lens | r | 0 |
| »»thermal_fusion_enable | Thermal Fusion Enable | int | {0: Off, 1: On} | Thermal and visible-light image fusion switch | r | 0 |
| »»thermal_super_resolution | Thermal Super Resolution | int | {0: Off, 1: On} | Thermal image super-resolution switch | r | 0 |
| »»thermal_gain_mode | Thermal Gain Mode | int | {1: High gain, 2: Low gain} | Thermal metering gain level | r | 0 |
| »»thermal_emissivity | Thermal Emissivity | int | {"max":100,"min":1} | Range 1-100; actual emissivity = value / 100 | r | 0 |
| »»thermal_image_mode | Thermal Image Mode | int | Display mode of the thermal image | r | 0 | |
| »»thermal_image_brightness | Thermal Image Brightness | int | Brightness of the thermal image | r | 0 | |
| »»thermal_image_contrast | Thermal Image Contrast | int | Contrast of the thermal image | r | 0 | |
| »»thermal_image_enhance_mode | Thermal Image Enhance Mode | int | {0: Off, 1: On} | Thermal image detail enhancement switch | r | 0 |
| »»thermal_image_enhance_value | Thermal Image Enhance Value | int | Thermal image detail enhancement level | r | 0 | |
| »»thermal_image_setting | Thermal Image Setting | struct | Aggregated structure of the thermal image parameters above | r | 0 | |
| »»»thermal_image_enhance | Thermal Image Enhance | struct | Switch and level of thermal image enhancement | r | 0 | |
| »»»»enable | Enable | int | {0: Off, 1: On} | Image enhancement switch | r | 0 |
| »»»»value | Value | int | Image enhancement level | r | 0 | |
| »»»thermal_image_mode | Thermal Image Mode | struct | Thermal image mode with brightness and contrast | r | 0 | |
| »»»»mode | Mode | int | Thermal image display mode | r | 0 | |
| »»»»brightness | Brightness | int | Thermal image brightness | r | 0 | |
| »»»»contrast | Contrast | int | Thermal image contrast | r | 0 | |
| »»thermal_isotherm_state | Thermal Isotherm State | int | {0: Off, 1: On} | Thermal isotherm function switch | r | 0 |
| »»thermal_isotherm_lower_limit | Thermal Isotherm Lower Limit | int | {"unit_name":"Celsius / °C"} | Lower temperature bound of the isotherm | r | 0 |
| »»thermal_isotherm_upper_limit | Thermal Isotherm Upper Limit | int | {"unit_name":"Celsius / °C"} | Upper temperature bound of the isotherm | r | 0 |
| »»thermal_thermometry | Thermal Thermometry | struct | Aggregated structure of emissivity and isotherm settings | r | 0 | |
| »»»emissivity | Emissivity | int | {"max":100,"min":1} | Range 1-100; actual emissivity = value / 100 | r | 0 |
| »»»thermal_isotherm | Thermal Isotherm | struct | Isotherm type and bounds | r | 0 | |
| »»»»type | Type | int | Isotherm display type | r | 0 | |
| »»»»low | Low | int | {"unit_name":"Celsius / °C"} | Lower temperature bound | r | 0 |
| »»»»high | High | int | {"unit_name":"Celsius / °C"} | Upper temperature bound | r | 0 |
| horizontal_speed | Horizontal speed | float | {"unit_name":"meters per second / m/s"} | Current horizontal flight speed of the aircraft | r | 0 |
| vertical_speed | Vertical speed | float | {"unit_name":"meters per second / m/s"} | Current vertical flight speed of the aircraft | r | 0 |
| longitude | Current longitude | float | Current longitude of the aircraft, WGS84 coordinate system | r | 0 | |
| latitude | Current latitude | float | Current latitude of the aircraft, WGS84 coordinate system | r | 0 | |
| height | Absolute height | float | Height relative to Earth's ellipsoid, calculated as: height relative to the takeoff point + ellipsoid height of the takeoff point | r | 0 | |
| elevation | Height relative to the takeoff point | float | Flight altitude of the aircraft relative to the takeoff point | r | 0 | |
| attitude_pitch | Pitch axis angle | float | Aircraft body pitch axis angle | r | 0 | |
| attitude_roll | Roll axis angle | float | Aircraft body roll axis angle | r | 0 | |
| attitude_head | Yaw axis angle | int | Yaw axis angle relative to true north (meridian), with 0 to 6 o'clock being positive and 6 to 12 o'clock being negative | r | 0 | |
| home_distance | Distance to home point | float | Horizontal distance between the aircraft and the home point | r | 0 | |
| wind_speed | Wind speed | float | {"unit_name":"meters per second / m/s"} | Ambient wind speed at the aircraft's current position | r | 0 |
| battery | Drone battery information | struct | Overall aircraft battery information | r | 0 | |
| »capacity_percent | Remaining battery percentage | int | {"max":100,"min":0} | Combined remaining battery percentage of all batteries | r | 0 |
| »remain_flight_time | Remaining flight time | int | Unit: seconds | Estimated remaining flight time based on current battery level | r | 0 |
| »temperature | Battery Pack Temperature | float | {"unit_name":"Celsius / °C"} | Current temperature of the battery pack | r | 0 |
| »voltage | Battery Pack Voltage | float | {"unit_name":"volts / V"} | Current voltage of the battery pack | r | 0 |
| »batteries | Battery list | array | List of individual battery status information | r | 0 | |
| »»index | Battery ID | int | Position index of the battery in the aircraft body | r | 0 | |
| »»sn | Battery serial number (SN) | text | Unique battery serial number | r | 0 | |
| »»capacity_percent | Battery capacity percentage | int | {"max":100,"min":0} | Remaining battery percentage of individual battery | r | 0 |
| »»temperature | Temperature | float | {"unit_name":"Celsius / °C"} | Current battery temperature | r | 0 |
| »»voltage | Voltage | float | {"unit_name":"volts / V"} | Current battery voltage | r | 0 |
| »»loop_times | Battery cycle count | int | Battery discharge count | Full charge/discharge cycle count of the battery | r | 0 |
| »»firmware_version | Battery Firmware Version | text | Firmware version of the individual battery | r | 0 | |
| position_state | Satellite search state | struct | Overall status of the aircraft positioning system | r | 0 | |
| »coordinate_sys | RTK coordinate system | Int | {0: WGS84, 1: RTK mobile station} | Coordinate system type used by RTK positioning | r | 0 |
| »fix_sta | Fix status | Int | {0: Not fixed, 1: Fixed} | RTK positioning fix solution status | 0 | |
| »is_fixed | Is converged | enum_int | {"0":"Not started","1":"Converging","2":"Converged successfully","3":"Convergence failed"} | Whether RTK positioning has completed convergence; derived from pos_type: reported as 2 when greater than 47, otherwise 3 | r | 0 |
| »quality | Satellite quality level | enum_int | {"1":"Level 1","2":"Level 2","3":"Level 3","4":"Level 4","5":"Level 5"} | Satellite signal quality level | r | 0 |
| »rtk_inpos | Is RTK module in position | int | {0: Not in position, 1: In position} | Whether RTK module positioning is ready | r | 0 |
| »rtk_used | Is RTK positioning used | Int | {0: Not used, 1: Used} | Whether current positioning uses RTK enhancement | r | 0 |
| »rtk_hgt | RTK height | Double | Ellipsoidal height from RTK solution | r | 0 | |
| »rtk_lat | RTK latitude | Double | Latitude value from RTK solution | r | 0 | |
| »rtk_lon | RTK longitude | Double | Longitude value from RTK solution | r | 0 | |
| »gps_number | Number of GPS satellites | int | Number of currently visible GPS satellites | r | 0 | |
| »rtk_number | Number of RTK satellites | int | Number of currently visible RTK satellites | r | 0 | |
| »calibration | Calibration Status | int | Always reported as 0 in the current firmware | r | 0 | |
| »rtk_enabled | RTK Enabled | bool | {true: Enabled, false: Disabled} | RTK function switch on the aircraft side | r | 0 |
| »rtk_inpos_state | RTK In-position State | int | Always reported as 0 in the current firmware | r | 0 | |
| »rtk_report_used | RTK Reported Usage Flag | int | {0: Not used, 1: Used} | RTK usage flag reported by the flight controller; rtk_used is derived from this field together with rtk_enabled | r | 0 |
| {type-subtype-gimbalindex} | Payload index | struct | Dynamic key identical to the payload's payload_index, e.g. "10902-0-0" | r | 0 | |
| »gimbal_pitch | Gimbal pitch axis angle | double | {"max":"180","min":"-180","step":0.1,"unit_name":"degrees / °"} | Current gimbal pitch axis angle | r | 0 |
| »gimbal_roll | Gimbal roll axis angle | double | {"max":"180","min":"-180","step":0.1,"unit_name":"degrees / °"} | Current gimbal roll axis angle | r | 0 |
| »gimbal_yaw | Gimbal yaw axis angle | double | {"max":"180","min":"-180","step":0.1,"unit_name":"degrees / °"} | Current gimbal yaw axis angle | r | 0 |
| »payload_index | Payload index, format: {type-subtype-gimbalindex} | text | Index identifier of the payload device | r | 1 | |
| »zoom_factor | Zoom factor | double | Current lens zoom factor | r | 0 | |
| »thermal_current_palette_style | Palette style | enum_int | {0:White Hot, 1:Cool Hot, 2:Rainbow, 3:Enhanced Rainbow, 4:Iron Red, 5:Lava, 6:Aurora, 7:Scorching, 8:Gradient, 9:Heat Detection, (Guide IR) 30:White Hot, 31:Black Hot, 32:Rainbow1, 33:Rainbow2, 34:Iron Red, 35:Lava, 36:Arctic, 38:Medical, 39:Red Trace} | Infrared camera provides multiple palette styles for different scenarios, allowing users to select different colors for clearer target observation | rw | 0 |
| »thermal_supported_palette_styles | Supported palette styles | array | {"item":{"specs":{0:White Hot, 1:Cool Hot, 2:Rainbow, 3:Enhanced Rainbow, 4:Iron Red, 5:Lava, 6:Aurora, 7:Scorching, 8:Gradient, 9:Heat Detection, (Guide IR) 30:White Hot, 31:Black Hot, 32:Rainbow1, 33:Rainbow2, 34:Iron Red, 35:Lava, 36:Arctic, 38:Medical, 39:Red Trace},"type":"enum_int"}} | Supported styles vary by device | r | 0 |
| »gimbal_pitch_max_speed | Gimbal Pitch Max Speed | int | {"unit_name":"degrees per second / °/s"} | Maximum rotation speed of the gimbal pitch axis | r | 0 |
| »measure_target_error_state | Laser Ranging Switch | int | {0: Off, 1: On} | Laser ranging function switch, not the validity of the ranging result | r | 0 |
| »measure_target_distance | Laser Target Distance | double | {"unit_name":"meters / m"} | Target distance measured by laser ranging | r | 0 |
| »measure_target_longitude | Laser Target Longitude | double | Longitude of the laser ranging target point | r | 0 | |
| »measure_target_latitude | Laser Target Latitude | double | Latitude of the laser ranging target point | r | 0 | |
| »measure_target_altitude | Laser Target Altitude | double | {"unit_name":"meters / m"} | Absolute altitude of the laser ranging target point | r | 0 |
| »iso_support_list | Supported ISO List | array | {"item_type": struct} | ISO values supported by each lens | r | 0 |
| »»lens_type | Lens Type | text | {"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision} | Lens this capability set belongs to | r | 0 |
| »»iso_values | ISO Values | array | {"item_type": int} | List of ISO levels supported by the lens | r | 0 |
| »shutter_speed_support_list | Supported Shutter Speed List | array | {"item_type": struct} | Shutter speeds supported by each lens | r | 0 |
| »»lens_type | Lens Type | text | {"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision} | Lens this capability set belongs to | r | 0 |
| »»shutter_speed_values | Shutter Speed Values | array | {"item_type": struct} | Shutter speeds expressed as fractions | r | 0 |
| »»»numerator | Numerator | int | Numerator of the shutter speed fraction | r | 0 | |
| »»»denominator | Denominator | int | Denominator of the shutter speed fraction, e.g. 1/10000 s | r | 0 | |
| »white_balance_support_list | Supported White Balance List | array | {"item_type": struct} | White balance color temperature range supported by each lens | r | 0 |
| »»lens_type | Lens Type | text | {"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision} | Lens this capability set belongs to | r | 0 |
| »»min_value | Min Value | int | {"unit_name":"Kelvin / K"} | Lowest settable color temperature | r | 0 |
| »»max_value | Max Value | int | {"unit_name":"Kelvin / K"} | Highest settable color temperature | r | 0 |
| »»step | Step | int | Color temperature adjustment step | r | 0 | |
| »object_distance_support_list | Supported Object Distance List | array | {"item_type": struct} | Focus object distance range supported by each lens | r | 0 |
| »»lens_type | Lens Type | text | {"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision} | Lens this capability set belongs to | r | 0 |
| »»min_value | Min Value | int | {"unit_name":"meters / m"} | Closest focusable object distance | r | 0 |
| »»max_value | Max Value | int | {"unit_name":"meters / m"} | Farthest focusable object distance | r | 0 |
| »»step | Step | int | Focus distance adjustment step | r | 0 | |
| »thermal_area_temperature | Thermal Area Temperature | struct | Thermal metering region and temperature results | r | 0 | |
| »»metering_mode | Metering Mode | int | {0: Spot metering, 1: Area metering} | Thermal metering mode | r | 0 |
| »»metering_point_x | Metering Point X | double | {"max":1.0,"min":0.0} | Normalized ratio of the image width | r | 0 |
| »»metering_point_y | Metering Point Y | double | {"max":1.0,"min":0.0} | Normalized ratio of the image height | r | 0 |
| »»metering_area_x | Metering Area X | double | {"max":1.0,"min":0.0} | Normalized ratio of the image width | r | 0 |
| »»metering_area_y | Metering Area Y | double | {"max":1.0,"min":0.0} | Normalized ratio of the image height | r | 0 |
| »»metering_area_width | Metering Area Width | double | {"max":1.0,"min":0.0} | Normalized region width | r | 0 |
| »»metering_area_height | Metering Area Height | double | {"max":1.0,"min":0.0} | Normalized region height | r | 0 |
| »»max_area_temp | Max Area Temperature | double | {"unit_name":"Celsius / °C"} | Highest temperature within the metering region | r | 0 |
| »»min_area_temp | Min Area Temperature | double | {"unit_name":"Celsius / °C"} | Lowest temperature within the metering region | r | 0 |
| »»avg_area_temp | Average Area Temperature | double | {"unit_name":"Celsius / °C"} | Average temperature within the metering region | r | 0 |
| »»center_area_temp | Center Area Temperature | double | {"unit_name":"Celsius / °C"} | Temperature at the center of the metering region | r | 0 |
| »»max_temp_point_x | Max Temp Point X | double | {"max":1.0,"min":0.0} | Normalized ratio of the image width | r | 0 |
| »»max_temp_point_y | Max Temp Point Y | double | {"max":1.0,"min":0.0} | Normalized ratio of the image height | r | 0 |
| »»min_temp_point_x | Min Temp Point X | double | {"max":1.0,"min":0.0} | Normalized ratio of the image width | r | 0 |
| »»min_temp_point_y | Min Temp Point Y | double | {"max":1.0,"min":0.0} | Normalized ratio of the image height | r | 0 |
| »»touch_temp | Touch Temperature | double | Temperature at the manually touched point | r | 0 | |
| »thermal_emissivity | Thermal Emissivity | int | {"max":100,"min":1} | Range 1-100; actual emissivity = value / 100 | r | 0 |
| »thermal_gain_mode | Thermal Gain Mode | int | {1: High gain, 2: Low gain} | Thermal metering gain level | r | 0 |
| »thermal_image_mode | Thermal Image Mode | int | Display mode of the thermal image | r | 0 | |
| »thermal_image_brightness | Thermal Image Brightness | int | Brightness of the thermal image | r | 0 | |
| »thermal_image_contrast | Thermal Image Contrast | int | Contrast of the thermal image | r | 0 | |
| »thermal_image_enhance_mode | Thermal Image Enhance Mode | int | {0: Off, 1: On} | Thermal image detail enhancement switch | r | 0 |
| »thermal_image_enhance_value | Thermal Image Enhance Value | int | Thermal image detail enhancement level | r | 0 | |
| »thermal_image_setting | Thermal Image Setting | struct | Aggregated structure of the thermal image parameters above | r | 0 | |
| »»thermal_image_enhance | Thermal Image Enhance | struct | Switch and level of thermal image enhancement | r | 0 | |
| »»»enable | Enable | int | {0: Off, 1: On} | Image enhancement switch | r | 0 |
| »»»value | Value | int | Image enhancement level | r | 0 | |
| »»thermal_image_mode | Thermal Image Mode | struct | Thermal image mode with brightness and contrast | r | 0 | |
| »»»mode | Mode | int | Thermal image display mode | r | 0 | |
| »»»brightness | Brightness | int | Thermal image brightness | r | 0 | |
| »»»contrast | Contrast | int | Thermal image contrast | r | 0 | |
| »thermal_isotherm_state | Thermal Isotherm State | int | {0: Off, 1: On} | Thermal isotherm function switch | r | 0 |
| »thermal_isotherm_lower_limit | Thermal Isotherm Lower Limit | int | {"unit_name":"Celsius / °C"} | Lower temperature bound of the isotherm | r | 0 |
| »thermal_isotherm_upper_limit | Thermal Isotherm Upper Limit | int | {"unit_name":"Celsius / °C"} | Upper temperature bound of the isotherm | r | 0 |
| »thermal_thermometry | Thermal Thermometry | struct | Aggregated structure of emissivity and isotherm settings | r | 0 | |
| »»emissivity | Emissivity | int | {"max":100,"min":1} | Range 1-100; actual emissivity = value / 100 | r | 0 |
| »»thermal_isotherm | Thermal Isotherm | struct | Isotherm type and bounds | r | 0 | |
| »»»type | Type | int | Isotherm display type | r | 0 | |
| »»»low | Low | int | {"unit_name":"Celsius / °C"} | Lower temperature bound | r | 0 |
| »»»high | High | int | {"unit_name":"Celsius / °C"} | Upper temperature bound | r | 0 |
| »zoom_photo_setting | Zoom Photo Setting | struct | Photo parameters of the zoom lens | r | 0 | |
| »»photo_format | Photo Format | int | {0: JPG, 1: DNG, 2: JPG+DNG, 3: RJPEG, 4: RJPEG+TIFF, 255: Unknown} | Output file format for photos | r | 0 |
| »»photo_size | Photo Size | text | Format "WxH" | For example "4096x3072" | r | 0 |
| »zoom_video_setting | Zoom Video Setting | struct | Video parameters of the zoom lens | r | 0 | |
| »»video_resolution | Video Resolution | text | Format "WxH" | For example "4000x3000" | r | 0 |
| »»video_fps | Video FPS | int | {"unit_name":"frames per second / fps"} | Video frame rate | r | 0 |
| »thermal_photo_setting | Thermal Photo Setting | struct | Photo parameters of the thermal lens | r | 0 | |
| »»photo_format | Photo Format | int | {0: JPG, 1: DNG, 2: JPG+DNG, 3: RJPEG, 4: RJPEG+TIFF, 255: Unknown} | Output file format for photos | r | 0 |
| »»photo_size | Photo Size | text | Format "WxH" | For example "640x512" | r | 0 |
| »thermal_video_setting | Thermal Video Setting | struct | Video parameters of the thermal lens | r | 0 | |
| »»video_resolution | Video Resolution | text | Format "WxH" | For example "640x512" | r | 0 |
| »»video_fps | Video FPS | int | {"unit_name":"frames per second / fps"} | Video frame rate | r | 0 |
| activation_time | Drone activation time (unix timestamp) | int | {"unit_name":"milliseconds / ms"} | Timestamp of the aircraft's first activation | r | 0 |
| night_lights_state | Drone night light status | enum_int | {"0":"Off","1":"On"} | Night light switch status | rw | 0 |
| height_limit | Drone altitude limit | int | {"max":"1500","min":"20","step":"1","unit_name":"meters / m"} | Maximum flight altitude setting | rw | 0 |
| is_near_height_limit | Approaching the set altitude limit | enum_int | {"0":"Not reached","1":"Approaching limit"} | Whether the aircraft is approaching the altitude limit | r | 0 |
| is_near_area_limit | Approaching no-fly zone | enum_int | {"0":"Not reached","1":"Approaching limit"} | Whether the aircraft is approaching the no-fly zone | r | 0 |
| obstacle_avoidance | Drone obstacle avoidance status | struct | Overall status of the aircraft obstacle avoidance function | rw | 0 | |
| »horizon | Horizontal obstacle avoidance status | enum_int | {"0":"Off","1":"On"} | Note: Drone currently does not differentiate between obstacle types | 0 | |
| »upside | Upside obstacle avoidance status | enum_int | {"0":"Off","1":"On"} | Note: Drone currently does not differentiate between obstacle types | 0 | |
| »downside | Downside obstacle avoidance status | enum_int | {"0":"Off","1":"On"} | Note: Drone currently does not differentiate between obstacle types | 0 | |
| »horizon_safe_distance | Horizontal Safe Distance | double | {"unit_name":"meters / m"} | Horizontal braking safety distance, default 2.0 | r | 0 |
| »horizon_warn_distance | Horizontal Warning Distance | double | {"unit_name":"meters / m"} | Horizontal distance at which warning starts, default 5.0 | r | 0 |
| »upside_safe_distance | Upward Safe Distance | double | {"unit_name":"meters / m"} | Upward braking safety distance, default 1.0 | r | 0 |
| »upside_warn_distance | Upward Warning Distance | double | {"unit_name":"meters / m"} | Upward distance at which warning starts, default 5.0 | r | 0 |
| »downside_safe_distance | Downward Safe Distance | double | {"unit_name":"meters / m"} | Downward braking safety distance, default 1.0 | r | 0 |
| »downside_warn_distance | Downward Warning Distance | double | {"unit_name":"meters / m"} | Downward distance at which warning starts, default 5.0 | r | 0 |
| »landing_protection | Landing Protection | bool | {true: On, false: Off} | Ground detection protection during landing, enabled by default | r | 0 |
| total_flight_time | Cumulative flight time | Int | Unit: seconds | Historical cumulative flight time of the aircraft | r | 0 |
| total_armed_time | Cumulative time for armed flights | Int | Unit: seconds | Cumulative flight time since motor start in current session | r | 0 |
| alarm_status | Alarm status | Int | {0: No alarm, 1: Alarm} | Whether the aircraft currently has alarms | r | 0 |
| pos_type | RTK status | text | {0: No solution, 1: Position set by FIX POSITION command, 2: Not supported, 8: Doppler information exported, 16: Single point positioning, 17: Pseudorange differential solution, 18: SBAS positioning, 32: L1 float solution, 33: Ionosphere-free float solution, 34: Narrow lane float solution, 48: L1 fixed solution, 49: Wide lane fixed solution, 50: Narrow lane fixed solution, 52: Pure INS positioning solution, 53: Combined INS and single point solution, 54: Combined INS and pseudorange differential positioning, 55: Combined INS and carrier phase differential float solution, 56: Combined INS and carrier phase differential fixed solution} | RTK solution type, reported as a decimal numeric string (e.g. "21"); also duplicated under the posType key | r | 0 |
| wireless_link | Link status | struct | Aircraft wireless link status information | r | 0 | |
| »link_workmode | Link Work Mode | int | {0: SDR link only, 1: SDR and 4G fusion} | Working mode of the current wireless link | r | 0 |
| »sdr_link_state | SDR Link State | int | {0: Disconnected, 1: Connected} | SDR link state, derived from SDR signal strength | r | 0 |
| »sdr_quality | SDR Quality | int | {"max":5,"min":0} | SDR signal quality level | r | 0 |
| »4g_link_state | 4G Link State | int | {0: Disconnected, 1: Connected} | Derived from lte_status == 4 | r | 0 |
| »4g_quality | 4G Quality | int | {"max":5,"min":0} | 4G signal quality level | r | 0 |
| »4g_uav_quality | Aircraft 4G Quality | int | {"max":5,"min":0} | Same value as 4g_quality, kept for backward compatibility | r | 0 |
| »4g_sim_card_detected | 4G SIM Card Detected | int | {0: Not inserted, 1: Inserted} | Whether the 4G module detects a SIM card | r | 0 |
| »4g_sdr_fusion_state | 4G and SDR Fusion State | int | {0: Not fused, 1: Fused} | Derived from link_workmode == 1 | r | 0 |
| »cellular_uav_type | Cellular Network Type | int | {0: 4G, 1: 5G} | Cellular network type on the aircraft side | r | 0 |
| »cellular_uav_server_state | Cellular Server State | int | {0: Disconnected, 1: Connected} | Set to 1 when 4G is connected in fusion mode | r | 0 |
| »fourth_line_error_msg | 4G Link Error Message | text | Defaults to "Login Success" in fusion mode | r | 0 | |
| payload_Index | Gimbal payload | struct | Overall status of the gimbal payload | r | 0 | |
| »gimbal_pitch | Gimbal pitch angle | double | Current gimbal pitch axis angle | 0 | ||
| »gimbal_roll | Gimbal roll angle | double | Current gimbal roll axis angle | 0 | ||
| »gimbal_yaw | Gimbal yaw angle | double | Current gimbal yaw axis angle | 0 | ||
| »payload_index | Payload ID | text | Index identifier of the payload device | 0 | ||
| »zoom_factor | Zoom factor | Int | Current lens zoom factor | 0 | ||
| lte_card_is_detected | Is SIM card inserted | int | {0: No card, 1: Card inserted} | Whether the aircraft detected a SIM card | r | 0 |
| lte_signal | 44G signal | int | {0,100} | 4G module signal strength | r | 0 |
| lte_status | 4G card status | int | {0: Does not support LTE module, 1: Off, 2: Not connected, 3: Connected but network unreachable, 4: Connected} | 4G module connection status | r | 0 |
| remote_id_status | Remote ID operational status | int | {0: Off, 1: On, 2: Self-check abnormal} | Remote ID broadcast module operational status | r | 0 |
| control_source | Current control source | text | The side currently controlling the aircraft; in the current firmware it is mapped from the aircraft running mode: Normal reports "A", all other modes report "B" | r | 1 | |
| ai_enable_func | AI function enable status | int | {0: Off, 1: On} | AI intelligent recognition function switch status | r | 0 |
| country | Country code | text | ISO code of the country or region where the aircraft is located | r | 0 | |
| gear_level | Gear level | int | {0: Unknown, 1: Smooth, 2: Normal, 3: Sport, 4: Low speed} | Current flight gear level of the aircraft | rw | 0 |
| gimbal_angle_follow_toggle | Gimbal angle follow toggle | int | {0: Off, 1: On} | Whether gimbal yaw angle follows the aircraft heading | r | 0 |
| hae | Ellipsoidal height | double | Height above WGS84 ellipsoid | r | 0 | |
| infrared_palette_mode | Infrared palette mode | int | {0: White hot, 1: Cool hot, 2: Rainbow, 3: Enhanced rainbow, 4: Iron red, 5: Lava, 6: Aurora, 7: Scorching, 8: Gradient, 9: Heat detection, (Gode IR) 30: White hot, 31: Black hot, 32: Rainbow 1, 33: Rainbow 2, 34: Iron red, 35: Lava, 36: Arctic, 38: Medical, 39: Red outline} | Current palette mode used by the infrared camera | rw | 0 |
| measure_target_error_state | Laser ranging status | int | {0: Off, 1: On} | Operational status of the laser rangefinding module | r | 0 |
| measure_target_distance | Laser ranging distance | double | Unit: meters (data available when measure_target_error_state == 1) | Target distance from laser rangefinding | r | 0 |
| measure_target_longitude | Laser ranging target longitude | double | Data available when measure_target_error_state == 1 | Target longitude calculated by laser rangefinding | r | 0 |
| measure_target_latitude | Laser ranging target latitude | double | Data available when measure_target_error_state == 1 | Target latitude calculated by laser rangefinding | r | 0 |
| measure_target_altitude | Laser ranging target altitude | double | Data available when measure_target_error_state == 1 | Target altitude calculated by laser rangefinding | r | 0 |
| main_mode | Aircraft flight mode | int | {0: Unknown, 1: Attitude mode, 2: GNSS mode, 3: IOC (deprecated), 4: Vision positioning} | Current flight positioning mode of the aircraft | r | 0 |
| ned_altitude | NED coordinate altitude | double | Altitude value in NED coordinate system | r | 0 | |
| ned_latitude | NED coordinate latitude | double | Latitude value in NED coordinate system | r | 0 | |
| ned_longitude | NED coordinate longitude | double | Longitude value in NED coordinate system | r | 0 | |
| vel_ned_x | NED coordinate X velocity (northward) | float | Northward velocity component in NED coordinate system | r | 0 | |
| vel_ned_y | NED coordinate Y velocity (eastward) | float | Eastward velocity component in NED coordinate system | r | 0 | |
| vel_ned_z | NED coordinate Z velocity (downward) | float | Vertical velocity component in NED coordinate system | r | 0 | |
| ntrip_status | NTRIP module status | text | {"normal": Normal, "error": Error} | NTRIP differential module status, reported as a string rather than an integer enum | r | 0 |
| storage | Storage information | struct | Aircraft onboard storage capacity information | r | 0 | |
| »storage_type | Storage type | int | {0: SD card, 1: MMC} | Storage media type | 0 | |
| »total | Total capacity | int | Total storage capacity | 0 | ||
| »used | Used capacity | int | Used storage capacity | 0 | ||
| »current_used | Currently Used | int | {0: Not in use, 1: In use} | Storage medium the camera is currently writing to | r | 0 |
| out_of_control_action | RC disconnection action | int | {"0":"Return to home", "1":"Hover", "2":"Landing"} | Action taken by the aircraft when remote controller signal is lost | rw | 0 |
| exit_wayline_when_rc_lost | Wayline RC lost action | int | {"0":"Continue wayline task", "1":"Exit wayline task, perform RC lost action"} | Action taken when remote controller is lost during wayline execution | rw | 0 |
| rth_altitude | Return to home altitude | int | Flight altitude of the aircraft during return to home (RTH) | rw | 0 | |
| rc_lost_action | RC lost action | enum_int | {"0":"Hover","1":"Landing","2":"Return to home"} | Safety action performed by the aircraft when remote controller is lost | r | 0 |
| intelligent_lock_mode | Intelligent lock mode | int | {"0":"Not in intelligent lock mode","1":"In intelligent lock mode"} | Whether the aircraft is in intelligent lock mode | r | 0 |
| manual_ctrl_gimbal | Manual gimbal control during wayline | int | {"0":"Manual gimbal control not supported","1":"Manual gimbal control supported"} | Whether manual gimbal control is allowed during wayline execution | rw | 0 |
| firmware_version | Drone firmware version | text | Current firmware version of the aircraft | r | 0 | |
| sn | Drone serial number (SN) | text | Unique serial number of the aircraft | r | 0 | |
| sdcard_storage | SD card storage information | struct | SD card storage capacity information | r | 0 | |
| »storage_type | Storage type | int | {0: SD card, 1: MMC} | Storage media type | r | 0 |
| »total | Total capacity | int | {"unit_name":"KB"} | Total SD card capacity | r | 0 |
| »used | Used capacity | int | {"unit_name":"KB"} | Used SD card capacity | r | 0 |
| »current_used | Currently Used | int | {0: Not in use, 1: In use} | Storage medium the camera is currently writing to | r | 0 |
| speaker | Speaker state | struct | Only reported when speaker is attached | r | 0 | |
| »work_mode | Work mode | int | {1: Default mode} | Current operating mode of the speaker | r | 0 |
| psdk_widget_values | PSDK payload widget values | array | {"item_type": struct} | Only reported when PSDK payload is attached | r | 0 |
| »psdkIndex | Payload index | int | Index number of the PSDK payload on the aircraft body | r | 0 | |
| »psdkName | Payload name | text | PSDK payload device name | r | 0 | |
| »psdkSn | Payload serial number | text | PSDK payload device serial number | r | 0 | |
| »psdkVersion | Payload firmware version | text | PSDK payload firmware version | r | 0 | |
| »psdkLibVersion | PSDK library version | text | PSDK library version | r | 0 | |
| »speaker | Speaker status | struct | PSDK payload speaker module status | r | 0 | |
| »»workMode | Work mode | int | {0: TTS payload mode, 1: Recording broadcast} | Speaker operating mode | r | 0 |
| »»playMode | Play mode | int | {0: Single play, 1: Loop play (single track)} | Audio playback mode | r | 0 |
| »»playVolume | Play volume | int | {"max":100,"min":0} | Speaker playback volume | r | 0 |
| »»systemState | Speaker system state | int | Speaker system running status | r | 0 | |
| »»playFileName | Play file name | text | Currently playing audio file name | r | 0 | |
| »»playFileMd5 | Play file MD5 | text | MD5 checksum of the currently playing file | r | 0 | |
| »»realTimeSpeakingStatus | Real-time speaking status | int | {0: Not speaking, 1: Speaking} | Whether real-time speaking is in progress | r | 0 |
| »lightStatus | Searchlight status | struct | PSDK payload searchlight module status | r | 0 | |
| »»switchStatus | Switch status | int | {0: Off, 1: On} | Searchlight switch status | r | 0 |
| »»flashMode | Flash mode | int | Searchlight flash mode | r | 0 | |
| »»brightnessLevel | Brightness level | int | Searchlight brightness level | r | 0 | |
| »»pitchEngle | Pitch angle | int | Searchlight pitch angle | r | 0 | |
| »»pztLinkedStatus | PZT linked status | int | Searchlight PZT linked status | r | 0 | |
| rid_state | Remote ID state | int | {0: Off, 1: On, 2: Self-check abnormal} | Remote ID broadcast module operational status | r | 0 |
| laser_distance_data | Laser ranging data | struct | Measurement results of the laser rangefinding module | r | 0 | |
| »laser_distance_is_valid | Whether laser ranging is valid | int | {0: Invalid, 1: Valid} | Whether laser rangefinding data is valid | r | 0 |
| »laser_distance | Laser ranging distance | int | {"unit_name":"centimeters / cm"} | Distance value from laser rangefinding | r | 0 |
| live_fps_stats | Live stream frame rate statistics | struct | Livestream frame rate statistics | r | 0 | |
| »recv_frame_stats | Receive frame statistics | array | {"item_type": struct} | Receiver frame rate statistics list | r | 0 |
| »»fps_video_type | Video type | text | Video stream type identifier | r | 0 | |
| »»lag_count | Lag frame count | int | Number of lag frames within the statistics period | r | 0 | |
| »»fps_count | Frame count | int | Total frame count within the statistics period | r | 0 | |
| »send_frame_stats | Send frame statistics | array | {"item_type": struct} | Sender frame rate statistics list | r | 0 |
| »»fps_video_type | Video type | text | Video stream type identifier | r | 0 | |
| »»lag_count | Lag frame count | int | Number of lag frames within the statistics period | r | 0 | |
| »»fps_count | Frame count | int | Total frame count within the statistics period | r | 0 | |
| home_latitude | Home Point Latitude | double | Latitude of the return-to-home point, WGS84 | r | 0、1 | |
| home_longitude | Home Point Longitude | double | Longitude of the return-to-home point, WGS84 | r | 0、1 | |
| home_distance_lat | Home Latitude Delta | double | (current latitude - home latitude) × 1e7, computed by the dock | r | 0 | |
| home_distance_lon | Home Longitude Delta | double | (current longitude - home longitude) × 1e7, computed by the dock | r | 0 | |
| coor_distance_to_home | Coordinate Distance to Home | double | {"unit_name":"meters / m"} | Computed by the dock using the Haversine formula | r | 0 |
| posType | RTK Solution Type (compatibility key) | text | Identical to pos_type; camelCase key kept for backward compatibility | r | 0 | |
| active_zoom_control | Active Zoom Control | int | {0: Inactive, 1: Active} | Whether zoom control is active | r | 0 |
| compatible_status | Compatible Status | int | Always reported as 0 in the current firmware | r | 0 | |
| navigation_project_enable | Navigation Project Enable | int | {0: Off, 1: On} | Field is omitted when the cache holds no value | rw | 0 |
| total_flight_sorties | Total Flight Sorties | int | Cumulative number of flights since manufacture; omitted when the cached value is -1 | r | 0 | |
| track_type | Track Type | int | {0: Not tracking, 1: Tracking} | Set to 1 in intelligent lock mode when the tracking state is TRACKING; works together with intelligent_lock_mode | r | 0 |
| uom_state | UOM Registration State | int | {0: Not registered, 1: Registered} | Derived from a flight controller status bit; omitted when the cache holds no value | r | 0 |
| user_hide_mode | User Hide Mode | int | {0: Off, 1: On} | User privacy hiding mode switch | rw | 0 |
| track_setting | Track Setting | struct | Distance and altitude parameters for intelligent tracking | rw | 0 | |
| »obstacle_avoidance | Obstacle Avoidance | int | {0: Off, 1: On} | Obstacle avoidance switch during tracking | r | 0 |
| »horizontal_distance | Horizontal Distance | int | {"max":100,"min":10,"unit_name":"meters / m"} | Omitted when outside the valid range | r | 0 |
| »vertical_distance | Vertical Distance | int | {"max":100,"min":10,"unit_name":"meters / m"} | Omitted when outside the valid range | r | 0 |
| »orbit_height | Orbit Height | int | {"max":100,"min":10,"unit_name":"meters / m"} | Omitted when outside the valid range | r | 0 |
| camera_watermark_settings | Camera Watermark Settings | struct | Watermark overlay configuration for photos and videos | rw | 0 | |
| »global_enable | Global Enable | int | {0: Off, 1: On} | Master switch for the watermark function | r | 0 |
| »drone_type_enable | Drone Type Enable | int | {0: Off, 1: On} | Whether to overlay the aircraft model | r | 0 |
| »drone_sn_enable | Drone SN Enable | int | {0: Off, 1: On} | Whether to overlay the aircraft serial number | r | 0 |
| »datetime_enable | Datetime Enable | int | {0: Off, 1: On} | Whether to overlay the capture date and time | r | 0 |
| »gps_enable | GPS Enable | int | {0: Off, 1: On} | Whether to overlay the capture location | r | 0 |
| »user_custom_string_enable | User Custom String Enable | int | {0: Off, 1: On} | Whether to overlay a user-defined string | r | 0 |
| »layout | Layout | int | Placement of the watermark within the frame | r | 0 | |
| dongle_infos | Dongle Information | array | {"item_type": struct} | LTE module and SIM card information on the aircraft side; omitted when the cache is empty | r | 0、1 |
| »dongle_type | Dongle Type | int | {0: Built-in, 1: External dongle} | How the cellular module is attached | r | 0、1 |
| »imei | IMEI | text | Always an empty string in the current firmware; not provided by the SDK | r | 0、1 | |
| »eid | eSIM EID | text | EID identifier of the eSIM | r | 0、1 | |
| »esim_activate_state | eSIM Activation State | int | {0: Unknown, 1: eSIM detected but no enabled profile, 2: An enabled profile exists} | Profile activation state of the eSIM | r | 0、1 |
| »esim_infos | eSIM Information List | array | {"item_type": struct} | List of eSIM profiles written to the module | r | 0、1 |
| »»telecom_operator | Telecom Operator | int | {0: Unknown, 1: China Mobile, 2: China Unicom, 3: China Telecom} | Mapped from the PLMN | r | 0、1 |
| »»enabled | Enabled | bool | {true: Enabled, false: Disabled} | Whether this profile is currently active | r | 0、1 |
| »»iccid | ICCID | text | ICCID of the eSIM profile | r | 0、1 | |
| »sim_card_state | SIM Card State | int | {0: Not inserted, 1: Inserted} | Presence of the physical SIM card | r | 0、1 |
| »sim_slot | SIM Slot | int | {0: Unknown, 1: Physical SIM, 2: eSIM} | Currently active slot type | r | 0、1 |
| »sim_info | SIM Information | struct | Operator and ICCID of the physical SIM card | r | 0、1 | |
| »»iccid | ICCID | text | ICCID of the physical SIM card | r | 0、1 | |
| »»sim_type | SIM Type | int | Always 0 (unknown) in the current firmware; not provided by the SDK | r | 0、1 | |
| »»telecom_operator | Telecom Operator | int | {0: Unknown, 1: China Mobile, 2: China Unicom, 3: China Telecom} | Mapped from the PLMN | r | 0、1 |
| camera_settings | Camera Settings | array | {"item_type": struct} | Current photo and video parameters of each lens | r | 1 |
| »camera_type | Camera Type | text | {"zoom": Zoom, "ir": Infrared} | Lens this parameter set belongs to | r | 1 |
| »photo_format | Photo Format | int | {0: JPG, 1: DNG, 2: JPG+DNG, 3: RJPEG, 4: RJPEG+TIFF, 255: Unknown} | Output file format for photos | r | 1 |
| »photo_size | Photo Size | text | Format "WxH" | For example "4096x3072"; a string rather than an enum | r | 1 |
| »video_resolution | Video Resolution | text | Format "WxH" | For example "4000x3000"; a string rather than an enum | r | 1 |
| »video_fps | Video FPS | int | {"unit_name":"frames per second / fps"} | Reported only when greater than 0 | r | 1 |
| current_firmware_version | Current Firmware Version | array | {"item_type": struct} | Version information of each aircraft component; omitted when the cache is empty | r | 1 |
| »component_id | Component ID | text | For example PLATFORM_SKYLINK / PLATFORM_VISION / GPS / FCS / CAMERA / GIMBAL / BATTERY / ESC1 / ESC2 / RADAR / SYSTEM_PACK; unmapped components are reported as UNKNOWN_{numeric id} | r | 1 | |
| »component_type | Component Type | text | For example TARGET_FCS / TARGET_CAMERA / TARGET_GIMBAL / TARGET_BATTERY / TARGET_ESC / TARGET_RADAR / FCS_GATEWAY / SYSTEM_PACK; unmapped components are reported as UNKNOWN_{numeric id} | r | 1 | |
| »component_model | Component Model | int | Numeric component model | r | 1 | |
| »str_component_model | Component Model (string) | text | String representation of the component model | r | 1 | |
| »component_sn | Component SN | text | Unique serial number of the component | r | 1 | |
| »software_version | Software Version | text | Format V{major}.{minor}.{patch}.{build} | Current software version of the component | r | 1 |
| »hardware_version | Hardware Version | text | Hardware version of the component | r | 1 | |
| »bootloader_version | Bootloader Version | text | Bootloader version of the component | r | 1 | |
| »label | Label | text | Label information of the component | r | 1 | |
| »data_source | Data Source | int | {0: Passively reported by version message, 1: Actively queried} | How this version record was obtained | r | 1 |
| locked | Aircraft Locked | bool | {true: Locked, false: Unlocked} | Always false in the current firmware | r | 1 |
| low_battery_warning_enable | Low Battery Warning Enable | int | {0: Off, 1: On} | Smart low-battery return switch; omitted when the cache holds no value | rw | 1 |
| low_battery_warning_threshold | Low Battery Warning Threshold | int | {"max":100,"min":0,"unit_name":"percent / %"} | Remaining capacity at which the low-battery warning triggers | rw | 1 |
| serious_low_battery_warning_threshold | Serious Low Battery Warning Threshold | int | {"max":100,"min":0,"unit_name":"percent / %"} | Remaining capacity at which the critical low-battery warning triggers | rw | 1 |
Payload Report
Topic: thing/product/{device_sn}/state
Direction: up
Direction: up (Device -> Cloud)
Data:
| Column | Name | Type | Remarks |
|---|---|---|---|
| payload_list | Payload List | array | |
| »payload_id | Payload ID | int | |
| »payload_type | Payload Type | int | |
| »is_online | Online Status | int | |
| »last_active_time | Last Active Time | Long | |
| »payload_position | Payload Position | int | |
| »psdklib_version | PSDK Version | String | |
| »payload_version | Payload Version | String |
Example:
{
"bid": "6b3665e1-be0f-4c7c-86ee-e387edd668e7",
"data": {
"payloads": [{
"last_active_time": 315535819380,
"payload_id": 10001,
"payload_index": "10306-0-0",
"payload_position": 2,
"payload_version": "",
"psdklib_version": "",
"is_online": 1
}]
},
"gateway": "TH7923350808",
"tid": "c441054b-88f7-4d88-ae66-2732f803310c",
"timestamp": 1724054078099
}