Betaflight Battery and current sensor: CLI settings
Cell voltage limits and warnings, voltage and current sensor scaling, and battery profiles where the release has them.
28 settings in Betaflight 2026.6.
Each range and value list is read from the firmware's settings.c, each default from the
CLI get of the release built for the simulator (no board config applied), so a board's own
config can still change it. Set one with set name = value, then save.
Paste a diff all into the CLI checker to test it against any release.
| Setting | Type | Range or values | Default | 4.4 | 4.5 | 2025.12 | 2026.6 | Notes |
|---|---|---|---|---|---|---|---|---|
bat_capacity # |
uint16 battery profile |
0 to 20000 | 0 |
✓ | ✓ | ✓ | ✓ | |
battery_continue # |
uint8 global |
OFF, ON | OFFneeds USE_BATTERY_CONTINUE |
✓ | ✓ | ✓ | ✓ | |
battery_meter # |
uint8 global |
NONE, ADC, ESC | NONE |
✓ | ✓ | ✓ | ✓ | |
battery_profile_name # |
uint8 battery profile |
text, 1 to 8 characters | - (empty)needs USE_PROFILE_NAMES |
— | — | — | ✓ | |
cbat_alert_percent # |
uint8 battery profile |
0 to 100 | 10 |
✓ | ✓ | ✓ | ✓ | |
current_meter # |
uint8 global |
NONE, ADC, VIRTUAL, ESC, MSP | set by the target |
✓ | ✓ | ✓ | ✓ | |
force_battery_cell_count # |
uint8 battery profile |
0 to 24 | 0 |
✓ | ✓ | ✓ | ✓ | |
ibat_lpf_period # |
uint8 global |
0 to 255 | 10 |
✓ | ✓ | ✓ | ✓ | |
ibata_offset # |
int16 global |
-32000 to 32000 | 0 |
✓ | ✓ | ✓ | ✓ | |
ibata_scale # |
int16 global |
-16000 to 16000 | 400 |
✓ | ✓ | ✓ | ✓ | |
ibatv_offset # |
uint16 global |
0 to 16000 | 0needs USE_VIRTUAL_CURRENT_METER |
✓ | ✓ | ✓ | ✓ | |
ibatv_scale # |
int16 global |
-16000 to 16000 | 0needs USE_VIRTUAL_CURRENT_METER |
✓ | ✓ | ✓ | ✓ | |
use_cbat_alerts # |
uint8 global |
OFF, ON | OFF |
✓ | ✓ | ✓ | ✓ | |
use_vbat_alerts # |
uint8 global |
OFF, ON | ON |
✓ | ✓ | ✓ | ✓ | |
vbat_cutoff_percent # |
uint8 global |
0 to 100 | 100 |
✓ | ✓ | ✓ | ✓ | |
vbat_detect_cell_voltage # |
uint16 global |
0 to 2000 | 300 |
✓ | ✓ | ✓ | ✓ | |
vbat_display_lpf_period # |
uint8 global |
1 to 255 | 30 |
✓ | ✓ | ✓ | ✓ | |
vbat_divider # |
uint8 global |
1 to 255 | 10 |
✓ | ✓ | ✓ | ✓ | |
vbat_duration_for_critical # |
uint8 global |
0 to 150 | 0 |
✓ | ✓ | ✓ | ✓ | |
vbat_duration_for_warning # |
uint8 global |
0 to 150 | 0 |
✓ | ✓ | ✓ | ✓ | |
vbat_full_cell_voltage # |
uint16 battery profile |
100 to 500 | 410 |
✓ | ✓ | ✓ | ✓ | |
vbat_hysteresis # |
uint8 global |
0 to 250 | 1 |
✓ | ✓ | ✓ | ✓ | |
vbat_max_cell_voltage # |
uint16 battery profile |
100 to 500 | 430 |
✓ | ✓ | ✓ | ✓ | |
vbat_min_cell_voltage # |
uint16 battery profile |
100 to 500 | 330 |
✓ | ✓ | ✓ | ✓ | |
vbat_multiplier # |
uint8 global |
1 to 255 | 1 |
✓ | ✓ | ✓ | ✓ | |
vbat_sag_lpf_period # |
uint8 global |
1 to 255 | 2needs USE_BATTERY_VOLTAGE_SAG_COMPENSATION |
✓ | ✓ | ✓ | ✓ | |
vbat_scale # |
uint8 global |
0 to 255 | 110 |
✓ | ✓ | ✓ | ✓ | |
vbat_warning_cell_voltage # |
uint16 battery profile |
100 to 500 | 350 |
✓ | ✓ | ✓ | ✓ |
✓ present, Δ changed in that release (hover for what changed), — not in that release. “needs USE_…” is the build option the setting is compiled with: a cloud build without it has no such setting.
Other sections
- Gyro and D-term filters (27)
- PID tuning (73)
- Angle, horizon and launch modes (20)
- Rates and throttle curve (25)
- Motors and ESC (23)
- Receiver and RC link (32)
- Failsafe and arming (14)
- GPS (14)
- GPS rescue (12)
- Autopilot, position and altitude hold (66)
- OSD (49)
- OSD element positions (90)
- VTX and camera control (12)
- Blackbox and debug (20)
- Telemetry and serial (44)
- LED strip and beeper (12)
- Sensors and board alignment (35)
- System and hardware (25)
What changed between releases: 4.4 → 4.5 · 4.5 → 2025.12 · 2025.12 → 2026.6. Machine-readable: params.json (2026.6.2), GPL-3.0 like the firmware it comes from.