diff --git a/README.md b/README.md index 2068a3e..fc72e19 100644 --- a/README.md +++ b/README.md @@ -34,14 +34,16 @@
Issues / to do / in progress:
Project goals:
To configure Femtofox wifi settings, you can insert a USB flash drive containing a configuration file named femtofox-config.txt.
+The USB drive must be formatted with a single FAT32, exFAT 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"
+
+++For country, insert your country’s two letter code (such as CA or IN) in capital letters.
+
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.
+