MeshCore netwerk troubleshooting
Debug tools, log analysis en praktische oplossingen voor MeshCore problemen
Netwerk problemen oplossen
Zelfs met een goed geconfigureerd MeshCore netwerk kunnen er problemen optreden. Nodes die niet verbinden, berichten die niet aankomen, korte bereik of hoog battery drain - dit zijn veelvoorkomende issues waar je mee te maken kunt krijgen.
Deze troubleshooting guide helpt je systematisch problemen te identificeren en op te lossen. We behandelen de meest voorkomende issues, debug tools die je kunt gebruiken en stap-voor-stap oplossingen.
MeshCore heeft uitgebreide logging en diagnostics ingebouwd waarmee je precies kunt zien wat er gebeurt. Door deze tools te gebruiken en een structured approach te volgen, kun je de meeste problemen zelf oplossen.
Veelvoorkomende problemen en oplossingen
1. Node verbindt niet met het netwerk
Je node blijft "searching" of toont geen andere nodes in de lijst.
Oplossing:
Check configuratie: Zorg dat je op dezelfde frequency (868 MHz) en hetzelfde kanaal zit als het netwerk. Check ook je region settings (moet EU zijn voor Nederland). Controleer of je antenne goed vastzit en niet beschadigd is.
2. Berichten komen niet aan
Je verstuurt berichten maar ontvangers ontvangen ze niet.
Oplossing:
Check bereik: Ben je binnen radio range? In stedelijk gebied is dit ~1km, in open veld tot 10km. Check ook je transmit power settings - misschien staat deze te laag. Kijk in de logs of berichten worden geroute via repeaters.
3. Zeer korte batterijduur
Je battery is binnen enkele uren leeg in plaats van dagen.
Oplossing:
Verminder power gebruik: Zet transmit power lager (10-15dBm is vaak genoeg). Verhoog de broadcast interval van 15 naar 30-60 minuten. Schakel Bluetooth uit als je het niet gebruikt. Gebruik sleep mode tussen berichten.
4. Slechte signaal kwaliteit (SNR)
Berichten worden ontvangen maar met lage SNR (Signal-to-Noise Ratio).
Oplossing:
Verbeter antenne setup: Gebruik een betere antenne (5dBi of hoger). Plaats je node hoger (minimaal 2 meter boven de grond). Verwijder obstakels tussen nodes. Check of je antenne goed is afgestemd op 868 MHz.
5. Node reboot spontaan
Je node herstart zichzelf random, zonder duidelijke oorzaak.
Oplossing:
Power en firmware issues: Check je power supply - gebruik minimaal 500mA USB adapter. Update naar de nieuwste firmware versie. Check de serial logs voor crash reports. Mogelijk is je hardware defect - test met andere node.
Debug tools voor troubleshooting
Gebruik deze tools om precies te zien wat er gebeurt in je mesh netwerk
Serial monitor
Real-time logs via USB verbinding - zie alle events, errors en debug output
MeshCore app
Node lijst, signal strength, message history en configuratie in één app
Web interface
Browser-based config en monitoring voor advanced diagnostics
Python CLI
Command-line tool voor scripting, automation en bulk operations
MQTT monitoring
Real-time netwerk data naar MQTT broker voor logging en visualisatie
Log analysis tools
Parse en analyseer log files om patronen en problemen te identificeren
Diagnostics commando's
Gebruik deze commando's via CLI of serial monitor om je netwerk te diagnosticeren
Toon netwerk nodes
Zie alle nodes die je node kan detecteren met hun SNR en afstand:
Check radio statistieken
Bekijk radio metrics zoals transmit power, air utilization en packet stats:
Test connectiviteit
Stuur een test bericht naar een specifieke node en meet latency:
Dump configuratie
Export alle settings naar JSON om configuratie te controleren:
Troubleshooting checklist
-
☐
Firmware versie: Update naar nieuwste stable release
-
☐
Frequency instellingen: 868 MHz voor Europa (niet 915 MHz)
-
☐
Region settings: EU voor Nederland, niet US of andere regio
-
☐
Kanaal configuratie: Zelfde kanaal en encryption key als netwerk
-
☐
Antenne: Goed aangesloten, 868 MHz afgestemd, geen schade
-
☐
Power supply: Minimaal 500mA, stabiele voltage, goede kabel
Veelgestelde vragen
Hoe zie ik de debug logs van mijn node?
Sluit je node aan via USB en open een serial monitor (Arduino IDE, PlatformIO of screen/minicom op Linux). Baud rate is 115200. Je ziet dan real-time logs van alle events.
Wat betekent een lage SNR waarde?
SNR (Signal-to-Noise Ratio) geeft de kwaliteit van het signaal aan. Boven +5 dB is goed, -5 tot +5 dB is matig, onder -5 dB is slecht. Lage SNR betekent dat berichten vaak falen of corrupt raken.
Mijn node ziet wel nodes maar kan niet communiceren, waarom?
Dit kan komen door verkeerde encryption settings. Check of je encryption key overeenkomt met het kanaal waar je op probeert te communiceren. Ook kunnen firewallregels of channel access restrictions je blokkeren.
Hoe reset ik mijn node naar factory settings?
Gebruik het commando meshcore --factory-reset via CLI, of druk de reset knop op je device 10 seconden in. Let op: alle configuratie en berichten worden gewist!
Waar vind ik hulp als ik er zelf niet uitkom?
Join de MeshCore Telegram groep op t.me/meshcorenet. De community helpt graag met troubleshooting. Post je logs en configuratie voor snellere hulp.
Hulp nodig met troubleshooting?
De MeshCore community staat klaar om je te helpen met netwerk problemen
Deel je logs en vraag advies - samen lossen we het op!