Newer
Older
<?xml version="1.0" encoding="utf-8"?>
<!-- Dynamically generated list of documented parameters (generated by param_parse.py) -->
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
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
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
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
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
<paramfile>
<vehicles>
<parameters name="ArduSub">
<param humanName="Depth reading at surface" name="ArduSub:SURFACE_DEPTH" documentation="The depth the external pressure sensor will read when the vehicle is considered at the surface (in centimeters)" user="Standard">
<field name="Range">-100 0</field>
<field name="Units">cm</field>
<field name="UnitText">centimeters</field>
</param>
<param humanName="Eeprom format version number" name="ArduSub:SYSID_SW_MREV" documentation="This value is incremented when changes are made to the eeprom format" user="Advanced">
<field name="ReadOnly">True</field>
</param>
<param humanName="MAVLink system ID of this vehicle" name="ArduSub:SYSID_THISMAV" documentation="Allows setting an individual MAVLink system id for this vehicle to distinguish it from others on the same network" user="Advanced">
<field name="Range">1 255</field>
</param>
<param humanName="My ground station number" name="ArduSub:SYSID_MYGCS" documentation="Allows restricting radio overrides to only come from my ground station" user="Advanced">
</param>
<param humanName="Throttle filter cutoff" name="ArduSub:PILOT_THR_FILT" documentation="Throttle filter cutoff (Hz) - active whenever altitude control is inactive - 0 to disable" user="Advanced">
<field name="Range">0 10</field>
<field name="Increment">.5</field>
<field name="Units">Hz</field>
<field name="UnitText">hertz</field>
</param>
<param humanName="GCS PID tuning mask" name="ArduSub:GCS_PID_MASK" documentation="bitmask of PIDs to send MAVLink PID_TUNING messages for" user="Advanced">
<field name="Bitmask">0:Roll,1:Pitch,2:Yaw</field>
<values>
<value code="0">None</value>
<value code="1">Roll</value>
<value code="2">Pitch</value>
<value code="4">Yaw</value>
</values>
</param>
<param humanName="Rangefinder gain" name="ArduSub:RNGFND_GAIN" documentation="Used to adjust the speed with which the target altitude is changed when objects are sensed below the sub" user="Standard">
<field name="Range">0.01 2.0</field>
<field name="Increment">0.01</field>
</param>
<param humanName="Ground Station Failsafe Enable" name="ArduSub:FS_GCS_ENABLE" documentation="Controls what action to take when GCS heartbeat is lost." user="Standard">
<values>
<value code="0">Disabled</value>
<value code="1">Warn only</value>
<value code="2">Disarm</value>
<value code="3">Enter depth hold mode</value>
<value code="4">Enter surface mode</value>
</values>
</param>
<param humanName="Leak Failsafe Enable" name="ArduSub:FS_LEAK_ENABLE" documentation="Controls what action to take if a leak is detected." user="Standard">
<values>
<value code="0">Disabled</value>
<value code="1">Warn only</value>
<value code="2">Enter surface mode</value>
</values>
</param>
<param humanName="Internal Pressure Failsafe Enable" name="ArduSub:FS_PRESS_ENABLE" documentation="Controls what action to take if internal pressure exceeds FS_PRESS_MAX parameter." user="Standard">
<values>
<value code="0">Disabled</value>
<value code="1">Warn only</value>
</values>
</param>
<param humanName="Internal Temperature Failsafe Enable" name="ArduSub:FS_TEMP_ENABLE" documentation="Controls what action to take if internal temperature exceeds FS_TEMP_MAX parameter." user="Standard">
<values>
<value code="0">Disabled</value>
<value code="1">Warn only</value>
</values>
</param>
<param humanName="Internal Pressure Failsafe Threshold" name="ArduSub:FS_PRESS_MAX" documentation="The maximum internal pressure allowed before triggering failsafe. Failsafe action is determined by FS_PRESS_ENABLE parameter" user="Standard">
<field name="Units">Pa</field>
<field name="UnitText">pascal</field>
</param>
<param humanName="Internal Temperature Failsafe Threshold" name="ArduSub:FS_TEMP_MAX" documentation="The maximum internal temperature allowed before triggering failsafe. Failsafe action is determined by FS_TEMP_ENABLE parameter." user="Standard">
<field name="Units">degC</field>
<field name="UnitText">degrees Celsius</field>
</param>
<param humanName="Terrain Failsafe Enable" name="ArduSub:FS_TERRAIN_ENAB" documentation="Controls what action to take if terrain information is lost during AUTO mode" user="Standard">
<values>
<value code="0">Disarm</value>
<value code=" 1">Hold Position</value>
<value code=" 2">Surface</value>
</values>
</param>
<param humanName="Pilot input failsafe action" name="ArduSub:FS_PILOT_INPUT" documentation="Controls what action to take if no pilot input has been received after the timeout period specified by the FS_PILOT_TIMEOUT parameter" user="Standard">
<values>
<value code="0">Disabled</value>
<value code=" 1">Warn Only</value>
<value code=" 2">Disarm</value>
</values>
</param>
<param humanName="Timeout for activation of pilot input failsafe" name="ArduSub:FS_PILOT_TIMEOUT" documentation="Controls the maximum interval between received pilot inputs before the failsafe action is triggered" user="Standard">
<field name="Range">0.1 3.0</field>
<field name="Units">s</field>
<field name="UnitText">seconds</field>
</param>
<param humanName="Crosstrack correction angle limit" name="ArduSub:XTRACK_ANG_LIM" documentation="Maximum allowed angle (in degrees) between current track and desired heading during waypoint navigation" user="Standard">
<field name="Range">10 90</field>
</param>
<param humanName="Yaw behaviour during missions" name="ArduSub:WP_YAW_BEHAVIOR" documentation="Determines how the autopilot controls the yaw during missions and RTL" user="Standard">
<values>
<value code="0">Never change yaw</value>
<value code=" 1">Face next waypoint</value>
<value code=" 2">Face next waypoint except RTL</value>
<value code=" 3">Face along GPS course</value>
<value code=" 4">Correct crosstrack error</value>
</values>
</param>
<param humanName="Pilot maximum vertical ascending speed" name="ArduSub:PILOT_SPEED_UP" documentation="The maximum vertical ascending velocity the pilot may request in cm/s" user="Standard">
<field name="Range">50 500</field>
<field name="Increment">10</field>
<field name="Units">cm/s</field>
<field name="UnitText">centimeters per second</field>
</param>
<param humanName="Pilot maximum vertical descending speed" name="ArduSub:PILOT_SPEED_DN" documentation="The maximum vertical descending velocity the pilot may request in cm/s" user="Standard">
<field name="Range">50 500</field>
<field name="Increment">10</field>
<field name="Units">cm/s</field>
<field name="UnitText">centimeters per second</field>
</param>
<param humanName="Pilot vertical acceleration" name="ArduSub:PILOT_ACCEL_Z" documentation="The vertical acceleration used when pilot is controlling the altitude" user="Standard">
<field name="Range">50 500</field>
<field name="Increment">10</field>
<field name="Units">cm/s/s</field>
<field name="UnitText">centimeters per square second</field>
</param>
<param humanName="Throttle deadzone" name="ArduSub:THR_DZ" documentation="The PWM deadzone in microseconds above and below mid throttle. Used in AltHold, Loiter, PosHold flight modes" user="Standard">
<field name="Range">0 300</field>
<field name="Increment">1</field>
<field name="Units">PWM</field>
<field name="UnitText">PWM in microseconds</field>
</param>
<param humanName="Log bitmask" name="ArduSub:LOG_BITMASK" documentation="4 byte bitmap of log types to enable" user="Standard">
<field name="Bitmask">0:ATTITUDE_FAST,1:ATTITUDE_MED,2:GPS,3:PM,4:CTUN,5:NTUN,6:RCIN,7:IMU,8:CMD,9:CURRENT,10:RCOUT,11:OPTFLOW,12:PID,13:COMPASS,14:INAV,15:CAMERA,17:MOTBATT,18:IMU_FAST,19:IMU_RAW</field>
<values>
<value code="830">Default</value>
<value code="894">Default+RCIN</value>
<value code="958">Default+IMU</value>
<value code="1854">Default+Motors</value>
<value code="-6146">NearlyAll-AC315</value>
<value code="45054">NearlyAll</value>
<value code="131071">All+FastATT</value>
<value code="262142">All+MotBatt</value>
<value code="393214">All+FastIMU</value>
<value code="397310">All+FastIMU+PID</value>
<value code="655358">All+FullIMU</value>
<value code="0">Disabled</value>
</values>
</param>
<param humanName="Angle Max" name="ArduSub:ANGLE_MAX" documentation="Maximum lean angle in all flight modes" user="Advanced">
<field name="Range">1000 8000</field>
<field name="Units">cdeg</field>
<field name="UnitText">centidegrees</field>
</param>
<param humanName="EKF Failsafe Action" name="ArduSub:FS_EKF_ACTION" documentation="Controls the action that will be taken when an EKF failsafe is invoked" user="Advanced">
<values>
<value code="0">Disabled</value>
<value code=" 1">Warn only</value>
<value code=" 2">Disarm</value>
</values>
</param>
<param humanName="EKF failsafe variance threshold" name="ArduSub:FS_EKF_THRESH" documentation="Allows setting the maximum acceptable compass and velocity variance" user="Advanced">
<field name="Values">0.6:Strict, 0.8:Default, 1.0:Relaxed</field>
</param>
<param humanName="Crash check enable" name="ArduSub:FS_CRASH_CHECK" documentation="This enables automatic crash checking. When enabled the motors will disarm if a crash is detected." user="Advanced">
<values>
<value code="0">Disabled</value>
<value code="1">Warn only</value>
<value code="2">Disarm</value>
</values>
</param>
<param humanName="Default gain at boot" name="ArduSub:JS_GAIN_DEFAULT" documentation="Default gain at boot, must be in range [JS_GAIN_MIN , JS_GAIN_MAX]" user="Standard">
<field name="Range">0.1 1.0</field>
</param>
<param humanName="Maximum joystick gain" name="ArduSub:JS_GAIN_MAX" documentation="Maximum joystick gain" user="Standard">
<field name="Range">0.2 1.0</field>
</param>
<param humanName="Minimum joystick gain" name="ArduSub:JS_GAIN_MIN" documentation="Minimum joystick gain" user="Standard">
<field name="Range">0.1 0.8</field>
</param>
<param humanName="Gain steps" name="ArduSub:JS_GAIN_STEPS" documentation="Controls the number of steps between minimum and maximum joystick gain when the gain is adjusted using buttons. Set to 1 to always use JS_GAIN_DEFAULT." user="Standard">
<field name="Range">1 10</field>
</param>
<param humanName="Lights brightness steps" name="ArduSub:JS_LIGHTS_STEPS" documentation="Number of steps in brightness between minimum and maximum brightness" user="Standard">
<field name="Range">1 10</field>
<field name="Units">PWM</field>
<field name="UnitText">PWM in microseconds</field>
</param>
<param humanName="Throttle gain scalar" name="ArduSub:JS_THR_GAIN" documentation="Scalar for gain on the throttle channel" user="Standard">
<field name="Range">0.5 4.0</field>
</param>
<param humanName="Frame configuration" name="ArduSub:FRAME_CONFIG" documentation="Set this parameter according to your vehicle/motor configuration" user="Standard">
<values>
<value code="0">BlueROV1</value>
<value code=" 1">Vectored</value>
<value code=" 2">Vectored_6DOF</value>
<value code=" 3">Vectored_6DOF_90</value>
<value code=" 4">SimpleROV-3</value>
<value code=" 5">SimpleROV-4</value>
<value code=" 6">SimpleROV-5</value>
<value code=" 7">Custom</value>
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="ESC Update Speed" name="ArduSub:RC_SPEED" documentation="This is the speed in Hertz that your ESCs will receive updates" user="Advanced">
<field name="Range">50 490</field>
<field name="Increment">1</field>
<field name="Units">Hz</field>
<field name="UnitText">hertz</field>
</param>
<param humanName="Acro Roll and Pitch P gain" name="ArduSub:ACRO_RP_P" documentation="Converts pilot roll and pitch into a desired rate of rotation in ACRO and SPORT mode. Higher values mean faster rate of rotation." user="Standard">
<field name="Range">1 10</field>
</param>
<param humanName="Acro Yaw P gain" name="ArduSub:ACRO_YAW_P" documentation="Converts pilot yaw input into a desired rate of rotation. Higher values mean faster rate of rotation." user="Standard">
<field name="Range">1 10</field>
</param>
<param humanName="Acro Balance Roll" name="ArduSub:ACRO_BAL_ROLL" documentation="rate at which roll angle returns to level in acro mode. A higher value causes the vehicle to return to level faster." user="Advanced">
<field name="Range">0 3</field>
<field name="Increment">0.1</field>
</param>
<param humanName="Acro Balance Pitch" name="ArduSub:ACRO_BAL_PITCH" documentation="rate at which pitch angle returns to level in acro mode. A higher value causes the vehicle to return to level faster." user="Advanced">
<field name="Range">0 3</field>
<field name="Increment">0.1</field>
</param>
<param humanName="Acro Trainer" name="ArduSub:ACRO_TRAINER" documentation="Type of trainer used in acro mode" user="Advanced">
<values>
<value code="0">Disabled</value>
<value code="1">Leveling</value>
<value code="2">Leveling and Limited</value>
</values>
</param>
<param humanName="Acro Expo" name="ArduSub:ACRO_EXPO" documentation="Acro roll/pitch Expo to allow faster rotation when stick at edges" user="Advanced">
<values>
<value code="0">Disabled</value>
<value code="0.1">Very Low</value>
<value code="0.2">Low</value>
<value code="0.3">Medium</value>
<value code="0.4">High</value>
<value code="0.5">Very High</value>
</values>
</param>
<param humanName="Terrain Following use control" name="ArduSub:TERRAIN_FOLLOW" documentation="This enables terrain following for RTL and SURFACE flight modes. To use this option TERRAIN_ENABLE must be 1 and the GCS must support sending terrain data to the aircraft. In RTL the RTL_ALT will be considered a height above the terrain. In LAND mode the vehicle will slow to LAND_SPEED 10m above terrain (instead of 10m above home). This parameter does not affect AUTO and Guided which use a per-command flag to determine if the height is above-home, absolute or above-terrain." user="Standard">
<values>
<value code="0">Do Not Use in RTL and SURFACE</value>
<value code="1">Use in RTL and SURFACE</value>
</values>
</param>
</parameters>
</vehicles><libraries><parameters name="AHRS_">
<param humanName="AHRS GPS gain" name="AHRS_GPS_GAIN" documentation="This controls how much to use the GPS to correct the attitude. This should never be set to zero for a plane as it would result in the plane losing control in turns. For a plane please use the default value of 1.0." user="Advanced">
<field name="Range">0.0 1.0</field>
<field name="Increment">.01</field>
</param>
<param humanName="AHRS use GPS for navigation" name="AHRS_GPS_USE" documentation="This controls whether to use dead-reckoning or GPS based navigation. If set to 0 then the GPS won't be used for navigation, and only dead reckoning will be used. A value of zero should never be used for normal flight. Currently this affects only the DCM-based AHRS: the EKF uses GPS whenever it is available." user="Advanced">
<values>
<value code="0">Disabled</value>
<value code="1">Enabled</value>
</values>
</param>
<param humanName="Yaw P" name="AHRS_YAW_P" documentation="This controls the weight the compass or GPS has on the heading. A higher value means the heading will track the yaw source (GPS or compass) more rapidly." user="Advanced">
<field name="Range">0.1 0.4</field>
<field name="Increment">.01</field>
</param>
<param humanName="AHRS RP_P" name="AHRS_RP_P" documentation="This controls how fast the accelerometers correct the attitude" user="Advanced">
<field name="Range">0.1 0.4</field>
<field name="Increment">.01</field>
</param>
<param humanName="Maximum wind" name="AHRS_WIND_MAX" documentation="This sets the maximum allowable difference between ground speed and airspeed. This allows the plane to cope with a failing airspeed sensor. A value of zero means to use the airspeed as is." user="Advanced">
<field name="Range">0 127</field>
<field name="Increment">1</field>
<field name="Units">m/s</field>
<field name="UnitText">meters per second</field>
</param>
<param humanName="AHRS Trim Roll" name="AHRS_TRIM_X" documentation="Compensates for the roll angle difference between the control board and the frame. Positive values make the vehicle roll right." user="Standard">
<field name="Range">-0.1745 +0.1745</field>
<field name="Increment">0.01</field>
<field name="Units">rad</field>
<field name="UnitText">radians</field>
</param>
<param humanName="AHRS Trim Pitch" name="AHRS_TRIM_Y" documentation="Compensates for the pitch angle difference between the control board and the frame. Positive values make the vehicle pitch up/back." user="Standard">
<field name="Range">-0.1745 +0.1745</field>
<field name="Increment">0.01</field>
<field name="Units">rad</field>
<field name="UnitText">radians</field>
</param>
<param humanName="AHRS Trim Yaw" name="AHRS_TRIM_Z" documentation="Not Used" user="Advanced">
<field name="Range">-0.1745 +0.1745</field>
<field name="Increment">0.01</field>
<field name="Units">rad</field>
<field name="UnitText">radians</field>
</param>
<param humanName="Board Orientation" name="AHRS_ORIENTATION" documentation="Overall board orientation relative to the standard orientation for the board type. This rotates the IMU and compass readings to allow the board to be oriented in your vehicle at any 90 or 45 degree angle. This option takes affect on next boot. After changing you will need to re-level your vehicle." user="Advanced">
<values>
<value code="0">None</value>
<value code="1">Yaw45</value>
<value code="2">Yaw90</value>
<value code="3">Yaw135</value>
<value code="4">Yaw180</value>
<value code="5">Yaw225</value>
<value code="6">Yaw270</value>
<value code="7">Yaw315</value>
<value code="8">Roll180</value>
<value code="9">Roll180Yaw45</value>
<value code="10">Roll180Yaw90</value>
<value code="11">Roll180Yaw135</value>
<value code="12">Pitch180</value>
<value code="13">Roll180Yaw225</value>
<value code="14">Roll180Yaw270</value>
<value code="15">Roll180Yaw315</value>
<value code="16">Roll90</value>
<value code="17">Roll90Yaw45</value>
<value code="18">Roll90Yaw90</value>
<value code="19">Roll90Yaw135</value>
<value code="20">Roll270</value>
<value code="21">Roll270Yaw45</value>
<value code="22">Roll270Yaw90</value>
<value code="23">Roll270Yaw135</value>
<value code="24">Pitch90</value>
<value code="25">Pitch270</value>
<value code="26">Pitch180Yaw90</value>
<value code="27">Pitch180Yaw270</value>
<value code="28">Roll90Pitch90</value>
<value code="29">Roll180Pitch90</value>
<value code="30">Roll270Pitch90</value>
<value code="31">Roll90Pitch180</value>
<value code="32">Roll270Pitch180</value>
<value code="33">Roll90Pitch270</value>
<value code="34">Roll180Pitch270</value>
<value code="35">Roll270Pitch270</value>
<value code="36">Roll90Pitch180Yaw90</value>
<value code="37">Roll90Yaw270</value>
<value code="38">Yaw293Pitch68Roll180</value>
<value code="39">Pitch315</value>
<value code="40">Roll90Pitch315</value>
<value code="100">Custom</value>
</values>
</param>
<param humanName="AHRS Velocity Complementary Filter Beta Coefficient" name="AHRS_COMP_BETA" documentation="This controls the time constant for the cross-over frequency used to fuse AHRS (airspeed and heading) and GPS data to estimate ground velocity. Time constant is 0.1/beta. A larger time constant will use GPS data less and a small time constant will use air data less." user="Advanced">
<field name="Range">0.001 0.5</field>
<field name="Increment">.01</field>
</param>
<param humanName="AHRS GPS Minimum satellites" name="AHRS_GPS_MINSATS" documentation="Minimum number of satellites visible to use GPS for velocity based corrections attitude correction. This defaults to 6, which is about the point at which the velocity numbers from a GPS become too unreliable for accurate correction of the accelerometers." user="Advanced">
<field name="Range">0 10</field>
<field name="Increment">1</field>
</param>
<param humanName="Use NavEKF Kalman filter for attitude and position estimation" name="AHRS_EKF_TYPE" documentation="This controls which NavEKF Kalman filter version is used for attitude and position estimation" user="Advanced">
<values>
<value code="0">Disabled</value>
<value code="2">Enable EKF2</value>
<value code="3">Enable EKF3</value>
</values>
</param>
<param humanName="Board orientation roll offset" name="AHRS_CUSTOM_ROLL" documentation="Autopilot mounting position roll offset. Positive values = roll right, negative values = roll left. This parameter is only used when AHRS_ORIENTATION is set to CUSTOM." user="Advanced">
<field name="Range">-180 180</field>
<field name="Increment">1</field>
<field name="Units">deg</field>
<field name="UnitText">degrees</field>
</param>
<param humanName="Board orientation pitch offset" name="AHRS_CUSTOM_PIT" documentation="Autopilot mounting position pitch offset. Positive values = pitch up, negative values = pitch down. This parameter is only used when AHRS_ORIENTATION is set to CUSTOM." user="Advanced">
<field name="Range">-180 180</field>
<field name="Increment">1</field>
<field name="Units">deg</field>
<field name="UnitText">degrees</field>
</param>
<param humanName="Board orientation yaw offset" name="AHRS_CUSTOM_YAW" documentation="Autopilot mounting position yaw offset. Positive values = yaw right, negative values = yaw left. This parameter is only used when AHRS_ORIENTATION is set to CUSTOM." user="Advanced">
<field name="Range">-180 180</field>
<field name="Increment">1</field>
<field name="Units">deg</field>
<field name="UnitText">degrees</field>
</param>
</parameters>
<parameters name="ARMING_">
<param humanName="Require Arming Motors " name="ARMING_REQUIRE" documentation="Arming disabled until some requirements are met. If 0, there are no requirements (arm immediately). If 1, require rudder stick or GCS arming before arming motors and sends the minimum throttle PWM value to the throttle channel when disarmed. If 2, require rudder stick or GCS arming and send 0 PWM to throttle channel when disarmed. See the ARMING_CHECK_* parameters to see what checks are done before arming. Note, if setting this parameter to 0 a reboot is required to arm the plane. Also note, even with this parameter at 0, if ARMING_CHECK parameter is not also zero the plane may fail to arm throttle at boot due to a pre-arm check failure." user="Advanced">
<values>
<value code="0">Disabled</value>
<value code="1">THR_MIN PWM when disarmed</value>
<value code="2">0 PWM when disarmed</value>
</values>
</param>
<param humanName="Arm Checks to Peform (bitmask)" name="ARMING_CHECK" documentation="Checks prior to arming motor. This is a bitmask of checks that will be performed before allowing arming. The default is no checks, allowing arming at any time. You can select whatever checks you prefer by adding together the values of each check type to set this parameter. For example, to only allow arming when you have GPS lock and no RC failsafe you would set ARMING_CHECK to 72. For most users it is recommended that you set this to 1 to enable all checks." user="Standard">
<field name="Bitmask">0:All,1:Barometer,2:Compass,3:GPS lock,4:INS,5:Parameters,6:RC Channels,7:Board voltage,8:Battery Level,9:Airspeed,10:Logging Available,11:Hardware safety switch,12:GPS Configuration,13:System</field>
<values>
<value code="0">None</value>
<value code="1">All</value>
<value code="2">Barometer</value>
<value code="4">Compass</value>
<value code="8">GPS Lock</value>
<value code="16">INS(INertial Sensors - accels & gyros)</value>
<value code="32">Parameters(unused)</value>
<value code="64">RC Channels</value>
<value code="128">Board voltage</value>
<value code="256">Battery Level</value>
<value code="512">Airspeed</value>
<value code="1024">LoggingAvailable</value>
<value code="2048">Hardware safety switch</value>
<value code="4096">GPS configuration</value>
<value code="8192">System</value>
</values>
</param>
<param humanName="Accelerometer error threshold" name="ARMING_ACCTHRESH" documentation="Accelerometer error threshold used to determine inconsistent accelerometers. Compares this error range to other accelerometers to detect a hardware or calibration error. Lower value means tighter check and harder to pass arming check. Not all accelerometers are created equal." user="Advanced">
<field name="Range">0.25 3.0</field>
<field name="Units">m/s/s</field>
<field name="UnitText">meters per square second</field>
</param>
<param humanName="Arming with Rudder enable/disable" name="ARMING_RUDDER" documentation="Allow arm/disarm by rudder input. When enabled arming can be done with right rudder, disarming with left rudder. Rudder arming only works in manual throttle modes with throttle at zero +- deadzone (RCx_DZ)" user="Advanced">
<values>
<value code="0">Disabled</value>
<value code="1">ArmingOnly</value>
<value code="2">ArmOrDisarm</value>
</values>
</param>
<param humanName="Required mission items" name="ARMING_MIS_ITEMS" documentation="Bitmask of mission items that are required to be planned in order to arm the aircraft" user="Advanced">
<field name="Bitmask">0:Land,1:VTOL Land,2:DO_LAND_START,3:Takeoff,4:VTOL Takeoff,5:Rallypoint</field>
</param>
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
</parameters>
<parameters name="ATC_">
<param humanName="Yaw target slew rate" name="ATC_SLEW_YAW" documentation="Maximum rate the yaw target can be updated in Loiter, RTL, Auto flight modes" user="Advanced">
<field name="Range">500 18000</field>
<field name="Increment">100</field>
<field name="Units">cdeg/s</field>
<field name="UnitText">centidegrees per second</field>
</param>
<param humanName="Acceleration Max for Yaw" name="ATC_ACCEL_Y_MAX" documentation="Maximum acceleration in yaw axis" user="Advanced">
<field name="Range">0 72000</field>
<values>
<value code="0">Disabled</value>
<value code=" 9000">VerySlow</value>
<value code=" 18000">Slow</value>
<value code=" 36000">Medium</value>
<value code=" 54000">Fast</value>
</values>
<field name="Increment">1000</field>
<field name="Units">cdeg/s/s</field>
<field name="UnitText">centidegrees per square second</field>
</param>
<param humanName="Rate Feedforward Enable" name="ATC_RATE_FF_ENAB" documentation="Controls whether body-frame rate feedfoward is enabled or disabled" user="Advanced">
<values>
<value code="0">Disabled</value>
<value code=" 1">Enabled</value>
</values>
</param>
<param humanName="Acceleration Max for Roll" name="ATC_ACCEL_R_MAX" documentation="Maximum acceleration in roll axis" user="Advanced">
<field name="Range">0 180000</field>
<values>
<value code="0">Disabled</value>
<value code=" 30000">VerySlow</value>
<value code=" 72000">Slow</value>
<value code=" 108000">Medium</value>
<value code=" 162000">Fast</value>
</values>
<field name="Increment">1000</field>
<field name="Units">cdeg/s/s</field>
<field name="UnitText">centidegrees per square second</field>
</param>
<param humanName="Acceleration Max for Pitch" name="ATC_ACCEL_P_MAX" documentation="Maximum acceleration in pitch axis" user="Advanced">
<field name="Range">0 180000</field>
<values>
<value code="0">Disabled</value>
<value code=" 30000">VerySlow</value>
<value code=" 72000">Slow</value>
<value code=" 108000">Medium</value>
<value code=" 162000">Fast</value>
</values>
<field name="Increment">1000</field>
<field name="Units">cdeg/s/s</field>
<field name="UnitText">centidegrees per square second</field>
</param>
<param humanName="Angle Boost" name="ATC_ANGLE_BOOST" documentation="Angle Boost increases output throttle as the vehicle leans to reduce loss of altitude" user="Advanced">
<values>
<value code="0">Disabled</value>
<value code=" 1">Enabled</value>
</values>
</param>
<param humanName="Roll axis angle controller P gain" name="ATC_ANG_RLL_P" documentation="Roll axis angle controller P gain. Converts the error between the desired roll angle and actual angle to a desired roll rate" user="Standard">
<field name="Range">0.0 12.000</field>
</param>
<param humanName="Pitch axis angle controller P gain" name="ATC_ANG_PIT_P" documentation="Pitch axis angle controller P gain. Converts the error between the desired pitch angle and actual angle to a desired pitch rate" user="Standard">
<field name="Range">0.0 12.000</field>
</param>
<param humanName="Yaw axis angle controller P gain" name="ATC_ANG_YAW_P" documentation="Yaw axis angle controller P gain. Converts the error between the desired yaw angle and actual angle to a desired yaw rate" user="Standard">
<field name="Range">0.0 6.000</field>
</param>
<param humanName="Angle Limit (to maintain altitude) Time Constant" name="ATC_ANG_LIM_TC" documentation="Angle Limit (to maintain altitude) Time Constant" user="Advanced">
<field name="Range">0.5 10.0</field>
</param>
<param humanName="Angular Velocity Max for Roll" name="ATC_RATE_R_MAX" documentation="Maximum angular velocity in roll axis" user="Advanced">
<field name="Range">0 1080</field>
<values>
<value code="0">Disabled</value>
<value code=" 360">Slow</value>
<value code=" 720">Medium</value>
<value code=" 1080">Fast</value>
</values>
<field name="Increment">1</field>
<field name="Units">deg/s</field>
<field name="UnitText">degrees per second</field>
</param>
<param humanName="Angular Velocity Max for Pitch" name="ATC_RATE_P_MAX" documentation="Maximum angular velocity in pitch axis" user="Advanced">
<field name="Range">0 1080</field>
<values>
<value code="0">Disabled</value>
<value code=" 360">Slow</value>
<value code=" 720">Medium</value>
<value code=" 1080">Fast</value>
</values>
<field name="Increment">1</field>
<field name="Units">deg/s</field>
<field name="UnitText">degrees per second</field>
</param>
<param humanName="Angular Velocity Max for Yaw" name="ATC_RATE_Y_MAX" documentation="Maximum angular velocity in yaw axis" user="Advanced">
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
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
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
<field name="Range">0 1080</field>
<values>
<value code="0">Disabled</value>
<value code=" 360">Slow</value>
<value code=" 720">Medium</value>
<value code=" 1080">Fast</value>
</values>
<field name="Increment">1</field>
<field name="Units">deg/s</field>
<field name="UnitText">degrees per second</field>
</param>
<param humanName="Attitude control input time constant (aka smoothing)" name="ATC_INPUT_TC" documentation="Attitude control input time constant. Low numbers lead to sharper response, higher numbers to softer response" user="Standard">
<field name="Range">0 1</field>
<field name="Values">0.5:Very Soft, 0.2:Soft, 0.15:Medium, 0.1:Crisp, 0.05:Very Crisp</field>
<field name="Increment">0.01</field>
<field name="Units">s</field>
<field name="UnitText">seconds</field>
</param>
<param humanName="Roll axis rate controller P gain" name="ATC_RAT_RLL_P" documentation="Roll axis rate controller P gain. Converts the difference between desired roll rate and actual roll rate into a motor speed output" user="Standard">
<field name="Range">0.0 0.30</field>
<field name="Increment">0.005</field>
</param>
<param humanName="Roll axis rate controller I gain" name="ATC_RAT_RLL_I" documentation="Roll axis rate controller I gain. Corrects long-term difference in desired roll rate vs actual roll rate" user="Standard">
<field name="Range">0.0 0.5</field>
<field name="Increment">0.01</field>
</param>
<param humanName="Roll axis rate controller I gain maximum" name="ATC_RAT_RLL_IMAX" documentation="Roll axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output" user="Standard">
<field name="Range">0 1</field>
<field name="Increment">0.01</field>
<field name="Units">%</field>
<field name="UnitText">percent</field>
</param>
<param humanName="Roll axis rate controller D gain" name="ATC_RAT_RLL_D" documentation="Roll axis rate controller D gain. Compensates for short-term change in desired roll rate vs actual roll rate" user="Standard">
<field name="Range">0.0 0.02</field>
<field name="Increment">0.001</field>
</param>
<param humanName="Roll axis rate controller feed forward" name="ATC_RAT_RLL_FF" documentation="Roll axis rate controller feed forward" user="Standard">
<field name="Range">0 0.5</field>
<field name="Increment">0.001</field>
</param>
<param humanName="Roll axis rate controller input frequency in Hz" name="ATC_RAT_RLL_FILT" documentation="Roll axis rate controller input frequency in Hz" user="Standard">
<field name="Range">1 100</field>
<field name="Increment">1</field>
<field name="Units">Hz</field>
<field name="UnitText">hertz</field>
</param>
<param humanName="Pitch axis rate controller P gain" name="ATC_RAT_PIT_P" documentation="Pitch axis rate controller P gain. Converts the difference between desired pitch rate and actual pitch rate into a motor speed output" user="Standard">
<field name="Range">0.0 0.30</field>
<field name="Increment">0.005</field>
</param>
<param humanName="Pitch axis rate controller I gain" name="ATC_RAT_PIT_I" documentation="Pitch axis rate controller I gain. Corrects long-term difference in desired pitch rate vs actual pitch rate" user="Standard">
<field name="Range">0.0 0.5</field>
<field name="Increment">0.01</field>
</param>
<param humanName="Pitch axis rate controller I gain maximum" name="ATC_RAT_PIT_IMAX" documentation="Pitch axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output" user="Standard">
<field name="Range">0 1</field>
<field name="Increment">0.01</field>
<field name="Units">%</field>
<field name="UnitText">percent</field>
</param>
<param humanName="Pitch axis rate controller D gain" name="ATC_RAT_PIT_D" documentation="Pitch axis rate controller D gain. Compensates for short-term change in desired pitch rate vs actual pitch rate" user="Standard">
<field name="Range">0.0 0.02</field>
<field name="Increment">0.001</field>
</param>
<param humanName="Pitch axis rate controller feed forward" name="ATC_RAT_PIT_FF" documentation="Pitch axis rate controller feed forward" user="Standard">
<field name="Range">0 0.5</field>
<field name="Increment">0.001</field>
</param>
<param humanName="Pitch axis rate controller input frequency in Hz" name="ATC_RAT_PIT_FILT" documentation="Pitch axis rate controller input frequency in Hz" user="Standard">
<field name="Range">1 100</field>
<field name="Increment">1</field>
<field name="Units">Hz</field>
<field name="UnitText">hertz</field>
</param>
<param humanName="Yaw axis rate controller P gain" name="ATC_RAT_YAW_P" documentation="Yaw axis rate controller P gain. Converts the difference between desired yaw rate and actual yaw rate into a motor speed output" user="Standard">
<field name="Range">0.0 0.50</field>
<field name="Increment">0.005</field>
</param>
<param humanName="Yaw axis rate controller I gain" name="ATC_RAT_YAW_I" documentation="Yaw axis rate controller I gain. Corrects long-term difference in desired yaw rate vs actual yaw rate" user="Standard">
<field name="Range">0.0 0.05</field>
<field name="Increment">0.01</field>
</param>
<param humanName="Yaw axis rate controller I gain maximum" name="ATC_RAT_YAW_IMAX" documentation="Yaw axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output" user="Standard">
<field name="Range">0 1</field>
<field name="Increment">0.01</field>
<field name="Units">%</field>
<field name="UnitText">percent</field>
</param>
<param humanName="Yaw axis rate controller D gain" name="ATC_RAT_YAW_D" documentation="Yaw axis rate controller D gain. Compensates for short-term change in desired yaw rate vs actual yaw rate" user="Standard">
<field name="Range">0.000 0.02</field>
<field name="Increment">0.001</field>
</param>
<param humanName="Yaw axis rate controller feed forward" name="ATC_RAT_YAW_FF" documentation="Yaw axis rate controller feed forward" user="Standard">
<field name="Range">0 0.5</field>
<field name="Increment">0.001</field>
</param>
<param humanName="Yaw axis rate controller input frequency in Hz" name="ATC_RAT_YAW_FILT" documentation="Yaw axis rate controller input frequency in Hz" user="Standard">
<field name="Range">1 100</field>
<field name="Increment">1</field>
<field name="Units">Hz</field>
<field name="UnitText">hertz</field>
</param>
<param humanName="Throttle Mix Minimum" name="ATC_THR_MIX_MIN" documentation="Throttle vs attitude control prioritisation used when landing (higher values mean we prioritise attitude control over throttle)" user="Advanced">
<field name="Range">0.1 0.25</field>
</param>
<param humanName="Throttle Mix Maximum" name="ATC_THR_MIX_MAX" documentation="Throttle vs attitude control prioritisation used during active flight (higher values mean we prioritise attitude control over throttle)" user="Advanced">
<field name="Range">0.5 0.9</field>
</param>
<param humanName="Throttle Mix Manual" name="ATC_THR_MIX_MAN" documentation="Throttle vs attitude control prioritisation used during manual flight (higher values mean we prioritise attitude control over throttle)" user="Advanced">
<field name="Range">0.5 0.9</field>
</param>
</parameters>
<parameters name="AVOID_">
<param humanName="Avoidance control enable/disable" name="AVOID_ENABLE" documentation="Enabled/disable stopping at fence" user="Standard">
<field name="Bitmask">0:StopAtFence,1:UseProximitySensor,2:StopAtBeaconFence</field>
<values>
<value code="0">None</value>
<value code="1">StopAtFence</value>
<value code="2">UseProximitySensor</value>
<value code="3">StopAtFence and UseProximitySensor</value>
<value code="4">StopAtBeaconFence</value>
<value code="7">All</value>
</values>
</param>
<param humanName="Avoidance max lean angle in non-GPS flight modes" name="AVOID_ANGLE_MAX" documentation="Max lean angle used to avoid obstacles while in non-GPS modes" user="Standard">
<field name="Range">0 4500</field>
<field name="Units">cdeg</field>
<field name="UnitText">centidegrees</field>
</param>
<param humanName="Avoidance distance maximum in non-GPS flight modes" name="AVOID_DIST_MAX" documentation="Distance from object at which obstacle avoidance will begin in non-GPS modes" user="Standard">
<field name="Range">1 30</field>
<field name="Units">m</field>
<field name="UnitText">meters</field>
</param>
<param humanName="Avoidance distance margin in GPS modes" name="AVOID_MARGIN" documentation="Vehicle will attempt to stay at least this distance (in meters) from objects while in GPS modes" user="Standard">
<field name="Range">1 10</field>
<field name="Units">m</field>
<field name="UnitText">meters</field>
</param>
<param humanName="Avoidance behaviour" name="AVOID_BEHAVE" documentation="Avoidance behaviour (slide or stop)" user="Standard">
<values>
<value code="0">Slide</value>
<value code="1">Stop</value>
</values>
</param>
</parameters>
<parameters name="BATT2_">
<param humanName="Battery monitoring" name="BATT2_MONITOR" documentation="Controls enabling monitoring of the battery's voltage and current" user="Standard">
<values>
<value code="0">Disabled</value>
<value code="3">Analog Voltage Only</value>
<value code="4">Analog Voltage and Current</value>
<value code="5">Solo</value>
<value code="6">Bebop</value>
<value code="7">SMBus-Maxell</value>
<value code="8">UAVCAN-BatteryInfo</value>
<value code="9">BLHeli ESC</value>
<value code="10">SumOfFollowing</value>
<value code="11">FuelFlow</value>
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Battery Voltage sensing pin" name="BATT2_VOLT_PIN" documentation="Sets the analog input pin that should be used for voltage monitoring." user="Standard">
<values>
<value code="-1">Disabled</value>
<value code=" 2">Pixhawk/Pixracer/Navio2/Pixhawk2_PM1</value>
<value code=" 13">Pixhawk2_PM2</value>
<value code=" 100">PX4-v1</value>
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Battery Current sensing pin" name="BATT2_CURR_PIN" documentation="Sets the analog input pin that should be used for current monitoring." user="Standard">
<values>
<value code="-1">Disabled</value>
<value code=" 3">Pixhawk/Pixracer/Navio2/Pixhawk2_PM1</value>
<value code=" 14">Pixhawk2_PM2</value>
<value code=" 101">PX4-v1</value>
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Voltage Multiplier" name="BATT2_VOLT_MULT" documentation="Used to convert the voltage of the voltage sensing pin (BATT2_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1." user="Advanced">
</param>
<param humanName="Amps per volt" name="BATT2_AMP_PERVLT" documentation="Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17." user="Standard">
<field name="Units">A/V</field>
<field name="UnitText">ampere per volt</field>
</param>
<param humanName="AMP offset" name="BATT2_AMP_OFFSET" documentation="Voltage offset at zero current on current sensor" user="Standard">
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Battery capacity" name="BATT2_CAPACITY" documentation="Capacity of the battery in mAh when full" user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Maximum allowed power (Watts)" name="BATT2_WATT_MAX" documentation="If battery wattage (voltage * current) exceeds this value then the system will reduce max throttle (THR_MAX, TKOFF_THR_MAX and THR_MIN for reverse thrust) to satisfy this limit. This helps limit high current to low C rated batteries regardless of battery voltage. The max throttle will slowly grow back to THR_MAX (or TKOFF_THR_MAX ) and THR_MIN if demanding the current max and under the watt max. Use 0 to disable." user="Advanced">
<field name="Increment">1</field>
<field name="Units">W</field>
<field name="UnitText">watt</field>
</param>
<param humanName="Battery serial number" name="BATT2_SERIAL_NUM" documentation="Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With UAVCAN it is the battery_id." user="Advanced">
</param>
<param humanName="Low voltage timeout" name="BATT2_LOW_TIMER" documentation="This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors." user="Advanced">
<field name="Range">0 120</field>
<field name="Increment">1</field>
<field name="Units">s</field>
<field name="UnitText">seconds</field>
</param>
<param humanName="Failsafe voltage source" name="BATT2_FS_VOLTSRC" documentation="Voltage type used for detection of low voltage event" user="Advanced">
<values>
<value code="0">Raw Voltage</value>
<value code=" 1">Sag Compensated Voltage</value>
</values>
</param>
<param humanName="Low battery voltage" name="BATT2_LOW_VOLT" documentation="Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT2_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT2_FS_LOW_ACT parameter." user="Standard">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Low battery capacity" name="BATT2_LOW_MAH" documentation="Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT2_FS_LOW_ACT parameter." user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Critical battery voltage" name="BATT2_CRT_VOLT" documentation="Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT2_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT2_FS_CRT_ACT parameter." user="Standard">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Battery critical capacity" name="BATT2_CRT_MAH" documentation="Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT2__FS_CRT_ACT parameter." user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Low battery failsafe action" name="BATT2_FS_LOW_ACT" documentation="What action the vehicle should perform if it hits a low battery failsafe" user="Standard">
<values>
<value code="0">None</value>
<value code="2">Disarm</value>
<value code="3">Enter surface mode</value>
</values>
</param>
<param humanName="Critical battery failsafe action" name="BATT2_FS_CRT_ACT" documentation="What action the vehicle should perform if it hits a critical battery failsafe" user="Standard">
<values>
<value code="0">None</value>
<value code="2">Disarm</value>
<value code="3">Enter surface mode</value>
</values>
</param>
<param humanName="Required arming voltage" name="BATT2_ARM_VOLT" documentation="Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage." user="Advanced">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Required arming remaining capacity" name="BATT2_ARM_MAH" documentation="Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT2__ARM_VOLT parameter." user="Advanced">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
</parameters>
<parameters name="BATT3_">
<param humanName="Battery monitoring" name="BATT3_MONITOR" documentation="Controls enabling monitoring of the battery's voltage and current" user="Standard">
<values>
<value code="0">Disabled</value>
<value code="3">Analog Voltage Only</value>
<value code="4">Analog Voltage and Current</value>
<value code="5">Solo</value>
<value code="6">Bebop</value>
<value code="7">SMBus-Maxell</value>
<value code="8">UAVCAN-BatteryInfo</value>
<value code="9">BLHeli ESC</value>
<value code="10">SumOfFollowing</value>
<value code="11">FuelFlow</value>
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Battery Voltage sensing pin" name="BATT3_VOLT_PIN" documentation="Sets the analog input pin that should be used for voltage monitoring." user="Standard">
<values>
<value code="-1">Disabled</value>
<value code=" 2">Pixhawk/Pixracer/Navio2/Pixhawk2_PM1</value>
<value code=" 13">Pixhawk2_PM2</value>
<value code=" 100">PX4-v1</value>
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Battery Current sensing pin" name="BATT3_CURR_PIN" documentation="Sets the analog input pin that should be used for current monitoring." user="Standard">
<values>
<value code="-1">Disabled</value>
<value code=" 3">Pixhawk/Pixracer/Navio2/Pixhawk2_PM1</value>
<value code=" 14">Pixhawk2_PM2</value>
<value code=" 101">PX4-v1</value>
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Voltage Multiplier" name="BATT3_VOLT_MULT" documentation="Used to convert the voltage of the voltage sensing pin (BATT3_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1." user="Advanced">
</param>
<param humanName="Amps per volt" name="BATT3_AMP_PERVLT" documentation="Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17." user="Standard">
<field name="Units">A/V</field>
<field name="UnitText">ampere per volt</field>
</param>
<param humanName="AMP offset" name="BATT3_AMP_OFFSET" documentation="Voltage offset at zero current on current sensor" user="Standard">
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Battery capacity" name="BATT3_CAPACITY" documentation="Capacity of the battery in mAh when full" user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Maximum allowed power (Watts)" name="BATT3_WATT_MAX" documentation="If battery wattage (voltage * current) exceeds this value then the system will reduce max throttle (THR_MAX, TKOFF_THR_MAX and THR_MIN for reverse thrust) to satisfy this limit. This helps limit high current to low C rated batteries regardless of battery voltage. The max throttle will slowly grow back to THR_MAX (or TKOFF_THR_MAX ) and THR_MIN if demanding the current max and under the watt max. Use 0 to disable." user="Advanced">
<field name="Increment">1</field>
<field name="Units">W</field>
<field name="UnitText">watt</field>
</param>
<param humanName="Battery serial number" name="BATT3_SERIAL_NUM" documentation="Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With UAVCAN it is the battery_id." user="Advanced">
</param>
<param humanName="Low voltage timeout" name="BATT3_LOW_TIMER" documentation="This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors." user="Advanced">
<field name="Range">0 120</field>
<field name="Increment">1</field>
<field name="Units">s</field>
<field name="UnitText">seconds</field>
</param>
<param humanName="Failsafe voltage source" name="BATT3_FS_VOLTSRC" documentation="Voltage type used for detection of low voltage event" user="Advanced">
<values>
<value code="0">Raw Voltage</value>
<value code=" 1">Sag Compensated Voltage</value>
</values>
</param>
<param humanName="Low battery voltage" name="BATT3_LOW_VOLT" documentation="Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT3_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT3_FS_LOW_ACT parameter." user="Standard">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Low battery capacity" name="BATT3_LOW_MAH" documentation="Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT3_FS_LOW_ACT parameter." user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Critical battery voltage" name="BATT3_CRT_VOLT" documentation="Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT3_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT3_FS_CRT_ACT parameter." user="Standard">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Battery critical capacity" name="BATT3_CRT_MAH" documentation="Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT3__FS_CRT_ACT parameter." user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Low battery failsafe action" name="BATT3_FS_LOW_ACT" documentation="What action the vehicle should perform if it hits a low battery failsafe" user="Standard">
<values>
<value code="0">None</value>
<value code="2">Disarm</value>
<value code="3">Enter surface mode</value>
</values>
</param>
<param humanName="Critical battery failsafe action" name="BATT3_FS_CRT_ACT" documentation="What action the vehicle should perform if it hits a critical battery failsafe" user="Standard">
<values>
<value code="0">None</value>
<value code="2">Disarm</value>
<value code="3">Enter surface mode</value>
</values>
</param>
<param humanName="Required arming voltage" name="BATT3_ARM_VOLT" documentation="Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage." user="Advanced">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Required arming remaining capacity" name="BATT3_ARM_MAH" documentation="Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT3__ARM_VOLT parameter." user="Advanced">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
</parameters>
<parameters name="BATT4_">
<param humanName="Battery monitoring" name="BATT4_MONITOR" documentation="Controls enabling monitoring of the battery's voltage and current" user="Standard">
<values>
<value code="0">Disabled</value>
<value code="3">Analog Voltage Only</value>
<value code="4">Analog Voltage and Current</value>
<value code="5">Solo</value>
<value code="6">Bebop</value>
<value code="7">SMBus-Maxell</value>
<value code="8">UAVCAN-BatteryInfo</value>
<value code="9">BLHeli ESC</value>
<value code="10">SumOfFollowing</value>
<value code="11">FuelFlow</value>
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Battery Voltage sensing pin" name="BATT4_VOLT_PIN" documentation="Sets the analog input pin that should be used for voltage monitoring." user="Standard">
<values>
<value code="-1">Disabled</value>
<value code=" 2">Pixhawk/Pixracer/Navio2/Pixhawk2_PM1</value>
<value code=" 13">Pixhawk2_PM2</value>
<value code=" 100">PX4-v1</value>
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Battery Current sensing pin" name="BATT4_CURR_PIN" documentation="Sets the analog input pin that should be used for current monitoring." user="Standard">
<values>
<value code="-1">Disabled</value>
<value code=" 3">Pixhawk/Pixracer/Navio2/Pixhawk2_PM1</value>
<value code=" 14">Pixhawk2_PM2</value>
<value code=" 101">PX4-v1</value>
</values>
<field name="RebootRequired">True</field>
</param>
<param humanName="Voltage Multiplier" name="BATT4_VOLT_MULT" documentation="Used to convert the voltage of the voltage sensing pin (BATT4_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1." user="Advanced">
</param>
<param humanName="Amps per volt" name="BATT4_AMP_PERVLT" documentation="Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17." user="Standard">
<field name="Units">A/V</field>
<field name="UnitText">ampere per volt</field>
</param>
<param humanName="AMP offset" name="BATT4_AMP_OFFSET" documentation="Voltage offset at zero current on current sensor" user="Standard">
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Battery capacity" name="BATT4_CAPACITY" documentation="Capacity of the battery in mAh when full" user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Maximum allowed power (Watts)" name="BATT4_WATT_MAX" documentation="If battery wattage (voltage * current) exceeds this value then the system will reduce max throttle (THR_MAX, TKOFF_THR_MAX and THR_MIN for reverse thrust) to satisfy this limit. This helps limit high current to low C rated batteries regardless of battery voltage. The max throttle will slowly grow back to THR_MAX (or TKOFF_THR_MAX ) and THR_MIN if demanding the current max and under the watt max. Use 0 to disable." user="Advanced">
<field name="Increment">1</field>
<field name="Units">W</field>
<field name="UnitText">watt</field>
</param>
<param humanName="Battery serial number" name="BATT4_SERIAL_NUM" documentation="Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With UAVCAN it is the battery_id." user="Advanced">
</param>
<param humanName="Low voltage timeout" name="BATT4_LOW_TIMER" documentation="This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors." user="Advanced">
<field name="Range">0 120</field>
<field name="Increment">1</field>
<field name="Units">s</field>
<field name="UnitText">seconds</field>
</param>
<param humanName="Failsafe voltage source" name="BATT4_FS_VOLTSRC" documentation="Voltage type used for detection of low voltage event" user="Advanced">
<values>
<value code="0">Raw Voltage</value>
<value code=" 1">Sag Compensated Voltage</value>
</values>
</param>
<param humanName="Low battery voltage" name="BATT4_LOW_VOLT" documentation="Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT4_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT4_FS_LOW_ACT parameter." user="Standard">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Low battery capacity" name="BATT4_LOW_MAH" documentation="Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT4_FS_LOW_ACT parameter." user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Critical battery voltage" name="BATT4_CRT_VOLT" documentation="Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT4_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT4_FS_CRT_ACT parameter." user="Standard">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Battery critical capacity" name="BATT4_CRT_MAH" documentation="Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT4__FS_CRT_ACT parameter." user="Standard">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
<param humanName="Low battery failsafe action" name="BATT4_FS_LOW_ACT" documentation="What action the vehicle should perform if it hits a low battery failsafe" user="Standard">
<values>
<value code="0">None</value>
<value code="2">Disarm</value>
<value code="3">Enter surface mode</value>
</values>
</param>
<param humanName="Critical battery failsafe action" name="BATT4_FS_CRT_ACT" documentation="What action the vehicle should perform if it hits a critical battery failsafe" user="Standard">
<values>
<value code="0">None</value>
<value code="2">Disarm</value>
<value code="3">Enter surface mode</value>
</values>
</param>
<param humanName="Required arming voltage" name="BATT4_ARM_VOLT" documentation="Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage." user="Advanced">
<field name="Increment">0.1</field>
<field name="Units">V</field>
<field name="UnitText">volt</field>
</param>
<param humanName="Required arming remaining capacity" name="BATT4_ARM_MAH" documentation="Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT4__ARM_VOLT parameter." user="Advanced">
<field name="Increment">50</field>
<field name="Units">mAh</field>
<field name="UnitText">milliampere hour</field>
</param>
</parameters>
<parameters name="BATT5_">
<param humanName="Battery monitoring" name="BATT5_MONITOR" documentation="Controls enabling monitoring of the battery's voltage and current" user="Standard">
<values>
<value code="0">Disabled</value>
<value code="3">Analog Voltage Only</value>
<value code="4">Analog Voltage and Current</value>
<value code="5">Solo</value>
<value code="6">Bebop</value>
<value code="7">SMBus-Maxell</value>