EN

CLI-Befehle

CLI-Befehle

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

- Funk (Radio) - System - Routing - ACL - Regionsverwaltung - Regionsbeispiele - GPS - Sensoren - Bridge

---

Betrieb

Knoten neu starten

Verwendung:
  • reboot
Hinweis: Es wird keine Antwort gesendet.

---

Knoten ausschalten

Verwendung:
  • poweroff, oder
  • shutdown
Hinweis: Es wird keine Antwort gesendet.

---

Uhr zurücksetzen und neu starten

Verwendung:
  • clkreboot
Hinweis: Es wird keine Antwort gesendet.

---

Uhr mit dem entfernten Gerät synchronisieren

Verwendung:
  • clock sync
---

Aktuelle Uhrzeit in UTC anzeigen

Verwendung:
  • clock
---

Zeit auf einen bestimmten Zeitstempel setzen

Verwendung:
  • time
Parameter:
  • epoch_seconds: Unix-Epoch-Zeit (Sekunden seit dem 1. Jänner 1970)
---

Flood-Advert senden

Verwendung:
  • advert
---

Zero-Hop-Advert senden

Verwendung:
  • advert.zerohop
---

Over-The-Air-(OTA-)Firmware-Update starten

Verwendung:
  • start ota
---

Löschen / Werksreset

Verwendung:
  • erase
Nur über Serial: Ja Warnung: _Dies ist eine destruktive Aktion!_

---

Nachbarn (nur Repeater)

Benachbarte Knoten auflisten

Verwendung:
  • neighbors
Hinweis: Die Ausgabe dieses Befehls ist auf die 8 jüngsten Adverts beschränkt. Hinweis: Jede Zeile ist als {pubkey-prefix}:{timestamp}:{snr*4} codiert.

---

Einen Nachbarn entfernen

Verwendung:
  • neighbor.remove
Parameter:
  • pubkey_prefix: Der öffentliche Schlüssel des Knotens, der aus der Nachbarliste entfernt werden soll. Dies kann ein kurzes Präfix oder der vollständige Schlüssel sein. Alle Nachbarn, die zum angegebenen Präfix passen, 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 auf alle vorhandenen Nachbarn passt.

---

Zero-Hop-Nachbarn entdecken

Verwendung:
  • discover.neighbors
---

Statistik

Statistik zurücksetzen

Verwendung: clear stats

---

System-Statistik – Akku, Laufzeit, Warteschlangenlänge und Debug-Flags

Verwendung:
  • stats-core
Nur über Serial: Ja

---

Funk-Statistik – Rauschpegel, letzter RSSI/SNR, Airtime, Empfangsfehler

Verwendung: stats-radio Nur über Serial: Ja

---

Paket-Statistik – Paketzähler: Empfangen, Gesendet

Verwendung: stats-packets Nur über Serial: Ja

---

Protokollierung

Aufzeichnung des Empfangsprotokolls (rx-Log) im Knotenspeicher starten

Verwendung: log start

---

Aufzeichnung des Empfangsprotokolls (rx-Log) im Knotenspeicher beenden

Verwendung: log stop

---

Aufgezeichnetes Protokoll löschen

Verwendung: log erase

---

Aufgezeichnetes Protokoll im Serial-Terminal ausgeben

Verwendung: log Nur über Serial: Ja

---

Informationen

Version abrufen

Verwendung: ver

---

Hardware-Namen anzeigen

Verwendung: board

---

Konfiguration

Funk (Radio)

Funk-Parameter dieses Knotens anzeigen oder ändern

Verwendung:
  • get radio
  • set radio ,,,
Parameter:
  • freq: Frequenz in MHz
  • bw: Bandbreite in kHz
  • sf: Spreading Factor / Spreizfaktor (5-12)
  • cr: Coding Rate / Coderate (5-8)
Festgelegt durch Build-Flag: LORA_FREQ, LORA_BW, LORA_SF, LORA_CR Standard: 869.525,250,11,5 Hinweis: Erfordert einen Neustart, damit die Änderung wirksam wird.

---

Sendeleistung dieses Knotens anzeigen oder ändern

Verwendung:
  • get tx
  • set tx
Parameter:
  • dbm: Leistungspegel in dBm (1-22)
Festgelegt durch Build-Flag: LORA_TX_POWER Standard: Variiert je nach Board Hinweise: Diese Einstellung steuert nur den Leistungspegel des LoRa-Chips. Manche Knoten verfügen über eine zusätzliche Leistungsverstärkerstufe, die die Gesamtausgangsleistung erhöht. Sieh im Handbuch des Knotens nach, welcher Wert korrekt ist. Ein zu hoch eingestellter Wert kann gegen die gesetzlichen Vorschriften in deinem Land verstoßen.

---

Funk-Parameter für eine bestimmte Dauer ändern

Verwendung:
  • tempradio ,,,,
Parameter:
  • freq: Frequenz in MHz (300-2500)
  • bw: Bandbreite in kHz (7.8-500)
  • sf: Spreading Factor / Spreizfaktor (5-12)
  • cr: Coding Rate / Coderate (5-8)
  • timeout_mins: Dauer in Minuten (muss > 0 sein)
Hinweis: Diese Einstellung wird nicht in den Präferenzen gespeichert und beim Neustart wieder gelöscht.

---

Frequenz dieses Knotens anzeigen oder ändern

Verwendung:
  • get freq
  • set freq
Parameter:
  • frequency: Frequenz in MHz
Standard: 869.525 Hinweis: Erfordert einen Neustart, damit die Änderung wirksam wird. Nur über Serial: set freq

---

Modus „Boosted Gain“ für den Empfang dieses Knotens anzeigen oder ändern (SX12xx und LR1110, ab v1.14.1)

Verwendung:
  • get radio.rxgain
  • set radio.rxgain
Parameter: - state: on|off Standard: on Temporärer Hinweis: Wenn du von einer älteren Version auf 1.14.1 aktualisiert hast, ohne den Flash-Speicher zu löschen, ist diese Einstellung aufgrund von #2118 auf off.

---

System

Namen dieses Knotens anzeigen oder ändern

Verwendung:
  • get name
  • set name
Parameter:
  • name: Knotenname
Festgelegt durch Build-Flag: ADVERT_NAME Standard: Variiert je nach Board Hinweis: Die maximale Länge variiert. Wenn ein Standort festgelegt ist, beträgt die maximale Länge 24 Byte, andernfalls 32. Emojis und Unicode-Zeichen können mehr als ein Byte belegen.

---

Breitengrad dieses Knotens anzeigen oder ändern

Verwendung:
  • get lat
  • set lat
Festgelegt durch Build-Flag: ADVERT_LAT Standard: 0 Parameter:
  • degrees: Breitengrad in Grad
---

Längengrad dieses Knotens anzeigen oder ändern

Verwendung:
  • get lon
  • set lon
Festgelegt durch Build-Flag: ADVERT_LON Standard: 0 Parameter:
  • degrees: Längengrad in Grad
---

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

Verwendung:
  • get prv.key
  • set prv.key
Parameter:
  • private_key: Privater Schlüssel im Hex-Format (64 Hex-Zeichen)
Nur über Serial:
  • get prv.key: Ja
  • set prv.key: Nein
Hinweis: Erfordert nach dem Setzen einen Neustart, damit die Änderung wirksam wird.

---

Admin-Passwort dieses Knotens ändern

Verwendung:
  • password
Parameter:
  • new_password: Neues Admin-Passwort
Festgelegt durch Build-Flag: ADMIN_PASSWORD Standard: password Hinweis: Die Antwort auf den Befehl gibt zur Bestätigung das aktualisierte Passwort zurück. Hinweis: Jeder Knoten, der dieses Passwort verwendet, wird der Admin-ACL-Liste hinzugefügt.

---

Gast-Passwort dieses Knotens anzeigen oder ändern

Verwendung:
  • get guest.password
  • set guest.password
Parameter:
  • password: Gast-Passwort
Festgelegt durch Build-Flag: ROOM_PASSWORD (nur Room-Server) Standard:

---

Besitzerinformationen dieses Knotens anzeigen oder ändern

Verwendung:
  • get owner.info
  • set owner.info
Parameter:
  • text: Text mit Besitzerinformationen
Standard: Hinweis: |-Zeichen werden in Zeilenumbrüche umgewandelt. Hinweis: Erfordert Firmware 1.12 oder neuer.

---

Feinabstimmung der Akku-Messung

Verwendung:
  • get adc.multiplier
  • set adc.multiplier
Parameter:
  • value: ADC-Multiplikator (0.0-10.0)
Standard: 0.0 (Wert wird vom Board definiert) Hinweis: Gibt „Error: unsupported by this board“ zurück, wenn die Hardware dies nicht unterstützt.

---

Öffentlichen Schlüssel dieses Knotens anzeigen

Verwendung: get public.key

---

Firmware-Version dieses Knotens anzeigen

Verwendung: ver

---

Konfigurierte Rolle dieses Knotens anzeigen

Verwendung: get role

---

Energiespar-Flag dieses Knotens anzeigen oder ändern (nur Repeater)

Verwendung:
  • powersaving
  • powersaving on
  • powersaving off
Parameter:
  • on: Energiesparen aktivieren
  • off: Energiesparen deaktivieren
Standard: off Hinweis: Wenn aktiviert, wechselt das Gerät zwischen Funkübertragungen in den Ruhemodus.

---

Routing

Repeat-Flag dieses Knotens anzeigen oder ändern

Verwendung:
  • get repeat
  • set repeat
Parameter: - state: on|off Standard: on

---

Größe des Advert-Pfad-Hashs dieses Knotens anzeigen oder ändern

Verwendung:
  • get path.hash.mode
  • set path.hash.mode
Parameter:
  • value: Pfad-Hash-Größe (0-2)
- 0: 1 Byte Hash-Größe (256 eindeutige IDs) [max. 64 Flood] - 1: 2 Byte Hash-Größe (65.536 eindeutige IDs) [max. 32 Flood] - 2: 3 Byte Hash-Größe (16.777.216 eindeutige IDs) [max. 21 Flood] - 3: NICHT VERWENDEN (reserviert) Standard: 0 Hinweis: Mit path.hash.mode wird die Größe der Low-Level-ID-/Hash-Codierung festgelegt, die der Repeater bei Adverts verwendet. Diese Einstellung hat keinen Einfluss darauf, welche Paket-ID-/Hash-Größe dieser Repeater weiterleitet – ab Firmware >= 1.14 sollten alle Größen weitergeleitet werden. Diese Funktion wurde in Firmware 1.14 eingeführt. Temporärer Hinweis: Adverts mit ID-/Hash-Größen von 2 oder 3 Byte können in deinem Netzwerk nur eingeschränkt per Flood verbreitet werden, solange diese Funktion neu ist, da Firmware v1.13.0 und älter Pakete mit mehr-Byte-Pfad-IDs/-Hashes verwerfen, weil sie nur 1-Byte-Hashes unterstützen. Stelle sicher, dass in deinem Bestand genügend Knoten mit Firmware >= 1.14 vorhanden sind, um ein effektives Netzwerk-Flooding zu gewährleisten, bevor du höhere ID-/Hash-Größen einführst.

---

Schleifenerkennung (Loop Detection) dieses Knotens anzeigen oder ändern

Verwendung:
  • get loop.detect
  • set loop.detect
Parameter:
  • state:
- off: keine Schleifenerkennung - minimal: Pakete werden verworfen, wenn die ID/der Hash des Repeaters 4-mal oder öfter (1 Byte), 2-mal oder öfter (2 Byte) bzw. 1-mal oder öfter (3 Byte) erscheint - moderate: Pakete werden verworfen, wenn die ID/der Hash des Repeaters 2-mal oder öfter (1 Byte), 1-mal oder öfter (2 Byte) bzw. 1-mal oder öfter (3 Byte) erscheint - strict: Pakete werden verworfen, wenn die ID/der Hash des Repeaters 1-mal oder öfter (1 Byte), 1-mal oder öfter (2 Byte) bzw. 1-mal oder öfter (3 Byte) erscheint Standard: off Hinweis: Wenn aktiviert, lehnen Repeater Flood-Pakete ab, die so aussehen, als befänden sie sich in einer Schleife. Dies ist in letzter Zeit in einigen Meshes vorgekommen, wenn nur ein einziger „fehlerhafter“ Repeater mit problematischer Firmware vorhanden ist (vermutlich eine geforkte oder angepasste Firmware). Wenn die Nutzlast verändert und dann weitergeleitet wird, verursacht dasselbe Paket einen Paketsturm, der bis zur maximalen Anzahl von 64 Hops wiederholt wird. Diese Funktion wurde in Firmware 1.14 eingeführt. Beispiel: Wenn die Einstellung loop.detect minimal ist und ein Paket mit 1-Byte-Pfadgröße empfangen wird, prüft der Repeater, ob seine eigene ID/sein eigener Hash bereits im Pfad enthalten ist. Ist er bereits 4-mal codiert, wird das Paket abgelehnt. Verwendet das Paket eine 2-Byte-Pfadgröße und ist die eigene ID/der eigene Hash des Repeaters bereits 2-mal codiert, wird es abgelehnt. Verwendet das Paket eine 3-Byte-Pfadgröße und ist die eigene ID/der eigene Hash des Repeaters bereits 1-mal codiert, wird es abgelehnt.

---

Verzögerungsfaktor für die erneute Übertragung von Flood-Verkehr anzeigen oder ändern

Verwendung:
  • get txdelay
  • set txdelay
Parameter:
  • value: Verzögerungsfaktor für die Übertragung (0-2)
Standard: 0.5 Hinweis: Wenn mehrere benachbarte Repeater dasselbe Flood-Paket hören, wartet jeder eine zufällige Zeitspanne, bevor er es weiterleitet, um gleichzeitige Kollisionen zu vermeiden. Dieser Faktor skaliert die Größe des Zufallsfensters. Höhere Werte verringern das Kollisionsrisiko, erhöhen aber die Latenz. 0 deaktiviert das Fenster vollständig.

---

Verzögerungsfaktor für die erneute Übertragung von Direktverkehr anzeigen oder ändern

Verwendung:
  • get direct.txdelay
  • set direct.txdelay
Parameter:
  • value: Verzögerungsfaktor für die direkte Übertragung (0-2)
Standard: 0.2 Hinweis: Dasselbe Zufallsfenster zur Kollisionsvermeidung wie bei txdelay, jedoch angewendet auf direkten (nicht per Flood verbreiteten, geroutetem) Verkehr. Der Standardwert ist niedriger, weil Direktpakete an einen bestimmten nächsten Hop adressiert sind, sodass deutlich weniger Knoten um ihre Weiterleitung konkurrieren.

---

[Experimentell] Verarbeitungsverzögerung für empfangenen Verkehr anzeigen oder ändern

Verwendung:
  • get rxdelay
  • set rxdelay
Parameter:
  • value: Basis-Empfangsverzögerung (0-20)
Standard: 0.0 Hinweis: Wenn aktiviert, werden Repeater, die ein Flood-Paket mit schwachem Signal empfangen haben, vor der Verarbeitung in einer Verzögerungswarteschlange gehalten, während jene mit starkem Signal es sofort verarbeiten. Dadurch erhalten Pfade mit starkem Signal Vorrang bei der Weiterleitung. Bis Knoten mit schwachem Signal ihre Kopie verarbeiten, hat sich das Paket möglicherweise bereits verbreitet und wird als Duplikat unterdrückt, was redundante erneute Übertragungen reduziert.

---

Duty-Cycle-Limit anzeigen oder ändern

Verwendung:
  • get dutycycle
  • set dutycycle
Parameter:
  • value: Duty-Cycle-Prozentsatz (1-100)
Standard: 50% (entspricht dem Airtime-Faktor 1.0) Beispiele:
  • set dutycycle 100 — kein Duty-Cycle-Limit
  • set dutycycle 50 — 50 % Duty Cycle (Standard)
  • set dutycycle 10 — 10 % Duty Cycle
  • set dutycycle 1 — 1 % Duty Cycle (strengste EU-Anforderung)
Hinweis: In Firmware v1.15.0 hinzugefügt.

---

Airtime-Faktor (Duty-Cycle-Limit) anzeigen oder ändern

Veraltet ab Firmware v1.15.0. Verwende stattdessen get/set dutycycle.
Verwendung:
  • get af
  • set af
Parameter:
  • value: Airtime-Faktor (0-9). Nach jeder Übertragung erzwingt der Repeater eine Ruhephase von etwa der On-Air-Übertragungszeit multipliziert mit dem Wert. Dies ergibt einen langfristigen Duty Cycle von ungefähr 1 geteilt durch (1 plus den Wert). Zum Beispiel:
- af = 1 → ~50 % Duty - af = 2 → ~33 % Duty - af = 3 → ~25 % Duty - af = 9 → ~10 % Duty Du bist selbst dafür verantwortlich, einen Wert zu wählen, der für deine Rechtsordnung und deinen Kanalplan geeignet ist (zum Beispiel die 10-%-Duty-Cycle-Vorschrift im EU-868-MHz-Band). Standard: 1.0

---

Lokalen Interferenzschwellenwert anzeigen oder ändern

Verwendung:
  • get int.thresh
  • set int.thresh
Parameter:
  • value: Wert des Interferenzschwellenwerts
Standard: 0.0

---

AGC-Reset-Intervall anzeigen oder ändern

Verwendung:
  • get agc.reset.interval
  • set agc.reset.interval
Parameter:
  • value: Intervall in Sekunden, abgerundet auf ein Vielfaches von 4 (aus 17 wird 16). 0 zum Deaktivieren.
Standard: 0.0

---

Unterstützung für Multi-Acks aktivieren oder deaktivieren

Verwendung:
  • get multi.acks
  • set multi.acks
Parameter:
  • state: 0 (deaktivieren) oder 1 (aktivieren)
Standard: 0

---

Flood-Advert-Intervall anzeigen oder ändern

Verwendung:
  • get flood.advert.interval
  • set flood.advert.interval
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
Parameter:
  • minutes: Intervall in Minuten, abgerundet auf das nächste Vielfache von 2 (aus 61 wird 60) (60-240)
Standard: 0

---

Anzahl der Hops für eine Flood-Nachricht begrenzen

Verwendung:
  • get flood.max
  • set flood.max
Parameter:
  • value: Maximale Flood-Hop-Anzahl (0-64)
Standard: 64

---

Anzahl der Hops für eine Flood-Nachricht ohne Region (unscoped) begrenzen

Verwendung:
  • get flood.max.unscoped
  • set flood.max.unscoped
Parameter:
  • value: Maximale Flood-Hop-Anzahl (0-64) für ein Paket ohne Geltungsbereich (keine Region gesetzt)
Standard: 64 – (0xFF zeigt an, dass der Wert noch nicht gesetzt wurde; bis dahin folgt er flood.max.) Hinweis: Als Alternative zu region denyf * würde das Setzen von flood.max.unscoped auf einen niedrigeren Wert wie 3 lokalen, regionslosen Nachrichten die Verbreitung erlauben, während verhindert wird, dass „lärmende“ Nachbarn eine lokale Region fluten.

---

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

Verwendung:
  • get flood.max.advert
  • set flood.max.advert
Parameter:
  • value: Maximale Flood-Hop-Anzahl (0-64) für ein Advert-Paket
Standard: 8

---

ACL

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

Verwendung:
  • setperm
Parameter:
  • pubkey: Öffentlicher Schlüssel des Companions
  • permissions:
- 0: Gast - 1: Nur Lesen - 2: Lesen und Schreiben - 3: Admin Hinweis: Entfernt den Eintrag, wenn permissions weggelassen wird.

---

Aktuelle ACL anzeigen

Verwendung:
  • get acl
Nur über Serial: Ja

---

„Read-only“-Flag dieses Room-Servers anzeigen oder ändern

Verwendung:
  • get allow.read.only
  • set allow.read.only
Parameter:
  • state: on (aktivieren) oder off (deaktivieren)
Standard: off

---

Regionsverwaltung (ab v1.10)

Regionslisten als Block laden

Verwendung:
  • region load
  • region load [flood_flag]
Parameter:
  • name: Ein Name einer Region. * steht für die Platzhalter-Region (Wildcard)
Hinweis: flood_flag: Optionales F, um Flooding zu erlauben Hinweis: Einrückung erzeugt Eltern-Kind-Beziehungen (max. 8 Ebenen) Hinweis: region load mit leerem Namen funktioniert nicht aus der Ferne (es ist interaktiv)

---

Seit dem Neustart vorgenommene Änderungen an Regionen speichern

Verwendung:
  • region save
---

Eine Region erlauben

Verwendung:
  • region allowf
Parameter:
  • name: Regionsname (oder * für Wildcard)
Hinweis: Wird dies auf der Wildcard * gesetzt, sind Pakete ohne Regions-Transportcodes erlaubt.

---

Eine Region blockieren

Verwendung:
  • region denyf
Parameter:
  • name: Regionsname (oder * für Wildcard)
Hinweis: Wird dies auf der Wildcard * gesetzt, werden Pakete ohne Regions-Transportcodes verworfen.

---

Informationen zu einer Region anzeigen

Verwendung:
  • region get
Parameter:
  • name: Regionsname (oder * für Wildcard)
---

Home-Region dieses Knotens anzeigen oder ändern

Verwendung:
  • region home
  • region home
Parameter:
  • name: Regionsname
---

Standard-Geltungsbereich-Region (Scope) dieses Knotens anzeigen oder ändern

Verwendung:
  • region default
  • region default {name|}
Parameter:
  • name: Regionsname, oder zum Zurücksetzen/Löschen
---

Eine neue Region erstellen

Verwendung:
  • region put [parent_name]
Parameter:
  • name: Regionsname
  • parent_name: Name der übergeordneten Region (optional, Standard ist die Wildcard)
---

Regionshierarchie definieren (einzeilig)

Verwendung:
  • region def [ ...]
Parameter (Tokens): Durch Leerzeichen getrennt. Ein logischer Cursor beginnt bei der Wildcard *.
  • name — Erstellt name als Kind des aktuellen Cursors (entspricht region put name mit dem Cursor als übergeordnetem Element). Der Cursor wandert zu name.
  • name|jump *(oder name,jump)* — Erstellt name als Kind des aktuellen Cursors und bewegt den Cursor anschließend zu jump (jump muss bereits auf dem Knoten vorhanden sein oder zuvor in diesem Befehl erstellt worden sein). jump ist nicht das übergeordnete Element von name; verwende diese Form, um wieder nach oben zu springen und einen weiteren Zweig zu beginnen.
Verhalten: Jede erstellte Region ist standardmäßig flood-erlaubt (wie bei region put). Die Antwort ist der resultierende Regionsbaum (im selben Format wie das nackte region); überprüfe ihn, bevor du region save zum dauerhaften Speichern ausführst. Bei einem Fehler lautet die Antwort Err - ..., und alle vor dem Fehler platzierten Regionen verbleiben auf dem Knoten, genau wie bei einer teilweisen Kette von region put. Bestehende Regionen: region def löscht den bestehenden Baum nicht – wenn ein Name bereits existiert, wird sein übergeordnetes Element auf den aktuellen Cursor aktualisiert; andernfalls wird eine neue Region erstellt. Um von Grund auf neu zu beginnen, entferne zuerst die unerwünschten Regionen mit region remove. Grenzen: Die Repeater-Serial-Schnittstelle akzeptiert eine Zeile mit bis zu 160 Zeichen. Für größere Bäume verteile die Eingabe auf mehrere region def-Befehle; der Cursor wird zwischen den Befehlen auf * zurückgesetzt, leite den nächsten Befehl also mit child|ancestor ein, um neu zu positionieren. Jedes Token wird höchstens einmal am | getrennt — region def a|b|c|d ist keine Kurzschreibweise für eine flache Liste; siehe das Flachlisten-Beispiel weiter unten. Beispiel — lineare Kette (jedes Token wird zum Kind des vorherigen):
CLI 
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):
CLI 
region def a b c d|b e f
region save
Beispiel — Fehler und teilweiser Zustand:
CLI 
region def a b c|nope d
Die Antwort lautet Err - unknown jump: nope. a, b und c wurden vor dem Fehler platziert; d nicht. Führe region aus, um den Zustand zu prüfen, und führe den Befehl dann mit einem korrigierten Sprung erneut aus oder behebe das Problem mit region remove / region put. Beispiel — flache Liste (jede Region ist ein Kind von *). Verwende |* nach jedem Token, um den Cursor vor dem nächsten Token wieder zur Wurzel zurückzusetzen:
CLI 
region def a|* b|* c|* d|* e|* f
region save

---

Eine Region entfernen

Verwendung:
  • region remove
Parameter:
  • name: Regionsname
Hinweis: Vor dem Entfernen einer Region müssen alle untergeordneten Regionen entfernt werden.

---

Alle Regionen anzeigen

Verwendung:
  • region list
Nur über Serial: Ja Parameter:
  • filter: allowed|denied
Hinweis: Erfordert Firmware 1.12 oder neuer.

---

Alle definierten Regionen und Flood-Berechtigungen ausgeben

Verwendung:
  • region
Nur über Serial: Bei Firmware älter als 1.12.0

---

Regionsbeispiele

Beispiel 1: F-Flag mit benannter öffentlicher Region verwenden
CLI 
region load
#Europe F
<Leerzeile zum Beenden von region load>
region save
Erläuterung:
  • Erstellt eine Region namens #Europe mit aktiviertem Flooding
  • Pakete aus dieser Region werden per Flood an andere Knoten verbreitet
--- Beispiel 2: Wildcard mit F-Flag verwenden
CLI 
region load 
* F
<Leerzeile zum Beenden von region load>
region save
Erläuterung:
  • Erstellt eine Wildcard-Region * mit aktiviertem Flooding
  • Aktiviert Flooding automatisch für alle Regionen
  • Gilt nur für Pakete ohne Transportcodes
--- Beispiel 3: Wildcard ohne F-Flag verwenden
CLI 
region load 
*
<Leerzeile zum Beenden von region load>
region save
Erläuterung:
  • Erstellt eine Wildcard-Region * ohne Flooding
  • Diese Region existiert, beeinflusst aber nicht die Paketverteilung
  • Wird als Standard-/leere Region verwendet
--- Beispiel 4: Verschachtelte öffentliche Region mit F-Flag
CLI 
region load 
#Europe F
  #UK
    #London
    #Manchester
  #France
    #Paris
    #Lyon
<Leerzeile zum Beenden von region load>
region save
Erläuterung:
  • Erstellt die Region #Europe mit aktiviertem Flooding
  • Fügt verschachtelte Kindregionen hinzu (#UK, #France)
  • Alle verschachtelten Regionen erben das Flood-Flag vom übergeordneten Element
--- Beispiel 5: Wildcard mit verschachtelten öffentlichen Regionen
CLI 
region load 
* F
  #NorthAmerica
    #USA
      #NewYork
      #California
    #Canada
      #Ontario
      #Quebec
<Leerzeile zum Beenden von region load>
region save
Erläuterung:
  • Erstellt die Wildcard-Region * mit aktiviertem Flooding
  • Fügt eine verschachtelte #NorthAmerica-Hierarchie hinzu
  • Aktiviert Flooding automatisch für alle Kindregionen
  • Nützlich für globale Netzwerke mit spezifischen regionalen Regeln
---

GPS (wenn GPS-Unterstützung einkompiliert ist)

GPS-Status anzeigen oder ändern

Verwendung:
  • gps
  • gps
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
---

Uhr dieses Knotens mit der GPS-Zeit synchronisieren

Verwendung:
  • gps sync
---

Standort dieses Knotens anhand der GPS-Koordinaten festlegen

Verwendung:
  • gps setloc
---

GPS-Advert-Richtlinie anzeigen oder ändern

Verwendung:
  • gps advert
  • gps advert
Parameter:
  • policy: none|share|prefs
- none: Standort nicht in Adverts aufnehmen - share: GPS-Standort teilen (vom SensorManager) - prefs: Standort, der in den lat- und lon-Einstellungen des Knotens gespeichert ist Standard: prefs

---

Sensoren (wenn Sensorunterstützung einkompiliert ist)

Liste der Sensoren auf diesem Knoten anzeigen

Verwendung: sensor list [start] Parameter:
  • start: Optionaler Startindex (Standard ist 0)
Hinweis: Ausgabeformat: =\n

---

Wert eines Sensors anzeigen oder ändern

Verwendung:
  • sensor get
  • sensor set
Parameter:
  • key: Name der Sensoreinstellung
  • value: Der Wert, auf den der Sensor gesetzt werden soll
---

Bridge (wenn Bridge-Unterstützung einkompiliert ist)

Einkompilierten Bridge-Typ anzeigen

Verwendung: get bridge.type

---

Aktivierungs-Flag der Bridge anzeigen oder ändern

Verwendung:
  • get bridge.enabled
  • set bridge.enabled
Parameter:
  • state: on|off
Standard: off

---

Verzögerung für Pakete hinzufügen, die über diese Bridge geroutet werden

Verwendung:
  • get bridge.delay
  • set bridge.delay
Parameter:
  • ms: Verzögerung in Millisekunden (0-10000)
Standard: 500

---

Quelle der zur externen Schnittstelle gebridgten Pakete anzeigen oder ändern

Verwendung:
  • get bridge.source
  • set bridge.source
Parameter:
  • source:
- logRx: bridgt empfangene Pakete - logTx: bridgt gesendete Pakete Standard: logTx

---

Geschwindigkeit der Bridge anzeigen oder ändern (nur RS-232)

Verwendung:
  • get bridge.baud
  • set bridge.baud
Parameter:
  • rate: Baudrate (9600, 19200, 38400, 57600 oder 115200)
Standard: 115200

---

Für das Bridging verwendeten Kanal anzeigen oder ändern (nur ESPNow)

Verwendung:
  • get bridge.channel
  • set bridge.channel
Parameter:
  • channel: Kanalnummer (1-14)
---

ESP-Now-Secret festlegen

Verwendung:
  • get bridge.secret
  • set bridge.secret
Parameter:
  • secret: ESP-NOW-Bridge-Secret, bis zu 15 Zeichen
Standard: Variiert je nach Board

---

Bootloader-Version anzeigen (nur nRF52)

Verwendung: get bootloader.ver

---

Unterstützung für Energieverwaltung anzeigen

Verwendung: get pwrmgt.support

---

Aktuelle Stromquelle anzeigen

Verwendung: get pwrmgt.source Hinweis: Gibt auf Boards ohne Energieverwaltungsunterstützung einen Fehler zurück.

---

Boot-Reset- und Abschaltgründe anzeigen

Verwendung: get pwrmgt.bootreason Hinweis: Gibt auf Boards ohne Energieverwaltungsunterstützung einen Fehler zurück.

---

Boot-Spannung anzeigen

Verwendung: get pwrmgt.bootmv Hinweis: Gibt auf Boards ohne Energieverwaltungsunterstützung einen Fehler zurück.

---

← Einführung Companion-Protokoll →

Quelle: docs.meshcore.io