regionen_und_scopes [Willkommen auf MeshCore-Austria.at]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Kanäle, Regions & Scopes ======

Mit zunehmender Größe des MeshCore-Netzwerks wird es immer wichtiger, Funkverkehr dort zu halten, wo er tatsächlich benötigt wird.

Eine Nachricht für Wien muss normalerweise nicht durch ganz Österreich weitergeleitet werden. Ein Test aus Niederösterreich muss nicht automatisch ganz Österreich erreichen. Genau dafür verwendet MeshCore **Regions bzw. Scopes**.

Das Ziel von Scoping ist nicht, Kommunikation einzuschränken, sondern das verfügbare Funknetz effizienter zu nutzen:

  * weniger unnötige Airtime
  * weniger unnötige Weiterleitungen
  * weniger Belastung weit entfernter Repeater
  * bessere Skalierbarkeit bei wachsender Teilnehmerzahl

''Die nachfolgenden Befehle beziehen sich ausschließlich auf die Verwendung der CLI (Command Line Interface) eingaben. Hier wird aktuell NICHT das Meshcore-GUI (iOS/Android APP) erklärt.''

Die wichtigste Grundregel lautet:
**So groß wie notwendig, aber so lokal wie sinnvoll.**

===== Versionshinweis: Region-Namen seit Firmware 1.12 =====

**Für Firmware 1.12 und neuer werden Public Regions in der MeshCore-GUI und in der Repeater-CLI ohne führendes ''#'' geschrieben.**

===== Das Prinzip in 30 Sekunden =====

Für Neueinsteiger reicht zunächst dieses Modell:

<code>
CHANNEL
= In welcher Gruppe schreibe ich?

SCOPE
= Für welches geografische Gebiet soll die Nachricht verteilt werden?

REGION AM REPEATER
= Welche gescopten Nachrichten leitet dieser Repeater weiter?
</code>

Beispiel für den österreichweiten Channel:

<code>
Channel: #austria
Scope:   at
</code>

Auf dem Repeater heißt die dazugehörige Public Region:

<code>
at
</code>

Damit ergibt sich:

<code>
#austria
   |
   +--> Scope: at
            |
            +--> Repeater mit Public Region at
</code>

===== Wichtig: Unsere Schreibweise auf dieser Seite =====

Hashtag-Channels und Public Regions werden bewusst unterschiedlich geschrieben:

^ Bedeutung ^ Schreibweise auf dieser Seite ^ Beispiel ^
| Hashtag-Channel | immer mit ''#'' | ''#austria'' |
| Scope | ohne ''#'' | ''at'' |
| Public Region in der Repeater-CLI | ohne ''#'' | ''at'' |
| kein Scope / unscoped | ''*'' | ''*'' |

Wenn wir schreiben:

<code>
Channel: #vienna
Scope:   at-w
</code>

ist ''#vienna'' der Channel. ''at-w'' ist zugleich Scope und Name der Public Region auf dem Repeater.


===== Channel und Scope sind nicht dasselbe =====

Ein Channel ist die Kommunikationsgruppe.

Beispiele:

<code>
#austria
#vienna
#noe
#ooe
#inn-salzach
#english
#test
#bot
</code>

Der Scope bestimmt dagegen, in welchem geografischen Bereich eine Nachricht sinnvoll weitergeleitet werden soll.

Beispiel:

<code>
#austria
Scope: at
</code>

Ein lokaler Wiener Channel verwendet dagegen:

<code>
#vienna
Scope: at-w
</code>

===== Was ist eine Region? =====

Eine Region ist eine organisierte geografische Kennzeichnung.

Auf einem Repeater können beispielsweise folgende Public Regions hinterlegt sein:

<code>
*
europe
at
at-ost
at-w
</code>

Der Repeater entscheidet anhand seiner konfigurierten Regions und Flood-Berechtigungen, welche gescopten Flood-Pakete er weiterleiten darf.

===== Was bedeutet das F in der Regions-Ausgabe? =====

Der Befehl:

<code>
region
</code>

zeigt die konfigurierten Regions und deren Flood-Status an.

Bei der hier empfohlenen flachen Konfiguration sieht die Ausgabe beispielsweise so aus:

<code>
*^ F
europe F
at F
at-ost F
at-w F
</code>

Das ''F'' bedeutet, dass Flooding für diese Region erlaubt ist.

Das ist besonders wichtig für die Konfiguration:

**Neu mit ''region put'' angelegte Regions sind bereits standardmäßig für Flooding freigegeben.**

Wenn nach:

<code>
region put at-w
</code>

die Antwort:

<code>
OK - (flood allowed)
</code>

erscheint, ist ein zusätzliches:


nicht notwendig.

Dasselbe gilt für alle weiteren mit ''region put'' neu erzeugten Regions.

''region allowf'' wird daher hauptsächlich benötigt, wenn:

  * eine bereits vorhandene Region aktuell gesperrt ist,
  * eine zuvor mit ''region denyf'' deaktivierte Region wieder freigegeben werden soll,
  * oder der Wildcard-Eintrag ''*'' gezielt für ungescopte Pakete aktiviert werden soll.

===== Was ist ein Scope? =====

Der Scope ist die Region, die für eine Nachricht bzw. einen Channel verwendet wird.

Wenn wir schreiben:

<code>
Scope: at-w
</code>

meinen wir die öffentliche MeshCore-Region:

<code>
at-w
</code>

===== Was bedeutet * ? =====

''*'' ist ein Sonderfall.

Der Wildcard-Eintrag:

<code>
*
</code>

steuert insbesondere den Umgang mit Flood-Paketen ohne Region Transport Code, also mit ungescopten Paketen.

Beispiel:

<code>
region allowf *
</code>

bedeutet:

<code>
Ungescopte Flood-Pakete dürfen weitergeleitet werden.
</code>

Dagegen:

<code>
region denyf *
</code>

bedeutet:

<code>
Ungescopte Flood-Pakete werden verworfen.
</code>

Wichtig:

Wenn die Ausgabe von:

<code>
region
</code>

bereits beispielsweise:

<code>
*^ F
</code>

zeigt, ist auch:

<code>
region allowf *
</code>

bereits nicht mehr notwendig.

Wir empfehlen daher grundsätzlich:

**Zuerst ''region'' ansehen und nur Flood-Berechtigungen ändern, die tatsächlich geändert werden müssen.**

===== Für Einsteiger: So kommt eine Nachricht durch das Mesh =====

Für eine Scoped-Nachricht arbeiten Companion und Repeater zusammen:

  - Im Companion wählst du einen Channel und den dazu passenden Scope, zum Beispiel ''#vienna'' mit dem Scope ''at-w''.
  - Die gesendete Nachricht trägt genau **einen** Scope. Eine ungescopte Nachricht trägt stattdessen keinen Scope und fällt unter ''*''.
  - Ein Repeater prüft, ob er genau diese Public Region kennt und ob dafür Flooding erlaubt ist (''F''). Nur dann leitet er das Paket weiter.
  - Ein Repeater ohne diese Region leitet das Paket nicht weiter. Dadurch bleibt lokaler Verkehr lokal und belastet nicht unnötig entfernte Infrastruktur.

Hat ein Repeater mehrere erlaubte Regions, gilt das als **ODER**: Er kann Pakete für jede dieser Regions weiterleiten. Das bedeutet nicht, dass ''*'' alle Regions umfasst. ''*'' steht ausschließlich für ungescopte Pakete.

Ein Scope ist keine Verschlüsselung und keine private Gruppe. Er ist ein Filter für die Verteilung im Funknetz. Die Privatsphäre eines Channels wird über dessen Channel-Konfiguration geregelt, nicht über den Scope.

==== Discover Regions im Companion ====

Die Funktion ''Discover Regions'' zeigt Regions, die dem Companion bekannt sind, und hilft bei der Auswahl eines passenden Scopes. Sie legt eine Region jedoch nicht auf Repeatern an und schaltet dort auch kein Flooding frei.

Damit ein Scope in der Praxis funktioniert, müssen entlang des gewünschten Wegs passende Repeater diese Public Region besitzen und dafür Flooding erlauben. Wird eine Region nur im Companion ausgewählt, aber von den erreichbaren Repeatern nicht unterstützt, kann die Nachricht lokal enden oder gar nicht weitergeleitet werden.

Für die Auswahl gilt als einfache Orientierung:

  * lokaler Channel: möglichst den lokalen Scope verwenden, zum Beispiel ''at-w'';
  * Kommunikation über mehrere Bundesländer: einen passenden größeren Scope verwenden, zum Beispiel ''at-ost'';
  * österreichweite Kommunikation: ''at'' verwenden;
  * ungescopte Kommunikation nur dort verwenden, wo sie ausdrücklich gewünscht und von ''*'' unterstützt wird.

===== Warum brauchen wir Scopes? =====

Ohne Scoping könnte beispielsweise eine lokale Wiener Nachricht über immer weitere Repeater verbreitet werden:

<code>
Wien
 |
 +--> Niederösterreich
       |
       +--> Oberösterreich
             |
             +--> Salzburg
                   |
                   +--> Tirol
                         |
                         +--> ...
</code>

Für eine lokale Nachricht ist das meistens unnötig.

Mit:

<code>
Scope: at-w
</code>

kann die Kommunikation auf die dafür vorgesehene Infrastruktur beschränkt werden.

===== Unsere österreichische Regionsstruktur =====

{{:mcaustriaregionsv2.png?600}}

Für MeshCore Austria werden die Regions bewusst **ohne technische Hierarchie** angelegt. Jede verwendete Region liegt direkt unter der Null-Region ''*''.

<code>
*
|
+-- europe
+-- at
+-- at-ost
+-- at-sued
+-- at-west
+-- at-w
+-- at-noe
+-- at-bgld
+-- at-stmk
+-- at-ktn
+-- at-ooe
+-- at-sbg
+-- at-t
+-- at-vbg
</code>

Die Namen folgen weiterhin einer verständlichen geografischen Namenslogik. Beispielsweise steht ''at-ost'' für Ostösterreich und ''at-w'' für Wien. Daraus entsteht aber **keine** Parent-Child-Vererbung: Jede Region ist ein eigenständiger Eintrag.

Die Public Regions auf dem Repeater lauten:

<code>
europe
at

at-ost
at-sued
at-west

at-w
at-noe
at-bgld

at-stmk
at-ktn

at-ooe
at-sbg
at-t
at-vbg
</code>

===== Namensgruppen =====

Die folgenden Gruppen dienen nur der Orientierung. Sie sind keine technischen Ebenen und bewirken keine Vererbung.

==== Global / unscoped ====

<code>
*
</code>

Für Flood-Pakete ohne Region Transport Code.

==== Europa ====

Scope:

<code>
europe
</code>

Public Region:

<code>
europe
</code>

Für länderübergreifende Kommunikation.

==== Österreich ====

Scope:

<code>
at
</code>

Public Region:

<code>
at
</code>

Für österreichweite Kommunikation.

==== Großregionen ====

<code>
at-ost
at-sued
at-west
</code>

Diese Namen können für größere österreichische Bereiche verwendet werden. Sie sind technisch eigenständige Regions direkt unter ''*''.

==== Bundesländer ====

^ Gebiet ^ Scope ^ Public Region ^
| Wien | ''at-w'' | ''at-w'' |
| Niederösterreich | ''at-noe'' | ''at-noe'' |
| Burgenland | ''at-bgld'' | ''at-bgld'' |
| Steiermark | ''at-stmk'' | ''at-stmk'' |
| Kärnten | ''at-ktn'' | ''at-ktn'' |
| Oberösterreich | ''at-ooe'' | ''at-ooe'' |
| Salzburg | ''at-sbg'' | ''at-sbg'' |
| Tirol | ''at-t'' | ''at-t'' |
| Vorarlberg | ''at-vbg'' | ''at-vbg'' |

===== Bekannte Channels und empfohlene Scopes =====

^ Channel ^ Verwendung ^ Empfohlener Scope ^ Public Region ^
| **Public** | allgemeiner MeshCore-Standardchannel | kein Scope / unscoped | ''*'' |
| **#austria** | österreichweite allgemeine Kommunikation | **at** | **at** |
| **#vienna** | Wien | **at-w** | **at-w** |
| **#noe** | Niederösterreich | **at-noe** | **at-noe** |
| **#ooe** | Oberösterreich | **at-ooe** | **at-ooe** |
| **#inn-salzach** | Innviertel / Salzburg / regionale Kommunikation | **at-west** | **at-west** |
| **#english** | englischsprachige / internationale Kommunikation | **europe** | **europe** |
| **#slovakia** | grenzüberschreitende Kommunikation Richtung Slowakei | **europe** | **europe** |
| **#hungary** | grenzüberschreitende Kommunikation Richtung Ungarn | **europe** | **europe** |
| **#czech** | grenzüberschreitende Kommunikation Richtung Tschechien | **europe** | **europe** |
| **#ping** | gezielter Reichweiten-/Erreichbarkeitstest | passend zum Testziel | passende Public Region |
| **#test** | allgemeine technische Tests | **nächsthöhere Großregion** | z.B. **at-ost** |
| **#bot** | Bots und automatisierte Systeme | **nächsthöhere Großregion** | z.B. **at-ost** |
| **#wetter-simmering** | Wetterdienst Wien / Simmering | **at-w** | **at-w** |

===== #austria =====

Der gemeinsame österreichweite Channel:

<code>
#austria
</code>

verwendet:

<code>
Scope: at
</code>

bzw. als Public Region:

<code>
at
</code>

===== Regionale Channels =====

==== Wien ====

<code>
Channel:       #vienna
Scope:         at-w
Public Region: at-w
</code>

==== Niederösterreich ====

<code>
Channel:       #noe
Scope:         at-noe
Public Region: at-noe
</code>

==== Oberösterreich ====

<code>
Channel:       #ooe
Scope:         at-ooe
Public Region: at-ooe
</code>

===== Sonderfall #inn-salzach =====

''#inn-salzach'' deckt einen größeren Bereich im Westen Österreichs ab.

Empfehlung:

<code>
Channel:       #inn-salzach
Scope:         at-west
Public Region: at-west
</code>

===== #english und Nachbarland-Channels =====

Für:

<code>
#english
#slovakia
#hungary
#czech
</code>

empfehlen wir derzeit:

<code>
Scope: europe
Public Region: europe
</code>

Sollten künftig abgestimmte nationale oder grenzüberschreitende Regions-Strukturen existieren, kann diese Empfehlung entsprechend angepasst werden.

===== Sonderregel für #test und #bot =====

''#test'' und ''#bot'' verwenden bewusst nicht den lokalen Bundesland-Scope, sondern die direkt darüberliegende österreichische Großregion.

^ Standort ^ Lokaler Scope ^ Scope für #test / #bot ^ Public Region ^
| Wien | ''at-w'' | **at-ost** | **at-ost** |
| Niederösterreich | ''at-noe'' | **at-ost** | **at-ost** |
| Burgenland | ''at-bgld'' | **at-ost** | **at-ost** |
| Steiermark | ''at-stmk'' | **at-sued** | **at-sued** |
| Kärnten | ''at-ktn'' | **at-sued** | **at-sued** |
| Oberösterreich | ''at-ooe'' | **at-west** | **at-west** |
| Salzburg | ''at-sbg'' | **at-west** | **at-west** |
| Tirol | ''at-t'' | **at-west** | **at-west** |
| Vorarlberg | ''at-vbg'' | **at-west** | **at-west** |

Beispiel Wien:

<code>
#vienna
Scope: at-w

#test
Scope: at-ost

#bot
Scope: at-ost
</code>

===== #ping =====

Der Scope von ''#ping'' richtet sich danach, welcher Bereich tatsächlich getestet werden soll.

<code>
lokal Wien       -> at-w
Ostösterreich    -> at-ost
Österreich       -> at
</code>

===== #wetter-simmering =====

<code>
Channel:       #wetter-simmering
Scope:         at-w
Public Region: at-w
</code>

===== Welchen Scope verwende ich? =====

<code>
Lokaler / Bundesland-Channel?
        |
        +--> lokaler Scope

#test oder #bot?
        |
        +--> nächsthöhere Großregion

Mehrere Bundesländer einer Großregion?
        |
        +--> at-ost / at-sued / at-west

Ganz Österreich?
        |
        +--> at

Länderübergreifend?
        |
        +--> europe
</code>

===== Repeater konfigurieren =====

Für die Konfiguration gibt es zwei relevante Möglichkeiten:

  * lokal über USB und die Console von ''flasher.meshcore.io''
  * nachträglich über die Remote Command Line eines Repeaters

===== Ganz wichtig: region put erlaubt Flooding bereits automatisch =====

Dieser Punkt ist für eine möglichst einfache Konfiguration besonders wichtig.

Die aktuelle MeshCore-CLI legt neue Regions mit:

<code>
region put
</code>

standardmäßig bereits als **flood-allowed** an.

Beispiel:

<code>
region put europe
</code>

Antwort:

<code>
OK - (flood allowed)
</code>

Damit ist keine weitere Freigabe erforderlich.

Dasselbe gilt beispielsweise für flach angelegte Regions:

<code>
region put at
region put at-ost
region put at-w
</code>

Wenn diese Befehle erfolgreich waren, ist keine zusätzliche Flood-Freigabe notwendig.

Die früher auf dieser Seite gezeigten Konfigurationsblöcke mit ''region allowf'' nach jedem ''region put'' waren daher unnötig ausführlich.

===== Wann brauche ich region allowf wirklich? =====

''region allowf'' bleibt ein wichtiger Befehl.

Er wird aber nur benötigt, wenn eine Region bereits existiert und aktuell nicht für Flooding freigegeben ist.

Beispiel:

<code>
region get at-w
</code>

zeigt, dass Flooding gesperrt ist. Daran zu erkennen, das nach der jeweiligen Region kein "F" steht!

Dann:

<code>
region allowf at-w
region save
</code>

Ein weiterer häufiger Anwendungsfall ist der Wildcard-Eintrag:

<code>
*
</code>

Wenn:

<code>
region
</code>

kein ''F'' beim Wildcard-Eintrag zeigt und ungescopte Pakete weiterhin erlaubt sein sollen:

<code>
region allowf *
region save
</code>

Zeigt ''region'' dagegen bereits:

<code>
*^ F
</code>

ist auch dieser Befehl nicht erforderlich.

===== Variante 1 – lokal über flasher.meshcore.io =====

Repeater per USB verbinden und:

<code>
https://flasher.meshcore.io
</code>

öffnen.

Danach die Console öffnen und den seriellen Port auswählen.

===== Firmware prüfen =====

<code>
ver
</code>

===== Vorhandene Konfiguration zuerst ansehen =====

Immer zuerst:

<code>
region
</code>

Das zeigt die bestehenden Regions und ihren Flood-Status.

**Nur ändern, was tatsächlich geändert werden muss.**

===== Fall A – Repeater besitzt noch keine Regions =====

Beispiel Wien:

<code>
*
+-- europe
+-- at
+-- at-ost
+-- at-w
</code>

Konfiguration:

<code>
region def europe|* at|* at-ost|* at-w|*
</code>

Optional bei entsprechender Funkabdeckung:

<code>
region put at-noe
</code>

Danach:

<code>
region
</code>

Die neuen Regions sollten bereits mit ''F'' angezeigt werden. Alle genannten Regions liegen direkt unter ''*''.

Wenn alles korrekt ist:

<code>
region save
</code>

**Es sind keine zusätzlichen ''region allowf #...''-Befehle erforderlich.**

===== Fall B – Regions sind bereits vorhanden =====

Zuerst:

<code>
region
</code>

Angenommen vorhanden:

<code>
*
+-- europe
+-- at
+-- at-ost
+-- at-w
</code>

Niederösterreich ergänzen:

<code>
region put at-noe
</code>

Danach:

<code>
region
</code>

und:

<code>
region save
</code>

===== Einzelne Region prüfen =====

<code>
region get at
region get at-ost
region get at-w
</code>

===== Flooding explizit wieder erlauben =====

Nur wenn eine bestehende Region gesperrt ist:

<code>
region allowf at-w
region save
</code>

===== Flooding einer Region sperren =====

<code>
region denyf at-w
region save
</code>

===== Flood Deny: Wann einsetzen und worauf achten? =====

''region denyf NAME'' sperrt das Flooding fuer genau diese eine Public Region auf diesem Repeater. Die Region wird dadurch nicht geloescht, aber Flood-Pakete mit diesem Scope werden von diesem Repeater nicht mehr weitergeleitet. Andere Regions bleiben davon unberuehrt.

Flood Deny sollte nur eingesetzt werden, wenn bewusst festgelegt werden soll, dass ein Repeater fuer einen bestimmten Scope **nicht** als Verteilpunkt dienen soll. Das kann beispielsweise bei einem klar abgegrenzten lokalen Repeater, bei unerwuenschter Ausbreitung eines bestimmten Scopes oder waehrend einer kontrollierten Umstellung sinnvoll sein.

Nicht als erste Massnahme verwenden, nur weil zu viel Verkehr vermutet wird. Zuerst pruefen, ob die betroffene Region tatsaechlich benoetigt wird und ob die Scopes der verwendeten Channels korrekt gesetzt sind.

Vor einem ''region denyf NAME'' immer:

  * mit ''region'' den aktuellen Zustand ansehen;
  * genau pruefen, welche Public Region gesperrt werden soll;
  * sicherstellen, dass wichtige lokale, regionale und oesterreichweite Kommunikation nicht auf diese Region angewiesen ist;
  * bei Remote-Aenderungen pruefen, dass der Repeater danach weiterhin ueber einen anderen erlaubten Weg erreichbar ist;
  * beruecksichtigen, dass benachbarte Repeater die gesperrte Region eventuell weiterhin weiterleiten koennen.

Sicherer Ablauf:

<code>
region
region denyf at-w
region
</code>

Erst die Ausgabe kontrollieren. Wenn die Wirkung wie gewuenscht ist, dauerhaft speichern:

<code>
region save
</code>

Falls die Sperre nicht gewuenscht war oder eine benoetigte Region dadurch fehlt:

<code>
region allowf at-w
region save
</code>

**Besonders wichtig:** ''region denyf *'' ist etwas anderes. Es betrifft nicht eine einzelne Region, sondern alle **ungescopten** Flood-Pakete. Dafuer gelten die besonderen Hinweise im folgenden Abschnitt.

===== Alle erlaubten oder gesperrten Regions anzeigen =====

Serielle CLI, Firmware 1.12+:

<code>
region list allowed
</code>

bzw.:

<code>
region list denied
</code>

===== Region entfernen =====

<code>
region remove at-noe
region save
</code>

Bei der hier empfohlenen flachen Konfiguration kann jede Region unabhängig entfernt werden. Eine Löschreihenfolge nach Parent-Child-Beziehungen ist nicht erforderlich.

===== Alle Regions neu aufbauen =====

MeshCore besitzt derzeit keinen eigenen:

<code>
region reset
</code>

oder:

<code>
region clear
</code>

Befehl.

Soll die Regions-Konfiguration vollständig neu aufgebaut werden, werden die nicht mehr benötigten Regions einzeln entfernt.

Beispiel einer flachen Konfiguration:

<code>
*
+-- europe
+-- at
+-- at-ost
+-- at-w
+-- at-noe
</code>

Entfernen:

<code>
region remove at-w
region remove at-noe
region remove at-ost
region remove at
region remove europe
</code>

Danach:

<code>
region
</code>

prüfen.

Wenn nur noch ''*'' vorhanden ist, kann die neue flache Konfiguration angelegt werden.

Am Ende:

<code>
region save
</code>

Der Befehl:

<code>
erase
</code>

ist **kein Regions-Reset**, sondern ein vollständiger Factory Reset des Nodes und sollte dafür nicht verwendet werden.

===== Default Scope =====

Der Default Scope ist die Region, mit der der Repeater seine **eigenen Flood-Adverts** versieht. Mit ''region default at'' werden die eigenen Flood-Adverts mit dem Scope ''at'' gesendet. Andere Repeater leiten diese Adverts nur weiter, wenn sie diese Region kennen und dafür Flooding erlauben.

Damit bestimmt der Default Scope vor allem, **wie weit der Repeater selbst im Mesh sichtbar wird** und wo andere Nodes eine Route zu ihm lernen können. Ein engerer Scope hält seine Adverts regional; ein breiterer Scope macht ihn über einen größeren Bereich sichtbar.

**Er beeinflusst nicht**, welche fremden oder empfangenen Pakete der Repeater weiterleitet. Dafür sind weiterhin die konfigurierten Regions und die Flood-Berechtigungen zuständig.

Anzeigen:

<code>
region default
</code>

Setzen:

<code>
region default at
</code>

Entfernen:

<code>
region default null
</code>

Der Default Scope bestimmt nicht, welche fremden Flood-Pakete weitergeleitet werden.

Beispiel: ''region default at-ost'' kann sinnvoll sein, damit die Adverts eines Repeaters in ganz Ostösterreich sichtbar sind. Die Wahl hängt von der gewünschten Erreichbarkeit ab, nicht nur vom exakten Standort.

Ein Default Scope ist daher optional. Ohne Default Scope bleiben eigene Flood-Adverts ungescopt. Soll keine Standardregion gesetzt sein, kann der Wert leer bleiben oder mit ''region default null'' entfernt werden.

===== Regionsdefinitionen mit region def =====

Fuer MeshCore Austria werden Regions flach definiert. Es gibt keine Parent-Child-Vererbung.

Die Regel ist verbindlich: **Nach jedem einzelnen Regionsnamen, auch nach dem letzten, muss ''|*'' stehen.** Damit springt der Cursor nach jeder Definition zur Null-Region ''*'' zurueck.

Beispiel fuer Wien mit Burgenland:

<code>
region def europe|* at|* at-ost|* at-w|* at-bgld|*
region
region save
</code>

Alle Regions in diesem Beispiel liegen direkt unter ''*''. Die Namen ''at-ost'', ''at-w'' und ''at-bgld'' sind nur eine logische Namenskonvention; sie bilden keine technische Vererbung.

Eine Region ergaenzen:

<code>
region def at-noe|*
region
region save
</code>

Neue Regions aus ''region def'' sind bereits flood-allowed. Ein zusaetzliches ''region allowf'' ist nicht erforderlich.

Bei bestehenden Regions zuerst ''region'' ausfuehren, anschliessend nur die benoetigten flachen Eintraege definieren, erneut ''region'' pruefen und danach ''region save'' ausfuehren.

===== region load =====

Für größere Strukturen existiert:

<code>
region load
</code>

''region load'' kann auch hierarchische Eingaben abbilden. Diese Möglichkeit wird in dieser Anleitung bewusst nicht verwendet, weil die österreichischen Beispiele flach unter ''*'' angelegt werden.

Für die hier empfohlene flache Konfiguration ist ''region def'' mit ''|*'' nach jedem Regionsnamen die übersichtlichere und besser nachvollziehbare Variante.

Der interaktive Aufruf von ''region load'' ohne Argument funktioniert nicht sinnvoll über die Remote-CLI.

===== Variante 2 – Remote-Konfiguration =====

Wenn Remote Administration eingerichtet ist:

  * Repeater auswählen
  * Remote Administration öffnen
  * Command Line öffnen

Zuerst:

<code>
ver
region
</code>

Dann nur die notwendigen Änderungen durchführen.

===== Remote – Repeater ohne Regions =====

Beispiel Wien:

<code>
region put europe
region put at
region put at-ost
region put at-w
</code>

Optional:

<code>
region put at-noe
</code>

Danach:

<code>
region
</code>

prüfen.

Wenn die neuen Regions mit ''F'' angezeigt werden:

<code>
region save
</code>

Mehr ist nicht notwendig.

===== Remote – vorhandene Konfiguration erweitern =====

<code>
region put at-noe
region
region save
</code>

===== Remote – vorhandene gesperrte Region wieder aktivieren =====

Nur wenn erforderlich:

<code>
region allowf at-noe
region save
</code>

===== Remote – Region sperren =====

<code>
region denyf at-noe
region save
</code>

===== Remote – Region entfernen =====

<code>
region remove at-noe
region save
</code>

===== Vorsicht mit region denyf * =====

''region denyf *'' verwirft ungescopte Flood-Pakete.

Vorher sicherstellen:

  * benötigte Public Regions sind vorhanden
  * die benötigten Regions sind flach und korrekt angelegt
  * benötigte Regions sind flood-allowed
  * angrenzende Repeater unterstützen die benötigten Regions
  * gewünschte Kommunikation funktioniert
  * Remote-Zugriff funktioniert weiterhin

Wenn:

<code>
region
</code>

bereits:

<code>
*^ F
</code>

zeigt, muss ''region allowf *'' nicht erneut gesetzt werden.

===== Ungescopte Pakete begrenzen statt vollständig sperren =====

Aktuellen Wert anzeigen:

<code>
get flood.max.unscoped
</code>

Beispielsweise:

<code>
set flood.max.unscoped 3
</code>

Damit können ungescopte Nachrichten noch lokal weiterlaufen, ohne unnötig weit geflutet zu werden.

===== Empfohlene Repeater-Konfigurationen =====

Die folgenden Beispiele sind bewusst minimal gehalten und verwenden keine technische Regionshierarchie. Jede Region wird direkt unter ''*'' definiert.

Da ''region put'' neue Regions bereits flood-allowed anlegt, werden keine redundanten ''region allowf #...''-Befehle mehr verwendet.

Nach jedem Aufbau sollte mit:

<code>
region
</code>

geprüft werden, ob die benötigten Einträge ein ''F'' besitzen.

==== Wien ====

<code>
region def europe|* at|* at-ost|* at-w|*

region default at

region
region save
</code>

Optional Niederösterreich & Burgenland:

<code>
region def europe|* at|* at-ost|* at-w|* at-noe|* at-bgld|*
region
region save
</code>

==== Niederösterreich ====

<code>
region def europe|* at|* at-ost|* at-noe|*

region default at

region
region save
</code>

Optional Wien & Burgenland:

<code>
region def europe|* at|* at-ost|* at-w|* at-noe|* at-bgld|*
region
region save
</code>

==== Burgenland ====

<code>
region def europe|* at|* at-ost|* at-bgld|*

region default at

region
region save
</code>

Optional Niederösterreich & Wien:

<code>
region def europe|* at|* at-ost|* at-w|* at-noe|* at-bgld|*
region
region save
</code>

==== Steiermark ====

<code>
region def europe|* at|* at-sued|* at-stmk|*

region default at

region
region save
</code>

==== Kärnten ====

<code>
region def europe|* at|* at-sued|* at-ktn|*

region default at

region
region save
</code>

==== Oberösterreich ====

<code>
region def europe|* at|* at-west|* at-ooe|*

region default at

region
region save
</code>

==== Salzburg ====

<code>
region def europe|* at|* at-west|* at-sbg|*

region default at

region
region save
</code>

==== Tirol ====

<code>
region def europe|* at|* at-west|* at-t|*

region default at

region
region save
</code>

==== Vorarlberg ====

<code>
region def europe|* at|* at-west|* at-vbg|*

region default at

region
region save
</code>

===== Muss jeder Repeater alle Regions besitzen? =====

Nein.

Ein Repeater soll jene Regions kennen, die aufgrund seines Standortes und seiner Funkabdeckung sinnvoll sind.

Grenzrepeater können mehrere benachbarte lokale Regions besitzen.

Beispiel Wien / Niederösterreich:

<code>
at-w
at-noe
</code>

Optional kann zusätzlich die eigenständige Region:

<code>
at-ost
</code>

angelegt werden, wenn sie für einen verwendeten Scope benötigt wird. Sie ist kein gemeinsamer Parent der beiden lokalen Regions.

===== CLI-Kurzreferenz =====

Firmware:

<code>
ver
</code>

Regions und Flood-Status:

<code>
region
</code>

Neue Region:

<code>
region put NAME
</code>

Wichtig:

<code>
region put
</code>

legt neue Regions bereits flood-allowed an.

Einzelne Region:

<code>
region get #NAME
</code>

Bestehende gesperrte Region wieder erlauben:

<code>
region allowf #NAME
</code>

Region sperren:

<code>
region denyf #NAME
</code>

Ungescopte Pakete erlauben, falls noch nicht erlaubt:

<code>
region allowf *
</code>

Region entfernen:

<code>
region remove #NAME
</code>

Default Scope:

<code>
region default #NAME
</code>

Default Scope löschen:

<code>
region default null
</code>

Flache Regionsdefinition kompakt anlegen:

<code>
region def europe|* at|* at-ost|* at-w|*
</code>

Speichern:

<code>
region save
</code>

===== Empfohlener Ablauf bei einem neuen Repeater =====

<code>
1. ver

2. region

3. benötigte Regions mit region put anlegen

4. region

5. prüfen, ob die neuen Regions mit F markiert sind

6. nur falls nötig:
   region allowf ...

7. Default Scope setzen

8. region

9. region save
</code>

===== Empfohlener Ablauf bei einem bestehenden Repeater =====

<code>
1. region

2. bestehende Regions und ihren Flood-Status prüfen

3. nur fehlende Regions mit region put ergänzen

4. region

5. nur gesperrte benötigte Regions mit region allowf aktivieren

6. nicht mehr benötigte Regions bei Bedarf entfernen

7. region

8. region save
</code>

===== Die wichtigsten Regeln =====

  * ''erase'' ist kein Regions-Reset, sondern ein Factory Reset des gesamten Nodes. ''AUFPASSEN''

Companion:
  * ''#austria'' ist ein Channel (Companion).
  * ''at'' schreiben wir auf dieser Seite als Scope (Companion).
  * daher ist der Kanal ''#austria'' mit dem Scope ''at'' in Verwendung (Companion).
  * Normale lokale Channels verwenden den lokalen Scope (Companion).
  * ''#test'' und ''#bot'' verwenden die nächsthöhere Großregion (Companion).
  * ''#ping'' verwendet den Scope des tatsächlich getesteten Gebiets (Companion).

Repeater bzw. Repeater Admin Konfiguration im Companion Remote, oder über Serial:
  * Die Public Region dazu heißt ''at''.
  * Die ''region''-Ausgabe kann Public Regions je nach Firmware ohne führendes ''#'' anzeigen.
  * ''F'' bedeutet, dass Flooding für die betreffende Region erlaubt ist.
  * **''region put'' legt neue Regions bereits standardmäßig flood-allowed an, selbiges bei ''region def''.**
  * Deshalb sind zusätzliche ''region allowf #...''-Befehle nach erfolgreichen ''region put''-Befehlen normalerweise überflüssig.
  * ''region allowf'' ist vor allem für bereits vorhandene, gesperrte Regions oder für ''*'' relevant.
  * Auch ''region allowf *'' ist nur erforderlich, wenn ''*'' nicht bereits mit ''F'' angezeigt wird.
  * ''*'' steuert ungescopte Flood-Pakete und bedeutet nicht einfach "alle Regions".
  * Nicht jeder Repeater benötigt alle österreichischen Regions.
  * Vor jeder Änderung zuerst ''region'' ausführen.
  * Nach Änderungen erneut ''region'' prüfen.
  * Erst danach ''region save'' verwenden.
  * Es gibt keinen eigenen ''region reset''-Befehl; für einen Neuaufbau werden nicht mehr benötigte Regions mit ''region remove'' entfernt.
  * ''region load'' ohne Argument ist interaktiv und nicht für Remote-CLI geeignet.

===== Kurzfassung =====

<code>
ÖSTERREICHWEIT

#austria
Scope: at
</code>

<code>
LOKAL WIEN

#vienna
Scope: at-w
</code>

<code>
TEST / BOT AUS WIEN

#test / #bot
Scope: at-ost
</code>

Und für die Repeater-Konfiguration:

<code>
region put europe
region put at
region put at-ost
region put at-w

region
region save
</code>

Wenn ''region'' danach:

<code>
europe F
at F
at-ost F
at-w F
</code>

zeigt, ist alles bereits für Flooding freigegeben.

Zusätzliche Flood-Freigaben sind dann **nicht notwendig**.

So bleibt die Konfiguration einfacher, verständlicher und näher am tatsächlichen Verhalten der MeshCore-CLI.