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

2026-07-21T15:54:11Z

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

← Oudere versie		Versie van 21 jul 2026 17:54
Regel 217:		Regel 217:
	* Bron-code & issues: [https://github.com/meshcore-dev/MeshCore github.com/meshcore-dev/MeshCore].		* Bron-code & issues: [https://github.com/meshcore-dev/MeshCore github.com/meshcore-dev/MeshCore].

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

Maintenance script: Wiki.js import (polished)

2026-07-21T13:00:22Z

Wiki.js import (polished)

Wijzigingen bekijken

Maintenance script: Wiki.js import (polished)

2026-07-21T11:58:29Z

Wiki.js import (polished)

← Oudere versie		Versie van 21 jul 2026 13:58
Regel 104:		Regel 104:
	=== 5.1 Jouw publieke sleutel = jouw identiteit ===		=== 5.1 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 [[##61''identity''key''back''uppen\|§6.1]].		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 [[#61''identity''key''back''uppen\|§6.1]].

	<div class="mw-message-box mw-message-box-notice">		<div class="mw-message-box mw-message-box-notice">

Maintenance script: Wiki.js import (polished)

2026-07-21T11:57:48Z

Wiki.js import (polished)

Wijzigingen bekijken

Maintenance script: Wiki.js import

2026-07-21T11:52:56Z

Wiki.js import

Nieuwe pagina

= Companion Configureren =

Je hebt je toestel [[MeshCore/FlashFirmware|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.

<blockquote>
'''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 [[MeshCore/ConfigureRepeater|repeaters]] nodig — companions dragen daar niet aan bij.
</blockquote>

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

== 1. 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 [https://meshcore.io meshcore.io]
- '''Web client''' — [https://app.meshcore.nz 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 <code>Remote Admin</code>-wachttijd voor het op afstand beheren van repeaters kan je afkopen.

== 2. Koppelen ==

=== 2.1 BLE (smartphone, tablet) ===

1. Zet je Companion aan en zet '''Bluetooth aan''' op je telefoon.
2. Open de MeshCore-app → <code>Connect</code> (rechtsboven)
3. Kies je toestel uit de lijst.
4. Voer de '''pairing-pincode''' in:
- '''Toestellen zonder scherm''': standaard <code>123456</code>.
- '''Toestellen met scherm''': de pincode verschijnt op het scherm van het toestel zelf.

=== 2.2 USB Serial (computer) ===

1. Verbind je Companion via USB met de computer.
2. Open [https://app.meshcore.nz app.meshcore.nz] in Chrome of Edge.
3. <code>Connect</code> → '''USB''' → kies je seriële poort in de browser-pop-up.

== 3. 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.

=== 3.1 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: <code>⚙️ Settings</code> → <code>Choose Preset</code> → '''EU/UK (Narrow)''' → ✅ opslaan.

Na opslaan zie je in de radio-instellingen:

| Parameter | Waarde |
|---|---|
| Frequency | <code>869.618 MHz</code> |
| Bandwidth | <code>62.5 kHz</code> |
| Spreading Factor (SF) | <code>8</code> |
| Coding Rate (CR) | <code>8</code> |

<blockquote>
'''Check <code>CR = 8</code>.''' 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.
</blockquote>

=== 3.2 Node-naam ===

Kies een korte, herkenbare naam (bv. <code>RRY09 Jan</code> of je roepnaam). Deze naam verschijnt in adverts en in de contactenlijsten van anderen. De naam zelf mag je later gerust wijzigen.

== 4. Eerste werkcheck ==

=== 4.1 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 [[MeshCore/ConfigureRepeater|Repeater Configureren]]).

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

=== 4.2 Test op <code>#test</code>, niet op <code>Public</code> ===

Het standaard '''<code>Public</code>'''-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 <code>#test</code>. Maar hou het beperkt, want ook dat gaat over radiogolven en kan andere berichten verstoren tot aan de andere kant van het land.

1. <code>⋮</code> → <code>+ Add Channel</code> → '''Join a Hashtag Channel''' → vul <code>#test</code> 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 <code>Sent</code> zonder getal, dan heeft geen repeater je
gehoord.

== 5. Contacten en identiteit ==

=== 5.1 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 [[#61-identity-key-back-uppen|§6.1]].

<blockquote>
De naam van je Companion is puur ter weergave en kan je veranderen zonder dat dit impact heeft op de mesh.
</blockquote>

=== 5.2 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.

<blockquote>
Gebruik flood-adverts met mate: ze nemen airtime in beslag voor iedereen in het netwerk.
</blockquote>

=== 5.3 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 <code>Contact Settings</code> 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.

=== 5.4 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.

<blockquote>
'''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.
</blockquote>

== 6. Geavanceerde instellingen (optioneel) ==

=== 6.1 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.

<code>⚙️ Settings</code> → <code>Manage Identity Key</code> → '''Export'''. Bewaar de export veilig (password
manager, offline USB). Op het nieuwe toestel: '''Import'''.

<blockquote>
'''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.
</blockquote>

<blockquote>
'''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.
</blockquote>

=== 6.2 Path Hash Mode (experimenteel) ===

Vanaf firmware '''1.14+''' en app-versie '''1.41.0+''' kan je de hash-lengte van je berichten instellen via <code>Settings</code> → <code>Experimental Settings</code> (officiële [https://github.com/meshcore-dev/MeshCore/blob/main/docs/faq.md#393-q-how-do-i-change-my-companions-path-hash-size 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).

<blockquote>
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.
</blockquote>

'''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 [https://analyzer.letsmesh.net 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 [[MeshCore/ConfigureRepeater|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.

== 7. 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 [[MeshCore/ConfigureRepeater|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 [https://github.com/meshcore-dev/MeshCore/blob/main/docs/faq.md#22-q-does-meshcore-cost-any-money FAQ §1.1 / §2.2]).

Details over wat je op afstand kan instellen, staat in [[MeshCore/ConfigureRepeater|Repeater Configureren]].

== 8. 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 [https://github.com/meshcore-dev/MeshCore/blob/main/docs/faq.md#64-q-my-companion-isnt-showing-up-over-bluetooth 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 <code>123456</code> ([https://github.com/meshcore-dev/MeshCore/blob/main/docs/faq.md#65-q-i-cant-connect-via-bluetooth-what-is-the-bluetooth-pairing-code 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, [https://github.com/meshcore-dev/MeshCore/blob/main/docs/faq.md#61-q-my-client-says-another-client-or-a-repeater-or-a-room-server-was-last-seen-many-many-days-ago FAQ §6.1]).

=== Toestel lijkt "bricked" ===

Voor nRF52-toestellen (RAK, T1000-E, Heltec T114, Xiao nRF52): officiële [https://github.com/meshcore-dev/MeshCore/blob/main/docs/faq.md#67-q-my-rakt1000-exiao_nrf52-device-seems-to-be-corrupted-how-do-i-wipe-it-clean-to-start-fresh FAQ §6.7] documenteert een <code>flash_erase-*.uf2</code>-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).

== 9. Volgende stappen ==

- '''[[MeshCore/AppUsageInstructions|MeshCore-app — diepere gids]]''' — dagelijks gebruik, privéberichten, Room Servers.
- '''[[MeshCore/ConfigureRepeater|Repeater Configureren]]''' — eigen repeater plaatsen en instellen.
- '''[[MeshCore/RegioScopes|Regio-scopes voor repeaters]]''' — wat betekenen die <code>be-*</code>-codes in berichten.
- '''[[MeshCore/Troubleshooting|Probleemoplossing]]''' — bredere troubleshooting-tips.

== Ondersteuning ==

- [https://discord.gg/kvybAgqnhD Radio-Actief Discord] — de #BEmesh-community.
- Officiële documentatie: [https://meshcore.io meshcore.io], [https://docs.meshcore.io docs.meshcore.io], [https://github.com/meshcore-dev/MeshCore/blob/main/docs/faq.md FAQ op GitHub].
- Bron-code & issues: [https://github.com/meshcore-dev/MeshCore github.com/meshcore-dev/MeshCore].

[[Category:Radio-Actief]]

MeshCore/ConfigureCompanion - Bewerkingsoverzicht

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

Maintenance script: Wiki.js import (polished)

Maintenance script: Wiki.js import (polished)

Maintenance script: Wiki.js import (polished)

Maintenance script: Wiki.js import