Dieses Dokument bietet einen Überblick über die CLI-Befehle, die an MeshCore Repeater, Raumserver und Sensoren gesendet werden können.

Starten Sie den Knoten neu

Verwendung:

• reboot

Gerät Ausschalten

Verwendung:

• poweroff, oder
• shutdown

Hinweis: Es wird keine Antwort gesendet.

Uhrzeit zurücksetzen und neu starten

Verwendung:

• clkreboot

Synchronisieren Sie die Uhr mit dem Remote-Gerät.

Verwendung:

• clock sync

Aktuelle Zeit in UTC anzeigen

Verwendung:

• clock

Stelle die Zeit auf einen bestimmten Zeitstempel ein.

Verwendung:

• time <epoch_seconds>

Parameter:

• epoc_seconds : Unix-Epochenzeit

Senden Sie eine flood advert

Verwendung:

• advert

Senden Sie eine zero-hop advert

Verwendung:

• advert.zerohop

Starten Sie ein Firmware-Update über Funk (OTA).

Verwendung:

• start ota

Löschen/Auf Werkseinstellungen zurücksetzen

Verwendung:

• erase

Nur seriell: Ja

Warnung: Dies ist zerstörerisch!

Listen Sie Nachbarn in der Nähe auf

Verwendung:

• neighbors

Hinweis: Die Ausgabe dieses Befehls ist auf die 8 neuesten Anzeigen beschränkt.

Hinweis: Jede Zeile ist wie folgt kodiert: {pubkey-prefix}:{timestamp}:{snr*4}

Entfernen Sie einen Nachbarn

Verwendung:

• neighbor.remove <pubkey_prefix>

pubkey_prefix: Der öffentliche Schlüssel des Knotens, der aus der Nachbarnliste entfernt werden soll. Dies kann ein kurzes Präfix oder der vollständige Schlüssel sein. Alle Nachbarn, die mit dem angegebenen Präfix übereinstimmen, werden entfernt.

Hinweis: Du kannst alle Nachbarn entfernen, indem du ein Leerzeichen als Präfix sendest. Das Leerzeichen steht für ein leeres Präfix, das mit allen vorhandenen Nachbarn übereinstimmt.

Entdecke zero hop Nachbarn

Verwendung:

• discover.neighbors

Statistiken löschen

Verwendung:

• clear stats

Systemstatistiken – Akku, Betriebszeit, Warteschlangenlänge und Debug-Flags

Verwendung:

• stats-core

Nur seriell: Ja

Funkstatistik – Rauschpegel, Letzter RSSI/SNR-Wert, Sendezeit, Empfangsfehler

Verwendung:

• stats-radio

Nur seriell: Ja

Paketstatistik – Paketzähler: Empfangen, Gesendet

Verwendung:

• stats-packets

Nur seriell: Ja

Beginne die Erfassung des RX-Protokolls im Knotenspeicher

Verwendung:

• log start

Ende der Erfassung des RX-Logs im Knotenspeicher

Verwendung:

• log stop

Erfasstes Protokoll löschen

Verwendung:

• log erase

Geben Sie das erfasste Protokoll im seriellen Terminal aus.

Verwendung:

• log

Nur seriell: Ja

Holen Sie sich die Version

Verwendung:

• ver

Zeigt den Hardwarenamen an

Verwendung:

• board

Funkparameter dieses Knotens anzeigen oder ändern

Verwendung:

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

Parameter:

• freq : Frequenz in MHz
• bw : Bandbreite in kHz
• sf : Spreizfaktor (5-12)
• cr : Kodierungsrate (5-8)

Wird durch Build-Flag gesetzt: LORA_FREQ, LORA_BW, LORA_SF, LORA_CR Standard: 869.525,250,11,5 Hinweis: Ein Neustart ist erforderlich, um die Anwendung zu ermöglichen.

Sendeleistung dieses Knotens anzeigen oder ändern

Verwendung:

• get tx
• set tx <dbm>

Parameter:

• dbm : Leistungspegel in dBm (1-22)

Wird durch Build-Flag gesetzt: LORA_TX_POWER

Standard: Variiert je nach Board

Hinweis: Diese Einstellung steuert lediglich die Sendeleistung des LoRa-Chips. Einige Knoten verfügen über eine zusätzliche Leistungsverstärkerstufe, die die Gesamtausgangsleistung erhöht. Die korrekte Einstellung finden Sie im Handbuch des jeweiligen Knotens. Ein zu hoher Wert kann gegen geltendes Recht in Ihrem Land verstoßen.

Ändern Sie die Funkparameter für eine festgelegte Dauer

Verwendung:

• tempradio <freq>,<bw>,<sf>,<cr>,<timeout_mins>

Parameter:

• freq : Frequenz in MHz
• bw : Bandbreite in kHz
• sf : Spreizfaktor (5-12)
• cr : Kodierungsrate (5-8)
• timeout_mins : Dauer in Minuten (muss > 0 sein)

Hinweis: Diese Einstellung wird nicht gespeichert und geht beim Neustart verloren.

Frequenz dieses Knotens anzeigen oder ändern

Verwendung:

• get freq
• set freq <frequency>

Parameter:

• frequency : Frequenz in MHz

Standard: 869.525

Hinweis: Ein Neustart ist erforderlich, um die Anwendung zu ermöglichen.

Den „rx boosted gain“-Modus dieses Knotens anzeigen oder ändern (SX12xx und LR1110, v1.14.1+)

Verwendung:

• get radio.rxgain
• set radio.rxgain <state>

Parameter:

• Zustand: on|off

Standard: on

Vorläufiger Hinweis: Wenn Sie von einer älteren Version auf 1.14.1 aktualisiert haben, ohne den Flash-Speicher zu löschen, ist diese Einstellung deaktiviert, da #2118

Den Verstärkungsstatus des LoRa-FEM-Empfangspfads auf unterstützten Boards anzeigen oder ändern

Verwendung:

• get radio.fem.rxgain
• set radio.fem.rxgain <state>

Parameter:

• Zustand: on|off

Hinweis:

• Hiermit wird der externe LNA des LoRa-FEM-Empfangspfads gesteuert, sofern die Platine dies unterstützt.
• Dies ist unabhängig von radio.rxgain, das den Empfangsverstärkungsmodus des Funkchips steuert.

Den Status der LoRa-FEM-Sendepfadverstärkung auf unterstützten Boards anzeigen oder ändern

Verwendung:

• get radio.fem.txgain
• set radio.fem.txgain <state>

Parameter:

• Zustand: on|off

Hinweis:

• Hiermit wird die softwaregesteuerte Sendeleistung des externen LoRa-FEM geregelt, sofern die Platine dies unterstützt.
• Entfernen Sie an Station G3 den PA-PL1-Jumper, um die Softwaresteuerung zu ermöglichen. In der Position on wird PA PL1 auf „High/Short“ gesetzt, in der Position off auf „Low/Open“. Der PA-PL2-Hardware-Jumper legt fest, ob dabei zwischen den Leistungsstufen 1/3 oder 2/4 umgeschaltet wird.
• Wählen Sie eine Betriebsebene und eine Sendeleistung des SX1262 aus, die den örtlichen HF-Grenzwerten und den Anforderungen an die Stromversorgung der Station G3 entsprechen.
• Die Einstellung wird sofort gespeichert, aber auf Station G3 wird der Pegel erst zu Beginn der nächsten Übertragung auf die Hardware angewendet, sodass die Versorgungsspannung der Leistungsstufe während des Betriebs der Leistungsstufe niemals neu eingestellt wird. get meldet den konfigurierten Zustand, der möglicherweise bis zur nächsten Übertragung des Knotens für die Hardware maßgeblich ist.

Diesen Knotennamen anzeigen oder ändern

Verwendung:

• get name
• set name <name>

Parameter:

• name : Knotenname

Wird durch Build-Flag gesetzt: ADVERT_NAME

Standard: Variiert je nach Board

Hinweis: Die maximale Länge variiert. Bei Angabe eines Speicherorts beträgt die maximale Länge 24 Byte, andernfalls 32 Byte. Emoji- und Unicode-Zeichen können mehr als ein Byte belegen.

Breitengrad dieses Knotens anzeigen oder ändern

Verwendung:

• get lat
• set lat <degrees>

Parameter:

• degrees : Breitengrad in Grad

Wird durch Build-Flag gesetzt: ADVERT_LAT

Standard: 0

Längengrad dieses Knotens anzeigen oder ändern

Verwendung:

• get lon
• set lon <degrees>

Parameter:

• degrees : Längengrad in Grad

Wird durch Build-Flag gesetzt: ADVERT_LON

Standard: 0

Die Identität dieses Knotens (Privater Schlüssel) anzeigen oder ändern

Verwendung:

• get prv.key
• set prv.key <private_key>

Parameter:

• private_key : Privater Schlüssel im Hexadezimalformat (64 Hexadezimalzeichen)

Serial Only:

• get prv.key : Ja
• set prv.key : Nein

Hinweis: Ein Neustart ist erforderlich, damit die Einstellung wirksam wird.

Ändern Sie das Administratorpasswort dieses Knotens.

Verwendung:

• password <password>

Parameter:

• password : Administratorpasswort

Wird durch Build-Flag gesetzt: ADMIN_PASSWORD

Standard: password

Hinweis: Zur Bestätigung zurückgesendet.

Hinweis: Jeder Knoten, der dieses Passwort verwendet, wird der Admin-ACL-Liste hinzugefügt.

Gastpasswort für diesen Knoten anzeigen oder ändern.

Verwendung:

• get guest.password
• set guest.password <password>

Parameter:

• password : Gastpasswort

Wird durch Build-Flag gesetzt: ROOM_PASSWORD (Nur für den Raumserver)

Standard: <blank> also leer

Eigentümerinformationen dieses Knotens anzeigen oder ändern

Verwendung:

• get owner.info
• set owner.info <text>

Parameter:

• text : Eigentümerinformationstext

Standard: <blank> also leer

Hinweis: | Zeichen werden in Zeilenumbrüche umgewandelt.

Hinweis: Erfordert Firmware 1.12 oder höher.

Feinabstimmung der Batterieanzeige

Verwendung:

• get adc.multiplier
• set adc.multiplier <value>

Parameter:

• value : ADC-Multiplikator (0,0-10,0)

Standard: 0.0 (vom Board festgelegter Wert)

Hinweis: Gibt die Fehlermeldung „Fehler: Von diesem Board nicht unterstützt“ zurück, wenn die Hardware dies nicht unterstützt.

Den öffentlichen Schlüssel dieses Knotens anzeigen

Verwendung: get public.key

Firmware-Version dieses Knotens anzeigen

Verwendung: ver

Die für diesen Knoten konfigurierte Rolle anzeigen

Verwendung: get role

Energiesparstatus dieses Knotens anzeigen oder ändern (nur Repeater)

Verwendung:

• powersaving
• powersaving on
• powersaving off

Parameter:

• on: Energiesparmodus aktivieren
• off: Energiesparmodus deaktivieren

Standard: off

Hinweis: Wenn diese Option aktiviert ist, wechselt das Gerät zwischen den Funkübertragungen in den Schlafmodus.

Wiederholungsflag dieses Knotens anzeigen oder ändern.

Verwendung:

• get repeat
• set repeat <state>

Parameter:

• state : on | off

Standard: on

Hash-Größe des Anzeigenpfads dieses Knotens anzeigen oder ändern

Verwendung:

• get path.hash.mode
• set path.hash.mode <value>

Parameter:

• value: Größe des Pfad-Hashes (0–2)
  • 0: Hash-Größe von 1 Byte (256 eindeutige IDs) [maximal 64 Floods]
  • 1: 2-Byte-Hash-Größe (65.536 eindeutige IDs) [maximal 32 Floods]
  • 2: Hash-Größe von 3 Byte (16.777.216 eindeutige IDs) [maximal 21 Floods]
  • 3: NICHT VERWENDEN (Reserviert)

Standard: 0

Hinweis: Die Einstellung „path.hash.mode“ legt die Größe der Low-Level-ID-/Hash-Kodierung fest, die verwendet wird, wenn der Repeater ein Signal sendet. Diese Einstellung hat keinen Einfluss darauf, welche Paket-ID-/Hash-Größe dieser Repeater weiterleitet; ab Firmware-Version 1.14 sollten alle Größen weitergeleitet werden. Diese Funktion wurde in der Firmware-Version 1.14 hinzugefügt.

Vorläufiger Hinweis: Bei Anzeigen mit ID-/Hash-Größen von 2 oder 3 Byte kann die Ausbreitung von Floods in Ihrem Netzwerk eingeschränkt sein, da diese Funktion erst seit der Firmware-Version 1.13.0 verfügbar ist und ältere Versionen Pakete mit mehr als einem Byte langen Pfad-IDs/Hashes verwerfen, da nur 1-Byte-Hashes unterstützt werden. Bitte stellen Sie sicher, dass der Großteil Ihrer Geräte mit einer Firmware-Version von mindestens 1.14 ausgestattet ist, bevor Sie größere ID-/Hash-Größen implementieren, um eine effektive Netzwerk-Flooding-Funktion zu gewährleisten.

Schleifenerkennung dieses Knotens anzeigen oder ändern

Verwendung:

• get loop.detect
• set loop.detect <state>

Parameter:

• state:
  • off: Es wird keine Schleifenerkennung durchgeführt
  • minimal: Pakete werden verworfen, wenn die ID/der Hash des Repeaters viermal oder öfter (1 Byte), zweimal oder öfter (2 Byte) bzw. einmal oder öfter (3 Byte) vorkommt
  • moderate: Pakete werden verworfen, wenn die ID/der Hash des Repeaters zwei- oder öfter (1 Byte), ein- oder öfter (2 Byte) bzw. ein- oder öfter (3 Byte) vorkommt
  • strict: Pakete werden verworfen, wenn die ID/der Hash des Repeaters ein- oder mehrmals (1 Byte), ein- oder mehrmals (2 Byte) bzw. ein- oder mehrmals (3 Byte) vorkommt

Standard: off

Hinweis: Wenn diese Funktion aktiviert ist, weisen Repeater nun Flood-Pakete zurück, die den Anschein erwecken, als befänden sie sich in einer Schleife. Dies ist in letzter Zeit in einigen Mesh-Netzwerken aufgetreten, wenn nur eine einzige „fehlerhafte“ Repeater-Firmware im Umlauf war (wahrscheinlich eine abgezweigte oder benutzerdefinierte Firmware). Wenn die Nutzdaten manipuliert und dann weitergeleitet werden, verursacht dasselbe Paket einen Paketsturm, der bis zu maximal 64 Hops wiederholt wird. Diese Funktion wurde in Firmware 1.14 hinzugefügt.

Beispiel: Wenn die Einstellung „loop.detect“ auf „minimal“ gesetzt ist und ein Paket mit einer Pfadgröße von 1 Byte empfangen wird, prüft der Repeater, ob seine eigene ID/sein eigener Hash bereits im Pfad enthalten ist. Ist dieser bereits viermal kodiert, lehnt er das Paket ab. Verwendet das Paket eine Pfadgröße von 2 Byte und ist die eigene ID/der eigene Hash des Repeaters bereits zweimal kodiert, lehnt er es ab. Wenn das Paket eine Pfadgröße von 3 Byte verwendet und die eigene ID/der eigene Hash des Repeaters bereits einmal codiert wurde, lehnt er es ab.

Den Wiederholungsverzögerungsfaktor anzeigen oder ändern für flood Datenverkehr

Verwendung:

• get txdelay
• set txdelay <value>

Parameter:

• value : Übertragungsverzögerungsfaktor (0-2)

Standard: 0.5

Anzeigen oder Ändern des Wiederholungsverzögerungsfaktors für direkten Datenverkehr

Verwendung:

• get direct.txdelay
• set direct.txdelay <value>

Parameter:

• value : Direkte Übertragungsverzögerungsfaktor (0-2)

Standard: 0.2

[Experimentell] Anzeigen oder Ändern der Verarbeitungsverzögerung für empfangenen Datenverkehr

Verwendung:

• get rxdelay
• set rxdelay <value>

Parameter:

• value : Empfangsverzögerungsbasis (0-20)

Standard: 0.0

Die Begrenzung des Arbeitszyklus anzeigen oder ändern

Verwendung:

• get dutycycle
• set dutycycle <value>

Parameter:

• value: Einschaltdauer in Prozent (1–100)

Standard: 50% (entspricht einem Sendezeitfaktor von 1,0)

Beispiele:

• set dutycycle 100 - keine Begrenzung des Arbeitszyklus
• set dutycycle 50 - 50 % Einschaltdauer (Standard)
• set dutycycle 10 - 10 % Einschaltdauer
• set dutycycle 1 - 1 % Einschaltdauer (strengste EU-Anforderung)

Hinweis: In Firmware-Version 1.15.0 hinzugefügt

Seit Firmware-Version 1.15.0 veraltet. Verwenden Sie stattdessen get/set dutycycle.

Anzeigen oder Ändern des Sendezeitfaktor (Arbeitszyklusgrenze)

Verwendung:

• get af
• set af <value>

Parameter:

• value : Sendezeitfaktor (0-9)

Standard: 1.0 (WICHTIG: Für Deutschland bitte Air‐Time und Duty Cycle schauen.)

Lokale Interferenzschwelle anzeigen oder ändern

Verwendung:

• get int.thresh
• set int.thresh <value>

Parameter:

• value : Interferenzschwellenwert

Standard: 0.0

Hardware-Kanalaktivitätserkennung (CAD) aktivieren oder deaktivieren

Verwendung:

• get cad
• set cad <on|off>

Beschreibung: Wenn diese Option aktiviert ist, führt das Funkmodul vor der Übertragung einen Hardware-Scan zur Erkennung von Kanalaktivität durch und wartet, falls der Kanal belegt ist. Die Funktion läuft unabhängig von int.thresh – entweder kann eine der beiden Optionen aktiv sein, beide oder keine.

Parameter:

• on|off: Hardware-CAD aktivieren oder deaktivieren

Standard: off

AGC-Rücksetzintervall anzeigen oder ändern

Verwendung:

• get agc.reset.interval
• set agc.reset.interval <value>

Parameter:

• value : Intervall in Sekunden, abgerundet auf ein Vielfaches von 4 (17 wird zu 16)

Standard: 0.0

Multi-Acks-Unterstützung aktivieren oder deaktivieren

Verwendung:

• get multi.acks
• set multi.acks <state>

Parameter:

• state : 0 (deaktivieren) oder 1 (aktivieren)

Standard: 0

flood advert intervall anzeigen oder ändern

Verwendung:

• get flood.advert.interval
• set flood.advert.interval <hours>

Parameter:

• hours : Intervall in Stunden (3–168)

Standard: 12 (Repeater) - 0 (Sensor)

zero-hop advert intervall anzeigen oder ändern

Verwendung:

• get advert.interval
• set advert.interval <minutes>

Parameter:

• minutes : Intervall in Minuten, abgerundet auf das nächste Vielfache von 2 (61 wird zu 60) (60–240)

Standard: 0

Begrenzen Sie die Anzahl der Hops für eine Flood-Nachricht.

Verwendung:

• get flood.max
• set flood.max <value>

Parameter:

• value : Maximale Flood-Hop-Anzahl (0-64)

Standard: 64

Die Anzahl der Hops für eine Flood-Nachricht ohne Gültigkeitsbereich begrenzen

Verwendung:

• get flood.max.unscoped
• set flood.max.unscoped <value>

Parameter:

• value: Maximale Anzahl von Flood-Hops (0–64) für ein Paket ohne Geltungsbereich (keine Region festgelegt)

Standard: 64 – (0xFF bedeutet, dass der Wert noch nicht gesetzt wurde; „flood.max“ wird so lange verfolgt, bis er gesetzt ist.)

Hinweis: Als Alternative zu region denyf * würde die Einstellung von flood.max.unscoped auf einen niedrigeren Wert, beispielsweise 3, die Weiterleitung lokaler, nicht in einen Bereich eingebundener Nachrichten ermöglichen und gleichzeitig verhindern, dass „Noisy Neighbors“ eine lokale Region mit Daten überfluten.

Die Anzahl der Hops für eine Advert-Flood-Nachricht begrenzen

Verwendung:

• get flood.max.advert
• set flood.max.advert <value>

Parameter:

• value: Maximale Anzahl von Flood-Hops (0–64) für ein Advert-Paket

Standard: 8

Berechtigungen für einen companion hinzufügen, aktualisieren oder entfernen

Verwendung:

• setperm <pubkey> <permissions>

Parameter:

• pubkey : Companion öffentlicher Schlüssel
• permissions :
  • 0 : Gast
  • 1 : Nur-Lesen
  • 2 : Lesen/Schreiben
  • 3 : Admin

Hinweis: Entfernt den Eintrag, wenn die permissions weggelassen werden.

Aktuelle ACL anzeigen

Verwendung:

• get acl

Nur seriell: Ja

Die „Nur-Lesen“-Kennzeichnung dieses Raumservers anzeigen oder ändern

Verwendung:

• get allow.read.only
• set allow.read.only <state>

Parameter:

• state : on (aktivieren) oder off (deaktivieren)

Standard: off

Regionslisten in großen Mengen laden

Verwendung:

• region load
• region load <name> [flood_flag]

Parameter:

• name : Der Name einer Region. * stellt die Wildcard-Region dar

Hinweis: flood_flag : Optionales F, um flooding zuzulassen.

Hinweis: Einrückungen schaffen Eltern-Kind-Beziehungen (max. 8 Ebenen).

Hinweis: region load mit einem leeren Namen funktioniert nicht aus der Ferne (es ist interaktiv)

Speichern Sie alle seit dem Neustart vorgenommenen Änderungen an Regionen.

Verwendung:

• region save

Allow a region

Verwendung:

• region allowf <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Hinweis: Hinweis: Die Einstellung mit dem Wildcard * lässt Pakete ohne Regions-Transportcodes zu.

Eine Region blockieren

Verwendung:

• region denyf <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Hinweis: Die Einstellung auf Wildcard * verwirft Pakete ohne Regions-Transportcodes.

Informationen für eine Region anzeigen

Verwendung:

• region get <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Die Heimatregion für diesen Knoten anzeigen oder ändern

Verwendung:

• region home
• region home <name>

Parameter:

• name : Der Name einer Region.

Den Standard-Gültigkeitsbereich für diesen Knoten anzeigen oder ändern

Verwendung:

• region default
• region default {name|<null>}

Parameter:

• name: Name der Region oder zum Zurücksetzen/Löschen

Neue Region erstellen

Verwendung:

• region put <name> [parent_name]

Parameter:

• name : Der Name einer Region.
• parent_name : Name der übergeordneten Region (optional, Standardwert ist Platzhalter)

Regionshierarchie definieren (einzeilig)

Verwendung:

• region def <token> [<token> …]

Parameter (tokens): Durch Leerzeichen getrennt. Ein logischer Cursor beginnt mit dem Platzhalter *.

• name — Erstellt name als untergeordnetes Element des aktuellen Cursors (entspricht dem Befehl region put name, wobei der Cursor als übergeordnetes Element dient). Der Cursor springt zu name.
• name|jump (oder name,jump) — Erstellt name als Unterelement des aktuellen Cursors und verschiebt den Cursor anschließend zu jump (das bereits auf dem Knoten vorhanden sein oder zuvor in diesem Befehl erstellt worden sein muss). jump ist nicht das übergeordnete Element von name; verwende diese Form, um wieder nach oben zu springen und einen neuen Zweig zu beginnen.

Verhalten: Jede erstellte Region ist standardmäßig auf „Flood-allowed“ gesetzt (genau wie bei region put). Die Rückgabe ist der resultierende Regionsbaum (im gleichen Format wie bei einer einfachen region); überprüfen Sie diesen, bevor Sie region save ausführen, um die Änderungen zu speichern. Im Fehlerfall lautet die Rückgabe Err - …, und alle vor dem Fehler platzierten Regionen verbleiben auf dem Knoten, genau wie bei einer unvollständigen Kette von region put-Aufrufen.

Vorhandene Regionen: Mit region def wird die vorhandene Baumstruktur nicht gelöscht – wenn ein Name bereits vorhanden ist, wird dessen übergeordneter Eintrag auf den aktuellen Cursor aktualisiert; andernfalls wird eine neue Region erstellt. Um ganz von vorne zu beginnen, entfernen Sie zunächst die unerwünschten Regionen mit region remove.

Einschränkungen: Der serielle Repeater akzeptiert eine Zeile mit bis zu 160 Zeichen. Bei größeren Baumstrukturen sollten Sie den Befehl region def auf mehrere Zeilen aufteilen; der Cursor springt zwischen den Befehlen zurück auf *, daher sollten Sie den nächsten Befehl mit child|ancestor einleiten, um die Position anzupassen. Jedes Token wird höchstens einmal an der Stelle | geteilt – region def a|b|c|d ist keine Kurzschreibweise für eine flache Liste; siehe das Beispiel für eine flache Liste weiter unten.

Beispiel – lineare Kette (jedes Element wird zum untergeordneten Element des vorherigen):

region def a b c d e
region save

Beispiel – verzweigter Baum (entspricht region put a, region put b a, region put c b, region put d c, region put e b, region put f e):

region def a b c d|b e f
region save

Beispiel – Fehler und Teilzustand:

region def a b c|nope d

Die Antwort lautet Err – unbekannter Sprung: nein. a, b und c wurden vor dem Fehler platziert; d hingegen nicht. Führen Sie region aus, um ihn zu überprüfen, und führen Sie ihn anschließend mit einem korrigierten Sprung erneut aus oder beheben Sie den Fehler mit region remove bzw. region put.

Beispiel – flache Liste (jeder Bereich ist ein untergeordneter Bereich von *). Verwenden Sie nach jedem Token |*, um den Cursor vor dem nächsten Token wieder an die Wurzel zurückzusetzen:

region def a|* b|* c|* d|* e|* f
region save

Region entfernen

Verwendung:

• region remove <name>

Parameter:

• name : Der Name einer Region (oder * für Wildcard)

Hinweis: Alle untergeordneten Regionen müssen entfernt werden, bevor die Region entfernt werden kann.

Alle Regionen anzeigen

Verwendung:

• region list <filter>

Nur seriell: Ja

Parameter:

• filter : allowed | denied

Hinweis: Erfordert Firmware 1.12.+

Alle definierten Regionen und flood Berechtigungen löschen

Verwendung:

• region

Nur seriell: Für Firmware älter als 1.12.0

Beispiel 1: Verwendung des F-Flags mit benannter öffentlicher Region

region load
#Europe F
<blank line to end region load>
region save

Erklärung:

• Erstellt eine Region namens #Europe mit aktiviertem flooding.
• Pakete aus dieser Region werden an andere Knoten weitergeleitet.

Beispiel 2: Verwendung von Wildcard mit dem F-Flag

region load 
* F
<blank line to end region load>
region save

Erklärung:

• Erstellt eine Wildcard-Region * mit aktiviertem flooding
• Aktiviert flooding automatisch für alle Regionen.
• Gilt nur für Pakete ohne Transportcodes.

Beispiel 3: Verwendung von Wildcard ohne F-Flag

region load 
*
<blank line to end region load>
region save

Erklärung:

• Erstellt eine Wildcard-Region * ohne flooding.
• Diese Region existiert, hat jedoch keinen Einfluss auf die Paketverteilung.
• Wird als Standard-/leere Region verwendet.

Beispiel 4: Verschachtelte öffentliche Region mit dem F-Flag

region load 
#Europe F
  #UK
    #London
    #Manchester
  #France
    #Paris
    #Lyon
<blank line to end region load>
region save

Erläuterung:

• Erstellt die Region #Europe mit aktivierter Überschwemmungsfunktion
• Fügt verschachtelte untergeordnete Regionen hinzu (#UK, #France)
• Alle verschachtelten Regionen erben das „Flooding“-Flag von der übergeordneten Region.

Beispiel 5: Platzhalter mit verschachtelten öffentlichen Regionen

region load 
* F
  #NorthAmerica
    #USA
      #NewYork
      #California
    #Canada
      #Ontario
      #Quebec
<blank line to end region load>
region save

Erläuterung:

• Erstellt eine Wildcard-Region * mit aktivierter Flutung
• Fügt eine verschachtelte #NorthAmerica-Hierarchie hinzu
• Aktiviert automatisch das Flooding für alle untergeordneten Regionen
• Nützlich für globale Netzwerke mit spezifischen regionalen Vorschriften

View or change GPS state

Verwendung:

• gps
• gps <state>

Parameter:

• state : on | off

Standard: off

Hinweis: Ausgabeformat:

• off wenn die GPS-Hardware deaktiviert ist
• on, {active|deactivated}, {fix|no fix}, {sat count} sats wenn die GPS-Hardware aktiviert ist

Synchronisieren Sie die Uhr dieses Knotens mit der GPS-Zeit.

Verwendung:

• gps sync

Legen Sie den Standort dieses Knotens anhand der GPS-Koordinaten fest.

Verwendung:

• gps setloc

GPS advert policy anzeigen oder ändern

Verwendung:

• gps advert
• gps advert <policy>

Parameter:

• policy : none | shared | prefs
  • none : Geben Sie den Standort nicht in adverts an.
  • shared : GPS-Standort teilen (von SensorManager)
  • prefs : Standort, gespeichert in den Lat- und Lon-Einstellungen des Knotens

Standard: prefs

Liste der Sensoren auf diesem Knoten anzeigen

Verwendung:

• sensor list [start]

Parameter:

• start : Optionaler Startindex (Standardwert ist 0)

Hinweis: Ausgabeformat: <var_name>=<value>\n

Den Wert eines Sensors anzeigen oder ändern

Verwendung:

• sensor get <key>
• sensor set <key> <value>

Parameter:

• key : Name der Sensoreinstellung
• value : Der Wert, auf den der Sensor eingestellt werden soll

Den zusammengestellten Brückentyp anzeigen

Verwendung: get bridge.type

Anzeigen oder Ändern des Flags „Bridge aktiviert“

Verwendung:

• get bridge.enabled
• set bridge.enabled <state>

Parameter:

• state : on | off

Standard: off

Brückenquelle anzeigen

Verwendung:

• get bridge.source

Fügen Sie eine Verzögerung für Pakete hinzu, die über diese Bridge weitergeleitet werden.

Verwendung:

• get bridge.delay
• set bridge.delay <ms>

Parameter:

• ms : Verzögerung in Millisekunden (0–10000)

Standard: 500

Anzeigen oder Ändern der Quelle von Paketen, die zur externen Schnittstelle gebrückt werden

Verwendung:

• get bridge.source
• set bridge.source <source>

Parameter:

• source :
  • rx : Brücken haben Pakete empfangen
  • tx : Brücken übertragene Pakete

Standard: tx

Anzeigen oder Ändern der Geschwindigkeit der Brücke (nur RS-232)

Verwendung:

• get bridge.baud
• set bridge.baud <rate>

Parameter:

• rate : Baudrate (9600, 19200, 38400, 57600, or 115200)

Standard: 115200

Den für die Überbrückung verwendeten Kanal anzeigen oder ändern (nur ESPNow)

Verwendung:

• get bridge.channel
• set bridge.channel <channel>

Parameter:

• channel : Kanalnummer (1-14)

ESP-Now-Geheimnis festlegen

Verwendung:

• get bridge.secret
• set bridge.secret <secret>

Parameter:

• secret : 16-stelliger Verschlüsselungscode

Standard: Variiert je nach Board

Holen Sie sich die Bootloader Version (nur nRF52)

Verwendung: get bootloader.ver

Unterstützte Energieverwaltungsfunktionen anzeigen

Verwendung: get pwrmgt.support

Aktuelle Stromquelle anzeigen

Verwendung: get pwrmgt.source

Hinweis: Auf Boards ohne Unterstützung für die Energieverwaltung wird ein Fehler zurückgegeben.

Gründe für Neustart und Herunterfahren anzeigen

Verwendung: get pwrmgt.bootreason

Hinweis: Auf Boards ohne Unterstützung für die Energieverwaltung wird ein Fehler zurückgegeben.

Boot-Spannung anzeigen

Verwendung: get pwrmgt.bootmv

Hinweis: Auf Boards ohne Unterstützung für die Energieverwaltung wird ein Fehler zurückgegeben.

Die Ethernet-Unterstützung ist auf RAK4631-Boards mit einem RAK13800 (W5100S)-Ethernet-Modul verfügbar. Verwenden Sie die _ethernet-Firmware-Varianten (z. B. RAK_4631_repeater_ethernet), um diese Funktion zu aktivieren.

Ethernet-Verbindungsstatus anzeigen

Verwendung:

• eth.status

Ausgabe:

• ETH: <ip>:<port> bei bestehender Verbindung (z. B. ETH: 192.168.1.50:23)
• ETH: not connected wenn Ethernet nicht aktiv ist

Hinweis:

• Nur in der Firmware von Repeatern und Raumservern verfügbar. Die Firmware des Companion-Funkmoduls mit Ethernet-Unterstützung stellt keine CLI bereit.
• Die Ethernet-Schnittstelle bezieht beim Systemstart automatisch eine IP-Adresse über DHCP.
• Ein TCP-Server wartet auf Port 23 (Standard) auf CLI-Verbindungen.
• Stellen Sie mit einem beliebigen TCP-Client (z. B. nc, PuTTY) eine Verbindung her, um auf dieselbe CLI zuzugreifen, die auch über die serielle Schnittstelle verfügbar ist.

Quelle