Files
PX4-Autopilot/msg/versioned/LongitudinalControlConfiguration.msg
T
Silvan 026f8d1fa8 docs(fw): define the fixed-wing pitch angle and FW_PSP_OFF
PX4 never said in which frame fixed-wing pitch angles are given, and
FW_PSP_OFF was described as an offset added to the pitch setpoint and as
the angle of attack, which holds only for TECS and Stabilized mode, and
only in level flight measured from the body x-axis.

- Trimming guide: a side-view diagram of the body frame, the pitch angle
  and FW_PSP_OFF, and where FW_PSP_OFF is used.
- Messages: state that pitch setpoints and limits are absolute, drop the
  FRD frame tag on an Euler angle, correct the pitch range to +-pi/2,
  and describe the TECS pitch integrator as a correction term.
  Comment-only, so no message version change.
- Parameters: describe FW_PSP_OFF as the level-flight pitch, mark the
  absolute pitch parameters as such, and describe the asymmetric
  FW_MAN_P_MAX range with a non-zero FW_PSP_OFF.

Assisted-by: Claude:claude-opus-5-5
Signed-off-by: Silvan <silvan@auterion.com>
2026-10-13 11:36:46 +02:00

20 lines
1.5 KiB
Plaintext

# Fixed Wing Longitudinal Control Configuration message
#
# Used by the fw_lateral_longitudinal_control module and TECS to constrain FixedWingLongitudinalSetpoint messages
# and configure the resultant setpoints.
# Pitch angles are absolute: the angle of the fixed-wing body x-axis above the horizon, without FW_PSP_OFF applied.
uint32 MESSAGE_VERSION = 0
uint64 timestamp # [us] Time since system start
float32 pitch_min # [rad] [@range -pi/2, pi/2] Minimum absolute pitch angle setpoint. Defaults to FW_P_LIM_MIN if NAN.
float32 pitch_max # [rad] [@range -pi/2, pi/2] Maximum absolute pitch angle setpoint. Defaults to FW_P_LIM_MAX if NAN.
float32 throttle_min # [norm] [@range 0,1] Defaults to FW_THR_MIN if NAN.
float32 throttle_max # [norm] [@range 0,1] Defaults to FW_THR_MAX if NAN.
float32 climb_rate_target # [m/s] Target climbrate to change altitude. Defaults to FW_T_CLMB_R_SP if NAN. Not used if height_rate is directly set in FixedWingLongitudinalSetpoint.
float32 sink_rate_target # [m/s] Target sinkrate to change altitude. Defaults to FW_T_SINK_R_SP if NAN. Not used if height_rate is directly set in FixedWingLongitudinalSetpoint.
float32 speed_weight # [-] [@range 0,2] 0=pitch controls altitude only, 2=pitch controls airspeed only
bool enforce_low_height_condition # If true, the altitude controller is configured with an alternative timeconstant for tighter altitude tracking
bool disable_underspeed_protection # If true, underspeed handling is disabled in the altitude controller