Reticulum Benutzerhandbuch - Bordwerkzeuge: Unterschied zwischen den Versionen

Aus AutarkWiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „==Reticulum Benutzerhandbuch – Kapitel 4: Die Bordwerkzeuge (CLI)== {| class="wikitable" style="width:100%; text-align:center;" |- | Reticulum Benutzerhan…“)
 
 
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
[[Kategorie:Digitale Autarkie]]
 +
[[Kategorie:Kommunikation]]
 +
[[Kategorie:Reticulum Handbuch]]
 +
[[Datei:Reticulum logo 512.png|512px|rechts|Quelle: https://reticulum.network/index_de.html]]
 +
==[[Digitale Autarkie in der Praxis]]==
 +
'''[[Digitale_Autarkie_in_der_Praxis#Kommunikation|Kommunikation]]'''
 +
├─ [[Wie funktioniert Meshtastic]]
 +
|  └─ [[Digitale Kommunikation mit Meshtastic]]
 +
|      └─ [[CB Datenfunk]]
 +
└─ [[Reticulum Network Stack (RNS)]]
 +
    └─ [[Reticulum Benutzerhandbuch - Einführung]]
 
==Reticulum Benutzerhandbuch – Kapitel 4: Die Bordwerkzeuge (CLI)==
 
==Reticulum Benutzerhandbuch – Kapitel 4: Die Bordwerkzeuge (CLI)==
  
Zeile 61: Zeile 72:
 
=== Worauf du bei <code>rnstatus</code> achten solltest ===
 
=== Worauf du bei <code>rnstatus</code> achten solltest ===
 
* '''Status: Up''' – Das Funkmodul ist verbunden und einsatzbereit. Steht hier <code>Down</code>, stimmt meist der USB-Port nicht oder das Board ist nicht angeschlossen.
 
* '''Status: Up''' – Das Funkmodul ist verbunden und einsatzbereit. Steht hier <code>Down</code>, stimmt meist der USB-Port nicht oder das Board ist nicht angeschlossen.
−
* '''Noise Flr (Noise Floor):''' Zeigt das Grundrauschen auf der Frequenz an. Werte um <code>-115 dBm</code> bis <code>-122 dBm</code> sind sauber. Liegt der Wert deutlich höher (z. B.
+
* '''Noise Flr (Noise Floor):''' Zeigt das Grundrauschen auf der Frequenz an. Werte um <code>-115 dBm</code> bis <code>-122 dBm</code> sind sauber. Liegt der Wert deutlich höher (z. B. <code>-90 dBm</code>), stört ein elektronisches Gerät in der Nähe (oft billige Schaltnetzteile oder LED-Treiber).
 +
* '''Airtime:''' Zeigt deine aktuelle Sendezeit-Auslastung (Duty Cycle) der letzten 15 Minuten und der letzten Stunde an – extrem praktisch, um im Blick zu behalten, wie nah man am gesetzlichen Limit ist.
 +
 
 +
== 2. Netzwerkkarte und Wege prüfen mit <code>rnpath</code> ==
 +
Jeder aktive Knoten im Reticulum-Netz sendet regelmäßig ein kleines Lebenszeichen (''Announce''). Mit <code>rnpath</code> siehst du, welche anderen Knoten dein Gerät bereits gehört hat und über welchen Weg sie erreichbar sind:
 +
<pre>
 +
rnpath -t
 +
</pre>
 +
Das <code>-t</code> steht für ''Table'' und listet alle bekannten Zieladressen (Hashes) zusammen mit der Anzahl der '''Hops''' (Zwischenstationen) und dem verwendeten Interface auf.
 +
 
 +
Möchtest du gezielt einen Weg zu einer bestimmten Adresse anfragen (falls dein Knoten ihn noch nicht kennt), nutzt du:
 +
<pre>
 +
rnpath <Ziel-Hash>
 +
</pre>
 +
 
 +
== 3. Reichweitentests im Gelände mit <code>rnprobe</code> ==
 +
Wenn du eine neue Antenne testest oder prüfen möchtest, wie weit dein LoRa-Signal im Gelände reicht, ist <code>rnprobe</code> das ideale Werkzeug – es funktioniert wie ein klassisches <code>ping</code>.
 +
 
 +
Auf dem Zielrechner (z. B. dem Heim-Pi) muss lediglich ein Dienst laufen, der auf Anfragen antwortet (z. B. ein aktivierter Probe-Responder in der Konfiguration oder NomadNet). Vom mobilen Gerät aus sendest du dann ein Testpaket:
 +
<pre>
 +
rnprobe rnstransport.probe <Ziel-Hash>
 +
</pre>
 +
 
 +
Als Antwort erhältst du die Umlaufzeit (''Round-Trip Time''), die Anzahl der Hops sowie den '''RSSI'''-Wert (Signalstärke) und den '''SNR'''-Wert (Signal-Rausch-Abstand):
 +
* '''SNR über +5 dB:''' Hervorragende Verbindung, sehr stabil.
 +
* '''SNR um 0 dB bis -10 dB:''' Gute bis brauchbare Verbindung über mittlere bis weite Distanzen.
 +
* '''SNR unter -15 dB:''' Grenze der Empfangbarkeit – Pakete kommen gerade noch so an.
 +
 
 +
== 4. Dateien über Funk senden mit <code>rncp</code> ==
 +
Mit <code>rncp</code> (''Reticulum Network Copy'') lassen sich beliebige Dateien – etwa Lageberichte, Kartenmaterial, PDF-Anleitungen oder Software-Pakete – verschlüsselt an einen anderen Knoten übertragen.
 +
 
 +
=== Empfangsmodus auf dem Zielrechner starten ===
 +
Damit nicht jeder ungefragt Dateien auf deinen Rechner laden kann, erlaubt <code>rncp</code> den Empfang nur für freigegebene Identitäten (oder kurzzeitig für alle per <code>-n</code> im geschlossenen Testnetz):
 +
<pre>
 +
rncp -l -a <Absender-Identitäts-Hash>
 +
</pre>
 +
Beim Start zeigt <code>rncp -l</code> seine eigene Zieladresse (Destination Hash) im Terminal an.
 +
 
 +
=== Datei vom Sender abschicken ===
 +
Auf dem sendenden Gerät überträgst du die Datei (z. B. <code>notfallplan.pdf</code>) an diese Zieladresse:
 +
<pre>
 +
rncp notfallplan.pdf <Ziel-Hash>
 +
</pre>
 +
<code>rncp</code> zerlegt die Datei automatisch in kleine Pakete, verschlüsselt sie, prüft die Vollständigkeit über Prüfsummen und setzt sie beim Empfänger wieder exakt zusammen – selbst wenn zwischendurch einzelne Funkpakete verloren gehen.
 +
 
 +
== 5. Entfernte Knoten fernwarten mit <code>rnx</code> ==
 +
Hast du einen Solar-Knoten auf dem Dachboden oder auf einer Berghütte stehen, musst du für Wartungsarbeiten nicht jedes Mal dorthin laufen. Mit <code>rnx</code> (''Reticulum Network Execute'') kannst du einzelne Befehle oder eine komplette interaktive Terminal-Sitzung über Funk ausführen.
 +
 
 +
=== Auf dem entfernten Knoten (Listener starten) ===
 +
<pre>
 +
rnx -l -a <Deine-Admin-Identität>
 +
</pre>
 +
''Sicherheitshinweis:'' Gib bei <code>-a</code> unbedingt nur deinen eigenen Identitäts-Hash frei, da jeder zugelassene Nutzer Befehle auf diesem Rechner ausführen darf!
 +
 
 +
=== Vom eigenen Rechner aus verbinden ===
 +
Für einen einzelnen Befehl (z. B. Temperatur oder Speicherplatz abfragen):
 +
<pre>
 +
rnx <Ziel-Hash> "uptime && df -h"
 +
</pre>
 +
 
 +
Oder für eine komplette interaktive Terminal-Sitzung (wie bei SSH):
 +
<pre>
 +
rnx -i <Ziel-Hash>
 +
</pre>
 +
''Tipp für Funkverbindungen:'' Da LoRa-Funk langsam ist, empfiehlt es sich, im interaktiven Modus keine Programme mit ständig aktualisierter Vollbild-Grafik (wie <code>htop</code>) zu starten, sondern klassische, sparsame Befehle zu nutzen.
 +
 
 +
== 6. Hardware-Feintuning mit <code>rnodeconf</code> ==
 +
Mit <code>rnodeconf</code> kannst du jederzeit Informationen aus deinem angeschlossenen LoRa-Board auslesen oder Einstellungen direkt im Speicher des Boards anpassen:
 +
<pre>
 +
# Geräteinformationen und Firmware-Version anzeigen
 +
rnodeconf /dev/ttyUSB0 --info
 +
 
 +
# OLED-Display des Boards dauerhaft ausschalten (spart Strom im Solarbetrieb)
 +
rnodeconf /dev/ttyUSB0 --display-off
 +
</pre>
 +
 
 +
== Nächster Schritt ==
 +
Kommandozeilen-Werkzeuge sind perfekt für Technik und Automatisierung – im Alltag wünscht man sich aber eine übersichtliche Oberfläche zum Chatten und Lesen. Im nächsten Kapitel richten wir '''NomadNet''' ein und bauen unser eigenes kleines Off-Grid-Web.
 +
 
 +
'''Weiter zu: [[Reticulum Benutzerhandbuch - NomadNet|Kapitel 5: NomadNet & das Small Web]]'''
 +
 
 +
[[Kategorie:Digitale Autarkie]]
 +
[[Kategorie:Kommunikation]]
 +
[[Kategorie:Reticulum Handbuch]]

Aktuelle Version vom 21. November 2026, 09:21 Uhr

Quelle: https://reticulum.network/index_de.html

Digitale Autarkie in der Praxis

Kommunikation
├─ Wie funktioniert Meshtastic 
|   └─ Digitale Kommunikation mit Meshtastic 
|      └─ CB Datenfunk
└─ Reticulum Network Stack (RNS)
   └─ Reticulum Benutzerhandbuch - Einführung

Reticulum Benutzerhandbuch – Kapitel 4: Die Bordwerkzeuge (CLI)

1. Einführung 2. Hardware 3. Installation 4. Bordwerkzeuge 5. NomadNet 6. Micron (.mu) 7. Solar-Knoten

Warum die Kommandozeile im Krisenfall Gold wert ist

Auf einem stromsparenden Raspberry Pi Zero 2 W oder einem Solar-Knoten im Außenbereich läuft in der Regel kein Desktop, sondern nur ein schlankes Linux-Terminal. Genau dafür bringt Reticulum bereits ab Werk eine Reihe extrem nützlicher Kommandozeilen-Werkzeuge mit.

Mit diesen kleinen Programmen kannst du:

  • Prüfen, ob dein Funkmodul sauber sendet und empfängt
  • Herauszufinden, über wie viele Zwischenstationen (Hops) ein entfernter Knoten erreichbar ist
  • Reichweitentests im Gelände durchführen
  • Dateien gezielt über Funk von einem Rechner auf einen anderen kopieren
  • Entfernte Knoten aus der Ferne warten – komplett ohne Internet

Übersicht der wichtigsten Befehle

Befehl Aufgabe Vergleich aus der klassischen IT
rnstatus Zeigt den Zustand aller Schnittstellen (Funk, WLAN, TCP) und Datenmengen an. ip a / ifconfig
rnpath Zeigt bekannte Knoten im Netz und die Anzahl der Zwischenstationen (Hops). traceroute / Routing-Tabelle
rnprobe Sendet ein Testpaket an ein Ziel und misst Antwortzeit und Signalqualität. ping
rncp Kopiert Dateien verschlüsselt über das Reticulum-Netz auf einen anderen Rechner. scp
rnx Führt Befehle oder eine interaktive Shell auf einem entfernten Rechner aus. ssh
rnid Verwaltet kryptografische Identitäten, prüft Signaturen und verschlüsselt Dateien. gpg / ssh-keygen
rnodeconf Flasht und konfiguriert RNode-LoRa-Boards (Sendeleistung, Frequenz, Display). Hardware-Konfigurator

1. Schnittstellen überwachen mit rnstatus

rnstatus ist dein wichtigstes Diagnosewerkzeug. Es zeigt auf einen Blick, ob der Hintergrunddienst rnsd läuft und welche Funk- oder Netzwerkverbindungen aktiv sind:

rnstatus

Typische Ausgabe:

 Shared Instance[37428]
    Status    : Up
    Serving   : 1 program
    Rate      : 320.00 bps

 RNodeInterface[RNode LoRa 868MHz]
    Status    : Up
    Mode      : Full
    Rate      : 1.56 kbps
    Noise Flr : -118 dBm
    Battery   : 94% (Charging)
    Airtime   : 0.4% (1h) / 0.1% (15m)
    Traffic   : 14.2 KB in / 8.7 KB out

Worauf du bei rnstatus achten solltest

  • Status: Up – Das Funkmodul ist verbunden und einsatzbereit. Steht hier Down, stimmt meist der USB-Port nicht oder das Board ist nicht angeschlossen.
  • Noise Flr (Noise Floor): Zeigt das Grundrauschen auf der Frequenz an. Werte um -115 dBm bis -122 dBm sind sauber. Liegt der Wert deutlich höher (z. B. -90 dBm), stört ein elektronisches Gerät in der Nähe (oft billige Schaltnetzteile oder LED-Treiber).
  • Airtime: Zeigt deine aktuelle Sendezeit-Auslastung (Duty Cycle) der letzten 15 Minuten und der letzten Stunde an – extrem praktisch, um im Blick zu behalten, wie nah man am gesetzlichen Limit ist.

2. Netzwerkkarte und Wege prüfen mit rnpath

Jeder aktive Knoten im Reticulum-Netz sendet regelmäßig ein kleines Lebenszeichen (Announce). Mit rnpath siehst du, welche anderen Knoten dein Gerät bereits gehört hat und über welchen Weg sie erreichbar sind:

rnpath -t

Das -t steht für Table und listet alle bekannten Zieladressen (Hashes) zusammen mit der Anzahl der Hops (Zwischenstationen) und dem verwendeten Interface auf.

Möchtest du gezielt einen Weg zu einer bestimmten Adresse anfragen (falls dein Knoten ihn noch nicht kennt), nutzt du:

rnpath <Ziel-Hash>

3. Reichweitentests im Gelände mit rnprobe

Wenn du eine neue Antenne testest oder prüfen möchtest, wie weit dein LoRa-Signal im Gelände reicht, ist rnprobe das ideale Werkzeug – es funktioniert wie ein klassisches ping.

Auf dem Zielrechner (z. B. dem Heim-Pi) muss lediglich ein Dienst laufen, der auf Anfragen antwortet (z. B. ein aktivierter Probe-Responder in der Konfiguration oder NomadNet). Vom mobilen Gerät aus sendest du dann ein Testpaket:

rnprobe rnstransport.probe <Ziel-Hash>

Als Antwort erhältst du die Umlaufzeit (Round-Trip Time), die Anzahl der Hops sowie den RSSI-Wert (Signalstärke) und den SNR-Wert (Signal-Rausch-Abstand):

  • SNR über +5 dB: Hervorragende Verbindung, sehr stabil.
  • SNR um 0 dB bis -10 dB: Gute bis brauchbare Verbindung über mittlere bis weite Distanzen.
  • SNR unter -15 dB: Grenze der Empfangbarkeit – Pakete kommen gerade noch so an.

4. Dateien über Funk senden mit rncp

Mit rncp (Reticulum Network Copy) lassen sich beliebige Dateien – etwa Lageberichte, Kartenmaterial, PDF-Anleitungen oder Software-Pakete – verschlüsselt an einen anderen Knoten übertragen.

Empfangsmodus auf dem Zielrechner starten

Damit nicht jeder ungefragt Dateien auf deinen Rechner laden kann, erlaubt rncp den Empfang nur für freigegebene Identitäten (oder kurzzeitig für alle per -n im geschlossenen Testnetz):

rncp -l -a <Absender-Identitäts-Hash>

Beim Start zeigt rncp -l seine eigene Zieladresse (Destination Hash) im Terminal an.

Datei vom Sender abschicken

Auf dem sendenden Gerät überträgst du die Datei (z. B. notfallplan.pdf) an diese Zieladresse:

rncp notfallplan.pdf <Ziel-Hash>

rncp zerlegt die Datei automatisch in kleine Pakete, verschlüsselt sie, prüft die Vollständigkeit über Prüfsummen und setzt sie beim Empfänger wieder exakt zusammen – selbst wenn zwischendurch einzelne Funkpakete verloren gehen.

5. Entfernte Knoten fernwarten mit rnx

Hast du einen Solar-Knoten auf dem Dachboden oder auf einer Berghütte stehen, musst du für Wartungsarbeiten nicht jedes Mal dorthin laufen. Mit rnx (Reticulum Network Execute) kannst du einzelne Befehle oder eine komplette interaktive Terminal-Sitzung über Funk ausführen.

Auf dem entfernten Knoten (Listener starten)

rnx -l -a <Deine-Admin-Identität>

Sicherheitshinweis: Gib bei -a unbedingt nur deinen eigenen Identitäts-Hash frei, da jeder zugelassene Nutzer Befehle auf diesem Rechner ausführen darf!

Vom eigenen Rechner aus verbinden

Für einen einzelnen Befehl (z. B. Temperatur oder Speicherplatz abfragen):

rnx <Ziel-Hash> "uptime && df -h"

Oder für eine komplette interaktive Terminal-Sitzung (wie bei SSH):

rnx -i <Ziel-Hash>

Tipp für Funkverbindungen: Da LoRa-Funk langsam ist, empfiehlt es sich, im interaktiven Modus keine Programme mit ständig aktualisierter Vollbild-Grafik (wie htop) zu starten, sondern klassische, sparsame Befehle zu nutzen.

6. Hardware-Feintuning mit rnodeconf

Mit rnodeconf kannst du jederzeit Informationen aus deinem angeschlossenen LoRa-Board auslesen oder Einstellungen direkt im Speicher des Boards anpassen:

# Geräteinformationen und Firmware-Version anzeigen
rnodeconf /dev/ttyUSB0 --info

# OLED-Display des Boards dauerhaft ausschalten (spart Strom im Solarbetrieb)
rnodeconf /dev/ttyUSB0 --display-off

Nächster Schritt

Kommandozeilen-Werkzeuge sind perfekt für Technik und Automatisierung – im Alltag wünscht man sich aber eine übersichtliche Oberfläche zum Chatten und Lesen. Im nächsten Kapitel richten wir NomadNet ein und bauen unser eigenes kleines Off-Grid-Web.

Weiter zu: Kapitel 5: NomadNet & das Small Web