Repository navigation
Releases
v0.5.2
Linux builds
Self-contained Linux builds (musl, fully static: OpenSSL and bzip2 are linked in, nothing to install on the device).
| Archive | Runs on |
|---|---|
linux-x86_64-musl |
PCs, servers, virtual machines |
linux-aarch64-musl |
Raspberry Pi 3/4/5 and Zero 2 with a 64-bit OS, Jetson, Orange Pi and similar |
linux-armv7-musl |
Raspberry Pi 2/3/Zero 2 with a 32-bit OS and similar |
linux-armv6-musl |
Raspberry Pi Zero and 1 (also runs on the armv7 boards) |
Each archive holds bin/ (the node daemon and tools), include/ and lib/ (static libraries, OpenSSL and bzip2 for static linking, a CMake package), BUILDINFO and the documentation. To link the SDK from CMake: -DCMAKE_PREFIX_PATH=<unpacked directory> -DOPENSSL_USE_STATIC_LIBS=ON. The Linux library needs a POSIX host with OpenSSL; use these builds on the computer a radio is attached to.
Microcontroller firmware (example node, serial interface; Wi-Fi TCP on ESP32 once provisioned; optional LoRa radio, off until configured)
reticulum-c-<version>-mcu-<board>.zip holds the firmware images, flash.txt with the exact flashing commands for that board, BUILDINFO (version, commit, toolchain versions), the manual and a README. The firmware is a Reticulum leaf node with one HDLC serial interface (the Reticulum SerialInterface framing): a host running reticulum-c-node or rnsd with the board as a SerialInterface routes between the board and the network. It announces reticulum_c.mcu.example and answers /echo and /info. It uses the portable crypto backend and the small mcu capacity profile (no OpenSSL).
Wi-Fi (ESP32 and ESP32-S3 archives). Unprovisioned images start in serial mode and contain no Wi-Fi credentials; updates that preserve settings retain the selected mode. To join a network, provision the board after flashing: run tools/wifi-config.sh from the archive (writes the Wi-Fi settings as an NVS image with esptool, no console needed; --arduino for the PlatformIO archives, which replaces their NVS partition and so their identity), or send the line rnc-config on the serial port within 2 seconds after reset (or press BOOT) and use the set/save/reboot console. The board then connects as a TCP client to a node's TCPServerInterface (same HDLC framing). The TCP link is plaintext and unauthenticated at the transport level and the credentials are stored unencrypted in flash; MANUAL.md has the details. The nRF52 archives have no Wi-Fi.
LoRa radio (the eight PlatformIO board archives). Each of those images contains a driver for its board's radio (SX1262 on the Heltec V3, T3-S3, T-Beam Supreme, RAK4631, T114 and T-Echo; SX1276 on the Heltec V2 and the T-Beam v1.0/1.1) and a Reticulum LoRa interface whose over-the-air format is meant to be compatible with stock RNodes on the same frequency and modem settings (header byte with sequence nibble and split flag, packets above 254 bytes in two frames, private-network sync word, CRC on, explicit header). lora.mode leaf makes LoRa the node's only interface; lora.mode gateway adds it to the serial or Wi-Fi interface with Reticulum transport on. The radio is off, and never transmits, until you have set the mode and all of frequency, bandwidth, spreading factor, coding rate and transmit power (console set lora.freq 868.1 ... or tools/wifi-config.sh --lora-mode ...); no default settings are in any image. You are responsible for a legal frequency, power and duty cycle where you use the board; the power setting is the power at the chip's output. The airtime budget defaults to 1% of every hour. Hardware bench testing covers a T-Echo leaf and Supreme SX1262 gateway at 915 MHz, including routed /echo and /info. Other boards retain build/model coverage; range, sustained load and stock RNode interoperability are unverified. The ESP-IDF archives are generic images without a board selection and have no radio; select a LoRa board in idf.py menuconfig and build from source to get one. The Supreme SX1262 target initializes its AXP2101 radio rail. Supreme LR1121 variants and T-Beam v1.2 are not supported.
| Archive | Board | Build |
|---|---|---|
mcu-esp-idf-esp32 |
ESP32 boards: Heltec WiFi LoRa 32 V2, LilyGo T-Beam, TTGO LoRa32 and similar | ESP-IDF 5.4.4 |
mcu-esp-idf-esp32s3 |
ESP32-S3 boards: Heltec WiFi LoRa 32 V3, T-Beam Supreme, T3-S3, T-Deck and similar | ESP-IDF 5.4.4 |
mcu-heltec_wifi_lora_32_v3, mcu-heltec_wifi_lora_32_v2, mcu-ttgo_t_beam, mcu-lilygo_t3_s3, mcu-lilygo_t_beam_supreme |
the named ESP32 / ESP32-S3 boards | Arduino (PlatformIO) |
mcu-wiscore_rak4631, mcu-heltec_t114, mcu-lilygo_t_echo |
RAKwireless RAK4631, Heltec Mesh Node T114, LilyGo T-Echo (nRF52840; UF2 and DFU files) | Arduino (PlatformIO) |
Updating an existing node. ESP32 merged.bin overwrites identity NVS (and provisioned settings on PlatformIO); use the separate-parts command in flash.txt to preserve NVS with the same partition layout. nRF52840 UF2/DFU files update only the application and preserve the internal file system, bootloader and SoftDevice; an existing compatible Adafruit bootloader is required.
Browser installer. Install and configure over USB offers the eight exact PlatformIO boards, versioned downloads and this firmware's rnc-config console. Its main-commit builds can include changes newer than a tagged release archive. In desktop browsers with Web Serial, ESP32 updates verify SHA-256 downloads and MD5 flash contents using separate parts; a factory erase requires an explicit choice and confirmation. nRF52840 uses acknowledged application-only serial DFU, with UF2 downloads also available. The setup form preserves a saved Wi-Fi password when left blank; explicitly select an open network to remove it. This uses reticulum-c provisioning, not RNode EEPROM/KISS configuration.
esp-idf-component.tar.gz is the protocol core and the example application as ESP-IDF components (use it with EXTRA_COMPONENT_DIRS). platformio-library.tar.gz is the same as a PlatformIO library (library.json; lib_deps = file:///path). Both are source archives.
Limits. The boards talk to a host over serial or USB (or, on ESP32 once provisioned, over Wi-Fi and TCP), and over LoRa once configured (see above). In these node modes they have no Bluetooth; Bluetooth LE is available only in rnode mode. Hardware coverage is the short T-Echo/Supreme SX1262 bench exchange described above, including serial provisioning and routed LoRa requests; other boards have build/model coverage. Wi-Fi hardware behavior, range, sustained load and stock RNode interoperability remain unverified. The same application logic passes host tests against reticulum-c-node and the reference Reticulum. The nRF52 board definitions for the RAK4631, T114 and T-Echo are derived from the Adafruit nRF52840 Feather and assume the Adafruit bootloader; serial DFU has been exercised on the T-Echo. It is a leaf node (no forwarding) unless the LoRa gateway mode is configured. The rnode mode (a host-driven LoRa modem for Sideband or rnsd, over USB or, once a PIN is set, Bluetooth LE) has been run on a T-Echo: driven over USB by this project's host adapter, and over Bluetooth LE from a Linux PC and from Sideband on one Android phone, which connected while the T-Echo exchanged packets with a Supreme over the air. Sideband showing the announces the board receives, other phones, rnsd, the reference RNodeInterface in its own Bluetooth mode (over USB it configured the T-Echo and sent announces with its default timing; through a Bluetooth bridge only once its 0.25 second readback wait was lengthened), range, and the ESP32 Bluetooth transport (compiled only) remain unverified.
Check every download with sha256sum -c SHA256SUMS.
What's Changed
- Evict a route when the path table is full, and learn paths whether or not the announce can be relayed by @mondain in #86
- Record the reference RNodeInterface and Supreme gateway findings by @mondain in #87
- Release 0.5.2 by @mondain in #88
Full Changelog: v0.5.1...v0.5.2
v0.5.1
Linux builds
Self-contained Linux builds (musl, fully static: OpenSSL and bzip2 are linked in, nothing to install on the device).
| Archive | Runs on |
|---|---|
linux-x86_64-musl |
PCs, servers, virtual machines |
linux-aarch64-musl |
Raspberry Pi 3/4/5 and Zero 2 with a 64-bit OS, Jetson, Orange Pi and similar |
linux-armv7-musl |
Raspberry Pi 2/3/Zero 2 with a 32-bit OS and similar |
linux-armv6-musl |
Raspberry Pi Zero and 1 (also runs on the armv7 boards) |
Each archive holds bin/ (the node daemon and tools), include/ and lib/ (static libraries, OpenSSL and bzip2 for static linking, a CMake package), BUILDINFO and the documentation. To link the SDK from CMake: -DCMAKE_PREFIX_PATH=<unpacked directory> -DOPENSSL_USE_STATIC_LIBS=ON. The Linux library needs a POSIX host with OpenSSL; use these builds on the computer a radio is attached to.
Microcontroller firmware (example node, serial interface; Wi-Fi TCP on ESP32 once provisioned; optional LoRa radio, off until configured)
reticulum-c-<version>-mcu-<board>.zip holds the firmware images, flash.txt with the exact flashing commands for that board, BUILDINFO (version, commit, toolchain versions), the manual and a README. The firmware is a Reticulum leaf node with one HDLC serial interface (the Reticulum SerialInterface framing): a host running reticulum-c-node or rnsd with the board as a SerialInterface routes between the board and the network. It announces reticulum_c.mcu.example and answers /echo and /info. It uses the portable crypto backend and the small mcu capacity profile (no OpenSSL).
Wi-Fi (ESP32 and ESP32-S3 archives). Unprovisioned images start in serial mode and contain no Wi-Fi credentials; updates that preserve settings retain the selected mode. To join a network, provision the board after flashing: run tools/wifi-config.sh from the archive (writes the Wi-Fi settings as an NVS image with esptool, no console needed; --arduino for the PlatformIO archives, which replaces their NVS partition and so their identity), or send the line rnc-config on the serial port within 2 seconds after reset (or press BOOT) and use the set/save/reboot console. The board then connects as a TCP client to a node's TCPServerInterface (same HDLC framing). The TCP link is plaintext and unauthenticated at the transport level and the credentials are stored unencrypted in flash; MANUAL.md has the details. The nRF52 archives have no Wi-Fi.
LoRa radio (the eight PlatformIO board archives). Each of those images contains a driver for its board's radio (SX1262 on the Heltec V3, T3-S3, T-Beam Supreme, RAK4631, T114 and T-Echo; SX1276 on the Heltec V2 and the T-Beam v1.0/1.1) and a Reticulum LoRa interface whose over-the-air format is meant to be compatible with stock RNodes on the same frequency and modem settings (header byte with sequence nibble and split flag, packets above 254 bytes in two frames, private-network sync word, CRC on, explicit header). lora.mode leaf makes LoRa the node's only interface; lora.mode gateway adds it to the serial or Wi-Fi interface with Reticulum transport on. The radio is off, and never transmits, until you have set the mode and all of frequency, bandwidth, spreading factor, coding rate and transmit power (console set lora.freq 868.1 ... or tools/wifi-config.sh --lora-mode ...); no default settings are in any image. You are responsible for a legal frequency, power and duty cycle where you use the board; the power setting is the power at the chip's output. The airtime budget defaults to 1% of every hour. Hardware bench testing covers a T-Echo leaf and Supreme SX1262 gateway at 915 MHz, including routed /echo and /info. Other boards retain build/model coverage; range, sustained load and stock RNode interoperability are unverified. The ESP-IDF archives are generic images without a board selection and have no radio; select a LoRa board in idf.py menuconfig and build from source to get one. The Supreme SX1262 target initializes its AXP2101 radio rail. Supreme LR1121 variants and T-Beam v1.2 are not supported.
| Archive | Board | Build |
|---|---|---|
mcu-esp-idf-esp32 |
ESP32 boards: Heltec WiFi LoRa 32 V2, LilyGo T-Beam, TTGO LoRa32 and similar | ESP-IDF 5.4.4 |
mcu-esp-idf-esp32s3 |
ESP32-S3 boards: Heltec WiFi LoRa 32 V3, T-Beam Supreme, T3-S3, T-Deck and similar | ESP-IDF 5.4.4 |
mcu-heltec_wifi_lora_32_v3, mcu-heltec_wifi_lora_32_v2, mcu-ttgo_t_beam, mcu-lilygo_t3_s3, mcu-lilygo_t_beam_supreme |
the named ESP32 / ESP32-S3 boards | Arduino (PlatformIO) |
mcu-wiscore_rak4631, mcu-heltec_t114, mcu-lilygo_t_echo |
RAKwireless RAK4631, Heltec Mesh Node T114, LilyGo T-Echo (nRF52840; UF2 and DFU files) | Arduino (PlatformIO) |
Updating an existing node. ESP32 merged.bin overwrites identity NVS (and provisioned settings on PlatformIO); use the separate-parts command in flash.txt to preserve NVS with the same partition layout. nRF52840 UF2/DFU files update only the application and preserve the internal file system, bootloader and SoftDevice; an existing compatible Adafruit bootloader is required.
Browser installer. Install and configure over USB offers the eight exact PlatformIO boards, versioned downloads and this firmware's rnc-config console. Its main-commit builds can include changes newer than a tagged release archive. In desktop browsers with Web Serial, ESP32 updates verify SHA-256 downloads and MD5 flash contents using separate parts; a factory erase requires an explicit choice and confirmation. nRF52840 uses acknowledged application-only serial DFU, with UF2 downloads also available. The setup form preserves a saved Wi-Fi password when left blank; explicitly select an open network to remove it. This uses reticulum-c provisioning, not RNode EEPROM/KISS configuration.
esp-idf-component.tar.gz is the protocol core and the example application as ESP-IDF components (use it with EXTRA_COMPONENT_DIRS). platformio-library.tar.gz is the same as a PlatformIO library (library.json; lib_deps = file:///path). Both are source archives.
Limits. The boards talk to a host over serial or USB (or, on ESP32 once provisioned, over Wi-Fi and TCP), and over LoRa once configured (see above). In these node modes they have no Bluetooth; Bluetooth LE is available only in rnode mode. Hardware coverage is the short T-Echo/Supreme SX1262 bench exchange described above, including serial provisioning and routed LoRa requests; other boards have build/model coverage. Wi-Fi hardware behavior, range, sustained load and stock RNode interoperability remain unverified. The same application logic passes host tests against reticulum-c-node and the reference Reticulum. The nRF52 board definitions for the RAK4631, T114 and T-Echo are derived from the Adafruit nRF52840 Feather and assume the Adafruit bootloader; serial DFU has been exercised on the T-Echo. It is a leaf node (no forwarding) unless the LoRa gateway mode is configured. The rnode mode (a host-driven LoRa modem for Sideband or rnsd, over USB or, once a PIN is set, Bluetooth LE) has been run on a T-Echo: driven over USB by this project's host adapter, and over Bluetooth LE from a Linux PC and from Sideband on one Android phone, which connected while the T-Echo exchanged packets with a Supreme over the air. Sideband showing the announces the board receives, other phones, the unmodified reference RNodeInterface and rnsd, range, and the ESP32 Bluetooth transport (compiled only) remain unverified.
Check every download with sha256sum -c SHA256SUMS.
What's Changed
- Release publishes the browser installer itself by @mondain in #82
- Accept interface_enabled, correct rnode mode docs, run interop jobs on tags and on demand only by @mondain in #83
- Correct the Sideband over BLE claims and migrate the text docs to Markdown by @mondain in #84
- Release 0.5.1 by @mondain in #85
Full Changelog: v0.5.0...v0.5.1
v0.5.0
Linux builds
Self-contained Linux builds (musl, fully static: OpenSSL and bzip2 are linked in, nothing to install on the device).
| Archive | Runs on |
|---|---|
linux-x86_64-musl |
PCs, servers, virtual machines |
linux-aarch64-musl |
Raspberry Pi 3/4/5 and Zero 2 with a 64-bit OS, Jetson, Orange Pi and similar |
linux-armv7-musl |
Raspberry Pi 2/3/Zero 2 with a 32-bit OS and similar |
linux-armv6-musl |
Raspberry Pi Zero and 1 (also runs on the armv7 boards) |
Each archive holds bin/ (the node daemon and tools), include/ and lib/ (static libraries, OpenSSL and bzip2 for static linking, a CMake package), BUILDINFO and the documentation. To link the SDK from CMake: -DCMAKE_PREFIX_PATH=<unpacked directory> -DOPENSSL_USE_STATIC_LIBS=ON. The Linux library needs a POSIX host with OpenSSL; use these builds on the computer a radio is attached to.
Microcontroller firmware (example node, serial interface; Wi-Fi TCP on ESP32 once provisioned; optional LoRa radio, off until configured)
reticulum-c-<version>-mcu-<board>.zip holds the firmware images, flash.txt with the exact flashing commands for that board, BUILDINFO (version, commit, toolchain versions), the manual and a README. The firmware is a Reticulum leaf node with one HDLC serial interface (the Reticulum SerialInterface framing): a host running reticulum-c-node or rnsd with the board as a SerialInterface routes between the board and the network. It announces reticulum_c.mcu.example and answers /echo and /info. It uses the portable crypto backend and the small mcu capacity profile (no OpenSSL).
Wi-Fi (ESP32 and ESP32-S3 archives). Unprovisioned images start in serial mode and contain no Wi-Fi credentials; updates that preserve settings retain the selected mode. To join a network, provision the board after flashing: run tools/wifi-config.sh from the archive (writes the Wi-Fi settings as an NVS image with esptool, no console needed; --arduino for the PlatformIO archives, which replaces their NVS partition and so their identity), or send the line rnc-config on the serial port within 2 seconds after reset (or press BOOT) and use the set/save/reboot console. The board then connects as a TCP client to a node's TCPServerInterface (same HDLC framing). The TCP link is plaintext and unauthenticated at the transport level and the credentials are stored unencrypted in flash; MANUAL.txt has the details. The nRF52 archives have no Wi-Fi.
LoRa radio (the eight PlatformIO board archives). Each of those images contains a driver for its board's radio (SX1262 on the Heltec V3, T3-S3, T-Beam Supreme, RAK4631, T114 and T-Echo; SX1276 on the Heltec V2 and the T-Beam v1.0/1.1) and a Reticulum LoRa interface whose over-the-air format is meant to be compatible with stock RNodes on the same frequency and modem settings (header byte with sequence nibble and split flag, packets above 254 bytes in two frames, private-network sync word, CRC on, explicit header). lora.mode leaf makes LoRa the node's only interface; lora.mode gateway adds it to the serial or Wi-Fi interface with Reticulum transport on. The radio is off, and never transmits, until you have set the mode and all of frequency, bandwidth, spreading factor, coding rate and transmit power (console set lora.freq 868.1 ... or tools/wifi-config.sh --lora-mode ...); no default settings are in any image. You are responsible for a legal frequency, power and duty cycle where you use the board; the power setting is the power at the chip's output. The airtime budget defaults to 1% of every hour. Hardware bench testing covers a T-Echo leaf and Supreme SX1262 gateway at 915 MHz, including routed /echo and /info. Other boards retain build/model coverage; range, sustained load and stock RNode interoperability are unverified. The ESP-IDF archives are generic images without a board selection and have no radio; select a LoRa board in idf.py menuconfig and build from source to get one. The Supreme SX1262 target initializes its AXP2101 radio rail. Supreme LR1121 variants and T-Beam v1.2 are not supported.
| Archive | Board | Build |
|---|---|---|
mcu-esp-idf-esp32 |
ESP32 boards: Heltec WiFi LoRa 32 V2, LilyGo T-Beam, TTGO LoRa32 and similar | ESP-IDF 5.4.4 |
mcu-esp-idf-esp32s3 |
ESP32-S3 boards: Heltec WiFi LoRa 32 V3, T-Beam Supreme, T3-S3, T-Deck and similar | ESP-IDF 5.4.4 |
mcu-heltec_wifi_lora_32_v3, mcu-heltec_wifi_lora_32_v2, mcu-ttgo_t_beam, mcu-lilygo_t3_s3, mcu-lilygo_t_beam_supreme |
the named ESP32 / ESP32-S3 boards | Arduino (PlatformIO) |
mcu-wiscore_rak4631, mcu-heltec_t114, mcu-lilygo_t_echo |
RAKwireless RAK4631, Heltec Mesh Node T114, LilyGo T-Echo (nRF52840; UF2 and DFU files) | Arduino (PlatformIO) |
Updating an existing node. ESP32 merged.bin overwrites identity NVS (and provisioned settings on PlatformIO); use the separate-parts command in flash.txt to preserve NVS with the same partition layout. nRF52840 UF2/DFU files update only the application and preserve the internal file system, bootloader and SoftDevice; an existing compatible Adafruit bootloader is required.
Browser installer. Install and configure over USB offers the eight exact PlatformIO boards, versioned downloads and this firmware's rnc-config console. Its main-commit builds can include changes newer than a tagged release archive. In desktop browsers with Web Serial, ESP32 updates verify SHA-256 downloads and MD5 flash contents using separate parts; a factory erase requires an explicit choice and confirmation. nRF52840 uses acknowledged application-only serial DFU, with UF2 downloads also available. The setup form preserves a saved Wi-Fi password when left blank; explicitly select an open network to remove it. This uses reticulum-c provisioning, not RNode EEPROM/KISS configuration.
esp-idf-component.tar.gz is the protocol core and the example application as ESP-IDF components (use it with EXTRA_COMPONENT_DIRS). platformio-library.tar.gz is the same as a PlatformIO library (library.json; lib_deps = file:///path). Both are source archives.
Limits. The boards talk to a host over serial or USB (or, on ESP32 once provisioned, over Wi-Fi and TCP), and over LoRa once configured (see above); they have no Bluetooth. Hardware coverage is the short T-Echo/Supreme SX1262 bench exchange described above, including serial provisioning and routed LoRa requests; other boards have build/model coverage. Wi-Fi hardware behavior, range, sustained load and stock RNode interoperability remain unverified. The same application logic passes host tests against reticulum-c-node and the reference Reticulum. The nRF52 board definitions for the RAK4631, T114 and T-Echo are derived from the Adafruit nRF52840 Feather and assume the Adafruit bootloader; serial DFU has been exercised on the T-Echo. It is a leaf node (no forwarding) unless the LoRa gateway mode is configured. The new rnode mode (a host-driven LoRa modem for Sideband or rnsd, USB only) has no hardware evidence yet.
Check every download with sha256sum -c SHA256SUMS.
What's Changed
- reticulum-c-flash: nRF52 serial DFU for the T-Echo and other Adafruit-bootloader boards by @mondain in #66
- ctl id: signed-message metadata (-E, --meta-spec, --meta) by @mondain in #67
- docs: the T-Echo screen showed 0.4.0 after the serial DFU by @mondain in #68
- tests: a watchdog for the I2P process test that names the stuck step by @mondain in #69
- Share the instance over abstract Unix sockets, with instance_name and the reference's config layout by @mondain in #70
- Check the transport rules against a live reference node; fix mode = internal by @mondain in #71
- rnpath path requests, rnstatus -l/-m/-d/-D and every sort key by @mondain in #72
- Echo example and a packet send/resend call by @mondain in #73
- Per-link physical layer statistics by @mondain in #74
- rnsd command line options by @mondain in #75
- rnid: text forms of signatures, including base256 by @mondain in #76
- rnid -a: announce through the shared instance by @mondain in #77
- Stream files through resources, transfers and rncp: no whole file in memory by @mondain in #78
- Backpressure on TCP peers: ingress and egress control by @mondain in #79
- Release 0.5.0 by @mondain in #80
- Fix streaming transfers on 32-bit targets by @mondain in #81
Full Changelog: v0.4.0...v0.5.0
v0.4.0
Linux builds
Self-contained Linux builds (musl, fully static: OpenSSL and bzip2 are linked in, nothing to install on the device).
| Archive | Runs on |
|---|---|
linux-x86_64-musl |
PCs, servers, virtual machines |
linux-aarch64-musl |
Raspberry Pi 3/4/5 and Zero 2 with a 64-bit OS, Jetson, Orange Pi and similar |
linux-armv7-musl |
Raspberry Pi 2/3/Zero 2 with a 32-bit OS and similar |
linux-armv6-musl |
Raspberry Pi Zero and 1 (also runs on the armv7 boards) |
Each archive holds bin/ (the node daemon and tools), include/ and lib/ (static libraries, OpenSSL and bzip2 for static linking, a CMake package), BUILDINFO and the documentation. To link the SDK from CMake: -DCMAKE_PREFIX_PATH=<unpacked directory> -DOPENSSL_USE_STATIC_LIBS=ON. The Linux library needs a POSIX host with OpenSSL; use these builds on the computer a radio is attached to.
Microcontroller firmware (example node, serial interface; Wi-Fi TCP on ESP32 once provisioned; optional LoRa radio, off until configured)
reticulum-c-<version>-mcu-<board>.zip holds the firmware images, flash.txt with the exact flashing commands for that board, BUILDINFO (version, commit, toolchain versions), the manual and a README. The firmware is a Reticulum leaf node with one HDLC serial interface (the Reticulum SerialInterface framing): a host running reticulum-c-node or rnsd with the board as a SerialInterface routes between the board and the network. It announces reticulum_c.mcu.example and answers /echo and /info. It uses the portable crypto backend and the small mcu capacity profile (no OpenSSL).
Wi-Fi (ESP32 and ESP32-S3 archives). Unprovisioned images start in serial mode and contain no Wi-Fi credentials; updates that preserve settings retain the selected mode. To join a network, provision the board after flashing: run tools/wifi-config.sh from the archive (writes the Wi-Fi settings as an NVS image with esptool, no console needed; --arduino for the PlatformIO archives, which replaces their NVS partition and so their identity), or send the line rnc-config on the serial port within 2 seconds after reset (or press BOOT) and use the set/save/reboot console. The board then connects as a TCP client to a node's TCPServerInterface (same HDLC framing). The TCP link is plaintext and unauthenticated at the transport level and the credentials are stored unencrypted in flash; MANUAL.txt has the details. The nRF52 archives have no Wi-Fi.
LoRa radio (the eight PlatformIO board archives). Each of those images contains a driver for its board's radio (SX1262 on the Heltec V3, T3-S3, T-Beam Supreme, RAK4631, T114 and T-Echo; SX1276 on the Heltec V2 and the T-Beam v1.0/1.1) and a Reticulum LoRa interface whose over-the-air format is meant to be compatible with stock RNodes on the same frequency and modem settings (header byte with sequence nibble and split flag, packets above 254 bytes in two frames, private-network sync word, CRC on, explicit header). lora.mode leaf makes LoRa the node's only interface; lora.mode gateway adds it to the serial or Wi-Fi interface with Reticulum transport on. The radio is off, and never transmits, until you have set the mode and all of frequency, bandwidth, spreading factor, coding rate and transmit power (console set lora.freq 868.1 ... or tools/wifi-config.sh --lora-mode ...); no default settings are in any image. You are responsible for a legal frequency, power and duty cycle where you use the board; the power setting is the power at the chip's output. The airtime budget defaults to 1% of every hour. Hardware bench testing covers a T-Echo leaf and Supreme SX1262 gateway at 915 MHz, including routed /echo and /info. Other boards retain build/model coverage; range, sustained load and stock RNode interoperability are unverified. The ESP-IDF archives are generic images without a board selection and have no radio; select a LoRa board in idf.py menuconfig and build from source to get one. The Supreme SX1262 target initializes its AXP2101 radio rail. Supreme LR1121 variants and T-Beam v1.2 are not supported.
| Archive | Board | Build |
|---|---|---|
mcu-esp-idf-esp32 |
ESP32 boards: Heltec WiFi LoRa 32 V2, LilyGo T-Beam, TTGO LoRa32 and similar | ESP-IDF 5.4.4 |
mcu-esp-idf-esp32s3 |
ESP32-S3 boards: Heltec WiFi LoRa 32 V3, T-Beam Supreme, T3-S3, T-Deck and similar | ESP-IDF 5.4.4 |
mcu-heltec_wifi_lora_32_v3, mcu-heltec_wifi_lora_32_v2, mcu-ttgo_t_beam, mcu-lilygo_t3_s3, mcu-lilygo_t_beam_supreme |
the named ESP32 / ESP32-S3 boards | Arduino (PlatformIO) |
mcu-wiscore_rak4631, mcu-heltec_t114, mcu-lilygo_t_echo |
RAKwireless RAK4631, Heltec Mesh Node T114, LilyGo T-Echo (nRF52840; UF2 and DFU files) | Arduino (PlatformIO) |
Updating an existing node. ESP32 merged.bin overwrites identity NVS (and provisioned settings on PlatformIO); use the separate-parts command in flash.txt to preserve NVS with the same partition layout. nRF52840 UF2/DFU files update only the application and preserve the internal file system, bootloader and SoftDevice; an existing compatible Adafruit bootloader is required.
Browser installer. Install and configure over USB offers the eight exact PlatformIO boards, versioned downloads and this firmware's rnc-config console. Its main-commit builds can include changes newer than a tagged release archive. In desktop browsers with Web Serial, ESP32 updates verify SHA-256 downloads and MD5 flash contents using separate parts; a factory erase requires an explicit choice and confirmation. nRF52840 uses acknowledged application-only serial DFU, with UF2 downloads also available. The setup form preserves a saved Wi-Fi password when left blank; explicitly select an open network to remove it. This uses reticulum-c provisioning, not RNode EEPROM/KISS configuration.
esp-idf-component.tar.gz is the protocol core and the example application as ESP-IDF components (use it with EXTRA_COMPONENT_DIRS). platformio-library.tar.gz is the same as a PlatformIO library (library.json; lib_deps = file:///path). Both are source archives.
Limits. The boards talk to a host over serial or USB (or, on ESP32 once provisioned, over Wi-Fi and TCP), and over LoRa once configured (see above); they have no Bluetooth. Hardware coverage is the short T-Echo/Supreme SX1262 bench exchange described above, including serial provisioning and routed LoRa requests; other boards have build/model coverage. Wi-Fi hardware behavior, range, sustained load and stock RNode interoperability remain unverified. The same application logic passes host tests against reticulum-c-node and the reference Reticulum. The nRF52 board definitions for the RAK4631, T114 and T-Echo are derived from the Adafruit nRF52840 Feather and assume the Adafruit bootloader; serial DFU has been exercised on the T-Echo. It is a leaf node (no forwarding) unless the LoRa gateway mode is configured. The new rnode mode (a host-driven LoRa modem for Sideband or rnsd, USB only) has no hardware evidence yet.
Check every download with sha256sum -c SHA256SUMS.
What's Changed
- node: hop limit, MODE_INTERNAL, path-response grace, rate_table RPC by @mondain in #49
- ci: run the macOS job on macos-15 by @mondain in #51
- Discovery options: gravity, autoconnect options, I2P/Weave announcements by @mondain in #50
- Host interface options: Auto devices and scope, device binding, i2p_tunneled by @mondain in #52
- CLI tools: path drops and rates, status sort and filter, rnid formats and import by @mondain in #53
- rncp and rnx: -p, allowed-identities files, -S, -C, -W by @mondain in #54
- node: neighbour rebroadcasts cancel a pending path response by @mondain in #55
- examples: stand-alone announce and request/response by @mondain in #56
- ctl: remote status and path queries; remote rates by @mondain in #57
- rnx: interactive mode (-x) by @mondain in #58
- ctl id: signed-envelope signatures (.rsg) by @mondain in #59
- rnsh: -p, allowed-identities files, -T by @mondain in #60
- ctl id: signed messages (-S, .rsm) by @mondain in #62
- rncp: -P physical-layer rates by @mondain in #63
- reticulum-c-flash: ESP32 firmware flashing through the ROM loader by @mondain in #61
- release: version 0.4.0 by @mondain in #64
- flash: fix the maybe-uninitialized status buffer that broke the v0.4.0 Linux build by @mondain in #65
Full Changelog: v0.3.0...v0.4.0
v0.3.0
Linux builds
Self-contained Linux builds (musl, fully static: OpenSSL and bzip2 are linked in, nothing to install on the device).
| Archive | Runs on |
|---|---|
linux-x86_64-musl |
PCs, servers, virtual machines |
linux-aarch64-musl |
Raspberry Pi 3/4/5 and Zero 2 with a 64-bit OS, Jetson, Orange Pi and similar |
linux-armv7-musl |
Raspberry Pi 2/3/Zero 2 with a 32-bit OS and similar |
linux-armv6-musl |
Raspberry Pi Zero and 1 (also runs on the armv7 boards) |
Each archive holds bin/ (the node daemon and tools), include/ and lib/ (static libraries, OpenSSL and bzip2 for static linking, a CMake package), BUILDINFO and the documentation. To link the SDK from CMake: -DCMAKE_PREFIX_PATH=<unpacked directory> -DOPENSSL_USE_STATIC_LIBS=ON. The Linux library needs a POSIX host with OpenSSL; use these builds on the computer a radio is attached to.
Microcontroller firmware (example node, serial interface; Wi-Fi TCP on ESP32 once provisioned; optional LoRa radio, off until configured)
reticulum-c-<version>-mcu-<board>.zip holds the firmware images, flash.txt with the exact flashing commands for that board, BUILDINFO (version, commit, toolchain versions), the manual and a README. The firmware is a Reticulum leaf node with one HDLC serial interface (the Reticulum SerialInterface framing): a host running reticulum-c-node or rnsd with the board as a SerialInterface routes between the board and the network. It announces reticulum_c.mcu.example and answers /echo and /info. It uses the portable crypto backend and the small mcu capacity profile (no OpenSSL).
Wi-Fi (ESP32 and ESP32-S3 archives). Unprovisioned images start in serial mode and contain no Wi-Fi credentials; updates that preserve settings retain the selected mode. To join a network, provision the board after flashing: run tools/wifi-config.sh from the archive (writes the Wi-Fi settings as an NVS image with esptool, no console needed; --arduino for the PlatformIO archives, which replaces their NVS partition and so their identity), or send the line rnc-config on the serial port within 2 seconds after reset (or press BOOT) and use the set/save/reboot console. The board then connects as a TCP client to a node's TCPServerInterface (same HDLC framing). The TCP link is plaintext and unauthenticated at the transport level and the credentials are stored unencrypted in flash; MANUAL.txt has the details. The nRF52 archives have no Wi-Fi.
LoRa radio (the eight PlatformIO board archives). Each of those images contains a driver for its board's radio (SX1262 on the Heltec V3, T3-S3, T-Beam Supreme, RAK4631, T114 and T-Echo; SX1276 on the Heltec V2 and the T-Beam v1.0/1.1) and a Reticulum LoRa interface whose over-the-air format is meant to be compatible with stock RNodes on the same frequency and modem settings (header byte with sequence nibble and split flag, packets above 254 bytes in two frames, private-network sync word, CRC on, explicit header). lora.mode leaf makes LoRa the node's only interface; lora.mode gateway adds it to the serial or Wi-Fi interface with Reticulum transport on. The radio is off, and never transmits, until you have set the mode and all of frequency, bandwidth, spreading factor, coding rate and transmit power (console set lora.freq 868.1 ... or tools/wifi-config.sh --lora-mode ...); no default settings are in any image. You are responsible for a legal frequency, power and duty cycle where you use the board; the power setting is the power at the chip's output. The airtime budget defaults to 1% of every hour. Hardware bench testing covers a T-Echo leaf and Supreme SX1262 gateway at 915 MHz, including routed /echo and /info. Other boards retain build/model coverage; range, sustained load and stock RNode interoperability are unverified. The ESP-IDF archives are generic images without a board selection and have no radio; select a LoRa board in idf.py menuconfig and build from source to get one. The Supreme SX1262 target initializes its AXP2101 radio rail. Supreme LR1121 variants and T-Beam v1.2 are not supported.
| Archive | Board | Build |
|---|---|---|
mcu-esp-idf-esp32 |
ESP32 boards: Heltec WiFi LoRa 32 V2, LilyGo T-Beam, TTGO LoRa32 and similar | ESP-IDF 5.4.4 |
mcu-esp-idf-esp32s3 |
ESP32-S3 boards: Heltec WiFi LoRa 32 V3, T-Beam Supreme, T3-S3, T-Deck and similar | ESP-IDF 5.4.4 |
mcu-heltec_wifi_lora_32_v3, mcu-heltec_wifi_lora_32_v2, mcu-ttgo_t_beam, mcu-lilygo_t3_s3, mcu-lilygo_t_beam_supreme |
the named ESP32 / ESP32-S3 boards | Arduino (PlatformIO) |
mcu-wiscore_rak4631, mcu-heltec_t114, mcu-lilygo_t_echo |
RAKwireless RAK4631, Heltec Mesh Node T114, LilyGo T-Echo (nRF52840; UF2 and DFU files) | Arduino (PlatformIO) |
Updating an existing node. ESP32 merged.bin overwrites identity NVS (and provisioned settings on PlatformIO); use the separate-parts command in flash.txt to preserve NVS with the same partition layout. nRF52840 UF2/DFU files update only the application and preserve the internal file system, bootloader and SoftDevice; an existing compatible Adafruit bootloader is required.
Browser installer. Install and configure over USB offers the eight exact PlatformIO boards, versioned downloads and this firmware's rnc-config console. Its main-commit builds can include changes newer than a tagged release archive. In desktop browsers with Web Serial, ESP32 updates verify SHA-256 downloads and MD5 flash contents using separate parts; a factory erase requires an explicit choice and confirmation. nRF52840 uses acknowledged application-only serial DFU, with UF2 downloads also available. The setup form preserves a saved Wi-Fi password when left blank; explicitly select an open network to remove it. This uses reticulum-c provisioning, not RNode EEPROM/KISS configuration.
esp-idf-component.tar.gz is the protocol core and the example application as ESP-IDF components (use it with EXTRA_COMPONENT_DIRS). platformio-library.tar.gz is the same as a PlatformIO library (library.json; lib_deps = file:///path). Both are source archives.
Limits. The boards talk to a host over serial or USB (or, on ESP32 once provisioned, over Wi-Fi and TCP), and over LoRa once configured (see above); they have no Bluetooth. Hardware coverage is the short T-Echo/Supreme SX1262 bench exchange described above, including serial provisioning and routed LoRa requests; other boards have build/model coverage. Wi-Fi hardware behavior, range, sustained load and stock RNode interoperability remain unverified. The same application logic passes host tests against reticulum-c-node and the reference Reticulum. The nRF52 board definitions for the RAK4631, T114 and T-Echo are derived from the Adafruit nRF52840 Feather and assume the Adafruit bootloader; serial DFU has been exercised on the T-Echo. It is a leaf node (no forwarding) unless the LoRa gateway mode is configured. The new rnode mode (a host-driven LoRa modem for Sideband or rnsd, USB only) has no hardware evidence yet.
Check every download with sha256sum -c SHA256SUMS.
What's Changed
- RNode mode: a host-driven LoRa modem, over USB and Bluetooth LE by @mondain in #43
- Status screens on the T-Echo and the T-Beam Supreme by @mondain in #44
- Docs: Sideband connected to the T-Echo over BLE by @mondain in #45
- Release: bump version to 0.3.0 by @mondain in #46
- Release: fix the Alpine build for v0.3.0 by @mondain in #47
- Release: strip the v from the version the consumer check asks for by @mondain in #48
Full Changelog: v0.2.1...v0.3.0