A structured, blackbox-driven PID tuning protocol based on step response analysis. Derived from the methodology implemented in PIDtoolbox (Brian White, MATLAB) and adapted for iterative field use. The protocol requires a .bbl log from a dedicated test flight; do not attempt to tune from a freestyle or racing session …

Betaflight modes are conditions assigned to AUX channel ranges. When a switch position triggers a condition, the FC activates that mode. Some modes are mutually exclusive; others stack. Mode Map mindmap root((Betaflight<br/>Modes)) ARM Required before any motor spins Always on a dedicated switch Flight modes ACRO …

Betaflight supports four rate mode formulas. They all do the same job — map stick deflection (0 to ±1) to a commanded rotation rate (°/s) — but they parameterize the curve differently. Switching modes changes what the sliders mean, not what the quad feels like if you set equivalent parameters. Overview Mode CLI value …

Rates control how fast the drone rotates in response to stick input. Higher rates = faster rotation = more aggressive feel. A rate profile is shaped by three parameters — RC Rate, Super Rate, and Expo — plus the choice of rate system (Betaflight, Actual, etc.). Common Shorthand Profiles The 533 / 633 / 733 shorthand …

Stick commands let you trigger Betaflight functions from your transmitter sticks without a computer. Useful in the field. All commands require the quad to be disarmed. Throttle is always at its minimum position unless noted. Stick Positions 1 PITCH UP 2 ↑ 3YAW LEFT ← → YAW RIGHT 4 ↓ 5 PITCH DOWN 6 7ROLL maps to: ← LEFT …

What happens inside Betaflight when you move a slider. The formulas here are derived from pid.c in the Betaflight source. Understanding the math makes the configurator sliders predictable rather than mysterious. The PID Control Loop flowchart LR RC[RC setpoint<br/>°/s] --> ERR GYRO[Gyro measurement<br/>°/s] --> ERR …

Blackbox records every sensor reading, RC input, PID output, and motor command at high frequency. It is the most powerful diagnostic tool available — without it, tuning is guesswork. How the Pipeline Works flowchart LR A([Gyro<br/>8 kHz]) --> B[Betaflight<br/>PID loop] B --> C[Blackbox<br/>logger] C -->|Compressed| …

Betaflight ships with a Presets library that includes ready-made cinematic tunes. These lower aggression, soften filters, and reduce propwash artifacts for smooth, floaty footage. Loading a Preset Betaflight Configurator → Presets tab → search cinematic. Good starting points: Cinematic Freestyle — moderate filtering, …

The Betaflight CLI is the only source of truth for a complete build configuration. Configurator tabs show most settings, but the CLI exposes everything — including defaults that the GUI hides. Before any tune experiment, back up with diff all. After a session, back up again. Why diff all Instead of dump flowchart LR …

A collection of "first 10 minutes of a new build" failures and how to diagnose them. Wrong Motor Direction (Single Motor) Symptom: Quad lifts but drifts or rotates on the yaw axis; one arm tilts down immediately on throttle. Cause: One motor spinning the wrong direction. Motors come as CW and CCW variants; some have …

DSHOT is a digital ESC protocol. When used bidirectionally, it feeds motor RPM back to the flight controller, enabling the RPM filter — the single biggest improvement to motor noise rejection in modern Betaflight tunes. For the byte-level view of how the frames and eRPM telemetry are encoded on the wire, see DSHOT on …

ESC PWM frequency controls how often the ESC updates the power delivered to the motor. Higher frequency = smoother power delivery, lower frequency = less heat but coarser control. What PWM Frequency Does The ESC uses PWM to modulate the voltage applied to each motor phase. The frequency determines how many times per …

Failsafe is what happens when the RC link dies mid-flight. Without correct configuration, a link-loss event sends the quad flying away at full throttle or drops it like a stone. Neither is good. Two-Stage Failsafe Betaflight uses a two-stage system: flowchart TD A([RC signal<br/>lost]) --> B{Stage 1<br/>guard time} B …