PX4ParameterFactMetaData.xml 502 KB
Newer Older
1
<?xml version='1.0' encoding='UTF-8'?>
2
<parameters>
3
  <version>3</version>
4
  <parameter_version_major>1</parameter_version_major>
5
  <parameter_version_minor>15</parameter_version_minor>
Don Gagne's avatar
Don Gagne committed
6
  <group name="UAVCAN Motor Parameters" no_code_generation="true">
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
    <parameter default="75" name="ctl_bw" type="INT32">
      <short_desc>Speed controller bandwidth</short_desc>
      <long_desc>Speed controller bandwidth, in Hz. Higher values result in faster speed and current rise times, but may result in overshoot and higher current consumption. For fixed-wing aircraft, this value should be less than 50 Hz; for multirotors, values up to 100 Hz may provide improvements in responsiveness.</long_desc>
      <unit>Hertz</unit>
      <min>10</min>
      <max>250</max>
    </parameter>
    <parameter default="1" name="ctl_dir" type="INT32">
      <short_desc>Reverse direction</short_desc>
      <long_desc>Motor spin direction as detected during initial enumeration. Use 0 or 1 to reverse direction.</long_desc>
      <min>0</min>
      <max>1</max>
    </parameter>
    <parameter default="1" name="ctl_gain" type="FLOAT">
      <short_desc>Speed (RPM) controller gain</short_desc>
      <long_desc>Speed (RPM) controller gain. Determines controller
            aggressiveness; units are amp-seconds per radian. Systems with
            higher rotational inertia (large props) will need gain increased;
            systems with low rotational inertia (small props) may need gain
            decreased. Higher values result in faster response, but may result
            in oscillation and excessive overshoot. Lower values result in a
            slower, smoother response.</long_desc>
      <unit>amp-seconds per radian</unit>
      <decimal>3</decimal>
      <min>0.00</min>
      <max>1.00</max>
    </parameter>
    <parameter default="3.5" name="ctl_hz_idle" type="FLOAT">
      <short_desc>Idle speed (e Hz)</short_desc>
      <long_desc>Idle speed (e Hz)</long_desc>
      <unit>Hertz</unit>
      <decimal>3</decimal>
      <min>0.0</min>
      <max>100.0</max>
    </parameter>
    <parameter default="25" name="ctl_start_rate" type="INT32">
      <short_desc>Spin-up rate (e Hz/s)</short_desc>
      <long_desc>Spin-up rate (e Hz/s)</long_desc>
      <unit>Hz/s</unit>
      <min>5</min>
      <max>1000</max>
    </parameter>
    <parameter default="0" name="esc_index" type="INT32">
      <short_desc>Index of this ESC in throttle command messages.</short_desc>
      <long_desc>Index of this ESC in throttle command messages.</long_desc>
      <unit>Index</unit>
      <min>0</min>
      <max>15</max>
    </parameter>
    <parameter default="20034" name="id_ext_status" type="INT32">
      <short_desc>Extended status ID</short_desc>
      <long_desc>Extended status ID</long_desc>
      <min>1</min>
60
      <max>1000000</max>
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94
    </parameter>
    <parameter default="50000" name="int_ext_status" type="INT32">
      <short_desc>Extended status interval (µs)</short_desc>
      <long_desc>Extended status interval (µs)</long_desc>
      <unit>µs</unit>
      <min>0</min>
      <max>1000000</max>
    </parameter>
    <parameter default="50000" name="int_status" type="INT32">
      <short_desc>ESC status interval (µs)</short_desc>
      <long_desc>ESC status interval (µs)</long_desc>
      <unit>µs</unit>
      <max>1000000</max>
    </parameter>
    <parameter default="12" name="mot_i_max" type="FLOAT">
      <short_desc>Motor current limit in amps</short_desc>
      <long_desc>Motor current limit in amps. This determines the maximum
            current controller setpoint, as well as the maximum allowable
            current setpoint slew rate. This value should generally be set to
            the continuous current rating listed in the motor’s specification
            sheet, or set equal to the motor’s specified continuous power
            divided by the motor voltage limit.</long_desc>
      <unit>Amps</unit>
      <decimal>3</decimal>
      <min>1</min>
      <max>80</max>
    </parameter>
    <parameter default="2300" name="mot_kv" type="INT32">
      <short_desc>Motor Kv in RPM per volt</short_desc>
      <long_desc>Motor Kv in RPM per volt. This can be taken from the motor’s
            specification sheet; accuracy will help control performance but
            some deviation from the specified value is acceptable.</long_desc>
      <unit>RPM/v</unit>
      <min>0</min>
Don Gagne's avatar
Don Gagne committed
95
      <max>4000</max>
96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
    </parameter>
    <parameter default="0.0" name="mot_ls" type="FLOAT">
      <short_desc>READ ONLY: Motor inductance in henries.</short_desc>
      <long_desc>READ ONLY: Motor inductance in henries. This is measured on start-up.</long_desc>
      <unit>henries</unit>
      <decimal>3</decimal>
    </parameter>
    <parameter default="14" name="mot_num_poles" type="INT32">
      <short_desc>Number of motor poles.</short_desc>
      <long_desc>Number of motor poles. Used to convert mechanical speeds to
            electrical speeds. This number should be taken from the motor’s
            specification sheet.</long_desc>
      <unit>Poles</unit>
      <min>2</min>
      <max>40</max>
    </parameter>
    <parameter default="0.0" name="mot_rs" type="FLOAT">
      <short_desc>READ ONLY: Motor resistance in ohms</short_desc>
      <long_desc>READ ONLY: Motor resistance in ohms. This is measured on start-up. When
            tuning a new motor, check that this value is approximately equal
            to the value shown in the motor’s specification sheet.</long_desc>
      <unit>Ohms</unit>
      <decimal>3</decimal>
    </parameter>
Don Gagne's avatar
Don Gagne committed
120
    <parameter default="0.5" name="mot_v_accel" type="FLOAT">
121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139
      <short_desc>Acceleration limit (V)</short_desc>
      <long_desc>Acceleration limit (V)</long_desc>
      <unit>Volts</unit>
      <decimal>3</decimal>
      <min>0.01</min>
      <max>1.00</max>
    </parameter>
    <parameter default="14.8" name="mot_v_max" type="FLOAT">
      <short_desc>Motor voltage limit in volts</short_desc>
      <long_desc>Motor voltage limit in volts. The current controller’s
            commanded voltage will never exceed this value. Note that this may
            safely be above the nominal voltage of the motor; to determine the
            actual motor voltage limit, divide the motor’s rated power by the
            motor current limit.</long_desc>
      <unit>Volts</unit>
      <decimal>3</decimal>
      <min>0</min>
    </parameter>
  </group>
140
  <group name="Attitude Q estimator">
141 142 143 144
    <parameter default="1" name="ATT_ACC_COMP" type="INT32">
      <short_desc>Acceleration compensation based on GPS
velocity</short_desc>
      <boolean />
145
    </parameter>
146 147
    <parameter default="0.05" name="ATT_BIAS_MAX" type="FLOAT">
      <short_desc>Gyro bias limit</short_desc>
148
      <min>0</min>
149 150 151
      <max>2</max>
      <unit>rad/s</unit>
      <decimal>3</decimal>
152
    </parameter>
153 154 155 156
    <parameter default="0" name="ATT_EXT_HDG_M" type="INT32">
      <short_desc>External heading usage mode (from Motion capture/Vision)
Set to 1 to use heading estimate from vision.
Set to 2 to use heading from motion capture</short_desc>
157
      <min>0</min>
158 159 160 161 162 163
      <max>2</max>
      <values>
        <value code="0">None</value>
        <value code="1">Vision</value>
        <value code="2">Motion Capture</value>
      </values>
164 165 166
    </parameter>
    <parameter default="0.0" name="ATT_MAG_DECL" type="FLOAT">
      <short_desc>Magnetic declination, in degrees</short_desc>
Don Gagne's avatar
Don Gagne committed
167
      <long_desc>This parameter is not used in normal operation, as the declination is looked up based on the GPS coordinates of the vehicle.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
168
      <unit>deg</unit>
169
      <decimal>2</decimal>
170 171
    </parameter>
    <parameter default="1" name="ATT_MAG_DECL_A" type="INT32">
Lorenz Meier's avatar
Lorenz Meier committed
172
      <short_desc>Automatic GPS based declination compensation</short_desc>
Lorenz Meier's avatar
Lorenz Meier committed
173
      <boolean />
174
    </parameter>
175 176
    <parameter default="0.2" name="ATT_W_ACC" type="FLOAT">
      <short_desc>Complimentary filter accelerometer weight</short_desc>
177
      <min>0</min>
178 179
      <max>1</max>
      <decimal>2</decimal>
180
    </parameter>
181 182 183 184
    <parameter default="0.1" name="ATT_W_EXT_HDG" type="FLOAT">
      <short_desc>Complimentary filter external heading weight</short_desc>
      <min>0</min>
      <max>1</max>
185
    </parameter>
186 187
    <parameter default="0.1" name="ATT_W_GYRO_BIAS" type="FLOAT">
      <short_desc>Complimentary filter gyroscope bias weight</short_desc>
188
      <min>0</min>
189 190 191 192 193
      <max>1</max>
      <decimal>2</decimal>
    </parameter>
    <parameter default="0.1" name="ATT_W_MAG" type="FLOAT">
      <short_desc>Complimentary filter magnetometer weight</short_desc>
194
      <long_desc>Set to 0 to avoid using the magnetometer.</long_desc>
195 196 197
      <min>0</min>
      <max>1</max>
      <decimal>2</decimal>
198 199 200
    </parameter>
  </group>
  <group name="Battery Calibration">
201 202 203 204
    <parameter default="-1" name="BAT_ADC_CHANNEL" type="INT32">
      <short_desc>Battery ADC Channel</short_desc>
      <long_desc>This parameter specifies the ADC channel used to monitor voltage of main power battery. A value of -1 means to use the board default.</long_desc>
    </parameter>
205 206 207
    <parameter default="-1.0" name="BAT_A_PER_V" type="FLOAT">
      <short_desc>Battery current per volt (A/V)</short_desc>
      <long_desc>The voltage seen by the 3.3V ADC multiplied by this factor will determine the battery current. A value of -1 means to use the board default.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
208 209
      <decimal>8</decimal>
    </parameter>
210 211 212 213 214
    <parameter default="-1.0" name="BAT_CAPACITY" type="FLOAT">
      <short_desc>Battery capacity</short_desc>
      <long_desc>Defines the capacity of the attached battery.</long_desc>
      <min>-1.0</min>
      <max>100000</max>
215
      <unit>mAh</unit>
216 217 218 219
      <decimal>0</decimal>
      <increment>50</increment>
      <reboot_required>true</reboot_required>
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
220 221 222
    <parameter default="-1.0" name="BAT_CNT_V_CURR" type="FLOAT">
      <short_desc>Scaling from ADC counts to volt on the ADC input (battery current)</short_desc>
      <long_desc>This is not the battery current, but the intermediate ADC voltage. A value of -1 signifies that the board defaults are used, which is highly recommended.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
223 224
      <decimal>8</decimal>
    </parameter>
225 226 227
    <parameter default="-1.0" name="BAT_CNT_V_VOLT" type="FLOAT">
      <short_desc>Scaling from ADC counts to volt on the ADC input (battery voltage)</short_desc>
      <long_desc>This is not the battery voltage, but the intermediate ADC voltage. A value of -1 signifies that the board defaults are used, which is highly recommended.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
228 229
      <decimal>8</decimal>
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
230
    <parameter default="0.07" name="BAT_CRIT_THR" type="FLOAT">
Lorenz Meier's avatar
Lorenz Meier committed
231
      <short_desc>Critical threshold</short_desc>
Lorenz Meier's avatar
Lorenz Meier committed
232
      <long_desc>Sets the threshold when the battery will be reported as critically low. This has to be lower than the low threshold. This threshold commonly will trigger RTL.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
233
      <min>0.05</min>
Lorenz Meier's avatar
Lorenz Meier committed
234
      <max>0.1</max>
Lorenz Meier's avatar
Lorenz Meier committed
235
      <unit>norm</unit>
Lorenz Meier's avatar
Lorenz Meier committed
236 237
      <decimal>2</decimal>
      <increment>0.01</increment>
DonLakeFlyer's avatar
DonLakeFlyer committed
238
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
239
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
240 241 242 243 244 245 246 247
    <parameter default="0.05" name="BAT_EMERGEN_THR" type="FLOAT">
      <short_desc>Emergency threshold</short_desc>
      <long_desc>Sets the threshold when the battery will be reported as dangerously low. This has to be lower than the critical threshold. This threshold commonly will trigger landing.</long_desc>
      <min>0.03</min>
      <max>0.07</max>
      <unit>norm</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
DonLakeFlyer's avatar
DonLakeFlyer committed
248
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
249
    </parameter>
250 251 252 253 254 255
    <parameter default="0.15" name="BAT_LOW_THR" type="FLOAT">
      <short_desc>Low threshold</short_desc>
      <long_desc>Sets the threshold when the battery will be reported as low. This has to be higher than the critical threshold.</long_desc>
      <min>0.12</min>
      <max>0.4</max>
      <unit>norm</unit>
256
      <decimal>2</decimal>
Lorenz Meier's avatar
Lorenz Meier committed
257
      <increment>0.01</increment>
DonLakeFlyer's avatar
DonLakeFlyer committed
258
      <reboot_required>true</reboot_required>
259
    </parameter>
260
    <parameter default="0" name="BAT_N_CELLS" type="INT32">
261 262 263
      <short_desc>Number of cells</short_desc>
      <long_desc>Defines the number of cells the attached battery consists of.</long_desc>
      <unit>S</unit>
DonLakeFlyer's avatar
DonLakeFlyer committed
264
      <reboot_required>true</reboot_required>
265
      <values>
266
        <value code="0">Unconfigured</value>
267
        <value code="2">2S Battery</value>
268
        <value code="3">3S Battery</value>
269
        <value code="4">4S Battery</value>
270
        <value code="5">5S Battery</value>
271
        <value code="6">6S Battery</value>
272
        <value code="7">7S Battery</value>
273
        <value code="8">8S Battery</value>
274 275 276 277 278 279 280 281
        <value code="9">9S Battery</value>
        <value code="10">10S Battery</value>
        <value code="11">11S Battery</value>
        <value code="12">12S Battery</value>
        <value code="13">13S Battery</value>
        <value code="14">14S Battery</value>
        <value code="15">15S Battery</value>
        <value code="16">16S Battery</value>
282
      </values>
283
    </parameter>
284 285 286
    <parameter default="-1.0" name="BAT_R_INTERNAL" type="FLOAT">
      <short_desc>Explicitly defines the per cell internal resistance</short_desc>
      <long_desc>If non-negative, then this will be used in place of BAT_V_LOAD_DROP for all calculations.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
287
      <min>-1.0</min>
288 289
      <max>0.2</max>
      <unit>Ohms</unit>
DonLakeFlyer's avatar
DonLakeFlyer committed
290
      <reboot_required>true</reboot_required>
291
    </parameter>
292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314
    <parameter default="0" name="BAT_SOURCE" type="INT32">
      <short_desc>Battery monitoring source</short_desc>
      <long_desc>This parameter controls the source of battery data. The value 'Power Module' means that measurements are expected to come from a power module. If the value is set to 'External' then the system expects to receive mavlink battery status messages.</long_desc>
      <min>0</min>
      <max>1</max>
      <values>
        <value code="0">Power Module</value>
        <value code="1">External</value>
      </values>
    </parameter>
    <parameter default="4.05" name="BAT_V_CHARGED" type="FLOAT">
      <short_desc>Full cell voltage (5C load)</short_desc>
      <long_desc>Defines the voltage where a single cell of the battery is considered full under a mild load. This will never be the nominal voltage of 4.2V</long_desc>
      <unit>V</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>true</reboot_required>
    </parameter>
    <parameter default="-1.0" name="BAT_V_DIV" type="FLOAT">
      <short_desc>Battery voltage divider (V divider)</short_desc>
      <long_desc>This is the divider from battery voltage to 3.3V ADC voltage. If using e.g. Mauch power modules the value from the datasheet can be applied straight here. A value of -1 means to use the board default.</long_desc>
      <decimal>8</decimal>
    </parameter>
315
    <parameter default="3.5" name="BAT_V_EMPTY" type="FLOAT">
316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338
      <short_desc>Empty cell voltage (5C load)</short_desc>
      <long_desc>Defines the voltage where a single cell of the battery is considered empty. The voltage should be chosen before the steep dropoff to 2.8V. A typical lithium battery can only be discharged down to 10% before it drops off to a voltage level damaging the cells.</long_desc>
      <unit>V</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>true</reboot_required>
    </parameter>
    <parameter default="0.3" name="BAT_V_LOAD_DROP" type="FLOAT">
      <short_desc>Voltage drop per cell on full throttle</short_desc>
      <long_desc>This implicitely defines the internal resistance to maximum current ratio and assumes linearity. A good value to use is the difference between the 5C and 20-25C load. Not used if BAT_R_INTERNAL is set.</long_desc>
      <min>0.07</min>
      <max>0.5</max>
      <unit>V</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>true</reboot_required>
    </parameter>
    <parameter default="0.0" name="BAT_V_OFFS_CURR" type="FLOAT">
      <short_desc>Offset in volt as seen by the ADC input of the current sensor</short_desc>
      <long_desc>This offset will be subtracted before calculating the battery current based on the voltage.</long_desc>
      <decimal>8</decimal>
    </parameter>
  </group>
339 340 341 342 343 344 345 346 347 348
  <group name="Camera Capture">
    <parameter default="0.0" name="CAM_CAP_DELAY" type="FLOAT">
      <short_desc>Camera strobe delay</short_desc>
      <long_desc>This parameter sets the delay between image integration start and strobe firing</long_desc>
      <min>0.0</min>
      <max>100.0</max>
      <unit>ms</unit>
      <decimal>1</decimal>
    </parameter>
  </group>
349
  <group name="Camera Control">
350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367
    <parameter default="0" name="CAM_CAP_EDGE" type="INT32">
      <short_desc>Camera capture edge</short_desc>
      <reboot_required>true</reboot_required>
      <values>
        <value code="0">Falling edge</value>
        <value code="1">Rising edge</value>
      </values>
    </parameter>
    <parameter default="0" name="CAM_CAP_FBACK" type="INT32">
      <short_desc>Camera capture feedback</short_desc>
      <long_desc>Enables camera capture feedback</long_desc>
      <boolean />
      <reboot_required>true</reboot_required>
    </parameter>
    <parameter default="0" name="CAM_CAP_MODE" type="INT32">
      <short_desc>Camera capture timestamping mode</short_desc>
      <long_desc>Change time measurement</long_desc>
      <reboot_required>true</reboot_required>
368
      <values>
369 370 371
        <value code="0">Get absolute timestamp</value>
        <value code="1">Get timestamp of mid exposure (active high)</value>
        <value code="2">Get timestamp of mid exposure (active low)</value>
372 373 374
      </values>
    </parameter>
  </group>
Don Gagne's avatar
Don Gagne committed
375
  <group name="Camera trigger">
376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391
    <parameter default="40.0" name="TRIG_ACT_TIME" type="FLOAT">
      <short_desc>Camera trigger activation time</short_desc>
      <long_desc>This parameter sets the time the trigger needs to pulled high or low.</long_desc>
      <min>0.1</min>
      <max>3000</max>
      <unit>ms</unit>
      <decimal>1</decimal>
    </parameter>
    <parameter default="25.0" name="TRIG_DISTANCE" type="FLOAT">
      <short_desc>Camera trigger distance</short_desc>
      <long_desc>Sets the distance at which to trigger the camera.</long_desc>
      <min>0</min>
      <unit>m</unit>
      <decimal>1</decimal>
      <increment>1</increment>
    </parameter>
392
    <parameter default="4" name="TRIG_INTERFACE" type="INT32">
Lorenz Meier's avatar
Lorenz Meier committed
393 394 395 396 397
      <short_desc>Camera trigger Interface</short_desc>
      <long_desc>Selects the trigger interface</long_desc>
      <reboot_required>true</reboot_required>
      <values>
        <value code="1">GPIO</value>
398
        <value code="2">Seagull MAP2 (over PWM)</value>
399
        <value code="3">MAVLink (forward via MAV_CMD_IMAGE_START_CAPTURE)</value>
400
        <value code="4">Generic PWM (IR trigger, servo)</value>
Lorenz Meier's avatar
Lorenz Meier committed
401 402
      </values>
    </parameter>
Don Gagne's avatar
Don Gagne committed
403 404 405 406 407
    <parameter default="40.0" name="TRIG_INTERVAL" type="FLOAT">
      <short_desc>Camera trigger interval</short_desc>
      <long_desc>This parameter sets the time between two consecutive trigger events</long_desc>
      <min>4.0</min>
      <max>10000.0</max>
Lorenz Meier's avatar
Lorenz Meier committed
408
      <unit>ms</unit>
Lorenz Meier's avatar
Lorenz Meier committed
409
      <decimal>1</decimal>
Don Gagne's avatar
Don Gagne committed
410 411 412 413
    </parameter>
    <parameter default="0" name="TRIG_MODE" type="INT32">
      <short_desc>Camera trigger mode</short_desc>
      <min>0</min>
Lorenz Meier's avatar
Lorenz Meier committed
414
      <max>4</max>
Lorenz Meier's avatar
Lorenz Meier committed
415
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
416 417
      <values>
        <value code="0">Disable</value>
418
        <value code="1">Time based, on command</value>
Lorenz Meier's avatar
Lorenz Meier committed
419
        <value code="2">Time based, always on</value>
420
        <value code="3">Distance based, always on</value>
421
        <value code="4">Distance based, on command (Survey mode)</value>
Lorenz Meier's avatar
Lorenz Meier committed
422
      </values>
Don Gagne's avatar
Don Gagne committed
423
    </parameter>
424
    <parameter default="56" name="TRIG_PINS" type="INT32">
Don Gagne's avatar
Don Gagne committed
425
      <short_desc>Camera trigger pin</short_desc>
426
      <long_desc>Selects which pin is used, ranges from 1 to 6 (AUX1-AUX6 on px4_fmu-v2 and the rail pins on px4_fmu-v4). The PWM interface takes two pins per camera, while relay triggers on every pin individually. Example: Value 56 would trigger on pins 5 and 6. For GPIO mode Pin 6 will be triggered followed by 5. With a value of 65 pin 5 will be triggered followed by 6. Pins may be non contiguous. I.E. 16 or 61. In GPIO mode the delay pin to pin is &lt; .2 uS.</long_desc>
Don Gagne's avatar
Don Gagne committed
427 428
      <min>1</min>
      <max>123456</max>
Lorenz Meier's avatar
Lorenz Meier committed
429 430
      <decimal>0</decimal>
      <reboot_required>true</reboot_required>
Don Gagne's avatar
Don Gagne committed
431
    </parameter>
432 433 434
    <parameter default="0" name="TRIG_POLARITY" type="INT32">
      <short_desc>Camera trigger polarity</short_desc>
      <long_desc>This parameter sets the polarity of the trigger (0 = active low, 1 = active high )</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
435
      <min>0</min>
436 437 438 439 440
      <max>1</max>
      <values>
        <value code="0">Active low</value>
        <value code="1">Active high</value>
      </values>
Lorenz Meier's avatar
Lorenz Meier committed
441
    </parameter>
442 443 444 445 446 447 448 449 450 451 452 453 454 455
    <parameter default="1500" name="TRIG_PWM_NEUTRAL" type="INT32">
      <short_desc>PWM neutral output on trigger pin</short_desc>
      <min>1000</min>
      <max>2000</max>
      <unit>us</unit>
      <reboot_required>true</reboot_required>
    </parameter>
    <parameter default="1900" name="TRIG_PWM_SHOOT" type="INT32">
      <short_desc>PWM output to trigger shot</short_desc>
      <min>1000</min>
      <max>2000</max>
      <unit>us</unit>
      <reboot_required>true</reboot_required>
    </parameter>
456 457
  </group>
  <group name="Circuit Breaker">
458
    <parameter category="Developer" default="0" name="CBRK_AIRSPD_CHK" type="INT32">
459
      <short_desc>Circuit breaker for airspeed sensor</short_desc>
Don Gagne's avatar
Don Gagne committed
460
      <long_desc>Setting this parameter to 162128 will disable the check for an airspeed sensor. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
461 462
      <min>0</min>
      <max>162128</max>
Lorenz Meier's avatar
Lorenz Meier committed
463
      <reboot_required>true</reboot_required>
464
    </parameter>
465
    <parameter category="Developer" default="0" name="CBRK_BUZZER" type="INT32">
466 467
      <short_desc>Circuit breaker for disabling buzzer</short_desc>
      <long_desc>Setting this parameter to 782097 will disable the buzzer audio notification. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
468
      <min>0</min>
469
      <max>782097</max>
Lorenz Meier's avatar
Lorenz Meier committed
470
      <reboot_required>true</reboot_required>
471
    </parameter>
472
    <parameter category="Developer" default="284953" name="CBRK_ENGINEFAIL" type="INT32">
473
      <short_desc>Circuit breaker for engine failure detection</short_desc>
Lorenz Meier's avatar
Lorenz Meier committed
474
      <long_desc>Setting this parameter to 284953 will disable the engine failure detection. If the aircraft is in engine failure mode the engine failure flag will be set to healthy WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
475 476
      <min>0</min>
      <max>284953</max>
Lorenz Meier's avatar
Lorenz Meier committed
477
      <reboot_required>true</reboot_required>
478
    </parameter>
479
    <parameter category="Developer" default="121212" name="CBRK_FLIGHTTERM" type="INT32">
480
      <short_desc>Circuit breaker for flight termination</short_desc>
481
      <long_desc>Setting this parameter to 121212 will disable the flight termination action if triggered by the FailureDetector logic or if FMU is lost. This circuit breaker does not affect the RC loss, data link loss and geofence safety logic.</long_desc>
482 483 484 485
      <min>0</min>
      <max>121212</max>
      <reboot_required>true</reboot_required>
    </parameter>
486
    <parameter category="Developer" default="0" name="CBRK_GPSFAIL" type="INT32">
487
      <short_desc>Circuit breaker for GPS failure detection</short_desc>
Don Gagne's avatar
Don Gagne committed
488
      <long_desc>Setting this parameter to 240024 will disable the GPS failure detection. If this check is enabled, then the sensor check will fail if the GPS module is missing. It will also check for excessive signal noise on the GPS receiver and warn the user if detected. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
489 490
      <min>0</min>
      <max>240024</max>
Lorenz Meier's avatar
Lorenz Meier committed
491
      <reboot_required>true</reboot_required>
492
    </parameter>
493
    <parameter category="Developer" default="0" name="CBRK_IO_SAFETY" type="INT32">
494 495
      <short_desc>Circuit breaker for IO safety</short_desc>
      <long_desc>Setting this parameter to 22027 will disable IO safety. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
496
      <min>0</min>
497 498 499
      <max>22027</max>
      <reboot_required>true</reboot_required>
    </parameter>
500
    <parameter category="Developer" default="0" name="CBRK_RATE_CTRL" type="INT32">
501 502 503 504 505 506
      <short_desc>Circuit breaker for rate controller output</short_desc>
      <long_desc>Setting this parameter to 140253 will disable the rate controller uORB publication. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
      <min>0</min>
      <max>140253</max>
      <reboot_required>true</reboot_required>
    </parameter>
507
    <parameter category="Developer" default="0" name="CBRK_SUPPLY_CHK" type="INT32">
508 509 510 511
      <short_desc>Circuit breaker for power supply check</short_desc>
      <long_desc>Setting this parameter to 894281 will disable the power valid checks in the commander. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
      <min>0</min>
      <max>894281</max>
Lorenz Meier's avatar
Lorenz Meier committed
512
      <reboot_required>true</reboot_required>
513
    </parameter>
514
    <parameter category="Developer" default="0" name="CBRK_USB_CHK" type="INT32">
515 516 517 518
      <short_desc>Circuit breaker for USB link check</short_desc>
      <long_desc>Setting this parameter to 197848 will disable the USB connected checks in the commander. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
      <min>0</min>
      <max>197848</max>
Lorenz Meier's avatar
Lorenz Meier committed
519
      <reboot_required>true</reboot_required>
520
    </parameter>
521
    <parameter category="Developer" default="0" name="CBRK_VELPOSERR" type="INT32">
522 523 524 525 526 527
      <short_desc>Circuit breaker for position error check</short_desc>
      <long_desc>Setting this parameter to 201607 will disable the position and velocity accuracy checks in the commander. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
      <min>0</min>
      <max>201607</max>
      <reboot_required>true</reboot_required>
    </parameter>
528 529
  </group>
  <group name="Commander">
530
    <parameter default="256010" name="COM_ARM_AUTH" type="INT32">
531
      <short_desc>Arm authorization parameters, this uint32_t will be split between starting from the LSB:
532 533 534 535 536 537 538
- 8bits to authorizer system id
- 16bits to authentication method parameter, this will be used to store a timeout for the first 2 methods but can be used to another parameter for other new authentication methods.
- 7bits to authentication method
- one arm = 0
- two step arm = 1
* the MSB bit is not used to avoid problems in the conversion between int and uint</short_desc>
      <long_desc>Default value: (10 &lt;&lt; 0 | 1000 &lt;&lt; 8 | 0 &lt;&lt; 24) = 256010 - authorizer system id = 10 - authentication method parameter = 10000msec of timeout - authentication method = during arm</long_desc>
539
    </parameter>
540
    <parameter default="1.73e-3" name="COM_ARM_EKF_AB" type="FLOAT">
541 542
      <short_desc>Maximum value of EKF accelerometer delta velocity bias estimate that will allow arming.
Note: ekf2 will limit the delta velocity bias estimate magnitude to be less than EKF2_ABL_LIM * FILTER_UPDATE_PERIOD_MS * 0.001 so this parameter must be less than that to be useful</short_desc>
543 544 545 546
      <min>0.001</min>
      <max>0.01</max>
      <unit>m/s</unit>
      <decimal>4</decimal>
547
      <increment>0.0001</increment>
548
    </parameter>
549 550 551 552 553 554 555 556 557 558 559
    <parameter default="8.7e-4" name="COM_ARM_EKF_GB" type="FLOAT">
      <short_desc>Maximum value of EKF gyro delta angle bias estimate that will allow arming</short_desc>
      <min>0.0001</min>
      <max>0.0017</max>
      <unit>rad</unit>
      <decimal>5</decimal>
      <increment>0.0001</increment>
    </parameter>
    <parameter default="1.0" name="COM_ARM_EKF_HGT" type="FLOAT">
      <short_desc>Maximum EKF height innovation test ratio that will allow arming</short_desc>
      <min>0.1</min>
560
      <max>1.0</max>
561
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
562
      <decimal>2</decimal>
563
      <increment>0.05</increment>
564
    </parameter>
565 566 567 568 569
    <parameter default="0.5" name="COM_ARM_EKF_POS" type="FLOAT">
      <short_desc>Maximum EKF position innovation test ratio that will allow arming</short_desc>
      <min>0.1</min>
      <max>1.0</max>
      <unit>m</unit>
570
      <decimal>2</decimal>
571
      <increment>0.05</increment>
572
    </parameter>
573 574 575 576 577 578 579
    <parameter default="0.5" name="COM_ARM_EKF_VEL" type="FLOAT">
      <short_desc>Maximum EKF velocity innovation test ratio that will allow arming</short_desc>
      <min>0.1</min>
      <max>1.0</max>
      <unit>m/s</unit>
      <decimal>2</decimal>
      <increment>0.05</increment>
580
    </parameter>
581 582 583 584 585 586 587
    <parameter default="0.5" name="COM_ARM_EKF_YAW" type="FLOAT">
      <short_desc>Maximum EKF yaw innovation test ratio that will allow arming</short_desc>
      <min>0.1</min>
      <max>1.0</max>
      <unit>rad</unit>
      <decimal>2</decimal>
      <increment>0.05</increment>
588
    </parameter>
589 590 591 592 593 594
    <parameter default="0.7" name="COM_ARM_IMU_ACC" type="FLOAT">
      <short_desc>Maximum accelerometer inconsistency between IMU units that will allow arming</short_desc>
      <min>0.1</min>
      <max>1.0</max>
      <unit>m/s/s</unit>
      <decimal>2</decimal>
595 596
      <increment>0.05</increment>
    </parameter>
597 598 599 600 601 602 603
    <parameter default="0.25" name="COM_ARM_IMU_GYR" type="FLOAT">
      <short_desc>Maximum rate gyro inconsistency between IMU units that will allow arming</short_desc>
      <min>0.02</min>
      <max>0.3</max>
      <unit>rad/s</unit>
      <decimal>3</decimal>
      <increment>0.01</increment>
Don Gagne's avatar
Don Gagne committed
604
    </parameter>
605 606 607 608 609
    <parameter default="0.15" name="COM_ARM_MAG" type="FLOAT">
      <short_desc>Maximum magnetic field inconsistency between units that will allow arming</short_desc>
      <min>0.05</min>
      <max>0.5</max>
      <unit>Gauss</unit>
610
      <decimal>2</decimal>
611
      <increment>0.05</increment>
Don Gagne's avatar
Don Gagne committed
612
    </parameter>
613 614 615 616 617 618 619 620
    <parameter default="0" name="COM_ARM_MIS_REQ" type="INT32">
      <short_desc>Require valid mission to arm</short_desc>
      <long_desc>The default allows to arm the vehicle without a valid mission.</long_desc>
      <boolean />
    </parameter>
    <parameter default="0" name="COM_ARM_SWISBTN" type="INT32">
      <short_desc>Arm switch is only a button</short_desc>
      <long_desc>The default uses the arm switch as real switch. If parameter set button gets handled like stick arming.</long_desc>
621
      <min>0</min>
622
      <max>1</max>
623
      <values>
624 625
        <value code="0">Arm switch is a switch that stays on when armed</value>
        <value code="1">Arm switch is a button that only triggers arming and disarming</value>
626
      </values>
627
    </parameter>
628 629 630 631
    <parameter default="1" name="COM_ARM_WO_GPS" type="INT32">
      <short_desc>Allow arming without GPS</short_desc>
      <long_desc>The default allows to arm the vehicle without GPS signal.</long_desc>
      <boolean />
Lorenz Meier's avatar
Lorenz Meier committed
632
    </parameter>
633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655
    <parameter category="Developer" default="0" name="COM_ASPD_FS_ACT" type="INT32">
      <short_desc>Airspeed fault detection (Experimental)</short_desc>
      <long_desc>Failsafe action when bad airspeed measurements are detected. Ensure the COM_ASPD_STALL parameter is set correctly before use.</long_desc>
      <values>
        <value code="0">disabled</value>
        <value code="1">log a message</value>
        <value code="2">log a message, warn the user</value>
        <value code="3">log a message, warn the user, switch to non-airspeed TECS mode</value>
        <value code="4">log a message, warn the user, switch to non-airspeed TECS mode, switch to Return mode after COM_ASPD_FS_DLY seconds</value>
      </values>
    </parameter>
    <parameter category="Developer" default="0" name="COM_ASPD_FS_DLY" type="INT32">
      <short_desc>Airspeed fault detection delay before RTL (Experimental)</short_desc>
      <long_desc>RTL delay after bad airspeed measurements are detected if COM_ASPD_FS_ACT is set to 4. Ensure the COM_ASPD_STALL parameter is set correctly before use. The failsafe start and stop delays are controlled by the COM_TAS_FS_T1 and COM_TAS_FS_T2 parameters. Additional protection against persistent airspeed sensor errors can be enabled using the COM_TAS_FS_INNOV parameter, but these addtional checks are more prone to false positives in windy conditions.</long_desc>
      <min>0</min>
      <max>300</max>
      <unit>s</unit>
    </parameter>
    <parameter category="Developer" default="10.0" name="COM_ASPD_STALL" type="FLOAT">
      <short_desc>Airspeed fault detection stall airspeed. (Experimental)</short_desc>
      <long_desc>This is the minimum indicated airspeed at which the wing can produce 1g of lift. It is used by the airspeed sensor fault detection and failsafe calculation to detect a significant airspeed low measurement error condition and should be set based on flight test for reliable operation. The failsafe response is controlled by the COM_ASPD_FS_ACT parameter.</long_desc>
      <unit>m/s</unit>
    </parameter>
656
    <parameter default="-1.0" name="COM_DISARM_LAND" type="FLOAT">
657
      <short_desc>Time-out for auto disarm after landing</short_desc>
658 659
      <long_desc>A non-zero, positive value specifies the time-out period in seconds after which the vehicle will be automatically disarmed in case a landing situation has been detected during this period. The vehicle will also auto-disarm right after arming if it has not even flown, however the time will always be 10 seconds such that the pilot has enough time to take off. A negative value means that automatic disarming triggered by landing detection is disabled.</long_desc>
      <min>-1</min>
Lorenz Meier's avatar
Lorenz Meier committed
660
      <max>20</max>
Lorenz Meier's avatar
Lorenz Meier committed
661
      <unit>s</unit>
662
      <decimal>2</decimal>
663
    </parameter>
664 665 666 667 668 669 670 671
    <parameter default="10" name="COM_DL_LOSS_T" type="INT32">
      <short_desc>Datalink loss time threshold</short_desc>
      <long_desc>After this amount of seconds without datalink the data link lost mode triggers</long_desc>
      <min>5</min>
      <max>300</max>
      <unit>s</unit>
      <decimal>1</decimal>
      <increment>0.5</increment>
Lorenz Meier's avatar
Lorenz Meier committed
672
    </parameter>
673 674 675 676 677 678 679
    <parameter default="5.0" name="COM_EF_C2T" type="FLOAT">
      <short_desc>Engine Failure Current/Throttle Threshold</short_desc>
      <long_desc>Engine failure triggers only below this current value</long_desc>
      <min>0.0</min>
      <max>50.0</max>
      <unit>A/%</unit>
      <decimal>2</decimal>
Lorenz Meier's avatar
Lorenz Meier committed
680 681
      <increment>1</increment>
    </parameter>
682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697
    <parameter default="0.5" name="COM_EF_THROT" type="FLOAT">
      <short_desc>Engine Failure Throttle Threshold</short_desc>
      <long_desc>Engine failure triggers only above this throttle value</long_desc>
      <min>0.0</min>
      <max>1.0</max>
      <unit>norm</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
    </parameter>
    <parameter default="10.0" name="COM_EF_TIME" type="FLOAT">
      <short_desc>Engine Failure Time Threshold</short_desc>
      <long_desc>Engine failure triggers only if the throttle threshold and the current to throttle threshold are violated for this time</long_desc>
      <min>0.0</min>
      <max>60.0</max>
      <unit>s</unit>
      <decimal>1</decimal>
Lorenz Meier's avatar
Lorenz Meier committed
698 699
      <increment>1</increment>
    </parameter>
700
    <parameter category="System" default="0" name="COM_FLIGHT_UUID" type="INT32" volatile="true">
701 702 703 704
      <short_desc>Next flight UUID</short_desc>
      <long_desc>This number is incremented automatically after every flight on disarming in order to remember the next flight UUID. The first flight is 0.</long_desc>
      <min>0</min>
    </parameter>
705 706 707 708
    <parameter default="-1" name="COM_FLTMODE1" type="INT32">
      <short_desc>First flightmode slot (1000-1160)</short_desc>
      <long_desc>If the main switch channel is in this range the selected flight mode will be applied.</long_desc>
      <values>
709
        <value code="-1">Unassigned</value>
710
        <value code="0">Manual</value>
711
        <value code="1">Altitude</value>
712
        <value code="2">Position</value>
713
        <value code="3">Mission</value>
714 715
        <value code="4">Hold</value>
        <value code="5">Return</value>
716 717
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
718
        <value code="8">Stabilized</value>
719 720 721 722
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
723 724 725 726 727 728
      </values>
    </parameter>
    <parameter default="-1" name="COM_FLTMODE2" type="INT32">
      <short_desc>Second flightmode slot (1160-1320)</short_desc>
      <long_desc>If the main switch channel is in this range the selected flight mode will be applied.</long_desc>
      <values>
729
        <value code="-1">Unassigned</value>
730
        <value code="0">Manual</value>
731
        <value code="1">Altitude</value>
732
        <value code="2">Position</value>
733
        <value code="3">Mission</value>
734 735
        <value code="4">Hold</value>
        <value code="5">Return</value>
736 737
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
738
        <value code="8">Stabilized</value>
739 740 741 742
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
743 744 745 746 747 748
      </values>
    </parameter>
    <parameter default="-1" name="COM_FLTMODE3" type="INT32">
      <short_desc>Third flightmode slot (1320-1480)</short_desc>
      <long_desc>If the main switch channel is in this range the selected flight mode will be applied.</long_desc>
      <values>
749
        <value code="-1">Unassigned</value>
750
        <value code="0">Manual</value>
751
        <value code="1">Altitude</value>
752
        <value code="2">Position</value>
753
        <value code="3">Mission</value>
754 755
        <value code="4">Hold</value>
        <value code="5">Return</value>
756 757
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
758
        <value code="8">Stabilized</value>
759 760 761 762
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
763 764 765 766 767 768
      </values>
    </parameter>
    <parameter default="-1" name="COM_FLTMODE4" type="INT32">
      <short_desc>Fourth flightmode slot (1480-1640)</short_desc>
      <long_desc>If the main switch channel is in this range the selected flight mode will be applied.</long_desc>
      <values>
769
        <value code="-1">Unassigned</value>
770
        <value code="0">Manual</value>
771
        <value code="1">Altitude</value>
772
        <value code="2">Position</value>
773
        <value code="3">Mission</value>
774 775
        <value code="4">Hold</value>
        <value code="5">Return</value>
776 777
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
778
        <value code="8">Stabilized</value>
779 780 781 782
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
783 784 785 786 787 788
      </values>
    </parameter>
    <parameter default="-1" name="COM_FLTMODE5" type="INT32">
      <short_desc>Fifth flightmode slot (1640-1800)</short_desc>
      <long_desc>If the main switch channel is in this range the selected flight mode will be applied.</long_desc>
      <values>
789
        <value code="-1">Unassigned</value>
790
        <value code="0">Manual</value>
791
        <value code="1">Altitude</value>
792
        <value code="2">Position</value>
793
        <value code="3">Mission</value>
794 795
        <value code="4">Hold</value>
        <value code="5">Return</value>
796 797
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
798
        <value code="8">Stabilized</value>
799 800 801 802
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
803 804 805 806 807 808
      </values>
    </parameter>
    <parameter default="-1" name="COM_FLTMODE6" type="INT32">
      <short_desc>Sixth flightmode slot (1800-2000)</short_desc>
      <long_desc>If the main switch channel is in this range the selected flight mode will be applied.</long_desc>
      <values>
809
        <value code="-1">Unassigned</value>
810
        <value code="0">Manual</value>
811
        <value code="1">Altitude</value>
812
        <value code="2">Position</value>
813
        <value code="3">Mission</value>
814 815
        <value code="4">Hold</value>
        <value code="5">Return</value>
816 817
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
818
        <value code="8">Stabilized</value>
819 820 821 822
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
823 824
      </values>
    </parameter>
825 826 827 828 829 830 831 832 833 834
    <parameter default="0" name="COM_FLT_PROFILE" type="INT32">
      <short_desc>User Flight Profile</short_desc>
      <long_desc>Describes the intended use of the vehicle. Can be used by ground control software or log post processing. This param does not influence the behavior within the firmware. This means for example the control logic is independent of the setting of this param (but depends on other params).</long_desc>
      <values>
        <value code="0">Default</value>
        <value code="100">Pro User</value>
        <value code="200">Flight Tester</value>
        <value code="300">Developer</value>
      </values>
    </parameter>
835 836 837 838 839 840 841 842 843 844 845 846 847 848
    <parameter default="120" name="COM_HLDL_LOSS_T" type="INT32">
      <short_desc>High Latency Datalink loss time threshold</short_desc>
      <long_desc>After this amount of seconds without datalink the data link lost mode triggers</long_desc>
      <min>60</min>
      <max>3600</max>
      <unit>s</unit>
    </parameter>
    <parameter default="0" name="COM_HLDL_REG_T" type="INT32">
      <short_desc>High Latency Datalink regain time threshold</short_desc>
      <long_desc>After a data link loss: after this this amount of seconds with a healthy datalink the 'datalink loss' flag is set back to false</long_desc>
      <min>0</min>
      <max>60</max>
      <unit>s</unit>
    </parameter>
849 850 851 852 853
    <parameter default="5.0" name="COM_HOME_H_T" type="FLOAT">
      <short_desc>Home set horizontal threshold</short_desc>
      <long_desc>The home position will be set if the estimated positioning accuracy is below the threshold.</long_desc>
      <min>2</min>
      <max>15</max>
Lorenz Meier's avatar
Lorenz Meier committed
854 855
      <unit>m</unit>
      <decimal>2</decimal>
856
      <increment>0.5</increment>
857
    </parameter>
858 859 860 861 862
    <parameter default="10.0" name="COM_HOME_V_T" type="FLOAT">
      <short_desc>Home set vertical threshold</short_desc>
      <long_desc>The home position will be set if the estimated positioning accuracy is below the threshold.</long_desc>
      <min>5</min>
      <max>25</max>
863
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
864
      <decimal>2</decimal>
865
      <increment>0.5</increment>
866
    </parameter>
867 868 869 870 871 872 873
    <parameter default="0" name="COM_LOW_BAT_ACT" type="INT32">
      <short_desc>Battery failsafe mode</short_desc>
      <long_desc>Action the system takes on low battery. Defaults to off</long_desc>
      <decimal>0</decimal>
      <increment>1</increment>
      <values>
        <value code="0">Warning</value>
874 875 876
        <value code="1">Return mode</value>
        <value code="2">Land mode</value>
        <value code="3">Return mode at critically low level, Land mode at current position if reaching dangerously low levels</value>
877
      </values>
878
    </parameter>
879 880 881 882 883 884 885
    <parameter default="100" name="COM_OA_BOOT_T" type="INT32">
      <short_desc>Set avoidance system bootup timeout</short_desc>
      <long_desc>The avoidance system running on the companion computer is expected to boot within this time and start providing trajectory points. If no avoidance system is detected a MAVLink warning message is sent.</long_desc>
      <min>0</min>
      <max>200</max>
      <unit>s</unit>
    </parameter>
886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906
    <parameter default="0" name="COM_OBL_ACT" type="INT32">
      <short_desc>Set offboard loss failsafe mode</short_desc>
      <long_desc>The offboard loss failsafe will only be entered after a timeout, set by COM_OF_LOSS_T in seconds.</long_desc>
      <values>
        <value code="0">Land mode</value>
        <value code="1">Hold mode</value>
        <value code="2">Return mode</value>
      </values>
    </parameter>
    <parameter default="0" name="COM_OBL_RC_ACT" type="INT32">
      <short_desc>Set offboard loss failsafe mode when RC is available</short_desc>
      <long_desc>The offboard loss failsafe will only be entered after a timeout, set by COM_OF_LOSS_T in seconds.</long_desc>
      <values>
        <value code="0">Position mode</value>
        <value code="1">Altitude mode</value>
        <value code="2">Manual</value>
        <value code="3">Return mode</value>
        <value code="4">Land mode</value>
        <value code="5">Hold mode</value>
      </values>
    </parameter>
907 908 909 910 911
    <parameter default="0.0" name="COM_OF_LOSS_T" type="FLOAT">
      <short_desc>Time-out to wait when offboard connection is lost before triggering offboard lost action.
See COM_OBL_ACT and COM_OBL_RC_ACT to configure action</short_desc>
      <min>0</min>
      <max>60</max>
912
      <unit>s</unit>
913
      <increment>1</increment>
914
    </parameter>
915 916 917 918 919 920 921 922
    <parameter default="0" name="COM_POSCTL_NAVL" type="INT32">
      <short_desc>Position control navigation loss response</short_desc>
      <long_desc>This sets the flight mode that will be used if navigation accuracy is no longer adequate for position control. Navigation accuracy checks can be disabled using the CBRK_VELPOSERR parameter, but doing so will remove protection for all flight modes.</long_desc>
      <values>
        <value code="0">Assume use of remote control after fallback. Switch to Altitude mode if a height estimate is available, else switch to MANUAL.</value>
        <value code="1">Assume no use of remote control after fallback. Switch to Land mode if a height estimate is available, else switch to TERMINATION.</value>
      </values>
    </parameter>
923 924 925
    <parameter default="1" name="COM_POS_FS_DELAY" type="INT32">
      <short_desc>Loss of position failsafe activation delay</short_desc>
      <long_desc>This sets number of seconds that the position checks need to be failed before the failsafe will activate. The default value has been optimised for rotary wing applications. For fixed wing applications, a larger value between 5 and 10 should be used.</long_desc>
926 927
      <min>1</min>
      <max>100</max>
928 929 930
      <unit>sec</unit>
      <reboot_required>true</reboot_required>
    </parameter>
931 932
    <parameter default="5" name="COM_POS_FS_EPH" type="FLOAT">
      <short_desc>Horizontal position error threshold</short_desc>
933
      <long_desc>This is the horizontal position error (EPH) threshold that will trigger a failsafe. The default is appropriate for a multicopter. Can be increased for a fixed-wing.</long_desc>
934 935 936 937 938 939 940
      <unit>m</unit>
    </parameter>
    <parameter default="10" name="COM_POS_FS_EPV" type="FLOAT">
      <short_desc>Vertical position error threshold</short_desc>
      <long_desc>This is the vertical position error (EPV) threshold that will trigger a failsafe. The default is appropriate for a multicopter. Can be increased for a fixed-wing.</long_desc>
      <unit>m</unit>
    </parameter>
941 942 943 944 945
    <parameter default="10" name="COM_POS_FS_GAIN" type="INT32">
      <short_desc>Loss of position probation gain factor</short_desc>
      <long_desc>This sets the rate that the loss of position probation time grows when position checks are failing. The default value has been optimised for rotary wing applications. For fixed wing applications a value of 0 should be used.</long_desc>
      <reboot_required>true</reboot_required>
    </parameter>
946 947 948
    <parameter default="30" name="COM_POS_FS_PROB" type="INT32">
      <short_desc>Loss of position probation delay at takeoff</short_desc>
      <long_desc>The probation delay is the number of seconds that the EKF innovation checks need to pass for the position to be declared good after it has been declared bad. The probation delay will be reset to this parameter value when takeoff is detected. After takeoff, if position checks are passing, the probation delay will reduce by one second for every lapsed second of valid position down to a minimum of 1 second. If position checks are failing, the probation delay will increase by COM_POS_FS_GAIN seconds for every lapsed second up to a maximum of 100 seconds. The default value has been optimised for rotary wing applications. For fixed wing applications, a value of 1 should be used.</long_desc>
949 950
      <min>1</min>
      <max>100</max>
951 952 953
      <unit>sec</unit>
      <reboot_required>true</reboot_required>
    </parameter>
954 955 956 957 958
    <parameter default="1000" name="COM_RC_ARM_HYST" type="INT32">
      <short_desc>RC input arm/disarm command duration</short_desc>
      <long_desc>The default value of 1000 requires the stick to be held in the arm or disarm position for 1 second.</long_desc>
      <min>100</min>
      <max>1500</max>
959
    </parameter>
960 961 962 963 964 965 966 967 968 969 970 971 972 973
    <parameter default="0" name="COM_RC_IN_MODE" type="INT32">
      <short_desc>RC control input mode</short_desc>
      <long_desc>The default value of 0 requires a valid RC transmitter setup. Setting this to 1 allows joystick control and disables RC input handling and the associated checks. A value of 2 will generate RC control data from manual input received via MAVLink instead of directly forwarding the manual input data.</long_desc>
      <min>0</min>
      <max>2</max>
      <values>
        <value code="0">RC Transmitter</value>
        <value code="1">Joystick/No RC Checks</value>
        <value code="2">Virtual RC by Joystick</value>
      </values>
    </parameter>
    <parameter default="0.5" name="COM_RC_LOSS_T" type="FLOAT">
      <short_desc>RC loss time threshold</short_desc>
      <long_desc>After this amount of seconds without RC connection the rc lost flag is set to true</long_desc>
974
      <min>0</min>
975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991
      <max>35</max>
      <unit>s</unit>
      <decimal>1</decimal>
      <increment>0.1</increment>
    </parameter>
    <parameter default="0" name="COM_RC_OVERRIDE" type="INT32">
      <short_desc>Enable RC stick override of auto modes</short_desc>
      <boolean />
    </parameter>
    <parameter default="12.0" name="COM_RC_STICK_OV" type="FLOAT">
      <short_desc>RC stick override threshold</short_desc>
      <long_desc>If an RC stick is moved more than by this amount the system will interpret this as override request by the pilot.</long_desc>
      <min>5</min>
      <max>40</max>
      <unit>%</unit>
      <decimal>0</decimal>
      <increment>0.05</increment>
992
    </parameter>
993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018
    <parameter category="Developer" default="1.0" name="COM_TAS_FS_INNOV" type="FLOAT">
      <short_desc>Airspeed failsafe consistency threshold (Experimental)</short_desc>
      <long_desc>This specifies the minimum airspeed test ratio as logged in estimator_status.tas_test_ratio required to trigger a failsafe. Larger values make the check less sensitive, smaller values make it more sensitive. Start with a value of 1.0 when tuning. When estimator_status.tas_test_ratio is &gt; 1.0 it indicates the inconsistency between predicted and measured airspeed is large enough to cause the navigation EKF to reject airspeed measurements. The time required to detect a fault when the threshold is exceeded depends on the size of the exceedance and is controlled by the COM_TAS_FS_INTEG parameter. The subsequent failsafe response is controlled by the COM_ASPD_FS_ACT parameter.</long_desc>
      <min>0.5</min>
      <max>3.0</max>
    </parameter>
    <parameter category="Developer" default="-1.0" name="COM_TAS_FS_INTEG" type="FLOAT">
      <short_desc>Airspeed failsafe consistency delay (Experimental)</short_desc>
      <long_desc>This sets the time integral of airspeed test ratio exceedance above COM_TAS_FS_INNOV required to trigger a failsafe. For example if COM_TAS_FS_INNOV is 100 and estimator_status.tas_test_ratio is 2.0, then the exceedance is 1.0 and the integral will rise at a rate of 1.0/second. A negative value disables the check. Larger positive values make the check less sensitive, smaller positive values make it more sensitive. The failsafe response is controlled by the COM_ASPD_FS_ACT parameter.</long_desc>
      <max>30.0</max>
      <unit>s</unit>
    </parameter>
    <parameter category="Developer" default="3" name="COM_TAS_FS_T1" type="INT32">
      <short_desc>Airspeed failsafe stop delay (Experimental)</short_desc>
      <long_desc>Delay before stopping use of airspeed sensor if checks indicate sensor is bad. The failsafe response is controlled by the COM_ASPD_FS_ACT parameter.</long_desc>
      <min>1</min>
      <max>10</max>
      <unit>s</unit>
    </parameter>
    <parameter category="Developer" default="100" name="COM_TAS_FS_T2" type="INT32">
      <short_desc>Airspeed failsafe start delay (Experimental)</short_desc>
      <long_desc>Delay before switching back to using airspeed sensor if checks indicate sensor is good. The failsafe response is controlled by the COM_ASPD_FS_ACT parameter.</long_desc>
      <min>10</min>
      <max>1000</max>
      <unit>s</unit>
    </parameter>
1019 1020 1021
    <parameter default="1" name="COM_VEL_FS_EVH" type="FLOAT">
      <short_desc>Horizontal velocity error threshold</short_desc>
      <long_desc>This is the horizontal velocity error (EVH) threshold that will trigger a failsafe. The default is appropriate for a multicopter. Can be increased for a fixed-wing.</long_desc>
1022
      <unit>m/s</unit>
1023
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
1024 1025
  </group>
  <group name="Data Link Loss">
1026 1027 1028 1029 1030 1031 1032 1033
    <parameter default="600.0" name="NAV_AH_ALT" type="FLOAT">
      <short_desc>Airfield home alt</short_desc>
      <long_desc>Altitude of airfield home waypoint</long_desc>
      <min>-50</min>
      <unit>m</unit>
      <decimal>1</decimal>
      <increment>0.5</increment>
    </parameter>
1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047
    <parameter default="-265847810" name="NAV_AH_LAT" type="INT32">
      <short_desc>Airfield home Lat</short_desc>
      <long_desc>Latitude of airfield home waypoint</long_desc>
      <min>-900000000</min>
      <max>900000000</max>
      <unit>deg * 1e7</unit>
    </parameter>
    <parameter default="1518423250" name="NAV_AH_LON" type="INT32">
      <short_desc>Airfield home Lon</short_desc>
      <long_desc>Longitude of airfield home waypoint</long_desc>
      <min>-1800000000</min>
      <max>1800000000</max>
      <unit>deg * 1e7</unit>
    </parameter>
1048 1049 1050
    <parameter default="120.0" name="NAV_DLL_AH_T" type="FLOAT">
      <short_desc>Airfield home wait time</short_desc>
      <long_desc>The amount of time in seconds the system should wait at the airfield home waypoint</long_desc>
1051
      <min>0.0</min>
Lorenz Meier's avatar
Lorenz Meier committed
1052
      <max>3600.0</max>
Lorenz Meier's avatar
Lorenz Meier committed
1053
      <unit>s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1054 1055
      <decimal>0</decimal>
      <increment>1</increment>
1056
    </parameter>
1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070
    <parameter default="0" name="NAV_DLL_CHSK" type="INT32">
      <short_desc>Skip comms hold wp</short_desc>
      <long_desc>If set to 1 the system will skip the comms hold wp on data link loss and will directly fly to airfield home</long_desc>
      <boolean />
    </parameter>
    <parameter default="600.0" name="NAV_DLL_CH_ALT" type="FLOAT">
      <short_desc>Comms hold alt</short_desc>
      <long_desc>Altitude of comms hold waypoint</long_desc>
      <min>-50</min>
      <max>30000</max>
      <unit>m</unit>
      <decimal>1</decimal>
      <increment>0.5</increment>
    </parameter>
1071 1072 1073
    <parameter default="-266072120" name="NAV_DLL_CH_LAT" type="INT32">
      <short_desc>Comms hold Lat</short_desc>
      <long_desc>Latitude of comms hold waypoint</long_desc>
Don Gagne's avatar
Don Gagne committed
1074 1075
      <min>-900000000</min>
      <max>900000000</max>
Lorenz Meier's avatar
Lorenz Meier committed
1076
      <unit>deg * 1e7</unit>
1077 1078 1079 1080
    </parameter>
    <parameter default="1518453890" name="NAV_DLL_CH_LON" type="INT32">
      <short_desc>Comms hold Lon</short_desc>
      <long_desc>Longitude of comms hold waypoint</long_desc>
Don Gagne's avatar
Don Gagne committed
1081 1082
      <min>-1800000000</min>
      <max>1800000000</max>
Lorenz Meier's avatar
Lorenz Meier committed
1083
      <unit>deg * 1e7</unit>
1084
    </parameter>
1085 1086 1087
    <parameter default="120.0" name="NAV_DLL_CH_T" type="FLOAT">
      <short_desc>Comms hold wait time</short_desc>
      <long_desc>The amount of time in seconds the system should wait at the comms hold waypoint</long_desc>
1088
      <min>0.0</min>
Lorenz Meier's avatar
Lorenz Meier committed
1089
      <max>3600.0</max>
Lorenz Meier's avatar
Lorenz Meier committed
1090
      <unit>s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1091 1092
      <decimal>0</decimal>
      <increment>1</increment>
1093 1094 1095 1096 1097 1098 1099 1100
    </parameter>
    <parameter default="2" name="NAV_DLL_N" type="INT32">
      <short_desc>Number of allowed Datalink timeouts</short_desc>
      <long_desc>After more than this number of data link timeouts the aircraft returns home directly</long_desc>
      <min>0</min>
      <max>1000</max>
    </parameter>
  </group>
1101
  <group name="EKF2">
1102 1103 1104 1105 1106 1107
    <parameter default="0.2" name="EKF2_ABIAS_INIT" type="FLOAT">
      <short_desc>1-sigma IMU accelerometer switch-on bias</short_desc>
      <min>0.0</min>
      <max>0.5</max>
      <unit>m/s/s</unit>
      <decimal>2</decimal>
1108
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1109
    </parameter>
1110 1111 1112 1113 1114 1115 1116
    <parameter default="25.0" name="EKF2_ABL_ACCLIM" type="FLOAT">
      <short_desc>Maximum IMU accel magnitude that allows IMU bias learning.
If the magnitude of the IMU accelerometer vector exceeds this value, the EKF delta velocity state estimation will be inhibited.
This reduces the adverse effect of high manoeuvre accelerations and IMU nonlinerity and scale factor errors on the delta velocity bias estimates</short_desc>
      <min>20.0</min>
      <max>200.0</max>
      <unit>m/s/s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1117
      <decimal>1</decimal>
1118
    </parameter>
1119 1120 1121 1122 1123 1124 1125
    <parameter default="3.0" name="EKF2_ABL_GYRLIM" type="FLOAT">
      <short_desc>Maximum IMU gyro angular rate magnitude that allows IMU bias learning.
If the magnitude of the IMU angular rate vector exceeds this value, the EKF delta velocity state estimation will be inhibited.
This reduces the adverse effect of rapid rotation rates and associated errors on the delta velocity bias estimates</short_desc>
      <min>2.0</min>
      <max>20.0</max>
      <unit>rad/s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1126
      <decimal>1</decimal>
1127
    </parameter>
1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159
    <parameter default="0.4" name="EKF2_ABL_LIM" type="FLOAT">
      <short_desc>Accelerometer bias learning limit. The ekf delta velocity bias states will be limited to within a range equivalent to +- of this value</short_desc>
      <min>0.0</min>
      <max>0.8</max>
      <unit>m/s/s</unit>
      <decimal>2</decimal>
    </parameter>
    <parameter default="0.5" name="EKF2_ABL_TAU" type="FLOAT">
      <short_desc>Time constant used by acceleration and angular rate magnitude checks used to inhibit delta velocity bias learning.
The vector magnitude of angular rate and acceleration used to check if learning should be inhibited has a peak hold filter applied to it with an exponential decay.
This parameter controls the time constant of the decay</short_desc>
      <min>0.1</min>
      <max>1.0</max>
      <unit>s</unit>
      <decimal>2</decimal>
    </parameter>
    <parameter default="3.0e-3" name="EKF2_ACC_B_NOISE" type="FLOAT">
      <short_desc>Process noise for IMU accelerometer bias prediction</short_desc>
      <min>0.0</min>
      <max>0.01</max>
      <unit>m/s**3</unit>
      <decimal>6</decimal>
    </parameter>
    <parameter default="3.5e-1" name="EKF2_ACC_NOISE" type="FLOAT">
      <short_desc>Accelerometer noise for covariance prediction</short_desc>
      <min>0.01</min>
      <max>1.0</max>
      <unit>m/s/s</unit>
      <decimal>2</decimal>
    </parameter>
    <parameter default="1" name="EKF2_AID_MASK" type="INT32">
      <short_desc>Integer bitmask controlling data fusion and aiding methods</short_desc>
1160
      <long_desc>Set bits in the following positions to enable: 0 : Set to true to use GPS data if available 1 : Set to true to use optical flow data if available 2 : Set to true to inhibit IMU delta velocity bias estimation 3 : Set to true to enable vision position fusion 4 : Set to true to enable vision yaw fusion. Cannot be used if bit position 7 is true. 5 : Set to true to enable multi-rotor drag specific force fusion 6 : set to true if the EV observations are in a non NED reference frame and need to be rotated before being used 7 : Set to true to enable GPS yaw fusion. Cannot be used if bit position 4 is true.</long_desc>
1161
      <min>0</min>
1162
      <max>255</max>
1163
      <reboot_required>true</reboot_required>
1164 1165 1166 1167 1168 1169 1170
      <bitmask>
        <bit index="0">use GPS</bit>
        <bit index="1">use optical flow</bit>
        <bit index="2">inhibit IMU bias estimation</bit>
        <bit index="3">vision position fusion</bit>
        <bit index="4">vision yaw fusion</bit>
        <bit index="5">multi-rotor drag fusion</bit>
1171
        <bit index="6">rotate external vision</bit>
1172
        <bit index="7">GPS yaw fusion</bit>
1173
      </bitmask>
Lorenz Meier's avatar
Lorenz Meier committed
1174
    </parameter>
1175 1176 1177 1178 1179 1180
    <parameter default="0.1" name="EKF2_ANGERR_INIT" type="FLOAT">
      <short_desc>1-sigma tilt angle uncertainty after gravity vector alignment</short_desc>
      <min>0.0</min>
      <max>0.5</max>
      <unit>rad</unit>
      <decimal>3</decimal>
1181
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1182
    </parameter>
1183 1184
    <parameter default="0.0" name="EKF2_ARSP_THR" type="FLOAT">
      <short_desc>Airspeed fusion threshold. A value of zero will deactivate airspeed fusion. Any other positive
1185 1186 1187
value will determine the minimum airspeed which will still be fused. Set to about 90% of the vehicles stall speed.
Both airspeed fusion and sideslip fusion must be active for the EKF to continue navigating after loss of GPS.
Use EKF2_FUSE_BETA to activate sideslip fusion</short_desc>
1188 1189 1190 1191 1192 1193 1194 1195 1196
      <min>0.0</min>
      <unit>m/s</unit>
      <decimal>1</decimal>
    </parameter>
    <parameter default="20.0" name="EKF2_ASPD_MAX" type="FLOAT">
      <short_desc>Upper limit on airspeed along individual axes used to correct baro for position error effects</short_desc>
      <min>5.0</min>
      <max>50.0</max>
      <unit>m/s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1197
      <decimal>1</decimal>
1198
    </parameter>
1199
    <parameter default="100" name="EKF2_ASP_DELAY" type="FLOAT">
1200 1201 1202 1203
      <short_desc>Airspeed measurement delay relative to IMU measurements</short_desc>
      <min>0</min>
      <max>300</max>
      <unit>ms</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1204
      <decimal>1</decimal>
1205
      <reboot_required>true</reboot_required>
1206
    </parameter>
1207 1208 1209 1210 1211 1212 1213 1214
    <parameter default="5" name="EKF2_AVEL_DELAY" type="FLOAT">
      <short_desc>Auxillary Velocity Estimate (e.g from a landing target) delay relative to IMU measurements</short_desc>
      <min>0</min>
      <max>300</max>
      <unit>ms</unit>
      <decimal>1</decimal>
      <reboot_required>true</reboot_required>
    </parameter>
1215 1216
    <parameter default="0" name="EKF2_BARO_DELAY" type="FLOAT">
      <short_desc>Barometer measurement delay relative to IMU measurements</short_desc>
Lorenz Meier's avatar
Lorenz Meier committed
1217 1218 1219 1220
      <min>0</min>
      <max>300</max>
      <unit>ms</unit>
      <decimal>1</decimal>
1221
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1222
    </parameter>
1223 1224 1225 1226 1227
    <parameter default="5.0" name="EKF2_BARO_GATE" type="FLOAT">
      <short_desc>Gate size for barometric and GPS height fusion</short_desc>
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
      <min>1.0</min>
      <unit>SD</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1228
      <decimal>1</decimal>
1229
    </parameter>
1230 1231 1232 1233
    <parameter default="2.0" name="EKF2_BARO_NOISE" type="FLOAT">
      <short_desc>Measurement noise for barometric altitude</short_desc>
      <min>0.01</min>
      <max>15.0</max>
1234
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1235
      <decimal>2</decimal>
1236
    </parameter>
1237 1238 1239 1240 1241 1242 1243
    <parameter default="25.0" name="EKF2_BCOEF_X" type="FLOAT">
      <short_desc>X-axis ballistic coefficient used by the multi-rotor specific drag force model.
This should be adjusted to minimise variance of the X-axis drag specific force innovation sequence</short_desc>
      <min>1.0</min>
      <max>100.0</max>
      <unit>kg/m**2</unit>
      <decimal>1</decimal>
1244
    </parameter>
1245 1246 1247 1248 1249 1250
    <parameter default="25.0" name="EKF2_BCOEF_Y" type="FLOAT">
      <short_desc>Y-axis ballistic coefficient used by the multi-rotor specific drag force model.
This should be adjusted to minimise variance of the Y-axis drag specific force innovation sequence</short_desc>
      <min>1.0</min>
      <max>100.0</max>
      <unit>kg/m**2</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1251
      <decimal>1</decimal>
1252
    </parameter>
1253 1254 1255 1256 1257 1258 1259
    <parameter default="5.0" name="EKF2_BETA_GATE" type="FLOAT">
      <short_desc>Gate size for synthetic sideslip fusion</short_desc>
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
      <min>1.0</min>
      <unit>SD</unit>
      <decimal>1</decimal>
    </parameter>
1260 1261
    <parameter default="0.3" name="EKF2_BETA_NOISE" type="FLOAT">
      <short_desc>Noise for synthetic sideslip fusion</short_desc>
1262 1263 1264
      <min>0.1</min>
      <max>1.0</max>
      <unit>m/s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1265
      <decimal>2</decimal>
1266
    </parameter>
1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284
    <parameter default="7" name="EKF2_DECL_TYPE" type="INT32">
      <short_desc>Integer bitmask controlling handling of magnetic declination</short_desc>
      <long_desc>Set bits in the following positions to enable functions. 0 : Set to true to use the declination from the geo_lookup library when the GPS position becomes available, set to false to always use the EKF2_MAG_DECL value. 1 : Set to true to save the EKF2_MAG_DECL parameter to the value returned by the EKF when the vehicle disarms. 2 : Set to true to always use the declination as an observation when 3-axis magnetometer fusion is being used.</long_desc>
      <min>0</min>
      <max>7</max>
      <reboot_required>true</reboot_required>
      <bitmask>
        <bit index="0">use geo_lookup declination</bit>
        <bit index="1">save EKF2_MAG_DECL on disarm</bit>
        <bit index="2">use declination as an observation</bit>
      </bitmask>
    </parameter>
    <parameter default="2.5" name="EKF2_DRAG_NOISE" type="FLOAT">
      <short_desc>Specific drag force observation noise variance used by the multi-rotor specific drag force model.
Increasing it makes the multi-rotor wind estimates adjust more slowly</short_desc>
      <min>0.5</min>
      <max>10.0</max>
      <unit>(m/sec**2)**2</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1285
      <decimal>2</decimal>
1286
    </parameter>
1287 1288 1289 1290 1291 1292
    <parameter default="1.4" name="EKF2_EAS_NOISE" type="FLOAT">
      <short_desc>Measurement noise for airspeed fusion</short_desc>
      <min>0.5</min>
      <max>5.0</max>
      <unit>m/s</unit>
      <decimal>1</decimal>
1293
    </parameter>
1294 1295
    <parameter default="0.05" name="EKF2_EVA_NOISE" type="FLOAT">
      <short_desc>Measurement noise for vision angle observations used when the vision system does not supply error estimates</short_desc>
1296
      <min>0.01</min>
1297
      <unit>rad</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1298
      <decimal>2</decimal>
1299
    </parameter>
1300 1301 1302 1303 1304
    <parameter default="0.05" name="EKF2_EVP_NOISE" type="FLOAT">
      <short_desc>Measurement noise for vision position observations used when the vision system does not supply error estimates</short_desc>
      <min>0.01</min>
      <unit>m</unit>
      <decimal>2</decimal>
1305
    </parameter>
1306 1307 1308 1309 1310 1311 1312
    <parameter default="175" name="EKF2_EV_DELAY" type="FLOAT">
      <short_desc>Vision Position Estimator delay relative to IMU measurements</short_desc>
      <min>0</min>
      <max>300</max>
      <unit>ms</unit>
      <decimal>1</decimal>
      <reboot_required>true</reboot_required>
1313
    </parameter>
1314 1315 1316 1317 1318 1319
    <parameter default="5.0" name="EKF2_EV_GATE" type="FLOAT">
      <short_desc>Gate size for vision estimate fusion</short_desc>
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
      <min>1.0</min>
      <unit>SD</unit>
      <decimal>1</decimal>
1320
    </parameter>
1321 1322
    <parameter default="0.0" name="EKF2_EV_POS_X" type="FLOAT">
      <short_desc>X position of VI sensor focal point in body frame</short_desc>
1323
      <unit>m</unit>
1324
      <decimal>3</decimal>
1325
    </parameter>
1326 1327
    <parameter default="0.0" name="EKF2_EV_POS_Y" type="FLOAT">
      <short_desc>Y position of VI sensor focal point in body frame</short_desc>
1328
      <unit>m</unit>
1329
      <decimal>3</decimal>
1330
    </parameter>
1331 1332
    <parameter default="0.0" name="EKF2_EV_POS_Z" type="FLOAT">
      <short_desc>Z position of VI sensor focal point in body frame</short_desc>
1333
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1334
      <decimal>3</decimal>
1335
    </parameter>
1336 1337
    <parameter default="0" name="EKF2_FUSE_BETA" type="INT32">
      <short_desc>Boolean determining if synthetic sideslip measurements should fused</short_desc>
1338
      <long_desc>A value of 1 indicates that fusion is active Both  sideslip fusion and airspeed fusion must be active for the EKF to continue navigating after loss of GPS. Use EKF2_ARSP_THR to activate airspeed fusion.</long_desc>
1339
      <boolean />
Lorenz Meier's avatar
Lorenz Meier committed
1340
    </parameter>
1341 1342 1343 1344 1345
    <parameter default="0.1" name="EKF2_GBIAS_INIT" type="FLOAT">
      <short_desc>1-sigma IMU gyro switch-on bias</short_desc>
      <min>0.0</min>
      <max>0.2</max>
      <unit>rad/sec</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1346
      <decimal>2</decimal>
1347
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1348
    </parameter>
1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364
    <parameter default="0.0" name="EKF2_GND_EFF_DZ" type="FLOAT">
      <short_desc>Baro deadzone range for height fusion</short_desc>
      <long_desc>Sets the value of deadzone applied to negative baro innovations. Deadzone is enabled when EKF2_GND_EFF_DZ &gt; 0.</long_desc>
      <min>0.0</min>
      <max>10.0</max>
      <unit>M</unit>
      <decimal>1</decimal>
    </parameter>
    <parameter default="0.5" name="EKF2_GND_MAX_HGT" type="FLOAT">
      <short_desc>Height above ground level for ground effect zone</short_desc>
      <long_desc>Sets the maximum distance to the ground level where negative baro innovations are expected.</long_desc>
      <min>0.0</min>
      <max>5.0</max>
      <unit>M</unit>
      <decimal>1</decimal>
    </parameter>
1365
    <parameter default="245" name="EKF2_GPS_CHECK" type="INT32">
1366
      <short_desc>Integer bitmask controlling GPS checks</short_desc>
1367
      <long_desc>Set bits to 1 to enable checks. Checks enabled by the following bit positions 0 : Minimum required sat count set by EKF2_REQ_NSATS 1 : Minimum required GDoP set by EKF2_REQ_GDOP 2 : Maximum allowed horizontal position error set by EKF2_REQ_EPH 3 : Maximum allowed vertical position error set by EKF2_REQ_EPV 4 : Maximum allowed speed error set by EKF2_REQ_SACC 5 : Maximum allowed horizontal position rate set by EKF2_REQ_HDRIFT. This check will only run when the vehicle is on ground and stationary. Detecton of the stationary condition is controlled by the EKF2_MOVE_TEST parameter. 6 : Maximum allowed vertical position rate set by EKF2_REQ_VDRIFT. This check will only run when the vehicle is on ground and stationary. Detecton of the stationary condition is controlled by the EKF2_MOVE_TEST parameter. 7 : Maximum allowed horizontal speed set by EKF2_REQ_HDRIFT. This check will only run when the vehicle is on ground and stationary. Detecton of the stationary condition is controlled by the EKF2_MOVE_TEST parameter. 8 : Maximum allowed vertical velocity discrepancy set by EKF2_REQ_VDRIFT</long_desc>
1368
      <min>0</min>
1369
      <max>511</max>
1370
      <bitmask>
1371 1372 1373 1374 1375 1376 1377 1378 1379
        <bit index="0">Min sat count (EKF2_REQ_NSATS)</bit>
        <bit index="1">Min GDoP (EKF2_REQ_GDOP)</bit>
        <bit index="2">Max horizontal position error (EKF2_REQ_EPH)</bit>
        <bit index="3">Max vertical position error (EKF2_REQ_EPV)</bit>
        <bit index="4">Max speed error (EKF2_REQ_SACC)</bit>
        <bit index="5">Max horizontal position rate (EKF2_REQ_HDRIFT)</bit>
        <bit index="6">Max vertical position rate (EKF2_REQ_VDRIFT)</bit>
        <bit index="7">Max horizontal speed (EKF2_REQ_HDRIFT)</bit>
        <bit index="8">Max vertical velocity discrepancy (EKF2_REQ_VDRIFT)</bit>
1380
      </bitmask>
1381
    </parameter>
1382 1383 1384 1385 1386 1387
    <parameter default="110" name="EKF2_GPS_DELAY" type="FLOAT">
      <short_desc>GPS measurement delay relative to IMU measurements</short_desc>
      <min>0</min>
      <max>300</max>
      <unit>ms</unit>
      <decimal>1</decimal>
1388
      <reboot_required>true</reboot_required>
1389
    </parameter>
1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400
    <parameter default="0" name="EKF2_GPS_MASK" type="INT32">
      <short_desc>Multi GPS Blending Control Mask</short_desc>
      <long_desc>Set bits in the following positions to set which GPS accuracy metrics will be used to calculate the blending weight. Set to zero to disable and always used first GPS instance. 0 : Set to true to use speed accuracy 1 : Set to true to use horizontal position accuracy 2 : Set to true to use vertical position accuracy</long_desc>
      <min>0</min>
      <max>7</max>
      <bitmask>
        <bit index="0">use speed accuracy</bit>
        <bit index="1">use hpos accuracy</bit>
        <bit index="2">use vpos accuracy</bit>
      </bitmask>
    </parameter>
1401 1402 1403 1404
    <parameter default="0.0" name="EKF2_GPS_POS_X" type="FLOAT">
      <short_desc>X position of GPS antenna in body frame</short_desc>
      <unit>m</unit>
      <decimal>3</decimal>
1405
    </parameter>
1406 1407 1408 1409
    <parameter default="0.0" name="EKF2_GPS_POS_Y" type="FLOAT">
      <short_desc>Y position of GPS antenna in body frame</short_desc>
      <unit>m</unit>
      <decimal>3</decimal>
1410
    </parameter>
1411 1412 1413 1414
    <parameter default="0.0" name="EKF2_GPS_POS_Z" type="FLOAT">
      <short_desc>Z position of GPS antenna in body frame</short_desc>
      <unit>m</unit>
      <decimal>3</decimal>