The USB drive must be formatted with a single FAT32, exFAT, NTFS (read only - log will not be saved to drive) or ext4 partition. Add a file named femtofox-config.txt and whichever of the the following lines you want to set, keeping in mind this is CaSe sEnSiTiVe:
+The USB drive must be formatted with a single FAT32, exFAT, NTFS (read only - log will not be saved to drive) or ext4 partition. Add a file named femtofox-config.txt` and whichever of the the following lines you want to set, keeping in mind this is CaSe sEnSiTiVe:
wifi_ssid="Your SSID name"
-wifi_psk="wifipassword"
-wifi_country="US"
+wifi_psk="wifipassword"wifi_country="US"
timezone="America/New_York"
meshtastic_lora_radio="ebyte-e22-900m30s"
meshtastic_url="https://meshtastic.org/e/#CgMSAQESCAgBOAFAA0gB"
@@ -33,12 +35,13 @@ meshtastic_admin_key="base64:T/b8EGvi/Nqi6GyGefJt/jOQr+5uWHHZuBavkNcUwWQ="
meshtastic_legacy_admin="true"
-[!NOTE]
+
-Enter as many or as few settings as you like.[!NOTE]> + +> Enter as many or as few settings as you like.
For
-wifi_country, insert your country’s two letter code (such as CA or IN) in capital letters.Use a timezone as it appears in the tz database.
+> Use a timezone as it appears in the tz database.Meshtastic
-Formeshtastic_lora_radio, choose your radio from the supported hardware list.
+Formeshtastic_lora_radio`, choose your radio from the supported hardware list.
Options are:-
- @@ -50,19 +53,22 @@ Options are:
ebyte-e22-900m30smai-thinker-ra-01shnone(for simradio)Important: You cannot set URL and security settings in the same operation - if you must set both, set the URL first, then edit the
-femtofox-config.txtfile on the USB drive to remove the URL and add in your security settings.To add a
-meshtastic_admin_key, copy it from the app and addbase64:to the beginning (meshtastic_admin_key="base64:T/b8EGvi/Nqi6GyGefJt/jOQr+5uWHHZuBavkNcUwWQ=").Clearing the
+meshtastic_admin_keylist: The admin key list can contain up to three keys - if more are added they will be ignored. The USB configuration tool supports clearing the admin key list, after which you will need to re-add your admin key/s in a second operation. To clear the admin key list, entermeshtastic_admin_key="0", withoutbase64:.Important: You cannot set URL and security settings in the same operation - if you must set both, set the URL first, then edit the
+`femtofox-config.txt` file on the USB drive to remove the URL and add in your security settings.To add a
+meshtastic_admin_key, copy it from the app and add`base64:` to the beginning (meshtastic_admin_key="base64:T/b8EGvi/Nqi6GyGefJt/jOQr+5uWHHZuBavkNcUwWQ=").Clearing the
meshtastic_admin_key` list: The admin key list can contain up to three keys - if more are added they will be ignored. The USB configuration tool supports clearing the admin key list, after which you will need to re-add your admin key/s in a secondoperation. To clear the admin key list, entermeshtastic_admin_key="0"`, without`base64:.
--[!CAUTION]
+
-Attempting to set wifi settings via USB configuration tool without a wifi adapter connected will lead to a 5 minute hang while the configuration tool runs - either disconnect and reconnect power or wait the full 5 minutes to to recover.`. + +> [!CAUTION]
+Attempting to set wifi settings via USB configuration tool without a wifi adapterconnected will lead to a 5 minute hang while the configuration tool runs - either disconnect and reconnect power or wait the full 5 minutes to 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.
-A log (femtofox-config.log) is saved to /home/femto and the USB drive (except on NTFS, which is read only).
+
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.
**
+A log (`femtofox-config.log`) is saved to `/home/femto and the USB drive (except on NTFS, which is read only).
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.
+
+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.
________________ 1 very long blink, lasting 5 seconds |
-Failed to mount USB drive. Ignoring. | -| Failed to mount USB drive. Ignoring. | +| |
+ | |
||
_____ _____ _____ 3 long blinks, each lasting 1.5 seconds |
+_ _ _____ 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. | +| Config file missing. | +| Create configuration file as described above. |
_____ _____ _____ _____ _____ 5 long blinks, each lasting 1.5 seconds |
+ ____\_\_\_\_\_ ____\_\_\_\_\_ ____\_\_\_\_\_ ____\_\_\_\_\_ _____ 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. | +| 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 |
+ |
+| _ _ _ _ _ _ _ 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 a Meshtastic setting after 3 attempts. Some settings may have been implemented successfully. | -This pattern may flash before other patterns. The pattern will repeat once for each failed setting. |
+| |
+ | This pattern may flash before other patterns. The pattern will repeat once for each failed setting. |
|
. . . . . . . . . . 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 sent for deployment. 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. |
+|
+| . . . . . . . . . . 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 sent for deployment. 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 |
+__ _ __ __ __ 5 medium blinks, each lasting 0.5 seconds |
Boot complete. Appears on every successful boot and always appears last. |
-+ \ No newline at end of file[!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.[!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.