femtofox/usbconfig.md

2.9 KiB
Raw Blame History

USB configuration

To configure Femtofox wifi settings, you can insert a USB flash drive containing a configuration file. The system will automatically recognize, mount and implement the settings you specify.
The USB drive must be formatted with a single FAT32, exFAT, NTFS (read only) or ext4 partition. Add a file named femtofox-config.txt and add the following lines, keeping in mind this is CaSe sEnSiTiVe:

ssid="Your SSID name"
psk="wifipassword"
country="US"

[!NOTE]
For country, insert your country’s two letter code (such as CA or IN) in capital letters.

To apply your configuration, reboot the Femtofox with the USB drive plugged in. No other USB drives can be plugged in at the same time.

Boot codes

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
⚠️ One very long blink, lasting 4 seconds Failed to mount USB drive. Ignoring.
  • Invalid filesystem
  • Corrupted partition table
  • Defective USB drive
  • Use a supported partition (FAT32, exFAT, NTFS, ext4)
  • Repair partition table
  • Try another USB drive
  • ⚠️ 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.
    ✅ 10 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. Wifi will now restart and boot will proceed. You can disconnect the USB drive. 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 0.5 seconds Boot complete. Always appears last.

    [!NOTE]
    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.