跳到主要内容

M4T/M4N设备属性

设备属性列表

  • pushMode:

    • 0:设备推送定频数据,设备将以 0.5HZ 的频率定时上报 (Topic:thing/product/{device_sn}/osd)
    • 1:设备推送状态数据,设备在状态变化时上报(Topic:thing/product/{device_sn}/state)
  • accessMode:

    • r:属性只读
    • rw:属性可读写 (Topic:thing/product/{gateway_sn}/property/set)
ColumnNameTypeconstraintDescriptionaccessModepushMode
payloads负载状态array{"size": -, "item_type": struct}无人机当前挂载的负载设备列表r1
»payload_index负载编号text负载索引,格式为 {type-subtype-gimbalindex}r1
»sn负载序列号(SN)text负载设备唯一识别码r1
mode_code无人机状态enum_int{"0":"待机","1":"起飞准备","2":"起飞准备完毕","3":"手动飞行","4":"自动起飞","5":"航线飞行","6":"全景拍照","7":"智能跟随","8":"ADS-B 躲避", "9":"自动返航","10":"自动降落","11":"强制降落","12":"三桨叶降落","13":"升级中","14":"未连接","15":"APAS","16":"虚拟摇杆状态", "17":"矩形","18":"多边形","19":"倾斜摄影","20":"保留字段","21":"精准复拍","22":"延时摄影","23":"环绕","25":"螺旋","26":"超清", "27":"智能图传打点模式","28":"红外跟踪","29":"智能任务航线飞行","30":"智能任务多边形仿地","31":"智能任务单体环绕","32":"全景智能检测","33":"安防智能检测", "34":"gps逃逸模式","35":"异常模式状态,当前只是planner进程挂掉,会切换至此模","36":"蜂群编队模式","37":"快速任务", "38":"建模环综模式","39":"kml航线模式"}当前无人机飞行状态码r0
distance_limit_status无人机限远状态struct无人机限远功能的整体状态信息rw0
»state是否开启限远enum_int{"0":"未设置","1":"已设置"}限远功能开关状态0
»distance_limit限远距离int{"max":"8000","min":"15","step":"1","unit_name":"米 / m"}设定的最大飞行距离0
»is_near_distance_limit是否接近设定的限制距离enum_int{"0":"未达到设定的限制距离","1":"接近设定的限制距离"}无人机是否即将达到限远距离r0
cameras无人机相机信息array{"size": -, "item_type": struct}无人机当前相机状态列表r0
»[array_item]Elements in arraystruct单个相机信息
»»payload_index负载编号text68-0-0负载编号,相机枚举值。非标准的 device_mode_key,格式为 {type-subtype-gimbalindex},可以参考产品支持页面r0
»»camera_mode相机模式enum_int{"0":"拍照","1":"录像"}相机模式r0
»»zoom_factor变焦倍数float{"max":160,"min":1}当前变焦镜头倍数r0
»»wide_factor广角变焦倍数float{"max":160,"min":1}当前广角镜头变焦倍数r0
»»night_factor夜视变焦倍数float{"max":160,"min":1}当前夜视镜头变焦倍数r0
»»ir_zoom_factor红外变焦倍数float{"max":16,"min":1}当前红外镜头变焦倍数r
»»photoStorageSettings拍照能力集String in array{"zoom":变焦, "wide":广角, "ir":红外,"NightVision": 夜视 }当前支持拍照的镜头类型列表
»»videoStorageSettings录像能力集String in array{"zoom":变焦, "wide":广角, "ir":红外,"NightVision": 夜视 }当前支持录像的镜头类型列表
»»photo_state拍照状态enum_int{"0":"空闲","1":"工作中"}相机当前拍照工作状态r0
»»record_time当前录像时长int{"unit_name":"秒 / s"}当前正在录制的视频时长r0
»»recording_state录像状态enum_int{"0":"空闲","1":"工作中"}相机当前录像工作状态r0
»»remain_photo_num剩余可拍照数量long存储卡剩余可拍照数量r0
»»remain_record_duration剩余可录像时长int{"unit_name":"秒 / s"}存储卡剩余可录像时长r0
»»screen_split_enable分屏开关int{"0":"关闭","1":"开启"}画面分屏显示开关状态r0
»»ir_metering_mode红外测温模式int{"0":"关闭测温","1":"点测温","2":"区域测温"}红外相机测温功能的工作模式r0
»»ir_metering_point红外点测温数据structir_metering_mode == 1 时有数据r0
»»»x测温点X坐标double点测温目标的归一化X坐标r0
»»»y测温点Y坐标double点测温目标的归一化Y坐标r0
»»»temperature测温点温度double点测温目标的温度值r0
»»ir_metering_area红外区域测温数据structir_metering_mode == 2 时有数据r0
»»»x测温区域X坐标double区域测温左上角归一化X坐标r0
»»»y测温区域Y坐标double区域测温左上角归一化Y坐标r0
»»»width测温区域宽度double区域测温归一化宽度r0
»»»height测温区域高度double区域测温归一化高度r0
»»»min_temperature_point最低温度点struct区域内最低温度的位置和温度值r0
»»»»xX坐标double最低温度点的归一化X坐标r0
»»»»yY坐标double最低温度点的归一化Y坐标r0
»»»»temperature温度double区域内的最低温度值r0
»»»max_temperature_point最高温度点struct区域内最高温度的位置和温度值r0
»»»»xX坐标double最高温度点的归一化X坐标r0
»»»»yY坐标double最高温度点的归一化Y坐标r0
»»»»temperature温度double区域内的最高温度值r0
»»zoom_fov_h变焦水平视场角float变焦镜头水平视场角r0
»»zoom_fov_v变焦垂直视场角float变焦镜头垂直视场角r0
»»zoom_focal_length变焦焦距float变焦镜头当前焦距r0
»»wide_fov_h广角水平视场角float广角镜头水平视场角r0
»»wide_fov_v广角垂直视场角float广角镜头垂直视场角r0
»»wide_focal_length广角焦距float广角镜头当前焦距r0
»»ir_fov_h红外水平视场角float红外镜头水平视场角r0
»»ir_fov_v红外垂直视场角float红外镜头垂直视场角r0
»»ir_focal_length红外焦距float红外镜头当前焦距r0
»»nightvision_fov_h夜视水平视场角float夜视镜头水平视场角r0
»»nightvision_fov_v夜视垂直视场角float夜视镜头垂直视场角r0
»»nightvision_focal_length夜视焦距float夜视镜头当前焦距r0
horizontal_speed水平速度float{"unit_name":"米每秒 / m/s"}无人机当前水平飞行速度r0
vertical_speed垂直速度float{"unit_name":"米每秒 / m/s"}无人机当前垂直飞行速度r0
longitude当前位置经度float无人机当前位置经度,WGS84坐标系r0
latitude当前位置纬度float无人机当前位置纬度,WGS84坐标系r0
height绝对高度float海拔高度r0
elevation相对起飞点高度float无人机相对于起飞点的飞行高度r0
attitude_pitch俯仰轴角度float无人机机体俯仰轴角度r0
attitude_roll横滚轴角度float无人机机体横滚轴角度r0
attitude_head偏航轴角度int偏航轴角度与真北角(经线)的角度,0到6点钟方向为正值,6到12点钟方向为负值r0
home_distance距离 Home 点的距离float无人机与返航点之间的水平距离r0
wind_speed风速float{"unit_name":"米每秒 / m/s"}无人机当前位置环境风速r0
battery无人机电池信息struct无人机电池整体信息r0
»capacity_percent电池的总剩余电量int{"max":100,"min":0}所有电池的综合剩余电量百分比r0
»remain_flight_time剩余飞行时长int单位s基于当前电量估算的剩余可飞行时间r0
»batteries多电池列表array各电池的独立状态信息列表r0
»»index电池IDint电池在机身中的位置索引r0
»»sn电池序列号(SN)text电池唯一序列号r0
»»capacity_percent电池电量百分比int{"max":100,"min":0}单块电池的剩余电量百分比r0
»»temperature温度float{"unit_name":"摄氏度 / °C"}电池当前温度r0
»»voltage电压float{"unit_name":"毫伏 / mV"}电池当前电压r0
»»loop_times电池循环次数int电池放电次数电池完整充放电循环次数r0
position_state搜星状态struct无人机定位系统综合状态r0
»coordinate_sysrtk坐标系统Int{0:WGS84, 1:RTK移动站}RTK定位使用的坐标系类型r0
»fix_stafix状态Int{0:未fix, 1:fix}RTK定位的Fix解算状态
»is_fixed是否收敛enum_int{"0":"未开始","1":"收敛中","2":"收敛成功","3":"收敛失败"}RTK定位是否完成收敛r0
»quality搜星档位enum_int{"1":"1档","2":"2档","3":"3档","4":"4档","5":"5档"}卫星信号质量等级r0
»rtk_inposrtk模块是否在位置int{0:没有在位置, 1: 在位置}RTK模块定位是否就绪r0
»rtk_used是否使用rtk定位Int{0:没有使用, 1: 在使用}当前定位是否使用RTK增强r0
»rtk_hgtrtk高度DoubleRTK解算的椭球高度r0
»rtk_latrtk纬度DoubleRTK解算的纬度值r0
»rtk_lonrtk经度DoubleRTK解算的经度值r0
»gps_numberGPS 搜星数量int当前GPS可见卫星数量r0
»rtk_numberRTK 搜星数量int当前RTK可见卫星数量r0
{type-subtype-gimbalindex}负载编号struct{{type-subtype-gimbalindex}_cBGPzxWKRQ}r0
»gimbal_pitch云台俯仰轴角度double{"max":"180","min":"-180","step":0.1,"unit_name":"度 / °"}云台俯仰轴当前角度r0
»gimbal_roll云台横滚轴角度double{"max":"180","min":"-180","step":0.1,"unit_name":"度 / °"}云台横滚轴当前角度r0
»gimbal_yaw云台偏航轴角度double{"max":"180","min":"-180","step":0.1,"unit_name":"度 / °"}云台偏航轴当前角度r0
»payload_index负载索引,格式为 {type-subtype-gimbalindex}text负载设备的索引标识r1
»zoom_factor变焦倍数double当前镜头变焦倍数r0
»thermal_current_palette_style当前热成像调色板样式int红外相机当前使用的调色板样式索引r0
»thermal_supported_palette_styles支持的热成像调色板样式集合array{"item_type": int}红外相机支持的所有调色板样式索引列表r0
activation_time无人机激活时间(unix 时间戳)int{"unit_name":"秒 / s"}无人机首次激活的时间戳r0
night_lights_state无人机夜航灯状态enum_int{"0":"关闭","1":"打开"}夜航灯的开关状态rw0
height_limit无人机限高int{"max":"1500","min":"20","step":"1","unit_name":"米 / m"}设定的最大飞行高度rw0
is_near_height_limit是否接近设定的限制高度enum_int{"0":"未达到设定的限制高度","1":"接近设定的限制高度"}无人机是否即将达到限高高度r0
is_near_area_limit是否接近限飞区enum_int{"0":"未达到限飞区","1":"接近限飞区"}无人机是否即将进入限飞区域r0
obstacle_avoidance无人机避障状态struct无人机避障功能整体状态rw0
»horizon水平避障状态enum_int{"0":"关闭","1":"开启"}注意:目前无人机是统一避障,没有区分0
»upside上视避障状态enum_int{"0":"关闭","1":"开启"}注意:目前无人机是统一避障,没有区分0
»downside下视避障状态enum_int{"0":"关闭","1":"开启"}注意:目前无人机是统一避障,没有区分0
total_flight_time累计飞行时长Int单位s无人机历史累计飞行时间r0
total_armed_time本次打桨累计飞行时长Int单位s本次启动电机后的累计飞行时间r0
alarm_status告警状态Int{0:未告警 1 有告警}无人机当前是否存在告警0
pos_typertk状态Int{0:无解, 1:位置由FIX POSITION命令指定, 2:不支持 8:多普勒信息导出,16:单点定位 17:伪距差分解 18:SBAS定位 32:L1浮点解 33:消电离层浮点解 34:窄巷浮点解 48:L1固定解 49:宽巷固定解 50:窄巷固定节 52:纯惯导定位解 53:惯导与单点组合解 54: 惯导与伪距差分定位组合解 55:惯导与载波相位差分浮点解组合解 56:惯导与载波相位差分固定解组合解}RTK定位解算类型0
wireless_link链路状态struct无人机无线链路状态信息r0
»fourth_generation_uavQuality4g信号强度Int无人机侧4G信号质量r0
payload_Index云台负载struct云台负载的综合状态信息r0
»gimbal_pitch云台俯仰角double云台俯仰轴当前角度0
»gimbal_roll云台横滚角double云台横滚轴当前角度0
»gimbal_yaw云台偏航角double云台偏航轴当前角度0
»payload_index负载IDtext负载设备的索引标识0
»zoom_factor缩放倍数Int当前镜头变焦倍数0
lte_card_is_detected是否有插sim卡int{0:没有插卡, 1: 有插卡}无人机是否检测到SIM卡{0:没有插卡, 1: 有插卡}
lte_signal4g信号int{0,100}4G模块信号强度
lte_status4g卡状态int{0:不支持lte模块,1:关闭状态 2:未连接状态 3: 已连接,但网络不可达, 4:已连接}4G模块连接状态{0:不支持lte模块,1:关闭状态 2:未连接状态 3: 已连接,但网络不可达, 4:已连接}
remote_id_statusRemote id 工作状态int{0:关闭1:开启2:自检异常}Remote ID广播模块工作状态
control_source当前控制源text当前控制无人机的设备标识(如遥控器或机巢SN)
commander_mode_lost_action指点飞行失控动作enum_int{"0":"继续执行指点飞行任务","1":"退出指点飞行任务,执行普通失控行为"}指点飞行模式下失去控制链路时的处理动作
ai_enable_funcai功能打开状态int{0:关闭, 1:打开}AI智能识别功能开关状态
country国家代码text无人机所在国家或地区的ISO代码
gear_level档位等级int{0:未知,1:平稳档,2:普通档,3:运动档4:低速档}无人机当前飞行档位
gimbal_angle_follow_toggle云台角度跟随开关int{0:关闭, 1:打开}云台偏航角是否跟随机头方向
hae椭球高double基于WGS84椭球面的高度
infrared_palette_mode红外调色板模式int{0:白热, 1:冷热, 2:彩虹, 3:增强彩虹,4:铁红,5:熔岩,6:极光,7:灼热, 8:渐变,9:热探测, (高德红外)30:白热,31:黑热,32:彩虹1,33:彩虹2,34:铁红,35:熔岩,36:北极,38:医疗,39:描红}红外相机当前使用的调色板模式rw
measure_target_error_state激光测距状态int{0:关闭, 1:打开}激光测距模块的工作状态
measure_target_distance激光测距距离double单位:米(measure_target_error_state == 1时有数据)激光测距的目标距离
measure_target_longitude激光测距目标经度double(measure_target_error_state == 1时有数据)激光测距计算的目标经度
measure_target_latitude激光测距目标纬度double(measure_target_error_state == 1时有数据)激光测距计算的目标纬度
measure_target_altitude激光测距目标高度double(measure_target_error_state == 1时有数据)激光测距计算的目标高度
main_mode飞机飞行模式int{0:未知, 1:姿态模式, 2:GNNS模式,3:视觉定位}飞机当前的飞行定位模式
ned_altitudened坐标高度doubleNED坐标系下的高度值
ned_latitudened坐标纬度doubleNED坐标系下的纬度值
ned_longitudened坐标经度doubleNED坐标系下的经度值
vel_ned_xNED坐标X方向速度(北向)floatNED坐标系下北向速度分量r0
vel_ned_yNED坐标Y方向速度(东向)floatNED坐标系下东向速度分量r0
vel_ned_zNED坐标Z方向速度(天向)floatNED坐标系下天向速度分量r0
ntrip_statusntrip模块状态int{0:不支持,1:未连接,2:已连接,3:账号不合法,4:没有差分数据,5,ntrip已关闭}NTRIP差分数据模块连接状态
infrared_camera_temp_data红外相机温度数据struct红外相机自动测温的全局温度数据
»average_temp平均温度float红外画面平均温度
»camera_id相机IDtext红外相机标识ID
»center_temp中心温度float红外画面中心点温度
»cold_temp最冷温度float红外画面内最低温度
»cold_x最冷点X坐标double最低温度点的X坐标
»cold_y最冷点Y坐标double最低温度点的Y坐标
»hot_temp最热温度float红外画面内最高温度
»hot_x最热点X坐标double最高温度点的X坐标
»hot_y最热点Y坐标double最高温度点的Y坐标
»touch_temp触摸点温度float手动触摸点的温度值
»zoom_value变焦值int红外相机当前变焦值
storage存储信息struct无人机机载存储容量信息
»storage_type存储类型int{0:SD卡, 1:MMC}存储介质类型
»total总容量int存储空间总容量
»used已使用容量int存储空间已使用容量
out_of_ control_action遥控器失联动作int{"0":"返航", “1”:“悬停”, "2":"降落" }遥控器信号丢失时无人机的处理动作
exit_wayline_when_rc_lost航线失联动作int{"0":"继续执行航线任务", “1”:“退出航线任务,执行遥控器失控动作}航线执行中遥控器失联时的处理方式
rth_altitude返航高度int无人机返航时的飞行高度
rc_lost_action遥控器失控动作enum_int{"0":"悬停","1":"着陆(降落)","2":"返航"}遥控器失控时无人机执行的安全动作
intelligent_lock_mode智能锁定模式int{"0":"未进入智能锁定模式","1":"已进入智能锁定模式"}无人机是否处于智能锁定模式
manual_ctrl_gimbal航线下是否支持手动控制云台int{"0":"不支持手动控制云台","1":"支持手动控制云台"}航线执行时是否允许手动控制云台rw
reflight_in_landing精准降落时复飞状态int{"0":"正常","1":"复飞中"}精准降落过程中的复飞状态r
firmware_version飞机固件版本text无人机当前固件版本号r0
sn飞机序列号(SN)text无人机唯一序列号r0
sdcard_storageSD卡存储信息structSD存储卡容量信息r0
»storage_type存储类型int{0:SD卡, 1:MMC}存储介质类型r0
»total总容量int{"unit_name":"KB"}SD卡总容量r0
»used已使用容量int{"unit_name":"KB"}SD卡已使用容量r0
speaker喊话器状态struct仅在挂载喊话器时上报r0
»work_mode工作模式int{1:默认模式}喊话器当前工作模式r0
psdk_widget_valuesPSDK 负载控件值array{"item_type": struct}仅在挂载PSDK负载时上报r0
»psdkIndex负载索引intPSDK负载在机身上的索引编号r0
»psdkName负载名称textPSDK负载设备名称r0
»psdkSn负载序列号textPSDK负载设备序列号r0
»psdkVersion负载固件版本textPSDK负载固件版本号r0
»psdkLibVersionPSDK库版本textPSDK库版本号r0
»speaker喊话器状态structPSDK负载喊话器模块状态r0
»»workMode工作模式int{0:TTS负载模式,1:录音喊话}喊话器工作模式r0
»»playMode播放模式int{0:单次播放,1:循环播放(单曲)}音频播放模式r0
»»playVolume播放音量int{"max":100,"min":0}喊话器播放音量r0
»»systemState喊话器系统状态int喊话器系统运行状态r0
»»playFileName播放文件名text当前播放的音频文件名r0
»»playFileMd5播放文件MD5text当前播放文件的MD5校验值r0
»»realTimeSpeakingStatus实时喊话状态int{0:未喊话,1:喊话中}是否正在进行实时喊话r0
»lightStatus探照灯状态structPSDK负载探照灯模块状态r0
»»switchStatus开关状态int{0:关闭,1:打开}探照灯开关状态r0
»»flashMode闪烁模式int探照灯闪烁模式r0
»»brightnessLevel亮度等级int探照灯亮度等级r0
»»pitchEngle俯仰角度int探照灯俯仰角度r0
»»pztLinkedStatusPZT联动状态int探照灯PZT联动状态r0
rid_stateRemote ID 状态int{0:关闭,1:开启,2:自检异常}Remote ID广播模块运行状态r0
laser_distance_data激光测距数据struct激光测距模块的测距结果r0
»laser_distance_is_valid激光测距是否有效int{0:无效,1:有效}激光测距数据是否有效r0
»laser_distance激光测距距离int{"unit_name":"厘米 / cm"}激光测距的距离值r0
live_fps_stats直播帧率统计struct直播推流帧率统计信息r0
»recv_frame_stats接收帧统计array{"item_type": struct}接收端帧率统计列表r0
»»fps_video_type视频类型text视频流类型标识r0
»»lag_count卡顿帧数int统计周期内的卡顿帧数r0
»»fps_count帧数量int统计周期内的总帧数r0
»send_frame_stats发送帧统计array{"item_type": struct}发送端帧率统计列表r0
»»fps_video_type视频类型text视频流类型标识r0
»»lag_count卡顿帧数int统计周期内的卡顿帧数r0
»»fps_count帧数量int统计周期内的总帧数r0

负载上报

Topic: thing/product/{device_sn}/state

Direction: up

方向:上行(设备->云)

Data:

ColumnNameType备注
payload_list负载列表array
»payload_id负载idint
»payload_type负载类型int
»is_online在线状态int
»last_active_time上次激活时间Long
»payload_position负载位置int
»psdklib_versionpsdk版本String
»payload_version负载版本String

示例:

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