跳到主要内容

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)
ColumnNameTypeconstraintDescriptionaccessModepushMode
payloadsPayload Statusarray{"size": -, "item_type": struct}List of payload devices currently mounted on the aircraftr1
»payload_indexPayload IndextextPayload index, format is {type-subtype-gimbalindex}r1
»snPayload Serial Number (SN)textUnique identifier of the payload devicer1
»payload_idPayload IDintID assigned to the payload by the agentr1
»payload_typePayload Typeint{5: Light-and-speaker combo, 6: Speaker}PSDK payload type; other values are defined by the SDKr1
»payload_positionPayload Positionint{0: Unknown, 1: Front, 2: Rear, 3: Left, 4: Right, 5: Top, 6: Bottom}Mounting position of the payload on the airframer1
»is_onlineOnline Statusint{0: Offline, 1: Online}Whether the payload is currently onliner1
»last_active_timeLast Active TimelongTimestamp of the payload's last activity; not populated for PSDK payloads in the current firmwarer1
»control_sourcePayload Control Sourcetext{"A": Control A, "B": Control B}The side that currently holds control of this payloadr1
»firmware_versionPayload Firmware VersiontextFirmware version of the payload devicer1
»psdklib_versionPSDK Library VersiontextPSDK library version of the payloadr1
»payload_versionPayload VersiontextFirmware version of the PSDK payloadr1
mode_codeDrone statusenum_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 coder0
distance_limit_statusDrone distance limit statusstructOverall status of the aircraft distance limit functionrw0
»stateDistance limit enabledenum_int{"0":"Not set","1":"Set"}Distance limit switch status0
»distance_limitDistance limitint{"max":"8000","min":"15","step":"1","unit_name":"meters / m"}Maximum flight distance setting0
»is_near_distance_limitApproaching the set distance limitenum_int{"0":"Not reached","1":"Approaching limit"}Whether the aircraft is approaching the distance limitr0
camerasDrone camera informationarray{"size": -, "item_type": struct}List of current aircraft camera statusesr0
»[array_item]Elements in arraystructIndividual camera information
»»payload_indexPayload indextext10902-0-0Payload index, camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, refer to the product support pager0
»»camera_modeCamera modeenum_int{"0":"Photo","1":"Video"}Camera moder0
»»zoom_factorZoom factorfloat{"max":160,"min":1}Current zoom lens magnificationr0
»»wide_factorWide-angle zoom factorfloat{"max":160,"min":1}Current wide-angle lens zoom factorr0
»»night_factorNight vision zoom factorfloat{"max":160,"min":1}Current night vision lens zoom factorr0
»»ir_zoom_factorInfrared zoom factorfloat{"max":16,"min":1}Current infrared lens zoom factorr0
»»photo_storage_settingsPhoto storage capabilitiesString in array{"zoom": Zoom, "wide": Wide-angle, "ir": Infrared, "NightVision": Night vision }List of lens types that support photo capture0
»»video_storage_settingsVideo storage capabilitiesString in array{"zoom": Zoom, "wide": Wide-angle, "ir": Infrared, "NightVision": Night vision }List of lens types that support video recording0
»»photo_statePhoto stateenum_int{"0":"Idle","1":"Working"}Current photo capture status of the camerar0
»»record_timeCurrent recording durationint{"unit_name":"seconds / s"}Duration of the current video being recordedr0
»»recording_stateRecording stateenum_int{"0":"Idle","1":"Working"}Current video recording status of the camerar0
»»remain_photo_numRemaining photo countlongRemaining photo capacity on storage cardr0
»»remain_record_durationRemaining recording durationint{"unit_name":"seconds / s"}Remaining recording duration on storage cardr0
»»screen_split_enableScreen split toggleint{"0":"Off","1":"On"}Screen split display toggle statusr0
»»ir_metering_modeInfrared metering modeint{"0":"Metering off","1":"Spot metering","2":"Area metering"}Operating mode of the infrared camera temperature metering functionr0
»»ir_metering_pointInfrared spot metering datastructData available when ir_metering_mode == 1r0
»»»xMetering point X coordinatedoubleNormalized X coordinate of the spot metering targetr0
»»»yMetering point Y coordinatedoubleNormalized Y coordinate of the spot metering targetr0
»»»temperatureMetering point temperaturedoubleTemperature value of the spot metering targetr0
»»ir_metering_areaInfrared area metering datastructData available when ir_metering_mode == 2r0
»»»xMetering area X coordinatedoubleNormalized X coordinate of the area metering top-left cornerr0
»»»yMetering area Y coordinatedoubleNormalized Y coordinate of the area metering top-left cornerr0
»»»widthMetering area widthdoubleNormalized width of the area metering regionr0
»»»heightMetering area heightdoubleNormalized height of the area metering regionr0
»»»aver_temperatureAverage temperature of the areadoubleAverage temperature within the area metering regionr0
»»»min_temperature_pointMinimum temperature pointstructLocation and value of the minimum temperature in the arear0
»»»»xX coordinatedoubleNormalized X coordinate of the minimum temperature pointr0
»»»»yY coordinatedoubleNormalized Y coordinate of the minimum temperature pointr0
»»»»temperatureTemperaturedoubleMinimum temperature value in the arear0
»»»max_temperature_pointMaximum temperature pointstructLocation and value of the maximum temperature in the arear0
»»»»xX coordinatedoubleNormalized X coordinate of the maximum temperature pointr0
»»»»yY coordinatedoubleNormalized Y coordinate of the maximum temperature pointr0
»»»»temperatureTemperaturedoubleMaximum temperature value in the arear0
»»zoom_fov_hZoom horizontal field of viewfloatHorizontal FOV of the zoom lensr0
»»zoom_fov_vZoom vertical field of viewfloatVertical FOV of the zoom lensr0
»»zoom_focal_lengthZoom focal lengthfloatCurrent focal length of the zoom lensr0
»»wide_fov_hWide-angle horizontal field of viewfloatHorizontal FOV of the wide-angle lensr0
»»wide_fov_vWide-angle vertical field of viewfloatVertical FOV of the wide-angle lensr0
»»wide_focal_lengthWide-angle focal lengthfloatCurrent focal length of the wide-angle lensr0
»»ir_fov_hInfrared horizontal field of viewfloatHorizontal FOV of the infrared lensr0
»»ir_fov_vInfrared vertical field of viewfloatVertical FOV of the infrared lensr0
»»ir_focal_lengthInfrared focal lengthfloatCurrent focal length of the infrared lensr0
»»nightvision_fov_hNight vision horizontal field of viewfloatHorizontal FOV of the night vision lensr0
»»nightvision_fov_vNight vision vertical field of viewfloatVertical FOV of the night vision lensr0
»»nightvision_focal_lengthNight vision focal lengthfloatCurrent focal length of the night vision lensr0
»»arm_lightArm Light Statusint{0: Off, 1: On}On/off state of the arm lightr0
»»brightness_valueBrightness ValueintBrightness of the visible-light imager0
»»defog_modeDefog Modeint{0: Off, 1: On}Camera defog switchr0
»»gimbal_dehaze_enableGimbal Dehaze Enableint{0: Off, 1: On}Gimbal-side dehaze enhancement switchr0
»»exposure_compensationExposure CompensationintCurrent exposure compensation stepr0
»»min_exposure_compensationMin Exposure CompensationintLower bound of exposure compensationr0
»»max_exposure_compensationMax Exposure CompensationintUpper bound of exposure compensationr0
»»linkage_zoom_modeLinkage Zoom Modeint{0: Off, 1: On}Multi-lens linked zoom switchr0
»»ultra_pixel_modeUltra Pixel Modeint{0: Off, 1: On}Ultra-resolution photo mode switchr0
»»video_encode_settingsVideo Encode Settingsint{0: H264, 1: H265}Current video encoding formatr0
»»video_format_settingsVideo Format Settingsint{0: MOV, 1: MP4, 2: TIFF}Current video container formatr0
»»video_subtitle_modeVideo Subtitle Modeint{0: Off, 1: On}Video subtitle overlay switchr0
»»zoom_focus_modeZoom Focus Modeenum_int{1: Auto Focus (AF), 2: Manual Focus (MF)}Focus mode of the zoom lensr0
»»zoom_focus_valueZoom Focus ValueintCurrent focus position of the zoom lensr0
»»zoom_iso_modeZoom ISO Modeint{0: Auto, 1: Manual}ISO control mode of the zoom lensr0
»»zoom_isoZoom ISOintCurrent ISO of the zoom lensr0
»»zoom_shutter_modeZoom Shutter Modeint{0: Auto, 1: Manual}Shutter control mode of the zoom lensr0
»»zoom_shutter_speedZoom Shutter Speedfloat{"unit_name":"seconds / s"}Current shutter time of the zoom lensr0
»»zoom_white_balance_modeZoom White Balance Modeint{0: Auto, 1: Manual}White balance mode of the zoom lensr0
»»zoom_white_balance_valueZoom White Balance Valueint{"unit_name":"Kelvin / K"}Current white balance color temperature of the zoom lensr0
»»thermal_fusion_enableThermal Fusion Enableint{0: Off, 1: On}Thermal and visible-light image fusion switchr0
»»thermal_super_resolutionThermal Super Resolutionint{0: Off, 1: On}Thermal image super-resolution switchr0
»»thermal_gain_modeThermal Gain Modeint{1: High gain, 2: Low gain}Thermal metering gain levelr0
»»thermal_emissivityThermal Emissivityint{"max":100,"min":1}Range 1-100; actual emissivity = value / 100r0
»»thermal_image_modeThermal Image ModeintDisplay mode of the thermal imager0
»»thermal_image_brightnessThermal Image BrightnessintBrightness of the thermal imager0
»»thermal_image_contrastThermal Image ContrastintContrast of the thermal imager0
»»thermal_image_enhance_modeThermal Image Enhance Modeint{0: Off, 1: On}Thermal image detail enhancement switchr0
»»thermal_image_enhance_valueThermal Image Enhance ValueintThermal image detail enhancement levelr0
»»thermal_image_settingThermal Image SettingstructAggregated structure of the thermal image parameters abover0
»»»thermal_image_enhanceThermal Image EnhancestructSwitch and level of thermal image enhancementr0
»»»»enableEnableint{0: Off, 1: On}Image enhancement switchr0
»»»»valueValueintImage enhancement levelr0
»»»thermal_image_modeThermal Image ModestructThermal image mode with brightness and contrastr0
»»»»modeModeintThermal image display moder0
»»»»brightnessBrightnessintThermal image brightnessr0
»»»»contrastContrastintThermal image contrastr0
»»thermal_isotherm_stateThermal Isotherm Stateint{0: Off, 1: On}Thermal isotherm function switchr0
»»thermal_isotherm_lower_limitThermal Isotherm Lower Limitint{"unit_name":"Celsius / °C"}Lower temperature bound of the isothermr0
»»thermal_isotherm_upper_limitThermal Isotherm Upper Limitint{"unit_name":"Celsius / °C"}Upper temperature bound of the isothermr0
»»thermal_thermometryThermal ThermometrystructAggregated structure of emissivity and isotherm settingsr0
»»»emissivityEmissivityint{"max":100,"min":1}Range 1-100; actual emissivity = value / 100r0
»»»thermal_isothermThermal IsothermstructIsotherm type and boundsr0
»»»»typeTypeintIsotherm display typer0
»»»»lowLowint{"unit_name":"Celsius / °C"}Lower temperature boundr0
»»»»highHighint{"unit_name":"Celsius / °C"}Upper temperature boundr0
horizontal_speedHorizontal speedfloat{"unit_name":"meters per second / m/s"}Current horizontal flight speed of the aircraftr0
vertical_speedVertical speedfloat{"unit_name":"meters per second / m/s"}Current vertical flight speed of the aircraftr0
longitudeCurrent longitudefloatCurrent longitude of the aircraft, WGS84 coordinate systemr0
latitudeCurrent latitudefloatCurrent latitude of the aircraft, WGS84 coordinate systemr0
heightAbsolute heightfloatHeight relative to Earth's ellipsoid, calculated as: height relative to the takeoff point + ellipsoid height of the takeoff pointr0
elevationHeight relative to the takeoff pointfloatFlight altitude of the aircraft relative to the takeoff pointr0
attitude_pitchPitch axis anglefloatAircraft body pitch axis angler0
attitude_rollRoll axis anglefloatAircraft body roll axis angler0
attitude_headYaw axis angleintYaw axis angle relative to true north (meridian), with 0 to 6 o'clock being positive and 6 to 12 o'clock being negativer0
home_distanceDistance to home pointfloatHorizontal distance between the aircraft and the home pointr0
wind_speedWind speedfloat{"unit_name":"meters per second / m/s"}Ambient wind speed at the aircraft's current positionr0
batteryDrone battery informationstructOverall aircraft battery informationr0
»capacity_percentRemaining battery percentageint{"max":100,"min":0}Combined remaining battery percentage of all batteriesr0
»remain_flight_timeRemaining flight timeintUnit: secondsEstimated remaining flight time based on current battery levelr0
»temperatureBattery Pack Temperaturefloat{"unit_name":"Celsius / °C"}Current temperature of the battery packr0
»voltageBattery Pack Voltagefloat{"unit_name":"volts / V"}Current voltage of the battery packr0
»batteriesBattery listarrayList of individual battery status informationr0
»»indexBattery IDintPosition index of the battery in the aircraft bodyr0
»»snBattery serial number (SN)textUnique battery serial numberr0
»»capacity_percentBattery capacity percentageint{"max":100,"min":0}Remaining battery percentage of individual batteryr0
»»temperatureTemperaturefloat{"unit_name":"Celsius / °C"}Current battery temperaturer0
»»voltageVoltagefloat{"unit_name":"volts / V"}Current battery voltager0
»»loop_timesBattery cycle countintBattery discharge countFull charge/discharge cycle count of the batteryr0
»»firmware_versionBattery Firmware VersiontextFirmware version of the individual batteryr0
position_stateSatellite search statestructOverall status of the aircraft positioning systemr0
»coordinate_sysRTK coordinate systemInt{0: WGS84, 1: RTK mobile station}Coordinate system type used by RTK positioningr0
»fix_staFix statusInt{0: Not fixed, 1: Fixed}RTK positioning fix solution status0
»is_fixedIs convergedenum_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 3r0
»qualitySatellite quality levelenum_int{"1":"Level 1","2":"Level 2","3":"Level 3","4":"Level 4","5":"Level 5"}Satellite signal quality levelr0
»rtk_inposIs RTK module in positionint{0: Not in position, 1: In position}Whether RTK module positioning is readyr0
»rtk_usedIs RTK positioning usedInt{0: Not used, 1: Used}Whether current positioning uses RTK enhancementr0
»rtk_hgtRTK heightDoubleEllipsoidal height from RTK solutionr0
»rtk_latRTK latitudeDoubleLatitude value from RTK solutionr0
»rtk_lonRTK longitudeDoubleLongitude value from RTK solutionr0
»gps_numberNumber of GPS satellitesintNumber of currently visible GPS satellitesr0
»rtk_numberNumber of RTK satellitesintNumber of currently visible RTK satellitesr0
»calibrationCalibration StatusintAlways reported as 0 in the current firmwarer0
»rtk_enabledRTK Enabledbool{true: Enabled, false: Disabled}RTK function switch on the aircraft sider0
»rtk_inpos_stateRTK In-position StateintAlways reported as 0 in the current firmwarer0
»rtk_report_usedRTK Reported Usage Flagint{0: Not used, 1: Used}RTK usage flag reported by the flight controller; rtk_used is derived from this field together with rtk_enabledr0
{type-subtype-gimbalindex}Payload indexstructDynamic key identical to the payload's payload_index, e.g. "10902-0-0"r0
»gimbal_pitchGimbal pitch axis angledouble{"max":"180","min":"-180","step":0.1,"unit_name":"degrees / °"}Current gimbal pitch axis angler0
»gimbal_rollGimbal roll axis angledouble{"max":"180","min":"-180","step":0.1,"unit_name":"degrees / °"}Current gimbal roll axis angler0
»gimbal_yawGimbal yaw axis angledouble{"max":"180","min":"-180","step":0.1,"unit_name":"degrees / °"}Current gimbal yaw axis angler0
»payload_indexPayload index, format: {type-subtype-gimbalindex}textIndex identifier of the payload devicer1
»zoom_factorZoom factordoubleCurrent lens zoom factorr0
»thermal_current_palette_stylePalette styleenum_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 observationrw0
»thermal_supported_palette_stylesSupported palette stylesarray{"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 devicer0
»gimbal_pitch_max_speedGimbal Pitch Max Speedint{"unit_name":"degrees per second / °/s"}Maximum rotation speed of the gimbal pitch axisr0
»measure_target_error_stateLaser Ranging Switchint{0: Off, 1: On}Laser ranging function switch, not the validity of the ranging resultr0
»measure_target_distanceLaser Target Distancedouble{"unit_name":"meters / m"}Target distance measured by laser rangingr0
»measure_target_longitudeLaser Target LongitudedoubleLongitude of the laser ranging target pointr0
»measure_target_latitudeLaser Target LatitudedoubleLatitude of the laser ranging target pointr0
»measure_target_altitudeLaser Target Altitudedouble{"unit_name":"meters / m"}Absolute altitude of the laser ranging target pointr0
»iso_support_listSupported ISO Listarray{"item_type": struct}ISO values supported by each lensr0
»»lens_typeLens Typetext{"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision}Lens this capability set belongs tor0
»»iso_valuesISO Valuesarray{"item_type": int}List of ISO levels supported by the lensr0
»shutter_speed_support_listSupported Shutter Speed Listarray{"item_type": struct}Shutter speeds supported by each lensr0
»»lens_typeLens Typetext{"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision}Lens this capability set belongs tor0
»»shutter_speed_valuesShutter Speed Valuesarray{"item_type": struct}Shutter speeds expressed as fractionsr0
»»»numeratorNumeratorintNumerator of the shutter speed fractionr0
»»»denominatorDenominatorintDenominator of the shutter speed fraction, e.g. 1/10000 sr0
»white_balance_support_listSupported White Balance Listarray{"item_type": struct}White balance color temperature range supported by each lensr0
»»lens_typeLens Typetext{"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision}Lens this capability set belongs tor0
»»min_valueMin Valueint{"unit_name":"Kelvin / K"}Lowest settable color temperaturer0
»»max_valueMax Valueint{"unit_name":"Kelvin / K"}Highest settable color temperaturer0
»»stepStepintColor temperature adjustment stepr0
»object_distance_support_listSupported Object Distance Listarray{"item_type": struct}Focus object distance range supported by each lensr0
»»lens_typeLens Typetext{"zoom": Zoom, "wide": Wide, "ir": Infrared, "NightVision": Night vision}Lens this capability set belongs tor0
»»min_valueMin Valueint{"unit_name":"meters / m"}Closest focusable object distancer0
»»max_valueMax Valueint{"unit_name":"meters / m"}Farthest focusable object distancer0
»»stepStepintFocus distance adjustment stepr0
»thermal_area_temperatureThermal Area TemperaturestructThermal metering region and temperature resultsr0
»»metering_modeMetering Modeint{0: Spot metering, 1: Area metering}Thermal metering moder0
»»metering_point_xMetering Point Xdouble{"max":1.0,"min":0.0}Normalized ratio of the image widthr0
»»metering_point_yMetering Point Ydouble{"max":1.0,"min":0.0}Normalized ratio of the image heightr0
»»metering_area_xMetering Area Xdouble{"max":1.0,"min":0.0}Normalized ratio of the image widthr0
»»metering_area_yMetering Area Ydouble{"max":1.0,"min":0.0}Normalized ratio of the image heightr0
»»metering_area_widthMetering Area Widthdouble{"max":1.0,"min":0.0}Normalized region widthr0
»»metering_area_heightMetering Area Heightdouble{"max":1.0,"min":0.0}Normalized region heightr0
»»max_area_tempMax Area Temperaturedouble{"unit_name":"Celsius / °C"}Highest temperature within the metering regionr0
»»min_area_tempMin Area Temperaturedouble{"unit_name":"Celsius / °C"}Lowest temperature within the metering regionr0
»»avg_area_tempAverage Area Temperaturedouble{"unit_name":"Celsius / °C"}Average temperature within the metering regionr0
»»center_area_tempCenter Area Temperaturedouble{"unit_name":"Celsius / °C"}Temperature at the center of the metering regionr0
»»max_temp_point_xMax Temp Point Xdouble{"max":1.0,"min":0.0}Normalized ratio of the image widthr0
»»max_temp_point_yMax Temp Point Ydouble{"max":1.0,"min":0.0}Normalized ratio of the image heightr0
»»min_temp_point_xMin Temp Point Xdouble{"max":1.0,"min":0.0}Normalized ratio of the image widthr0
»»min_temp_point_yMin Temp Point Ydouble{"max":1.0,"min":0.0}Normalized ratio of the image heightr0
»»touch_tempTouch TemperaturedoubleTemperature at the manually touched pointr0
»thermal_emissivityThermal Emissivityint{"max":100,"min":1}Range 1-100; actual emissivity = value / 100r0
»thermal_gain_modeThermal Gain Modeint{1: High gain, 2: Low gain}Thermal metering gain levelr0
»thermal_image_modeThermal Image ModeintDisplay mode of the thermal imager0
»thermal_image_brightnessThermal Image BrightnessintBrightness of the thermal imager0
»thermal_image_contrastThermal Image ContrastintContrast of the thermal imager0
»thermal_image_enhance_modeThermal Image Enhance Modeint{0: Off, 1: On}Thermal image detail enhancement switchr0
»thermal_image_enhance_valueThermal Image Enhance ValueintThermal image detail enhancement levelr0
»thermal_image_settingThermal Image SettingstructAggregated structure of the thermal image parameters abover0
»»thermal_image_enhanceThermal Image EnhancestructSwitch and level of thermal image enhancementr0
»»»enableEnableint{0: Off, 1: On}Image enhancement switchr0
»»»valueValueintImage enhancement levelr0
»»thermal_image_modeThermal Image ModestructThermal image mode with brightness and contrastr0
»»»modeModeintThermal image display moder0
»»»brightnessBrightnessintThermal image brightnessr0
»»»contrastContrastintThermal image contrastr0
»thermal_isotherm_stateThermal Isotherm Stateint{0: Off, 1: On}Thermal isotherm function switchr0
»thermal_isotherm_lower_limitThermal Isotherm Lower Limitint{"unit_name":"Celsius / °C"}Lower temperature bound of the isothermr0
»thermal_isotherm_upper_limitThermal Isotherm Upper Limitint{"unit_name":"Celsius / °C"}Upper temperature bound of the isothermr0
»thermal_thermometryThermal ThermometrystructAggregated structure of emissivity and isotherm settingsr0
»»emissivityEmissivityint{"max":100,"min":1}Range 1-100; actual emissivity = value / 100r0
»»thermal_isothermThermal IsothermstructIsotherm type and boundsr0
»»»typeTypeintIsotherm display typer0
»»»lowLowint{"unit_name":"Celsius / °C"}Lower temperature boundr0
»»»highHighint{"unit_name":"Celsius / °C"}Upper temperature boundr0
»zoom_photo_settingZoom Photo SettingstructPhoto parameters of the zoom lensr0
»»photo_formatPhoto Formatint{0: JPG, 1: DNG, 2: JPG+DNG, 3: RJPEG, 4: RJPEG+TIFF, 255: Unknown}Output file format for photosr0
»»photo_sizePhoto SizetextFormat "WxH"For example "4096x3072"r0
»zoom_video_settingZoom Video SettingstructVideo parameters of the zoom lensr0
»»video_resolutionVideo ResolutiontextFormat "WxH"For example "4000x3000"r0
»»video_fpsVideo FPSint{"unit_name":"frames per second / fps"}Video frame rater0
»thermal_photo_settingThermal Photo SettingstructPhoto parameters of the thermal lensr0
»»photo_formatPhoto Formatint{0: JPG, 1: DNG, 2: JPG+DNG, 3: RJPEG, 4: RJPEG+TIFF, 255: Unknown}Output file format for photosr0
»»photo_sizePhoto SizetextFormat "WxH"For example "640x512"r0
»thermal_video_settingThermal Video SettingstructVideo parameters of the thermal lensr0
»»video_resolutionVideo ResolutiontextFormat "WxH"For example "640x512"r0
»»video_fpsVideo FPSint{"unit_name":"frames per second / fps"}Video frame rater0
activation_timeDrone activation time (unix timestamp)int{"unit_name":"milliseconds / ms"}Timestamp of the aircraft's first activationr0
night_lights_stateDrone night light statusenum_int{"0":"Off","1":"On"}Night light switch statusrw0
height_limitDrone altitude limitint{"max":"1500","min":"20","step":"1","unit_name":"meters / m"}Maximum flight altitude settingrw0
is_near_height_limitApproaching the set altitude limitenum_int{"0":"Not reached","1":"Approaching limit"}Whether the aircraft is approaching the altitude limitr0
is_near_area_limitApproaching no-fly zoneenum_int{"0":"Not reached","1":"Approaching limit"}Whether the aircraft is approaching the no-fly zoner0
obstacle_avoidanceDrone obstacle avoidance statusstructOverall status of the aircraft obstacle avoidance functionrw0
»horizonHorizontal obstacle avoidance statusenum_int{"0":"Off","1":"On"}Note: Drone currently does not differentiate between obstacle types0
»upsideUpside obstacle avoidance statusenum_int{"0":"Off","1":"On"}Note: Drone currently does not differentiate between obstacle types0
»downsideDownside obstacle avoidance statusenum_int{"0":"Off","1":"On"}Note: Drone currently does not differentiate between obstacle types0
»horizon_safe_distanceHorizontal Safe Distancedouble{"unit_name":"meters / m"}Horizontal braking safety distance, default 2.0r0
»horizon_warn_distanceHorizontal Warning Distancedouble{"unit_name":"meters / m"}Horizontal distance at which warning starts, default 5.0r0
»upside_safe_distanceUpward Safe Distancedouble{"unit_name":"meters / m"}Upward braking safety distance, default 1.0r0
»upside_warn_distanceUpward Warning Distancedouble{"unit_name":"meters / m"}Upward distance at which warning starts, default 5.0r0
»downside_safe_distanceDownward Safe Distancedouble{"unit_name":"meters / m"}Downward braking safety distance, default 1.0r0
»downside_warn_distanceDownward Warning Distancedouble{"unit_name":"meters / m"}Downward distance at which warning starts, default 5.0r0
»landing_protectionLanding Protectionbool{true: On, false: Off}Ground detection protection during landing, enabled by defaultr0
total_flight_timeCumulative flight timeIntUnit: secondsHistorical cumulative flight time of the aircraftr0
total_armed_timeCumulative time for armed flightsIntUnit: secondsCumulative flight time since motor start in current sessionr0
alarm_statusAlarm statusInt{0: No alarm, 1: Alarm}Whether the aircraft currently has alarmsr0
pos_typeRTK statustext{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 keyr0
wireless_linkLink statusstructAircraft wireless link status informationr0
»link_workmodeLink Work Modeint{0: SDR link only, 1: SDR and 4G fusion}Working mode of the current wireless linkr0
»sdr_link_stateSDR Link Stateint{0: Disconnected, 1: Connected}SDR link state, derived from SDR signal strengthr0
»sdr_qualitySDR Qualityint{"max":5,"min":0}SDR signal quality levelr0
»4g_link_state4G Link Stateint{0: Disconnected, 1: Connected}Derived from lte_status == 4r0
»4g_quality4G Qualityint{"max":5,"min":0}4G signal quality levelr0
»4g_uav_qualityAircraft 4G Qualityint{"max":5,"min":0}Same value as 4g_quality, kept for backward compatibilityr0
»4g_sim_card_detected4G SIM Card Detectedint{0: Not inserted, 1: Inserted}Whether the 4G module detects a SIM cardr0
»4g_sdr_fusion_state4G and SDR Fusion Stateint{0: Not fused, 1: Fused}Derived from link_workmode == 1r0
»cellular_uav_typeCellular Network Typeint{0: 4G, 1: 5G}Cellular network type on the aircraft sider0
»cellular_uav_server_stateCellular Server Stateint{0: Disconnected, 1: Connected}Set to 1 when 4G is connected in fusion moder0
»fourth_line_error_msg4G Link Error MessagetextDefaults to "Login Success" in fusion moder0
payload_IndexGimbal payloadstructOverall status of the gimbal payloadr0
»gimbal_pitchGimbal pitch angledoubleCurrent gimbal pitch axis angle0
»gimbal_rollGimbal roll angledoubleCurrent gimbal roll axis angle0
»gimbal_yawGimbal yaw angledoubleCurrent gimbal yaw axis angle0
»payload_indexPayload IDtextIndex identifier of the payload device0
»zoom_factorZoom factorIntCurrent lens zoom factor0
lte_card_is_detectedIs SIM card insertedint{0: No card, 1: Card inserted}Whether the aircraft detected a SIM cardr0
lte_signal44G signalint{0,100}4G module signal strengthr0
lte_status4G card statusint{0: Does not support LTE module, 1: Off, 2: Not connected, 3: Connected but network unreachable, 4: Connected}4G module connection statusr0
remote_id_statusRemote ID operational statusint{0: Off, 1: On, 2: Self-check abnormal}Remote ID broadcast module operational statusr0
control_sourceCurrent control sourcetextThe 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"r1
ai_enable_funcAI function enable statusint{0: Off, 1: On}AI intelligent recognition function switch statusr0
countryCountry codetextISO code of the country or region where the aircraft is locatedr0
gear_levelGear levelint{0: Unknown, 1: Smooth, 2: Normal, 3: Sport, 4: Low speed}Current flight gear level of the aircraftrw0
gimbal_angle_follow_toggleGimbal angle follow toggleint{0: Off, 1: On}Whether gimbal yaw angle follows the aircraft headingr0
haeEllipsoidal heightdoubleHeight above WGS84 ellipsoidr0
infrared_palette_modeInfrared palette modeint{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 camerarw0
measure_target_error_stateLaser ranging statusint{0: Off, 1: On}Operational status of the laser rangefinding moduler0
measure_target_distanceLaser ranging distancedoubleUnit: meters (data available when measure_target_error_state == 1)Target distance from laser rangefindingr0
measure_target_longitudeLaser ranging target longitudedoubleData available when measure_target_error_state == 1Target longitude calculated by laser rangefindingr0
measure_target_latitudeLaser ranging target latitudedoubleData available when measure_target_error_state == 1Target latitude calculated by laser rangefindingr0
measure_target_altitudeLaser ranging target altitudedoubleData available when measure_target_error_state == 1Target altitude calculated by laser rangefindingr0
main_modeAircraft flight modeint{0: Unknown, 1: Attitude mode, 2: GNSS mode, 3: IOC (deprecated), 4: Vision positioning}Current flight positioning mode of the aircraftr0
ned_altitudeNED coordinate altitudedoubleAltitude value in NED coordinate systemr0
ned_latitudeNED coordinate latitudedoubleLatitude value in NED coordinate systemr0
ned_longitudeNED coordinate longitudedoubleLongitude value in NED coordinate systemr0
vel_ned_xNED coordinate X velocity (northward)floatNorthward velocity component in NED coordinate systemr0
vel_ned_yNED coordinate Y velocity (eastward)floatEastward velocity component in NED coordinate systemr0
vel_ned_zNED coordinate Z velocity (downward)floatVertical velocity component in NED coordinate systemr0
ntrip_statusNTRIP module statustext{"normal": Normal, "error": Error}NTRIP differential module status, reported as a string rather than an integer enumr0
storageStorage informationstructAircraft onboard storage capacity informationr0
»storage_typeStorage typeint{0: SD card, 1: MMC}Storage media type0
»totalTotal capacityintTotal storage capacity0
»usedUsed capacityintUsed storage capacity0
»current_usedCurrently Usedint{0: Not in use, 1: In use}Storage medium the camera is currently writing tor0
out_of_control_actionRC disconnection actionint{"0":"Return to home", "1":"Hover", "2":"Landing"}Action taken by the aircraft when remote controller signal is lostrw0
exit_wayline_when_rc_lostWayline RC lost actionint{"0":"Continue wayline task", "1":"Exit wayline task, perform RC lost action"}Action taken when remote controller is lost during wayline executionrw0
rth_altitudeReturn to home altitudeintFlight altitude of the aircraft during return to home (RTH)rw0
rc_lost_actionRC lost actionenum_int{"0":"Hover","1":"Landing","2":"Return to home"}Safety action performed by the aircraft when remote controller is lostr0
intelligent_lock_modeIntelligent lock modeint{"0":"Not in intelligent lock mode","1":"In intelligent lock mode"}Whether the aircraft is in intelligent lock moder0
manual_ctrl_gimbalManual gimbal control during waylineint{"0":"Manual gimbal control not supported","1":"Manual gimbal control supported"}Whether manual gimbal control is allowed during wayline executionrw0
firmware_versionDrone firmware versiontextCurrent firmware version of the aircraftr0
snDrone serial number (SN)textUnique serial number of the aircraftr0
sdcard_storageSD card storage informationstructSD card storage capacity informationr0
»storage_typeStorage typeint{0: SD card, 1: MMC}Storage media typer0
»totalTotal capacityint{"unit_name":"KB"}Total SD card capacityr0
»usedUsed capacityint{"unit_name":"KB"}Used SD card capacityr0
»current_usedCurrently Usedint{0: Not in use, 1: In use}Storage medium the camera is currently writing tor0
speakerSpeaker statestructOnly reported when speaker is attachedr0
»work_modeWork modeint{1: Default mode}Current operating mode of the speakerr0
psdk_widget_valuesPSDK payload widget valuesarray{"item_type": struct}Only reported when PSDK payload is attachedr0
»psdkIndexPayload indexintIndex number of the PSDK payload on the aircraft bodyr0
»psdkNamePayload nametextPSDK payload device namer0
»psdkSnPayload serial numbertextPSDK payload device serial numberr0
»psdkVersionPayload firmware versiontextPSDK payload firmware versionr0
»psdkLibVersionPSDK library versiontextPSDK library versionr0
»speakerSpeaker statusstructPSDK payload speaker module statusr0
»»workModeWork modeint{0: TTS payload mode, 1: Recording broadcast}Speaker operating moder0
»»playModePlay modeint{0: Single play, 1: Loop play (single track)}Audio playback moder0
»»playVolumePlay volumeint{"max":100,"min":0}Speaker playback volumer0
»»systemStateSpeaker system stateintSpeaker system running statusr0
»»playFileNamePlay file nametextCurrently playing audio file namer0
»»playFileMd5Play file MD5textMD5 checksum of the currently playing filer0
»»realTimeSpeakingStatusReal-time speaking statusint{0: Not speaking, 1: Speaking}Whether real-time speaking is in progressr0
»lightStatusSearchlight statusstructPSDK payload searchlight module statusr0
»»switchStatusSwitch statusint{0: Off, 1: On}Searchlight switch statusr0
»»flashModeFlash modeintSearchlight flash moder0
»»brightnessLevelBrightness levelintSearchlight brightness levelr0
»»pitchEnglePitch angleintSearchlight pitch angler0
»»pztLinkedStatusPZT linked statusintSearchlight PZT linked statusr0
rid_stateRemote ID stateint{0: Off, 1: On, 2: Self-check abnormal}Remote ID broadcast module operational statusr0
laser_distance_dataLaser ranging datastructMeasurement results of the laser rangefinding moduler0
»laser_distance_is_validWhether laser ranging is validint{0: Invalid, 1: Valid}Whether laser rangefinding data is validr0
»laser_distanceLaser ranging distanceint{"unit_name":"centimeters / cm"}Distance value from laser rangefindingr0
live_fps_statsLive stream frame rate statisticsstructLivestream frame rate statisticsr0
»recv_frame_statsReceive frame statisticsarray{"item_type": struct}Receiver frame rate statistics listr0
»»fps_video_typeVideo typetextVideo stream type identifierr0
»»lag_countLag frame countintNumber of lag frames within the statistics periodr0
»»fps_countFrame countintTotal frame count within the statistics periodr0
»send_frame_statsSend frame statisticsarray{"item_type": struct}Sender frame rate statistics listr0
»»fps_video_typeVideo typetextVideo stream type identifierr0
»»lag_countLag frame countintNumber of lag frames within the statistics periodr0
»»fps_countFrame countintTotal frame count within the statistics periodr0
home_latitudeHome Point LatitudedoubleLatitude of the return-to-home point, WGS84r0、1
home_longitudeHome Point LongitudedoubleLongitude of the return-to-home point, WGS84r0、1
home_distance_latHome Latitude Deltadouble(current latitude - home latitude) × 1e7, computed by the dockr0
home_distance_lonHome Longitude Deltadouble(current longitude - home longitude) × 1e7, computed by the dockr0
coor_distance_to_homeCoordinate Distance to Homedouble{"unit_name":"meters / m"}Computed by the dock using the Haversine formular0
posTypeRTK Solution Type (compatibility key)textIdentical to pos_type; camelCase key kept for backward compatibilityr0
active_zoom_controlActive Zoom Controlint{0: Inactive, 1: Active}Whether zoom control is activer0
compatible_statusCompatible StatusintAlways reported as 0 in the current firmwarer0
navigation_project_enableNavigation Project Enableint{0: Off, 1: On}Field is omitted when the cache holds no valuerw0
total_flight_sortiesTotal Flight SortiesintCumulative number of flights since manufacture; omitted when the cached value is -1r0
track_typeTrack Typeint{0: Not tracking, 1: Tracking}Set to 1 in intelligent lock mode when the tracking state is TRACKING; works together with intelligent_lock_moder0
uom_stateUOM Registration Stateint{0: Not registered, 1: Registered}Derived from a flight controller status bit; omitted when the cache holds no valuer0
user_hide_modeUser Hide Modeint{0: Off, 1: On}User privacy hiding mode switchrw0
track_settingTrack SettingstructDistance and altitude parameters for intelligent trackingrw0
»obstacle_avoidanceObstacle Avoidanceint{0: Off, 1: On}Obstacle avoidance switch during trackingr0
»horizontal_distanceHorizontal Distanceint{"max":100,"min":10,"unit_name":"meters / m"}Omitted when outside the valid ranger0
»vertical_distanceVertical Distanceint{"max":100,"min":10,"unit_name":"meters / m"}Omitted when outside the valid ranger0
»orbit_heightOrbit Heightint{"max":100,"min":10,"unit_name":"meters / m"}Omitted when outside the valid ranger0
camera_watermark_settingsCamera Watermark SettingsstructWatermark overlay configuration for photos and videosrw0
»global_enableGlobal Enableint{0: Off, 1: On}Master switch for the watermark functionr0
»drone_type_enableDrone Type Enableint{0: Off, 1: On}Whether to overlay the aircraft modelr0
»drone_sn_enableDrone SN Enableint{0: Off, 1: On}Whether to overlay the aircraft serial numberr0
»datetime_enableDatetime Enableint{0: Off, 1: On}Whether to overlay the capture date and timer0
»gps_enableGPS Enableint{0: Off, 1: On}Whether to overlay the capture locationr0
»user_custom_string_enableUser Custom String Enableint{0: Off, 1: On}Whether to overlay a user-defined stringr0
»layoutLayoutintPlacement of the watermark within the framer0
dongle_infosDongle Informationarray{"item_type": struct}LTE module and SIM card information on the aircraft side; omitted when the cache is emptyr0、1
»dongle_typeDongle Typeint{0: Built-in, 1: External dongle}How the cellular module is attachedr0、1
»imeiIMEItextAlways an empty string in the current firmware; not provided by the SDKr0、1
»eideSIM EIDtextEID identifier of the eSIMr0、1
»esim_activate_stateeSIM Activation Stateint{0: Unknown, 1: eSIM detected but no enabled profile, 2: An enabled profile exists}Profile activation state of the eSIMr0、1
»esim_infoseSIM Information Listarray{"item_type": struct}List of eSIM profiles written to the moduler0、1
»»telecom_operatorTelecom Operatorint{0: Unknown, 1: China Mobile, 2: China Unicom, 3: China Telecom}Mapped from the PLMNr0、1
»»enabledEnabledbool{true: Enabled, false: Disabled}Whether this profile is currently activer0、1
»»iccidICCIDtextICCID of the eSIM profiler0、1
»sim_card_stateSIM Card Stateint{0: Not inserted, 1: Inserted}Presence of the physical SIM cardr0、1
»sim_slotSIM Slotint{0: Unknown, 1: Physical SIM, 2: eSIM}Currently active slot typer0、1
»sim_infoSIM InformationstructOperator and ICCID of the physical SIM cardr0、1
»»iccidICCIDtextICCID of the physical SIM cardr0、1
»»sim_typeSIM TypeintAlways 0 (unknown) in the current firmware; not provided by the SDKr0、1
»»telecom_operatorTelecom Operatorint{0: Unknown, 1: China Mobile, 2: China Unicom, 3: China Telecom}Mapped from the PLMNr0、1
camera_settingsCamera Settingsarray{"item_type": struct}Current photo and video parameters of each lensr1
»camera_typeCamera Typetext{"zoom": Zoom, "ir": Infrared}Lens this parameter set belongs tor1
»photo_formatPhoto Formatint{0: JPG, 1: DNG, 2: JPG+DNG, 3: RJPEG, 4: RJPEG+TIFF, 255: Unknown}Output file format for photosr1
»photo_sizePhoto SizetextFormat "WxH"For example "4096x3072"; a string rather than an enumr1
»video_resolutionVideo ResolutiontextFormat "WxH"For example "4000x3000"; a string rather than an enumr1
»video_fpsVideo FPSint{"unit_name":"frames per second / fps"}Reported only when greater than 0r1
current_firmware_versionCurrent Firmware Versionarray{"item_type": struct}Version information of each aircraft component; omitted when the cache is emptyr1
»component_idComponent IDtextFor example PLATFORM_SKYLINK / PLATFORM_VISION / GPS / FCS / CAMERA / GIMBAL / BATTERY / ESC1 / ESC2 / RADAR / SYSTEM_PACK; unmapped components are reported as UNKNOWN_{numeric id}r1
»component_typeComponent TypetextFor 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}r1
»component_modelComponent ModelintNumeric component modelr1
»str_component_modelComponent Model (string)textString representation of the component modelr1
»component_snComponent SNtextUnique serial number of the componentr1
»software_versionSoftware VersiontextFormat V{major}.{minor}.{patch}.{build}Current software version of the componentr1
»hardware_versionHardware VersiontextHardware version of the componentr1
»bootloader_versionBootloader VersiontextBootloader version of the componentr1
»labelLabeltextLabel information of the componentr1
»data_sourceData Sourceint{0: Passively reported by version message, 1: Actively queried}How this version record was obtainedr1
lockedAircraft Lockedbool{true: Locked, false: Unlocked}Always false in the current firmwarer1
low_battery_warning_enableLow Battery Warning Enableint{0: Off, 1: On}Smart low-battery return switch; omitted when the cache holds no valuerw1
low_battery_warning_thresholdLow Battery Warning Thresholdint{"max":100,"min":0,"unit_name":"percent / %"}Remaining capacity at which the low-battery warning triggersrw1
serious_low_battery_warning_thresholdSerious Low Battery Warning Thresholdint{"max":100,"min":0,"unit_name":"percent / %"}Remaining capacity at which the critical low-battery warning triggersrw1

Payload Report​

Topic: thing/product/{device_sn}/state

Direction: up

Direction: up (Device -> Cloud)

Data:

ColumnNameTypeRemarks
payload_listPayload Listarray
»payload_idPayload IDint
»payload_typePayload Typeint
»is_onlineOnline Statusint
»last_active_timeLast Active TimeLong
»payload_positionPayload Positionint
»psdklib_versionPSDK VersionString
»payload_versionPayload VersionString

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
}