diff --git a/usbconfig.md b/usbconfig.md index 4b9bc03..b453dca 100644 --- a/usbconfig.md +++ b/usbconfig.md @@ -59,19 +59,60 @@ Options are:
[!WARNING]
Attempting to set wifi settings via USB configuration tool without a USB adapter connected will lead to a hard crash - you will need to disconnect and reconnect power to recover.
+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.
+ +
++ +
+ + + +LED blink pattern +Meaning +Possible causes +Solutions ++ +⚠️ 1 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. ++ +⚠️ 2 long blinks, each lasting 1 seconds, then 2 short blinks, each lasting 1/4 of a second. Repeats twice +
Error while trying to implement Meshtastic 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 above.
This pattern may flash before other patterns.+ +✅ 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 deployed. 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. 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.