PID-Attenuation-and-scaling.md

   1 **TPA** [***Throttle PID Attenuation***] is what allows vehicles, that are optimally tuned for hover or slow flight, dynamically adjust PID gains, so high throttle (fast forward flight or rapid climb) doesn't introduce oscillations.
   2
   3 ## Multirotors
   4
   5 TPA applies a PID value reduction in relation to full Throttle. It is used to apply dampening of PID values as full throttle is reached.
   6
   7 **TPA** = % of dampening that will occur at full throttle.
   8
   9 **TPA Breakpoint** = the point in the throttle curve at which TPA will begin to be applied. Below that point PIDs are not attenuated at all.
  10
  11 ### How and Why to use this?
  12
  13 If you are getting oscillations starting at say 3/4 throttle, set TPA Breakpoint = 1750 or lower (remember, this is assuming your throttle range is 1000-2000), and then slowly increase TPA until your oscillations are gone. Usually, you will want TPA Breakpoint to start a little sooner then when your oscillations start so you'll want to experiment with the values to reduce/remove the oscillations.
  14
  15 ### Example of multirotor TPA curve
  16
  17 ![](images/tpa_multirotor.png)
  18
  19 ## Airplanes
  20
  21 Airplanes are different from multirotors as PID gains should be attenuated according to airspeed, not throttle. However, until airspeed sensor support is introduced it's safe to assume that speed is directly proportional to throttle.
  22
  23 For airplanes TPA works in a different way - it's not only attenuating PID gains at high throttle but also boosts them at low throttle allowing better control when gliding at low speeds with no throttle at all or slow flying with minimal throttle. TPA is expressed as a curve that boosts PIDs below TPA breakpoint and attenuates them above the breakpoint.
  24
  25 **TPA** = amount of TPA curve to apply to PIDs. 100% TPA allows PIDs to be scaled by factor in range [0.5; 2].
  26
  27 **TPA Breakpoint** = the point in the throttle curve at which PIDs are not attenuated
  28
  29 **FW TPA Time Constant** = TPA smoothing and delay time constant to reflect non-instant speed/throttle response of the plane.
  30
  31 ### How to use this?
  32
  33 Tune your PIDs at throttle level you intend to fly your airplane (cruise throttle). Set that value as TPA Breakpoint.
  34 You will notice that when you fly at lower throttle your airplane handles worse and at higher throttle (up to full throttle) it begins to oscillate. Increase TPA amount until these oscillations are gone or minimal. You will instantly notice better handling at lower throttle values.
  35
  36 The **TPA Time Constant** feature uses an asymmetric filter, that effects both increasing and decreasing throttle/speed. Planes with low thrust/weight ratio generally need higher time constant, for launch. While planes with a lower drag coefficient, conversely require a higher time constant, during speed wash-off; requiring the constant to be balanced.
  37
  38 ### Example of airplane TPA curve
  39
  40 ![](images/tpa_airplane.png)