Diagnosegids

MeshCore netwerk troubleshooting

Een praktische checklist om MeshCore-problemen snel te isoleren en correct op te lossen.

Begin altijd met een vaste volgorde

Veel storingen lijken complex, maar komen vaak neer op preset, voeding, antenne of configuratiemismatch.

Door stap voor stap te testen vermijd je willekeurige wijzigingen die het probleem onduidelijker maken.

Werk met logs en meetbare signalen, niet op basis van aannames.

Veelvoorkomende problemen

1. Node ziet geen netwerk

De node blijft zoeken of toont geen bruikbare peers.

Oplossing:

Controleer profiel en band: verifieer EU/UK preset, 868 MHz en correcte antenneaansluiting.

2. Berichten gaan verloren

Verzending lijkt te lukken, maar levering is onregelmatig.

Oplossing:

Controleer topologie: test kortere afstand, kijk naar SNR en bevestig dat repeaters actief zijn.

3. Batterij loopt te snel leeg

Autonomie is veel lager dan verwacht.

Oplossing:

Optimaliseer verbruik: beperk onnodige functies, pas intervallen aan en test met lager zendprofiel.

4. Lage SNR of ruisgevoelige links

Signaalkwaliteit is instabiel en wisselvallig.

Oplossing:

Verbeter RF-opstelling: verhoog antenne, vermijd obstakels en test andere plaatsing.

5. Spontane herstarts

Node reset zonder duidelijke trigger.

Oplossing:

Check voeding en firmware: gebruik stabiele voeding en draai een betrouwbare firmwareversie.

6. Bluetooth-koppeling mislukt

App vindt node niet of koppeling valt weg.

Oplossing:

Herkoppel proper: oude pairing verwijderen, node en gsm herstarten, opnieuw verbinden.

7. Instabiele verbinding op bepaald board

Disconnects blijven terugkomen op specifieke hardware.

Oplossing:

Isoleer hardwarefactoren: test andere kabel, poort en voeding; vergelijk met bekende firmwareissues.

8. Node reageert niet meer

Opstart blijft hangen of toestel lijkt corrupt.

Oplossing:

Recovery uitvoeren: reset/herflash volgens de juiste procedure voor jouw model.

9. WebFlasher werkt niet op Linux

Toestel verschijnt niet in browserselectie.

Oplossing:

Controleer rechten: serial-permissies, browsercompatibiliteit en mogelijke poortconflicten.

Handige diagnose-tools

Combineer meerdere bronnen voor snellere foutanalyse

1

Serial monitor

Realtime logs via USB voor diepere foutanalyse.

2

MeshCore app

Snel overzicht van nodes, basisstatus en profiel.

3

Web interface

Controle van instellingen en gedrag via browser.

4

Python CLI

Gerichte tests en geautomatiseerde checks.

5

MQTT monitoring

Live datastroom naar externe logging of dashboards.

6

Loganalyse

Herhalende patronen detecteren over langere periodes.

Diagnostische commando's

Gebruik commando's volgens je firmware- en toolingversie

Nodes bekijken

Toon zichtbare peers en linkkwaliteit.

meshcore --info nodes

Radiostatistieken opvragen

Bekijk relevante metrics voor zenden/ontvangen.

meshcore --info radio

Pad test met ping

Controleer praktische bereikbaarheid van een node-id.

meshcore --ping <node-id>

Config exporteren

Maak een snapshot voor vergelijking of rollback.

meshcore --export-config config.json

Snelcheck vóór diep debuggen

  • Firmware: stabiele versie en changelog nagekeken

  • Frequentie: 868 MHz profiel actief

  • Regio: juiste regio/scope-instellingen

  • Kanaal: gelijke key en kanaalparameters

  • Antenne: correct gemonteerd en geschikt

  • Voeding: stabiele spanning, geen dips

Veelgestelde vragen

Hoe lees ik bruikbare debuglogs?

Gebruik seriële logging en focus op events rond het exacte foutmoment.

Wat betekent negatieve of lage SNR?

Dat wijst op zwakke signaal-ruisverhouding; betere antenneplaatsing helpt vaak direct.

Waarom zie ik nodes maar lukt chat niet?

Controleer kanaalsleutel, profielovereenkomst en mogelijke configuratieverschillen.

Kan ik veilig resetten?

Ja, volg de officiële resetflow per board en maak indien mogelijk eerst een config-back-up.

Waar vind ik snelle ondersteuning?

Deel hardwaretype, logs en uitgevoerde stappen in de community voor gerichte hulp.

Diagnose wint van gokken

Met een vaste methode los je sneller op en houd je je netwerk stabiel op langere termijn.

Noteer elke wijziging en test telkens één variabele tegelijk.