MeshCore/ConfigureRepeater

! NEEDS REVIEW !

• Deze pagina is nog in opbouw.*

Wat is een Repeater?

Bij MeshCore speelt niet alleen het apparaat een rol, maar vooral de firmware (software) die je erop installeert. Wanneer je een repeater opzet, moet je bij het flashen van de firmware de rol repeater selecteren.

Een repeater breidt het bereik van je MeshCore netwerk uit door pakketten door te sturen naar andere apparaten. Zoals de naam al aangeeft: een repeater herhaalt berichten. In tegenstelling tot een companion wordt een repeater niet gebruikt om direct mee te chatten, maar om inkomende berichten af te leveren of door te sturen naar andere repeaters. Samen vormen repeaters de infrastructuur (snelwegen) van het mesh-netwerk.

Met behulp van repeaters neemt de omvang van de mesh toe. Ook kan een repeater net een extra alternatieve verbinding vormen tussen twee punten, waardoor er meer redundantie ontstaat. Dat is goed voor de stabiliteit en verhoogt de kans dat berichten goed afgeleverd kunnen worden.

ℹ️ Info: Intelligente Forwarding

MeshCore repeaters zijn slim: ze sturen alleen relevante pakketten door die daadwerkelijk doorgestuurd moeten worden, wat efficiënter is dan andere mesh systemen die alle pakketten herzenden.

Vereisten

• LoRa apparaat met Repeater firmware geïnstalleerd
• BLE Companion client voor configuratie

Repeater Plaatsing

Voor een repeater is hoogte cruciaal - plaats deze bij voorkeur zo hoog mogelijk. Hoogte is waarschijnlijk de belangrijkste factor voor een goed bereik en vrij zicht. Hoewel een toren op een hoog punt ideaal zou zijn, heeft bijna niemand dat in de achtertuin. In gebieden met veel laagbouw is hoogte lastiger te realiseren dan voor iemand die op de bovenste verdieping van een flat woont. Ongeacht je situatie: probeer de repeater zo hoog mogelijk te plaatsen.

Voor optimale netwerkprestaties:

• Hoogte: Hoogte is de belangrijkste factor - plaats zo hoog mogelijk
• Strategische Locaties: Plaats repeaters op tactische locaties om het netwerkbereik te maximaliseren
• Obstakels: Overweeg obstakels zoals gebouwen en bomen bij plaatsing
• Dekking: Zorg voor goede overlap tussen repeater dekking gebieden
• Weerbestendigheid: Zorg dat het apparaat tegen de invloeden van buitenaf kan (zon, stof, regen)

⚠️ Waarschuwing: Te Veel Repeaters

Te veel repeaters kunnen het netwerk vertragen. Plaats alleen repeaters waar ze nodig zijn voor bereik.

Antenne en Kabel

De antenne is een cruciaal onderdeel voor een goede repeater. De standaard meegeleverde antennes zijn vaak vrij klein, wat betekent dat ze minder signalen kunnen opvangen en moeite hebben om berichten over grotere afstanden te verzenden. Dit komt mede doordat LoRa-technologie met relatief lage zendkracht werkt. Een grotere, betere antenne kan daarom een aanzienlijk verschil maken in bereik en prestaties.

Antenne Type

Je kunt kiezen tussen directionele antennes (gericht op een specifiek punt) en omnidirectionele antennes (360-graden bereik). Voor de meeste MeshCore-nodes, en zeker voor repeaters, is een omnidirectionele antenne de betere keuze. Deze kan signalen van alle kanten ontvangen, wat essentieel is in een mesh-netwerk waar je vaak niet precies weet waar andere repeaters zich bevinden. Als er meerdere repeaters in de buurt zijn, is een directionele antenne meestal niet geschikt.

Kabel

De kabel die de antenne met je apparaat verbindt is eveneens belangrijk. Het algemene advies is: hoe korter de kabel, hoe beter. Langere kabels veroorzaken signaalverliezen, wat de prestaties negatief beïnvloedt.

💡 Tip: Expert Tips

Ben je een specialist (bijv. HAM-radio) of techneut met ervaring en heb je meer tips rondom de antenne? Je feedback voor deze documentatie is erg welkom via de Radio-Actief Discord.

>

Voor meer informatie over vaste en mobiele antennes: zie de Antennes pagina.

Repeater Instellen

Na het flashen van je apparaat met repeater firmware, zijn er een paar stappen nodig. Vaak kun je dit doen met behulp van de Repeater Setup-knop op de flasher-pagina. Hiervoor dient het apparaat nog verbonden te zijn met een USB-kabel.

Basis Configuratie (via Flasher)

1. Instellen naam (zie Naamgeving hieronder)
2. Instellen van de juiste preset (Narrow EU/UK)
3. Uitvoeren van een kloksynchronisatie
4. Instellen Admin-wachtwoord

Configuratie via App

Is je apparaat al in de lucht? Dan kun je via de app een verbinding maken:

1. Open MeshCore App op je smartphone
2. Ga naar Apparaten en selecteer je repeater
3. Log in met het Admin-wachtwoord
4. Via de diverse knoppen aan de onderzijde kun je bijvoorbeeld een advertisement (advert) sturen om te laten weten dat jouw repeater beschikbaar is
5. Ook is het mogelijk om de tijd te synchroniseren

Command-Line Configuratie

De MeshCore-software heeft ook de optie om via de command-line opdrachten te sturen, zoals clock sync om de klok te synchroniseren. Ook na het herstarten van de repeater is dit vaak nodig.

Configuratie Instellingen

Je kunt je repeater ook eenvoudig configureren via de online Radio-Actief Configurator, zonder command-line kennis nodig te hebben.

Netwerk Instellingen

• Preset: Zorg ervoor dat de juiste preset (Narrow EU/UK) actief is en opgeslagen is (niet alleen gekozen)
• Netwerk ID: Zorg ervoor dat de repeater dezelfde Netwerk ID gebruikt als de rest van je netwerk
• Kanaal: Configureer het juiste kanaal voor je regio
• Frequentie Band: Controleer of de juiste frequentie band is ingesteld (433MHz, 868MHz, of 915MHz)

Repeater Specifieke Instellingen

• Naam: Stel een duidelijke naam in voor je repeater (zie Naamgeving hieronder)
• Admin-wachtwoord: Stel een beveiligd Admin-wachtwoord in voor beheer
• Kloksynchronisatie: Voer regelmatig kloksynchronisatie uit, vooral na herstarten
• Forwarding: Zorg ervoor dat forwarding is ingeschakeld
• Range: Configureer range instellingen indien beschikbaar
• Power: Stel zendvermogen in voor optimaal bereik

Privésleutel (backup)

Het is belangrijk om je privésleutel te back-uppen. De privésleutel is wat je publieke sleutel genereert en bepaalt. Als je je apparaat flasht of wist, of een node vervangt door een ander model of apparaat, kun je met een backup van je privésleutel altijd dezelfde identiteit/public key behouden. Dit wordt aanbevolen om je buren, de online kaart en observers schoon te houden met correcte gegevens en geen verouderde informatie. Het zorgt voor minder vervuiling.

• • Hoe kan ik de privésleutel van een repeater ophalen of instellen?**

Sluit je node via USB aan op een computer. Open de CLI-console via flasher.meshcore.io (klik rechtsboven op Console, in een Chromium-browser zoals Chrome of Edge). Je kunt daar deze commando's uitvoeren. Dit werkt niet via de remote management over LoRa – alleen via USB-seriële verbinding.

Commando	Beschrijving
get prv.key	Toont de privésleutel van de repeater, dit doe je dus op je oude node
set prv.key <hex>	Stelt de privésleutel van de repeater in, dit doe je dus op je nieuwe node of na de clean install

Herstart de repeater na het commando set prv.key met reboot zodat de nieuwe privésleutel van kracht wordt.

Duty cycle, multi-byte path en loop-detectie

Deze drie instellingen horen bij een volwassen repeater-setup naast netwerk/regio’s. Stel ze in via de seriële console (flasher.meshcore.io → Console) of Repeater Admin in de app.

Instelling	CLI	Beschrijving
Duty cycle	get dutycycle / set dutycycle <waarde>	Maximale zendtijd als percentage van een venster (EU-regelgeving). 100 = geen limiet; 50 = default in veel builds; 10 = 10 % (streng, gangbaar in EU); 1 = striktst.
Multi-byte path (advert)	get path.hash.mode / `set path.hash.mode <0\	1\	2>`	Grootte van de eigen node-hash in flood-adverts van deze repeater: 0 = 1 byte (max ~64 hops), 1 = 2 bytes (max ~32 hops), 2 = 3 bytes (max ~21 hops). Doorsturen van 1-/2-/3-byte pakketten doet firmware 1.14 of nieuwer ongeacht deze waarde; 1 of 2 helpt de community zien dat repeaters klaar zijn voor bredere path-hashes.
Loop-detectie	get loop.detect / `set loop.detect <off\	minimal\	moderate\	strict>`	Hoe strikt lussen worden gedetecteerd: de repeater telt hoe vaak zijn hash in het pad zit en dropt het pakket bij overschrijding.

Aanbevolen start (#BEmesh / EU)

Voor een typische Belgische repeater in een groeiend netwerk (EU duty cycle, multi-byte-adverts, lichte loop-guard):

set dutycycle 10
set path.hash.mode 1
set loop.detect minimal

Kleinere of oudere meshes

• Heel klein netwerk (weinig repeaters, veel nodes nog onder firmware 1.14): overweeg set path.hash.mode 0 en set loop.detect minimal.
• Groter gebied, meer repeaters: set path.hash.mode 1 (of 2 na afspraak in de community) en set loop.detect moderate (of ten minste minimal).

Voorbeeld alternatief (klein netwerk):

set dutycycle 10
set path.hash.mode 0
set loop.detect minimal

of groter netwerk:

set dutycycle 10
set path.hash.mode 1
set loop.detect moderate

Duty cycle: set dutycycle vervangt in firmware 1.15 of nieuwer het oudere set af/set airtime‑pad; zie upstream cli_commands.md als je build nog de oude voorkeuren toont.

Regio's (scopes)

MeshCore ondersteunt regio-scopes om te bepalen welke flood-pakketten je repeater nog doorstuurt (land en provincie). Voor #BEmesh houden we het bij provincieniveau; zie Lijst van regio's (België). Standaardiseer dit vroeg zodat het netwerk later beter schaalt.

Uitgebreide gids: stap-voor-stap, configurator, wildcard *, plat matchen en volledige CLI-tabel → Regio-scopes voor repeaters.
Code-overzicht België: Lijst van regio's (België).

Naamgeving

Kies een duidelijke en beschrijvende naam voor je repeater. Dit helpt bij het identificeren en beheren van je repeater in het netwerk.

Let op: Houd de naam compact (max. 32 tekens). Lange namen kunnen problemen veroorzaken: ze nemen meer ruimte in advertentiepakketten in beslag en kunnen tot afkapping of prestatieproblemen leiden.

Je kunt een operator-ID opnemen: RRY01 (Radio-Actief lidnummer), ON7MHZ (HAM-roepnaam) of 1A001 (noodcommunicatie-operator).

Je kunt een emoji aan het einde toevoegen voor het voedingstype: ☀️ voor een zonne-energie node (met batterij), ⚡️ voor een enkel netgevoede node, of 🔋 voor een netgevoede node met batterijback-up.

Je kunt in je repeater-naam informeel land- of provincie-afkortingen opnemen (los van de technische region-boom). Standaardreferentie voor Belgische provincies: ISO 3166-2:BE.

• • Voorbeelden** (combinaties van de aanbevelingen hierboven):

• BE-GNE-RRY01 — Gent, Radio-Actief lid
• BE-LIE-ON7MHZ☀️ — Lier, HAM-roepnaam, zonne-energie
• BE-LGG-RRY01⚡️ — Luik/Liège, Radio-Actief lid, enkel netgevoed
• BE-GNE-RRY01🔋 — Gent, Radio-Actief lid, netgevoed met batterijback-up
• BE-BGS-1A001 — Brugge, noodcommunicatie-operator

Testen

Na configuratie, test je repeater:

1. Test Bereik: Test of het bereik daadwerkelijk is uitgebreid
2. Test Forwarding: Verzend berichten en controleer of ze correct worden doorgestuurd
3. Monitor Prestaties: Monitor de prestaties van je repeater

Best Practices

• Plaatsing: Plaats repeaters op strategische locaties
• Onderhoud: Monitor repeater prestaties regelmatig
• Netwerk Planning: Plan je repeater plaatsing zorgvuldig voor optimale dekking
• Backup: Overweeg backup repeaters voor kritieke netwerken

Problemen Oplossen

Repeater Stuurt Geen Pakketten Door

• Controleer of forwarding is ingeschakeld
• Controleer netwerk instellingen (Netwerk ID, Kanaal)
• Zorg dat de repeater binnen bereik is van andere apparaten
• Test met een ander apparaat

Beperkt Bereik

• Controleer plaatsing (hoogte, obstakels)
• Controleer zendvermogen instellingen
• Overweeg betere antenne plaatsing
• Test op verschillende locaties

Netwerk Vertraging

• Controleer of er te veel repeaters zijn
• Optimaliseer repeater plaatsing
• Controleer netwerk belasting
• Overweeg netwerk herstructurering

Volgende Stappen

Na het configureren van je Repeater:

• MeshCore Introductie – Meer informatie over MeshCore
• Firmware Flashen – Andere firmware types installeren
• Companion Configureren – Companion apparaten configureren
• Regio-scopes voor repeaters – Regio's en flood-beleid voor repeaters

Ondersteuning

Voor hulp bij Repeater configuratie:

• Bezoek de Radio-Actief community Discord server
• Bekijk de MeshCore website voor meer informatie
• Raadpleeg de MeshCore Firmware GitHub voor technische details