femtofox/usbconfig.md

2.1 KiB

To configure Femtofox 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. Note that this does not mean that the information in the config file is correct - only that we were able to copy it to system configuration.
✅ 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.