A Reticulum node on a board in your pocket.

Reticulum mesh networking for ESP32

Reticulous implements the Reticulum mesh networking stack for ESP32 embedded systems and boards. It does LXMF messaging and Nomad Network browsing, and adds things embedded Reticulum nodes usually lack, such as remote shell access with rnsh.

Reticulous is built on Spangap, a new framework for ESP32 firmware that was developed alongside it. Spangap provides the multitasking, the web interface, the command line, SSH and the phone-style apps on the LCD, so Reticulous only has to be about Reticulum.

The web interface a board serves: settings, LXMF messaging, the command line, the Nomad Network browser and the live log, all of it out of the ESP32 in your hand. Click to enlarge.

Supported hardware

Reticulous runs on a growing list of boards: the LilyGO T-Deck Plus, the Heltec V4 (both the 2 MB and 8 MB PSRAM versions), the Meshnology W12, the RAK WisMesh TAP V2, the LilyGo T-Beam S3 Supreme, the Waveshare ESP32-S3-Touch-LCD-2.8B, the Retia Nibble Zero, the Seeed XIAO ESP32S3 with Wio-SX1262, and the LilyGo T3-S3. They are listed with their radios and peripherals in the overview.

On any other ESP32-S3 with PSRAM, the generic build has no LoRa radio but still does Reticulum over WiFi, with the web interface, the serial console and SSH. 4 MB of PSRAM and 8 MB of flash or more is ideal. Support for more boards is coming.

Where to start

The fastest way to see what this is: put a ready-made image on a board from your browser. Once you’ve seen it, building it yourself is the more interesting path.