This is an attempt to document the variables of Betaflight 4.1, motivated by my previous trouble to easily look up certain information.
When using the Betaflight command line interface or examining a diff, it can sometimes be difficult to understand what certain settings is supposed to do. This is intended to be used as a reference to quickly look this information up.
As I'm not an expert, any contributions or help with creating this document will be greatly appreciated! If you have trouble understanding any of the explanations, please open an issue so we can rewrite it and hopefully clear things up.
Documentation is based on information from previous Betaflight/Cleanflight docs, Betaflight Configurator, as well as Betaflight source code and various other sources.
Update: I'm currently working on an app that uses this documentation to help you understand your Betaflight configuration. https://github.com/mathiasvr/betaflight-inspector
Descriptions and other information is organized into a JSON file, with the intent to generate consistent documentation and allow other possible future integration.
Betaflight can be configured through a CLI by setting the following list of variables.
Variables are read by entering get <variable_name>
, and written with set <variable_name> = <value>
.
Sections
- Master: General variables, always in effect.
- Profile: Profile specific variables, affecting only the active profile.
- Rate Profile: Rate specific variables, affecting only the active rate profile.
Gyro Hardware Low Pass Filter
- Default:
NORMAL
- Allowed:
NORMAL
,1KHZ_SAMPLING
,EXPERIMENTAL
Gyro Sync Denominator
- Default:
1
- Range:
1
-32
- BF Configurator: Gyro update frequency
Sets the gyro update frequency based on dividing the max loop rate (8kHz). 4
means 8kHz/4 = 2kHz
. Loop time is the reciprocal (1/Rate
). Don't forget to check CPU usage when playing with this value. It is recommended to set the gyro update frequency in BF Configurator, this takes care of all the required settings. This value also affects the PID loop pid_process_denom.
Gyro Low Pass Filter 1 Type
- Default:
PT1
- Allowed:
PT1
,BIQUAD
- BF Configurator: Gyro Lowpass 1 Dynamic Filter Type
TODO: Type of gyro dynamic lowpass filter. Maybe also static lowpass filter type if not using dynamic filter.
Gyro Low Pass Filter 1 Cutoff Frequency
- Default:
200
- Range:
0
-4000
- Unit:
Hz
- BF Configurator: Gyro Lowpass 1 Cutoff Frequency [Hz]
TODO: I think this is only used if not using dynamic filter.
Gyro Low Pass Filter 2 Type
- Default:
PT1
- Allowed:
PT1
,BIQUAD
- BF Configurator: Gyro Lowpass 2 Filter Type
Gyro Low Pass Filter 2 Cutoff Frequency
- Default:
250
- Range:
0
-4000
- Unit:
Hz
- BF Configurator: Gyro Lowpass 2 Cutoff Frequency [Hz]
Gyro Notch Filter 1 Frequency
- Default:
0
- Range:
0
-4000
- Unit:
Hz
Gyro Notch Filter 1 Cutoff
- Default:
0
- Range:
0
-4000
- Unit:
Hz
Gyro Notch Filter 2 Frequency
- Default:
0
- Range:
0
-4000
- Unit:
Hz
Gyro Notch Filter 2 Cutoff
- Default:
0
- Range:
0
-4000
- Unit:
Hz
Gyro Calibration Duration
- Default:
125
- Range:
50
-3000
Gyro Calibration Noise Limit
- Default:
48
- Range:
0
-200
Gyro Offset Yaw
- Default:
0
- Range:
-1000
-1000
Gyro Overflow Detect
- Default:
ALL
- Allowed:
OFF
,YAW
,ALL
Axis where gyro overflow detection applies. Intended to deal with overflow issues on ICM gyros. The default is to be on, for all axes. It is unwise to disable this if your quad has an ICM gyro. It is not needed or helpful for MPU gyros. ICM gyros are susceptible to overflow-inversion problems if exposed to very high turn rates. If enabled and set to ALL
, overflow protection will kick in and disable all PIDs whenever any axis exceeds 1950 degrees/second.
Yaw Spin Recovery
- Default:
ON
- Allowed:
OFF
,ON
This feature reduces the severity and duration of un-commanded severe yaw spins. For example, if a quadcopter clips a gate, tree, branch or other object and causes a high rate yaw spin, it may go into a 'never-ending' uncontrollable spin. Typically it makes a distinctive warbling noise and climbs rapidly - the so-called Yaw Spin To The Moon (YSTTM) problem. Yaw Spin Recovery is intended primarily for FPV pilots, and works best with MPU gyros. LOS acro pilots who use high yaw rates may prefer to disable this function.
Yaw Spin Threshold
- Default:
1950
- Range:
500
-1950
- Unit:
deg/s
The 'threshold' value is the spin rate, in degrees per second, at which the spin protection kicks in. The default threshold of 1950
was chosen to minimise false triggering. For FPV, a lower value, e.g. 100-200 above your maximum configured yaw rate, is recommended. For example, a quad with a maximum configured yaw rate of 700 degrees/sec: Too low a threshold may cause false triggering, and delay return to normal control.
Gyro To Use
- Default:
FIRST
- Allowed:
FIRST
,SECOND
,BOTH
TODO: Selects the gyro(s) that should be used.
Dynamic Notch Filter Range
- Default:
MEDIUM
- Allowed:
HIGH
,MEDIUM
,LOW
,AUTO
- BF Configurator: Dynamic Notch Filter Range
The dynamic notch has three frequency ranges in which it can operate: LOW
(80-330hz) for lower revving quads like 6+ inches, MEDIUM
(140-550hz) for a normal 5 inch quad, HIGH
(230-800hz) for very high revving 2.5-3 inch quads. AUTO
option selects the range depending on the value of the Gyro Dynamic Lowpass 1 Filter's max cutoff frequency.
Dynamic Notch Filter Width Percentage
- Default:
8
- Range:
0
-20
- Unit:
%
- BF Configurator: Dynamic Notch Width Percent
This sets the width between two dynamic notch filters. Setting it at 0 will disable the second dynamic notch filter and will reduce filter delay, however it may make motor temperatures higher.
Dynamic Notch Filter Q
- Default:
120
- Range:
1
-1000
- BF Configurator: Dynamic Notch Q
Q factor adjust how narrow or wide the dynamic notch filters are. Higher value makes it narrower and more precise and lower value makes it wider and broader. Having a really low value will greatly increase filter delay.
Dynamic Notch Filter Minimum Frequency
- Default:
150
- Range:
60
-1000
- Unit:
Hz
- BF Configurator: Dynamic Notch Min Hz
Defines the lowest dynamic notch center frequency below which the dynamic notch will not go.
Gyro Dynamic Low Pass Filter 1 Minimum Cutoff Frequency
- Default:
200
- Range:
0
-1000
- Unit:
Hz
- BF Configurator: Gyro Lowpass 1 Dynamic Min Cutoff Frequency [Hz]
Gyro Dynamic Low Pass Filter 1 Maximum Cutoff Frequency
- Default:
500
- Range:
0
-1000
- Unit:
Hz
- BF Configurator: Gyro Lowpass 1 Dynamic Max Cutoff Frequency [Hz]
Gyro Filter Debug Axis
- Default:
ROLL
- Allowed:
ROLL
,PITCH
,YAW
Accelerometer Hardware
- Default:
AUTO
- Allowed:
AUTO
,NONE
,ADXL345
,MPU6050
,MMA8452
,BMA280
,LSM303DLHC
,MPU6000
,MPU6500
,MPU9250
,ICM20601
,ICM20602
,ICM20608G
,ICM20649
,ICM20689
,BMI160
,FAKE
This is used to suggest which accelerometer driver should load, or to force no accelerometer in case gyro-only flight is needed. Default AUTO
will attempt to auto-detect among enabled drivers. Otherwise, to force a particular device, set appropriately, or select NONE
to disable accelerometer alltogether - resulting in gyro-only operation.
Accelerometer Low Pass Filter Cutoff Frequency
- Default:
10
- Range:
0
-400
- Unit:
Hz
Accelerometer Trim Pitch
- Default:
0
- Range:
-300
-300
Accelerometer trim (Pitch)
Accelerometer Trim Roll
- Default:
0
- Range:
-300
-300
Accelerometer trim (Roll)
Accelerometer Calibration
- Default:
0,0,0
- Type:
Array[3]
TODO: Accelerometer calibration values. Normally set automatically by pressing Calibrate Accelerometer in BF Configurator.
Magnetometer Alignment
- Default:
DEFAULT
- Allowed:
DEFAULT
,CW0
,CW90
,CW180
,CW270
,CW0FLIP
,CW90FLIP
,CW180FLIP
,CW270FLIP
,CUSTOM
When running on non-default hardware or adding support for new sensors/sensor boards, these values are used for sensor orientation. When carefully understood, these values can also be used to rotate (in 90deg steps) or flip the board.
Magnetometer Alignment Roll Axis
- Default:
0
- Range:
-3600
-3600
Magnetometer Alignment Pitch Axis
- Default:
0
- Range:
-3600
-3600
Magnetometer Alignment Yaw Axis
- Default:
0
- Range:
-3600
-3600
Magnetometer Bus Type
- Default:
I2C
- Allowed:
NONE
,I2C
,SPI
,SLAVE
,GYROAUTO
Magnetometer I2C Device
- Default:
1
- Range:
0
-3
Magnetometer I2C Address
- Default:
0
- Range:
0
-119
Magnetometer SPI Device
- Default:
0
- Range:
0
-3
Magnetometer Hardware
- Default:
NONE
- Allowed:
AUTO
,NONE
,HMC5883
,AK8975
,AK8963
,QMC5883
,LIS3MDL
Set default AUTO
to use magnetometer hardware defined for your board type. Otherwise select appropriate device, or set to None
to disable magnetometer.
Magnetic Declination
- Default:
0
- Range:
-18000
-18000
- Unit:
dddmm
Magnetic declination of your current location in dddmm
format. For example, -6deg 37min
= -637
for Japan. Leading zeros not required. Get your local magnetic declination here: http://magnetic-declination.com/
Magnetometer Calibration
- Default:
0,0,0
- Type:
Array[3]
Barometer Bus Type
- Default:
I2C
- Allowed:
NONE
,I2C
,SPI
,SLAVE
,GYROAUTO
Barometer SPI Device
- Default:
0
- Range:
0
-5
Barometer I2C Device
- Default:
1
- Range:
0
-5
Barometer I2C Address
- Default:
0
- Range:
0
-119
Barometer Hardware
- Default:
AUTO
- Allowed:
AUTO
,NONE
,BMP085
,MS5611
,BMP280
,LPS
,QMP6988
,BMP388
Set default AUTO
to use the barometer hardware defined for your board type. Otherwise select appropriate device, or set to None
to disable barometer.
Barometer Tab Size
- Default:
21
- Range:
0
-48
Pressure sensor sample count.
Barometer Low Pass Filter Cutoff Frequency
- Default:
600
- Range:
0
-1000
- Unit:
Hz
Barometer low-pass filter cut-off frequency in Hz.
TODO: Barometer CF Velocity
- Default:
985
- Range:
0
-1000
Velocity sensor mix in altitude hold. Determines the influence accelerometer and barometer sensors have in the velocity estimation. 1000
for pure accelerometer altitude, 0 for pure barometer altitude.
RC Stick Center
- Default:
1500
- Range:
1200
-1700
- Unit:
us
- BF Configurator: Stick Center
The value (in us) used to determine if a stick is centered.
RC Stick Low Threshold
- Default:
1050
- Range:
750
-2250
- Unit:
us
- BF Configurator: 'Stick Low' Threshold
The maximum value (in us) for a stick to be recognised as low. Used for stick commands and pid_at_min_throttle.
RC Stick High Threshold
- Default:
1900
- Range:
750
-2250
- Unit:
us
- BF Configurator: 'Stick High' Threshold
The minimum value (in us) for a stick to be recognised as high. Used for stick commands, etc.
RSSI Channel
- Default:
0
- Range:
0
-18
- BF Configurator: RSSI Channel
Receiver (RX) channel (AUX channel + 4) that contains an RSSI signal.
TODO RSSI Source Frame Errors
- Default:
OFF
- Allowed:
OFF
,ON
RSSI Scale
- Default:
100
- Range:
1
-255
GUESS: Scales the RSSI value.
RSSI Offset
- Default:
0
- Range:
-100
-100
GUESS: Offsets the RSSI value by a given amount.
RSSI Inversion
- Default:
OFF
- Allowed:
OFF
,ON
GUESS: Inverts the RSSI value (high value = poor signal, low value = good signal)
TODO: RSSI Source Frame Low Pass Filter Period
- Default:
30
- Range:
0
-255
RC Interpolation
- Default:
AUTO
- Allowed:
OFF
,PRESET
,AUTO
,MANUAL
TODO: This feature can cause the CPU to work harder to be able to run higher d setpoint weights and get cleaner motor outputs. Set to OFF
if CPU loading is too high. Note: Auto RC interpolation detects RX speed based on the reported speed by RX itself. But some receivers can report 9ms interval while it is actually 18ms on roll and pitch when using more channels than 8.
RC Interpolation Channels
- Default:
RPYT
- Allowed:
RP
,RPY
,RPYT
,T
,RPT
TODO: Smoothing of RX inputs for Roll, Pitch, Yaw, Throttle.
RC Interpolation Interval
- Default:
19
- Range:
1
-50
RC Smoothing Type
- Default:
FILTER
- Allowed:
INTERPOLATION
,FILTER
RC Smoothing Input Filter Frequency
- Default:
0
- Range:
0
-255
- Unit:
Hz
RC Smoothing Derivative Filter Frequency
- Default:
0
- Range:
0
-255
- Unit:
Hz
RC Smoothing Debug Axis
- Default:
ROLL
- Allowed:
ROLL
,PITCH
,YAW
,THROTTLE
RC Smoothing Input Filter Type
- Default:
BIQUAD
- Allowed:
PT1
,BIQUAD
RC Smoothing Derivative Filter Type
- Default:
BIQUAD
- Allowed:
OFF
,PT1
,BIQUAD
RC Smoothing Automatic Smoothness
- Default:
10
- Range:
0
-50
TODO: FPV Mix Degrees
- Default:
0
- Range:
0
-90
- Unit:
deg
- BF Configurator: FPV Camera Angle [degrees]
Camera tilt angle in degrees that should be compensated for when enabling FPV Angle Mix mode. It can be used to fly FPV as if the camera was tilted differently. Also known as uptilt compensation.
Maximum AUX Channels
- Default:
14
- Range:
0
-14
SerialRX Provider
- Default:
SBUS
- Allowed:
SPEK1024
,SPEK2048
,SBUS
,SUMD
,SUMH
,XB-B
,XB-B-RJ01
,IBUS
,JETIEXBUS
,CRSF
,SRXL
,CUSTOM
,FPORT
,SRXL2
When feature SERIALRX
is enabled, this allows connection to several receivers which output data via digital interface resembling serial.
SerialRX Inversion
- Default:
OFF
- Allowed:
OFF
,ON
TODO: Spektrum Sat Bind
- Default:
0
- Range:
0
-10
Used to bind the spektrum satellite to RX. Set 0
to disable.
TODO: Spektrum Sat Bind Automatic Reset
- Default:
ON
- Allowed:
OFF
,ON
- Default:
1
- Range:
0
-15
- Default:
ON
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
TODO: Airmode Start Throttle Percentage
- Default:
25
- Range:
0
-100
- Unit:
%
As a safety feature when having airmode enabled, it will not become active until you throttle up above this value in percent once. After that airmode will be active in the whole throttle range, until you disarm.
RX Minimum Pulse Length
- Default:
885
- Range:
750
-2250
- Unit:
us
- BF Configurator: Minimum length
Minimum valid pulse length [usec]. Pulses shorter than minimum are invalid and will trigger application of individual channel fallback settings for AUX channels or entering stage 1 for flightchannels.
RX Maximum Pulse Length
- Default:
2115
- Range:
750
-2250
- Unit:
us
- BF Configurator: Maximum length
Maximum valid pulse length [usec]. Pulses longer than maximum are invalid and will trigger application of individual channel fallback settings for AUX channels or entering stage 1 for flightchannels.
SerialRX Half Duplex
- Default:
OFF
- Allowed:
OFF
,ON
RX SPI Protocol
- Default:
V202_250K
- Allowed:
V202_250K
,V202_1M
,SYMA_X
,SYMA_X5C
,CX10
,CX10A
,H8_3D
,INAV
,FRSKY_D
,FRSKY_X
,FLYSKY
,FLYSKY_2A
,KN
,SFHSS
,SPEKTRUM
,FRSKY_X_LBT
RX SPI Bus
- Default:
0
- Range:
0
-3
RX SPI LED Inversion
- Default:
OFF
- Allowed:
OFF
,ON
ADC Device
- Default:
1
- Range:
0
-3
TODO: ADC Vrefint Calibration
- Default:
0
- Range:
0
-2000
TODO: ADC Temperature Sensor Calibration30
- Default:
0
- Range:
0
-2000
TODO: ADC Temperature Sensor Calibration110
- Default:
0
- Range:
0
-2000
Input Filtering Mode
- Default:
OFF
- Allowed:
OFF
,ON
Filter out noise from OpenLRS Telemetry RX
Blackbox P-Frame Ratio
- Default:
32
- Range:
0
-32767
Describes how many blackbox P-frames (delta) are written for every I-frame (absolute). This can also be defined as the ratio: I-frame interval
/ P-frame interval
. It can be adjusted in BF Configurator with the Blackbox logging rate option in Hz.
Blackbox Device
- Default:
SDCARD
- Allowed:
NONE
,SPIFLASH
,SDCARD
,SERIAL
- BF Configurator: Blackbox logging device
TODO: Device used for logging blackbox stats.
Blackbox Record Accelerometer
- Default:
ON
- Allowed:
OFF
,ON
Include accelerometer data in the blackbox logs.
Blackbox Mode
- Default:
NORMAL
- Allowed:
NORMAL
,MOTOR_TEST
,ALWAYS
Determines when to enable blackbox logging. E.g. flipping a switch or when testing motors in BF Configurator.
Minimum Throttle
- Default:
1070
- Range:
750
-2250
- Unit:
us
These are minimum values (in us) that are sent to ESC when armed. This should be set to a value that reliably spins the motors. You can choose a value by performing a motor test in BF Configurator, and increase the motor speed until the motor spins properly.
Maximum Throttle
- Default:
2000
- Range:
750
-2250
- Unit:
us
These are maximum values (in us) that are sent to ESC when armed. You can perform a motor test in BF Configurator to select this value. Usually the maximum of 2000
is fine. If you want less throttle you should not change this value, but instead use throttle_limit_percent.
TODO: Minimum Command
- Default:
1000
- Range:
750
-2250
- Unit:
us
This is the PWM value sent to ESCs when they are not armed. It should be less than your BLHeli minimum throttle configuration, to stop motors from spinning. If ESCs beep slowly when powered up, try decreasing this value. It can also be used for calibrating all ESCs at once.
Motor (DShot) Idle Throttle Value
- Default:
550
- Range:
0
-2000
- Unit:
bps
- BF Configurator: Motor Idle Throttle Value [percent]
This is the idle value of throttle that is sent to the ESCs when the craft is armed and the throttle stick is at minimum position. Specified in percent * 100
, i.e. 500
equals 5
percent of maximum throttle.
TODO: DShot Burst
- Default:
ON
- Allowed:
OFF
,ON
,AUTO
Bidirectional DShot
- Default:
OFF
- Allowed:
OFF
,ON
- BF Configurator: Bidirectional DShot (requires supported ESC firmware)
Bidirectional DShot. When enabled lets the DSHOT protocol receive information directly from the ESC, needed by the RPM Filter and other features. This requires custom firmware on BLHELI_S or the latest BLHELI_32 firmware.
DShot Bitbang Mode
- Default:
AUTO
- Allowed:
OFF
,ON
,AUTO
DShot Bitbang Timer
- Default:
AUTO
- Allowed:
AUTO
,TIM1
,TIM8
Use Unsynced PWM
- Default:
OFF
- Allowed:
OFF
,ON
Motor PWM Protocol
- Default:
DSHOT600
- Allowed:
OFF
,ONESHOT125
,ONESHOT42
,MULTISHOT
,BRUSHED
,DSHOT150
,DSHOT300
,DSHOT600
,PROSHOT1000
Motor PWM Rate
- Default:
480
- Range:
200
-32000
- Unit:
Hz
TODO: Output frequency (in Hz) for motor pins. Defaults are 400Hz for motor. If setting above 500Hz, will switch to brushed (direct drive) motors mode. For example, setting to 8000 will use brushed mode at 8kHz switching frequency. Up to 32kHz is supported. Default is 16000 for boards with brushed motors. Note, that in brushed mode, min_throttle is offset to zero. For brushed mode, set max_throttle to 2000.
Motor PWM Inversion
- Default:
OFF
- Allowed:
OFF
,ON
Number of Motor Poles
- Default:
14
- Range:
4
-255
- BF Configurator: Motor poles (number of magnets on the motor bell)
Represents the number of magnets that are on the bell of the motor. Do NOT count the stators where the windings are located. This setting is used for features such as the RPM Filter. Typical 5" motors have 14 magnets, smaller ones like 3" or less usually have 12 magnets.
TODO: Thr Corr Value
- Default:
0
- Range:
0
-150
TODO: Thr Corr Angle
- Default:
800
- Range:
1
-900
Failsafe Stage 1 Delay
- Default:
4
- Range:
0
-200
- Unit:
ds
- BF Configurator: Guard time for stage 2 activation after signal lost [1 = 0.1 sec.]
Time for stage 1 to wait for recovery.
TODO: Failsafe Stage 2 Delay
- Default:
10
- Range:
0
-200
- Unit:
ds
Time in deciseconds to wait before turning off motors when failsafe is activated. See Failsafe documentation.
Failsafe Throttle Level
- Default:
1000
- Range:
750
-2250
- Unit:
us
Throttle level used for landing when failsafe is enabled. See Failsafe documentation.
Failsafe Switch Mode
- Default:
STAGE1
- Allowed:
STAGE1
,KILL
,STAGE2
- BF Configurator: Failsafe Switch Action
This option determines what happens when Failsafe is activated through AUX switch: Stage 1
activates Stage 1 failsafe. This is useful if you want to simulate the exact signal loss failsafe behavior. Stage 2
skips Stage 1 and activates the Stage 2 procedure immediately. Kill
disarms instantly (your craft will crash).
Failsafe Throttle Low Delay
- Default:
100
- Range:
0
-300
- Unit:
ds
- BF Configurator: Failsafe Throttle Low Delay [1 = 0.1 sec.]
Just disarm the craft instead of executing the selected failsafe procedure when the throttle was low for this amount of time.
Stage 2 Failsafe Procedure
- Default:
DROP
- Allowed:
AUTO-LAND
,DROP
,GPS-RESCUE
- BF Configurator: Stage 2 - Failsafe Procedure
Failsafe Recovery Delay
- Default:
20
- Range:
0
-200
- Unit:
ds
Failsafe Stick Threshold
- Default:
30
- Range:
0
-50
Board Alignment Roll Axis
- Default:
0
- Range:
-180
-360
- Unit:
deg
- BF Configurator: Roll Degrees
Assigns how the flight controller board is aligned on the roll axis.
Board Alignment Pitch Axis
- Default:
0
- Range:
-180
-360
- Unit:
deg
- BF Configurator: Pitch Degrees
Assigns how the flight controller board is aligned on the pitch axis.
Board Alignment Yaw Axis
- Default:
0
- Range:
-180
-360
- Unit:
deg
- BF Configurator: Yaw Degrees
Assigns how the flight controller board is aligned on the yaw axis.
Gimbal Mode
- Default:
NORMAL
- Allowed:
NORMAL
,MIXTILT
TODO: When feature SERVO_TILT
is enabled, this can be either NORMAL or MIXTILT
Battery Capacity
- Default:
0
- Range:
0
-20000
- Unit:
mAh
Capacity of the battery in mAh. Can be used with current_meter to detect remaining battery capacity. Leave at 0
to disable.
Maximum Battery Cell Voltage
- Default:
430
- Range:
100
-500
- Unit:
cV
- BF Configurator: Maximum Cell Voltage
Maximum voltage of a single cell in the battery. Used for battery PID compensation vbat_pid_gain, so be sure to set accordingly if enabling this option.
Full Battery Cell Voltage
- Default:
410
- Range:
100
-500
- Unit:
cV
TODO: Voltage of a single cell in battery to be considered fully charged. I think used for warning if battery is not fully charged.
Minimum Battery Cell Voltage
- Default:
330
- Range:
100
-500
- Unit:
cV
- BF Configurator: Minimum Cell Voltage
Minimum voltage allowed for a single cell in the battery. Warnings can be issued with beeper and OSD if this happens.
Battery Warning Cell Voltage
- Default:
350
- Range:
100
-500
- Unit:
cV
- BF Configurator: Warning Cell Voltage
Voltage of a single cell in the battery that should issue a warning, which can be detected with beeper and OSD.
TODO: Battery Hysteresis
- Default:
1
- Range:
0
-250
- Unit:
dV
Sets the hysteresis value for low-battery alarms, in 0.1V units, i.e. 1 = 0.1V. The alarm will only go off if the voltage dips this amount below the warning voltage. Can be used to tame alarms that go off too easily with sagging batteries etc.
Battery Current Meter Source
- Default:
ADC
- Allowed:
NONE
,ADC
,VIRTUAL
,ESC
,MSP
- BF Configurator: Current Meter Source
TODO: The VIRTUAL
current sensor, once calibrated, estimates the current value from throttle position.
Battery Voltage Meter Source
- Default:
ADC
- Allowed:
NONE
,ADC
,ESC
- BF Configurator: Voltage Meter Source
- Default:
300
- Range:
0
-2000
Use Battery Voltage Alerts
- Default:
ON
- Allowed:
OFF
,ON
Use Battery Current Alerts
- Default:
OFF
- Allowed:
OFF
,ON
TODO: Battery Current Alert Percentage
- Default:
10
- Range:
0
-100
- Unit:
%
TODO: Battery Voltage Cutoff Percentage
- Default:
100
- Range:
0
-100
- Unit:
%
TODO: Force Battery Cell Count
- Default:
0
- Range:
0
-24
Battery Voltage Low Pass Filter Period
- Default:
30
- Range:
0
-255
TODO Battery Current Low Pass Filter Period
- Default:
10
- Range:
0
-255
Battery Voltage Warning Duration
- Default:
0
- Range:
0
-150
Battery Voltage Critical Warning Duration
- Default:
0
- Range:
0
-150
Battery Voltage Scale
- Default:
110
- Range:
0
-255
- BF Configurator: Voltage Meter: Scale
TODO: Result is Vbatt in 0.1V steps. 3.3V = ADC Vref, 4095 = 12bit adc, 110 = 11:1 voltage divider (10k:1k) x 10 for 0.1V. Adjust this slightly if reported pack voltage is different from multimeter reading. You can get current voltage by typing "status" in cli.
Battery Voltage Divider Value
- Default:
10
- Range:
1
-255
- BF Configurator: Voltage Meter: Divider Value
Battery Voltage Multiplier Value
- Default:
1
- Range:
1
-255
- BF Configurator: Voltage Meter: Multiplier Value
Battery Current Scale
- Default:
179
- Range:
-16000
-16000
- BF Configurator: Amperage Meter: Scale [1/10th mV/A]
Battery Current Offset
- Default:
0
- Range:
-32000
-32000
- Unit:
mA
- BF Configurator: Amperage Meter: Offset [mA]
- Default:
0
- Range:
-16000
-16000
- Default:
0
- Range:
0
-16000
Beeper Inversion
- Default:
ON
- Allowed:
OFF
,ON
TODO: Beeper OD
- Default:
OFF
- Allowed:
OFF
,ON
Beeper Frequency
- Default:
0
- Range:
0
-16000
Beeper DShot Beacon Tone
- Default:
1
- Range:
1
-5
Adjusts the tone of the of the DShot beacon. Higher value equals a higher tone frequency.
Motor Direction Reversed
- Default:
OFF
- Allowed:
OFF
,ON
- BF Configurator: Motor direction is reversed
Configures the mixer to expect the motor direction to be reversed and the propellers to be on accordingly, in order to perform correct yaw movement. Warning: This does not reverse the motor direction. Use the configuration tool for your ESCs or switch the ESC motor wiring order to achieve this. Also known as Props Out configuration.
TODO: Crashflip Motor Percentage
- Default:
0
- Range:
0
-100
- Unit:
%
3D Low Throttle Deadband
- Default:
1406
- Range:
750
-1500
- Unit:
us
TODO: Low value of throttle deadband for 3D mode (when stick is in the 3d_deadband_throttle range, the fixed values of 3d_deadband_low / _high are used instead)
3D High Throttle Deadband
- Default:
1514
- Range:
1500
-2250
- Unit:
us
TODO: High value of throttle deadband for 3D mode (when stick is in the deadband range, the value in 3d_neutral is used instead)
3D Neutral Throttle
- Default:
1460
- Range:
750
-2250
- Unit:
us
Neutral (stop) throttle value for 3D mode
TODO: 3D Neutral Throttle Deadband
- Default:
50
- Range:
1
-100
TODO: Throttle signal will be held to a fixed value when throttle is centered with an error margin defined in this parameter.
- Default:
1000
- Range:
750
-1500
- Unit:
us
- Default:
2000
- Range:
1500
-2250
- Unit:
us
- Default:
OFF
- Allowed:
OFF
,ON
Servo Center Pulse
- Default:
1500
- Range:
750
-2250
- Unit:
us
TODO: Servo midpoint
Servo PWM Rate
- Default:
50
- Range:
50
-498
- Unit:
Hz
Output frequency (in Hz) servo pins. When using tricopters or gimbal with digital servo, this rate can be increased. Max of 498Hz (for 500Hz pwm period), and min of 50Hz. Most digital servos will support for example 330Hz.
Servo Low Pass Filter Cutoff Frequency
- Default:
0
- Range:
0
-400
- Unit:
Hz
- Default:
ON
- Allowed:
OFF
,ON
On tricopter mix only, if this is enabled, servo will always be correcting regardless of armed state.
- Default:
4
- Range:
4
-18
Reboot Character
- Default:
82
- Range:
48
-126
Special character used to trigger reboot.
- Default:
100
- Range:
100
-2000
- Unit:
Hz
- Default:
2500
- Range:
0
-32000
TODO: Inertial Measurement Unit KP Gain.
- Default:
0
- Range:
0
-32000
TODO: Inertial Measurement Unit KI Gain.
Maximum Arming Angle
- Default:
25
- Range:
0
-180
- Unit:
deg
- BF Configurator: Maximum ARM Angle [degrees]
Craft will not ARM if tilted more than specified number of degrees. Only applies if accelerometer is enabled. Setting to 180 will effectivly disable check.
Automatic Disarming Delay
- Default:
5
- Range:
0
-60
- Unit:
s
Automatically disarm multicopter after this delay in seconds of zero throttle. Disabled when 0
. The MOTOR_STOP
feature must be enabled for this to take effect.
- Default:
OFF
- Allowed:
OFF
,ON
GPS Provider
- Default:
NMEA
- Allowed:
NMEA
,UBLOX
,MSP
GPS standard.
- Default:
AUTO
- Allowed:
AUTO
,EGNOS
,WAAS
,MSAS
,GAGAN
Ground assistance type.
Automatic GPS Configuration
- Default:
ON
- Allowed:
OFF
,ON
TODO: Enable automatic configuration of UBlox GPS receivers.
Automatic GPS Baudrate Detection
- Default:
OFF
- Allowed:
OFF
,ON
Enable automatic detection of GPS baudrate.
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
GPS Rescue Angle
- Default:
32
- Range:
0
-200
GPS Rescue Initial Altitude
- Default:
50
- Range:
20
-100
GPS Rescue Descent Distance
- Default:
200
- Range:
30
-500
GPS Rescue Landing Altitude
- Default:
5
- Range:
3
-10
GPS Rescue Landing Distance
- Default:
10
- Range:
5
-15
GPS Rescue Ground Speed
- Default:
2000
- Range:
30
-3000
GPS Rescue Throttle P Gain
- Default:
150
- Range:
0
-500
GPS Rescue Throttle I Gain
- Default:
20
- Range:
0
-500
GPS Rescue Throttle D Gain
- Default:
50
- Range:
0
-500
GPS Rescue Velocity P Gain
- Default:
80
- Range:
0
-500
GPS Rescue Velocity I Gain
- Default:
20
- Range:
0
-500
GPS Rescue Velocity D Gain
- Default:
15
- Range:
0
-500
GPS Rescue Yaw P Gain
- Default:
40
- Range:
0
-500
GPS Rescue Minimum Throttle
- Default:
1100
- Range:
1000
-2000
GPS Rescue Maximum Throttle
- Default:
1600
- Range:
1000
-2000
- Default:
500
- Range:
100
-2500
- Default:
150
- Range:
100
-500
GPS Rescue Hovering Throttle
- Default:
1280
- Range:
1000
-2000
GPS Rescue Sanity Checks
- Default:
RESCUE_SANITY_ON
- Allowed:
RESCUE_SANITY_OFF
,RESCUE_SANITY_ON
,RESCUE_SANITY_FS_ONLY
- Default:
8
- Range:
5
-50
- Default:
100
- Range:
50
-1000
- Default:
OFF
- Allowed:
OFF
,ON
GPS Rescue Altitude Mode
- Default:
MAX_ALT
- Allowed:
MAX_ALT
,FIXED_ALT
,CURRENT_ALT
GPS Rescue Use Magnetometer
- Default:
ON
- Allowed:
OFF
,ON
RC Pitch and Roll Deadband
- Default:
0
- Range:
0
-32
- Unit:
us
These are values (in us) by how much RC input can be different before it's considered valid for roll and pitch axis. For transmitters with jitter on outputs, this value can be increased. Defaults are zero, but can be increased up to 10 or so if rc inputs twitch while idle. This value is applied either side of the centrepoint.
RC Yaw Deadband
- Default:
0
- Range:
0
-100
- Unit:
us
These are values (in us) by how much RC input can be different before it's considered valid for the yaw axis. For transmitters with jitter on outputs, this value can be increased. Defaults are zero, but can be increased up to 10 or so if rc inputs twitch while idle. This value is applied either side of the centrepoint.
- Default:
OFF
- Allowed:
OFF
,ON
TODO: PID Process Denominator
- Default:
4
- Range:
1
-16
- BF Configurator: PID loop frequency
Determines PID and motor write frequency by dividing the gyro sample rate, determined by gyro_sync_denom. This is automatically set to proper values when setting pid loop frequency in BF Configurator. The maximum frequency for the PID loop is limited by the maximum frequency that updates can be sent by the chosen ESC/motor protocol.
Runaway Takeoff Prevention
- Default:
ON
- Allowed:
OFF
,ON
TODO: Set this to OFF to completely disable the feature. Note that there will be no protection against runaway takeoff events and the firmware will behave as it did before the feature was implemented.
Runaway Takeoff Deactivation Delay
- Default:
500
- Range:
100
-1000
- Unit:
ms
TODO: This is the amount of successful flight time in milliseconds that must be accumulated to deactivate the feature. Valid values range from 100 (0.1 seconds) to 1000 (1 second). The default value of 500 (0.5 seconds) seems to be very reliable and shouldn't need to be adjusted. The goal is to deactivate the logic after a "reasonable" but short period of time once we've determined the craft is flying normally. However we want it to deactivate before we might reach the first point where a crash or other event may occur (like at the first gate during a race). Raising this value will delay the deactivation and it's possible that a crash or gate/branch clip could cause an unintended disarm. Lowering this value too much could result in the logic deactivating too soon and not providing protection in a runaway event. It's important to note that the delay is the accumulated amount of flight time where the other criteria like throttle level, stick activity, etc. are met. Thus the "real" elapsed time before deactivation may be longer than 0.5 seconds if the throttle was dropping below the limit or if the R/P/Y sticks were centered. The actual behavior can be viewed by using blackbox logging.
Runaway Takeoff Deactivation Throttle Percentage
- Default:
20
- Range:
0
-100
- Unit:
%
TODO: Determines the minimum throttle percentage threshold where successful flight can be considered. Valid values range from 0 to 100. Along with throttle level the logic also requires activity on the roll, pitch or yaw sticks along with the PID controller successfully controlling the craft with the PID_sum staying under control. When these conditions are met the logic accumulates successful flight time. Generally you won't need to adjust this value as most quads require around 25% or more throttle to takeoff/hover. The exception may be if you have and extremely powerful or light craft that is capable of flying well below 25% throttle. In this case you may want to lower this value closer to your actual hover throttle percent. If this value is set too low it's possible that the logic will deactivate too quickly and may not trigger in a real runaway event. Setting it too high will result in the logic taking more flight time to deactivate as it only accumulates flight time when the throttle is above the setting.
Thrust Linearization
- Default:
0
- Range:
0
-100
TODO: betaflight/betaflight#7304.
Transient Throttle Limit
- Default:
0
- Range:
0
-30
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
Frsky Default Latitude
- Default:
0
- Range:
-9000
-9000
Frsky Default Longitude
- Default:
0
- Range:
-18000
-18000
Frsky GPS Format
- Default:
0
- Range:
0
-1
- Default:
IMPERIAL
- Allowed:
IMPERIAL
,METRIC
- Default:
0
- Range:
0
-1
TODO: Set to 1 to send raw VBat value in 0.1V resolution for receivers that can handle it, or 0 (default) to use the standard method.
- Default:
5
- Range:
0
-120
- Default:
OFF
- Allowed:
OFF
,ON
Report Battery Cell Voltage
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
1,2,3,0,0,0,0,0,0,0,0,0,0,0,0
- Type:
Array[15]
- Default:
0
- Range:
0
-30000
Telemetry Disabled Voltage
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Current
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Fuel
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Mode
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Accelerometer X
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Accelerometer Y
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Accelerometer Z
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Pitch
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Roll
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Heading
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Altitude
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Vario
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Latitude Longitude
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Ground Speed
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled Distance
- Default:
OFF
- Allowed:
OFF
,ON
Telemetry Disabled ESC Current
- Default:
ON
- Allowed:
OFF
,ON
Telemetry Disabled ESC Voltage
- Default:
ON
- Allowed:
OFF
,ON
Telemetry Disabled ESC RPM
- Default:
ON
- Allowed:
OFF
,ON
Telemetry Disabled ESC Temperature
- Default:
ON
- Allowed:
OFF
,ON
Telemetry Disabled Temperature
- Default:
OFF
- Allowed:
OFF
,ON
LED Strip Visual Beeper
- Default:
OFF
- Allowed:
OFF
,ON
TODO: When set to ON
, and the LEDLOW mode is active (i.e. LED strip off), blink the LED strip in synch with beeping, as a visual indicator in cases where the craft is too far away for the beeper to be heard / multiple craft are flying.
LED Strip Visual Beeper Color
- Default:
WHITE
- Allowed:
BLACK
,WHITE
,RED
,ORANGE
,YELLOW
,LIME_GREEN
,GREEN
,MINT_GREEN
,CYAN
,LIGHT_BLUE
,BLUE
,DARK_VIOLET
,MAGENTA
,DEEP_PINK
LED Strip Color Mode
- Default:
GRB
- Allowed:
GRB
,RGB
LED Strip Profile
- Default:
STATUS
- Allowed:
RACE
,BEACON
,STATUS
LED Strip Race Color
- Default:
ORANGE
- Allowed:
BLACK
,WHITE
,RED
,ORANGE
,YELLOW
,LIME_GREEN
,GREEN
,MINT_GREEN
,CYAN
,LIGHT_BLUE
,BLUE
,DARK_VIOLET
,MAGENTA
,DEEP_PINK
LED Strip Beacon Color
- Default:
WHITE
- Allowed:
BLACK
,WHITE
,RED
,ORANGE
,YELLOW
,LIME_GREEN
,GREEN
,MINT_GREEN
,CYAN
,LIGHT_BLUE
,BLUE
,DARK_VIOLET
,MAGENTA
,DEEP_PINK
LED Strip Beacon Period
- Default:
500
- Range:
50
-10000
- Unit:
ms
LED Strip Beacon Percentage
- Default:
50
- Range:
0
-100
- Unit:
%
LED Strip Beacon Armed Only
- Default:
OFF
- Allowed:
OFF
,ON
SD Card Inversion Detection
- Default:
OFF
- Allowed:
OFF
,ON
SD Card Mode
- Default:
SPI
- Allowed:
OFF
,SPI
,SDIO
SD Card DMA
- Default:
OFF
- Allowed:
OFF
,ON
SD Card SPI Bus
- Default:
3
- Range:
0
-3
SDIO Clock Bypass
- Default:
OFF
- Allowed:
OFF
,ON
SDIO Cache
- Default:
OFF
- Allowed:
OFF
,ON
SDIO 4bit Width
- Default:
OFF
- Allowed:
OFF
,ON
OSD Unit System
- Default:
METRIC
- Allowed:
IMPERIAL
,METRIC
- BF Configurator: Units
Sets whether to use the Metric
or Imperial
unit system for numerical readouts in the On Screen Display (OSD).
- Default:
ON
- Allowed:
OFF
,ON
OSD Battery Not Full Warning
- Default:
ON
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
OSD Battery Critical Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD Visual Beeper Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD Crash Flip Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD ESC Failure Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD Core Temperature Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD RC Smoothing Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD Fail Safe Warning
- Default:
ON
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
OSD Launch Control Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD GPS Rescue Disabled Warning
- Default:
ON
- Allowed:
OFF
,ON
OSD RSSI Warning
- Default:
OFF
- Allowed:
OFF
,ON
OSD Link Quality Warning
- Default:
OFF
- Allowed:
OFF
,ON
OSD RSSI Alarm
- Default:
20
- Range:
0
-100
OSD Link Quality Alarm
- Default:
80
- Range:
0
-300
OSD RSSI dBm Alarm
- Default:
60
- Range:
0
-130
OSD Battery Capacity Alarm
- Default:
2200
- Range:
0
-20000
OSD Altitude Alarm
- Default:
100
- Range:
0
-10000
OSD ESC Temperature Alarm
- Default:
-128
- Range:
-128
-127
OSD ESC RPM Alarm
- Default:
-1
- Range:
-1
-32767
OSD ESC Current Alarm
- Default:
-1
- Range:
-1
-32767
OSD Core Temperature Alarm
- Default:
70
- Range:
0
-255
- Default:
20
- Range:
0
-90
- Default:
40
- Range:
0
-90
- Default:
OFF
- Allowed:
OFF
,ON
OSD Timer 1
- Default:
2560
- Range:
0
-32767
OSD Timer 2
- Default:
2561
- Range:
0
-32767
OSD Battery Voltage Position
- Default:
234
- Range:
0
-15359
OSD RSSI Position
- Default:
234
- Range:
0
-15359
OSD Link Quality Position
- Default:
234
- Range:
0
-15359
OSD RSSI dBm Position
- Default:
234
- Range:
0
-15359
OSD Timer 1 Position
- Default:
234
- Range:
0
-15359
OSD Timer 2 Position
- Default:
234
- Range:
0
-15359
OSD Remaining Time Estimate Position
- Default:
234
- Range:
0
-15359
OSD Flymode Position
- Default:
234
- Range:
0
-15359
OSD Anti Gravity Position
- Default:
234
- Range:
0
-15359
OSD G Force Position
- Default:
234
- Range:
0
-15359
OSD Throttle Position
- Default:
234
- Range:
0
-15359
OSD VTX Channel Position
- Default:
234
- Range:
0
-15359
OSD Crosshairs Position
- Default:
205
- Range:
0
-15359
- Default:
206
- Range:
0
-15359
- Default:
78
- Range:
0
-15359
OSD Current Position
- Default:
234
- Range:
0
-15359
OSD mAh Drawn Position
- Default:
234
- Range:
0
-15359
OSD Motor Diagnostics Position
- Default:
234
- Range:
0
-15359
OSD Craft Name Position
- Default:
234
- Range:
0
-15359
OSD Display Name Position
- Default:
234
- Range:
0
-15359
OSD GPS Speed Position
- Default:
234
- Range:
0
-15359
OSD GPS Longitude Position
- Default:
234
- Range:
0
-15359
OSD GPS Latitude Position
- Default:
234
- Range:
0
-15359
- Default:
234
- Range:
0
-15359
OSD Home Direction Position
- Default:
234
- Range:
0
-15359
OSD Home Distance Position
- Default:
234
- Range:
0
-15359
OSD Flight Distance Position
- Default:
234
- Range:
0
-15359
- Default:
234
- Range:
0
-15359
OSD Altitude Position
- Default:
234
- Range:
0
-15359
OSD PID Roll Position
- Default:
234
- Range:
0
-15359
OSD PID Pitch Position
- Default:
234
- Range:
0
-15359
OSD PID Yaw Position
- Default:
234
- Range:
0
-15359
OSD Debug Info Position
- Default:
234
- Range:
0
-15359
OSD Power Consumtion Position
- Default:
234
- Range:
0
-15359
- Default:
234
- Range:
0
-15359
OSD PID and Rate Proifle Position
OSD Warnings Position
- Default:
14665
- Range:
0
-15359
OSD Average Cell Voltage Position
- Default:
234
- Range:
0
-15359
- Default:
234
- Range:
0
-15359
- Default:
234
- Range:
0
-15359
OSD Battery Usage Position
- Default:
234
- Range:
0
-15359
OSD Disarmed Position
- Default:
234
- Range:
0
-15359
OSD Numerical Heading Position
- Default:
234
- Range:
0
-15359
OSD Numerical Vario Position
- Default:
234
- Range:
0
-15359
OSD ESC Temperature Position
- Default:
234
- Range:
0
-15359
OSD ESC RPM Position
- Default:
234
- Range:
0
-15359
OSD ESC RPM Frequncy Position
- Default:
234
- Range:
0
-15359
OSD RTC Date and Time Position
- Default:
234
- Range:
0
-15359
OSD Adjustment Range Position
- Default:
234
- Range:
0
-15359
OSD Flip After Crash Arrow Position
- Default:
234
- Range:
0
-15359
OSD Core Temperature Position
- Default:
234
- Range:
0
-15359
OSD Log Status Position
- Default:
234
- Range:
0
-15359
OSD Stick Overlay Left Position
- Default:
234
- Range:
0
-15359
OSD Stick Overlay Right Position
- Default:
234
- Range:
0
-15359
OSD Stick Overlay Radio Mode
- Default:
2
- Range:
1
-4
OSD Rate Profile Name Position
- Default:
234
- Range:
0
-15359
Displays the current value of the rateprofile_name variable.
OSD PID Profile Name Position
- Default:
234
- Range:
0
-15359
Displays the current value of the profile_name variable.
OSD Profile Name Position
- Default:
234
- Range:
0
-15359
Displays the name of the active OSD Profile osd_profile.
OSD Post Flight Statistics: RTC Date and Time
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Timer 1
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Timer 2
- Default:
ON
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Maximum Speed Recorded
OSD Post Flight Statistics: Maximum Distance
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Minimum Battery
- Default:
ON
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Battery Voltage at Time of Disarm
OSD Post Flight Statistics: Battery Voltage
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Minimum RSSI
- Default:
ON
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Maximum Current
- Default:
ON
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Battery mAh used.
- Default:
ON
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Maximum Altitude
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Blackbox Usage
- Default:
ON
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Blackbox Log Number
OSD Post Flight Statistics: Maximum G Force
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Maximum ESC Temperature
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Maximum ESC RPM
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Minimum Link Quality
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Flight Distance
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Total Flights
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Total Time
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Total Distance
- Default:
OFF
- Allowed:
OFF
,ON
OSD Post Flight Statistics: Minimum RSSI dBm
- Default:
OFF
- Allowed:
OFF
,ON
OSD Profile
- Default:
1
- Range:
1
-3
- BF Configurator: Active OSD Profile
Sets the active OSD profile.
OSD Profile 1 Name
- Type:
String[16]
Name of OSD Profile 1. Can be displayed in OSD using osd_profile_name_pos.
OSD Profile 2 Name
- Type:
String[16]
Name of OSD Profile 2. Can be displayed in OSD using osd_profile_name_pos.
OSD Profile 3 Name
- Type:
String[16]
Name of OSD Profile 3. Can be displayed in OSD using osd_profile_name_pos.
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
8
- Range:
0
-30
- Unit:
MHz
Task Statistics
- Default:
ON
- Allowed:
OFF
,ON
Debug Mode
- Default:
NONE
- Allowed:
NONE
,CYCLETIME
,BATTERY
,GYRO_FILTERED
,ACCELEROMETER
,PIDLOOP
,GYRO_SCALED
,RC_INTERPOLATION
,ANGLERATE
,ESC_SENSOR
,SCHEDULER
,STACK
,ESC_SENSOR_RPM
,ESC_SENSOR_TMP
,ALTITUDE
,FFT
,FFT_TIME
,FFT_FREQ
,RX_FRSKY_SPI
,RX_SFHSS_SPI
,GYRO_RAW
,DUAL_GYRO_RAW
,DUAL_GYRO_DIFF
,MAX7456_SIGNAL
,MAX7456_SPICLOCK
,SBUS
,FPORT
,RANGEFINDER
,RANGEFINDER_QUALITY
,LIDAR_TF
,ADC_INTERNAL
,RUNAWAY_TAKEOFF
,SDIO
,CURRENT_SENSOR
,USB
,SMARTAUDIO
,RTH
,ITERM_RELAX
,ACRO_TRAINER
,RC_SMOOTHING
,RX_SIGNAL_LOSS
,RC_SMOOTHING_RATE
,ANTI_GRAVITY
,DYN_LPF
,RX_SPEKTRUM_SPI
,DSHOT_RPM_TELEMETRY
,RPM_FILTER
,D_MIN
,AC_CORRECTION
,AC_ERROR
,DUAL_GYRO_SCALED
,DSHOT_RPM_ERRORS
,CRSF_LINK_STATISTICS_UPLINK
,CRSF_LINK_STATISTICS_PWR
,CRSF_LINK_STATISTICS_DOWN
,BARO
,GPS_RESCUE_THROTTLE_PID
,DYN_IDLE
,FF_LIMIT
,FF_INTERPOLATED
Rate Six Position Switch
- Default:
OFF
- Allowed:
OFF
,ON
Allows selection of all 6 rate profiles using a six position switch or pot. Normally, when configuring an adjustment channel for rate profile selection the channel value is divided into 3 ranges instead of 6.
CPU Overclocking
- Default:
OFF
- Allowed:
OFF
,192MHZ
,216MHZ
,240MHZ
Overclocks the flight controller CPU to run at a higher clock rate. It's recommended to only overclock if you have a CPU load higher than 50%. Overclocking can potentially overheat the CPU if not properly ventilated. Overclocking has previously been used to allow F4 FC to enable Gyro 32KHz sampling mode which was removed in Betaflight 4.0.
- Default:
5
- Range:
0
-30
- Default:
AUTO
- Allowed:
OFF
,ON
,AUTO
VTX Band
- Default:
0
- Range:
0
-8
- BF Configurator: Band
The band (index) to be used by the VTX. You must configure the VTX Table and set up a VTX communication protocol such as SmartAudio for this to work.
VTX Channel
- Default:
0
- Range:
0
-8
- BF Configurator: Channel
The channel (index) to be used by the VTX within the configured vtx_band. You must configure the VTX Table and set up a VTX communication protocol such as SmartAudio for this to work.
VTX Power Level
- Default:
0
- Range:
0
-7
- BF Configurator: Power
TODO: The power level (index) to be used by the VTX. You must configure the VTX Table and set up a VTX communication protocol such as SmartAudio for this to work. It can be modified if Pit Mode or vtx_low_power_disarm is enabled.
VTX Low Power Disarm
- Default:
OFF
- Allowed:
OFF
,ON
,UNTIL_FIRST_ARM
- BF Configurator: Low Power Disarm
When enabled, the VTX uses the lowest available power when disarmed (except if a failsafe has occurred).
VTX Frequency
- Default:
0
- Range:
0
-5999
- Unit:
MHz
- BF Configurator: Frequency
The frequency to be used by the VTX in MHz. Can be set directly if supported by your VTX, otherwise it is automatically set according to VTX table when you set vtx_band and vtx_channel.
VTX Pit Mode Frequency
- Default:
0
- Range:
0
-5999
- Unit:
MHz
- BF Configurator: Pit Mode frequency
Frequency to use (in MHz) when the VTX is in pit mode.
VTX Half Duplex UART
- Default:
ON
- Allowed:
OFF
,ON
Use half duplex UART to communicate with the VTX, using only a TX pin in the FC.
VTX SPI Bus
- Default:
0
- Range:
0
-3
VCD Video System
- Default:
AUTO
- Allowed:
AUTO
,PAL
,NTSC
- BF Configurator: Video Format
Sets the expected analog color system used by the connected FPV camera. Typically this can be left on AUTO
.
VCD Horizontal Offset
- Default:
0
- Range:
-32
-31
VCD Vertical Offset
- Default:
0
- Range:
-15
-16
MAX7456 Clock
- Default:
DEFAULT
- Allowed:
HALF
,DEFAULT
,FULL
MAX7456 SPI Bus
- Default:
2
- Range:
0
-3
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
0
- Range:
-6
-0
- Default:
0
- Range:
-3
-0
- Default:
0
- Range:
-6
-0
- Default:
0
- Range:
-3
-0
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
0
- Range:
0
-3
- Default:
2
- Range:
0
-3
ESC Sensor Half Duplex
- Default:
OFF
- Allowed:
OFF
,ON
ESC Sensor Current Offset
- Default:
0
- Range:
0
-16000
Frsky SPI Autobind
- Default:
OFF
- Allowed:
OFF
,ON
Frsky SPI TX ID
- Default:
0,0
- Type:
Array[2]
Frsky SPI Offset
- Default:
0
- Range:
-127
-127
Frsky SPI Bind Hop Data
- Default:
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
- Type:
Array[50]
GUESS: Data used to bind specific transmitter with receiver, using Frsky SPI protocol. This can avoid the need for rebinding, etc.
- Default:
0
- Range:
0
-255
- Default:
VBAT
- Allowed:
VBAT
,EXTADC
,CONST
CC2500 SPI Chip Detect
- Default:
ON
- Allowed:
OFF
,ON
LED Inversion
- Default:
0
- Range:
0
-7
Dashboard I2C Bus
- Default:
1
- Range:
0
-3
Dashboard I2C Address
- Default:
60
- Range:
8
-119
Camera Control Mode
- Default:
HARDWARE_PWM
- Allowed:
HARDWARE_PWM
,SOFTWARE_PWM
,DAC
TODO: https://github.com/betaflight/betaflight/wiki/FPV-Camera-Control-(Joystick-Emulation).
Camera Control Reference Voltage
- Default:
330
- Range:
200
-400
- Unit:
cV
TODO: Voltage (in 10 mV steps) measured across your camera's floating OSD and GND pins, usually 3V3.
Camera Control Key Press Delay
- Default:
180
- Range:
100
-500
- Unit:
ms
TODO: The duration of each key press (in ms presence at the camera_control pin, after consulting with RunCam it was set to 180 ms to accommodate most cameras, while some of them accept as low as 125 ms.
Camera Control Internal Resistance
- Default:
470
- Range:
10
-1000
- Unit:
hOhm
TODO: The internal resistance (in 100 Ohm steps) of your camera, most HS1177 derivatives have 47 kΩ, but that's not guaranteed. You'll have to derive this value for your camera in case the default one doesn't work.
Camera Control Button Resistance
- Default:
450,270,150,68,0
- Type:
Array[5]
Camera Control Inversion
- Default:
OFF
- Allowed:
OFF
,ON
TODO: Rangefinder Hardware
- Default:
NONE
- Allowed:
NONE
,HCSR04
,TFMINI
,TF02
Pinio Configuration
- Default:
1,1,1,1
- Type:
Array[4]
Pinio Box
- Default:
255,255,255,255
- Type:
Array[4]
USB HID/CDC Joystick Mode
- Default:
OFF
- Allowed:
OFF
,ON
TODO: Allows using your flight controller as a USB HID joystick. Useful if your transmitter does not support HID. Support is currently only available on F4 / F7 boards.
- Default:
ON
- Allowed:
OFF
,ON
Flash SPI Bus
- Default:
0
- Range:
0
-3
- Default:
6
- Range:
0
-10
- Default:
1000
- Range:
0
-5000
- Default:
0
- Range:
0
-1
- Default:
0
- Range:
0
-65535
Gyro 1 Bus Type
- Default:
SPI
- Allowed:
NONE
,I2C
,SPI
,SLAVE
,GYROAUTO
Gyro 1 SPI Bus
- Default:
1
- Range:
0
-3
Gyro 1 I2C Bus
- Default:
0
- Range:
0
-3
Gyro 1 I2C Address
- Default:
0
- Range:
0
-119
Gyro 1 Sensor Alignment
- Default:
CW180
- Allowed:
DEFAULT
,CW0
,CW90
,CW180
,CW270
,CW0FLIP
,CW90FLIP
,CW180FLIP
,CW270FLIP
,CUSTOM
- BF Configurator: First GYRO
GUESS: Alignment of the first gyro sensor, represented as a rotation string. This seems to be closely coupled with the gyro_1_align_* variables.
Gyro 1 Alignment Roll Axis
- Default:
0
- Range:
-3600
-3600
Assigns how the gyro sensor roll axis is aligned, independent of board alignment. This is updated by the First GYRO (gyro_1_sensor_align) in BF Configurator.
Gyro 1 Alignment Pitch Axis
- Default:
0
- Range:
-3600
-3600
Assigns how the gyro sensor pitch axis is aligned, independent of board alignment. This is updated by the First GYRO (gyro_1_sensor_align) in BF Configurator.
Gyro 1 Alignment Yaw Axis
- Default:
0
- Range:
-3600
-3600
Assigns how the gyro sensor yaw axis is aligned, independent of board alignment. This is updated by the First GYRO (gyro_1_sensor_align) in BF Configurator.
Gyro 2 Bus Type
- Default:
SPI
- Allowed:
NONE
,I2C
,SPI
,SLAVE
,GYROAUTO
Gyro 2 SPI Bus
- Default:
0
- Range:
0
-3
Gyro 2 I2C Bus
- Default:
0
- Range:
0
-3
Gyro 2 I2C Address
- Default:
0
- Range:
0
-119
Gyro 2 Sensor Alignment
- Default:
CW0
- Allowed:
DEFAULT
,CW0
,CW90
,CW180
,CW270
,CW0FLIP
,CW90FLIP
,CW180FLIP
,CW270FLIP
,CUSTOM
Like gyro_1_sensor_align, but for the second gyro sensor.
Gyro 2 Alignment Roll Axis
- Default:
0
- Range:
-3600
-3600
Like gyro_1_align_roll, but for the second gyro sensor.
Gyro 2 Alignment Pitch Axis
- Default:
0
- Range:
-3600
-3600
Like gyro_1_align_pitch, but for the second gyro sensor.
Gyro 2 Alignment Yaw Axis
- Default:
0
- Range:
-3600
-3600
Like gyro_1_align_yaw, but for the second gyro sensor.
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
- Default:
ON
- Allowed:
OFF
,ON
- Default:
OFF
- Allowed:
OFF
,ON
Timezone Offset Minutes
- Default:
0
- Range:
-780
-780
Gyro RPM Notch Filter Harmonics
- Default:
3
- Range:
0
-3
- BF Configurator: Gyro RPM Filter Harmonics Number
Number of harmonics per motor. A value of 3 (recommended for most quads) will generate 3 notch filters, per motor for each axis, totaling 36 notches. One at the base motor frequency and two harmonics at multiples of that base frequency.
Gyro RPM Notch Filter Q
- Default:
500
- Range:
1
-3000
Gyro RPM Notch Filter Minimum Frequency
- Default:
100
- Range:
50
-200
- Unit:
Hz
- BF Configurator: Gyro RPM Filter Min Frequency [Hz]
Minimum frequency that will be used by the RPM Filter.
D Term RPM Notch Filter Harmonics
- Default:
0
- Range:
0
-3
D Term RPM Notch Q
- Default:
500
- Range:
1
-3000
D Term RPM Notch Filter Minimum Frequency
- Default:
100
- Range:
50
-200
- Unit:
Hz
TODO: RPM Notch Low Pass Filter
- Default:
150
- Range:
100
-500
Flysky SPI TX ID
- Default:
0
- Range:
0
-4294967295
Flysky SPI RF Channels
- Default:
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
- Type:
Array[16]
TODO: Statistics
- Default:
OFF
- Allowed:
OFF
,ON
Statistics Total Flights
- Default:
0
- Range:
0
-4294967295
TODO: Statistics Total Time
- Default:
0
- Range:
0
-4294967295
TODO: Statistics Total Distance
- Default:
0
- Range:
0
-4294967295
Craft Name
- Type:
String[16]
- BF Configurator: Craft Name
Name of the craft. Used in log and config files, and can be displayed in OSD with osd_craft_name_pos.
Display Name
- Type:
String[16]
- BF Configurator: Display Name
Text that can be displayed in OSD with osd_display_name_pos. E.g. name of the pilot.
Altitude Position Source
- Default:
DEFAULT
- Allowed:
DEFAULT
,BARO_ONLY
,GPS_ONLY
Profile Name
- Type:
String[8]
Name of the PID profile. Can be seen in OSD using osd_pid_profile_name_pos.
D Term Dynamic Low Pass Filter 1 Minimum Cutoff Frequency
- Default:
70
- Range:
0
-1000
- Unit:
Hz
- BF Configurator: D Term Lowpass 1 Dynamic Min Cutoff Frequency [Hz]
D Term Dynamic Low Pass Filter 1 Maximum Cutoff Frequency
- Default:
170
- Range:
0
-1000
- Unit:
Hz
- BF Configurator: D Term Lowpass 1 Dynamic Max Cutoff Frequency [Hz]
D Term Low Pass Filter 1 Type
- Default:
PT1
- Allowed:
PT1
,BIQUAD
- BF Configurator: D Term Lowpass 1 Dynamic Filter Type
D Term Low Pass Filter 1 Cutoff Frequency
- Default:
150
- Range:
0
-4000
- Unit:
Hz
- BF Configurator: D Term Lowpass 1 Cutoff Frequency [Hz]
D Term Low Pass Filter 2 Type
- Default:
PT1
- Allowed:
PT1
,BIQUAD
- BF Configurator: D Term Lowpass 2 Filter Type
D Term Low Pass Filter 2 Cutoff Frequency
- Default:
150
- Range:
0
-4000
- Unit:
Hz
- BF Configurator: D Term Lowpass 2 Cutoff Frequency [Hz]
D Term Notch Filter Frequency
- Default:
0
- Range:
0
-4000
- Unit:
Hz
D Term Notch Filter Cutoff
- Default:
0
- Range:
0
-4000
- Unit:
Hz
Battery Voltage PID Compensation
- Default:
OFF
- Allowed:
OFF
,ON
- BF Configurator: Vbat PID Compensation
Increases the PID values to compensate when battery voltage gets lower. This will give more constant flight characteristics throughout the flight. The amount of compensation that is applied is calculated from the vbat_max_cell_voltage, so make sure that is set to something appropriate.
- Default:
ON
- Allowed:
OFF
,ON
If enabled, the copter will process the PID algorithm at minimum throttle. With this OFF
the PID controller does not respond to sticks when throttle values is below min_check.
Anti Gravity Mode
- Default:
SMOOTH
- Allowed:
SMOOTH
,STEP
- BF Configurator: Anti Gravity: Mode
Anti Gravity Threshold
- Default:
250
- Range:
20
-1000
To improve stability in fast changing G forces during flight. This applies to quick throttle jumps where multirotor can go through weightless transitions. In these cases the iterm can cause unwanted effects like pitching up or yawing due to strong changes in accumulation polarities.
Anti Gravity Gain
- Default:
5000
- Range:
1000
-30000
- BF Configurator: Anti Gravity: Gain
Anti Gravity boosts the I term when fast throttle changes are detected. Higher gain values provide stability and better attitude hold when you pump the throttle.
Feedforward Transition
- Default:
0
- Range:
0
-100
- BF Configurator: Feedforward transition
With this parameter, the Feedforward term can be reduced near the center of the sticks, which results in smoother end of flips and rolls. The value represents a point of stick deflection: 0
- stick centered, 100
- full deflection. When the stick is above that point, Feedforward is kept constant at its configured value. When the stick is positioned below that point, Feedforward is reduced proportionally, reaching 0
at the stick center position. Value of 100
gives maximum smoothing effect, while value of 0
keeps the Feedforward fixed at its configured value over the whole stick range.
- Default:
0
- Range:
0
-500
- Default:
0
- Range:
0
-500
- Default:
50
- Range:
10
-2000
- Default:
400
- Range:
100
-2000
- Default:
350
- Range:
50
-2000
- Default:
500
- Range:
100
-5000
- Default:
0
- Range:
0
-500
Crash Recovery Angle
- Default:
10
- Range:
5
-30
Crash Recovery Rate
- Default:
100
- Range:
50
-255
- Default:
200
- Range:
0
-1000
Crash Recovery
- Default:
OFF
- Allowed:
OFF
,ON
,BEEP
,DISARM
I Term Rotation
- Default:
OFF
- Allowed:
OFF
,ON
- BF Configurator: I Term Rotation
Rotates the current I Term vector properly to other axes as the quad rotates when yawing continuously during rolls and when performing funnels and other tricks. This is appreciated by LOS acro pilots. For FPV the effect is fairly subtle but can result in somewhat more predictable responses during abrupt stick inputs and while performing tricks.
I Term Relax Axes
- Default:
RP
- Allowed:
OFF
,RP
,RPY
,RP_INC
,RPY_INC
- BF Configurator: I Term Relax: Axes
TODO: Limits the accumulation of I Term when fast movements happen. This helps specially to reduce the bounceback at the end of rolls and other fast movements. You can choose the axes in which this is active, and if the fast movement is detectd using the Gyro or the Setpoint (stick).
I Term Relax Type
- Default:
SETPOINT
- Allowed:
GYRO
,SETPOINT
- BF Configurator: I Term Relax: Type
I Term Relax Cutoff
- Default:
20
- Range:
1
-100
- BF Configurator: I Term Relax: Cutoff
I Term Windup
- Default:
100
- Range:
30
-100
I Term Limit
- Default:
400
- Range:
0
-500
- Default:
500
- Range:
100
-1000
- Default:
400
- Range:
100
-1000
Yaw Low Pass Filter Cutoff Frequency
- Default:
0
- Range:
0
-500
- Unit:
Hz
Throttle Boost
- Default:
5
- Range:
0
-100
- BF Configurator: Throttle Boost
Allows throttle to be temporarily boosted on quick stick movements, which increases acceleration torque to the motors, providing a much faster throttle response.
Throttle Boost Cutoff
- Default:
15
- Range:
5
-50
Acro Trainer Angle Limit
- Default:
20
- Range:
10
-80
- Unit:
deg
- BF Configurator: Acro Trainer Angle Limit
Adds an angle limiting mode for pilots who are learning to fly in acro mode. The mode must be activated with a switch in the modes tab.
TODO: Acro Trainer Lookahead Time
- Default:
50
- Range:
10
-200
- Unit:
ms
Acro Trainer Debug Axis
- Default:
ROLL
- Allowed:
ROLL
,PITCH
- Default:
75
- Range:
25
-255
P Pitch
- Default:
46
- Range:
0
-200
Pitch P parameter
I Pitch
- Default:
90
- Range:
0
-200
Pitch I parameter
D Pitch
- Default:
38
- Range:
0
-200
Pitch D parameter
F Pitch
- Default:
95
- Range:
0
-2000
P Roll
- Default:
42
- Range:
0
-200
Roll P parameter
I Roll
- Default:
85
- Range:
0
-200
Roll I parameter
D Roll
- Default:
35
- Range:
0
-200
Roll D parameter
F Roll
- Default:
90
- Range:
0
-2000
P Yaw
- Default:
30
- Range:
0
-200
Yaw P parameter
I Yaw
- Default:
90
- Range:
0
-200
Yaw I parameter
D Yaw
- Default:
0
- Range:
0
-200
Yaw D parameter
- Default:
90
- Range:
0
-2000
Angle Level Strength
- Default:
50
- Range:
0
-200
Horizon Level Strength
- Default:
50
- Range:
0
-200
- Default:
75
- Range:
0
-200
- Default:
55
- Range:
10
-90
- Unit:
deg
TODO: The maximum allowed angle in degrees.
Horizon Tilt Effect
- Default:
75
- Range:
0
-250
Horizon Tilt Expert Mode
- Default:
OFF
- Allowed:
OFF
,ON
Absolute Control Gain
- Default:
0
- Range:
0
-20
- BF Configurator: Absolute Control
To enable Absolute Control, set this to 10
, Smaller quads are ok with 5
. This feature solves some underlying problems of iterm_rotation and should hopefully replace it at some point. This feature accumulates the absolute gyro error in quad coordinates and mixes a proportional correction into the setpoint. For it to work you need to enable AirMode and iterm_relax (for RP
). If you combine this feature with Integrated Yaw (use_integrated_yaw), you can set iterm_relax enabled for RPY
. You should not enable absolute control and iterm_rotation at the same time.
Absulote Control Limit
- Default:
90
- Range:
10
-255
Absulote Control Error Limit
- Default:
20
- Range:
1
-45
Absolute Control Cutoff
- Default:
11
- Range:
1
-45
Integrated Yaw
- Default:
OFF
- Allowed:
OFF
,ON
- BF Configurator: Integrated Yaw
Integrated Yaw is a feature which corrects a fundamental issue with quad control: while the pitch and roll axis are controlled by the thrust differentials the props generate yaw is different. Integrated Yaw fixes this by integrating the output of the yaw pid before applying them to the mixer. This normalizes the way the pids work. You can now tune as any other axis. It requires use of Absolute Control (abs_control_gain) since no I is needed with Integrated Yaw.
Integrated Yaw Relax
- Default:
200
- Range:
0
-255
D Min Roll
- Default:
20
- Range:
0
-100
- BF Configurator: D Min Roll
Controls the strength of dampening (D-term) in normal forward flight. During a sharp move or during prop wash, the Active D-gain raises to the Derivative gains (d_roll).
D Min Pitch
- Default:
22
- Range:
0
-100
- BF Configurator: D Min Pitch
Controls the strength of dampening (D-term) in normal forward flight. During a sharp move or during prop wash, the Active D-gain raises to the Derivative gains (d_pitch).
D Min Yaw
- Default:
0
- Range:
0
-100
- BF Configurator: D Min Yaw
Controls the strength of dampening (D-term) in normal forward flight. During a sharp move or during prop wash, the Active D-gain raises to the Derivative gains (d_yaw).
D Min Boost Gain
- Default:
27
- Range:
0
-100
- BF Configurator: D Min Gain
Adjusts how fast D gets up to its maximum value and is based on gyro to determine sharp moves and propwash events.
D Min Advance
- Default:
20
- Range:
0
-200
- BF Configurator: D Min Advance
Makes D go up earlier by using setpoint instead of gyro to determine sharp moves.
Motor Output Attenuation Percentage
- Default:
100
- Range:
1
-100
- Unit:
%
- BF Configurator: Motor Output Limit: Attenuation %
Attenuates motor commands by the set percentage. Reduces ESC current and motor heat when using higher cell count batteries, e.g. for similar performance from a 6S battery on a 4S build, try 66%; for a 4S battery on a 3S build, try 75%.
Automatic Profile Cell Count
- Default:
0
- Range:
-1
-8
- BF Configurator: Motor Output Limit: Cell Count
Automatically activates the first profile that has a cell count equal to the connected battery.
Launch Control Mode
- Default:
NORMAL
- Allowed:
NORMAL
,PITCHONLY
,FULL
- Default:
ON
- Allowed:
OFF
,ON
Launch Trigger Throttle Percentage
- Default:
20
- Range:
0
-90
- Unit:
%
- Default:
0
- Range:
0
-80
- Default:
40
- Range:
0
-200
- Default:
AVERAGED
- Allowed:
OFF
,ON
,AVERAGED
- Default:
60
- Range:
0
-255
- Default:
100
- Range:
0
-150
- Default:
15
- Range:
0
-50
Idle Minimum RPM
- Default:
0
- Range:
0
-100
Idle Adjustment Speed
- Default:
50
- Range:
25
-200
Idle P
- Default:
50
- Range:
10
-200
Idle PID Limit
- Default:
200
- Range:
10
-255
Idle Maximum Increase
- Default:
150
- Range:
0
-255
Rate Profile Name
- Type:
String[8]
Name of the rate profile. Can be displayed in OSD using osd_rate_profile_name_pos.
Throttle Midpoint
- Default:
50
- Range:
0
-100
- BF Configurator: Throttle MID
Throttle Mid. The thr_expo is centered around this point. Usually this is set around the hovering point.
Throttle Expo
- Default:
0
- Range:
0
-100
- BF Configurator: Throttle EXPO
Throttle Expo. Creates an exponential throttle curve around the thr_mid point. Used to increase throttle resolution, usually to support more fine-grained hovering.
Rates Type
- Default:
BETAFLIGHT
- Allowed:
BETAFLIGHT
,RACEFLIGHT
,KISS
Roll RC Rate
- Default:
100
- Range:
1
-255
- BF Configurator: Roll RC Rate
Pitch RC Rate
- Default:
100
- Range:
1
-255
- BF Configurator: Pitch RC Rate
Yaw RC Rate
- Default:
100
- Range:
1
-255
- BF Configurator: Yaw RC Rate
Roll RC Expo
- Default:
0
- Range:
0
-100
- BF Configurator: Roll RC Expo
Pitch RC Expo
- Default:
0
- Range:
0
-100
- BF Configurator: Pitch RC Expo
Yaw RC Expo
- Default:
0
- Range:
0
-100
- BF Configurator: Yaw RC Expo
Roll Super Rate
- Default:
70
- Range:
0
-255
- BF Configurator: Roll Super Rate
Pitch Super Rate
- Default:
70
- Range:
0
-255
- BF Configurator: Pitch Super Rate
Yaw Super Rate
- Default:
70
- Range:
0
-255
- BF Configurator: Yaw Super Rate
TPA Rate
- Default:
65
- Range:
0
-100
- BF Configurator: TPA
Throttle PID Attenuation rate. How much to reduce PID gains when throttle is beyond tpa_breakpoint. Used to eliminate fast oscillations at high throttle.
TPA Breakpoint
- Default:
1250
- Range:
750
-2250
- Unit:
us
- BF Configurator: TPA Breakpoint
Throttle PID Attenuation breakpoint. The point at which TPA should take effect. This should be set around the throttle point at which fast oscillations would occur.
TPA Mode
- Default:
D
- Allowed:
PD
,D
Throttle PID Attenuation mode. Determines which PID gains should be reduced. Used to be both P and D, but by default only D since Betaflight 4.0.
Throttle Limit Type
- Default:
OFF
- Allowed:
OFF
,SCALE
,CLIP
- BF Configurator: Throttle Limit
Select how throttle_limit_percent should limit maximum throttle. OFF
disables the feature. SCALE
will transform the throttle range from 0 to the selected percentage using the full stick travel (linear throttle curve). CLIP
will set a max throttle percentage and stick travel above that will have no additional effect.
Throttle Limit Percentage
- Default:
100
- Range:
25
-100
- Unit:
%
- BF Configurator: Throttle Limit %
Sets the desired maximum throttle percentage, according to throttle_limit_type.
Roll Rate Limit
- Default:
1998
- Range:
200
-1998
- Unit:
deg/s
Maximum velocity (deg/s) for roll. Caps a roll rate curve that would otherwise become higher.
Pitch Rate Limit
- Default:
1998
- Range:
200
-1998
- Unit:
deg/s
Maximum velocity (deg/s) for pitch. Caps a pitch rate curve that would otherwise become higher.
Yaw Rate Limit
- Default:
1998
- Range:
200
-1998
- Unit:
deg/s
Maximum velocity (deg/s) for yaw. Caps a yaw rate curve that would otherwise become higher.