Troubleshooting
Start from what you observe, isolate one layer, and avoid changing multiple variables at once.
ESPFlight Docs · v1 • Validated v1 documentation path
# Choose the symptom
01
The app cannot find or keep the Drone connected
→ 02 Work through Wi-Fi, discovery, protocol, and controller-state checks.
The hardware does not power or a motor/output is wrong
→ 03 Return to wiring, power, modules, pin mapping, and propeller-off testing.
The Drone flips, drifts, vibrates, or oscillates
→ 04 Check orientation, mapping, mechanics, then tuning.
I am not sure what a term means
→Use the ESPFlight glossary.
# Troubleshooting rule
ONE LAYER AT A TIME
Return to the last known-good state, change one variable, and re-test. Do not respond to a connection problem by changing PID values or to a wrong motor mapping by changing network settings.