Skip to content

Commit 0337d87

Browse files
committed
MAVLink messages update Wed Jun 11 01:30:36 UTC 2025
1 parent 118bde2 commit 0337d87

File tree

3 files changed

+26
-26
lines changed

3 files changed

+26
-26
lines changed

en/messages/common.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4000,25 +4000,25 @@ Value | Name | Description
40004000
<a id='MAV_GOTO_HOLD_AT_CURRENT_POSITION'></a>2 | [MAV_GOTO_HOLD_AT_CURRENT_POSITION](#MAV_GOTO_HOLD_AT_CURRENT_POSITION) | Hold at the current position of the system
40014001
<a id='MAV_GOTO_HOLD_AT_SPECIFIED_POSITION'></a>3 | [MAV_GOTO_HOLD_AT_SPECIFIED_POSITION](#MAV_GOTO_HOLD_AT_SPECIFIED_POSITION) | Hold at the position specified in the parameters of the [DO_HOLD](#DO_HOLD) action
40024002

4003-
### MAV_MODE {#MAV_MODE}
4003+
### MAV_MODE — [DEP] {#MAV_MODE}
40044004

4005-
These defines are predefined OR-combined mode flags. There is no need to use values from this enum, but it
4005+
<span class="warning">**DEPRECATED:** Replaced By [MAV_MODE_FLAG](#MAV_MODE_FLAG) (2025-02) — Using [MAV_MODE](#MAV_MODE) to set modes is less predictable than using standard modes ([MAV_STANDARD_MODE](#MAV_STANDARD_MODE)) or custom modes ([MAV_MODE_FLAG_CUSTOM_MODE_ENABLED](#MAV_MODE_FLAG_CUSTOM_MODE_ENABLED)).)</span>
40064006

4007-
simplifies the use of the mode flags. Note that manual input is enabled in all modes as a safety override.
4007+
Predefined OR-combined [MAV_MODE_FLAG](#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.
40084008

40094009
Value | Name | Description
40104010
--- | --- | ---
40114011
<a id='MAV_MODE_PREFLIGHT'></a>0 | [MAV_MODE_PREFLIGHT](#MAV_MODE_PREFLIGHT) | System is not ready to fly, booting, calibrating, etc. No flag is set.
4012-
<a id='MAV_MODE_MANUAL_DISARMED'></a>64 | [MAV_MODE_MANUAL_DISARMED](#MAV_MODE_MANUAL_DISARMED) | System is allowed to be active, under manual (RC) control, no stabilization
4013-
<a id='MAV_MODE_TEST_DISARMED'></a>66 | [MAV_MODE_TEST_DISARMED](#MAV_MODE_TEST_DISARMED) | UNDEFINED mode. This solely depends on the autopilot - use with caution, intended for developers only.
4014-
<a id='MAV_MODE_STABILIZE_DISARMED'></a>80 | [MAV_MODE_STABILIZE_DISARMED](#MAV_MODE_STABILIZE_DISARMED) | System is allowed to be active, under assisted RC control.
4015-
<a id='MAV_MODE_GUIDED_DISARMED'></a>88 | [MAV_MODE_GUIDED_DISARMED](#MAV_MODE_GUIDED_DISARMED) | System is allowed to be active, under autonomous control, manual setpoint
4016-
<a id='MAV_MODE_AUTO_DISARMED'></a>92 | [MAV_MODE_AUTO_DISARMED](#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)
4017-
<a id='MAV_MODE_MANUAL_ARMED'></a>192 | [MAV_MODE_MANUAL_ARMED](#MAV_MODE_MANUAL_ARMED) | System is allowed to be active, under manual (RC) control, no stabilization
4018-
<a id='MAV_MODE_TEST_ARMED'></a>194 | [MAV_MODE_TEST_ARMED](#MAV_MODE_TEST_ARMED) | UNDEFINED mode. This solely depends on the autopilot - use with caution, intended for developers only.
4019-
<a id='MAV_MODE_STABILIZE_ARMED'></a>208 | [MAV_MODE_STABILIZE_ARMED](#MAV_MODE_STABILIZE_ARMED) | System is allowed to be active, under assisted RC control.
4020-
<a id='MAV_MODE_GUIDED_ARMED'></a>216 | [MAV_MODE_GUIDED_ARMED](#MAV_MODE_GUIDED_ARMED) | System is allowed to be active, under autonomous control, manual setpoint
4021-
<a id='MAV_MODE_AUTO_ARMED'></a>220 | [MAV_MODE_AUTO_ARMED](#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)
4012+
<a id='MAV_MODE_MANUAL_DISARMED'></a>64 | [MAV_MODE_MANUAL_DISARMED](#MAV_MODE_MANUAL_DISARMED) | System is allowed to be active, under manual (RC) control, no stabilization ([MAV_MODE_FLAG_MANUAL_INPUT_ENABLED](#MAV_MODE_FLAG_MANUAL_INPUT_ENABLED))
4013+
<a id='MAV_MODE_TEST_DISARMED'></a>66 | [MAV_MODE_TEST_DISARMED](#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_MANUAL_INPUT_ENABLED), [MAV_MODE_FLAG_TEST_ENABLED](#MAV_MODE_FLAG_TEST_ENABLED)).
4014+
<a id='MAV_MODE_STABILIZE_DISARMED'></a>80 | [MAV_MODE_STABILIZE_DISARMED](#MAV_MODE_STABILIZE_DISARMED) | System is allowed to be active, under assisted RC control ([MAV_MODE_FLAG_SAFETY_ARMED](#MAV_MODE_FLAG_SAFETY_ARMED), [MAV_MODE_FLAG_STABILIZE_ENABLED](#MAV_MODE_FLAG_STABILIZE_ENABLED))
4015+
<a id='MAV_MODE_GUIDED_DISARMED'></a>88 | [MAV_MODE_GUIDED_DISARMED](#MAV_MODE_GUIDED_DISARMED) | System is allowed to be active, under autonomous control, manual setpoint ([MAV_MODE_FLAG_SAFETY_ARMED](#MAV_MODE_FLAG_SAFETY_ARMED), [MAV_MODE_FLAG_STABILIZE_ENABLED](#MAV_MODE_FLAG_STABILIZE_ENABLED), [MAV_MODE_FLAG_GUIDED_ENABLED](#MAV_MODE_FLAG_GUIDED_ENABLED))
4016+
<a id='MAV_MODE_AUTO_DISARMED'></a>92 | [MAV_MODE_AUTO_DISARMED](#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_SAFETY_ARMED), [MAV_MODE_FLAG_STABILIZE_ENABLED](#MAV_MODE_FLAG_STABILIZE_ENABLED), [MAV_MODE_FLAG_GUIDED_ENABLED](#MAV_MODE_FLAG_GUIDED_ENABLED), [MAV_MODE_FLAG_AUTO_ENABLED](#MAV_MODE_FLAG_AUTO_ENABLED)).
4017+
<a id='MAV_MODE_MANUAL_ARMED'></a>192 | [MAV_MODE_MANUAL_ARMED](#MAV_MODE_MANUAL_ARMED) | System is allowed to be active, under manual (RC) control, no stabilization ([MAV_MODE_FLAG_SAFETY_ARMED](#MAV_MODE_FLAG_SAFETY_ARMED), [MAV_MODE_FLAG_MANUAL_INPUT_ENABLED](#MAV_MODE_FLAG_MANUAL_INPUT_ENABLED))
4018+
<a id='MAV_MODE_TEST_ARMED'></a>194 | [MAV_MODE_TEST_ARMED](#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_SAFETY_ARMED), [MAV_MODE_FLAG_MANUAL_INPUT_ENABLED](#MAV_MODE_FLAG_MANUAL_INPUT_ENABLED), [MAV_MODE_FLAG_TEST_ENABLED](#MAV_MODE_FLAG_TEST_ENABLED))
4019+
<a id='MAV_MODE_STABILIZE_ARMED'></a>208 | [MAV_MODE_STABILIZE_ARMED](#MAV_MODE_STABILIZE_ARMED) | System is allowed to be active, under assisted RC control ([MAV_MODE_FLAG_SAFETY_ARMED](#MAV_MODE_FLAG_SAFETY_ARMED), [MAV_MODE_FLAG_MANUAL_INPUT_ENABLED](#MAV_MODE_FLAG_MANUAL_INPUT_ENABLED), [MAV_MODE_FLAG_STABILIZE_ENABLED](#MAV_MODE_FLAG_STABILIZE_ENABLED))
4020+
<a id='MAV_MODE_GUIDED_ARMED'></a>216 | [MAV_MODE_GUIDED_ARMED](#MAV_MODE_GUIDED_ARMED) | System is allowed to be active, under autonomous control, manual setpoint ([MAV_MODE_FLAG_SAFETY_ARMED](#MAV_MODE_FLAG_SAFETY_ARMED), [MAV_MODE_FLAG_MANUAL_INPUT_ENABLED](#MAV_MODE_FLAG_MANUAL_INPUT_ENABLED), [MAV_MODE_FLAG_STABILIZE_ENABLED](#MAV_MODE_FLAG_STABILIZE_ENABLED), [MAV_MODE_FLAG_GUIDED_ENABLED](#MAV_MODE_FLAG_GUIDED_ENABLED))
4021+
<a id='MAV_MODE_AUTO_ARMED'></a>220 | [MAV_MODE_AUTO_ARMED](#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_SAFETY_ARMED), [MAV_MODE_FLAG_MANUAL_INPUT_ENABLED](#MAV_MODE_FLAG_MANUAL_INPUT_ENABLED), [MAV_MODE_FLAG_STABILIZE_ENABLED](#MAV_MODE_FLAG_STABILIZE_ENABLED), [MAV_MODE_FLAG_GUIDED_ENABLED](#MAV_MODE_FLAG_GUIDED_ENABLED),MAV_MODE_FLAG_AUTO_ENABLED).
40224022

40234023
### MAV_SYS_STATUS_SENSOR {#MAV_SYS_STATUS_SENSOR}
40244024

@@ -6169,11 +6169,11 @@ Value | Name | Description
61696169

61706170
### MAV_MODE_FLAG — \[from: [minimal](../messages/minimal.md#MAV_MODE_FLAG)\] {#MAV_MODE_FLAG}
61716171

6172-
(Bitmask) These flags encode the MAV mode.
6172+
(Bitmask) These flags encode the MAV mode, see [MAV_MODE](#MAV_MODE) enum for useful combinations.
61736173

61746174
Value | Name | Description
61756175
--- | --- | ---
6176-
<a id='MAV_MODE_FLAG_CUSTOM_MODE_ENABLED'></a>1 | [MAV_MODE_FLAG_CUSTOM_MODE_ENABLED](#MAV_MODE_FLAG_CUSTOM_MODE_ENABLED) | 0b00000001 Reserved for future use.
6176+
<a id='MAV_MODE_FLAG_CUSTOM_MODE_ENABLED'></a>1 | [MAV_MODE_FLAG_CUSTOM_MODE_ENABLED](#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.
61776177
<a id='MAV_MODE_FLAG_TEST_ENABLED'></a>2 | [MAV_MODE_FLAG_TEST_ENABLED](#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.
61786178
<a id='MAV_MODE_FLAG_AUTO_ENABLED'></a>4 | [MAV_MODE_FLAG_AUTO_ENABLED](#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.
61796179
<a id='MAV_MODE_FLAG_GUIDED_ENABLED'></a>8 | [MAV_MODE_FLAG_GUIDED_ENABLED](#MAV_MODE_FLAG_GUIDED_ENABLED) | 0b00001000 guided mode enabled, system flies waypoints / mission items.
@@ -6812,8 +6812,8 @@ Set system mode.
68126812

68136813
Param (Label) | Description | Values
68146814
--- | --- | ---
6815-
1 (Mode) | Mode | [MAV_MODE](#MAV_MODE)
6816-
2 (Custom Mode) | Custom mode - this is system specific, please refer to the individual autopilot specifications for details. |
6815+
1 (Mode) | Mode flags. MAV_MODE values can be used to set some mode flag combinations. | [MAV_MODE_FLAG](#MAV_MODE_FLAG)
6816+
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. |
68176817
3 (Custom Submode) | Custom sub mode - this is system specific, please refer to the individual autopilot specifications for details. |
68186818
4 | Empty |
68196819
5 | Empty |

en/messages/dialects.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,18 +17,18 @@ Dialects are not managed by this project!
1717

1818
The dialect definitions are:
1919

20-
- [cubepilot.xml](cubepilot.md)
20+
- [storm32.xml](storm32.md)
21+
- [uAvionix.xml](uAvionix.md)
22+
- [matrixpilot.xml](matrixpilot.md)
2123
- [ardupilotmega.xml](ardupilotmega.md)
22-
- [icarous.xml](icarous.md)
23-
- [loweheiser.xml](loweheiser.md)
24-
- [paparazzi.xml](paparazzi.md)
2524
- [csAirLink.xml](csAirLink.md)
26-
- [storm32.xml](storm32.md)
25+
- [loweheiser.xml](loweheiser.md)
2726
- [ASLUAV.xml](ASLUAV.md)
2827
- [ualberta.xml](ualberta.md)
29-
- [matrixpilot.xml](matrixpilot.md)
28+
- [cubepilot.xml](cubepilot.md)
29+
- [paparazzi.xml](paparazzi.md)
30+
- [icarous.xml](icarous.md)
3031
- [AVSSUAS.xml](AVSSUAS.md)
31-
- [uAvionix.xml](uAvionix.md)
3232

3333
Note that dialects may `include` [MAVLink-Standard Definitions](index.md) or other dialects.
3434
Up to 5 levels of XML file nesting are allowed - see `MAXIMUM_INCLUDE_FILE_NESTING` in [mavgen.py](https://github.com/ArduPilot/pymavlink/blob/master/generator/mavgen.py#L44).

en/messages/minimal.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -162,11 +162,11 @@ Value | Name | Description
162162

163163
### MAV_MODE_FLAG {#MAV_MODE_FLAG}
164164

165-
(Bitmask) These flags encode the MAV mode.
165+
(Bitmask) These flags encode the MAV mode, see [MAV_MODE](#MAV_MODE) enum for useful combinations.
166166

167167
Value | Name | Description
168168
--- | --- | ---
169-
<a id='MAV_MODE_FLAG_CUSTOM_MODE_ENABLED'></a>1 | [MAV_MODE_FLAG_CUSTOM_MODE_ENABLED](#MAV_MODE_FLAG_CUSTOM_MODE_ENABLED) | 0b00000001 Reserved for future use.
169+
<a id='MAV_MODE_FLAG_CUSTOM_MODE_ENABLED'></a>1 | [MAV_MODE_FLAG_CUSTOM_MODE_ENABLED](#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.
170170
<a id='MAV_MODE_FLAG_TEST_ENABLED'></a>2 | [MAV_MODE_FLAG_TEST_ENABLED](#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.
171171
<a id='MAV_MODE_FLAG_AUTO_ENABLED'></a>4 | [MAV_MODE_FLAG_AUTO_ENABLED](#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.
172172
<a id='MAV_MODE_FLAG_GUIDED_ENABLED'></a>8 | [MAV_MODE_FLAG_GUIDED_ENABLED](#MAV_MODE_FLAG_GUIDED_ENABLED) | 0b00001000 guided mode enabled, system flies waypoints / mission items.

0 commit comments

Comments
 (0)