mirror of
https://github.com/markqvist/unsignedio
synced 2026-08-12 17:40:37 -04:00
108 lines
9.3 KiB
HTML
108 lines
9.3 KiB
HTML
|
|
<!doctype html>
|
|
<html>
|
|
<head>
|
|
<link rel="stylesheet" href="../css/water.css?v=19">
|
|
<link rel="shortcut icon" type="image/x-icon" href="../gfx/icon.png">
|
|
<meta charset="utf-8"/>
|
|
<title>RNode Firmware | unsigned.io</title>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
<meta property="og:title" content="RNode Firmware">
|
|
<meta name="description" content="RNode Firmware page at unsigned.io">
|
|
<meta property="og:description" content="RNode Firmware page at unsigned.io">
|
|
<meta property="og:image" content="https://unsigned.io/gfx/unsigned_logo.webp">
|
|
<meta property="og:url" content="https://unsigned.io/software/RNode_Firmware.html">
|
|
<meta property="og:title" content="RNode Firmware">
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta property="twitter:domain" content="unsigned.io">
|
|
<meta property="twitter:url" content="https://unsigned.io/software/RNode_Firmware.html">
|
|
<meta name="twitter:title" content="RNode Firmware">
|
|
<meta name="twitter:description" content="RNode Firmware page at unsigned.io">
|
|
<meta name="twitter:image" content="https://unsigned.io/gfx/unsigned_logo.webp">
|
|
|
|
</head>
|
|
<body>
|
|
<div id="load_overlay" style="background-color:#2a2a2f; position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:2000;"></div>
|
|
<span class="logo">unsigned.io</span>
|
|
<center>
|
|
<p><span class="menu"><a href="../index.html">Home</a> | <a href="../log.html">Log</a> | <a href="../guides.html">Guides</a> | <a href="../software/index.html">Software</a> | <a href="../hardware/index.html">Hardware</a> | <a href="https://github.com/markqvist/Reticulum/discussions">Discussions</a> | <a href="../shop.html">Shop</a> | <a href="../contact.html">Contact Me</a> | <a href="../donate.html">Donate</a></span></p>
|
|
</center><hr><h1>RNode Firmware</h1>
|
|
<p>This is the open and flexible firmware and bootstrapping system for creating <a href="/rnode/">RNode</a> devices.</p>
|
|
<p>An RNode is an open, free and unrestricted digital radio transceiver. It enables anyone to send and receive any kind of data over both short and very long distances. RNodes can be used with many different kinds of programs and systems, but they are especially well suited for use with <a href="https://reticulum.network">Reticulum</a>.</p>
|
|
<p><img alt="Devices Running RNode Firmware" src="https://github.com/markqvist/RNode_Firmware/raw/master/Documentation/rnfw_1.jpg" /></p>
|
|
<p>Depeding on configuration, it can be used for local networking purposes, or to send data over very long distances. Once you have an RNode, there is a wide variety of possible uses:</p>
|
|
<ul>
|
|
<li>As a network adapter for <a href="https://reticulum.network">Reticulum</a></li>
|
|
<li>Messaging using <a href="https://unsigned.io/software/Sideband.html">Sideband</a></li>
|
|
<li>Information sharing and communication using <a href="https://unsigned.io/software/Nomad_Network.html">Nomad Network</a></li>
|
|
<li>LoRa-based <a href="https://unsigned.io/guides/2020_05_03_using_rnodes_with_amateur_radio_software.html">KISS-compatible amateur radio TNC</a></li>
|
|
<li>LoRa development platform</li>
|
|
<li><a href="https://unsigned.io/software/LoRaMon.html">Packet sniffer</a> for LoRa networks</li>
|
|
<li>Long range <a href="https://unsigned.io/guides/2020_05_27_ethernet-and-ip-over-packet-radio-tncs.html">Ethernet and IP network interface</a> on Linux</li>
|
|
<li>As a general-purpose long-range data radio</li>
|
|
</ul>
|
|
<h2><a name="supported"></a>Supported Boards & Devices</h2>
|
|
<p>The RNode Firmware supports the following boards:</p>
|
|
<ul>
|
|
<li>Handheld v2.x RNodes from <a href="https://unsigned.io/shop/product/handheld-rnode">unsigned.io</a></li>
|
|
<li>Original v1.x RNodes from <a href="https://unsigned.io/shop/product/rnode">unsigned.io</a></li>
|
|
<li>LilyGO T-Beam v1.1 devices</li>
|
|
<li>LilyGO LoRa32 v2.0 devices</li>
|
|
<li>LilyGO LoRa32 v2.1 devices</li>
|
|
<li>Heltec LoRa32 v2 devices</li>
|
|
<li>Homebrew RNodes based on ATmega1284p boards</li>
|
|
<li>Homebrew RNodes based on ATmega2560 boards</li>
|
|
<li>Homebrew RNodes based on Adafruit Feather ESP32 boards</li>
|
|
<li>Homebrew RNodes based on generic ESP32 boards</li>
|
|
</ul>
|
|
<h2>Supported Transceiver Modules</h2>
|
|
<p>The RNode Firmware supports all transceiver modules based on <strong>Semtech SX1276</strong>, <strong>Semtech SX1278</strong>, <strong>SX1262</strong>, <strong>SX1268</strong> and <strong>SX1280</strong> chips, that have an <strong>SPI interface</strong> and expose the relevant interrupt pins from the chip.</p>
|
|
<h2>Getting Started Fast</h2>
|
|
<p>You can download and flash the firmware to all the supported boards using the <a href="../rnodeconf/">RNode Config Utility</a>. All firmware releases are now handled and installed directly through the <code>rnodeconf</code> utility, which is inclueded in the <code>rns</code> package. It can be installed via <code>pip</code>:</p>
|
|
<pre><code># Install rnodeconf via rns package
|
|
pip install rns --upgrade
|
|
|
|
# Install the firmware on a board with the install guide
|
|
rnodeconf --autoinstall
|
|
</code></pre>
|
|
<p>For more detailed instruction and in-depth guides, you can have a look at some of these resources:</p>
|
|
<ul>
|
|
<li>Create a <a href="https://unsigned.io/guides/2022_01_25_installing-rnode-firmware-on-supported-devices.html">basic RNode from readily available development boards</a></li>
|
|
<li>Follow a complete build recipe for <a href="https://unsigned.io/guides/2023_01_14_Making_A_Handheld_RNode.html">making a handheld RNode</a>, like the one pictured above</li>
|
|
<li>Learn the basics on how to <a href="https://unsigned.io/guides/2022_01_26_how-to-make-your-own-rnodes.html">create and build your own RNode designs</a> from scratch</li>
|
|
<li>Once you've got the hang of it, start building RNodes for your community, or <a href="../sell_rnodes.html">even for selling them</a></li>
|
|
</ul>
|
|
<p>If you would rather just buy a pre-made unit, you can visit <a href="https://unsigned.io/shop">my shop</a> and purchase my particular version of the <a href="https://unsigned.io/shop/handheld-rnode/">Handheld RNode</a>, which I can assure you is made to the highest quality, and with a lot of care.</p>
|
|
<h2>Support RNode Development</h2>
|
|
<p>You can help support the continued development of open, free and private communications systems by donating via one of the following channels:</p>
|
|
<ul>
|
|
<li>Monero<br/>
|
|
<code>84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w</code>
|
|
<br/><br/></li>
|
|
<li>Ethereum<br/>
|
|
<code>0xFDabC71AC4c0C78C95aDDDe3B4FA19d6273c5E73</code>
|
|
<br/><br/></li>
|
|
<li>Bitcoin<br/>
|
|
<code>35G9uWVzrpJJibzUwpNUQGQNFzLirhrYAH</code>
|
|
<br/><br/></li>
|
|
<li>Ko-Fi<br/>
|
|
<a href="https://ko-fi.com/markqvist"><code>https://ko-fi.com/markqvist</code></a></li>
|
|
</ul>
|
|
<h2>License & Use</h2>
|
|
<p>The RNode Firmware is Copyright © 2023 Mark Qvist / <a href="https://unsigned.io">unsigned.io</a>, and is made available under the <strong>GNU General Public License v3.0</strong>. The source code includes an SX1276, SX1262 and SX1280 driver that is released under MIT License, and Copyright © 2018 Sandeep Mistry / Mark Qvist.</p>
|
|
<p>You can obtain the source code from <a href="https://git.unsigned.io/markqvist/RNode_Firmware">git.unsigned.io</a> or <a href="https://github.com/markqvist/rnode_firmware">GitHub</a>.</p>
|
|
<p>Every RNode also includes an internal copy of it's own firmware source code, that can be downloaded through the <a href="https://unsigned.io/rnode_bootstrap_console">RNode Bootstrap Console</a>, by putting the RNode into Console Mode (which can be activated by pressing the reset button two times within two seconds).</p>
|
|
<p>The RNode Ecosystem is free and non-proprietary, and actively seeks to distribute it's ownership and control. If you want to build RNodes for commercial purposes, including selling them, you must do so adhering to the Open Source licenses that the various parts of the RNode project is released under, and under your own responsibility.</p>
|
|
<p>If you distribute or modify this work, you <strong>must</strong> adhere to the terms of the GPLv3, including, but not limited to, providing up-to-date source code upon distribution, displaying appropriate copyright and license notices in prominent positions of all conveyed works, and making users aware of their rights to the software under the GPLv3.</p>
|
|
<p>In practice, this means that you can use the firmware commercially, but you must understand your obligation to provide all future users of the system with the same rights, that you have been provided by the GPLv3. If you intend using the RNode Firmware commercially, it is worth reading <a href="../sell_rnodes.html">this page</a>.</p>
|
|
<br/><hr/><span class="no_print"><center><br/><i>This website is running on a 100% solar powered server</i><br/><br/>☀️<br/><br/><i><small>Unless otherwise noted, everything here is put into the world under a <a href="../LICENSE.txt">CC BY-NC-SA 4.0</a> license.<br/>Feel free to share and remix, just remember the attribution.
|
|
</small></i></center></span>
|
|
<div class="print_only donation_block"><br/>
|
|
Contribute to keeping information on Free & Open Communications systems available for all.<br/>
|
|
You can donate directly to <b>unsigned.io</b> by using one of the following QR codes:<br/><br/>
|
|
<span class="donate_qr"><img src="../gfx/donate_xmr.png"/><br/>Monero</span>
|
|
<span class="donate_qr"><img src="../gfx/donate_btc.png"/><br/>Bitcoin</span>
|
|
<span class="donate_qr"><img src="../gfx/donate_eth.png"/><br/>Ethereum</span>
|
|
</div>
|
|
</body></html>
|