mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-11-22 22:50:49 +08:00
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>
20 lines
1.5 KiB
Plaintext
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
|