PX4ParameterFactMetaData.xml 465 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 481 482 483 484 485
      <short_desc>Circuit breaker for flight termination</short_desc>
      <long_desc>Setting this parameter to 121212 will disable the flight termination action. --&gt; The IO driver will not do flight termination if requested by the FMU WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
      <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
    <parameter default="-1.0" name="COM_DISARM_LAND" type="FLOAT">
634
      <short_desc>Time-out for auto disarm after landing</short_desc>
635 636
      <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
637
      <max>20</max>
Lorenz Meier's avatar
Lorenz Meier committed
638
      <unit>s</unit>
639
      <decimal>2</decimal>
640
    </parameter>
641 642 643 644 645 646 647 648
    <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
649
    </parameter>
650 651 652
    <parameter default="0" name="COM_DL_REG_T" type="INT32">
      <short_desc>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>
Lorenz Meier's avatar
Lorenz Meier committed
653
      <min>0</min>
654 655 656 657
      <max>3</max>
      <unit>s</unit>
      <decimal>1</decimal>
      <increment>0.5</increment>
Lorenz Meier's avatar
Lorenz Meier committed
658
    </parameter>
659 660 661 662 663 664 665
    <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
666 667
      <increment>1</increment>
    </parameter>
668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683
    <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
684 685
      <increment>1</increment>
    </parameter>
686
    <parameter category="System" default="0" name="COM_FLIGHT_UUID" type="INT32" volatile="true">
687 688 689 690
      <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>
691 692 693 694
    <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>
695
        <value code="-1">Unassigned</value>
696
        <value code="0">Manual</value>
697
        <value code="1">Altitude</value>
698
        <value code="2">Position</value>
699
        <value code="3">Mission</value>
700 701
        <value code="4">Hold</value>
        <value code="5">Return</value>
702 703
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
704
        <value code="8">Stabilized</value>
705 706 707 708
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
709 710 711 712 713 714
      </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>
715
        <value code="-1">Unassigned</value>
716
        <value code="0">Manual</value>
717
        <value code="1">Altitude</value>
718
        <value code="2">Position</value>
719
        <value code="3">Mission</value>
720 721
        <value code="4">Hold</value>
        <value code="5">Return</value>
722 723
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
724
        <value code="8">Stabilized</value>
725 726 727 728
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
729 730 731 732 733 734
      </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>
735
        <value code="-1">Unassigned</value>
736
        <value code="0">Manual</value>
737
        <value code="1">Altitude</value>
738
        <value code="2">Position</value>
739
        <value code="3">Mission</value>
740 741
        <value code="4">Hold</value>
        <value code="5">Return</value>
742 743
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
744
        <value code="8">Stabilized</value>
745 746 747 748
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
749 750 751 752 753 754
      </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>
755
        <value code="-1">Unassigned</value>
756
        <value code="0">Manual</value>
757
        <value code="1">Altitude</value>
758
        <value code="2">Position</value>
759
        <value code="3">Mission</value>
760 761
        <value code="4">Hold</value>
        <value code="5">Return</value>
762 763
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
764
        <value code="8">Stabilized</value>
765 766 767 768
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
769 770 771 772 773 774
      </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>
775
        <value code="-1">Unassigned</value>
776
        <value code="0">Manual</value>
777
        <value code="1">Altitude</value>
778
        <value code="2">Position</value>
779
        <value code="3">Mission</value>
780 781
        <value code="4">Hold</value>
        <value code="5">Return</value>
782 783
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
784
        <value code="8">Stabilized</value>
785 786 787 788
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
789 790 791 792 793 794
      </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>
795
        <value code="-1">Unassigned</value>
796
        <value code="0">Manual</value>
797
        <value code="1">Altitude</value>
798
        <value code="2">Position</value>
799
        <value code="3">Mission</value>
800 801
        <value code="4">Hold</value>
        <value code="5">Return</value>
802 803
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
804
        <value code="8">Stabilized</value>
805 806 807 808
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
809 810
      </values>
    </parameter>
811 812 813 814 815 816 817 818 819 820 821 822 823 824
    <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>
825 826 827 828 829
    <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
830 831
      <unit>m</unit>
      <decimal>2</decimal>
832
      <increment>0.5</increment>
833
    </parameter>
834 835 836 837 838
    <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>
839
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
840
      <decimal>2</decimal>
841
      <increment>0.5</increment>
842
    </parameter>
843 844 845 846 847 848 849
    <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>
850 851 852
        <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>
853
      </values>
854
    </parameter>
855 856 857 858 859
    <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>
860
      <unit>s</unit>
861
      <increment>1</increment>
862 863 864 865
    </parameter>
    <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>
866 867
      <min>1</min>
      <max>100</max>
868 869 870
      <unit>sec</unit>
      <reboot_required>true</reboot_required>
    </parameter>
871 872
    <parameter default="5" name="COM_POS_FS_EPH" type="FLOAT">
      <short_desc>Horizontal position error threshold</short_desc>
873
      <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>
874 875 876 877 878 879 880
      <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>
881 882 883 884 885
    <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>
886 887 888
    <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>
889 890
      <min>1</min>
      <max>100</max>
891 892 893
      <unit>sec</unit>
      <reboot_required>true</reboot_required>
    </parameter>
894 895 896 897 898
    <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>
899
    </parameter>
900 901 902 903 904 905 906 907 908 909 910 911 912 913
    <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>
914
      <min>0</min>
915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931
      <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>
932
    </parameter>
933 934 935
    <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>
936
      <unit>m/s</unit>
937
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
938 939
  </group>
  <group name="Data Link Loss">
940 941 942 943 944 945 946 947
    <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>
948 949 950 951 952 953 954 955 956 957 958 959 960 961
    <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>
962 963 964
    <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>
965
      <min>0.0</min>
Lorenz Meier's avatar
Lorenz Meier committed
966
      <max>3600.0</max>
Lorenz Meier's avatar
Lorenz Meier committed
967
      <unit>s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
968 969
      <decimal>0</decimal>
      <increment>1</increment>
970
    </parameter>
971 972 973 974 975 976 977 978 979 980 981 982 983 984
    <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>
985 986 987
    <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
988 989
      <min>-900000000</min>
      <max>900000000</max>
Lorenz Meier's avatar
Lorenz Meier committed
990
      <unit>deg * 1e7</unit>
991 992 993 994
    </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
995 996
      <min>-1800000000</min>
      <max>1800000000</max>
Lorenz Meier's avatar
Lorenz Meier committed
997
      <unit>deg * 1e7</unit>
998
    </parameter>
999 1000 1001
    <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>
1002
      <min>0.0</min>
Lorenz Meier's avatar
Lorenz Meier committed
1003
      <max>3600.0</max>
Lorenz Meier's avatar
Lorenz Meier committed
1004
      <unit>s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1005 1006
      <decimal>0</decimal>
      <increment>1</increment>
1007 1008 1009 1010 1011 1012 1013 1014
    </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>
1015
  <group name="EKF2">
1016 1017 1018 1019 1020 1021
    <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>
1022
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1023
    </parameter>
1024 1025 1026 1027 1028 1029 1030
    <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
1031
      <decimal>1</decimal>
1032
    </parameter>
1033 1034 1035 1036 1037 1038 1039
    <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
1040
      <decimal>1</decimal>
1041
    </parameter>
1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073
    <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>
1074
      <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 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>
1075
      <min>0</min>
1076
      <max>255</max>
1077
      <reboot_required>true</reboot_required>
1078 1079 1080 1081 1082 1083 1084
      <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>
1085
        <bit index="6">rotate external vision</bit>
1086
        <bit index="7">GPS yaw fusion</bit>
1087
      </bitmask>
Lorenz Meier's avatar
Lorenz Meier committed
1088
    </parameter>
1089 1090 1091 1092 1093 1094
    <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>
1095
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1096
    </parameter>
1097 1098
    <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
1099 1100 1101
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>
1102 1103 1104 1105 1106 1107 1108 1109 1110
      <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
1111
      <decimal>1</decimal>
1112
    </parameter>
1113
    <parameter default="100" name="EKF2_ASP_DELAY" type="FLOAT">
1114 1115 1116 1117
      <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
1118
      <decimal>1</decimal>
1119
      <reboot_required>true</reboot_required>
1120
    </parameter>
1121 1122 1123 1124 1125 1126 1127 1128
    <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>
1129 1130
    <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
1131 1132 1133 1134
      <min>0</min>
      <max>300</max>
      <unit>ms</unit>
      <decimal>1</decimal>
1135
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1136
    </parameter>
1137 1138 1139 1140 1141
    <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
1142
      <decimal>1</decimal>
1143
    </parameter>
1144 1145 1146 1147
    <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>
1148
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1149
      <decimal>2</decimal>
1150
    </parameter>
1151 1152 1153 1154 1155 1156 1157
    <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>
1158
    </parameter>
1159 1160 1161 1162 1163 1164
    <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
1165
      <decimal>1</decimal>
1166
    </parameter>
1167 1168 1169 1170 1171 1172 1173
    <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>
1174 1175
    <parameter default="0.3" name="EKF2_BETA_NOISE" type="FLOAT">
      <short_desc>Noise for synthetic sideslip fusion</short_desc>
1176 1177 1178
      <min>0.1</min>
      <max>1.0</max>
      <unit>m/s</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1179
      <decimal>2</decimal>
1180
    </parameter>
1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198
    <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
1199
      <decimal>2</decimal>
1200
    </parameter>
1201 1202 1203 1204 1205 1206
    <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>
1207
    </parameter>
1208 1209
    <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>
1210
      <min>0.01</min>
1211
      <unit>rad</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1212
      <decimal>2</decimal>
1213
    </parameter>
1214 1215 1216 1217 1218
    <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>
1219
    </parameter>
1220 1221 1222 1223 1224 1225 1226
    <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>
1227
    </parameter>
1228 1229 1230 1231 1232 1233
    <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>
1234
    </parameter>
1235 1236
    <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>
1237
      <unit>m</unit>
1238
      <decimal>3</decimal>
1239
    </parameter>
1240 1241
    <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>
1242
      <unit>m</unit>
1243
      <decimal>3</decimal>
1244
    </parameter>
1245 1246
    <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>
1247
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1248
      <decimal>3</decimal>
1249
    </parameter>
1250 1251
    <parameter default="0" name="EKF2_FUSE_BETA" type="INT32">
      <short_desc>Boolean determining if synthetic sideslip measurements should fused</short_desc>
1252
      <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>
1253
      <boolean />
Lorenz Meier's avatar
Lorenz Meier committed
1254
    </parameter>
1255 1256 1257 1258 1259
    <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
1260
      <decimal>2</decimal>
1261
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
1262
    </parameter>
1263
    <parameter default="245" name="EKF2_GPS_CHECK" type="INT32">
1264
      <short_desc>Integer bitmask controlling GPS checks</short_desc>
1265
      <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>
1266
      <min>0</min>
1267
      <max>511</max>
1268
      <bitmask>
1269 1270 1271 1272 1273 1274 1275 1276 1277
        <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>
1278
      </bitmask>
1279
    </parameter>
1280 1281 1282 1283 1284 1285
    <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>
1286
      <reboot_required>true</reboot_required>
1287
    </parameter>
1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298
    <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>
1299 1300 1301 1302
    <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>
1303
    </parameter>
1304 1305 1306 1307
    <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>
1308
    </parameter>
1309 1310 1311 1312
    <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>
1313
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
1314
    <parameter default="5.0" name="EKF2_GPS_P_GATE" type="FLOAT">
1315
      <short_desc>Gate size for GPS horizontal position fusion</short_desc>
1316
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
1317 1318
      <min>1.0</min>
      <unit>SD</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1319
      <decimal>1</decimal>
1320
    </parameter>
1321 1322 1323 1324 1325 1326 1327
    <parameter default="0.5" name="EKF2_GPS_P_NOISE" type="FLOAT">
      <short_desc>Measurement noise for gps position</short_desc>
      <min>0.01</min>
      <max>10.0</max>
      <unit>m</unit>
      <decimal>2</decimal>
    </parameter>
1328 1329 1330 1331 1332 1333 1334 1335
    <parameter default="10.0" name="EKF2_GPS_TAU" type="FLOAT">
      <short_desc>Multi GPS Blending Time Constant</short_desc>
      <long_desc>Sets the longest time constant that will be applied to the calculation of GPS position and height offsets used to correct data from multiple GPS data for steady state position differences.</long_desc>
      <min>1.0</min>
      <max>100.0</max>
      <unit>s</unit>
      <decimal>1</decimal>
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
1336
    <parameter default="5.0" name="EKF2_GPS_V_GATE" type="FLOAT">
1337
      <short_desc>Gate size for GPS velocity fusion</short_desc>
1338
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
1339 1340
      <min>1.0</min>
      <unit>SD</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1341
      <decimal>1</decimal>
1342
    </parameter>
1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365
    <parameter default="0.5" name="EKF2_GPS_V_NOISE" type="FLOAT">
      <short_desc>Measurement noise for gps horizontal velocity</short_desc>
      <min>0.01</min>
      <max>5.0</max>
      <unit>m/s</unit>
      <decimal>2</decimal>
    </parameter>
    <parameter default="1.0e-3" name="EKF2_GYR_B_NOISE" type="FLOAT">
      <short_desc>Process noise for IMU rate gyro bias prediction</short_desc>
      <min>0.0</min>
      <max>0.01</max>
      <unit>rad/s**2</unit>
      <decimal>6</decimal>
    </parameter>
    <parameter default="1.5e-2" name="EKF2_GYR_NOISE" type="FLOAT">
      <short_desc>Rate gyro noise for covariance prediction</short_desc>
      <min>0.0001</min>
      <max>0.1</max>
      <unit>rad/s</unit>
      <decimal>4</decimal>
    </parameter>
    <parameter default="2.6" name="EKF2_HDG_GATE" type="FLOAT">
      <short_desc>Gate size for magnetic heading fusion</short_desc>
1366
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
1367 1368 1369 1370
      <min>1.0</min>
      <unit>SD</unit>
      <decimal>1</decimal>
    </parameter>
1371 1372 1373 1374 1375 1376
    <parameter default="0.3" name="EKF2_HEAD_NOISE" type="FLOAT">
      <short_desc>Measurement noise for magnetic heading fusion</short_desc>
      <min>0.01</min>
      <max>1.0</max>
      <unit>rad</unit>
      <decimal>2</decimal>
Lorenz Meier's avatar
Lorenz Meier committed
1377 1378 1379 1380
    </parameter>
    <parameter default="0" name="EKF2_HGT_MODE"