PX4ParameterFactMetaData.xml 548 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
    <parameter name="ctl_bw" default="75" type="INT32">
7 8 9 10
      <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
    </parameter>
13
    <parameter name="ctl_dir" default="1" type="INT32">
14 15 16 17 18
      <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>
19
    <parameter name="ctl_gain" default="1" type="FLOAT">
20 21 22 23 24 25 26 27 28 29
      <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
    </parameter>
33
    <parameter name="ctl_hz_idle" default="3.5" type="FLOAT">
34 35 36 37
      <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
    </parameter>
41
    <parameter name="ctl_start_rate" default="25" type="INT32">
42 43 44 45
      <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
    </parameter>
48
    <parameter name="esc_index" default="0" type="INT32">
49 50 51 52 53
      <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>
54
    <parameter name="id_ext_status" default="20034" type="INT32">
55 56 57
      <short_desc>Extended status ID</short_desc>
      <long_desc>Extended status ID</long_desc>
      <min>1</min>
58
      <max>1000000</max>
59
    </parameter>
60
    <parameter name="int_ext_status" default="50000" type="INT32">
61 62 63 64
      <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
    </parameter>
67
    <parameter name="int_status" default="50000" type="INT32">
68 69 70
      <short_desc>ESC status interval (µs)</short_desc>
      <long_desc>ESC status interval (µs)</long_desc>
      <max>1000000</max>
71
      <unit>us</unit>
72
    </parameter>
73
    <parameter name="mot_i_max" default="12" type="FLOAT">
74 75 76 77 78 79 80 81 82
      <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
    </parameter>
86
    <parameter name="mot_kv" default="2300" type="INT32">
87 88 89 90 91
      <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
    </parameter>
95
    <parameter name="mot_ls" default="0.0" type="FLOAT">
96 97
      <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
      <decimal>3</decimal>
    </parameter>
101
    <parameter name="mot_num_poles" default="14" type="INT32">
102 103 104 105 106 107 108
      <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>
109
    <parameter name="mot_rs" default="0.0" type="FLOAT">
110 111 112 113
      <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>
117
    <parameter name="mot_v_accel" default="0.5" 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
    </parameter>
125
    <parameter name="mot_v_max" default="14.8" type="FLOAT">
126 127 128 129 130 131
      <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
  <group name="UAVCAN GNSS" no_code_generation="true">
138
    <parameter name="gnss.dyn_model" default="2" type="INT32">
139 140 141 142 143 144 145 146 147 148 149 150
      <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>
151
    <parameter name="gnss.old_fix_msg" default="1" type="INT32">
152 153 154 155 156 157 158 159 160 161 162 163 164
      <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
    <parameter name="gnss.warn_dimens" default="0" type="INT32">
166 167 168 169 170 171 172 173 174 175 176 177 178 179 180
      <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>
181
    <parameter name="gnss.warn_sats" default="0" type="INT32">
182 183 184 185 186 187
      <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
    <parameter name="uavcan.pubp-pres" default="0" type="INT32">
189 190 191 192 193 194 195
      <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
    <parameter name="ASPD_BETA_GATE" default="1" type="INT32">
201
      <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 name="ASPD_BETA_NOISE" default="0.3" 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
    <parameter name="ASPD_DO_CHECKS" default="0" type="INT32">
215 216 217 218
      <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>
219
    <parameter name="ASPD_FALLBACK" default="0" type="INT32">
220 221 222 223 224 225 226 227
      <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>
228
    <parameter name="ASPD_FS_INNOV" default="1.0" type="FLOAT">
229 230 231 232 233
      <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>
234
    <parameter name="ASPD_FS_INTEG" default="-1.0" type="FLOAT">
235 236 237 238 239
      <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>
240
    <parameter name="ASPD_FS_T1" default="3" type="INT32">
241 242 243 244 245 246
      <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>
247
    <parameter name="ASPD_FS_T2" default="100" type="INT32">
248 249 250 251 252 253
      <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>
254
    <parameter name="ASPD_PRIMARY" default="1" type="INT32">
255 256 257 258 259 260 261 262 263 264
      <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>
265
    <parameter name="ASPD_SCALE" default="1.0" type="FLOAT">
266 267 268 269 270
      <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>
271
    <parameter name="ASPD_SCALE_EST" default="0" 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 name="ASPD_SC_P_NOISE" default="0.0001" 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
    <parameter name="ASPD_STALL" default="10.0" type="FLOAT">
283 284 285 286
      <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>
287
    <parameter name="ASPD_TAS_GATE" default="3" 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 name="ASPD_TAS_NOISE" default="1.4" 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 name="ASPD_W_P_NOISE" default="0.1" 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
    <parameter name="ATT_ACC_COMP" default="1" type="INT32">
311 312
      <short_desc>Acceleration compensation based on GPS
velocity</short_desc>
313
    </parameter>
314
    <parameter name="ATT_BIAS_MAX" default="0.05" type="FLOAT">
315
      <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
    <parameter name="ATT_EXT_HDG_M" default="0" type="INT32">
322 323 324
      <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
    </parameter>
333
    <parameter name="ATT_MAG_DECL" default="0.0" type="FLOAT">
334
      <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
    </parameter>
339
    <parameter name="ATT_MAG_DECL_A" default="1" type="INT32">
Lorenz Meier's avatar
Lorenz Meier committed
340
      <short_desc>Automatic GPS based declination compensation</short_desc>
341
    </parameter>
342
    <parameter name="ATT_W_ACC" default="0.2" type="FLOAT">
343
      <short_desc>Complimentary filter accelerometer weight</short_desc>
344
      <min>0</min>
345 346
      <max>1</max>
      <decimal>2</decimal>
347
    </parameter>
348
    <parameter name="ATT_W_EXT_HDG" default="0.1" type="FLOAT">
349 350 351
      <short_desc>Complimentary filter external heading weight</short_desc>
      <min>0</min>
      <max>1</max>
352
    </parameter>
353
    <parameter name="ATT_W_GYRO_BIAS" default="0.1" type="FLOAT">
354
      <short_desc>Complimentary filter gyroscope bias weight</short_desc>
355
      <min>0</min>
356 357 358
      <max>1</max>
      <decimal>2</decimal>
    </parameter>
359
    <parameter name="ATT_W_MAG" default="0.1" type="FLOAT">
360
      <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
    <parameter name="BAT1_A_PER_V" default="-1.0" type="FLOAT">
369
      <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
      <decimal>8</decimal>
      <reboot_required>True</reboot_required>
    </parameter>
374
    <parameter name="BAT1_CAPACITY" default="-1.0" type="FLOAT">
375 376 377 378 379 380 381 382 383
      <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
    <parameter name="BAT1_I_CHANNEL" default="-1" type="INT32">
385 386 387 388
      <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
    <parameter name="BAT1_N_CELLS" default="0" type="INT32">
390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410
      <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>
411
    <parameter name="BAT1_R_INTERNAL" default="-1.0" type="FLOAT">
412 413 414 415 416 417 418 419 420
      <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>
421
    <parameter name="BAT1_SOURCE" default="0" type="INT32">
422
      <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
    <parameter name="BAT1_V_CHANNEL" default="-1" type="INT32">
432 433 434 435
      <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
    <parameter name="BAT1_V_CHARGED" default="4.05" type="FLOAT">
437 438 439 440 441 442 443
      <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>
444
    <parameter name="BAT1_V_DIV" default="-1.0" type="FLOAT">
445
      <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
      <decimal>8</decimal>
      <reboot_required>True</reboot_required>
    </parameter>
450
    <parameter name="BAT1_V_EMPTY" default="3.5" type="FLOAT">
451 452 453 454 455 456 457
      <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>
458
    <parameter name="BAT1_V_LOAD_DROP" default="0.3" type="FLOAT">
459 460 461 462 463 464 465 466 467
      <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>
468
    <parameter name="BAT2_A_PER_V" default="-1.0" type="FLOAT">
469
      <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
      <reboot_required>True</reboot_required>
    </parameter>
474
    <parameter name="BAT2_CAPACITY" default="-1.0" type="FLOAT">
475 476 477 478 479 480 481 482 483
      <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
    <parameter name="BAT2_I_CHANNEL" default="-1" type="INT32">
485 486 487 488
      <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
    <parameter name="BAT2_N_CELLS" default="0" type="INT32">
490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510
      <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>
511
    <parameter name="BAT2_R_INTERNAL" default="-1.0" type="FLOAT">
512 513 514 515 516 517 518 519 520
      <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>
521
    <parameter name="BAT2_SOURCE" default="0" type="INT32">
522
      <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
    <parameter name="BAT2_V_CHANNEL" default="-1" type="INT32">
532 533 534 535
      <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
    <parameter name="BAT2_V_CHARGED" default="4.05" type="FLOAT">
537 538 539 540 541 542 543
      <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>
544
    <parameter name="BAT2_V_DIV" default="-1.0" type="FLOAT">
545
      <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
      <decimal>8</decimal>
      <reboot_required>True</reboot_required>
    </parameter>
550
    <parameter name="BAT2_V_EMPTY" default="3.5" type="FLOAT">
551 552 553 554 555 556 557
      <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>
558
    <parameter name="BAT2_V_LOAD_DROP" default="0.3" type="FLOAT">
559 560 561 562 563 564 565 566 567
      <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>
568
    <parameter name="BAT_ADC_CHANNEL" default="-1" type="INT32">
569 570
      <short_desc>This parameter is deprecated. Please use BAT1_ADC_CHANNEL</short_desc>
    </parameter>
571
    <parameter name="BAT_A_PER_V" default="-1.0" type="FLOAT">
572 573
      <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 name="BAT_CAPACITY" default="-1.0" 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>
585
    <parameter name="BAT_CRIT_THR" default="0.07" 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>
595
    <parameter name="BAT_EMERGEN_THR" default="0.05" type="FLOAT">
Lorenz Meier's avatar
Lorenz Meier committed
596 597 598
      <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
    <parameter name="BAT_LOW_THR" default="0.15" type="FLOAT">
606 607 608
      <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 name="BAT_N_CELLS" default="0" 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 name="BAT_R_INTERNAL" default="-1.0" 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 name="BAT_SOURCE" default="0" 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
      <min>0</min>
      <max>1</max>
      <values>
        <value code="0">Power Module</value>
        <value code="1">External</value>
      </values>
    </parameter>
657
    <parameter name="BAT_V_CHARGED" default="4.05" 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
      <unit>V</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>true</reboot_required>
    </parameter>
665
    <parameter name="BAT_V_DIV" default="-1.0" type="FLOAT">
666
      <short_desc>This parameter is deprecated. Please use BAT1_V_DIV</short_desc>
667 668
      <decimal>8</decimal>
    </parameter>
669
    <parameter name="BAT_V_EMPTY" default="3.5" 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
      <unit>V</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>true</reboot_required>
    </parameter>
677
    <parameter name="BAT_V_LOAD_DROP" default="0.3" 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
      <min>0.07</min>
      <max>0.5</max>
      <unit>V</unit>
      <decimal>2</decimal>
      <increment>0.01</increment>
      <reboot_required>true</reboot_required>
    </parameter>
687
    <parameter name="BAT_V_OFFS_CURR" default="0.0" type="FLOAT">
688 689 690 691 692
      <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
  <group name="Camera Capture">
694
    <parameter name="CAM_CAP_DELAY" default="0.0" type="FLOAT">
695 696 697 698 699 700 701 702
      <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
    <parameter name="CAM_CAP_EDGE" default="0" type="INT32">
705 706 707 708 709 710 711
      <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>
712
    <parameter name="CAM_CAP_FBACK" default="0" type="INT32">
713 714 715 716
      <short_desc>Camera capture feedback</short_desc>
      <long_desc>Enables camera capture feedback</long_desc>
      <reboot_required>true</reboot_required>
    </parameter>
717
    <parameter name="CAM_CAP_MODE" default="0" type="INT32">
718 719 720
      <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
    <parameter name="TRIG_ACT_TIME" default="40.0" type="FLOAT">
730 731 732 733 734 735
      <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
    </parameter>
738
    <parameter name="TRIG_DISTANCE" default="25.0" type="FLOAT">
739 740 741 742 743 744
      <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 name="TRIG_INTERFACE" default="4" 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>
758
    <parameter name="TRIG_INTERVAL" default="40.0" type="FLOAT">
Don Gagne's avatar
Don Gagne committed
759 760 761 762
      <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
      <reboot_required>true</reboot_required>
    </parameter>
767
    <parameter name="TRIG_MIN_INTERVA" default="1.0" type="FLOAT">
768 769 770 771 772 773 774
      <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
    </parameter>
776
    <parameter name="TRIG_MODE" default="0" type="INT32">
Don Gagne's avatar
Don Gagne committed
777 778
      <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 name="TRIG_PINS" default="56" 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
    <parameter name="TRIG_POLARITY" default="0" type="INT32">
798 799
      <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
    <parameter name="TRIG_PWM_NEUTRAL" default="1500" type="INT32">
809 810 811 812 813 814
      <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>
815
    <parameter name="TRIG_PWM_SHOOT" default="1900" type="INT32">
816 817 818 819 820 821
      <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 name="CBRK_AIRSPD_CHK" default="0" type="INT32" category="Developer">
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 name="CBRK_BUZZER" default="0" type="INT32" category="Developer">
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 name="CBRK_ENGINEFAIL" default="284953" type="INT32" category="Developer">
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 name="CBRK_FLIGHTTERM" default="121212" type="INT32" category="Developer">
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 name="CBRK_IO_SAFETY" default="0" type="INT32" category="Developer">
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 name="CBRK_RATE_CTRL" default="0" type="INT32" category="Developer">
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 name="CBRK_SUPPLY_CHK" default="0" type="INT32" category="Developer">
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 name="CBRK_USB_CHK" default="0" type="INT32" category="Developer">
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 name="CBRK_VELPOSERR" default="0" type="INT32" category="Developer">
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
    <parameter name="CBRK_VTOLARMING" default="0" type="INT32" category="Developer">
888 889 890 891 892 893
      <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 name="COM_ARM_AUTH" default="256010" 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
- 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>
904
      <long_desc>Default value: (10 &lt;&lt; 0 | 1000 &lt;&lt; 8 | 0 &lt;&lt; 24) = 256010 - authorizer system id = 10 - authentication method parameter = 1000 msec of timeout - authentication method = during arm</long_desc>
905
    </parameter>
906
    <parameter name="COM_ARM_AUTH_REQ" default="0" type="INT32">
907 908 909
      <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
    <parameter name="COM_ARM_CHK_ESCS" default="1" type="INT32">
911 912 913
      <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 name="COM_ARM_EKF_AB" default="0.0022" 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 name="COM_ARM_EKF_GB" default="0.0011" 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
      <increment>0.0001</increment>
    </parameter>
931
    <parameter name="COM_ARM_EKF_HGT" default="1.0" type="FLOAT">
932 933
      <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
    <parameter name="COM_ARM_EKF_POS" default="0.5" type="FLOAT">
939 940 941
      <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
    <parameter name="COM_ARM_EKF_VEL" default="0.5" type="FLOAT">
946 947 948 949 950
      <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
    <parameter name="COM_ARM_EKF_YAW" default="0.5" type="FLOAT">
953 954 955 956 957
      <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
    <parameter name="COM_ARM_IMU_ACC" default="0.7" type="FLOAT">
960 961 962
      <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
    <parameter name="COM_ARM_IMU_GYR" default="0.25" type="FLOAT">
968 969 970 971 972 973
      <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 name="COM_ARM_MAG_ANG" default="45" 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
    <parameter name="COM_ARM_MAG_STR" default="1" type="INT32">
983 984 985
      <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
    <parameter name="COM_ARM_MIS_REQ" default="0" type="INT32">
987 988 989
      <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>
990
    <parameter name="COM_ARM_SWISBTN" default="0" type="INT32">
991 992
      <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
    <parameter name="COM_ARM_WO_GPS" default="1" type="INT32">
995 996
      <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 name="COM_CPU_MAX" default="90.0" 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 name="COM_DISARM_LAND" default="2.0" type="FLOAT">
1007
      <short_desc>Time-out for auto disarm after landing</short_desc>
1008 1009 1010 1011
      <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>
1012
    <parameter name="COM_DISARM_PRFLT" default="10.0" type="FLOAT">
1013 1014
      <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
    <parameter name="COM_DL_LOSS_T" default="10" type="INT32">
1019 1020 1021 1022 1023 1024
      <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
    <parameter name="COM_EF_C2T" default="5.0" type="FLOAT">
1028 1029 1030 1031 1032 1033
      <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
    <parameter name="COM_EF_THROT" default="0.5" type="FLOAT">
1037 1038 1039 1040 1041 1042 1043 1044
      <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>
1045
    <parameter name="COM_EF_TIME" default="10.0" type="FLOAT">
1046 1047 1048 1049 1050 1051
      <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 name="COM_FLIGHT_UUID" default="0" type="INT32" volatile="true" category="System">
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
    <parameter name="COM_FLTMODE1" default="-1" type="INT32">
1060 1061 1062
      <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
      </values>
    </parameter>
1079
    <parameter name="COM_FLTMODE2" default="-1" type="INT32">
1080 1081 1082
      <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
      </values>
    </parameter>
1099
    <parameter name="COM_FLTMODE3" default="-1" type="INT32">
1100 1101 1102
      <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
      </values>
    </parameter>
1119
    <parameter name="COM_FLTMODE4" default="-1" type="INT32">
1120 1121 1122
      <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
      </values>
    </parameter>
1139
    <parameter name="COM_FLTMODE5" default="-1" type="INT32">
1140 1141 1142
      <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>