From 974e61488ce8746526cba11d64a593a668e74a7f Mon Sep 17 00:00:00 2001 From: PX4BuildBot Date: Thu, 9 Mar 2023 01:14:56 +0000 Subject: [PATCH] Update PX4 Firmware metadata Thu Mar 9 01:14:56 UTC 2023 --- .../PX4/PX4ParameterFactMetaData.xml | 193 ++++++--------------- 1 file changed, 49 insertions(+), 144 deletions(-) diff --git a/src/FirmwarePlugin/PX4/PX4ParameterFactMetaData.xml b/src/FirmwarePlugin/PX4/PX4ParameterFactMetaData.xml index 821f5c0..a192f1a 100644 --- a/src/FirmwarePlugin/PX4/PX4ParameterFactMetaData.xml +++ b/src/FirmwarePlugin/PX4/PX4ParameterFactMetaData.xml @@ -2483,10 +2483,10 @@ Airspeed mode - For small wings or VTOL without airspeed sensor this parameter can be used to enable flying without an airspeed reading + On vehicles without airspeed sensor this parameter can be used to enable flying without an airspeed reading - Normal (use airspeed if available) - Airspeed disabled + Use airspeed in controller + Do not use airspeed in controller @@ -2550,8 +2550,7 @@ 0.5 - Maximum negative / down pitch rate - This limits the maximum pitch down up angular rate the controller will output (in degrees per second). + Maximum negative / down pitch rate setpoint 0.0 90.0 deg/s @@ -2559,8 +2558,7 @@ 0.5 - Maximum positive / up pitch rate - This limits the maximum pitch up angular rate the controller will output (in degrees per second). + Maximum positive / up pitch rate setpoint 0.0 90.0 deg/s @@ -2578,14 +2576,13 @@ Roll control to yaw control feedforward gain - This gain can be used to counteract the "adverse yaw" effect for fixed wings. When the plane enters a roll it will tend to yaw the nose out of the turn. This gain enables the use of a yaw actuator (rudder, airbrakes, ...) to counteract this effect. + This gain can be used to counteract the "adverse yaw" effect for fixed wings. When the plane enters a roll it will tend to yaw the nose out of the turn. This gain enables the use of a yaw actuator to counteract this effect. 0.0 1 0.01 - Maximum roll rate - This limits the maximum roll rate the controller will output (in degrees per second). + Maximum roll rate setpoint 0.0 90.0 deg/s @@ -2675,8 +2672,7 @@ 0.5 - Maximum yaw rate - This limits the maximum yaw rate the controller will output (in degrees per second). + Maximum yaw rate setpoint 0.0 90.0 deg/s @@ -2790,7 +2786,7 @@ Altitude time constant factor for landing - Set this parameter to less than 1.0 to make TECS react faster to altitude errors during landing than during normal flight (i.e. giving efficiency and low motor wear at high altitudes but control accuracy during landing). During landing, the TECS altitude time constant (FW_T_ALT_TC) is multiplied by this value. + Set this parameter to less than 1.0 to make TECS react faster to altitude errors during landing than during normal flight. During landing, the TECS altitude time constant (FW_T_ALT_TC) is multiplied by this value. 0.2 1.0 @@ -2850,7 +2846,7 @@ Motor delay - Delay between starting attitude control and powering up the throttle (giving throttle control to the controller) Before this timespan is up the throttle will be set to FW_THR_IDLE, set to 0 to deactivate + Start the motor(s) this amount of seconds after launch is detected. 0.0 10.0 s @@ -2950,7 +2946,7 @@ Maximum roll angle - The maximum roll angle setpoint for autonomous modes including altitude and position control. + The maximum roll angle setpoint for setpoint for a height-rate or altitude controlled mode. 35.0 65.0 deg @@ -2975,15 +2971,13 @@ deg - Acro body y max rate - This is the body y rate the controller is trying to achieve if the user applies full pitch stick input in acro mode. + Acro body pitch max rate setpoint 45 720 deg - Acro body z max rate - This is the body z rate the controller is trying to achieve if the user applies full yaw stick input in acro mode. + Acro body yaw max rate setpoint 10 180 deg @@ -2993,24 +2987,8 @@ This enables a logic that automatically adjusts the output of the rate controller to take into account the real torque produced by an aerodynamic control surface given the current deviation from the trim airspeed (FW_AIRSPD_TRIM). Enable when using aerodynamic control surfaces (e.g.: plane) Disable when using rotor wings (e.g.: autogyro) - Whether to scale throttle by battery power level - This compensates for voltage drop of the battery over time by attempting to normalize performance across the operating range of the battery. The fixed wing should constantly behave as if it was fully charged with reduced max thrust at lower battery percentages. i.e. if cruise speed is at 0.5 throttle at 100% battery, it will still be 0.5 at 60% battery. - - - Pitch trim increment for flaps configuration - This increment is added to the pitch trim whenever flaps are fully deployed. - -0.25 - 0.25 - 2 - 0.01 - - - Pitch trim increment for spoiler configuration - This increment is added to the pitch trim whenever spoilers are fully deployed. - -0.25 - 0.25 - 2 - 0.01 + Enable throttle scale by battery level + This compensates for voltage drop of the battery over time by attempting to normalize performance across the operating range of the battery. Pitch trim increment at maximum airspeed @@ -3028,14 +3006,6 @@ 2 0.01 - - Roll trim increment for flaps configuration - This increment is added to TRIM_ROLL whenever flaps are fully deployed. - -0.25 - 0.25 - 2 - 0.01 - Roll trim increment at maximum airspeed This increment is added to TRIM_ROLL when airspeed is FW_AIRSPD_MAX. @@ -3088,7 +3058,7 @@ Pitch rate derivative gain - Pitch rate differential gain. Small values help reduce fast oscillations. If value is too big oscillations will appear again. + Pitch rate differential gain. 0.0 1.0 %/rad/s @@ -3123,7 +3093,6 @@ Pitch rate proportional gain - Pitch rate proportional gain, i.e. control output for angular speed error 1 rad/s. 0.0 1.0 %/rad/s @@ -3167,7 +3136,6 @@ Roll rate proportional Gain - Roll rate proportional gain, i.e. control output for angular speed error 1 rad/s. 0.0 1.0 %/rad/s @@ -3211,7 +3179,6 @@ Yaw rate proportional gain - Yaw rate proportional gain, i.e. control output for angular speed error 1 rad/s. 0.0 1.0 %/rad/s @@ -3222,7 +3189,7 @@ Maximum Airspeed (CAS) - The maximal airspeed (calibrated airspeed) the user is able to command. Further, if the airspeed is above this value, the TECS controller will try to decrease airspeed more aggressively. + The maximal airspeed (calibrated airspeed) the user is able to command. 0.5 40 m/s @@ -3248,8 +3215,8 @@ 0.5 - Cruise Airspeed (CAS) - The trim CAS (calibrated airspeed) of the vehicle. If an airspeed controller is active, this is the default airspeed setpoint that the controller will try to achieve if no other airspeed setpoint sources are present (e.g. through non-centered RC sticks). + Trim (Cruise) Airspeed + The trim CAS (calibrated airspeed) of the vehicle. If an airspeed controller is active, this is the default airspeed setpoint that the controller will try to achieve. 0.5 40 m/s @@ -3267,7 +3234,7 @@ Maximum pitch angle - The maximum pitch angle setpoint for autonomous modes including altitude and position control. + The maximum pitch angle setpoint setpoint for a height-rate or altitude controlled mode. 0.0 60.0 deg @@ -3276,7 +3243,7 @@ Minimum pitch angle - The minimum pitch angle setpoint for autonomous modes including altitude and position control. + The minimum pitch angle setpoint for a height-rate or altitude controlled mode. -60.0 0.0 deg @@ -3320,7 +3287,7 @@ Trim throttle - This is the throttle setting required to achieve FW_AIRSPD_TRIM during level flight. Most airframes have a value of 0.5-0.7. + This is the throttle setting required to achieve FW_AIRSPD_TRIM during level flight. 0.0 1.0 norm @@ -3343,7 +3310,7 @@ Maximum climb rate - This is the best climb rate that the aircraft can achieve with the throttle set to THR_MAX and the airspeed set to the default value. For electric aircraft make sure this number can be achieved towards the end of flight when the battery voltage has reduced. The setting of this parameter can be checked by commanding a positive altitude change of 100m in loiter, RTL or guided mode. If the throttle required to climb is close to THR_MAX and the aircraft is maintaining airspeed, then this parameter is set correctly. If the airspeed starts to reduce, then the parameter is set to high, and if the throttle demand required to climb and maintain speed is noticeably less than FW_THR_MAX, then either FW_T_CLMB_MAX should be increased or FW_THR_MAX reduced. + This is the maximum climb rate that the aircraft can achieve with the throttle set to THR_MAX and the airspeed set to the trim value. For electric aircraft make sure this number can be achieved towards the end of flight when the battery voltage has reduced. 1.0 15.0 m/s @@ -3434,7 +3401,7 @@ Speed <--> Altitude priority - This parameter adjusts the amount of weighting that the pitch control applies to speed vs height errors. Setting it to 0.0 will cause the pitch control to control height and ignore speed errors. This will normally improve height accuracy but give larger airspeed errors. Setting it to 2.0 will cause the pitch control loop to control speed and ignore height errors. This will normally reduce airspeed errors, but give larger height errors. The default value of 1.0 allows the pitch control to simultaneously control height and speed. Note to Glider Pilots - set this parameter to 2.0 (The glider will adjust its pitch angle to maintain airspeed, ignoring changes in height). + This parameter adjusts the amount of weighting that the pitch control applies to speed vs height errors. Setting it to 0.0 will cause the pitch control to control height and ignore speed errors. This will normally improve height accuracy but give larger airspeed errors. Setting it to 2.0 will cause the pitch control loop to control speed and ignore height errors. This will normally reduce airspeed errors, but give larger height errors. The default value of 1.0 allows the pitch control to simultaneously control height and speed. Set to 2 for gliders. 0.0 2.0 1 @@ -4567,6 +4534,16 @@ 10 1 + + UART ESC verbose logging + 0 + 1 + true + + - Disabled + - Enabled + + @@ -4599,7 +4576,7 @@ GPS failure fixed roll angle - Roll in degrees during the loiter after the vehicle has lost GPS in an auto mode (e.g. mission or loiter). Does only apply for fixed-wing vehicles or VTOLs with NAV_FORCE_VT set to 0. + Roll in degrees during the loiter after the vehicle has lost GPS in an auto mode (e.g. mission or loiter). 0.0 30.0 deg @@ -7550,60 +7527,6 @@ 1 - - - Address of the Roboclaw - The Roboclaw can be configured to have an address from 0x80 to 0x87, inclusive. It must be configured to match this parameter. - 128 - 135 - - 0x80 - 0x81 - 0x82 - 0x83 - 0x84 - 0x85 - 0x86 - 0x87 - - - - Roboclaw serial baud rate - Baud rate of the serial communication with the Roboclaw. The Roboclaw must be configured to match this rate. - 2400 - 460800 - true - - 2400 baud - 9600 baud - 19200 baud - 38400 baud - 57600 baud - 115200 baud - 230400 baud - 460800 baud - - - - Encoder counts per revolution - Number of encoder counts for one revolution. The roboclaw treats analog encoders (potentiometers) as having 2047 counts per rev. The default value of 1200 corresponds to the default configuration of the Aion R1 rover. - 1 - - - Encoder read period - How long to wait, in Milliseconds, between reading wheel encoder values over Uart from the Roboclaw - 1 - 1000 - ms - - - Uart write period - How long to wait, in Milliseconds, between writing actuator controls over Uart to the Roboclaw - 1 - 1000 - ms - - L1 damping @@ -7767,7 +7690,6 @@ Max throttle during runway takeoff - Can be used to test taxi on runway 0.0 1.0 norm @@ -10458,30 +10380,13 @@ Approximate deceleration during back transition - The approximate deceleration during a back transition in m/s/s Used to calculate back transition distance in mission mode. A lower value will make the VTOL transition further from the destination waypoint. For standard vtol and tiltrotors a controller is used to track this value during the transition. + The approximate deceleration during a back transition in m/s/s Used to calculate back transition distance in an auto mode. For standard vtol and tiltrotors a controller is used to track this value during the transition. 0.5 10 m/s^2 2 0.1 - - Delay in seconds before applying back transition throttle - Set this to a value greater than 0 to give the motor time to spin down. - 0 - 10 - s - 2 - 1 - - - Output on airbrakes channel during back transition - Used for airbrakes or with ESCs that have reverse thrust enabled on a separate channel. Airbrakes need to be enabled for your selected model/mixer. - 0 - 1 - 2 - 0.01 - Duration of a back transition Time in seconds used for a back transition @@ -10500,7 +10405,7 @@ Target throttle value for the transition to hover flight - standard vtol: pusher tailsitter, tiltrotor: main throttle Note for standard vtol: For ESCs and mixers that support reverse thrust on low PWM values set this to a negative value to apply active breaking For ESCs that support thrust reversal with a control channel please set VT_B_REV_OUT and set this to a positive value to apply active breaking + standard vtol: pusher tailsitter, tiltrotor: main throttle -1 1 2 @@ -10511,8 +10416,8 @@ If set to 1 the control surfaces are locked at the disarmed value in multicopter mode. - Enable usage of fixed-wing actuators in hover to generate forward force (instead of pitching down) - This feature can be used to avoid the plane having to pitch down in order to move forward, and prevents large, negative lift values being created when facing strong winds. Fixed-wing forward actuators refers to puller/pusher (standard VTOL), or forward-tilt (tiltrotor VTOL). Only active if demanded down pitch is below VT_PITCH_MIN. Use VT_FWD_THRUST_SC to tune it. Only active (if enabled) in Altitude, Position and Auto modes, not in Stabilized. + Use fixed-wing actuation in hover to accelerate forward + This feature can be used to avoid the plane having to pitch nose down in order to move forward. Prevents large, negative lift from pitching nose down into wind. Fixed-wing forward actuators refers to puller/pusher (standard VTOL), or forward-tilt (tiltrotor VTOL). Only active if demanded down pitch is below VT_PITCH_MIN. Use VT_FWD_THRUST_SC to tune it. Only active (if enabled) in Altitude, Position and Auto modes, not in Stabilized. Disabled Enabled (except LANDING) @@ -10524,8 +10429,8 @@ - Fixed-wing actuator thrust scale for hover forward flight - Scale applied to the demanded down-pitch to get the fixed-wing forward actuation in hover mode. Only active if demaded down pitch is below VT_PITCH_MIN. Enabled via VT_FWD_THRUST_EN. + Fixed-wing actuation thrust scale for hover forward flight + Scale applied to the demanded down-pitch to get the fixed-wing forward actuation in hover mode. Enabled via VT_FWD_THRUST_EN. 0.0 2.0 @@ -10542,7 +10447,7 @@ Pitch differential thrust factor in forward flight - Maps the pitch control output in forward flight to the actuator differential thrust output. Differential thrust in forward flight is enabled via VT_FW_DIFTHR_EN. + Differential thrust in forward flight is enabled via VT_FW_DIFTHR_EN. 0.0 2.0 2 @@ -10550,7 +10455,7 @@ Roll differential thrust factor in forward flight - Maps the roll control output in forward flight to the actuator differential thrust output. Differential thrust in forward flight is enabled via VT_FW_DIFTHR_EN. + Differential thrust in forward flight is enabled via VT_FW_DIFTHR_EN. 0.0 2.0 2 @@ -10558,7 +10463,7 @@ Yaw differential thrust factor in forward flight - Maps the yaw control output in forward flight to the actuator differential thrust output. Differential thrust in forward flight is enabled via VT_FW_DIFTHR_EN. + Differential thrust in forward flight is enabled via VT_FW_DIFTHR_EN. 0.0 2.0 2 @@ -10575,7 +10480,7 @@ Quad-chute maximum height - Maximum height above the ground (if available, otherwhise above home if available, otherwise above the local origin) where triggering a quadchute is possible. Triggering a quadchute always means transitioning the vehicle to hover flight in which generally a lot of energy is consumed. At high altitudes there is therefore a big risk to deplete the battery and therefore crash. Currently, there is no automated re-transition to fixed wing mode implemented and therefore this parameter serves and an intermediate measure to increase safety. Setting this value to 0 deactivates the behavior (always enable quad-chute independently of altitude). + Maximum height above the ground (if available, otherwhise above home if available, otherwise above the local origin) where triggering a quadchute is possible. At high altitudes there is a big risk to deplete the battery and therefore crash if quad-chuting there. 0 m 1 @@ -10622,7 +10527,7 @@ Minimum pitch angle during hover landing - Overrides VT_PITCH_MIN when the vehicle is in LAND mode (hovering). During landing it can be beneficial to allow lower minimum pitch angles as it can avoid the wings generating too much lift and preventing the vehicle from sinking at the desired rate. + Overrides VT_PITCH_MIN when the vehicle is in LAND mode (hovering). During landing it can be beneficial to allow lower minimum pitch angles as it can avoid the wings generating too much lift and preventing the vehicle from sinking at the desired rate. -10.0 45.0 deg @@ -10687,11 +10592,11 @@ 0.01 - Tilt actuator control value commanded when disarmed and during the first second after arming + Tilt when disarmed and in the first second after arming This specific tilt during spin-up is necessary for some systems whose motors otherwise don't spin-up freely. 0.0 1.0 - 3 + 2 0.01 @@ -10712,7 +10617,7 @@ Duration of front transition phase 2 - Time in seconds it should take for the rotors to rotate forward completely from the point when the plane has picked up enough airspeed and is ready to go into fixed wind mode. + Time in seconds it takes to tilt form VT_TILT_TRANS to VT_TILT_FW. 0.1 5.0 s