mirror of
https://github.com/markqvist/reticulum_website.git
synced 2025-11-26 01:16:39 -05:00
669 lines
No EOL
39 KiB
HTML
669 lines
No EOL
39 KiB
HTML
<!doctype html>
|
|
<html class="no-js" lang="en" data-content_root="./">
|
|
<head><meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
<link rel="index" title="Index" href="genindex.html"><link rel="search" title="Search" href="search.html"><link rel="next" title="Configuring Interfaces" href="interfaces.html"><link rel="prev" title="Understanding Reticulum" href="understanding.html">
|
|
<link rel="prefetch" href="_static/rns_logo_512.png" as="image">
|
|
|
|
<!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25.dev1 -->
|
|
<title>Communications Hardware - Reticulum Network Stack 1.0.1 documentation</title>
|
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
|
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
|
|
<link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" />
|
|
<link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
|
|
<link rel="stylesheet" type="text/css" href="_static/custom.css?v=bb3cebc5" />
|
|
|
|
|
|
|
|
|
|
<style>
|
|
body {
|
|
--color-code-background: #f2f2f2;
|
|
--color-code-foreground: #1e1e1e;
|
|
|
|
}
|
|
@media not print {
|
|
body[data-theme="dark"] {
|
|
--color-code-background: #202020;
|
|
--color-code-foreground: #d0d0d0;
|
|
--color-background-primary: #202b38;
|
|
--color-background-secondary: #161f27;
|
|
--color-foreground-primary: #dbdbdb;
|
|
--color-foreground-secondary: #a9b1ba;
|
|
--color-brand-primary: #41adff;
|
|
--color-background-hover: #161f27;
|
|
--color-api-name: #ffbe85;
|
|
--color-api-pre-name: #efae75;
|
|
|
|
}
|
|
@media (prefers-color-scheme: dark) {
|
|
body:not([data-theme="light"]) {
|
|
--color-code-background: #202020;
|
|
--color-code-foreground: #d0d0d0;
|
|
--color-background-primary: #202b38;
|
|
--color-background-secondary: #161f27;
|
|
--color-foreground-primary: #dbdbdb;
|
|
--color-foreground-secondary: #a9b1ba;
|
|
--color-brand-primary: #41adff;
|
|
--color-background-hover: #161f27;
|
|
--color-api-name: #ffbe85;
|
|
--color-api-pre-name: #efae75;
|
|
|
|
}
|
|
}
|
|
}
|
|
</style></head>
|
|
<body>
|
|
|
|
<script>
|
|
document.body.dataset.theme = localStorage.getItem("theme") || "auto";
|
|
</script>
|
|
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
|
|
<symbol id="svg-toc" viewBox="0 0 24 24">
|
|
<title>Contents</title>
|
|
<svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 1024 1024">
|
|
<path d="M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z"/>
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-menu" viewBox="0 0 24 24">
|
|
<title>Menu</title>
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
|
|
<line x1="3" y1="12" x2="21" y2="12"></line>
|
|
<line x1="3" y1="6" x2="21" y2="6"></line>
|
|
<line x1="3" y1="18" x2="21" y2="18"></line>
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-arrow-right" viewBox="0 0 24 24">
|
|
<title>Expand</title>
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
|
|
<polyline points="9 18 15 12 9 6"></polyline>
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-sun" viewBox="0 0 24 24">
|
|
<title>Light mode</title>
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
|
|
<circle cx="12" cy="12" r="5"></circle>
|
|
<line x1="12" y1="1" x2="12" y2="3"></line>
|
|
<line x1="12" y1="21" x2="12" y2="23"></line>
|
|
<line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
|
|
<line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
|
|
<line x1="1" y1="12" x2="3" y2="12"></line>
|
|
<line x1="21" y1="12" x2="23" y2="12"></line>
|
|
<line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
|
|
<line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-moon" viewBox="0 0 24 24">
|
|
<title>Dark mode</title>
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
|
|
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
<path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
|
|
<title>Auto light/dark, in light mode</title>
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
|
|
class="icon-custom-derived-from-feather-sun-and-tabler-moon">
|
|
<path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
|
|
<line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
|
|
<line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
|
|
<line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
|
|
<line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
|
|
<line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
|
|
<line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
|
|
<line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
|
|
<line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
|
|
<circle cx="14.5" cy="9.55" r="3.6"/>
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
|
|
<title>Auto light/dark, in dark mode</title>
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
|
|
class="icon-custom-derived-from-feather-sun-and-tabler-moon">
|
|
<path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
|
|
<line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
|
|
<line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
|
|
<line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
|
|
<line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
|
|
<line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
|
|
<line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
|
|
<line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
|
|
<line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
|
|
<circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-pencil" viewBox="0 0 24 24">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-pencil-code">
|
|
<path d="M4 20h4l10.5 -10.5a2.828 2.828 0 1 0 -4 -4l-10.5 10.5v4" />
|
|
<path d="M13.5 6.5l4 4" />
|
|
<path d="M20 21l2 -2l-2 -2" />
|
|
<path d="M17 17l-2 2l2 2" />
|
|
</svg>
|
|
</symbol>
|
|
<symbol id="svg-eye" viewBox="0 0 24 24">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
|
|
stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-eye-code">
|
|
<path stroke="none" d="M0 0h24v24H0z" fill="none" />
|
|
<path d="M10 12a2 2 0 1 0 4 0a2 2 0 0 0 -4 0" />
|
|
<path
|
|
d="M11.11 17.958c-3.209 -.307 -5.91 -2.293 -8.11 -5.958c2.4 -4 5.4 -6 9 -6c3.6 0 6.6 2 9 6c-.21 .352 -.427 .688 -.647 1.008" />
|
|
<path d="M20 21l2 -2l-2 -2" />
|
|
<path d="M17 17l-2 2l2 2" />
|
|
</svg>
|
|
</symbol>
|
|
</svg>
|
|
|
|
<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation" aria-label="Toggle site navigation sidebar">
|
|
<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc" aria-label="Toggle table of contents sidebar">
|
|
<label class="overlay sidebar-overlay" for="__navigation"></label>
|
|
<label class="overlay toc-overlay" for="__toc"></label>
|
|
|
|
<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
|
|
|
|
|
|
|
|
<div class="page">
|
|
<header class="mobile-header">
|
|
<div class="header-left">
|
|
<label class="nav-overlay-icon" for="__navigation">
|
|
<span class="icon"><svg><use href="#svg-menu"></use></svg></span>
|
|
</label>
|
|
</div>
|
|
<div class="header-center">
|
|
<a href="index.html"><div class="brand">Reticulum Network Stack 1.0.1 documentation</div></a>
|
|
</div>
|
|
<div class="header-right">
|
|
<div class="theme-toggle-container theme-toggle-header">
|
|
<button class="theme-toggle" aria-label="Toggle Light / Dark / Auto color theme">
|
|
<svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
|
|
<svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
|
|
<svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
|
|
<svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
|
|
</button>
|
|
</div>
|
|
<label class="toc-overlay-icon toc-header-icon" for="__toc">
|
|
<span class="icon"><svg><use href="#svg-toc"></use></svg></span>
|
|
</label>
|
|
</div>
|
|
</header>
|
|
<aside class="sidebar-drawer">
|
|
<div class="sidebar-container">
|
|
|
|
<div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
|
|
<div class="sidebar-logo-container">
|
|
<img class="sidebar-logo" src="_static/rns_logo_512.png" alt="Logo"/>
|
|
</div>
|
|
|
|
<span class="sidebar-brand-text">Reticulum Network Stack 1.0.1 documentation</span>
|
|
|
|
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
|
|
<input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
|
|
<input type="hidden" name="check_keywords" value="yes">
|
|
<input type="hidden" name="area" value="default">
|
|
</form>
|
|
<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
|
|
<ul class="current">
|
|
<li class="toctree-l1"><a class="reference internal" href="whatis.html">What is Reticulum?</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="gettingstartedfast.html">Getting Started Fast</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="using.html">Using Reticulum on Your System</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="understanding.html">Understanding Reticulum</a></li>
|
|
<li class="toctree-l1 current current-page"><a class="current reference internal" href="#">Communications Hardware</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="interfaces.html">Configuring Interfaces</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="networks.html">Building Networks</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="support.html">Support Reticulum</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="examples.html">Code Examples</a></li>
|
|
</ul>
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="reference.html">API Reference</a></li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</aside>
|
|
<div class="main">
|
|
<div class="content">
|
|
<div class="article-container">
|
|
<a href="#" class="back-to-top muted-link">
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
|
|
<path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
|
|
</svg>
|
|
<span>Back to top</span>
|
|
</a>
|
|
<div class="content-icon-container">
|
|
<div class="theme-toggle-container theme-toggle-content">
|
|
<button class="theme-toggle" aria-label="Toggle Light / Dark / Auto color theme">
|
|
<svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
|
|
<svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
|
|
<svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
|
|
<svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
|
|
</button>
|
|
</div>
|
|
<label class="toc-overlay-icon toc-content-icon" for="__toc">
|
|
<span class="icon"><svg><use href="#svg-toc"></use></svg></span>
|
|
</label>
|
|
</div>
|
|
<article role="main" id="furo-main-content">
|
|
<section id="communications-hardware">
|
|
<span id="hardware-main"></span><h1>Communications Hardware<a class="headerlink" href="#communications-hardware" title="Link to this heading">¶</a></h1>
|
|
<p>One of the truly valuable aspects of Reticulum is the ability to use it over
|
|
almost any conceivable kind of communications medium. The <a class="reference internal" href="interfaces.html#interfaces-main"><span class="std std-ref">interface types</span></a>
|
|
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.</p>
|
|
<p>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 <a class="reference internal" href="interfaces.html#interfaces-pipe"><span class="std std-ref">PipeInterface</span></a> or the <a class="reference internal" href="interfaces.html#interfaces-tcpc"><span class="std std-ref">TCPClientInterface</span></a>
|
|
in combination with code like <a class="reference external" href="https://github.com/simplyequipped/tcpkissserver">TCP KISS Server</a>
|
|
by <a class="reference external" href="https://github.com/simplyequipped">simplyequipped</a>.</p>
|
|
<p>It is also very easy to write and load <a class="reference internal" href="interfaces.html#interfaces-custom"><span class="std std-ref">custom interface modules</span></a>
|
|
into Reticulum, allowing you to communicate with more or less anything you can think of.</p>
|
|
<p>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.</p>
|
|
<p>This chapter will outline a few different sensible starting paths to get
|
|
real-world functional wireless communications up and running with minimal cost
|
|
and effort. Two fundamental devices categories will be covered, <em>RNodes</em> and
|
|
<em>WiFi-based radios</em>. Additionally, other common options will be briefly described.</p>
|
|
<p>Knowing how to employ just a few different types of hardware will make it possible
|
|
to build a wide range of useful networks with little effort.</p>
|
|
<section id="combining-hardware-types">
|
|
<h2>Combining Hardware Types<a class="headerlink" href="#combining-hardware-types" title="Link to this heading">¶</a></h2>
|
|
<p>It is useful 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.</p>
|
|
</section>
|
|
<section id="rnode">
|
|
<span id="rnode-main"></span><h2>RNode<a class="headerlink" href="#rnode" title="Link to this heading">¶</a></h2>
|
|
<p>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 <em>RNode</em> was designed. It is important to
|
|
note that RNode is not one specific device, from one particular vendor, but
|
|
<em>an open plaform</em> that anyone can use to build interoperable digital transceivers
|
|
suited to their needs and particular situations.</p>
|
|
<p>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 <em>LoRa</em> modulation in common ISM bands.</p>
|
|
<p><strong>Avoid Confusion!</strong> RNodes can use LoRa as a <em>physical-layer modulation</em>, but it
|
|
does not use, and has nothing to do with the <em>LoRaWAN</em> protocol and standard, commonly
|
|
used for centrally controlled IoT devices. RNodes use <em>raw LoRa modulation</em>, without
|
|
any additional protocol overhead. All high-level protocol functionality is handled
|
|
directly by Reticulum.</p>
|
|
<section id="creating-rnodes">
|
|
<span id="rnode-creating"></span><h3>Creating RNodes<a class="headerlink" href="#creating-rnodes" title="Link to this heading">¶</a></h3>
|
|
<p>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 open source 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: Using common
|
|
LoRa development boards. This approach can be boiled down to two simple steps:</p>
|
|
<ol class="arabic simple">
|
|
<li><p>Obtain one or more <a class="reference internal" href="#rnode-supported"><span class="std std-ref">supported development boards</span></a></p></li>
|
|
<li><p>Install the RNode firmware with the <a class="reference internal" href="#rnode-installation"><span class="std std-ref">automated installer</span></a></p></li>
|
|
</ol>
|
|
<p>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 <a class="reference internal" href="interfaces.html#interfaces-rnode"><span class="std std-ref">RNodeInterface</span></a>
|
|
to the configuration.</p>
|
|
</section>
|
|
<section id="supported-boards-and-devices">
|
|
<span id="rnode-supported"></span><h3>Supported Boards and Devices<a class="headerlink" href="#supported-boards-and-devices" title="Link to this heading">¶</a></h3>
|
|
<p>To create one or more RNodes, you will need to obtain supported development
|
|
boards or completed devices. The following boards and devices are supported
|
|
by the auto-installer.</p>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_tbeam_supreme.png"><img alt="_images/board_tbeam_supreme.png" class="align-center" src="_images/board_tbeam_supreme.png" style="width: 75%;" />
|
|
</a>
|
|
<section id="lilygo-t-beam-supreme">
|
|
<h4>LilyGO T-Beam Supreme<a class="headerlink" href="#lilygo-t-beam-supreme" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262 or SX1268</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_tbeam.png"><img alt="_images/board_tbeam.png" class="align-center" src="_images/board_tbeam.png" style="width: 75%;" />
|
|
</a>
|
|
</section>
|
|
<section id="lilygo-t-beam">
|
|
<h4>LilyGO T-Beam<a class="headerlink" href="#lilygo-t-beam" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262, SX1268, SX1276 or SX1278</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_t3s3.png"><img alt="_images/board_t3s3.png" class="align-center" src="_images/board_t3s3.png" style="width: 50%;" />
|
|
</a>
|
|
</section>
|
|
<section id="lilygo-t3s3">
|
|
<h4>LilyGO T3S3<a class="headerlink" href="#lilygo-t3s3" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262, SX1268, SX1276 or SX1278</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_rak4631.png"><img alt="_images/board_rak4631.png" class="align-center" src="_images/board_rak4631.png" style="width: 45%;" />
|
|
</a>
|
|
</section>
|
|
<section id="rak4631-based-boards">
|
|
<h4>RAK4631-based Boards<a class="headerlink" href="#rak4631-based-boards" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262 or SX1268</p></li>
|
|
<li><p><strong>Device Platform</strong> nRF52</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://www.rakwireless.com">RAK Wireless</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_opencomxl.png"><img alt="_images/board_opencomxl.png" class="align-center" src="_images/board_opencomxl.png" style="width: 45%;" />
|
|
</a>
|
|
</section>
|
|
<section id="opencom-xl">
|
|
<h4>OpenCom XL<a class="headerlink" href="#opencom-xl" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver ICs</strong> Semtech SX1262 and SX1280 (dual transceiver)</p></li>
|
|
<li><p><strong>Device Platform</strong> nRF52</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://liberatedsystems.co.uk/">RAK Wireless</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_rnodev2.png"><img alt="_images/board_rnodev2.png" class="align-center" src="_images/board_rnodev2.png" style="width: 68%;" />
|
|
</a>
|
|
</section>
|
|
<section id="unsigned-rnode-v2-x">
|
|
<h4>Unsigned RNode v2.x<a class="headerlink" href="#unsigned-rnode-v2-x" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1276 or SX1278</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://unsigned.io">unsigned.io</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_t3v21.png"><img alt="_images/board_t3v21.png" class="align-center" src="_images/board_t3v21.png" style="width: 46%;" />
|
|
</a>
|
|
</section>
|
|
<section id="lilygo-lora32-v2-1">
|
|
<h4>LilyGO LoRa32 v2.1<a class="headerlink" href="#lilygo-lora32-v2-1" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1276 or SX1278</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_t3v20.png"><img alt="_images/board_t3v20.png" class="align-center" src="_images/board_t3v20.png" style="width: 46%;" />
|
|
</a>
|
|
</section>
|
|
<section id="lilygo-lora32-v2-0">
|
|
<h4>LilyGO LoRa32 v2.0<a class="headerlink" href="#lilygo-lora32-v2-0" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1276 or SX1278</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_t3v10.png"><img alt="_images/board_t3v10.png" class="align-center" src="_images/board_t3v10.png" style="width: 46%;" />
|
|
</a>
|
|
</section>
|
|
<section id="lilygo-lora32-v1-0">
|
|
<h4>LilyGO LoRa32 v1.0<a class="headerlink" href="#lilygo-lora32-v1-0" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1276 or SX1278</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_tdeck.png"><img alt="_images/board_tdeck.png" class="align-center" src="_images/board_tdeck.png" style="width: 45%;" />
|
|
</a>
|
|
</section>
|
|
<section id="lilygo-t-deck">
|
|
<h4>LilyGO T-Deck<a class="headerlink" href="#lilygo-t-deck" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262 or SX1268</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_techo.png"><img alt="_images/board_techo.png" class="align-center" src="_images/board_techo.png" style="width: 45%;" />
|
|
</a>
|
|
</section>
|
|
<section id="lilygo-t-echo">
|
|
<h4>LilyGO T-Echo<a class="headerlink" href="#lilygo-t-echo" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262 or SX1268</p></li>
|
|
<li><p><strong>Device Platform</strong> nRF52</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://lilygo.cn">LilyGO</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_t114.png"><img alt="_images/board_t114.png" class="align-center" src="_images/board_t114.png" style="width: 58%;" />
|
|
</a>
|
|
</section>
|
|
<section id="heltec-t114">
|
|
<h4>Heltec T114<a class="headerlink" href="#heltec-t114" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262 or SX1268</p></li>
|
|
<li><p><strong>Device Platform</strong> nRF52</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://heltec.org">Heltec Automation</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_heltec32v30.png"><img alt="_images/board_heltec32v30.png" class="align-center" src="_images/board_heltec32v30.png" style="width: 58%;" />
|
|
</a>
|
|
</section>
|
|
<section id="heltec-lora32-v3-0">
|
|
<h4>Heltec LoRa32 v3.0<a class="headerlink" href="#heltec-lora32-v3-0" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1262 or SX1268</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://heltec.org">Heltec Automation</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
<a class="reference internal image-reference" href="_images/board_heltec32v20.png"><img alt="_images/board_heltec32v20.png" class="align-center" src="_images/board_heltec32v20.png" style="width: 58%;" />
|
|
</a>
|
|
</section>
|
|
<section id="heltec-lora32-v2-0">
|
|
<h4>Heltec LoRa32 v2.0<a class="headerlink" href="#heltec-lora32-v2-0" title="Link to this heading">¶</a></h4>
|
|
<ul class="simple">
|
|
<li><p><strong>Transceiver IC</strong> Semtech SX1276 or SX1278</p></li>
|
|
<li><p><strong>Device Platform</strong> ESP32</p></li>
|
|
<li><p><strong>Manufacturer</strong> <a class="reference external" href="https://heltec.org">Heltec Automation</a></p></li>
|
|
</ul>
|
|
<hr class="docutils" />
|
|
</section>
|
|
</section>
|
|
<section id="installation">
|
|
<span id="rnode-installation"></span><h3>Installation<a class="headerlink" href="#installation" title="Link to this heading">¶</a></h3>
|
|
<p>Once you have obtained compatible boards, you can install the <a class="reference external" href="https://github.com/markqvist/RNode_Firmware">RNode Firmware</a>
|
|
using the <a class="reference external" href="https://github.com/markqvist/rnodeconfigutil">RNode Configuration Utility</a>.
|
|
If you have installed Reticulum on your system, the <code class="docutils literal notranslate"><span class="pre">rnodeconf</span></code> program will already be
|
|
available. If not, make sure that <code class="docutils literal notranslate"><span class="pre">Python3</span></code> and <code class="docutils literal notranslate"><span class="pre">pip</span></code> is installed on your system, and
|
|
then install Reticulum with with <code class="docutils literal notranslate"><span class="pre">pip</span></code>:</p>
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">pip</span> <span class="n">install</span> <span class="n">rns</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Once installation has completed, it is time to start installing the firmware on your
|
|
devices. Run <code class="docutils literal notranslate"><span class="pre">rnodeconf</span></code> in auto-install mode like so:</p>
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">rnodeconf</span> <span class="o">--</span><span class="n">autoinstall</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>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.</p>
|
|
</section>
|
|
<section id="usage-with-reticulum">
|
|
<span id="rnode-usage"></span><h3>Usage with Reticulum<a class="headerlink" href="#usage-with-reticulum" title="Link to this heading">¶</a></h3>
|
|
<p>When the devices have been installed and provisioned, you can use them with Reticulum
|
|
by adding the <a class="reference internal" href="interfaces.html#interfaces-rnode"><span class="std std-ref">relevant interface section</span></a> to the configuration
|
|
file of Reticulum. In the configuraion you can specify all interface parameters,
|
|
such as serial port and on-air parameters.</p>
|
|
</section>
|
|
</section>
|
|
<section id="wifi-based-hardware">
|
|
<h2>WiFi-based Hardware<a class="headerlink" href="#wifi-based-hardware" title="Link to this heading">¶</a></h2>
|
|
<p>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 <a class="reference internal" href="interfaces.html#interfaces-auto"><span class="std std-ref">AutoInterface</span></a> in Reticulum.
|
|
Most devices will behave like this by default, or allow it via configuration options.</p>
|
|
<p>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.</p>
|
|
<a class="reference internal image-reference" href="_images/radio_rblhg5.png"><img alt="_images/radio_rblhg5.png" src="_images/radio_rblhg5.png" style="width: 49%;" />
|
|
</a>
|
|
<a class="reference internal image-reference" href="_images/radio_is5ac.png"><img alt="_images/radio_is5ac.png" src="_images/radio_is5ac.png" style="width: 49%;" />
|
|
</a>
|
|
<p>Below is a list of example WiFi (and similar) radios that work well for high capacity
|
|
Reticulum links over long distances:</p>
|
|
<ul class="simple">
|
|
<li><p><a class="reference external" href="https://store.ui.com/collections/operator-airmax-devices">Ubiquiti airMAX radios</a></p></li>
|
|
<li><p><a class="reference external" href="https://store.ui.com/collections/operator-ltu">Ubiquiti LTU radios</a></p></li>
|
|
<li><p><a class="reference external" href="https://mikrotik.com/products/group/wireless-systems">MikroTik radios</a></p></li>
|
|
</ul>
|
|
<p>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.</p>
|
|
</section>
|
|
<section id="ethernet-based-hardware">
|
|
<h2>Ethernet-based Hardware<a class="headerlink" href="#ethernet-based-hardware" title="Link to this heading">¶</a></h2>
|
|
<p>Reticulum can run over any kind of hardware that can provide a switched Ethernet-based
|
|
medium. This means that anything from a plain Ethernet switch, to fiber-optic systems,
|
|
to data radios with Ethernet interfaces can be used by Reticulum.</p>
|
|
<p>The Ethernet medium does not need to have any IP infrastructure such as DHCP servers
|
|
or routing set up, but in case such infrastructure does exist, Reticulum will simply
|
|
co-exist with.</p>
|
|
<p>To use Reticulum over Ethernet-based mediums, it is generally enough to use the included
|
|
<a class="reference internal" href="interfaces.html#interfaces-auto"><span class="std std-ref">AutoInterface</span></a>. This interface also works over any kind of
|
|
virtual networking adapter, such as <code class="docutils literal notranslate"><span class="pre">tun</span></code> and <code class="docutils literal notranslate"><span class="pre">tap</span></code> devices in Linux.</p>
|
|
</section>
|
|
<section id="serial-lines-devices">
|
|
<h2>Serial Lines & Devices<a class="headerlink" href="#serial-lines-devices" title="Link to this heading">¶</a></h2>
|
|
<p>Using Reticulum over any kind of raw serial line is also possible with the
|
|
<a class="reference internal" href="interfaces.html#interfaces-serial"><span class="std std-ref">SerialInterface</span></a>. This interface type is also useful for
|
|
using Reticulum over communications hardware that provides a serial port interface.</p>
|
|
</section>
|
|
<section id="packet-radio-modems">
|
|
<h2>Packet Radio Modems<a class="headerlink" href="#packet-radio-modems" title="Link to this heading">¶</a></h2>
|
|
<p>Any packet radio modem that provides a standard KISS interface over USB, serial or TCP
|
|
can be used with Reticulum. This includes virtual software modems such as
|
|
<a class="reference external" href="https://github.com/xssfox/freedv-tnc">FreeDV TNC</a> and <a class="reference external" href="https://github.com/wb2osz/direwolf">Dire Wolf</a>.</p>
|
|
</section>
|
|
</section>
|
|
|
|
</article>
|
|
</div>
|
|
<footer>
|
|
|
|
<div class="related-pages">
|
|
<a class="next-page" href="interfaces.html">
|
|
<div class="page-info">
|
|
<div class="context">
|
|
<span>Next</span>
|
|
</div>
|
|
<div class="title">Configuring Interfaces</div>
|
|
</div>
|
|
<svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
|
|
</a>
|
|
<a class="prev-page" href="understanding.html">
|
|
<svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
|
|
<div class="page-info">
|
|
<div class="context">
|
|
<span>Previous</span>
|
|
</div>
|
|
|
|
<div class="title">Understanding Reticulum</div>
|
|
|
|
</div>
|
|
</a>
|
|
</div>
|
|
<div class="bottom-of-page">
|
|
<div class="left-details">
|
|
<div class="copyright">
|
|
Copyright © 2025, Mark Qvist
|
|
</div>
|
|
Generated with <a href="https://www.sphinx-doc.org/">Sphinx</a> and
|
|
<a href="https://github.com/pradyunsg/furo">Furo</a>
|
|
|
|
</div>
|
|
<div class="right-details">
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</footer>
|
|
</div>
|
|
<aside class="toc-drawer">
|
|
|
|
|
|
<div class="toc-sticky toc-scroll">
|
|
<div class="toc-title-container">
|
|
<span class="toc-title">
|
|
On this page
|
|
</span>
|
|
</div>
|
|
<div class="toc-tree-container">
|
|
<div class="toc-tree">
|
|
<ul>
|
|
<li><a class="reference internal" href="#">Communications Hardware</a><ul>
|
|
<li><a class="reference internal" href="#combining-hardware-types">Combining Hardware Types</a></li>
|
|
<li><a class="reference internal" href="#rnode">RNode</a><ul>
|
|
<li><a class="reference internal" href="#creating-rnodes">Creating RNodes</a></li>
|
|
<li><a class="reference internal" href="#supported-boards-and-devices">Supported Boards and Devices</a><ul>
|
|
<li><a class="reference internal" href="#lilygo-t-beam-supreme">LilyGO T-Beam Supreme</a></li>
|
|
<li><a class="reference internal" href="#lilygo-t-beam">LilyGO T-Beam</a></li>
|
|
<li><a class="reference internal" href="#lilygo-t3s3">LilyGO T3S3</a></li>
|
|
<li><a class="reference internal" href="#rak4631-based-boards">RAK4631-based Boards</a></li>
|
|
<li><a class="reference internal" href="#opencom-xl">OpenCom XL</a></li>
|
|
<li><a class="reference internal" href="#unsigned-rnode-v2-x">Unsigned RNode v2.x</a></li>
|
|
<li><a class="reference internal" href="#lilygo-lora32-v2-1">LilyGO LoRa32 v2.1</a></li>
|
|
<li><a class="reference internal" href="#lilygo-lora32-v2-0">LilyGO LoRa32 v2.0</a></li>
|
|
<li><a class="reference internal" href="#lilygo-lora32-v1-0">LilyGO LoRa32 v1.0</a></li>
|
|
<li><a class="reference internal" href="#lilygo-t-deck">LilyGO T-Deck</a></li>
|
|
<li><a class="reference internal" href="#lilygo-t-echo">LilyGO T-Echo</a></li>
|
|
<li><a class="reference internal" href="#heltec-t114">Heltec T114</a></li>
|
|
<li><a class="reference internal" href="#heltec-lora32-v3-0">Heltec LoRa32 v3.0</a></li>
|
|
<li><a class="reference internal" href="#heltec-lora32-v2-0">Heltec LoRa32 v2.0</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#installation">Installation</a></li>
|
|
<li><a class="reference internal" href="#usage-with-reticulum">Usage with Reticulum</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#wifi-based-hardware">WiFi-based Hardware</a></li>
|
|
<li><a class="reference internal" href="#ethernet-based-hardware">Ethernet-based Hardware</a></li>
|
|
<li><a class="reference internal" href="#serial-lines-devices">Serial Lines & Devices</a></li>
|
|
<li><a class="reference internal" href="#packet-radio-modems">Packet Radio Modems</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</aside>
|
|
</div>
|
|
</div><script src="_static/documentation_options.js?v=292eb321"></script>
|
|
<script src="_static/doctools.js?v=9bcbadda"></script>
|
|
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
|
|
<script src="_static/scripts/furo.js?v=46bd48cc"></script>
|
|
<script src="_static/clipboard.min.js?v=a7894cd8"></script>
|
|
<script src="_static/copybutton.js?v=f281be69"></script>
|
|
</body>
|
|
</html> |