Communications Hardware¶
One of the truly valuable aspects of Reticulum is the ability to use it over almost any conceivable kind of communications medium. The interface types available for configuration in Reticulum are flexible enough to cover the use of most wired and wireless communications hardware available, from decades-old packet radio modems to modern millimeter-wave backhaul systems.
If you already have or operate some kind of communications hardware, there is a very good chance that it will work with Reticulum out of the box. In case it does not, it is possible to provide the necessary glue with very little effort using for example the PipeInterface or the TCPClientInterface in combination with code like TCP KISS Server by simplyequipped.
While this broad support and flexibility is very useful, an abundance of options can sometimes make it difficult to know where to begin, especially when you are starting from scratch.
This chapter will outline a few different sensible easy starting paths to get real-world functional wireless communications up and running with minimal cost and effort. Two fundamental devices types will be covered, RNodes and WiFi-based radios.
RNode¶
Reliable and general-purpose long-range digital radio transceiver systems are commonly either very expensive, difficult to set up and operate, hard to source, power-hungry, or all of the above at the same time. In an attempt to alleviate this situation, the transceiver system RNode was designed. It is important to note that RNode is not one specific device, from one particular vendor, but an open plaform that anyone can use to build digital transceivers suited to their needs and particular situations.
An RNode is a general purpose, interoperable, low-power and long-range, reliable, open and flexible radio communications device. Depending on its components, it can operate on many different frequency bands, and use many different modulation schemes, but most commonly, and for the purposes of this chapter, we will limit the discussion to RNodes using LoRa modulation in common ISM bands.
Avoid Confusion! An RNode can use LoRa as a physical-layer modulation, but it does not use, and has nothing to do with the LoRaWAN protocol and standard, commonly used for IoT devices. RNodes use raw LoRa modulation, without any additional protocol overhead. All high-level protocol funcionality is handled directly by Reticulum.
Creating RNodes¶
RNode has been designed as a system that is easy to replicate across time and space. You can put together a functioning transceiver using commonly available components, and a few software tools. While you can design and build RNodes completely from scratch, to your exact desired specifications, this chapter will explain the easiest possible approach to creating RNodes, which is using common LoRa development boards. This approach can be boiled down to two simple steps:
Obtain one or more supported development boards
Install the RNode firmware with the automated installer
Once the firmware has been installed and provisioned by the install script, it is ready to use with any software that supports RNodes, including Reticulum. The device can be used with Reticulum by adding an RNodeInterface to the configuration.
Supported Boards¶
To create one or more RNodes, you will need to obtain supported development boards. The following boards are supported by the auto-installer.
LilyGO LoRa32 v2.1¶
Supported Firmware Lines v1.x & v2.x
Transceiver IC Semtech SX1276
Device Platform ESP32
Manufacturer LilyGO
LilyGO LoRa32 v2.0¶
Supported Firmware Lines v1.x & v2.x
Transceiver IC Semtech SX1276
Device Platform ESP32
Manufacturer LilyGO
LilyGO T-Beam¶
Supported Firmware Lines v1.x & v2.x
Transceiver IC Semtech SX1276
Device Platform ESP32
Manufacturer LilyGO
Heltec LoRa32 v2.0¶
Supported Firmware Lines v1.x & v2.x
Transceiver IC Semtech SX1276
Device Platform ESP32
Manufacturer Heltec Automation
Unsigned RNode v2.x¶
Supported Firmware Lines v1.x & v2.x
Transceiver IC Semtech SX1276
Device Platform ESP32
Manufacturer unsigned.io
Unsigned RNode v1.x¶
Supported Firmware Lines v1.x
Transceiver IC Semtech SX1276
Device Platform AVR ATmega1284p
Manufacturer unsigned.io
Installation¶
Once you have obtained compatible boards, you can install the RNode Firmware
using the RNode Configuration Utility.
Make sure that Python3 and pip is installed on your system, and then install
the config utility with pip:
pip3 install rnodeconf
Once installation has completed, it is time to start installing the firmware on your
devices. Run rnodeconf in auto-install mode like so:
rnodeconf --autoinstall
The utility will guide you through the installation process by asking a series of questions about your hardware. Simply follow the guide, and the utility will auto-install and configure your devices
Important Note! It is currently recommended to use the v1.x line of the RNode firmware, even though the v2.x line is available for early testing. The v2.x line should still be considered an experimental pre-release. Only use the v2.x firmware line if you want to test out the absolutely newest version, and don’t care about stability.
Usage with Reticulum¶
When the devices have been installed and provisioned, you can use them with Reticulum by adding the relevant interface section to the configuration file of Reticulum. For v1.x firmwares, you will have to specify all interface parameters, such as serial port and on-air parameters. For v2.x firmwares, you just need to specify the Connection ID of the RNode, and Reticulum will automatically locate and connect to the RNode, using the parameters stored in the RNode itself.
Suppliers¶
Get in touch if you want to have your RNode supplier listed here, or if you want help to get started with producing RNodes.
WiFi-based Hardware¶
It is possible to use all kinds of both short- and long-range Wifi-based hardware with Reticulum. Any kind of hardware that fully supports bridged ethernet over the WiFi interface will work with the AutoInterface in Reticulum. Most devices will behave like this by default, or allow it via configuration options.
This means that you can simply configure the physical links of the WiFi based devices, and start communicating over them using Reticulum. It is not necessary to enable any IP infrastructure such as DHCP servers, DNS or similar, as long as at least Ethernet is available, and packets are passed transparently over the physical WiFi-based devices.
Below is a list of example WiFi (and similar) radios that work well for high capacity Reticulum links over long distances:
This list is by no means exhaustive, and only serves as a few examples of radio hardware that is relatively cheap while providing long range and high capacity for Reticulum networks. As in all other cases, it is also possible for Reticulum to co-exist with IP networks running concurrently on such devices.
Combining Hardware Types¶
It is a useful tool to combine different link and hardware types when designing and building a network. One useful design pattern is to employ high-capacity point-to-point links based on WiFi or millimeter-wave radios (with high-gain directional antennas) for the network backbone, and using LoRa-based RNodes for covering large areas with connectivity for client devices.