Maintenance script: Categorieën: Radio-Actief alleen community; MeshCore/Hardware/België

2026-07-21T15:54:15Z

Categorieën: Radio-Actief alleen community; MeshCore/Hardware/België

← Oudere versie		Versie van 21 jul 2026 17:54
Regel 190:		Regel 190:
	* '''[https://github.com/meshcore-dev/MeshCore/blob/main/docs/cli_commands.md#region-management-v110 MeshCore <code>cli_commands.md</code> — Region management (v1.10+)]''' — volledige officiële commandoreferentie (inclusief subcommando’s die wij hier niet uitwerken).		* '''[https://github.com/meshcore-dev/MeshCore/blob/main/docs/cli_commands.md#region-management-v110 MeshCore <code>cli_commands.md</code> — Region management (v1.10+)]''' — volledige officiële commandoreferentie (inclusief subcommando’s die wij hier niet uitwerken).

	[[Category:~~Radio-Actief~~]]		[[Category:MeshCore]]
			[[Category:België]]

Maintenance script: Wiki.js import (polished)

2026-07-21T11:57:50Z

Wiki.js import (polished)

Wijzigingen bekijken

Maintenance script: Wiki.js import

2026-07-21T11:52:59Z

Wiki.js import

Nieuwe pagina

= Regio-scopes voor repeaters =

Met '''regio-scopes''' bepaal je welke '''flood'''-verkeer je MeshCore-repeater nog doorstuurt. Zo kan je bijvoorbeeld alleen verkeer voor Belgische codes doorlaten, of je provincie en buurprovincies — en minder nuttige richtingen afknijpen. Companions en apps kunnen berichten met zo'n scope meesturen; de repeater kijkt per pakket of flood voor die '''exacte''' regio-naam is toegestaan.

'''Canonieke technische bron''' (syntax, randgevallen, limieten): [https://github.com/meshcore-dev/MeshCore/blob/main/docs/cli_commands.md#region-management-v110 MeshCore <code>cli_commands.md</code> — Region management (v1.10+)]. Deze pagina vat het samen voor '''#BEmesh'''; wat hier niet uitgewerkt is, staat upstream.

<blockquote>
'''Gericht op #BEmesh (België):''' codes en conventies volgen <code>be</code> (land) en '''<code>be-*</code>''' (provincie volgens ISO 3166-2:BE). We documenteren '''geen''' stads- of gemeentecodes meer. Zie '''[[MeshCore/LijstVanRegios|Lijst van regio's (België)]]''' voor het overzicht.
</blockquote>

== Vereiste firmware ==

- '''Regio's (basis):''' gebruik een actuele repeater-build; in de praktijk regio-ondersteuning vanaf ongeveer firmware '''1.10''' — check je [https://github.com/meshcore-dev/MeshCore/releases release notes].
- '''<code>region list allowed</code> / <code>region list denied</code>:''' alleen via seriële console, firmware '''1.12+'''.
- '''<code>region</code>-dump en oudere builds:''' op zeer oude firmware is <code>region</code> soms alleen bruikbaar via USB-serieel; check je release notes.

== Snelste weg: Regiocodes-configurator ==

Indien je liever een '''configurator''' gebruikt zodat je CLI-commando's kunt '''kopiëren en plakken''' in je repeaterconsole:

- Codes '''visueel op de kaart''' zoeken: '''[https://meshmap.radio-actief.be/region-map Kaart van regioncodes]''' (#BEmesh; pagina in opbouw).

1. Open de '''[https://meshmap.radio-actief.be/region-configurator Regiocodes-configurator]''' op de #BEmesh-kaart.
2. Kies je '''provincie''' (of land) in de configurator.
3. Stel onder '''Policy''' in welke gebieden '''Allow''' of '''Deny''' flood krijgen (of start met '''Defaults''').
4. Kopieer het blok '''Generated MeshCore CLI commands''' en plak het in de '''seriële console''' van je repeater (bijvoorbeeld via [https://flasher.meshcore.io/ flasher.meshcore.io] → '''Console'''), '''regel voor regel''' als dat makkelijker is. Na <code>region save</code> voegt de configurator ook aanbevolen repeater-regels toe: <code>set dutycycle 10</code>, '''<code>set path.hash.mode 1</code>''' (multi-byte advert-path) en <code>set loop.detect minimal</code> — zie '''[[MeshCore/ConfigureRepeater|Repeater Configureren]]'''.

De tool legt ook uit dat '''<code>region load</code>''' (met optioneel <code>F</code> per regel) iets anders is dan de gegenereerde '''<code>region allowf</code> / <code>region denyf</code>''': je kan de boom met <code>put</code>/<code>load</code> opbouwen en flood per naam daarna met <code>allowf</code>/<code>denyf</code> zetten — precies zoals de configurator het uitstuurt.

<blockquote>
'''Belangrijk uit de configurator:''' laat '''Allow flood voor verkeer zonder regio-tag''' (effectief <code>region allowf *</code>) aan tenzij je bewust alles zonder tag wilt blokkeren. Zet dat enkel uit als je '''weet''' dat je andere repeaters hetzelfde doen; anders verdwijnen veel pakketten.
</blockquote>

== Codes in het kort (België) ==

| Laag | Voorbeeld | Opmerking |
|------|-----------|-----------|
| Land | <code>be</code> | ISO-land |
| Provincie | <code>be-vbr</code>, <code>be-van</code>, <code>be-bru</code>, … | ISO 3166-2:BE, parent in de boom meestal <code>be</code> |

Buurlanden en overkoepelend: o.a. <code>nl</code>, <code>lu</code>, <code>bx</code> (Benelux), <code>eu</code> — zie de lijstpagina en je gemeenschapsafspraken.

== Twee losse dingen: boom versus flood ==

Je moet dit conceptueel scheiden:

1. '''Regio bestaat?''' → <code>region put <naam> [ouder]</code> of interactief '''<code>region load</code>''' (indentatie + optioneel <code>F</code> aan het '''einde van de regel''' voor flood tijdens load).
2. '''Mag flood voor díe naam?''' → '''<code>region allowf <naam></code>''' of '''<code>region denyf <naam></code>'''.

De policy-tabel op de configurator genereert vooral '''<code>allowf</code> / <code>denyf</code>''' (niet de <code>F</code>-suffix van <code>region load</code>).

<blockquote>
'''App vs firmware:''' In de app zijn regio’s vaak '''zichtbaar in een boom''' (handig bij <code>region put</code>). '''Nesting in de firmware voor flood is er nog niet''' — het idee (ouder/kind in de boom) bestaat wél in CLI en opslag, maar voor '''flood''' matcht de repeater '''vandaag plat''': elke code telt apart bij <code>allowf</code>/<code>denyf</code>, zonder automatische erfenis ouder → kind.
</blockquote>

== Wildcard <code>*</code> ==

- '''<code>region allowf *</code>''' — flood-pakketten '''zonder''' regio-transportcode nog doorspelen (gangbare default tijdens groei van het netwerk).
- '''<code>region denyf *</code>''' — die on-getaggde flood-pakketten '''laten vallen'''.

== Plat matchen (geen “erfenis” via ouder) ==

In de boom zie je ouder en kind (bijv. <code>be</code> → <code>be-vbr</code>), maar '''routing matcht plat''': een pakket getagged <code>be-vov</code> valt '''niet''' automatisch onder <code>allowf be-vbr</code>.
Je moet '''expliciet''' <code>allowf</code> (of <code>denyf</code>) zetten voor elke '''naam''' die je wilt besturen.

De '''ouder''' bij <code>region put</code> bepaalt vooral: volgorde in <code>region</code>-output, '''<code>region get</code>''', en '''verwijderen''' (<code>region remove</code>: eerst kinderen weg).

== Standaard: flood eerst uit ==

Nieuwe regio’s starten met '''flood geweigerd''' voor die naam. Zet flood aan met '''<code>region allowf <naam></code>''' (of een regel die eindigt op '''<code>F</code>''' tijdens interactief '''<code>region load</code>'''). Zonder <code>allowf</code> stuurt de repeater geen flood door voor die code, ook al staat de naam al in de boom.

== Thuisregio ==

'''<code>region home <naam></code>''' onthoudt welke regio jij als '''thuis''' beschouwt. In het overzicht (<code>region</code>) krijgt die naam een '''<code>^</code>''' ernaast — vooral een '''merktekencode''' om te zien wat je hebt ingesteld. '''Flood doorsturen''' blijft afhangen van '''<code>allowf</code>/<code>denyf</code>''' en de boom, niet van <code>home</code>. Andere <code>region</code>‑subcommando’s die upstream wél bestaan maar '''wij hier niet uitleggen''', vind je in de officiële MeshCore‑referentie onderaan.

== Checks en opslaan ==

- '''<code>region</code>''' — boom + welke namen flood mogen (<code>F</code> in de dump).
- '''<code>region get <naam></code>''' — detail van één regio.
- '''<code>region save</code>''' — '''altijd''' uitvoeren na wijzigingen, anders verlies je ze bij reboot. Regio’s worden op flash bewaard (exact pad hangt van de build af; upstream noemt o.a. <code>/regions2</code>).

Sommige builds raden een '''herstart''' aan na grotere regio-wijzigingen; volg je firmware-release.

== Minimaal voorbeeld (België + twee provincies) ==

Zelfde idee als in de upstream [https://github.com/meshcore-dev/MeshCore/blob/main/docs/cli_commands.md#region-management-v110 Region management]-documentatie:

<pre>
region put be
region put be-vbr be
region put be-van be
region allowf *
region allowf be
region allowf be-vbr
region allowf be-van
region home be-vbr
region save
</pre>

Pas de provinciecodes aan naar jouw situatie; zie '''[[MeshCore/LijstVanRegios|Lijst van regio's (België)]]'''. '''<code>region home</code>''' in dit voorbeeld zet vooral de '''<code>^</code>'''‑markering in het overzicht — zie '''Thuisregio'''.

=== Voorbeeld: <code>F</code> in de <code>region</code>-dump ===

Zo kan de boom in de <code>region</code>-uitvoer eruitzien: de letter '''<code>F</code>''' na een regel betekent dat flood voor die naam is '''toegestaan''' (exacte opmaak kan per firmware verschillen):

<pre>
* F
be F
be-vbr F
be-vov
</pre>

== Praktijkvoorbeelden ==

Naast “alles wat #BEmesh nodig heeft” kan je regio-namen ook '''selectief''' of '''niet-geografisch''' gebruiken — de namen zijn vrije labels zolang afzenders en repeaters dezelfde afspraken hanteren.

=== Geografisch (België): flood enkel voor één provincie ===

Je zet meerdere provincies in de boom, maar laat '''flood''' enkel toe voor degene die deze repeater nuttig moet doorgeven. Verkeer getagged <code>be-vov</code> belast deze node dan niet (tenzij je ook <code>allowf be-vov</code> zet):

<pre>
region put be
region put be-vbr be
region put be-vov be
region allowf be-vbr
region save
</pre>

Voor #BEmesh: voeg provincies toe volgens '''[[MeshCore/LijstVanRegios|Lijst van regio's (België)]]'''; bredere codes zoals <code>bx</code> of <code>eu</code> alleen als je gemeenschap dat afspreekt.

=== Topic-namen (geen kaart, wel afspraak) ===

Voorbeeld: alleen bepaalde '''onderwerpen''' laten flood-en, niet algemene chat — de namen zijn zelf gekozen binnen je mesh:

<pre>
region put emergencies
region put chat
region put weather
region allowf emergencies
region allowf weather
region save
</pre>

Hier gaat flood o.a. door voor <code>emergencies</code> en <code>weather</code>, niet voor <code>chat</code>. Gebruik namen die '''iedereen''' in jouw netwerk begrijpt en meeneemt in berichten.

== Limieten (typisch) ==

- '''Max. ~32 regio's''' per apparaat (<code>MAX_REGION_ENTRIES</code>).
- '''Namen''' tot '''~30 tekens'''.
- '''Transportcodes in cache:''' o.a. '''16''' entries (<code>MAX_TKS_ENTRIES</code> in upstream — zie <code>cli_commands.md</code>).
- Houd de boom beperkt; gebruik de configurator om niet onnodig veel <code>put</code>'s te doen.

== Commando-overzicht ==

| Commando | Kort |
|----------|------|
| <code>region</code> | Boom + flood-flags (oude firmware: vooral serieel). |
| <code>region put <naam> [ouder]</code> | Regio aanmaken; optionele ouder (default: wildcard-root). |
| <code>region remove <naam></code> | Leaf weg; eerst kinderen verwijderen. |
| <code>region allowf <naam></code> | Flood toestaan voor '''exacte''' naam (of <code>*</code> voor on-getagde flood). |
| <code>region denyf <naam></code> | Flood weigeren voor die naam (of <code>*</code>). |
| <code>region home</code> / <code>region home <naam></code> | Thuisregio (<code>^</code> in boom); zie '''Thuisregio'''. Overige subcommando’s: upstream. |
| <code>region get <naam></code> | Details één regio. |
| <code>region list allowed</code> / <code>denied</code> | Lijsten (serieel, '''1.12+'''). |
| <code>region save</code> | Wegschrijven naar flash. |
| <code>region load</code> | Interactieve multiline modus; lege regel beëindigt. Lege naam werkt '''niet betrouwbaar op afstand'''. |

== Zie ook ==

- '''[[MeshCore/ConfigureRepeater|Repeater Configureren]]''' — algemene repeater-setup (antenne, netwerk, privésleutel, …).
- '''[[MeshCore/LijstVanRegios|Lijst van regio's (België)]]''' — land, provincies en buurlanden (geen stadsniveau).
- '''[https://meshmap.radio-actief.be/region-map Kaart van regioncodes]''' — regioncodes op de kaart (#BEmesh).
- '''[https://meshmap.radio-actief.be/region-configurator Regiocodes-configurator]''' — policy, CLI-blok en na <code>region save</code> o.a. <code>set dutycycle 10</code>, '''<code>set path.hash.mode 1</code>''', <code>set loop.detect minimal</code>; geen <code>region default</code>.
- '''[https://github.com/meshcore-dev/MeshCore/blob/main/docs/cli_commands.md#region-management-v110 MeshCore <code>cli_commands.md</code> — Region management (v1.10+)]''' — volledige officiële commandoreferentie (inclusief subcommando’s die wij hier niet uitwerken).

[[Category:Radio-Actief]]

MeshCore/RegioScopes - Bewerkingsoverzicht

Maintenance script: Categorieën: Radio-Actief alleen community; MeshCore/Hardware/België

Maintenance script: Wiki.js import (polished)

Maintenance script: Wiki.js import