Files
PX4-Autopilot/docs/uk/msg_docs/FailureInjection.md
2026-07-01 18:54:18 +10:00

8.1 KiB

pageClass
pageClass
is-wide-page

FailureInjection (UORB message)

Failure injection configuration.

Currently active failure-injection configuration, published by the failure injection manager (the sole subscriber to vehicle_command INJECT_FAILURE). Republished only when the configuration changes, so command spam on vehicle_command cannot propagate to the consumers applying the failures.

TOPICS: failure_injection

Fields

Назва Тип Unit [Frame] Range/Enum Опис
timestamp uint64 us Time since system start
count uint8 number of valid entries in the arrays below
unit uint8[4] FAILURE_UNIT Affected component per entry
instance_mask uint16[4] Bit i targets instance (i+1); 0xFFFF = all instances
failure_type uint8[4] FAILURE_TYPE failure mode per entry

Enums

FAILURE_UNIT

Used in field(s): unit

Назва Тип Значення Опис
FAILURE_UNIT_SENSOR_GYRO uint8 0
FAILURE_UNIT_SENSOR_ACCEL uint8 1
FAILURE_UNIT_SENSOR_MAG uint8 2
FAILURE_UNIT_SENSOR_BARO uint8 3
FAILURE_UNIT_SENSOR_GPS uint8 4
FAILURE_UNIT_SENSOR_OPTICAL_FLOW uint8 5
FAILURE_UNIT_SENSOR_VIO uint8 6
FAILURE_UNIT_SENSOR_DISTANCE_SENSOR uint8 7
FAILURE_UNIT_SENSOR_AIRSPEED uint8 8
FAILURE_UNIT_SYSTEM_BATTERY uint8 100
FAILURE_UNIT_SYSTEM_MOTOR uint8 101
FAILURE_UNIT_SYSTEM_SERVO uint8 102
FAILURE_UNIT_SYSTEM_AVOIDANCE uint8 103
FAILURE_UNIT_SYSTEM_RC_SIGNAL uint8 104
FAILURE_UNIT_SYSTEM_MAVLINK_SIGNAL uint8 105

FAILURE_TYPE

Used in field(s): failure_type

Назва Тип Значення Опис
FAILURE_TYPE_OK uint8 0
FAILURE_TYPE_OFF uint8 1
FAILURE_TYPE_STUCK uint8 2
FAILURE_TYPE_GARBAGE uint8 3
FAILURE_TYPE_WRONG uint8 4
FAILURE_TYPE_SLOW uint8 5
FAILURE_TYPE_DELAYED uint8 6
FAILURE_TYPE_INTERMITTENT uint8 7

Constants

Назва Тип Значення Опис
MAX_FAILURES uint8 4 maximum number of simultaneous failures

Source Message

Source file (GitHub)

:::details Click here to see original file

#Failure injection configuration.
#
# Currently active failure-injection configuration, published by the failure
# injection manager (the sole subscriber to vehicle_command INJECT_FAILURE).
# Republished only when the configuration changes, so command spam on
# vehicle_command cannot propagate to the consumers applying the failures.

uint64 timestamp # [us] Time since system start

uint8 MAX_FAILURES = 4 # maximum number of simultaneous failures

uint8 count # number of valid entries in the arrays below

uint8[4] unit # [@enum FAILURE_UNIT] Affected component per entry
# Failure unit (affected component). Mirrors MAVLink FAILURE_UNIT and the
# FAILURE_UNIT_* values in vehicle_command.
uint8 FAILURE_UNIT_SENSOR_GYRO = 0
uint8 FAILURE_UNIT_SENSOR_ACCEL = 1
uint8 FAILURE_UNIT_SENSOR_MAG = 2
uint8 FAILURE_UNIT_SENSOR_BARO = 3
uint8 FAILURE_UNIT_SENSOR_GPS = 4
uint8 FAILURE_UNIT_SENSOR_OPTICAL_FLOW = 5
uint8 FAILURE_UNIT_SENSOR_VIO = 6
uint8 FAILURE_UNIT_SENSOR_DISTANCE_SENSOR = 7
uint8 FAILURE_UNIT_SENSOR_AIRSPEED = 8
uint8 FAILURE_UNIT_SYSTEM_BATTERY = 100
uint8 FAILURE_UNIT_SYSTEM_MOTOR = 101
uint8 FAILURE_UNIT_SYSTEM_SERVO = 102
uint8 FAILURE_UNIT_SYSTEM_AVOIDANCE = 103
uint8 FAILURE_UNIT_SYSTEM_RC_SIGNAL = 104
uint8 FAILURE_UNIT_SYSTEM_MAVLINK_SIGNAL = 105

uint16[4] instance_mask # Bit i targets instance (i+1); 0xFFFF = all instances

uint8[4] failure_type # [@enum FAILURE_TYPE] failure mode per entry
# Failure mode.
# Mirrors MAVLink FAILURE_TYPE and the FAILURE_TYPE_* values in vehicle_command.
uint8 FAILURE_TYPE_OK = 0
uint8 FAILURE_TYPE_OFF = 1
uint8 FAILURE_TYPE_STUCK = 2
uint8 FAILURE_TYPE_GARBAGE = 3
uint8 FAILURE_TYPE_WRONG = 4
uint8 FAILURE_TYPE_SLOW = 5
uint8 FAILURE_TYPE_DELAYED = 6
uint8 FAILURE_TYPE_INTERMITTENT = 7

:::