Webseiten-Werkzeuge


meshcore:allgemeines:regions:cli

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
meshcore:allgemeines:regions:cli [05.02.2026 14:46] josch0meshcore:allgemeines:regions:cli [05.02.2026 15:20] (aktuell) josch0
Zeile 1: Zeile 1:
 ====== Regions in Repeatern konfigurieren ====== ====== Regions in Repeatern konfigurieren ======
  
-**:!: WICHTIG: Damit Regions auf den Repeatern funktionieren, sollte Firmware 1.12.0 installiert sein. Frühere Versionen ab Version 1.10.0 enthalten bereits eine Teil der Funktionen, aber nicht alle. Es ist nicht empfohlen, Regions mit einer Firmware älter 1.12.0 zu nutzen! Firmware vor 1.10.0 kennt gar keine Regions und leitet **alle** Nachrichten einfach weiter. Ein Update auf 1.12.0 ist dringend empfohlen!**+**:!: WICHTIG: Damit Regions auf den Repeatern funktionieren, sollte Firmware 1.12.0 installiert sein. Frühere Versionen ab Version 1.10.0 enthalten bereits eine Teil der Funktionen, aber nicht alle. Es ist nicht empfohlen, Regions mit einer Firmware älter 1.12.0 zu nutzen! Firmware vor 1.10.0 kennen gar keine Regions und leiten alle Nachrichten einfach weiter. Ein Update auf 1.12.0 ist dringend empfohlen!**
  
 Damit Regions und Scopes funktionieren, müssen **alle** Repeater-Admins ihre Repeater entsprechend konfigurieren. Es müssen sowohl die [[basis|Basis-Regions]] als auch die [[reale-regions-in-repeatern|regionalen Regions]] eingetragen werden. Wie das funktioniert, wird hier erklärt. Damit Regions und Scopes funktionieren, müssen **alle** Repeater-Admins ihre Repeater entsprechend konfigurieren. Es müssen sowohl die [[basis|Basis-Regions]] als auch die [[reale-regions-in-repeatern|regionalen Regions]] eingetragen werden. Wie das funktioniert, wird hier erklärt.
Zeile 8: Zeile 8:
  
 **:!: WICHTIG: Dieses Feature kommt erst mit App-Version 1.39.0, die aktuell noch nicht in den App-Stores für Android/iOS zu finden ist. Im offiziellen [[https://app.meshcore.nz/|Web-Client]] ist das Feature aber bereits enthalten. Zur Nutzung muss sowohl der Companion, als auch der Repeater auf Firmware 1.12.0 geupdatet sein!** **:!: WICHTIG: Dieses Feature kommt erst mit App-Version 1.39.0, die aktuell noch nicht in den App-Stores für Android/iOS zu finden ist. Im offiziellen [[https://app.meshcore.nz/|Web-Client]] ist das Feature aber bereits enthalten. Zur Nutzung muss sowohl der Companion, als auch der Repeater auf Firmware 1.12.0 geupdatet sein!**
 +\\
 +\\
  
-{{:meshcore:allgemeines:regions:manageregions.jpg?500 }}+{{:meshcore:allgemeines:regions:ManageRegions2.jpg?500 }}
  
-Um die Regions direkt über die App zu verwalten, muss man sich auf dem entsprechenden Repeater einloggen und hat dann einen neuen Menüpunkt "Manage Regions" in den Settings des Repeaters. Dort kann man Regions hinzufügen/löschen und aktivieren/deaktivieren. Bei der Eingabe des Region-Namens ist kein # (Hashtag) am Anfang mehr erforderlich, da intern alle Regions als Hashtag-Region interpretiert werden. Die Settings unterstützen entgegen der CLI keine Parent-Verknüpfungen der Regions, d.h. die Regions werden als flache Liste angezeigt und angelegt. Ist wird empfohlen, auf das Anlegen von hierarchischen Regions zu verzichten, solange nicht klar ist, ob und wie diese zukünftig genutzt werden.+\\ 
 +Um die Regions direkt über die App zu verwalten, muss man sich auf dem entsprechenden Repeater einloggen und hat dann einen neuen Menüpunkt "Manage Regions" in den Settings des Repeaters. Dort kann man Regions hinzufügen/löschen und aktivieren/deaktivieren.
  
-===== Über die CLI =====+Bei der Eingabe des Region-Namens ist kein # (Hashtag) am Anfang mehr erforderlich, da intern alle Regions als Hashtag-Region interpretiert werden.
  
 +Die Settings unterstützen entgegen der CLI keine Parent-Verknüpfungen der Regions (Hiearchie), d.h. die Regions werden als flache Liste angezeigt und angelegt. Ist wird empfohlen, auf das Anlegen von hierarchischen Regions zu verzichten, solange nicht klar ist, ob und wie diese zukünftig genutzt werden.
  
  
-Über die CLI (per USB oder remote über den Companion/App) lassen sich die Regions im Repeater verwalten. 
-Nachfolgend die einzelnen Befehle und Hinweise zur Nutzung. 
  
-==== Regionen anzeigen ====+===== Über die Command Line ===== 
 +**:!: WICHTIG: Dieses Feature funktioniert bereits mit der aktuellen App-Version (1.38.0). Zur Nutzung aller Kommandos muss trotzdem sowohl der Companion, als auch der Repeater auf Firmware 1.12.0 geupdatet sein!** 
 +\\ 
 +\\
  
-**:!WICHTIG:** Da dieser Befehl je nach Anzahl der konfigurierten Regionen große Datenmengen liefern kann, kann er derzeit (Firmware 1.11.0) nicht via Remote CLI (mittels Companion/App) verwendet werden, sondern nur über USB/Seriell. Mit der kommenden Firmware (vermutlich 1.12.0), werden die ersten 160 Zeichen der Liste übertragen. Es ist daher ratsam, die Anzahl der Regions gering und die Länge der Namen kurz zu halten.\\+{{:meshcore:allgemeines:regions:ManageRegionsCli.jpg?500 }}
  
 \\ \\
 +Hat man sich per App auf dem Repeater eingeloggt, kann man die Regions auch per Command Line (CLI) verwalten. 
 +
 +\\
 +==== Regionen anzeigen ====
 +----
 +**:?: WICHTIG: Funktioniert erst ab Firmware 1.12.0**
 <code> <code>
 > region > region
Zeile 47: Zeile 58:
 </code> </code>
  
-:?: //Erst ab Firmware 1.12.0// \\ 
 Mit **region list allowed** oder **region list denied** kann man sich nur die aktivierten/deaktivierten Regions anzeigen lassen. Auch hier ist die Ausgabe auf 160 Zeichen begrenzt. Mit **region list allowed** oder **region list denied** kann man sich nur die aktivierten/deaktivierten Regions anzeigen lassen. Auch hier ist die Ausgabe auf 160 Zeichen begrenzt.
  
  
 +\\
 ==== Regionen hinzufügen (Kurzform für gesamte Liste) ==== ==== Regionen hinzufügen (Kurzform für gesamte Liste) ====
- +---- 
-**:!: WICHTIG:** Dieser Befehl ist **nicht** das Gegenstück zu **save** und dient **nicht** dazu, die Regions aus dem Speicher des Device zu laden!\\ +**:!: WICHTIG: Dieser Befehl ist **nicht** das Gegenstück zu **save** und dient **nicht** dazu, die Regions aus dem Speicher des Device zu laden!**\\ 
-**:!: WICHTIG:** Die Hierarchie der Regions hat keinen Einfluss auf das Matching beim Weiterleiten, sondern dient nur der strukturierten Organisation der Regions auf dem Device.\\ +**:!: WICHTIG: Die Hierarchie der Regions hat keinen Einfluss auf das Matching beim Weiterleiten, sondern dient nur der strukturierten Organisation der Regions auf dem Device. Es wird empfohlen, auf hierarchische Eingabe zu verzichten, solange der Nutzen und die Auswirkungen nicht klar sind.**\\
- +
-\\+
 <code> <code>
 > region load > region load
Zeile 80: Zeile 89:
 Das kann hilfreich sein, um über die Remote CLI (mittels Companion/App) die Regions auf dem Repeater komplett zu löschen und eine "frische" Konfiguration zu starten. Das kann hilfreich sein, um über die Remote CLI (mittels Companion/App) die Regions auf dem Repeater komplett zu löschen und eine "frische" Konfiguration zu starten.
  
 +\\
 ==== Region hinzufügen, löschen, abfragen (Einzeln) ==== ==== Region hinzufügen, löschen, abfragen (Einzeln) ====
 +---- 
 +**:!: WICHTIG: Die Hierarchie (Parent) der Regions hat keinen Einfluss auf das Matching beim Weiterleiten, sondern dient nur der strukturierten Organisation der Regions auf dem Device. Es wird empfohlen, auf hierarchische Eingabe zu verzichten, solange der Nutzen und die Auswirkungen nicht klar sind.**\\
 <code> <code>
 > region put #de > region put #de
Zeile 109: Zeile 120:
 Mit dem Befehl **region get** kann man die Infos zu einer einzelnen Region abrufen, oder prüfen ob diese existiert. Mit dem Befehl **region get** kann man die Infos zu einer einzelnen Region abrufen, oder prüfen ob diese existiert.
  
 +\\
 ==== Region aktivieren oder deaktivieren ==== ==== Region aktivieren oder deaktivieren ====
 +----
  
 <code> <code>
Zeile 135: Zeile 148:
 Es ist auch möglich die Wildcard-Region zu deaktivieren. Damit wird das Weiterleiten von Nachrichten OHNE Scope deaktiviert. Das Flooding sollte hier auf keinen Fall deaktiviert werden, da sonst eine Großzahl der Nachrichten im Netz nicht weitergeleitet werden. Es ist auch möglich die Wildcard-Region zu deaktivieren. Damit wird das Weiterleiten von Nachrichten OHNE Scope deaktiviert. Das Flooding sollte hier auf keinen Fall deaktiviert werden, da sonst eine Großzahl der Nachrichten im Netz nicht weitergeleitet werden.
  
 +\\
 ==== Änderungen speichern ==== ==== Änderungen speichern ====
 +----
  
 <code> <code>
Zeile 144: Zeile 159:
 Damit alle über die CLI gemachten Änderungen auf dem Repeatern gespeichert werden und nach einem Reboot zur Verfügung stehen, muss unbedingt ein **region save** ausgeführt werden. Am besten nach jeder einzelnen Änderung durchführen, um nicht aus versehen die ganze Arbeit zu verlieren. Damit alle über die CLI gemachten Änderungen auf dem Repeatern gespeichert werden und nach einem Reboot zur Verfügung stehen, muss unbedingt ein **region save** ausgeführt werden. Am besten nach jeder einzelnen Änderung durchführen, um nicht aus versehen die ganze Arbeit zu verlieren.
  
 +\\
 ==== Home-Region setzen, abfragen ==== ==== Home-Region setzen, abfragen ====
 +---- 
 +**:!: WICHTIG: In der aktuellen Firmware hat die Home-Region keine Bedeutung. Solange deren Zweck und Auswirkung nicht klar sind, sollte auf die Angabe einer Home-Region verzichtet werden.**
 <code> <code>
 > region home > region home
Zeile 159: Zeile 176:
 </code> </code>
  
-//:?: In der aktuellen Firmware hat die Home-Region keine Bedeutung. Das ist ein Feature, was ggf. mal kommen wird.// \\ 
 Mit **region home** lässt sich die aktuelle Home-Region abfragen und setzen. In der Region-Liste erkennt man die Home-Region an dem ^ (Dach) hinter dem Namen.\\ Mit **region home** lässt sich die aktuelle Home-Region abfragen und setzen. In der Region-Liste erkennt man die Home-Region an dem ^ (Dach) hinter dem Namen.\\
  
meshcore/allgemeines/regions/cli.1770299209.txt.gz · Zuletzt geändert: von josch0