This is a complete list of the parameters which can be set (e.g. via the MAVLink protocol) to control vehicle behaviour. They are stored in persistent storage on the vehicle.
This list is automatically generated from the latest ardupilot source code, and so may contain parameters which are not yet in the stable released versions of the code.
ArduCopter Parameters
SYSID_THISMAV: MAVLink system ID of this vehicle
Note: This parameter is for advanced users
Allows setting an individual MAVLink system id for this vehicle to distinguish it from others on the same network
SYSID_MYGCS: My ground station number
Note: This parameter is for advanced users
Allows restricting radio overrides to only come from my ground station
Values |
Value |
Meaning |
255 |
Mission Planner and DroidPlanner |
252 |
AP Planner 2 |
|
PILOT_THR_FILT: Throttle filter cutoff
Note: This parameter is for advanced users
Throttle filter cutoff (Hz) - active whenever altitude control is inactive - 0 to disable
Range |
Increment |
Units |
0 - 10 |
.5 |
hertz |
PILOT_TKOFF_ALT: Pilot takeoff altitude
Altitude that altitude control modes will climb to when a takeoff is triggered with the throttle stick.
Range |
Increment |
Units |
0.0 - 1000.0 |
10 |
centimeters |
PILOT_TKOFF_DZ: Takeoff trigger deadzone
Offset from mid stick at which takeoff is triggered
Range |
Increment |
0 - 500 |
10 |
PILOT_THR_BHV: Throttle stick behavior
Bitmask containing various throttle stick options. Add up the values for options that you want.
Bitmask |
Values |
Bit |
Meaning |
0 |
Feedback from mid stick |
1 |
High throttle cancels landing |
2 |
Disarm on land detection |
|
Value |
Meaning |
0 |
None |
1 |
Feedback from mid stick |
2 |
High throttle cancels landing |
4 |
Disarm on land detection |
|
TELEM_DELAY: Telemetry startup delay
Note: This parameter is for advanced users
The amount of time (in seconds) to delay radio telemetry to prevent an Xbee bricking on power up
Range |
Increment |
Units |
0 - 30 |
1 |
seconds |
GCS_PID_MASK: GCS PID tuning mask
Note: This parameter is for advanced users
bitmask of PIDs to send MAVLink PID_TUNING messages for
Bitmask |
Values |
Bit |
Meaning |
0 |
Roll |
1 |
Pitch |
2 |
Yaw |
|
Value |
Meaning |
0 |
None |
1 |
Roll |
2 |
Pitch |
4 |
Yaw |
|
RTL_ALT: RTL Altitude
The minimum relative altitude the model will move to before Returning to Launch. Set to zero to return at current altitude.
Range |
Increment |
Units |
0 - 8000 |
1 |
centimeters |
RTL_CONE_SLOPE: RTL cone slope
Defines a cone above home which determines maximum climb
Range |
Values |
Increment |
0.5 - 10.0 |
Value |
Meaning |
0 |
Disabled |
1 |
Shallow |
3 |
Steep |
|
.1 |
RTL_SPEED: RTL speed
Defines the speed in cm/s which the aircraft will attempt to maintain horizontally while flying home. If this is set to zero, WPNAV_SPEED will be used instead.
Range |
Increment |
Units |
0 - 2000 |
50 |
centimeters per second |
RTL_ALT_FINAL: RTL Final Altitude
This is the altitude the vehicle will move to as the final stage of Returning to Launch or after completing a mission. Set to zero to land.
Range |
Increment |
Units |
-1 - 1000 |
1 |
centimeters |
RTL_CLIMB_MIN: RTL minimum climb
The vehicle will climb this many cm during the initial climb portion of the RTL
Range |
Increment |
Units |
0 - 3000 |
10 |
centimeters |
RTL_LOIT_TIME: RTL loiter time
Time (in milliseconds) to loiter above home before beginning final descent
Range |
Increment |
Units |
0 - 60000 |
1000 |
milliseconds |
RNGFND_GAIN: Rangefinder gain
Used to adjust the speed with which the target altitude is changed when objects are sensed below the copter
Range |
Increment |
0.01 - 2.0 |
0.01 |
FS_GCS_ENABLE: Ground Station Failsafe Enable
Controls whether failsafe will be invoked (and what action to take) when connection with Ground station is lost for at least 5 seconds. NB. The GCS Failsafe is only active when RC_OVERRIDE is being used to control the vehicle.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled always RTL |
2 |
Enabled Continue with Mission in Auto Mode |
3 |
Enabled always SmartRTL or RTL |
4 |
Enabled always SmartRTL or Land |
|
GPS_HDOP_GOOD: GPS Hdop Good
Note: This parameter is for advanced users
GPS Hdop value at or below this value represent a good position. Used for pre-arm checks
MAG_ENABLE: Compass enable/disable
Setting this to Enabled(1) will enable the compass. Setting this to Disabled(0) will disable the compass
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
SUPER_SIMPLE: Super Simple Mode
Bitmask to enable Super Simple mode for some flight modes. Setting this to Disabled(0) will disable Super Simple Mode
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Mode1 |
2 |
Mode2 |
3 |
Mode1+2 |
4 |
Mode3 |
5 |
Mode1+3 |
6 |
Mode2+3 |
7 |
Mode1+2+3 |
8 |
Mode4 |
9 |
Mode1+4 |
10 |
Mode2+4 |
11 |
Mode1+2+4 |
12 |
Mode3+4 |
13 |
Mode1+3+4 |
14 |
Mode2+3+4 |
15 |
Mode1+2+3+4 |
16 |
Mode5 |
17 |
Mode1+5 |
18 |
Mode2+5 |
19 |
Mode1+2+5 |
20 |
Mode3+5 |
21 |
Mode1+3+5 |
22 |
Mode2+3+5 |
23 |
Mode1+2+3+5 |
24 |
Mode4+5 |
25 |
Mode1+4+5 |
26 |
Mode2+4+5 |
27 |
Mode1+2+4+5 |
28 |
Mode3+4+5 |
29 |
Mode1+3+4+5 |
30 |
Mode2+3+4+5 |
31 |
Mode1+2+3+4+5 |
32 |
Mode6 |
33 |
Mode1+6 |
34 |
Mode2+6 |
35 |
Mode1+2+6 |
36 |
Mode3+6 |
37 |
Mode1+3+6 |
38 |
Mode2+3+6 |
39 |
Mode1+2+3+6 |
40 |
Mode4+6 |
41 |
Mode1+4+6 |
42 |
Mode2+4+6 |
43 |
Mode1+2+4+6 |
44 |
Mode3+4+6 |
45 |
Mode1+3+4+6 |
46 |
Mode2+3+4+6 |
47 |
Mode1+2+3+4+6 |
48 |
Mode5+6 |
49 |
Mode1+5+6 |
50 |
Mode2+5+6 |
51 |
Mode1+2+5+6 |
52 |
Mode3+5+6 |
53 |
Mode1+3+5+6 |
54 |
Mode2+3+5+6 |
55 |
Mode1+2+3+5+6 |
56 |
Mode4+5+6 |
57 |
Mode1+4+5+6 |
58 |
Mode2+4+5+6 |
59 |
Mode1+2+4+5+6 |
60 |
Mode3+4+5+6 |
61 |
Mode1+3+4+5+6 |
62 |
Mode2+3+4+5+6 |
63 |
Mode1+2+3+4+5+6 |
|
WP_YAW_BEHAVIOR: Yaw behaviour during missions
Determines how the autopilot controls the yaw during missions and RTL
Values |
Value |
Meaning |
0 |
Never change yaw |
1 |
Face next waypoint |
2 |
Face next waypoint except RTL |
3 |
Face along GPS course |
|
LAND_SPEED: Land speed
The descent speed for the final stage of landing in cm/s
Range |
Increment |
Units |
30 - 200 |
10 |
centimeters per second |
LAND_SPEED_HIGH: Land speed high
The descent speed for the first stage of landing in cm/s. If this is zero then WPNAV_SPEED_DN is used
Range |
Increment |
Units |
0 - 500 |
10 |
centimeters per second |
PILOT_SPEED_UP: Pilot maximum vertical speed ascending
The maximum vertical ascending velocity the pilot may request in cm/s
Range |
Increment |
Units |
50 - 500 |
10 |
centimeters per second |
PILOT_ACCEL_Z: Pilot vertical acceleration
The vertical acceleration used when pilot is controlling the altitude
Range |
Increment |
Units |
50 - 500 |
10 |
centimeters per square second |
FS_THR_ENABLE: Throttle Failsafe Enable
The throttle failsafe allows you to configure a software failsafe activated by a setting on the throttle input channel
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled always RTL |
2 |
Enabled Continue with Mission in Auto Mode |
3 |
Enabled always Land |
4 |
Enabled always SmartRTL or RTL |
5 |
Enabled always SmartRTL or Land |
|
FS_THR_VALUE: Throttle Failsafe Value
The PWM level in microseconds on channel 3 below which throttle failsafe triggers
Range |
Increment |
Units |
925 - 1100 |
1 |
PWM in microseconds |
THR_DZ: Throttle deadzone
The deadzone above and below mid throttle in PWM microseconds. Used in AltHold, Loiter, PosHold flight modes
Range |
Increment |
Units |
0 - 300 |
1 |
PWM in microseconds |
FLTMODE1: Flight Mode 1
Flight mode when Channel 5 pwm is <= 1230
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
Smart_RTL |
22 |
FlowHold |
23 |
Follow |
|
FLTMODE2: Flight Mode 2
Flight mode when Channel 5 pwm is >1230, <= 1360
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
Smart_RTL |
22 |
FlowHold |
23 |
Follow |
|
FLTMODE3: Flight Mode 3
Flight mode when Channel 5 pwm is >1360, <= 1490
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
Smart_RTL |
22 |
FlowHold |
23 |
Follow |
|
FLTMODE4: Flight Mode 4
Flight mode when Channel 5 pwm is >1490, <= 1620
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
Smart_RTL |
22 |
FlowHold |
23 |
Follow |
|
FLTMODE5: Flight Mode 5
Flight mode when Channel 5 pwm is >1620, <= 1749
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
Smart_RTL |
22 |
FlowHold |
23 |
Follow |
|
FLTMODE6: Flight Mode 6
Flight mode when Channel 5 pwm is >=1750
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
Smart_RTL |
22 |
FlowHold |
23 |
Follow |
|
FLTMODE_CH: Flightmode channel
Note: This parameter is for advanced users
RC Channel to use for flight mode control
Values |
Value |
Meaning |
0 |
Disabled |
5 |
Channel5 |
6 |
Channel6 |
7 |
Channel7 |
8 |
Channel8 |
|
SIMPLE: Simple mode bitmask
Note: This parameter is for advanced users
Bitmask which holds which flight modes use simple heading mode (eg bit 0 = 1 means Flight Mode 0 uses simple mode)
LOG_BITMASK: Log bitmask
4 byte bitmap of log types to enable
Bitmask |
Values |
Bit |
Meaning |
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 |
|
Value |
Meaning |
830 |
Default |
894 |
Default+RCIN |
958 |
Default+IMU |
1854 |
Default+Motors |
-6146 |
NearlyAll-AC315 |
45054 |
NearlyAll |
131071 |
All+FastATT |
262142 |
All+MotBatt |
393214 |
All+FastIMU |
397310 |
All+FastIMU+PID |
655358 |
All+FullIMU |
0 |
Disabled |
|
ESC_CALIBRATION: ESC Calibration
Note: This parameter is for advanced users
Controls whether ArduCopter will enter ESC calibration on the next restart. Do not adjust this parameter manually.
Values |
Value |
Meaning |
0 |
Normal Start-up |
1 |
Start-up in ESC Calibration mode if throttle high |
2 |
Start-up in ESC Calibration mode regardless of throttle |
3 |
Start-up and automatically calibrate ESCs |
9 |
Disabled |
|
TUNE: Channel 6 Tuning
Controls which parameters (normally PID gains) are being tuned with transmitter’s channel 6 knob
Values |
Value |
Meaning |
0 |
None |
1 |
Stab Roll/Pitch kP |
4 |
Rate Roll/Pitch kP |
5 |
Rate Roll/Pitch kI |
21 |
Rate Roll/Pitch kD |
3 |
Stab Yaw kP |
6 |
Rate Yaw kP |
26 |
Rate Yaw kD |
56 |
Rate Yaw Filter |
55 |
Motor Yaw Headroom |
14 |
AltHold kP |
7 |
Throttle Rate kP |
34 |
Throttle Accel kP |
35 |
Throttle Accel kI |
36 |
Throttle Accel kD |
12 |
Loiter Pos kP |
22 |
Velocity XY kP |
28 |
Velocity XY kI |
10 |
WP Speed |
25 |
Acro RollPitch kP |
40 |
Acro Yaw kP |
45 |
RC Feel |
13 |
Heli Ext Gyro |
38 |
Declination |
39 |
Circle Rate |
41 |
RangeFinder Gain |
46 |
Rate Pitch kP |
47 |
Rate Pitch kI |
48 |
Rate Pitch kD |
49 |
Rate Roll kP |
50 |
Rate Roll kI |
51 |
Rate Roll kD |
52 |
Rate Pitch FF |
53 |
Rate Roll FF |
54 |
Rate Yaw FF |
57 |
Winch |
|
TUNE_LOW: Tuning minimum
The minimum value that will be applied to the parameter currently being tuned with the transmitter’s channel 6 knob
TUNE_HIGH: Tuning maximum
The maximum value that will be applied to the parameter currently being tuned with the transmitter’s channel 6 knob
FRAME_TYPE: Frame Type (+, X, V, etc)
Controls motor mixing for multicopters. Not used for Tri or Traditional Helicopters.
Values |
RebootRequired |
Value |
Meaning |
0 |
Plus |
1 |
X |
2 |
V |
3 |
H |
4 |
V-Tail |
5 |
A-Tail |
10 |
Y6B |
|
True |
CH7_OPT: Channel 7 option
Select which function is performed when CH7 is above 1800 pwm
Values |
Value |
Meaning |
0 |
Do Nothing |
2 |
Flip |
3 |
Simple Mode |
4 |
RTL |
5 |
Save Trim |
7 |
Save WP |
9 |
Camera Trigger |
10 |
RangeFinder |
11 |
Fence |
13 |
Super Simple Mode |
14 |
Acro Trainer |
15 |
Sprayer |
16 |
Auto |
17 |
AutoTune |
18 |
Land |
19 |
Gripper |
21 |
Parachute Enable |
22 |
Parachute Release |
23 |
Parachute 3pos |
24 |
Auto Mission Reset |
25 |
AttCon Feed Forward |
26 |
AttCon Accel Limits |
27 |
Retract Mount |
28 |
Relay On/Off |
34 |
Relay2 On/Off |
35 |
Relay3 On/Off |
36 |
Relay4 On/Off |
29 |
Landing Gear |
30 |
Lost Copter Sound |
31 |
Motor Emergency Stop |
32 |
Motor Interlock |
33 |
Brake |
37 |
Throw |
38 |
ADSB-Avoidance |
39 |
PrecLoiter |
40 |
Object Avoidance |
41 |
ArmDisarm |
42 |
SmartRTL |
43 |
InvertedFlight |
44 |
Winch Enable |
45 |
WinchControl |
100 |
KillIMU1 |
101 |
KillIMU2 |
|
CH8_OPT: Channel 8 option
Select which function is performed when CH8 is above 1800 pwm
Values |
Value |
Meaning |
0 |
Do Nothing |
2 |
Flip |
3 |
Simple Mode |
4 |
RTL |
5 |
Save Trim |
7 |
Save WP |
9 |
Camera Trigger |
10 |
RangeFinder |
11 |
Fence |
13 |
Super Simple Mode |
14 |
Acro Trainer |
15 |
Sprayer |
16 |
Auto |
17 |
AutoTune |
18 |
Land |
19 |
Gripper |
21 |
Parachute Enable |
22 |
Parachute Release |
23 |
Parachute 3pos |
24 |
Auto Mission Reset |
25 |
AttCon Feed Forward |
26 |
AttCon Accel Limits |
27 |
Retract Mount |
28 |
Relay On/Off |
34 |
Relay2 On/Off |
35 |
Relay3 On/Off |
36 |
Relay4 On/Off |
29 |
Landing Gear |
30 |
Lost Copter Sound |
31 |
Motor Emergency Stop |
32 |
Motor Interlock |
33 |
Brake |
37 |
Throw |
38 |
ADSB-Avoidance |
39 |
PrecLoiter |
40 |
Object Avoidance |
41 |
ArmDisarm |
42 |
SmartRTL |
43 |
InvertedFlight |
44 |
Winch Enable |
45 |
WinchControl |
100 |
KillIMU1 |
101 |
KillIMU2 |
|
CH9_OPT: Channel 9 option
Select which function is performed when CH9 is above 1800 pwm
Values |
Value |
Meaning |
0 |
Do Nothing |
2 |
Flip |
3 |
Simple Mode |
4 |
RTL |
5 |
Save Trim |
7 |
Save WP |
9 |
Camera Trigger |
10 |
RangeFinder |
11 |
Fence |
13 |
Super Simple Mode |
14 |
Acro Trainer |
15 |
Sprayer |
16 |
Auto |
17 |
AutoTune |
18 |
Land |
19 |
Gripper |
21 |
Parachute Enable |
22 |
Parachute Release |
23 |
Parachute 3pos |
24 |
Auto Mission Reset |
25 |
AttCon Feed Forward |
26 |
AttCon Accel Limits |
27 |
Retract Mount |
28 |
Relay On/Off |
34 |
Relay2 On/Off |
35 |
Relay3 On/Off |
36 |
Relay4 On/Off |
29 |
Landing Gear |
30 |
Lost Copter Sound |
31 |
Motor Emergency Stop |
32 |
Motor Interlock |
33 |
Brake |
37 |
Throw |
38 |
ADSB-Avoidance |
39 |
PrecLoiter |
40 |
Object Avoidance |
41 |
ArmDisarm |
42 |
SmartRTL |
43 |
InvertedFlight |
44 |
Winch Enable |
45 |
WinchControl |
100 |
KillIMU1 |
101 |
KillIMU2 |
|
CH10_OPT: Channel 10 option
Select which function is performed when CH10 is above 1800 pwm
Values |
Value |
Meaning |
0 |
Do Nothing |
2 |
Flip |
3 |
Simple Mode |
4 |
RTL |
5 |
Save Trim |
7 |
Save WP |
9 |
Camera Trigger |
10 |
RangeFinder |
11 |
Fence |
13 |
Super Simple Mode |
14 |
Acro Trainer |
15 |
Sprayer |
16 |
Auto |
17 |
AutoTune |
18 |
Land |
19 |
Gripper |
21 |
Parachute Enable |
22 |
Parachute Release |
23 |
Parachute 3pos |
24 |
Auto Mission Reset |
25 |
AttCon Feed Forward |
26 |
AttCon Accel Limits |
27 |
Retract Mount |
28 |
Relay On/Off |
34 |
Relay2 On/Off |
35 |
Relay3 On/Off |
36 |
Relay4 On/Off |
29 |
Landing Gear |
30 |
Lost Copter Sound |
31 |
Motor Emergency Stop |
32 |
Motor Interlock |
33 |
Brake |
37 |
Throw |
38 |
ADSB-Avoidance |
39 |
PrecLoiter |
40 |
Object Avoidance |
41 |
ArmDisarm |
42 |
SmartRTL |
43 |
InvertedFlight |
44 |
Winch Enable |
45 |
WinchControl |
100 |
KillIMU1 |
101 |
KillIMU2 |
|
CH11_OPT: Channel 11 option
Select which function is performed when CH11 is above 1800 pwm
Values |
Value |
Meaning |
0 |
Do Nothing |
2 |
Flip |
3 |
Simple Mode |
4 |
RTL |
5 |
Save Trim |
7 |
Save WP |
9 |
Camera Trigger |
10 |
RangeFinder |
11 |
Fence |
13 |
Super Simple Mode |
14 |
Acro Trainer |
15 |
Sprayer |
16 |
Auto |
17 |
AutoTune |
18 |
Land |
19 |
Gripper |
21 |
Parachute Enable |
22 |
Parachute Release |
23 |
Parachute 3pos |
24 |
Auto Mission Reset |
25 |
AttCon Feed Forward |
26 |
AttCon Accel Limits |
27 |
Retract Mount |
28 |
Relay On/Off |
34 |
Relay2 On/Off |
35 |
Relay3 On/Off |
36 |
Relay4 On/Off |
29 |
Landing Gear |
30 |
Lost Copter Sound |
31 |
Motor Emergency Stop |
32 |
Motor Interlock |
33 |
Brake |
37 |
Throw |
38 |
ADSB-Avoidance |
39 |
PrecLoiter |
40 |
Object Avoidance |
41 |
ArmDisarm |
42 |
SmartRTL |
43 |
InvertedFlight |
44 |
Winch Enable |
45 |
WinchControl |
100 |
KillIMU1 |
101 |
KillIMU2 |
|
CH12_OPT: Channel 12 option
Select which function is performed when CH12 is above 1800 pwm
Values |
Value |
Meaning |
0 |
Do Nothing |
2 |
Flip |
3 |
Simple Mode |
4 |
RTL |
5 |
Save Trim |
7 |
Save WP |
9 |
Camera Trigger |
10 |
RangeFinder |
11 |
Fence |
13 |
Super Simple Mode |
14 |
Acro Trainer |
15 |
Sprayer |
16 |
Auto |
17 |
AutoTune |
18 |
Land |
19 |
Gripper |
21 |
Parachute Enable |
22 |
Parachute Release |
23 |
Parachute 3pos |
24 |
Auto Mission Reset |
25 |
AttCon Feed Forward |
26 |
AttCon Accel Limits |
27 |
Retract Mount |
28 |
Relay On/Off |
34 |
Relay2 On/Off |
35 |
Relay3 On/Off |
36 |
Relay4 On/Off |
29 |
Landing Gear |
30 |
Lost Copter Sound |
31 |
Motor Emergency Stop |
32 |
Motor Interlock |
33 |
Brake |
37 |
Throw |
38 |
ADSB-Avoidance |
39 |
PrecLoiter |
40 |
Object Avoidance |
41 |
ArmDisarm |
42 |
SmartRTL |
43 |
InvertedFlight |
44 |
Winch Enable |
45 |
WinchControl |
100 |
KillIMU1 |
101 |
KillIMU2 |
|
DISARM_DELAY: Disarm delay
Note: This parameter is for advanced users
Delay before automatic disarm in seconds. A value of zero disables auto disarm.
Range |
Units |
0 - 127 |
seconds |
ANGLE_MAX: Angle Max
Note: This parameter is for advanced users
Maximum lean angle in all flight modes
Range |
Units |
1000 - 8000 |
centidegrees |
PHLD_BRAKE_RATE: PosHold braking rate
Note: This parameter is for advanced users
PosHold flight mode’s rotation rate during braking in deg/sec
Range |
Units |
4 - 12 |
degrees per second |
PHLD_BRAKE_ANGLE: PosHold braking angle max
Note: This parameter is for advanced users
PosHold flight mode’s max lean angle during braking in centi-degrees
Range |
Units |
2000 - 4500 |
centidegrees |
LAND_REPOSITION: Land repositioning
Note: This parameter is for advanced users
Enables user input during LAND mode, the landing phase of RTL, and auto mode landings.
Values |
Value |
Meaning |
0 |
No repositioning |
1 |
Repositioning |
|
FS_EKF_ACTION: EKF Failsafe Action
Note: This parameter is for advanced users
Controls the action that will be taken when an EKF failsafe is invoked
Values |
Value |
Meaning |
1 |
Land |
2 |
AltHold |
3 |
Land even in Stabilize |
|
FS_EKF_THRESH: EKF failsafe variance threshold
Note: This parameter is for advanced users
Allows setting the maximum acceptable compass and velocity variance
Values |
0.6:Strict, 0.8:Default, 1.0:Relaxed |
FS_CRASH_CHECK: Crash check enable
Note: This parameter is for advanced users
This enables automatic crash checking. When enabled the motors will disarm if a crash is detected.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
RC_SPEED: ESC Update Speed
Note: This parameter is for advanced users
This is the speed in Hertz that your ESCs will receive updates
Range |
Increment |
Units |
50 - 490 |
1 |
hertz |
ACRO_RP_P: Acro Roll and Pitch P gain
Converts pilot roll and pitch into a desired rate of rotation in ACRO and SPORT mode. Higher values mean faster rate of rotation.
ACRO_YAW_P: Acro Yaw P gain
Converts pilot yaw input into a desired rate of rotation in ACRO, Stabilize and SPORT modes. Higher values mean faster rate of rotation.
ACRO_BAL_ROLL: Acro Balance Roll
Note: This parameter is for advanced users
rate at which roll angle returns to level in acro and sport mode. A higher value causes the vehicle to return to level faster.
Range |
Increment |
0 - 3 |
0.1 |
ACRO_BAL_PITCH: Acro Balance Pitch
Note: This parameter is for advanced users
rate at which pitch angle returns to level in acro and sport mode. A higher value causes the vehicle to return to level faster.
Range |
Increment |
0 - 3 |
0.1 |
ACRO_TRAINER: Acro Trainer
Note: This parameter is for advanced users
Type of trainer used in acro mode
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Leveling |
2 |
Leveling and Limited |
|
ACRO_RP_EXPO: Acro Roll/Pitch Expo
Note: This parameter is for advanced users
Acro roll/pitch Expo to allow faster rotation when stick at edges
Range |
Values |
-0.5 - 1.0 |
Value |
Meaning |
0 |
Disabled |
0.1 |
Very Low |
0.2 |
Low |
0.3 |
Medium |
0.4 |
High |
0.5 |
Very High |
|
AUTOTUNE_AXES: Autotune axis bitmask
1-byte bitmap of axes to autotune
Bitmask |
Values |
Bit |
Meaning |
0 |
Roll |
1 |
Pitch |
2 |
Yaw |
|
Value |
Meaning |
7 |
All |
1 |
Roll Only |
2 |
Pitch Only |
4 |
Yaw Only |
3 |
Roll and Pitch |
5 |
Roll and Yaw |
6 |
Pitch and Yaw |
|
AUTOTUNE_AGGR: Autotune aggressiveness
Autotune aggressiveness. Defines the bounce back used to detect size of the D term.
AUTOTUNE_MIN_D: AutoTune minimum D
Defines the minimum D gain
THROW_MOT_START: Start motors before throwing is detected
Used by THROW mode. Controls whether motors will run at the speed set by THR_MIN or will be stopped when armed and waiting for the throw.
Values |
Value |
Meaning |
0 |
Stopped |
1 |
Running |
|
TERRAIN_FOLLOW: Terrain Following use control
This enables terrain following for RTL and LAND 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.
Values |
Value |
Meaning |
0 |
Do Not Use in RTL and Land |
1 |
Use in RTL and Land |
|
WP_NAVALT_MIN: Minimum navigation altitude
This is the altitude in meters above which for navigation can begin. This applies in auto takeoff and auto landing.
THROW_NEXTMODE: Throw mode’s follow up mode
Vehicle will switch to this mode after the throw is successfully completed. Default is to stay in throw mode (18)
Values |
Value |
Meaning |
3 |
Auto |
4 |
Guided |
5 |
LOITER |
6 |
RTL |
9 |
Land |
17 |
Brake |
18 |
Throw |
|
THROW_TYPE: Type of Type
Used by THROW mode. Specifies whether Copter is thrown upward or dropped.
Values |
Value |
Meaning |
0 |
Upward Throw |
1 |
Drop |
|
GND_EFFECT_COMP: Ground Effect Compensation Enable/Disable
Note: This parameter is for advanced users
Ground Effect Compensation Enable/Disable
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
DEV_OPTIONS: Development options
Note: This parameter is for advanced users
Bitmask of developer options. The meanings of the bit fields in this parameter may vary at any time. Developers should check the source code for current meaning
Bitmask |
Bit |
Meaning |
0 |
ADSBMavlinkProcessing |
1 |
DevOptionVFR_HUDRelativeAlt |
|
ACRO_Y_EXPO: Acro Yaw Expo
Note: This parameter is for advanced users
Acro yaw expo to allow faster rotation when stick at edges
Range |
Values |
-0.5 - 1.0 |
Value |
Meaning |
0 |
Disabled |
0.1 |
Very Low |
0.2 |
Low |
0.3 |
Medium |
0.4 |
High |
0.5 |
Very High |
|
ACRO_THR_MID: Acro Thr Mid
Note: This parameter is for advanced users
Acro Throttle Mid
SYSID_ENFORCE: GCS sysid enforcement
Note: This parameter is for advanced users
This controls whether packets from other than the expected GCS system ID will be accepted
Values |
Value |
Meaning |
0 |
NotEnforced |
1 |
Enforced |
|
FRAME_CLASS: Frame Class
Controls major frame class for multicopter component
Values |
RebootRequired |
Value |
Meaning |
0 |
Undefined |
1 |
Quad |
2 |
Hexa |
3 |
Octa |
4 |
OctaQuad |
5 |
Y6 |
6 |
Heli |
7 |
Tri |
8 |
SingleCopter |
9 |
CoaxCopter |
11 |
Heli_Dual |
12 |
DodecaHexa |
13 |
HeliQuad |
|
True |
PILOT_SPEED_DN: Pilot maximum vertical speed descending
The maximum vertical descending velocity the pilot may request in cm/s
Range |
Increment |
Units |
50 - 500 |
10 |
centimeters per second |
LAND_ALT_LOW: Land alt low
Note: This parameter is for advanced users
Altitude during Landing at which vehicle slows to LAND_SPEED
Range |
Increment |
Units |
100 - 10000 |
10 |
centimeters |
AFS_ Parameters
AFS_ENABLE: Enable Advanced Failsafe
Note: This parameter is for advanced users
This enables the advanced failsafe system. If this is set to zero (disable) then all the other AFS options have no effect
AFS_MAN_PIN: Manual Pin
Note: This parameter is for advanced users
This sets a digital output pin to set high when in manual mode
AFS_HB_PIN: Heartbeat Pin
Note: This parameter is for advanced users
This sets a digital output pin which is cycled at 10Hz when termination is not activated. Note that if a FS_TERM_PIN is set then the heartbeat pin will continue to cycle at 10Hz when termination is activated, to allow the termination board to distinguish between autopilot crash and termination.
AFS_WP_COMMS: Comms Waypoint
Note: This parameter is for advanced users
Waypoint number to navigate to on comms loss
AFS_GPS_LOSS: GPS Loss Waypoint
Note: This parameter is for advanced users
Waypoint number to navigate to on GPS lock loss
AFS_TERMINATE: Force Terminate
Note: This parameter is for advanced users
Can be set in flight to force termination of the heartbeat signal
AFS_TERM_ACTION: Terminate action
Note: This parameter is for advanced users
This can be used to force an action on flight termination. Normally this is handled by an external failsafe board, but you can setup APM to handle it here. Please consult the wiki for more information on the possible values of the parameter
AFS_TERM_PIN: Terminate Pin
Note: This parameter is for advanced users
This sets a digital output pin to set high on flight termination
AFS_AMSL_LIMIT: AMSL limit
Note: This parameter is for advanced users
This sets the AMSL (above mean sea level) altitude limit. If the pressure altitude determined by QNH exceeds this limit then flight termination will be forced. Note that this limit is in meters, whereas pressure altitude limits are often quoted in feet. A value of zero disables the pressure altitude limit.
AFS_AMSL_ERR_GPS: Error margin for GPS based AMSL limit
Note: This parameter is for advanced users
This sets margin for error in GPS derived altitude limit. This error margin is only used if the barometer has failed. If the barometer fails then the GPS will be used to enforce the AMSL_LIMIT, but this margin will be subtracted from the AMSL_LIMIT first, to ensure that even with the given amount of GPS altitude error the pressure altitude is not breached. OBC users should set this to comply with their D2 safety case. A value of -1 will mean that barometer failure will lead to immediate termination.
AFS_QNH_PRESSURE: QNH pressure
Note: This parameter is for advanced users
This sets the QNH pressure in millibars to be used for pressure altitude in the altitude limit. A value of zero disables the altitude limit.
AFS_MAX_GPS_LOSS: Maximum number of GPS loss events
Note: This parameter is for advanced users
Maximum number of GPS loss events before the aircraft stops returning to mission on GPS recovery. Use zero to allow for any number of GPS loss events.
AFS_GEOFENCE: Enable geofence Advanced Failsafe
Note: This parameter is for advanced users
This enables the geofence part of the AFS. Will only be in effect if AFS_ENABLE is also 1
AFS_RC: Enable RC Advanced Failsafe
Note: This parameter is for advanced users
This enables the RC part of the AFS. Will only be in effect if AFS_ENABLE is also 1
AFS_RC_MAN_ONLY: Enable RC Termination only in manual control modes
Note: This parameter is for advanced users
If this parameter is set to 1, then an RC loss will only cause the plane to terminate in manual control modes. If it is 0, then the plane will terminate in any flight mode.
AFS_DUAL_LOSS: Enable dual loss terminate due to failure of both GCS and GPS simultaneously
Note: This parameter is for advanced users
This enables the dual loss termination part of the AFS system. If this parameter is 1 and both GPS and the ground control station fail simultaneously, this will be considered a “dual loss” and cause termination.
AFS_RC_FAIL_TIME: RC failure time
Note: This parameter is for advanced users
This is the time in seconds in manual mode that failsafe termination will activate if RC input is lost. For the OBC rules this should be (1.5). Use 0 to disable.
ATC_ Parameters
ATC_SLEW_YAW: Yaw target slew rate
Note: This parameter is for advanced users
Maximum rate the yaw target can be updated in Loiter, RTL, Auto flight modes
Range |
Increment |
Units |
500 - 18000 |
100 |
centidegrees per second |
ATC_ACCEL_Y_MAX: Acceleration Max for Yaw
Note: This parameter is for advanced users
Maximum acceleration in yaw axis
Range |
Values |
Increment |
Units |
0 - 72000 |
Value |
Meaning |
0 |
Disabled |
9000 |
VerySlow |
18000 |
Slow |
36000 |
Medium |
54000 |
Fast |
|
1000 |
centidegrees per square second |
ATC_RATE_FF_ENAB: Rate Feedforward Enable
Note: This parameter is for advanced users
Controls whether body-frame rate feedfoward is enabled or disabled
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
ATC_ACCEL_R_MAX: Acceleration Max for Roll
Note: This parameter is for advanced users
Maximum acceleration in roll axis
Range |
Values |
Increment |
Units |
0 - 180000 |
Value |
Meaning |
0 |
Disabled |
30000 |
VerySlow |
72000 |
Slow |
108000 |
Medium |
162000 |
Fast |
|
1000 |
centidegrees per square second |
ATC_ACCEL_P_MAX: Acceleration Max for Pitch
Note: This parameter is for advanced users
Maximum acceleration in pitch axis
Range |
Values |
Increment |
Units |
0 - 180000 |
Value |
Meaning |
0 |
Disabled |
30000 |
VerySlow |
72000 |
Slow |
108000 |
Medium |
162000 |
Fast |
|
1000 |
centidegrees per square second |
ATC_ANGLE_BOOST: Angle Boost
Note: This parameter is for advanced users
Angle Boost increases output throttle as the vehicle leans to reduce loss of altitude
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
ATC_ANG_RLL_P: Roll axis angle controller P gain
Roll axis angle controller P gain. Converts the error between the desired roll angle and actual angle to a desired roll rate
ATC_ANG_PIT_P: Pitch axis angle controller P gain
Pitch axis angle controller P gain. Converts the error between the desired pitch angle and actual angle to a desired pitch rate
ATC_ANG_YAW_P: Yaw axis angle controller P gain
Yaw axis angle controller P gain. Converts the error between the desired yaw angle and actual angle to a desired yaw rate
ATC_ANG_LIM_TC: Angle Limit (to maintain altitude) Time Constant
Note: This parameter is for advanced users
Angle Limit (to maintain altitude) Time Constant
ATC_RATE_R_MAX: Angular Velocity Max for Roll
Note: This parameter is for advanced users
Maximum angular velocity in roll axis
Range |
Values |
Increment |
Units |
0 - 1080 |
Value |
Meaning |
0 |
Disabled |
360 |
Slow |
720 |
Medium |
1080 |
Fast |
|
1 |
degrees per second |
ATC_RATE_P_MAX: Angular Velocity Max for Pitch
Note: This parameter is for advanced users
Maximum angular velocity in pitch axis
Range |
Values |
Increment |
Units |
0 - 1080 |
Value |
Meaning |
0 |
Disabled |
360 |
Slow |
720 |
Medium |
1080 |
Fast |
|
1 |
degrees per second |
ATC_RATE_Y_MAX: Angular Velocity Max for Pitch
Note: This parameter is for advanced users
Maximum angular velocity in pitch axis
Range |
Values |
Increment |
Units |
0 - 1080 |
Value |
Meaning |
0 |
Disabled |
360 |
Slow |
720 |
Medium |
1080 |
Fast |
|
1 |
degrees per second |
ATC_RAT_RLL_P: Roll axis rate controller P gain
Roll axis rate controller P gain. Converts the difference between desired roll rate and actual roll rate into a motor speed output
Range |
Increment |
0.05 - 0.5 |
0.005 |
ATC_RAT_RLL_I: Roll axis rate controller I gain
Roll axis rate controller I gain. Corrects long-term difference in desired roll rate vs actual roll rate
Range |
Increment |
0.01 - 2.0 |
0.01 |
ATC_RAT_RLL_IMAX: Roll axis rate controller I gain maximum
Roll axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output
Range |
Increment |
Units |
0 - 1 |
0.01 |
percent |
ATC_RAT_RLL_D: Roll axis rate controller D gain
Roll axis rate controller D gain. Compensates for short-term change in desired roll rate vs actual roll rate
Range |
Increment |
0.0 - 0.02 |
0.001 |
ATC_RAT_RLL_FF: Roll axis rate controller feed forward
Roll axis rate controller feed forward
Range |
Increment |
0 - 0.5 |
0.001 |
ATC_RAT_PIT_P: Pitch axis rate controller P gain
Pitch axis rate controller P gain. Converts the difference between desired pitch rate and actual pitch rate into a motor speed output
Range |
Increment |
0.05 - 0.50 |
0.005 |
ATC_RAT_PIT_I: Pitch axis rate controller I gain
Pitch axis rate controller I gain. Corrects long-term difference in desired pitch rate vs actual pitch rate
Range |
Increment |
0.01 - 2.0 |
0.01 |
ATC_RAT_PIT_IMAX: Pitch axis rate controller I gain maximum
Pitch axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output
Range |
Increment |
Units |
0 - 1 |
0.01 |
percent |
ATC_RAT_PIT_D: Pitch axis rate controller D gain
Pitch axis rate controller D gain. Compensates for short-term change in desired pitch rate vs actual pitch rate
Range |
Increment |
0.0 - 0.02 |
0.001 |
ATC_RAT_PIT_FF: Pitch axis rate controller feed forward
Pitch axis rate controller feed forward
Range |
Increment |
0 - 0.5 |
0.001 |
ATC_RAT_YAW_P: Yaw axis rate controller P gain
Yaw axis rate controller P gain. Converts the difference between desired yaw rate and actual yaw rate into a motor speed output
Range |
Increment |
0.10 - 2.50 |
0.005 |
ATC_RAT_YAW_I: Yaw axis rate controller I gain
Yaw axis rate controller I gain. Corrects long-term difference in desired yaw rate vs actual yaw rate
Range |
Increment |
0.010 - 1.0 |
0.01 |
ATC_RAT_YAW_IMAX: Yaw axis rate controller I gain maximum
Yaw axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output
Range |
Increment |
Units |
0 - 1 |
0.01 |
percent |
ATC_RAT_YAW_D: Yaw axis rate controller D gain
Yaw axis rate controller D gain. Compensates for short-term change in desired yaw rate vs actual yaw rate
Range |
Increment |
0.000 - 0.02 |
0.001 |
ATC_RAT_YAW_FF: Yaw axis rate controller feed forward
Yaw axis rate controller feed forward
Range |
Increment |
0 - 0.5 |
0.001 |
ATC_THR_MIX_MIN: Throttle Mix Minimum
Note: This parameter is for advanced users
Throttle vs attitude control prioritisation used when landing (higher values mean we prioritise attitude control over throttle)
ATC_THR_MIX_MAX: Throttle Mix Maximum
Note: This parameter is for advanced users
Throttle vs attitude control prioritisation used during active flight (higher values mean we prioritise attitude control over throttle)
ATC_THR_MIX_MAN: Throttle Mix Manual
Note: This parameter is for advanced users
Throttle vs attitude control prioritisation used during manual flight (higher values mean we prioritise attitude control over throttle)
ATC_HOVR_ROL_TRM: Hover Roll Trim
Note: This parameter is for advanced users
Trim the hover roll angle to counter tail rotor thrust in a hover
Range |
Units |
0 - 1000 |
centidegrees |
ATC_RAT_RLL_P: Roll axis rate controller P gain
Roll axis rate controller P gain. Converts the difference between desired roll rate and actual roll rate into a motor speed output
Range |
Increment |
0.08 - 0.35 |
0.005 |
ATC_RAT_RLL_I: Roll axis rate controller I gain
Roll axis rate controller I gain. Corrects long-term difference in desired roll rate vs actual roll rate
Range |
Increment |
0.01 - 0.6 |
0.01 |
ATC_RAT_RLL_IMAX: Roll axis rate controller I gain maximum
Roll axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output
Range |
Increment |
0 - 1 |
0.01 |
ATC_RAT_RLL_D: Roll axis rate controller D gain
Roll axis rate controller D gain. Compensates for short-term change in desired roll rate vs actual roll rate
Range |
Increment |
0.001 - 0.03 |
0.001 |
ATC_RAT_RLL_FF: Roll axis rate controller feed forward
Roll axis rate controller feed forward
Range |
Increment |
0 - 0.5 |
0.001 |
ATC_RAT_RLL_FILT: Roll axis rate controller input frequency in Hz
Roll axis rate controller input frequency in Hz
Range |
Increment |
Units |
1 - 20 |
1 |
hertz |
ATC_RAT_PIT_P: Pitch axis rate controller P gain
Pitch axis rate controller P gain. Converts the difference between desired pitch rate and actual pitch rate into a motor speed output
Range |
Increment |
0.08 - 0.35 |
0.005 |
ATC_RAT_PIT_I: Pitch axis rate controller I gain
Pitch axis rate controller I gain. Corrects long-term difference in desired pitch rate vs actual pitch rate
Range |
Increment |
0.01 - 0.6 |
0.01 |
ATC_RAT_PIT_IMAX: Pitch axis rate controller I gain maximum
Pitch axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output
Range |
Increment |
0 - 1 |
0.01 |
ATC_RAT_PIT_D: Pitch axis rate controller D gain
Pitch axis rate controller D gain. Compensates for short-term change in desired pitch rate vs actual pitch rate
Range |
Increment |
0.001 - 0.03 |
0.001 |
ATC_RAT_PIT_FF: Pitch axis rate controller feed forward
Pitch axis rate controller feed forward
Range |
Increment |
0 - 0.5 |
0.001 |
ATC_RAT_PIT_FILT: Pitch axis rate controller input frequency in Hz
Pitch axis rate controller input frequency in Hz
Range |
Increment |
Units |
1 - 20 |
1 |
hertz |
ATC_RAT_YAW_P: Yaw axis rate controller P gain
Yaw axis rate controller P gain. Converts the difference between desired yaw rate and actual yaw rate into a motor speed output
Range |
Increment |
0.180 - 0.60 |
0.005 |
ATC_RAT_YAW_I: Yaw axis rate controller I gain
Yaw axis rate controller I gain. Corrects long-term difference in desired yaw rate vs actual yaw rate
Range |
Increment |
0.01 - 0.06 |
0.01 |
ATC_RAT_YAW_IMAX: Yaw axis rate controller I gain maximum
Yaw axis rate controller I gain maximum. Constrains the maximum motor output that the I gain will output
Range |
Increment |
0 - 1 |
0.01 |
ATC_RAT_YAW_D: Yaw axis rate controller D gain
Yaw axis rate controller D gain. Compensates for short-term change in desired yaw rate vs actual yaw rate
Range |
Increment |
0.000 - 0.02 |
0.001 |
ATC_RAT_YAW_FF: Yaw axis rate controller feed forward
Yaw axis rate controller feed forward
Range |
Increment |
0 - 0.5 |
0.001 |
ATC_RAT_YAW_FILT: Yaw axis rate controller input frequency in Hz
Yaw axis rate controller input frequency in Hz
Range |
Increment |
Units |
1 - 20 |
1 |
hertz |
ATC_PIRO_COMP: Piro Comp Enable
Note: This parameter is for advanced users
Pirouette compensation enabled
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
BATT2_ Parameters
BATT2_MONITOR: Battery monitoring
Controls enabling monitoring of the battery’s voltage and current
Values |
RebootRequired |
Value |
Meaning |
0 |
Disabled |
3 |
Analog Voltage Only |
4 |
Analog Voltage and Current |
5 |
Solo |
6 |
Bebop |
7 |
SMBus-Maxell |
8 |
UAVCAN-BatteryInfo |
9 |
BLHeli ESC |
|
True |
BATT2_VOLT_PIN: Battery Voltage sensing pin
Setting this to 0 ~ 13 will enable battery voltage sensing on pins A0 ~ A13. On the PX4-v1 it should be set to 100. On the Pixhawk, Pixracer and NAVIO boards it should be set to 2, Pixhawk2 Power2 is 13.
Values |
RebootRequired |
Value |
Meaning |
-1 |
Disabled |
0 |
A0 |
1 |
A1 |
2 |
Pixhawk/Pixracer/Navio2/Pixhawk2_PM1 |
13 |
Pixhawk2_PM2 |
100 |
PX4-v1 |
|
True |
BATT2_CURR_PIN: Battery Current sensing pin
Setting this to 0 ~ 13 will enable battery current sensing on pins A0 ~ A13. On the PX4-v1 it should be set to 101. On the Pixhawk, Pixracer and NAVIO boards it should be set to 3, Pixhawk2 Power2 is 14.
Values |
RebootRequired |
Value |
Meaning |
-1 |
Disabled |
1 |
A1 |
2 |
A2 |
3 |
Pixhawk/Pixracer/Navio2/Pixhawk2_PM1 |
14 |
Pixhawk2_PM2 |
101 |
PX4-v1 |
|
True |
BATT2_VOLT_MULT: Voltage Multiplier
Note: This parameter is for advanced users
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 on APM2 or 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.
BATT2_AMP_PERVLT: Amps per volt
Number of amps that a 1V reading on the current sensor corresponds to. On the APM2 or Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17.
BATT2_AMP_OFFSET: AMP offset
Voltage offset at zero current on current sensor
BATT2_CAPACITY: Battery capacity
Capacity of the battery in mAh when full
Increment |
Units |
50 |
milliampere hour |
BATT2_WATT_MAX: Maximum allowed power (Watts)
Note: This parameter is for advanced users
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.
BATT2_SERIAL_NUM: Battery serial number
Note: This parameter is for advanced users
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With UAVCAN it is the battery_id.
BATT2_LOW_TIMER: Low voltage timeout
Note: This parameter is for advanced users
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.
Range |
Increment |
Units |
0 - 120 |
1 |
seconds |
BATT2_FS_VOLTSRC: Failsafe voltage source
Note: This parameter is for advanced users
Voltage type used for detection of low voltage event
Values |
Value |
Meaning |
0 |
Raw Voltage |
1 |
Sag Compensated Voltage |
|
BATT2_LOW_VOLT: Low battery voltage
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.
BATT2_LOW_MAH: Low battery capacity
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.
Increment |
Units |
50 |
milliampere hour |
BATT2_CRT_VOLT: Critical battery voltage
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.
BATT2_CRT_MAH: Battery critical capacity
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.
Increment |
Units |
50 |
milliampere hour |
BATT2_FS_LOW_ACT: Low battery failsafe action
What action the vehicle should perform if it hits a low battery failsafe
Values |
Value |
Meaning |
0 |
None |
1 |
Land |
2 |
RTL |
3 |
SmartRTL |
4 |
SmartRTL or Land |
5 |
Terminate |
|
BATT2_FS_CRT_ACT: Critical battery failsafe action
What action the vehicle should perform if it hits a critical battery failsafe
Values |
Value |
Meaning |
0 |
None |
1 |
Land |
2 |
RTL |
3 |
SmartRTL |
4 |
SmartRTL or Land |
5 |
Terminate |
|
BATT_ Parameters
BATT_MONITOR: Battery monitoring
Controls enabling monitoring of the battery’s voltage and current
Values |
RebootRequired |
Value |
Meaning |
0 |
Disabled |
3 |
Analog Voltage Only |
4 |
Analog Voltage and Current |
5 |
Solo |
6 |
Bebop |
7 |
SMBus-Maxell |
8 |
UAVCAN-BatteryInfo |
9 |
BLHeli ESC |
|
True |
BATT_VOLT_PIN: Battery Voltage sensing pin
Setting this to 0 ~ 13 will enable battery voltage sensing on pins A0 ~ A13. On the PX4-v1 it should be set to 100. On the Pixhawk, Pixracer and NAVIO boards it should be set to 2, Pixhawk2 Power2 is 13.
Values |
RebootRequired |
Value |
Meaning |
-1 |
Disabled |
0 |
A0 |
1 |
A1 |
2 |
Pixhawk/Pixracer/Navio2/Pixhawk2_PM1 |
13 |
Pixhawk2_PM2 |
100 |
PX4-v1 |
|
True |
BATT_CURR_PIN: Battery Current sensing pin
Setting this to 0 ~ 13 will enable battery current sensing on pins A0 ~ A13. On the PX4-v1 it should be set to 101. On the Pixhawk, Pixracer and NAVIO boards it should be set to 3, Pixhawk2 Power2 is 14.
Values |
RebootRequired |
Value |
Meaning |
-1 |
Disabled |
1 |
A1 |
2 |
A2 |
3 |
Pixhawk/Pixracer/Navio2/Pixhawk2_PM1 |
14 |
Pixhawk2_PM2 |
101 |
PX4-v1 |
|
True |
BATT_VOLT_MULT: Voltage Multiplier
Note: This parameter is for advanced users
Used to convert the voltage of the voltage sensing pin (BATT_VOLT_PIN) to the actual battery’s voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick on APM2 or 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.
BATT_AMP_PERVLT: Amps per volt
Number of amps that a 1V reading on the current sensor corresponds to. On the APM2 or Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17.
BATT_AMP_OFFSET: AMP offset
Voltage offset at zero current on current sensor
BATT_CAPACITY: Battery capacity
Capacity of the battery in mAh when full
Increment |
Units |
50 |
milliampere hour |
BATT_WATT_MAX: Maximum allowed power (Watts)
Note: This parameter is for advanced users
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.
BATT_SERIAL_NUM: Battery serial number
Note: This parameter is for advanced users
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With UAVCAN it is the battery_id.
BATT_LOW_TIMER: Low voltage timeout
Note: This parameter is for advanced users
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.
Range |
Increment |
Units |
0 - 120 |
1 |
seconds |
BATT_FS_VOLTSRC: Failsafe voltage source
Note: This parameter is for advanced users
Voltage type used for detection of low voltage event
Values |
Value |
Meaning |
0 |
Raw Voltage |
1 |
Sag Compensated Voltage |
|
BATT_LOW_VOLT: Low battery voltage
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 BATT_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT_FS_LOW_ACT parameter.
BATT_LOW_MAH: Low battery capacity
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 BATT_FS_LOW_ACT parameter.
Increment |
Units |
50 |
milliampere hour |
BATT_CRT_VOLT: Critical battery voltage
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 BATT_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT_FS_CRT_ACT parameter.
BATT_CRT_MAH: Battery critical capacity
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 BATT__FS_CRT_ACT parameter.
Increment |
Units |
50 |
milliampere hour |
BATT_FS_LOW_ACT: Low battery failsafe action
What action the vehicle should perform if it hits a low battery failsafe
Values |
Value |
Meaning |
0 |
None |
1 |
Land |
2 |
RTL |
3 |
SmartRTL |
4 |
SmartRTL or Land |
5 |
Terminate |
|
BATT_FS_CRT_ACT: Critical battery failsafe action
What action the vehicle should perform if it hits a critical battery failsafe
Values |
Value |
Meaning |
0 |
None |
1 |
Land |
2 |
RTL |
3 |
SmartRTL |
4 |
SmartRTL or Land |
5 |
Terminate |
|
COMPASS_ Parameters
COMPASS_OFS_X: Compass offsets in milligauss on the X axis
Note: This parameter is for advanced users
Offset to be added to the compass x-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_OFS_Y: Compass offsets in milligauss on the Y axis
Note: This parameter is for advanced users
Offset to be added to the compass y-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_OFS_Z: Compass offsets in milligauss on the Z axis
Note: This parameter is for advanced users
Offset to be added to the compass z-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_DEC: Compass declination
An angle to compensate between the true north and magnetic north
Range |
Increment |
Units |
-3.142 - 3.142 |
0.01 |
radians |
COMPASS_LEARN: Learn compass offsets automatically
Note: This parameter is for advanced users
Enable or disable the automatic learning of compass offsets. You can enable learning either using a compass-only method that is suitable only for fixed wing aircraft or using the offsets learnt by the active EKF state estimator. If this option is enabled then the learnt offsets are saved when you disarm the vehicle.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Internal-Learning |
2 |
EKF-Learning |
|
COMPASS_USE: Use compass for yaw
Note: This parameter is for advanced users
Enable or disable the use of the compass (instead of the GPS) for determining heading
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
COMPASS_AUTODEC: Auto Declination
Note: This parameter is for advanced users
Enable or disable the automatic calculation of the declination based on gps location
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
COMPASS_MOTCT: Motor interference compensation type
Note: This parameter is for advanced users
Set motor interference compensation type to disabled, throttle or current. Do not change manually.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Use Throttle |
2 |
Use Current |
|
COMPASS_MOT_X: Motor interference compensation for body frame X axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to the compass’s x-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_MOT_Y: Motor interference compensation for body frame Y axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to the compass’s y-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_MOT_Z: Motor interference compensation for body frame Z axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to the compass’s z-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_ORIENT: Compass orientation
Note: This parameter is for advanced users
The orientation of the first external compass relative to the vehicle frame. This value will be ignored unless this compass is set as an external compass. When set correctly in the northern hemisphere, pointing the nose and right side down should increase the MagX and MagY values respectively. Rolling the vehicle upside down should decrease the MagZ value. For southern hemisphere, switch increase and decrease. NOTE: For internal compasses, AHRS_ORIENT is used.
Values |
Value |
Meaning |
0 |
None |
1 |
Yaw45 |
2 |
Yaw90 |
3 |
Yaw135 |
4 |
Yaw180 |
5 |
Yaw225 |
6 |
Yaw270 |
7 |
Yaw315 |
8 |
Roll180 |
9 |
Roll180Yaw45 |
10 |
Roll180Yaw90 |
11 |
Roll180Yaw135 |
12 |
Pitch180 |
13 |
Roll180Yaw225 |
14 |
Roll180Yaw270 |
15 |
Roll180Yaw315 |
16 |
Roll90 |
17 |
Roll90Yaw45 |
18 |
Roll90Yaw90 |
19 |
Roll90Yaw135 |
20 |
Roll270 |
21 |
Roll270Yaw45 |
22 |
Roll270Yaw90 |
23 |
Roll270Yaw135 |
24 |
Pitch90 |
25 |
Pitch270 |
26 |
Pitch180Yaw90 |
27 |
Pitch180Yaw270 |
28 |
Roll90Pitch90 |
29 |
Roll180Pitch90 |
30 |
Roll270Pitch90 |
31 |
Roll90Pitch180 |
32 |
Roll270Pitch180 |
33 |
Roll90Pitch270 |
34 |
Roll180Pitch270 |
35 |
Roll270Pitch270 |
36 |
Roll90Pitch180Yaw90 |
37 |
Roll90Yaw270 |
38 |
Yaw293Pitch68Roll180 |
39 |
Pitch315 |
40 |
Roll90Pitch315 |
|
COMPASS_EXTERNAL: Compass is attached via an external cable
Note: This parameter is for advanced users
Configure compass so it is attached externally. This is auto-detected on PX4 and Pixhawk. Set to 1 if the compass is externally connected. When externally connected the COMPASS_ORIENT option operates independently of the AHRS_ORIENTATION board orientation option. If set to 0 or 1 then auto-detection by bus connection can override the value. If set to 2 then auto-detection will be disabled.
Values |
Value |
Meaning |
0 |
Internal |
1 |
External |
2 |
ForcedExternal |
|
COMPASS_OFS2_X: Compass2 offsets in milligauss on the X axis
Note: This parameter is for advanced users
Offset to be added to compass2’s x-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_OFS2_Y: Compass2 offsets in milligauss on the Y axis
Note: This parameter is for advanced users
Offset to be added to compass2’s y-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_OFS2_Z: Compass2 offsets in milligauss on the Z axis
Note: This parameter is for advanced users
Offset to be added to compass2’s z-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_MOT2_X: Motor interference compensation to compass2 for body frame X axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to compass2’s x-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_MOT2_Y: Motor interference compensation to compass2 for body frame Y axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to compass2’s y-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_MOT2_Z: Motor interference compensation to compass2 for body frame Z axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to compass2’s z-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_PRIMARY: Choose primary compass
Note: This parameter is for advanced users
If more than one compass is available, this selects which compass is the primary. When external compasses are connected, they will be ordered first. NOTE: If no external compass is attached, this parameter is ignored.
Values |
Value |
Meaning |
0 |
FirstCompass |
1 |
SecondCompass |
2 |
ThirdCompass |
|
COMPASS_OFS3_X: Compass3 offsets in milligauss on the X axis
Note: This parameter is for advanced users
Offset to be added to compass3’s x-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_OFS3_Y: Compass3 offsets in milligauss on the Y axis
Note: This parameter is for advanced users
Offset to be added to compass3’s y-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_OFS3_Z: Compass3 offsets in milligauss on the Z axis
Note: This parameter is for advanced users
Offset to be added to compass3’s z-axis values to compensate for metal in the frame
Range |
Increment |
Units |
-400 - 400 |
1 |
milligauss |
COMPASS_MOT3_X: Motor interference compensation to compass3 for body frame X axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to compass3’s x-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_MOT3_Y: Motor interference compensation to compass3 for body frame Y axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to compass3’s y-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_MOT3_Z: Motor interference compensation to compass3 for body frame Z axis
Note: This parameter is for advanced users
Multiplied by the current throttle and added to compass3’s z-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Range |
Increment |
Units |
-1000 - 1000 |
1 |
milligauss per ampere |
COMPASS_DEV_ID: Compass device id
Note: This parameter is for advanced users
Compass device id. Automatically detected, do not set manually
COMPASS_DEV_ID2: Compass2 device id
Note: This parameter is for advanced users
Second compass’s device id. Automatically detected, do not set manually
COMPASS_DEV_ID3: Compass3 device id
Note: This parameter is for advanced users
Third compass’s device id. Automatically detected, do not set manually
COMPASS_USE2: Compass2 used for yaw
Note: This parameter is for advanced users
Enable or disable the second compass for determining heading.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
COMPASS_ORIENT2: Compass2 orientation
Note: This parameter is for advanced users
The orientation of a second external compass relative to the vehicle frame. This value will be ignored unless this compass is set as an external compass. When set correctly in the northern hemisphere, pointing the nose and right side down should increase the MagX and MagY values respectively. Rolling the vehicle upside down should decrease the MagZ value. For southern hemisphere, switch increase and decrease. NOTE: For internal compasses, AHRS_ORIENT is used.
Values |
Value |
Meaning |
0 |
None |
1 |
Yaw45 |
2 |
Yaw90 |
3 |
Yaw135 |
4 |
Yaw180 |
5 |
Yaw225 |
6 |
Yaw270 |
7 |
Yaw315 |
8 |
Roll180 |
9 |
Roll180Yaw45 |
10 |
Roll180Yaw90 |
11 |
Roll180Yaw135 |
12 |
Pitch180 |
13 |
Roll180Yaw225 |
14 |
Roll180Yaw270 |
15 |
Roll180Yaw315 |
16 |
Roll90 |
17 |
Roll90Yaw45 |
18 |
Roll90Yaw90 |
19 |
Roll90Yaw135 |
20 |
Roll270 |
21 |
Roll270Yaw45 |
22 |
Roll270Yaw90 |
23 |
Roll270Yaw135 |
24 |
Pitch90 |
25 |
Pitch270 |
26 |
Pitch180Yaw90 |
27 |
Pitch180Yaw270 |
28 |
Roll90Pitch90 |
29 |
Roll180Pitch90 |
30 |
Roll270Pitch90 |
31 |
Roll90Pitch180 |
32 |
Roll270Pitch180 |
33 |
Roll90Pitch270 |
34 |
Roll180Pitch270 |
35 |
Roll270Pitch270 |
36 |
Roll90Pitch180Yaw90 |
37 |
Roll90Yaw270 |
38 |
Yaw293Pitch68Roll180 |
39 |
Pitch315 |
40 |
Roll90Pitch315 |
|
COMPASS_EXTERN2: Compass2 is attached via an external cable
Note: This parameter is for advanced users
Configure second compass so it is attached externally. This is auto-detected on PX4 and Pixhawk. If set to 0 or 1 then auto-detection by bus connection can override the value. If set to 2 then auto-detection will be disabled.
Values |
Value |
Meaning |
0 |
Internal |
1 |
External |
2 |
ForcedExternal |
|
COMPASS_USE3: Compass3 used for yaw
Note: This parameter is for advanced users
Enable or disable the third compass for determining heading.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
COMPASS_ORIENT3: Compass3 orientation
Note: This parameter is for advanced users
The orientation of a third external compass relative to the vehicle frame. This value will be ignored unless this compass is set as an external compass. When set correctly in the northern hemisphere, pointing the nose and right side down should increase the MagX and MagY values respectively. Rolling the vehicle upside down should decrease the MagZ value. For southern hemisphere, switch increase and decrease. NOTE: For internal compasses, AHRS_ORIENT is used.
Values |
Value |
Meaning |
0 |
None |
1 |
Yaw45 |
2 |
Yaw90 |
3 |
Yaw135 |
4 |
Yaw180 |
5 |
Yaw225 |
6 |
Yaw270 |
7 |
Yaw315 |
8 |
Roll180 |
9 |
Roll180Yaw45 |
10 |
Roll180Yaw90 |
11 |
Roll180Yaw135 |
12 |
Pitch180 |
13 |
Roll180Yaw225 |
14 |
Roll180Yaw270 |
15 |
Roll180Yaw315 |
16 |
Roll90 |
17 |
Roll90Yaw45 |
18 |
Roll90Yaw90 |
19 |
Roll90Yaw135 |
20 |
Roll270 |
21 |
Roll270Yaw45 |
22 |
Roll270Yaw90 |
23 |
Roll270Yaw135 |
24 |
Pitch90 |
25 |
Pitch270 |
26 |
Pitch180Yaw90 |
27 |
Pitch180Yaw270 |
28 |
Roll90Pitch90 |
29 |
Roll180Pitch90 |
30 |
Roll270Pitch90 |
31 |
Roll90Pitch180 |
32 |
Roll270Pitch180 |
33 |
Roll90Pitch270 |
34 |
Roll180Pitch270 |
35 |
Roll270Pitch270 |
36 |
Roll90Pitch180Yaw90 |
37 |
Roll90Yaw270 |
38 |
Yaw293Pitch68Roll180 |
39 |
Pitch315 |
40 |
Roll90Pitch315 |
|
COMPASS_EXTERN3: Compass3 is attached via an external cable
Note: This parameter is for advanced users
Configure third compass so it is attached externally. This is auto-detected on PX4 and Pixhawk. If set to 0 or 1 then auto-detection by bus connection can override the value. If set to 2 then auto-detection will be disabled.
Values |
Value |
Meaning |
0 |
Internal |
1 |
External |
2 |
ForcedExternal |
|
COMPASS_DIA_X: Compass soft-iron diagonal X component
Note: This parameter is for advanced users
DIA_X in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA_Y: Compass soft-iron diagonal Y component
Note: This parameter is for advanced users
DIA_Y in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA_Z: Compass soft-iron diagonal Z component
Note: This parameter is for advanced users
DIA_Z in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI_X: Compass soft-iron off-diagonal X component
Note: This parameter is for advanced users
ODI_X in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI_Y: Compass soft-iron off-diagonal Y component
Note: This parameter is for advanced users
ODI_Y in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI_Z: Compass soft-iron off-diagonal Z component
Note: This parameter is for advanced users
ODI_Z in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA2_X: Compass2 soft-iron diagonal X component
Note: This parameter is for advanced users
DIA_X in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA2_Y: Compass2 soft-iron diagonal Y component
Note: This parameter is for advanced users
DIA_Y in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA2_Z: Compass2 soft-iron diagonal Z component
Note: This parameter is for advanced users
DIA_Z in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI2_X: Compass2 soft-iron off-diagonal X component
Note: This parameter is for advanced users
ODI_X in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI2_Y: Compass2 soft-iron off-diagonal Y component
Note: This parameter is for advanced users
ODI_Y in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI2_Z: Compass2 soft-iron off-diagonal Z component
Note: This parameter is for advanced users
ODI_Z in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA3_X: Compass3 soft-iron diagonal X component
Note: This parameter is for advanced users
DIA_X in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA3_Y: Compass3 soft-iron diagonal Y component
Note: This parameter is for advanced users
DIA_Y in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_DIA3_Z: Compass3 soft-iron diagonal Z component
Note: This parameter is for advanced users
DIA_Z in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI3_X: Compass3 soft-iron off-diagonal X component
Note: This parameter is for advanced users
ODI_X in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI3_Y: Compass3 soft-iron off-diagonal Y component
Note: This parameter is for advanced users
ODI_Y in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_ODI3_Z: Compass3 soft-iron off-diagonal Z component
Note: This parameter is for advanced users
ODI_Z in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
COMPASS_CAL_FIT: Compass calibration fitness
Note: This parameter is for advanced users
This controls the fitness level required for a successful compass calibration. A lower value makes for a stricter fit (less likely to pass). This is the value used for the primary magnetometer. Other magnetometers get double the value.
Range |
Values |
Increment |
4 - 32 |
Value |
Meaning |
4 |
Very Strict |
8 |
Strict |
16 |
Default |
32 |
Relaxed |
|
0.1 |
COMPASS_OFFS_MAX: Compass maximum offset
Note: This parameter is for advanced users
This sets the maximum allowed compass offset in calibration and arming checks
Range |
Increment |
500 - 3000 |
1 |
COMPASS_TYPEMASK: Compass disable driver type mask
Note: This parameter is for advanced users
This is a bitmask of driver types to disable. If a driver type is set in this mask then that driver will not try to find a sensor at startup
Bitmask |
Bit |
Meaning |
0 |
HMC5883 |
1 |
LSM303D |
2 |
AK8963 |
3 |
BMM150 |
4 |
LSM9DS1 |
5 |
LIS3MDL |
6 |
AK09916 |
7 |
IST8310 |
8 |
ICM20948 |
9 |
MMC3416 |
11 |
UAVCAN |
12 |
QMC5883 |
|
COMPASS_FLTR_RNG: Range in which sample is accepted
This sets the range around the average value that new samples must be within to be accepted. This can help reduce the impact of noise on sensors that are on long I2C cables. The value is a percentage from the average value. A value of zero disables this filter.
Range |
Increment |
Units |
0 - 100 |
1 |
percent |
COMPASS_AUTO_ROT: Automatically check orientation
When enabled this will automatically check the orientation of compasses on successful completion of compass calibration. If set to 2 then external compasses will have their orientation automatically corrected.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
CheckOnly |
2 |
CheckAndFix |
|
EK2_ Parameters
EK2_ENABLE: Enable EKF2
Note: This parameter is for advanced users
This enables EKF2. Enabling EKF2 only makes the maths run, it does not mean it will be used for flight control. To use it for flight control set AHRS_EKF_TYPE=2. A reboot or restart will need to be performed after changing the value of EK2_ENABLE for it to take effect.
Values |
RebootRequired |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
True |
EK2_GPS_TYPE: GPS mode control
Note: This parameter is for advanced users
This controls use of GPS measurements : 0 = use 3D velocity & 2D position, 1 = use 2D velocity and 2D position, 2 = use 2D position, 3 = Inhibit GPS use - this can be useful when flying with an optical flow sensor in an environment where GPS quality is poor and subject to large multipath errors.
Values |
Value |
Meaning |
0 |
GPS 3D Vel and 2D Pos |
1 |
GPS 2D vel and 2D pos |
2 |
GPS 2D pos |
3 |
No GPS |
|
EK2_VELNE_M_NSE: GPS horizontal velocity measurement noise (m/s)
Note: This parameter is for advanced users
This sets a lower limit on the speed accuracy reported by the GPS receiver that is used to set horizontal velocity observation noise. If the model of receiver used does not provide a speed accurcy estimate, then the parameter value will be used. Increasing it reduces the weighting of the GPS horizontal velocity measurements.
Range |
Increment |
Units |
0.05 - 5.0 |
0.05 |
meters per second |
EK2_VELD_M_NSE: GPS vertical velocity measurement noise (m/s)
Note: This parameter is for advanced users
This sets a lower limit on the speed accuracy reported by the GPS receiver that is used to set vertical velocity observation noise. If the model of receiver used does not provide a speed accurcy estimate, then the parameter value will be used. Increasing it reduces the weighting of the GPS vertical velocity measurements.
Range |
Increment |
Units |
0.05 - 5.0 |
0.05 |
meters per second |
EK2_VEL_I_GATE: GPS velocity innovation gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the GPS velocity measurement innovation consistency check. Decreasing it makes it more likely that good measurements willbe rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_POSNE_M_NSE: GPS horizontal position measurement noise (m)
Note: This parameter is for advanced users
This sets the GPS horizontal position observation noise. Increasing it reduces the weighting of GPS horizontal position measurements.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK2_POS_I_GATE: GPS position measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the GPS position measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_GLITCH_RAD: GPS glitch radius gate size (m)
Note: This parameter is for advanced users
This controls the maximum radial uncertainty in position between the value predicted by the filter and the value measured by the GPS before the filter position and velocity states are reset to the GPS. Making this value larger allows the filter to ignore larger GPS glitches but also means that non-GPS errors such as IMU and compass can create a larger error in position before the filter is forced back to the GPS position.
Range |
Increment |
Units |
10 - 100 |
5 |
meters |
EK2_GPS_DELAY: GPS measurement delay (msec)
Note: This parameter is for advanced users
This is the number of msec that the GPS measurements lag behind the inertial measurements.
Range |
Increment |
Units |
RebootRequired |
0 - 250 |
10 |
milliseconds |
True |
EK2_ALT_SOURCE: Primary altitude sensor source
Note: This parameter is for advanced users
This parameter controls the primary height sensor used by the EKF. If the selected option cannot be used, it will default to Baro as the primary height source. Setting 0 will use the baro altitude at all times. Setting 1 uses the range finder and is only available in combination with optical flow navigation (EK2_GPS_TYPE = 3). Setting 2 uses GPS. Setting 3 uses the range beacon data. NOTE - the EK2_RNG_USE_HGT parameter can be used to switch to range-finder when close to the ground.
Values |
RebootRequired |
Value |
Meaning |
0 |
Use Baro |
1 |
Use Range Finder |
2 |
Use GPS |
3 |
Use Range Beacon |
|
True |
EK2_ALT_M_NSE: Altitude measurement noise (m)
Note: This parameter is for advanced users
This is the RMS value of noise in the altitude measurement. Increasing it reduces the weighting of the baro measurement and will make the filter respond more slowly to baro measurement errors, but will make it more sensitive to GPS and accelerometer errors.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK2_HGT_I_GATE: Height measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the height measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_HGT_DELAY: Height measurement delay (msec)
Note: This parameter is for advanced users
This is the number of msec that the Height measurements lag behind the inertial measurements.
Range |
Increment |
Units |
RebootRequired |
0 - 250 |
10 |
milliseconds |
True |
EK2_MAG_M_NSE: Magnetometer measurement noise (Gauss)
Note: This parameter is for advanced users
This is the RMS value of noise in magnetometer measurements. Increasing it reduces the weighting on these measurements.
Range |
Increment |
Units |
0.01 - 0.5 |
0.01 |
gauss |
EK2_MAG_CAL: Magnetometer default fusion mode
Note: This parameter is for advanced users
This determines when the filter will use the 3-axis magnetometer fusion model that estimates both earth and body fixed magnetic field states and when it will use a simpler magnetic heading fusion model that does not use magnetic field states. The 3-axis magnetometer fusion is only suitable for use when the external magnetic field environment is stable. EK2_MAG_CAL = 0 uses heading fusion on ground, 3-axis fusion in-flight, and is the default setting for Plane users. EK2_MAG_CAL = 1 uses 3-axis fusion only when manoeuvring. EK2_MAG_CAL = 2 uses heading fusion at all times, is recommended if the external magnetic field is varying and is the default for rovers. EK2_MAG_CAL = 3 uses heading fusion on the ground and 3-axis fusion after the first in-air field and yaw reset has completed, and is the default for copters. EK2_MAG_CAL = 4 uses 3-axis fusion at all times. NOTE : Use of simple heading magnetometer fusion makes vehicle compass calibration and alignment errors harder for the EKF to detect which reduces the sensitivity of the Copter EKF failsafe algorithm. NOTE: The fusion mode can be forced to 2 for specific EKF cores using the EK2_MAG_MASK parameter.
Values |
Value |
Meaning |
0 |
When flying |
1 |
When manoeuvring |
2 |
Never |
3 |
After first climb yaw reset |
4 |
Always |
|
EK2_MAG_I_GATE: Magnetometer measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the magnetometer measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_EAS_M_NSE: Equivalent airspeed measurement noise (m/s)
Note: This parameter is for advanced users
This is the RMS value of noise in equivalent airspeed measurements used by planes. Increasing it reduces the weighting of airspeed measurements and will make wind speed estimates less noisy and slower to converge. Increasing also increases navigation errors when dead-reckoning without GPS measurements.
Range |
Increment |
Units |
0.5 - 5.0 |
0.1 |
meters per second |
EK2_EAS_I_GATE: Airspeed measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the airspeed measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_RNG_M_NSE: Range finder measurement noise (m)
Note: This parameter is for advanced users
This is the RMS value of noise in the range finder measurement. Increasing it reduces the weighting on this measurement.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK2_RNG_I_GATE: Range finder measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the range finder innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_MAX_FLOW: Maximum valid optical flow rate
Note: This parameter is for advanced users
This sets the magnitude maximum optical flow rate in rad/sec that will be accepted by the filter
Range |
Increment |
Units |
1.0 - 4.0 |
0.1 |
radians per second |
EK2_FLOW_M_NSE: Optical flow measurement noise (rad/s)
Note: This parameter is for advanced users
This is the RMS value of noise and errors in optical flow measurements. Increasing it reduces the weighting on these measurements.
Range |
Increment |
Units |
0.05 - 1.0 |
0.05 |
radians per second |
EK2_FLOW_I_GATE: Optical Flow measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the optical flow innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_FLOW_DELAY: Optical Flow measurement delay (msec)
Note: This parameter is for advanced users
This is the number of msec that the optical flow measurements lag behind the inertial measurements. It is the time from the end of the optical flow averaging period and does not include the time delay due to the 100msec of averaging within the flow sensor.
Range |
Increment |
Units |
RebootRequired |
0 - 127 |
10 |
milliseconds |
True |
EK2_GYRO_P_NSE: Rate gyro noise (rad/s)
Note: This parameter is for advanced users
This control disturbance noise controls the growth of estimated error due to gyro measurement errors excluding bias. Increasing it makes the flter trust the gyro measurements less and other measurements more.
Range |
Increment |
Units |
0.0001 - 0.1 |
0.0001 |
radians per second |
EK2_ACC_P_NSE: Accelerometer noise (m/s^2)
Note: This parameter is for advanced users
This control disturbance noise controls the growth of estimated error due to accelerometer measurement errors excluding bias. Increasing it makes the flter trust the accelerometer measurements less and other measurements more.
Range |
Increment |
Units |
0.01 - 1.0 |
0.01 |
meters per square second |
EK2_GBIAS_P_NSE: Rate gyro bias stability (rad/s/s)
Note: This parameter is for advanced users
This state process noise controls growth of the gyro delta angle bias state error estimate. Increasing it makes rate gyro bias estimation faster and noisier.
Range |
Units |
0.00001 - 0.001 |
radians per square second |
EK2_GSCL_P_NSE: Rate gyro scale factor stability (1/s)
Note: This parameter is for advanced users
This noise controls the rate of gyro scale factor learning. Increasing it makes rate gyro scale factor estimation faster and noisier.
Range |
Units |
0.000001 - 0.001 |
hertz |
EK2_ABIAS_P_NSE: Accelerometer bias stability (m/s^3)
Note: This parameter is for advanced users
This noise controls the growth of the vertical accelerometer delta velocity bias state error estimate. Increasing it makes accelerometer bias estimation faster and noisier.
Range |
Units |
0.00001 - 0.001 |
meters per cubic second |
EK2_WIND_P_NSE: Wind velocity process noise (m/s^2)
Note: This parameter is for advanced users
This state process noise controls the growth of wind state error estimates. Increasing it makes wind estimation faster and noisier.
Range |
Increment |
Units |
0.01 - 1.0 |
0.1 |
meters per square second |
EK2_WIND_PSCALE: Height rate to wind process noise scaler
Note: This parameter is for advanced users
This controls how much the process noise on the wind states is increased when gaining or losing altitude to take into account changes in wind speed and direction with altitude. Increasing this parameter increases how rapidly the wind states adapt when changing altitude, but does make wind velocity estimation noiser.
Range |
Increment |
0.0 - 1.0 |
0.1 |
EK2_GPS_CHECK: GPS preflight check
Note: This parameter is for advanced users
This is a 1 byte bitmap controlling which GPS preflight checks are performed. Set to 0 to bypass all checks. Set to 255 perform all checks. Set to 3 to check just the number of satellites and HDoP. Set to 31 for the most rigorous checks that will still allow checks to pass when the copter is moving, eg launch from a boat.
Bitmask |
Bit |
Meaning |
0 |
NSats |
1 |
HDoP |
2 |
speed error |
3 |
position error |
4 |
yaw error |
5 |
pos drift |
6 |
vert speed |
7 |
horiz speed |
|
EK2_IMU_MASK: Bitmask of active IMUs
Note: This parameter is for advanced users
1 byte bitmap of IMUs to use in EKF2. A separate instance of EKF2 will be started for each IMU selected. Set to 1 to use the first IMU only (default), set to 2 to use the second IMU only, set to 3 to use the first and second IMU. Additional IMU’s can be used up to a maximum of 6 if memory and processing resources permit. There may be insufficient memory and processing resources to run multiple instances. If this occurs EKF2 will fail to start.
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
FirstIMU |
1 |
SecondIMU |
2 |
ThirdIMU |
3 |
FourthIMU |
4 |
FifthIMU |
5 |
SixthIMU |
|
True |
EK2_CHECK_SCALE: GPS accuracy check scaler (%)
Note: This parameter is for advanced users
This scales the thresholds that are used to check GPS accuracy before it is used by the EKF. A value of 100 is the default. Values greater than 100 increase and values less than 100 reduce the maximum GPS error the EKF will accept. A value of 200 will double the allowable GPS error.
Range |
Units |
50 - 200 |
percent |
EK2_NOAID_M_NSE: Non-GPS operation position uncertainty (m)
Note: This parameter is for advanced users
This sets the amount of position variation that the EKF allows for when operating without external measurements (eg GPS or optical flow). Increasing this parameter makes the EKF attitude estimate less sensitive to vehicle manoeuvres but more sensitive to IMU errors.
Range |
Units |
0.5 - 50.0 |
meters |
EK2_LOG_MASK: EKF sensor logging IMU mask
Note: This parameter is for advanced users
This sets the IMU mask of sensors to do full logging for
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
FirstIMU |
1 |
SecondIMU |
2 |
ThirdIMU |
3 |
FourthIMU |
4 |
FifthIMU |
5 |
SixthIMU |
|
True |
EK2_YAW_M_NSE: Yaw measurement noise (rad)
Note: This parameter is for advanced users
This is the RMS value of noise in yaw measurements from the magnetometer. Increasing it reduces the weighting on these measurements.
Range |
Increment |
Units |
0.05 - 1.0 |
0.05 |
radians |
EK2_YAW_I_GATE: Yaw measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the magnetometer yaw measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_TAU_OUTPUT: Output complementary filter time constant (centi-sec)
Note: This parameter is for advanced users
Sets the time constant of the output complementary filter/predictor in centi-seconds.
Range |
Increment |
Units |
10 - 50 |
5 |
centiseconds |
EK2_MAGE_P_NSE: Earth magnetic field process noise (gauss/s)
Note: This parameter is for advanced users
This state process noise controls the growth of earth magnetic field state error estimates. Increasing it makes earth magnetic field estimation faster and noisier.
Range |
Units |
0.00001 - 0.01 |
gauss per second |
EK2_MAGB_P_NSE: Body magnetic field process noise (gauss/s)
Note: This parameter is for advanced users
This state process noise controls the growth of body magnetic field state error estimates. Increasing it makes magnetometer bias error estimation faster and noisier.
Range |
Units |
0.00001 - 0.01 |
gauss per second |
EK2_RNG_USE_HGT: Range finder switch height percentage
Note: This parameter is for advanced users
The range finder will be used as the primary height source when below a specified percentage of the sensor maximum as set by the RNGFND_MAX_CM parameter. Set to -1 to prevent range finder use.
Range |
Increment |
Units |
-1 - 70 |
1 |
percent |
EK2_TERR_GRAD: Maximum terrain gradient
Note: This parameter is for advanced users
Specifies the maximum gradient of the terrain below the vehicle when it is using range finder as a height reference
Range |
Increment |
0 - 0.2 |
0.01 |
EK2_BCN_M_NSE: Range beacon measurement noise (m)
Note: This parameter is for advanced users
This is the RMS value of noise in the range beacon measurement. Increasing it reduces the weighting on this measurement.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK2_BCN_I_GTE: Range beacon measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the range beacon measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK2_BCN_DELAY: Range beacon measurement delay (msec)
Note: This parameter is for advanced users
This is the number of msec that the range beacon measurements lag behind the inertial measurements. It is the time from the end of the optical flow averaging period and does not include the time delay due to the 100msec of averaging within the flow sensor.
Range |
Increment |
Units |
RebootRequired |
0 - 127 |
10 |
milliseconds |
True |
EK2_RNG_USE_SPD: Range finder max ground speed
Note: This parameter is for advanced users
The range finder will not be used as the primary height source when the horizontal ground speed is greater than this value.
Range |
Increment |
Units |
2.0 - 6.0 |
0.5 |
meters per second |
EK2_MAG_MASK: Bitmask of active EKF cores that will always use heading fusion
Note: This parameter is for advanced users
1 byte bitmap of EKF cores that will disable magnetic field states and use simple magnetic heading fusion at all times. This parameter enables specified cores to be used as a backup for flight into an environment with high levels of external magnetic interference which may degrade the EKF attitude estimate when using 3-axis magnetometer fusion. NOTE : Use of a different magnetometer fusion algorithm on different cores makes unwanted EKF core switches due to magnetometer errors more likely.
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
FirstEKF |
1 |
SecondEKF |
2 |
ThirdEKF |
3 |
FourthEKF |
4 |
FifthEKF |
5 |
SixthEKF |
|
True |
EK2_OGN_HGT_MASK: Bitmask control of EKF reference height correction
Note: This parameter is for advanced users
When a height sensor other than GPS is used as the primary height source by the EKF, the position of the zero height datum is defined by that sensor and its frame of reference. If a GPS height measurement is also available, then the height of the WGS-84 height datum used by the EKF can be corrected so that the height returned by the getLLH() function is compensated for primary height sensor drift and change in datum over time. The first two bit positions control when the height datum will be corrected. Correction is performed using a Bayes filter and only operates when GPS quality permits. The third bit position controls where the corrections to the GPS reference datum are applied. Corrections can be applied to the local vertical position or to the reported EKF origin height (default).
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
Correct when using Baro height |
1 |
Correct when using range finder height |
2 |
Apply corrections to local position |
|
True |
EK2_MAG_EF_LIM: EarthField error limit
Note: This parameter is for advanced users
This limits the difference between the learned earth magnetic field and the earth field from the world magnetic model tables. A value of zero means to disable the use of the WMM tables.
Range |
Units |
0 - 500 |
milligauss |
EK3_ Parameters
EK3_ENABLE: Enable EKF3
Note: This parameter is for advanced users
This enables EKF3. Enabling EKF3 only makes the maths run, it does not mean it will be used for flight control. To use it for flight control set AHRS_EKF_TYPE=3. A reboot or restart will need to be performed after changing the value of EK3_ENABLE for it to take effect.
Values |
RebootRequired |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
True |
EK3_GPS_TYPE: GPS mode control
Note: This parameter is for advanced users
This controls use of GPS measurements : 0 = use 3D velocity & 2D position, 1 = use 2D velocity and 2D position, 2 = use 2D position, 3 = Inhibit GPS use - this can be useful when flying with an optical flow sensor in an environment where GPS quality is poor and subject to large multipath errors.
Values |
Value |
Meaning |
0 |
GPS 3D Vel and 2D Pos |
1 |
GPS 2D vel and 2D pos |
2 |
GPS 2D pos |
3 |
No GPS |
|
EK3_VELNE_M_NSE: GPS horizontal velocity measurement noise (m/s)
Note: This parameter is for advanced users
This sets a lower limit on the speed accuracy reported by the GPS receiver that is used to set horizontal velocity observation noise. If the model of receiver used does not provide a speed accurcy estimate, then the parameter value will be used. Increasing it reduces the weighting of the GPS horizontal velocity measurements.
Range |
Increment |
Units |
0.05 - 5.0 |
0.05 |
meters per second |
EK3_VELD_M_NSE: GPS vertical velocity measurement noise (m/s)
Note: This parameter is for advanced users
This sets a lower limit on the speed accuracy reported by the GPS receiver that is used to set vertical velocity observation noise. If the model of receiver used does not provide a speed accurcy estimate, then the parameter value will be used. Increasing it reduces the weighting of the GPS vertical velocity measurements.
Range |
Increment |
Units |
0.05 - 5.0 |
0.05 |
meters per second |
EK3_VEL_I_GATE: GPS velocity innovation gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the GPS velocity measurement innovation consistency check. Decreasing it makes it more likely that good measurements willbe rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_POSNE_M_NSE: GPS horizontal position measurement noise (m)
Note: This parameter is for advanced users
This sets the GPS horizontal position observation noise. Increasing it reduces the weighting of GPS horizontal position measurements.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK3_POS_I_GATE: GPS position measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the GPS position measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_GLITCH_RAD: GPS glitch radius gate size (m)
Note: This parameter is for advanced users
This controls the maximum radial uncertainty in position between the value predicted by the filter and the value measured by the GPS before the filter position and velocity states are reset to the GPS. Making this value larger allows the filter to ignore larger GPS glitches but also means that non-GPS errors such as IMU and compass can create a larger error in position before the filter is forced back to the GPS position.
Range |
Increment |
Units |
10 - 100 |
5 |
meters |
EK3_ALT_SOURCE: Primary altitude sensor source
Note: This parameter is for advanced users
This parameter controls the primary height sensor used by the EKF. If the selected option cannot be used, it will default to Baro as the primary height source. Setting 0 will use the baro altitude at all times. Setting 1 uses the range finder and is only available in combination with optical flow navigation (EK3_GPS_TYPE = 3). Setting 2 uses GPS. Setting 3 uses the range beacon data. NOTE - the EK3_RNG_USE_HGT parameter can be used to switch to range-finder when close to the ground.
Values |
RebootRequired |
Value |
Meaning |
0 |
Use Baro |
1 |
Use Range Finder |
2 |
Use GPS |
3 |
Use Range Beacon |
|
True |
EK3_ALT_M_NSE: Altitude measurement noise (m)
Note: This parameter is for advanced users
This is the RMS value of noise in the altitude measurement. Increasing it reduces the weighting of the baro measurement and will make the filter respond more slowly to baro measurement errors, but will make it more sensitive to GPS and accelerometer errors.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK3_HGT_I_GATE: Height measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the height measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_HGT_DELAY: Height measurement delay (msec)
Note: This parameter is for advanced users
This is the number of msec that the Height measurements lag behind the inertial measurements.
Range |
Increment |
Units |
RebootRequired |
0 - 250 |
10 |
milliseconds |
True |
EK3_MAG_M_NSE: Magnetometer measurement noise (Gauss)
Note: This parameter is for advanced users
This is the RMS value of noise in magnetometer measurements. Increasing it reduces the weighting on these measurements.
Range |
Increment |
Units |
0.01 - 0.5 |
0.01 |
gauss |
EK3_MAG_CAL: Magnetometer default fusion mode
Note: This parameter is for advanced users
This determines when the filter will use the 3-axis magnetometer fusion model that estimates both earth and body fixed magnetic field states and when it will use a simpler magnetic heading fusion model that does not use magnetic field states. The 3-axis magnetometer fusion is only suitable for use when the external magnetic field environment is stable. EK3_MAG_CAL = 0 uses heading fusion on ground, 3-axis fusion in-flight, and is the default setting for Plane users. EK3_MAG_CAL = 1 uses 3-axis fusion only when manoeuvring. EK3_MAG_CAL = 2 uses heading fusion at all times, is recommended if the external magnetic field is varying and is the default for rovers. EK3_MAG_CAL = 3 uses heading fusion on the ground and 3-axis fusion after the first in-air field and yaw reset has completed, and is the default for copters. EK3_MAG_CAL = 4 uses 3-axis fusion at all times. NOTE : Use of simple heading magnetometer fusion makes vehicle compass calibration and alignment errors harder for the EKF to detect which reduces the sensitivity of the Copter EKF failsafe algorithm. NOTE: The fusion mode can be forced to 2 for specific EKF cores using the EK3_MAG_MASK parameter.
Values |
RebootRequired |
Value |
Meaning |
0 |
When flying |
1 |
When manoeuvring |
2 |
Never |
3 |
After first climb yaw reset |
4 |
Always |
|
True |
EK3_MAG_I_GATE: Magnetometer measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the magnetometer measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_EAS_M_NSE: Equivalent airspeed measurement noise (m/s)
Note: This parameter is for advanced users
This is the RMS value of noise in equivalent airspeed measurements used by planes. Increasing it reduces the weighting of airspeed measurements and will make wind speed estimates less noisy and slower to converge. Increasing also increases navigation errors when dead-reckoning without GPS measurements.
Range |
Increment |
Units |
0.5 - 5.0 |
0.1 |
meters per second |
EK3_EAS_I_GATE: Airspeed measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the airspeed measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_RNG_M_NSE: Range finder measurement noise (m)
Note: This parameter is for advanced users
This is the RMS value of noise in the range finder measurement. Increasing it reduces the weighting on this measurement.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK3_RNG_I_GATE: Range finder measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the range finder innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_MAX_FLOW: Maximum valid optical flow rate
Note: This parameter is for advanced users
This sets the magnitude maximum optical flow rate in rad/sec that will be accepted by the filter
Range |
Increment |
Units |
1.0 - 4.0 |
0.1 |
radians per second |
EK3_FLOW_M_NSE: Optical flow measurement noise (rad/s)
Note: This parameter is for advanced users
This is the RMS value of noise and errors in optical flow measurements. Increasing it reduces the weighting on these measurements.
Range |
Increment |
Units |
0.05 - 1.0 |
0.05 |
radians per second |
EK3_FLOW_I_GATE: Optical Flow measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the optical flow innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_FLOW_DELAY: Optical Flow measurement delay (msec)
Note: This parameter is for advanced users
This is the number of msec that the optical flow measurements lag behind the inertial measurements. It is the time from the end of the optical flow averaging period and does not include the time delay due to the 100msec of averaging within the flow sensor.
Range |
Increment |
Units |
RebootRequired |
0 - 250 |
10 |
milliseconds |
True |
EK3_GYRO_P_NSE: Rate gyro noise (rad/s)
Note: This parameter is for advanced users
This control disturbance noise controls the growth of estimated error due to gyro measurement errors excluding bias. Increasing it makes the flter trust the gyro measurements less and other measurements more.
Range |
Increment |
Units |
0.0001 - 0.1 |
0.0001 |
radians per second |
EK3_ACC_P_NSE: Accelerometer noise (m/s^2)
Note: This parameter is for advanced users
This control disturbance noise controls the growth of estimated error due to accelerometer measurement errors excluding bias. Increasing it makes the flter trust the accelerometer measurements less and other measurements more.
Range |
Increment |
Units |
0.01 - 1.0 |
0.01 |
meters per square second |
EK3_GBIAS_P_NSE: Rate gyro bias stability (rad/s/s)
Note: This parameter is for advanced users
This state process noise controls growth of the gyro delta angle bias state error estimate. Increasing it makes rate gyro bias estimation faster and noisier.
Range |
Units |
0.00001 - 0.001 |
radians per square second |
EK3_ABIAS_P_NSE: Accelerometer bias stability (m/s^3)
Note: This parameter is for advanced users
This noise controls the growth of the vertical accelerometer delta velocity bias state error estimate. Increasing it makes accelerometer bias estimation faster and noisier.
Range |
Units |
0.00001 - 0.001 |
meters per cubic second |
EK3_WIND_P_NSE: Wind velocity process noise (m/s^2)
Note: This parameter is for advanced users
This state process noise controls the growth of wind state error estimates. Increasing it makes wind estimation faster and noisier.
Range |
Increment |
Units |
0.01 - 1.0 |
0.1 |
meters per square second |
EK3_WIND_PSCALE: Height rate to wind process noise scaler
Note: This parameter is for advanced users
This controls how much the process noise on the wind states is increased when gaining or losing altitude to take into account changes in wind speed and direction with altitude. Increasing this parameter increases how rapidly the wind states adapt when changing altitude, but does make wind velocity estimation noiser.
Range |
Increment |
0.0 - 1.0 |
0.1 |
EK3_GPS_CHECK: GPS preflight check
Note: This parameter is for advanced users
This is a 1 byte bitmap controlling which GPS preflight checks are performed. Set to 0 to bypass all checks. Set to 255 perform all checks. Set to 3 to check just the number of satellites and HDoP. Set to 31 for the most rigorous checks that will still allow checks to pass when the copter is moving, eg launch from a boat.
Bitmask |
Bit |
Meaning |
0 |
NSats |
1 |
HDoP |
2 |
speed error |
3 |
position error |
4 |
yaw error |
5 |
pos drift |
6 |
vert speed |
7 |
horiz speed |
|
EK3_IMU_MASK: Bitmask of active IMUs
Note: This parameter is for advanced users
1 byte bitmap of IMUs to use in EKF3. A separate instance of EKF3 will be started for each IMU selected. Set to 1 to use the first IMU only (default), set to 2 to use the second IMU only, set to 3 to use the first and second IMU. Additional IMU’s can be used up to a maximum of 6 if memory and processing resources permit. There may be insufficient memory and processing resources to run multiple instances. If this occurs EKF3 will fail to start.
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
FirstIMU |
1 |
SecondIMU |
2 |
ThirdIMU |
3 |
FourthIMU |
4 |
FifthIMU |
5 |
SixthIMU |
|
True |
EK3_CHECK_SCALE: GPS accuracy check scaler (%)
Note: This parameter is for advanced users
This scales the thresholds that are used to check GPS accuracy before it is used by the EKF. A value of 100 is the default. Values greater than 100 increase and values less than 100 reduce the maximum GPS error the EKF will accept. A value of 200 will double the allowable GPS error.
Range |
Units |
50 - 200 |
percent |
EK3_NOAID_M_NSE: Non-GPS operation position uncertainty (m)
Note: This parameter is for advanced users
This sets the amount of position variation that the EKF allows for when operating without external measurements (eg GPS or optical flow). Increasing this parameter makes the EKF attitude estimate less sensitive to vehicle manoeuvres but more sensitive to IMU errors.
Range |
Units |
0.5 - 50.0 |
meters |
EK3_LOG_MASK: EKF sensor logging IMU mask
Note: This parameter is for advanced users
This sets the IMU mask of sensors to do full logging for
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
FirstIMU |
1 |
SecondIMU |
2 |
ThirdIMU |
3 |
FourthIMU |
4 |
FifthIMU |
5 |
SixthIMU |
|
True |
EK3_YAW_M_NSE: Yaw measurement noise (rad)
Note: This parameter is for advanced users
This is the RMS value of noise in yaw measurements from the magnetometer. Increasing it reduces the weighting on these measurements.
Range |
Increment |
Units |
0.05 - 1.0 |
0.05 |
radians |
EK3_YAW_I_GATE: Yaw measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the magnetometer yaw measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_TAU_OUTPUT: Output complementary filter time constant (centi-sec)
Note: This parameter is for advanced users
Sets the time constant of the output complementary filter/predictor in centi-seconds.
Range |
Increment |
Units |
10 - 50 |
5 |
centiseconds |
EK3_MAGE_P_NSE: Earth magnetic field process noise (gauss/s)
Note: This parameter is for advanced users
This state process noise controls the growth of earth magnetic field state error estimates. Increasing it makes earth magnetic field estimation faster and noisier.
Range |
Units |
0.00001 - 0.01 |
gauss per second |
EK3_MAGB_P_NSE: Body magnetic field process noise (gauss/s)
Note: This parameter is for advanced users
This state process noise controls the growth of body magnetic field state error estimates. Increasing it makes magnetometer bias error estimation faster and noisier.
Range |
Units |
0.00001 - 0.01 |
gauss per second |
EK3_RNG_USE_HGT: Range finder switch height percentage
Note: This parameter is for advanced users
The range finder will be used as the primary height source when below a specified percentage of the sensor maximum as set by the RNGFND_MAX_CM parameter. Set to -1 to prevent range finder use.
Range |
Increment |
Units |
-1 - 70 |
1 |
percent |
EK3_TERR_GRAD: Maximum terrain gradient
Note: This parameter is for advanced users
Specifies the maximum gradient of the terrain below the vehicle when it is using range finder as a height reference
Range |
Increment |
0 - 0.2 |
0.01 |
EK3_BCN_M_NSE: Range beacon measurement noise (m)
Note: This parameter is for advanced users
This is the RMS value of noise in the range beacon measurement. Increasing it reduces the weighting on this measurement.
Range |
Increment |
Units |
0.1 - 10.0 |
0.1 |
meters |
EK3_BCN_I_GTE: Range beacon measurement gate size
Note: This parameter is for advanced users
This sets the percentage number of standard deviations applied to the range beacon measurement innovation consistency check. Decreasing it makes it more likely that good measurements will be rejected. Increasing it makes it more likely that bad measurements will be accepted.
Range |
Increment |
100 - 1000 |
25 |
EK3_BCN_DELAY: Range beacon measurement delay (msec)
Note: This parameter is for advanced users
This is the number of msec that the range beacon measurements lag behind the inertial measurements.
Range |
Increment |
Units |
RebootRequired |
0 - 250 |
10 |
milliseconds |
True |
EK3_RNG_USE_SPD: Range finder max ground speed
Note: This parameter is for advanced users
The range finder will not be used as the primary height source when the horizontal ground speed is greater than this value.
Range |
Increment |
Units |
2.0 - 6.0 |
0.5 |
meters per second |
EK3_ACC_BIAS_LIM: Accelerometer bias limit
Note: This parameter is for advanced users
The accelerometer bias state will be limited to +- this value
Range |
Increment |
Units |
0.5 - 2.5 |
0.1 |
meters per square second |
EK3_MAG_MASK: Bitmask of active EKF cores that will always use heading fusion
Note: This parameter is for advanced users
1 byte bitmap of EKF cores that will disable magnetic field states and use simple magnetic heading fusion at all times. This parameter enables specified cores to be used as a backup for flight into an environment with high levels of external magnetic interference which may degrade the EKF attitude estimate when using 3-axis magnetometer fusion. NOTE : Use of a different magnetometer fusion algorithm on different cores makes unwanted EKF core switches due to magnetometer errors more likely.
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
FirstEKF |
1 |
SecondEKF |
2 |
ThirdEKF |
3 |
FourthEKF |
4 |
FifthEKF |
5 |
SixthEKF |
|
True |
EK3_OGN_HGT_MASK: Bitmask control of EKF reference height correction
Note: This parameter is for advanced users
When a height sensor other than GPS is used as the primary height source by the EKF, the position of the zero height datum is defined by that sensor and its frame of reference. If a GPS height measurement is also available, then the height of the WGS-84 height datum used by the EKF can be corrected so that the height returned by the getLLH() function is compensated for primary height sensor drift and change in datum over time. The first two bit positions control when the height datum will be corrected. Correction is performed using a Bayes filter and only operates when GPS quality permits. The third bit position controls where the corrections to the GPS reference datum are applied. Corrections can be applied to the local vertical position or to the reported EKF origin height (default).
Bitmask |
RebootRequired |
Bit |
Meaning |
0 |
Correct when using Baro height |
1 |
Correct when using range finder height |
2 |
Apply corrections to local position |
|
True |
EK3_VIS_VERR_MIN: Visual odometry minimum velocity error
Note: This parameter is for advanced users
This is the 1-STD odometry velocity observation error that will be assumed when maximum quality is reported by the sensor. When quality is between max and min, the error will be calculated using linear interpolation between VIS_VERR_MIN and VIS_VERR_MAX.
Range |
Increment |
Units |
0.05 - 0.5 |
0.05 |
meters per second |
EK3_VIS_VERR_MAX: Visual odometry maximum velocity error
Note: This parameter is for advanced users
This is the 1-STD odometry velocity observation error that will be assumed when minimum quality is reported by the sensor. When quality is between max and min, the error will be calculated using linear interpolation between VIS_VERR_MIN and VIS_VERR_MAX.
Range |
Increment |
Units |
0.5 - 5.0 |
0.1 |
meters per second |
EK3_WENC_VERR: Wheel odometry velocity error
Note: This parameter is for advanced users
This is the 1-STD odometry velocity observation error that will be assumed when wheel encoder data is being fused.
Range |
Increment |
Units |
0.01 - 1.0 |
0.1 |
meters per second |
GPS_ Parameters
GPS_TYPE: GPS type
Note: This parameter is for advanced users
GPS type
Values |
RebootRequired |
Value |
Meaning |
0 |
None |
1 |
AUTO |
2 |
uBlox |
3 |
MTK |
4 |
MTK19 |
5 |
NMEA |
6 |
SiRF |
7 |
HIL |
8 |
SwiftNav |
9 |
UAVCAN |
10 |
SBF |
11 |
GSOF |
13 |
ERB |
14 |
MAV |
15 |
NOVA |
|
True |
GPS_TYPE2: 2nd GPS type
Note: This parameter is for advanced users
GPS type of 2nd GPS
Values |
RebootRequired |
Value |
Meaning |
0 |
None |
1 |
AUTO |
2 |
uBlox |
3 |
MTK |
4 |
MTK19 |
5 |
NMEA |
6 |
SiRF |
7 |
HIL |
8 |
SwiftNav |
9 |
UAVCAN |
10 |
SBF |
11 |
GSOF |
13 |
ERB |
14 |
MAV |
15 |
NOVA |
|
True |
GPS_NAVFILTER: Navigation filter setting
Note: This parameter is for advanced users
Navigation filter engine setting
Values |
Value |
Meaning |
0 |
Portable |
2 |
Stationary |
3 |
Pedestrian |
4 |
Automotive |
5 |
Sea |
6 |
Airborne1G |
7 |
Airborne2G |
8 |
Airborne4G |
|
GPS_AUTO_SWITCH: Automatic Switchover Setting
Note: This parameter is for advanced users
Automatic switchover to GPS reporting best lock
Values |
Value |
Meaning |
0 |
Disabled |
1 |
UseBest |
2 |
Blend |
|
GPS_MIN_DGPS: Minimum Lock Type Accepted for DGPS
Note: This parameter is for advanced users
Sets the minimum type of differential GPS corrections required before allowing to switch into DGPS mode.
Values |
RebootRequired |
Value |
Meaning |
0 |
Any |
50 |
FloatRTK |
100 |
IntegerRTK |
|
True |
GPS_SBAS_MODE: SBAS Mode
Note: This parameter is for advanced users
This sets the SBAS (satellite based augmentation system) mode if available on this GPS. If set to 2 then the SBAS mode is not changed in the GPS. Otherwise the GPS will be reconfigured to enable/disable SBAS. Disabling SBAS may be worthwhile in some parts of the world where an SBAS signal is available but the baseline is too long to be useful.
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
2 |
NoChange |
|
GPS_MIN_ELEV: Minimum elevation
Note: This parameter is for advanced users
This sets the minimum elevation of satellites above the horizon for them to be used for navigation. Setting this to -100 leaves the minimum elevation set to the GPS modules default.
Range |
Units |
-100 - 90 |
degrees |
GPS_INJECT_TO: Destination for GPS_INJECT_DATA MAVLink packets
Note: This parameter is for advanced users
The GGS can send raw serial packets to inject data to multiple GPSes.
Values |
Value |
Meaning |
0 |
send to first GPS |
1 |
send to 2nd GPS |
127 |
send to all |
|
GPS_SBP_LOGMASK: Swift Binary Protocol Logging Mask
Note: This parameter is for advanced users
Masked with the SBP msg_type field to determine whether SBR1/SBR2 data is logged
Values |
Value |
Meaning |
0 |
None (0x0000) |
-1 |
All (0xFFFF) |
-256 |
External only (0xFF00) |
|
GPS_RAW_DATA: Raw data logging
Note: This parameter is for advanced users
Handles logging raw data; on uBlox chips that support raw data this will log RXM messages into dataflash log; on Septentrio this will log on the equipment’s SD card and when set to 2, the autopilot will try to stop logging after disarming and restart after arming
Values |
RebootRequired |
Value |
Meaning |
0 |
Ignore |
1 |
Always log |
2 |
Stop logging when disarmed (SBF only) |
5 |
Only log every five samples (uBlox only) |
|
True |
GPS_GNSS_MODE: GNSS system configuration
Note: This parameter is for advanced users
Bitmask for what GNSS system to use on the first GPS (all unchecked or zero to leave GPS as configured)
Bitmask |
Values |
Bit |
Meaning |
0 |
GPS |
1 |
SBAS |
2 |
Galileo |
3 |
Beidou |
4 |
IMES |
5 |
QZSS |
6 |
GLOSNASS |
|
Value |
Meaning |
0 |
Leave as currently configured |
1 |
GPS-NoSBAS |
3 |
GPS+SBAS |
4 |
Galileo-NoSBAS |
6 |
Galileo+SBAS |
8 |
Beidou |
51 |
GPS+IMES+QZSS+SBAS (Japan Only) |
64 |
GLONASS |
66 |
GLONASS+SBAS |
67 |
GPS+GLONASS+SBAS |
|
GPS_SAVE_CFG: Save GPS configuration
Note: This parameter is for advanced users
Determines whether the configuration for this GPS should be written to non-volatile memory on the GPS. Currently working for UBlox 6 series and above.
Values |
Value |
Meaning |
0 |
Do not save config |
1 |
Save config |
2 |
Save only when needed |
|
GPS_GNSS_MODE2: GNSS system configuration
Note: This parameter is for advanced users
Bitmask for what GNSS system to use on the second GPS (all unchecked or zero to leave GPS as configured)
Bitmask |
Values |
Bit |
Meaning |
0 |
GPS |
1 |
SBAS |
2 |
Galileo |
3 |
Beidou |
4 |
IMES |
5 |
QZSS |
6 |
GLOSNASS |
|
Value |
Meaning |
0 |
Leave as currently configured |
1 |
GPS-NoSBAS |
3 |
GPS+SBAS |
4 |
Galileo-NoSBAS |
6 |
Galileo+SBAS |
8 |
Beidou |
51 |
GPS+IMES+QZSS+SBAS (Japan Only) |
64 |
GLONASS |
66 |
GLONASS+SBAS |
67 |
GPS+GLONASS+SBAS |
|
GPS_AUTO_CONFIG: Automatic GPS configuration
Note: This parameter is for advanced users
Controls if the autopilot should automatically configure the GPS based on the parameters and default settings
Values |
Value |
Meaning |
0 |
Disables automatic configuration |
1 |
Enable automatic configuration |
|
GPS_RATE_MS: GPS update rate in milliseconds
Note: This parameter is for advanced users
Controls how often the GPS should provide a position update. Lowering below 5Hz is not allowed
Range |
Values |
Units |
50 - 200 |
Value |
Meaning |
100 |
10Hz |
125 |
8Hz |
200 |
5Hz |
|
milliseconds |
GPS_RATE_MS2: GPS 2 update rate in milliseconds
Note: This parameter is for advanced users
Controls how often the GPS should provide a position update. Lowering below 5Hz is not allowed
Range |
Values |
Units |
50 - 200 |
Value |
Meaning |
100 |
10Hz |
125 |
8Hz |
200 |
5Hz |
|
milliseconds |
GPS_POS1_X: Antenna X position offset
Note: This parameter is for advanced users
X position of the first GPS antenna in body frame. Positive X is forward of the origin. Use antenna phase centroid location if provided by the manufacturer.
GPS_POS1_Y: Antenna Y position offset
Note: This parameter is for advanced users
Y position of the first GPS antenna in body frame. Positive Y is to the right of the origin. Use antenna phase centroid location if provided by the manufacturer.
GPS_POS1_Z: Antenna Z position offset
Note: This parameter is for advanced users
Z position of the first GPS antenna in body frame. Positive Z is down from the origin. Use antenna phase centroid location if provided by the manufacturer.
GPS_POS2_X: Antenna X position offset
Note: This parameter is for advanced users
X position of the second GPS antenna in body frame. Positive X is forward of the origin. Use antenna phase centroid location if provided by the manufacturer.
GPS_POS2_Y: Antenna Y position offset
Note: This parameter is for advanced users
Y position of the second GPS antenna in body frame. Positive Y is to the right of the origin. Use antenna phase centroid location if provided by the manufacturer.
GPS_POS2_Z: Antenna Z position offset
Note: This parameter is for advanced users
Z position of the second GPS antenna in body frame. Positive Z is down from the origin. Use antenna phase centroid location if provided by the manufacturer.
GPS_DELAY_MS: GPS delay in milliseconds
Note: This parameter is for advanced users
Controls the amount of GPS measurement delay that the autopilot compensates for. Set to zero to use the default delay for the detected GPS type.
Range |
Units |
RebootRequired |
0 - 250 |
milliseconds |
True |
GPS_DELAY_MS2: GPS 2 delay in milliseconds
Note: This parameter is for advanced users
Controls the amount of GPS measurement delay that the autopilot compensates for. Set to zero to use the default delay for the detected GPS type.
Range |
Units |
RebootRequired |
0 - 250 |
milliseconds |
True |
GPS_BLEND_MASK: Multi GPS Blending Mask
Note: This parameter is for advanced users
Determines which of the accuracy measures Horizontal position, Vertical Position and Speed are used to calculate the weighting on each GPS receiver when soft switching has been selected by setting GPS_AUTO_SWITCH to 2
Bitmask |
Bit |
Meaning |
0 |
Horiz Pos |
1 |
Vert Pos |
2 |
Speed |
|
GPS_BLEND_TC: Blending time constant
Note: This parameter is for advanced users
Controls the slowest time constant applied to the calculation of GPS position and height offsets used to adjust different GPS receivers for steady state position differences.
Range |
Units |
5.0 - 30.0 |
seconds |
H_ Parameters
H_SV1_POS: Servo 1 Position
Angular location of swash servo #1 - only used for H3 swash type
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_SV2_POS: Servo 2 Position
Angular location of swash servo #2 - only used for H3 swash type
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_SV3_POS: Servo 3 Position
Angular location of swash servo #3 - only used for H3 swash type
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_TAIL_TYPE: Tail Type
Tail type selection. Simpler yaw controller used if external gyro is selected
Values |
Value |
Meaning |
0 |
Servo only |
1 |
Servo with ExtGyro |
2 |
DirectDrive VarPitch |
3 |
DirectDrive FixedPitch |
|
H_SWASH_TYPE: Swash Type
Swash Type Setting
Values |
Value |
Meaning |
0 |
H3 CCPM Adjustable |
1 |
H1 Straight Swash |
2 |
H3_140 CCPM |
|
H_GYR_GAIN: External Gyro Gain
PWM in microseconds sent to external gyro on ch7 when tail type is Servo w/ ExtGyro
Range |
Increment |
Units |
0 - 1000 |
1 |
PWM in microseconds |
H_PHANG: Swashplate Phase Angle Compensation
Note: This parameter is for advanced users
Only for H3 swashplate. If pitching the swash forward induces a roll, this can be correct the problem
Range |
Increment |
Units |
-30 - 30 |
1 |
degrees |
H_COLYAW: Collective-Yaw Mixing
Note: This parameter is for advanced users
Feed-forward compensation to automatically add rudder input when collective pitch is increased. Can be positive or negative depending on mechanics.
Range |
Increment |
-10 - 10 |
0.1 |
H_FLYBAR_MODE: Flybar Mode Selector
Flybar present or not. Affects attitude controller used during ACRO flight mode
Values |
Value |
Meaning |
0 |
NoFlybar |
1 |
Flybar |
|
H_TAIL_SPEED: Direct Drive VarPitch Tail ESC speed
Direct Drive VarPitch Tail ESC speed in PWM microseconds. Only used when TailType is DirectDrive VarPitch
Range |
Increment |
Units |
0 - 1000 |
1 |
PWM in microseconds |
H_GYR_GAIN_ACRO: External Gyro Gain for ACRO
PWM in microseconds sent to external gyro on ch7 when tail type is Servo w/ ExtGyro. A value of zero means to use H_GYR_GAIN
Range |
Increment |
Units |
0 - 1000 |
1 |
PWM in microseconds |
H_COL_CTRL_DIR: Collective Control Direction
Direction collective moves for positive pitch. 0 for Normal, 1 for Reversed
Values |
Value |
Meaning |
0 |
Normal |
1 |
Reversed |
|
H_SV1_POS: Servo 1 Position
Angular location of swash servo #1
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_SV2_POS: Servo 2 Position
Angular location of swash servo #2
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_SV3_POS: Servo 3 Position
Angular location of swash servo #3
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_SV4_POS: Servo 4 Position
Angular location of swash servo #4
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_SV5_POS: Servo 5 Position
Angular location of swash servo #5
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_SV6_POS: Servo 6 Position
Angular location of swash servo #6
Range |
Increment |
Units |
-180 - 180 |
1 |
degrees |
H_PHANG1: Swashplate 1 Phase Angle Compensation
Note: This parameter is for advanced users
Phase angle correction for rotor head. If pitching the swash forward induces a roll, this can be correct the problem
Range |
Increment |
Units |
-90 - 90 |
1 |
degrees |
H_PHANG2: Swashplate 2 Phase Angle Compensation
Note: This parameter is for advanced users
Phase angle correction for rotor head. If pitching the swash forward induces a roll, this can be correct the problem
Range |
Increment |
Units |
-90 - 90 |
1 |
degrees |
H_DUAL_MODE: Dual Mode
Sets the dual mode of the heli, either as tandem or as transverse.
Values |
Value |
Meaning |
0 |
Longitudinal |
1 |
Transverse |
|
H_DCP_SCALER: Differential-Collective-Pitch Scaler
Scaling factor applied to the differential-collective-pitch
H_DCP_YAW: Differential-Collective-Pitch Yaw Mixing
Feed-forward compensation to automatically add yaw input when differential collective pitch is applied.
Range |
Increment |
-10 - 10 |
0.1 |
H_YAW_SCALER: Scaler for yaw mixing
Scaler for mixing yaw into roll or pitch.
Range |
Increment |
-10 - 10 |
0.1 |
H_COL2_MIN: Collective Pitch Minimum for rear swashplate
Lowest possible servo position in PWM microseconds for the rear swashplate
Range |
Increment |
Units |
1000 - 2000 |
1 |
PWM in microseconds |
H_COL2_MAX: Collective Pitch Maximum for rear swashplate
Highest possible servo position in PWM microseconds for the rear swashplate
Range |
Increment |
Units |
1000 - 2000 |
1 |
PWM in microseconds |
H_COL2_MID: Collective Pitch Mid-Point for rear swashplate
Swash servo position in PWM microseconds corresponding to zero collective pitch for the rear swashplate (or zero lift for Asymmetrical blades)
Range |
Increment |
Units |
1000 - 2000 |
1 |
PWM in microseconds |
H_COL_CTRL_DIR: Collective Control Direction
Direction collective moves for positive pitch. 0 for Normal, 1 for Reversed
Values |
Value |
Meaning |
0 |
Normal |
1 |
Reversed |
|
H_COL_MIN: Collective Pitch Minimum
Lowest possible servo position in PWM microseconds for the swashplate
Range |
Increment |
Units |
1000 - 2000 |
1 |
PWM in microseconds |
H_COL_MAX: Collective Pitch Maximum
Highest possible servo position in PWM microseconds for the swashplate
Range |
Increment |
Units |
1000 - 2000 |
1 |
PWM in microseconds |
H_COL_MID: Collective Pitch Mid-Point
Swash servo position in PWM microseconds corresponding to zero collective pitch (or zero lift for Asymmetrical blades)
Range |
Increment |
Units |
1000 - 2000 |
1 |
PWM in microseconds |
H_SV_MAN: Manual Servo Mode
Manual servo override for swash set-up. Do not set this manually!
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Passthrough |
2 |
Max collective |
3 |
Mid collective |
4 |
Min collective |
|
H_RSC_SETPOINT: External Motor Governor Setpoint
PWM in microseconds passed to the external motor governor when external governor is enabled
Range |
Increment |
Units |
0 - 1000 |
10 |
PWM in microseconds |
H_RSC_MODE: Rotor Speed Control Mode
Determines the method of rotor speed control
Values |
Value |
Meaning |
1 |
Ch8 Input |
2 |
SetPoint |
3 |
Throttle Curve |
|
H_LAND_COL_MIN: Landing Collective Minimum
Minimum collective position in PWM microseconds while landed or landing
Range |
Increment |
Units |
0 - 500 |
1 |
PWM in microseconds |
H_RSC_RAMP_TIME: RSC Ramp Time
Time in seconds for the output to the main rotor’s ESC to reach full speed
Range |
Units |
0 - 60 |
seconds |
H_RSC_RUNUP_TIME: RSC Runup Time
Time in seconds for the main rotor to reach full speed. Must be longer than RSC_RAMP_TIME
Range |
Units |
0 - 60 |
seconds |
H_RSC_CRITICAL: Critical Rotor Speed
Rotor speed below which flight is not possible
Range |
Increment |
0 - 1000 |
10 |
H_RSC_IDLE: Rotor Speed Output at Idle
Rotor speed output while armed but rotor control speed is not engaged
Range |
Increment |
0 - 500 |
10 |
H_CYC_MAX: Cyclic Pitch Angle Max
Note: This parameter is for advanced users
Maximum pitch angle of the swash plate
Range |
Increment |
Units |
0 - 18000 |
100 |
centidegrees |
H_SV_TEST: Boot-up Servo Test Cycles
Number of cycles to run servo test on boot-up
H_RSC_SLEWRATE: Throttle servo slew rate
This controls the maximum rate at which the throttle output can change, as a percentage per second. A value of 100 means the throttle can change over its full range in one second. A value of zero gives unlimited slew rate.
Range |
Increment |
0 - 500 |
10 |
H_RSC_THRCRV_0: Throttle Servo Position for 0 percent collective
Throttle Servo Position for 0 percent collective. This is on a scale from 0 to 1000, where 1000 is full throttle and 0 is zero throttle. Actual PWM values are controlled by SERVOX_MIN and SERVOX_MAX. The 0 percent collective is defined by H_COL_MIN and 100 percent collective is defined by H_COL_MAX.
Range |
Increment |
0 - 1000 |
10 |
H_RSC_THRCRV_25: Throttle Servo Position for 25 percent collective
Throttle Servo Position for 25 percent collective. This is on a scale from 0 to 1000, where 1000 is full throttle and 0 is zero throttle. Actual PWM values are controlled by SERVOX_MIN and SERVOX_MAX. The 0 percent collective is defined by H_COL_MIN and 100 percent collective is defined by H_COL_MAX.
Range |
Increment |
0 - 1000 |
10 |
H_RSC_THRCRV_50: Throttle Servo Position for 50 percent collective
Throttle Servo Position for 50 percent collective. This is on a scale from 0 to 1000, where 1000 is full throttle and 0 is zero throttle. Actual PWM values are controlled by SERVOX_MIN and SERVOX_MAX. The 0 percent collective is defined by H_COL_MIN and 100 percent collective is defined by H_COL_MAX.
Range |
Increment |
0 - 1000 |
10 |
H_RSC_THRCRV_75: Throttle Servo Position for 75 percent collective
Throttle Servo Position for 75 percent collective. This is on a scale from 0 to 1000, where 1000 is full throttle and 0 is zero throttle. Actual PWM values are controlled by SERVOX_MIN and SERVOX_MAX. The 0 percent collective is defined by H_COL_MIN and 100 percent collective is defined by H_COL_MAX.
Range |
Increment |
0 - 1000 |
10 |
H_RSC_THRCRV_100: Throttle Servo Position for 100 percent collective
Throttle Servo Position for 100 percent collective. This is on a scale from 0 to 1000, where 1000 is full throttle and 0 is zero throttle. Actual PWM values are controlled by SERVOX_MIN and SERVOX_MAX. The 0 percent collective is defined by H_COL_MIN and 100 percent collective is defined by H_COL_MAX.
Range |
Increment |
0 - 1000 |
10 |
INS_ Parameters
INS_PRODUCT_ID: IMU Product ID
Note: This parameter is for advanced users
unused
INS_GYROFFS_X: Gyro offsets of X axis
Note: This parameter is for advanced users
Gyro sensor offsets of X axis. This is setup on each boot during gyro calibrations
INS_GYROFFS_Y: Gyro offsets of Y axis
Note: This parameter is for advanced users
Gyro sensor offsets of Y axis. This is setup on each boot during gyro calibrations
INS_GYROFFS_Z: Gyro offsets of Z axis
Note: This parameter is for advanced users
Gyro sensor offsets of Z axis. This is setup on each boot during gyro calibrations
INS_GYR2OFFS_X: Gyro2 offsets of X axis
Note: This parameter is for advanced users
Gyro2 sensor offsets of X axis. This is setup on each boot during gyro calibrations
INS_GYR2OFFS_Y: Gyro2 offsets of Y axis
Note: This parameter is for advanced users
Gyro2 sensor offsets of Y axis. This is setup on each boot during gyro calibrations
INS_GYR2OFFS_Z: Gyro2 offsets of Z axis
Note: This parameter is for advanced users
Gyro2 sensor offsets of Z axis. This is setup on each boot during gyro calibrations
INS_GYR3OFFS_X: Gyro3 offsets of X axis
Note: This parameter is for advanced users
Gyro3 sensor offsets of X axis. This is setup on each boot during gyro calibrations
INS_GYR3OFFS_Y: Gyro3 offsets of Y axis
Note: This parameter is for advanced users
Gyro3 sensor offsets of Y axis. This is setup on each boot during gyro calibrations
INS_GYR3OFFS_Z: Gyro3 offsets of Z axis
Note: This parameter is for advanced users
Gyro3 sensor offsets of Z axis. This is setup on each boot during gyro calibrations
INS_ACCSCAL_X: Accelerometer scaling of X axis
Note: This parameter is for advanced users
Accelerometer scaling of X axis. Calculated during acceleration calibration routine
INS_ACCSCAL_Y: Accelerometer scaling of Y axis
Note: This parameter is for advanced users
Accelerometer scaling of Y axis Calculated during acceleration calibration routine
INS_ACCSCAL_Z: Accelerometer scaling of Z axis
Note: This parameter is for advanced users
Accelerometer scaling of Z axis Calculated during acceleration calibration routine
INS_ACCOFFS_X: Accelerometer offsets of X axis
Note: This parameter is for advanced users
Accelerometer offsets of X axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACCOFFS_Y: Accelerometer offsets of Y axis
Note: This parameter is for advanced users
Accelerometer offsets of Y axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACCOFFS_Z: Accelerometer offsets of Z axis
Note: This parameter is for advanced users
Accelerometer offsets of Z axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACC2SCAL_X: Accelerometer2 scaling of X axis
Note: This parameter is for advanced users
Accelerometer2 scaling of X axis. Calculated during acceleration calibration routine
INS_ACC2SCAL_Y: Accelerometer2 scaling of Y axis
Note: This parameter is for advanced users
Accelerometer2 scaling of Y axis Calculated during acceleration calibration routine
INS_ACC2SCAL_Z: Accelerometer2 scaling of Z axis
Note: This parameter is for advanced users
Accelerometer2 scaling of Z axis Calculated during acceleration calibration routine
INS_ACC2OFFS_X: Accelerometer2 offsets of X axis
Note: This parameter is for advanced users
Accelerometer2 offsets of X axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACC2OFFS_Y: Accelerometer2 offsets of Y axis
Note: This parameter is for advanced users
Accelerometer2 offsets of Y axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACC2OFFS_Z: Accelerometer2 offsets of Z axis
Note: This parameter is for advanced users
Accelerometer2 offsets of Z axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACC3SCAL_X: Accelerometer3 scaling of X axis
Note: This parameter is for advanced users
Accelerometer3 scaling of X axis. Calculated during acceleration calibration routine
INS_ACC3SCAL_Y: Accelerometer3 scaling of Y axis
Note: This parameter is for advanced users
Accelerometer3 scaling of Y axis Calculated during acceleration calibration routine
INS_ACC3SCAL_Z: Accelerometer3 scaling of Z axis
Note: This parameter is for advanced users
Accelerometer3 scaling of Z axis Calculated during acceleration calibration routine
INS_ACC3OFFS_X: Accelerometer3 offsets of X axis
Note: This parameter is for advanced users
Accelerometer3 offsets of X axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACC3OFFS_Y: Accelerometer3 offsets of Y axis
Note: This parameter is for advanced users
Accelerometer3 offsets of Y axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_ACC3OFFS_Z: Accelerometer3 offsets of Z axis
Note: This parameter is for advanced users
Accelerometer3 offsets of Z axis. This is setup using the acceleration calibration or level operations
Range |
Units |
-3.5 - 3.5 |
meters per square second |
INS_GYRO_FILTER: Gyro filter cutoff frequency
Note: This parameter is for advanced users
Filter cutoff frequency for gyroscopes. This can be set to a lower value to try to cope with very high vibration levels in aircraft. This option takes effect on the next reboot. A value of zero means no filtering (not recommended!)
Range |
Units |
0 - 127 |
hertz |
INS_ACCEL_FILTER: Accel filter cutoff frequency
Note: This parameter is for advanced users
Filter cutoff frequency for accelerometers. This can be set to a lower value to try to cope with very high vibration levels in aircraft. This option takes effect on the next reboot. A value of zero means no filtering (not recommended!)
Range |
Units |
0 - 127 |
hertz |
INS_USE: Use first IMU for attitude, velocity and position estimates
Note: This parameter is for advanced users
Use first IMU for attitude, velocity and position estimates
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
INS_USE2: Use second IMU for attitude, velocity and position estimates
Note: This parameter is for advanced users
Use second IMU for attitude, velocity and position estimates
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
INS_USE3: Use third IMU for attitude, velocity and position estimates
Note: This parameter is for advanced users
Use third IMU for attitude, velocity and position estimates
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
INS_STILL_THRESH: Stillness threshold for detecting if we are moving
Note: This parameter is for advanced users
Threshold to tolerate vibration to determine if vehicle is motionless. This depends on the frame type and if there is a constant vibration due to motors before launch or after landing. Total motionless is about 0.05. Suggested values: Planes/rover use 0.1, multirotors use 1, tradHeli uses 5
INS_GYR_CAL: Gyro Calibration scheme
Note: This parameter is for advanced users
Conrols when automatic gyro calibration is performed
Values |
Value |
Meaning |
0 |
Never |
1 |
Start-up only |
|
INS_TRIM_OPTION: Accel cal trim option
Note: This parameter is for advanced users
Specifies how the accel cal routine determines the trims
Values |
Value |
Meaning |
0 |
Don’t adjust the trims |
1 |
Assume first orientation was level |
2 |
Assume ACC_BODYFIX is perfectly aligned to the vehicle |
|
INS_ACC_BODYFIX: Body-fixed accelerometer
Note: This parameter is for advanced users
The body-fixed accelerometer to be used for trim calculation
Values |
Value |
Meaning |
1 |
IMU 1 |
2 |
IMU 2 |
3 |
IMU 3 |
|
INS_POS1_X: IMU accelerometer X position
Note: This parameter is for advanced users
X position of the first IMU Accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS1_Y: IMU accelerometer Y position
Note: This parameter is for advanced users
Y position of the first IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS1_Z: IMU accelerometer Z position
Note: This parameter is for advanced users
Z position of the first IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS2_X: IMU accelerometer X position
Note: This parameter is for advanced users
X position of the second IMU accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS2_Y: IMU accelerometer Y position
Note: This parameter is for advanced users
Y position of the second IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS2_Z: IMU accelerometer Z position
Note: This parameter is for advanced users
Z position of the second IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS3_X: IMU accelerometer X position
Note: This parameter is for advanced users
X position of the third IMU accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS3_Y: IMU accelerometer Y position
Note: This parameter is for advanced users
Y position of the third IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_POS3_Z: IMU accelerometer Z position
Note: This parameter is for advanced users
Z position of the third IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
INS_GYR_ID: Gyro ID
Note: This parameter is for advanced users
Gyro sensor ID, taking into account its type, bus and instance
INS_GYR2_ID: Gyro2 ID
Note: This parameter is for advanced users
Gyro2 sensor ID, taking into account its type, bus and instance
INS_GYR3_ID: Gyro3 ID
Note: This parameter is for advanced users
Gyro3 sensor ID, taking into account its type, bus and instance
INS_ACC_ID: Accelerometer ID
Note: This parameter is for advanced users
Accelerometer sensor ID, taking into account its type, bus and instance
INS_ACC2_ID: Accelerometer2 ID
Note: This parameter is for advanced users
Accelerometer2 sensor ID, taking into account its type, bus and instance
INS_ACC3_ID: Accelerometer3 ID
Note: This parameter is for advanced users
Accelerometer3 sensor ID, taking into account its type, bus and instance
INS_FAST_SAMPLE: Fast sampling mask
Note: This parameter is for advanced users
Mask of IMUs to enable fast sampling on, if available
Bitmask |
Values |
Bit |
Meaning |
0 |
FirstIMU |
1 |
SecondIMU |
2 |
ThirdIMU |
|
Value |
Meaning |
1 |
FirstIMUOnly |
3 |
FirstAndSecondIMU |
|
MNT Parameters
MNT_DEFLT_MODE: Mount default operating mode
Mount default operating mode on startup and after control is returned from autopilot
Values |
Value |
Meaning |
0 |
Retracted |
1 |
Neutral |
2 |
MavLink Targeting |
3 |
RC Targeting |
4 |
GPS Point |
|
MNT_RETRACT_X: Mount roll angle when in retracted position
Mount roll angle when in retracted position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT_RETRACT_Y: Mount tilt/pitch angle when in retracted position
Mount tilt/pitch angle when in retracted position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT_RETRACT_Z: Mount yaw/pan angle when in retracted position
Mount yaw/pan angle when in retracted position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT_NEUTRAL_X: Mount roll angle when in neutral position
Mount roll angle when in neutral position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT_NEUTRAL_Y: Mount tilt/pitch angle when in neutral position
Mount tilt/pitch angle when in neutral position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT_NEUTRAL_Z: Mount pan/yaw angle when in neutral position
Mount pan/yaw angle when in neutral position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT_STAB_ROLL: Stabilize mount’s roll angle
enable roll stabilisation relative to Earth
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
MNT_STAB_TILT: Stabilize mount’s pitch/tilt angle
enable tilt/pitch stabilisation relative to Earth
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
MNT_STAB_PAN: Stabilize mount pan/yaw angle
enable pan/yaw stabilisation relative to Earth
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
MNT_ANGMIN_ROL: Minimum roll angle
Minimum physical roll angular position of mount.
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT_ANGMAX_ROL: Maximum roll angle
Maximum physical roll angular position of the mount
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT_ANGMIN_TIL: Minimum tilt angle
Minimum physical tilt (pitch) angular position of mount.
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT_ANGMAX_TIL: Maximum tilt angle
Maximum physical tilt (pitch) angular position of the mount
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT_ANGMIN_PAN: Minimum pan angle
Minimum physical pan (yaw) angular position of mount.
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT_ANGMAX_PAN: Maximum pan angle
Maximum physical pan (yaw) angular position of the mount
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT_JSTICK_SPD: mount joystick speed
0 for position control, small for low speeds, 100 for max speed. A good general value is 10 which gives a movement speed of 3 degrees per second.
Range |
Increment |
0 - 100 |
1 |
MNT_LEAD_RLL: Roll stabilization lead time
Causes the servo angle output to lead the current angle of the vehicle by some amount of time based on current angular rate, compensating for servo delay. Increase until the servo is responsive but doesn’t overshoot. Does nothing with pan stabilization enabled.
Range |
Increment |
Units |
0.0 - 0.2 |
.005 |
seconds |
MNT_LEAD_PTCH: Pitch stabilization lead time
Causes the servo angle output to lead the current angle of the vehicle by some amount of time based on current angular rate. Increase until the servo is responsive but doesn’t overshoot. Does nothing with pan stabilization enabled.
Range |
Increment |
Units |
0.0 - 0.2 |
.005 |
seconds |
MNT_TYPE: Mount Type
Mount Type (None, Servo or MAVLink)
Values |
RebootRequired |
Value |
Meaning |
0 |
None |
1 |
Servo |
2 |
3DR Solo |
3 |
Alexmos Serial |
4 |
SToRM32 MAVLink |
5 |
SToRM32 Serial |
|
True |
MNT2_DEFLT_MODE: Mount default operating mode
Mount default operating mode on startup and after control is returned from autopilot
Values |
Value |
Meaning |
0 |
Retracted |
1 |
Neutral |
2 |
MavLink Targeting |
3 |
RC Targeting |
4 |
GPS Point |
|
MNT2_RETRACT_X: Mount2 roll angle when in retracted position
Mount2 roll angle when in retracted position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT2_RETRACT_Y: Mount2 tilt/pitch angle when in retracted position
Mount2 tilt/pitch angle when in retracted position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT2_RETRACT_Z: Mount2 yaw/pan angle when in retracted position
Mount2 yaw/pan angle when in retracted position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT2_NEUTRAL_X: Mount2 roll angle when in neutral position
Mount2 roll angle when in neutral position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT2_NEUTRAL_Y: Mount2 tilt/pitch angle when in neutral position
Mount2 tilt/pitch angle when in neutral position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT2_NEUTRAL_Z: Mount2 pan/yaw angle when in neutral position
Mount2 pan/yaw angle when in neutral position
Range |
Increment |
Units |
-180.00 - 179.99 |
1 |
degrees |
MNT2_STAB_ROLL: Stabilize Mount2’s roll angle
enable roll stabilisation relative to Earth
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
MNT2_STAB_TILT: Stabilize Mount2’s pitch/tilt angle
enable tilt/pitch stabilisation relative to Earth
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
MNT2_STAB_PAN: Stabilize mount2 pan/yaw angle
enable pan/yaw stabilisation relative to Earth
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Enabled |
|
MNT2_ANGMIN_ROL: Mount2’s minimum roll angle
Mount2’s minimum physical roll angular position
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT2_ANGMAX_ROL: Mount2’s maximum roll angle
Mount2’s maximum physical roll angular position
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT2_ANGMIN_TIL: Mount2’s minimum tilt angle
Mount2’s minimum physical tilt (pitch) angular position
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT2_ANGMAX_TIL: Mount2’s maximum tilt angle
Mount2’s maximum physical tilt (pitch) angular position
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT2_ANGMIN_PAN: Mount2’s minimum pan angle
Mount2’s minimum physical pan (yaw) angular position
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT2_ANGMAX_PAN: Mount2’s maximum pan angle
MOunt2’s maximum physical pan (yaw) angular position
Range |
Increment |
Units |
-18000 - 17999 |
1 |
centidegrees |
MNT2_LEAD_RLL: Mount2’s Roll stabilization lead time
Causes the servo angle output to lead the current angle of the vehicle by some amount of time based on current angular rate, compensating for servo delay. Increase until the servo is responsive but doesn’t overshoot. Does nothing with pan stabilization enabled.
Range |
Increment |
Units |
0.0 - 0.2 |
.005 |
seconds |
MNT2_LEAD_PTCH: Mount2’s Pitch stabilization lead time
Causes the servo angle output to lead the current angle of the vehicle by some amount of time based on current angular rate. Increase until the servo is responsive but doesn’t overshoot. Does nothing with pan stabilization enabled.
Range |
Increment |
Units |
0.0 - 0.2 |
.005 |
seconds |
MNT2_TYPE: Mount2 Type
Mount Type (None, Servo or MAVLink)
Values |
Value |
Meaning |
0 |
None |
1 |
Servo |
2 |
3DR Solo |
3 |
Alexmos Serial |
4 |
SToRM32 MAVLink |
5 |
SToRM32 Serial |
|
MOT_ Parameters
MOT_YAW_HEADROOM: Matrix Yaw Min
Note: This parameter is for advanced users
Yaw control is given at least this pwm in microseconds range
Range |
Units |
0 - 500 |
PWM in microseconds |
MOT_THST_EXPO: Thrust Curve Expo
Note: This parameter is for advanced users
Motor thrust curve exponent (from 0 for linear to 1.0 for second order curve)
MOT_SPIN_MAX: Motor Spin maximum
Note: This parameter is for advanced users
Point at which the thrust saturates expressed as a number from 0 to 1 in the entire output range
Values |
0.9:Low, 0.95:Default, 1.0:High |
MOT_BAT_VOLT_MAX: Battery voltage compensation maximum voltage
Note: This parameter is for advanced users
Battery voltage compensation maximum voltage (voltage above this will have no additional scaling effect on thrust). Recommend 4.4 * cell count, 0 = Disabled
MOT_BAT_VOLT_MIN: Battery voltage compensation minimum voltage
Note: This parameter is for advanced users
Battery voltage compensation minimum voltage (voltage below this will have no additional scaling effect on thrust). Recommend 3.5 * cell count, 0 = Disabled
MOT_BAT_CURR_MAX: Motor Current Max
Note: This parameter is for advanced users
Maximum current over which maximum throttle is limited (0 = Disabled)
Range |
Units |
0 - 200 |
ampere |
MOT_PWM_TYPE: Output PWM type
Note: This parameter is for advanced users
This selects the output PWM type, allowing for normal PWM continuous output, OneShot, brushed or DShot motor output
Values |
RebootRequired |
Value |
Meaning |
0 |
Normal |
1 |
OneShot |
2 |
OneShot125 |
3 |
Brushed |
4 |
DShot150 |
5 |
DShot300 |
6 |
DShot600 |
7 |
DShot1200 |
|
True |
MOT_PWM_MIN: PWM output miniumum
Note: This parameter is for advanced users
This sets the min PWM output value in microseconds that will ever be output to the motors, 0 = use input RC3_MIN
Range |
Units |
0 - 2000 |
PWM in microseconds |
MOT_PWM_MAX: PWM output maximum
Note: This parameter is for advanced users
This sets the max PWM value in microseconds that will ever be output to the motors, 0 = use input RC3_MAX
Range |
Units |
0 - 2000 |
PWM in microseconds |
MOT_SPIN_MIN: Motor Spin minimum
Note: This parameter is for advanced users
Point at which the thrust starts expressed as a number from 0 to 1 in the entire output range. Should be higher than MOT_SPIN_ARM.
Values |
0.0:Low, 0.15:Default, 0.3:High |
MOT_SPIN_ARM: Motor Spin armed
Note: This parameter is for advanced users
Point at which the motors start to spin expressed as a number from 0 to 1 in the entire output range. Should be lower than MOT_SPIN_MIN.
Values |
0.0:Low, 0.1:Default, 0.2:High |
MOT_BAT_CURR_TC: Motor Current Max Time Constant
Note: This parameter is for advanced users
Time constant used to limit the maximum current
Range |
Units |
0 - 10 |
seconds |
MOT_THST_HOVER: Thrust Hover Value
Note: This parameter is for advanced users
Motor thrust needed to hover expressed as a number from 0 to 1
MOT_HOVER_LEARN: Hover Value Learning
Note: This parameter is for advanced users
Enable/Disable automatic learning of hover throttle
Values |
Value |
Meaning |
0 |
Disabled |
1 |
Learn |
2 |
LearnAndSave |
|
MOT_SAFE_DISARM: Motor PWM output disabled when disarmed
Note: This parameter is for advanced users
Disables motor PWM output when disarmed
Values |
Value |
Meaning |
0 |
PWM enabled while disarmed |
1 |
PWM disabled while disarmed |
|
MOT_YAW_SV_ANGLE: Yaw Servo Max Lean Angle
Yaw servo’s maximum lean angle
Range |
Increment |
Units |
5 - 80 |
1 |
degrees |
MOT_SPOOL_TIME: Spool up time
Note: This parameter is for advanced users
Time in seconds to spool up the motors from zero to min throttle.
Range |
Increment |
Units |
0 - 2 |
0.1 |
seconds |
MOT_BOOST_SCALE: Motor boost scale
Note: This parameter is for advanced users
This is a scaling factor for vehicles with a vertical booster motor used for extra lift. It is used with electric multicopters that have an internal combusion booster motor for longer endurance. The output to the BoostThrottle servo function is set to the current motor thottle times this scaling factor. A higher scaling factor will put more of the load on the booster motor. A value of 1 will set the BoostThrottle equal to the main throttle.
Range |
Increment |
0 - 5 |
0.1 |
MOT_BAT_IDX: Battery compensation index
Note: This parameter is for advanced users
Which battery monitor should be used for doing compensation
Values |
Value |
Meaning |
0 |
First battery |
1 |
Second battery |
|
RNGFND Parameters
RNGFND_TYPE: Rangefinder type
What type of rangefinder device that is connected
Values |
Value |
Meaning |
0 |
None |
1 |
Analog |
2 |
MaxbotixI2C |
3 |
LidarLiteV2-I2C |
5 |
PX4-PWM |
6 |
BBB-PRU |
7 |
LightWareI2C |
8 |
LightWareSerial |
9 |
Bebop |
10 |
MAVLink |
11 |
uLanding |
12 |
LeddarOne |
13 |
MaxbotixSerial |
14 |
TeraRangerI2C |
15 |
LidarLiteV3-I2C |
16 |
VL53L0X |
17 |
NMEA |
18 |
WASP-LRF |
19 |
BenewakeTF02 |
20 |
BenewakeTFmini |
21 |
LidarLiteV3HP-I2C |
|
RNGFND_PIN: Rangefinder pin
Analog pin that rangefinder is connected to. Set this to 0..9 for the APM2 analog pins. Set to 64 on an APM1 for the dedicated ‘airspeed’ port on the end of the board. Set to 11 on PX4 for the analog ‘airspeed’ port. Set to 15 on the Pixhawk for the analog ‘airspeed’ port.
Values |
Value |
Meaning |
-1 |
Not Used |
0 |
APM2-A0 |
1 |
APM2-A1 |
2 |
APM2-A2 |
3 |
APM2-A3 |
4 |
APM2-A4 |
5 |
APM2-A5 |
6 |
APM2-A6 |
7 |
APM2-A7 |
8 |
APM2-A8 |
9 |
APM2-A9 |
11 |
PX4-airspeed port |
15 |
Pixhawk-airspeed port |
64 |
APM1-airspeed port |
|
RNGFND_SCALING: Rangefinder scaling
Scaling factor between rangefinder reading and distance. For the linear and inverted functions this is in meters per volt. For the hyperbolic function the units are meterVolts.
Increment |
Units |
0.001 |
meters per volt |
RNGFND_OFFSET: rangefinder offset
Offset in volts for zero distance for analog rangefinders. Offset added to distance in centimeters for PWM and I2C Lidars
Increment |
Units |
0.001 |
volt |
RNGFND_FUNCTION: Rangefinder function
Control over what function is used to calculate distance. For a linear function, the distance is (voltage-offset)*scaling. For a inverted function the distance is (offset-voltage)*scaling. For a hyperbolic function the distance is scaling/(voltage-offset). The functions return the distance in meters.
Values |
Value |
Meaning |
0 |
Linear |
1 |
Inverted |
2 |
Hyperbolic |
|
RNGFND_MIN_CM: Rangefinder minimum distance
Minimum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND_MAX_CM: Rangefinder maximum distance
Maximum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND_STOP_PIN: Rangefinder stop pin
Digital pin that enables/disables rangefinder measurement for an analog rangefinder. A value of -1 means no pin. If this is set, then the pin is set to 1 to enable the rangefinder and set to 0 to disable it. This can be used to ensure that multiple sonar rangefinders don’t interfere with each other.
Values |
Value |
Meaning |
-1 |
Not Used |
50 |
Pixhawk AUXOUT1 |
51 |
Pixhawk AUXOUT2 |
52 |
Pixhawk AUXOUT3 |
53 |
Pixhawk AUXOUT4 |
54 |
Pixhawk AUXOUT5 |
55 |
Pixhawk AUXOUT6 |
111 |
PX4 FMU Relay1 |
112 |
PX4 FMU Relay2 |
113 |
PX4IO Relay1 |
114 |
PX4IO Relay2 |
115 |
PX4IO ACC1 |
116 |
PX4IO ACC2 |
|
RNGFND_SETTLE: Rangefinder settle time
The time in milliseconds that the rangefinder reading takes to settle. This is only used when a STOP_PIN is specified. It determines how long we have to wait for the rangefinder to give a reading after we set the STOP_PIN high. For a sonar rangefinder with a range of around 7m this would need to be around 50 milliseconds to allow for the sonar pulse to travel to the target and back again.
Increment |
Units |
1 |
milliseconds |
RNGFND_RMETRIC: Ratiometric
This parameter sets whether an analog rangefinder is ratiometric. Most analog rangefinders are ratiometric, meaning that their output voltage is influenced by the supply voltage. Some analog rangefinders (such as the SF/02) have their own internal voltage regulators so they are not ratiometric.
RNGFND_PWRRNG: Powersave range
This parameter sets the estimated terrain distance in meters above which the sensor will be put into a power saving mode (if available). A value of zero means power saving is not enabled
Range |
Units |
0 - 32767 |
meters |
RNGFND_GNDCLEAR: Distance (in cm) from the range finder to the ground
This parameter sets the expected range measurement(in cm) that the range finder should return when the vehicle is on the ground.
Range |
Increment |
Units |
5 - 127 |
1 |
centimeters |
RNGFND_ADDR: Bus address of sensor
This sets the bus address of the sensor, where applicable. Used for the LightWare I2C sensor to allow for multiple sensors on different addresses. A value of 0 disables the sensor.
Range |
Increment |
0 - 127 |
1 |
RNGFND_POS_X: X position offset
Note: This parameter is for advanced users
X position of the first rangefinder in body frame. Positive X is forward of the origin. Use the zero range datum point if supplied.
RNGFND_POS_Y: Y position offset
Note: This parameter is for advanced users
Y position of the first rangefinder in body frame. Positive Y is to the right of the origin. Use the zero range datum point if supplied.
RNGFND_POS_Z: Z position offset
Note: This parameter is for advanced users
Z position of the first rangefinder in body frame. Positive Z is down from the origin. Use the zero range datum point if supplied.
RNGFND_ORIENT: Rangefinder orientation
Note: This parameter is for advanced users
Orientation of rangefinder
Values |
Value |
Meaning |
0 |
Forward |
1 |
Forward-Right |
2 |
Right |
3 |
Back-Right |
4 |
Back |
5 |
Back-Left |
6 |
Left |
7 |
Forward-Left |
24 |
Up |
25 |
Down |
|
RNGFND2_TYPE: Second Rangefinder type
Note: This parameter is for advanced users
What type of rangefinder device that is connected
Values |
Value |
Meaning |
0 |
None |
1 |
Analog |
2 |
MaxbotixI2C |
3 |
LidarLiteV2-I2C |
5 |
PX4-PWM |
6 |
BBB-PRU |
7 |
LightWareI2C |
8 |
LightWareSerial |
9 |
Bebop |
10 |
MAVLink |
11 |
uLanding |
12 |
LeddarOne |
13 |
MaxbotixSerial |
14 |
TeraRangerI2C |
15 |
LidarLiteV3-I2C |
16 |
VL53L0X |
17 |
NMEA |
18 |
WASP-LRF |
19 |
BenewakeTF02 |
20 |
BenewakeTFmini |
21 |
LidarLiteV3HP-I2C |
|
RNGFND2_PIN: Rangefinder pin
Note: This parameter is for advanced users
Analog pin that rangefinder is connected to. Set this to 0..9 for the APM2 analog pins. Set to 64 on an APM1 for the dedicated ‘airspeed’ port on the end of the board. Set to 11 on PX4 for the analog ‘airspeed’ port. Set to 15 on the Pixhawk for the analog ‘airspeed’ port.
Values |
Value |
Meaning |
-1 |
Not Used |
0 |
APM2-A0 |
1 |
APM2-A1 |
2 |
APM2-A2 |
3 |
APM2-A3 |
4 |
APM2-A4 |
5 |
APM2-A5 |
6 |
APM2-A6 |
7 |
APM2-A7 |
8 |
APM2-A8 |
9 |
APM2-A9 |
11 |
PX4-airspeed port |
15 |
Pixhawk-airspeed port |
64 |
APM1-airspeed port |
|
RNGFND2_SCALING: Rangefinder scaling
Note: This parameter is for advanced users
Scaling factor between rangefinder reading and distance. For the linear and inverted functions this is in meters per volt. For the hyperbolic function the units are meterVolts.
Increment |
Units |
0.001 |
meters per volt |
RNGFND2_OFFSET: rangefinder offset
Note: This parameter is for advanced users
Offset in volts for zero distance
Increment |
Units |
0.001 |
volt |
RNGFND2_FUNCTION: Rangefinder function
Note: This parameter is for advanced users
Control over what function is used to calculate distance. For a linear function, the distance is (voltage-offset)*scaling. For a inverted function the distance is (offset-voltage)*scaling. For a hyperbolic function the distance is scaling/(voltage-offset). The functions return the distance in meters.
Values |
Value |
Meaning |
0 |
Linear |
1 |
Inverted |
2 |
Hyperbolic |
|
RNGFND2_MIN_CM: Rangefinder minimum distance
Note: This parameter is for advanced users
Minimum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND2_MAX_CM: Rangefinder maximum distance
Note: This parameter is for advanced users
Maximum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND2_STOP_PIN: Rangefinder stop pin
Note: This parameter is for advanced users
Digital pin that enables/disables rangefinder measurement for an analog rangefinder. A value of -1 means no pin. If this is set, then the pin is set to 1 to enable the rangefinder and set to 0 to disable it. This can be used to ensure that multiple sonar rangefinders don’t interfere with each other.
Values |
Value |
Meaning |
-1 |
Not Used |
50 |
Pixhawk AUXOUT1 |
51 |
Pixhawk AUXOUT2 |
52 |
Pixhawk AUXOUT3 |
53 |
Pixhawk AUXOUT4 |
54 |
Pixhawk AUXOUT5 |
55 |
Pixhawk AUXOUT6 |
111 |
PX4 FMU Relay1 |
112 |
PX4 FMU Relay2 |
113 |
PX4IO Relay1 |
114 |
PX4IO Relay2 |
115 |
PX4IO ACC1 |
116 |
PX4IO ACC2 |
|
RNGFND2_SETTLE: Sonar settle time
Note: This parameter is for advanced users
The time in milliseconds that the rangefinder reading takes to settle. This is only used when a STOP_PIN is specified. It determines how long we have to wait for the rangefinder to give a reading after we set the STOP_PIN high. For a sonar rangefinder with a range of around 7m this would need to be around 50 milliseconds to allow for the sonar pulse to travel to the target and back again.
Increment |
Units |
1 |
milliseconds |
RNGFND2_RMETRIC: Ratiometric
Note: This parameter is for advanced users
This parameter sets whether an analog rangefinder is ratiometric. Most analog rangefinders are ratiometric, meaning that their output voltage is influenced by the supply voltage. Some analog rangefinders (such as the SF/02) have their own internal voltage regulators so they are not ratiometric.
RNGFND2_GNDCLEAR: Distance (in cm) from the second range finder to the ground
Note: This parameter is for advanced users
This parameter sets the expected range measurement(in cm) that the second range finder should return when the vehicle is on the ground.
Range |
Increment |
Units |
0 - 127 |
1 |
centimeters |
RNGFND2_ADDR: Bus address of second rangefinder
Note: This parameter is for advanced users
This sets the bus address of the sensor, where applicable. Used for the LightWare I2C sensor to allow for multiple sensors on different addresses. A value of 0 disables the sensor.
Range |
Increment |
0 - 127 |
1 |
RNGFND2_POS_X: X position offset
Note: This parameter is for advanced users
X position of the second rangefinder in body frame. Positive X is forward of the origin. Use the zero range datum point if supplied.
RNGFND2_POS_Y: Y position offset
Note: This parameter is for advanced users
Y position of the second rangefinder in body frame. Positive Y is to the right of the origin. Use the zero range datum point if supplied.
RNGFND2_POS_Z: Z position offset
Note: This parameter is for advanced users
Z position of the second rangefinder in body frame. Positive Z is down from the origin. Use the zero range datum point if supplied.
RNGFND2_ORIENT: Rangefinder 2 orientation
Note: This parameter is for advanced users
Orientation of 2nd rangefinder
Values |
Value |
Meaning |
0 |
Forward |
1 |
Forward-Right |
2 |
Right |
3 |
Back-Right |
4 |
Back |
5 |
Back-Left |
6 |
Left |
7 |
Forward-Left |
24 |
Up |
25 |
Down |
|
RNGFND3_TYPE: Third Rangefinder type
Note: This parameter is for advanced users
What type of rangefinder device that is connected
Values |
Value |
Meaning |
0 |
None |
1 |
Analog |
2 |
MaxbotixI2C |
3 |
LidarLiteV2-I2C |
5 |
PX4-PWM |
6 |
BBB-PRU |
7 |
LightWareI2C |
8 |
LightWareSerial |
9 |
Bebop |
10 |
MAVLink |
11 |
uLanding |
12 |
LeddarOne |
13 |
MaxbotixSerial |
14 |
TeraRangerI2C |
15 |
LidarLiteV3-I2C |
16 |
VL53L0X |
17 |
NMEA |
18 |
WASP-LRF |
19 |
BenewakeTF02 |
20 |
BenewakeTFmini |
21 |
LidarLiteV3HP-I2C |
|
RNGFND3_PIN: Rangefinder pin
Note: This parameter is for advanced users
Analog pin that rangefinder is connected to. Set this to 0..9 for the APM2 analog pins. Set to 64 on an APM1 for the dedicated ‘airspeed’ port on the end of the board. Set to 11 on PX4 for the analog ‘airspeed’ port. Set to 15 on the Pixhawk for the analog ‘airspeed’ port.
Values |
Value |
Meaning |
-1 |
Not Used |
0 |
APM2-A0 |
1 |
APM2-A1 |
2 |
APM2-A2 |
3 |
APM2-A3 |
4 |
APM2-A4 |
5 |
APM2-A5 |
6 |
APM2-A6 |
7 |
APM2-A7 |
8 |
APM2-A8 |
9 |
APM2-A9 |
11 |
PX4-airspeed port |
15 |
Pixhawk-airspeed port |
64 |
APM1-airspeed port |
|
RNGFND3_SCALING: Rangefinder scaling
Note: This parameter is for advanced users
Scaling factor between rangefinder reading and distance. For the linear and inverted functions this is in meters per volt. For the hyperbolic function the units are meterVolts.
Increment |
Units |
0.001 |
meters per volt |
RNGFND3_OFFSET: rangefinder offset
Note: This parameter is for advanced users
Offset in volts for zero distance
Increment |
Units |
0.001 |
volt |
RNGFND3_FUNCTION: Rangefinder function
Note: This parameter is for advanced users
Control over what function is used to calculate distance. For a linear function, the distance is (voltage-offset)*scaling. For a inverted function the distance is (offset-voltage)*scaling. For a hyperbolic function the distance is scaling/(voltage-offset). The functions return the distance in meters.
Values |
Value |
Meaning |
0 |
Linear |
1 |
Inverted |
2 |
Hyperbolic |
|
RNGFND3_MIN_CM: Rangefinder minimum distance
Note: This parameter is for advanced users
Minimum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND3_MAX_CM: Rangefinder maximum distance
Note: This parameter is for advanced users
Maximum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND3_STOP_PIN: Rangefinder stop pin
Note: This parameter is for advanced users
Digital pin that enables/disables rangefinder measurement for an analog rangefinder. A value of -1 means no pin. If this is set, then the pin is set to 1 to enable the rangefinder and set to 0 to disable it. This can be used to ensure that multiple sonar rangefinders don’t interfere with each other.
Values |
Value |
Meaning |
-1 |
Not Used |
50 |
Pixhawk AUXOUT1 |
51 |
Pixhawk AUXOUT2 |
52 |
Pixhawk AUXOUT3 |
53 |
Pixhawk AUXOUT4 |
54 |
Pixhawk AUXOUT5 |
55 |
Pixhawk AUXOUT6 |
111 |
PX4 FMU Relay1 |
112 |
PX4 FMU Relay2 |
113 |
PX4IO Relay1 |
114 |
PX4IO Relay2 |
115 |
PX4IO ACC1 |
116 |
PX4IO ACC2 |
|
RNGFND3_SETTLE: Sonar settle time
Note: This parameter is for advanced users
The time in milliseconds that the rangefinder reading takes to settle. This is only used when a STOP_PIN is specified. It determines how long we have to wait for the rangefinder to give a reading after we set the STOP_PIN high. For a sonar rangefinder with a range of around 7m this would need to be around 50 milliseconds to allow for the sonar pulse to travel to the target and back again.
Increment |
Units |
1 |
milliseconds |
RNGFND3_RMETRIC: Ratiometric
Note: This parameter is for advanced users
This parameter sets whether an analog rangefinder is ratiometric. Most analog rangefinders are ratiometric, meaning that their output voltage is influenced by the supply voltage. Some analog rangefinders (such as the SF/02) have their own internal voltage regulators so they are not ratiometric.
RNGFND3_GNDCLEAR: Distance (in cm) from the third range finder to the ground
Note: This parameter is for advanced users
This parameter sets the expected range measurement(in cm) that the third range finder should return when the vehicle is on the ground.
Range |
Increment |
Units |
0 - 127 |
1 |
centimeters |
RNGFND3_ADDR: Bus address of third rangefinder
Note: This parameter is for advanced users
This sets the bus address of the sensor, where applicable. Used for the LightWare I2C sensor to allow for multiple sensors on different addresses. A value of 0 disables the sensor.
Range |
Increment |
0 - 127 |
1 |
RNGFND3_POS_X: X position offset
Note: This parameter is for advanced users
X position of the third rangefinder in body frame. Positive X is forward of the origin. Use the zero range datum point if supplied.
RNGFND3_POS_Y: Y position offset
Note: This parameter is for advanced users
Y position of the third rangefinder in body frame. Positive Y is to the right of the origin. Use the zero range datum point if supplied.
RNGFND3_POS_Z: Z position offset
Note: This parameter is for advanced users
Z position of the third rangefinder in body frame. Positive Z is down from the origin. Use the zero range datum point if supplied.
RNGFND3_ORIENT: Rangefinder 3 orientation
Note: This parameter is for advanced users
Orientation of 3rd rangefinder
Values |
Value |
Meaning |
0 |
Forward |
1 |
Forward-Right |
2 |
Right |
3 |
Back-Right |
4 |
Back |
5 |
Back-Left |
6 |
Left |
7 |
Forward-Left |
24 |
Up |
25 |
Down |
|
RNGFND4_TYPE: Fourth Rangefinder type
Note: This parameter is for advanced users
What type of rangefinder device that is connected
Values |
Value |
Meaning |
0 |
None |
1 |
Analog |
2 |
MaxbotixI2C |
3 |
LidarLiteV2-I2C |
5 |
PX4-PWM |
6 |
BBB-PRU |
7 |
LightWareI2C |
8 |
LightWareSerial |
9 |
Bebop |
10 |
MAVLink |
11 |
uLanding |
12 |
LeddarOne |
13 |
MaxbotixSerial |
14 |
TeraRangerI2C |
15 |
LidarLiteV3-I2C |
16 |
VL53L0X |
17 |
NMEA |
18 |
WASP-LRF |
19 |
BenewakeTF02 |
20 |
BenewakeTFmini |
21 |
LidarLiteV3HP-I2C |
|
RNGFND4_PIN: Rangefinder pin
Note: This parameter is for advanced users
Analog pin that rangefinder is connected to. Set this to 0..9 for the APM2 analog pins. Set to 64 on an APM1 for the dedicated ‘airspeed’ port on the end of the board. Set to 11 on PX4 for the analog ‘airspeed’ port. Set to 15 on the Pixhawk for the analog ‘airspeed’ port.
Values |
Value |
Meaning |
-1 |
Not Used |
0 |
APM2-A0 |
1 |
APM2-A1 |
2 |
APM2-A2 |
3 |
APM2-A3 |
4 |
APM2-A4 |
5 |
APM2-A5 |
6 |
APM2-A6 |
7 |
APM2-A7 |
8 |
APM2-A8 |
9 |
APM2-A9 |
11 |
PX4-airspeed port |
15 |
Pixhawk-airspeed port |
64 |
APM1-airspeed port |
|
RNGFND4_SCALING: Rangefinder scaling
Note: This parameter is for advanced users
Scaling factor between rangefinder reading and distance. For the linear and inverted functions this is in meters per volt. For the hyperbolic function the units are meterVolts.
Increment |
Units |
0.001 |
meters per volt |
RNGFND4_OFFSET: rangefinder offset
Note: This parameter is for advanced users
Offset in volts for zero distance
Increment |
Units |
0.001 |
volt |
RNGFND4_FUNCTION: Rangefinder function
Note: This parameter is for advanced users
Control over what function is used to calculate distance. For a linear function, the distance is (voltage-offset)*scaling. For a inverted function the distance is (offset-voltage)*scaling. For a hyperbolic function the distance is scaling/(voltage-offset). The functions return the distance in meters.
Values |
Value |
Meaning |
0 |
Linear |
1 |
Inverted |
2 |
Hyperbolic |
|
RNGFND4_MIN_CM: Rangefinder minimum distance
Note: This parameter is for advanced users
Minimum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND4_MAX_CM: Rangefinder maximum distance
Note: This parameter is for advanced users
Maximum distance in centimeters that rangefinder can reliably read
Increment |
Units |
1 |
centimeters |
RNGFND4_STOP_PIN: Rangefinder stop pin
Note: This parameter is for advanced users
Digital pin that enables/disables rangefinder measurement for an analog rangefinder. A value of -1 means no pin. If this is set, then the pin is set to 1 to enable the rangefinder and set to 0 to disable it. This can be used to ensure that multiple sonar rangefinders don’t interfere with each other.
Values |
Value |
Meaning |
-1 |
Not Used |
50 |
Pixhawk AUXOUT1 |
51 |
Pixhawk AUXOUT2 |
52 |
Pixhawk AUXOUT3 |
53 |
Pixhawk AUXOUT4 |
54 |
Pixhawk AUXOUT5 |
55 |
Pixhawk AUXOUT6 |
111 |
PX4 FMU Relay1 |
112 |
PX4 FMU Relay2 |
113 |
PX4IO Relay1 |
114 |
PX4IO Relay2 |
115 |
PX4IO ACC1 |
116 |
PX4IO ACC2 |
|
RNGFND4_SETTLE: Sonar settle time
Note: This parameter is for advanced users
The time in milliseconds that the rangefinder reading takes to settle. This is only used when a STOP_PIN is specified. It determines how long we have to wait for the rangefinder to give a reading after we set the STOP_PIN high. For a sonar rangefinder with a range of around 7m this would need to be around 50 milliseconds to allow for the sonar pulse to travel to the target and back again.
Increment |
Units |
1 |
milliseconds |
RNGFND4_RMETRIC: Ratiometric
Note: This parameter is for advanced users
This parameter sets whether an analog rangefinder is ratiometric. Most analog rangefinders are ratiometric, meaning that their output voltage is influenced by the supply voltage. Some analog rangefinders (such as the SF/02) have their own internal voltage regulators so they are not ratiometric.
RNGFND4_GNDCLEAR: Distance (in cm) from the fourth range finder to the ground
Note: This parameter is for advanced users
This parameter sets the expected range measurement(in cm) that the fourth range finder should return when the vehicle is on the ground.
Range |
Increment |
Units |
0 - 127 |
1 |
centimeters |
RNGFND4_ADDR: Bus address of fourth rangefinder
Note: This parameter is for advanced users
This sets the bus address of the sensor, where applicable. Used for the LightWare I2C sensor to allow for multiple sensors on different addresses. A value of 0 disables the sensor.
Range |
Increment |
0 - 127 |
1 |
RNGFND4_POS_X: X position offset
Note: This parameter is for advanced users
X position of the fourth rangefinder in body frame. Use the zero range datum point if supplied.
RNGFND4_POS_Y: Y position offset
Note: This parameter is for advanced users
Y position of the fourth rangefinder in body frame. Use the zero range datum point if supplied.
RNGFND4_POS_Z: Z position offset
Note: This parameter is for advanced users
Z position of the fourth rangefinder in body frame. Use the zero range datum point if supplied.
RNGFND4_ORIENT: Rangefinder 4 orientation
Note: This parameter is for advanced users
Orientation of 4th range finder
Values |
Value |
Meaning |
0 |
Forward |
1 |
Forward-Right |
2 |
Right |
3 |
Back-Right |
4 |
Back |
5 |
Back-Left |
6 |
Left |
7 |
Forward-Left |
24 |
Up |
25 |
Down |
|
SERIAL Parameters
SERIAL0_BAUD: Serial0 baud rate
The baud rate used on the USB console. The APM2 can support all baudrates up to 115, and also can support 500. The PX4 can support rates of up to 1500. If you setup a rate you cannot support on APM2 and then can’t connect to your board you should load a firmware from a different vehicle type. That will reset all your parameters to defaults.
Values |
Value |
Meaning |
1 |
1200 |
2 |
2400 |
4 |
4800 |
9 |
9600 |
19 |
19200 |
38 |
38400 |
57 |
57600 |
111 |
111100 |
115 |
115200 |
460 |
460800 |
500 |
500000 |
921 |
921600 |
1500 |
1500000 |
|
SERIAL0_PROTOCOL: Console protocol selection
Control what protocol to use on the console.
Values |
RebootRequired |
Value |
Meaning |
1 |
MAVlink1 |
2 |
MAVLink2 |
|
True |
SERIAL1_PROTOCOL: Telem1 protocol selection
Control what protocol to use on the Telem1 port. Note that the Frsky options require external converter hardware. See the wiki for details.
Values |
RebootRequired |
Value |
Meaning |
-1 |
None |
1 |
MAVLink1 |
2 |
MAVLink2 |
3 |
Frsky D |
4 |
Frsky SPort |
5 |
GPS |
7 |
Alexmos Gimbal Serial |
8 |
SToRM32 Gimbal Serial |
9 |
Rangefinder |
10 |
FrSky SPort Passthrough (OpenTX) |
11 |
Lidar360 |
13 |
Beacon |
14 |
Volz servo out |
15 |
SBus servo out |
16 |
ESC Telemetry |
17 |
Devo Telemetry |
18 |
OpticalFlow |
|
True |
SERIAL1_BAUD: Telem1 Baud Rate
The baud rate used on the Telem1 port. The APM2 can support all baudrates up to 115, and also can support 500. The PX4 can support rates of up to 1500. If you setup a rate you cannot support on APM2 and then can’t connect to your board you should load a firmware from a different vehicle type. That will reset all your parameters to defaults.
Values |
Value |
Meaning |
1 |
1200 |
2 |
2400 |
4 |
4800 |
9 |
9600 |
19 |
19200 |
38 |
38400 |
57 |
57600 |
111 |
111100 |
115 |
115200 |
500 |
500000 |
921 |
921600 |
1500 |
1500000 |
|
SERIAL2_PROTOCOL: Telemetry 2 protocol selection
Control what protocol to use on the Telem2 port. Note that the Frsky options require external converter hardware. See the wiki for details.
Values |
RebootRequired |
Value |
Meaning |
-1 |
None |
1 |
MAVLink1 |
2 |
MAVLink2 |
3 |
Frsky D |
4 |
Frsky SPort |
5 |
GPS |
7 |
Alexmos Gimbal Serial |
8 |
SToRM32 Gimbal Serial |
9 |
Rangefinder |
10 |
FrSky SPort Passthrough (OpenTX) |
11 |
Lidar360 |
13 |
Beacon |
14 |
Volz servo out |
15 |
SBus servo out |
16 |
ESC Telemetry |
17 |
Devo Telemetry |
18 |
OpticalFlow |
|
True |
SERIAL2_BAUD: Telemetry 2 Baud Rate
The baud rate of the Telem2 port. The APM2 can support all baudrates up to 115, and also can support 500. The PX4 can support rates of up to 1500. If you setup a rate you cannot support on APM2 and then can’t connect to your board you should load a firmware from a different vehicle type. That will reset all your parameters to defaults.
Values |
Value |
Meaning |
1 |
1200 |
2 |
2400 |
4 |
4800 |
9 |
9600 |
19 |
19200 |
38 |
38400 |
57 |
57600 |
111 |
111100 |
115 |
115200 |
500 |
500000 |
921 |
921600 |
1500 |
1500000 |
|
SERIAL3_PROTOCOL: Serial 3 (GPS) protocol selection
Control what protocol Serial 3 (GPS) should be used for. Note that the Frsky options require external converter hardware. See the wiki for details.
Values |
RebootRequired |
Value |
Meaning |
-1 |
None |
1 |
MAVLink1 |
2 |
MAVLink2 |
3 |
Frsky D |
4 |
Frsky SPort |
5 |
GPS |
7 |
Alexmos Gimbal Serial |
8 |
SToRM32 Gimbal Serial |
9 |
Rangefinder |
10 |
FrSky SPort Passthrough (OpenTX) |
11 |
Lidar360 |
13 |
Beacon |
14 |
Volz servo out |
15 |
SBus servo out |
16 |
ESC Telemetry |
17 |
Devo Telemetry |
18 |
OpticalFlow |
|
True |
SERIAL3_BAUD: Serial 3 (GPS) Baud Rate
The baud rate used for the Serial 3 (GPS). The APM2 can support all baudrates up to 115, and also can support 500. The PX4 can support rates of up to 1500. If you setup a rate you cannot support on APM2 and then can’t connect to your board you should load a firmware from a different vehicle type. That will reset all your parameters to defaults.
Values |
Value |
Meaning |
1 |
1200 |
2 |
2400 |
4 |
4800 |
9 |
9600 |
19 |
19200 |
38 |
38400 |
57 |
57600 |
111 |
111100 |
115 |
115200 |
500 |
500000 |
921 |
921600 |
1500 |
1500000 |
|
SERIAL4_PROTOCOL: Serial4 protocol selection
Control what protocol Serial4 port should be used for. Note that the Frsky options require external converter hardware. See the wiki for details.
Values |
RebootRequired |
Value |
Meaning |
-1 |
None |
1 |
MAVLink1 |
2 |
MAVLink2 |
3 |
Frsky D |
4 |
Frsky SPort |
5 |
GPS |
7 |
Alexmos Gimbal Serial |
8 |
SToRM32 Gimbal Serial |
9 |
Rangefinder |
10 |
FrSky SPort Passthrough (OpenTX) |
11 |
Lidar360 |
13 |
Beacon |
14 |
Volz servo out |
15 |
SBus servo out |
16 |
ESC Telemetry |
17 |
Devo Telemetry |
18 |
OpticalFlow |
|
True |
SERIAL4_BAUD: Serial 4 Baud Rate
The baud rate used for Serial4. The APM2 can support all baudrates up to 115, and also can support 500. The PX4 can support rates of up to 1500. If you setup a rate you cannot support on APM2 and then can’t connect to your board you should load a firmware from a different vehicle type. That will reset all your parameters to defaults.
Values |
Value |
Meaning |
1 |
1200 |
2 |
2400 |
4 |
4800 |
9 |
9600 |
19 |
19200 |
38 |
38400 |
57 |
57600 |
111 |
111100 |
115 |
115200 |
500 |
500000 |
921 |
921600 |
1500 |
1500000 |
|
SERIAL5_PROTOCOL: Serial5 protocol selection
Control what protocol Serial5 port should be used for. Note that the Frsky options require external converter hardware. See the wiki for details.
Values |
RebootRequired |
Value |
Meaning |
-1 |
None |
1 |
MAVLink1 |
2 |
MAVLink2 |
3 |
Frsky D |
4 |
Frsky SPort |
5 |
GPS |
7 |
Alexmos Gimbal Serial |
8 |
SToRM32 Gimbal Serial |
9 |
Rangefinder |
10 |
FrSky SPort Passthrough (OpenTX) |
11 |
Lidar360 |
13 |
Beacon |
14 |
Volz servo out |
15 |
SBus servo out |
16 |
ESC Telemetry |
17 |
Devo Telemetry |
18 |
OpticalFlow |
|
True |
SERIAL5_BAUD: Serial 5 Baud Rate
The baud rate used for Serial5. The APM2 can support all baudrates up to 115, and also can support 500. The PX4 can support rates of up to 1500. If you setup a rate you cannot support on APM2 and then can’t connect to your board you should load a firmware from a different vehicle type. That will reset all your parameters to defaults.
Values |
Value |
Meaning |
1 |
1200 |
2 |
2400 |
4 |
4800 |
9 |
9600 |
19 |
19200 |
38 |
38400 |
57 |
57600 |
111 |
111100 |
115 |
115200 |
500 |
500000 |
921 |
921600 |
1500 |
1500000 |
|
SERIAL6_PROTOCOL: Serial6 protocol selection
Control what protocol Serial6 port should be used for. Note that the Frsky options require external converter hardware. See the wiki for details.
Values |
RebootRequired |
Value |
Meaning |
-1 |
None |
1 |
MAVLink1 |
2 |
MAVLink2 |
3 |
Frsky D |
4 |
Frsky SPort |
5 |
GPS |
7 |
Alexmos Gimbal Serial |
8 |
SToRM32 Gimbal Serial |
9 |
Rangefinder |
10 |
FrSky SPort Passthrough (OpenTX) |
11 |
Lidar360 |
13 |
Beacon |
14 |
Volz servo out |
15 |
SBus servo out |
16 |
ESC Telemetry |
17 |
Devo Telemetry |
18 |
OpticalFlow |
|
True |
SERIAL6_BAUD: Serial 6 Baud Rate
The baud rate used for Serial6. The APM2 can support all baudrates up to 115, and also can support 500. The PX4 can support rates of up to 1500. If you setup a rate you cannot support on APM2 and then can’t connect to your board you should load a firmware from a different vehicle type. That will reset all your parameters to defaults.
Values |
Value |
Meaning |
1 |
1200 |
2 |
2400 |
4 |
4800 |
9 |
9600 |
19 |
19200 |
38 |
38400 |
57 |
57600 |
111 |
111100 |
115 |
115200 |
500 |
500000 |
921 |
921600 |
1500 |
1500000 |
|
TMODE Parameters
TMODE_ENABLE: tmode enable
Note: This parameter is for advanced users
tmode (or “toy” mode) gives a simplified user interface designed for mass market drones. Version1 is for the SkyViper V2450GPS. Version2 is for the F412 based boards
Values |
Value |
Meaning |
0 |
Disabled |
1 |
EnableVersion1 |
2 |
EnableVersion2 |
|
TMODE_MODE1: Tmode first mode
This is the initial mode when the vehicle is first turned on. This mode is assumed to not require GPS
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
FlowHold |
|
TMODE_MODE2: Tmode second mode
This is the secondary mode. This mode is assumed to require GPS
Values |
Value |
Meaning |
0 |
Stabilize |
1 |
Acro |
2 |
AltHold |
3 |
Auto |
4 |
Guided |
5 |
Loiter |
6 |
RTL |
7 |
Circle |
9 |
Land |
11 |
Drift |
13 |
Sport |
14 |
Flip |
15 |
AutoTune |
16 |
PosHold |
17 |
Brake |
18 |
Throw |
19 |
Avoid_ADSB |
20 |
Guided_NoGPS |
21 |
FlowHold |
|
TMODE_ACTION1: Tmode action 1
This is the action taken for the left action button
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_ACTION2: Tmode action 2
This is the action taken for the right action button
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_ACTION3: Tmode action 3
This is the action taken for the power button
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_ACTION4: Tmode action 4
This is the action taken for the left action button while the mode button is pressed
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_ACTION5: Tmode action 5
This is the action taken for the right action button while the mode button is pressed
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_ACTION6: Tmode action 6
This is the action taken for the power button while the mode button is pressed
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_LEFT: Tmode left action
This is the action taken for the left button (mode button) being pressed
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_LEFT_LONG: Tmode left long action
This is the action taken for a long press of the left button (home button)
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
24 |
ModeFlowHold |
|
TMODE_TRIM_AUTO: Stick auto trim limit
This is the amount of automatic stick trim that can be applied when disarmed with sticks not moving. It is a PWM limit value away from 1500
TMODE_RIGHT: Tmode right action
This is the action taken for the right button (RTL) being pressed
Values |
Value |
Meaning |
0 |
None |
1 |
TakePhoto |
2 |
ToggleVideo |
3 |
ModeAcro |
4 |
ModeAltHold |
5 |
ModeAuto |
6 |
ModeLoiter |
7 |
ModeRTL |
8 |
ModeCircle |
9 |
ModeLand |
10 |
ModeDrift |
11 |
ModeSport |
12 |
ModeAutoTune |
13 |
ModePosHold |
14 |
ModeBrake |
15 |
ModeThrow |
16 |
Flip |
17 |
ModeStabilize |
18 |
Disarm |
19 |
ToggleMode |
20 |
Arm-Land-RTL |
21 |
ToggleSimpleMode |
22 |
ToggleSuperSimpleMode |
23 |
MotorLoadTest |
|
TMODE_FLAGS: Tmode flags
Bitmask of flags to change the behaviour of tmode. DisarmOnLowThrottle means to disarm if throttle is held down for 1 second when landed. ArmOnHighThrottle means to arm if throttle is above 80% for 1 second. UpgradeToLoiter means to allow takeoff in LOITER mode by switching to ALT_HOLD, then auto-upgrading to LOITER once GPS is available. RTLStickCancel means that on large stick inputs in RTL mode that LOITER mode is engaged
Bitmask |
Bit |
Meaning |
0 |
DisarmOnLowThrottle |
1 |
ArmOnHighThrottle |
2 |
UpgradeToLoiter |
3 |
RTLStickCancel |
|
TMODE_VMIN: Min voltage for output limiting
Note: This parameter is for advanced users
This is the battery voltage below which no output limiting is done
Range |
Increment |
0 - 5 |
0.01 |
TMODE_VMAX: Max voltage for output limiting
Note: This parameter is for advanced users
This is the battery voltage above which thrust min is used
Range |
Increment |
0 - 5 |
0.01 |
TMODE_TMIN: Min thrust multiplier
Note: This parameter is for advanced users
This sets the thrust multiplier when voltage is high
Range |
Increment |
0 - 1 |
0.01 |
TMODE_TMAX: Max thrust multiplier
Note: This parameter is for advanced users
This sets the thrust multiplier when voltage is low
Range |
Increment |
0 - 1 |
0.01 |
TMODE_LOAD_MUL: Load test multiplier
Note: This parameter is for advanced users
This scales the load test output, as a value between 0 and 1
Range |
Increment |
0 - 1 |
0.01 |
TMODE_LOAD_FILT: Load test filter
Note: This parameter is for advanced users
This filters the load test output. A value of 1 means no filter. 2 means values are repeated once. 3 means values are repeated 3 times, etc
TMODE_LOAD_TYPE: Load test type
Note: This parameter is for advanced users
This sets the type of load test
Values |
Value |
Meaning |
0 |
ConstantThrust |
1 |
LogReplay1 |
2 |
LogReplay2 |
|