mirror of
https://github.com/femtofox/femtofox.git
synced 2026-10-26 19:02:00 -04:00
82 lines
5.4 KiB
Markdown
82 lines
5.4 KiB
Markdown
<img src="assets/images/KSE_side_shot.png" width="750">
|
|
|
|
|
|
# Femtofox <sub><sub>The tiny, low power Linux Meshtastic node
|
|
**Femtofox is a Linux-based mesh development platform - a Raspberry Pi sized computer with onboard LoRa radio, capable of being run with only 0.3w, making it *ideal* for solar powered nodes.**
|
|
|
|
The Luckfox Pico Mini is the postage stamp sized heart of the Femtofox - a compact and power efficient Linux board, running a customized version of Ubuntu. Femtofox is an expansion of the Luckfox's capabilities, utilizing a custom PCB with a 30db LoRa radio (over 6x the transmit power of a RAK Wisblock or Heltec V3) to create a power efficient, tiny and highly capable Meshtastic Linux node.
|
|
|
|
- [Features](#features)
|
|
- Specifications - coming soon
|
|
- [Supported hardware](./supported_hardware.md)
|
|
- [Installation guide](./foxbuntu_install.md)
|
|
- How to order - coming soon
|
|
- DIY instructions - coming soon
|
|
- [Networking](#networking)
|
|
- [USB configuration tool](./usb_config.md)
|
|
|
|
### Features
|
|
* Tiny size (63x54mm for the Kitchen Sink Edition, 65x30mm for the Smol Edition). Roughly equivalent to a standard Raspberry Pi hat and Pi Zero respectively.
|
|
* Power efficiency (~0.27-0.4w average, depending on radio and mesh congestion)
|
|
* Full Linux CLI (Ubuntu) via our pre-built Foxbuntu image
|
|
* Meshtastic native client support via SPI
|
|
* USB host support - attach USB peripherals (see [supported hardware](supported_hardware.md))
|
|
* USB wifi support (see [supported hardware](supported_hardware.md))
|
|
* RTC support for timekeeping (see [supported hardware](supported_hardware.md))
|
|
|
|
**Accomplished:**
|
|
- [x] Meshtastic native client controlling a LoRa radio (see [supported hardware](supported_hardware.md))
|
|
- [x] WIFI over USB (see [supported hardware](supported_hardware.md))
|
|
- [x] Ethernet over USB (see [supported hardware](supported_hardware.md))
|
|
- [x] Ethernet over pins (see *Networking* below and wiring diagram at bottom of page)
|
|
- [x] UART communications with Meshtastic nodes (2 pin pairs) such as RAK Wisblock
|
|
- [x] USB serial communications with Meshtastic nodes (see [supported hardware](supported_hardware.md))
|
|
- [x] USB mass storage
|
|
- [x] Real time clock (RTC) support (see [supported hardware](supported_hardware.md))
|
|
- [x] Activity LED disabled. User LED will blink for 5 seconds when boot is complete
|
|
- [x] Short pressing the "BOOT" button toggles wifi, 2-5 second press triggers reboot, 5+ second press shuts system down
|
|
- [x] Ability to reconfigure wifi via USB flash drive
|
|
- [x] Meshtasticd to run LoRa radio over SPI (accomplished, updated image and instructions coming soon)
|
|
- [x] Allow editing of config files by plugging in thumb drive
|
|
- [x] Ability to activate or deactivate WIFI via Meshtastic admin
|
|
|
|
The preconfigured images will reboot every 24 hours. If the internal clock is accurate, this will be at 3am. Reboot timing is set in `crontab`. To keep accurate time, an RTC module can be installed (see [supported hardware](supported_hardware.md)) or internet connectivity can be utilized for NTP via [Chrony](https://chrony-project.org/).
|
|
|
|
### [Supported hardware - click here](supported_hardware.md)
|
|
|
|
### Networking
|
|
There are four methods to get online:
|
|
1. Ethernet over USB - most adapters should be supported, but I've only tested the RTL8152 chipset.
|
|
2. USB wifi (see [supported hardware](supported_hardware.md)).
|
|
3. Preconfigured Ubuntu images: ethernet via the castellated pins at the bottom of the board. See pinout at the bottom of this readme.
|
|
4. RDNIS via usb - [see this guide](https://web.archive.org/web/20241006173648/https://wiki.luckfox.com/Luckfox-Pico/Luckfox-Pico-Network-Sharing-1/). Note that in the preconfigured images USB is set to host mode, so you'll have to switch back to peripheral with `sudo luckfox-config`. This is not really recommended, but can be used in a pinch.
|
|
|
|
### [Installation guide](foxbuntu_install.md)
|
|
|
|
### Pinout:
|
|
|Pin #|Pin ID |Function |Luckfox |Pin #|Pin ID |Function |
|
|
|-----|-------|--------------|--------|-----|-------|--------------|
|
|
|1 |VBus |5V in/out | |22 |1V8 |1.8V out |
|
|
|2 |GND | | |21 |GND | |
|
|
|3 |3V3 |3.3V out | |20 |4C1 |1v8 IO, SARADC|
|
|
|4/42 |1B2 |Debug UART2-TX| |19 |4C0 |1v8 IO, SARADC|
|
|
|5/43 |1B3 |Debug UART2-RX| |18/4 |0A4 |3v3 IO |
|
|
|6/48 |1C0 |CS0, IO | |17/55|1C7 |IRQ, IO |
|
|
|7/49 |1C1 |CLK, IO | |16/54|1C6 |BUSY, IO |
|
|
|8/50 |1C2 |MOSI, IO | |15/59|1D3 |i2c SCL |
|
|
|9/51 |1C3 |MISO, IO | |14/58|1D2 |i2c SDA |
|
|
|10/52|1C4 |UART4-TX | |13/57|1D1 |UART3-RX, NRST|
|
|
|11/53|1C5 |UART4-RX | |12/56|1D0 |UART3-TX, RXEN|
|
|
|
|
Pin ID explanation: **1C6** = GPIO bank **1**, group **C**, pin **6**.
|
|
In Meshtasticd's config.yaml we use GPIO bank 1, and subtract 32 from the pin number.
|
|
|
|
|
|
|
|
|
|
> [!NOTE]
|
|
> The information on this page is given without warranty or guarantee. Links to vendors of products are for informational purposes only.
|
|
> Meshtastic® is a registered trademark of Meshtastic LLC. Meshtastic software components are released under various licenses, see GitHub for details. No warranty is provided - use at your own risk.
|
|
<!--stackedit_data:
|
|
eyJoaXN0b3J5IjpbMTAyOTUxODA1MywtODA3NjYxMjY1XX0=
|
|
-->
|