Troubleshooting
USB drive does not appear
Section titled “USB drive does not appear”Check:
- The board is actually receiving USB power.
- Input voltage is within the USB range.
- Your USB cable supports data.
- The selected USB port works.
- USB and storage health fields.
- Serial output.
Reconnect with hazardous outputs disconnected.
Unknown power source
Section titled “Unknown power source”If the board reports an unknown power source, inspect:
- Battery voltage
- Battery polarity
- Wiring
- Voltage-sense circuit
Supported classifications are:
USB: 4.5 - 5.5 V1S LiPo: 3.0 - 4.35 V2S LiPo: 6.0 - 8.4 VDo not continue using an unknown source until the cause is understood.
Calibration fails
Section titled “Calibration fails”Place the board on a stable surface.
Remove:
- Movement
- Vibration
- External disturbances
Then inspect:
IMU_STREAM_OKBARO_OKFAULT_REASONAlso check serial output.
Red blinking LED
Section titled “Red blinking LED”A rapidly blinking red LED indicates a latched fault.
When this occurs:
- Keep hazardous hardware disconnected.
- Read
FAULT_REASON. - Inspect the health checks.
- Find the underlying problem.
- Correct it before rebooting or retesting.
The pyro output is disabled while the critical fault is active.
Settings do not change
Section titled “Settings do not change”Check:
- Setting names are spelled correctly.
- Values use the expected format.
- The file was actually saved.
- The USB drive was safely ejected.
- The board was reconnected or rebooted.
Only edit normal configuration values in:
[settings]The diagnostic sections are generated by the firmware.
Flight log is missing
Section titled “Flight log is missing”Wait until the landing and save process has completed.
Then reconnect over USB and inspect:
/logsAlso check:
- Flash filesystem health
- Serial output
- Fault state
Do not remove power while the board is writing the log.