MeshCore CLI Befehle

Wird ein Leerzeichen nach neighbor.remove gesendet, dann wird die komplette Liste gelöscht.

log stop

log erase

log

log stop

log erase

Stoppe die Erfassung des RX-Logs

Lösche das RX-Log

Das Log kann logischerweise aufgrund seiner Größe nicht per Lora abgerufen werden sondern nur über die serielle Schnittstelle.

set radio <freq>,<bw>,<sf>,<cr>

set radio 869.618, 62.5,8,8

set tx <dbm>

set tx 20

Setzt die Ausgangsleistung des Repeaters. Hier 20dBm, das sind 100mW.
Es wird nur die Leistung des Lora Boards gesetzt. Wenn ein Leistungsverstärker nachgeschaltet ist, dann ist die Sendeleistung natürlich höher. Bitte darauf achten dass die gesetzlichen Maximalwerte einghalten werden. Siehe dazu unseren Beitrag zu ERP/EIRP

set radio.rxgain <state>

set radio.rxgain on|off

Mit diesem Befehl wird der Vorverstärker ein oder ausgeschaltet.

set name <name>

set name DE-NW-HSK-Meschede

set lat <degrees>

set lat 51.3446807

Setzt den Breitengrad des Knotens auf 51.3446807
Die Werte sind jeweils in Grad mit Nachkommastellen

set lon <degrees>

set lat 8.2999601

Setzt den Längengrad des Knotens auf 8.2999601
Die Werte sind jeweils in Grad mit Nachkommastellen

set prv.key <private_key>

set prv.key <private_key>

Setzen des privaten Schlüssels. Es ist ein Meustart erforderlich, damit der neue private Schlüssel wirksam wird.

set guest.password <password>

set guest.password asdfjklö

Das Gast Passwort auf einen neuen Wert setzen. Der Standartwert  ist<blank>

set owner.info <text>

set owner.info > Repeater Stimmstamm DB0HSK

Setzt die Eigentümerinformation des Knotens. | – Zeichen werden in Zeilenumbrüche umgewandelt.

set adc.multiplier <value>

set adc.multiplier 2

setzt den aktuellen aktuellen Korrekturfaktor für die Batterie-Spannungsmessung.

Wenn dir dein Repeater oder Node eine falsche Akkuspannung oder einen falschen Prozentsatz anzeigt, kannst du den Wert mit set adc.multiplier <wert> kalibrieren. Falls das Board dies nicht unterstützt, wird eine Fehlermeldung ausgegeben.

Wichtig: Dieser Befehl hat keinerlei Auswirkungen auf die tatsächliche Stromversorgung oder das Ladeverhalten des Geräts – er dient rein der korrekten Anzeige des Akkustands.

Z.B.: > repeater

powersaving on powersaving off

powersaving on powersaving off

Energiesparstatus dieses Knotens ein oder ausschalten

Der Mikrocontroller schaltet sich in Phasen, in denen keine Aktivität stattfindet, weitgehend ab. Dadurch sinkt der Stromverbrauch im Leerlauf oft von einigen Dutzend Milliampère auf wenige Mikroampère

Ein echter Repeater sollte idealerweise permanent empfangsbereit sein, um durchfliegende Pakete sofort weiterzuleiten. Wenn der Repeater in den Energiesparmodus wechselt, kann es passieren, dass er Nachrichten verpasst, weil er gerade schläft. Hier führt Powersaving oft zu Paketverlusten im Mesh.

get repeat <state>

set repeat on
set repeat off

Mit set repeat off machst du aus einem Repeater einen ganz normalen „Client“. Wenn du die Funktion später wieder aktivieren möchtest, reicht ein set repeat on.
Macht bei einem Repeater eigentlich keinen Sinn.

set path.hash.mode <value>

set path.hash.mode 0

Setzt die Zahl der Bytes des öffentlichen Schlüssels eines Knotens die bei Adverts übertragen gesendet werden.

Der Sinn dahinter: Kürzere Hashes sparen wertvollen Platz im Funkpaket, während längere Hashes mehr eindeutige Geräte im Netz unterstützen.

Um Platz im Funkpaket zu sparen, wird dieser Public Key abgeschnitten – man nimmt je nach eingestelltem Modus einfach das 1. Byte, die ersten 2 Bytes oder die ersten 3 Bytes als kompakte ID.

set loop.detect <state>

set loop.detect on

Schaltet lopp.detect  ein, dabei gibt es 4 Parameter:

off: Schleifenerkennung ist komplett deaktiviert.

minimal: Ein Paket wird erst dann als Schleife verworfen, wenn die eigene Node-ID/Hash 4 Mal oder häufiger im Pfad auftaucht.

moderate: Ein Paket wird erst dann als Schleife verworfen, wenn die eigene Node-ID/Hash 2 Mal oder häufiger im Pfad auftaucht.

strict: Blockiert ein Paket sofort beim ersten Anzeichen dafür, dass es den eigenen Knoten/Pfad bereits passiert hat.

In einem vermaschten Funknetz (Mesh) kann es passieren, dass ein Funkpaket im Kreis weitergeleitet wird (weil beispielsweise mehrere Repeater das Paket gegenseitig hin- und herschicken). Das verstopft unnötig den Äther und verschwendet Bandbreite. Die Schleifenerkennung verhindert das, indem sie solche Endlosschleifen (Loops) erkennt und die betroffenen Pakete verwirft.

set txdelay <value>

set txdelay 0.5

Setzt einen Wert für txdelay

Wenn mehrere nahe beieinander liegende Repeater dasselbe Flood-Paket empfangen, wartet jeder eine zufällige Zeitspanne, bevor er es erneut sendet, um gleichzeitige Kollisionen zu vermeiden. Dieser Faktor skaliert die Größe dieses zufälligen Zeitfensters. Höhere Werte verringern das Kollisionsrisiko, erhöhen aber die Latenzzeit. Der Wert 0 deaktiviert das Zeitfenster vollständig. Die Werte können zwischen 0 und 2 liegen

set direct.txdelay <value>

set direct.txdelay 0.2

Der Standardwert ist niedriger, da bei direkten Paketen deutlich weniger Knoten um die Weiterleitung konkurrieren.

set rxdelay <value>

set rxdelay <value>

Setzt einen Wert für rxdelay
Die rxdelay sorgt signalabhängig dafür wie schnell ein Paket weitergeletet wird. tarke signale eerhälten eine kurze Verzögerung. Schwache Signale erhalten eine längere Verzögerung.

Das Netz sorgt dadurch automatisch dafür, dass sich primär die stabilsten, direktesten Wege durchsetzen, während wackelige Pfade im Hintergrund gehalten werden.

set dutycycle <value>

set dutycycle 10

Setzt den Dutycycle in Prozent als maximale Sendezeit in einem Zeitraum von einer Stunde.

In der Region der EU ist es gesetzlich vorgeschrieben, dass ein Funksender im LoRa-Band (868 MHz) ununterbrochen maximal 10 % der Zeit innerhalb einer Stunde senden darf, um andere Nutzer nicht zu blockieren. Hier wird ein gleitender Stundenwert zugrunde betrachtet.

Wird dieser Wert erreicht, werden alle Aussendungen absolut blockiert bis dieser gleitende Stundenwert wieder unter 10% gesunken ist.

set af <value>log

set af 9

Setzt den Artimefaktor auf 9

Ein Airtimefaktor von 1 besagt, dass nach jedem gesendeten Paket genau so lange nicht gesendet wird, wie die Aussendung des aktuellen Paketes gedauert hat. Ein Airtimefaktor von 9 besagt, dass nach jedem gesendeten Paket 9x so lange nicht gesendet wird, wie die Aussendung des aktuellen Paketes gedauert hat.

Ein AF von 9 passt exakt zum Dutycycle von 10%. Heißt aber, dass nach einer Sekunde Sendezeit immer 9 Sekunden nicht gesendet wird. Dass bedeutet, dass zwischen den einzelnen Pakten immer eine größere Zeitspanne liegt. Dies sorgt aber dafür, dass der Repeater nicht für den Großteil einer Stunde abgeschaltet werden muss um die 10% gesetliche Vorgabe einzuhalten. Heißt: Die AF sorgt dafür wie man die 10% Dutycycle erreichen will.

Bei einem wenig frequentierten Repeater kann man die AF runter setzten. Die einzelnen Pakate kommen dann schnell hintereinander.

Bei einem Repeater mit viel Verkehr sollte die AF hoch sein, damit der Repeater nicht plötzlich für einen großen Teil einer Stunde abgeschaltet ist.

set int.thresh <value>

set int.thresh 14

Setzt den Schwellwert für lokale Interferenzen in dB.

Ein Knoten misst kontinuierlich das aktuelle Grundrauschen, also den sogenannten Noise Floor. Wenn ein Paket weitergeleitet werden soll, prüft der Knoten zuerst, ob auf dem Kanal gerade andere Funksignale zu hören sind. Liegt der aktuelle RSSI-Wert (Empfangspegel) über dem Rauschen plus diesem Schwellenwert (int.thresh), stuft der Knoten den Kanal als „beschäftigt“ (busy) ein. Der Knoten verschiebt in dem Fall seine eigene Aussendung (verzögert also das Senden), um nicht genau in den Funkverkehr anderer Stationen hineinzusenden und Kollisionen zu provozieren. Bei einem niedrigen Wert von z.B. 1 wartet der Knoten schon bei schwachen Signalen mit dem Aussenden. Bei großen Werten z.B. 20, wartet der Knoten nur bei starken Fremdsignalen.

Mit einem Wert von 0 schaltet man die automatische Erkennung von Fremdsignalen komplett aus. Dies tun die meisten Repeater.

set agc.reset.interval <value>region

set agc.reset.interval 16

Setzt den Wert des AGC-Zurücksetzungs-Intervalls in Sekunden.

Die AGC regelt die Verstärkung bei starken Signalen herunter. Manchmal „verhakt“ sich der Chip dabei und bleibt zu unempfindlich. Das regelmäßige Zurücksetzen zwingt den Empfänger zur Neueinstellung, damit auch schwache Signale nicht verloren gehen. Dieser Wert sollte mindestens im Bereich von vielen Minuten liegen, um den Knoten nicht zu „schwächen“. Diese Funktion wird aber auch häufig durch eine 0 deaktiviert.

set multi.acks <state>

set multi.acks 0 oder 1

Mit diesem Befehl lässt sich Multi-ACKs ein (1) oder ausschalten (0)

Der Zielknoten, für den die Nachricht bestimmt ist, schickt natürlich immer ein ACK zurück, damit der Empfänger weißt, dass die Nachricht angekommen ist. Wenn Multi-ACKs eingeschatet ist, bestätigt der Repeater auch für ein Paket, dass er nur weiterleitet, dass es angekommen ist.

Die Funktion sparsam einsetzen, sie macht nur zu Testzwecken sinn. Außerdem werden die Netze stark belastet wenn dies viele Repeater machen.

set flood.advert.interval <hours>

set flood.advert.interval 24

Setzt das Zeitinterval, in dem ein flood-Advert gesendet wird.

set advert.interval <minutes>

set advert.interval 60

Setzt das Zeitinterval, in dem ein Zero-Hop-Advert gesendet wird.

set flood.max <value>

set flood.max 5

Maximal zulässige Hops für einem Knoten festlegen.

Die Logik funktioniert nun so: Der Companion liefert von der App eine gewünscht Anzahl an Hops mit. Bei jedem Weiterleiten wird dieser Wert um 1 reduziert. Sobald der Wert 0 erreicht wird das Paket verworfen.

Sollte bei einem Repeater ein Paket mit einem Hop-Zähler ankommen, die größer ist als der flood-max Wert des Repeaters , dann wird  der Hop-Zähler auf den max-Wert des Repeaters heruntergestutzt.

Dieses Vorgehen verhindert dass Pakete durch das ganze Netz geleitet werden.

set flood.max.unscoped <value>

set flood.max.unscoped 5

Hiermit kann man Nachrichten ohne Region auf wenige Hops begrenzen

set flood.max.advert <value>

set flood.max.advert 5

Hiermit kann man flood-Adverts auf wenige Hops begrenzen

0: Guest
1: Read-only
2: Read-write
3: Admin

Welchen <pubkey> welche Rechte zugeteilt wurden, kann nur seriel abgefragt werden.

Bei region denyf * werden Pakte ohne Region verworfen

region home <name>

region home hsk

region default <name>

region default <null>

region default hsk

region default <null>

Setzt eine Default-Region für einen Knoten

Löscht die default-Region

Wenn ein Node eine Nachricht bzw. ein Flood-Packet ohne ausdrücklich angegebene Region erzeugt, soll standardmäßig die Region die default Region als Scope verwendet werden.

gps <state>

gps on | off

GPS ein oder ausschalten

Funktioniert natgürlich nur bei Modulen mit GPS-Epfänger

gps advert <policy>

gps advert <policy>

Legt fest, nach welcher Richtlinie der eigene Standort an das Mesh gesendet wird.

none: Standort in Adverts nicht teilen
share: gps Standort in Adverts teilen
prefs: Standort aus Einstgellungen in Adverts teilen