Betaflight Blackbox and debug: CLI settings
Blackbox logging device, sample rate and which fields are logged, plus `debug_mode`, which picks what the four debug channels record.
21 settings in Betaflight 2026.6.
Each range and value list is read from the release's src/main/cli/settings.c, each default from
the CLI get of the release built for the simulator (SITL), booted on an empty EEPROM, with 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 |
|---|---|---|---|---|---|---|---|---|
blackbox_device # |
uint8 global |
NONE, SPIFLASH, SDCARD, SERIAL, VIRTUAL | NONEneeds USE_BLACKBOX |
✓ | ✓ | Δ | ✓ | 2025.12: new values VIRTUAL |
blackbox_disable_acc # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX, USE_ACC |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_alt # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX, USE_BARO, USE_RANGEFINDER |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_attitude # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX, USE_ACC |
— | — | ✓ | ✓ | |
blackbox_disable_bat # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_debug # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_gps # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX, USE_GPS |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_gyro # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_gyrounfilt # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
— | ✓ | ✓ | ✓ | |
blackbox_disable_mag # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX, USE_MAG |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_motors # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_pids # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_rc # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_rpm # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX, USE_DSHOT_TELEMETRY |
— | ✓ | ✓ | ✓ | |
blackbox_disable_rssi # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_disable_servos # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX, USE_SERVOS |
— | — | ✓ | ✓ | |
blackbox_disable_setpoint # |
uint32 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_high_resolution # |
uint8 global |
OFF, ON | OFFneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_mode # |
uint8 global |
NORMAL, MOTOR_TEST, ALWAYS | NORMALneeds USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
blackbox_sample_rate # |
uint8 global |
1/1, 1/2, 1/4, 1/8, 1/16 | 1/4needs USE_BLACKBOX |
✓ | ✓ | ✓ | ✓ | |
debug_mode # |
uint8 global |
101 valuesNONE, CYCLETIME, BATTERY, GYRO_FILTERED, ACCELEROMETER, PIDLOOP, 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, MULTI_GYRO_RAW, MULTI_GYRO_DIFF, MAX7456_SIGNAL, MAX7456_SPICLOCK, SBUS, FPORT, RANGEFINDER, RANGEFINDER_QUALITY, OPTICALFLOW, 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_MAX, AC_CORRECTION, AC_ERROR, MULTI_GYRO_SCALED, DSHOT_RPM_ERRORS, CRSF_LINK_STATISTICS_UPLINK, CRSF_LINK_STATISTICS_PWR, CRSF_LINK_STATISTICS_DOWN, BARO, AUTOPILOT_ALTITUDE, DYN_IDLE, FEEDFORWARD_LIMIT, FEEDFORWARD, BLACKBOX_OUTPUT, GYRO_SAMPLE, RX_TIMING, D_LPF, VTX_TRAMP, GHST, GHST_MSP, SCHEDULER_DETERMINISM, TIMING_ACCURACY, RX_EXPRESSLRS_SPI, RX_EXPRESSLRS_PHASELOCK, RX_STATE_TIME, GPS_RESCUE_VELOCITY, GPS_RESCUE_HEADING, GPS_RESCUE_TRACKING, GPS_CONNECTION, ATTITUDE, VTX_MSP, GPS_DOP, FAILSAFE, GYRO_CALIBRATION, ANGLE_MODE, ANGLE_TARGET, CURRENT_ANGLE, DSHOT_TELEMETRY_COUNTS, RPM_LIMIT, RC_STATS, MAG_CALIB, MAG_TASK_RATE, EZLANDING, TPA, S_TERM, SPA, TASK, GIMBAL, WING_SETPOINT, CHIRP, FLASH_TEST_PRBS, MAVLINK_TELEMETRY, AUTOPILOT_PID, AUTOPILOT_STOP |
NONE |
✓ | Δ | Δ | Δ | 4.5: new values GPS_CONNECTION, GYRO_CALIBRATION, ANGLE_MODE, ANGLE_TARGET, CURRENT_ANGLE, RPM_LIMIT, RC_STATS, MAG_CALIB, MAG_TASK_RATE, EZLANDING 2025.12: new values MULTI_GYRO_RAW, MULTI_GYRO_DIFF, OPTICALFLOW, D_MAX, MULTI_GYRO_SCALED, AUTOPILOT_ALTITUDE, TPA, S_TERM, SPA, TASK, GIMBAL, WING_SETPOINT, AUTOPILOT_POSITION, CHIRP, FLASH_TEST_PRBS, MAVLINK_TELEMETRY; values dropped GYRO_SCALED, DUAL_GYRO_RAW, DUAL_GYRO_DIFF, D_MIN, DUAL_GYRO_SCALED, GPS_RESCUE_THROTTLE_PID 2026.6: new values AUTOPILOT_PID, AUTOPILOT_STOP; values dropped AUTOPILOT_POSITION |
✓ 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 (33)
- PID tuning (81)
- Angle, horizon and launch modes (24)
- Rates and throttle curve (25)
- Motors and ESC (35)
- Servos and gimbal (23)
- Receiver and RC link (32)
- Failsafe and arming (14)
- GPS (18)
- GPS rescue (12)
- Autopilot, position and altitude hold (66)
- Battery and current sensor (28)
- OSD (49)
- OSD element positions (93)
- VTX and camera control (12)
- Telemetry and serial (44)
- LED strip and beeper (12)
- Sensors and board alignment (38)
- System and hardware (23)
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.