Je hebt je toestel geflasht met Companion-firmware. Op deze pagina koppel je het aan je telefoon of computer, zet je de juiste radio-preset voor België, en doe je een eerste werkcheck op de mesh.
Wat is een Companion? Een Companion is een LoRa-zender die géén pakketten doorstuurt. Hij luistert en zendt jouw berichten. Je bedient hem via een app (smartphone), een web client (browser), of een desktop client. Om bereik te geven aan het netwerk heb je repeaters nodig — companions dragen daar niet aan bij.
| Firmware | Verbinding naar client | Typisch gebruik |
|---|---|---|
| BLE Companion | Bluetooth Low Energy | Smartphone of tablet, in de broekzak of rugzak |
| USB Serial Companion | USB kabel | Vast aan laptop of desktop, ook handig voor observer-/debugopstellingen |
Beide spreken hetzelfde MeshCore-protocol — het verschil zit enkel in hoe je client ermee praat.
De officiële clients vind je via het upstream app-portaal:
De Windows- en macOS-versies zijn dezelfde codebase als de mobiele app en volledig gratis. iOS/Android zijn freemium: het basisgebruik is gratis, enkel de Remote Admin-wachttijd voor het op afstand beheren van repeaters kan je afkopen.
Connect (rechtsboven)123456.Connect → USB → kies je seriële poort in de browser-pop-up.Dit is de belangrijkste stap, en de meest vergeten. Jouw Companion moet op dezelfde radio-parameters staan als de rest van #BEmesh. Anders hoor je niemand, en hoort niemand jou.
Voor #BEmesh is de community-afspraak de EU/UK (Narrow)-preset radio-parameters.
Op een companion stel je deze parameters in via de radio-instellingen van de MeshCore-app waarmee je verbonden bent.
In de app: ⚙️ Settings → Choose Preset → EU/UK (Narrow) → ✅ opslaan.
Na opslaan zie je in de radio-instellingen:
| Parameter | Waarde |
|---|---|
| Frequency | 869.618 MHz |
| Bandwidth | 62.5 kHz |
| Spreading Factor (SF) | 8 |
| Coding Rate (CR) | 8 |
Check
CR = 8. De firmware-default van veel builds is CR5. Kiezen voor "EU/UK Narrow" in de preset-selector past alle vier de parameters toe; vergeet daarna niet te controleren of CR ook effectief op 8 staat.
Kies een korte, herkenbare naam (bv. RRY09 Jan of je roepnaam). Deze naam verschijnt in adverts en in de contactenlijsten van anderen. De naam zelf mag je later gerust wijzigen.
Voor je het Public-kanaal gaat belasten met testberichten, doe je best een directe bereik-check. De app heeft een Discover Nearby Nodes-functie die een zero-hop-query uitstuurt; repeaters die je direct kan bereiken, antwoorden daarop. Zie je géén enkele repeater in het lijstje en zijn je instellingen toch correct? Dan zit je hoogstwaarschijnlijk in een "repeater-loze" zone — probeer hoger, buiten, of zet er zelf een op (zie Repeater Configureren).
⋮ → Tools → Discover Nearby Nodes.Discover Repeaters.#test, niet op PublicHet standaard Public-kanaal is géén testkanaal — daar chat een groot deel van de Belgische én Europese mesh op. Wil je iets uitproberen (berichten versturen, dekking checken, nieuwe node inwijden), doe dat dan op #test. Maar hou het beperkt, want ook dat gaat over radiogolven en kan andere berichten verstoren tot aan de andere kant van het land.
⋮ → + Add Channel → Join a Hashtag Channel → vul #test in.Sent zonder getal, dan heeft geen repeater jeDe publieke sleutel van je Companion is jouw identiteit in de mesh; iedereen die je een DM wil sturen, heeft die nodig. Maar ook jij hebt hun identiteit nodig vooraleer je met elkaar in privéberichten kan communiceren. Jij deelt de jouwe door een advert uit te zenden. Je publieke sleutel wordt automatisch gegenereerd op basis van je private sleutel — meer daarover in §6.1.
De naam van je Companion is puur ter weergave en kan je veranderen zonder dat dit impact heeft op de mesh.
Er zijn twee soorten adverts:
MeshCore-companions zenden adverts alleen als jij het initieert — niet automatisch, noch periodiek, in tegenstelling tot repeaters.
Gebruik flood-adverts met mate: ze nemen airtime in beslag voor iedereen in het netwerk.
Standaard voegt je Companion elk contact toe waarvan hij een advert opvangt: repeaters, room servers, andere companions én sensoren. In een drukke mesh loopt je contactenlijst zo snel vol — de praktische limiet ligt rond de 350 contacten.
Beperk daarom je auto-add-instellingen. In de Contact Settings van de app kan je per type kiezen wat automatisch toegevoegd wordt en welke afstand je daarbij accepteert. Een redelijke vuistregel:
Het Discover Contacts-scherm toont de adverts die je Companion recent heeft opgevangen, óók die je niet automatisch toevoegt. Vanaf dat scherm kan je gericht een contact aan je lijst toevoegen — bijvoorbeeld de dichtstbijzijnde repeaters via de kaartweergave, zodat je later een path-tracering kan doen om te zien via welke route een bericht binnenkwam.
Belangrijk: dit scherm vult zich enkel aan terwijl de app actief verbonden is met je Companion. Adverts die binnenkwamen toen de app niét verbonden was — én die niet onder je auto-add-regels vallen — verschijnen niet alsnog in deze lijst.
Vervang je ooit je hardware en wil je dat anderen je nog als dezelfde contactpersoon herkennen? Back-up je identity key vóór je het oude toestel wist. De MeshCore-app heeft een export-/importfunctie: je bewaart de sleutel veilig (bv. in een password manager), importeer hem achteraf op je nieuwe toestel.
⚙️ Settings → Manage Identity Key → Export. Bewaar de export veilig (password
manager, offline USB). Op het nieuwe toestel: Import.
Waarom dit ertoe doet: je publieke sleutel is je identiteit op de mesh. Genereer je een nieuw keypair (of doe je een factory reset zonder back-up), dan verschijn je bij iedereen als een nieuw contact náást het oude — berichten die men naar het oude contact stuurt, komen niet meer aan.
Nooit je private key delen, en nooit in een publiek Discord-kanaal of GitHub-issue plakken. Wie je private key heeft, kan zich als jou voordoen op het netwerk.
Vanaf firmware 1.14+ en app-versie 1.41.0+ kan je de hash-lengte van je berichten instellen via Settings → Experimental Settings (officiële FAQ §3.9.3):
Repeaters met firmware ouder dan 1.14 droppen 2- en 3-byte-berichten stilzwijgend. Zet je companion dus pas over wanneer je weet dat de repeaters die jouw verkeer dragen, mee zijn.
Aanpak voor #BEmesh. De community mikt op 2-byte als gezamenlijke standaard — voor de meeste Belgische gebruiksgevallen ruim voldoende, én het helpt analyse-tools zoals MeshMapper en de LetsMesh Analyzer om repeaters uit elkaar te houden. Een veilige migratievolgorde:
Via je Companion kan je een repeater of room server op afstand beheren over LoRa. Vul het admin-wachtwoord in dat je tijdens het configureren van je repeater hebt ingesteld.
De officiële MeshCore-app is freemium: remote admin werkt met een wachttijd per sessie die je via een in-app purchase kan wegnemen — dit is de enige betaalde feature in de app (officiële FAQ §1.1 / §2.2).
Details over wat je op afstand kan instellen, staat in Repeater Configureren.
De meest voorkomende oorzaak is dat de USB-only Companion-firmware geflasht is in plaats van de BLE-variant (officiële FAQ §6.4). Controleer je firmware-bestand en herflash met de BLE-build indien nodig.
Voor toestellen zonder scherm is de standaard pairing-code 123456 (FAQ §6.5). Heeft je toestel wél een scherm, lees dan de pincode af van het scherm zelf bij het pairen.
Heb je ooit een vaste pincode via de app ingesteld en ben je die vergeten? Dan is het best om het toestel opnieuw te configureren — let op dat dit ook je identity key wist (zie §6.1 voor back-up).
Voor nRF52-toestellen (RAK, T1000-E, Heltec T114, Xiao nRF52): officiële FAQ §6.7 documenteert een flash_erase-*.uf2-procedure. Voor toestellen met een user-knop is er daarnaast een CLI-rescue-mode vanaf firmware 1.7.0 (houd de user-knop ingedrukt binnen 8 seconden na boot).
be-*-codes in berichten.