PX4ParameterFactMetaData.xml 547 KB
Newer Older
1
<parameters>
2
  <version>3</version>
3
  <parameter_version_major>1</parameter_version_major>
4
  <parameter_version_minor>15</parameter_version_minor>
Don Gagne's avatar
Don Gagne committed
5
  <group name="UAVCAN Motor Parameters" no_code_generation="true">
6 7 8 9 10
    <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>
      <min>10</min>
      <max>250</max>
11
      <unit>Hz</unit>
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
    </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>
      <min>0.00</min>
      <max>1.00</max>
30
      <unit>C/rad</unit>
31
      <decimal>3</decimal>
32 33 34 35 36 37
    </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>
      <min>0.0</min>
      <max>100.0</max>
38
      <unit>Hz</unit>
39
      <decimal>3</decimal>
40 41 42 43 44 45
    </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>
      <min>5</min>
      <max>1000</max>
46
      <unit>1/s^2</unit>
47 48 49 50 51 52 53 54 55 56 57
    </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>
      <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>
58
      <max>1000000</max>
59 60 61 62 63 64
    </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>
      <min>0</min>
      <max>1000000</max>
65
      <unit>us</unit>
66 67 68 69 70
    </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>
      <max>1000000</max>
71
      <unit>us</unit>
72 73 74 75 76 77 78 79 80 81 82
    </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>
      <min>1</min>
      <max>80</max>
83
      <unit>A</unit>
84
      <decimal>3</decimal>
85 86 87 88 89 90 91
    </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>
      <min>0</min>
Don Gagne's avatar
Don Gagne committed
92
      <max>4000</max>
93
      <unit>rpm/V</unit>
94 95 96 97
    </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>
98
      <unit>H</unit>
99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
      <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>
      <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>
114
      <unit>Ohm</unit>
115 116
      <decimal>3</decimal>
    </parameter>
Don Gagne's avatar
Don Gagne committed
117
    <parameter default="0.5" name="mot_v_accel" type="FLOAT">
118 119 120 121
      <short_desc>Acceleration limit (V)</short_desc>
      <long_desc>Acceleration limit (V)</long_desc>
      <min>0.01</min>
      <max>1.00</max>
122
      <unit>V</unit>
123
      <decimal>3</decimal>
124 125 126 127 128 129 130 131
    </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>
132
      <min>0</min>
133
      <unit>V</unit>
134 135 136
      <decimal>3</decimal>
    </parameter>
  </group>
137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164
  <group name="UAVCAN GNSS" no_code_generation="true">
    <parameter default="2" name="gnss.dyn_model" type="INT32">
      <short_desc>GNSS dynamic model</short_desc>
      <long_desc>Dynamic model used in the GNSS positioning engine. 0 –
        Automotive, 1 – Sea, 2 – Airborne.
      </long_desc>
      <min>0</min>
      <max>2</max>
      <values>
        <value code="0">Automotive</value>
        <value code="1">Sea</value>
        <value code="2">Airborne</value>
      </values>
    </parameter>
    <parameter default="1" name="gnss.old_fix_msg" type="INT32">
      <short_desc>Broadcast old GNSS fix message</short_desc>
      <long_desc>Broadcast the old (deprecated) GNSS fix message
        uavcan.equipment.gnss.Fix alongside the new alternative
        uavcan.equipment.gnss.Fix2. It is recommended to
        disable this feature to reduce the CAN bus traffic.
      </long_desc>
      <min>0</min>
      <max>1</max>
      <values>
        <value code="0">Fix2</value>
        <value code="1">Fix and Fix2</value>
      </values>
    </parameter>
165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187
    <parameter default="0" name="gnss.warn_dimens" type="INT32">
      <short_desc>device health warning</short_desc>
      <long_desc>Set the device health to Warning if the dimensionality of
              the GNSS solution is less than this value. 3 for the full (3D)
              solution, 2 for planar (2D) solution, 1 for time-only solution,
              0 disables the feature.
      </long_desc>
      <min>0</min>
      <max>3</max>
      <values>
        <value code="0">disables the feature</value>
        <value code="1">time-only solution</value>
        <value code="2">planar (2D) solution</value>
        <value code="3">full (3D) solution</value>
      </values>
    </parameter>
    <parameter default="0" name="gnss.warn_sats" type="INT32">
      <short_desc />
      <long_desc>Set the device health to Warning if the number of satellites
        used in the GNSS solution is below this threshold. Zero
        disables the feature
      </long_desc>
    </parameter>
188 189 190 191 192 193 194 195
    <parameter default="0" name="uavcan.pubp-pres" type="INT32">
      <short_desc />
      <long_desc>Set the device health to Warning if the number of satellites
        used in the GNSS solution is below this threshold. Zero
        disables the feature
      </long_desc>
      <min>0</min>
      <max>1000000</max>
196
      <unit>us</unit>
197 198
    </parameter>
  </group>
199
  <group name="Airspeed Validator">
200 201
    <parameter default="1" name="ASPD_BETA_GATE" type="INT32">
      <short_desc>Airspeed Selector: Gate size for sideslip angle fusion</short_desc>
202 203 204 205 206
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
      <min>1</min>
      <max>5</max>
      <unit>SD</unit>
    </parameter>
207
    <parameter default="0.3" name="ASPD_BETA_NOISE" type="FLOAT">
208 209 210 211 212 213
      <short_desc>Airspeed Selector: Wind estimator sideslip measurement noise</short_desc>
      <long_desc>Sideslip measurement noise of the internal wind estimator(s) of the airspeed selector.</long_desc>
      <min>0</min>
      <max>1</max>
      <unit>rad</unit>
    </parameter>
214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271
    <parameter default="0" name="ASPD_DO_CHECKS" type="INT32">
      <short_desc>Enable checks on airspeed sensors</short_desc>
      <long_desc>If set to true then the data comming from the airspeed sensors is checked for validity. Only applied if ASPD_PRIMARY &gt; 0.</long_desc>
      <reboot_required>true</reboot_required>
    </parameter>
    <parameter default="0" name="ASPD_FALLBACK" type="INT32">
      <short_desc>Enable fallback to secondary airspeed measurement</short_desc>
      <long_desc>If ASPD_DO_CHECKS is set to true, then airspeed estimation can fallback from what specified in ASPD_PRIMARY to secondary source (other airspeed sensors, groundspeed minus windspeed).</long_desc>
      <reboot_required>true</reboot_required>
      <values>
        <value code="0">To other airspeed sensor (if one valid), else disable airspeed</value>
        <value code="1">To other airspeed sensor (if one valid), else to ground-windspeed</value>
      </values>
    </parameter>
    <parameter default="1.0" name="ASPD_FS_INNOV" type="FLOAT">
      <short_desc>Airspeed failsafe consistency threshold (Experimental)</short_desc>
      <long_desc>This specifies the minimum airspeed 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 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 ASPD_FS_INTEG parameter.</long_desc>
      <min>0.5</min>
      <max>3.0</max>
    </parameter>
    <parameter default="-1.0" name="ASPD_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 ASPD_FS_INNOV required to trigger a failsafe. For example if ASPD_FS_INNOV is 1 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.</long_desc>
      <max>30.0</max>
      <unit>s</unit>
    </parameter>
    <parameter default="3" name="ASPD_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.</long_desc>
      <min>1</min>
      <max>10</max>
      <unit>s</unit>
    </parameter>
    <parameter default="100" name="ASPD_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.</long_desc>
      <min>10</min>
      <max>1000</max>
      <unit>s</unit>
    </parameter>
    <parameter default="1" name="ASPD_PRIMARY" type="INT32">
      <short_desc>Index or primary airspeed measurement source</short_desc>
      <reboot_required>true</reboot_required>
      <values>
        <value code="-1">Disabled</value>
        <value code="0">Groundspeed minus windspeed</value>
        <value code="1">First airspeed sensor</value>
        <value code="2">Second airspeed sensor</value>
        <value code="3">Third airspeed sensor</value>
      </values>
    </parameter>
    <parameter default="1.0" name="ASPD_SCALE" type="FLOAT">
      <short_desc>Airspeed scale (scale from IAS to CAS/EAS)</short_desc>
      <long_desc>Scale can either be entered manually, or estimated in-flight by setting ASPD_SCALE_EST to 1.</long_desc>
      <min>0.5</min>
      <max>1.5</max>
    </parameter>
    <parameter default="0" name="ASPD_SCALE_EST" type="INT32">
272
      <short_desc>Automatic airspeed scale estimation on</short_desc>
273
      <long_desc>Turns the automatic airspeed scale (scale from IAS to CAS/EAS) on or off. It is recommended to fly level altitude while performing the estimation. Set to 1 to start estimation (best when already flying). Set to 0 to end scale estimation. The estimated scale is then saved using the ASPD_SCALE parameter.</long_desc>
274
    </parameter>
275
    <parameter default="0.0001" name="ASPD_SC_P_NOISE" type="FLOAT">
276 277 278 279
      <short_desc>Airspeed Selector: Wind estimator true airspeed scale process noise</short_desc>
      <long_desc>Airspeed scale process noise of the internal wind estimator(s) of the airspeed selector.</long_desc>
      <min>0</min>
      <max>0.1</max>
280
      <unit>Hz</unit>
281
    </parameter>
282 283 284 285 286 287
    <parameter default="10.0" name="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.</long_desc>
      <unit>m/s</unit>
    </parameter>
    <parameter default="3" name="ASPD_TAS_GATE" type="INT32">
288 289 290 291 292 293
      <short_desc>Airspeed Selector: Gate size for true airspeed fusion</short_desc>
      <long_desc>Sets the number of standard deviations used by the innovation consistency test.</long_desc>
      <min>1</min>
      <max>5</max>
      <unit>SD</unit>
    </parameter>
294
    <parameter default="1.4" name="ASPD_TAS_NOISE" type="FLOAT">
295 296 297 298 299 300
      <short_desc>Airspeed Selector: Wind estimator true airspeed measurement noise</short_desc>
      <long_desc>True airspeed measurement noise of the internal wind estimator(s) of the airspeed selector.</long_desc>
      <min>0</min>
      <max>4</max>
      <unit>m/s</unit>
    </parameter>
301
    <parameter default="0.1" name="ASPD_W_P_NOISE" type="FLOAT">
302 303 304 305
      <short_desc>Airspeed Selector: Wind estimator wind process noise</short_desc>
      <long_desc>Wind process noise of the internal wind estimator(s) of the airspeed selector.</long_desc>
      <min>0</min>
      <max>1</max>
306
      <unit>m/s^2</unit>
307 308
    </parameter>
  </group>
309
  <group name="Attitude Q estimator">
310 311 312
    <parameter default="1" name="ATT_ACC_COMP" type="INT32">
      <short_desc>Acceleration compensation based on GPS
velocity</short_desc>
313
    </parameter>
314 315
    <parameter default="0.05" name="ATT_BIAS_MAX" type="FLOAT">
      <short_desc>Gyro bias limit</short_desc>
316
      <min>0</min>
317 318 319
      <max>2</max>
      <unit>rad/s</unit>
      <decimal>3</decimal>
320
    </parameter>
321 322 323 324
    <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>
325
      <min>0</min>
326 327 328 329 330 331
      <max>2</max>
      <values>
        <value code="0">None</value>
        <value code="1">Vision</value>
        <value code="2">Motion Capture</value>
      </values>
332 333 334
    </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
335
      <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
336
      <unit>deg</unit>
337
      <decimal>2</decimal>
338 339
    </parameter>
    <parameter default="1" name="ATT_MAG_DECL_A" type="INT32">
Lorenz Meier's avatar
Lorenz Meier committed
340
      <short_desc>Automatic GPS based declination compensation</short_desc>
341
    </parameter>
342 343
    <parameter default="0.2" name="ATT_W_ACC" type="FLOAT">
      <short_desc>Complimentary filter accelerometer weight</short_desc>
344
      <min>0</min>
345 346
      <max>1</max>
      <decimal>2</decimal>
347
    </parameter>
348 349 350 351
    <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>
352
    </parameter>
353 354
    <parameter default="0.1" name="ATT_W_GYRO_BIAS" type="FLOAT">
      <short_desc>Complimentary filter gyroscope bias weight</short_desc>
355
      <min>0</min>
356 357 358 359 360
      <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>
361
      <long_desc>Set to 0 to avoid using the magnetometer.</long_desc>
362 363 364
      <min>0</min>
      <max>1</max>
      <decimal>2</decimal>
365 366 367
    </parameter>
  </group>
  <group name="Battery Calibration">
368 369
    <parameter default="-1.0" name="BAT1_A_PER_V" type="FLOAT">
      <short_desc>Battery 1 current per volt (A/V)</short_desc>
370
      <long_desc>The voltage seen by the ADC multiplied by this factor will determine the battery current. A value of -1 means to use the board default.</long_desc>
371 372 373 374 375 376 377 378 379 380 381 382 383
      <decimal>8</decimal>
      <reboot_required>True</reboot_required>
    </parameter>
    <parameter default="-1.0" name="BAT1_CAPACITY" type="FLOAT">
      <short_desc>Battery 1 capacity</short_desc>
      <long_desc>Defines the capacity of battery 1 in mAh.</long_desc>
      <min>-1.0</min>
      <max>100000</max>
      <unit>mAh</unit>
      <decimal>0</decimal>
      <increment>50</increment>
      <reboot_required>True</reboot_required>
    </parameter>
384 385 386 387 388
    <parameter default="-1" name="BAT1_I_CHANNEL" type="INT32">
      <short_desc>Battery 1 Current ADC Channel</short_desc>
      <long_desc>This parameter specifies the ADC channel used to monitor current of main power battery. A value of -1 means to use the board default.</long_desc>
      <reboot_required>True</reboot_required>
    </parameter>
389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422
    <parameter default="0" name="BAT1_N_CELLS" type="INT32">
      <short_desc>Number of cells for battery 1</short_desc>
      <long_desc>Defines the number of cells the attached battery consists of.</long_desc>
      <reboot_required>True</reboot_required>
      <values>
        <value code="2">2S Battery</value>
        <value code="3">3S Battery</value>
        <value code="4">4S Battery</value>
        <value code="5">5S Battery</value>
        <value code="6">6S Battery</value>
        <value code="7">7S Battery</value>
        <value code="8">8S Battery</value>
        <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>
      </values>
    </parameter>
    <parameter default="-1.0" name="BAT1_R_INTERNAL" type="FLOAT">
      <short_desc>Explicitly defines the per cell internal resistance for battery 1</short_desc>
      <long_desc>If non-negative, then this will be used in place of BAT1_V_LOAD_DROP for all calculations.</long_desc>
      <min>-1.0</min>
      <max>0.2</max>
      <unit>Ohm</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>True</reboot_required>
    </parameter>
    <parameter default="0" name="BAT1_SOURCE" type="INT32">
      <short_desc>Battery 1 monitoring source</short_desc>
423
      <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. If the value is set to 'ESCs', the battery information are taken from the esc_status message. This requires the ESC to provide both voltage as well as current.</long_desc>
424 425 426 427
      <reboot_required>True</reboot_required>
      <values>
        <value code="0">Power Module</value>
        <value code="1">External</value>
428
        <value code="2">ESCs</value>
429 430
      </values>
    </parameter>
431 432 433 434 435
    <parameter default="-1" name="BAT1_V_CHANNEL" type="INT32">
      <short_desc>Battery 1 Voltage 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>
      <reboot_required>True</reboot_required>
    </parameter>
436 437 438 439 440 441 442 443 444 445
    <parameter default="4.05" name="BAT1_V_CHARGED" type="FLOAT">
      <short_desc>Full cell voltage (5C load)</short_desc>
      <long_desc>Defines the voltage where a single cell of battery 1 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="BAT1_V_DIV" type="FLOAT">
      <short_desc>Battery 1 voltage divider (V divider)</short_desc>
446
      <long_desc>This is the divider from battery 1 voltage to 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>
447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469
      <decimal>8</decimal>
      <reboot_required>True</reboot_required>
    </parameter>
    <parameter default="3.5" name="BAT1_V_EMPTY" type="FLOAT">
      <short_desc>Empty cell voltage (5C load)</short_desc>
      <long_desc>Defines the voltage where a single cell of battery 1 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="BAT1_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 for battery 1 and assumes linearity. A good value to use is the difference between the 5C and 20-25C load. Not used if BAT1_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="-1.0" name="BAT2_A_PER_V" type="FLOAT">
      <short_desc>Battery 2 current per volt (A/V)</short_desc>
470
      <long_desc>The voltage seen by the 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
471
      <decimal>8</decimal>
472 473 474 475 476 477 478 479 480 481 482 483
      <reboot_required>True</reboot_required>
    </parameter>
    <parameter default="-1.0" name="BAT2_CAPACITY" type="FLOAT">
      <short_desc>Battery 2 capacity</short_desc>
      <long_desc>Defines the capacity of battery 2 in mAh.</long_desc>
      <min>-1.0</min>
      <max>100000</max>
      <unit>mAh</unit>
      <decimal>0</decimal>
      <increment>50</increment>
      <reboot_required>True</reboot_required>
    </parameter>
484 485 486 487 488
    <parameter default="-1" name="BAT2_I_CHANNEL" type="INT32">
      <short_desc>Battery 2 Current ADC Channel</short_desc>
      <long_desc>This parameter specifies the ADC channel used to monitor current of main power battery. A value of -1 means to use the board default.</long_desc>
      <reboot_required>True</reboot_required>
    </parameter>
489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522
    <parameter default="0" name="BAT2_N_CELLS" type="INT32">
      <short_desc>Number of cells for battery 2</short_desc>
      <long_desc>Defines the number of cells the attached battery consists of.</long_desc>
      <reboot_required>True</reboot_required>
      <values>
        <value code="2">2S Battery</value>
        <value code="3">3S Battery</value>
        <value code="4">4S Battery</value>
        <value code="5">5S Battery</value>
        <value code="6">6S Battery</value>
        <value code="7">7S Battery</value>
        <value code="8">8S Battery</value>
        <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>
      </values>
    </parameter>
    <parameter default="-1.0" name="BAT2_R_INTERNAL" type="FLOAT">
      <short_desc>Explicitly defines the per cell internal resistance for battery 2</short_desc>
      <long_desc>If non-negative, then this will be used in place of BAT2_V_LOAD_DROP for all calculations.</long_desc>
      <min>-1.0</min>
      <max>0.2</max>
      <unit>Ohm</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>True</reboot_required>
    </parameter>
    <parameter default="0" name="BAT2_SOURCE" type="INT32">
      <short_desc>Battery 2 monitoring source</short_desc>
523
      <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. If the value is set to 'ESCs', the battery information are taken from the esc_status message. This requires the ESC to provide both voltage as well as current.</long_desc>
524 525 526 527
      <reboot_required>True</reboot_required>
      <values>
        <value code="0">Power Module</value>
        <value code="1">External</value>
528
        <value code="2">ESCs</value>
529 530
      </values>
    </parameter>
531 532 533 534 535
    <parameter default="-1" name="BAT2_V_CHANNEL" type="INT32">
      <short_desc>Battery 2 Voltage 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>
      <reboot_required>True</reboot_required>
    </parameter>
536 537 538 539 540 541 542 543 544 545
    <parameter default="4.05" name="BAT2_V_CHARGED" type="FLOAT">
      <short_desc>Full cell voltage (5C load)</short_desc>
      <long_desc>Defines the voltage where a single cell of battery 1 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="BAT2_V_DIV" type="FLOAT">
      <short_desc>Battery 2 voltage divider (V divider)</short_desc>
546
      <long_desc>This is the divider from battery 2 voltage to 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>
547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573
      <decimal>8</decimal>
      <reboot_required>True</reboot_required>
    </parameter>
    <parameter default="3.5" name="BAT2_V_EMPTY" type="FLOAT">
      <short_desc>Empty cell voltage (5C load)</short_desc>
      <long_desc>Defines the voltage where a single cell of battery 1 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="BAT2_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 for battery 1 and assumes linearity. A good value to use is the difference between the 5C and 20-25C load. Not used if BAT2_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="-1" name="BAT_ADC_CHANNEL" type="INT32">
      <short_desc>This parameter is deprecated. Please use BAT1_ADC_CHANNEL</short_desc>
    </parameter>
    <parameter default="-1.0" name="BAT_A_PER_V" type="FLOAT">
      <short_desc>This parameter is deprecated. Please use BAT1_A_PER_V</short_desc>
      <decimal>8</decimal>
Lorenz Meier's avatar
Lorenz Meier committed
574
    </parameter>
575
    <parameter default="-1.0" name="BAT_CAPACITY" type="FLOAT">
576 577
      <short_desc>This parameter is deprecated. Please use BAT1_CAPACITY instead</short_desc>
      <long_desc>Defines the capacity of battery 1.</long_desc>
578 579
      <min>-1.0</min>
      <max>100000</max>
580
      <unit>mAh</unit>
581 582 583 584
      <decimal>0</decimal>
      <increment>50</increment>
      <reboot_required>true</reboot_required>
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
585
    <parameter default="0.07" name="BAT_CRIT_THR" type="FLOAT">
Lorenz Meier's avatar
Lorenz Meier committed
586
      <short_desc>Critical threshold</short_desc>
Lorenz Meier's avatar
Lorenz Meier committed
587
      <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
588
      <min>0.05</min>
589
      <max>0.25</max>
Lorenz Meier's avatar
Lorenz Meier committed
590
      <unit>norm</unit>
Lorenz Meier's avatar
Lorenz Meier committed
591 592
      <decimal>2</decimal>
      <increment>0.01</increment>
DonLakeFlyer's avatar
DonLakeFlyer committed
593
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
594
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
595 596 597 598
    <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>
599
      <max>0.1</max>
Lorenz Meier's avatar
Lorenz Meier committed
600 601 602
      <unit>norm</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
DonLakeFlyer's avatar
DonLakeFlyer committed
603
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
604
    </parameter>
605 606 607 608
    <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>
609
      <max>0.5</max>
610
      <unit>norm</unit>
611
      <decimal>2</decimal>
Lorenz Meier's avatar
Lorenz Meier committed
612
      <increment>0.01</increment>
DonLakeFlyer's avatar
DonLakeFlyer committed
613
      <reboot_required>true</reboot_required>
614
    </parameter>
615
    <parameter default="0" name="BAT_N_CELLS" type="INT32">
616
      <short_desc>This parameter is deprecated. Please use BAT1_N_CELLS instead</short_desc>
617 618
      <long_desc>Defines the number of cells the attached battery consists of.</long_desc>
      <unit>S</unit>
DonLakeFlyer's avatar
DonLakeFlyer committed
619
      <reboot_required>true</reboot_required>
620
      <values>
621
        <value code="0">Unconfigured</value>
622
        <value code="2">2S Battery</value>
623
        <value code="3">3S Battery</value>
624
        <value code="4">4S Battery</value>
625
        <value code="5">5S Battery</value>
626
        <value code="6">6S Battery</value>
627
        <value code="7">7S Battery</value>
628
        <value code="8">8S Battery</value>
629 630 631 632 633 634 635 636
        <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>
637
      </values>
638
    </parameter>
639
    <parameter default="-1.0" name="BAT_R_INTERNAL" type="FLOAT">
640
      <short_desc>This parameter is deprecated. Please use BAT1_R_INTERNAL instead</short_desc>
641
      <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
642
      <min>-1.0</min>
643
      <max>0.2</max>
644
      <unit>Ohm</unit>
DonLakeFlyer's avatar
DonLakeFlyer committed
645
      <reboot_required>true</reboot_required>
646
    </parameter>
647
    <parameter default="0" name="BAT_SOURCE" type="INT32">
648 649
      <short_desc>This parameter is deprecated. Please use BAT1_SOURCE instead</short_desc>
      <long_desc>Battery monitoring source. 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>
650 651 652 653 654 655 656 657
      <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">
658 659
      <short_desc>This parameter is deprecated. Please use BAT1_V_CHARGED instead</short_desc>
      <long_desc>Defines the voltage where a single cell of battery 1 is considered full under a mild load. This will never be the nominal voltage of 4.2V</long_desc>
660 661 662 663 664 665
      <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">
666
      <short_desc>This parameter is deprecated. Please use BAT1_V_DIV</short_desc>
667 668
      <decimal>8</decimal>
    </parameter>
669
    <parameter default="3.5" name="BAT_V_EMPTY" type="FLOAT">
670 671
      <short_desc>This parameter is deprecated. Please use BAT1_V_EMPTY instead</short_desc>
      <long_desc>Defines the voltage where a single cell of battery 1 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>
672 673 674 675 676 677
      <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">
678 679
      <short_desc>This parameter is deprecated. Please use BAT1_V_LOAD_DROP instead</short_desc>
      <long_desc>This implicitely defines the internal resistance to maximum current ratio for battery 1 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>
680 681 682 683 684 685 686 687 688 689 690 691 692
      <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>
693 694 695 696 697 698 699 700 701 702
  <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>
703
  <group name="Camera Control">
704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720
    <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>
      <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>
721
      <values>
722 723 724
        <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>
725 726 727
      </values>
    </parameter>
  </group>
Don Gagne's avatar
Don Gagne committed
728
  <group name="Camera trigger">
729 730 731 732 733 734 735
    <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>
736
      <reboot_required>true</reboot_required>
737 738 739 740 741 742 743 744
    </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>
745
      <reboot_required>true</reboot_required>
746
    </parameter>
747
    <parameter default="4" name="TRIG_INTERFACE" type="INT32">
Lorenz Meier's avatar
Lorenz Meier committed
748 749 750 751 752
      <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>
753
        <value code="2">Seagull MAP2 (over PWM)</value>
754
        <value code="3">MAVLink (forward via MAV_CMD_IMAGE_START_CAPTURE)</value>
755
        <value code="4">Generic PWM (IR trigger, servo)</value>
Lorenz Meier's avatar
Lorenz Meier committed
756 757
      </values>
    </parameter>
Don Gagne's avatar
Don Gagne committed
758 759 760 761 762
    <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
763
      <unit>ms</unit>
Lorenz Meier's avatar
Lorenz Meier committed
764
      <decimal>1</decimal>
765 766 767 768 769 770 771 772 773 774
      <reboot_required>true</reboot_required>
    </parameter>
    <parameter default="1.0" name="TRIG_MIN_INTERVA" type="FLOAT">
      <short_desc>Minimum camera trigger interval</short_desc>
      <long_desc>This parameter sets the minimum time between two consecutive trigger events the specific camera setup is supporting.</long_desc>
      <min>1.0</min>
      <max>10000.0</max>
      <unit>ms</unit>
      <decimal>1</decimal>
      <reboot_required>true</reboot_required>
Don Gagne's avatar
Don Gagne committed
775 776 777 778
    </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
779
      <max>4</max>
Lorenz Meier's avatar
Lorenz Meier committed
780
      <reboot_required>true</reboot_required>
Lorenz Meier's avatar
Lorenz Meier committed
781 782
      <values>
        <value code="0">Disable</value>
783
        <value code="1">Time based, on command</value>
Lorenz Meier's avatar
Lorenz Meier committed
784
        <value code="2">Time based, always on</value>
785
        <value code="3">Distance based, always on</value>
786
        <value code="4">Distance based, on command (Survey mode)</value>
Lorenz Meier's avatar
Lorenz Meier committed
787
      </values>
Don Gagne's avatar
Don Gagne committed
788
    </parameter>
789
    <parameter default="56" name="TRIG_PINS" type="INT32">
Don Gagne's avatar
Don Gagne committed
790
      <short_desc>Camera trigger pin</short_desc>
791
      <long_desc>Selects which FMU pin is used (range: AUX1-AUX8 on Pixhawk controllers with an I/O board, MAIN1-MAIN8 on controllers without an I/O board. 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. Note: only with a value of 56 or 78 it is possible to use the lower pins for actuator outputs (e.g. ESC's).</long_desc>
Don Gagne's avatar
Don Gagne committed
792
      <min>1</min>
793
      <max>12345678</max>
Lorenz Meier's avatar
Lorenz Meier committed
794 795
      <decimal>0</decimal>
      <reboot_required>true</reboot_required>
Don Gagne's avatar
Don Gagne committed
796
    </parameter>
797 798 799
    <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
800
      <min>0</min>
801
      <max>1</max>
802
      <reboot_required>true</reboot_required>
803 804 805 806
      <values>
        <value code="0">Active low</value>
        <value code="1">Active high</value>
      </values>
Lorenz Meier's avatar
Lorenz Meier committed
807
    </parameter>
808 809 810 811 812 813 814 815 816 817 818 819 820 821
    <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>
822 823
  </group>
  <group name="Circuit Breaker">
824
    <parameter category="Developer" default="0" name="CBRK_AIRSPD_CHK" type="INT32">
825
      <short_desc>Circuit breaker for airspeed sensor</short_desc>
826
      <long_desc>Setting this parameter to 162128 will disable the check for an airspeed sensor. The sensor driver will not be started and it cannot be calibrated. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
827 828
      <min>0</min>
      <max>162128</max>
Lorenz Meier's avatar
Lorenz Meier committed
829
      <reboot_required>true</reboot_required>
830
    </parameter>
831
    <parameter category="Developer" default="0" name="CBRK_BUZZER" type="INT32">
832
      <short_desc>Circuit breaker for disabling buzzer</short_desc>
833
      <long_desc>Setting this parameter to 782097 will disable the buzzer audio notification. Setting this parameter to 782090 will disable the startup tune, while keeping all others enabled.</long_desc>
834
      <min>0</min>
835
      <max>782097</max>
Lorenz Meier's avatar
Lorenz Meier committed
836
      <reboot_required>true</reboot_required>
837
    </parameter>
838
    <parameter category="Developer" default="284953" name="CBRK_ENGINEFAIL" type="INT32">
839
      <short_desc>Circuit breaker for engine failure detection</short_desc>
Lorenz Meier's avatar
Lorenz Meier committed
840
      <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>
841 842
      <min>0</min>
      <max>284953</max>
Lorenz Meier's avatar
Lorenz Meier committed
843
      <reboot_required>true</reboot_required>
844
    </parameter>
845
    <parameter category="Developer" default="121212" name="CBRK_FLIGHTTERM" type="INT32">
846
      <short_desc>Circuit breaker for flight termination</short_desc>
847
      <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, geofence, and takeoff failure detection safety logic.</long_desc>
848 849 850 851
      <min>0</min>
      <max>121212</max>
      <reboot_required>true</reboot_required>
    </parameter>
852
    <parameter category="Developer" default="0" name="CBRK_IO_SAFETY" type="INT32">
853 854
      <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>
855
      <min>0</min>
856 857 858
      <max>22027</max>
      <reboot_required>true</reboot_required>
    </parameter>
859
    <parameter category="Developer" default="0" name="CBRK_RATE_CTRL" type="INT32">
860 861 862 863 864 865
      <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>
866
    <parameter category="Developer" default="0" name="CBRK_SUPPLY_CHK" type="INT32">
867 868 869 870
      <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
871
      <reboot_required>true</reboot_required>
872
    </parameter>
873
    <parameter category="Developer" default="0" name="CBRK_USB_CHK" type="INT32">
874 875 876 877
      <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
878
      <reboot_required>true</reboot_required>
879
    </parameter>
880
    <parameter category="Developer" default="0" name="CBRK_VELPOSERR" type="INT32">
881 882 883 884 885 886
      <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>
887 888 889 890 891 892 893
    <parameter category="Developer" default="0" name="CBRK_VTOLARMING" type="INT32">
      <short_desc>Circuit breaker for arming in fixed-wing mode check</short_desc>
      <long_desc>Setting this parameter to 159753 will enable arming in fixed-wing mode for VTOLs. WARNING: ENABLING THIS CIRCUIT BREAKER IS AT OWN RISK</long_desc>
      <min>0</min>
      <max>159753</max>
      <reboot_required>true</reboot_required>
    </parameter>
894 895
  </group>
  <group name="Commander">
896
    <parameter default="256010" name="COM_ARM_AUTH" type="INT32">
897
      <short_desc>Arm authorization parameters, this uint32_t will be split between starting from the LSB:
898 899 900 901 902 903 904
- 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>
905
    </parameter>
906 907 908 909
    <parameter default="0" name="COM_ARM_AUTH_REQ" type="INT32">
      <short_desc>Require arm authorization to arm</short_desc>
      <long_desc>The default allows to arm the vehicle without a arm authorization.</long_desc>
    </parameter>
910 911 912 913
    <parameter default="1" name="COM_ARM_CHK_ESCS" type="INT32">
      <short_desc>Require all the ESCs to be detected to arm</short_desc>
      <long_desc>This param is specific for ESCs reporting status. Normal ESCs configurations are not affected by the change of this param.</long_desc>
    </parameter>
914
    <parameter default="0.0022" name="COM_ARM_EKF_AB" type="FLOAT">
915 916
      <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>
917 918 919 920
      <min>0.001</min>
      <max>0.01</max>
      <unit>m/s</unit>
      <decimal>4</decimal>
921
      <increment>0.0001</increment>
922
    </parameter>
923
    <parameter default="0.0011" name="COM_ARM_EKF_GB" type="FLOAT">
924 925 926 927
      <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>
928
      <decimal>4</decimal>
929 930 931 932 933
      <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>
934
      <max>1.0</max>
Lorenz Meier's avatar
Lorenz Meier committed
935
      <decimal>2</decimal>
936
      <increment>0.05</increment>
937
    </parameter>
938 939 940 941
    <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>
942
      <decimal>2</decimal>
943
      <increment>0.05</increment>
944
    </parameter>
945 946 947 948 949 950
    <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>
      <decimal>2</decimal>
      <increment>0.05</increment>
951
    </parameter>
952 953 954 955 956 957
    <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>
      <decimal>2</decimal>
      <increment>0.05</increment>
958
    </parameter>
959 960 961 962
    <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>
963
      <unit>m/s^2</unit>
964
      <decimal>2</decimal>
965 966
      <increment>0.05</increment>
    </parameter>
967 968 969 970 971 972 973
    <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
974
    </parameter>
975
    <parameter default="45" name="COM_ARM_MAG_ANG" type="INT32">
976 977 978 979 980
      <short_desc>Maximum magnetic field inconsistency between units that will allow arming
Set -1 to disable the check</short_desc>
      <min>3</min>
      <max>180</max>
      <unit>deg</unit>
Don Gagne's avatar
Don Gagne committed
981
    </parameter>
982 983 984 985
    <parameter default="1" name="COM_ARM_MAG_STR" type="INT32">
      <short_desc>Enable mag strength preflight check</short_desc>
      <long_desc>Deny arming if the estimator detects a strong magnetic disturbance (check enabled by EKF2_MAG_CHECK)</long_desc>
    </parameter>
986 987 988 989 990 991 992
    <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>
    </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>
993
    </parameter>
994 995 996
    <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>
Lorenz Meier's avatar
Lorenz Meier committed
997
    </parameter>
998
    <parameter default="90.0" name="COM_CPU_MAX" type="FLOAT">
999
      <short_desc>Maximum allowed CPU load to still arm</short_desc>
1000 1001 1002 1003 1004 1005
      <long_desc>A negative value disables the check.</long_desc>
      <min>-1</min>
      <max>100</max>
      <unit>%</unit>
      <increment>1</increment>
    </parameter>
1006
    <parameter default="2.0" name="COM_DISARM_LAND" type="FLOAT">
1007
      <short_desc>Time-out for auto disarm after landing</short_desc>
1008 1009 1010 1011 1012 1013 1014
      <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. A zero or negative value means that automatic disarming triggered by landing detection is disabled.</long_desc>
      <unit>s</unit>
      <decimal>2</decimal>
    </parameter>
    <parameter default="10.0" name="COM_DISARM_PRFLT" type="FLOAT">
      <short_desc>Time-out for auto disarm if too slow to takeoff</short_desc>
      <long_desc>A non-zero, positive value specifies the time after arming, in seconds, within which the vehicle must take off (after which it will automatically disarm). A zero or negative value means that automatic disarming triggered by a pre-takeoff timeout is disabled.</long_desc>
Lorenz Meier's avatar
Lorenz Meier committed
1015
      <unit>s</unit>
1016
      <decimal>2</decimal>
1017
    </parameter>
1018 1019 1020 1021 1022 1023 1024
    <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>
1025
      <increment>1</increment>
Lorenz Meier's avatar
Lorenz Meier committed
1026
    </parameter>
1027 1028 1029 1030 1031 1032 1033
    <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
1034 1035
      <increment>1</increment>
    </parameter>
1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051
    <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
1052 1053
      <increment>1</increment>
    </parameter>
1054
    <parameter category="System" default="0" name="COM_FLIGHT_UUID" type="INT32" volatile="true">
1055 1056 1057 1058
      <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>
1059 1060 1061 1062
    <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>
1063
        <value code="-1">Unassigned</value>
1064
        <value code="0">Manual</value>
1065
        <value code="1">Altitude</value>
1066
        <value code="2">Position</value>
1067
        <value code="3">Mission</value>
1068 1069
        <value code="4">Hold</value>
        <value code="5">Return</value>
1070 1071
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
1072
        <value code="8">Stabilized</value>
1073 1074 1075 1076
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
1077 1078 1079 1080 1081 1082
      </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>
1083
        <value code="-1">Unassigned</value>
1084
        <value code="0">Manual</value>
1085
        <value code="1">Altitude</value>
1086
        <value code="2">Position</value>
1087
        <value code="3">Mission</value>
1088 1089
        <value code="4">Hold</value>
        <value code="5">Return</value>
1090 1091
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
1092
        <value code="8">Stabilized</value>
1093 1094 1095 1096
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
1097 1098 1099 1100 1101 1102
      </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>
1103
        <value code="-1">Unassigned</value>
1104
        <value code="0">Manual</value>
1105
        <value code="1">Altitude</value>
1106
        <value code="2">Position</value>
1107
        <value code="3">Mission</value>
1108 1109
        <value code="4">Hold</value>
        <value code="5">Return</value>
1110 1111
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
1112
        <value code="8">Stabilized</value>
1113 1114 1115 1116
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
1117 1118 1119 1120 1121 1122
      </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>
1123
        <value code="-1">Unassigned</value>
1124
        <value code="0">Manual</value>
1125
        <value code="1">Altitude</value>
1126
        <value code="2">Position</value>
1127
        <value code="3">Mission</value>
1128 1129
        <value code="4">Hold</value>
        <value code="5">Return</value>
1130 1131
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
1132
        <value code="8">Stabilized</value>
1133 1134 1135 1136
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
1137 1138 1139 1140 1141 1142
      </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>
1143
        <value code="-1">Unassigned</value>
1144
        <value code="0">Manual</value>
1145
        <value code="1">Altitude</value>
1146
        <value code="2">Position</value>
1147
        <value code="3">Mission</value>
1148 1149
        <value code="4">Hold</value>
        <value code="5">Return</value>
1150 1151
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
1152
        <value code="8">Stabilized</value>
1153 1154 1155 1156
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
1157 1158 1159 1160 1161 1162
      </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>
1163
        <value code="-1">Unassigned</value>
1164
        <value code="0">Manual</value>
1165
        <value code="1">Altitude</value>
1166
        <value code="2">Position</value>
1167
        <value code="3">Mission</value>
1168 1169
        <value code="4">Hold</value>
        <value code="5">Return</value>
1170 1171
        <value code="6">Acro</value>
        <value code="7">Offboard</value>
1172
        <value code="8">Stabilized</value>
1173 1174 1175 1176
        <value code="9">Rattitude</value>
        <value code="10">Takeoff</value>
        <value code="11">Land</value>
        <value code="12">Follow Me</value>
1177 1178
      </values>
    </parameter>
1179 1180 1181 1182 1183 1184 1185 1186 1187 1188
    <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>
1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202
    <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>
1203 1204 1205 1206 1207
    <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
1208 1209
      <unit>m</unit>
      <decimal>2</decimal>
1210
      <increment>0.5</increment>
1211
    </parameter>
1212 1213 1214 1215 1216
    <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>
1217
      <unit>m</unit>
Lorenz Meier's avatar
Lorenz Meier committed
1218
      <decimal>2</decimal>
1219
      <increment>0.5</increment>
1220
    </parameter>
1221 1222 1223 1224 1225 1226 1227
    <parameter default="5.0" name="COM_KILL_DISARM" type="FLOAT">
      <short_desc>Timeout value for disarming when kill switch is engaged</short_desc>
      <min>0.0</min>
      <max>30.0</max>
      <unit>s</unit>
      <increment>0.1</increment>
    </parameter>
1228 1229 1230 1231 1232 1233 1234 1235
    <parameter default="3.0" name="COM_LKDOWN_TKO" type="FLOAT">
      <short_desc>Timeout for detecting a failure after takeoff</short_desc>
      <long_desc>A non-zero, positive value specifies the timeframe in seconds within failure detector is allowed to put the vehicle into a lockdown state if attitude exceeds the limits defined in FD_FAIL_P and FD_FAIL_R. The check is not executed for flight modes that do support acrobatic maneuvers, e.g: Acro (MC/FW), Rattitude and Manual (FW). A zero or negative value means that the check is disabled.</long_desc>
      <min>-1.0</min>
      <max>5.0</max>
      <unit>s</unit>
      <decimal>3</decimal>
    </parameter>
1236
    <parameter default="0" name="COM_LOW_BAT_ACT" type="INT32">
1237
      <short_desc>Battery failsafe mode</short_desc>
1238
      <long_desc>Action the system takes at critical battery. See also BAT_CRIT_THR and BAT_EMERGEN_THR for definition of battery states.</long_desc>
1239 1240 1241 1242
      <decimal>0</decimal>
      <increment>1</increment>
      <values>
        <value code="0">Warning</value>
1243
        <value code="2">Land mode</value>
1244
        <value code="3">Return at critical level, land at emergency level</value>
1245
      </values>
1246
    </parameter>
1247 1248 1249 1250
    <parameter default="1" name="COM_MOT_TEST_EN" type="INT32">
      <short_desc>Enable Motor Testing</short_desc>
      <long_desc>If set, enables the motor test interface via MAVLink (DO_MOTOR_TEST), that allows spinning the motors for testing purposes.</long_desc>
    </parameter>
1251 1252 1253 1254
    <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>
1255
        <value code="-1">Disabled</value>
1256 1257 1258
        <value code="0">Land mode</value>
        <value code="1">Hold mode</value>
        <value code="2">Return mode</value>
1259 1260
        <value code="3">Terminate</value>
        <value code="4">Lockdown</value>
1261 1262 1263 1264 1265 1266
      </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>
1267
        <value code="-1">Disabled</value>
1268 1269 1270 1271 1272 1273
        <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>
1274 1275
        <value code="6">Terminate</value>
        <value code="7">Lockdown</value>
1276 1277
      </values>
    </parameter>
1278
    <parameter default="0.5" name="COM_OF_LOSS_T" type="FLOAT">
1279 1280 1281 1282
      <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>
1283
      <unit>s</unit>
1284
      <increment>0.01</increment>
1285
    </parameter>
1286 1287 1288 1289
    <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>
1290 1291
        <value code="0">Altitude/Manual. 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">Land/Terminate.  Assume no use of remote control after fallback. Switch to Land mode if a height estimate is available, else switch to TERMINATION.</value>
1292 1293
      </values>
    </parameter>
1294 1295 1296
    <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>
1297 1298
      <min>1</min>
      <max>100</max>
1299
      <unit>s</unit>
1300 1301
      <reboot_required>true</reboot_required>
    </parameter>
1302 1303
    <parameter default="5" name="COM_POS_FS_EPH" type="FLOAT">
      <short_desc>Horizontal position error threshold</short_desc>
1304
      <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>
1305 1306 1307 1308 1309 1310 1311
      <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>
1312 1313 1314 1315 1316
    <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>
1317 1318 1319
    <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>
1320 1321
      <min>1</min>
      <max>100</max>
1322
      <unit>s</unit>
1323 1324
      <reboot_required>true</reboot_required>
    </parameter>
1325 1326 1327 1328 1329 1330
    <parameter default="1" name="COM_POWER_COUNT" type="INT32">
      <short_desc>Required number of redundant power modules</short_desc>
      <long_desc>This configures a check to verify the expected number of 5V rail power supplies are present. By default only one is expected. Note: CBRK_SUPPLY_CHK disables all power checks including this one.</long_desc>
      <min>0</min>
      <max>4</max>
    </parameter>
1331 1332 1333 1334 1335 1336 1337 1338 1339
    <parameter default="1" name="COM_PREARM_MODE" type="INT32">
      <short_desc>Condition to enter prearmed mode</short_desc>
      <long_desc>Condition to enter the prearmed state, an intermediate state between disarmed and armed in which non-throttling actuators are active.</long_desc>
      <values>
        <value code="0">Disabled</value>
        <value code="1">Safety button</value>
        <value code="2">Always</value>
      </values>
    </parameter>
1340 1341 1342 1343 1344
    <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>
1345
    </parameter>
1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359
    <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>
1360
      <min>0</min>
1361 1362 1363 1364 1365
      <max>35</max>
      <unit>s</unit>
      <decimal>1</decimal>
      <increment>0.1</increment>
    </parameter>
1366
    <parameter default="1" name="COM_RC_OVERRIDE" type="INT32">
1367 1368
      <short_desc>Enable RC stick override of auto and/or offboard modes</short_desc>
      <long_desc>When RC stick override is enabled, moving the RC sticks immediately gives control back to the pilot (switches to manual position mode): bit 0: Enable for auto modes (except for in critical battery reaction), bit 1: Enable for offboard mode. Only has an effect on multicopters, and VTOLS in multicopter mode.</long_desc>
1369 1370 1371
      <min>0</min>
      <max>3</max>
      <bitmask>
1372 1373
        <bit index="0"> Enable override in auto modes</bit>
        <bit index="1"> Enable override in offboard mode</bit>
1374
      </bitmask>
1375
    </parameter>
1376
    <parameter default="50.0" name="COM_RC_STICK_OV" type="FLOAT">
1377 1378 1379
      <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>
1380
      <max>80</max>
1381 1382 1383
      <unit>%</unit>
      <decimal>0</decimal>
      <increment>0.05</increment>
1384
    </parameter>
1385 1386 1387
    <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>
1388
      <unit>m/s</unit>
1389
    </parameter>
Lorenz Meier's avatar
Lorenz Meier committed
1390
  </group>
1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425
  <group name="DShot">
    <parameter default="0" name="DSHOT_CONFIG" type="INT32">
      <short_desc>Configure DShot</short_desc>
      <long_desc>This enables/disables DShot. The different modes define different speeds, for example DShot150 = 150kb/s. Not all ESCs support all modes. Note: this enables DShot on the FMU outputs. For boards with an IO it is the AUX outputs.</long_desc>
      <reboot_required>True</reboot_required>
      <values>
        <value code="0">Disable (use PWM/Oneshot)</value>
        <value code="150"