Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- meshcore:allgemeines:regions:cli [31.01.2026 11:47] – josch0
+++ meshcore:allgemeines:regions:cli [11.02.2026 08:33] (aktuell) – [Default Verhalten Repeater] clauwn
@@ Zeile 1: / Zeile 1: @@
-====== CLI Referenz für Regions ======
+====== Regions in Repeatern konfigurieren ======
-**:!: 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. \\
+**:!: 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!**
-Über die CLI (per USB oder remote über den Companion/App) lassen sich die Regions im Repeater verwalten.
+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.
-Nachfolgend die einzelnen Befehle und Hinweise zur Nutzung.
-===== Regionen anzeigen =====
+===== Standard-Verhalten der Repeater =====
-**:!: 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.\\
+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 *").
+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.
+===== Welche Regions brauche ich? =====
+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__.
+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>
 > region
@@ Zeile 33: / Zeile 77: @@
 </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.
-===== 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>
 > region load
@@ Zeile 66: / 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.
-===== 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>
 > region put #de
@@ Zeile 95: / Zeile 139: @@
 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>
@@ Zeile 121: / 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.
-===== Änderungen speichern =====
+\\
+==== Änderungen speichern ====
+----
 <code>
@@ Zeile 130: / 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.
-===== 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>
 > region home
@@ Zeile 145: / Zeile 195: @@
 </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.\\

MeshCore Wiki DE

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge