Wat is een Repeater?

Een repeater breidt het bereik van je MeshCore netwerk uit door LoRa data door te sturen naar andere apparaten. Zoals de naam al aangeeft: een repeater herhaalt berichten en stuurt die dus op die manier verder door. De repeaters vormen dus de infrastructuur van het mesh-netwerk.

Alle compatibele LoRa modules kunnen dus voorzien worden van ofwel companion firmware ofwel repeater firmware, er is geen verschil op het gebied van hardware. Maar een repeater beperkt zich dus enkel tot het herhalen (repeaten) van berichten, om berichten te kunnen versturen heb je dus een companion nodig.

Met MeshCore-repeaters groeit het netwerk niet alleen in bereik, maar ook in betrouwbaarheid. Ze kunnen als extra schakel dienen tussen knooppunten, waardoor alternatieve routes ontstaan en de redundantie toeneemt. Dat vertaalt zich in een stabieler netwerk en een grotere kans dat berichten hun bestemming bereiken. Bovendien werken MeshCore-repeaters efficiënt en intelligent: ze sturen enkel de pakketten door die er echt toe doen, in tegenstelling tot sommige andere mesh-systemen die alles blindelings herhalen.

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 
  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 op je smartphone verbinding maken via je companion:

  1. Open MeshCore App op je smartphone
  2. Ga naar contacten en selecteer je repeater
  3. Log in met het Admin-wachtwoord
  4. vraag de status op van je repater voor een algemeen overzicht. => check zeker of datum en tijd correct zijn!
  5. indien datum en tijd afwijken moet je eerst de tijd synchroniseren
  6. Via de diverse knoppen aan de onderzijde kun je bijvoorbeeld een advertisement (advert) sturen om te laten weten dat jouw repeater beschikbaar is
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.

Naamgeving Belgische Repeaters

Kies een duidelijke en beschrijvende naam voor je repeater, dit helpt bij het identificeren en beheren van je repeater in het netwerk. Ben je lid van Radio-Actief gebruik dan zeker het RRY lidnummer in je repeater naam om aan te tonen dat je deel uitmaakt van het grootste Belgisch Meshcore netwerk.

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 land- of regio-/stadcodes opnemen (bijv. BE, of ISO 3166-2 / UN/LOCODE stadscodes). Standaardreferenties: ISO 3166-1 (landcodes), ISO 3166-2:BE (Belgische regio’s en provincies), UN/LOCODE BE (locatiecodes België).

Voorbeelden (combinaties van de aanbevelingen hierboven):

  • BE-GNE-RRY01 — Gent, Radio-Actief lid
  • BE-VLD-ON7MHZ☀️ — Oedelem, 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

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.

Configuratie meshcore repeater

Hieronder overlopen we alle instellingen stap voor stap zoals die te zien zijn in het scherm van je smartphone. Vergeet niet om iedere aanpassing telkens op te slaan.

Name : vul hier je repeater naam in zoals hierboven beschreven.

Public Key : je unieke ID nummer in het netwerk.
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.

Kies hier via de drie puntjes de preset EU/UK narrow. Dit geeft automatisch onderstaande correcte instellingen
Frequency (MHz): 869.618
Bandwidth: 62.5 kHz
Spreading Factor: 8
Coding Rate: 8

Hier kan je je contactgegevens als eigenaar van de repeater invullen. Deze informatie is publiek zichtbaar, zo kunnen anderen weten wie de repeater beheert en wie ze eventueel kunnen contacteren. Ben je lid van Radio-Actief vermeld hier dan zeker je RRY lidnummer!

Wanneer je op Advert klikt, stuurt je repeater op dat moment een soort “ik ben hier”-bericht het netwerk in.
Dit heet een “Flood Advert”: je repeater laat aan de andere repeaters in de buurt weten dat hij actief is. Die repeaters geven dit bericht op hun beurt verder door in het meshnetwerk.

Stuur zo’n manuele advert zeker wanneer je repeater net nieuw is of pas (opnieuw) werd ingesteld om je repeater kenbaar te maken in het netwerk. Eénmalig versturen volstaat, té veel adverts vervuilen het netwerk.

Hiermee stel je in hoe vaak je repeater zichzelf automatisch bekend maakt door een “advert” te sturen.

Auto Advert (Flood)
Om het netwerk niet onnodig te belasten, raden we aan om dit minimaal op 24 uur te zetten. Nog beter is om een oneven getal tussen 24 en 48 uur te kiezen, zodat diverse adverts van alle repeaters beter gespreid worden.

Auto Advert (Zero Hop)
Hiermee maak je je repeater enkel lokaal bekend, de gestuurde advert wordt niet herhaald in het netwerk. Voor een nieuwe repeater staat dit vaak automatisch op 60, maar eigenlijk zet je dit beter op 0 gezien de Flood Adverts eigenlijk hetzelfde doen maar dan over gans het netwerk.

Hier stel je de locatie van je repeater in. Dit mag maar hoeft niet supernauwkeurig te zijn: een benaderende positie is ruim voldoende. Hou de eventuele ‘afwijking’ wel realistisch zodat het netwerk niet verstoord wordt qua kaartweergave door de diverse analysers.

Via Sync Clock kan je de tijd van je repeater gelijkzetten met die van je smartphone. Het is aan te raden om deze synchronisatie uit te voeren telkens je repeater opnieuw opgestart is na vb stroomonderbreking, batterijwissel of firmware update.

Of de interne klok juist staat kun je altijd opvragen via het status scherm van je repeater.

Via dit menu bepaal je wie toegang krijgt tot je repeater, zonder dat die personen een wachtwoord moeten ingeven.

Je kan per gebruiker één van deze rechten toekennen:

  • alleen lezen (read only)
  • lezen en schrijven (read/write)
  • admin‑rechten (admin)

Iedereen in het meshnetwerk die dit admin‑wachtwoord kent, krijgt volledige beheerrechten op je repeater, ook als die persoon niet in de Access Control‑lijst van hierboven staat.  Kies dus een sterk wachtwoord en deel het alleen met mensen die je volledig vertrouwt.

Met het guest password geef je anderen toegang tot de telemetriegegevens van je repeater (zoals batterij en temperatuur).

We raden aan om dit veld leeg te laten, zo kan iedereen deze gegevens bekijken.

Hiermee verander je de publieke sleutel van je repeater, en dus ook zijn identiteit in het netwerk. Voor een nieuwe repeater hoef je hier niets te doen. Vervang je echter de hardware van een reeds bestaande repeater dan is het beter om originele sleutel opnieuw te gebruiken, zo ziet het netwerk eigenlijk geen verandering in de mesh structuur.

Hier bepaal je welke regio’s je repeater moet bedienen en welke hij moet negeren.

Voor kleine aanpassingen volstaat dit scherm, maar voor een correcte en fijnmazige configuratie gebruik je beter de CLI (command line interface). Zie ook Regio en Scope.

op dit scherm zie je welke andere repeaters rechtstreeks verbinding maken met jouw repeater.

Voor een gezond meshnetwerk heeft een repeater idealiter minstens twee buren, maar ook zonder directe buren kan een repeater nuttig zijn omdat die communicatie over een grotere afstand kan verzorgen tussen verschillende lokale gebruikers.

Hier kan je je repeater aan- of uitzetten. Standaard staat dit natuurlijk ingeschakeld (enabled.

Hier zie je alle sensorinformatie van je repeater. Afhankelijk van de hardware kunnen er diverse sensoren aanwezig zijn.
Meestal gaat het om:

  • batterijniveau
  • temperatuur
  • luchtdruk
  • vochtigheidsgraad

Met deze optie start je de repeater opnieuw op. Dit is over het algemeen nodig als je een aantal settings aangepast hebt.
Vergeet niet om na een reboot de klok te controleren en eventueel opnieuw te synchroniseren.

Hier zie je welke firmwareversie op je repeater geïnstalleerd staat.

Privésleutel (backup)

Zoals hierboven reeds aangehaald is het belangrijk om je privésleutel te back-uppen, zowel van je companion node(s) als van je repeater(s). 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.dev (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.