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.

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_rpm # uint32
global
OFF, ON OFF
needs USE_BLACKBOX, USE_DSHOT_TELEMETRY
—✓✓✓
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.

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.