跳到主要内容

M4T/M4N 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
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"}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 indextext68-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 factorr
»»photoStorageSettingsPhoto storage capabilitiesString in array{"zoom": Zoom, "wide": Wide-angle, "ir": Infrared, "NightVision": Night vision }List of lens types that support photo capture
»»videoStorageSettingsVideo storage capabilitiesString in array{"zoom": Zoom, "wide": Wide-angle, "ir": Infrared, "NightVision": Night vision }List of lens types that support video recording
»»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
»»»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
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
»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":"millivolts / mV"}Current battery voltager0
»»loop_timesBattery cycle countintBattery discharge countFull charge/discharge cycle count of the 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 status
»is_fixedIs convergedenum_int{"0":"Not started","1":"Converging","2":"Converged successfully","3":"Convergence failed"}Whether RTK positioning has completed convergencer0
»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
{type-subtype-gimbalindex}Payload indexstruct{{type-subtype-gimbalindex}_cBGPzxWKRQ}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_styleCurrent thermal palette styleintCurrent palette style index used by the infrared camerar0
»thermal_supported_palette_stylesSupported thermal palette stylesarray{"item_type": int}List of all palette style indices supported by the infrared camerar0
activation_timeDrone activation time (unix timestamp)int{"unit_name":"seconds / s"}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
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 alarms0
pos_typeRTK statusInt{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 positioning solution type0
wireless_linkLink statusstructAircraft wireless link status informationr0
»fourth_generation_uavQuality4G signal strengthInt4G signal quality on the aircraft sider0
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 card{0: No card, 1: Card inserted}
lte_signal44G signalint{0,100}4G module signal strength
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 status{0: Does not support LTE module, 1: Off, 2: Not connected, 3: Connected but network unreachable, 4: Connected}
remote_id_statusRemote ID operational statusint{0: Off, 1: On, 2: Self-check abnormal}Remote ID broadcast module operational status
control_sourceCurrent control sourcetextDevice identifier currently controlling the aircraft (e.g., remote controller or dock SN)
commander_mode_lost_actionFlight point failure actionenum_int{"0":"Continue waypoint flight task","1":"Exit waypoint flight task, perform normal failure action"}Action taken when control link is lost during waypoint flight mode
ai_enable_funcAI function enable statusint{0: Off, 1: On}AI intelligent recognition function switch status
countryCountry codetextISO code of the country or region where the aircraft is located
gear_levelGear levelint{0: Unknown, 1: Smooth, 2: Normal, 3: Sport, 4: Low speed}Current flight gear level of the aircraft
gimbal_angle_follow_toggleGimbal angle follow toggleint{0: Off, 1: On}Whether gimbal yaw angle follows the aircraft heading
haeEllipsoidal heightdoubleHeight above WGS84 ellipsoid
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 camerarw
measure_target_error_stateLaser ranging statusint{0: Off, 1: On}Operational status of the laser rangefinding module
measure_target_distanceLaser ranging distancedoubleUnit: meters (data available when measure_target_error_state == 1)Target distance from laser rangefinding
measure_target_longitudeLaser ranging target longitudedoubleData available when measure_target_error_state == 1Target longitude calculated by laser rangefinding
measure_target_latitudeLaser ranging target latitudedoubleData available when measure_target_error_state == 1Target latitude calculated by laser rangefinding
measure_target_altitudeLaser ranging target altitudedoubleData available when measure_target_error_state == 1Target altitude calculated by laser rangefinding
main_modeAircraft flight modeint{0: Unknown, 1: Attitude mode, 2: GNSS mode, 3: Visual positioning}Current flight positioning mode of the aircraft
ned_altitudeNED coordinate altitudedoubleAltitude value in NED coordinate system
ned_latitudeNED coordinate latitudedoubleLatitude value in NED coordinate system
ned_longitudeNED coordinate longitudedoubleLongitude value in NED coordinate system
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 statusint{0: Not supported, 1: Not connected, 2: Connected, 3: Invalid account, 4: No differential data, 5: NTRIP disabled}NTRIP differential data module connection status
infrared_camera_temp_dataInfrared camera temperature datastructGlobal temperature data from infrared camera auto metering
»average_tempAverage temperaturefloatAverage temperature of the infrared image
»camera_idCamera IDtextInfrared camera identifier
»center_tempCenter temperaturefloatCenter point temperature of the infrared image
»cold_tempColdest temperaturefloatMinimum temperature in the infrared image
»cold_xColdest point X coordinatedoubleX coordinate of the minimum temperature point
»cold_yColdest point Y coordinatedoubleY coordinate of the minimum temperature point
»hot_tempHottest temperaturefloatMaximum temperature in the infrared image
»hot_xHottest point X coordinatedoubleX coordinate of the maximum temperature point
»hot_yHottest point Y coordinatedoubleY coordinate of the maximum temperature point
»touch_tempTouch point temperaturefloatTemperature value of the manual touch point
»zoom_valueZoom valueintCurrent zoom value of the infrared camera
storageStorage informationstructAircraft onboard storage capacity information
»storage_typeStorage typeint{0: SD card, 1: MMC}Storage media type
»totalTotal capacityintTotal storage capacity
»usedUsed capacityintUsed storage capacity
out_of_ control_actionRC disconnection actionint{"0":"Return to home", "1":"Hover", "2":"Landing"}Action taken by the aircraft when remote controller signal is lost
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 execution
rth_altitudeReturn to home altitudeintFlight altitude of the aircraft during return to home (RTH)
rc_lost_actionRC lost actionenum_int{"0":"Hover","1":"Landing","2":"Return to home"}Safety action performed by the aircraft when remote controller is lost
intelligent_lock_modeIntelligent lock modeint{"0":"Not in intelligent lock mode","1":"In intelligent lock mode"}Whether the aircraft is in intelligent lock mode
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 executionrw
reflight_in_landingRe-flight status during precision landingint{"0":"Normal","1":"Re-flying"}Re-flight status during precision landingr
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
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

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
}