Basic Tuning
Separate hardware faults from control tuning and make only small, observable changes.
ESPFlight Docs · v1 • Validated v1 documentation path
# Diagnose before tuning
| Symptom | Check first |
|---|---|
| Drone flips immediately | Motor mapping, motor direction, propeller direction, IMU orientation. |
| Strong vibration | Propellers, motor mounting, frame rigidity, damaged parts. |
| Attitude display moves incorrectly | IMU orientation and axis direction. |
| Rapid oscillation | Mechanical vibration first, then PID values. |
| Connection-related behavior | Network and failsafe state before PID. |
# Tuning discipline
Keep a known-good baseline.
Change one variable at a time.
Use small steps.
Repeat the same simple test after each change.
Record the hardware, battery, propellers, firmware, mode, and values used.