MeshCore/ConfigureCompanion

Companion Configureren

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.

Twee soorten Companion-firmware

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.

App of web client installeren

De officiële clients vind je via het upstream app-portaal:

• Android / iOS / Windows / macOS / Linux — de officiële MeshCore-app, beschikbaar via meshcore.io
• Web client — app.meshcore.nz werkt in elke Chromium-browser (Chrome, Edge) en is de eenvoudigste keuze voor USB Serial. (handig voor oudere bardjes zonder bluetooth)

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.

Koppelen

BLE (smartphone, tablet)

1. Zet je Companion aan en zet Bluetooth aan op je telefoon.
2. Open de MeshCore-app → Connect (rechtsboven)
3. Kies je toestel uit de lijst.
4. Voer de pairing-pincode in:

  - Toestellen zonder scherm: standaard 123456.
  - Toestellen met scherm: de pincode verschijnt op het scherm van het toestel zelf.

USB Serial (computer)

1. Verbind je Companion via USB met de computer.
2. Open app.meshcore.nz in Chrome of Edge.
3. Connect → USB → kies je seriële poort in de browser-pop-up.

Radio-instellingen — *doe dit vóór je iets verstuurt*

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.

Preset: EU/UK (Narrow)

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.

Node-naam

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.

Eerste werkcheck

Is er een repeater in bereik?

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).

1. Menu ⋮ → Tools → Discover Nearby Nodes.
2. Tik Discover Repeaters.
3. Je Companion stuurt een zero-hop ping uit; repeaters die je direct horen, antwoorden.

Test op `#test`, niet op `Public`

Het 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.

1. ⋮ → + Add Channel → Join a Hashtag Channel → vul #test in.
2. Stuur een kort bericht.
3. Onder je bericht verschijnt een cijfer: het aantal directe repeater-herhalingen dat jouw

Companion zelf weer heeft opgevangen. Zie je Sent zonder getal, dan heeft geen repeater je gehoord.

Contacten en identiteit

Jouw publieke sleutel = jouw identiteit

De 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.

Adverts: zero-hop versus flood

Er zijn twee soorten adverts:

• Zero-hop — alleen nodes die jou rechtstreeks horen. Repeaters herhalen dit niet. (dit is eveneens het type advert die je kan doen via de menu op companion nodes met een scherm)
• Flood — alle repeaters die je advert horen, herhalen hem; daardoor verspreidt hij zich over het hele bereikbare netwerk.

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.

Auto-Add-Contacts beperken

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:

• Companions / chat users: enkel auto-add tot bijvoorbeeld 5 hops weg.
• Repeaters, room servers, sensoren: niet automatisch — voeg ze manueel toe via Discover Contacts (zie §5.4) als je ze écht nodig hebt.

Manueel toevoegen via Discover Contacts

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.

Geavanceerde instellingen (optioneel)

Identity key back-uppen

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.

Path Hash Mode (experimenteel)

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):

• 1 byte (standaard) — tot 64 hops, compatibel met alle repeater-firmwareversies.
• 2 of 3 byte — minder kans op ID-botsingen bij netwerkanalyse, maar lager max aantal hops (32 resp. 21).

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:

1. Stem met je buur-operators af zodat de repeaters in jouw omgeving op 2-byte staan (zie Repeater Configureren).
2. Laat je companion nog even op 1-byte staan tot iedereen die overstap gemaakt heeft.
3. Pas daarna zet je je companion ook op 2-byte.

Repeater op afstand beheren

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.

Problemen oplossen

Mijn Companion verschijnt niet in de Bluetooth-lijst

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.

Pincode wordt niet geaccepteerd

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).

Geen berichten ontvangen

• Preset & CR: controleer dat je werkelijk op de gedeelde radio-parameters zit (zie §3.1). Zelfs bij dezelfde frequentie geven afwijkende SF of CR onbetrouwbare decodes.
• Bereik: probeer §4.1 — zonder repeater in bereik krijg je alleen zero-hop-verkeer.
• Klok: contacten die "heel lang geleden gezien werden" tonen wijzen vaak op klokafwijking (§3.3, FAQ §6.1).

Toestel lijkt "bricked"

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).

Volgende stappen

• MeshCore-app — diepere gids — dagelijks gebruik, privéberichten, Room Servers.
• Repeater Configureren — eigen repeater plaatsen en instellen.
• Regio-scopes voor repeaters — wat betekenen die be-*-codes in berichten.
• Probleemoplossing — bredere troubleshooting-tips.

Ondersteuning

• Radio-Actief Discord — de #BEmesh-community.
• Officiële documentatie: meshcore.io, docs.meshcore.io, FAQ op GitHub.
• Bron-code & issues: github.com/meshcore-dev/MeshCore.