Files
mavlink-devguide/zh/messages/common.md
T
PX4 Build Bot d88c9cb149 New Crowdin updates (#709)
* New translations common.md (Korean)

[ci skip]

* New translations common.md (Chinese Simplified)

[ci skip]

* New translations common.md (Korean)

[ci skip]

* New translations common.md (Chinese Simplified)

[ci skip]
2026-06-03 10:00:13 +10:00

2.0 MiB
Raw Blame History

MAVLINK Common Message Set (common.xml)

The MAVLink common message set contains standard definitions that are managed by the MAVLink project. The definitions cover functionality that is considered useful to most ground control stations and autopilots. MAVLink-compatible systems are expected to use these definitions where possible (if an appropriate message exists) rather than rolling out variants in their own dialects.

The original definitions are defined in common.xml.

::: info

  • MAVLink 2 extension fields are displayed in blue.
  • Entities from dialects are displayed only as headings (with link to original)

:::

<style> span.ext { color: blue; } span.warning { color: red; } </style>

Protocol dialect: 0

Protocol version: 3

概览

Type Defined Included
Messages 231 3
Enums 150 9
Commands 168 0

The following sections list all entities in the dialect (both included and defined in this file).

消息

HEARTBEAT (0) — [from: minimal]

The heartbeat message shows that a system or component is present and responding. The type and autopilot fields (along with the message component id), allow the receiving system to treat further messages from this system appropriately (e.g. by laying out the user interface based on the autopilot). This microservice is documented at https://mavlink.io/en/services/heartbeat.html

Field Name Type 描述
type uint8_t MAV_TYPE Vehicle or component type. For a flight controller component the vehicle type (quadrotor, helicopter, etc.). For other components the component type (e.g. camera, gimbal, etc.). This should be used in preference to component id for identifying the component type.
autopilot uint8_t MAV_AUTOPILOT Autopilot type / class. Use MAV_AUTOPILOT_INVALID for components that are not flight controllers.
base_mode uint8_t MAV_MODE_FLAG System mode bitmap.
custom_mode uint32_t A bitfield for use for autopilot-specific flags
system_status uint8_t MAV_STATE System status flag.
mavlink_version uint8_t_mavlink_version MAVLink version, not writable by user, gets added by protocol because of magic data type: uint8_t_mavlink_version

SYS_STATUS (1)

Sensor and subsystem status information. Provides a compact representation of sensor/subsystem status and a few other basic statistics.

Field Name Type Units 描述
onboard_control_sensors_present uint32_t MAV_SYS_STATUS_SENSOR Bitmap showing which onboard controllers and sensors are present. Value of 0: not present. Value of 1: present.
onboard_control_sensors_enabled uint32_t MAV_SYS_STATUS_SENSOR Bitmap showing which onboard controllers and sensors are enabled: Value of 0: not enabled. Value of 1: enabled.
onboard_control_sensors_health uint32_t MAV_SYS_STATUS_SENSOR Bitmap showing which onboard controllers and sensors have an error (or are operational). Value of 0: error. Value of 1: healthy.
load uint16_t d% Maximum usage in percent of the mainloop time. Values: [0-1000] - should always be below 1000
voltage_battery uint16_t mV invalid:UINT16_MAX Battery voltage, UINT16_MAX: Voltage not sent by autopilot. Value is ambiguous on multi-battery systems. BATTERY_STATUS is a recommended alternative.
current_battery int16_t cA invalid:-1 Battery current, -1: Current not sent by autopilot. Value may overflow/rollover for very high currents (> 327.67A). Value is ambiguous on multi-battery systems. BATTERY_STATUS is a recommended alternative.
battery_remaining int8_t % invalid:-1 Battery energy remaining, -1: Battery remaining energy not sent by autopilot. Value is ambiguous on multi-battery systems. BATTERY_STATUS is a recommended alternative.
drop_rate_comm uint16_t c% Communication drop rate, (UART, I2C, SPI, CAN), dropped packets on all links (packets that were corrupted on reception on the MAV)
errors_comm uint16_t Communication errors (UART, I2C, SPI, CAN), dropped packets on all links (packets that were corrupted on reception on the MAV)
errors_count1 uint16_t Autopilot-specific errors
errors_count2 uint16_t Autopilot-specific errors
errors_count3 uint16_t Autopilot-specific errors
errors_count4 uint16_t Autopilot-specific errors
onboard_control_sensors_present_extended ++ uint32_t MAV_SYS_STATUS_SENSOR_EXTENDED Bitmap showing which onboard controllers and sensors are present. Value of 0: not present. Value of 1: present.
onboard_control_sensors_enabled_extended ++ uint32_t MAV_SYS_STATUS_SENSOR_EXTENDED Bitmap showing which onboard controllers and sensors are enabled: Value of 0: not enabled. Value of 1: enabled.
onboard_control_sensors_health_extended ++ uint32_t MAV_SYS_STATUS_SENSOR_EXTENDED Bitmap showing which onboard controllers and sensors have an error (or are operational). Value of 0: error. Value of 1: healthy.

SYSTEM_TIME (2)

The system time is the time of the sender's master clock.

This can be emitted by flight controllers, onboard computers, or other components in the MAVLink network. Components that are using a less reliable time source, such as a battery-backed real time clock, can choose to match their system clock to that of a system that indicates a more recent time. This allows more broadly accurate date stamping of logs, and so on. If precise time synchronization is needed then use TIMESYNC instead.

Field Name Type Units 描述
time_unix_usec uint64_t us Timestamp (UNIX epoch time).
time_boot_ms uint32_t ms Timestamp (time since system boot).

PING (4) — [SUP]

SUPERSEDED: Replaced By TIMESYNC (2011-08) — To be removed / merged with TIMESYNC)

A ping message either requesting or responding to a ping. This allows to measure the system latencies, including serial port, radio modem and UDP connections. The ping microservice is documented at https://mavlink.io/en/services/ping.html

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
seq uint32_t PING sequence
target_system uint8_t 0: request ping from all receiving systems. If greater than 0: message is a ping response and number is the system id of the requesting system
target_component uint8_t 0: request ping from all receiving components. If greater than 0: message is a ping response and number is the component id of the requesting component.

CHANGE_OPERATOR_CONTROL (5)

Request to control this MAV

Field Name Type 描述
target_system uint8_t System the GCS requests control for
control_request uint8_t 0: request control of this MAV, 1: Release control of this MAV
version uint8_t 0: key as plaintext, 1-255: future, different hashing/encryption variants. The GCS should in general use the safest mode possible initially and then gradually move down the encryption level if it gets a NACK message indicating an encryption mismatch.
passkey char[25] Password / Key, depending on version plaintext or encrypted. 25 or less characters, NULL terminated. The characters may involve A-Z, a-z, 0-9, and "!?,.-"

CHANGE_OPERATOR_CONTROL_ACK (6)

Accept / deny control of this MAV

Field Name Type 描述
gcs_system_id uint8_t ID of the GCS this message
control_request uint8_t 0: request control of this MAV, 1: Release control of this MAV
ack uint8_t 0: ACK, 1: NACK: Wrong passkey, 2: NACK: Unsupported passkey encryption method, 3: NACK: Already under control

AUTH_KEY (7)

Emit an encrypted signature / key identifying this system. PLEASE NOTE: This protocol has been kept simple, so transmitting the key requires an encrypted channel for true safety.

Field Name Type 描述
key charr[32] key

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Status generated in each node in the communication chain and injected into MAVLink stream.

Field Name Type Units 描述
timestamp uint64_t ms Timestamp (time since system boot).
tx_buf uint8_t % Remaining free transmit buffer space
rx_buf uint8_t % Remaining free receive buffer space
tx_rate uint32_t bytes/s Transmit rate
rx_rate uint32_t bytes/s Receive rate
rx_parse_err uint16_t bytes Number of bytes that could not be parsed correctly.
tx_overflows uint16_t bytes Transmit buffer overflows. This number wraps around as it reaches UINT16_MAX
rx_overflows uint16_t bytes Receive buffer overflows. This number wraps around as it reaches UINT16_MAX
messages_sent uint32_t Messages sent
messages_received uint32_t Messages received (estimated from counting seq)
messages_lost uint32_t Messages lost (estimated from counting seq)

SET_MODE (11) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_SET_MODE (2015-12) — Use COMMAND_LONG with MAV_CMD_DO_SET_MODE instead)

Set the system mode, as defined by enum MAV_MODE_FLAG. There is no target component id as the mode is by definition for the overall aircraft, not only for one component.

Field Name Type 描述
target_system uint8_t The system setting the mode
base_mode uint8_t MAV_MODE_FLAG The new base mode.
custom_mode uint32_t The new autopilot-specific mode. This field can be ignored by an autopilot.

PARAM_REQUEST_READ (20)

Request to read the onboard parameter with the param_id string id. Onboard parameters are stored as key[const char*] -> value[float]. This allows to send a parameter to any other component (such as the GCS) without the need of previous knowledge of possible parameter names. Thus the same GCS can store different parameters for different autopilots. See also https://mavlink.io/en/services/parameter.html for a full documentation of QGroundControl and IMU code.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
param_id char[16] Onboard parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_index int16_t Parameter index. Send -1 to use the param ID field as identifier (else the param id will be ignored)

PARAM_REQUEST_LIST (21)

Request all parameters of this component. After this request, all parameters are emitted. The parameter microservice is documented at https://mavlink.io/en/services/parameter.html

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID

PARAM_VALUE (22)

Emit the value of a onboard parameter. The inclusion of param_count and param_index in the message allows the recipient to keep track of received parameters and allows him to re-request missing parameters after a loss or timeout. The parameter microservice is documented at https://mavlink.io/en/services/parameter.html

Field Name Type 描述
param_id char[16] Onboard parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_value float Onboard parameter value
param_type uint8_t MAV_PARAM_TYPE Onboard parameter type.
param_count uint16_t Total number of onboard parameters
param_index uint16_t Index of this onboard parameter

PARAM_SET (23)

Set a parameter value (write new value to permanent storage).

The receiving component should acknowledge the new parameter value by broadcasting a PARAM_VALUE message (broadcasting ensures that multiple GCS all have an up-to-date list of all parameters). If the sending GCS did not receive a PARAM_VALUE within its timeout time, it should re-send the PARAM_SET message. The parameter microservice is documented at https://mavlink.io/en/services/parameter.html.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
param_id char[16] Onboard parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_value float Onboard parameter value
param_type uint8_t MAV_PARAM_TYPE Onboard parameter type.

GPS_RAW_INT (24)

The global position, as returned by the Global Positioning System (GPS). This is

NOT the global position estimate of the system, but rather a RAW sensor value. See message GLOBAL_POSITION_INT for the global position estimate.

Field Name Type Units Multiplier 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
fix_type uint8_t GPS_FIX_TYPE GPS fix type.
lat int32_t degE7 Latitude (WGS84, EGM96 ellipsoid)
lon int32_t degE7 Longitude (WGS84, EGM96 ellipsoid)
alt int32_t 毫米 Altitude (MSL). Positive for up. Note that virtually all GPS modules provide the MSL altitude in addition to the WGS84 altitude.
eph uint16_t 1E-2 invalid:UINT16_MAX GPS HDOP horizontal dilution of position (unitless * 100). If unknown, set to: UINT16_MAX
epv uint16_t 1E-2 invalid:UINT16_MAX GPS VDOP vertical dilution of position (unitless * 100). If unknown, set to: UINT16_MAX
vel uint16_t 厘米/秒 invalid:UINT16_MAX GPS ground speed. If unknown, set to: UINT16_MAX
cog uint16_t cdeg invalid:UINT16_MAX Course over ground (NOT heading, but direction of movement) in degrees * 100, 0.0..359.99 degrees. If unknown, set to: UINT16_MAX
satellites_visible uint8_t invalid:UINT8_MAX 可见卫星数量。 If unknown, set to UINT8_MAX
alt_ellipsoid ++ int32_t 毫米 Altitude (above WGS84, EGM96 ellipsoid). Positive for up.
h_acc ++ uint32_t 毫米 Position uncertainty.
v_acc ++ uint32_t 毫米 Altitude uncertainty.
vel_acc ++ uint32_t 毫米/秒 Speed uncertainty.
hdg_acc ++ uint32_t degE5 Heading / track uncertainty
yaw ++ uint16_t cdeg invalid:0 Yaw in earth frame from north. Use 0 if this GPS does not provide yaw. Use UINT16_MAX if this GPS is configured to provide yaw and is currently unable to provide it. Use 36000 for north.

GPS_STATUS (25)

The positioning status, as reported by GPS. This message is intended to display status information about each satellite visible to the receiver. See message GLOBAL_POSITION_INT for the global position estimate. This message can contain information for up to 20 satellites.

Field Name Type Units Multiplier 描述
satellites_visible uint8_t Number of satellites visible
satellite_prn uint8_t[20] Global satellite ID
satellite_used uint8_t[20] 0: Satellite not used, 1: used for localization
satellite_elevation uint8_t[20] Elevation (0: right on top of receiver, 90: on the horizon) of satellite
satellite_azimuth uint8_t[20] 360/255 Direction of satellite, 0: 0 deg, 255: 360 deg.
satellite_snr uint8_t[20] dB Signal to noise ratio of satellite

SCALED_IMU (26)

The RAW IMU readings for the usual 9DOF sensor setup. This message should contain the scaled values to the described units

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
xacc int16_t mG X acceleration
yacc int16_t mG Y acceleration
zacc int16_t mG Z acceleration
xgyro int16_t mrad/s Angular speed around X axis
ygyro int16_t mrad/s Angular speed around Y axis
zgyro int16_t mrad/s Angular speed around Z axis
xmag int16_t mgauss X Magnetic field
ymag int16_t mgauss Y Magnetic field
zmag int16_t mgauss Z Magnetic field
temperature ++ int16_t cdegC Temperature, 0: IMU does not provide temperature values. If the IMU is at 0C it must send 1 (0.01C).

RAW_IMU (27)

The RAW IMU readings for a 9DOF sensor, which is identified by the id (default IMU1). This message should always contain the true raw values without any scaling to allow data capture and system debugging.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
xacc int16_t X acceleration (raw)
yacc int16_t Y acceleration (raw)
zacc int16_t Z acceleration (raw)
xgyro int16_t Angular speed around X axis (raw)
ygyro int16_t Angular speed around Y axis (raw)
zgyro int16_t Angular speed around Z axis (raw)
xmag int16_t X Magnetic field (raw)
ymag int16_t Y Magnetic field (raw)
zmag int16_t Z Magnetic field (raw)
id ++ uint8_t Id. Ids are numbered from 0 and map to IMUs numbered from 1 (e.g. IMU1 will have a message with id=0)
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
temperature ++ int16_t cdegC Temperature, 0: IMU does not provide temperature values. If the IMU is at 0C it must send 1 (0.01C).

RAW_PRESSURE (28)

The RAW pressure readings for the typical setup of one absolute pressure and one differential pressure sensor. The sensor values should be the raw, UNSCALED ADC values.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
press_abs int16_t Absolute pressure (raw)
press_diff1 int16_t Differential pressure 1 (raw, 0 if nonexistent)
press_diff2 int16_t Differential pressure 2 (raw, 0 if nonexistent)
temperature int16_t Raw Temperature measurement (raw)

SCALED_PRESSURE (29)

The pressure readings for the typical setup of one absolute and differential pressure sensor. The units are as specified in each field.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
press_abs float hPa Absolute pressure
press_diff float hPa Differential pressure 1
temperature int16_t cdegC Absolute pressure temperature
temperature_press_diff ++ int16_t cdegC Differential pressure temperature (0, if not available). Report values of 0 (or 1) as 1 cdegC.

ATTITUDE (30)

The attitude in the aeronautical frame (right-handed, Z-down, Y-right, X-front, ZYX, intrinsic).

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
roll float rad Roll angle (-pi..+pi)
俯仰角 float rad Pitch angle (-pi..+pi)
yaw float rad Yaw angle (-pi..+pi)
rollspeed float rad/s Roll angular speed
pitchspeed float rad/s Pitch angular speed
yawspeed float rad/s Yaw angular speed

ATTITUDE_QUATERNION (31)

The attitude in the aeronautical frame (right-handed, Z-down, X-front, Y-right), expressed as quaternion. Quaternion order is w, x, y, z and a zero rotation would be expressed as (1 0 0 0).

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
q1 float Quaternion component 1, w (1 in null-rotation)
q2 float Quaternion component 2, x (0 in null-rotation)
q3 float Quaternion component 3, y (0 in null-rotation)
q4 float Quaternion component 4, z (0 in null-rotation)
rollspeed float rad/s Roll angular speed
pitchspeed float rad/s Pitch angular speed
yawspeed float rad/s Yaw angular speed
repr_offset_q ++ float[4] Rotation offset by which the attitude quaternion and angular speed vector should be rotated for user display (quaternion with [w, x, y, z] order, zero-rotation is [1, 0, 0, 0], send [0, 0, 0, 0] if field not supported). This field is intended for systems in which the reference attitude may change during flight. For example, tailsitters VTOLs rotate their reference attitude by 90 degrees between hover mode and fixed wing mode, thus repr_offset_q is equal to [1, 0, 0, 0] in hover mode and equal to [0.7071, 0, 0.7071, 0] in fixed wing mode.

LOCAL_POSITION_NED (32)

The filtered local position (e.g. fused computer vision and accelerometers). Coordinate frame is right-handed, Z-axis down (aeronautical frame, NED / north-east-down convention)

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
x float m X Position
y float m Y Position
z float m Z Position
vx float m/s X Speed
vy float m/s Y Speed
vz float m/s Z Speed

GLOBAL_POSITION_INT (33) — [from: standard]

The filtered global position (e.g. fused GPS and accelerometers). The position is in GPS-frame (right-handed, Z-up). It is designed as scaled integer message since the resolution of float is not sufficient.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
lat int32_t degE7 Latitude, expressed
lon int32_t degE7 Longitude, expressed
alt int32_t 毫米 Altitude (MSL). Note that virtually all GPS modules provide both WGS84 and MSL.
relative_alt int32_t 毫米 Altitude above home
vx int16_t 厘米/秒 Ground X Speed (Latitude, positive north)
vy int16_t 厘米/秒 Ground Y Speed (Longitude, positive east)
vz int16_t 厘米/秒 Ground Z Speed (Altitude, positive down)
hdg uint16_t cdeg Vehicle heading (yaw angle), 0.0..359.99 degrees. If unknown, set to: UINT16_MAX

RC_CHANNELS_SCALED (34)

The scaled values of the RC channels received: (-100%) -10000, (0%) 0, (100%) 10000. Channels that are inactive should be set to INT16_MAX.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
port uint8_t Servo output port (set of 8 outputs = 1 port). Flight stacks running on Pixhawk should use: 0 = MAIN, 1 = AUX.
chan1_scaled int16_t RC channel 1 value scaled.
chan2_scaled int16_t RC channel 2 value scaled.
chan3_scaled int16_t RC channel 3 value scaled.
chan4_scaled int16_t RC channel 4 value scaled.
chan5_scaled int16_t RC channel 5 value scaled.
chan6_scaled int16_t RC channel 6 value scaled.
chan7_scaled int16_t RC channel 7 value scaled.
chan8_scaled int16_t RC channel 8 value scaled.
rssi uint8_t Receive signal strength indicator in device-dependent units/scale. Values: [0-254], UINT8_MAX: invalid/unknown.

RC_CHANNELS_RAW (35)

The RAW values of the RC channels received. The standard PPM modulation is as follows: 1000 microseconds: 0%, 2000 microseconds: 100%. A value of UINT16_MAX implies the channel is unused. Individual receivers/transmitters might violate this specification.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
port uint8_t Servo output port (set of 8 outputs = 1 port). Flight stacks running on Pixhawk should use: 0 = MAIN, 1 = AUX.
chan1_raw uint16_t us RC channel 1 value.
chan2_raw uint16_t us RC channel 2 value.
chan3_raw uint16_t us RC channel 3 value.
chan4_raw uint16_t us RC channel 4 value.
chan5_raw uint16_t us RC channel 5 value.
chan6_raw uint16_t us RC channel 6 value.
chan7_raw uint16_t us RC channel 7 value.
chan8_raw uint16_t us RC channel 8 value.
rssi uint8_t Receive signal strength indicator in device-dependent units/scale. Values: [0-254], UINT8_MAX: invalid/unknown.

SERVO_OUTPUT_RAW (36)

Superseded by ACTUATOR_OUTPUT_STATUS. The RAW values of the servo outputs (for RC input from the remote, use the RC_CHANNELS messages). The standard PPM modulation is as follows: 1000 microseconds: 0%, 2000 microseconds: 100%.

Field Name Type Units 描述
time_usec uint32_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
port uint8_t Servo output port (set of 8 outputs = 1 port). Flight stacks running on Pixhawk should use: 0 = MAIN, 1 = AUX.
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
servo1_raw uint16_t us Servo output 1 value
servo2_raw uint16_t us Servo output 2 value
servo3_raw uint16_t us Servo output 3 value
servo4_raw uint16_t us Servo output 4 value
servo5_raw uint16_t us Servo output 5 value
servo6_raw uint16_t us Servo output 6 value
servo7_raw uint16_t us Servo output 7 value
servo8_raw uint16_t us Servo output 8 value
servo9_raw ++ uint16_t us Servo output 9 value
servo10_raw ++ uint16_t us Servo output 10 value
servo11_raw ++ uint16_t us Servo output 11 value
servo12_raw ++ uint16_t us Servo output 12 value
servo13_raw ++ uint16_t us Servo output 13 value
servo14_raw ++ uint16_t us Servo output 14 value
servo15_raw ++ uint16_t us Servo output 15 value
servo16_raw ++ uint16_t us Servo output 16 value

MISSION_REQUEST_PARTIAL_LIST (37)

Request a partial list of mission items from the system/component. https://mavlink.io/en/services/mission.html. If start and end index are the same, just send one waypoint.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
start_index int16_t Start index
end_index int16_t End index, -1 by default (-1: send list to end). Else a valid index of the list
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

MISSION_WRITE_PARTIAL_LIST (38)

This message is sent to the MAV to write a partial list. If start index == end index, only one item will be transmitted / updated. If the start index is NOT 0 and above the current list size, this request should be REJECTED!

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
start_index int16_t Start index. Must be smaller / equal to the largest index of the current onboard list.
end_index int16_t End index, equal or greater than start index.
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

MISSION_ITEM (39) — [DEP]

DEPRECATED: Replaced By MISSION_ITEM_INT (2020-06)

Message encoding a mission item.

This message is emitted to announce the presence of a mission item and to set a mission item on the system. The mission item can be either in x, y, z meters (type: LOCAL) or x:lat, y:lon, z:altitude. Local frame is Z-down, right handed (NED), global frame is Z-up, right handed (ENU). NaN may be used to indicate an optional/default value (e.g. to use the system's current latitude or yaw rather than a specific value). See also https://mavlink.io/en/services/mission.html.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
seq uint16_t 序列
frame uint8_t MAV_FRAME The coordinate system of the waypoint.
command uint16_t MAV_CMD The scheduled action for the waypoint.
current uint8_t false:0, true:1
autocontinue uint8_t Autocontinue to next waypoint. 0: false, 1: true. Set false to pause mission after the item completes.
param1 float PARAM1, see MAV_CMD enum
param2 float PARAM2, see MAV_CMD enum
param3 float PARAM3, see MAV_CMD enum
param4 float PARAM4, see MAV_CMD enum
x float PARAM5 / local: X coordinate, global: latitude
y float PARAM6 / local: Y coordinate, global: longitude
z float PARAM7 / local: Z coordinate, global: altitude (relative or absolute, depending on frame).
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

MISSION_REQUEST (40) — [DEP]

DEPRECATED: Replaced By MISSION_REQUEST_INT (2020-06) — A system that gets this request should respond with MISSION_ITEM_INT (as though MISSION_REQUEST_INT was received).)

Request the information of the mission item with the sequence number seq. The response of the system to this message should be a MISSION_ITEM message. https://mavlink.io/en/services/mission.html

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
seq uint16_t 序列
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

MISSION_SET_CURRENT (41) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_SET_MISSION_CURRENT (2022-08)

Set the mission item with sequence number seq as the current item and emit MISSION_CURRENT (whether or not the mission number changed). If a mission is currently being executed, the system will continue to this new mission item on the shortest path, skipping any intermediate mission items. Note that mission jump repeat counters are not reset (see MAV_CMD_DO_JUMP param2).

This message may trigger a mission state-machine change on some systems: for example from MISSION_STATE_NOT_STARTED or MISSION_STATE_PAUSED to MISSION_STATE_ACTIVE. If the system is in mission mode, on those systems this command might therefore start, restart or resume the mission. If the system is not in mission mode this message must not trigger a switch to mission mode.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
seq uint16_t 序列

MISSION_CURRENT (42)

Message that announces the sequence number of the current target mission item (that the system will fly towards/execute when the mission is running). This message should be streamed all the time (nominally at 1Hz). This message should be emitted following a call to MAV_CMD_DO_SET_MISSION_CURRENT or MISSION_SET_CURRENT.

Field Name Type 描述
seq uint16_t 序列
total ++ uint16_t invalid:UINT16_MAX Total number of mission items on vehicle (on last item, sequence == total). If the autopilot stores its home location as part of the mission this will be excluded from the total. 0: Not supported, UINT16_MAX if no mission is present on the vehicle.
mission_state ++ uint8_t invalid:0 MISSION_STATE Mission state machine state. MISSION_STATE_UNKNOWN if state reporting not supported.
mission_mode ++ uint8_t invalid:0 Vehicle is in a mode that can execute mission items or suspended. 0: Unknown, 1: In mission mode, 2: Suspended (not in mission mode).
mission_id ++ uint32_t invalid:0 Id of current on-vehicle mission plan, or 0 if IDs are not supported or there is no mission loaded. GCS can use this to track changes to the mission plan type. The same value is returned on mission upload (in the MISSION_ACK).
fence_id ++ uint32_t invalid:0 Id of current on-vehicle fence plan, or 0 if IDs are not supported or there is no fence loaded. GCS can use this to track changes to the fence plan type. The same value is returned on fence upload (in the MISSION_ACK).
rally_points_id ++ uint32_t invalid:0 Id of current on-vehicle rally point plan, or 0 if IDs are not supported or there are no rally points loaded. GCS can use this to track changes to the rally point plan type. The same value is returned on rally point upload (in the MISSION_ACK).

MISSION_REQUEST_LIST (43)

从系统/构成部分请求任务项目的总清单。

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

MISSION_COUNT (44)

This message is emitted as response to MISSION_REQUEST_LIST by the MAV and to initiate a write transaction. The GCS can then request the individual mission item based on the knowledge of the total number of waypoints.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
count uint16_t Number of mission items in the sequence
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.
opaque_id ++ uint32_t invalid:0 Id of current on-vehicle mission, fence, or rally point plan (on download from vehicle).
This field is used when downloading a plan from a vehicle to a GCS.
0 on upload to the vehicle from GCS.
0 if plan ids are not supported.
The current on-vehicle plan ids are streamed in [MISSION_CURRENT](#MISSION_CURRENT), allowing a GCS to determine if any part of the plan has changed and needs to be re-uploaded.
The ids are recalculated by the vehicle when any part of the on-vehicle plan changes (when a new plan is uploaded, the vehicle returns the new id to the GCS in MISSION_ACK).

MISSION_CLEAR_ALL (45)

Delete all mission items at once.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

MISSION_ITEM_REACHED (46)

A certain mission item has been reached. The system will either hold this position (or circle on the orbit) or (if the autocontinue on the WP was set) continue to the next waypoint.

Field Name Type 描述
seq uint16_t 序列

MISSION_ACK (47)

Acknowledgment message during waypoint handling. The type field states if this message is a positive ack (type=0) or if an error happened (type=non-zero).

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
type uint8_t MAV_MISSION_RESULT Mission result.
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.
opaque_id ++ uint32_t invalid:0 Id of new on-vehicle mission, fence, or rally point plan (on upload to vehicle).
The id is calculated and returned by a vehicle when a new plan is uploaded by a GCS.
The only requirement on the id is that it must change when there is any change to the on-vehicle plan type (there is no requirement that the id be globally unique).
0 on download from the vehicle to the GCS (on download the ID is set in MISSION_COUNT).
0 if plan ids are not supported.
The current on-vehicle plan ids are streamed in [MISSION_CURRENT](#MISSION_CURRENT), allowing a GCS to determine if any part of the plan has changed and needs to be re-uploaded.

SET_GPS_GLOBAL_ORIGIN (48) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_SET_GLOBAL_ORIGIN (2025-04)

Sets the GPS coordinates of the vehicle local origin (0,0,0) position. Vehicle should emit GPS_GLOBAL_ORIGIN irrespective of whether the origin is changed. This enables transform between the local coordinate frame and the global (GPS) coordinate frame, which may be necessary when (for example) indoor and outdoor settings are connected and the MAV should move from in- to outdoor.

Field Name Type Units 描述
target_system uint8_t System ID
latitude int32_t degE7 Latitude (WGS84)
longitude int32_t degE7 Longitude (WGS84)
altitude int32_t 毫米 Altitude (MSL). Positive for up.
time_usec ++ uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.

GPS_GLOBAL_ORIGIN (49)

Publishes the GPS coordinates of the vehicle local origin (0,0,0) position. Emitted whenever a new GPS-Local position mapping is requested or set - e.g. following SET_GPS_GLOBAL_ORIGIN message.

Field Name Type Units 描述
latitude int32_t degE7 Latitude (WGS84)
longitude int32_t degE7 Longitude (WGS84)
altitude int32_t 毫米 Altitude (MSL). Positive for up.
time_usec ++ uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.

PARAM_MAP_RC (50)

Bind a RC channel to a parameter. The parameter should change according to the RC channel value.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
param_id char[16] Onboard parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_index int16_t Parameter index. Send -1 to use the param ID field as identifier (else the param id will be ignored), send -2 to disable any existing map for this rc_channel_index.
parameter_rc_channel_index uint8_t Index of parameter RC channel. Not equal to the RC channel id. Typically corresponds to a potentiometer-knob on the RC.
param_value0 float Initial parameter value
scale float Scale, maps the RC range [-1, 1] to a parameter value
param_value_min float Minimum param value. The protocol does not define if this overwrites an onboard minimum value. (Depends on implementation)
param_value_max float Maximum param value. The protocol does not define if this overwrites an onboard maximum value. (Depends on implementation)

MISSION_REQUEST_INT (51)

Request the information of the mission item with the sequence number seq. The response of the system to this message should be a MISSION_ITEM_INT message. https://mavlink.io/en/services/mission.html

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
seq uint16_t 序列
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

SAFETY_SET_ALLOWED_AREA (54)

Set a safety zone (volume), which is defined by two corners of a cube. This message can be used to tell the MAV which setpoints/waypoints to accept and which to reject. Safety areas are often enforced by national or competition regulations.

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
frame uint8_t MAV_FRAME Coordinate frame. Can be either global, GPS, right-handed with Z axis up or local, right handed, Z axis down.
p1x float m x position 1 / Latitude 1
p1y float m y position 1 / Longitude 1
p1z float m z position 1 / Altitude 1
p2x float m x position 2 / Latitude 2
p2y float m y position 2 / Longitude 2
p2z float m z position 2 / Altitude 2

SAFETY_ALLOWED_AREA (55)

Read out the safety zone the MAV currently assumes.

Field Name Type Units 描述
frame uint8_t MAV_FRAME Coordinate frame. Can be either global, GPS, right-handed with Z axis up or local, right handed, Z axis down.
p1x float m x position 1 / Latitude 1
p1y float m y position 1 / Longitude 1
p1z float m z position 1 / Altitude 1
p2x float m x position 2 / Latitude 2
p2y float m y position 2 / Longitude 2
p2z float m z position 2 / Altitude 2

ATTITUDE_QUATERNION_COV (61)

The attitude in the aeronautical frame (right-handed, Z-down, X-front, Y-right), expressed as quaternion. Quaternion order is w, x, y, z and a zero rotation would be expressed as (1 0 0 0).

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
q float[4] Quaternion components, w, x, y, z (1 0 0 0 is the null-rotation)
rollspeed float rad/s Roll angular speed
pitchspeed float rad/s Pitch angular speed
yawspeed float rad/s Yaw angular speed
covariance float[9] Row-major representation of a 3x3 attitude covariance matrix (states: roll, pitch, yaw; first three entries are the first ROW, next three entries are the second row, etc.). If unknown, assign NaN value to first element in the array.

NAV_CONTROLLER_OUTPUT (62)

The state of the navigation and position controller.

Field Name Type Units 描述
nav_roll float Current desired roll
nav_pitch float Current desired pitch
nav_bearing int16_t Current desired heading
target_bearing int16_t Bearing to current waypoint/target
wp_dist uint16_t m Distance to active waypoint
alt_error float m Current altitude error
aspd_error float m/s Current airspeed error
xtrack_error float m Current crosstrack error on x-y plane

GLOBAL_POSITION_INT_COV (63)

The filtered global position (e.g. fused GPS and accelerometers). The position is in GPS-frame (right-handed, Z-up). It is designed as scaled integer message since the resolution of float is not sufficient. NOTE: This message is intended for onboard networks / companion computers and higher-bandwidth links and optimized for accuracy and completeness. Please use the GLOBAL_POSITION_INT message for a minimal subset.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
estimator_type uint8_t MAV_ESTIMATOR_TYPE Class id of the estimator this estimate originated from.
lat int32_t degE7 Latitude
lon int32_t degE7 Longitude
alt int32_t 毫米 Altitude in meters above MSL
relative_alt int32_t 毫米 Altitude above ground
vx float m/s Ground X Speed (Latitude)
vy float m/s Ground Y Speed (Longitude)
vz float m/s Ground Z Speed (Altitude)
covariance float[36] invalid:[NaN:] Row-major representation of a 6x6 position and velocity 6x6 cross-covariance matrix (states: lat, lon, alt, vx, vy, vz; first six entries are the first ROW, next six entries are the second row, etc.). If unknown, assign NaN value to first element in the array.

LOCAL_POSITION_NED_COV (64)

The filtered local position (e.g. fused computer vision and accelerometers). Coordinate frame is right-handed, Z-axis down (aeronautical frame, NED / north-east-down convention)

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
estimator_type uint8_t MAV_ESTIMATOR_TYPE Class id of the estimator this estimate originated from.
x float m X Position
y float m Y Position
z float m Z Position
vx float m/s X Speed
vy float m/s Y Speed
vz float m/s Z Speed
ax float m/s/s X Acceleration
ay float m/s/s Y Acceleration
az float m/s/s Z Acceleration
covariance float[45] invalid:[NaN:] Row-major representation of position, velocity and acceleration 9x9 cross-covariance matrix upper right triangle (states: x, y, z, vx, vy, vz, ax, ay, az; first nine entries are the first ROW, next eight entries are the second row, etc.). If unknown, assign NaN value to first element in the array.

RC_CHANNELS (65)

The PPM values of the RC channels received. The standard PPM modulation is as follows: 1000 microseconds: 0%, 2000 microseconds: 100%. A value of UINT16_MAX implies the channel is unused. Individual receivers/transmitters might violate this specification.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
chancount uint8_t Total number of RC channels being received. This can be larger than 18, indicating that more channels are available but not given in this message. This value should be 0 when no RC channels are available.
chan1_raw uint16_t us RC channel 1 value.
chan2_raw uint16_t us RC channel 2 value.
chan3_raw uint16_t us RC channel 3 value.
chan4_raw uint16_t us RC channel 4 value.
chan5_raw uint16_t us RC channel 5 value.
chan6_raw uint16_t us RC channel 6 value.
chan7_raw uint16_t us RC channel 7 value.
chan8_raw uint16_t us RC channel 8 value.
chan9_raw uint16_t us RC channel 9 value.
chan10_raw uint16_t us RC channel 10 value.
chan11_raw uint16_t us RC channel 11 value.
chan12_raw uint16_t us RC channel 12 value.
chan13_raw uint16_t us RC channel 13 value.
chan14_raw uint16_t us RC channel 14 value.
chan15_raw uint16_t us RC channel 15 value.
chan16_raw uint16_t us RC channel 16 value.
chan17_raw uint16_t us RC channel 17 value.
chan18_raw uint16_t us RC channel 18 value.
rssi uint8_t Receive signal strength indicator in device-dependent units/scale. Values: [0-254], UINT8_MAX: invalid/unknown.

REQUEST_DATA_STREAM (66) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_SET_MESSAGE_INTERVAL (2015-08)

Request a data stream.

Field Name Type Units 描述
target_system uint8_t The target requested to send the message stream.
target_component uint8_t The target requested to send the message stream.
req_stream_id uint8_t MAV_DATA_STREAM The ID of the requested data stream.
req_message_rate uint16_t Hz The requested message rate
start_stop uint8_t 1 to start sending, 0 to stop sending.

DATA_STREAM (67) — [SUP]

SUPERSEDED: Replaced By MESSAGE_INTERVAL (2015-08)

Data stream status information.

Field Name Type Units 描述
stream_id uint8_t MAV_DATA_STREAM The ID of the requested data stream.
message_rate uint16_t Hz The message rate
on_off uint8_t 1 stream is enabled, 0 stream is stopped.

MANUAL_CONTROL (69)

Manual (joystick) control message.

This message represents movement axes and button using standard joystick axes nomenclature. Unused axes can be disabled and buttons states are transmitted as individual on/off bits of a bitmask. For more information see https://mavlink.io/en/services/manual_control.html

Field Name Type 描述
target uint8_t The system to be controlled.
x int16_t X-axis, normalized to the range [-1000,1000]. A value of INT16_MAX indicates that this axis is invalid. Generally corresponds to forward(1000)-backward(-1000) movement on a joystick and the pitch of a vehicle.
y int16_t Y-axis, normalized to the range [-1000,1000]. A value of INT16_MAX indicates that this axis is invalid. Generally corresponds to left(-1000)-right(1000) movement on a joystick and the roll of a vehicle.
z int16_t Z-axis, normalized to the range [-1000,1000]. A value of INT16_MAX indicates that this axis is invalid. Generally corresponds to a separate slider movement with maximum being 1000 and minimum being -1000 on a joystick and the thrust of a vehicle. Positive values are positive thrust, negative values are negative thrust.
r int16_t R-axis, normalized to the range [-1000,1000]. A value of INT16_MAX indicates that this axis is invalid. Generally corresponds to a twisting of the joystick, with clockwise being 1000 and counter-clockwise being -1000, and the yaw of a vehicle.
buttons uint16_t A bitfield corresponding to the joystick buttons' 0-15 current state, 1 for pressed, 0 for released. The lowest bit corresponds to Button 1.
buttons2 ++ uint16_t A bitfield corresponding to the joystick buttons' 16-31 current state, 1 for pressed, 0 for released. The lowest bit corresponds to Button 16.
enabled_extensions ++ uint8_t Set bits to 1 to indicate which of the following extension fields contain valid data: bit 0: pitch, bit 1: roll, bit 2: aux1, bit 3: aux2, bit 4: aux3, bit 5: aux4, bit 6: aux5, bit 7: aux6
s ++ int16_t Pitch-only-axis, normalized to the range [-1000,1000]. Generally corresponds to pitch on vehicles with additional degrees of freedom. Valid if bit 0 of enabled_extensions field is set. Set to 0 if invalid.
t ++ int16_t Roll-only-axis, normalized to the range [-1000,1000]. Generally corresponds to roll on vehicles with additional degrees of freedom. Valid if bit 1 of enabled_extensions field is set. Set to 0 if invalid.
aux1 ++ int16_t Aux continuous input field 1. Normalized in the range [-1000,1000]. Purpose defined by recipient. Valid data if bit 2 of enabled_extensions field is set. 0 if bit 2 is unset.
aux2 ++ int16_t Aux continuous input field 2. Normalized in the range [-1000,1000]. Purpose defined by recipient. Valid data if bit 3 of enabled_extensions field is set. 0 if bit 3 is unset.
aux3 ++ int16_t Aux continuous input field 3. Normalized in the range [-1000,1000]. Purpose defined by recipient. Valid data if bit 4 of enabled_extensions field is set. 0 if bit 4 is unset.
aux4 ++ int16_t Aux continuous input field 4. Normalized in the range [-1000,1000]. Purpose defined by recipient. Valid data if bit 5 of enabled_extensions field is set. 0 if bit 5 is unset.
aux5 ++ int16_t Aux continuous input field 5. Normalized in the range [-1000,1000]. Purpose defined by recipient. Valid data if bit 6 of enabled_extensions field is set. 0 if bit 6 is unset.
aux6 ++ int16_t Aux continuous input field 6. Normalized in the range [-1000,1000]. Purpose defined by recipient. Valid data if bit 7 of enabled_extensions field is set. 0 if bit 7 is unset.

RC_CHANNELS_OVERRIDE (70)

The RAW values of the RC channels sent to the MAV to override info received from the RC radio. The standard PPM modulation is as follows: 1000 microseconds: 0%, 2000 microseconds: 100%. Individual receivers/transmitters might violate this specification. Note carefully the semantic differences between the first 8 channels and the subsequent channels

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
chan1_raw uint16_t us RC channel 1 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan2_raw uint16_t us RC channel 2 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan3_raw uint16_t us RC channel 3 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan4_raw uint16_t us RC channel 4 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan5_raw uint16_t us RC channel 5 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan6_raw uint16_t us RC channel 6 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan7_raw uint16_t us RC channel 7 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan8_raw uint16_t us RC channel 8 value. A value of UINT16_MAX means to ignore this field. A value of 0 means to release this channel back to the RC radio.
chan9_raw ++ uint16_t us RC channel 9 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan10_raw ++ uint16_t us RC channel 10 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan11_raw ++ uint16_t us RC channel 11 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan12_raw ++ uint16_t us RC channel 12 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan13_raw ++ uint16_t us RC channel 13 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan14_raw ++ uint16_t us RC channel 14 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan15_raw ++ uint16_t us RC channel 15 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan16_raw ++ uint16_t us RC channel 16 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan17_raw ++ uint16_t us RC channel 17 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.
chan18_raw ++ uint16_t us RC channel 18 value. A value of 0 or UINT16_MAX means to ignore this field. A value of UINT16_MAX-1 means to release this channel back to the RC radio.

MISSION_ITEM_INT (73)

Message encoding a mission item. This message is emitted to announce

the presence of a mission item and to set a mission item on the system. The mission item can be either in x, y, z meters (type: LOCAL) or x:lat, y:lon, z:altitude. Local frame is Z-down, right handed (NED), global frame is Z-up, right handed (ENU). NaN or INT32_MAX may be used in float/integer params (respectively) to indicate optional/default values (e.g. to use the component's current latitude, yaw rather than a specific value). See also https://mavlink.io/en/services/mission.html.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
seq uint16_t Waypoint ID (sequence number). Starts at zero. Increases monotonically for each waypoint, no gaps in the sequence (0,1,2,3,4).
frame uint8_t MAV_FRAME The coordinate system of the waypoint.
command uint16_t MAV_CMD The scheduled action for the waypoint.
current uint8_t false:0, true:1
autocontinue uint8_t Autocontinue to next waypoint. 0: false, 1: true. Set false to pause mission after the item completes.
param1 float PARAM1, see MAV_CMD enum
param2 float PARAM2, see MAV_CMD enum
param3 float PARAM3, see MAV_CMD enum
param4 float PARAM4, see MAV_CMD enum
x int32_t PARAM5 / local: x position in meters * 1e4, global: latitude in degrees * 10^7
y int32_t PARAM6 / y position: local: x position in meters * 1e4, global: longitude in degrees *10^7
z float PARAM7 / z position: global: altitude in meters (relative or absolute, depending on frame.
mission_type ++ uint8_t MAV_MISSION_TYPE Mission type.

VFR_HUD (74)

Metrics typically displayed on a HUD for fixed wing aircraft.

Field Name Type Units 描述
airspeed float m/s Vehicle speed in form appropriate for vehicle type. For standard aircraft this is typically calibrated airspeed (CAS) or indicated airspeed (IAS) - either of which can be used by a pilot to estimate stall speed.
groundspeed float m/s Current ground speed.
heading int16_t Current heading in compass units (0-360, 0=north).
油门 uint16_t % Current throttle setting (0 to 100).
alt float m Current altitude (MSL).
climb float m/s Current climb rate.

COMMAND_INT (75)

Send a command with up to seven parameters to the MAV, where params 5 and 6 are integers and the other values are floats. This is preferred over COMMAND_LONG as it allows the MAV_FRAME to be specified for interpreting positional information, such as altitude. COMMAND_INT is also preferred when sending latitude and longitude data in params 5 and 6, as it allows for greater precision. Param 5 and 6 encode positional data as scaled integers, where the scaling depends on the actual command value. NaN or INT32_MAX may be used in float/integer params (respectively) to indicate optional/default values (e.g. to use the component's current latitude, yaw rather than a specific value). The command microservice is documented at https://mavlink.io/en/services/command.html

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
frame uint8_t MAV_FRAME The coordinate system of the COMMAND.
command uint16_t MAV_CMD The scheduled action for the mission item.
current uint8_t Not used.
autocontinue uint8_t Not used (set 0).
param1 float invalid:NaN PARAM1, see MAV_CMD enum
param2 float invalid:NaN PARAM2, see MAV_CMD enum
param3 float invalid:NaN PARAM3, see MAV_CMD enum
param4 float invalid:NaN PARAM4, see MAV_CMD enum
x int32_t invalid:INT32_MAX PARAM5 / local: x position in meters * 1e4, global: latitude in degrees * 10^7
y int32_t invalid:INT32_MAX PARAM6 / local: y position in meters * 1e4, global: longitude in degrees * 10^7
z float invalid:NaN PARAM7 / z position: global: altitude in meters (relative or absolute, depending on frame).

COMMAND_LONG (76)

Send a command with up to seven parameters to the MAV. COMMAND_INT is generally preferred when sending MAV_CMD commands that include positional information; it offers higher precision and allows the MAV_FRAME to be specified (which may otherwise be ambiguous, particularly for altitude). The command microservice is documented at https://mavlink.io/en/services/command.html

Field Name Type 描述
target_system uint8_t System which should execute the command
target_component uint8_t Component which should execute the command, 0 for all components
command uint16_t MAV_CMD Command ID (of command to send).
confirmation uint8_t 0: First transmission of this command. 1-255: Confirmation transmissions (e.g. for kill command)
param1 float invalid:NaN Parameter 1 (for the specific command).
param2 float invalid:NaN Parameter 2 (for the specific command).
param3 float invalid:NaN Parameter 3 (for the specific command).
param4 float invalid:NaN Parameter 4 (for the specific command).
param5 float invalid:NaN Parameter 5 (for the specific command).
param6 float invalid:NaN Parameter 6 (for the specific command).
param7 float invalid:NaN Parameter 7 (for the specific command).

COMMAND_ACK (77)

Report status of a command. Includes feedback whether the command was executed. The command microservice is documented at https://mavlink.io/en/services/command.html

Field Name Type Units 描述
command uint16_t MAV_CMD Command ID (of acknowledged command).
result uint8_t MAV_RESULT Result of command.
progress ++ uint8_t % invalid:UINT8_MAX The progress percentage when result is MAV_RESULT_IN_PROGRESS. Values: [0-100], or UINT8_MAX if the progress is unknown.
result_param2 ++ int32_t Additional result information. Can be set with a command-specific enum containing command-specific error reasons for why the command might be denied. If used, the associated enum must be documented in the corresponding MAV_CMD (this enum should have a 0 value to indicate "unused" or "unknown").
target_system ++ uint8_t System ID of the target recipient. This is the ID of the system that sent the command for which this COMMAND_ACK is an acknowledgement.
target_component ++ uint8_t Component ID of the target recipient. This is the ID of the system that sent the command for which this COMMAND_ACK is an acknowledgement.

COMMAND_CANCEL (80) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Cancel a long running command. The target system should respond with a COMMAND_ACK to the original command with result=MAV_RESULT_CANCELLED if the long running process was cancelled. If it has already completed, the cancel action can be ignored. The cancel action can be retried until some sort of acknowledgement to the original command has been received. The command microservice is documented at https://mavlink.io/en/services/command.html

Field Name Type 描述
target_system uint8_t System executing long running command. Should not be broadcast (0).
target_component uint8_t Component executing long running command.
command uint16_t MAV_CMD Command ID (of command to cancel).

MANUAL_SETPOINT (81)

Setpoint in roll, pitch, yaw and thrust from the operator

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
roll float rad/s Desired roll rate
俯仰角 float rad/s Desired pitch rate
yaw float rad/s Desired yaw rate
thrust float Collective thrust, normalized to 0 .. 1
mode_switch uint8_t Flight mode switch position, 0.. 255
manual_override_switch uint8_t Override mode switch position, 0.. 255

SET_ATTITUDE_TARGET (82)

Sets a desired vehicle attitude. Used by an external controller to command the vehicle (manual controller or other system).

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
target_system uint8_t System ID
target_component uint8_t Component ID
type_mask uint8_t ATTITUDE_TARGET_TYPEMASK Bitmap to indicate which dimensions should be ignored by the vehicle.
q float[4] Attitude quaternion (w, x, y, z order, zero-rotation is 1, 0, 0, 0) from MAV_FRAME_LOCAL_NED to MAV_FRAME_BODY_FRD
body_roll_rate float rad/s Body roll rate
body_pitch_rate float rad/s Body pitch rate
body_yaw_rate float rad/s Body yaw rate
thrust float Collective thrust, normalized to 0 .. 1 (-1 .. 1 for vehicles capable of reverse thrust)
thrust_body ++ float[3] 3D thrust setpoint in the body NED frame, normalized to -1 .. 1

ATTITUDE_TARGET (83)

Reports the current commanded attitude of the vehicle as specified by the autopilot. This should match the commands sent in a SET_ATTITUDE_TARGET message if the vehicle is being controlled this way.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
type_mask uint8_t ATTITUDE_TARGET_TYPEMASK Bitmap to indicate which dimensions should be ignored by the vehicle.
q float[4] Attitude quaternion (w, x, y, z order, zero-rotation is 1, 0, 0, 0)
body_roll_rate float rad/s Body roll rate
body_pitch_rate float rad/s Body pitch rate
body_yaw_rate float rad/s Body yaw rate
thrust float Collective thrust, normalized to 0 .. 1 (-1 .. 1 for vehicles capable of reverse thrust)

SET_POSITION_TARGET_LOCAL_NED (84)

Sets a desired vehicle position in a local north-east-down coordinate frame. Used by an external controller to command the vehicle (manual controller or other system).

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
target_system uint8_t System ID
target_component uint8_t Component ID
coordinate_frame uint8_t MAV_FRAME Valid options are: MAV_FRAME_LOCAL_NED = 1, MAV_FRAME_LOCAL_OFFSET_NED = 7, MAV_FRAME_BODY_NED = 8, MAV_FRAME_BODY_OFFSET_NED = 9
type_mask uint16_t POSITION_TARGET_TYPEMASK Bitmap to indicate which dimensions should be ignored by the vehicle.
x float m X Position in NED frame
y float m Y Position in NED frame
z float m Z Position in NED frame (note, altitude is negative in NED)
vx float m/s X velocity in NED frame
vy float m/s Y velocity in NED frame
vz float m/s Z velocity in NED frame
afx float m/s/s X acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afy float m/s/s Y acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afz float m/s/s Z acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
yaw float rad yaw setpoint
yaw_rate float rad/s yaw rate setpoint

POSITION_TARGET_LOCAL_NED (85)

Reports the current commanded vehicle position, velocity, and acceleration as specified by the autopilot. This should match the commands sent in SET_POSITION_TARGET_LOCAL_NED if the vehicle is being controlled this way.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
coordinate_frame uint8_t MAV_FRAME Valid options are: MAV_FRAME_LOCAL_NED = 1, MAV_FRAME_LOCAL_OFFSET_NED = 7, MAV_FRAME_BODY_NED = 8, MAV_FRAME_BODY_OFFSET_NED = 9
type_mask uint16_t POSITION_TARGET_TYPEMASK Bitmap to indicate which dimensions should be ignored by the vehicle.
x float m X Position in NED frame
y float m Y Position in NED frame
z float m Z Position in NED frame (note, altitude is negative in NED)
vx float m/s X velocity in NED frame
vy float m/s Y velocity in NED frame
vz float m/s Z velocity in NED frame
afx float m/s/s X acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afy float m/s/s Y acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afz float m/s/s Z acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
yaw float rad yaw setpoint
yaw_rate float rad/s yaw rate setpoint

SET_POSITION_TARGET_GLOBAL_INT (86)

Sets a desired vehicle position, velocity, and/or acceleration in a global coordinate system (WGS84). Used by an external controller to command the vehicle (manual controller or other system).

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot). The rationale for the timestamp in the setpoint is to allow the system to compensate for the transport delay of the setpoint. This allows the system to compensate processing latency.
target_system uint8_t System ID
target_component uint8_t Component ID
coordinate_frame uint8_t MAV_FRAME Valid options are: MAV_FRAME_GLOBAL = 0, MAV_FRAME_GLOBAL_RELATIVE_ALT = 3, MAV_FRAME_GLOBAL_TERRAIN_ALT = 10 (MAV_FRAME_GLOBAL_INT, MAV_FRAME_GLOBAL_RELATIVE_ALT_INT, MAV_FRAME_GLOBAL_TERRAIN_ALT_INT are allowed synonyms, but have been deprecated)
type_mask uint16_t POSITION_TARGET_TYPEMASK Bitmap to indicate which dimensions should be ignored by the vehicle.
lat_int int32_t degE7 Latitude in WGS84 frame
lon_int int32_t degE7 Longitude in WGS84 frame
alt float m Altitude (MSL, Relative to home, or AGL - depending on frame)
vx float m/s X velocity in NED frame
vy float m/s Y velocity in NED frame
vz float m/s Z velocity in NED frame
afx float m/s/s X acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afy float m/s/s Y acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afz float m/s/s Z acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
yaw float rad yaw setpoint
yaw_rate float rad/s yaw rate setpoint

POSITION_TARGET_GLOBAL_INT (87)

Reports the current commanded vehicle position, velocity, and acceleration as specified by the autopilot. This should match the commands sent in SET_POSITION_TARGET_GLOBAL_INT if the vehicle is being controlled this way.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot). The rationale for the timestamp in the setpoint is to allow the system to compensate for the transport delay of the setpoint. This allows the system to compensate processing latency.
coordinate_frame uint8_t MAV_FRAME Valid options are: MAV_FRAME_GLOBAL = 0, MAV_FRAME_GLOBAL_RELATIVE_ALT = 3, MAV_FRAME_GLOBAL_TERRAIN_ALT = 10 (MAV_FRAME_GLOBAL_INT, MAV_FRAME_GLOBAL_RELATIVE_ALT_INT, MAV_FRAME_GLOBAL_TERRAIN_ALT_INT are allowed synonyms, but have been deprecated)
type_mask uint16_t POSITION_TARGET_TYPEMASK Bitmap to indicate which dimensions should be ignored by the vehicle.
lat_int int32_t degE7 Latitude in WGS84 frame
lon_int int32_t degE7 Longitude in WGS84 frame
alt float m Altitude (MSL, AGL or relative to home altitude, depending on frame)
vx float m/s X velocity in NED frame
vy float m/s Y velocity in NED frame
vz float m/s Z velocity in NED frame
afx float m/s/s X acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afy float m/s/s Y acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
afz float m/s/s Z acceleration or force (if bit 10 of type_mask is set) in NED frame in meter / s^2 or N
yaw float rad yaw setpoint
yaw_rate float rad/s yaw rate setpoint

LOCAL_POSITION_NED_SYSTEM_GLOBAL_OFFSET (89)

The offset in X, Y, Z and yaw between the LOCAL_POSITION_NED messages of MAV X and the global coordinate frame in NED coordinates. Coordinate frame is right-handed, Z-axis down (aeronautical frame, NED / north-east-down convention)

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
x float m X Position
y float m Y Position
z float m Z Position
roll float rad Roll
俯仰角 float rad Pitch
yaw float rad Yaw

HIL_STATE (90) — [SUP]

SUPERSEDED: Replaced By HIL_STATE_QUATERNION (2013-07) — Suffers from missing airspeed fields and singularities due to Euler angles)

Sent from simulation to autopilot. This packet is useful for high throughput applications such as hardware in the loop simulations.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
roll float rad Roll angle
俯仰角 float rad Pitch angle
yaw float rad Yaw angle
rollspeed float rad/s Body frame roll / phi angular speed
pitchspeed float rad/s Body frame pitch / theta angular speed
yawspeed float rad/s Body frame yaw / psi angular speed
lat int32_t degE7 Latitude
lon int32_t degE7 Longitude
alt int32_t 毫米 Altitude
vx int16_t 厘米/秒 Ground X Speed (Latitude)
vy int16_t 厘米/秒 Ground Y Speed (Longitude)
vz int16_t 厘米/秒 Ground Z Speed (Altitude)
xacc int16_t mG X acceleration
yacc int16_t mG Y acceleration
zacc int16_t mG Z acceleration

HIL_CONTROLS (91)

Sent from autopilot to simulation. Hardware in the loop control outputs. Alternative to HIL_ACTUATOR_CONTROLS.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
roll_ailerons float Control output -1 .. 1
pitch_elevator float Control output -1 .. 1
yaw_rudder float Control output -1 .. 1
油门 float Throttle 0 .. 1
aux1 float Aux 1, -1 .. 1
aux2 float Aux 2, -1 .. 1
aux3 float Aux 3, -1 .. 1
aux4 float Aux 4, -1 .. 1
模式 uint8_t MAV_MODE System mode.
导航模式 uint8_t Navigation mode (MAV_NAV_MODE)

HIL_RC_INPUTS_RAW (92)

Sent from simulation to autopilot. The RAW values of the RC channels received. The standard PPM modulation is as follows: 1000 microseconds: 0%, 2000 microseconds: 100%. Individual receivers/transmitters might violate this specification.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
chan1_raw uint16_t us RC channel 1 value
chan2_raw uint16_t us RC channel 2 value
chan3_raw uint16_t us RC channel 3 value
chan4_raw uint16_t us RC channel 4 value
chan5_raw uint16_t us RC channel 5 value
chan6_raw uint16_t us RC channel 6 value
chan7_raw uint16_t us RC channel 7 value
chan8_raw uint16_t us RC channel 8 value
chan9_raw uint16_t us RC channel 9 value
chan10_raw uint16_t us RC channel 10 value
chan11_raw uint16_t us RC channel 11 value
chan12_raw uint16_t us RC channel 12 value
rssi uint8_t Receive signal strength indicator in device-dependent units/scale. Values: [0-254], UINT8_MAX: invalid/unknown.

HIL_ACTUATOR_CONTROLS (93)

Sent from autopilot to simulation. Hardware in the loop control outputs. Alternative to HIL_CONTROLS.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
controls float[16] Control outputs -1 .. 1. Channel assignment depends on the simulated hardware.
模式 uint8_t MAV_MODE_FLAG System mode. Includes arming state.
flags uint64_t HIL_ACTUATOR_CONTROLS_FLAGS Flags bitmask.

OPTICAL_FLOW (100)

Optical flow from a flow sensor (e.g. optical mouse sensor)

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
sensor_id uint8_t Sensor ID
flow_x int16_t dpix Flow in x-sensor direction
flow_y int16_t dpix Flow in y-sensor direction
flow_comp_m_x float m/s Flow in x-sensor direction, angular-speed compensated
flow_comp_m_y float m/s Flow in y-sensor direction, angular-speed compensated
quality uint8_t Optical flow quality / confidence. 0: bad, 255: maximum quality
ground_distance float m Ground distance. Positive value: distance known. Negative value: Unknown distance
flow_rate_x ++ float rad/s Flow rate about X axis
flow_rate_y ++ float rad/s Flow rate about Y axis

GLOBAL_VISION_POSITION_ESTIMATE (101)

Global position/attitude estimate from a vision source.

Field Name Type Units 描述
usec uint64_t us Timestamp (UNIX time or since system boot)
x float m Global X position
y float m Global Y position
z float m Global Z position
roll float rad Roll angle
俯仰角 float rad Pitch angle
yaw float rad Yaw angle
covariance ++ float[21] Row-major representation of pose 6x6 cross-covariance matrix upper right triangle (states: x_global, y_global, z_global, roll, pitch, yaw; first six entries are the first ROW, next five entries are the second ROW, etc.). If unknown, assign NaN value to first element in the array.
reset_counter ++ uint8_t Estimate reset counter. This should be incremented when the estimate resets in any of the dimensions (position, velocity, attitude, angular speed). This is designed to be used when e.g an external SLAM system detects a loop-closure and the estimate jumps.

VISION_POSITION_ESTIMATE (102)

Local position/attitude estimate from a vision source.

Field Name Type Units 描述
usec uint64_t us Timestamp (UNIX time or time since system boot)
x float m Local X position
y float m Local Y position
z float m Local Z position
roll float rad Roll angle
俯仰角 float rad Pitch angle
yaw float rad Yaw angle
covariance ++ float[21] Row-major representation of pose 6x6 cross-covariance matrix upper right triangle (states: x, y, z, roll, pitch, yaw; first six entries are the first ROW, next five entries are the second ROW, etc.). If unknown, assign NaN value to first element in the array.
reset_counter ++ uint8_t Estimate reset counter. This should be incremented when the estimate resets in any of the dimensions (position, velocity, attitude, angular speed). This is designed to be used when e.g an external SLAM system detects a loop-closure and the estimate jumps.

VISION_SPEED_ESTIMATE (103)

Speed estimate from a vision source.

Field Name Type Units 描述
usec uint64_t us Timestamp (UNIX time or time since system boot)
x float m/s Global X speed
y float m/s Global Y speed
z float m/s Global Z speed
covariance ++ float[9] Row-major representation of 3x3 linear velocity covariance matrix (states: vx, vy, vz; 1st three entries - 1st row, etc.). If unknown, assign NaN value to first element in the array.
reset_counter ++ uint8_t Estimate reset counter. This should be incremented when the estimate resets in any of the dimensions (position, velocity, attitude, angular speed). This is designed to be used when e.g an external SLAM system detects a loop-closure and the estimate jumps.

VICON_POSITION_ESTIMATE (104)

Global position estimate from a Vicon motion system source.

Field Name Type Units 描述
usec uint64_t us Timestamp (UNIX time or time since system boot)
x float m Global X position
y float m Global Y position
z float m Global Z position
roll float rad Roll angle
俯仰角 float rad Pitch angle
yaw float rad Yaw angle
covariance ++ float[21] Row-major representation of 6x6 pose cross-covariance matrix upper right triangle (states: x, y, z, roll, pitch, yaw; first six entries are the first ROW, next five entries are the second ROW, etc.). If unknown, assign NaN value to first element in the array.

HIGHRES_IMU (105)

The IMU readings in SI units in NED body frame

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
xacc float m/s/s X acceleration
yacc float m/s/s Y acceleration
zacc float m/s/s Z acceleration
xgyro float rad/s Angular speed around X axis
ygyro float rad/s Angular speed around Y axis
zgyro float rad/s Angular speed around Z axis
xmag float gauss X Magnetic field
ymag float gauss Y Magnetic field
zmag float gauss Z Magnetic field
abs_pressure float hPa Absolute pressure
diff_pressure float hPa Differential pressure
pressure_alt float Altitude calculated from pressure
temperature float degC Temperature
fields_updated uint16_t HIGHRES_IMU_UPDATED_FLAGS Bitmap for fields that have updated since last message
id ++ uint8_t Id. Ids are numbered from 0 and map to IMUs numbered from 1 (e.g. IMU1 will have a message with id=0)
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.

OPTICAL_FLOW_RAD (106)

Optical flow from an angular rate flow sensor (e.g. PX4FLOW or mouse sensor)

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
sensor_id uint8_t Sensor ID
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
integration_time_us uint32_t us Integration time. Divide integrated_x and integrated_y by the integration time to obtain average flow. The integration time also indicates the.
integrated_x float rad Flow around X axis (Sensor RH rotation about the X axis induces a positive flow. Sensor linear motion along the positive Y axis induces a negative flow.)
integrated_y float rad Flow around Y axis (Sensor RH rotation about the Y axis induces a positive flow. Sensor linear motion along the positive X axis induces a positive flow.)
integrated_xgyro float rad RH rotation around X axis
integrated_ygyro float rad RH rotation around Y axis
integrated_zgyro float rad RH rotation around Z axis
temperature int16_t cdegC Temperature
quality uint8_t Optical flow quality / confidence. 0: no valid flow, 255: maximum quality
time_delta_distance_us uint32_t us Time since the distance was sampled.
distance float m Distance to the center of the flow field. Positive value (including zero): distance known. Negative value: Unknown distance.

HIL_SENSOR (107)

The IMU readings in SI units in NED body frame

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
xacc float m/s/s X acceleration
yacc float m/s/s Y acceleration
zacc float m/s/s Z acceleration
xgyro float rad/s Angular speed around X axis in body frame
ygyro float rad/s Angular speed around Y axis in body frame
zgyro float rad/s Angular speed around Z axis in body frame
xmag float gauss X Magnetic field
ymag float gauss Y Magnetic field
zmag float gauss Z Magnetic field
abs_pressure float hPa Absolute pressure
diff_pressure float hPa Differential pressure (airspeed)
pressure_alt float Altitude calculated from pressure
temperature float degC Temperature
fields_updated uint32_t HIL_SENSOR_UPDATED_FLAGS Bitmap for fields that have updated since last message
id ++ uint8_t Sensor ID (zero indexed). Used for multiple sensor inputs

SIM_STATE (108)

Status of simulation environment, if used

Field Name Type Units 描述
q1 float True attitude quaternion component 1, w (1 in null-rotation)
q2 float True attitude quaternion component 2, x (0 in null-rotation)
q3 float True attitude quaternion component 3, y (0 in null-rotation)
q4 float True attitude quaternion component 4, z (0 in null-rotation)
roll float rad Attitude roll expressed as Euler angles, not recommended except for human-readable outputs
俯仰角 float rad Attitude pitch expressed as Euler angles, not recommended except for human-readable outputs
yaw float rad Attitude yaw expressed as Euler angles, not recommended except for human-readable outputs
xacc float m/s/s X acceleration
yacc float m/s/s Y acceleration
zacc float m/s/s Z acceleration
xgyro float rad/s Angular speed around X axis
ygyro float rad/s Angular speed around Y axis
zgyro float rad/s Angular speed around Z axis
lat float Latitude (lower precision). Both this and the lat_int field should be set.
lon float Longitude (lower precision). Both this and the lon_int field should be set.
alt float m Altitude
std_dev_horz float Horizontal position standard deviation
std_dev_vert float Vertical position standard deviation
vn float m/s True velocity in north direction in earth-fixed NED frame
ve float m/s True velocity in east direction in earth-fixed NED frame
vd float m/s True velocity in down direction in earth-fixed NED frame
lat_int ++ int32_t degE7 Latitude (higher precision). If 0, recipients should use the lat field value (otherwise this field is preferred).
lon_int ++ int32_t degE7 Longitude (higher precision). If 0, recipients should use the lon field value (otherwise this field is preferred).

RADIO_STATUS (109)

Status generated by radio and injected into MAVLink stream.

Field Name Type Units 描述
rssi uint8_t Local (message sender) received signal strength indication in device-dependent units/scale. Values: [0-254], UINT8_MAX: invalid/unknown.
remrssi uint8_t Remote (message receiver) signal strength indication in device-dependent units/scale. Values: [0-254], UINT8_MAX: invalid/unknown.
txbuf uint8_t % Remaining free transmitter buffer space.
noise uint8_t Local background noise level. These are device dependent RSSI values (scale as approx 2x dB on SiK radios). Values: [0-254], UINT8_MAX: invalid/unknown.
remnoise uint8_t Remote background noise level. These are device dependent RSSI values (scale as approx 2x dB on SiK radios). Values: [0-254], UINT8_MAX: invalid/unknown.
rxerrors uint16_t Count of radio packet receive errors (since boot).
fixed uint16_t Count of error corrected radio packets (since boot).

FILE_TRANSFER_PROTOCOL (110)

File transfer protocol message: https://mavlink.io/en/services/ftp.html.

Field Name Type 描述
target_network uint8_t Network ID (0 for broadcast)
target_system uint8_t System ID (0 for broadcast)
target_component uint8_t Component ID (0 for broadcast)
payload uint8_t[251] Variable length payload. The content/format of this block is defined in https://mavlink.io/en/services/ftp.html. The length is defined by the remaining message length when subtracting the header and other fields. See also MAV_FTP_OPCODE and MAV_FTP_ERR.

TIMESYNC (111)

Time synchronization message. The message is used for both timesync requests and responses. The request is sent with ts1=syncing component timestamp and tc1=0, and may be broadcast or targeted to a specific system/component. The response is sent with ts1=syncing component timestamp (mirror back unchanged), and tc1=responding component timestamp, with the target_system and target_component set to ids of the original request. Systems can determine if they are receiving a request or response based on the value of tc. If the response has target_system==target_component==0 the remote system has not been updated to use the component IDs and cannot reliably timesync; the requester may report an error. Timestamps are UNIX Epoch time or time since system boot in nanoseconds (the timestamp format can be inferred by checking for the magnitude of the number; generally it doesn't matter as only the offset is used). The message sequence is repeated numerous times with results being filtered/averaged to estimate the offset. See also: https://mavlink.io/en/services/timesync.html.

Field Name Type Units 描述
tc1 int64_t ns Time sync timestamp 1. Syncing: 0. Responding: Timestamp of responding component.
ts1 int64_t ns Time sync timestamp 2. Timestamp of syncing component (mirrored in response).
target_system ++ uint8_t Target system id. Request: 0 (broadcast) or id of specific system. Response must contain system id of the requesting component.
target_component ++ uint8_t Target component id. Request: 0 (broadcast) or id of specific component. Response must contain component id of the requesting component.

CAMERA_TRIGGER (112)

Camera-IMU triggering and synchronisation message.

Field Name Type Units 描述
time_usec uint64_t us Timestamp for image frame (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
seq uint32_t Image frame sequence

HIL_GPS (113)

The global position, as returned by the Global Positioning System (GPS). This is

NOT the global position estimate of the system, but rather a RAW sensor value. See message GLOBAL_POSITION_INT for the global position estimate.

Field Name Type Units Multiplier 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
fix_type uint8_t 0-1: no fix, 2: 2D fix, 3: 3D fix. Some applications will not use the value of this field unless it is at least two, so always correctly fill in the fix.
lat int32_t degE7 Latitude (WGS84)
lon int32_t degE7 Longitude (WGS84)
alt int32_t 毫米 Altitude (MSL). Positive for up.
eph uint16_t 1E-2 GPS HDOP horizontal dilution of position (unitless * 100). If unknown, set to: UINT16_MAX
epv uint16_t 1E-2 GPS VDOP vertical dilution of position (unitless * 100). If unknown, set to: UINT16_MAX
vel uint16_t 厘米/秒 GPS ground speed. If unknown, set to: UINT16_MAX
vn int16_t 厘米/秒 GPS velocity in north direction in earth-fixed NED frame
ve int16_t 厘米/秒 GPS velocity in east direction in earth-fixed NED frame
vd int16_t 厘米/秒 GPS velocity in down direction in earth-fixed NED frame
cog uint16_t cdeg Course over ground (NOT heading, but direction of movement), 0.0..359.99 degrees. If unknown, set to: UINT16_MAX
satellites_visible uint8_t 可见卫星数量。 If unknown, set to UINT8_MAX
id ++ uint8_t GPS ID (zero indexed). Used for multiple GPS inputs
yaw ++ uint16_t cdeg Yaw of vehicle relative to Earth's North, zero means not available, use 36000 for north

HIL_OPTICAL_FLOW (114)

Simulated optical flow from a flow sensor (e.g. PX4FLOW or optical mouse sensor)

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
sensor_id uint8_t Sensor ID
integration_time_us uint32_t us Integration time. Divide integrated_x and integrated_y by the integration time to obtain average flow. The integration time also indicates the.
integrated_x float rad Flow in radians around X axis (Sensor RH rotation about the X axis induces a positive flow. Sensor linear motion along the positive Y axis induces a negative flow.)
integrated_y float rad Flow in radians around Y axis (Sensor RH rotation about the Y axis induces a positive flow. Sensor linear motion along the positive X axis induces a positive flow.)
integrated_xgyro float rad RH rotation around X axis
integrated_ygyro float rad RH rotation around Y axis
integrated_zgyro float rad RH rotation around Z axis
temperature int16_t cdegC Temperature
quality uint8_t Optical flow quality / confidence. 0: no valid flow, 255: maximum quality
time_delta_distance_us uint32_t us Time since the distance was sampled.
distance float m Distance to the center of the flow field. Positive value (including zero): distance known. Negative value: Unknown distance.

HIL_STATE_QUATERNION (115)

Sent from simulation to autopilot, avoids in contrast to HIL_STATE singularities. This packet is useful for high throughput applications such as hardware in the loop simulations.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
attitude_quaternion float[4] Vehicle attitude expressed as normalized quaternion in w, x, y, z order (with 1 0 0 0 being the null-rotation)
rollspeed float rad/s Body frame roll / phi angular speed
pitchspeed float rad/s Body frame pitch / theta angular speed
yawspeed float rad/s Body frame yaw / psi angular speed
lat int32_t degE7 Latitude
lon int32_t degE7 Longitude
alt int32_t 毫米 Altitude
vx int16_t 厘米/秒 Ground X Speed (Latitude)
vy int16_t 厘米/秒 Ground Y Speed (Longitude)
vz int16_t 厘米/秒 Ground Z Speed (Altitude)
ind_airspeed uint16_t 厘米/秒 Indicated airspeed
true_airspeed uint16_t 厘米/秒 True airspeed
xacc int16_t mG X acceleration
yacc int16_t mG Y acceleration
zacc int16_t mG Z acceleration

SCALED_IMU2 (116)

The RAW IMU readings for secondary 9DOF sensor setup. This message should contain the scaled values to the described units

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
xacc int16_t mG X acceleration
yacc int16_t mG Y acceleration
zacc int16_t mG Z acceleration
xgyro int16_t mrad/s Angular speed around X axis
ygyro int16_t mrad/s Angular speed around Y axis
zgyro int16_t mrad/s Angular speed around Z axis
xmag int16_t mgauss X Magnetic field
ymag int16_t mgauss Y Magnetic field
zmag int16_t mgauss Z Magnetic field
temperature ++ int16_t cdegC Temperature, 0: IMU does not provide temperature values. If the IMU is at 0C it must send 1 (0.01C).

LOG_REQUEST_LIST (117)

Request a list of available logs.

On some systems calling this may stop on-board logging until LOG_REQUEST_END is called. If there are no log files available this request shall be answered with one LOG_ENTRY message with id = 0 and num_logs = 0. LOG_ENTRY messages can start with id 1 or 0. The ground station needs to be able to process either.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
start uint16_t First log id (0 for first available)
end uint16_t Last log id (0xffff for last available)

LOG_ENTRY (118)

Reply to LOG_REQUEST_LIST

Field Name Type Units 描述
id uint16_t Log id
num_logs uint16_t Total number of logs
last_log_num uint16_t High log number
time_utc uint32_t s UTC timestamp of log since 1970, or 0 if not available
size uint32_t bytes Size of the log (may be approximate)

LOG_REQUEST_DATA (119)

Request a chunk of a log

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
id uint16_t Log id (from LOG_ENTRY reply)
ofs uint32_t Offset into the log
count uint32_t bytes Number of bytes

LOG_DATA (120)

Reply to LOG_REQUEST_DATA

Field Name Type Units 描述
id uint16_t Log id (from LOG_ENTRY reply)
ofs uint32_t Offset into the log
count uint8_t bytes Number of bytes (zero for end of log)
data uint8_t[90] log data

LOG_ERASE (121)

Erase all logs

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID

LOG_REQUEST_END (122)

Stop log transfer and resume normal logging

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID

GPS_INJECT_DATA (123) — [SUP]

SUPERSEDED: Replaced By GPS_RTCM_DATA (2022-05)

Data for injecting into the onboard GPS (used for DGPS)

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
len uint8_t bytes Data length
data uint8_t[110] Raw data (110 is enough for 12 satellites of RTCMv2)

GPS2_RAW (124)

Second GPS data.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
fix_type uint8_t GPS_FIX_TYPE GPS fix type.
lat int32_t degE7 Latitude (WGS84)
lon int32_t degE7 Longitude (WGS84)
alt int32_t 毫米 Altitude (MSL). Positive for up.
eph uint16_t invalid:UINT16_MAX GPS HDOP horizontal dilution of position (unitless * 100). If unknown, set to: UINT16_MAX
epv uint16_t invalid:UINT16_MAX GPS VDOP vertical dilution of position (unitless * 100). If unknown, set to: UINT16_MAX
vel uint16_t 厘米/秒 invalid:UINT16_MAX GPS ground speed. If unknown, set to: UINT16_MAX
cog uint16_t cdeg invalid:UINT16_MAX Course over ground (NOT heading, but direction of movement): 0.0..359.99 degrees. If unknown, set to: UINT16_MAX
satellites_visible uint8_t invalid:UINT8_MAX 可见卫星数量。 If unknown, set to UINT8_MAX
dgps_numch uint8_t Number of DGPS satellites
dgps_age uint32_t ms Age of DGPS info
yaw ++ uint16_t cdeg invalid:0 Yaw in earth frame from north. Use 0 if this GPS does not provide yaw. Use UINT16_MAX if this GPS is configured to provide yaw and is currently unable to provide it. Use 36000 for north.
alt_ellipsoid ++ int32_t 毫米 Altitude (above WGS84, EGM96 ellipsoid). Positive for up.
h_acc ++ uint32_t 毫米 Position uncertainty.
v_acc ++ uint32_t 毫米 Altitude uncertainty.
vel_acc ++ uint32_t 毫米/秒 Speed uncertainty.
hdg_acc ++ uint32_t degE5 Heading / track uncertainty

POWER_STATUS (125)

Power supply status

Field Name Type Units 描述
Vcc uint16_t mV 5V rail voltage.
Vservo uint16_t mV Servo rail voltage.
flags uint16_t MAV_POWER_STATUS Bitmap of power supply status flags.

SERIAL_CONTROL (126)

Control a serial port. This can be used for raw access to an onboard serial peripheral such as a GPS or telemetry radio. It is designed to make it possible to update the devices firmware via MAVLink messages or change the devices settings. A message with zero bytes can be used to change just the baudrate.

Field Name Type Units 描述
device uint8_t SERIAL_CONTROL_DEV Serial control device type.
flags uint8_t SERIAL_CONTROL_FLAG Bitmap of serial control flags.
timeout uint16_t ms Timeout for reply data
baudrate uint32_t bits/s Baudrate of transfer. Zero means no change.
count uint8_t bytes how many bytes in this transfer
data uint8_t[70] serial data
target_system ++ uint8_t System ID
target_component ++ uint8_t Component ID

GPS_RTK (127)

RTK GPS data. Gives information on the relative baseline calculation the GPS is reporting

Field Name Type Units 描述
time_last_baseline_ms uint32_t ms Time since boot of last baseline message received.
rtk_receiver_id uint8_t Identification of connected RTK receiver.
wn uint16_t GPS Week Number of last baseline
tow uint32_t ms GPS Time of Week of last baseline
rtk_health uint8_t GPS-specific health report for RTK data.
rtk_rate uint8_t Hz Rate of baseline messages being received by GPS
nsats uint8_t Current number of sats used for RTK calculation.
baseline_coords_type uint8_t RTK_BASELINE_COORDINATE_SYSTEM Coordinate system of baseline
baseline_a_mm int32_t 毫米 Current baseline in ECEF x or NED north component.
baseline_b_mm int32_t 毫米 Current baseline in ECEF y or NED east component.
baseline_c_mm int32_t 毫米 Current baseline in ECEF z or NED down component.
accuracy uint32_t Current estimate of baseline accuracy.
iar_num_hypotheses int32_t Current number of integer ambiguity hypotheses.

GPS2_RTK (128)

RTK GPS data. Gives information on the relative baseline calculation the GPS is reporting

Field Name Type Units 描述
time_last_baseline_ms uint32_t ms Time since boot of last baseline message received.
rtk_receiver_id uint8_t Identification of connected RTK receiver.
wn uint16_t GPS Week Number of last baseline
tow uint32_t ms GPS Time of Week of last baseline
rtk_health uint8_t GPS-specific health report for RTK data.
rtk_rate uint8_t Hz Rate of baseline messages being received by GPS
nsats uint8_t Current number of sats used for RTK calculation.
baseline_coords_type uint8_t RTK_BASELINE_COORDINATE_SYSTEM Coordinate system of baseline
baseline_a_mm int32_t 毫米 Current baseline in ECEF x or NED north component.
baseline_b_mm int32_t 毫米 Current baseline in ECEF y or NED east component.
baseline_c_mm int32_t 毫米 Current baseline in ECEF z or NED down component.
accuracy uint32_t Current estimate of baseline accuracy.
iar_num_hypotheses int32_t Current number of integer ambiguity hypotheses.

SCALED_IMU3 (129)

The RAW IMU readings for 3rd 9DOF sensor setup. This message should contain the scaled values to the described units

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
xacc int16_t mG X acceleration
yacc int16_t mG Y acceleration
zacc int16_t mG Z acceleration
xgyro int16_t mrad/s Angular speed around X axis
ygyro int16_t mrad/s Angular speed around Y axis
zgyro int16_t mrad/s Angular speed around Z axis
xmag int16_t mgauss X Magnetic field
ymag int16_t mgauss Y Magnetic field
zmag int16_t mgauss Z Magnetic field
temperature ++ int16_t cdegC Temperature, 0: IMU does not provide temperature values. If the IMU is at 0C it must send 1 (0.01C).

DATA_TRANSMISSION_HANDSHAKE (130)

Handshake message to initiate, control and stop image streaming when using the Image Transmission Protocol: https://mavlink.io/en/services/image_transmission.html.

Field Name Type Units 描述
type uint8_t MAVLINK_DATA_STREAM_TYPE Type of requested/acknowledged data.
size uint32_t bytes total data size (set on ACK only).
width uint16_t Width of a matrix or image.
height uint16_t Height of a matrix or image.
packets uint16_t Number of packets being sent (set on ACK only).
payload uint8_t bytes Payload size per packet (normally 253 byte, see DATA field size in message ENCAPSULATED_DATA) (set on ACK only).
jpg_quality uint8_t % JPEG quality. Values: [1-100].

ENCAPSULATED_DATA (131)

Data packet for images sent using the Image Transmission Protocol: https://mavlink.io/en/services/image_transmission.html.

Field Name Type 描述
seqnr uint16_t sequence number (starting with 0 on every transmission)
data uint8_t[253] image data bytes

DISTANCE_SENSOR (132)

Distance sensor information for an onboard rangefinder.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
min_distance uint16_t 厘米 Minimum distance the sensor can measure
max_distance uint16_t 厘米 Maximum distance the sensor can measure
current_distance uint16_t 厘米 Current distance reading
type uint8_t MAV_DISTANCE_SENSOR Type of distance sensor.
id uint8_t Onboard ID of the sensor
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
orientation uint8_t MAV_SENSOR_ORIENTATION Direction the sensor faces. downward-facing: ROTATION_PITCH_270, upward-facing: ROTATION_PITCH_90, backward-facing: ROTATION_PITCH_180, forward-facing: ROTATION_NONE, left-facing: ROTATION_YAW_90, right-facing: ROTATION_YAW_270
covariance uint8_t cm^2 invalid:UINT8_MAX Measurement variance. Max standard deviation is 6cm. UINT8_MAX if unknown.
horizontal_fov ++ float rad invalid:0 Horizontal Field of View (angle) where the distance measurement is valid and the field of view is known. Otherwise this is set to 0.
vertical_fov ++ float rad invalid:0 Vertical Field of View (angle) where the distance measurement is valid and the field of view is known. Otherwise this is set to 0.
quaternion ++ float[4] invalid:[0] Quaternion of the sensor orientation in vehicle body frame (w, x, y, z order, zero-rotation is 1, 0, 0, 0). Zero-rotation is along the vehicle body x-axis. This field is required if the orientation is set to MAV_SENSOR_ROTATION_CUSTOM. Set it to 0 if invalid."
signal_quality ++ uint8_t % invalid:0 Signal quality of the sensor. Specific to each sensor type, representing the relation of the signal strength with the target reflectivity, distance, size or aspect, but normalised as a percentage. 0 = unknown/unset signal quality, 1 = invalid signal, 100 = perfect signal.

TERRAIN_REQUEST (133)

Request for terrain data and terrain status. See terrain protocol docs: https://mavlink.io/en/services/terrain.html

Field Name Type Units 描述
lat int32_t degE7 Latitude of SW corner of first grid
lon int32_t degE7 Longitude of SW corner of first grid
grid_spacing uint16_t m Grid spacing
mask uint64_t Bitmask of requested 4x4 grids (row major 8x7 array of grids, 56 bits)

TERRAIN_DATA (134)

Terrain data sent from GCS. The lat/lon and grid_spacing must be the same as a lat/lon from a TERRAIN_REQUEST. See terrain protocol docs: https://mavlink.io/en/services/terrain.html

Field Name Type Units 描述
lat int32_t degE7 Latitude of SW corner of first grid
lon int32_t degE7 Longitude of SW corner of first grid
grid_spacing uint16_t m Grid spacing
gridbit uint8_t bit within the terrain request mask
data int16_t[16] m Terrain data MSL

TERRAIN_CHECK (135)

Request that the vehicle report terrain height at the given location (expected response is a TERRAIN_REPORT). Used by GCS to check if vehicle has all terrain data needed for a mission.

Field Name Type Units 描述
lat int32_t degE7 Latitude
lon int32_t degE7 Longitude

TERRAIN_REPORT (136)

Streamed from drone to report progress of terrain map download (initiated by TERRAIN_REQUEST), or sent as a response to a TERRAIN_CHECK request. See terrain protocol docs: https://mavlink.io/en/services/terrain.html

Field Name Type Units 描述
lat int32_t degE7 Latitude
lon int32_t degE7 Longitude
spacing uint16_t grid spacing (zero if terrain at this location unavailable)
terrain_height float m Terrain height MSL
current_height float m Current vehicle height above lat/lon terrain height
pending uint16_t Number of 4x4 terrain blocks waiting to be received or read from disk
loaded uint16_t Number of 4x4 terrain blocks in memory

SCALED_PRESSURE2 (137)

Barometer readings for 2nd barometer

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
press_abs float hPa Absolute pressure
press_diff float hPa Differential pressure
temperature int16_t cdegC Absolute pressure temperature
temperature_press_diff ++ int16_t cdegC Differential pressure temperature (0, if not available). Report values of 0 (or 1) as 1 cdegC.

ATT_POS_MOCAP (138)

Motion capture attitude and position

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
q float[4] Attitude quaternion (w, x, y, z order, zero-rotation is 1, 0, 0, 0)
x float m X position (NED)
y float m Y position (NED)
z float m Z position (NED)
covariance ++ float[21] Row-major representation of a pose 6x6 cross-covariance matrix upper right triangle (states: x, y, z, roll, pitch, yaw; first six entries are the first ROW, next five entries are the second ROW, etc.). If unknown, assign NaN value to first element in the array.

SET_ACTUATOR_CONTROL_TARGET (139)

Set the vehicle attitude and body angular rates.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
group_mlx uint8_t Actuator group. The "_mlx" indicates this is a multi-instance message and a MAVLink parser should use this field to difference between instances.
target_system uint8_t System ID
target_component uint8_t Component ID
controls float[8] Actuator controls. Normed to -1..+1 where 0 is neutral position. Throttle for single rotation direction motors is 0..1, negative range for reverse direction. Standard mapping for attitude controls (group 0): (index 0-7): roll, pitch, yaw, throttle, flaps, spoilers, airbrakes, landing gear. Load a pass-through mixer to repurpose them as generic outputs.

ACTUATOR_CONTROL_TARGET (140)

Set the vehicle attitude and body angular rates.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
group_mlx uint8_t Actuator group. The "_mlx" indicates this is a multi-instance message and a MAVLink parser should use this field to difference between instances.
controls float[8] Actuator controls. Normed to -1..+1 where 0 is neutral position. Throttle for single rotation direction motors is 0..1, negative range for reverse direction. Standard mapping for attitude controls (group 0): (index 0-7): roll, pitch, yaw, throttle, flaps, spoilers, airbrakes, landing gear. Load a pass-through mixer to repurpose them as generic outputs.

ALTITUDE (141)

The current system altitude.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
altitude_monotonic float m This altitude measure is initialized on system boot and monotonic (it is never reset, but represents the local altitude change). The only guarantee on this field is that it will never be reset and is consistent within a flight. The recommended value for this field is the uncorrected barometric altitude at boot time. This altitude will also drift and vary between flights.
altitude_amsl float m This altitude measure is strictly above mean sea level and might be non-monotonic (it might reset on events like GPS lock or when a new QNH value is set). It should be the altitude to which global altitude waypoints are compared to. Note that it is not the GPS altitude, however, most GPS modules already output MSL by default and not the WGS84 altitude.
altitude_local float m This is the local altitude in the local coordinate frame. It is not the altitude above home, but in reference to the coordinate origin (0, 0, 0). It is up-positive.
altitude_relative float m This is the altitude above the home position. It resets on each change of the current home position.
altitude_terrain float m This is the altitude above terrain. It might be fed by a terrain database or an altimeter. Values smaller than -1000 should be interpreted as unknown.
bottom_clearance float m This is not the altitude, but the clear space below the system according to the fused clearance estimate. It generally should max out at the maximum range of e.g. the laser altimeter. It is generally a moving target. A negative value indicates no measurement available.

RESOURCE_REQUEST (142)

The autopilot is requesting a resource (file, binary, other type of data)

Field Name Type 描述
request_id uint8_t Request ID. This ID should be reused when sending back URI contents
uri_type uint8_t The type of requested URI. 0 = a file via URL. 1 = a UAVCAN binary
uri uint8_t[120] The requested unique resource identifier (URI). It is not necessarily a straight domain name (depends on the URI type enum)
transfer_type uint8_t The way the autopilot wants to receive the URI. 0 = MAVLink FTP. 1 = binary stream.
storage uint8_t[120] The storage path the autopilot wants the URI to be stored in. Will only be valid if the transfer_type has a storage associated (e.g. MAVLink FTP).

SCALED_PRESSURE3 (143)

Barometer readings for 3rd barometer

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
press_abs float hPa Absolute pressure
press_diff float hPa Differential pressure
temperature int16_t cdegC Absolute pressure temperature
temperature_press_diff ++ int16_t cdegC Differential pressure temperature (0, if not available). Report values of 0 (or 1) as 1 cdegC.

FOLLOW_TARGET (144)

Current motion information from a designated system

Field Name Type Units 描述
timestamp uint64_t ms Timestamp (time since system boot).
est_capabilities uint8_t bit positions for tracker reporting capabilities (POS = 0, VEL = 1, ACCEL = 2, ATT + RATES = 3)
lat int32_t degE7 Latitude (WGS84)
lon int32_t degE7 Longitude (WGS84)
alt float m Altitude (MSL)
vel float[3] m/s target velocity (0,0,0) for unknown
acc float[3] m/s/s linear target acceleration (0,0,0) for unknown
attitude_q float[4] (0 0 0 0 for unknown)
rates float[3] (0 0 0 for unknown)
position_cov float[3] eph epv
custom_state uint64_t button states or switches of a tracker device

CONTROL_SYSTEM_STATE (146)

The smoothed, monotonic system state used to feed the control loops of the system.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
x_acc float m/s/s X acceleration in body frame
y_acc float m/s/s Y acceleration in body frame
z_acc float m/s/s Z acceleration in body frame
x_vel float m/s X velocity in body frame
y_vel float m/s Y velocity in body frame
z_vel float m/s Z velocity in body frame
x_pos float m X position in local frame
y_pos float m Y position in local frame
z_pos float m Z position in local frame
airspeed float m/s Airspeed, set to -1 if unknown
vel_variance float[3] Variance of body velocity estimate
pos_variance float[3] Variance in local position
q float[4] The attitude, represented as Quaternion
roll_rate float rad/s Angular rate in roll axis
pitch_rate float rad/s Angular rate in pitch axis
yaw_rate float rad/s Angular rate in yaw axis

BATTERY_STATUS (147)

Battery information. Updates GCS with flight controller battery status. Smart batteries also use this message, but may additionally send BATTERY_INFO.

Field Name Type Units 描述
id uint8_t Battery ID
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
battery_function uint8_t MAV_BATTERY_FUNCTION Function of the battery
type uint8_t MAV_BATTERY_TYPE Type (chemistry) of the battery
temperature int16_t cdegC invalid:INT16_MAX Temperature of the battery. INT16_MAX for unknown temperature.
voltages uint16_t[10] mV invalid:[UINT16_MAX] Battery voltage of cells 1 to 10 (see voltages_ext for cells 11-14). Cells in this field above the valid cell count for this battery should have the UINT16_MAX value. If individual cell voltages are unknown or not measured for this battery, then the overall battery voltage should be filled in cell 0, with all others set to UINT16_MAX. If the voltage of the battery is greater than (UINT16_MAX - 1), then cell 0 should be set to (UINT16_MAX - 1), and cell 1 to the remaining voltage. This can be extended to multiple cells if the total voltage is greater than 2 * (UINT16_MAX - 1).
current_battery int16_t cA invalid:-1 Battery current, -1: autopilot does not measure the current. Value may overflow/rollover for very high currents (> 327.67A)
current_consumed int32_t mAh invalid:-1 Consumed charge, -1: autopilot does not provide consumption estimate
energy_consumed int32_t hJ invalid:-1 Consumed energy, -1: autopilot does not provide energy consumption estimate
battery_remaining int8_t % invalid:-1 Remaining battery energy. Values: [0-100], -1: autopilot does not estimate the remaining battery.
time_remaining ++ int32_t s invalid:0 Remaining battery time, 0: autopilot does not provide remaining battery time estimate
charge_state ++ uint8_t MAV_BATTERY_CHARGE_STATE State for extent of discharge, provided by autopilot for warning or external reactions
voltages_ext ++ uint16_t[4] mV invalid:[0] Battery voltages for cells 11 to 14. Cells above the valid cell count for this battery should have a value of 0, where zero indicates not supported (note, this is different than for the voltages field and allows empty byte truncation). If the measured value is 0 then 1 should be sent instead.
mode ++ uint8_t MAV_BATTERY_MODE Battery mode. Default (0) is that battery mode reporting is not supported or battery is in normal-use mode.
fault_bitmask ++ uint32_t MAV_BATTERY_FAULT Fault/health indications. These should be set when charge_state is MAV_BATTERY_CHARGE_STATE_FAILED or MAV_BATTERY_CHARGE_STATE_UNHEALTHY (if not, fault reporting is not supported).

AUTOPILOT_VERSION (148) — [from: standard]

Version and capability of autopilot software. This should be emitted in response to a request with MAV_CMD_REQUEST_MESSAGE.

Field Name Type 描述
capabilities uint64_t MAV_PROTOCOL_CAPABILITY Bitmap of capabilities
flight_sw_version uint32_t Firmware version number.
The field must be encoded as 4 bytes, where each byte (shown from MSB to LSB) is part of a semantic version: (major) (minor) (patch) (FIRMWARE_VERSION_TYPE).
middleware_sw_version uint32_t Middleware version number
os_sw_version uint32_t Operating system version number
board_version uint32_t HW / board version (last 8 bits should be silicon ID, if any). The first 16 bits of this field specify a board type from an enumeration stored at https://github.com/PX4/PX4-Bootloader/blob/master/board_types.txt and with extensive additions at https://github.com/ArduPilot/ardupilot/blob/master/Tools/AP_Bootloader/board_types.txt
flight_custom_version uint8_t[8] Custom version field, commonly the first 8 bytes of the git hash. This is not an unique identifier, but should allow to identify the commit using the main version number even for very large code bases.
middleware_custom_version uint8_t[8] Custom version field, commonly the first 8 bytes of the git hash. This is not an unique identifier, but should allow to identify the commit using the main version number even for very large code bases.
os_custom_version uint8_t[8] Custom version field, commonly the first 8 bytes of the git hash. This is not an unique identifier, but should allow to identify the commit using the main version number even for very large code bases.
vendor_id uint16_t ID of the board vendor
product_id uint16_t ID of the product
uid uint64_t UID if provided by hardware (see uid2)
uid2 ++ uint8_t[18] UID if provided by hardware (supersedes the uid field. If this is non-zero, use this field, otherwise use uid)

LANDING_TARGET (149)

The location of a landing target. See: https://mavlink.io/en/services/landing_target.html

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
target_num uint8_t The ID of the target if multiple targets are present
frame uint8_t MAV_FRAME Coordinate frame used for following fields.
angle_x float rad X-axis angular offset of the target from the center of the image
angle_y float rad Y-axis angular offset of the target from the center of the image
distance float m Distance to the target from the vehicle
size_x float rad Size of target along x-axis
size_y float rad Size of target along y-axis
x ++ float m X Position of the landing target in MAV_FRAME
y ++ float m Y Position of the landing target in MAV_FRAME
z ++ float m Z Position of the landing target in MAV_FRAME
q ++ float[4] Quaternion of landing target orientation (w, x, y, z order, zero-rotation is 1, 0, 0, 0)
type ++ uint8_t LANDING_TARGET_TYPE Type of landing target
position_valid ++ uint8_t default:0 MAV_BOOL Position fields (x, y, z, q, type) contain valid target position information (MAV_BOOL_FALSE: invalid values). Values not equal to 0 or 1 are invalid.

FENCE_STATUS (162)

Status of geo-fencing. Sent in extended status stream when fencing enabled.

Field Name Type Units 描述
breach_status uint8_t Breach status (0 if currently inside fence, 1 if outside).
breach_count uint16_t Number of fence breaches.
breach_type uint8_t FENCE_BREACH Last breach type.
breach_time uint32_t ms Time (since boot) of last breach.
breach_mitigation ++ uint8_t FENCE_MITIGATE Active action to prevent fence breach

MAG_CAL_REPORT (192)

Reports results of completed compass calibration. Sent until MAG_CAL_ACK received.

Field Name Type Units 描述
compass_id uint8_t Compass being calibrated.
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
cal_mask uint8_t Bitmask of compasses being calibrated.
cal_status uint8_t MAG_CAL_STATUS Calibration Status.
autosaved uint8_t 0=requires a MAV_CMD_DO_ACCEPT_MAG_CAL, 1=saved to parameters.
fitness float mgauss RMS milligauss residuals.
ofs_x float X offset.
ofs_y float Y offset.
ofs_z float Z offset.
diag_x float X diagonal (matrix 11).
diag_y float Y diagonal (matrix 22).
diag_z float Z diagonal (matrix 33).
offdiag_x float X off-diagonal (matrix 12 and 21).
offdiag_y float Y off-diagonal (matrix 13 and 31).
offdiag_z float Z off-diagonal (matrix 32 and 23).
orientation_confidence ++ float Confidence in orientation (higher is better).
old_orientation ++ uint8_t MAV_SENSOR_ORIENTATION orientation before calibration.
new_orientation ++ uint8_t MAV_SENSOR_ORIENTATION orientation after calibration.
scale_factor ++ float field radius correction factor

EFI_STATUS (225)

EFI status output

Field Name Type Units 描述
health uint8_t EFI health status
ecu_index float ECU index
rpm float RPM
fuel_consumed float cm^3 Fuel consumed
fuel_flow float cm^3/min Fuel flow rate
engine_load float % Engine load
throttle_position float % Throttle position
spark_dwell_time float ms Spark dwell time
barometric_pressure float kPa Barometric pressure
intake_manifold_pressure float kPa Intake manifold pressure(
intake_manifold_temperature float degC Intake manifold temperature
cylinder_head_temperature float degC Cylinder head temperature
ignition_timing float Ignition timing (Crank angle degrees)
injection_time float ms Injection time
exhaust_gas_temperature float degC Exhaust gas temperature
throttle_out float % Output throttle
pt_compensation float Pressure/temperature compensation
ignition_voltage ++ float V Supply voltage to EFI sparking system. Zero in this value means "unknown", so if the supply voltage really is zero volts use 0.0001 instead.
fuel_pressure ++ float kPa Fuel pressure. Zero in this value means "unknown", so if the fuel pressure really is zero kPa use 0.0001 instead.

ESTIMATOR_STATUS (230)

Estimator status message including flags, innovation test ratios and estimated accuracies. The flags message is an integer bitmask containing information on which EKF outputs are valid. See the ESTIMATOR_STATUS_FLAGS enum definition for further information. The innovation test ratios show the magnitude of the sensor innovation divided by the innovation check threshold. Under normal operation the innovation test ratios should be below 0.5 with occasional values up to 1.0. Values greater than 1.0 should be rare under normal operation and indicate that a measurement has been rejected by the filter. The user should be notified if an innovation test ratio greater than 1.0 is recorded. Notifications for values in the range between 0.5 and 1.0 should be optional and controllable by the user.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
flags uint16_t ESTIMATOR_STATUS_FLAGS Bitmap indicating which EKF outputs are valid.
vel_ratio float Velocity innovation test ratio
pos_horiz_ratio float Horizontal position innovation test ratio
pos_vert_ratio float Vertical position innovation test ratio
mag_ratio float Magnetometer innovation test ratio
hagl_ratio float Height above terrain innovation test ratio
tas_ratio float True airspeed innovation test ratio
pos_horiz_accuracy float m Horizontal position 1-STD accuracy relative to the EKF local origin
pos_vert_accuracy float m Vertical position 1-STD accuracy relative to the EKF local origin

WIND_COV (231)

Wind estimate from vehicle. Note that despite the name, this message does not actually contain any covariances but instead variability and accuracy fields in terms of standard deviation (1-STD).

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
wind_x float m/s Wind in North (NED) direction (NAN if unknown)
wind_y float m/s Wind in East (NED) direction (NAN if unknown)
wind_z float m/s Wind in down (NED) direction (NAN if unknown)
var_horiz float m/s Variability of wind in XY, 1-STD estimated from a 1 Hz lowpassed wind estimate (NAN if unknown)
var_vert float m/s Variability of wind in Z, 1-STD estimated from a 1 Hz lowpassed wind estimate (NAN if unknown)
wind_alt float m Altitude (MSL) that this measurement was taken at (NAN if unknown)
horiz_accuracy float m/s Horizontal speed 1-STD accuracy (0 if unknown)
vert_accuracy float m/s Vertical speed 1-STD accuracy (0 if unknown)

GPS_INPUT (232)

GPS sensor input message. This is a raw sensor value sent by the GPS. This is NOT the global position estimate of the system.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
gps_id uint8_t ID of the GPS for multiple GPS inputs
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
ignore_flags uint16_t GPS_INPUT_IGNORE_FLAGS Bitmap indicating which GPS input flags fields to ignore. All other fields must be provided.
time_week_ms uint32_t ms GPS time (from start of GPS week)
time_week uint16_t GPS week number
fix_type uint8_t 0-1: no fix, 2: 2D fix, 3: 3D fix. 4: 3D with DGPS. 5: 3D with RTK
lat int32_t degE7 Latitude (WGS84)
lon int32_t degE7 Longitude (WGS84)
alt float m Altitude (MSL). Positive for up.
hdop float invalid:UINT16_MAX GPS HDOP horizontal dilution of position (unitless). If unknown, set to: UINT16_MAX
vdop float invalid:UINT16_MAX GPS VDOP vertical dilution of position (unitless). If unknown, set to: UINT16_MAX
vn float m/s GPS velocity in north direction in earth-fixed NED frame
ve float m/s GPS velocity in east direction in earth-fixed NED frame
vd float m/s GPS velocity in down direction in earth-fixed NED frame
speed_accuracy float m/s GPS speed accuracy
horiz_accuracy float m GPS horizontal accuracy
vert_accuracy float m GPS vertical accuracy
satellites_visible uint8_t 可见卫星数量。
yaw ++ uint16_t cdeg Yaw of vehicle relative to Earth's North, zero means not available, use 36000 for north

GPS_RTCM_DATA (233)

RTCM message for injecting into the onboard GPS (used for DGPS)

Field Name Type Units 描述
flags uint8_t LSB: 1 means message is fragmented, next 2 bits are the fragment ID, the remaining 5 bits are used for the sequence ID. Messages are only to be flushed to the GPS when the entire message has been reconstructed on the autopilot. The fragment ID specifies which order the fragments should be assembled into a buffer, while the sequence ID is used to detect a mismatch between different buffers. The buffer is considered fully reconstructed when either all 4 fragments are present, or all the fragments before the first fragment with a non full payload is received. This management is used to ensure that normal GPS operation doesn't corrupt RTCM data, and to recover from a unreliable transport delivery order.
len uint8_t bytes data length
data uint8_t[180] RTCM message (may be fragmented)

HIGH_LATENCY (234) — [SUP]

SUPERSEDED: Replaced By HIGH_LATENCY2 (2020-10)

Message appropriate for high latency connections like Iridium

Field Name Type Units 描述
base_mode uint8_t MAV_MODE_FLAG Bitmap of enabled system modes.
custom_mode uint32_t A bitfield for use for autopilot-specific flags.
landed_state uint8_t MAV_LANDED_STATE The landed state. Is set to MAV_LANDED_STATE_UNDEFINED if landed state is unknown.
roll int16_t cdeg roll
俯仰角 int16_t cdeg 俯仰角
heading uint16_t cdeg heading
油门 int8_t % throttle (percentage)
heading_sp int16_t cdeg heading setpoint
latitude int32_t degE7 Latitude
longitude int32_t degE7 Longitude
altitude_amsl int16_t m Altitude above mean sea level
altitude_sp int16_t m Altitude setpoint relative to the home position
airspeed uint8_t m/s airspeed
airspeed_sp uint8_t m/s airspeed setpoint
groundspeed uint8_t m/s groundspeed
climb_rate int8_t m/s climb rate
gps_nsat uint8_t invalid:UINT8_MAX 可见卫星数量。 If unknown, set to UINT8_MAX
gps_fix_type uint8_t GPS_FIX_TYPE GPS Fix type.
battery_remaining uint8_t % Remaining battery (percentage)
temperature int8_t degC Autopilot temperature (degrees C)
temperature_air int8_t degC Air temperature (degrees C) from airspeed sensor
failsafe uint8_t failsafe (each bit represents a failsafe where 0=ok, 1=failsafe active (bit0:RC, bit1:batt, bit2:GPS, bit3:GCS, bit4:fence)
wp_num uint8_t current waypoint number
wp_distance uint16_t m distance to target

HIGH_LATENCY2 (235)

Message appropriate for high latency connections like Iridium (version 2)

Field Name Type Units 描述
timestamp uint32_t ms Timestamp (milliseconds since boot or Unix epoch)
type uint8_t MAV_TYPE Type of the MAV (quadrotor, helicopter, etc.)
autopilot uint8_t MAV_AUTOPILOT Autopilot type / class. Use MAV_AUTOPILOT_INVALID for components that are not flight controllers.
custom_mode uint16_t A bitfield for use for autopilot-specific flags (2 byte version).
latitude int32_t degE7 Latitude
longitude int32_t degE7 Longitude
altitude int16_t m Altitude above mean sea level
target_altitude int16_t m Altitude setpoint
heading uint8_t deg/2 Heading
target_heading uint8_t deg/2 Heading setpoint
target_distance uint16_t dam Distance to target waypoint or position
油门 uint8_t % Throttle
airspeed uint8_t m/s*5 Airspeed
airspeed_sp uint8_t m/s*5 Airspeed setpoint
groundspeed uint8_t m/s*5 Groundspeed
windspeed uint8_t m/s*5 Windspeed
wind_heading uint8_t deg/2 Wind heading
eph uint8_t dm Maximum error horizontal position since last message
epv uint8_t dm Maximum error vertical position since last message
temperature_air int8_t degC Air temperature
climb_rate int8_t dm/s Maximum climb rate magnitude since last message
battery int8_t % invalid:-1 Battery level (-1 if field not provided).
wp_num uint16_t Current waypoint number
failure_flags uint16_t HL_FAILURE_FLAG Bitmap of failure flags.
custom0 int8_t Field for custom payload.
custom1 int8_t Field for custom payload.
custom2 int8_t Field for custom payload.

VIBRATION (241)

Vibration levels and accelerometer clipping

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
vibration_x float Vibration levels on X-axis
vibration_y float Vibration levels on Y-axis
vibration_z float Vibration levels on Z-axis
clipping_0 uint32_t first accelerometer clipping count
clipping_1 uint32_t second accelerometer clipping count
clipping_2 uint32_t third accelerometer clipping count

HOME_POSITION (242)

Contains the home position. The home position is the default position that the system will return to and land on. The position must be set automatically by the system during the takeoff, and may also be explicitly set using MAV_CMD_DO_SET_HOME. The global and local positions encode the position in the respective coordinate frames, while the q parameter encodes the orientation of the surface. Under normal conditions it describes the heading and terrain slope, which can be used by the aircraft to adjust the approach. The approach 3D vector describes the point to which the system should fly in normal flight mode and then perform a landing sequence along the vector. Note: this message can be requested by sending the MAV_CMD_REQUEST_MESSAGE with param1=242.

Field Name Type Units 描述
latitude int32_t degE7 Latitude (WGS84)
longitude int32_t degE7 Longitude (WGS84)
altitude int32_t 毫米 Altitude (MSL). Positive for up.
x float m Local X position of this position in the local coordinate frame (NED)
y float m Local Y position of this position in the local coordinate frame (NED)
z float m Local Z position of this position in the local coordinate frame (NED: positive "down")
q float[4] Quaternion indicating world-to-surface-normal and heading transformation of the takeoff position.
Used to indicate the heading and slope of the ground.
All fields should be set to NaN if an accurate quaternion for both heading and surface slope cannot be supplied.
approach_x float m Local X position of the end of the approach vector. Multicopters should set this position based on their takeoff path. Grass-landing fixed wing aircraft should set it the same way as multicopters. Runway-landing fixed wing aircraft should set it to the opposite direction of the takeoff, assuming the takeoff happened from the threshold / touchdown zone.
approach_y float m Local Y position of the end of the approach vector. Multicopters should set this position based on their takeoff path. Grass-landing fixed wing aircraft should set it the same way as multicopters. Runway-landing fixed wing aircraft should set it to the opposite direction of the takeoff, assuming the takeoff happened from the threshold / touchdown zone.
approach_z float m Local Z position of the end of the approach vector. Multicopters should set this position based on their takeoff path. Grass-landing fixed wing aircraft should set it the same way as multicopters. Runway-landing fixed wing aircraft should set it to the opposite direction of the takeoff, assuming the takeoff happened from the threshold / touchdown zone.
time_usec ++ uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.

SET_HOME_POSITION (243) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_SET_HOME (2022-02) — The command protocol version (MAV_CMD_DO_SET_HOME) allows a GCS to detect when setting the home position has failed.)

Sets the home position. The home position is the default position that the system will return to and land on. The position is set automatically by the system during the takeoff (and may also be set using this message). The global and local positions encode the position in the respective coordinate frames, while the q parameter encodes the orientation of the surface. Under normal conditions it describes the heading and terrain slope, which can be used by the aircraft to adjust the approach. The approach 3D vector describes the point to which the system should fly in normal flight mode and then perform a landing sequence along the vector. Note: the current home position may be emitted in a HOME_POSITION message on request (using MAV_CMD_REQUEST_MESSAGE with param1=242).

Field Name Type Units 描述
target_system uint8_t System ID.
latitude int32_t degE7 Latitude (WGS84)
longitude int32_t degE7 Longitude (WGS84)
altitude int32_t 毫米 Altitude (MSL). Positive for up.
x float m Local X position of this position in the local coordinate frame (NED)
y float m Local Y position of this position in the local coordinate frame (NED)
z float m Local Z position of this position in the local coordinate frame (NED: positive "down")
q float[4] World to surface normal and heading transformation of the takeoff position. Used to indicate the heading and slope of the ground
approach_x float m Local X position of the end of the approach vector. Multicopters should set this position based on their takeoff path. Grass-landing fixed wing aircraft should set it the same way as multicopters. Runway-landing fixed wing aircraft should set it to the opposite direction of the takeoff, assuming the takeoff happened from the threshold / touchdown zone.
approach_y float m Local Y position of the end of the approach vector. Multicopters should set this position based on their takeoff path. Grass-landing fixed wing aircraft should set it the same way as multicopters. Runway-landing fixed wing aircraft should set it to the opposite direction of the takeoff, assuming the takeoff happened from the threshold / touchdown zone.
approach_z float m Local Z position of the end of the approach vector. Multicopters should set this position based on their takeoff path. Grass-landing fixed wing aircraft should set it the same way as multicopters. Runway-landing fixed wing aircraft should set it to the opposite direction of the takeoff, assuming the takeoff happened from the threshold / touchdown zone.
time_usec ++ uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.

MESSAGE_INTERVAL (244)

The interval between messages for a particular MAVLink message ID. This message is sent in response to the MAV_CMD_REQUEST_MESSAGE command with param1=244 (this message) and param2=message_id (the id of the message for which the interval is required). This interface replaces DATA_STREAM.

Field Name Type Units 描述
message_id uint16_t The ID of the requested MAVLink message. v1.0 is limited to 254 messages.
interval_us int32_t us The interval between two messages. A value of -1 indicates this stream is disabled, 0 indicates it is not available, > 0 indicates the interval at which it is sent.

EXTENDED_SYS_STATE (245)

Provides state for additional features

Field Name Type 描述
vtol_state uint8_t MAV_VTOL_STATE The VTOL state if applicable. Is set to MAV_VTOL_STATE_UNDEFINED if UAV is not in VTOL configuration.
landed_state uint8_t MAV_LANDED_STATE The landed state. Is set to MAV_LANDED_STATE_UNDEFINED if landed state is unknown.

ADSB_VEHICLE (246)

The location and information of an ADSB vehicle

Field Name Type Units 描述
ICAO_address uint32_t ICAO address
lat int32_t degE7 invalid:INT32_MAX Latitude
lon int32_t degE7 invalid:INT32_MAX Longitude
altitude_type uint8_t ADSB_ALTITUDE_TYPE ADSB altitude type.
altitude int32_t 毫米 invalid:INT32_MAX Altitude (ASL)
heading uint16_t cdeg invalid:UINT16_MAX Course over ground
hor_velocity uint16_t 厘米/秒 invalid:UINT16_MAX The horizontal velocity
ver_velocity int16_t 厘米/秒 invalid:INT16_MAX The vertical velocity. Positive is up
callsign char[9] The callsign, 8+null
emitter_type uint8_t ADSB_EMITTER_TYPE ADSB emitter type.
tslc uint8_t s Time since last communication from the remote vehicle, in seconds.
flags uint16_t ADSB_FLAGS Bitmap to indicate various statuses including valid data fields
squawk uint16_t Squawk code. Note that the code is in decimal: e.g. 7700 (general emergency) is encoded as binary 0b0001_1110_0001_0100, not(!) as 0b0000_111_111_000_000

COLLISION (247)

Information about a potential collision

Field Name Type Units 描述
src uint8_t MAV_COLLISION_SRC Collision data source
id uint32_t Unique identifier, domain based on src field
action uint8_t MAV_COLLISION_ACTION Action that is being taken to avoid this collision
threat_level uint8_t MAV_COLLISION_THREAT_LEVEL How concerned the aircraft is about this collision
time_to_minimum_delta float s Estimated time until collision occurs
altitude_minimum_delta float m Closest vertical distance between vehicle and object
horizontal_minimum_delta float m Closest horizontal distance between vehicle and object

V2_EXTENSION (248)

Message implementing parts of the V2 payload specs in V1 frames for transitional support.

Field Name Type 描述
target_network uint8_t Network ID (0 for broadcast)
target_system uint8_t System ID (0 for broadcast)
target_component uint8_t Component ID (0 for broadcast)
message_type uint16_t A code that identifies the software component that understands this message (analogous to USB device classes or mime type strings). If this code is less than 32768, it is considered a 'registered' protocol extension and the corresponding entry should be added to https://github.com/mavlink/mavlink/definition_files/extension_message_ids.xml. Software creators can register blocks of message IDs as needed (useful for GCS specific metadata, etc...). Message_types greater than 32767 are considered local experiments and should not be checked in to any widely distributed codebase.
payload uint8_t[249] Variable length payload. The length must be encoded in the payload as part of the message_type protocol, e.g. by including the length as payload data, or by terminating the payload data with a non-zero marker. This is required in order to reconstruct zero-terminated payloads that are (or otherwise would be) trimmed by MAVLink 2 empty-byte truncation. The entire content of the payload block is opaque unless you understand the encoding message_type. The particular encoding used can be extension specific and might not always be documented as part of the MAVLink specification.

MEMORY_VECT (249)

Send raw controller memory. The use of this message is discouraged for normal packets, but a quite efficient way for testing new messages and getting experimental debug output.

Field Name Type 描述
address uint16_t Starting address of the debug variables
ver uint8_t Version code of the type variable. 0=unknown, type ignored and assumed int16_t. 1=as below
type uint8_t Type code of the memory variables. for ver = 1: 0=16 x int16_t, 1=16 x uint16_t, 2=16 x Q15, 3=16 x 1Q14
value int8_t[32] Memory contents at specified address

DEBUG_VECT (250)

To debug something using a named 3D vector.

Field Name Type Units 描述
name charr[10] Name
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
x float x
y float y
z float z

NAMED_VALUE_FLOAT (251)

Send a key-value pair as float. The use of this message is discouraged for normal packets, but a quite efficient way for testing new messages and getting experimental debug output.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
name charr[10] Name of the debug variable
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
value float Floating point value

NAMED_VALUE_INT (252)

Send a key-value pair as integer. The use of this message is discouraged for normal packets, but a quite efficient way for testing new messages and getting experimental debug output.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
name charr[10] Name of the debug variable
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
value int32_t Signed integer value

STATUSTEXT (253)

Status text message. These messages are printed in yellow in the COMM console of QGroundControl. WARNING: They consume quite some bandwidth, so use only for important status and error messages. If implemented wisely, these messages are buffered on the MCU and sent only at a limited rate (e.g. 10 Hz).

Field Name Type 描述
severity uint8_t MAV_SEVERITY Severity of status. Relies on the definitions within RFC-5424.
text char[50] Status text message, without null termination character. UTF-8 encoded.
id ++ uint16_t Unique (opaque) identifier for this statustext message. May be used to reassemble a logical long-statustext message from a sequence of chunks. A value of zero indicates this is the only chunk in the sequence and the message can be emitted immediately.
chunk_seq ++ uint8_t This chunk's sequence number; indexing is from zero. Any null character in the text field is taken to mean this was the last chunk.

DEBUG (254)

Send a debug value. The index is used to discriminate between values. These values show up in the plot of QGroundControl as DEBUG N.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
ind uint8_t index of debug variable
value float DEBUG value

SETUP_SIGNING (256)

Setup a MAVLink2 signing key. If called with secret_key of all zero and zero initial_timestamp will disable signing

Field Name Type 描述
target_system uint8_t system id of the target
target_component uint8_t component ID of the target
secret_key uint8_t[32] signing key
initial_timestamp uint64_t initial timestamp

BUTTON_CHANGE (257)

Report button state change.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
last_change_ms uint32_t ms Time of last change of button state.
state uint8_t Bitmap for state of buttons.

PLAY_TUNE (258) — [SUP]

SUPERSEDED: Replaced By PLAY_TUNE_V2 (2019-10) — New version explicitly defines format. More interoperable.)

Control vehicle tone generation (buzzer).

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
tune char[30] tune in board specific format
tune2 ++ char[200] tune extension (appended to tune)

CAMERA_INFORMATION (259)

Information about a camera. Can be requested with a MAV_CMD_REQUEST_MESSAGE command.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
vendor_name uint8_t[32] Name of the camera vendor
model_name uint8_t[32] Name of the camera model
firmware_version uint32_t invalid:0 Version of the camera firmware, encoded as: (Dev & 0xff) << 24 + (Patch & 0xff) << 16 + (Minor & 0xff) << 8 + (Major & 0xff). Use 0 if not known.
focal_length float 毫米 invalid:NaN Focal length. Use NaN if not known.
sensor_size_h float 毫米 invalid:NaN Image sensor size horizontal. Use NaN if not known.
sensor_size_v float 毫米 invalid:NaN Image sensor size vertical. Use NaN if not known.
resolution_h uint16_t pix invalid:0 Horizontal image resolution. Use 0 if not known.
resolution_v uint16_t pix invalid:0 Vertical image resolution. Use 0 if not known.
lens_id uint8_t invalid:0 Reserved for a lens ID. Use 0 if not known.
flags uint32_t CAMERA_CAP_FLAGS Bitmap of camera capability flags.
cam_definition_version uint16_t Camera definition version (iteration). Use 0 if not known.
cam_definition_uri char[140] Camera definition URI (if any, otherwise only basic functions will be available). HTTP- (http://) and MAVLink FTP- (mavlinkftp://) formatted URIs are allowed (and both must be supported by any GCS that implements the Camera Protocol). The definition file may be xz compressed, which will be indicated by the file extension .xml.xz (a GCS that implements the protocol must support decompressing the file). The string needs to be zero terminated. Use a zero-length string if not known.
gimbal_device_id ++ uint8_t invalid:0 Gimbal id of a gimbal associated with this camera. This is the component id of the gimbal device, or 1-6 for non mavlink gimbals. Use 0 if no gimbal is associated with the camera.
camera_device_id ++ uint8_t default:0 min:0 max:6 Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

CAMERA_SETTINGS (260)

Settings of a camera. Can be requested with a MAV_CMD_REQUEST_MESSAGE command.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
mode_id uint8_t CAMERA_MODE Camera mode
zoomLevel ++ float invalid:NaN Current zoom level as a percentage of the full range (0.0 to 100.0, NaN if not known)
focusLevel ++ float invalid:NaN Current focus level as a percentage of the full range (0.0 to 100.0, NaN if not known)
camera_device_id ++ uint8_t default:0 min:0 max:6 Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

STORAGE_INFORMATION (261)

Information about a storage medium. This message is sent in response to a request with MAV_CMD_REQUEST_MESSAGE and whenever the status of the storage changes (STORAGE_STATUS). Use MAV_CMD_REQUEST_MESSAGE.param2 to indicate the index/id of requested storage: 0 for all, 1 for first, 2 for second, etc.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
storage_id uint8_t Storage ID (1 for first, 2 for second, etc.)
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
storage_count uint8_t Number of storage devices
status uint8_t STORAGE_STATUS Status of storage
total_capacity float MiB Total capacity. If storage is not ready (STORAGE_STATUS_READY) value will be ignored.
used_capacity float MiB Used capacity. If storage is not ready (STORAGE_STATUS_READY) value will be ignored.
available_capacity float MiB Available storage capacity. If storage is not ready (STORAGE_STATUS_READY) value will be ignored.
read_speed float MiB/s Read speed.
write_speed float MiB/s Write speed.
type ++ uint8_t STORAGE_TYPE Type of storage
name ++ charr[32] Textual storage name to be used in UI (microSD 1, Internal Memory, etc.) This is a NULL terminated string. If it is exactly 32 characters long, add a terminating NULL. If this string is empty, the generic type is shown to the user.
storage_usage ++ uint8_t STORAGE_USAGE_FLAG Flags indicating whether this instance is preferred storage for photos, videos, etc.
Note: Implementations should initially set the flags on the system-default storage id used for saving media (if possible/supported).
This setting can then be overridden using MAV_CMD_SET_STORAGE_USAGE.
If the media usage flags are not set, a GCS may assume storage ID 1 is the default storage for all media types.

CAMERA_CAPTURE_STATUS (262)

Information about the status of a capture. Can be requested with a MAV_CMD_REQUEST_MESSAGE command.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
image_status uint8_t Current status of image capturing (0: idle, 1: capture in progress, 2: interval set but idle, 3: interval set and capture in progress)
video_status uint8_t Current status of video capturing (0: idle, 1: capture in progress)
image_interval float s Image capture interval
recording_time_ms uint32_t ms Elapsed time since recording started (0: Not supported/available). A GCS should compute recording time and use non-zero values of this field to correct any discrepancy.
available_capacity float MiB Available storage capacity.
image_count ++ int32_t Total number of images captured ('forever', or until reset using MAV_CMD_STORAGE_FORMAT).
camera_device_id ++ uint8_t Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

CAMERA_IMAGE_CAPTURED (263)

Information about a captured image. This is emitted every time a message is captured.

MAV_CMD_REQUEST_MESSAGE can be used to (re)request this message for a specific sequence number or range of sequence numbers: MAV_CMD_REQUEST_MESSAGE.param2 indicates the sequence number the first image to send, or set to -1 to send the message for all sequence numbers. MAV_CMD_REQUEST_MESSAGE.param3 is used to specify a range of messages to send: set to 0 (default) to send just the the message for the sequence number in param 2, set to -1 to send the message for the sequence number in param 2 and all the following sequence numbers, set to the sequence number of the final message in the range.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
time_utc uint64_t us invalid:0 Timestamp (time since UNIX epoch) in UTC. 0 for unknown.
camera_id uint8_t default:0 min:0 max:6 Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id). Field name is usually camera_device_id.
lat int32_t degE7 Latitude where image was taken
lon int32_t degE7 Longitude where capture was taken
alt int32_t 毫米 Altitude (MSL) where image was taken
relative_alt int32_t 毫米 Altitude above ground
q float[4] Quaternion of camera orientation (w, x, y, z order, zero-rotation is 1, 0, 0, 0)
image_index int32_t Zero based index of this image (i.e. a new image will have index CAMERA_CAPTURE_STATUS.image count -1)
capture_result int8_t MAV_BOOL Image was captured successfully (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid.
file_url char[205] URL of image taken. Either local storage or http://foo.jpg if camera provides an HTTP interface.

FLIGHT_INFORMATION (264)

Flight information.

This includes time since boot for arm, takeoff, and land, and a flight number. Takeoff and landing values reset to zero on arm. This can be requested using MAV_CMD_REQUEST_MESSAGE. Note, some fields are misnamed - timestamps are from boot (not UTC) and the flight_uuid is a sequence number.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
arming_time_utc uint64_t us Timestamp at arming (since system boot). Set to 0 on boot. Set value on arming. Note, field is misnamed UTC.
takeoff_time_utc uint64_t us Timestamp at takeoff (since system boot). Set to 0 at boot and on arming. Note, field is misnamed UTC.
flight_uuid uint64_t Flight number. Note, field is misnamed UUID.
landing_time ++ uint32_t ms Timestamp at landing (in ms since system boot). Set to 0 at boot and on arming.

MOUNT_ORIENTATION (265) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_GIMBAL_MANAGER_PITCHYAW (2020-01) — This message is being superseded by MAV_CMD_DO_GIMBAL_MANAGER_PITCHYAW. The message can still be used to communicate with legacy gimbals implementing it.)

Orientation of a mount

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
roll float Roll in global frame (set to NaN for invalid).
俯仰角 float Pitch in global frame (set to NaN for invalid).
yaw float Yaw relative to vehicle (set to NaN for invalid).
yaw_absolute ++ float Yaw in absolute frame relative to Earth's North, north is 0 (set to NaN for invalid).

LOGGING_DATA (266)

A message containing logged data (see also MAV_CMD_LOGGING_START)

Field Name Type Units 描述
target_system uint8_t system ID of the target
target_component uint8_t component ID of the target
sequence uint16_t sequence number (can wrap)
length uint8_t bytes data length
first_message_offset uint8_t bytes offset into data where first message starts. This can be used for recovery, when a previous message got lost (set to UINT8_MAX if no start exists).
data uint8_t[249] logged data

LOGGING_DATA_ACKED (267)

A message containing logged data which requires a LOGGING_ACK to be sent back

Field Name Type Units 描述
target_system uint8_t system ID of the target
target_component uint8_t component ID of the target
sequence uint16_t sequence number (can wrap)
length uint8_t bytes data length
first_message_offset uint8_t bytes offset into data where first message starts. This can be used for recovery, when a previous message got lost (set to UINT8_MAX if no start exists).
data uint8_t[249] logged data

LOGGING_ACK (268)

An ack for a LOGGING_DATA_ACKED message

Field Name Type 描述
target_system uint8_t system ID of the target
target_component uint8_t component ID of the target
sequence uint16_t sequence number (must match the one in LOGGING_DATA_ACKED)

VIDEO_STREAM_INFORMATION (269)

Information about video stream. It may be requested using MAV_CMD_REQUEST_MESSAGE, where param2 indicates the video stream id: 0 for all streams, 1 for first, 2 for second, etc.

Field Name Type Units 描述
stream_id uint8_t Video Stream ID (1 for first, 2 for second, etc.)
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
count uint8_t Number of streams available.
type uint8_t VIDEO_STREAM_TYPE Type of stream.
flags uint16_t VIDEO_STREAM_STATUS_FLAGS Bitmap of stream status flags.
framerate float Hz Frame rate.
resolution_h uint16_t pix Horizontal resolution.
resolution_v uint16_t pix Vertical resolution.
bitrate uint32_t bits/s Bit rate.
rotation uint16_t Video image rotation clockwise.
hfov uint16_t Horizontal Field of view.
name charr[32] Stream name.
uri char[160] Video stream URI (TCP or RTSP URI ground station should connect to) or port number (UDP port ground station should listen to).
encoding ++ uint8_t VIDEO_STREAM_ENCODING Encoding of stream.
camera_device_id ++ uint8_t default:0 min:0 max:6 Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

VIDEO_STREAM_STATUS (270)

Information about the status of a video stream. It may be requested using MAV_CMD_REQUEST_MESSAGE.

Field Name Type Units 描述
stream_id uint8_t Video Stream ID (1 for first, 2 for second, etc.)
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
flags uint16_t VIDEO_STREAM_STATUS_FLAGS Bitmap of stream status flags
framerate float Hz Frame rate
resolution_h uint16_t pix Horizontal resolution
resolution_v uint16_t pix Vertical resolution
bitrate uint32_t bits/s Bit rate
rotation uint16_t Video image rotation clockwise
hfov uint16_t Horizontal Field of view
camera_device_id ++ uint8_t default:0 min:0 max:6 Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

CAMERA_FOV_STATUS (271)

Information about the field of view of a camera. Can be requested with a MAV_CMD_REQUEST_MESSAGE command.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
lat_camera int32_t degE7 Latitude of camera (INT32_MAX if unknown).
lon_camera int32_t degE7 Longitude of camera (INT32_MAX if unknown).
alt_camera int32_t 毫米 Altitude (MSL) of camera (INT32_MAX if unknown).
lat_image int32_t degE7 Latitude of center of image (INT32_MAX if unknown, INT32_MIN if at infinity, not intersecting with horizon).
lon_image int32_t degE7 Longitude of center of image (INT32_MAX if unknown, INT32_MIN if at infinity, not intersecting with horizon).
alt_image int32_t 毫米 Altitude (MSL) of center of image (INT32_MAX if unknown, INT32_MIN if at infinity, not intersecting with horizon).
q float[4] Quaternion of camera orientation (w, x, y, z order, zero-rotation is 1, 0, 0, 0)
hfov float Horizontal field of view (NaN if unknown).
vfov float Vertical field of view (NaN if unknown).
camera_device_id ++ uint8_t Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

CAMERA_TRACKING_IMAGE_STATUS (275)

Camera tracking status, sent while in active tracking. Use MAV_CMD_SET_MESSAGE_INTERVAL to define message interval.

Field Name Type 描述
tracking_status uint8_t CAMERA_TRACKING_STATUS_FLAGS Current tracking status
tracking_mode uint8_t CAMERA_TRACKING_MODE Current tracking mode
target_data uint8_t CAMERA_TRACKING_TARGET_DATA Defines location of target data
point_x float invalid:NaN Current tracked point x value if CAMERA_TRACKING_MODE_POINT (normalized 0..1, 0 is left, 1 is right), NAN if unknown
point_y float invalid:NaN Current tracked point y value if CAMERA_TRACKING_MODE_POINT (normalized 0..1, 0 is top, 1 is bottom), NAN if unknown
radius float invalid:NaN Current tracked radius if CAMERA_TRACKING_MODE_POINT (normalized 0..1, 0 is image left, 1 is image right), NAN if unknown
rec_top_x float invalid:NaN Current tracked rectangle top x value if CAMERA_TRACKING_MODE_RECTANGLE (normalized 0..1, 0 is left, 1 is right), NAN if unknown
rec_top_y float invalid:NaN Current tracked rectangle top y value if CAMERA_TRACKING_MODE_RECTANGLE (normalized 0..1, 0 is top, 1 is bottom), NAN if unknown
rec_bottom_x float invalid:NaN Current tracked rectangle bottom x value if CAMERA_TRACKING_MODE_RECTANGLE (normalized 0..1, 0 is left, 1 is right), NAN if unknown
rec_bottom_y float invalid:NaN Current tracked rectangle bottom y value if CAMERA_TRACKING_MODE_RECTANGLE (normalized 0..1, 0 is top, 1 is bottom), NAN if unknown
camera_device_id ++ uint8_t default:0 min:0 max:6 Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

CAMERA_TRACKING_GEO_STATUS (276)

Camera tracking status, sent while in active tracking. Use MAV_CMD_SET_MESSAGE_INTERVAL to define message interval.

Field Name Type Units 描述
tracking_status uint8_t CAMERA_TRACKING_STATUS_FLAGS Current tracking status
lat int32_t degE7 Latitude of tracked object
lon int32_t degE7 Longitude of tracked object
alt float m Altitude of tracked object(AMSL, WGS84)
h_acc float m invalid:NaN Horizontal accuracy. NAN if unknown
v_acc float m invalid:NaN Vertical accuracy. NAN if unknown
vel_n float m/s invalid:NaN North velocity of tracked object. NAN if unknown
vel_e float m/s invalid:NaN East velocity of tracked object. NAN if unknown
vel_d float m/s invalid:NaN Down velocity of tracked object. NAN if unknown
vel_acc float m/s invalid:NaN Velocity accuracy. NAN if unknown
dist float m invalid:NaN Distance between camera and tracked object. NAN if unknown
hdg float rad invalid:NaN Heading in radians, in NED. NAN if unknown
hdg_acc float rad invalid:NaN Accuracy of heading, in NED. NAN if unknown
camera_device_id ++ uint8_t default:0 min:0 max:6 Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).

CAMERA_THERMAL_RANGE (277)

Camera absolute thermal range. This can be streamed when the associated VIDEO_STREAM_STATUS flag field bit VIDEO_STREAM_STATUS_FLAGS_THERMAL_RANGE_ENABLED is set, but a GCS may choose to only request it for the current active stream. Use MAV_CMD_SET_MESSAGE_INTERVAL to define message interval (param3 indicates the stream id of the current camera, or 0 for all streams, param4 indicates the target camera_device_id for autopilot-attached cameras or 0 for MAVLink cameras).

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
stream_id uint8_t Video Stream ID (1 for first, 2 for second, etc.)
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
camera_device_id uint8_t Camera id of a non-MAVLink camera attached to an autopilot (1-6). 0 if the component is a MAVLink camera (with its own component id).
max float degC Temperature max.
max_point_x float Temperature max point x value (normalized 0..1, 0 is left, 1 is right), NAN if unknown.
max_point_y float Temperature max point y value (normalized 0..1, 0 is top, 1 is bottom), NAN if unknown.
min float degC Temperature min.
min_point_x float Temperature min point x value (normalized 0..1, 0 is left, 1 is right), NAN if unknown.
min_point_y float Temperature min point y value (normalized 0..1, 0 is top, 1 is bottom), NAN if unknown.

GIMBAL_MANAGER_INFORMATION (280)

Information about a high level gimbal manager. This message should be requested by a ground station using MAV_CMD_REQUEST_MESSAGE.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
cap_flags uint32_t GIMBAL_MANAGER_CAP_FLAGS Bitmap of gimbal capability flags.
gimbal_device_id uint8_t Gimbal device ID that this gimbal manager is responsible for. Component ID of gimbal device (or 1-6 for non-MAVLink gimbal).
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
roll_min float rad Minimum hardware roll angle (positive: rolling to the right, negative: rolling to the left)
roll_max float rad Maximum hardware roll angle (positive: rolling to the right, negative: rolling to the left)
pitch_min float rad Minimum pitch angle (positive: up, negative: down)
pitch_max float rad Maximum pitch angle (positive: up, negative: down)
yaw_min float rad Minimum yaw angle (positive: to the right, negative: to the left)
yaw_max float rad Maximum yaw angle (positive: to the right, negative: to the left)

GIMBAL_MANAGER_STATUS (281)

Current status about a high level gimbal manager. This message should be broadcast at a low regular rate (e.g. 5Hz).

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
flags uint32_t GIMBAL_MANAGER_FLAGS High level gimbal manager flags currently applied.
gimbal_device_id uint8_t Gimbal device ID that this gimbal manager is responsible for. Component ID of gimbal device (or 1-6 for non-MAVLink gimbal).
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
primary_control_sysid uint8_t System ID of MAVLink component with primary control, 0 for none.
primary_control_compid uint8_t Component ID of MAVLink component with primary control, 0 for none.
secondary_control_sysid uint8_t System ID of MAVLink component with secondary control, 0 for none.
secondary_control_compid uint8_t Component ID of MAVLink component with secondary control, 0 for none.

GIMBAL_MANAGER_SET_ATTITUDE (282)

High level message to control a gimbal's attitude. This message is to be sent to the gimbal manager (e.g. from a ground station). Angles and rates can be set to NaN according to use case.

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
flags uint32_t GIMBAL_MANAGER_FLAGS High level gimbal manager flags to use.
gimbal_device_id uint8_t Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
q float[4] Quaternion components, w, x, y, z (1 0 0 0 is the null-rotation, the frame is depends on whether the flag GIMBAL_MANAGER_FLAGS_YAW_LOCK is set)
angular_velocity_x float rad/s invalid:NaN X component of angular velocity, positive is rolling to the right, NaN to be ignored.
angular_velocity_y float rad/s invalid:NaN Y component of angular velocity, positive is pitching up, NaN to be ignored.
angular_velocity_z float rad/s invalid:NaN Z component of angular velocity, positive is yawing to the right, NaN to be ignored.

GIMBAL_DEVICE_INFORMATION (283)

Information about a low level gimbal. This message should be requested by the gimbal manager or a ground station using MAV_CMD_REQUEST_MESSAGE. The maximum angles and rates are the limits by hardware. However, the limits by software used are likely different/smaller and dependent on mode/settings/etc..

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
vendor_name charr[32] Name of the gimbal vendor.
model_name charr[32] Name of the gimbal model.
custom_name charr[32] Custom name of the gimbal given to it by the user.
firmware_version uint32_t Version of the gimbal firmware, encoded as: (Dev & 0xff) << 24 + (Patch & 0xff) << 16 + (Minor & 0xff) << 8 + (Major & 0xff).
hardware_version uint32_t Version of the gimbal hardware, encoded as: (Dev & 0xff) << 24 + (Patch & 0xff) << 16 + (Minor & 0xff) << 8 + (Major & 0xff).
uid uint64_t invalid:0 UID of gimbal hardware (0 if unknown).
cap_flags uint16_t GIMBAL_DEVICE_CAP_FLAGS Bitmap of gimbal capability flags.
custom_cap_flags uint16_t Bitmap for use for gimbal-specific capability flags.
roll_min float rad invalid:NaN Minimum hardware roll angle (positive: rolling to the right, negative: rolling to the left). NAN if unknown.
roll_max float rad invalid:NaN Maximum hardware roll angle (positive: rolling to the right, negative: rolling to the left). NAN if unknown.
pitch_min float rad invalid:NaN Minimum hardware pitch angle (positive: up, negative: down). NAN if unknown.
pitch_max float rad invalid:NaN Maximum hardware pitch angle (positive: up, negative: down). NAN if unknown.
yaw_min float rad invalid:NaN Minimum hardware yaw angle (positive: to the right, negative: to the left). NAN if unknown.
yaw_max float rad invalid:NaN Maximum hardware yaw angle (positive: to the right, negative: to the left). NAN if unknown.
gimbal_device_id ++ uint8_t invalid:0 This field is to be used if the gimbal manager and the gimbal device are the same component and hence have the same component ID. This field is then set to a number between 1-6. If the component ID is separate, this field is not required and must be set to 0.
cap_flags2 ++ uint32_t invalid:0 GIMBAL_DEVICE_CAP_FLAGS Extended bitmap of gimbal capability flags (32 bit). For backwards compatibility, the lower 16 bits should also be set in cap_flags. Ground stations should prefer this field if non-zero.

GIMBAL_DEVICE_SET_ATTITUDE (284)

Low level message to control a gimbal device's attitude.

This message is to be sent from the gimbal manager to the gimbal device component. The quaternion and angular velocities can be set to NaN according to use case. For the angles encoded in the quaternion and the angular velocities holds: If the flag GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME is set, then they are relative to the vehicle heading (vehicle frame). If the flag GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME is set, then they are relative to absolute North (earth frame). If neither of these flags are set, then (for backwards compatibility) it holds: If the flag GIMBAL_DEVICE_FLAGS_YAW_LOCK is set, then they are relative to absolute North (earth frame), else they are relative to the vehicle heading (vehicle frame). Setting both GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME and GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME is not allowed. These rules are to ensure backwards compatibility. New implementations should always set either GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME or GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME.

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
flags uint16_t GIMBAL_DEVICE_FLAGS Low level gimbal flags.
q float[4] invalid:[NaN] Quaternion components, w, x, y, z (1 0 0 0 is the null-rotation). The frame is described in the message description. Set fields to NaN to be ignored.
angular_velocity_x float rad/s invalid:NaN X component of angular velocity (positive: rolling to the right). The frame is described in the message description. NaN to be ignored.
angular_velocity_y float rad/s invalid:NaN Y component of angular velocity (positive: pitching up). The frame is described in the message description. NaN to be ignored.
angular_velocity_z float rad/s invalid:NaN Z component of angular velocity (positive: yawing to the right). The frame is described in the message description. NaN to be ignored.

GIMBAL_DEVICE_ATTITUDE_STATUS (285)

Message reporting the status of a gimbal device.

This message should be broadcast by a gimbal device component at a low regular rate (e.g. 5 Hz). For the angles encoded in the quaternion and the angular velocities holds: If the flag GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME is set, then they are relative to the vehicle heading (vehicle frame). If the flag GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME is set, then they are relative to absolute North (earth frame). If neither of these flags are set, then (for backwards compatibility) it holds: If the flag GIMBAL_DEVICE_FLAGS_YAW_LOCK is set, then they are relative to absolute North (earth frame), else they are relative to the vehicle heading (vehicle frame). Other conditions of the flags are not allowed. The quaternion and angular velocities in the other frame can be calculated from delta_yaw and delta_yaw_velocity as q_earth = q_delta_yaw * q_vehicle and w_earth = w_delta_yaw_velocity + w_vehicle (if not NaN). If neither the GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME nor the GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME flag is set, then (for backwards compatibility) the data in the delta_yaw and delta_yaw_velocity fields are to be ignored. New implementations should always set either GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME or GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME, and always should set delta_yaw and delta_yaw_velocity either to the proper value or NaN.

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
time_boot_ms uint32_t ms Timestamp (time since system boot).
flags uint16_t GIMBAL_DEVICE_FLAGS Current gimbal flags set.
q float[4] Quaternion components, w, x, y, z (1 0 0 0 is the null-rotation). The frame is described in the message description.
angular_velocity_x float rad/s invalid:NaN X component of angular velocity (positive: rolling to the right). The frame is described in the message description. NaN if unknown.
angular_velocity_y float rad/s invalid:NaN Y component of angular velocity (positive: pitching up). The frame is described in the message description. NaN if unknown.
angular_velocity_z float rad/s invalid:NaN Z component of angular velocity (positive: yawing to the right). The frame is described in the message description. NaN if unknown.
failure_flags uint32_t GIMBAL_DEVICE_ERROR_FLAGS Failure flags (0 for no failure)
delta_yaw ++ float rad invalid:NAN Yaw angle relating the quaternions in earth and body frames (see message description). NaN if unknown.
delta_yaw_velocity ++ float rad/s invalid:NAN Yaw angular velocity relating the angular velocities in earth and body frames (see message description). NaN if unknown.
gimbal_device_id ++ uint8_t invalid:0 This field is to be used if the gimbal manager and the gimbal device are the same component and hence have the same component ID. This field is then set a number between 1-6. If the component ID is separate, this field is not required and must be set to 0.

AUTOPILOT_STATE_FOR_GIMBAL_DEVICE (286)

Low level message containing autopilot state relevant for a gimbal device. This message is to be sent from the autopilot to the gimbal device component. The data of this message are for the gimbal device's estimator corrections, in particular horizon compensation, as well as indicates autopilot control intentions, e.g. feed forward angular control in the z-axis.

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
time_boot_us uint64_t us Timestamp (time since system boot).
q float[4] Quaternion components of autopilot attitude: w, x, y, z (1 0 0 0 is the null-rotation, Hamilton convention).
q_estimated_delay_us uint32_t us invalid:0 Estimated delay of the attitude data. 0 if unknown.
vx float m/s invalid:NaN X Speed in NED (North, East, Down). NAN if unknown.
vy float m/s invalid:NaN Y Speed in NED (North, East, Down). NAN if unknown.
vz float m/s invalid:NaN Z Speed in NED (North, East, Down). NAN if unknown.
v_estimated_delay_us uint32_t us invalid:0 Estimated delay of the speed data. 0 if unknown.
feed_forward_angular_velocity_z float rad/s invalid:NaN Feed forward Z component of angular velocity (positive: yawing to the right). NaN to be ignored. This is to indicate if the autopilot is actively yawing.
estimator_status uint16_t ESTIMATOR_STATUS_FLAGS Bitmap indicating which estimator outputs are valid.
landed_state uint8_t invalid:MAV_LANDED_STATE_UNDEFINED MAV_LANDED_STATE The landed state. Is set to MAV_LANDED_STATE_UNDEFINED if landed state is unknown.
angular_velocity_z ++ float rad/s invalid:0 Z component of angular velocity in NED (North, East, Down). 0 if unknown. Use 0.00001 to represent a measured value of zero.

GIMBAL_MANAGER_SET_PITCHYAW (287)

Set gimbal manager pitch and yaw angles (high rate message). This message is to be sent to the gimbal manager (e.g. from a ground station) and will be ignored by gimbal devices. Angles and rates can be set to NaN according to use case. Use MAV_CMD_DO_GIMBAL_MANAGER_PITCHYAW for low-rate adjustments that require confirmation.

Field Name Type Units 描述
target_system uint8_t System ID
target_component uint8_t Component ID
flags uint32_t GIMBAL_MANAGER_FLAGS High level gimbal manager flags to use.
gimbal_device_id uint8_t Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
俯仰角 float rad invalid:NaN Pitch angle (positive: up, negative: down, NaN to be ignored).
yaw float rad invalid:NaN Yaw angle (positive: to the right, negative: to the left, NaN to be ignored).
pitch_rate float rad/s invalid:NaN Pitch angular rate (positive: up, negative: down, NaN to be ignored).
yaw_rate float rad/s invalid:NaN Yaw angular rate (positive: to the right, negative: to the left, NaN to be ignored).

GIMBAL_MANAGER_SET_MANUAL_CONTROL (288)

High level message to control a gimbal manually. The angles or angular rates are unitless; the actual rates will depend on internal gimbal manager settings/configuration (e.g. set by parameters). This message is to be sent to the gimbal manager (e.g. from a ground station). Angles and rates can be set to NaN according to use case.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
flags uint32_t GIMBAL_MANAGER_FLAGS High level gimbal manager flags.
gimbal_device_id uint8_t Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
俯仰角 float invalid:NaN Pitch angle unitless (-1..1, positive: up, negative: down, NaN to be ignored).
yaw float invalid:NaN Yaw angle unitless (-1..1, positive: to the right, negative: to the left, NaN to be ignored).
pitch_rate float invalid:NaN Pitch angular rate unitless (-1..1, positive: up, negative: down, NaN to be ignored).
yaw_rate float invalid:NaN Yaw angular rate unitless (-1..1, positive: to the right, negative: to the left, NaN to be ignored).

ESC_INFO (290) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

ESC information for lower rate streaming. Recommended streaming rate 1Hz. See ESC_STATUS for higher-rate ESC data.

Field Name Type Units 描述
index uint8_t Index of the first ESC in this message (ESC are indexed in motor order). minValue = 0, maxValue = 60, increment = 4.
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude the number.
counter uint16_t Counter of data packets received.
count uint8_t Total number of ESCs in all messages of this type. Message fields with an index higher than this should be ignored because they contain invalid data.
connection_type uint8_t ESC_CONNECTION_TYPE Connection type protocol for all ESC.
info uint8_t Information regarding online/offline status of each ESC.
failure_flags uint16_t[4] ESC_FAILURE_FLAGS Bitmap of ESC failure flags.
error_count uint32_t[4] Number of reported errors by each ESC since boot.
temperature int16_t[4] cdegC invalid:[INT16_MAX] Temperature of each ESC. INT16_MAX: if data not supplied by ESC.

ESC_STATUS (291) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

ESC information for higher rate streaming. Recommended streaming rate is ~10 Hz. Information that changes more slowly is sent in ESC_INFO. It should typically only be streamed on high-bandwidth links (i.e. to a companion computer).

Field Name Type Units 描述
index uint8_t Index of the first ESC in this message (ESC are indexed in motor order). minValue = 0, maxValue = 60, increment = 4.
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude the number.
rpm int32_t[4] rpm Reported motor RPM from each ESC (negative for reverse rotation).
voltage float[4] V Voltage measured from each ESC.
current float[4] A Current measured from each ESC.

AIRSPEED (295)

Airspeed information from a sensor.

Field Name Type Units 描述
id uint8_t Sensor ID.
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
airspeed float m/s Calibrated airspeed (CAS).
temperature int16_t cdegC invalid:INT16_MAX Temperature.
raw_press float hPa invalid:NaN Raw differential pressure.
flags uint8_t AIRSPEED_SENSOR_FLAGS Airspeed sensor flags.

GLOBAL_POSITION_SENSOR (296)

Reports measurement/estimate from a global position sensor. Used as navigation fusion source and optionally displayed in the UI.

Field Name Type Units 描述
target_system uint8_t default:0 System ID (ID of target system, normally autopilot and ground station).
target_component uint8_t default:0 Component ID (normally 0 for broadcast).
id uint8_t Sensor ID
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
time_usec uint64_t us Timestamp of message transmission (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
processing_time uint32_t us The time spent in processing the sensor data that is the basis for this position. The recipient can use this to improve time alignment of the data. This is the time between measurement (e.g. camera exposure time) and transmission of this message. Set to NaN if not known.
source uint8_t GLOBAL_POSITION_SRC Source of position/estimate (such as GNSS, estimator, etc.)
flags uint8_t GLOBAL_POSITION_FLAGS Status flags
lat int32_t degE7 invalid:INT32_MAX Latitude (WGS84)
lon int32_t degE7 invalid:INT32_MAX Longitude (WGS84)
alt_ellipsoid float m invalid:NaN Altitude (WGS84 elipsoid), preferred if available
alt float m invalid:NaN Altitude (MSL - position-system specific value) use if no alt_ellipsoid available
eph float m invalid:NaN Standard deviation of horizontal position error
epv float m invalid:NaN Standard deviation of vertical position error

WIFI_CONFIG_AP (299)

Configure WiFi AP SSID, password, and mode. This message is re-emitted as an acknowledgement by the AP. The message may also be explicitly requested using MAV_CMD_REQUEST_MESSAGE

Field Name Type 描述
ssid charr[32] Name of Wi-Fi network (SSID). Blank to leave it unchanged when setting. Current SSID when sent back as a response.
password char[64] Password. Blank for an open AP. MD5 hash when message is sent back as a response.
mode ++ int8_t WIFI_CONFIG_AP_MODE WiFi Mode.
response ++ int8_t WIFI_CONFIG_AP_RESPONSE Message acceptance response (sent back to GS).

PROTOCOL_VERSION (300) — [DEP]

DEPRECATED: Replaced By Nothing (2025-11) — No longer needed. Support is being removed from flight stacks.)

Version and capability of protocol version. This message can be requested with MAV_CMD_REQUEST_MESSAGE and is used as part of the handshaking to establish which MAVLink version should be used on the network. Every node should respond to a request for PROTOCOL_VERSION to enable the handshaking. Library implementers should consider adding this into the default decoding state machine to allow the protocol core to respond directly.

Field Name Type 描述
version uint16_t Currently active MAVLink version number * 100: v1.0 is 100, v2.0 is 200, etc.
min_version uint16_t Minimum MAVLink version supported
max_version uint16_t Maximum MAVLink version supported (set to the same value as version by default)
spec_version_hash uint8_t[8] The first 8 bytes (not characters printed in hex!) of the git hash.
library_version_hash uint8_t[8] The first 8 bytes (not characters printed in hex!) of the git hash.

AIS_VESSEL (301)

The location and information of an AIS vessel

Field Name Type Units 描述
MMSI uint32_t Mobile Marine Service Identifier, 9 decimal digits
lat int32_t degE7 invalid:INT32_MAX Latitude
lon int32_t degE7 invalid:INT32_MAX Longitude
COG uint16_t cdeg invalid:UINT16_MAX Course over ground
heading uint16_t cdeg invalid:UINT16_MAX True heading
velocity uint16_t 厘米/秒 invalid:UINT16_MAX Speed over ground
turn_rate int8_t ddeg/s invalid:INT8_MAX Turn rate, 0.1 degrees per second
navigational_status uint8_t AIS_NAV_STATUS Navigational status
type uint8_t AIS_TYPE Type of vessels
dimension_bow uint16_t m invalid:UINT16_MAX Distance from lat/lon location to bow
dimension_stern uint16_t m invalid:UINT16_MAX Distance from lat/lon location to stern
dimension_port uint8_t m invalid:UINT8_MAX Distance from lat/lon location to port side
dimension_starboard uint8_t m invalid:UINT8_MAX Distance from lat/lon location to starboard side
callsign char[7] The vessel callsign. Characters are encoded as 7-bit ASCII, but only characters in the AIS 6-bit ASCII subset are permitted. Also set AIS_FLAGS_VALID_CALLSIGN if valid. The string is NULL-terminated if it is shorter than the array length.
name char[20] The vessel name. Characters are encoded as 7-bit ASCII, but only characters in the AIS 6-bit ASCII subset are permitted. Also set AIS_FLAGS_VALID_NAME if valid. The string is NULL-terminated if it is shorter than the array length.
tslc uint16_t s Time since last communication from the vessel, in seconds
flags uint16_t AIS_FLAGS Bitmask to indicate various statuses including valid data fields

UAVCAN_NODE_STATUS (310)

General status information of an UAVCAN node. Please refer to the definition of the UAVCAN message "uavcan.protocol.NodeStatus" for the background information. The UAVCAN specification is available at http://uavcan.org.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
uptime_sec uint32_t s Time since the start-up of the node.
health uint8_t UAVCAN_NODE_HEALTH Generalized node health status.
模式 uint8_t UAVCAN_NODE_MODE Generalized operating mode.
sub_mode uint8_t Not used currently.
vendor_specific_status_code uint16_t Vendor-specific status information.

UAVCAN_NODE_INFO (311)

General information describing a particular UAVCAN node.

Please refer to the definition of the UAVCAN service "uavcan.protocol.GetNodeInfo" for the background information. This message should be emitted by the system whenever a new node appears online, or an existing node reboots. The message may also be explicitly requested using MAV_CMD_REQUEST_MESSAGE. It is also not prohibited to emit this message unconditionally at a low frequency. The DroneCAN specification is available at https://dronecan.github.io/Specification/1._Introduction/.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
uptime_sec uint32_t s Time since the start-up of the node.
name char[80] Node name string. For example, "sapog.px4.io".
hw_version_major uint8_t Hardware major version number.
hw_version_minor uint8_t Hardware minor version number.
hw_unique_id uint8_t[16] Hardware unique 128-bit ID.
sw_version_major uint8_t Software major version number.
sw_version_minor uint8_t Software minor version number.
sw_vcs_commit uint32_t Version control system (VCS) revision identifier (e.g. git short commit hash). 0 if unknown.

PARAM_EXT_REQUEST_READ (320)

Request to read the value of a parameter with either the param_id string id or param_index. PARAM_EXT_VALUE should be emitted in response.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
param_id char[16] Parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_index int16_t Parameter index. Set to -1 to use the Parameter ID field as identifier (else param_id will be ignored)

PARAM_EXT_REQUEST_LIST (321)

Request all parameters of this component. All parameters should be emitted in response as PARAM_EXT_VALUE.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID

PARAM_EXT_VALUE (322)

Emit the value of a parameter. The inclusion of param_count and param_index in the message allows the recipient to keep track of received parameters and allows them to re-request missing parameters after a loss or timeout.

Field Name Type 描述
param_id char[16] Parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_value char[128] Parameter value
param_type uint8_t MAV_PARAM_EXT_TYPE Parameter type.
param_count uint16_t Total number of parameters
param_index uint16_t Index of this parameter

PARAM_EXT_SET (323)

Set a parameter value. In order to deal with message loss (and retransmission of PARAM_EXT_SET), when setting a parameter value and the new value is the same as the current value, you will immediately get a PARAM_ACK_ACCEPTED response. If the current state is PARAM_ACK_IN_PROGRESS, you will accordingly receive a PARAM_ACK_IN_PROGRESS in response.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
param_id char[16] Parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_value char[128] Parameter value
param_type uint8_t MAV_PARAM_EXT_TYPE Parameter type.

PARAM_EXT_ACK (324)

Response from a PARAM_EXT_SET message.

Field Name Type 描述
param_id char[16] Parameter id, terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_value char[128] Parameter value (new value if PARAM_ACK_ACCEPTED, current value otherwise)
param_type uint8_t MAV_PARAM_EXT_TYPE Parameter type.
param_result uint8_t PARAM_ACK Result code.

OBSTACLE_DISTANCE (330)

Obstacle distances in front of the sensor, starting from the left in increment degrees to the right

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
sensor_type uint8_t MAV_DISTANCE_SENSOR Class id of the distance sensor type.
distances uint16_t[72] 厘米 invalid:[UINT16_MAX] Distance of obstacles around the vehicle with index 0 corresponding to north + angle_offset, unless otherwise specified in the frame. A value of 0 is valid and means that the obstacle is practically touching the sensor. A value of max_distance +1 means no obstacle is present. A value of UINT16_MAX for unknown/not used. In a array element, one unit corresponds to 1cm.
increment uint8_t Angular width in degrees of each array element. Increment direction is clockwise. This field is ignored if increment_f is non-zero.
min_distance uint16_t 厘米 Minimum distance the sensor can measure.
max_distance uint16_t 厘米 Maximum distance the sensor can measure.
increment_f ++ float Angular width in degrees of each array element as a float. If non-zero then this value is used instead of the uint8_t increment field. Positive is clockwise direction, negative is counter-clockwise.
angle_offset ++ float Relative angle offset of the 0-index element in the distances array. Value of 0 corresponds to forward. Positive is clockwise direction, negative is counter-clockwise.
frame ++ uint8_t MAV_FRAME Coordinate frame of reference for the yaw rotation and offset of the sensor data. Defaults to MAV_FRAME_GLOBAL, which is north aligned. For body-mounted sensors use MAV_FRAME_BODY_FRD, which is vehicle front aligned.

ODOMETRY (331)

Odometry message to communicate odometry information with an external interface. Fits ROS REP 147 standard for aerial vehicles (http://www.ros.org/reps/rep-0147.html).

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
frame_id uint8_t MAV_FRAME Coordinate frame of reference for the pose data.
child_frame_id uint8_t MAV_FRAME Coordinate frame of reference for the velocity in free space (twist) data.
x float m X Position
y float m Y Position
z float m Z Position
q float[4] Quaternion components, w, x, y, z (1 0 0 0 is the null-rotation)
vx float m/s X linear speed
vy float m/s Y linear speed
vz float m/s Z linear speed
rollspeed float rad/s Roll angular speed
pitchspeed float rad/s Pitch angular speed
yawspeed float rad/s Yaw angular speed
pose_covariance float[21] invalid:[NaN:] Row-major representation of a 6x6 pose cross-covariance matrix upper right triangle (states: x, y, z, roll, pitch, yaw; first six entries are the first ROW, next five entries are the second ROW, etc.). If unknown, assign NaN value to first element in the array.
velocity_covariance float[21] invalid:[NaN:] Row-major representation of a 6x6 velocity cross-covariance matrix upper right triangle (states: vx, vy, vz, rollspeed, pitchspeed, yawspeed; first six entries are the first ROW, next five entries are the second ROW, etc.). If unknown, assign NaN value to first element in the array.
reset_counter ++ uint8_t Estimate reset counter. This should be incremented when the estimate resets in any of the dimensions (position, velocity, attitude, angular speed). This is designed to be used when e.g an external SLAM system detects a loop-closure and the estimate jumps.
estimator_type ++ uint8_t MAV_ESTIMATOR_TYPE Type of estimator that is providing the odometry.
quality ++ int8_t % invalid:0 Optional odometry quality metric as a percentage. -1 = odometry has failed, 0 = unknown/unset quality, 1 = worst quality, 100 = best quality

TRAJECTORY_REPRESENTATION_WAYPOINTS (332) — [DEP]

DEPRECATED: Replaced By Nothing (2025-03) — Implemented PX4 v1.11 to v1.14. Not used in current flight stacks.)

Describe a trajectory using an array of up-to 5 waypoints in the local frame (MAV_FRAME_LOCAL_NED).

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
valid_points uint8_t Number of valid points (up-to 5 waypoints are possible)
pos_x float[5] m invalid:[NaN] X-coordinate of waypoint, set to NaN if not being used
pos_y float[5] m invalid:[NaN] Y-coordinate of waypoint, set to NaN if not being used
pos_z float[5] m invalid:[NaN] Z-coordinate of waypoint, set to NaN if not being used
vel_x float[5] m/s invalid:[NaN] X-velocity of waypoint, set to NaN if not being used
vel_y float[5] m/s invalid:[NaN] Y-velocity of waypoint, set to NaN if not being used
vel_z float[5] m/s invalid:[NaN] Z-velocity of waypoint, set to NaN if not being used
acc_x float[5] m/s/s invalid:[NaN] X-acceleration of waypoint, set to NaN if not being used
acc_y float[5] m/s/s invalid:[NaN] Y-acceleration of waypoint, set to NaN if not being used
acc_z float[5] m/s/s invalid:[NaN] Z-acceleration of waypoint, set to NaN if not being used
pos_yaw float[5] rad invalid:[NaN] Yaw angle, set to NaN if not being used
vel_yaw float[5] rad/s invalid:[NaN] Yaw rate, set to NaN if not being used
command uint16_t[5] invalid:[UINT16_MAX] MAV_CMD MAV_CMD command id of waypoint, set to UINT16_MAX if not being used.

TRAJECTORY_REPRESENTATION_BEZIER (333) — [DEP]

DEPRECATED: Replaced By Nothing (2025-03) — Implemented PX4 v1.11 to v1.14. Not used in current flight stacks.)

Describe a trajectory using an array of up-to 5 bezier control points in the local frame (MAV_FRAME_LOCAL_NED).

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
valid_points uint8_t Number of valid control points (up-to 5 points are possible)
pos_x float[5] m X-coordinate of bezier control points. Set to NaN if not being used
pos_y float[5] m Y-coordinate of bezier control points. Set to NaN if not being used
pos_z float[5] m Z-coordinate of bezier control points. Set to NaN if not being used
delta float[5] s Bezier time horizon. Set to NaN if velocity/acceleration should not be incorporated
pos_yaw float[5] rad Yaw. Set to NaN for unchanged

CELLULAR_STATUS (334)

Cellular network status as reported by a particular modem.

This is primarily intended for logging, but a GCS may choose to display link_tx_rate and link_rx_rate.

Note that a value of 0 in the id field indicates that the sender does not support reporting of multiple modems. Message data should be from a single modem, but that is not guaranteed.

Field Name Type Units 描述
status uint8_t CELLULAR_STATUS_FLAG Cellular modem status
failure_reason uint8_t CELLULAR_NETWORK_FAILED_REASON Failure reason when status in in CELLULAR_STATUS_FLAG_FAILED
type uint8_t CELLULAR_NETWORK_RADIO_TYPE Cellular network radio type: gsm, cdma, lte...
quality uint8_t invalid:UINT8_MAX Signal quality in percent. If unknown, set to UINT8_MAX
mcc uint16_t invalid:UINT16_MAX Mobile country code. If unknown, set to UINT16_MAX
mnc uint16_t invalid:UINT16_MAX Mobile network code. If unknown, set to UINT16_MAX
lac uint16_t invalid:0 Location area code. If unknown, set to 0
id ++ uint8_t min:1 Cellular modem instance number. Indexed from 1.
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
link_tx_rate ++ uint32_t KiB/s invalid:0 Download rate.
link_rx_rate ++ uint32_t KiB/s invalid:0 Upload rate.
cell_tower_id ++ char[9] invalid:0 ID of the currently connected cell tower. This must be NULL terminated if the length is less than 9 human-readable chars, and without the null termination (NULL) byte if the length is exactly 9 chars.
band_number ++ uint8_t invalid:0 LTE frequency band number.
band_frequency ++ float MHz invalid:0 LTE radio frequency.
channel_number ++ uint32_t invalid:0 The channel number (CN). Absolute radio-frequency (ARFCN) / E-UTRA (EARFCN) / UTRA (UARFCN) / New radio (NR_CH).
rx_level ++ float dBm invalid:0 On 3G is Received Signal Code Power (RSCP). On LTE is Reference Signal Received Power (RSRP). On 5G is New Radio Reference Signal Received Power (NR_RSRP).
tx_level ++ float dBm invalid:0 Transmitter (modem) signal absolute power level.
rx_quality ++ float dBm invalid:0 On 3G is Receiver Quality (RxQual). On LTE is Reference Signal Received Quality (RSRQ). On 5G is New Radio Reference Signal Received Quality (NR_RSRQ).
sinr ++ float dB invalid:0 Signal to interference plus noise ratio (SINR).

Status of the Iridium SBD link.

Field Name Type Units 描述
timestamp uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
last_heartbeat uint64_t us Timestamp of the last successful sbd session. The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
failed_sessions uint16_t Number of failed SBD sessions.
successful_sessions uint16_t Number of successful SBD sessions.
signal_quality uint8_t Signal quality equal to the number of bars displayed on the ISU signal strength indicator. Range is 0 to 5, where 0 indicates no signal and 5 indicates maximum signal strength.
ring_pending uint8_t 1: Ring call pending, 0: No call pending.
tx_session_pending uint8_t 1: Transmission session pending, 0: No transmission session pending.
rx_session_pending uint8_t 1: Receiving session pending, 0: No receiving session pending.

CELLULAR_CONFIG (336)

Configure cellular modems.

This message is re-emitted as an acknowledgement by the modem. The message may also be explicitly requested using MAV_CMD_REQUEST_MESSAGE.

Field Name Type 描述
enable_lte uint8_t Enable/disable LTE. 0: setting unchanged, 1: disabled, 2: enabled. Current setting when sent back as a response.
enable_pin uint8_t Enable/disable PIN on the SIM card. 0: setting unchanged, 1: disabled, 2: enabled. Current setting when sent back as a response.
pin char[16] PIN sent to the SIM card. Blank when PIN is disabled. Empty when message is sent back as a response.
new_pin char[16] New PIN when changing the PIN. Blank to leave it unchanged. Empty when message is sent back as a response.
apn charr[32] Name of the cellular APN. Blank to leave it unchanged. Current APN when sent back as a response.
puk char[16] Required PUK code in case the user failed to authenticate 3 times with the PIN. Empty when message is sent back as a response.
roaming uint8_t Enable/disable roaming. 0: setting unchanged, 1: disabled, 2: enabled. Current setting when sent back as a response.
response uint8_t CELLULAR_CONFIG_RESPONSE Message acceptance response (sent back to GS).

RAW_RPM (339)

RPM sensor data message.

Field Name Type Units 描述
index uint8_t Index of this RPM sensor (0-indexed)
frequency float rpm Indicated rate

UTM_GLOBAL_POSITION (340)

The global position resulting from GPS and sensor fusion.

Field Name Type Units 描述
time uint64_t us Time of applicability of position (microseconds since UNIX epoch).
uas_id uint8_t[18] Unique UAS ID.
lat int32_t degE7 Latitude (WGS84)
lon int32_t degE7 Longitude (WGS84)
alt int32_t 毫米 Altitude (WGS84)
relative_alt int32_t 毫米 Altitude above ground
vx int16_t 厘米/秒 Ground X speed (latitude, positive north)
vy int16_t 厘米/秒 Ground Y speed (longitude, positive east)
vz int16_t 厘米/秒 Ground Z speed (altitude, positive down)
h_acc uint16_t 毫米 Horizontal position uncertainty (standard deviation)
v_acc uint16_t 毫米 Altitude uncertainty (standard deviation)
vel_acc uint16_t 厘米/秒 Speed uncertainty (standard deviation)
next_lat int32_t degE7 Next waypoint, latitude (WGS84)
next_lon int32_t degE7 Next waypoint, longitude (WGS84)
next_alt int32_t 毫米 Next waypoint, altitude (WGS84)
update_rate uint16_t cs invalid:0 Time until next update. Set to 0 if unknown or in data driven mode.
flight_state uint8_t UTM_FLIGHT_STATE Flight state
flags uint8_t UTM_DATA_AVAIL_FLAGS Bitwise OR combination of the data available flags.

PARAM_ERROR (345) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Parameter set/get error. Returned from a MAVLink node in response to an error in the parameter protocol, for example failing to set a parameter because it does not exist.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
param_id char[16] Parameter id. Terminated by NULL if the length is less than 16 human-readable chars and WITHOUT null termination (NULL) byte if the length is exactly 16 chars - applications have to provide 16+1 bytes storage if the ID is stored as string
param_index int16_t Parameter index. Will be -1 if the param ID field should be used as an identifier (else the param id will be ignored)
error uint8_t MAV_PARAM_ERROR Error being returned to client.

DEBUG_FLOAT_ARRAY (350)

Large debug/prototyping array. The message uses the maximum available payload for data. The array_id and name fields are used to discriminate between messages in code and in user interfaces (respectively). Do not use in production code.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
name charr[10] Name, for human-friendly display in a Ground Control Station
array_id uint16_t Unique ID used to discriminate between arrays
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
data ++ float[58] data

ORBIT_EXECUTION_STATUS (360)

Vehicle status report that is sent out while orbit execution is in progress (see MAV_CMD_DO_ORBIT).

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
radius float m Radius of the orbit circle. Positive values orbit clockwise, negative values orbit counter-clockwise.
frame uint8_t MAV_FRAME The coordinate system of the fields: x, y, z.
x int32_t X coordinate of center point. Coordinate system depends on frame field: local = x position in meters * 1e4, global = latitude in degrees * 1e7.
y int32_t Y coordinate of center point. Coordinate system depends on frame field: local = x position in meters * 1e4, global = latitude in degrees * 1e7.
z float m Altitude of center point. Coordinate system depends on frame field.

FIGURE_EIGHT_EXECUTION_STATUS (361)

Vehicle status report that is sent out while figure eight execution is in progress (see MAV_CMD_DO_FIGURE_EIGHT). This may typically send at low rates: of the order of 2Hz.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
major_radius float m Major axis radius of the figure eight. Positive: orbit the north circle clockwise. Negative: orbit the north circle counter-clockwise.
minor_radius float m Minor axis radius of the figure eight. Defines the radius of two circles that make up the figure.
orientation float rad Orientation of the figure eight major axis with respect to true north in [-pi,pi).
frame uint8_t MAV_FRAME The coordinate system of the fields: x, y, z.
x int32_t X coordinate of center point. Coordinate system depends on frame field.
y int32_t Y coordinate of center point. Coordinate system depends on frame field.
z float m Altitude of center point. Coordinate system depends on frame field.

SMART_BATTERY_INFO (370) — [SUP]

SUPERSEDED: Replaced By BATTERY_INFO (2024-02) — The BATTERY_INFO message is better aligned with UAVCAN messages, and in any case is useful even if a battery is not "smart".)

Smart Battery information (static/infrequent update). Use for updates from: smart battery to flight stack, flight stack to GCS. Use BATTERY_STATUS for the frequent battery updates.

Field Name Type Units 描述
id uint8_t Battery ID
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
battery_function uint8_t MAV_BATTERY_FUNCTION Function of the battery
type uint8_t MAV_BATTERY_TYPE Type (chemistry) of the battery
capacity_full_specification int32_t mAh invalid:-1 Capacity when full according to manufacturer, -1: field not provided.
capacity_full int32_t mAh invalid:-1 Capacity when full (accounting for battery degradation), -1: field not provided.
cycle_count uint16_t invalid:UINT16_MAX Charge/discharge cycle count. UINT16_MAX: field not provided.
serial_number char[16] invalid:[0] Serial number in ASCII characters, 0 terminated. All 0: field not provided.
device_name char[50] invalid:[0] Static device name in ASCII characters, 0 terminated. All 0: field not provided. Encode as manufacturer name then product name separated using an underscore.
weight uint16_t g invalid:0 Battery weight. 0: field not provided.
discharge_minimum_voltage uint16_t mV invalid:UINT16_MAX Minimum per-cell voltage when discharging. If not supplied set to UINT16_MAX value.
charging_minimum_voltage uint16_t mV invalid:UINT16_MAX Minimum per-cell voltage when charging. If not supplied set to UINT16_MAX value.
resting_minimum_voltage uint16_t mV invalid:UINT16_MAX Minimum per-cell voltage when resting. If not supplied set to UINT16_MAX value.
charging_maximum_voltage ++ uint16_t mV invalid:0 Maximum per-cell voltage when charged. 0: field not provided.
cells_in_series ++ uint8_t invalid:0 Number of battery cells in series. 0: field not provided.
discharge_maximum_current ++ uint32_t mA invalid:0 Maximum pack discharge current. 0: field not provided.
discharge_maximum_burst_current ++ uint32_t mA invalid:0 Maximum pack discharge burst current. 0: field not provided.
manufacture_date ++ char[11] invalid:[0] Manufacture date (DD/MM/YYYY) in ASCII characters, 0 terminated. All 0: field not provided.

FUEL_STATUS (371)

Fuel status.

This message provides "generic" fuel level information for in a GCS and for triggering failsafes in an autopilot. The fuel type and associated units for fields in this message are defined in the enum MAV_FUEL_TYPE.

The reported consumed_fuel and remaining_fuel must only be supplied if measured: they must not be inferred from the maximum_fuel and the other value. A recipient can assume that if these fields are supplied they are accurate. If not provided, the recipient can infer remaining_fuel from maximum_fuel and consumed_fuel on the assumption that the fuel was initially at its maximum (this is what battery monitors assume). Note however that this is an assumption, and the UI should prompt the user appropriately (i.e. notify user that they should fill the tank before boot).

This kind of information may also be sent in fuel-specific messages such as BATTERY_STATUS_V2. If both messages are sent for the same fuel system, the ids and corresponding information must match.

This should be streamed (nominally at 0.1 Hz).

Field Name Type Units 描述
id uint8_t Fuel ID. Must match ID of other messages for same fuel system, such as BATTERY_STATUS_V2.
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
maximum_fuel float Capacity when full. Must be provided.
consumed_fuel float invalid:NaN Consumed fuel (measured). This value should not be inferred: if not measured set to NaN. NaN: field not provided.
remaining_fuel float invalid:NaN Remaining fuel until empty (measured). The value should not be inferred: if not measured set to NaN. NaN: field not provided.
percent_remaining uint8_t % invalid:UINT8_MAX Percentage of remaining fuel, relative to full. Values: [0-100], UINT8_MAX: field not provided.
flow_rate float invalid:NaN Positive value when emptying/using, and negative if filling/replacing. NaN: field not provided.
temperature float K invalid:NaN Fuel temperature. NaN: field not provided.
fuel_type uint32_t MAV_FUEL_TYPE Fuel type. Defines units for fuel capacity and consumption fields above.

BATTERY_INFO (372) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Battery information that is static, or requires infrequent update. This message should requested using MAV_CMD_REQUEST_MESSAGE and/or streamed at very low rate. BATTERY_STATUS_V2 is used for higher-rate battery status information.

Field Name Type Units 描述
id uint8_t Battery ID
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
battery_function uint8_t MAV_BATTERY_FUNCTION Function of the battery.
type uint8_t MAV_BATTERY_TYPE Type (chemistry) of the battery.
state_of_health uint8_t % invalid:UINT8_MAX State of Health (SOH) estimate. Typically 100% at the time of manufacture and will decrease over time and use. -1: field not provided.
cells_in_series uint8_t invalid:0 Number of battery cells in series. 0: field not provided.
cycle_count uint16_t invalid:UINT16_MAX Lifetime count of the number of charge/discharge cycles (https://en.wikipedia.org/wiki/Charge_cycle). UINT16_MAX: field not provided.
weight uint16_t g invalid:0 Battery weight. 0: field not provided.
discharge_minimum_voltage float V invalid:0 Minimum per-cell voltage when discharging. 0: field not provided.
charging_minimum_voltage float V invalid:0 Minimum per-cell voltage when charging. 0: field not provided.
resting_minimum_voltage float V invalid:0 Minimum per-cell voltage when resting. 0: field not provided.
charging_maximum_voltage float V invalid:0 Maximum per-cell voltage when charged. 0: field not provided.
charging_maximum_current float A invalid:0 Maximum pack continuous charge current. 0: field not provided.
nominal_voltage float V invalid:0 Battery nominal voltage. Used for conversion between Wh and Ah. 0: field not provided.
discharge_maximum_current float A invalid:0 Maximum pack discharge current. 0: field not provided.
discharge_maximum_burst_current float A invalid:0 Maximum pack discharge burst current. 0: field not provided.
design_capacity float Ah invalid:0 Fully charged design capacity. 0: field not provided.
full_charge_capacity float Ah invalid:NaN Predicted battery capacity when fully charged (accounting for battery degradation). NAN: field not provided.
manufacture_date char[9] invalid:[0] Manufacture date (DDMMYYYY) in ASCII characters, 0 terminated. All 0: field not provided.
serial_number charr[32] invalid:[0] Serial number in ASCII characters, 0 terminated. All 0: field not provided.
name char[50] invalid:[0] Battery device name. Formatted as manufacturer name then product name, separated with an underscore (in ASCII characters), 0 terminated. All 0: field not provided.

GENERATOR_STATUS (373)

Telemetry of power generation system. Alternator or mechanical generator.

Field Name Type Units 描述
status uint64_t MAV_GENERATOR_STATUS_FLAG Status flags.
generator_speed uint16_t rpm invalid:UINT16_MAX Speed of electrical generator or alternator. UINT16_MAX: field not provided.
battery_current float A invalid:NaN Current into/out of battery. Positive for out. Negative for in. NaN: field not provided.
load_current float A invalid:NaN Current going to the UAV. If battery current not available this is the DC current from the generator. Positive for out. Negative for in. NaN: field not provided
power_generated float W invalid:NaN The power being generated. NaN: field not provided
bus_voltage float V Voltage of the bus seen at the generator, or battery bus if battery bus is controlled by generator and at a different voltage to main bus.
rectifier_temperature int16_t degC invalid:INT16_MAX The temperature of the rectifier or power converter. INT16_MAX: field not provided.
bat_current_setpoint float A invalid:NaN The target battery current. Positive for out. Negative for in. NaN: field not provided
generator_temperature int16_t degC invalid:INT16_MAX The temperature of the mechanical motor, fuel cell core or generator. INT16_MAX: field not provided.
runtime uint32_t s invalid:UINT32_MAX Seconds this generator has run since it was rebooted. UINT32_MAX: field not provided.
time_until_maintenance int32_t s invalid:INT32_MAX Seconds until this generator requires maintenance. A negative value indicates maintenance is past-due. INT32_MAX: field not provided.

ACTUATOR_OUTPUT_STATUS (375)

The raw values of the actuator outputs (e.g. on Pixhawk, from MAIN, AUX ports). This message supersedes SERVO_OUTPUT_RAW.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (since system boot).
active uint32_t Active outputs
actuator float[32] Servo / motor output array values. Zero values indicate unused channels.

RELAY_STATUS (376)

Reports the on/off state of relays, as controlled by MAV_CMD_DO_SET_RELAY.

Message streaming should be requested using MAV_CMD_SET_MESSAGE_INTERVAL. Note that it should not be sent on every relay state change to avoid flooding the link.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
on uint16_t Relay states. Relay instance numbers are represented as individual bits in this mask by offset.
present uint16_t Relay present. Relay instance numbers are represented as individual bits in this mask by offset. Bits will be true if a relay instance is configured.

TIME_ESTIMATE_TO_TARGET (380) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Time/duration estimates for various events and actions given the current vehicle state and position.

Field Name Type Units 描述
safe_return int32_t s Estimated time to complete the vehicle's configured "safe return" action from its current position (e.g. RTL, Smart RTL, etc.). -1 indicates that the vehicle is landed, or that no time estimate available.
land int32_t s Estimated time for vehicle to complete the LAND action from its current position. -1 indicates that the vehicle is landed, or that no time estimate available.
mission_next_item int32_t s Estimated time for reaching/completing the currently active mission item. -1 means no time estimate available.
mission_end int32_t s Estimated time for completing the current mission. -1 means no mission active and/or no estimate available.
commanded_action int32_t s Estimated time for completing the current commanded action (i.e. Go To, Takeoff, Land, etc.). -1 means no action active and/or no estimate available.

TUNNEL (385)

Message for transporting "arbitrary" variable-length data from one component to another (broadcast is not forbidden, but discouraged). The encoding of the data is usually extension specific, i.e. determined by the source, and is usually not documented as part of the MAVLink specification.

Field Name Type 描述
target_system uint8_t System ID (can be 0 for broadcast, but this is discouraged)
target_component uint8_t Component ID (can be 0 for broadcast, but this is discouraged)
payload_type uint16_t MAV_TUNNEL_PAYLOAD_TYPE A code that identifies the content of the payload (0 for unknown, which is the default). If this code is less than 32768, it is a 'registered' payload type and the corresponding code should be added to the MAV_TUNNEL_PAYLOAD_TYPE enum. Software creators can register blocks of types as needed. Codes greater than 32767 are considered local experiments and should not be checked in to any widely distributed codebase.
payload_length uint8_t Length of the data transported in payload
payload uint8_t[128] Variable length payload. The payload length is defined by payload_length. The entire content of this block is opaque unless you understand the encoding specified by payload_type.

CAN_FRAME (386)

A forwarded CAN frame as requested by MAV_CMD_CAN_FORWARD.

Field Name Type 描述
target_system uint8_t System ID.
target_component uint8_t Component ID.
bus uint8_t Bus number
len uint8_t Frame length
id uint32_t Frame ID
data uint8_t[8] Frame data

CANFD_FRAME (387)

A forwarded CANFD frame as requested by MAV_CMD_CAN_FORWARD. These are separated from CAN_FRAME as they need different handling (eg. TAO handling)

Field Name Type 描述
target_system uint8_t System ID.
target_component uint8_t Component ID.
bus uint8_t bus number
len uint8_t Frame length
id uint32_t Frame ID
data uint8_t[64] Frame data

CAN_FILTER_MODIFY (388)

Modify the filter of what CAN messages to forward over the mavlink. This can be used to make CAN forwarding work well on low bandwidth links. The filtering is applied on bits 8 to 24 of the CAN id (2nd and 3rd bytes) which corresponds to the DroneCAN message ID for DroneCAN. Filters with more than 16 IDs can be constructed by sending multiple CAN_FILTER_MODIFY messages.

Field Name Type 描述
target_system uint8_t System ID.
target_component uint8_t Component ID.
bus uint8_t bus number
operation uint8_t CAN_FILTER_OP what operation to perform on the filter list. See CAN_FILTER_OP enum.
num_ids uint8_t number of IDs in filter list
ids uint16_t[16] filter IDs, length num_ids

ONBOARD_COMPUTER_STATUS (390)

Hardware status sent by an onboard computer.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (UNIX Epoch time or time since system boot). The receiving end can infer timestamp format (since 1.1.1970 or since system boot) by checking for the magnitude of the number.
uptime uint32_t ms Time since system boot.
type uint8_t Type of the onboard computer: 0: Mission computer primary, 1: Mission computer backup 1, 2: Mission computer backup 2, 3: Compute node, 4-5: Compute spares, 6-9: Payload computers.
cpu_cores uint8_t[8] invalid:[UINT8_MAX] CPU usage on the component in percent (100 - idle). A value of UINT8_MAX implies the field is unused.
cpu_combined uint8_t[10] invalid:[UINT8_MAX] Combined CPU usage as the last 10 slices of 100 MS (a histogram). This allows to identify spikes in load that max out the system, but only for a short amount of time. A value of UINT8_MAX implies the field is unused.
gpu_cores uint8_t[4] invalid:[UINT8_MAX] GPU usage on the component in percent (100 - idle). A value of UINT8_MAX implies the field is unused.
gpu_combined uint8_t[10] invalid:[UINT8_MAX] Combined GPU usage as the last 10 slices of 100 MS (a histogram). This allows to identify spikes in load that max out the system, but only for a short amount of time. A value of UINT8_MAX implies the field is unused.
temperature_board int8_t degC invalid:INT8_MAX Temperature of the board. A value of INT8_MAX implies the field is unused.
temperature_core int8_t[8] degC invalid:[INT8_MAX] Temperature of the CPU core. A value of INT8_MAX implies the field is unused.
fan_speed int16_t[4] rpm invalid:[INT16_MAX] Fan speeds. A value of INT16_MAX implies the field is unused.
ram_usage uint32_t MiB invalid:UINT32_MAX Amount of used RAM on the component system. A value of UINT32_MAX implies the field is unused.
ram_total uint32_t MiB invalid:UINT32_MAX Total amount of RAM on the component system. A value of UINT32_MAX implies the field is unused.
storage_type uint32_t[4] invalid:[UINT32_MAX] Storage type: 0: HDD, 1: SSD, 2: EMMC, 3: SD card (non-removable), 4: SD card (removable). A value of UINT32_MAX implies the field is unused.
storage_usage uint32_t[4] MiB invalid:[UINT32_MAX] Amount of used storage space on the component system. A value of UINT32_MAX implies the field is unused.
storage_total uint32_t[4] MiB invalid:[UINT32_MAX] Total amount of storage space on the component system. A value of UINT32_MAX implies the field is unused.
link_type uint32_t[6] Link type: 0-9: UART, 10-19: Wired network, 20-29: Wifi, 30-39: Point-to-point proprietary, 40-49: Mesh proprietary
link_tx_rate uint32_t[6] KiB/s invalid:[UINT32_MAX] Network traffic from the component system. A value of UINT32_MAX implies the field is unused.
link_rx_rate uint32_t[6] KiB/s invalid:[UINT32_MAX] Network traffic to the component system. A value of UINT32_MAX implies the field is unused.
link_tx_max uint32_t[6] KiB/s invalid:[UINT32_MAX] Network capacity from the component system. A value of UINT32_MAX implies the field is unused.
link_rx_max uint32_t[6] KiB/s invalid:[UINT32_MAX] Network capacity to the component system. A value of UINT32_MAX implies the field is unused.
status_flags ++ uint16_t COMPUTER_STATUS_FLAGS Bitmap of status flags.

COMPONENT_INFORMATION (395) — [DEP]

DEPRECATED: Replaced By COMPONENT_METADATA (2022-04)

Component information message, which may be requested using MAV_CMD_REQUEST_MESSAGE.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
general_metadata_file_crc uint32_t CRC32 of the general metadata file (general_metadata_uri).
general_metadata_uri char[100] MAVLink FTP URI for the general metadata file (COMP_METADATA_TYPE_GENERAL), which may be compressed with xz. The file contains general component metadata, and may contain URI links for additional metadata (see COMP_METADATA_TYPE). The information is static from boot, and may be generated at compile time. The string needs to be zero terminated.
peripherals_metadata_file_crc uint32_t CRC32 of peripherals metadata file (peripherals_metadata_uri).
peripherals_metadata_uri char[100] (Optional) MAVLink FTP URI for the peripherals metadata file (COMP_METADATA_TYPE_PERIPHERALS), which may be compressed with xz. This contains data about "attached components" such as UAVCAN nodes. The peripherals are in a separate file because the information must be generated dynamically at runtime. The string needs to be zero terminated.

COMPONENT_INFORMATION_BASIC (396)

Basic component information data. Should be requested using MAV_CMD_REQUEST_MESSAGE on startup, or when required.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
capabilities uint64_t MAV_PROTOCOL_CAPABILITY Component capability flags
time_manufacture_s uint32_t s invalid:0 Date of manufacture as a UNIX Epoch time (since 1.1.1970) in seconds.
vendor_name charr[32] Name of the component vendor. Needs to be zero terminated. The field is optional and can be empty/all zeros.
model_name charr[32] Name of the component model. Needs to be zero terminated. The field is optional and can be empty/all zeros.
software_version char[24] Software version. The recommended format is SEMVER: 'major.minor.patch' (any format may be used). The field must be zero terminated if it has a value. The field is optional and can be empty/all zeros.
hardware_version char[24] Hardware version. The recommended format is SEMVER: 'major.minor.patch' (any format may be used). The field must be zero terminated if it has a value. The field is optional and can be empty/all zeros.
serial_number charr[32] Hardware serial number. The field must be zero terminated if it has a value. The field is optional and can be empty/all zeros.

COMPONENT_METADATA (397)

Component metadata message, which may be requested using MAV_CMD_REQUEST_MESSAGE.

This contains the MAVLink FTP URI and CRC for the component's general metadata file. The file must be hosted on the component, and may be xz compressed. The file CRC can be used for file caching.

The general metadata file can be read to get the locations of other metadata files (COMP_METADATA_TYPE) and translations, which may be hosted either on the vehicle or the internet. For more information see: https://mavlink.io/en/services/component_information.html.

Note: Camera components should use CAMERA_INFORMATION instead, and autopilots may use both this message and AUTOPILOT_VERSION.

Field Name Type Units 描述
time_boot_ms uint32_t ms Timestamp (time since system boot).
file_crc uint32_t CRC32 of the general metadata file.
uri char[100] MAVLink FTP URI for the general metadata file (COMP_METADATA_TYPE_GENERAL), which may be compressed with xz. The file contains general component metadata, and may contain URI links for additional metadata (see COMP_METADATA_TYPE). The information is static from boot, and may be generated at compile time. The string needs to be zero terminated.

PLAY_TUNE_V2 (400)

Play vehicle tone/tune (buzzer). Supported tunes can be determined using SUPPORTED_TUNES. Supersedes message PLAY_TUNE.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
format uint32_t TUNE_FORMAT Tune format
tune char[248] Tune definition as a NULL-terminated string.

SUPPORTED_TUNES (401)

Tune formats supported by vehicle, i.e. via PLAY_TUNE_V2. This should be emitted as response to MAV_CMD_REQUEST_MESSAGE.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
format uint32_t TUNE_FORMAT Bitfield of supported tune formats.

EVENT (410) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Event message. Each new event from a particular component gets a new sequence number. The same message might be sent multiple times if (re-)requested. Most events are broadcast, some can be specific to a target component (as receivers keep track of the sequence for missed events, all events need to be broadcast. Thus we use destination_component instead of target_component).

Field Name Type Units 描述
destination_component uint8_t Component ID
destination_system uint8_t System ID
id uint32_t Event ID (as defined in the component metadata)
event_time_boot_ms uint32_t ms Timestamp (time since system boot when the event happened).
sequence uint16_t Sequence number.
log_levels uint8_t Log levels: 4 bits MSB: internal (for logging purposes), 4 bits LSB: external. Levels: Emergency = 0, Alert = 1, Critical = 2, Error = 3, Warning = 4, Notice = 5, Info = 6, Debug = 7, Protocol = 8, Disabled = 9
arguments uint8_t[40] Arguments (depend on event ID).

CURRENT_EVENT_SEQUENCE (411) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Regular broadcast for the current latest event sequence number for a component. This is used to check for dropped events.

Field Name Type 描述
sequence uint16_t Sequence number.
flags uint8_t MAV_EVENT_CURRENT_SEQUENCE_FLAGS Flag bitset.

REQUEST_EVENT (412) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Request one or more events to be (re-)sent. If first_sequence==last_sequence, only a single event is requested. Note that first_sequence can be larger than last_sequence (because the sequence number can wrap). Each sequence will trigger an EVENT or EVENT_ERROR response.

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
first_sequence uint16_t First sequence number of the requested event.
last_sequence uint16_t Last sequence number of the requested event.

RESPONSE_EVENT_ERROR (413) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Response to a REQUEST_EVENT in case of an error (e.g. the event is not available anymore).

Field Name Type 描述
target_system uint8_t System ID
target_component uint8_t Component ID
sequence uint16_t Sequence number.
sequence_oldest_available uint16_t Oldest Sequence number that is still available after the sequence set in REQUEST_EVENT.
reason uint8_t MAV_EVENT_ERROR_REASON Error reason.

AVAILABLE_MODES (435)

Information about a flight mode.

The message can be enumerated to get information for all modes, or requested for a particular mode, using MAV_CMD_REQUEST_MESSAGE. Specify 0 in param2 to request that the message is emitted for all available modes or the specific index for just one mode. The modes must be available/settable for the current vehicle/frame type. Each mode should only be emitted once (even if it is both standard and custom). Note that the current mode should be emitted in CURRENT_MODE, and that if the mode list can change then AVAILABLE_MODES_MONITOR must be emitted on first change and subsequently streamed. See https://mavlink.io/en/services/standard_modes.html

Field Name Type 描述
number_modes uint8_t The total number of available modes for the current vehicle type.
mode_index uint8_t The current mode index within number_modes, indexed from 1. The index is not guaranteed to be persistent, and may change between reboots or if the set of modes change.
standard_mode uint8_t MAV_STANDARD_MODE Standard mode.
custom_mode uint32_t A bitfield for use for autopilot-specific flags
properties uint32_t MAV_MODE_PROPERTY Mode properties.
mode_name char[35] Name of custom mode, with null termination character. Should be omitted for standard modes.

CURRENT_MODE (436)

Get the current mode.

This should be emitted on any mode change, and broadcast at low rate (nominally 0.5 Hz). It may be requested using MAV_CMD_REQUEST_MESSAGE. See https://mavlink.io/en/services/standard_modes.html

Field Name Type 描述
standard_mode uint8_t MAV_STANDARD_MODE Standard mode.
custom_mode uint32_t A bitfield for use for autopilot-specific flags
intended_custom_mode uint32_t invalid:0 The custom_mode of the mode that was last commanded by the user (for example, with MAV_CMD_DO_SET_STANDARD_MODE, MAV_CMD_DO_SET_MODE or via RC). This should usually be the same as custom_mode. It will be different if the vehicle is unable to enter the intended mode, or has left that mode due to a failsafe condition. 0 indicates the intended custom mode is unknown/not supplied

AVAILABLE_MODES_MONITOR (437)

A change to the sequence number indicates that the set of AVAILABLE_MODES has changed, and that the receiver should re-request all available modes.

The message is optional, and is only needed when the set of modes can change dynamically after boot. It should be emitted whenever the set of modes change. It should be streamed at low rate (nominally 0.3 Hz). See https://mavlink.io/en/services/standard_modes.html

Field Name Type 描述
seq uint8_t Sequence number. The value iterates sequentially whenever AVAILABLE_MODES changes (e.g. support for a new mode is added/removed dynamically).

ILLUMINATOR_STATUS (440)

Illuminator status

Field Name Type Units 描述
uptime_ms uint32_t ms Time since the start-up of the illuminator in ms
enable uint8_t 0: Illuminators OFF, 1: Illuminators ON
mode_bitmask uint8_t ILLUMINATOR_MODE Supported illuminator modes
error_status uint32_t ILLUMINATOR_ERROR_FLAGS Errors
模式 uint8_t ILLUMINATOR_MODE Illuminator mode
brightness float % Illuminator brightness
strobe_period float s Illuminator strobing period in seconds
strobe_duty_cycle float % Illuminator strobing duty cycle
temp_c float Temperature in Celsius
min_strobe_period float s Minimum strobing period in seconds
max_strobe_period float s Maximum strobing period in seconds

WHEEL_DISTANCE (9000)

Cumulative distance traveled for each reported wheel.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (synced to UNIX time or since system boot).
count uint8_t Number of wheels reported.
distance double[16] m Distance reported by individual wheel encoders. Forward rotations increase values, reverse rotations decrease them. Not all wheels will necessarily have wheel encoders; the mapping of encoders to wheel positions must be agreed/understood by the endpoints.

WINCH_STATUS (9005)

Winch status.

Field Name Type Units 描述
time_usec uint64_t us Timestamp (synced to UNIX time or since system boot).
line_length float m invalid:NaN Length of line released. NaN if unknown
speed float m/s invalid:NaN Speed line is being released or retracted. Positive values if being released, negative values if being retracted, NaN if unknown
tension float kg invalid:NaN Tension on the line. NaN if unknown
voltage float V invalid:NaN Voltage of the battery supplying the winch. NaN if unknown
current float A invalid:NaN Current draw from the winch. NaN if unknown
temperature int16_t degC invalid:INT16_MAX Temperature of the motor. INT16_MAX if unknown
status uint32_t MAV_WINCH_STATUS_FLAG Status flags

OPEN_DRONE_ID_BASIC_ID (12900)

Data for filling the OpenDroneID Basic ID message. This and the below messages are primarily meant for feeding data to/from an OpenDroneID implementation. E.g. https://github.com/opendroneid/opendroneid-core-c. These messages are compatible with the ASTM F3411 Remote ID standard and the ASD-STAN prEN 4709-002 Direct Remote ID standard. Additional information and usage of these messages is documented at https://mavlink.io/en/services/opendroneid.html.

Field Name Type 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
id_or_mac uint8_t[20] Only used for drone ID data received from other UAs. See detailed description at https://mavlink.io/en/services/opendroneid.html.
id_type uint8_t MAV_ODID_ID_TYPE Indicates the format for the uas_id field of this message.
ua_type uint8_t MAV_ODID_UA_TYPE Indicates the type of UA (Unmanned Aircraft).
uas_id uint8_t[20] UAS (Unmanned Aircraft System) ID following the format specified by id_type. Shall be filled with nulls in the unused portion of the field.

OPEN_DRONE_ID_LOCATION (12901)

Data for filling the OpenDroneID Location message. The float data types are 32-bit IEEE 754. The Location message provides the location, altitude, direction and speed of the aircraft.

Field Name Type Units 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
id_or_mac uint8_t[20] Only used for drone ID data received from other UAs. See detailed description at https://mavlink.io/en/services/opendroneid.html.
status uint8_t MAV_ODID_STATUS Indicates whether the unmanned aircraft is on the ground or in the air.
direction uint16_t cdeg invalid:36100 Direction over ground (not heading, but direction of movement) measured clockwise from true North: 0 - 35999 centi-degrees. If unknown: 36100 centi-degrees.
speed_horizontal uint16_t 厘米/秒 Ground speed. Positive only. If unknown: 25500 cm/s. If speed is larger than 25425 cm/s, use 25425 cm/s.
speed_vertical int16_t 厘米/秒 The vertical speed. Up is positive. If unknown: 6300 cm/s. If speed is larger than 6200 cm/s, use 6200 cm/s. If lower than -6200 cm/s, use -6200 cm/s.
latitude int32_t degE7 invalid:0 Current latitude of the unmanned aircraft. If unknown: 0 (both Lat/Lon).
longitude int32_t degE7 invalid:0 Current longitude of the unmanned aircraft. If unknown: 0 (both Lat/Lon).
altitude_barometric float m invalid:-1000 The altitude calculated from the barometric pressure. Reference is against 29.92inHg or 1013.2mb. If unknown: -1000 m.
altitude_geodetic float m invalid:-1000 The geodetic altitude as defined by WGS84. If unknown: -1000 m.
height_reference uint8_t MAV_ODID_HEIGHT_REF Indicates the reference point for the height field.
height float m invalid:-1000 The current height of the unmanned aircraft above the take-off location or the ground as indicated by height_reference. If unknown: -1000 m.
horizontal_accuracy uint8_t MAV_ODID_HOR_ACC The accuracy of the horizontal position.
vertical_accuracy uint8_t MAV_ODID_VER_ACC The accuracy of the vertical position.
barometer_accuracy uint8_t MAV_ODID_VER_ACC The accuracy of the barometric altitude.
speed_accuracy uint8_t MAV_ODID_SPEED_ACC The accuracy of the horizontal and vertical speed.
timestamp float s invalid:0xFFFF Seconds after the full hour with reference to UTC time. Typically the GPS outputs a time-of-week value in milliseconds. First convert that to UTC and then convert for this field using ((float) (time_week_ms % (60_60_1000))) / 1000. If unknown: 0xFFFF.
timestamp_accuracy uint8_t MAV_ODID_TIME_ACC The accuracy of the timestamps.

OPEN_DRONE_ID_AUTHENTICATION (12902)

Data for filling the OpenDroneID Authentication message. The Authentication Message defines a field that can provide a means of authenticity for the identity of the UAS (Unmanned Aircraft System). The Authentication message can have two different formats. For data page 0, the fields PageCount, Length and TimeStamp are present and AuthData is only 17 bytes. For data page 1 through 15, PageCount, Length and TimeStamp are not present and the size of AuthData is 23 bytes.

Field Name Type Units 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
id_or_mac uint8_t[20] Only used for drone ID data received from other UAs. See detailed description at https://mavlink.io/en/services/opendroneid.html.
authentication_type uint8_t MAV_ODID_AUTH_TYPE Indicates the type of authentication.
data_page uint8_t Allowed range is 0 - 15.
last_page_index uint8_t This field is only present for page 0. Allowed range is 0 - 15. See the description of struct ODID_Auth_data at https://github.com/opendroneid/opendroneid-core-c/blob/master/libopendroneid/opendroneid.h.
length uint8_t bytes This field is only present for page 0. Total bytes of authentication_data from all data pages. See the description of struct ODID_Auth_data at https://github.com/opendroneid/opendroneid-core-c/blob/master/libopendroneid/opendroneid.h.
timestamp uint32_t s This field is only present for page 0. 32 bit Unix Timestamp in seconds since 00:00:00 01/01/2019.
authentication_data uint8_t[23] Opaque authentication data. For page 0, the size is only 17 bytes. For other pages, the size is 23 bytes. Shall be filled with nulls in the unused portion of the field.

OPEN_DRONE_ID_SELF_ID (12903)

Data for filling the OpenDroneID Self ID message. The Self ID Message is an opportunity for the operator to (optionally) declare their identity and purpose of the flight. This message can provide additional information that could reduce the threat profile of a UA (Unmanned Aircraft) flying in a particular area or manner. This message can also be used to provide optional additional clarification in an emergency/remote ID system failure situation.

Field Name Type 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
id_or_mac uint8_t[20] Only used for drone ID data received from other UAs. See detailed description at https://mavlink.io/en/services/opendroneid.html.
description_type uint8_t MAV_ODID_DESC_TYPE Indicates the type of the description field.
description char[23] Text description or numeric value expressed as ASCII characters. Shall be filled with nulls in the unused portion of the field.

OPEN_DRONE_ID_SYSTEM (12904)

Data for filling the OpenDroneID System message. The System Message contains general system information including the operator location/altitude and possible aircraft group and/or category/class information.

Field Name Type Units 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
id_or_mac uint8_t[20] Only used for drone ID data received from other UAs. See detailed description at https://mavlink.io/en/services/opendroneid.html.
operator_location_type uint8_t MAV_ODID_OPERATOR_LOCATION_TYPE Specifies the operator location type.
classification_type uint8_t MAV_ODID_CLASSIFICATION_TYPE Specifies the classification type of the UA.
operator_latitude int32_t degE7 invalid:0 Latitude of the operator. If unknown: 0 (both Lat/Lon).
operator_longitude int32_t degE7 invalid:0 Longitude of the operator. If unknown: 0 (both Lat/Lon).
area_count uint16_t Number of aircraft in the area, group or formation (default 1). Used only for swarms/multiple UA.
area_radius uint16_t m Radius of the cylindrical area of the group or formation (default 0). Used only for swarms/multiple UA.
area_ceiling float m invalid:-1000 Area Operations Ceiling relative to WGS84. If unknown: -1000 m. Used only for swarms/multiple UA.
area_floor float m invalid:-1000 Area Operations Floor relative to WGS84. If unknown: -1000 m. Used only for swarms/multiple UA.
category_eu uint8_t MAV_ODID_CATEGORY_EU When classification_type is MAV_ODID_CLASSIFICATION_TYPE_EU, specifies the category of the UA.
class_eu uint8_t MAV_ODID_CLASS_EU When classification_type is MAV_ODID_CLASSIFICATION_TYPE_EU, specifies the class of the UA.
operator_altitude_geo float m invalid:-1000 Geodetic altitude of the operator relative to WGS84. If unknown: -1000 m.
timestamp uint32_t s 32 bit Unix Timestamp in seconds since 00:00:00 01/01/2019.

OPEN_DRONE_ID_OPERATOR_ID (12905)

Data for filling the OpenDroneID Operator ID message, which contains the CAA (Civil Aviation Authority) issued operator ID.

Field Name Type 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
id_or_mac uint8_t[20] Only used for drone ID data received from other UAs. See detailed description at https://mavlink.io/en/services/opendroneid.html.
operator_id_type uint8_t MAV_ODID_OPERATOR_ID_TYPE Indicates the type of the operator_id field.
operator_id char[20] Text description or numeric value expressed as ASCII characters. Shall be filled with nulls in the unused portion of the field.

OPEN_DRONE_ID_MESSAGE_PACK (12915)

An OpenDroneID message pack is a container for multiple encoded OpenDroneID messages (i.e. not in the format given for the above message descriptions but after encoding into the compressed OpenDroneID byte format). Used e.g. when transmitting on Bluetooth 5.0 Long Range/Extended Advertising or on WiFi Neighbor Aware Networking or on WiFi Beacon.

Field Name Type Units 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
id_or_mac uint8_t[20] Only used for drone ID data received from other UAs. See detailed description at https://mavlink.io/en/services/opendroneid.html.
single_message_size uint8_t bytes This field must currently always be equal to 25 (bytes), since all encoded OpenDroneID messages are specified to have this length.
msg_pack_size uint8_t Number of encoded messages in the pack (not the number of bytes). Allowed range is 1 - 9.
messages uint8_t[225] Concatenation of encoded OpenDroneID messages. Shall be filled with nulls in the unused portion of the field.

OPEN_DRONE_ID_ARM_STATUS (12918)

Transmitter (remote ID system) is enabled and ready to start sending location and other required information. This is streamed by transmitter. A flight controller uses it as a condition to arm.

Field Name Type 描述
status uint8_t MAV_ODID_ARM_STATUS Status level indicating if arming is allowed.
error char[50] Text error message, should be empty if status is good to arm. Fill with nulls in unused portion.

OPEN_DRONE_ID_SYSTEM_UPDATE (12919)

Update the data in the OPEN_DRONE_ID_SYSTEM message with new location information. This can be sent to update the location information for the operator when no other information in the SYSTEM message has changed. This message allows for efficient operation on radio links which have limited uplink bandwidth while meeting requirements for update frequency of the operator location.

Field Name Type Units 描述
target_system uint8_t System ID (0 for broadcast).
target_component uint8_t Component ID (0 for broadcast).
operator_latitude int32_t degE7 Latitude of the operator. If unknown: 0 (both Lat/Lon).
operator_longitude int32_t degE7 Longitude of the operator. If unknown: 0 (both Lat/Lon).
operator_altitude_geo float m Geodetic altitude of the operator relative to WGS84. If unknown: -1000 m.
timestamp uint32_t s 32 bit Unix Timestamp in seconds since 00:00:00 01/01/2019.

HYGROMETER_SENSOR (12920)

Temperature and humidity from hygrometer.

Field Name Type Units 描述
id uint8_t Hygrometer ID
[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component.
temperature int16_t cdegC Temperature
humidity uint16_t c% Humidity

Enumerated Types

HL_FAILURE_FLAG

(Bitmask) Flags to report failure cases over the high latency telemetry.

Name 描述
1 HL_FAILURE_FLAG_GPS GPS failure.
2 HL_FAILURE_FLAG_DIFFERENTIAL_PRESSURE Differential pressure sensor failure.
4 HL_FAILURE_FLAG_ABSOLUTE_PRESSURE Absolute pressure sensor failure.
8 HL_FAILURE_FLAG_3D_ACCEL Accelerometer sensor failure.
16 HL_FAILURE_FLAG_3D_GYRO Gyroscope sensor failure.
32 HL_FAILURE_FLAG_3D_MAG Magnetometer sensor failure.
64 HL_FAILURE_FLAG_TERRAIN Terrain subsystem failure.
128 HL_FAILURE_FLAG_BATTERY Battery failure/critical low battery.
256 HL_FAILURE_FLAG_RC_RECEIVER RC receiver failure/no RC connection.
512 HL_FAILURE_FLAG_OFFBOARD_LINK Offboard link failure.
1024 HL_FAILURE_FLAG_ENGINE Engine failure.
2048 HL_FAILURE_FLAG_GEOFENCE Geofence violation.
4096 HL_FAILURE_FLAG_ESTIMATOR Estimator failure, for example measurement rejection or large variances.
8192 HL_FAILURE_FLAG_MISSION Mission failure.

MAV_GOTO

Actions that may be specified in MAV_CMD_OVERRIDE_GOTO to override mission execution.

Name 描述
0 MAV_GOTO_DO_HOLD Hold at the current position.
1 MAV_GOTO_DO_CONTINUE Continue with the next item in mission execution.
2 MAV_GOTO_HOLD_AT_CURRENT_POSITION Hold at the current position of the system
3 MAV_GOTO_HOLD_AT_SPECIFIED_POSITION Hold at the position specified in the parameters of the DO_HOLD action

MAV_MODE — [DEP]

DEPRECATED: Replaced By MAV_MODE_FLAG (2025-02) — Using MAV_MODE to set modes is less predictable than using standard modes (MAV_STANDARD_MODE) or custom modes (MAV_MODE_FLAG_CUSTOM_MODE_ENABLED).)

Predefined OR-combined MAV_MODE_FLAG values. These can simplify using the flags when setting modes. Note that manual input is enabled in all modes as a safety override.

Name 描述
0 MAV_MODE_PREFLIGHT System is not ready to fly, booting, calibrating, etc. No flag is set.
64 MAV_MODE_MANUAL_DISARMED System is allowed to be active, under manual (RC) control, no stabilization (MAV_MODE_FLAG_MANUAL_INPUT_ENABLED)
66 MAV_MODE_TEST_DISARMED UNDEFINED mode. This solely depends on the autopilot - use with caution, intended for developers only. (MAV_MODE_FLAG_MANUAL_INPUT_ENABLED, MAV_MODE_FLAG_TEST_ENABLED).
80 MAV_MODE_STABILIZE_DISARMED System is allowed to be active, under assisted RC control (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_STABILIZE_ENABLED)
88 MAV_MODE_GUIDED_DISARMED System is allowed to be active, under autonomous control, manual setpoint (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_STABILIZE_ENABLED, MAV_MODE_FLAG_GUIDED_ENABLED)
92 MAV_MODE_AUTO_DISARMED System is allowed to be active, under autonomous control and navigation (the trajectory is decided onboard and not pre-programmed by waypoints). (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_STABILIZE_ENABLED, MAV_MODE_FLAG_GUIDED_ENABLED, MAV_MODE_FLAG_AUTO_ENABLED).
192 MAV_MODE_MANUAL_ARMED System is allowed to be active, under manual (RC) control, no stabilization (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_MANUAL_INPUT_ENABLED)
194 MAV_MODE_TEST_ARMED UNDEFINED mode. This solely depends on the autopilot - use with caution, intended for developers only (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_MANUAL_INPUT_ENABLED, MAV_MODE_FLAG_TEST_ENABLED)
208 MAV_MODE_STABILIZE_ARMED System is allowed to be active, under assisted RC control (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_MANUAL_INPUT_ENABLED, MAV_MODE_FLAG_STABILIZE_ENABLED)
216 MAV_MODE_GUIDED_ARMED System is allowed to be active, under autonomous control, manual setpoint (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_MANUAL_INPUT_ENABLED, MAV_MODE_FLAG_STABILIZE_ENABLED, MAV_MODE_FLAG_GUIDED_ENABLED)
220 MAV_MODE_AUTO_ARMED System is allowed to be active, under autonomous control and navigation (the trajectory is decided onboard and not pre-programmed by waypoints). (MAV_MODE_FLAG_SAFETY_ARMED, MAV_MODE_FLAG_MANUAL_INPUT_ENABLED, MAV_MODE_FLAG_STABILIZE_ENABLED, MAV_MODE_FLAG_GUIDED_ENABLED,MAV_MODE_FLAG_AUTO_ENABLED).

MAV_SYS_STATUS_SENSOR

(Bitmask) These encode the sensors whose status is sent as part of the SYS_STATUS message.

Name 描述
1 MAV_SYS_STATUS_SENSOR_3D_GYRO 0x01 3D gyro
2 MAV_SYS_STATUS_SENSOR_3D_ACCEL 0x02 3D accelerometer
4 MAV_SYS_STATUS_SENSOR_3D_MAG 0x04 3D magnetometer
8 MAV_SYS_STATUS_SENSOR_ABSOLUTE_PRESSURE 0x08 absolute pressure
16 MAV_SYS_STATUS_SENSOR_DIFFERENTIAL_PRESSURE 0x10 differential pressure
32 MAV_SYS_STATUS_SENSOR_GPS 0x20 GPS
64 MAV_SYS_STATUS_SENSOR_OPTICAL_FLOW 0x40 optical flow
128 MAV_SYS_STATUS_SENSOR_VISION_POSITION 0x80 computer vision position
256 MAV_SYS_STATUS_SENSOR_LASER_POSITION 0x100 laser based position
512 MAV_SYS_STATUS_SENSOR_EXTERNAL_GROUND_TRUTH 0x200 external ground truth (Vicon or Leica)
1024 MAV_SYS_STATUS_SENSOR_ANGULAR_RATE_CONTROL 0x400 3D angular rate control
2048 MAV_SYS_STATUS_SENSOR_ATTITUDE_STABILIZATION 0x800 attitude stabilization
4096 MAV_SYS_STATUS_SENSOR_YAW_POSITION 0x1000 yaw position
8192 MAV_SYS_STATUS_SENSOR_Z_ALTITUDE_CONTROL 0x2000 z/altitude control
16384 MAV_SYS_STATUS_SENSOR_XY_POSITION_CONTROL 0x4000 x/y position control
32768 MAV_SYS_STATUS_SENSOR_MOTOR_OUTPUTS 0x8000 motor outputs / control
65536 MAV_SYS_STATUS_SENSOR_RC_RECEIVER 0x10000 RC receiver
131072 MAV_SYS_STATUS_SENSOR_3D_GYRO2 0x20000 2nd 3D gyro
262144 MAV_SYS_STATUS_SENSOR_3D_ACCEL2 0x40000 2nd 3D accelerometer
524288 MAV_SYS_STATUS_SENSOR_3D_MAG2 0x80000 2nd 3D magnetometer
1048576 MAV_SYS_STATUS_GEOFENCE 0x100000 geofence
2097152 MAV_SYS_STATUS_AHRS 0x200000 AHRS subsystem health
4194304 MAV_SYS_STATUS_TERRAIN 0x400000 Terrain subsystem health
8388608 MAV_SYS_STATUS_REVERSE_MOTOR 0x800000 Motors are reversed
16777216 MAV_SYS_STATUS_LOGGING 0x1000000 Logging
33554432 MAV_SYS_STATUS_SENSOR_BATTERY 0x2000000 Battery
67108864 MAV_SYS_STATUS_SENSOR_PROXIMITY 0x4000000 Proximity
134217728 MAV_SYS_STATUS_SENSOR_SATCOM 0x8000000 Satellite Communication
268435456 MAV_SYS_STATUS_PREARM_CHECK 0x10000000 pre-arm check status. Always healthy when armed
536870912 MAV_SYS_STATUS_OBSTACLE_AVOIDANCE 0x20000000 Avoidance/collision prevention
1073741824 MAV_SYS_STATUS_SENSOR_PROPULSION 0x40000000 propulsion (actuator, esc, motor or propellor)
2147483648 MAV_SYS_STATUS_EXTENSION_USED 0x80000000 Extended bit-field are used for further sensor status bits (needs to be set in onboard_control_sensors_present only)

MAV_SYS_STATUS_SENSOR_EXTENDED

(Bitmask) These encode the sensors whose status is sent as part of the SYS_STATUS message in the extended fields.

Name 描述
1 MAV_SYS_STATUS_RECOVERY_SYSTEM 0x01 Recovery system (parachute, balloon, retracts etc)
2 MAV_SYS_STATUS_SENSOR_LEAK 0x02 Leak detection

MAV_FRAME

Coordinate frames used by MAVLink. Not all frames are supported by all commands, messages, or vehicles.

Global frames use the following naming conventions:

  • "GLOBAL": Global coordinate frame with WGS84 latitude/longitude and altitude positive over mean sea level (MSL) by default. The following modifiers may be used with "GLOBAL":
  • "RELATIVE_ALT": Altitude is relative to the vehicle home position rather than MSL.
  • "TERRAIN_ALT": Altitude is relative to ground level rather than MSL.
  • "INT": Latitude/longitude (in degrees) are scaled by multiplying by 1E7.

Local frames use the following naming conventions:

  • "LOCAL": Origin of local frame is fixed relative to earth. Unless otherwise specified this origin is the origin of the vehicle position-estimator ("EKF").
  • "BODY": Origin of local frame travels with the vehicle. NOTE, "BODY" does NOT indicate alignment of frame axis with vehicle attitude.
  • "OFFSET": Deprecated synonym for "BODY" (origin travels with the vehicle). Not to be used for new frames.

Some deprecated frames do not follow these conventions (e.g. MAV_FRAME_BODY_NED and MAV_FRAME_BODY_OFFSET_NED).

Name 描述
0 MAV_FRAME_GLOBAL Global (WGS84) coordinate frame + altitude relative to mean sea level (MSL).
1 MAV_FRAME_LOCAL_NED NED local tangent frame (x: North, y: East, z: Down) with origin fixed relative to earth.
2 MAV_FRAME_MISSION NOT a coordinate frame, indicates a mission command.
3 MAV_FRAME_GLOBAL_RELATIVE_ALT Global (WGS84) coordinate frame + altitude relative to the home position.
4 MAV_FRAME_LOCAL_ENU ENU local tangent frame (x: East, y: North, z: Up) with origin fixed relative to earth.
5 MAV_FRAME_GLOBAL_INT Global (WGS84) coordinate frame (scaled) + altitude relative to mean sea level (MSL).
SUPERSEDED: Replaced By MAV_FRAME_GLOBAL (2024-03) — Use MAV_FRAME_GLOBAL in COMMAND_INT (and elsewhere) as a synonymous replacement.)
6 MAV_FRAME_GLOBAL_RELATIVE_ALT_INT Global (WGS84) coordinate frame (scaled) + altitude relative to the home position.
SUPERSEDED: Replaced By MAV_FRAME_GLOBAL_RELATIVE_ALT (2024-03) — Use MAV_FRAME_GLOBAL_RELATIVE_ALT in COMMAND_INT (and elsewhere) as a synonymous replacement.)
7 MAV_FRAME_LOCAL_OFFSET_NED NED local tangent frame (x: North, y: East, z: Down) with origin that travels with the vehicle.
8 MAV_FRAME_BODY_NED Same as MAV_FRAME_LOCAL_NED when used to represent position values. Same as MAV_FRAME_BODY_FRD when used with velocity/acceleration values.
SUPERSEDED: Replaced By MAV_FRAME_BODY_FRD (2019-08)
9 MAV_FRAME_BODY_OFFSET_NED This is the same as MAV_FRAME_BODY_FRD.
SUPERSEDED: Replaced By MAV_FRAME_BODY_FRD (2019-08)
10 MAV_FRAME_GLOBAL_TERRAIN_ALT Global (WGS84) coordinate frame with AGL altitude (altitude at ground level).
11 MAV_FRAME_GLOBAL_TERRAIN_ALT_INT Global (WGS84) coordinate frame (scaled) with AGL altitude (altitude at ground level).
SUPERSEDED: Replaced By MAV_FRAME_GLOBAL_TERRAIN_ALT (2024-03) — Use MAV_FRAME_GLOBAL_TERRAIN_ALT in COMMAND_INT (and elsewhere) as a synonymous replacement.)
12 MAV_FRAME_BODY_FRD FRD local frame aligned to the vehicle's attitude (x: Forward, y: Right, z: Down) with an origin that travels with vehicle.
13 MAV_FRAME_RESERVED_13 MAV_FRAME_BODY_FLU - Body fixed frame of reference, Z-up (x: Forward, y: Left, z: Up).
DEPRECATED:(2019-04)
14 MAV_FRAME_RESERVED_14 MAV_FRAME_MOCAP_NED - Odometry local coordinate frame of data given by a motion capture system, Z-down (x: North, y: East, z: Down).
DEPRECATED: Replaced By MAV_FRAME_LOCAL_FRD (2019-04)
15 MAV_FRAME_RESERVED_15 MAV_FRAME_MOCAP_ENU - Odometry local coordinate frame of data given by a motion capture system, Z-up (x: East, y: North, z: Up).
DEPRECATED: Replaced By MAV_FRAME_LOCAL_FLU (2019-04)
16 MAV_FRAME_RESERVED_16 MAV_FRAME_VISION_NED - Odometry local coordinate frame of data given by a vision estimation system, Z-down (x: North, y: East, z: Down).
DEPRECATED: Replaced By MAV_FRAME_LOCAL_FRD (2019-04)
17 MAV_FRAME_RESERVED_17 MAV_FRAME_VISION_ENU - Odometry local coordinate frame of data given by a vision estimation system, Z-up (x: East, y: North, z: Up).
DEPRECATED: Replaced By MAV_FRAME_LOCAL_FLU (2019-04)
18 MAV_FRAME_RESERVED_18 MAV_FRAME_ESTIM_NED - Odometry local coordinate frame of data given by an estimator running onboard the vehicle, Z-down (x: North, y: East, z: Down).
DEPRECATED: Replaced By MAV_FRAME_LOCAL_FRD (2019-04)
19 MAV_FRAME_RESERVED_19 MAV_FRAME_ESTIM_ENU - Odometry local coordinate frame of data given by an estimator running onboard the vehicle, Z-up (x: East, y: North, z: Up).
DEPRECATED: Replaced By MAV_FRAME_LOCAL_FLU (2019-04)
20 MAV_FRAME_LOCAL_FRD FRD local tangent frame (x: Forward, y: Right, z: Down) with origin fixed relative to earth. The forward axis is aligned to the front of the vehicle in the horizontal plane.
21 MAV_FRAME_LOCAL_FLU FLU local tangent frame (x: Forward, y: Left, z: Up) with origin fixed relative to earth. The forward axis is aligned to the front of the vehicle in the horizontal plane.
Name 描述
0 MAVLINK_DATA_STREAM_IMG_JPEG
1 MAVLINK_DATA_STREAM_IMG_BMP
2 MAVLINK_DATA_STREAM_IMG_RAW8U
3 MAVLINK_DATA_STREAM_IMG_RAW32U
4 MAVLINK_DATA_STREAM_IMG_PGM
5 MAVLINK_DATA_STREAM_IMG_PNG

FENCE_BREACH

Name 描述
0 FENCE_BREACH_NONE No last fence breach
1 FENCE_BREACH_MINALT Breached minimum altitude
2 FENCE_BREACH_MAXALT Breached maximum altitude
3 FENCE_BREACH_BOUNDARY Breached fence boundary

FENCE_MITIGATE

Actions being taken to mitigate/prevent fence breach

Name 描述
0 FENCE_MITIGATE_UNKNOWN Unknown
1 FENCE_MITIGATE_NONE No actions being taken
2 FENCE_MITIGATE_VEL_LIMIT Velocity limiting active to prevent breach

FENCE_TYPE

(Bitmask) Fence types to enable or disable when using MAV_CMD_DO_FENCE_ENABLE.

Note that at least one of these flags must be set in MAV_CMD_DO_FENCE_ENABLE.param2. If none are set, the flight stack will ignore the field and enable/disable its default set of fences (usually all of them).

Name 描述
1 FENCE_TYPE_ALT_MAX Maximum altitude fence
2 FENCE_TYPE_CIRCLE Circle fence
4 FENCE_TYPE_POLYGON Polygon fence
8 FENCE_TYPE_ALT_MIN Minimum altitude fence

MAV_MOUNT_MODE — [DEP]

DEPRECATED: Replaced By GIMBAL_MANAGER_FLAGS (2020-01)

Enumeration of possible mount operation modes. This message is used by obsolete/deprecated gimbal messages.

Name 描述
0 MAV_MOUNT_MODE_RETRACT Load and keep safe position (Roll,Pitch,Yaw) from permanent memory and stop stabilization
1 MAV_MOUNT_MODE_NEUTRAL Load and keep neutral position (Roll,Pitch,Yaw) from permanent memory.
2 MAV_MOUNT_MODE_MAVLINK_TARGETING Load neutral position and start MAVLink Roll,Pitch,Yaw control with stabilization
3 MAV_MOUNT_MODE_RC_TARGETING Load neutral position and start RC Roll,Pitch,Yaw control with stabilization
4 MAV_MOUNT_MODE_GPS_POINT Load neutral position and start to point to Lat,Lon,Alt
5 MAV_MOUNT_MODE_SYSID_TARGET Gimbal tracks system with specified system ID
6 MAV_MOUNT_MODE_HOME_LOCATION Gimbal tracks home position
7 MAV_MOUNT_MODE_WPNEXT_OFFSET Gimbal tracks next waypoint location with offset

GIMBAL_DEVICE_CAP_FLAGS

(Bitmask) Gimbal device (low level) capability flags (bitmap).

Name 描述
1 GIMBAL_DEVICE_CAP_FLAGS_HAS_RETRACT Gimbal device supports a retracted position.
2 GIMBAL_DEVICE_CAP_FLAGS_HAS_NEUTRAL Gimbal device supports a horizontal, forward looking position, stabilized.
4 GIMBAL_DEVICE_CAP_FLAGS_HAS_ROLL_AXIS Gimbal device supports rotating around roll axis.
8 GIMBAL_DEVICE_CAP_FLAGS_HAS_ROLL_FOLLOW Gimbal device supports to follow a roll angle relative to the vehicle.
16 GIMBAL_DEVICE_CAP_FLAGS_HAS_ROLL_LOCK Gimbal device supports locking to a roll angle (generally that's the default with roll stabilized).
32 GIMBAL_DEVICE_CAP_FLAGS_HAS_PITCH_AXIS Gimbal device supports rotating around pitch axis.
64 GIMBAL_DEVICE_CAP_FLAGS_HAS_PITCH_FOLLOW Gimbal device supports to follow a pitch angle relative to the vehicle.
128 GIMBAL_DEVICE_CAP_FLAGS_HAS_PITCH_LOCK Gimbal device supports locking to a pitch angle (generally that's the default with pitch stabilized).
256 GIMBAL_DEVICE_CAP_FLAGS_HAS_YAW_AXIS Gimbal device supports rotating around yaw axis.
512 GIMBAL_DEVICE_CAP_FLAGS_HAS_YAW_FOLLOW Gimbal device supports to follow a yaw angle relative to the vehicle (generally that's the default).
1024 GIMBAL_DEVICE_CAP_FLAGS_HAS_YAW_LOCK Gimbal device supports locking to an absolute heading, i.e., yaw angle relative to North (earth frame, often this is an option available).
2048 GIMBAL_DEVICE_CAP_FLAGS_SUPPORTS_INFINITE_YAW Gimbal device supports yawing/panning infinitely (e.g. using slip disk).
4096 GIMBAL_DEVICE_CAP_FLAGS_SUPPORTS_YAW_IN_EARTH_FRAME Gimbal device supports yaw angles and angular velocities relative to North (earth frame). This usually requires support by an autopilot via AUTOPILOT_STATE_FOR_GIMBAL_DEVICE. Support can go on and off during runtime, which is reported by the flag GIMBAL_DEVICE_FLAGS_CAN_ACCEPT_YAW_IN_EARTH_FRAME.
8192 GIMBAL_DEVICE_CAP_FLAGS_HAS_RC_INPUTS Gimbal device supports radio control inputs as an alternative input for controlling the gimbal orientation.
65536 GIMBAL_DEVICE_CAP_FLAGS_CAN_POINT_LOCATION_LOCAL Gimbal device supports to point to a local position.
131072 GIMBAL_DEVICE_CAP_FLAGS_CAN_POINT_LOCATION_GLOBAL Gimbal device supports to point to a global latitude, longitude, altitude position.

GIMBAL_MANAGER_CAP_FLAGS

(Bitmask) Gimbal manager high level capability flags (bitmap). The flags are identical to the GIMBAL_DEVICE_CAP_FLAGS. However, the gimbal manager does not need to copy the flags from the gimbal but can also enhance the capabilities and thus add flags.

Name 描述
1 GIMBAL_MANAGER_CAP_FLAGS_HAS_RETRACT Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_RETRACT.
2 GIMBAL_MANAGER_CAP_FLAGS_HAS_NEUTRAL Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_NEUTRAL.
4 GIMBAL_MANAGER_CAP_FLAGS_HAS_ROLL_AXIS Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_ROLL_AXIS.
8 GIMBAL_MANAGER_CAP_FLAGS_HAS_ROLL_FOLLOW Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_ROLL_FOLLOW.
16 GIMBAL_MANAGER_CAP_FLAGS_HAS_ROLL_LOCK Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_ROLL_LOCK.
32 GIMBAL_MANAGER_CAP_FLAGS_HAS_PITCH_AXIS Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_PITCH_AXIS.
64 GIMBAL_MANAGER_CAP_FLAGS_HAS_PITCH_FOLLOW Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_PITCH_FOLLOW.
128 GIMBAL_MANAGER_CAP_FLAGS_HAS_PITCH_LOCK Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_PITCH_LOCK.
256 GIMBAL_MANAGER_CAP_FLAGS_HAS_YAW_AXIS Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_YAW_AXIS.
512 GIMBAL_MANAGER_CAP_FLAGS_HAS_YAW_FOLLOW Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_YAW_FOLLOW.
1024 GIMBAL_MANAGER_CAP_FLAGS_HAS_YAW_LOCK Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_YAW_LOCK.
2048 GIMBAL_MANAGER_CAP_FLAGS_SUPPORTS_INFINITE_YAW Based on GIMBAL_DEVICE_CAP_FLAGS_SUPPORTS_INFINITE_YAW.
4096 GIMBAL_MANAGER_CAP_FLAGS_SUPPORTS_YAW_IN_EARTH_FRAME Based on GIMBAL_DEVICE_CAP_FLAGS_SUPPORTS_YAW_IN_EARTH_FRAME.
8192 GIMBAL_MANAGER_CAP_FLAGS_HAS_RC_INPUTS Based on GIMBAL_DEVICE_CAP_FLAGS_HAS_RC_INPUTS.
65536 GIMBAL_MANAGER_CAP_FLAGS_CAN_POINT_LOCATION_LOCAL Based on GIMBAL_DEVICE_CAP_FLAGS_CAN_POINT_LOCATION_LOCAL.
131072 GIMBAL_MANAGER_CAP_FLAGS_CAN_POINT_LOCATION_GLOBAL Based on GIMBAL_DEVICE_CAP_FLAGS_CAN_POINT_LOCATION_GLOBAL.

GIMBAL_DEVICE_FLAGS

(Bitmask) Flags for gimbal device (lower level) operation.

Name 描述
1 GIMBAL_DEVICE_FLAGS_RETRACT Set to retracted safe position (no stabilization), takes precedence over all other flags.
2 GIMBAL_DEVICE_FLAGS_NEUTRAL Set to neutral/default position, taking precedence over all other flags except RETRACT. Neutral is commonly forward-facing and horizontal (roll=pitch=yaw=0) but may be any orientation.
4 GIMBAL_DEVICE_FLAGS_ROLL_LOCK Lock roll angle to absolute angle relative to horizon (not relative to vehicle). This is generally the default with a stabilizing gimbal.
8 GIMBAL_DEVICE_FLAGS_PITCH_LOCK Lock pitch angle to absolute angle relative to horizon (not relative to vehicle). This is generally the default with a stabilizing gimbal.
16 GIMBAL_DEVICE_FLAGS_YAW_LOCK Lock yaw angle to absolute angle relative to North (not relative to vehicle). If this flag is set, the yaw angle and z component of angular velocity are relative to North (earth frame, x-axis pointing North), else they are relative to the vehicle heading (vehicle frame, earth frame rotated so that the x-axis is pointing forward).
32 GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME Yaw angle and z component of angular velocity are relative to the vehicle heading (vehicle frame, earth frame rotated such that the x-axis is pointing forward).
64 GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME Yaw angle and z component of angular velocity are relative to North (earth frame, x-axis is pointing North).
128 GIMBAL_DEVICE_FLAGS_ACCEPTS_YAW_IN_EARTH_FRAME Gimbal device can accept yaw angle inputs relative to North (earth frame). This flag is only for reporting (attempts to set this flag are ignored).
256 GIMBAL_DEVICE_FLAGS_RC_EXCLUSIVE The gimbal orientation is set exclusively by the RC signals feed to the gimbal's radio control inputs. MAVLink messages for setting the gimbal orientation (GIMBAL_DEVICE_SET_ATTITUDE) are ignored.
512 GIMBAL_DEVICE_FLAGS_RC_MIXED The gimbal orientation is determined by combining/mixing the RC signals feed to the gimbal's radio control inputs and the MAVLink messages for setting the gimbal orientation (GIMBAL_DEVICE_SET_ATTITUDE). How these two controls are combined or mixed is not defined by the protocol but is up to the implementation.

GIMBAL_MANAGER_FLAGS

(Bitmask) Flags for high level gimbal manager operation The first 16 bits are identical to the GIMBAL_DEVICE_FLAGS.

Name 描述
1 GIMBAL_MANAGER_FLAGS_RETRACT Based on GIMBAL_DEVICE_FLAGS_RETRACT.
2 GIMBAL_MANAGER_FLAGS_NEUTRAL Based on GIMBAL_DEVICE_FLAGS_NEUTRAL.
4 GIMBAL_MANAGER_FLAGS_ROLL_LOCK Based on GIMBAL_DEVICE_FLAGS_ROLL_LOCK.
8 GIMBAL_MANAGER_FLAGS_PITCH_LOCK Based on GIMBAL_DEVICE_FLAGS_PITCH_LOCK.
16 GIMBAL_MANAGER_FLAGS_YAW_LOCK Based on GIMBAL_DEVICE_FLAGS_YAW_LOCK.
32 GIMBAL_MANAGER_FLAGS_YAW_IN_VEHICLE_FRAME Based on GIMBAL_DEVICE_FLAGS_YAW_IN_VEHICLE_FRAME.
64 GIMBAL_MANAGER_FLAGS_YAW_IN_EARTH_FRAME Based on GIMBAL_DEVICE_FLAGS_YAW_IN_EARTH_FRAME.
128 GIMBAL_MANAGER_FLAGS_ACCEPTS_YAW_IN_EARTH_FRAME Based on GIMBAL_DEVICE_FLAGS_ACCEPTS_YAW_IN_EARTH_FRAME.
256 GIMBAL_MANAGER_FLAGS_RC_EXCLUSIVE Based on GIMBAL_DEVICE_FLAGS_RC_EXCLUSIVE.
512 GIMBAL_MANAGER_FLAGS_RC_MIXED Based on GIMBAL_DEVICE_FLAGS_RC_MIXED.

GIMBAL_DEVICE_ERROR_FLAGS

(Bitmask) Gimbal device (low level) error flags (bitmap, 0 means no error)

Name 描述
1 GIMBAL_DEVICE_ERROR_FLAGS_AT_ROLL_LIMIT Gimbal device is limited by hardware roll limit.
2 GIMBAL_DEVICE_ERROR_FLAGS_AT_PITCH_LIMIT Gimbal device is limited by hardware pitch limit.
4 GIMBAL_DEVICE_ERROR_FLAGS_AT_YAW_LIMIT Gimbal device is limited by hardware yaw limit.
8 GIMBAL_DEVICE_ERROR_FLAGS_ENCODER_ERROR There is an error with the gimbal encoders.
16 GIMBAL_DEVICE_ERROR_FLAGS_POWER_ERROR There is an error with the gimbal power source.
32 GIMBAL_DEVICE_ERROR_FLAGS_MOTOR_ERROR There is an error with the gimbal motors.
64 GIMBAL_DEVICE_ERROR_FLAGS_SOFTWARE_ERROR There is an error with the gimbal's software.
128 GIMBAL_DEVICE_ERROR_FLAGS_COMMS_ERROR There is an error with the gimbal's communication.
256 GIMBAL_DEVICE_ERROR_FLAGS_CALIBRATION_RUNNING Gimbal device is currently calibrating.
512 GIMBAL_DEVICE_ERROR_FLAGS_NO_MANAGER Gimbal device is not assigned to a gimbal manager.

GRIPPER_ACTIONS

Gripper actions.

Name 描述
0 GRIPPER_ACTION_RELEASE Gripper release cargo.
1 GRIPPER_ACTION_GRAB Gripper grab onto cargo.
2 GRIPPER_ACTION_HOLD Gripper hold current grip state/position.

WINCH_ACTIONS

Winch actions.

Name 描述
0 WINCH_RELAXED Allow motor to freewheel.
1 WINCH_RELATIVE_LENGTH_CONTROL Wind or unwind specified length of line, optionally using specified rate.
2 WINCH_RATE_CONTROL Wind or unwind line at specified rate.
3 WINCH_LOCK Perform the locking sequence to relieve motor while in the fully retracted position. Only action and instance command parameters are used, others are ignored.
4 WINCH_DELIVER Sequence of drop, slow down, touch down, reel up, lock. Only action and instance command parameters are used, others are ignored.
5 WINCH_HOLD Engage motor and hold current position. Only action and instance command parameters are used, others are ignored.
6 WINCH_RETRACT Return the reel to the fully retracted position. Only action and instance command parameters are used, others are ignored.
7 WINCH_LOAD_LINE Load the reel with line. The winch will calculate the total loaded length and stop when the tension exceeds a threshold. Only action and instance command parameters are used, others are ignored.
8 WINCH_ABANDON_LINE Spool out the entire length of the line. Only action and instance command parameters are used, others are ignored.
9 WINCH_LOAD_PAYLOAD Spools out just enough to present the hook to the user to load the payload. Only action and instance command parameters are used, others are ignored

UAVCAN_NODE_HEALTH

Generalized UAVCAN node health

Name 描述
0 UAVCAN_NODE_HEALTH_OK The node is functioning properly.
1 UAVCAN_NODE_HEALTH_WARNING A critical parameter went out of range or the node has encountered a minor failure.
2 UAVCAN_NODE_HEALTH_ERROR The node has encountered a major failure.
3 UAVCAN_NODE_HEALTH_CRITICAL The node has suffered a fatal malfunction.

UAVCAN_NODE_MODE

Generalized UAVCAN node mode

Name 描述
0 UAVCAN_NODE_MODE_OPERATIONAL The node is performing its primary functions.
1 UAVCAN_NODE_MODE_INITIALIZATION The node is initializing; this mode is entered immediately after startup.
2 UAVCAN_NODE_MODE_MAINTENANCE The node is under maintenance.
3 UAVCAN_NODE_MODE_SOFTWARE_UPDATE The node is in the process of updating its software.
7 UAVCAN_NODE_MODE_OFFLINE The node is no longer available online.

ESC_CONNECTION_TYPE

Indicates the ESC connection type.

Name 描述
0 ESC_CONNECTION_TYPE_PPM Traditional PPM ESC.
1 ESC_CONNECTION_TYPE_SERIAL Serial Bus connected ESC.
2 ESC_CONNECTION_TYPE_ONESHOT One Shot PPM ESC.
3 ESC_CONNECTION_TYPE_I2C I2C ESC.
4 ESC_CONNECTION_TYPE_CAN CAN-Bus ESC.
5 ESC_CONNECTION_TYPE_DSHOT DShot ESC.

ESC_FAILURE_FLAGS

(Bitmask) Flags to report ESC failures.

Name 描述
1 ESC_FAILURE_OVER_CURRENT Over current failure.
2 ESC_FAILURE_OVER_VOLTAGE Over voltage failure.
4 ESC_FAILURE_OVER_TEMPERATURE Over temperature failure.
8 ESC_FAILURE_OVER_RPM Over RPM failure.
16 ESC_FAILURE_INCONSISTENT_CMD Inconsistent command failure i.e. out of bounds.
32 ESC_FAILURE_MOTOR_STUCK Motor stuck failure.
64 ESC_FAILURE_GENERIC Generic ESC failure.

STORAGE_STATUS

Flags to indicate the status of camera storage.

Name 描述
0 STORAGE_STATUS_EMPTY Storage is missing (no microSD card loaded for example.)
1 STORAGE_STATUS_UNFORMATTED Storage present but unformatted.
2 STORAGE_STATUS_READY Storage present and ready.
3 STORAGE_STATUS_NOT_SUPPORTED Camera does not supply storage status information. Capacity information in STORAGE_INFORMATION fields will be ignored.

STORAGE_TYPE

Flags to indicate the type of storage.

Name 描述
0 STORAGE_TYPE_UNKNOWN Storage type is not known.
1 STORAGE_TYPE_USB_STICK Storage type is USB device.
2 STORAGE_TYPE_SD Storage type is SD card.
3 STORAGE_TYPE_MICROSD Storage type is microSD card.
4 STORAGE_TYPE_CF Storage type is CFast.
5 STORAGE_TYPE_CFE Storage type is CFexpress.
6 STORAGE_TYPE_XQD Storage type is XQD.
7 STORAGE_TYPE_HD Storage type is HD mass storage type.
254 STORAGE_TYPE_OTHER Storage type is other, not listed type.

STORAGE_USAGE_FLAG

(Bitmask) Flags to indicate usage for a particular storage (see STORAGE_INFORMATION.storage_usage and MAV_CMD_SET_STORAGE_USAGE).

Name 描述
1 STORAGE_USAGE_FLAG_SET Always set to 1 (indicates STORAGE_INFORMATION.storage_usage is supported).
2 STORAGE_USAGE_FLAG_PHOTO Storage for saving photos.
4 STORAGE_USAGE_FLAG_VIDEO Storage for saving videos.
8 STORAGE_USAGE_FLAG_LOGS Storage for saving logs.

ORBIT_YAW_BEHAVIOUR

Yaw behaviour during orbit flight.

Name 描述
0 ORBIT_YAW_BEHAVIOUR_HOLD_FRONT_TO_CIRCLE_CENTER Vehicle front points to the center (default).
1 ORBIT_YAW_BEHAVIOUR_HOLD_INITIAL_HEADING Vehicle front holds heading when message received.
2 ORBIT_YAW_BEHAVIOUR_UNCONTROLLED Yaw uncontrolled.
3 ORBIT_YAW_BEHAVIOUR_HOLD_FRONT_TANGENT_TO_CIRCLE Vehicle front follows flight path (tangential to circle).
4 ORBIT_YAW_BEHAVIOUR_RC_CONTROLLED Yaw controlled by RC input.
5 ORBIT_YAW_BEHAVIOUR_UNCHANGED Vehicle uses current yaw behaviour (unchanged). The vehicle-default yaw behaviour is used if this value is specified when orbit is first commanded.

WIFI_CONFIG_AP_RESPONSE

Possible responses from a WIFI_CONFIG_AP message.

Name 描述
0 WIFI_CONFIG_AP_RESPONSE_UNDEFINED Undefined response. Likely an indicative of a system that doesn't support this request.
1 WIFI_CONFIG_AP_RESPONSE_ACCEPTED Changes accepted.
2 WIFI_CONFIG_AP_RESPONSE_REJECTED Changes rejected.
3 WIFI_CONFIG_AP_RESPONSE_MODE_ERROR Invalid Mode.
4 WIFI_CONFIG_AP_RESPONSE_SSID_ERROR Invalid SSID.
5 WIFI_CONFIG_AP_RESPONSE_PASSWORD_ERROR Invalid Password.

CELLULAR_CONFIG_RESPONSE

Possible responses from a CELLULAR_CONFIG message.

Name 描述
0 CELLULAR_CONFIG_RESPONSE_ACCEPTED Changes accepted.
1 CELLULAR_CONFIG_RESPONSE_APN_ERROR Invalid APN.
2 CELLULAR_CONFIG_RESPONSE_PIN_ERROR Invalid PIN.
3 CELLULAR_CONFIG_RESPONSE_REJECTED Changes rejected.
4 CELLULAR_CONFIG_BLOCKED_PUK_REQUIRED PUK is required to unblock SIM card.

WIFI_CONFIG_AP_MODE

WiFi Mode.

Name 描述
0 WIFI_CONFIG_AP_MODE_UNDEFINED WiFi mode is undefined.
1 WIFI_CONFIG_AP_MODE_AP WiFi configured as an access point.
2 WIFI_CONFIG_AP_MODE_STATION WiFi configured as a station connected to an existing local WiFi network.
3 WIFI_CONFIG_AP_MODE_DISABLED WiFi disabled.

COMP_METADATA_TYPE

Supported component metadata types. These are used in the "general" metadata file returned by COMPONENT_METADATA to provide information about supported metadata types. The types are not used directly in MAVLink messages.

Name 描述
0 COMP_METADATA_TYPE_GENERAL General information about the component. General metadata includes information about other metadata types supported by the component. Files of this type must be supported, and must be downloadable from vehicle using a MAVLink FTP URI.
1 COMP_METADATA_TYPE_PARAMETER Parameter meta data.
2 COMP_METADATA_TYPE_COMMANDS Meta data that specifies which commands and command parameters the vehicle supports. (WIP)
3 COMP_METADATA_TYPE_PERIPHERALS Meta data that specifies external non-MAVLink peripherals.
4 COMP_METADATA_TYPE_EVENTS Meta data for the events interface.
5 COMP_METADATA_TYPE_ACTUATORS Meta data for actuator configuration (motors, servos and vehicle geometry) and testing.

ACTUATOR_CONFIGURATION

Actuator configuration, used to change a setting on an actuator. Component information metadata can be used to know which outputs support which commands.

Name 描述
0 ACTUATOR_CONFIGURATION_NONE Do nothing.
1 ACTUATOR_CONFIGURATION_BEEP Command the actuator to beep now.
2 ACTUATOR_CONFIGURATION_3D_MODE_ON Permanently set the actuator (ESC) to 3D mode (reversible thrust).
3 ACTUATOR_CONFIGURATION_3D_MODE_OFF Permanently set the actuator (ESC) to non 3D mode (non-reversible thrust).
4 ACTUATOR_CONFIGURATION_SPIN_DIRECTION1 Permanently set the actuator (ESC) to spin direction 1 (which can be clockwise or counter-clockwise).
5 ACTUATOR_CONFIGURATION_SPIN_DIRECTION2 Permanently set the actuator (ESC) to spin direction 2 (opposite of direction 1).

ACTUATOR_OUTPUT_FUNCTION

Actuator output function. Values greater or equal to 1000 are autopilot-specific.

Name 描述
0 ACTUATOR_OUTPUT_FUNCTION_NONE No function (disabled).
1 ACTUATOR_OUTPUT_FUNCTION_MOTOR1 Motor 1
2 ACTUATOR_OUTPUT_FUNCTION_MOTOR2 Motor 2
3 ACTUATOR_OUTPUT_FUNCTION_MOTOR3 Motor 3
4 ACTUATOR_OUTPUT_FUNCTION_MOTOR4 Motor 4
5 ACTUATOR_OUTPUT_FUNCTION_MOTOR5 Motor 5
6 ACTUATOR_OUTPUT_FUNCTION_MOTOR6 Motor 6
7 ACTUATOR_OUTPUT_FUNCTION_MOTOR7 Motor 7
8 ACTUATOR_OUTPUT_FUNCTION_MOTOR8 Motor 8
9 ACTUATOR_OUTPUT_FUNCTION_MOTOR9 Motor 9
10 ACTUATOR_OUTPUT_FUNCTION_MOTOR10 Motor 10
11 ACTUATOR_OUTPUT_FUNCTION_MOTOR11 Motor 11
12 ACTUATOR_OUTPUT_FUNCTION_MOTOR12 Motor 12
13 ACTUATOR_OUTPUT_FUNCTION_MOTOR13 Motor 13
14 ACTUATOR_OUTPUT_FUNCTION_MOTOR14 Motor 14
15 ACTUATOR_OUTPUT_FUNCTION_MOTOR15 Motor 15
16 ACTUATOR_OUTPUT_FUNCTION_MOTOR16 Motor 16
33 ACTUATOR_OUTPUT_FUNCTION_SERVO1 Servo 1
34 ACTUATOR_OUTPUT_FUNCTION_SERVO2 Servo 2
35 ACTUATOR_OUTPUT_FUNCTION_SERVO3 Servo 3
36 ACTUATOR_OUTPUT_FUNCTION_SERVO4 Servo 4
37 ACTUATOR_OUTPUT_FUNCTION_SERVO5 Servo 5
38 ACTUATOR_OUTPUT_FUNCTION_SERVO6 Servo 6
39 ACTUATOR_OUTPUT_FUNCTION_SERVO7 Servo 7
40 ACTUATOR_OUTPUT_FUNCTION_SERVO8 Servo 8
41 ACTUATOR_OUTPUT_FUNCTION_SERVO9 Servo 9
42 ACTUATOR_OUTPUT_FUNCTION_SERVO10 Servo 10
43 ACTUATOR_OUTPUT_FUNCTION_SERVO11 Servo 11
44 ACTUATOR_OUTPUT_FUNCTION_SERVO12 Servo 12
45 ACTUATOR_OUTPUT_FUNCTION_SERVO13 Servo 13
46 ACTUATOR_OUTPUT_FUNCTION_SERVO14 Servo 14
47 ACTUATOR_OUTPUT_FUNCTION_SERVO15 Servo 15
48 ACTUATOR_OUTPUT_FUNCTION_SERVO16 Servo 16

AUTOTUNE_AXIS

(Bitmask) Axes that will be autotuned by MAV_CMD_DO_AUTOTUNE_ENABLE.

Note that at least one flag must be set in MAV_CMD_DO_AUTOTUNE_ENABLE.param2: if none are set, the flight stack will tune its default set of axes.

Name 描述
1 AUTOTUNE_AXIS_ROLL Autotune roll axis.
2 AUTOTUNE_AXIS_PITCH Autotune pitch axis.
4 AUTOTUNE_AXIS_YAW Autotune yaw axis.

PREFLIGHT_STORAGE_PARAMETER_ACTION

Actions for reading/writing parameters between persistent and volatile storage when using MAV_CMD_PREFLIGHT_STORAGE. (Commonly parameters are loaded from persistent storage (flash/EEPROM) into volatile storage (RAM) on startup and written back when they are changed.)

Name 描述
0 PARAM_READ_PERSISTENT Read all parameters from persistent storage. Replaces values in volatile storage.
1 PARAM_WRITE_PERSISTENT Write all parameter values to persistent storage (flash/EEPROM)
2 PARAM_RESET_FACTORY_DEFAULT Reset parameters to default values (such as sensor calibration, safety settings, and so on). Note that a flight stack may choose not to reset some parameters at their own discretion (such as those that are locked or expected to persist for the vehicle lifetime).
3 PARAM_RESET_SENSOR_DEFAULT Reset only sensor calibration parameters to factory defaults (or firmware default if not available)
4 PARAM_RESET_ALL_DEFAULT Reset all parameters to default values.

PREFLIGHT_STORAGE_MISSION_ACTION

Actions for reading and writing plan information (mission, rally points, geofence) between persistent and volatile storage when using MAV_CMD_PREFLIGHT_STORAGE. (Commonly missions are loaded from persistent storage (flash/EEPROM) into volatile storage (RAM) on startup and written back when they are changed.)

Name 描述
0 MISSION_READ_PERSISTENT Read current mission data from persistent storage
1 MISSION_WRITE_PERSISTENT Write current mission data to persistent storage
2 MISSION_RESET_DEFAULT Erase all mission data stored on the vehicle (both persistent and volatile storage)

REBOOT_SHUTDOWN_ACTION

Reboot/shutdown action for selected component in MAV_CMD_PREFLIGHT_REBOOT_SHUTDOWN.

Name 描述
0 REBOOT_SHUTDOWN_ACTION_NONE Do nothing.
1 REBOOT_SHUTDOWN_ACTION_REBOOT Reboot component.
2 REBOOT_SHUTDOWN_ACTION_SHUTDOWN Shutdown component.
3 REBOOT_SHUTDOWN_ACTION_REBOOT_TO_BOOTLOADER Reboot component and keep it in the bootloader until upgraded.
4 REBOOT_SHUTDOWN_ACTION_POWER_ON Power on component. Do nothing if component is already powered (ACK command with MAV_RESULT_ACCEPTED).

REBOOT_SHUTDOWN_CONDITIONS

Specifies the conditions under which the MAV_CMD_PREFLIGHT_REBOOT_SHUTDOWN command should be accepted.

Name 描述
0 REBOOT_SHUTDOWN_CONDITIONS_SAFETY_INTERLOCKED Reboot/Shutdown only if allowed by safety checks, such as being landed.
20190226 REBOOT_SHUTDOWN_CONDITIONS_FORCE Force reboot/shutdown of the autopilot/component regardless of system state.

PREFLIGHT_CALIBRATION_MAGNETOMETER

Action for the magnetometer (param2) of MAV_CMD_PREFLIGHT_CALIBRATION.

Name 描述
0 PREFLIGHT_CALIBRATION_MAGNETOMETER_NONE No action.
1 PREFLIGHT_CALIBRATION_MAGNETOMETER_START Start magnetometer calibration.
76 PREFLIGHT_CALIBRATION_MAGNETOMETER_FORCE_SAVE Force-accept the existing compass calibration as valid without re-running it. Useful after a parameter reload that cleared calibration validity flags.

PREFLIGHT_CALIBRATION_ACCELEROMETER

Action for the accelerometer (param5) of MAV_CMD_PREFLIGHT_CALIBRATION.

Name 描述
0 PREFLIGHT_CALIBRATION_ACCELEROMETER_NONE No action.
1 PREFLIGHT_CALIBRATION_ACCELEROMETER_FULL Full 6-position accelerometer calibration.
2 PREFLIGHT_CALIBRATION_ACCELEROMETER_TRIM Board level (trim) calibration.
3 PREFLIGHT_CALIBRATION_ACCELEROMETER_TEMPERATURE Accelerometer temperature calibration.
4 PREFLIGHT_CALIBRATION_ACCELEROMETER_SIMPLE Simple accelerometer calibration.
76 PREFLIGHT_CALIBRATION_ACCELEROMETER_FORCE_SAVE Force-accept the existing accelerometer calibration as valid without re-running it. Useful after a parameter reload that cleared calibration validity flags.

NAV_TAKEOFF_FLAGS

(Bitmask)

Name 描述
1 NAV_TAKEOFF_FLAGS_HORIZONTAL_POSITION_NOT_REQUIRED Accept the command even if the autopilot does not have control over its horizontal position (note that it might not have altitude control either).

MAV_DATA_STREAM — [SUP]

SUPERSEDED: Replaced By MESSAGE_INTERVAL (2015-06)

A data stream is not a fixed set of messages, but rather a

recommendation to the autopilot software. Individual autopilots may or may not obey the recommended messages.

Name 描述
0 MAV_DATA_STREAM_ALL Enable all data streams
1 MAV_DATA_STREAM_RAW_SENSORS Enable IMU_RAW, GPS_RAW, GPS_STATUS packets.
2 MAV_DATA_STREAM_EXTENDED_STATUS Enable GPS_STATUS, CONTROL_STATUS, AUX_STATUS
3 MAV_DATA_STREAM_RC_CHANNELS Enable RC_CHANNELS_SCALED, RC_CHANNELS_RAW, SERVO_OUTPUT_RAW
4 MAV_DATA_STREAM_RAW_CONTROLLER Enable ATTITUDE_CONTROLLER_OUTPUT, POSITION_CONTROLLER_OUTPUT, NAV_CONTROLLER_OUTPUT.
6 MAV_DATA_STREAM_POSITION Enable LOCAL_POSITION, GLOBAL_POSITION_INT messages.
10 MAV_DATA_STREAM_EXTRA1 Dependent on the autopilot
11 MAV_DATA_STREAM_EXTRA2 Dependent on the autopilot
12 MAV_DATA_STREAM_EXTRA3 Dependent on the autopilot

MAV_ROI — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_SET_ROI_* (2018-01)

The ROI (region of interest) for the vehicle. This can be

be used by the vehicle for camera/vehicle attitude alignment (see MAV_CMD_NAV_ROI).

Name 描述
0 MAV_ROI_NONE No region of interest.
1 MAV_ROI_WPNEXT Point toward next waypoint, with optional pitch/roll/yaw offset.
2 MAV_ROI_WPINDEX Point toward given waypoint.
3 MAV_ROI_LOCATION Point toward fixed location.
4 MAV_ROI_TARGET Point toward of given id.

MAV_PARAM_TYPE

Specifies the datatype of a MAVLink parameter.

Name 描述
1 MAV_PARAM_TYPE_UINT8 8-bit unsigned integer
2 MAV_PARAM_TYPE_INT8 8-bit signed integer
3 MAV_PARAM_TYPE_UINT16 16-bit unsigned integer
4 MAV_PARAM_TYPE_INT16 16-bit signed integer
5 MAV_PARAM_TYPE_UINT32 32-bit unsigned integer
6 MAV_PARAM_TYPE_INT32 32-bit signed integer
7 MAV_PARAM_TYPE_UINT64 64-bit unsigned integer
8 MAV_PARAM_TYPE_INT64 64-bit signed integer
9 MAV_PARAM_TYPE_REAL32 32-bit floating-point
10 MAV_PARAM_TYPE_REAL64 64-bit floating-point

MAV_PARAM_ERROR — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Parameter protocol error types (see PARAM_ERROR).

Name 描述
0 MAV_PARAM_ERROR_NO_ERROR No error occurred (not expected in PARAM_ERROR but may be used in future implementations.
1 MAV_PARAM_ERROR_DOES_NOT_EXIST Parameter does not exist
2 MAV_PARAM_ERROR_VALUE_OUT_OF_RANGE Parameter value does not fit within accepted range
3 MAV_PARAM_ERROR_PERMISSION_DENIED Caller is not permitted to set the value of this parameter
4 MAV_PARAM_ERROR_COMPONENT_NOT_FOUND Unknown component specified
5 MAV_PARAM_ERROR_READ_ONLY Parameter is read-only
6 MAV_PARAM_ERROR_TYPE_UNSUPPORTED Parameter data type (MAV_PARAM_TYPE) is not supported by flight stack (at all)
7 MAV_PARAM_ERROR_TYPE_MISMATCH Parameter type does not match expected type
8 MAV_PARAM_ERROR_READ_FAIL Parameter exists but reading failed

MAV_PARAM_EXT_TYPE

Specifies the datatype of a MAVLink extended parameter.

Name 描述
1 MAV_PARAM_EXT_TYPE_UINT8 8-bit unsigned integer
2 MAV_PARAM_EXT_TYPE_INT8 8-bit signed integer
3 MAV_PARAM_EXT_TYPE_UINT16 16-bit unsigned integer
4 MAV_PARAM_EXT_TYPE_INT16 16-bit signed integer
5 MAV_PARAM_EXT_TYPE_UINT32 32-bit unsigned integer
6 MAV_PARAM_EXT_TYPE_INT32 32-bit signed integer
7 MAV_PARAM_EXT_TYPE_UINT64 64-bit unsigned integer
8 MAV_PARAM_EXT_TYPE_INT64 64-bit signed integer
9 MAV_PARAM_EXT_TYPE_REAL32 32-bit floating-point
10 MAV_PARAM_EXT_TYPE_REAL64 64-bit floating-point
11 MAV_PARAM_EXT_TYPE_CUSTOM Custom Type

MAV_RESULT

Result from a MAVLink command (MAV_CMD)

Name 描述
0 MAV_RESULT_ACCEPTED Command is valid (is supported and has valid parameters), and was executed.
1 MAV_RESULT_TEMPORARILY_REJECTED Command is valid, but cannot be executed at this time. This is used to indicate a problem that should be fixed just by waiting (e.g. a state machine is busy, can't arm because have not got GPS lock, etc.). Retrying later should work.
2 MAV_RESULT_DENIED Command is invalid; it is supported but one or more parameter values are invalid (i.e. parameter reserved, value allowed by spec but not supported by flight stack, and so on). Retrying the same command and parameters will not work.
3 MAV_RESULT_UNSUPPORTED Command is not supported (unknown).
4 MAV_RESULT_FAILED Command is valid, but execution has failed. This is used to indicate any non-temporary or unexpected problem, i.e. any problem that must be fixed before the command can succeed/be retried. For example, attempting to write a file when out of memory, attempting to arm when sensors are not calibrated, etc.
5 MAV_RESULT_IN_PROGRESS Command is valid and is being executed. This will be followed by further progress updates, i.e. the component may send further COMMAND_ACK messages with result MAV_RESULT_IN_PROGRESS (at a rate decided by the implementation), and must terminate by sending a COMMAND_ACK message with final result of the operation. The COMMAND_ACK.progress field can be used to indicate the progress of the operation.
6 MAV_RESULT_CANCELLED Command has been cancelled (as a result of receiving a COMMAND_CANCEL message).
7 MAV_RESULT_COMMAND_LONG_ONLY Command is only accepted when sent as a COMMAND_LONG.
8 MAV_RESULT_COMMAND_INT_ONLY Command is only accepted when sent as a COMMAND_INT.
9 MAV_RESULT_COMMAND_UNSUPPORTED_MAV_FRAME Command is invalid because a frame is required and the specified frame is not supported.
10 MAV_RESULT_NOT_IN_CONTROL Command has been rejected because source system is not in control of the target system/component.
WORK IN PROGRESS: Do not use in stable production environments (it may change).

MAV_MISSION_RESULT

Result of mission operation (in a MISSION_ACK message).

Name 描述
0 MAV_MISSION_ACCEPTED mission accepted OK
1 MAV_MISSION_ERROR Generic error / not accepting mission commands at all right now.
2 MAV_MISSION_UNSUPPORTED_FRAME Coordinate frame is not supported.
3 MAV_MISSION_UNSUPPORTED Command is not supported.
4 MAV_MISSION_NO_SPACE Mission items exceed storage space.
5 MAV_MISSION_INVALID One of the parameters has an invalid value.
6 MAV_MISSION_INVALID_PARAM1 param1 has an invalid value.
7 MAV_MISSION_INVALID_PARAM2 param2 has an invalid value.
8 MAV_MISSION_INVALID_PARAM3 param3 has an invalid value.
9 MAV_MISSION_INVALID_PARAM4 param4 has an invalid value.
10 MAV_MISSION_INVALID_PARAM5_X x / param5 has an invalid value.
11 MAV_MISSION_INVALID_PARAM6_Y y / param6 has an invalid value.
12 MAV_MISSION_INVALID_PARAM7 z / param7 has an invalid value.
13 MAV_MISSION_INVALID_SEQUENCE Mission item received out of sequence
14 MAV_MISSION_DENIED Not accepting any mission commands from this communication partner.
15 MAV_MISSION_OPERATION_CANCELLED Current mission operation cancelled (e.g. mission upload, mission download).

MAV_SEVERITY

Indicates the severity level, generally used for status messages to indicate their relative urgency. Based on RFC-5424 using expanded definitions at: http://www.kiwisyslog.com/kb/info:-syslog-message-levels/.

Name 描述
0 MAV_SEVERITY_EMERGENCY System is unusable. This is a "panic" condition.
1 MAV_SEVERITY_ALERT Action should be taken immediately. Indicates error in non-critical systems.
2 MAV_SEVERITY_CRITICAL Action must be taken immediately. Indicates failure in a primary system.
3 MAV_SEVERITY_ERROR Indicates an error in secondary/redundant systems.
4 MAV_SEVERITY_WARNING Indicates about a possible future error if this is not resolved within a given timeframe. Example would be a low battery warning.
5 MAV_SEVERITY_NOTICE An unusual event has occurred, though not an error condition. This should be investigated for the root cause.
6 MAV_SEVERITY_INFO Normal operational messages. Useful for logging. No action is required for these messages.
7 MAV_SEVERITY_DEBUG Useful non-operational messages that can assist in debugging. These should not occur during normal operation.

MAV_POWER_STATUS

(Bitmask) Power supply status flags (bitmask)

Name 描述
1 MAV_POWER_STATUS_BRICK_VALID main brick power supply valid
2 MAV_POWER_STATUS_SERVO_VALID main servo power supply valid for FMU
4 MAV_POWER_STATUS_USB_CONNECTED USB power is connected
8 MAV_POWER_STATUS_PERIPH_OVERCURRENT peripheral supply is in over-current state
16 MAV_POWER_STATUS_PERIPH_HIPOWER_OVERCURRENT hi-power peripheral supply is in over-current state
32 MAV_POWER_STATUS_CHANGED Power status has changed since boot

SERIAL_CONTROL_DEV

SERIAL_CONTROL device types

Name 描述
0 SERIAL_CONTROL_DEV_TELEM1 First telemetry port
1 SERIAL_CONTROL_DEV_TELEM2 Second telemetry port
2 SERIAL_CONTROL_DEV_GPS1 First GPS port
3 SERIAL_CONTROL_DEV_GPS2 Second GPS port
10 SERIAL_CONTROL_DEV_SHELL system shell
100 SERIAL_CONTROL_SERIAL0 SERIAL0
101 SERIAL_CONTROL_SERIAL1 SERIAL1
102 SERIAL_CONTROL_SERIAL2 SERIAL2
103 SERIAL_CONTROL_SERIAL3 SERIAL3
104 SERIAL_CONTROL_SERIAL4 SERIAL4
105 SERIAL_CONTROL_SERIAL5 SERIAL5
106 SERIAL_CONTROL_SERIAL6 SERIAL6
107 SERIAL_CONTROL_SERIAL7 SERIAL7
108 SERIAL_CONTROL_SERIAL8 SERIAL8
109 SERIAL_CONTROL_SERIAL9 SERIAL9

SERIAL_CONTROL_FLAG

(Bitmask) SERIAL_CONTROL flags (bitmask)

Name 描述
1 SERIAL_CONTROL_FLAG_REPLY Set if this is a reply
2 SERIAL_CONTROL_FLAG_RESPOND Set if the sender wants the receiver to send a response as another SERIAL_CONTROL message
4 SERIAL_CONTROL_FLAG_EXCLUSIVE Set if access to the serial port should be removed from whatever driver is currently using it, giving exclusive access to the SERIAL_CONTROL protocol. The port can be handed back by sending a request without this flag set
8 SERIAL_CONTROL_FLAG_BLOCKING Block on writes to the serial port
16 SERIAL_CONTROL_FLAG_MULTI Send multiple replies until port is drained

MAV_DISTANCE_SENSOR

Enumeration of distance sensor types

Name 描述
0 MAV_DISTANCE_SENSOR_LASER Laser rangefinder, e.g. LightWare SF02/F or PulsedLight units
1 MAV_DISTANCE_SENSOR_ULTRASOUND Ultrasound rangefinder, e.g. MaxBotix units
2 MAV_DISTANCE_SENSOR_INFRARED Infrared rangefinder, e.g. Sharp units
3 MAV_DISTANCE_SENSOR_RADAR Radar type, e.g. uLanding units
4 MAV_DISTANCE_SENSOR_UNKNOWN Broken or unknown type, e.g. analog units

MAV_SENSOR_ORIENTATION

Enumeration of sensor orientation, according to its rotations

Name 描述
0 MAV_SENSOR_ROTATION_NONE Roll: 0, Pitch: 0, Yaw: 0
1 MAV_SENSOR_ROTATION_YAW_45 Roll: 0, Pitch: 0, Yaw: 45
2 MAV_SENSOR_ROTATION_YAW_90 Roll: 0, Pitch: 0, Yaw: 90
3 MAV_SENSOR_ROTATION_YAW_135 Roll: 0, Pitch: 0, Yaw: 135
4 MAV_SENSOR_ROTATION_YAW_180 Roll: 0, Pitch: 0, Yaw: 180
5 MAV_SENSOR_ROTATION_YAW_225 Roll: 0, Pitch: 0, Yaw: 225
6 MAV_SENSOR_ROTATION_YAW_270 Roll: 0, Pitch: 0, Yaw: 270
7 MAV_SENSOR_ROTATION_YAW_315 Roll: 0, Pitch: 0, Yaw: 315
8 MAV_SENSOR_ROTATION_ROLL_180 Roll: 180, Pitch: 0, Yaw: 0
9 MAV_SENSOR_ROTATION_ROLL_180_YAW_45 Roll: 180, Pitch: 0, Yaw: 45
10 MAV_SENSOR_ROTATION_ROLL_180_YAW_90 Roll: 180, Pitch: 0, Yaw: 90
11 MAV_SENSOR_ROTATION_ROLL_180_YAW_135 Roll: 180, Pitch: 0, Yaw: 135
12 MAV_SENSOR_ROTATION_PITCH_180 Roll: 0, Pitch: 180, Yaw: 0
13 MAV_SENSOR_ROTATION_ROLL_180_YAW_225 Roll: 180, Pitch: 0, Yaw: 225
14 MAV_SENSOR_ROTATION_ROLL_180_YAW_270 Roll: 180, Pitch: 0, Yaw: 270
15 MAV_SENSOR_ROTATION_ROLL_180_YAW_315 Roll: 180, Pitch: 0, Yaw: 315
16 MAV_SENSOR_ROTATION_ROLL_90 Roll: 90, Pitch: 0, Yaw: 0
17 MAV_SENSOR_ROTATION_ROLL_90_YAW_45 Roll: 90, Pitch: 0, Yaw: 45
18 MAV_SENSOR_ROTATION_ROLL_90_YAW_90 Roll: 90, Pitch: 0, Yaw: 90
19 MAV_SENSOR_ROTATION_ROLL_90_YAW_135 Roll: 90, Pitch: 0, Yaw: 135
20 MAV_SENSOR_ROTATION_ROLL_270 Roll: 270, Pitch: 0, Yaw: 0
21 MAV_SENSOR_ROTATION_ROLL_270_YAW_45 Roll: 270, Pitch: 0, Yaw: 45
22 MAV_SENSOR_ROTATION_ROLL_270_YAW_90 Roll: 270, Pitch: 0, Yaw: 90
23 MAV_SENSOR_ROTATION_ROLL_270_YAW_135 Roll: 270, Pitch: 0, Yaw: 135
24 MAV_SENSOR_ROTATION_PITCH_90 Roll: 0, Pitch: 90, Yaw: 0
25 MAV_SENSOR_ROTATION_PITCH_270 Roll: 0, Pitch: 270, Yaw: 0
26 MAV_SENSOR_ROTATION_PITCH_180_YAW_90 Roll: 0, Pitch: 180, Yaw: 90
27 MAV_SENSOR_ROTATION_PITCH_180_YAW_270 Roll: 0, Pitch: 180, Yaw: 270
28 MAV_SENSOR_ROTATION_ROLL_90_PITCH_90 Roll: 90, Pitch: 90, Yaw: 0
29 MAV_SENSOR_ROTATION_ROLL_180_PITCH_90 Roll: 180, Pitch: 90, Yaw: 0
30 MAV_SENSOR_ROTATION_ROLL_270_PITCH_90 Roll: 270, Pitch: 90, Yaw: 0
31 MAV_SENSOR_ROTATION_ROLL_90_PITCH_180 Roll: 90, Pitch: 180, Yaw: 0
32 MAV_SENSOR_ROTATION_ROLL_270_PITCH_180 Roll: 270, Pitch: 180, Yaw: 0
33 MAV_SENSOR_ROTATION_ROLL_90_PITCH_270 Roll: 90, Pitch: 270, Yaw: 0
34 MAV_SENSOR_ROTATION_ROLL_180_PITCH_270 Roll: 180, Pitch: 270, Yaw: 0
35 MAV_SENSOR_ROTATION_ROLL_270_PITCH_270 Roll: 270, Pitch: 270, Yaw: 0
36 MAV_SENSOR_ROTATION_ROLL_90_PITCH_180_YAW_90 Roll: 90, Pitch: 180, Yaw: 90
37 MAV_SENSOR_ROTATION_ROLL_90_YAW_270 Roll: 90, Pitch: 0, Yaw: 270
38 MAV_SENSOR_ROTATION_ROLL_90_PITCH_68_YAW_293 Roll: 90, Pitch: 68, Yaw: 293
39 MAV_SENSOR_ROTATION_PITCH_315 Pitch: 315
40 MAV_SENSOR_ROTATION_ROLL_90_PITCH_315 Roll: 90, Pitch: 315
100 MAV_SENSOR_ROTATION_CUSTOM Custom orientation

MAV_MISSION_TYPE

Type of mission items being requested/sent in mission protocol.

Name 描述
0 MAV_MISSION_TYPE_MISSION Items are mission commands for main mission.
1 MAV_MISSION_TYPE_FENCE Specifies GeoFence area(s). Items are MAV_CMD_NAV_FENCE_ GeoFence items.
2 MAV_MISSION_TYPE_RALLY Specifies the rally points for the vehicle. Rally points are alternative RTL points. Items are MAV_CMD_NAV_RALLY_POINT rally point items.
255 MAV_MISSION_TYPE_ALL Only used in MISSION_CLEAR_ALL to clear all mission types.

MAV_ESTIMATOR_TYPE

Enumeration of estimator types

Name 描述
0 MAV_ESTIMATOR_TYPE_UNKNOWN Unknown type of the estimator.
1 MAV_ESTIMATOR_TYPE_NAIVE This is a naive estimator without any real covariance feedback.
2 MAV_ESTIMATOR_TYPE_VISION Computer vision based estimate. Might be up to scale.
3 MAV_ESTIMATOR_TYPE_VIO Visual-inertial estimate.
4 MAV_ESTIMATOR_TYPE_GPS Plain GPS estimate.
5 MAV_ESTIMATOR_TYPE_GPS_INS Estimator integrating GPS and inertial sensing.
6 MAV_ESTIMATOR_TYPE_MOCAP Estimate from external motion capturing system.
7 MAV_ESTIMATOR_TYPE_LIDAR Estimator based on lidar sensor input.
8 MAV_ESTIMATOR_TYPE_AUTOPILOT Estimator on autopilot.

MAV_BATTERY_TYPE

Enumeration of battery types

Name 描述
0 MAV_BATTERY_TYPE_UNKNOWN Not specified.
1 MAV_BATTERY_TYPE_LIPO Lithium polymer battery
2 MAV_BATTERY_TYPE_LIFE Lithium-iron-phosphate battery
3 MAV_BATTERY_TYPE_LION Lithium-ION battery
4 MAV_BATTERY_TYPE_NIMH Nickel metal hydride battery

MAV_BATTERY_FUNCTION

Enumeration of battery functions

Name 描述
0 MAV_BATTERY_FUNCTION_UNKNOWN Battery function is unknown
1 MAV_BATTERY_FUNCTION_ALL Battery supports all flight systems
2 MAV_BATTERY_FUNCTION_PROPULSION Battery for the propulsion system
3 MAV_BATTERY_FUNCTION_AVIONICS Avionics battery
4 MAV_BATTERY_FUNCTION_PAYLOAD Payload battery

MAV_BATTERY_CHARGE_STATE

Enumeration for battery charge states.

Name 描述
0 MAV_BATTERY_CHARGE_STATE_UNDEFINED Low battery state is not provided
1 MAV_BATTERY_CHARGE_STATE_OK Battery is not in low state. Normal operation.
2 MAV_BATTERY_CHARGE_STATE_LOW Battery state is low, warn and monitor close.
3 MAV_BATTERY_CHARGE_STATE_CRITICAL Battery state is critical, return or abort immediately.
4 MAV_BATTERY_CHARGE_STATE_EMERGENCY Battery state is too low for ordinary abort sequence. Perform fastest possible emergency stop to prevent damage.
5 MAV_BATTERY_CHARGE_STATE_FAILED Battery failed, damage unavoidable. Possible causes (faults) are listed in MAV_BATTERY_FAULT.
6 MAV_BATTERY_CHARGE_STATE_UNHEALTHY Battery is diagnosed to be defective or an error occurred, usage is discouraged / prohibited. Possible causes (faults) are listed in MAV_BATTERY_FAULT.
7 MAV_BATTERY_CHARGE_STATE_CHARGING Battery is charging.

MAV_BATTERY_MODE

Battery mode. Note, the normal operation mode (i.e. when flying) should be reported as MAV_BATTERY_MODE_UNKNOWN to allow message trimming in normal flight.

Name 描述
0 MAV_BATTERY_MODE_UNKNOWN Battery mode not supported/unknown battery mode/normal operation.
1 MAV_BATTERY_MODE_AUTO_DISCHARGING Battery is auto discharging (towards storage level).
2 MAV_BATTERY_MODE_HOT_SWAP Battery in hot-swap mode (current limited to prevent spikes that might damage sensitive electrical circuits).

MAV_BATTERY_FAULT

(Bitmask) Smart battery supply status/fault flags (bitmask) for health indication. The battery must also report either MAV_BATTERY_CHARGE_STATE_FAILED or MAV_BATTERY_CHARGE_STATE_UNHEALTHY if any of these are set.

Name 描述
1 MAV_BATTERY_FAULT_DEEP_DISCHARGE Battery has deep discharged.
2 MAV_BATTERY_FAULT_SPIKES Voltage spikes.
4 MAV_BATTERY_FAULT_CELL_FAIL One or more cells have failed. Battery should also report MAV_BATTERY_CHARGE_STATE_FAILE (and should not be used).
8 MAV_BATTERY_FAULT_OVER_CURRENT Over-current fault.
16 MAV_BATTERY_FAULT_OVER_TEMPERATURE Over-temperature fault.
32 MAV_BATTERY_FAULT_UNDER_TEMPERATURE Under-temperature fault.
64 MAV_BATTERY_FAULT_INCOMPATIBLE_VOLTAGE Vehicle voltage is not compatible with this battery (batteries on same power rail should have similar voltage).
128 MAV_BATTERY_FAULT_INCOMPATIBLE_FIRMWARE Battery firmware is not compatible with current autopilot firmware.
256 BATTERY_FAULT_INCOMPATIBLE_CELLS_CONFIGURATION Battery is not compatible due to cell configuration (e.g. 5s1p when vehicle requires 6s).

MAV_FUEL_TYPE

Fuel types for use in FUEL_TYPE. Fuel types specify the units for the maximum, available and consumed fuel, and for the flow rates.

Name 描述
0 MAV_FUEL_TYPE_UNKNOWN Not specified. Fuel levels are normalized (i.e. maximum is 1, and other levels are relative to 1).
1 MAV_FUEL_TYPE_LIQUID A generic liquid fuel. Fuel levels are in millilitres (ml). Fuel rates are in millilitres/second.
2 MAV_FUEL_TYPE_GAS A gas tank. Fuel levels are in kilo-Pascal (kPa), and flow rates are in milliliters per second (ml/s).

MAV_GENERATOR_STATUS_FLAG

(Bitmask) Flags to report status/failure cases for a power generator (used in GENERATOR_STATUS). Note that FAULTS are conditions that cause the generator to fail. Warnings are conditions that require attention before the next use (they indicate the system is not operating properly).

Name 描述
1 MAV_GENERATOR_STATUS_FLAG_OFF Generator is off.
2 MAV_GENERATOR_STATUS_FLAG_READY Generator is ready to start generating power.
4 MAV_GENERATOR_STATUS_FLAG_GENERATING Generator is generating power.
8 MAV_GENERATOR_STATUS_FLAG_CHARGING Generator is charging the batteries (generating enough power to charge and provide the load).
16 MAV_GENERATOR_STATUS_FLAG_REDUCED_POWER Generator is operating at a reduced maximum power.
32 MAV_GENERATOR_STATUS_FLAG_MAXPOWER Generator is providing the maximum output.
64 MAV_GENERATOR_STATUS_FLAG_OVERTEMP_WARNING Generator is near the maximum operating temperature, cooling is insufficient.
128 MAV_GENERATOR_STATUS_FLAG_OVERTEMP_FAULT Generator hit the maximum operating temperature and shutdown.
256 MAV_GENERATOR_STATUS_FLAG_ELECTRONICS_OVERTEMP_WARNING Power electronics are near the maximum operating temperature, cooling is insufficient.
512 MAV_GENERATOR_STATUS_FLAG_ELECTRONICS_OVERTEMP_FAULT Power electronics hit the maximum operating temperature and shutdown.
1024 MAV_GENERATOR_STATUS_FLAG_ELECTRONICS_FAULT Power electronics experienced a fault and shutdown.
2048 MAV_GENERATOR_STATUS_FLAG_POWERSOURCE_FAULT The power source supplying the generator failed e.g. mechanical generator stopped, tether is no longer providing power, solar cell is in shade, hydrogen reaction no longer happening.
4096 MAV_GENERATOR_STATUS_FLAG_COMMUNICATION_WARNING Generator controller having communication problems.
8192 MAV_GENERATOR_STATUS_FLAG_COOLING_WARNING Power electronic or generator cooling system error.
16384 MAV_GENERATOR_STATUS_FLAG_POWER_RAIL_FAULT Generator controller power rail experienced a fault.
32768 MAV_GENERATOR_STATUS_FLAG_OVERCURRENT_FAULT Generator controller exceeded the overcurrent threshold and shutdown to prevent damage.
65536 MAV_GENERATOR_STATUS_FLAG_BATTERY_OVERCHARGE_CURRENT_FAULT Generator controller detected a high current going into the batteries and shutdown to prevent battery damage.
131072 MAV_GENERATOR_STATUS_FLAG_OVERVOLTAGE_FAULT Generator controller exceeded it's overvoltage threshold and shutdown to prevent it exceeding the voltage rating.
262144 MAV_GENERATOR_STATUS_FLAG_BATTERY_UNDERVOLT_FAULT Batteries are under voltage (generator will not start).
524288 MAV_GENERATOR_STATUS_FLAG_START_INHIBITED Generator start is inhibited by e.g. a safety switch.
1048576 MAV_GENERATOR_STATUS_FLAG_MAINTENANCE_REQUIRED Generator requires maintenance.
2097152 MAV_GENERATOR_STATUS_FLAG_WARMING_UP Generator is not ready to generate yet.
4194304 MAV_GENERATOR_STATUS_FLAG_IDLE Generator is idle.

MAV_VTOL_STATE

Enumeration of VTOL states

Name 描述
0 MAV_VTOL_STATE_UNDEFINED MAV is not configured as VTOL
1 MAV_VTOL_STATE_TRANSITION_TO_FW VTOL is in transition from multicopter to fixed-wing
2 MAV_VTOL_STATE_TRANSITION_TO_MC VTOL is in transition from fixed-wing to multicopter
3 MAV_VTOL_STATE_MC VTOL is in multicopter state
4 MAV_VTOL_STATE_FW VTOL is in fixed-wing state

MAV_LANDED_STATE

Enumeration of landed detector states

Name 描述
0 MAV_LANDED_STATE_UNDEFINED MAV landed state is unknown
1 MAV_LANDED_STATE_ON_GROUND MAV is landed (on ground)
2 MAV_LANDED_STATE_IN_AIR MAV is in air
3 MAV_LANDED_STATE_TAKEOFF MAV currently taking off
4 MAV_LANDED_STATE_LANDING MAV currently landing

ADSB_ALTITUDE_TYPE

Enumeration of the ADSB altimeter types

Name 描述
0 ADSB_ALTITUDE_TYPE_PRESSURE_QNH Altitude reported from a Baro source using QNH reference
1 ADSB_ALTITUDE_TYPE_GEOMETRIC Altitude reported from a GNSS source

ADSB_EMITTER_TYPE

ADSB classification for the type of vehicle emitting the transponder signal

Name 描述
0 ADSB_EMITTER_TYPE_NO_INFO
1 ADSB_EMITTER_TYPE_LIGHT
2 ADSB_EMITTER_TYPE_SMALL
3 ADSB_EMITTER_TYPE_LARGE
4 ADSB_EMITTER_TYPE_HIGH_VORTEX_LARGE
5 ADSB_EMITTER_TYPE_HEAVY
6 ADSB_EMITTER_TYPE_HIGHLY_MANUV
7 ADSB_EMITTER_TYPE_ROTOCRAFT
8 ADSB_EMITTER_TYPE_UNASSIGNED
9 ADSB_EMITTER_TYPE_GLIDER
10 ADSB_EMITTER_TYPE_LIGHTER_AIR
11 ADSB_EMITTER_TYPE_PARACHUTE
12 ADSB_EMITTER_TYPE_ULTRA_LIGHT
13 ADSB_EMITTER_TYPE_UNASSIGNED2
14 ADSB_EMITTER_TYPE_UAV
15 ADSB_EMITTER_TYPE_SPACE
16 ADSB_EMITTER_TYPE_UNASSGINED3
17 ADSB_EMITTER_TYPE_EMERGENCY_SURFACE
18 ADSB_EMITTER_TYPE_SERVICE_SURFACE
19 ADSB_EMITTER_TYPE_POINT_OBSTACLE

ADSB_FLAGS

(Bitmask) These flags indicate status such as data validity of each data source. Set = data valid

Name 描述
1 ADSB_FLAGS_VALID_COORDS
2 ADSB_FLAGS_VALID_ALTITUDE
4 ADSB_FLAGS_VALID_HEADING
8 ADSB_FLAGS_VALID_VELOCITY
16 ADSB_FLAGS_VALID_CALLSIGN
32 ADSB_FLAGS_VALID_SQUAWK
64 ADSB_FLAGS_SIMULATED
128 ADSB_FLAGS_VERTICAL_VELOCITY_VALID
256 ADSB_FLAGS_BARO_VALID
32768 ADSB_FLAGS_SOURCE_UAT

MAV_DO_REPOSITION_FLAGS

(Bitmask) Bitmap of options for the MAV_CMD_DO_REPOSITION

Name 描述
1 MAV_DO_REPOSITION_FLAGS_CHANGE_MODE The aircraft should immediately transition into guided. This should not be set for follow me applications
2 MAV_DO_REPOSITION_FLAGS_RELATIVE_YAW Yaw relative to the vehicle current heading (if not set, relative to North).

SPEED_TYPE

Speed setpoint types used in MAV_CMD_DO_CHANGE_SPEED

Name 描述
0 SPEED_TYPE_AIRSPEED Airspeed
1 SPEED_TYPE_GROUNDSPEED Groundspeed
2 SPEED_TYPE_CLIMB_SPEED Climb speed
3 SPEED_TYPE_DESCENT_SPEED Descent speed

HEADING_TYPE

Heading setpoint types used in MAV_CMD_GUIDED_CHANGE_HEADING

Name 描述
0 HEADING_TYPE_COURSE_OVER_GROUND Course over ground.
1 HEADING_TYPE_HEADING Raw vehicle heading.
2 HEADING_TYPE_DEFAULT Default heading.

ESTIMATOR_STATUS_FLAGS

(Bitmask) Flags in ESTIMATOR_STATUS message

Name 描述
1 ESTIMATOR_ATTITUDE True if the attitude estimate is good
2 ESTIMATOR_VELOCITY_HORIZ True if the horizontal velocity estimate is good
4 ESTIMATOR_VELOCITY_VERT True if the vertical velocity estimate is good
8 ESTIMATOR_POS_HORIZ_REL True if the horizontal position (relative) estimate is good
16 ESTIMATOR_POS_HORIZ_ABS True if the horizontal position (absolute) estimate is good
32 ESTIMATOR_POS_VERT_ABS True if the vertical position (absolute) estimate is good
64 ESTIMATOR_POS_VERT_AGL True if the vertical position (above ground) estimate is good
128 ESTIMATOR_CONST_POS_MODE True if the EKF is in a constant position mode and is not using external measurements (eg GPS or optical flow)
256 ESTIMATOR_PRED_POS_HORIZ_REL True if the EKF has sufficient data to enter a mode that will provide a (relative) position estimate
512 ESTIMATOR_PRED_POS_HORIZ_ABS True if the EKF has sufficient data to enter a mode that will provide a (absolute) position estimate
1024 ESTIMATOR_GPS_GLITCH True if the EKF has detected a GPS glitch
2048 ESTIMATOR_ACCEL_ERROR True if the EKF has detected bad accelerometer data

MOTOR_TEST_ORDER

Sequence that motors are tested when using MAV_CMD_DO_MOTOR_TEST.

Name 描述
0 MOTOR_TEST_ORDER_DEFAULT Default autopilot motor test method.
1 MOTOR_TEST_ORDER_SEQUENCE Motor numbers are specified as their index in a predefined vehicle-specific sequence.
2 MOTOR_TEST_ORDER_BOARD Motor numbers are specified as the output as labeled on the board.

MOTOR_TEST_THROTTLE_TYPE

Defines how throttle value is represented in MAV_CMD_DO_MOTOR_TEST.

Name 描述
0 MOTOR_TEST_THROTTLE_PERCENT Throttle as a percentage (0 ~ 100)
1 MOTOR_TEST_THROTTLE_PWM Throttle as an absolute PWM value (normally in range of 1000~2000).
2 MOTOR_TEST_THROTTLE_PILOT Throttle pass-through from pilot's transmitter.
3 MOTOR_TEST_COMPASS_CAL Per-motor compass calibration test.

GPS_INPUT_IGNORE_FLAGS

(Bitmask)

Name 描述
1 GPS_INPUT_IGNORE_FLAG_ALT ignore altitude field
2 GPS_INPUT_IGNORE_FLAG_HDOP ignore hdop field
4 GPS_INPUT_IGNORE_FLAG_VDOP ignore vdop field
8 GPS_INPUT_IGNORE_FLAG_VEL_HORIZ ignore horizontal velocity field (vn and ve)
16 GPS_INPUT_IGNORE_FLAG_VEL_VERT ignore vertical velocity field (vd)
32 GPS_INPUT_IGNORE_FLAG_SPEED_ACCURACY ignore speed accuracy field
64 GPS_INPUT_IGNORE_FLAG_HORIZONTAL_ACCURACY ignore horizontal accuracy field
128 GPS_INPUT_IGNORE_FLAG_VERTICAL_ACCURACY ignore vertical accuracy field

MAV_COLLISION_ACTION

Possible actions an aircraft can take to avoid a collision.

Name 描述
0 MAV_COLLISION_ACTION_NONE Ignore any potential collisions
1 MAV_COLLISION_ACTION_REPORT Report potential collision
2 MAV_COLLISION_ACTION_ASCEND_OR_DESCEND Ascend or Descend to avoid threat
3 MAV_COLLISION_ACTION_MOVE_HORIZONTALLY Move horizontally to avoid threat
4 MAV_COLLISION_ACTION_MOVE_PERPENDICULAR Aircraft to move perpendicular to the collision's velocity vector
5 MAV_COLLISION_ACTION_RTL Aircraft to fly directly back to its launch point
6 MAV_COLLISION_ACTION_HOVER Aircraft to stop in place

MAV_COLLISION_THREAT_LEVEL

Aircraft-rated danger from this threat.

Name 描述
0 MAV_COLLISION_THREAT_LEVEL_NONE Not a threat
1 MAV_COLLISION_THREAT_LEVEL_LOW Craft is mildly concerned about this threat
2 MAV_COLLISION_THREAT_LEVEL_HIGH Craft is panicking, and may take actions to avoid threat

MAV_COLLISION_SRC

Source of information about this collision.

Name 描述
0 MAV_COLLISION_SRC_ADSB ID field references ADSB_VEHICLE packets
1 MAV_COLLISION_SRC_MAVLINK_GPS_GLOBAL_INT ID field references MAVLink SRC ID

GPS_FIX_TYPE

Type of GPS fix

Name 描述
0 GPS_FIX_TYPE_NO_GPS No GPS connected
1 GPS_FIX_TYPE_NO_FIX No position information, GPS is connected
2 GPS_FIX_TYPE_2D_FIX 2D position
3 GPS_FIX_TYPE_3D_FIX 3D position
4 GPS_FIX_TYPE_DGPS DGPS/SBAS aided 3D position
5 GPS_FIX_TYPE_RTK_FLOAT RTK float, 3D position
6 GPS_FIX_TYPE_RTK_FIXED RTK Fixed, 3D position
7 GPS_FIX_TYPE_STATIC Static fixed, typically used for base stations
8 GPS_FIX_TYPE_PPP PPP, 3D position.

RTK_BASELINE_COORDINATE_SYSTEM

RTK GPS baseline coordinate system, used for RTK corrections

Name 描述
0 RTK_BASELINE_COORDINATE_SYSTEM_ECEF Earth-centered, Earth-fixed
1 RTK_BASELINE_COORDINATE_SYSTEM_NED RTK basestation centered, north, east, down

LANDING_TARGET_TYPE

Type of landing target

Name 描述
0 LANDING_TARGET_TYPE_LIGHT_BEACON Landing target signaled by light beacon (ex: IR-LOCK)
1 LANDING_TARGET_TYPE_RADIO_BEACON Landing target signaled by radio beacon (ex: ILS, NDB)
2 LANDING_TARGET_TYPE_VISION_FIDUCIAL Landing target represented by a fiducial marker (ex: ARTag)
3 LANDING_TARGET_TYPE_VISION_OTHER Landing target represented by a pre-defined visual shape/feature (ex: X-marker, H-marker, square)

VTOL_TRANSITION_HEADING

Direction of VTOL transition

Name 描述
0 VTOL_TRANSITION_HEADING_VEHICLE_DEFAULT Respect the heading configuration of the vehicle.
1 VTOL_TRANSITION_HEADING_NEXT_WAYPOINT Use the heading pointing towards the next waypoint.
2 VTOL_TRANSITION_HEADING_TAKEOFF Use the heading on takeoff (while sitting on the ground).
3 VTOL_TRANSITION_HEADING_SPECIFIED Use the specified heading in parameter 4.
4 VTOL_TRANSITION_HEADING_ANY Use the current heading when reaching takeoff altitude (potentially facing the wind when weather-vaning is active).

CAMERA_CAP_FLAGS

(Bitmask) Camera capability flags (Bitmap)

Name 描述
1 CAMERA_CAP_FLAGS_CAPTURE_VIDEO Camera is able to record video
2 CAMERA_CAP_FLAGS_CAPTURE_IMAGE Camera is able to capture images
4 CAMERA_CAP_FLAGS_HAS_MODES Camera has separate Video and Image/Photo modes (MAV_CMD_SET_CAMERA_MODE)
8 CAMERA_CAP_FLAGS_CAN_CAPTURE_IMAGE_IN_VIDEO_MODE Camera can capture images while in video mode
16 CAMERA_CAP_FLAGS_CAN_CAPTURE_VIDEO_IN_IMAGE_MODE Camera can capture videos while in Photo/Image mode
32 CAMERA_CAP_FLAGS_HAS_IMAGE_SURVEY_MODE Camera has image survey mode (MAV_CMD_SET_CAMERA_MODE)
64 CAMERA_CAP_FLAGS_HAS_BASIC_ZOOM Camera has basic zoom control (MAV_CMD_SET_CAMERA_ZOOM)
128 CAMERA_CAP_FLAGS_HAS_BASIC_FOCUS Camera has basic focus control (MAV_CMD_SET_CAMERA_FOCUS)
256 CAMERA_CAP_FLAGS_HAS_VIDEO_STREAM Camera has video streaming capabilities (request VIDEO_STREAM_INFORMATION with MAV_CMD_REQUEST_MESSAGE for video streaming info)
512 CAMERA_CAP_FLAGS_HAS_TRACKING_POINT Camera supports tracking of a point on the camera view.
1024 CAMERA_CAP_FLAGS_HAS_TRACKING_RECTANGLE Camera supports tracking of a selection rectangle on the camera view.
2048 CAMERA_CAP_FLAGS_HAS_TRACKING_GEO_STATUS Camera supports tracking geo status (CAMERA_TRACKING_GEO_STATUS).
4096 CAMERA_CAP_FLAGS_HAS_THERMAL_RANGE Camera supports absolute thermal range (request CAMERA_THERMAL_RANGE with MAV_CMD_REQUEST_MESSAGE).
8192 CAMERA_CAP_FLAGS_HAS_MTI Camera supports Moving Target Indicators (MTI) on the camera view (using MAV_CMD_CAMERA_START_MTI).
WORK IN PROGRESS: Do not use in stable production environments (it may change).

VIDEO_STREAM_STATUS_FLAGS

(Bitmask) Stream status flags (Bitmap)

Name 描述
1 VIDEO_STREAM_STATUS_FLAGS_RUNNING Stream is active (running)
2 VIDEO_STREAM_STATUS_FLAGS_THERMAL Stream is thermal imaging
4 VIDEO_STREAM_STATUS_FLAGS_THERMAL_RANGE_ENABLED Stream can report absolute thermal range (see CAMERA_THERMAL_RANGE).

VIDEO_STREAM_TYPE

Video stream types

Name 描述
0 VIDEO_STREAM_TYPE_RTSP Stream is RTSP
1 VIDEO_STREAM_TYPE_RTPUDP Stream is RTP UDP (URI gives the port number)
2 VIDEO_STREAM_TYPE_TCP_MPEG Stream is MPEG on TCP
3 VIDEO_STREAM_TYPE_MPEG_TS Stream is MPEG TS (URI gives the port number)
4 VIDEO_STREAM_TYPE_WHEP Stream is WHEP (WebRTC-HTTP Egress Protocol)

VIDEO_STREAM_ENCODING

Video stream encodings

Name 描述
0 VIDEO_STREAM_ENCODING_UNKNOWN Stream encoding is unknown
1 VIDEO_STREAM_ENCODING_H264 Stream encoding is H.264
2 VIDEO_STREAM_ENCODING_H265 Stream encoding is H.265

CAMERA_TRACKING_STATUS_FLAGS

(Bitmask) Camera tracking status flags

Name 描述
0 CAMERA_TRACKING_STATUS_FLAGS_IDLE Camera is not tracking
1 CAMERA_TRACKING_STATUS_FLAGS_ACTIVE Camera is tracking
2 CAMERA_TRACKING_STATUS_FLAGS_ERROR Camera tracking in error state
4 CAMERA_TRACKING_STATUS_FLAGS_MTI Camera Moving Target Indicators (MTI) are active
WORK IN PROGRESS: Do not use in stable production environments (it may change).
8 CAMERA_TRACKING_STATUS_FLAGS_COASTING Camera tracking target is obscured and is being predicted
WORK IN PROGRESS: Do not use in stable production environments (it may change).

CAMERA_TRACKING_MODE

Camera tracking modes

Name 描述
0 CAMERA_TRACKING_MODE_NONE Not tracking
1 CAMERA_TRACKING_MODE_POINT Target is a point
2 CAMERA_TRACKING_MODE_RECTANGLE Target is a rectangle

CAMERA_TRACKING_TARGET_DATA

(Bitmask) Camera tracking target data (shows where tracked target is within image)

Name 描述
1 CAMERA_TRACKING_TARGET_DATA_EMBEDDED Target data embedded in image data (proprietary)
2 CAMERA_TRACKING_TARGET_DATA_RENDERED Target data rendered in image
4 CAMERA_TRACKING_TARGET_DATA_IN_STATUS Target data within status message (Point or Rectangle)

CAMERA_ZOOM_TYPE

Zoom types for MAV_CMD_SET_CAMERA_ZOOM

Name 描述
0 ZOOM_TYPE_STEP Zoom one step increment (-1 for wide, 1 for tele)
1 ZOOM_TYPE_CONTINUOUS Continuous normalized zoom in/out rate until stopped. Range -1..1, negative: wide, positive: narrow/tele, 0 to stop zooming. Other values should be clipped to the range.
2 ZOOM_TYPE_RANGE Zoom value as proportion of full camera range (a percentage value between 0.0 and 100.0)
3 ZOOM_TYPE_FOCAL_LENGTH Zoom value/variable focal length in millimetres. Note that there is no message to get the valid zoom range of the camera, so this can type can only be used for cameras where the zoom range is known (implying that this cannot reliably be used in a GCS for an arbitrary camera)
4 ZOOM_TYPE_HORIZONTAL_FOV Zoom value as horizontal field of view in degrees.

SET_FOCUS_TYPE

Focus types for MAV_CMD_SET_CAMERA_FOCUS

Name 描述
0 FOCUS_TYPE_STEP Focus one step increment (-1 for focusing in, 1 for focusing out towards infinity).
1 FOCUS_TYPE_CONTINUOUS Continuous normalized focus in/out rate until stopped. Range -1..1, negative: in, positive: out towards infinity, 0 to stop focusing. Other values should be clipped to the range.
2 FOCUS_TYPE_RANGE Focus value as proportion of full camera focus range (a value between 0.0 and 100.0)
3 FOCUS_TYPE_METERS Focus value in metres. Note that there is no message to get the valid focus range of the camera, so this can type can only be used for cameras where the range is known (implying that this cannot reliably be used in a GCS for an arbitrary camera).
4 FOCUS_TYPE_AUTO Focus automatically.
5 FOCUS_TYPE_AUTO_SINGLE Single auto focus. Mainly used for still pictures. Usually abbreviated as AF-S.
6 FOCUS_TYPE_AUTO_CONTINUOUS Continuous auto focus. Mainly used for dynamic scenes. Abbreviated as AF-C.

CAMERA_SOURCE

Camera sources for MAV_CMD_SET_CAMERA_SOURCE

Name 描述
0 CAMERA_SOURCE_DEFAULT Default camera source.
1 CAMERA_SOURCE_RGB RGB camera source.
2 CAMERA_SOURCE_IR IR camera source.
3 CAMERA_SOURCE_NDVI NDVI camera source.

PARAM_ACK

Result from PARAM_EXT_SET message.

Name 描述
0 PARAM_ACK_ACCEPTED Parameter value ACCEPTED and SET
1 PARAM_ACK_VALUE_UNSUPPORTED Parameter value UNKNOWN/UNSUPPORTED
2 PARAM_ACK_FAILED Parameter failed to set
3 PARAM_ACK_IN_PROGRESS Parameter value received but not yet set/accepted. A subsequent PARAM_EXT_ACK with the final result will follow once operation is completed. This is returned immediately for parameters that take longer to set, indicating that the the parameter was received and does not need to be resent.

CAMERA_MODE

Camera Modes.

Name 描述
0 CAMERA_MODE_IMAGE Camera is in image/photo capture mode.
1 CAMERA_MODE_VIDEO Camera is in video capture mode.
2 CAMERA_MODE_IMAGE_SURVEY Camera is in image survey capture mode. It allows for camera controller to do specific settings for surveys.

MAV_ARM_AUTH_DENIED_REASON

Reasons for denying an authorization request made with MAV_CMD_ARM_AUTHORIZATION_REQUEST. If the COMMAND_ACK result is MAV_RESULT_DENIED, this is used to set the reason in the result_param2 field.

Name 描述
0 MAV_ARM_AUTH_DENIED_REASON_GENERIC Not a specific reason
1 MAV_ARM_AUTH_DENIED_REASON_NONE Authorizer will send the error as string to GCS
2 MAV_ARM_AUTH_DENIED_REASON_INVALID_WAYPOINT At least one waypoint have a invalid value
3 MAV_ARM_AUTH_DENIED_REASON_TIMEOUT Timeout in the authorizer process(in case it depends on network)
4 MAV_ARM_AUTH_DENIED_REASON_AIRSPACE_IN_USE Airspace of the mission in use by another vehicle, second result parameter can have the waypoint id that caused it to be denied.
5 MAV_ARM_AUTH_DENIED_REASON_BAD_WEATHER Weather is not good to fly

RC_TYPE

RC type. Used in MAV_CMD_START_RX_PAIR.

Name 描述
0 RC_TYPE_SPEKTRUM Spektrum
1 RC_TYPE_CRSF CRSF

RC_SUB_TYPE

RC sub-type of types defined in RC_TYPE. Used in MAV_CMD_START_RX_PAIR. Ignored if value does not correspond to the set RC_TYPE.

Name 描述
0 RC_SUB_TYPE_SPEKTRUM_DSM2 Spektrum DSM2
1 RC_SUB_TYPE_SPEKTRUM_DSMX Spektrum DSMX
2 RC_SUB_TYPE_SPEKTRUM_DSMX8 Spektrum DSMX8

ENGINE_CONTROL_OPTIONS

(Bitmask) Engine control options

Name 描述
1 ENGINE_CONTROL_OPTIONS_ALLOW_START_WHILE_DISARMED Allow starting the engine while disarmed (without changing the vehicle's armed state). This effectively arms just the ICE, without arming the vehicle to start other motors or propellers.

POSITION_TARGET_TYPEMASK

(Bitmask) Bitmap to indicate which dimensions should be ignored by the vehicle: a value of 0b0000000000000000 or 0b0000001000000000 indicates that none of the setpoint dimensions should be ignored. If bit 9 is set the floats afx afy afz should be interpreted as force instead of acceleration.

Name 描述
1 POSITION_TARGET_TYPEMASK_X_IGNORE Ignore position x
2 POSITION_TARGET_TYPEMASK_Y_IGNORE Ignore position y
4 POSITION_TARGET_TYPEMASK_Z_IGNORE Ignore position z
8 POSITION_TARGET_TYPEMASK_VX_IGNORE Ignore velocity x
16 POSITION_TARGET_TYPEMASK_VY_IGNORE Ignore velocity y
32 POSITION_TARGET_TYPEMASK_VZ_IGNORE Ignore velocity z
64 POSITION_TARGET_TYPEMASK_AX_IGNORE Ignore acceleration x
128 POSITION_TARGET_TYPEMASK_AY_IGNORE Ignore acceleration y
256 POSITION_TARGET_TYPEMASK_AZ_IGNORE Ignore acceleration z
512 POSITION_TARGET_TYPEMASK_FORCE_SET Use force instead of acceleration
1024 POSITION_TARGET_TYPEMASK_YAW_IGNORE Ignore yaw
2048 POSITION_TARGET_TYPEMASK_YAW_RATE_IGNORE Ignore yaw rate

ATTITUDE_TARGET_TYPEMASK

(Bitmask) Bitmap to indicate which dimensions should be ignored by the vehicle: a value of 0b00000000 indicates that none of the setpoint dimensions should be ignored.

Name 描述
1 ATTITUDE_TARGET_TYPEMASK_BODY_ROLL_RATE_IGNORE Ignore body roll rate
2 ATTITUDE_TARGET_TYPEMASK_BODY_PITCH_RATE_IGNORE Ignore body pitch rate
4 ATTITUDE_TARGET_TYPEMASK_BODY_YAW_RATE_IGNORE Ignore body yaw rate
32 ATTITUDE_TARGET_TYPEMASK_THRUST_BODY_SET Use 3D body thrust setpoint instead of throttle
64 ATTITUDE_TARGET_TYPEMASK_THROTTLE_IGNORE Ignore throttle
128 ATTITUDE_TARGET_TYPEMASK_ATTITUDE_IGNORE Ignore attitude

UTM_FLIGHT_STATE

Airborne status of UAS.

Name 描述
1 UTM_FLIGHT_STATE_UNKNOWN The flight state can't be determined.
2 UTM_FLIGHT_STATE_GROUND UAS on ground.
3 UTM_FLIGHT_STATE_AIRBORNE UAS airborne.
16 UTM_FLIGHT_STATE_EMERGENCY UAS is in an emergency flight state.
32 UTM_FLIGHT_STATE_NOCTRL UAS has no active controls.

UTM_DATA_AVAIL_FLAGS

(Bitmask) Flags for the global position report.

Name 描述
1 UTM_DATA_AVAIL_FLAGS_TIME_VALID The field time contains valid data.
2 UTM_DATA_AVAIL_FLAGS_UAS_ID_AVAILABLE The field uas_id contains valid data.
4 UTM_DATA_AVAIL_FLAGS_POSITION_AVAILABLE The fields lat, lon and h_acc contain valid data.
8 UTM_DATA_AVAIL_FLAGS_ALTITUDE_AVAILABLE The fields alt and v_acc contain valid data.
16 UTM_DATA_AVAIL_FLAGS_RELATIVE_ALTITUDE_AVAILABLE The field relative_alt contains valid data.
32 UTM_DATA_AVAIL_FLAGS_HORIZONTAL_VELO_AVAILABLE The fields vx and vy contain valid data.
64 UTM_DATA_AVAIL_FLAGS_VERTICAL_VELO_AVAILABLE The field vz contains valid data.
128 UTM_DATA_AVAIL_FLAGS_NEXT_WAYPOINT_AVAILABLE The fields next_lat, next_lon and next_alt contain valid data.

CELLULAR_STATUS_FLAG

These flags encode the cellular network status

Name 描述
0 CELLULAR_STATUS_FLAG_UNKNOWN State unknown or not reportable.
1 CELLULAR_STATUS_FLAG_FAILED Modem is unusable
2 CELLULAR_STATUS_FLAG_INITIALIZING Modem is being initialized
3 CELLULAR_STATUS_FLAG_LOCKED Modem is locked
4 CELLULAR_STATUS_FLAG_DISABLED Modem is not enabled and is powered down
5 CELLULAR_STATUS_FLAG_DISABLING Modem is currently transitioning to the CELLULAR_STATUS_FLAG_DISABLED state
6 CELLULAR_STATUS_FLAG_ENABLING Modem is currently transitioning to the CELLULAR_STATUS_FLAG_ENABLED state
7 CELLULAR_STATUS_FLAG_ENABLED Modem is enabled and powered on but not registered with a network provider and not available for data connections
8 CELLULAR_STATUS_FLAG_SEARCHING Modem is searching for a network provider to register
9 CELLULAR_STATUS_FLAG_REGISTERED Modem is registered with a network provider, and data connections and messaging may be available for use
10 CELLULAR_STATUS_FLAG_DISCONNECTING Modem is disconnecting and deactivating the last active packet data bearer. This state will not be entered if more than one packet data bearer is active and one of the active bearers is deactivated
11 CELLULAR_STATUS_FLAG_CONNECTING Modem is activating and connecting the first packet data bearer. Subsequent bearer activations when another bearer is already active do not cause this state to be entered
12 CELLULAR_STATUS_FLAG_CONNECTED One or more packet data bearers is active and connected

CELLULAR_NETWORK_FAILED_REASON

These flags are used to diagnose the failure state of CELLULAR_STATUS

Name 描述
0 CELLULAR_NETWORK_FAILED_REASON_NONE No error
1 CELLULAR_NETWORK_FAILED_REASON_UNKNOWN Error state is unknown
2 CELLULAR_NETWORK_FAILED_REASON_SIM_MISSING SIM is required for the modem but missing
3 CELLULAR_NETWORK_FAILED_REASON_SIM_ERROR SIM is available, but not usable for connection

CELLULAR_NETWORK_RADIO_TYPE

Cellular network radio type

Name 描述
0 CELLULAR_NETWORK_RADIO_TYPE_NONE
1 CELLULAR_NETWORK_RADIO_TYPE_GSM
2 CELLULAR_NETWORK_RADIO_TYPE_CDMA
3 CELLULAR_NETWORK_RADIO_TYPE_WCDMA
4 CELLULAR_NETWORK_RADIO_TYPE_LTE

PRECISION_LAND_MODE

Precision land modes (used in MAV_CMD_NAV_LAND).

Name 描述
0 PRECISION_LAND_MODE_DISABLED Normal (non-precision) landing.
1 PRECISION_LAND_MODE_OPPORTUNISTIC Use precision landing if beacon detected when land command accepted, otherwise land normally.
2 PRECISION_LAND_MODE_REQUIRED Use precision landing, searching for beacon if not found when land command accepted (land normally if beacon cannot be found).

PARACHUTE_ACTION

Parachute actions. Trigger release and enable/disable auto-release.

Name 描述
0 PARACHUTE_DISABLE Disable auto-release of parachute (i.e. release triggered by crash detectors).
1 PARACHUTE_ENABLE Enable auto-release of parachute.
2 PARACHUTE_RELEASE Release parachute and kill motors.

MAV_TUNNEL_PAYLOAD_TYPE

Name 描述
0 MAV_TUNNEL_PAYLOAD_TYPE_UNKNOWN Encoding of payload unknown.
200 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED0 Registered for STorM32 gimbal controller.
201 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED1 Registered for STorM32 gimbal controller.
202 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED2 Registered for STorM32 gimbal controller.
203 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED3 Registered for STorM32 gimbal controller.
204 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED4 Registered for STorM32 gimbal controller.
205 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED5 Registered for STorM32 gimbal controller.
206 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED6 Registered for STorM32 gimbal controller.
207 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED7 Registered for STorM32 gimbal controller.
208 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED8 Registered for STorM32 gimbal controller.
209 MAV_TUNNEL_PAYLOAD_TYPE_STORM32_RESERVED9 Registered for STorM32 gimbal controller.
210 MAV_TUNNEL_PAYLOAD_TYPE_MODALAI_REMOTE_OSD Registered for ModalAI remote OSD protocol.
211 MAV_TUNNEL_PAYLOAD_TYPE_MODALAI_ESC_UART_PASSTHRU Registered for ModalAI ESC UART passthru protocol.
212 MAV_TUNNEL_PAYLOAD_TYPE_MODALAI_IO_UART_PASSTHRU Registered for ModalAI vendor use.

MAV_ODID_ID_TYPE

Name 描述
0 MAV_ODID_ID_TYPE_NONE No type defined.
1 MAV_ODID_ID_TYPE_SERIAL_NUMBER Manufacturer Serial Number (ANSI/CTA-2063 format).
2 MAV_ODID_ID_TYPE_CAA_REGISTRATION_ID CAA (Civil Aviation Authority) registered ID. Format: [ICAO Country Code].[CAA Assigned ID].
3 MAV_ODID_ID_TYPE_UTM_ASSIGNED_UUID UTM (Unmanned Traffic Management) assigned UUID (RFC4122).
4 MAV_ODID_ID_TYPE_SPECIFIC_SESSION_ID A 20 byte ID for a specific flight/session. The exact ID type is indicated by the first byte of uas_id and these type values are managed by ICAO.

MAV_ODID_UA_TYPE

Name 描述
0 MAV_ODID_UA_TYPE_NONE No UA (Unmanned Aircraft) type defined.
1 MAV_ODID_UA_TYPE_AEROPLANE Aeroplane/Airplane. Fixed wing.
2 MAV_ODID_UA_TYPE_HELICOPTER_OR_MULTIROTOR Helicopter or multirotor.
3 MAV_ODID_UA_TYPE_GYROPLANE Gyroplane.
4 MAV_ODID_UA_TYPE_HYBRID_LIFT VTOL (Vertical Take-Off and Landing). Fixed wing aircraft that can take off vertically.
5 MAV_ODID_UA_TYPE_ORNITHOPTER Ornithopter.
6 MAV_ODID_UA_TYPE_GLIDER Glider.
7 MAV_ODID_UA_TYPE_KITE Kite.
8 MAV_ODID_UA_TYPE_FREE_BALLOON Free Balloon.
9 MAV_ODID_UA_TYPE_CAPTIVE_BALLOON Captive Balloon.
10 MAV_ODID_UA_TYPE_AIRSHIP Airship. E.g. a blimp.
11 MAV_ODID_UA_TYPE_FREE_FALL_PARACHUTE Free Fall/Parachute (unpowered).
12 MAV_ODID_UA_TYPE_ROCKET Rocket.
13 MAV_ODID_UA_TYPE_TETHERED_POWERED_AIRCRAFT Tethered powered aircraft.
14 MAV_ODID_UA_TYPE_GROUND_OBSTACLE Ground Obstacle.
15 MAV_ODID_UA_TYPE_OTHER Other type of aircraft not listed earlier.

MAV_ODID_STATUS

Name 描述
0 MAV_ODID_STATUS_UNDECLARED The status of the (UA) Unmanned Aircraft is undefined.
1 MAV_ODID_STATUS_GROUND The UA is on the ground.
2 MAV_ODID_STATUS_AIRBORNE The UA is in the air.
3 MAV_ODID_STATUS_EMERGENCY The UA is having an emergency.
4 MAV_ODID_STATUS_REMOTE_ID_SYSTEM_FAILURE The remote ID system is failing or unreliable in some way.

MAV_ODID_HEIGHT_REF

Name 描述
0 MAV_ODID_HEIGHT_REF_OVER_TAKEOFF The height field is relative to the take-off location.
1 MAV_ODID_HEIGHT_REF_OVER_GROUND The height field is relative to ground.

MAV_ODID_HOR_ACC

Name 描述
0 MAV_ODID_HOR_ACC_UNKNOWN The horizontal accuracy is unknown.
1 MAV_ODID_HOR_ACC_10NM The horizontal accuracy is smaller than 10 Nautical Miles. 18.52 km.
2 MAV_ODID_HOR_ACC_4NM The horizontal accuracy is smaller than 4 Nautical Miles. 7.408 km.
3 MAV_ODID_HOR_ACC_2NM The horizontal accuracy is smaller than 2 Nautical Miles. 3.704 km.
4 MAV_ODID_HOR_ACC_1NM The horizontal accuracy is smaller than 1 Nautical Miles. 1.852 km.
5 MAV_ODID_HOR_ACC_0_5NM The horizontal accuracy is smaller than 0.5 Nautical Miles. 926 m.
6 MAV_ODID_HOR_ACC_0_3NM The horizontal accuracy is smaller than 0.3 Nautical Miles. 555.6 m.
7 MAV_ODID_HOR_ACC_0_1NM The horizontal accuracy is smaller than 0.1 Nautical Miles. 185.2 m.
8 MAV_ODID_HOR_ACC_0_05NM The horizontal accuracy is smaller than 0.05 Nautical Miles. 92.6 m.
9 MAV_ODID_HOR_ACC_30_METER The horizontal accuracy is smaller than 30 meter.
10 MAV_ODID_HOR_ACC_10_METER The horizontal accuracy is smaller than 10 meter.
11 MAV_ODID_HOR_ACC_3_METER The horizontal accuracy is smaller than 3 meter.
12 MAV_ODID_HOR_ACC_1_METER The horizontal accuracy is smaller than 1 meter.

MAV_ODID_VER_ACC

Name 描述
0 MAV_ODID_VER_ACC_UNKNOWN The vertical accuracy is unknown.
1 MAV_ODID_VER_ACC_150_METER The vertical accuracy is smaller than 150 meter.
2 MAV_ODID_VER_ACC_45_METER The vertical accuracy is smaller than 45 meter.
3 MAV_ODID_VER_ACC_25_METER The vertical accuracy is smaller than 25 meter.
4 MAV_ODID_VER_ACC_10_METER The vertical accuracy is smaller than 10 meter.
5 MAV_ODID_VER_ACC_3_METER The vertical accuracy is smaller than 3 meter.
6 MAV_ODID_VER_ACC_1_METER The vertical accuracy is smaller than 1 meter.

MAV_ODID_SPEED_ACC

Name 描述
0 MAV_ODID_SPEED_ACC_UNKNOWN The speed accuracy is unknown.
1 MAV_ODID_SPEED_ACC_10_METERS_PER_SECOND The speed accuracy is smaller than 10 meters per second.
2 MAV_ODID_SPEED_ACC_3_METERS_PER_SECOND The speed accuracy is smaller than 3 meters per second.
3 MAV_ODID_SPEED_ACC_1_METERS_PER_SECOND The speed accuracy is smaller than 1 meters per second.
4 MAV_ODID_SPEED_ACC_0_3_METERS_PER_SECOND The speed accuracy is smaller than 0.3 meters per second.

MAV_ODID_TIME_ACC

Name 描述
0 MAV_ODID_TIME_ACC_UNKNOWN The timestamp accuracy is unknown.
1 MAV_ODID_TIME_ACC_0_1_SECOND The timestamp accuracy is smaller than or equal to 0.1 second.
2 MAV_ODID_TIME_ACC_0_2_SECOND The timestamp accuracy is smaller than or equal to 0.2 second.
3 MAV_ODID_TIME_ACC_0_3_SECOND The timestamp accuracy is smaller than or equal to 0.3 second.
4 MAV_ODID_TIME_ACC_0_4_SECOND The timestamp accuracy is smaller than or equal to 0.4 second.
5 MAV_ODID_TIME_ACC_0_5_SECOND The timestamp accuracy is smaller than or equal to 0.5 second.
6 MAV_ODID_TIME_ACC_0_6_SECOND The timestamp accuracy is smaller than or equal to 0.6 second.
7 MAV_ODID_TIME_ACC_0_7_SECOND The timestamp accuracy is smaller than or equal to 0.7 second.
8 MAV_ODID_TIME_ACC_0_8_SECOND The timestamp accuracy is smaller than or equal to 0.8 second.
9 MAV_ODID_TIME_ACC_0_9_SECOND The timestamp accuracy is smaller than or equal to 0.9 second.
10 MAV_ODID_TIME_ACC_1_0_SECOND The timestamp accuracy is smaller than or equal to 1.0 second.
11 MAV_ODID_TIME_ACC_1_1_SECOND The timestamp accuracy is smaller than or equal to 1.1 second.
12 MAV_ODID_TIME_ACC_1_2_SECOND The timestamp accuracy is smaller than or equal to 1.2 second.
13 MAV_ODID_TIME_ACC_1_3_SECOND The timestamp accuracy is smaller than or equal to 1.3 second.
14 MAV_ODID_TIME_ACC_1_4_SECOND The timestamp accuracy is smaller than or equal to 1.4 second.
15 MAV_ODID_TIME_ACC_1_5_SECOND The timestamp accuracy is smaller than or equal to 1.5 second.

MAV_ODID_AUTH_TYPE

Name 描述
0 MAV_ODID_AUTH_TYPE_NONE No authentication type is specified.
1 MAV_ODID_AUTH_TYPE_UAS_ID_SIGNATURE Signature for the UAS (Unmanned Aircraft System) ID.
2 MAV_ODID_AUTH_TYPE_OPERATOR_ID_SIGNATURE Signature for the Operator ID.
3 MAV_ODID_AUTH_TYPE_MESSAGE_SET_SIGNATURE Signature for the entire message set.
4 MAV_ODID_AUTH_TYPE_NETWORK_REMOTE_ID Authentication is provided by Network Remote ID.
5 MAV_ODID_AUTH_TYPE_SPECIFIC_AUTHENTICATION The exact authentication type is indicated by the first byte of authentication_data and these type values are managed by ICAO.

MAV_ODID_DESC_TYPE

Name 描述
0 MAV_ODID_DESC_TYPE_TEXT Optional free-form text description of the purpose of the flight.
1 MAV_ODID_DESC_TYPE_EMERGENCY Optional additional clarification when status == MAV_ODID_STATUS_EMERGENCY.
2 MAV_ODID_DESC_TYPE_EXTENDED_STATUS Optional additional clarification when status != MAV_ODID_STATUS_EMERGENCY.

MAV_ODID_OPERATOR_LOCATION_TYPE

Name 描述
0 MAV_ODID_OPERATOR_LOCATION_TYPE_TAKEOFF The location/altitude of the operator is the same as the take-off location.
1 MAV_ODID_OPERATOR_LOCATION_TYPE_LIVE_GNSS The location/altitude of the operator is dynamic. E.g. based on live GNSS data.
2 MAV_ODID_OPERATOR_LOCATION_TYPE_FIXED The location/altitude of the operator are fixed values.

MAV_ODID_CLASSIFICATION_TYPE

Name 描述
0 MAV_ODID_CLASSIFICATION_TYPE_UNDECLARED The classification type for the UA is undeclared.
1 MAV_ODID_CLASSIFICATION_TYPE_EU The classification type for the UA follows EU (European Union) specifications.

MAV_ODID_CATEGORY_EU

Name 描述
0 MAV_ODID_CATEGORY_EU_UNDECLARED The category for the UA, according to the EU specification, is undeclared.
1 MAV_ODID_CATEGORY_EU_OPEN The category for the UA, according to the EU specification, is the Open category.
2 MAV_ODID_CATEGORY_EU_SPECIFIC The category for the UA, according to the EU specification, is the Specific category.
3 MAV_ODID_CATEGORY_EU_CERTIFIED The category for the UA, according to the EU specification, is the Certified category.

MAV_ODID_CLASS_EU

Name 描述
0 MAV_ODID_CLASS_EU_UNDECLARED The class for the UA, according to the EU specification, is undeclared.
1 MAV_ODID_CLASS_EU_CLASS_0 The class for the UA, according to the EU specification, is Class 0.
2 MAV_ODID_CLASS_EU_CLASS_1 The class for the UA, according to the EU specification, is Class 1.
3 MAV_ODID_CLASS_EU_CLASS_2 The class for the UA, according to the EU specification, is Class 2.
4 MAV_ODID_CLASS_EU_CLASS_3 The class for the UA, according to the EU specification, is Class 3.
5 MAV_ODID_CLASS_EU_CLASS_4 The class for the UA, according to the EU specification, is Class 4.
6 MAV_ODID_CLASS_EU_CLASS_5 The class for the UA, according to the EU specification, is Class 5.
7 MAV_ODID_CLASS_EU_CLASS_6 The class for the UA, according to the EU specification, is Class 6.

MAV_ODID_OPERATOR_ID_TYPE

Name 描述
0 MAV_ODID_OPERATOR_ID_TYPE_CAA CAA (Civil Aviation Authority) registered operator ID.

MAV_ODID_ARM_STATUS

Name 描述
0 MAV_ODID_ARM_STATUS_GOOD_TO_ARM Passing arming checks.
1 MAV_ODID_ARM_STATUS_PRE_ARM_FAIL_GENERIC Generic arming failure, see error string for details.

TUNE_FORMAT

Tune formats (used for vehicle buzzer/tone generation).

Name 描述
1 TUNE_FORMAT_QBASIC1_1 Format is QBasic 1.1 Play: https://www.qbasic.net/en/reference/qb11/Statement/PLAY-006.htm.
2 TUNE_FORMAT_MML_MODERN Format is Modern Music Markup Language (MML): https://en.wikipedia.org/wiki/Music_Macro_Language#Modern_MML.

AIS_TYPE

Type of AIS vessel, enum duplicated from AIS standard, https://gpsd.gitlab.io/gpsd/AIVDM.html

Name 描述
0 AIS_TYPE_UNKNOWN Not available (default).
1 AIS_TYPE_RESERVED_1
2 AIS_TYPE_RESERVED_2
3 AIS_TYPE_RESERVED_3
4 AIS_TYPE_RESERVED_4
5 AIS_TYPE_RESERVED_5
6 AIS_TYPE_RESERVED_6
7 AIS_TYPE_RESERVED_7
8 AIS_TYPE_RESERVED_8
9 AIS_TYPE_RESERVED_9
10 AIS_TYPE_RESERVED_10
11 AIS_TYPE_RESERVED_11
12 AIS_TYPE_RESERVED_12
13 AIS_TYPE_RESERVED_13
14 AIS_TYPE_RESERVED_14
15 AIS_TYPE_RESERVED_15
16 AIS_TYPE_RESERVED_16
17 AIS_TYPE_RESERVED_17
18 AIS_TYPE_RESERVED_18
19 AIS_TYPE_RESERVED_19
20 AIS_TYPE_WIG Wing In Ground effect.
21 AIS_TYPE_WIG_HAZARDOUS_A
22 AIS_TYPE_WIG_HAZARDOUS_B
23 AIS_TYPE_WIG_HAZARDOUS_C
24 AIS_TYPE_WIG_HAZARDOUS_D
25 AIS_TYPE_WIG_RESERVED_1
26 AIS_TYPE_WIG_RESERVED_2
27 AIS_TYPE_WIG_RESERVED_3
28 AIS_TYPE_WIG_RESERVED_4
29 AIS_TYPE_WIG_RESERVED_5
30 AIS_TYPE_FISHING
31 AIS_TYPE_TOWING
32 AIS_TYPE_TOWING_LARGE Towing: length exceeds 200m or breadth exceeds 25m.
33 AIS_TYPE_DREDGING Dredging or other underwater ops.
34 AIS_TYPE_DIVING
35 AIS_TYPE_MILITARY
36 AIS_TYPE_SAILING
37 AIS_TYPE_PLEASURE
38 AIS_TYPE_RESERVED_20
39 AIS_TYPE_RESERVED_21
40 AIS_TYPE_HSC High Speed Craft.
41 AIS_TYPE_HSC_HAZARDOUS_A
42 AIS_TYPE_HSC_HAZARDOUS_B
43 AIS_TYPE_HSC_HAZARDOUS_C
44 AIS_TYPE_HSC_HAZARDOUS_D
45 AIS_TYPE_HSC_RESERVED_1
46 AIS_TYPE_HSC_RESERVED_2
47 AIS_TYPE_HSC_RESERVED_3
48 AIS_TYPE_HSC_RESERVED_4
49 AIS_TYPE_HSC_UNKNOWN
50 AIS_TYPE_PILOT
51 AIS_TYPE_SAR Search And Rescue vessel.
52 AIS_TYPE_TUG
53 AIS_TYPE_PORT_TENDER
54 AIS_TYPE_ANTI_POLLUTION Anti-pollution equipment.
55 AIS_TYPE_LAW_ENFORCEMENT
56 AIS_TYPE_SPARE_LOCAL_1
57 AIS_TYPE_SPARE_LOCAL_2
58 AIS_TYPE_MEDICAL_TRANSPORT
59 AIS_TYPE_NONECOMBATANT Noncombatant ship according to RR Resolution No. 18.
60 AIS_TYPE_PASSENGER
61 AIS_TYPE_PASSENGER_HAZARDOUS_A
62 AIS_TYPE_PASSENGER_HAZARDOUS_B
63 AIS_TYPE_PASSENGER_HAZARDOUS_C
64 AIS_TYPE_PASSENGER_HAZARDOUS_D
65 AIS_TYPE_PASSENGER_RESERVED_1
66 AIS_TYPE_PASSENGER_RESERVED_2
67 AIS_TYPE_PASSENGER_RESERVED_3
68 AIS_TYPE_PASSENGER_RESERVED_4
69 AIS_TYPE_PASSENGER_UNKNOWN
70 AIS_TYPE_CARGO
71 AIS_TYPE_CARGO_HAZARDOUS_A
72 AIS_TYPE_CARGO_HAZARDOUS_B
73 AIS_TYPE_CARGO_HAZARDOUS_C
74 AIS_TYPE_CARGO_HAZARDOUS_D
75 AIS_TYPE_CARGO_RESERVED_1
76 AIS_TYPE_CARGO_RESERVED_2
77 AIS_TYPE_CARGO_RESERVED_3
78 AIS_TYPE_CARGO_RESERVED_4
79 AIS_TYPE_CARGO_UNKNOWN
80 AIS_TYPE_TANKER
81 AIS_TYPE_TANKER_HAZARDOUS_A
82 AIS_TYPE_TANKER_HAZARDOUS_B
83 AIS_TYPE_TANKER_HAZARDOUS_C
84 AIS_TYPE_TANKER_HAZARDOUS_D
85 AIS_TYPE_TANKER_RESERVED_1
86 AIS_TYPE_TANKER_RESERVED_2
87 AIS_TYPE_TANKER_RESERVED_3
88 AIS_TYPE_TANKER_RESERVED_4
89 AIS_TYPE_TANKER_UNKNOWN
90 AIS_TYPE_OTHER
91 AIS_TYPE_OTHER_HAZARDOUS_A
92 AIS_TYPE_OTHER_HAZARDOUS_B
93 AIS_TYPE_OTHER_HAZARDOUS_C
94 AIS_TYPE_OTHER_HAZARDOUS_D
95 AIS_TYPE_OTHER_RESERVED_1
96 AIS_TYPE_OTHER_RESERVED_2
97 AIS_TYPE_OTHER_RESERVED_3
98 AIS_TYPE_OTHER_RESERVED_4
99 AIS_TYPE_OTHER_UNKNOWN

AIS_NAV_STATUS

Navigational status of AIS vessel, enum duplicated from AIS standard, https://gpsd.gitlab.io/gpsd/AIVDM.html

Name 描述
0 AIS_NAV_STATUS_UNDER_WAY Under way using engine.
1 AIS_NAV_STATUS_ANCHORED
2 AIS_NAV_STATUS_UN_COMMANDED
3 AIS_NAV_STATUS_RESTRICTED_MANOEUVERABILITY
4 AIS_NAV_STATUS_DRAUGHT_CONSTRAINED
5 AIS_NAV_STATUS_MOORED
6 AIS_NAV_STATUS_AGROUND
7 AIS_NAV_STATUS_FISHING
8 AIS_NAV_STATUS_SAILING
9 AIS_NAV_STATUS_RESERVED_HSC
10 AIS_NAV_STATUS_RESERVED_WIG
11 AIS_NAV_STATUS_RESERVED_1
12 AIS_NAV_STATUS_RESERVED_2
13 AIS_NAV_STATUS_RESERVED_3
14 AIS_NAV_STATUS_AIS_SART Search And Rescue Transponder.
15 AIS_NAV_STATUS_UNKNOWN Not available (default).

AIS_FLAGS

(Bitmask) These flags are used in the AIS_VESSEL.fields bitmask to indicate validity of data in the other message fields. When set, the data is valid.

Name 描述
1 AIS_FLAGS_POSITION_ACCURACY 1 = High (Position accuracy less than or equal to 10m), 0 = Low (position accuracy greater than 10m).
2 AIS_FLAGS_VALID_COG The COG field contains valid data
4 AIS_FLAGS_VALID_VELOCITY The velocity field contains valid data
8 AIS_FLAGS_HIGH_VELOCITY 1 = Velocity over 52.5765m/s (102.2 knots)
16 AIS_FLAGS_VALID_TURN_RATE The turn_rate field contains valid data
32 AIS_FLAGS_TURN_RATE_SIGN_ONLY Only the sign of the returned turn_rate value is valid. The actual turn rate is either greater than 5deg/30s or less than -5deg/30s.
64 AIS_FLAGS_VALID_DIMENSIONS
128 AIS_FLAGS_LARGE_BOW_DIMENSION Distance to bow is greater than or equal to 511m
256 AIS_FLAGS_LARGE_STERN_DIMENSION Distance to stern is greater than or equal to 511m
512 AIS_FLAGS_LARGE_PORT_DIMENSION Distance to port side is greater than or equal to 63m
1024 AIS_FLAGS_LARGE_STARBOARD_DIMENSION Distance to starboard side is greater than or equal to 63m
2048 AIS_FLAGS_VALID_CALLSIGN The callsign field contains valid data
4096 AIS_FLAGS_VALID_NAME The name field contains valid data

FAILURE_UNIT

List of possible units where failures can be injected.

Name 描述
0 FAILURE_UNIT_SENSOR_GYRO
1 FAILURE_UNIT_SENSOR_ACCEL
2 FAILURE_UNIT_SENSOR_MAG
3 FAILURE_UNIT_SENSOR_BARO
4 FAILURE_UNIT_SENSOR_GPS
5 FAILURE_UNIT_SENSOR_OPTICAL_FLOW
6 FAILURE_UNIT_SENSOR_VIO
7 FAILURE_UNIT_SENSOR_DISTANCE_SENSOR
8 FAILURE_UNIT_SENSOR_AIRSPEED
100 FAILURE_UNIT_SYSTEM_BATTERY
101 FAILURE_UNIT_SYSTEM_MOTOR
102 FAILURE_UNIT_SYSTEM_SERVO
103 FAILURE_UNIT_SYSTEM_AVOIDANCE
104 FAILURE_UNIT_SYSTEM_RC_SIGNAL
105 FAILURE_UNIT_SYSTEM_MAVLINK_SIGNAL

FAILURE_TYPE

List of possible failure type to inject.

Name 描述
0 FAILURE_TYPE_OK No failure injected, used to reset a previous failure.
1 FAILURE_TYPE_OFF Sets unit off, so completely non-responsive.
2 FAILURE_TYPE_STUCK Unit is stuck e.g. keeps reporting the same value.
3 FAILURE_TYPE_GARBAGE Unit is reporting complete garbage.
4 FAILURE_TYPE_WRONG Unit is consistently wrong.
5 FAILURE_TYPE_SLOW Unit is slow, so e.g. reporting at slower than expected rate.
6 FAILURE_TYPE_DELAYED Data of unit is delayed in time.
7 FAILURE_TYPE_INTERMITTENT Unit is sometimes working, sometimes not.

NAV_VTOL_LAND_OPTIONS

Name 描述
0 NAV_VTOL_LAND_OPTIONS_DEFAULT Default autopilot landing behaviour.
1 NAV_VTOL_LAND_OPTIONS_FW_SPIRAL_APPROACH Use a fixed wing spiral desent approach before landing.
2 NAV_VTOL_LAND_OPTIONS_FW_APPROACH Use a fixed wing approach before detransitioning and landing vertically.

MAV_WINCH_STATUS_FLAG

(Bitmask) Winch status flags used in WINCH_STATUS

Name 描述
1 MAV_WINCH_STATUS_HEALTHY Winch is healthy
2 MAV_WINCH_STATUS_FULLY_RETRACTED Winch line is fully retracted
4 MAV_WINCH_STATUS_MOVING Winch motor is moving
8 MAV_WINCH_STATUS_CLUTCH_ENGAGED Winch clutch is engaged allowing motor to move freely.
16 MAV_WINCH_STATUS_LOCKED Winch is locked by locking mechanism.
32 MAV_WINCH_STATUS_DROPPING Winch is gravity dropping payload.
64 MAV_WINCH_STATUS_ARRESTING Winch is arresting payload descent.
128 MAV_WINCH_STATUS_GROUND_SENSE Winch is using torque measurements to sense the ground.
256 MAV_WINCH_STATUS_RETRACTING Winch is returning to the fully retracted position.
512 MAV_WINCH_STATUS_REDELIVER Winch is redelivering the payload. This is a failover state if the line tension goes above a threshold during RETRACTING.
1024 MAV_WINCH_STATUS_ABANDON_LINE Winch is abandoning the line and possibly payload. Winch unspools the entire calculated line length. This is a failover state from REDELIVER if the number of attempts exceeds a threshold.
2048 MAV_WINCH_STATUS_LOCKING Winch is engaging the locking mechanism.
4096 MAV_WINCH_STATUS_LOAD_LINE Winch is spooling on line.
8192 MAV_WINCH_STATUS_LOAD_PAYLOAD Winch is loading a payload.

MAG_CAL_STATUS

Name 描述
0 MAG_CAL_NOT_STARTED
1 MAG_CAL_WAITING_TO_START
2 MAG_CAL_RUNNING_STEP_ONE
3 MAG_CAL_RUNNING_STEP_TWO
4 MAG_CAL_SUCCESS
5 MAG_CAL_FAILED
6 MAG_CAL_FAILED_ORIENTATION Compass calibration failed: the vehicle orientation is outside the required tolerance.
7 MAG_CAL_FAILED_RADIUS Compass calibration failed: the radius of the fitted sphere is unrealistically small or large.
8 MAG_CAL_FAILED_OFFSETS Compass calibration failed: offset magnitude too large.
9 MAG_CAL_FAILED_DIAG_SCALING Compass calibration failed: diagonal or off-diagonal scaling values out of valid range.
10 MAG_CAL_FAILED_RESIDUALS_HIGH Compass calibration failed: fitness (RMS residual) exceeds tolerance.

MAV_EVENT_ERROR_REASON

Reason for an event error response.

Name 描述
0 MAV_EVENT_ERROR_REASON_UNAVAILABLE The requested event is not available (anymore).

MAV_EVENT_CURRENT_SEQUENCE_FLAGS

(Bitmask) Flags for CURRENT_EVENT_SEQUENCE.

Name 描述
1 MAV_EVENT_CURRENT_SEQUENCE_FLAGS_RESET A sequence reset has happened (e.g. vehicle reboot).

HIL_SENSOR_UPDATED_FLAGS

(Bitmask) Flags in the HIL_SENSOR message indicate which fields have updated since the last message

Name 描述
1 HIL_SENSOR_UPDATED_XACC The value in the xacc field has been updated
2 HIL_SENSOR_UPDATED_YACC The value in the yacc field has been updated
4 HIL_SENSOR_UPDATED_ZACC The value in the zacc field has been updated
8 HIL_SENSOR_UPDATED_XGYRO The value in the xgyro field has been updated
16 HIL_SENSOR_UPDATED_YGYRO The value in the ygyro field has been updated
32 HIL_SENSOR_UPDATED_ZGYRO The value in the zgyro field has been updated
64 HIL_SENSOR_UPDATED_XMAG The value in the xmag field has been updated
128 HIL_SENSOR_UPDATED_YMAG The value in the ymag field has been updated
256 HIL_SENSOR_UPDATED_ZMAG The value in the zmag field has been updated
512 HIL_SENSOR_UPDATED_ABS_PRESSURE The value in the abs_pressure field has been updated
1024 HIL_SENSOR_UPDATED_DIFF_PRESSURE The value in the diff_pressure field has been updated
2048 HIL_SENSOR_UPDATED_PRESSURE_ALT The value in the pressure_alt field has been updated
4096 HIL_SENSOR_UPDATED_TEMPERATURE The value in the temperature field has been updated
2147483648 HIL_SENSOR_UPDATED_RESET Full reset of attitude/position/velocities/etc was performed in sim (Bit 31).

HIGHRES_IMU_UPDATED_FLAGS

(Bitmask) Flags in the HIGHRES_IMU message indicate which fields have updated since the last message

Name 描述
1 HIGHRES_IMU_UPDATED_XACC The value in the xacc field has been updated
2 HIGHRES_IMU_UPDATED_YACC The value in the yacc field has been updated
4 HIGHRES_IMU_UPDATED_ZACC The value in the zacc field has been updated since
8 HIGHRES_IMU_UPDATED_XGYRO The value in the xgyro field has been updated
16 HIGHRES_IMU_UPDATED_YGYRO The value in the ygyro field has been updated
32 HIGHRES_IMU_UPDATED_ZGYRO The value in the zgyro field has been updated
64 HIGHRES_IMU_UPDATED_XMAG The value in the xmag field has been updated
128 HIGHRES_IMU_UPDATED_YMAG The value in the ymag field has been updated
256 HIGHRES_IMU_UPDATED_ZMAG The value in the zmag field has been updated
512 HIGHRES_IMU_UPDATED_ABS_PRESSURE The value in the abs_pressure field has been updated
1024 HIGHRES_IMU_UPDATED_DIFF_PRESSURE The value in the diff_pressure field has been updated
2048 HIGHRES_IMU_UPDATED_PRESSURE_ALT The value in the pressure_alt field has been updated
4096 HIGHRES_IMU_UPDATED_TEMPERATURE The value in the temperature field has been updated

CAN_FILTER_OP

Name 描述
0 CAN_FILTER_REPLACE
1 CAN_FILTER_ADD
2 CAN_FILTER_REMOVE

MAV_FTP_ERR

MAV FTP error codes (may be used in FILE_TRANSFER_PROTOCOL). See https://mavlink.io/en/services/ftp.html.

Name 描述
0 MAV_FTP_ERR_NONE None: No error
1 MAV_FTP_ERR_FAIL Fail: Unknown failure
2 MAV_FTP_ERR_FAILERRNO FailErrno: Command failed, Err number sent back in PayloadHeader.data[1].
This is a file-system error number understood by the server operating system.
3 MAV_FTP_ERR_INVALIDDATASIZE InvalidDataSize: Payload size is invalid
4 MAV_FTP_ERR_INVALIDSESSION InvalidSession: Session is not currently open
5 MAV_FTP_ERR_NOSESSIONSAVAILABLE NoSessionsAvailable: All available sessions are already in use
6 MAV_FTP_ERR_EOF EOF: Offset past end of file for ListDirectory and ReadFile commands
7 MAV_FTP_ERR_UNKNOWNCOMMAND UnknownCommand: Unknown command / opcode
8 MAV_FTP_ERR_FILEEXISTS FileExists: File/directory already exists
9 MAV_FTP_ERR_FILEPROTECTED FileProtected: File/directory is write protected
10 MAV_FTP_ERR_FILENOTFOUND FileNotFound: File/directory not found

MAV_FTP_OPCODE

MAV FTP opcodes (may be used in FILE_TRANSFER_PROTOCOL). See https://mavlink.io/en/services/ftp.html.

Name 描述
0 MAV_FTP_OPCODE_NONE None. Ignored, always ACKed
1 MAV_FTP_OPCODE_TERMINATESESSION TerminateSession: Terminates open Read session
2 MAV_FTP_OPCODE_RESETSESSION ResetSessions: Terminates all open read sessions
3 MAV_FTP_OPCODE_LISTDIRECTORY ListDirectory. List files and directories in path from offset
4 MAV_FTP_OPCODE_OPENFILERO OpenFileRO: Opens file at path for reading, returns session
5 MAV_FTP_OPCODE_READFILE ReadFile: Reads size bytes from offset in session
6 MAV_FTP_OPCODE_CREATEFILE CreateFile: Creates file at path for writing, returns session
7 MAV_FTP_OPCODE_WRITEFILE WriteFile: Writes size bytes to offset in session
8 MAV_FTP_OPCODE_REMOVEFILE RemoveFile: Remove file at path
9 MAV_FTP_OPCODE_CREATEDIRECTORY CreateDirectory: Creates directory at path
10 MAV_FTP_OPCODE_REMOVEDIRECTORY RemoveDirectory: Removes directory at path. The directory must be empty.
11 MAV_FTP_OPCODE_OPENFILEWO OpenFileWO: Opens file at path for writing, returns session
12 MAV_FTP_OPCODE_TRUNCATEFILE TruncateFile: Truncate file at path to offset length
13 MAV_FTP_OPCODE_RENAME Rename: Rename path1 to path2
14 MAV_FTP_OPCODE_CALCFILECRC CalcFileCRC32: Calculate CRC32 for file at path
15 MAV_FTP_OPCODE_BURSTREADFILE BurstReadFile: Burst download session file
16 MAV_FTP_OPCODE_LISTDIRECTORYWITHTIME ListDirectoryWithTime: List files and directories, along with last-modification timestamps, in path from offset. This is the same as ListDirectory except for the addition of timestamps. Servers that do not support this opcode respond with a NAK (MAV_FTP_ERR_UNKNOWNCOMMAND).
128 MAV_FTP_OPCODE_ACK ACK: ACK response
129 MAV_FTP_OPCODE_NAK NAK: NAK response

MISSION_STATE

States of the mission state machine. Note that these states are independent of whether the mission is in a mode that can execute mission items or not (is suspended). They may not all be relevant on all vehicles.

Name 描述
0 MISSION_STATE_UNKNOWN The mission status reporting is not supported.
1 MISSION_STATE_NO_MISSION No mission on the vehicle.
2 MISSION_STATE_NOT_STARTED Mission has not started. This is the case after a mission has uploaded but not yet started executing.
3 MISSION_STATE_ACTIVE Mission is active, and will execute mission items when in auto mode.
4 MISSION_STATE_PAUSED Mission is paused when in auto mode.
5 MISSION_STATE_COMPLETE Mission has executed all mission items.

SAFETY_SWITCH_STATE

Possible safety switch states.

Name 描述
0 SAFETY_SWITCH_STATE_SAFE Safety switch is engaged and vehicle should be safe to approach.
1 SAFETY_SWITCH_STATE_DANGEROUS Safety switch is NOT engaged and motors, propellers and other actuators should be considered active.

ILLUMINATOR_MODE

Modes of illuminator

Name 描述
0 ILLUMINATOR_MODE_UNKNOWN Illuminator mode is not specified/unknown
1 ILLUMINATOR_MODE_INTERNAL_CONTROL Illuminator behavior is controlled by MAV_CMD_DO_ILLUMINATOR_CONFIGURE settings
2 ILLUMINATOR_MODE_EXTERNAL_SYNC Illuminator behavior is controlled by external factors: e.g. an external hardware signal

ILLUMINATOR_ERROR_FLAGS

(Bitmask) Illuminator module error flags (bitmap, 0 means no error)

Name 描述
1 ILLUMINATOR_ERROR_FLAGS_THERMAL_THROTTLING Illuminator thermal throttling error.
2 ILLUMINATOR_ERROR_FLAGS_OVER_TEMPERATURE_SHUTDOWN Illuminator over temperature shutdown error.
4 ILLUMINATOR_ERROR_FLAGS_THERMISTOR_FAILURE Illuminator thermistor failure.

MAV_STANDARD_MODE

Standard modes with a well understood meaning across flight stacks and vehicle types.

For example, most flight stack have the concept of a "return" or "RTL" mode that takes a vehicle to safety, even though the precise mechanics of this mode may differ. The modes supported by a flight stack can be queried using AVAILABLE_MODES and set using MAV_CMD_DO_SET_STANDARD_MODE. The current mode is streamed in CURRENT_MODE. See https://mavlink.io/en/services/standard_modes.html

Name 描述
0 MAV_STANDARD_MODE_NON_STANDARD Non standard mode.
This may be used when reporting the mode if the current flight mode is not a standard mode.
1 MAV_STANDARD_MODE_POSITION_HOLD Position mode (manual).
Position-controlled and stabilized manual mode.
When sticks are released vehicles return to their level-flight orientation and hold both position and altitude against wind and external forces.
This mode can only be set by vehicles that can hold a fixed position.
Multicopter (MC) vehicles actively brake and hold both position and altitude against wind and external forces.
Hybrid MC/FW ("VTOL") vehicles first transition to multicopter mode (if needed) but otherwise behave in the same way as MC vehicles.
Fixed-wing (FW) vehicles must not support this mode.
Other vehicle types must not support this mode (this may be revisited through the PR process).
2 MAV_STANDARD_MODE_ORBIT Orbit (manual).
Position-controlled and stabilized manual mode.
The vehicle circles around a fixed setpoint in the horizontal plane at a particular radius, altitude, and direction.
Flight stacks may further allow manual control over the setpoint position, radius, direction, speed, and/or altitude of the circle, but this is not mandated.
Flight stacks may support the MAV_CMD_DO_ORBIT for changing the orbit parameters.
MC and FW vehicles may support this mode.
Hybrid MC/FW ("VTOL") vehicles may support this mode in MC/FW or both modes; if the mode is not supported by the current configuration the vehicle should transition to the supported configuration.
Other vehicle types must not support this mode (this may be revisited through the PR process).
3 MAV_STANDARD_MODE_CRUISE Cruise mode (manual).
Position-controlled and stabilized manual mode.
When sticks are released vehicles return to their level-flight orientation and hold their original track against wind and external forces.
Fixed-wing (FW) vehicles level orientation and maintain current track and altitude against wind and external forces.
Hybrid MC/FW ("VTOL") vehicles first transition to FW mode (if needed) but otherwise behave in the same way as MC vehicles.
Multicopter (MC) vehicles must not support this mode.
Other vehicle types must not support this mode (this may be revisited through the PR process).
4 MAV_STANDARD_MODE_ALTITUDE_HOLD Altitude hold (manual).
Altitude-controlled and stabilized manual mode.
When sticks are released vehicles return to their level-flight orientation and hold their altitude.
MC vehicles continue with existing momentum and may move with wind (or other external forces).
FW vehicles continue with current heading, but may be moved off-track by wind.
Hybrid MC/FW ("VTOL") vehicles behave according to their current configuration/mode (FW or MC).
Other vehicle types must not support this mode (this may be revisited through the PR process).
5 MAV_STANDARD_MODE_SAFE_RECOVERY Safe recovery mode (auto).
Automatic mode that takes vehicle to a predefined safe location via a safe flight path, and may also automatically land the vehicle.
This mode is more commonly referred to as RTL and/or or Smart RTL.
The precise return location, flight path, and landing behaviour depend on vehicle configuration and type.
For example, the vehicle might return to the home/launch location, a rally point, or the start of a mission landing, it might follow a direct path, mission path, or breadcrumb path, and land using a mission landing pattern or some other kind of descent.
6 MAV_STANDARD_MODE_MISSION Mission mode (automatic).
Automatic mode that executes MAVLink missions.
Missions are executed from the current waypoint as soon as the mode is enabled.
7 MAV_STANDARD_MODE_LAND Land mode (auto).
Automatic mode that lands the vehicle at the current location.
The precise landing behaviour depends on vehicle configuration and type.
8 MAV_STANDARD_MODE_TAKEOFF Takeoff mode (auto).
Automatic takeoff mode.
The precise takeoff behaviour depends on vehicle configuration and type.

MAV_MODE_PROPERTY

(Bitmask) Mode properties.

Name 描述
1 MAV_MODE_PROPERTY_ADVANCED If set, this mode is an advanced mode.
For example a rate-controlled manual mode might be advanced, whereas a position-controlled manual mode is not.
A GCS can optionally use this flag to configure the UI for its intended users.
2 MAV_MODE_PROPERTY_NOT_USER_SELECTABLE If set, this mode should not be added to the list of selectable modes.
The mode might still be selected by the FC directly (for example as part of a failsafe).
4 MAV_MODE_PROPERTY_AUTO_MODE If set, this mode is automatically controlled (it may use but does not require a manual controller).
If unset the mode is a assumed to require user input (be a manual mode).

HIL_ACTUATOR_CONTROLS_FLAGS

(Bitmask) Flags used in HIL_ACTUATOR_CONTROLS message.

Name 描述
1 HIL_ACTUATOR_CONTROLS_FLAGS_LOCKSTEP Simulation is using lockstep

COMPUTER_STATUS_FLAGS

(Bitmask) Flags used to report computer status.

Name 描述
1 COMPUTER_STATUS_FLAGS_UNDER_VOLTAGE Indicates if the system is experiencing voltage outside of acceptable range.
2 COMPUTER_STATUS_FLAGS_CPU_THROTTLE Indicates if CPU throttling is active.
4 COMPUTER_STATUS_FLAGS_THERMAL_THROTTLE Indicates if thermal throttling is active.
8 COMPUTER_STATUS_FLAGS_DISK_FULL Indicates if main disk is full.

AIRSPEED_SENSOR_FLAGS

(Bitmask) Airspeed sensor flags

Name 描述
1 AIRSPEED_SENSOR_UNHEALTHY Airspeed sensor is unhealthy
2 AIRSPEED_SENSOR_USING True if the data from this sensor is being actively used by the flight controller for guidance, navigation or control.

GLOBAL_POSITION_SRC

Source for GLOBAL_POSITION measurement or estimate.

Name 描述
0 GLOBAL_POSITION_SRC_UNKNOWN Source is unknown or not one of the listed types.
1 GLOBAL_POSITION_SRC_GNSS Global Navigation Satellite System (e.g.: GPS, Galileo, Glonass, BeiDou).
2 GLOBAL_POSITION_SRC_VISION Vision system (e.g.: map matching).
3 GLOBAL_POSITION_SRC_PSEUDOLITES A pseudo-satellite system using transceiver beacons to perform GNSS-like positioning.
4 GLOBAL_POSITION_SRC_TERRAIN Terrain referenced navigation.
5 GLOBAL_POSITION_SRC_MAGNETIC Magnetic positioning.
6 GLOBAL_POSITION_SRC_ESTIMATOR Estimated position based on various sensors (eg. a Kalman Filter).
7 GLOBAL_POSITION_SRC_LEO Low Earth Orbit satellite-based positioning (e.g.: Starlink, Xona PULSAR).

GLOBAL_POSITION_FLAGS

(Bitmask) Status flags for GLOBAL_POSITION

Name 描述
1 GLOBAL_POSITION_UNHEALTHY Unhealthy sensor/estimator.
2 GLOBAL_POSITION_PRIMARY True if the data originates from or is consumed by the primary estimator.

MAV_BOOL — [from: standard]

(Bitmask) Enum used to indicate true or false (also: success or failure, enabled or disabled, active or inactive).

Name 描述
0 MAV_BOOL_FALSE False.
1 MAV_BOOL_TRUE True.

MAV_PROTOCOL_CAPABILITY — [from: standard]

(Bitmask) Bitmask of (optional) autopilot capabilities (64 bit). If a bit is set, the autopilot supports this capability.

Name 描述
1 MAV_PROTOCOL_CAPABILITY_MISSION_FLOAT Autopilot supports the MISSION_ITEM float message type.
Note that MISSION_ITEM is deprecated, and autopilots should use MISSION_ITEM_INT instead.
2 MAV_PROTOCOL_CAPABILITY_PARAM_FLOAT Autopilot supports the new param float message type.
DEPRECATED: Replaced By MAV_PROTOCOL_CAPABILITY_PARAM_ENCODE_C_CAST (2022-03)
4 MAV_PROTOCOL_CAPABILITY_MISSION_INT Autopilot supports MISSION_ITEM_INT scaled integer message type.
Note that this flag must always be set if missions are supported, because missions must always use MISSION_ITEM_INT (rather than MISSION_ITEM, which is deprecated).
8 MAV_PROTOCOL_CAPABILITY_COMMAND_INT Autopilot supports COMMAND_INT scaled integer message type.
16 MAV_PROTOCOL_CAPABILITY_PARAM_ENCODE_BYTEWISE Parameter protocol uses byte-wise encoding of parameter values into param_value (float) fields: https://mavlink.io/en/services/parameter.html#parameter-encoding.
Note that either this flag or MAV_PROTOCOL_CAPABILITY_PARAM_ENCODE_C_CAST should be set if the parameter protocol is supported.
32 MAV_PROTOCOL_CAPABILITY_FTP Autopilot supports the File Transfer Protocol v1: https://mavlink.io/en/services/ftp.html.
64 MAV_PROTOCOL_CAPABILITY_SET_ATTITUDE_TARGET Autopilot supports commanding attitude offboard.
128 MAV_PROTOCOL_CAPABILITY_SET_POSITION_TARGET_LOCAL_NED Autopilot supports commanding position and velocity targets in local NED frame.
256 MAV_PROTOCOL_CAPABILITY_SET_POSITION_TARGET_GLOBAL_INT Autopilot supports commanding position and velocity targets in global scaled integers.
512 MAV_PROTOCOL_CAPABILITY_TERRAIN Autopilot supports terrain protocol / data handling.
1024 MAV_PROTOCOL_CAPABILITY_RESERVED3 保留以备将来使用。
2048 MAV_PROTOCOL_CAPABILITY_FLIGHT_TERMINATION Autopilot supports the MAV_CMD_DO_FLIGHTTERMINATION command (flight termination).
4096 MAV_PROTOCOL_CAPABILITY_COMPASS_CALIBRATION Autopilot supports onboard compass calibration.
8192 MAV_PROTOCOL_CAPABILITY_MAVLINK2 Autopilot supports MAVLink version 2.
16384 MAV_PROTOCOL_CAPABILITY_MISSION_FENCE Autopilot supports mission fence protocol.
32768 MAV_PROTOCOL_CAPABILITY_MISSION_RALLY Autopilot supports mission rally point protocol.
65536 MAV_PROTOCOL_CAPABILITY_RESERVED2 保留以备将来使用。
131072 MAV_PROTOCOL_CAPABILITY_PARAM_ENCODE_C_CAST Parameter protocol uses C-cast of parameter values to set the param_value (float) fields: https://mavlink.io/en/services/parameter.html#parameter-encoding.
Note that either this flag or MAV_PROTOCOL_CAPABILITY_PARAM_ENCODE_BYTEWISE should be set if the parameter protocol is supported.
262144 MAV_PROTOCOL_CAPABILITY_COMPONENT_IMPLEMENTS_GIMBAL_MANAGER This component implements/is a gimbal manager. This means the GIMBAL_MANAGER_INFORMATION, and other messages can be requested.
524288 MAV_PROTOCOL_CAPABILITY_COMPONENT_ACCEPTS_GCS_CONTROL Component supports locking control to a particular GCS independent of its system (via MAV_CMD_REQUEST_OPERATOR_CONTROL).
WORK IN PROGRESS: Do not use in stable production environments (it may change).
1048576 MAV_PROTOCOL_CAPABILITY_GRIPPER Autopilot has a connected gripper. MAVLink Grippers would set MAV_TYPE_GRIPPER instead.
WORK IN PROGRESS: Do not use in stable production environments (it may change).

FIRMWARE_VERSION_TYPE — [from: standard]

These values define the type of firmware release. These values indicate the first version or release of this type. For example the first alpha release would be 64, the second would be 65.

Name 描述
0 FIRMWARE_VERSION_TYPE_DEV development release
64 FIRMWARE_VERSION_TYPE_ALPHA alpha release
128 FIRMWARE_VERSION_TYPE_BETA beta release
192 FIRMWARE_VERSION_TYPE_RC release candidate
255 FIRMWARE_VERSION_TYPE_OFFICIAL official stable release

MAV_AUTOPILOT — [from: minimal]

Micro air vehicle / autopilot classes. 这里标明了每个单个模型。

Name 描述
0 MAV_AUTOPILOT_GENERIC 通用自动驾驶仪,完全支持所有
1 MAV_AUTOPILOT_RESERVED 保留以备将来使用。
2 MAV_AUTOPILOT_SLUGS SLUGS 自动驾驶仪,http://slugsuav.soe.ucsc.edu
3 MAV_AUTOPILOT_ARDUPILOTMEGA ArduPilot - Plane/Copter/Rover/Sub/Tracker, https://ardupilot.org
4 MAV_AUTOPILOT_OPENPILOT OpenPilothttp://openpilot.org
5 MAV_AUTOPILOT_GENERIC_WAYPOINTS_ONLY Generic autopilot only supporting simple waypoints
6 MAV_AUTOPILOT_GENERIC_WAYPOINTS_AND_SIMPLE_NAVIGATION_ONLY Generic autopilot supporting waypoints and other simple navigation commands
7 MAV_AUTOPILOT_GENERIC_MISSION_FULL 支持所有任务命令的通用自动驾驶仪
8 MAV_AUTOPILOT_INVALID 没有有效的自动驾驶仪,例如地面站或其他 MAVLink 组件
9 MAV_AUTOPILOT_PPZ PPZ 无人机 - http://nongnu.org/paparazzi
10 MAV_AUTOPILOT_UDB 无人机开发板
11 MAV_AUTOPILOT_FP FlexiPilot
12 MAV_AUTOPILOT_PX4 PX4 自动驾驶仪 - http://px4.io/
13 MAV_AUTOPILOT_SMACCMPILOT SMACCMPilot - http://smaccmpilot.org
14 MAV_AUTOPILOT_AUTOQUAD AutoQuad -- http://autoquad.org
15 MAV_AUTOPILOT_ARMAZILA Armazila -- http://armazila.com
16 MAV_AUTOPILOT_AEROB Aerob -- http://aerob.ru
17 MAV_AUTOPILOT_ASLUAV ASLUAV 自动驾驶仪 -- http://www.asl.ethz.ch
18 MAV_AUTOPILOT_SMARTAP SmartAP自动驾驶仪 - http://sky-drones.com
19 MAV_AUTOPILOT_AIRRAILS AirRails - http://uaventure.com
20 MAV_AUTOPILOT_REFLEX Fusion Reflex - https://fusion.engineering

MAV_TYPE — [from: minimal]

MAVLINK component type reported in HEARTBEAT message. Flight controllers must report the type of the vehicle on which they are mounted (e.g. MAV_TYPE_OCTOROTOR). All other components must report a value appropriate for their type (e.g. a camera must use MAV_TYPE_CAMERA).

Name 描述
0 MAV_TYPE_GENERIC 通用微型飞行器
1 MAV_TYPE_FIXED_WING 固定翼。
2 MAV_TYPE_QUADROTOR 四旋翼
3 MAV_TYPE_COAXIAL 共轴直升机
4 MAV_TYPE_HELICOPTER 带尾桨的普通直升机。
5 MAV_TYPE_ANTENNA_TRACKER 地面安装
6 MAV_TYPE_GCS 操作员控制单元/地面站
7 MAV_TYPE_AIRSHIP 可控飞艇
8 MAV_TYPE_FREE_BALLOON 不可控的热气球
9 MAV_TYPE_ROCKET 火箭
10 MAV_TYPE_GROUND_ROVER 地面小车
11 MAV_TYPE_SURFACE_BOAT 水面舰艇,小船,轮船
12 MAV_TYPE_SUBMARINE 潜艇
13 MAV_TYPE_HEXAROTOR 六旋翼
14 MAV_TYPE_OCTOROTOR 八旋翼
15 MAV_TYPE_TRICOPTER Tricopter
16 MAV_TYPE_FLAPPING_WING Flapping wing
17 MAV_TYPE_KITE Kite
18 MAV_TYPE_ONBOARD_CONTROLLER Onboard companion controller
19 MAV_TYPE_VTOL_TAILSITTER_DUOROTOR Two-rotor Tailsitter VTOL that additionally uses control surfaces in vertical operation. Note, value previously named MAV_TYPE_VTOL_DUOROTOR.
20 MAV_TYPE_VTOL_TAILSITTER_QUADROTOR Quad-rotor Tailsitter VTOL using a V-shaped quad config in vertical operation. Note: value previously named MAV_TYPE_VTOL_QUADROTOR.
21 MAV_TYPE_VTOL_TILTROTOR Tiltrotor VTOL. Fuselage and wings stay (nominally) horizontal in all flight phases. It able to tilt (some) rotors to provide thrust in cruise flight.
22 MAV_TYPE_VTOL_FIXEDROTOR VTOL with separate fixed rotors for hover and cruise flight. Fuselage and wings stay (nominally) horizontal in all flight phases.
23 MAV_TYPE_VTOL_TAILSITTER Tailsitter VTOL. Fuselage and wings orientation changes depending on flight phase: vertical for hover, horizontal for cruise. Use more specific VTOL MAV_TYPE_VTOL_TAILSITTER_DUOROTOR or MAV_TYPE_VTOL_TAILSITTER_QUADROTOR if appropriate.
24 MAV_TYPE_VTOL_TILTWING Tiltwing VTOL. Fuselage stays horizontal in all flight phases. The whole wing, along with any attached engine, can tilt between vertical and horizontal mode.
25 MAV_TYPE_VTOL_RESERVED5 VTOL reserved 5
26 MAV_TYPE_GIMBAL Gimbal
27 MAV_TYPE_ADSB ADSB system
28 MAV_TYPE_PARAFOIL Steerable, nonrigid airfoil
29 MAV_TYPE_DODECAROTOR Dodecarotor
30 MAV_TYPE_CAMERA Camera
31 MAV_TYPE_CHARGING_STATION Charging station
32 MAV_TYPE_FLARM FLARM collision avoidance system
33 MAV_TYPE_SERVO Servo
34 MAV_TYPE_ODID Open Drone ID. See https://mavlink.io/en/services/opendroneid.html.
35 MAV_TYPE_DECAROTOR Decarotor
36 MAV_TYPE_BATTERY Battery
37 MAV_TYPE_PARACHUTE Parachute
38 MAV_TYPE_LOG Log
39 MAV_TYPE_OSD OSD
40 MAV_TYPE_IMU IMU
41 MAV_TYPE_GPS GPS
42 MAV_TYPE_WINCH Winch
43 MAV_TYPE_GENERIC_MULTIROTOR Generic multirotor that does not fit into a specific type or whose type is unknown
44 MAV_TYPE_ILLUMINATOR Illuminator. An illuminator is a light source that is used for lighting up dark areas external to the system: e.g. a torch or searchlight (as opposed to a light source for illuminating the system itself, e.g. an indicator light).
45 MAV_TYPE_SPACECRAFT_ORBITER Orbiter spacecraft. Includes satellites orbiting terrestrial and extra-terrestrial bodies. Follows NASA Spacecraft Classification.
46 MAV_TYPE_GROUND_QUADRUPED A generic four-legged ground vehicle (e.g., a robot dog).
47 MAV_TYPE_VTOL_GYRODYNE VTOL hybrid of helicopter and autogyro. It has a main rotor for lift and separate propellers for forward flight. The rotor must be powered for hover but can autorotate in cruise flight. See: https://en.wikipedia.org/wiki/Gyrodyne
48 MAV_TYPE_GRIPPER Gripper
49 MAV_TYPE_RADIO Radio

MAV_MODE_FLAG — [from: minimal]

(Bitmask) These flags encode the MAV mode, see MAV_MODE enum for useful combinations.

Name 描述
1 MAV_MODE_FLAG_CUSTOM_MODE_ENABLED 0b00000001 system-specific custom mode is enabled. When using this flag to enable a custom mode all other flags should be ignored.
2 MAV_MODE_FLAG_TEST_ENABLED 0b00000010 system has a test mode enabled. This flag is intended for temporary system tests and should not be used for stable implementations.
4 MAV_MODE_FLAG_AUTO_ENABLED 0b00000100 autonomous mode enabled, system finds its own goal positions. Guided flag can be set or not, depends on the actual implementation.
8 MAV_MODE_FLAG_GUIDED_ENABLED 0b00001000 guided mode enabled, system flies waypoints / mission items.
16 MAV_MODE_FLAG_STABILIZE_ENABLED 0b00010000 system stabilizes electronically its attitude (and optionally position). It needs however further control inputs to move around.
32 MAV_MODE_FLAG_HIL_ENABLED 0b00100000 hardware in the loop simulation. All motors / actuators are blocked, but internal software is full operational.
64 MAV_MODE_FLAG_MANUAL_INPUT_ENABLED 0b01000000 remote control input is enabled.
128 MAV_MODE_FLAG_SAFETY_ARMED 0b10000000 MAV safety set to armed. Motors are enabled / running / can start. Ready to fly. Additional note: this flag is to be ignore when sent in the command MAV_CMD_DO_SET_MODE and MAV_CMD_COMPONENT_ARM_DISARM shall be used instead. The flag can still be used to report the armed state.

MAV_MODE_FLAG_DECODE_POSITION — [from: minimal]

(Bitmask) These values encode the bit positions of the decode position. These values can be used to read the value of a flag bit by combining the base_mode variable with AND with the flag position value. The result will be either 0 or 1, depending on if the flag is set or not.

Name 描述
1 MAV_MODE_FLAG_DECODE_POSITION_CUSTOM_MODE Eighth bit: 00000001
2 MAV_MODE_FLAG_DECODE_POSITION_TEST Seventh bit: 00000010
4 MAV_MODE_FLAG_DECODE_POSITION_AUTO Sixth bit: 00000100
8 MAV_MODE_FLAG_DECODE_POSITION_GUIDED Fifth bit: 00001000
16 MAV_MODE_FLAG_DECODE_POSITION_STABILIZE Fourth bit: 00010000
32 MAV_MODE_FLAG_DECODE_POSITION_HIL Third bit: 00100000
64 MAV_MODE_FLAG_DECODE_POSITION_MANUAL Second bit: 01000000
128 MAV_MODE_FLAG_DECODE_POSITION_SAFETY First bit: 10000000

MAV_STATE — [from: minimal]

Name 描述
0 MAV_STATE_UNINIT Uninitialized system, state is unknown.
1 MAV_STATE_BOOT System is booting up.
2 MAV_STATE_CALIBRATING System is calibrating and not flight-ready.
3 MAV_STATE_STANDBY System is grounded and on standby. It can be launched any time.
4 MAV_STATE_ACTIVE System is active and might be already airborne. Motors are engaged.
5 MAV_STATE_CRITICAL System is in a non-normal flight mode (failsafe). It can however still navigate.
6 MAV_STATE_EMERGENCY System is in a non-normal flight mode (failsafe). It lost control over parts or over the whole airframe. It is in mayday and going down.
7 MAV_STATE_POWEROFF System just initialized its power-down sequence, will shut down now.
8 MAV_STATE_FLIGHT_TERMINATION System is terminating itself (failsafe or commanded).

MAV_COMPONENT — [from: minimal]

Legacy component ID values for particular types of hardware/software that might make up a MAVLink system (autopilot, cameras, servos, avoidance systems etc.).

Components are not required or expected to use IDs with names that correspond to their type or function, but may choose to do so. Using an ID that matches the type may slightly reduce the chances of component id clashes, as, for historical reasons, it is less likely to be used by some other type of component. System integration will still need to ensure that all components have unique IDs.

Component IDs are used for addressing messages to a particular component within a system. A component can use any unique ID between 1 and 255 (MAV_COMP_ID_ALL value is the broadcast address, used to send to all components).

Historically component ID were also used for identifying the type of component. New code must not use component IDs to infer the component type, but instead check the MAV_TYPE in the HEARTBEAT message!

Name 描述
0 MAV_COMP_ID_ALL Target id (target_component) used to broadcast messages to all components of the receiving system. Components should attempt to process messages with this component ID and forward to components on any other interfaces. Note: This is not a valid source component id for a message.
1 MAV_COMP_ID_AUTOPILOT1 System flight controller component ("autopilot"). Only one autopilot is expected in a particular system.
25 MAV_COMP_ID_USER1 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
26 MAV_COMP_ID_USER2 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
27 MAV_COMP_ID_USER3 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
28 MAV_COMP_ID_USER4 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
29 MAV_COMP_ID_USER5 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
30 MAV_COMP_ID_USER6 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
31 MAV_COMP_ID_USER7 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
32 MAV_COMP_ID_USER8 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
33 MAV_COMP_ID_USER9 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
34 MAV_COMP_ID_USER10 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
35 MAV_COMP_ID_USER11 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
36 MAV_COMP_ID_USER12 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
37 MAV_COMP_ID_USER13 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
38 MAV_COMP_ID_USER14 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
39 MAV_COMP_ID_USER15 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
40 MAV_COMP_ID_USER16 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
41 MAV_COMP_ID_USER17 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
42 MAV_COMP_ID_USER18 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
43 MAV_COMP_ID_USER19 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
44 MAV_COMP_ID_USER20 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
45 MAV_COMP_ID_USER21 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
46 MAV_COMP_ID_USER22 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
47 MAV_COMP_ID_USER23 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
48 MAV_COMP_ID_USER24 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
49 MAV_COMP_ID_USER25 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
50 MAV_COMP_ID_USER26 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
51 MAV_COMP_ID_USER27 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
52 MAV_COMP_ID_USER28 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
53 MAV_COMP_ID_USER29 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
54 MAV_COMP_ID_USER30 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
55 MAV_COMP_ID_USER31 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
56 MAV_COMP_ID_USER32 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
57 MAV_COMP_ID_USER33 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
58 MAV_COMP_ID_USER34 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
59 MAV_COMP_ID_USER35 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
60 MAV_COMP_ID_USER36 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
61 MAV_COMP_ID_USER37 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
62 MAV_COMP_ID_USER38 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
63 MAV_COMP_ID_USER39 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
64 MAV_COMP_ID_USER40 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
65 MAV_COMP_ID_USER41 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
66 MAV_COMP_ID_USER42 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
67 MAV_COMP_ID_USER43 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
68 MAV_COMP_ID_TELEMETRY_RADIO Telemetry radio (e.g. SiK radio, or other component that emits RADIO_STATUS messages).
69 MAV_COMP_ID_USER45 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
70 MAV_COMP_ID_USER46 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
71 MAV_COMP_ID_USER47 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
72 MAV_COMP_ID_USER48 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
73 MAV_COMP_ID_USER49 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
74 MAV_COMP_ID_USER50 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
75 MAV_COMP_ID_USER51 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
76 MAV_COMP_ID_USER52 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
77 MAV_COMP_ID_USER53 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
78 MAV_COMP_ID_USER54 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
79 MAV_COMP_ID_USER55 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
80 MAV_COMP_ID_USER56 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
81 MAV_COMP_ID_USER57 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
82 MAV_COMP_ID_USER58 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
83 MAV_COMP_ID_USER59 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
84 MAV_COMP_ID_USER60 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
85 MAV_COMP_ID_USER61 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
86 MAV_COMP_ID_USER62 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
87 MAV_COMP_ID_USER63 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
88 MAV_COMP_ID_USER64 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
89 MAV_COMP_ID_USER65 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
90 MAV_COMP_ID_USER66 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
91 MAV_COMP_ID_USER67 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
92 MAV_COMP_ID_USER68 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
93 MAV_COMP_ID_USER69 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
94 MAV_COMP_ID_USER70 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
95 MAV_COMP_ID_USER71 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
96 MAV_COMP_ID_USER72 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
97 MAV_COMP_ID_USER73 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
98 MAV_COMP_ID_USER74 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
99 MAV_COMP_ID_USER75 Id for a component on privately managed MAVLink network. Can be used for any purpose but may not be published by components outside of the private network.
100 MAV_COMP_ID_CAMERA Camera #1.
101 MAV_COMP_ID_CAMERA2 Camera #2.
102 MAV_COMP_ID_CAMERA3 Camera #3.
103 MAV_COMP_ID_CAMERA4 Camera #4.
104 MAV_COMP_ID_CAMERA5 Camera #5.
105 MAV_COMP_ID_CAMERA6 Camera #6.
110 MAV_COMP_ID_RADIO Radio #1.
111 MAV_COMP_ID_RADIO2 Radio #2.
112 MAV_COMP_ID_RADIO3 Radio #3.
140 MAV_COMP_ID_SERVO1 Servo #1.
141 MAV_COMP_ID_SERVO2 Servo #2.
142 MAV_COMP_ID_SERVO3 Servo #3.
143 MAV_COMP_ID_SERVO4 Servo #4.
144 MAV_COMP_ID_SERVO5 Servo #5.
145 MAV_COMP_ID_SERVO6 Servo #6.
146 MAV_COMP_ID_SERVO7 Servo #7.
147 MAV_COMP_ID_SERVO8 Servo #8.
148 MAV_COMP_ID_SERVO9 Servo #9.
149 MAV_COMP_ID_SERVO10 Servo #10.
150 MAV_COMP_ID_SERVO11 Servo #11.
151 MAV_COMP_ID_SERVO12 Servo #12.
152 MAV_COMP_ID_SERVO13 Servo #13.
153 MAV_COMP_ID_SERVO14 Servo #14.
154 MAV_COMP_ID_GIMBAL Gimbal #1.
155 MAV_COMP_ID_LOG Logging component.
156 MAV_COMP_ID_ADSB Automatic Dependent Surveillance-Broadcast (ADS-B) component.
157 MAV_COMP_ID_OSD On Screen Display (OSD) devices for video links.
158 MAV_COMP_ID_PERIPHERAL Generic autopilot peripheral component ID. Meant for devices that do not implement the parameter microservice.
159 MAV_COMP_ID_QX1_GIMBAL Gimbal ID for QX1.
DEPRECATED: Replaced By MAV_COMP_ID_GIMBAL (2018-11) — All gimbals should use MAV_COMP_ID_GIMBAL.)
160 MAV_COMP_ID_FLARM FLARM collision alert component.
161 MAV_COMP_ID_PARACHUTE Parachute component.
169 MAV_COMP_ID_WINCH Winch component.
171 MAV_COMP_ID_GIMBAL2 Gimbal #2.
172 MAV_COMP_ID_GIMBAL3 Gimbal #3.
173 MAV_COMP_ID_GIMBAL4 Gimbal #4
174 MAV_COMP_ID_GIMBAL5 Gimbal #5.
175 MAV_COMP_ID_GIMBAL6 Gimbal #6.
180 MAV_COMP_ID_BATTERY Battery #1.
181 MAV_COMP_ID_BATTERY2 Battery #2.
189 MAV_COMP_ID_MAVCAN CAN over MAVLink client.
190 MAV_COMP_ID_MISSIONPLANNER Component that can generate/supply a mission flight plan (e.g. GCS or developer API).
191 MAV_COMP_ID_ONBOARD_COMPUTER Component that lives on the onboard computer (companion computer) and has some generic functionalities, such as settings system parameters and monitoring the status of some processes that don't directly speak mavlink and so on.
192 MAV_COMP_ID_ONBOARD_COMPUTER2 Component that lives on the onboard computer (companion computer) and has some generic functionalities, such as settings system parameters and monitoring the status of some processes that don't directly speak mavlink and so on.
193 MAV_COMP_ID_ONBOARD_COMPUTER3 Component that lives on the onboard computer (companion computer) and has some generic functionalities, such as settings system parameters and monitoring the status of some processes that don't directly speak mavlink and so on.
194 MAV_COMP_ID_ONBOARD_COMPUTER4 Component that lives on the onboard computer (companion computer) and has some generic functionalities, such as settings system parameters and monitoring the status of some processes that don't directly speak mavlink and so on.
195 MAV_COMP_ID_PATHPLANNER Component that finds an optimal path between points based on a certain constraint (e.g. minimum snap, shortest path, cost, etc.).
196 MAV_COMP_ID_OBSTACLE_AVOIDANCE Component that plans a collision free path between two points.
197 MAV_COMP_ID_VISUAL_INERTIAL_ODOMETRY Component that provides position estimates using VIO techniques.
198 MAV_COMP_ID_PAIRING_MANAGER Component that manages pairing of vehicle and GCS.
200 MAV_COMP_ID_IMU Inertial Measurement Unit (IMU) #1.
201 MAV_COMP_ID_IMU_2 Inertial Measurement Unit (IMU) #2.
202 MAV_COMP_ID_IMU_3 Inertial Measurement Unit (IMU) #3.
220 MAV_COMP_ID_GPS GPS #1.
221 MAV_COMP_ID_GPS2 GPS #2.
236 MAV_COMP_ID_ODID_TXRX_1 Open Drone ID transmitter/receiver (Bluetooth/WiFi/Internet).
237 MAV_COMP_ID_ODID_TXRX_2 Open Drone ID transmitter/receiver (Bluetooth/WiFi/Internet).
238 MAV_COMP_ID_ODID_TXRX_3 Open Drone ID transmitter/receiver (Bluetooth/WiFi/Internet).
240 MAV_COMP_ID_UDP_BRIDGE Component to bridge MAVLink to UDP (i.e. from a UART).
241 MAV_COMP_ID_UART_BRIDGE Component to bridge to UART (i.e. from UDP).
242 MAV_COMP_ID_TUNNEL_NODE Component handling TUNNEL messages (e.g. vendor specific GUI of a component).
243 MAV_COMP_ID_ILLUMINATOR Illuminator
250 MAV_COMP_ID_SYSTEM_CONTROL Deprecated, don't use. Component for handling system messages (e.g. to ARM, takeoff, etc.).
DEPRECATED: Replaced By MAV_COMP_ID_ALL (2018-11) — System control does not require a separate component ID. Instead, system commands should be sent with target_component=MAV_COMP_ID_ALL allowing the target component to use any appropriate component id.)

Commands (MAV_CMD)

MAV_CMD_NAV_WAYPOINT (16)

Navigate to waypoint. This is intended for use in missions (for guided commands outside of missions use MAV_CMD_DO_REPOSITION).

Param (Label) 描述 Units
1 (Hold) Hold time. (ignored by fixed wing, time to stay at waypoint for rotary wing) min: 0 s
2 (Accept Radius) Acceptance radius (if the sphere with this radius is hit, the waypoint counts as reached) min: 0 m
3 (Pass Radius) 0 to pass through the WP, if > 0 radius to pass by WP. Positive value for clockwise orbit, negative value for counter-clockwise orbit. Allows trajectory control. m
4 (Yaw) Desired yaw angle at waypoint (rotary wing). NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_LOITER_UNLIM (17)

Loiter around this waypoint an unlimited amount of time

Param (Label) 描述 Units
1 Empty
2 Empty
3 (Radius) Loiter radius around waypoint for forward-only moving vehicles (not multicopters). If positive loiter clockwise, else counter-clockwise m
4 (Yaw) Desired yaw angle. NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_LOITER_TURNS (18)

Loiter around this waypoint for X turns

Param (Label) 描述 Units
1 (Turns) Number of turns. min: 0
2 (Heading Required) Leave loiter circle only when track heads towards the next waypoint (MAV_BOOL_FALSE: Leave when turns complete). Values not equal to 0 or 1 are invalid. MAV_BOOL
3 (Radius) Loiter radius around waypoint for forward-only moving vehicles (not multicopters). If positive loiter clockwise, else counter-clockwise m
4 (Xtrack Location) Loiter circle exit location and/or path to next waypoint ("xtrack") for forward-only moving vehicles (not multicopters). 0 for the vehicle to converge towards the center xtrack when it leaves the loiter (the line between the centers of the current and next waypoint), 1 to converge to the direct line between the location that the vehicle exits the loiter radius and the next waypoint. NaN to use the current system default xtrack behaviour.
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_LOITER_TIME (19)

Loiter at the specified latitude, longitude and altitude for a certain amount of time. Multicopter vehicles stop at the point (within a vehicle-specific acceptance radius). Forward-only moving vehicles (e.g. fixed-wing) circle the point with the specified radius/direction. If the Heading Required parameter (2) is non-zero forward moving aircraft will only leave the loiter circle once heading towards the next waypoint.

Param (Label) 描述 Units
1 (Time) Loiter time (only starts once Lat, Lon and Alt is reached). min: 0 s
2 (Heading Required) Leave loiter circle only when track heading towards the next waypoint (MAV_BOOL_FALSE: Leave on time expiry). Values not equal to 0 or 1 are invalid. MAV_BOOL
3 (Radius) Loiter radius around waypoint for forward-only moving vehicles (not multicopters). If positive loiter clockwise, else counter-clockwise. m
4 (Xtrack Location) Loiter circle exit location and/or path to next waypoint ("xtrack") for forward-only moving vehicles (not multicopters). 0 for the vehicle to converge towards the center xtrack when it leaves the loiter (the line between the centers of the current and next waypoint), 1 to converge to the direct line between the location that the vehicle exits the loiter radius and the next waypoint. NaN to use the current system default xtrack behaviour.
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_RETURN_TO_LAUNCH (20)

Return to launch location

Param (Label) 描述
1 Empty
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_NAV_LAND (21)

Land at location.

Param (Label) 描述 Units
1 (Abort Alt) Minimum target altitude if landing is aborted (0 = undefined/use system default). m
2 (Land Mode) Precision land mode. PRECISION_LAND_MODE
3 Empty.
4 (Yaw Angle) Desired yaw angle. NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
5 (Latitude) Latitude.
6 (Longitude) Longitude.
7 (Altitude) Landing altitude (ground level in current frame). m

MAV_CMD_NAV_TAKEOFF (22)

Takeoff from ground / hand. Vehicles that support multiple takeoff modes (e.g. VTOL quadplane) should take off using the currently configured mode.

Param (Label) 描述 Units
1 (Pitch) Minimum pitch (if airspeed sensor present), desired pitch without sensor
2 Empty
3 (Flags) Bitmask of options flags. NAV_TAKEOFF_FLAGS
4 (Yaw) Yaw angle (if magnetometer present), ignored without magnetometer. NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_LAND_LOCAL (23)

Land at local position (local frame only)

Param (Label) 描述 Units
1 (Target) Landing target number (if available) min: 0 inc: 1
2 (Offset) Maximum accepted offset from desired landing position - computed magnitude from spherical coordinates: d = sqrt(x^2 + y^2 + z^2), which gives the maximum accepted distance between the desired landing position and the position where the vehicle is about to land min: 0 m
3 (Descend Rate) Landing descend rate m/s
4 (Yaw) Desired yaw angle rad
5 (Y Position) Y-axis position m
6 (X Position) X-axis position m
7 (Z Position) Z-axis / ground level position m

MAV_CMD_NAV_TAKEOFF_LOCAL (24)

Takeoff from local position (local frame only)

Param (Label) 描述 Units
1 (Pitch) Minimum pitch (if airspeed sensor present), desired pitch without sensor rad
2 Empty
3 (Ascend Rate) Takeoff ascend rate m/s
4 (Yaw) Yaw angle (if magnetometer or another yaw estimation source present), ignored without one of these rad
5 (Y Position) Y-axis position m
6 (X Position) X-axis position m
7 (Z Position) Z-axis position m

MAV_CMD_NAV_FOLLOW (25)

Vehicle following, i.e. this waypoint represents the position of a moving vehicle

Param (Label) 描述 Units
1 (Following) Following logic to use (e.g. loitering or sinusoidal following) - depends on specific autopilot implementation inc: 1
2 (Ground Speed) Ground speed of vehicle to be followed m/s
3 (Radius) Radius around waypoint. If positive loiter clockwise, else counter-clockwise m
4 (Yaw) Desired yaw angle.
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_CONTINUE_AND_CHANGE_ALT (30)

Continue on the current course and climb/descend to specified altitude. When the altitude is reached continue to the next command (i.e., don't proceed to the next command until the desired altitude is reached.

Param (Label) 描述 Units
1 (Action) Climb or Descend (0 = Neutral, command completes when within 5m of this command's altitude, 1 = Climbing, command completes when at or above this command's altitude, 2 = Descending, command completes when at or below this command's altitude. min: 0 max: 2 inc: 1
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 (Altitude) Desired altitude m

MAV_CMD_NAV_LOITER_TO_ALT (31)

Begin loiter at the specified Latitude and Longitude. If Lat=Lon=0, then loiter at the current position. Don't consider the navigation command complete (don't leave loiter) until the altitude has been reached. Additionally, if the Heading Required parameter is non-zero the aircraft will not leave the loiter until heading toward the next waypoint.

Param (Label) 描述 Units
1 (Heading Required) Leave loiter circle only when track heading towards the next waypoint (MAV_BOOL_FALSE: Leave when altitude reached). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 (Radius) Loiter radius around waypoint for forward-only moving vehicles (not multicopters). If positive loiter clockwise, negative counter-clockwise, 0 means no change to standard loiter. m
3 Empty
4 (Xtrack Location) Loiter circle exit location and/or path to next waypoint ("xtrack") for forward-only moving vehicles (not multicopters). 0 for the vehicle to converge towards the center xtrack when it leaves the loiter (the line between the centers of the current and next waypoint), 1 to converge to the direct line between the location that the vehicle exits the loiter radius and the next waypoint. NaN to use the current system default xtrack behaviour. min: 0 max: 1 inc: 1
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_DO_FOLLOW (32)

Begin following a target

Param (Label) 描述 Units
1 (System ID) System ID (of the FOLLOW_TARGET beacon). Send 0 to disable follow-me and return to the default position hold mode. min: 0 max: 255 inc: 1
2 Reserved
3 Reserved
4 (Altitude Mode) Altitude mode: 0: Keep current altitude, 1: keep altitude difference to target, 2: go to a fixed altitude above home. min: 0 max: 2 inc: 1
5 (Altitude) Altitude above home. (used if mode=2) m
6 Reserved
7 (Time to Land) Time to land in which the MAV should go to the default position hold mode after a message RX timeout. min: 0 s

MAV_CMD_DO_FOLLOW_REPOSITION (33)

Reposition the MAV after a follow target command has been sent

Param (Label) 描述 Units
1 (Camera Q1) Camera q1 (where 0 is on the ray from the camera to the tracking device)
2 (Camera Q2) Camera q2
3 (Camera Q3) Camera q3
4 (Camera Q4) Camera q4
5 (Altitude Offset) altitude offset from target m
6 (X Offset) X offset from target m
7 (Y Offset) Y offset from target m

MAV_CMD_DO_ORBIT (34)

Start orbiting on the circumference of a circle defined by the parameters. Setting values to NaN/INT32_MAX (as appropriate) results in using defaults.

Param (Label) 描述 Units
1 (Radius) Radius of the circle. Positive: orbit clockwise. Negative: orbit counter-clockwise. NaN: Use vehicle default radius, or current radius if already orbiting. m
2 (Velocity) Tangential Velocity. NaN: Use vehicle default velocity, or current velocity if already orbiting. m/s
3 (Yaw Behavior) Yaw behavior of the vehicle. ORBIT_YAW_BEHAVIOUR
4 (Orbits) Orbit around the centre point for this many radians (i.e. for a three-quarter orbit set 270*Pi/180). 0: Orbit forever. NaN: Use vehicle default, or current value if already orbiting. min: 0 rad
5 (Latitude/X) Center point latitude (if no MAV_FRAME specified) / X coordinate according to MAV_FRAME. INT32_MAX (or NaN if sent in COMMAND_LONG): Use current vehicle position, or current center if already orbiting.
6 (Longitude/Y) Center point longitude (if no MAV_FRAME specified) / Y coordinate according to MAV_FRAME. INT32_MAX (or NaN if sent in COMMAND_LONG): Use current vehicle position, or current center if already orbiting.
7 (Altitude/Z) Center point altitude (MSL) (if no MAV_FRAME specified) / Z coordinate according to MAV_FRAME. NaN: Use current vehicle altitude.

MAV_CMD_DO_FIGURE_EIGHT (35)

Fly a figure eight path as defined by the parameters.

Set parameters to NaN/INT32_MAX (as appropriate) to use system-default values. The command is intended for fixed wing vehicles (and VTOL hybrids flying in fixed-wing mode), allowing POI tracking for gimbals that don't support infinite rotation. This command only defines the flight path. Speed should be set independently (use e.g. MAV_CMD_DO_CHANGE_SPEED). Yaw and other degrees of freedom are not specified, and will be flight-stack specific (on vehicles where they can be controlled independent of the heading).

Param (Label) 描述 Units
1 (Major Radius) Major axis radius of the figure eight. Positive: orbit the north circle clockwise. Negative: orbit the north circle counter-clockwise.
NaN: The radius will be set to 2.5 times the minor radius and direction is clockwise.
Must be greater or equal to two times the minor radius for feasible values.
m
2 (Minor Radius) Minor axis radius of the figure eight. Defines the radius of the two circles that make up the figure. Negative value has no effect.
NaN: The radius will be set to the default loiter radius.
m
3
4 (Orientation) Orientation of the figure eight major axis with respect to true north (range: [-pi,pi]). NaN: use default orientation aligned to true north. rad
5 (Latitude/X) Center point latitude/X coordinate according to MAV_FRAME. If no MAV_FRAME specified, MAV_FRAME_GLOBAL is assumed.
INT32_MAX or NaN: Use current vehicle position, or current center if already loitering.
6 (Longitude/Y) Center point longitude/Y coordinate according to MAV_FRAME. If no MAV_FRAME specified, MAV_FRAME_GLOBAL is assumed.
INT32_MAX or NaN: Use current vehicle position, or current center if already loitering.
7 (Altitude/Z) Center point altitude MSL/Z coordinate according to MAV_FRAME. If no MAV_FRAME specified, MAV_FRAME_GLOBAL is assumed.
INT32_MAX or NaN: Use current vehicle altitude.

MAV_CMD_NAV_ARC_WAYPOINT (36)

Circular arc path waypoint.

This defines the end/exit point and angle (param1) of an arc path from the previous waypoint. A position is required before this command to define the start of the arc (e.g. current position, a MAV_CMD_NAV_WAYPOINT, or a MAV_CMD_NAV_ARC_WAYPOINT). The resulting path is a circular arc in the NE frame, with the difference in height being defined by the difference in waypoint altitudes.

Param (Label) 描述 Units
1 (Arc Angle) The angle in degrees from the starting position to the exit position of the arc in the NE frame. Positive values are CW arcs and negative values are CCW arcs. min: -359 max: 359 inc: 1
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_ROI (80) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_SET_ROI_* (2018-01)

Sets the region of interest (ROI) for a sensor set or the vehicle itself. This can then be used by the vehicle's control system to control the vehicle attitude and the attitude of various sensors such as cameras.

Param (Label) 描述
1 (ROI Mode) Region of interest mode. MAV_ROI
2 (WP Index) Waypoint index/ target ID. (see MAV_ROI enum) min: 0 inc: 1
3 (ROI Index) ROI index (allows a vehicle to manage multiple ROI's) min: 0 inc: 1
4 Empty
5 (X) x the location of the fixed ROI (see MAV_FRAME)
6 (Y) y
7 (Z) z

MAV_CMD_NAV_PATHPLANNING (81)

Control autonomous path planning on the MAV.

Param (Label) 描述 Units
1 (Local Ctrl) 0: Disable local obstacle avoidance / local path planning (without resetting map), 1: Enable local path planning, 2: Enable and reset local path planning min: 0 max: 2 inc: 1
2 (Global Ctrl) 0: Disable full path planning (without resetting map), 1: Enable, 2: Enable and reset map/occupancy grid, 3: Enable and reset planned route, but not occupancy grid min: 0 max: 3 inc: 1
3 Empty
4 (Yaw) Yaw angle at goal
5 (Latitude/X) Latitude/X of goal
6 (Longitude/Y) Longitude/Y of goal
7 (Altitude/Z) Altitude/Z of goal

MAV_CMD_NAV_SPLINE_WAYPOINT (82)

Navigate to waypoint using a spline path.

Param (Label) 描述 Units
1 (Hold) Hold time. (ignored by fixed wing, time to stay at waypoint for rotary wing) min: 0 s
2 Empty
3 Empty
4 Empty
5 (Latitude/X) Latitude/X of goal
6 (Longitude/Y) Longitude/Y of goal
7 (Altitude/Z) Altitude/Z of goal

MAV_CMD_NAV_VTOL_TAKEOFF (84)

Takeoff from ground using VTOL mode, and transition to forward flight with specified heading. The command should be ignored by vehicles that dont support both VTOL and fixed-wing flight (multicopters, boats,etc.).

Param (Label) 描述 Units
1 Empty
2 (Transition Heading) Front transition heading. VTOL_TRANSITION_HEADING
3 Empty
4 (Yaw Angle) Yaw angle. NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_VTOL_LAND (85)

Land using VTOL mode

Param (Label) 描述 Units
1 (Land Options) Landing behaviour. NAV_VTOL_LAND_OPTIONS
2 Empty
3 (Approach Altitude) Approach altitude (with the same reference as the Altitude field). NaN if unspecified. m
4 (Yaw) Yaw angle. NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Ground Altitude) Altitude (ground level) relative to the current coordinate frame. NaN to use system default landing altitude (ignore value). m

MAV_CMD_NAV_GUIDED_ENABLE (92)

Hand control over to an external controller

Param (Label) 描述
1 (Enable) Guided mode on (MAV_BOOL_FALSE: Off). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_NAV_DELAY (93)

Delay the next navigation command a number of seconds or until a specified time

Param (Label) 描述 Units
1 (Delay) Delay (-1 to enable time-of-day fields) min: -1 inc: 1 s
2 (Hour) hour (24h format, UTC, -1 to ignore) min: -1 max: 23 inc: 1
3 (Minute) minute (24h format, UTC, -1 to ignore) min: -1 max: 59 inc: 1
4 (Second) second (24h format, UTC, -1 to ignore) min: -1 max: 59 inc: 1
5 Empty
6 Empty
7 Empty

MAV_CMD_NAV_PAYLOAD_PLACE (94)

Descend and place payload. Vehicle moves to specified location, descends until it detects a hanging payload has reached the ground, and then releases the payload. If ground is not detected before the reaching the maximum descent value (param1), the command will complete without releasing the payload.

Param (Label) 描述 Units
1 (Max Descent) Maximum distance to descend. min: 0 m
2 Empty
3 Empty
4 Empty
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_LAST (95)

NOP - This command is only used to mark the upper limit of the NAV/ACTION commands in the enumeration

Param (Label) 描述
1 Empty
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_CONDITION_DELAY (112)

Delay mission state machine.

Param (Label) 描述 Units
1 (Delay) Delay min: 0 s
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_CONDITION_CHANGE_ALT (113)

Ascend/descend to target altitude at specified rate. Delay mission state machine until desired altitude reached.

Param (Label) 描述 Units
1 (Rate) Descent / Ascend rate. m/s
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 (Altitude) Target Altitude m

MAV_CMD_CONDITION_DISTANCE (114)

Delay mission state machine until within desired distance of next NAV point.

Param (Label) 描述 Units
1 (Distance) Distance. min: 0 m
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_CONDITION_YAW (115)

Reach a certain target angle.

Param (Label) 描述 Units
1 (Angle) target angle [0-360]. Absolute angles: 0 is north. Relative angle: 0 is initial yaw. Direction set by param3. min: 0 max: 360
2 (Angular Speed) angular speed min: 0 deg/s
3 (Direction) direction: -1: counter clockwise, 0: shortest direction, 1: clockwise min: -1 max: 1 inc: 1
4 (Relative) Relative offset (MAV_BOOL_FALSE: absolute angle). Values not equal to 0 or 1 are invalid. MAV_BOOL
5 Empty
6 Empty
7 Empty

MAV_CMD_CONDITION_LAST (159)

NOP - This command is only used to mark the upper limit of the CONDITION commands in the enumeration

Param (Label) 描述
1 Empty
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_MODE (176)

Set system mode.

Param (Label) 描述
1 (Mode) Mode flags. MAV_MODE values can be used to set some mode flag combinations. MAV_MODE_FLAG
2 (Custom Mode) Custom system-specific mode (see target autopilot specifications for mode information). If MAV_MODE_FLAG_CUSTOM_MODE_ENABLED is set in param1 (mode) this mode is used: otherwise the field is ignored.
3 (Custom Submode) Custom sub mode - this is system specific, please refer to the individual autopilot specifications for details.
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_JUMP (177)

Jump to the desired command in the mission list. Repeat this action only the specified number of times

Param (Label) 描述
1 (Number) Sequence number min: 0 inc: 1
2 (Repeat) Repeat count min: 0 inc: 1
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_CHANGE_SPEED (178)

Change speed and/or throttle set points. The value persists until it is overridden or there is a mode change

Param (Label) 描述 Units
1 (Speed Type) Speed type of value set in param2 (such as airspeed, ground speed, and so on) SPEED_TYPE
2 (Speed) Speed (-1 indicates no change, -2 indicates return to default vehicle speed) min: -2 m/s
3 (Throttle) Throttle (-1 indicates no change, -2 indicates return to default vehicle throttle value) min: -2 %
4
5
6
7

MAV_CMD_DO_SET_HOME (179)

Sets the home position to either to the current position or a specified position. The home position is the default position that the system will return to and land on. The position is set automatically by the system during the takeoff (and may also be set using this command). Note: the current home position may be emitted in a HOME_POSITION message on request (using MAV_CMD_REQUEST_MESSAGE with param1=242).

Param (Label) 描述 Units
1 (Use Current) Use current location (MAV_BOOL_FALSE: use specified location). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 (Roll) Roll angle (of surface). Range: -180..180 degrees. NAN or 0 means value not set. 0.01 indicates zero roll. min: -180 max: 180
3 (Pitch) Pitch angle (of surface). Range: -90..90 degrees. NAN or 0 means value not set. 0.01 means zero pitch. min: -90 max: 90
4 (Yaw) Yaw angle. NaN to use default heading. Range: -180..180 degrees. min: -180 max: 180
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_DO_SET_PARAMETER (180) — [DEP]

DEPRECATED: Replaced By PARAM_SET (2024-04)

Set a system parameter. Caution! Use of this command requires knowledge of the numeric enumeration value of the parameter.

Param (Label) 描述
1 (Number) Parameter number min: 0 inc: 1
2 (Value) Parameter value
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_RELAY (181)

Set a relay to a condition. The current value may optionally be reported using RELAY_STATUS.

Param (Label) 描述
1 (Instance) Relay instance number. min: 0 inc: 1
2 (Setting) Setting. (1=on, 0=off, others possible depending on system hardware) min: 0 inc: 1
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_REPEAT_RELAY (182)

Cycle a relay on and off for a desired number of cycles with a desired period.

Param (Label) 描述 Units
1 (Instance) Relay instance number. min: 0 inc: 1
2 (Count) Cycle count. min: 1 inc: 1
3 (Time) Cycle time. min: 0 s
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_SERVO (183)

Set a servo to a desired PWM value.

Param (Label) 描述 Units
1 (Instance) Servo instance number. min: 0 inc: 1
2 (PWM) Pulse Width Modulation. min: 0 inc: 1 us
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_REPEAT_SERVO (184)

Cycle a between its nominal setting and a desired PWM for a desired number of cycles with a desired period.

Param (Label) 描述 Units
1 (Instance) Servo instance number. min: 0 inc: 1
2 (PWM) Pulse Width Modulation. min: 0 inc: 1 us
3 (Count) Cycle count. min: 1 inc: 1
4 (Time) Cycle time. min: 0 s
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_FLIGHTTERMINATION (185)

Terminate flight immediately.

Flight termination immediately and irreversibly terminates the current flight, returning the vehicle to ground. The vehicle will ignore RC or other input until it has been power-cycled. Termination may trigger safety measures, including: disabling motors and deployment of parachute on multicopters, and setting flight surfaces to initiate a landing pattern on fixed-wing). On multicopters without a parachute it may trigger a crash landing. Support for this command can be tested using the protocol bit: MAV_PROTOCOL_CAPABILITY_FLIGHT_TERMINATION. Support for this command can also be tested by sending the command with param1=0 (< 0.5); the ACK should be either MAV_RESULT_FAILED or MAV_RESULT_UNSUPPORTED.

Param (Label) 描述
1 (Terminate) Flight termination activated if > 0.5. Otherwise not activated and ACK with MAV_RESULT_FAILED. min: 0 max: 1 inc: 1
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_CHANGE_ALTITUDE (186)

Change altitude set point.

Param (Label) 描述 Units
1 (Altitude) Altitude. m
2 (Frame) Frame of new altitude. MAV_FRAME
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_ACTUATOR (187)

Sets actuators (e.g. servos) to a desired value. The actuator numbers are mapped to specific outputs (e.g. on any MAIN or AUX PWM or UAVCAN) using a flight-stack specific mechanism (i.e. a parameter).

Param (Label) 描述
1 (Actuator 1) Actuator 1 value, scaled from [-1 to 1]. NaN to ignore. min: -1 max: 1
2 (Actuator 2) Actuator 2 value, scaled from [-1 to 1]. NaN to ignore. min: -1 max: 1
3 (Actuator 3) Actuator 3 value, scaled from [-1 to 1]. NaN to ignore. min: -1 max: 1
4 (Actuator 4) Actuator 4 value, scaled from [-1 to 1]. NaN to ignore. min: -1 max: 1
5 (Actuator 5) Actuator 5 value.
If sent in COMMAND_LONG: value is scaled from [-1 to 1]. NaN to ignore.
If sent in COMMAND_INT or MISSION_ITEM_INT: value is scaled by 1e7. INT32_MAX to ignore.
6 (Actuator 6) Actuator 6 value.
If sent in COMMAND_LONG: value is scaled from [-1 to 1]. NaN to ignore.
If sent in COMMAND_INT or MISSION_ITEM_INT: value is scaled by 1e7. INT32_MAX to ignore.
7 (Index) Index of actuator set (i.e if set to 1, Actuator 1 becomes Actuator 7) min: 0 inc: 1

MAV_CMD_DO_RETURN_PATH_START (188)

Mission item to specify the start of a failsafe/landing return-path segment (the end of the segment is the next MAV_CMD_DO_LAND_START item).

A vehicle that is using missions for landing (e.g. in a return mode) will join the mission on the closest path of the return-path segment (instead of MAV_CMD_DO_LAND_START or the nearest waypoint). The main use case is to minimize the failsafe flight path in corridor missions, where the inbound/outbound paths are constrained (by geofences) to the same particular path. The MAV_CMD_NAV_RETURN_PATH_START would be placed at the start of the return path. If a failsafe occurs on the outbound path the vehicle will move to the nearest point on the return path (which is parallel for this kind of mission), effectively turning round and following the shortest path to landing. If a failsafe occurs on the inbound path the vehicle is already on the return segment and will continue to landing. The Latitude/Longitude/Altitude are optional, and may be set to 0 if not needed. If specified, the item defines the waypoint at which the return segment starts. If sent using as a command, the vehicle will perform a mission landing (using the land segment if defined) or reject the command if mission landings are not supported, or no mission landing is defined. When used as a command any position information in the command is ignored.

Param (Label) 描述 Units
1 Empty
2 Empty
3 Empty
4 Empty
5 (Latitude) Latitudee. 0: not used.
6 (Longitude) Longitudee. 0: not used.
7 (Altitude) Altitudee. 0: not used. m

MAV_CMD_DO_LAND_START (189)

Mission item to mark the start of a mission landing pattern, or a command to land with a mission landing pattern.

When used in a mission, this is a marker for the start of a sequence of mission items that represent a landing pattern. It should be followed by a navigation item that defines the first waypoint of the landing sequence. The start marker positional params are used only for selecting what landing pattern to use if several are defined in the mission (the selected pattern will be the one with the marker position that is closest to the vehicle when a landing is commanded). If the marker item position has zero-values for latitude, longitude, and altitude, then landing pattern selection is instead based on the position of the first waypoint in the landing sequence.

When sent as a command it triggers a landing using a mission landing pattern. The location parameters are not used in this case, and should be set to 0.

Param (Label) 描述 Units
1 Empty
2 Empty
3 Empty
4 Empty
5 (Latitude) Latitude for landing sequence selection, or 0 (see description). Ignored in commands (set 0).
6 (Longitude) Longitude for landing sequence selection, or 0 (see description). Ignored in commands (set 0).
7 (Altitude) Altitude for landing sequence selection, or 0 (see description). Ignored in commands (set 0). m

MAV_CMD_DO_RALLY_LAND (190)

Mission command to perform a landing from a rally point.

Param (Label) 描述 Units
1 (Altitude) Break altitude m
2 (Speed) Landing speed m/s
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_GO_AROUND (191)

Mission command to safely abort an autonomous landing.

Param (Label) 描述 Units
1 (Altitude) Altitude m
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_REPOSITION (192)

Reposition the vehicle to a specific WGS84 global position. This command is intended for guided commands (for missions use MAV_CMD_NAV_WAYPOINT instead).

Param (Label) 描述 Units
1 (Speed) Ground speed, less than 0 (-1) for default min: -1 m/s
2 (Bitmask) Bitmask of option flags. MAV_DO_REPOSITION_FLAGS
3 (Radius) Loiter radius for planes. Positive values only, direction is controlled by Yaw value. A value of zero or NaN is ignored. m
4 (Yaw) Yaw heading (heading reference defined in Bitmask field). NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.). For planes indicates loiter direction (0: clockwise, 1: counter clockwise) rad
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_DO_PAUSE_CONTINUE (193)

If in a GPS controlled position mode, hold the current position or continue.

Param (Label) 描述
1 (Continue) Continue mission (MAV_BOOL_TRUE), Pause current mission or reposition command, hold current position (MAV_BOOL_FALSE). Values not equal to 0 or 1 are invalid. A VTOL capable vehicle should enter hover mode (multicopter and VTOL planes). A plane should loiter with the default loiter radius. MAV_BOOL
2 Reserved
3 Reserved
4 Reserved
5 Reserved
6 Reserved
7 Reserved

MAV_CMD_DO_SET_REVERSE (194)

Set moving direction to forward or reverse.

Param (Label) 描述
1 (Reverse) Reverse direction (MAV_BOOL_FALSE: Forward direction). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_ROI_LOCATION (195)

Sets the region of interest (ROI) to a location. This can then be used by the vehicle's control system to control the vehicle attitude and the attitude of various sensors such as cameras. This command can be sent to a gimbal manager but not to a gimbal device. A gimbal is not to react to this message.

Param (Label) 描述 Units
1 (Gimbal device ID) Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).
2 Empty
3 Empty
4 Empty
5 (Latitude) Latitude of ROI location
6 (Longitude) Longitude of ROI location
7 (Altitude) Altitude of ROI location m

MAV_CMD_DO_SET_ROI_WPNEXT_OFFSET (196)

Sets the region of interest (ROI) to be toward next waypoint, with optional pitch/roll/yaw offset. This can then be used by the vehicle's control system to control the vehicle attitude and the attitude of various sensors such as cameras. This command can be sent to a gimbal manager but not to a gimbal device. A gimbal device is not to react to this message.

Param (Label) 描述 Units
1 (Gimbal device ID) Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).
2 Empty
3 Empty
4 Empty
5 (Pitch Offset) Pitch offset from next waypoint, positive pitching up
6 (Roll Offset) Roll offset from next waypoint, positive rolling to the right
7 (Yaw Offset) Yaw offset from next waypoint, positive yawing to the right

MAV_CMD_DO_SET_ROI_NONE (197)

Cancels any previous ROI command returning the vehicle/sensors to default flight characteristics. This can then be used by the vehicle's control system to control the vehicle attitude and the attitude of various sensors such as cameras. This command can be sent to a gimbal manager but not to a gimbal device. A gimbal device is not to react to this message. After this command the gimbal manager should go back to manual input if available, and otherwise assume a neutral position.

Param (Label) 描述
1 (Gimbal device ID) Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_ROI_SYSID (198)

Mount tracks system with specified system ID. Determination of target vehicle position may be done with GLOBAL_POSITION_INT or any other means. This command can be sent to a gimbal manager but not to a gimbal device. A gimbal device is not to react to this message.

Param (Label) 描述
1 (System ID) System ID min: 1 max: 255 inc: 1
2 (Gimbal device ID) Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).

MAV_CMD_DO_CONTROL_VIDEO (200)

Control onboard camera system.

Param (Label) 描述 Units
1 (ID) Camera ID (-1 for all) min: -1 inc: 1
2 (Transmission) Transmission: 0: disabled, 1: enabled compressed, 2: enabled raw min: 0 max: 2 inc: 1
3 (Interval) Transmission mode: 0: video stream, >0: single images every n seconds min: 0 s
4 (Recording) Recording: 0: disabled, 1: enabled compressed, 2: enabled raw min: 0 max: 2 inc: 1
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_ROI (201) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_SET_ROI_* (2018-01)

Sets the region of interest (ROI) for a sensor set or the vehicle itself. This can then be used by the vehicle's control system to control the vehicle attitude and the attitude of various sensors such as cameras.

Param (Label) 描述
1 (ROI Mode) Region of interest mode. MAV_ROI
2 (WP Index) Waypoint index/ target ID (depends on param 1). min: 0 inc: 1
3 (ROI Index) Region of interest index. (allows a vehicle to manage multiple ROI's) min: 0 inc: 1
4 Empty
5 MAV_ROI_WPNEXT: pitch offset from next waypoint, MAV_ROI_LOCATION: latitude
6 MAV_ROI_WPNEXT: roll offset from next waypoint, MAV_ROI_LOCATION: longitude
7 MAV_ROI_WPNEXT: yaw offset from next waypoint, MAV_ROI_LOCATION: altitude

MAV_CMD_DO_DIGICAM_CONFIGURE (202)

Configure digital camera. This is a fallback message for systems that have not yet implemented PARAM_EXT_XXX messages and camera definition files (see https://mavlink.io/en/services/camera_def.html ).

Param (Label) 描述 Units
1 (Mode) Modes: P, TV, AV, M, Etc. min: 0 inc: 1
2 (Shutter Speed) Shutter speed: Divisor number for one second. min: 0 inc: 1
3 (Aperture) Aperture: F stop number. min: 0
4 (ISO) ISO number e.g. 80, 100, 200, Etc. min: 0 inc: 1
5 (Exposure) Exposure type enumerator.
6 (Command Identity) Command Identity.
7 (Engine Cut-off) Main engine cut-off time before camera trigger. (0 means no cut-off) min: 0 inc: 1 ds

MAV_CMD_DO_DIGICAM_CONTROL (203)

Control digital camera. This is a fallback message for systems that have not yet implemented PARAM_EXT_XXX messages and camera definition files (see https://mavlink.io/en/services/camera_def.html ).

Param (Label) 描述
1 (Session Control) Session control e.g. show/hide lens
2 (Zoom Absolute) Zoom's absolute position
3 (Zoom Relative) Zooming step value to offset zoom from the current position
4 (Focus) Focus Locking, Unlocking or Re-locking
5 (Shoot Command) Shooting Command
6 (Command Identity) Command Identity
7 (Shot ID) Test shot identifier. If set to 1, image will only be captured, but not counted towards internal frame count.

MAV_CMD_DO_MOUNT_CONFIGURE (204) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_GIMBAL_MANAGER_CONFIGURE (2020-01) — The message can still be used to communicate with legacy gimbals implementing it.)

Mission command to configure a camera or antenna mount

Param (Label) 描述
1 (Mode) Mount operation mode MAV_MOUNT_MODE
2 (Stabilize Roll) Stabilize roll (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
3 (Stabilize Pitch) Stabilize pitch (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
4 (Stabilize Yaw) Stabilize yaw (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
5 (Roll Input Mode) Roll input (0 = angle body frame, 1 = angular rate, 2 = angle absolute frame)
6 (Pitch Input Mode) Pitch input (0 = angle body frame, 1 = angular rate, 2 = angle absolute frame)
7 (Yaw Input Mode) Yaw input (0 = angle body frame, 1 = angular rate, 2 = angle absolute frame)

MAV_CMD_DO_MOUNT_CONTROL (205) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_GIMBAL_MANAGER_PITCHYAW (2020-01) — This message is ambiguous and inconsistent. It has been superseded by MAV_CMD_DO_GIMBAL_MANAGER_PITCHYAW and MAV_CMD_DO_SET_ROI_* variants. The message can still be used to communicate with legacy gimbals implementing it.)

Mission command to control a camera or antenna mount

Param (Label) 描述 Units
1 (Pitch) pitch depending on mount mode (degrees or degrees/second depending on pitch input).
2 (Roll) roll depending on mount mode (degrees or degrees/second depending on roll input).
3 (Yaw) yaw depending on mount mode (degrees or degrees/second depending on yaw input).
4 (Altitude) altitude depending on mount mode. m
5 (Latitude) latitude, set if appropriate mount mode.
6 (Longitude) longitude, set if appropriate mount mode.
7 (Mode) Mount mode. MAV_MOUNT_MODE

MAV_CMD_DO_SET_CAM_TRIGG_DIST (206)

Mission command to set camera trigger distance for this flight. The camera is triggered each time this distance is exceeded. This command can also be used to set the shutter integration time for the camera.

Param (Label) 描述 Units
1 (Distance) Camera trigger distance. 0 to stop triggering. min: 0 m
2 (Shutter) Camera shutter integration time. -1 or 0 to ignore min: -1 inc: 1 ms
3 (Trigger) Trigger camera once, immediately (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
4 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_FENCE_ENABLE (207)

Enable the geofence. This can be used in a mission or via the command protocol. The persistence/lifetime of the setting is undefined. Depending on flight stack implementation it may persist until superseded, or it may revert to a system default at the end of a mission. Flight stacks typically reset the setting to system defaults on reboot.

Param (Label) 描述
1 (Enable) enable? (0=disable, 1=enable, 2=disable_floor_only) min: 0 max: 2 inc: 1
2 (Types) Fence types to enable or disable as a bitmask. 0: field is unused/all fences should be enabled or disabled (for compatibility reasons). Parameter is ignored if param1=2. FENCE_TYPE
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_PARACHUTE (208)

Mission item/command to release a parachute or enable/disable auto release.

Param (Label) 描述
1 (Action) Action PARACHUTE_ACTION
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_MOTOR_TEST (209)

Command to perform motor test.

Param (Label) 描述 Units
1 (Instance) Motor instance number (from 1 to max number of motors on the vehicle). min: 1 inc: 1
2 (Throttle Type) Throttle type (whether the Throttle Value in param3 is a percentage, PWM value, etc.) MOTOR_TEST_THROTTLE_TYPE
3 (Throttle) Throttle value.
4 (Timeout) Timeout between tests that are run in sequence. min: 0 s
5 (Motor Count) Motor count. Number of motors to test in sequence: 0/1=one motor, 2= two motors, etc. The Timeout (param4) is used between tests. min: 0 inc: 1
6 (Test Order) Motor test order. MOTOR_TEST_ORDER
7 Empty

MAV_CMD_DO_INVERTED_FLIGHT (210)

Change to/from inverted flight.

Param (Label) 描述
1 (Inverted) Inverted flight (MAV_BOOL_False: normal flight). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_GRIPPER (211)

Mission command to operate a gripper.

Param (Label) 描述
1 (Gripper ID) Gripper ID. 1-6 for an autopilot connected gripper. In missions this may be set to 1-6 for an autopilot gripper, or the gripper component id for a MAVLink gripper. 0 targets all grippers. min: 0 inc: 1
2 (Action) Gripper action to perform. GRIPPER_ACTIONS
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_AUTOTUNE_ENABLE (212)

Enable/disable autotune.

Param (Label) 描述
1 (Enable) Enable autotune (MAV_BOOL_FALSE: disable autotune). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 (Axis) Specify axes for which autotuning is enabled/disabled. 0 indicates the field is unused (for compatibility reasons). If 0 the autopilot will follow its default behaviour, which is usually to tune all axes. AUTOTUNE_AXIS
3 Empty.
4 Empty.
5 Empty.
6 Empty.
7 Empty.

MAV_CMD_NAV_SET_YAW_SPEED (213)

Sets a desired vehicle turn angle and speed change.

Param (Label) 描述 Units
1 (Yaw) Yaw angle to adjust steering by.
2 (Speed) Speed. m/s
3 (Angle) Relative final angle (MAV_BOOL_FALSE: Absolute angle). Values not equal to 0 or 1 are invalid. MAV_BOOL
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_CAM_TRIGG_INTERVAL (214)

Mission command to set camera trigger interval for this flight. If triggering is enabled, the camera is triggered each time this interval expires. This command can also be used to set the shutter integration time for the camera.

Param (Label) 描述 Units
1 (Trigger Cycle) Camera trigger cycle time. -1 or 0 to ignore. min: -1 inc: 1 ms
2 (Shutter Integration) Camera shutter integration time. Should be less than trigger cycle time. -1 or 0 to ignore. min: -1 inc: 1 ms
3 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_MOUNT_CONTROL_QUAT (220) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_DO_GIMBAL_MANAGER_PITCHYAW (2020-01)

Mission command to control a camera or antenna mount, using a quaternion as reference.

Param (Label) 描述
1 (Q1) quaternion param q1, w (1 in null-rotation)
2 (Q2) quaternion param q2, x (0 in null-rotation)
3 (Q3) quaternion param q3, y (0 in null-rotation)
4 (Q4) quaternion param q4, z (0 in null-rotation)
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_GUIDED_MASTER (221)

set id of master controller

Param (Label) 描述
1 (System ID) System ID min: 0 max: 255 inc: 1
2 (Component ID) Component ID min: 0 max: 255 inc: 1
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_GUIDED_LIMITS (222)

Set limits for external control

Param (Label) 描述 Units
1 (Timeout) Timeout - maximum time that external controller will be allowed to control vehicle. 0 means no timeout. min: 0 s
2 (Min Altitude) Altitude (MSL) min - if vehicle moves below this alt, the command will be aborted and the mission will continue. 0 means no lower altitude limit. m
3 (Max Altitude) Altitude (MSL) max - if vehicle moves above this alt, the command will be aborted and the mission will continue. 0 means no upper altitude limit. m
4 (Horiz. Move Limit) Horizontal move limit - if vehicle moves more than this distance from its location at the moment the command was executed, the command will be aborted and the mission will continue. 0 means no horizontal move limit. min: 0 m
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_ENGINE_CONTROL (223)

Control vehicle engine. This is interpreted by the vehicles engine controller to change the target engine state. It is intended for vehicles with internal combustion engines

Param (Label) 描述 Units
1 (Start Engine) Start engine (MAV_BOOL_False: Stop engine). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 (Cold Start) Cold start engine (MAV_BOOL_FALSE: Warm start). Values not equal to 0 or 1 are invalid. Controls use of choke where applicable MAV_BOOL
3 (Height Delay) Height delay. This is for commanding engine start only after the vehicle has gained the specified height. Used in VTOL vehicles during takeoff to start engine after the aircraft is off the ground. Zero for no delay. min: 0 m
4 (Options) A bitmask of options for engine control ENGINE_CONTROL_OPTIONS
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_SET_MISSION_CURRENT (224)

Set the mission item with sequence number seq as the current item and emit MISSION_CURRENT (whether or not the mission number changed). If a mission is currently being executed, the system will continue to this new mission item on the shortest path, skipping any intermediate mission items. Note that mission jump repeat counters are not reset unless param2 is set (see MAV_CMD_DO_JUMP param2).

This command may trigger a mission state-machine change on some systems: for example from MISSION_STATE_NOT_STARTED or MISSION_STATE_PAUSED to MISSION_STATE_ACTIVE. If the system is in mission mode, on those systems this command might therefore start, restart or resume the mission. If the system is not in mission mode this command must not trigger a switch to mission mode.

The mission may be "reset" using param2. Resetting sets jump counters to initial values (to reset counters without changing the current mission item set the param1 to -1). Resetting also explicitly changes a mission state of MISSION_STATE_COMPLETE to MISSION_STATE_PAUSED or MISSION_STATE_ACTIVE, potentially allowing it to resume when it is (next) in a mission mode.

The command will ACK with MAV_RESULT_FAILED if the sequence number is out of range (including if there is no mission item).

Param (Label) 描述
1 (Number) Mission sequence value to set. -1 for the current mission item (use to reset mission without changing current mission item). min: -1 inc: 1
2 (Reset Mission) Reset mission (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. Resets jump counters to initial values and changes mission state "completed" to be "active" or "paused". MAV_BOOL
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_DO_LAST (240)

NOP - This command is only used to mark the upper limit of the DO commands in the enumeration

Param (Label) 描述
1 Empty
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_PREFLIGHT_CALIBRATION (241)

Trigger calibration. 只有在飞行前模式下才会接受此命令。 Except for Temperature Calibration, only one sensor should be set in a single message and all others should be zero.

Param (Label) 描述
1 (Gyro Temperature) 1: gyro calibration, 3: gyro temperature calibration min: 0 max: 3 inc: 1
2 (Magnetometer) Magnetometer calibration action. PREFLIGHT_CALIBRATION_MAGNETOMETER
3 (Ground Pressure) Ground pressure calibration. Values not equal to 0 or 1 are invalid. MAV_BOOL
4 (Remote Control) 1: radio RC calibration, 2: RC trim calibration min: 0 max: 1 inc: 1
5 (Accelerometer) Accelerometer calibration action. PREFLIGHT_CALIBRATION_ACCELEROMETER
6 (Compmot or Airspeed) 1: APM: compass/motor interference calibration (PX4: airspeed calibration, deprecated), 2: airspeed calibration min: 0 max: 2 inc: 1
7 (ESC or Baro) 1: ESC calibration, 3: barometer temperature calibration min: 0 max: 3 inc: 1

MAV_CMD_PREFLIGHT_SET_SENSOR_OFFSETS (242)

Set sensor offsets. 只有在飞行前模式下才会接受此命令。

Param (Label) 描述
1 (Sensor Type) Sensor to adjust the offsets for: 0: gyros, 1: accelerometer, 2: magnetometer, 3: barometer, 4: optical flow, 5: second magnetometer, 6: third magnetometer min: 0 max: 6 inc: 1
2 (X Offset) X axis offset (or generic dimension 1), in the sensor's raw units
3 (Y Offset) Y axis offset (or generic dimension 2), in the sensor's raw units
4 (Z Offset) Z axis offset (or generic dimension 3), in the sensor's raw units
5 (4th Dimension) Generic dimension 4, in the sensor's raw units
6 (5th Dimension) Generic dimension 5, in the sensor's raw units
7 (6th Dimension) Generic dimension 6, in the sensor's raw units

MAV_CMD_PREFLIGHT_UAVCAN (243)

Trigger UAVCAN configuration (actuator ID assignment and direction mapping). Note that this maps to the legacy UAVCAN v0 function UAVCAN_ENUMERATE, which is intended to be executed just once during initial vehicle configuration (it is not a normal pre-flight command and has been poorly named).

Param (Label) 描述
1 (Actuator ID) 1: Trigger actuator ID assignment and direction mapping. 0: Cancel command.
2 Reserved
3 Reserved
4 Reserved
5 Reserved
6 Reserved
7 Reserved

MAV_CMD_PREFLIGHT_STORAGE (245)

Request storage of different parameter values and logs. 只有在飞行前模式下才会接受此命令。

Param (Label) 描述 Units
1 (Parameter Storage) Action to perform on the persistent parameter storage PREFLIGHT_STORAGE_PARAMETER_ACTION
2 (Mission Storage) Action to perform on the persistent mission storage PREFLIGHT_STORAGE_MISSION_ACTION
3 (Logging Rate) Onboard logging: 0: Ignore, 1: Start default rate logging, -1: Stop logging, > 1: logging rate (e.g. set to 1000 for 1000 Hz logging) min: -1 inc: 1 Hz
4 Reserved
5 Empty
6 Empty
7 Empty

MAV_CMD_PREFLIGHT_REBOOT_SHUTDOWN (246)

Request the reboot or shutdown of system components.

Param (Label) 描述
1 (Autopilot) Action to take for autopilot. REBOOT_SHUTDOWN_ACTION
2 (Companion) Action to take for onboard computer. REBOOT_SHUTDOWN_ACTION
3 (Component Action) Action to take for component specified in param4. REBOOT_SHUTDOWN_ACTION
4 (Component ID) MAVLink Component ID targeted in param3 (0 for all components). min: 0 max: 255 inc: 1
5 Reserved (set to 0)
6 (Conditions) Conditions under which reboot/shutdown is allowed. REBOOT_SHUTDOWN_CONDITIONS
7 WIP: ID (e.g. camera ID -1 for all IDs)

MAV_CMD_OVERRIDE_GOTO (252)

Override current mission with command to pause mission, pause mission and move to position, continue/resume mission. When param 1 indicates that the mission is paused (MAV_GOTO_DO_HOLD), param 2 defines whether it holds in place or moves to another position.

Param (Label) 描述 Units
1 (Continue) MAV_GOTO_DO_HOLD: pause mission and either hold or move to specified position (depending on param2), MAV_GOTO_DO_CONTINUE: resume mission. MAV_GOTO
2 (Position) MAV_GOTO_HOLD_AT_CURRENT_POSITION: hold at current position, MAV_GOTO_HOLD_AT_SPECIFIED_POSITION: hold at specified position. MAV_GOTO
3 (Frame) Coordinate frame of hold point. MAV_FRAME
4 (Yaw) Desired yaw angle.
5 (Latitude/X) Latitude/X position.
6 (Longitude/Y) Longitude/Y position.
7 (Altitude/Z) Altitude/Z position.

MAV_CMD_OBLIQUE_SURVEY (260)

Mission command to set a Camera Auto Mount Pivoting Oblique Survey (Replaces CAM_TRIGG_DIST for this purpose). The camera is triggered each time this distance is exceeded, then the mount moves to the next position. Params 4~6 set-up the angle limits and number of positions for oblique survey, where mount-enabled vehicles automatically roll the camera between shots to emulate an oblique camera setup (providing an increased HFOV). This command can also be used to set the shutter integration time for the camera.

Param (Label) 描述 Units
1 (Distance) Camera trigger distance. 0 to stop triggering. min: 0 m
2 (Shutter) Camera shutter integration time. 0 to ignore min: 0 inc: 1 ms
3 (Min Interval) The minimum interval in which the camera is capable of taking subsequent pictures repeatedly. 0 to ignore. min: 0 max: 10000 inc: 1 ms
4 (Positions) Total number of roll positions at which the camera will capture photos (images captures spread evenly across the limits defined by param5). min: 2 inc: 1
5 (Roll Angle) Angle limits that the camera can be rolled to left and right of center. min: 0
6 (Pitch Angle) Fixed pitch angle that the camera will hold in oblique mode if the mount is actuated in the pitch axis. min: -180 max: 180
7 Empty

MAV_CMD_DO_SET_STANDARD_MODE (262)

Enable the specified standard MAVLink mode.

If the specified mode is not supported, the vehicle should ACK with MAV_RESULT_FAILED. See https://mavlink.io/en/services/standard_modes.html

Param (Label) 描述
1 (Standard Mode) The mode to set. MAV_STANDARD_MODE
2
3
4
5
6
7

MAV_CMD_MISSION_START (300)

start running a mission

Param (Label) 描述
1 (First Item) first_item: the first mission item to run min: 0 inc: 1
2 (Last Item) last_item: the last mission item to run (after this item is run, the mission ends) min: 0 inc: 1

MAV_CMD_ACTUATOR_TEST (310)

Actuator testing command. This is similar to MAV_CMD_DO_MOTOR_TEST but operates on the level of output functions, i.e. it is possible to test Motor1 independent from which output it is configured on. Autopilots must NACK this command with MAV_RESULT_TEMPORARILY_REJECTED while armed.

Param (Label) 描述 Units
1 (Value) Output value: 1 means maximum positive output, 0 to center servos or minimum motor thrust (expected to spin), -1 for maximum negative (if not supported by the motors, i.e. motor is not reversible, smaller than 0 maps to NaN). And NaN maps to disarmed (stop the motors). min: -1 max: 1
2 (Timeout) Timeout after which the test command expires and the output is restored to the previous value. A timeout has to be set for safety reasons. A timeout of 0 means to restore the previous value immediately. min: 0 max: 3 s
3
4
5 (Output Function) Actuator Output function ACTUATOR_OUTPUT_FUNCTION
6
7

MAV_CMD_CONFIGURE_ACTUATOR (311)

Actuator configuration command.

Param (Label) 描述
1 (Configuration) Actuator configuration action ACTUATOR_CONFIGURATION
2
3
4
5 (Output Function) Actuator Output function ACTUATOR_OUTPUT_FUNCTION
6
7

MAV_CMD_COMPONENT_ARM_DISARM (400)

Arms / Disarms a component

Param (Label) 描述
1 (Arm) Arm (MAV_BOOL_FALSE: disarm). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 (Force) 0: arm-disarm unless prevented by safety checks (i.e. when landed), 21196: force arming/disarming (e.g. allow arming to override preflight checks and disarming in flight) min: 0 max: 21196 inc: 21196

MAV_CMD_RUN_PREARM_CHECKS (401)

Instructs a target system to run pre-arm checks.

This allows preflight checks to be run on demand, which may be useful on systems that normally run them at low rate, or which do not trigger checks when the armable state might have changed. This command should return MAV_RESULT_ACCEPTED if it will run the checks. The results of the checks are usually then reported in SYS_STATUS messages (this is system-specific). The command should return MAV_RESULT_TEMPORARILY_REJECTED if the system is already armed.

Param (Label) 描述

MAV_CMD_ILLUMINATOR_ON_OFF (405)

Turns illuminators ON/OFF. An illuminator is a light source that is used for lighting up dark areas external to the system: e.g. a torch or searchlight (as opposed to a light source for illuminating the system itself, e.g. an indicator light).

Param (Label) 描述
1 (Enable) Illuminators on/off (MAV_BOOL_TRUE: illuminators on). Values not equal to 0 or 1 are invalid. MAV_BOOL

MAV_CMD_DO_ILLUMINATOR_CONFIGURE (406)

Configures illuminator settings. An illuminator is a light source that is used for lighting up dark areas external to the system: e.g. a torch or searchlight (as opposed to a light source for illuminating the system itself, e.g. an indicator light).

Param (Label) 描述 Units
1 (Mode) Mode ILLUMINATOR_MODE
2 (Brightness) 0%: Off, 100%: Max Brightness min: 0 max: 100 %
3 (Strobe Period) Strobe period in seconds where 0 means strobing is not used min: 0 s
4 (Strobe Duty) Strobe duty cycle where 100% means it is on constantly and 0 means strobing is not used min: 0 max: 100 %

MAV_CMD_GET_HOME_POSITION (410) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2022-04)

Request the home position from the vehicle.

The vehicle will ACK the command and emit the HOME_POSITION message.

Param (Label) 描述
1 Reserved
2 Reserved
3 Reserved
4 Reserved
5 Reserved
6 Reserved
7 Reserved

MAV_CMD_INJECT_FAILURE (420)

Inject artificial failure for testing purposes. Note that autopilots should implement an additional protection before accepting this command such as a specific param setting.

Param (Label) 描述
1 (Failure unit) The unit which is affected by the failure. FAILURE_UNIT
2 (Failure type) The type how the failure manifests itself. FAILURE_TYPE
3 (Instance) Instance affected by failure (0 to signal all).

MAV_CMD_START_RX_PAIR (500)

Starts receiver pairing.

Param (Label) 描述
1 (RC Type) RC type. RC_TYPE
2 (RC Sub Type) RC sub type. RC_SUB_TYPE

MAV_CMD_GET_MESSAGE_INTERVAL (510) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2022-04)

Request the interval between messages for a particular MAVLink message ID. The receiver should ACK the command and then emit its response in a MESSAGE_INTERVAL message.

Param (Label) 描述
1 (Message ID) The MAVLink message ID min: 0 max: 16777215 inc: 1

MAV_CMD_SET_MESSAGE_INTERVAL (511)

Set the interval between messages for a particular MAVLink message ID. This interface replaces REQUEST_DATA_STREAM.

Param (Label) 描述 Units
1 (Message ID) The MAVLink message ID min: 0 max: 16777215 inc: 1
2 (Interval) The interval between two messages. -1: disable. 0: request default rate (which may be zero). min: -1 inc: 1 us
3 (Req Param 3) Use for index ID, if required. Otherwise, the use of this parameter (if any) must be defined in the requested message. By default assumed not used (0). When used as an index ID, 0 means "all instances", "1" means the first instance in the sequence (the emitted message will have an id of 0 if message ids are 0-indexed, or 1 if index numbers start from one).
4 (Req Param 4) The use of this parameter (if any), must be defined in the requested message. By default assumed not used (0).
5 (Req Param 5) The use of this parameter (if any), must be defined in the requested message. By default assumed not used (0/NaN).
6 (Req Param 6) The use of this parameter (if any), must be defined in the requested message. By default assumed not used (0/NaN).
7 (Response Target) Target address of message stream (if message has target address fields). 0: Flight-stack default (recommended), 1: address of requester, 2: broadcast. min: 0 max: 2 inc: 1

MAV_CMD_REQUEST_MESSAGE (512)

Request the target system(s) emit a single instance of a specified message (i.e. a "one-shot" version of MAV_CMD_SET_MESSAGE_INTERVAL).

Param (Label) 描述
1 (Message ID) The MAVLink message ID of the requested message. min: 0 max: 16777215 inc: 1
2 (Req Param 1) Use for index ID, if required. Otherwise, the use of this parameter (if any) must be defined in the requested message. By default assumed not used (0).
3 (Req Param 2) The use of this parameter (if any), must be defined in the requested message. By default assumed not used (0).
4 (Req Param 3) The use of this parameter (if any), must be defined in the requested message. By default assumed not used (0).
5 (Req Param 4) The use of this parameter (if any), must be defined in the requested message. By default assumed not used (0).
6 (Req Param 5) The use of this parameter (if any), must be defined in the requested message. By default assumed not used (0).
7 (Response Target) Target address for requested message (if message has target address fields). 0: Flight-stack default, 1: address of requester, 2: broadcast. min: 0 max: 2 inc: 1

MAV_CMD_REQUEST_PROTOCOL_VERSION (519) — [DEP]

DEPRECATED: Replaced By MAV_CMD_REQUEST_MESSAGE (2025-11)

Request MAVLink protocol version compatibility. All receivers should ACK the command and then emit their capabilities in an PROTOCOL_VERSION message

Param (Label) 描述
1 (Protocol) Request supported protocol versions by all nodes on the network (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Reserved (all remaining params)

MAV_CMD_REQUEST_AUTOPILOT_CAPABILITIES (520) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request autopilot capabilities. The receiver should ACK the command and then emit its capabilities in an AUTOPILOT_VERSION message

Param (Label) 描述
1 (Version) Request autopilot version (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Reserved (all remaining params)

MAV_CMD_REQUEST_CAMERA_INFORMATION (521) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request camera information (CAMERA_INFORMATION).

Param (Label) 描述
1 (Capabilities) Request camera capabilities (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Reserved (all remaining params)

MAV_CMD_REQUEST_CAMERA_SETTINGS (522) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request camera settings (CAMERA_SETTINGS).

Param (Label) 描述
1 (Settings) Request camera settings (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Reserved (all remaining params)

MAV_CMD_REQUEST_STORAGE_INFORMATION (525) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request storage information (STORAGE_INFORMATION). Use the command's target_component to target a specific component's storage.

Param (Label) 描述
1 (Storage ID) Storage ID (0 for all, 1 for first, 2 for second, etc.) min: 0 inc: 1
2 (Information) Request storage information (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
3 Reserved (all remaining params)

MAV_CMD_STORAGE_FORMAT (526)

Format a storage medium. Once format is complete, a STORAGE_INFORMATION message is sent. Use the command's target_component to target a specific component's storage.

Param (Label) 描述
1 (Storage ID) Storage ID (1 for first, 2 for second, etc.) min: 0 inc: 1
2 (Format) Format storage (and reset image log). Values not equal to 0 or 1 are invalid. MAV_BOOL
3 (Reset Image Log) Reset Image Log (without formatting storage medium). This will reset CAMERA_CAPTURE_STATUS.image_count and CAMERA_IMAGE_CAPTURED.image_index. Values not equal to 0 or 1 are invalid. MAV_BOOL
4 Reserved (all remaining params)

MAV_CMD_REQUEST_CAMERA_CAPTURE_STATUS (527) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request camera capture status (CAMERA_CAPTURE_STATUS)

Param (Label) 描述
1 (Capture Status) Request camera capture status (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Reserved (all remaining params)

MAV_CMD_REQUEST_FLIGHT_INFORMATION (528) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request flight information (FLIGHT_INFORMATION)

Param (Label) 描述
1 (Flight Information) Request flight information (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Reserved (all remaining params)

MAV_CMD_RESET_CAMERA_SETTINGS (529)

Reset all camera settings to Factory Default

Param (Label) 描述
1 (Reset) Reset all settings (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1

MAV_CMD_SET_CAMERA_MODE (530)

Set camera running mode. Use NaN for reserved values. GCS will send a MAV_CMD_REQUEST_VIDEO_STREAM_STATUS command after a mode change if the camera supports video streaming.

Param (Label) 描述
1 (id) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
2 (Camera Mode) Camera mode CAMERA_MODE
3
4
7

MAV_CMD_SET_CAMERA_ZOOM (531)

Set camera zoom. Camera must respond with a CAMERA_SETTINGS message (on success).

Param (Label) 描述
1 (Zoom Type) Zoom type CAMERA_ZOOM_TYPE
2 (Zoom Value) Zoom value. The range of valid values depend on the zoom type.
3 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
4

MAV_CMD_SET_CAMERA_FOCUS (532)

Set camera focus. Camera must respond with a CAMERA_SETTINGS message (on success).

Param (Label) 描述
1 (Focus Type) Focus type SET_FOCUS_TYPE
2 (Focus Value) Focus value
3 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
4

MAV_CMD_SET_STORAGE_USAGE (533)

Set that a particular storage is the preferred location for saving photos, videos, and/or other media (e.g. to set that an SD card is used for storing videos).

There can only be one preferred save location for each particular media type: setting a media usage flag will clear/reset that same flag if set on any other storage. If no flag is set the system should use its default storage. A target system can choose to always use default storage, in which case it should ACK the command with MAV_RESULT_UNSUPPORTED. A target system can choose to not allow a particular storage to be set as preferred storage, in which case it should ACK the command with MAV_RESULT_DENIED.

Param (Label) 描述
1 (Storage ID) Storage ID (1 for first, 2 for second, etc.) min: 0 inc: 1
2 (Usage) Usage flags STORAGE_USAGE_FLAG

MAV_CMD_SET_CAMERA_SOURCE (534)

Set camera source. Changes the camera's active sources on cameras with multiple image sensors.

Param (Label) 描述
1 (device id) Component Id of camera to address or 1-6 for non-MAVLink cameras, 0 for all cameras.
2 (primary source) Primary Source CAMERA_SOURCE
3 (secondary source) Secondary Source. If non-zero the second source will be displayed as picture-in-picture. CAMERA_SOURCE

MAV_CMD_JUMP_TAG (600)

Tagged jump target. Can be jumped to with MAV_CMD_DO_JUMP_TAG.

Param (Label) 描述
1 (Tag) Tag. min: 0 inc: 1

MAV_CMD_DO_JUMP_TAG (601)

Jump to the matching tag in the mission list. Repeat this action for the specified number of times. A mission should contain a single matching tag for each jump. If this is not the case then a jump to a missing tag should complete the mission, and a jump where there are multiple matching tags should always select the one with the lowest mission sequence number.

Param (Label) 描述
1 (Tag) Target tag to jump to. min: 0 inc: 1
2 (Repeat) Repeat count. min: 0 inc: 1

MAV_CMD_DO_GIMBAL_MANAGER_PITCHYAW (1000)

Set gimbal manager pitch/yaw setpoints (low rate command). It is possible to set combinations of the values below. E.g. an angle as well as a desired angular rate can be used to get to this angle at a certain angular rate, or an angular rate only will result in continuous turning. NaN is to be used to signal unset. Note: only the gimbal manager will react to this command - it will be ignored by a gimbal device. Use GIMBAL_MANAGER_SET_PITCHYAW if you need to stream pitch/yaw setpoints at higher rate.

Param (Label) 描述 Units
1 (Pitch angle) Pitch angle (positive to pitch up, relative to vehicle for FOLLOW mode, relative to world horizon for LOCK mode). min: -180 max: 180
2 (Yaw angle) Yaw angle (positive to yaw to the right, relative to vehicle for FOLLOW mode, absolute to North for LOCK mode). min: -180 max: 180
3 (Pitch rate) Pitch rate (positive to pitch up). deg/s
4 (Yaw rate) Yaw rate (positive to yaw to the right). deg/s
5 (Gimbal manager flags) Gimbal manager flags to use. GIMBAL_MANAGER_FLAGS
7 (Gimbal device ID) Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).

MAV_CMD_DO_GIMBAL_MANAGER_CONFIGURE (1001)

Gimbal configuration to set which sysid/compid is in primary and secondary control.

Param (Label) 描述
1 (sysid primary control) Sysid for primary control (0: no one in control, -1: leave unchanged, -2: set itself in control (for missions where the own sysid is still unknown), -3: remove control if currently in control).
2 (compid primary control) Compid for primary control (0: no one in control, -1: leave unchanged, -2: set itself in control (for missions where the own sysid is still unknown), -3: remove control if currently in control).
3 (sysid secondary control) Sysid for secondary control (0: no one in control, -1: leave unchanged, -2: set itself in control (for missions where the own sysid is still unknown), -3: remove control if currently in control).
4 (compid secondary control) Compid for secondary control (0: no one in control, -1: leave unchanged, -2: set itself in control (for missions where the own sysid is still unknown), -3: remove control if currently in control).
7 (Gimbal device ID) Component ID of gimbal device to address (or 1-6 for non-MAVLink gimbal), 0 for all gimbal device components. Send command multiple times for more than one gimbal (but not all gimbals).

MAV_CMD_IMAGE_START_CAPTURE (2000)

Start image capture sequence. CAMERA_IMAGE_CAPTURED must be emitted after each capture.

Param1 (id) may be used to specify the target camera: 0: all cameras, 1 to 6: autopilot-connected cameras, 7-255: MAVLink camera component ID. It is needed in order to target specific cameras connected to the autopilot, or specific sensors in a multi-sensor camera (neither of which have a distinct MAVLink component ID). It is also needed to specify the target camera in missions.

When used in a mission, an autopilot should execute the MAV_CMD for a specified local camera (param1 = 1-6), or resend it as a command if it is intended for a MAVLink camera (param1 = 7 - 255), setting the command's target_component as the param1 value (and setting param1 in the command to zero). If the param1 is 0 the autopilot should do both.

When sent in a command the target MAVLink address is set using target_component. If addressed specifically to an autopilot: param1 should be used in the same way as it is for missions (though command should NACK with MAV_RESULT_DENIED if a specified local camera does not exist). If addressed to a MAVLink camera, param 1 can be used to address all cameras (0), or to separately address 1 to 7 individual sensors. Other values should be NACKed with MAV_RESULT_DENIED. If the command is broadcast (target_component is 0) then param 1 should be set to 0 (any other value should be NACKED with MAV_RESULT_DENIED). An autopilot would trigger any local cameras and forward the command to all channels.

Param (Label) 描述 Units
1 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
2 (Interval) Desired elapsed time between two consecutive pictures (in seconds). Minimum values depend on hardware (typically greater than 2 seconds). min: 0 s
3 (Total Images) Total number of images to capture. 0 to capture forever/until MAV_CMD_IMAGE_STOP_CAPTURE. min: 0 inc: 1
4 (Sequence Number) Capture sequence number starting from 1. This is only valid for single-capture (param3 == 1), otherwise set to 0. Increment the capture ID for each capture command to prevent double captures when a command is re-transmitted. min: 1 inc: 1
5
6
7

MAV_CMD_IMAGE_STOP_CAPTURE (2001)

Stop image capture sequence.

Param1 (id) may be used to specify the target camera: 0: all cameras, 1 to 6: autopilot-connected cameras, 7-255: MAVLink camera component ID. It is needed in order to target specific cameras connected to the autopilot, or specific sensors in a multi-sensor camera (neither of which have a distinct MAVLink component ID). It is also needed to specify the target camera in missions.

When used in a mission, an autopilot should execute the MAV_CMD for a specified local camera (param1 = 1-6), or resend it as a command if it is intended for a MAVLink camera (param1 = 7 - 255), setting the command's target_component as the param1 value (and setting param1 in the command to zero). If the param1 is 0 the autopilot should do both.

When sent in a command the target MAVLink address is set using target_component. If addressed specifically to an autopilot: param1 should be used in the same way as it is for missions (though command should NACK with MAV_RESULT_DENIED if a specified local camera does not exist). If addressed to a MAVLink camera, param1 can be used to address all cameras (0), or to separately address 1 to 7 individual sensors. Other values should be NACKed with MAV_RESULT_DENIED. If the command is broadcast (target_component is 0) then param 1 should be set to 0 (any other value should be NACKED with MAV_RESULT_DENIED). An autopilot would trigger any local cameras and forward the command to all channels.

Param (Label) 描述
1 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
2
3
4
5
6
7

MAV_CMD_REQUEST_CAMERA_IMAGE_CAPTURE (2002) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Re-request a CAMERA_IMAGE_CAPTURED message.

Param (Label) 描述
1 (Number) Sequence number for missing CAMERA_IMAGE_CAPTURED message min: 0 inc: 1
2
3
4
5
6
7

MAV_CMD_DO_TRIGGER_CONTROL (2003)

Enable or disable on-board camera triggering system.

Param (Label) 描述
1 (Enable) Trigger enable/disable (0 for disable, 1 for start), -1 to ignore min: -1 max: 1 inc: 1
2 (Reset) 1 to reset the trigger sequence, -1 or 0 to ignore min: -1 max: 1 inc: 1
3 (Pause) 1 to pause triggering, but without switching the camera off or retracting it. -1 to ignore min: -1 max: 1 inc: 2
4 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1

MAV_CMD_CAMERA_TRACK_POINT (2004)

If the camera supports point visual tracking (CAMERA_CAP_FLAGS_HAS_TRACKING_POINT is set), this command allows to initiate the tracking.

Param (Label) 描述
1 (Point x) Point to track x value (normalized 0..1, 0 is left, 1 is right). min: 0 max: 1
2 (Point y) Point to track y value (normalized 0..1, 0 is top, 1 is bottom). min: 0 max: 1
3 (Radius) Point radius (normalized 0..1, 0 is one pixel, 1 is full image width). min: 0 max: 1
4 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1

MAV_CMD_CAMERA_TRACK_RECTANGLE (2005)

If the camera supports rectangle visual tracking (CAMERA_CAP_FLAGS_HAS_TRACKING_RECTANGLE is set), this command allows to initiate the tracking.

Param (Label) 描述
1 (Top left corner x) Top left corner of rectangle x value (normalized 0..1, 0 is left, 1 is right). min: 0 max: 1
2 (Top left corner y) Top left corner of rectangle y value (normalized 0..1, 0 is top, 1 is bottom). min: 0 max: 1
3 (Bottom right corner x) Bottom right corner of rectangle x value (normalized 0..1, 0 is left, 1 is right). min: 0 max: 1
4 (Bottom right corner y) Bottom right corner of rectangle y value (normalized 0..1, 0 is top, 1 is bottom). min: 0 max: 1
5 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1

MAV_CMD_CAMERA_STOP_TRACKING (2010)

Stops ongoing tracking.

Param (Label) 描述
1 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1

MAV_CMD_VIDEO_START_CAPTURE (2500)

Starts video capture (recording).

Param (Label) 描述 Units
1 (Stream ID) Video Stream ID (0 for all streams) min: 0 inc: 1
2 (Status Frequency) Frequency CAMERA_CAPTURE_STATUS messages should be sent while recording (0 for no messages, otherwise frequency) min: 0 Hz
3 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
4
5
6
7

MAV_CMD_VIDEO_STOP_CAPTURE (2501)

Stop the current video capture (recording).

Param (Label) 描述
1 (Stream ID) Video Stream ID (0 for all streams) min: 0 inc: 1
2 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1
3
4
5
6
7

MAV_CMD_VIDEO_START_STREAMING (2502)

Start video streaming

Param (Label) 描述
1 (Stream ID) Video Stream ID (0 for all streams, 1 for first, 2 for second, etc.) min: 0 inc: 1
2 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1

MAV_CMD_VIDEO_STOP_STREAMING (2503)

Stop the given video stream

Param (Label) 描述
1 (Stream ID) Video Stream ID (0 for all streams, 1 for first, 2 for second, etc.) min: 0 inc: 1
2 (Target Camera ID) Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission. min: 0 max: 255 inc: 1

MAV_CMD_REQUEST_VIDEO_STREAM_INFORMATION (2504) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request video stream information (VIDEO_STREAM_INFORMATION)

Param (Label) 描述
1 (Stream ID) Video Stream ID (0 for all streams, 1 for first, 2 for second, etc.) min: 0 inc: 1

MAV_CMD_REQUEST_VIDEO_STREAM_STATUS (2505) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2019-08)

Request video stream status (VIDEO_STREAM_STATUS)

Param (Label) 描述
1 (Stream ID) Video Stream ID (0 for all streams, 1 for first, 2 for second, etc.) min: 0 inc: 1

MAV_CMD_LOGGING_START (2510)

Request to start streaming logging data over MAVLink (see also LOGGING_DATA message)

Param (Label) 描述
1 (Format) Format: 0: ULog min: 0 inc: 1
2 Reserved (set to 0)
3 Reserved (set to 0)
4 Reserved (set to 0)
5 Reserved (set to 0)
6 Reserved (set to 0)
7 Reserved (set to 0)

MAV_CMD_LOGGING_STOP (2511)

Request to stop streaming log data over MAVLink

Param (Label) 描述
1 Reserved (set to 0)
2 Reserved (set to 0)
3 Reserved (set to 0)
4 Reserved (set to 0)
5 Reserved (set to 0)
6 Reserved (set to 0)
7 Reserved (set to 0)

MAV_CMD_AIRFRAME_CONFIGURATION (2520)

Param (Label) 描述
1 (Landing Gear ID) Landing gear ID (default: 0, -1 for all) min: -1 inc: 1
2 (Landing Gear Position) Landing gear position (Down: 0, Up: 1, NaN for no change)
3
4
5
6
7

MAV_CMD_CONTROL_HIGH_LATENCY (2600)

Request to start/stop transmitting over the high latency telemetry

Param (Label) 描述
1 (Enable) Start transmission over high latency telemetry (MAV_BOOL_FALSE: stop transmission). Values not equal to 0 or 1 are invalid. MAV_BOOL
2 Empty
3 Empty
4 Empty
5 Empty
6 Empty
7 Empty

MAV_CMD_PANORAMA_CREATE (2800)

Create a panorama at the current position

Param (Label) 描述 Units
1 (Horizontal Angle) Viewing angle horizontal of the panorama (+- 0.5 the total angle)
2 (Vertical Angle) Viewing angle vertical of panorama.
3 (Horizontal Speed) Speed of the horizontal rotation. deg/s
4 (Vertical Speed) Speed of the vertical rotation. deg/s

MAV_CMD_DO_VTOL_TRANSITION (3000)

Request VTOL transition

Param (Label) 描述
1 (State) The target VTOL state. For normal transitions, only MAV_VTOL_STATE_MC and MAV_VTOL_STATE_FW can be used. MAV_VTOL_STATE
2 (Immediate) Force immediate transition to the specified MAV_VTOL_STATE. 1: Force immediate, 0: normal transition. Can be used, for example, to trigger an emergency "Quadchute". Caution: Can be dangerous/damage vehicle, depending on autopilot implementation of this command.

MAV_CMD_ARM_AUTHORIZATION_REQUEST (3001)

Request authorization to arm the vehicle to a external entity, the arm authorizer is responsible to request all data that is needs from the vehicle before authorize or deny the request.

If approved the COMMAND_ACK message progress field should be set with period of time that this authorization is valid in seconds. If the authorization is denied COMMAND_ACK.result_param2 should be set with one of the reasons in MAV_ARM_AUTH_DENIED_REASON.

Param (Label) 描述
1 (System ID) Vehicle system id, this way ground station can request arm authorization on behalf of any vehicle min: 0 max: 255 inc: 1

MAV_CMD_SET_GUIDED_SUBMODE_STANDARD (4000)

This command sets the submode to standard guided when vehicle is in guided mode. The vehicle holds position and altitude and the user can input the desired velocities along all three axes.

Param (Label) 描述

MAV_CMD_SET_GUIDED_SUBMODE_CIRCLE (4001)

This command sets submode circle when vehicle is in guided mode. Vehicle flies along a circle facing the center of the circle. The user can input the velocity along the circle and change the radius. If no input is given the vehicle will hold position.

Param (Label) 描述 Units
1 (Radius) Radius of desired circle in CIRCLE_MODE m
2 User defined
3 User defined
4 User defined
5 (Latitude) Target latitude of center of circle in CIRCLE_MODE degE7
6 (Longitude) Target longitude of center of circle in CIRCLE_MODE degE7

MAV_CMD_CONDITION_GATE (4501) — [WIP]

WORK IN PROGRESS: Do not use in stable production environments (it may change).

Delay mission state machine until gate has been reached.

Param (Label) 描述 Units
1 (Geometry) Geometry: 0: orthogonal to path between previous and next waypoint. min: 0 inc: 1
2 (UseAltitude) Use altitude (MAV_BOOL_FALSE: ignore altitude). Values not equal to 0 or 1 are invalid. MAV_BOOL
3 Empty
4 Empty
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_FENCE_RETURN_POINT (5000)

Fence return point (there can only be one such point in a geofence definition). If rally points are supported they should be used instead.

Param (Label) 描述 Units
1 Reserved
2 Reserved
3 Reserved
4 Reserved
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_NAV_FENCE_POLYGON_VERTEX_INCLUSION (5001)

Fence vertex for an inclusion polygon (the polygon must not be self-intersecting). The vehicle must stay within this area. Minimum of 3 vertices required.

The vertices for a polygon must be sent sequentially, each with param1 set to the total number of vertices in the polygon.

Param (Label) 描述
1 (Vertex Count) Polygon vertex count. This is the number of vertices in the current polygon (all vertices will have the same number). min: 3 inc: 1
2 (Inclusion Group) Vehicle must be inside ALL inclusion zones in a single group, vehicle must be inside at least one group, must be the same for all points in each polygon min: 0 inc: 1
3 Reserved
4 Reserved
5 (Latitude) Latitude
6 (Longitude) Longitude
7 Reserved

MAV_CMD_NAV_FENCE_POLYGON_VERTEX_EXCLUSION (5002)

Fence vertex for an exclusion polygon (the polygon must not be self-intersecting). The vehicle must stay outside this area. Minimum of 3 vertices required.

The vertices for a polygon must be sent sequentially, each with param1 set to the total number of vertices in the polygon.

Param (Label) 描述
1 (Vertex Count) Polygon vertex count. This is the number of vertices in the current polygon (all vertices will have the same number). min: 3 inc: 1
2 Reserved
3 Reserved
4 Reserved
5 (Latitude) Latitude
6 (Longitude) Longitude
7 Reserved

MAV_CMD_NAV_FENCE_CIRCLE_INCLUSION (5003)

Circular fence area. The vehicle must stay inside this area.

Param (Label) 描述 Units
1 (Radius) Radius. m
2 (Inclusion Group) Vehicle must be inside ALL inclusion zones in a single group, vehicle must be inside at least one group min: 0 inc: 1
3 Reserved
4 Reserved
5 (Latitude) Latitude
6 (Longitude) Longitude
7 Reserved

MAV_CMD_NAV_FENCE_CIRCLE_EXCLUSION (5004)

Circular fence area. The vehicle must stay outside this area.

Param (Label) 描述 Units
1 (Radius) Radius. m
2 Reserved
3 Reserved
4 Reserved
5 (Latitude) Latitude
6 (Longitude) Longitude
7 Reserved

MAV_CMD_NAV_RALLY_POINT (5100)

Rally point. You can have multiple rally points defined.

Param (Label) 描述 Units
1 Reserved
2 Reserved
3 Reserved
4 Reserved
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude m

MAV_CMD_UAVCAN_GET_NODE_INFO (5200) — [SUP]

SUPERSEDED: Replaced By MAV_CMD_REQUEST_MESSAGE (2026-05)

Commands the vehicle to respond with a sequence of messages UAVCAN_NODE_INFO, one message per every UAVCAN node that is online. Note that some of the response messages can be lost, which the receiver can detect easily by checking whether every received UAVCAN_NODE_STATUS has a matching message UAVCAN_NODE_INFO received earlier; if not, this command should be sent again in order to request re-transmission of the node information messages.

Param (Label) 描述
1 Reserved (set to 0)
2 Reserved (set to 0)
3 Reserved (set to 0)
4 Reserved (set to 0)
5 Reserved (set to 0)
6 Reserved (set to 0)
7 Reserved (set to 0)

MAV_CMD_DO_SET_SAFETY_SWITCH_STATE (5300)

Change state of safety switch.

Param (Label) 描述
1 (Desired State) New safety switch state. SAFETY_SWITCH_STATE
2 Empty.
3 Empty.
4 Empty
5 Empty.
6 Empty.
7 Empty.

MAV_CMD_DO_ADSB_OUT_IDENT (10001)

Trigger the start of an ADSB-out IDENT. This should only be used when requested to do so by an Air Traffic Controller in controlled airspace. This starts the IDENT which is then typically held for 18 seconds by the hardware per the Mode A, C, and S transponder spec.

Param (Label) 描述
1 Reserved (set to 0)
2 Reserved (set to 0)
3 Reserved (set to 0)
4 Reserved (set to 0)
5 Reserved (set to 0)
6 Reserved (set to 0)
7 Reserved (set to 0)

MAV_CMD_PAYLOAD_PREPARE_DEPLOY (30001) — [SUP]

SUPERSEDED:(2021-06)

Deploy payload on a Lat / Lon / Alt position. This includes the navigation to reach the required release position and velocity.

Param (Label) 描述 Units
1 (Operation Mode) Operation mode. 0: prepare single payload deploy (overwriting previous requests), but do not execute it. 1: execute payload deploy immediately (rejecting further deploy commands during execution, but allowing abort). 2: add payload deploy to existing deployment list. min: 0 max: 2 inc: 1
2 (Approach Vector) Desired approach vector in compass heading. A negative value indicates the system can define the approach vector at will. min: -1 max: 360
3 (Ground Speed) Desired ground speed at release time. This can be overridden by the airframe in case it needs to meet minimum airspeed. A negative value indicates the system can define the ground speed at will. min: -1
4 (Altitude Clearance) Minimum altitude clearance to the release position. A negative value indicates the system can define the clearance at will. min: -1 m
5 (Latitude) Latitude. degE7
6 (Longitude) Longitude. degE7
7 (Altitude) Altitude (MSL) m

MAV_CMD_PAYLOAD_CONTROL_DEPLOY (30002) — [SUP]

SUPERSEDED:(2021-06)

Control the payload deployment.

Param (Label) 描述
1 (Operation Mode) Operation mode. 0: Abort deployment, continue normal mission. 1: switch to payload deployment mode. 100: delete first payload deployment request. 101: delete all payload deployment requests. min: 0 max: 101 inc: 1
2 Reserved
3 Reserved
4 Reserved
5 Reserved
6 Reserved
7 Reserved

MAV_CMD_WAYPOINT_USER_1 (31000)

User defined waypoint item. Ground Station will show the Vehicle as flying through this item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_WAYPOINT_USER_2 (31001)

User defined waypoint item. Ground Station will show the Vehicle as flying through this item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_WAYPOINT_USER_3 (31002)

User defined waypoint item. Ground Station will show the Vehicle as flying through this item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_WAYPOINT_USER_4 (31003)

User defined waypoint item. Ground Station will show the Vehicle as flying through this item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_WAYPOINT_USER_5 (31004)

User defined waypoint item. Ground Station will show the Vehicle as flying through this item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_SPATIAL_USER_1 (31005)

User defined spatial item. Ground Station will not show the Vehicle as flying through this item. Example: ROI item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_SPATIAL_USER_2 (31006)

User defined spatial item. Ground Station will not show the Vehicle as flying through this item. Example: ROI item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_SPATIAL_USER_3 (31007)

User defined spatial item. Ground Station will not show the Vehicle as flying through this item. Example: ROI item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_SPATIAL_USER_4 (31008)

User defined spatial item. Ground Station will not show the Vehicle as flying through this item. Example: ROI item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_SPATIAL_USER_5 (31009)

User defined spatial item. Ground Station will not show the Vehicle as flying through this item. Example: ROI item.

Param (Label) 描述 Units
1 User defined
2 User defined
3 User defined
4 User defined
5 (Latitude) Latitude unscaled
6 (Longitude) Longitude unscaled
7 (Altitude) Altitude (MSL) m

MAV_CMD_USER_1 (31010)

User defined command. Ground Station will not show the Vehicle as flying through this item. Example: MAV_CMD_DO_SET_PARAMETER item.

Param (Label) 描述
1 User defined
2 User defined
3 User defined
4 User defined
5 User defined
6 User defined
7 User defined

MAV_CMD_USER_2 (31011)

User defined command. Ground Station will not show the Vehicle as flying through this item. Example: MAV_CMD_DO_SET_PARAMETER item.

Param (Label) 描述
1 User defined
2 User defined
3 User defined
4 User defined
5 User defined
6 User defined
7 User defined

MAV_CMD_USER_3 (31012)

User defined command. Ground Station will not show the Vehicle as flying through this item. Example: MAV_CMD_DO_SET_PARAMETER item.

Param (Label) 描述
1 User defined
2 User defined
3 User defined
4 User defined
5 User defined
6 User defined
7 User defined

MAV_CMD_USER_4 (31013)

User defined command. Ground Station will not show the Vehicle as flying through this item. Example: MAV_CMD_DO_SET_PARAMETER item.

Param (Label) 描述
1 User defined
2 User defined
3 User defined
4 User defined
5 User defined
6 User defined
7 User defined

MAV_CMD_USER_5 (31014)

User defined command. Ground Station will not show the Vehicle as flying through this item. Example: MAV_CMD_DO_SET_PARAMETER item.

Param (Label) 描述
1 User defined
2 User defined
3 User defined
4 User defined
5 User defined
6 User defined
7 User defined

MAV_CMD_CAN_FORWARD (32000)

Request forwarding of CAN packets from the given CAN bus to this component via this MAVLink channel. CAN Frames are sent using CAN_FRAME and CANFD_FRAME messages

Param (Label) 描述
1 (bus) Bus number (0 to disable forwarding, 1 for first bus, 2 for 2nd bus, 3 for 3rd bus).
2 Empty.
3 Empty.
4 Empty.
5 Empty.
6 Empty.
7 Empty.

MAV_CMD_FIXED_MAG_CAL_YAW (42006)

Magnetometer calibration based on provided known yaw. This allows for fast calibration using WMM field tables in the vehicle, given only the known yaw of the vehicle. If Latitude and longitude are both zero then use the current vehicle location.

Param (Label) 描述 Units
1 (Yaw) Yaw of vehicle in earth frame.
2 (CompassMask) CompassMask, 0 for all.
3 (Latitude) Latitude.
4 (Longitude) Longitude.
5 Empty.
6 Empty.
7 Empty.

MAV_CMD_DO_WINCH (42600)

Command to operate winch.

Param (Label) 描述 Units
1 (Instance) Winch instance number. min: 1 inc: 1
2 (Action) Action to perform. WINCH_ACTIONS
3 (Length) Length of line to release (negative to wind). m
4 (Rate) Release rate (negative to wind). m/s
5 Empty.
6 Empty.
7 Empty.

MAV_CMD_GUIDED_CHANGE_HEADING (43002)

Change to target direction at a given rate, overriding previous heading/s. This slews the vehicle at a controllable rate between its previous heading and the new one.

Param (Label) 描述 Units
1 (Heading Type) Course-over-ground or raw vehicle heading. HEADING_TYPE
2 (Heading Target) Target heading. min: 0 max: 359.99
3 (Heading Rate of Change) Maximum centripetal acceleration, i.e. rate of change toward new heading. deg/s

MAV_CMD_EXTERNAL_POSITION_ESTIMATE (43003)

Provide an external position estimate for use when dead-reckoning. This is meant to be used for occasional position resets that may be provided by a external system such as a remote pilot using landmarks over a video link.

Param (Label) 描述 Units
1 (transmission_time) Timestamp that this message was sent as a time in the transmitters time domain. The sender should wrap this time back to zero based on required timing accuracy for the application and the limitations of a 32 bit float. For example, wrapping at 10 hours would give approximately 1ms accuracy. Recipient must handle time wrap in any timing jitter correction applied to this field. Wrap rollover time should not be at not more than 250 seconds, which would give approximately 10 microsecond accuracy. s
2 (processing_time) The time spent in processing the sensor data that is the basis for this position. The recipient can use this to improve time alignment of the data. Set to zero if not known. s
3 (accuracy) estimated one standard deviation accuracy of the measurement. Set to NaN if not known.
4 Empty
5 (Latitude) Latitude
6 (Longitude) Longitude
7 (Altitude) Altitude, not used. Should be sent as NaN. May be supported in a future version of this message. m