Dépannage réseau MeshCore
Outils de debug, analyse des logs et solutions concrètes pour les problèmes MeshCore
Résoudre les problèmes réseau
Même avec un réseau MeshCore bien configuré, des soucis peuvent survenir. Des nœuds qui refusent de se connecter, des messages qui n'arrivent pas, une portée limitée ou une batterie qui se vide trop vite – voilà des problèmes courants auxquels vous pouvez être confronté.
Ce guide de dépannage vous aide à identifier et résoudre les problèmes de manière systématique. Nous passons en revue les soucis les plus fréquents, les outils de debug disponibles et les solutions étape par étape.
MeshCore dispose de logs et diagnostics étendus qui vous permettent de voir exactement ce qui se passe. En utilisant ces outils et en suivant une approche structurée, vous résoudrez la plupart des problèmes par vous-même.
Problèmes courants et solutions
1. Le nœud ne se connecte pas au réseau
Votre nœud reste bloqué sur « searching » ou n'affiche aucun autre nœud dans la liste.
Solution :
Vérifiez la configuration : Assurez-vous d'être sur la même fréquence (868 MHz) et le même canal que le réseau. Vérifiez aussi vos paramètres de région (doit être EU pour la Belgique). Contrôlez que votre antenne est bien fixée et non endommagée.
2. Les messages n'arrivent pas
Vous envoyez des messages mais les destinataires ne les reçoivent pas.
Solution :
Vérifiez la portée : Êtes-vous dans la portée radio ? En milieu urbain, c'est ~1 km, en terrain dégagé jusqu'à 10 km. Vérifiez aussi vos paramètres de puissance d'émission – ils sont peut-être trop bas. Consultez les logs pour voir si les messages sont routés via des répéteurs.
3. Autonomie de batterie très courte
Votre batterie est vide en quelques heures au lieu de quelques jours.
Solution :
Réduisez la consommation : Baissez la puissance d'émission (10-15 dBm suffit souvent). Augmentez l'intervalle de diffusion de 15 à 30-60 minutes. Désactivez le Bluetooth si vous ne l'utilisez pas. Activez le mode veille entre les messages.
4. Mauvaise qualité de signal (SNR)
Les messages sont reçus mais avec un SNR (Signal-to-Noise Ratio) faible.
Solution :
Améliorez votre installation antenne : Utilisez une meilleure antenne (5 dBi ou plus). Placez votre nœud plus en hauteur (minimum 2 mètres du sol). Supprimez les obstacles entre les nœuds. Vérifiez que votre antenne est bien accordée sur 868 MHz.
5. Le nœud redémarre spontanément
Votre nœud redémarre de manière aléatoire, sans cause apparente.
Solution :
Problèmes d'alimentation et de firmware : Vérifiez votre alimentation – utilisez au minimum un adaptateur USB de 500 mA. Mettez à jour vers la dernière version du firmware. Consultez les logs série pour les rapports de crash. Votre matériel est peut-être défectueux – testez avec un autre appareil.
6. L'appareil n'apparaît pas via Bluetooth
Votre appareil compagnon n'est pas détecté par l'application MeshCore sur votre GSM.
Solution :
Dépannage Bluetooth : Vérifiez que le Bluetooth est activé sur votre GSM. Éteignez et rallumez l'appareil. Sur Android : allez dans les paramètres de votre GSM → Bluetooth et oubliez l'appareil s'il était précédemment appairé, puis réessayez. Le code d'appairage Bluetooth par défaut est 123456.
7. Le Heltec V3 se déconnecte sans cesse
Votre Heltec V3 se connecte mais perd constamment la connexion.
Solution :
Problème connu : C'est un souci identifié sur certains lots de Heltec V3. Mettez à jour vers le dernier firmware via le flasher MeshCore. Si le problème persiste, essayez un autre câble ou port USB. Certains utilisateurs signalent que débrancher la batterie et alimenter uniquement via USB résout le problème.
8. L'appareil semble corrompu ou ne réagit plus
Votre appareil RAK ou T1000-E a un comportement étrange ou ne répond plus du tout.
Solution :
Procédure de réinitialisation : Pour les appareils RAK : maintenez le bouton reset enfoncé 10 secondes en connectant l'appareil via USB. Pour le T1000-E : utilisez l'application nRF Connect pour effectuer une réinitialisation DFU. Après la réinitialisation, reflashez le firmware via le flasher MeshCore.
9. Le WebFlasher ne fonctionne pas sous Linux
Le flasher web MeshCore ne parvient pas à se connecter à votre appareil sous Linux.
Solution :
Permissions USB : Sous Linux, il faut généralement configurer les permissions USB. Ajoutez-vous au groupe dialout : sudo usermod -a -G dialout $USER. Déconnectez-vous puis reconnectez-vous. Utilisez Chrome ou Edge (Firefox ne supporte pas totalement WebSerial).
Outils de debug pour le dépannage
Utilisez ces outils pour voir précisément ce qui se passe dans votre réseau mesh
Moniteur série
Logs en temps réel via connexion USB – consultez tous les événements, erreurs et sorties de debug
Application MeshCore
Liste des nœuds, force du signal, historique des messages et configuration dans une seule appli
Interface web
Configuration et monitoring via navigateur pour les diagnostics avancés
CLI Python
Outil en ligne de commande pour le scripting, l'automatisation et les opérations en masse
Monitoring MQTT
Données réseau en temps réel vers un broker MQTT pour le logging et la visualisation
Outils d'analyse de logs
Analysez les fichiers de logs pour détecter des schémas et identifier les problèmes
Commandes de diagnostic
Utilisez ces commandes via CLI ou moniteur série pour diagnostiquer votre réseau
Afficher les nœuds du réseau
Affichez tous les nœuds détectés avec leur SNR et leur distance :
Vérifier les statistiques radio
Consultez les métriques radio : puissance d'émission, utilisation du canal et statistiques de paquets :
Tester la connectivité
Envoyez un message test vers un nœud spécifique et mesurez la latence :
Exporter la configuration
Exportez tous les paramètres en JSON pour vérifier la configuration :
Checklist de dépannage
-
☐
Version firmware : Mettez à jour vers la dernière version stable
-
☐
Paramètres de fréquence : 868 MHz pour l'Europe (pas 915 MHz)
-
☐
Paramètres de région : EU pour la Belgique, pas US ni autre région
-
☐
Configuration du canal : Même canal et clé de chiffrement que le réseau
-
☐
Antenne : Bien connectée, accordée sur 868 MHz, aucun dommage
-
☐
Alimentation : Minimum 500 mA, tension stable, câble fiable
Questions fréquentes
Comment consulter les logs de debug de mon nœud ?
Connectez votre nœud via USB et ouvrez un moniteur série (Arduino IDE, PlatformIO ou screen/minicom sous Linux). Le baud rate est 115200. Vous verrez alors en temps réel les logs de tous les événements.
Que signifie une valeur SNR basse ?
Le SNR (Signal-to-Noise Ratio) indique la qualité du signal. Au-dessus de +5 dB c'est bon, entre -5 et +5 dB c'est moyen, en dessous de -5 dB c'est mauvais. Un SNR bas signifie que les messages échouent ou sont corrompus fréquemment.
Mon nœud détecte des nœuds mais ne peut pas communiquer, pourquoi ?
Cela peut provenir de paramètres de chiffrement incorrects. Vérifiez que votre clé de chiffrement correspond au canal sur lequel vous tentez de communiquer. Des restrictions d'accès au canal ou des règles de pare-feu peuvent également vous bloquer.
Comment remettre mon nœud en configuration d'usine ?
Utilisez la commande meshcore --factory-reset via CLI, ou maintenez le bouton reset de votre appareil enfoncé pendant 10 secondes. Attention : toute la configuration et les messages seront effacés !
Où trouver de l'aide si je n'y arrive pas seul ?
Rejoignez le groupe Telegram MeshCore sur t.me/meshcorenet. La communauté est toujours prête à aider avec le dépannage. Partagez vos logs et votre configuration pour obtenir une aide plus rapide.
Besoin d'aide pour le dépannage ?
La communauté MeshCore est là pour vous aider à résoudre les problèmes réseau
Partagez vos logs et demandez conseil – ensemble, on trouve la solution !