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.

20 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.

SettingTypeRange or valuesDefault 4.44.52025.122026.6Notes
blackbox_device # uint8
global
NONE, SPIFLASH, SDCARD, SERIAL, VIRTUAL NONE
needs USE_BLACKBOX
✓✓Δ✓ 2025.12: new values VIRTUAL
blackbox_disable_acc # uint32
global
OFF, ON OFF
needs USE_BLACKBOX, USE_ACC
✓✓✓✓
blackbox_disable_alt # uint32
global
OFF, ON OFF
needs USE_BLACKBOX, USE_BARO, USE_RANGEFINDER
✓✓✓✓
blackbox_disable_attitude # uint32
global
OFF, ON OFF
needs USE_BLACKBOX, USE_ACC
——✓✓
blackbox_disable_bat # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_disable_debug # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_disable_gps # uint32
global
OFF, ON OFF
needs USE_BLACKBOX, USE_GPS
✓✓✓✓
blackbox_disable_gyro # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_disable_gyrounfilt # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
—✓✓✓
blackbox_disable_mag # uint32
global
OFF, ON OFF
needs USE_BLACKBOX, USE_MAG
✓✓✓✓
blackbox_disable_motors # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_disable_pids # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_disable_rc # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_disable_rssi # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_disable_servos # uint32
global
OFF, ON OFF
needs USE_BLACKBOX, USE_SERVOS
——✓✓
blackbox_disable_setpoint # uint32
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_high_resolution # uint8
global
OFF, ON OFF
needs USE_BLACKBOX
✓✓✓✓
blackbox_mode # uint8
global
NORMAL, MOTOR_TEST, ALWAYS NORMAL
needs USE_BLACKBOX
✓✓✓✓
blackbox_sample_rate # uint8
global
1/1, 1/2, 1/4, 1/8, 1/16 1/4
needs 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.

Also in this section

These settings exist in 2026.6, but their default depends on build options the simulator build does not compile (DShot, RPM filter, board drivers), so it is not printed here rather than guessed: blackbox_disable_rpm.

Other sections

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.