From 57f5111bd9b0cc1ab0b1ccb34f64df39e477c09b Mon Sep 17 00:00:00 2001 From: noon92 <40807970+noon92@users.noreply.github.com> Date: Fri, 29 Nov 2024 15:58:38 +0200 Subject: [PATCH 1/2] usbconfig.md updated from https://stackedit.io/ --- usbconfig.md | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/usbconfig.md b/usbconfig.md index 1d74c70..71e89fc 100644 --- a/usbconfig.md +++ b/usbconfig.md @@ -4,15 +4,27 @@ ---
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.
+
To configure some Femtofox settings such as wifi, 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"
+wifi_ssid="Your SSID name"
+wifi_psk="wifipassword"
+wifi_country="US"
+lora_radio="ebyte-e22-900m30s"
[!NOTE]
-For country, insert your country’s two letter code (such as CA or IN) in capital letters.
+For wifi country, insert your country’s two letter code (such as CA or IN) in capital letters.
+For LoRa radio, choose your radio from the supported hardware list.
+Options are:
+
+- ebyte-e22-900m30sm
+- ebyte-e22-900m22s
+- e22-900mm22s
+- heltec-ht-ra62
+- seeed-wio-sx1262
+- waveshare-sx126x-xxxm
+- ai-thinker-ra-01sh
+
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
@@ -49,8 +61,8 @@ For country, insert your country’s two letter code (such as CA or IN) in capit
✅ 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.
+USB drive mounted successfully, and femtofox-config.txt was found and contained valid configuration data which was deployed. Any affected services will now restart. You can disconnect the USB drive.
+Note that this does not mean that the information in the config file is correct - only that it was readable.
From 5784406152f4c3396ee8eaa149122e46792cd98c Mon Sep 17 00:00:00 2001
From: noon92 <40807970+noon92@users.noreply.github.com>
Date: Fri, 29 Nov 2024 16:11:58 +0200
Subject: [PATCH 2/2] usbconfig.md updated from https://stackedit.io/
---
usbconfig.md | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/usbconfig.md b/usbconfig.md
index 71e89fc..1234863 100644
--- a/usbconfig.md
+++ b/usbconfig.md
@@ -10,10 +10,12 @@ The USB drive must be formatted with a single FAT32, exFAT, NTFS (read only) or
wifi_psk="wifipassword"
wifi_country="US"
lora_radio="ebyte-e22-900m30s"
+timezone="America/New_York"
[!NOTE]
-For wifi country, insert your country’s two letter code (such as CA or IN) in capital letters.
+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.
For LoRa radio, choose your radio from the supported hardware list.
Options are:
@@ -25,6 +27,7 @@ Options are:
- waveshare-sx126x-xxxm
- ai-thinker-ra-01sh
+For timezone, use a timezone as it appears in the tz database.
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
@@ -62,7 +65,7 @@ Options are:
✅ 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. Any affected services will now restart. You can disconnect the USB drive.
-Note that this does not mean that the information in the config file is correct - only that it was readable.
+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 some data was not read successfully.