mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-11-22 22:31:04 +08:00
MAVLink 2 now supports 32-bit system IDs. The uORB fields carrying a MAVLink system ID need to hold them, so VehicleStatus (v5), VehicleCommand (v1), VehicleCommandAck (v2) and ManualControlSetpoint (v2) get uint32 system ID fields, with translations to the previous versions. Older versions get IDs above 255 clamped to 255. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Julian Oes <julian@oes.ch>
63 lines
2.6 KiB
Plaintext
63 lines
2.6 KiB
Plaintext
# Manual control input
|
|
#
|
|
# This message provides a representation of manual control input sources,
|
|
# such as RC controllers and MAVLink controller (Joystick).
|
|
#
|
|
# It defines the `manual_control_input` topic to represent each configured input,
|
|
# and the `manual_control_setpoint` topic to represent the input that is currently
|
|
# in charge of the vehicle (based on parameter COM_RC_IN_MODE).
|
|
# `manual_control_setpoint` is the topic that is published to the controllers.
|
|
#
|
|
# The message includes fields for the roll, pitch, yaw, throttle and flaps, along with auxiliary channels and button states.
|
|
|
|
uint32 MESSAGE_VERSION = 2
|
|
|
|
uint64 timestamp # time since system start (microseconds)
|
|
uint64 timestamp_sample # the timestamp of the raw data (microseconds)
|
|
|
|
bool valid
|
|
|
|
uint8 SOURCE_UNKNOWN = 0
|
|
uint8 SOURCE_RC = 1 # radio control (input_rc)
|
|
uint8 SOURCE_MAVLINK_0 = 2 # mavlink instance 0
|
|
uint8 SOURCE_MAVLINK_1 = 3 # mavlink instance 1
|
|
uint8 SOURCE_MAVLINK_2 = 4 # mavlink instance 2
|
|
uint8 SOURCE_MAVLINK_3 = 5 # mavlink instance 3
|
|
uint8 SOURCE_MAVLINK_4 = 6 # mavlink instance 4
|
|
uint8 SOURCE_MAVLINK_5 = 7 # mavlink instance 5
|
|
|
|
uint8 data_source
|
|
uint32 source_system_id # [@invalid 0] MAVLink system ID of the manual control source
|
|
uint8 source_component_id # [@invalid 0] MAVLink component ID of the manual control source
|
|
|
|
# Any of the channels may not be available and be set to NaN
|
|
# to indicate that it does not contain valid data.
|
|
|
|
# Stick positions [-1,1]
|
|
# on a common RC mode 1/2/3/4 remote/joystick the stick deflection: -1 is down/left, 1 is up/right
|
|
# Note: QGC sends throttle/z in range [0,1000] - [0,1]. The MAVLink input conversion [0,1] to [-1,1] is at the moment kept backwards compatible.
|
|
# Positive values are generally used for:
|
|
float32 roll # move right, positive roll rotation, right side down
|
|
float32 pitch # move forward, negative pitch rotation, nose down
|
|
float32 yaw # positive yaw rotation, clockwise when seen top down
|
|
float32 throttle # move up, positive thrust, -1 is minimum available 0% or -100% +1 is 100% thrust
|
|
|
|
float32 flaps # position of flaps switch/knob/lever [-1, 1]
|
|
|
|
float32 aux1
|
|
float32 aux2
|
|
float32 aux3
|
|
float32 aux4
|
|
float32 aux5
|
|
float32 aux6
|
|
|
|
bool sticks_moving # manual control override request in an auto or offboard mode, only gets true if feature is enabled
|
|
|
|
uint16 buttons # From uint16 buttons field of Mavlink manual_control message
|
|
|
|
# TOPICS manual_control_setpoint manual_control_input
|
|
# DEPRECATED: float32 x
|
|
# DEPRECATED: float32 y
|
|
# DEPRECATED: float32 z
|
|
# DEPRECATED: float32 r
|