This commit is contained in:
nagumii 2024-11-19 23:01:24 +02:00
commit 3d2b1e7199
2 changed files with 67 additions and 2 deletions

View file

@ -34,14 +34,16 @@
</ul>
<p><strong>Issues / to do / in progress:</strong></p>
<ul>
<li>WIFI over USB or UART (accomplished, unstable, optimizing)</li>
<li>WIFI over USB or UART (accomplished, stable, optimizing)</li>
<li>Meshtasticd to run LoRa radio over SPI (accomplished, updated image and instructions coming soon)</li>
<li>Custom carrier PCB with LoRa radio (in progress)</li>
<li>Custom PCB for USB, with power injection and GPIO/i2c control (in progress)</li>
<li>Ability to trigger GPIO to shut off USB via mesh</li>
<li>Prevent hanging on boot when no network ("[ ***] A start job is running for Raise network interfaces (2min 10s / 5min 6s"). Also, stop job on reboot</li>
<li>Prevent hanging on boot when no network ("[ ***] A start job is running for Raise network interfaces (2min 10s / 5min 6s"). Also, on reboot</li>
<li>Test power consumption with LoRa radio attached / figure out what size solar panel will be required</li>
<li>Work out i2c sharing between OS and Meshtasticd - allow mesh to access sensors while RTC is accessible to OS</li>
<li>Allow editing of config files by plugging in thumb drive</li>
<li>Test lowering CPU frequency - see if reduces total power consumption. Presumption is that it will not</li>
</ul>
<p><strong>Project goals:</strong></p>
<ul>

63
usbconfig.md Normal file
View file

@ -0,0 +1,63 @@
---
---
<h2 id="usb-configuration">USB configuration</h2>
<p>To configure Femtofox wifi settings, you can insert a USB flash drive containing a configuration file named <code>femtofox-config.txt</code>.<br>
The USB drive must be formatted with a single FAT32, exFAT or ext4 partition. Add a file named <code>femtofox-config.txt</code> and add the following lines, keeping in mind this is CaSe sEnSiTiVe:</p>
<pre><code>ssid="Your SSID name"
psk="wifipassword"
country="US"
</code></pre>
<blockquote>
<p>For country, insert your country’s two letter code (such as CA or IN) in capital letters.</p>
</blockquote>
<h3 id="boot-codes">Boot codes</h3>
<p>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.</p>
<table>
<thead>
<tr>
<th>LED blink pattern</th>
<th>Meaning</th>
<th>Possible causes</th>
<th>Solutions</th>
</tr>
</thead>
<tbody>
<tr>
<td>⚠️ One very long blink, lasting 4 seconds</td>
<td>Failed to mount USB drive. Ignoring.</td>
<td>* Invalid filesystem<br>* Corrupted partition table</td>
<td>* Use a supported partition (FAT32, exFAT, ext4)<br>* Repair partition table</td>
</tr>
<tr>
<td>⚠️ 3 long blinks, each lasting 1.5 seconds</td>
<td>USB drive mounted successfully but femtofox-config.txt was not found. Ignoring.</td>
<td>Config file missing.</td>
<td>Create configuration file as described above.</td>
</tr>
<tr>
<td>⚠️ 5 long blinks, each lasting 1.5 seconds</td>
<td>USB drive mounted successfully and femtofox-config.txt was found but did not contain readable configuration data. Ignoring.</td>
<td>Configuration file improperly formatted or contains no data.</td>
<td>Check configuration file contents as described above.</td>
</tr>
<tr>
<td>✅ 5 very fast blinks, each lasting 1/8th of a second</td>
<td>USB drive mounted successfully, and femtofox-config.txt was found and contained valid configuration data which was deployed. System will now reboot. <strong>Unplug the USB drive or the system will continue to reboot repeatedly.</strong></td>
<td>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.</td>
<td></td>
</tr>
<tr>
<td>✅ 5 medium blinks, each lasting 1/2 a second</td>
<td>Boot complete. Always appears last unless rebooting.</td>
<td></td>
<td></td>
</tr>
</tbody>
</table><blockquote>
<p>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.</p>
</blockquote>