femtofox/usbconfig.md

2 KiB
Raw Blame History

To configure the Femtofox’s wifi settings, you can insert a USB drive containing a configuration file named femtofox-config.txt

Boot codes

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

LED blink pattern Meaning Possible causes Solutions
⚠️ One very long blink, lasting 4 seconds Failed to mount USB drive. Ignoring. * Invalid filesystem
* Corrupted partition table
* Use a supported partition (FAT32, exFAT, ext4)
* Repair partition table
⚠️ 3 long blinks, each lasting 1.5 seconds USB drive mounted successfully but femtofox-config.txt was not found. Ignoring. Config file missing. Create configuration file as described above.
⚠️ 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. Ignoring. Configuration file improperly formatted or contains no data. Check configuration file contents as described above.
✅ 5 very fast blinks, each lasting 1/8th of a second USB drive mounted successfully, and femtofox-config.txt was found and contained valid configuration data which was deployed. System will now reboot. Unplug the USB drive or the system will continue to reboot repeatedly.
✅ 5 medium blinks, each lasting 1/2 a second Boot complete. Always appears last unless rebooting.

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