13 Boot Codes
noon92 edited this page 2025-02-26 20:17:13 +02:00

When the Femtofox is finished booting, it will blink its User LED (see below) in a pattern which can be used to gather info on its status or help diagnose issues.
LEDs

LED blink pattern Meaning Possible causes Solutions

⚠️
──────────
1 very long blink, lasting 5 seconds

Failed to mount USB drive. Ignoring. • Invalid filesystem
• Corrupted partition table
• Defective USB drive
• Defective USB OTG adapter
• Use a supported partition (FAT32, exFAT, NTFS, ext4)
• Repair partition table
• Try another USB drive
• Try another USB OTG adapter

⚠️
───   ───
2 long blinks, each lasting 1.5 seconds

femtofox-config.txt is configured to skip if log exists. femtofox-config.txt is configured to skip if USB drive mounted successfully but femtofox-config.txt contains dont_run_if_log_exists="true" and a log is present on the USB drive. Ignoring. • Remove log from USB drive.
• Remove dont_run_if_log_exists line from femtofox-config.txt.

⚠️
───   ───   ───
3 long blinks, each lasting 1.5 seconds

USB drive mounted successfully but femtofox-config.txt was not found. Config file missing. Create configuration file as described in USB Configuration Tool.

⚠️
───   ───   ───   ───   ───
5 long blinks, each lasting 1.5 seconds

USB drive mounted successfully and femtofox-config.txt was found but did not contain readable configuration data. Configuration file improperly formatted or contains no data. Check configuration file contents as described in USB Configuration Tool.

⚠️
──   ──   -   -
2 long blinks, each lasting 1 second, then 2 short blinks, each lasting 1/4 of a second. Repeats twice

Error while trying to implement a setting. Some settings may have been implemented successfully. • The error may be transient.
• Configuration file may contain improper data.
• Try again.
• Check configuration file contents as described in USB Configuration Tool.
• Check the log.

This pattern may flash after the "success" pattern.

✅
·   ·   ·   ·   ·   ·   ·   ·   ·   ·
10 very fast blinks, each lasting 1/8th of a second

USB drive mounted successfully, and femtofox-config.txt was found and contained configuration data which was sent for deployment. Any affected services will now restart. You can disconnect the USB drive. This does not mean that the information in the config file is correct - only that it was readable.
Note that the "success" boot code will flash if at least one setting is successfully read - even if the setting was not implemented successfully.

✅
─   ─   ─   ─   ─
5 medium blinks, each lasting 0.5 seconds

Boot complete. Appears on every successful boot and always appears last. 🎉 Hooray!
!NOTE

Boot codes can appear in sequence - for example: one long (4 second) blink, followed by 5 medium (half second) blinks means the USB drive failed to mount, and that the boot sequence is complete.

!NOTE

During first boot, a run-once script executes. While this script is running, the User LED will power on and off every half second. This can take up to about 7 minutes, after which Femtofox will reboot.