You swap a flight controller, arm the quad, and it instantly flips into the dirt. No amount of PID tuning fixes it because the problem isn’t the tune — the FC thinks “forward” is a different direction than the quad’s actual forward. This is a board alignment problem, and it’s one of the most common post-build failures.
How FC Orientation Works
The flight controller has a gyro/accelerometer chip with a fixed physical orientation. When you mount the FC on the frame, the chip’s axes must align with the quad’s axes: X = forward, Y = right, Z = down. If the FC is rotated 90 degrees clockwise, the gyro’s “forward” is actually the quad’s “right” — and the PID controller tries to stabilize the wrong axis.
Betaflight handles this with the Board and Sensor Alignment section on the Configuration tab. You set yaw/pitch/roll degrees of rotation to tell Betaflight how the FC is physically oriented relative to the frame.
The Default Alignment Matrix
With the FC mounted arrow-forward (arrow on the silkscreen pointing toward the camera), all three alignment values are zero. The FC’s coordinate system matches the quad’s. This is the ideal scenario.
Common Non-Standard Orientations
| FC Orientation | Yaw Degrees | When You’d Use It |
|---|---|---|
| Arrow forward | 0 | Standard mount |
| Arrow right | 90 CW | USB port on left side, arrow points right |
| Arrow back | 180 | USB port on front (reverse mount) |
| Arrow left | 270 CW (or 90 CCW) | USB port on right side |
| Upside down, arrow forward | 0 yaw, 180 roll | FC mounted on bottom of stack |
Betaflight only supports 90-degree increments for the board alignment setting in the GUI. For non-standard angles (45 degrees, or a 30-degree rotated AIO board in a whoop), you need CLI commands.
Step-by-Step Alignment Verification
1. Props Off, USB Connected, Configurator Open
Connect to Betaflight Configurator. Go to the Setup tab. The 3D model in the top right shows a virtual quad that mirrors your real quad’s orientation. Pick up your quad and tilt it forward (nose down). The virtual quad should also tilt nose down.
If the virtual quad rolls left when you pitch the real quad forward, your yaw alignment is offset by 90 degrees. Arm the quad like this and it instantly flips because pitch corrections are applied to the roll axis.
2. Correct the Alignment in GUI or CLI
For 90-degree increments, use the GUI: Configuration tab → Board and Sensor Alignment → set the appropriate yaw/roll/pitch degrees → Save and Reboot.
For non-standard angles: use the CLI.
set align_board_yaw = 45
save
This handles a board mounted at 45 degrees — uncommon on 5-inch builds but common on whoops with angled AIO boards.
3. Verify Custom Motor Mixes
If your board alignment is non-standard AND you’re using a custom motor mix (or a non-standard motor ordering), the two interact. Betaflight’s motor ordering assumes the board alignment has already corrected for orientation. If you set the alignment and the quad still flips, double-check that your motor resources are mapped correctly.
resource list
This shows which physical motor outputs are assigned to motor 1-4. On a standard build with the FC arrow forward, motor 1 is rear-right, motor 2 is front-right, motor 3 is rear-left, motor 4 is front-left (Betaflight default). If you’ve rotated the FC, the motor numbering follows the FC, not the frame. The board alignment setting handles this automatically — motors remap to match.
4. Gyro Alignment — First Flight Verification
After setting alignment, arm the quad with props ON in a wide open area. Hover at knee height. If it wobbles violently or flips, disarm immediately. The alignment is wrong.
If it hovers but drifts hard in one direction: check that the accelerometer is calibrated. Go to the Setup tab, place the quad on a level surface, and click Calibrate Accelerometer.
If it hovers fine but the 3D model drifts slowly in the Configurator: gyro calibration issue, not an alignment issue. Reboot the FC on a level surface (the gyro calibrates at power-on).
Alignment Troubleshooting Table
| Symptom on Arm | Likely Cause | Fix |
|---|---|---|
| Instant violent flip | FC yaw alignment offset by 90° | Set align_board_yaw in GUI |
| Slow roll on takeoff | Alignment correct but I-term windup | Check I values, recalibrate accel |
| Flips only on one axis | Pitch/roll swapped (yaw 90° off) | Correct board yaw alignment |
| Hovers fine, flips on punch | Wrong motor direction or prop direction | Check motor direction, props in/out setting |
| 3D model moves wrong in Configurator | Board alignment not saved | Re-save alignment, reboot FC |
| Quad wobbles at specific angles | Non-perpendicular FC mount | Use align_board_roll/pitch in CLI |
What Most Pilots Get Wrong About FC Alignment
Mistake 1: Forgetting to save alignment after flashing firmware.
A full chip erase during firmware flash wipes the alignment setting back to default. If you re-flash and don’t restore your alignment, the quad flips on the next arm. Always restore from a diff all backup after flashing, or manually re-enter the alignment values.
Mistake 2: Confusing the 3D model lag with an alignment problem.
The 3D model in Betaflight Configurator has a slight processing delay. It won’t track 1:1 with fast movements. If it lags but eventually catches up with the correct orientation on slow movements, the alignment is fine. The model is a visual aid, not a diagnostic instrument.
Mistake 3: Mounting the FC with foam tape that compresses unevenly.
If the FC sits at a slight angle (3-5 degrees) because the mounting grommets or foam tape are uneven, the accelerometer sees this as a permanent tilt. Betaflight tries to correct for it, and the quad drifts. Use nylon standoffs with rubber grommets — they provide vibration isolation without introducing a tilt.
Mistake 4: Using the wrong arrow direction.
The silkscreen arrow on the FC points forward. Arrow forward = toward the camera. Arrow back = toward the VTX antenna. It’s printed on the board. Look at it. Don’t guess. I’ve seen builds where the pilot oriented the FC based on the USB port position, assuming USB = back. On some boards, USB is on the side. Always verify the arrow.
⚠️ Regulatory Notice: The flight recommendations in this article should be followed in accordance with the latest 2026 drone regulations in your country or region. Always verify local laws regarding flight altitude, no-fly zones, remote ID requirements, and registration before flying. Regulations vary significantly between the FAA (US), EASA (EU), CAA (UK), CAAC (China), and other authorities.
After getting your board alignment dialed in, check our Betaflight CLI guide for the essential commands that make tuning faster. If vibration is causing drift that mimics alignment issues, our soft mounting guide covers proper isolation techniques.
The Matek F722-SE has clearly labeled silkscreen arrows and a well-thought-out layout that puts the USB on the side — no guessing which way is forward. It’s been my go-to for builds where orientation could be ambiguous (tight frames, inverted stacks).