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 10:16] 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 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 den Dialog in der MeshCore-App =====+===== Standard-Verhalten der Repeater =====
  
-IN ARBEIT+Ein frisch geflashter Repeater mit Version 1.12.0 hat nur die Wildcard-Region * (Stern) aktiviert. Diese leitet alle Nachrichten **ohne** Scope automatisch weiter. 
 +Es ist bisher nicht geplant und auch nicht sinnvoll, das Weiterleiten ohne Scope zu unterbinden ("denyf *").
  
-===== Über die CLI =====+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.
  
-**:!: WICHTIG:** Aktuell (Stand 1.38.0) gibt es in der App keine Möglichkeit mittels UI die Regions einfach zu verwalten. Das kommt aber mit der nächsten App-Version. Der [[https://app.meshcore.nz/|WebClient]] ist in einer Dev-Version vorhanden und unterstützt die neuen Features bereits. Alternativ bleibt immer die Nutzung der CLI. \\+===== Welche Regions brauche ich? =====
  
-Über die CLI (per USB oder remote über den Companion/App) lassen sich die Regions im Repeater verwalten. +Maßgeblich dafür ist immer der exakte Repeater-Standort.
-Nachfolgend die einzelnen Befehle und Hinweise zur Nutzung.+
  
-==== Regionen anzeigen ====+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.
  
-**:!: 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/SeriellMit der kommenden Firmware (vermutlich 1.12.0)werden die ersten 160 Zeichen der Liste übertragen. Es ist daher ratsamdie Anzahl der Regions gering und die Länge der Namen kurz zu halten.\\+Ausgehend vom eigenen Standort kann man im ersten Schritt die für den Standort passenden [[basis|Basis-Regions]] auswählenEin Repeater in Hanau bekäme z.Bdann __europe____de__, __de-mitte____de-sued__, __de-west__ und __de-he__.
  
 +Im nächsten Schritt schaut man nach, welche [[reale-regions-in-repeatern|Regionale Regions]] es bereits gibt. Für Hanau z.B. __rhein-main__.
 +
 +===== Konfigurieren per Settings =====
 +
 +**:!: 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 41: 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) ==== ==== 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 74: 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 103: 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 129: 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 138: 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 153: 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.1770283018.txt.gz · Zuletzt geändert: von josch0