1
0
mirror of https://bitbucket.org/librepilot/librepilot.git synced 2024-12-04 12:24:11 +01:00
LibrePilot/shared/uavobjectdefinition/systemidentsettings.xml
2017-03-03 01:46:10 +01:00

85 lines
9.0 KiB
XML

<xml>
<object name="SystemIdentSettings" singleinstance="true" settings="true" category="Control">
<description>The input to and results of the PID tuning.</description>
<field name="Tau" units="ln(sec)" type="float" elements="1" defaultvalue="-4.0" description="Measured delay between inner loop and detected gyro response"/>
<!-- Beta default values 10.0 10.0 7.0 so that SystemIdent mode can be run without AutoTune -->
<field name="Beta" units="" type="float" elementnames="Roll,Pitch,Yaw" defaultvalue="10.0,10.0,7.0" description="(Natural log of) Measured control gain"/>
<!-- The following comments come from / are extrapolated from various TauLabs / dRonin sources. -->
<!-- TL / dRonin requires you to adjust two sliders, one called RateDamp and the other called RateNoise. -->
<!-- They have documented that certain pairings of damp and noise go together well. -->
<!-- The LP code uses these "known good pairs" to weld the damp and noise scales together into the SmoothQuick slider. -->
<!-- When using the SmoothQuick slider you automatically get an interpolated matching pair of damp and noise. -->
<!-- So be aware that these comments refer to the TL/dRronin slider names. -->
<!-- -->
<!-- Decrease damping to make your aircraft response more rapidly. Increase it for more stability. -->
<!-- Increasing noise (sensitivity) will make your aircraft respond more rapidly, but will cause twitches due to noise. -->
<!-- Use RateDamp 130 with RateNoise 08 for very smooth flight. -->
<!-- Use RateDamp 110 with RateNoise 10 for default flight. -->
<!-- Use RateDamp 100 with RateNoise 13 for very snappy flight. -->
<!-- RateNoise is [0,30] default 10. -->
<!-- RateDamp is [50,150] default 110. -->
<!-- per https://github.com/d-ronin/dRonin/pull/811/files change min ratedamp to 85. -->
<!-- So RateDamp is [85,150] default 110. -->
<!-- Extrapolated multiplicatively: -->
<!-- Use RateDamp 153.636363636 with RateNoise 06.4 for very very smooth flight. -->
<!-- Use RateDamp 90.909090909 with RateNoise 16.9 for very very snappy flight. -->
<!-- Extrapolated additively: -->
<!-- Use RateDamp 150 with RateNoise 06 for very very smooth flight. -->
<!-- Use RateDamp 90 with RateNoise 16 for very very snappy flight. -->
<!-- use additive so the piecewise algorithm will give the exact recommended pairs at 25%, 50%, and 75% of slider -->
<!-- -->
<!-- So the following 6 fields set up the SmoothQuick slider using 3 known good damp and noise pairings. -->
<!-- You can adjust just one end of SmoothQuick by changing e.g. the DampMin and NoiseMax pairing. -->
<!-- You can maintain the known good ratio to simply extend or shrink the SmoothQuick scale. -->
<!-- You can change the known good ratio e.g. if you find that the quick end of SmoothQuick tends to oscillate. -->
<!-- You can change the default PIDs by changing the "center" values DampRate and NoiseRate. -->
<!-- You can change the whole SmoothQuick slider uniformly by e.g. multiplying all Damp* fields by .75 -->
<!-- You can shift the whole SmoothQuick slider up or down -->
<!-- etc! -->
<!-- on the SmoothQuick value scale of [-1,+1]: -->
<!-- the default SmoothQuick value of 0.0 gives recommended default damp and rate for normal flight -->
<!-- a SmoothQuick value of -0.5 gives the recommended damp and rate for very smooth flight -->
<!-- a SmoothQuick value of +0.5 gives the recommended damp and rate for very quick flight -->
<!-- a SmoothQuick value of -1.0 is extrapolated to give very very smooth flight while still being inside the range of sane values-->
<!-- a SmoothQuick value of +1.0 is extrapolated to give very very quick flight while still being inside the range of sane values-->
<!-- other values of SmoothQuick are interpolated or extrapolated from these -->
<field name="DampMin" units="" type="uint8" elements="1" defaultvalue="90" description="Setting: Part of smoothquick slider (expert)"/>
<field name="DampRate" units="" type="uint8" elements="1" defaultvalue="110" description="Setting: Part of smoothquick slider (expert)"/>
<field name="DampMax" units="" type="uint8" elements="1" defaultvalue="150" description="Setting: Part of smoothquick slider (expert)"/>
<field name="NoiseMin" units="" type="uint8" elements="1" defaultvalue="6" description="Setting: Part of smoothquick slider (expert)"/>
<field name="NoiseRate" units="" type="uint8" elements="1" defaultvalue="10" description="Setting: Part of smoothquick slider (expert)"/>
<field name="NoiseMax" units="" type="uint8" elements="1" defaultvalue="16" description="Setting: Part of smoothquick slider (expert)"/>
<field name="CalculateYaw" units="" type="enum" elements="1" options="False,TrueLimitToRatio,TrueIgnoreLimit" defaultvalue="TrueLimitToRatio" description="Setting: Whether to calculate yaw and whether to use YawToRollPitchPIDRatio"/>
<!-- Mateuze quad needs yaw P to be at most 2.6 times roll/pitch P to avoid yaw oscillation -->
<!-- Cliff sluggish 500 quad thinks that yaw P should be about 5.8 times roll/pitch P, but can easily (and better) live with 2.6 -->
<field name="YawToRollPitchPIDRatioMin" units="" type="float" elements="1" defaultvalue="1.0" description="Setting: Yaw PID will be at least this times Pitch PID (if enabled)"/>
<field name="YawToRollPitchPIDRatioMax" units="" type="float" elements="1" defaultvalue="2.5" description="Setting: Yaw PID will be at most this times Pitch PID (if enabled)"/>
<field name="DerivativeFactor" units="" type="float" elements="1" defaultvalue="1.0" limits="%BE:0:1" description="Setting: Multiplicative factor. If you have D term oscillations, reduce it toward zero and it will reduce PID D terms."/>
<field name="OuterLoopKpSoftClamp" units="" type="float" elements="1" defaultvalue="6.5" limits="%BE:0:100" description="Setting: Change this to change the outer loop Kp and Ki limiting"/>
<field name="DestinationPidBank" units="bank#" type="uint8" elements="1" defaultvalue="3" limits="%BE:1:3" description="Setting: Which bank the calculated PIDs will be stored in after tuning"/>
<field name="TuningDuration" units="s" type="uint8" elements="1" defaultvalue="60" limits="%BI:0" description="Setting: Duration of the tuning motions (expert)"/>
<field name="ThrustControl" units="" type="enum" elements="1" options="Manual,AltitudeVario" defaultvalue="Manual" description="Setting: Manual is direct control, AltitudeVario helps to maintain altitude"/>
<!-- SmoothQuickSource: the smooth vs. quick PID selector -->
<!-- 0 = disabled -->
<!-- 10 thru 13 correspond to accessory0 -> accessory3 transmitter knobs -->
<!-- an accessory knob works as expected, with full left being smoothest and full right being quickest -->
<!-- 23, 25, and 27 are discrete 3, 5, and 7 position rount robin selectors -->
<!-- incremented by quickly double toggling the fms 3 times (starting outside autotune mode -->
<!-- with each double toggle going into and back out of autotune) to go to the next position -->
<!-- think of the positions on a scale from 0 to 100, with smoothest being 0 and quickest being 100, and you start out at 50 -->
<!-- 23 (3 stops) means stops at 50, then 100, then 0 then back to 50 -->
<!-- 25 (5 stops) means stops at 50, 75, 100, 0, 25 (repeat as you toggle) -->
<!-- 27 (7 stops) means stops at 50, 67, 83, 100, 0, 17, 33 (repeat as you toggle) -->
<!-- 25 is special in that the 3 middle values (25, 50, 75) are exactly those that are recommended for smooth, normal, and quick responses -->
<field name="SmoothQuickSource" units="" type="uint8" elements="1" defaultvalue="25" description="Setting: 10-13 to use one of accessory0-3, 23 25 27 for FMS 3x toggle method with 3 5 7 positions"/>
<field name="SmoothQuickValue" units="" type="float" elements="1" defaultvalue="0.0" description="Remembers the value of the FMS 3x toggle"/>
<field name="DisableSanityChecks" units="bool" type="enum" elements="1" options="False,True" defaultvalue="False" description="Setting: Debugging tool (expert)"/>
<field name="GyroReadTimeAverage" units="s" type="float" elements="1" defaultvalue="0.001" description="Measured delay from gyro read to inner loop"/>
<field name="Complete" units="bool" type="enum" elements="1" options="False,True" defaultvalue="False" description="Automatically set True for a good complete tune or False for incomplete or bad"/>
<access gcs="readwrite" flight="readwrite"/>
<telemetrygcs acked="true" updatemode="onchange" period="0"/>
<telemetryflight acked="true" updatemode="onchange" period="0"/>
<logging updatemode="manual" period="0"/>
</object>
</xml>