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 [11.02.2026 08:33] (aktuell) – [Default Verhalten Repeater] clauwn
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.
  
-===== Über die Settings =====+===== Standard-Verhalten der Repeater =====
  
-**:!: WICHTIG: Dieses Feature kommt erst mit App-Version 1.39.0die aktuell noch nicht in den App-Stores für Android/iOS zu finden istIm offiziellen [[https://app.meshcore.nz/|Web-Client]] ist das Feature aber bereits enthaltenZur Nutzung muss sowohl der Companion, als auch der Repeater auf Firmware 1.12.0 geupdatet sein!**+Ein frisch geflashter Repeater mit Version 1.12.0 hat nur die Wildcard-Region * (Stern) aktiviertDiese leitet alle Nachrichten **ohne** Scope automatisch weiter. 
 +Es ist bisher nicht geplant und auch nicht sinnvoll, das Weiterleiten ohne Scope zu unterbinden ("denyf *").
  
-{{:meshcore:allgemeines:regions:manageregions.jpg?500 }}+Nachrichten mit beliebig gesetztem Scope, werden per default **nicht** weitergeleitet. Das ist gewünschtes Verhalten. Es ist daher wichtig, den Repeater so schnell wie möglich mit den richtigen Regions zu bestücken.
  
-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.+===== Welche Regions brauche ich? =====
  
-===== Über die CLI =====+Maßgeblich dafür ist immer der exakte Repeater-Standort.
  
 +Es empfiehlt sich, vor dem Konfigurieren des Repeaters zu schauen ob es Mesh-Communities in der Gegend gibt, die beim Einrichten helfen können. Hier sei die deutsche [[https://t.me/meshcorede|Telegram Gruppe]] als erste Anlaufstelle empfohlen. Es ist ebenfalls sinnvoll, im Companion per "Region Discover" mal zu schauen, welche Regions im Umkreis schon gesetzt sind.
  
 +Ausgehend vom eigenen Standort kann man im ersten Schritt die für den Standort passenden [[basis|Basis-Regions]] auswählen. Ein Repeater in Hanau bekäme z.B. dann __europe__, __de__, __de-mitte__, __de-sued__, __de-west__ und __de-he__.
  
-Über die CLI (per USB oder remote über den Companion/App) lassen sich die Regions im Repeater verwalten. +Im nächsten Schritt schaut man nach, welche [[reale-regions-in-repeatern|Regionale Regions]] es bereits gibtFür Hanau z.B. __rhein-main__.
-Nachfolgend die einzelnen Befehle und Hinweise zur Nutzung.+
  
-==== Regionen anzeigen ====+===== Konfigurieren per Settings =====
  
-**:!: 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 werdensondern 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.\\+**:!: WICHTIG: Dieses Feature ist erst in App-Version 1.39.0 enthalten. Zur Nutzung muss sowohl der Companion, als auch der Repeater auf Firmware 1.12.0 geupdatet sein!** 
 +\\ 
 +\\
  
 +{{: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 (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.
 +
 +In App v1.39.0 muss nach dem konfigurieren noch per cli „region save“ genutzt werden um die Einstellungen über einen Neustart hinweg zu speichern. Ab v1.40.0 gibt es hierfür in der App noch einen weiteren Knopf mit Haken. 
 +
 +<WRAP clear></WRAP>
 +
 +===== Konfigurieren per Command Line (CLI) =====
 +**:!: WICHTIG: Dieses Feature funktioniert ab 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!**
 +\\
 +\\
 +
 +{{: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. 
 +
 +<WRAP clear></WRAP>
 +
 +==== Regionen anzeigen ====
 +----
 +**:?: WICHTIG: Funktioniert erst ab Firmware 1.12.0**
 <code> <code>
 > region > region
Zeile 47: Zeile 77:
 </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) ==== 
- 
-**:!: 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.\\ 
  
 \\ \\
 +==== 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: 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 108:
 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 139:
 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 167:
 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 178:
 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 195:
 </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