Dépannage

Les symptômes ci-dessous sont classés par fréquence réelle. Commencez toujours par le haut : la cause la plus banale est presque toujours la bonne.

« Je ne vois aucun nœud »

1. Les paramètres radio ne correspondent pas. C'est la cause dans la grande majorité des cas.

get radio

Doit renvoyer 869.618,62.5,8,8 pour le réseau français. Les valeurs d'usine 869.525,250,11,5 rendent le nœud totalement invisible.

set radio 869.618,62.5,8,8
reboot

2. Il n'y a réellement personne à portée. En LoRa, sans dégagement, la portée utile peut tomber à quelques centaines de mètres. Consultez la carte pour voir le répéteur le plus proche.

3. L'antenne. Antenne absente, mal vissée, ou prévue pour une autre bande. Une antenne 915 MHz sur du 868 MHz dégrade fortement le bilan de liaison.

4. Patience. Les annonces ne sont pas instantanées. Comptez plusieurs minutes, et forcez une annonce avec advert.

« Mon nœud voit les autres, mais personne ne le voit »

Asymétrie caractéristique d'un problème d'émission :

• Puissance trop faible — vérifiez avec get tx.
• Antenne défectueuse ou coaxial coupé : la réception reste possible alors que l'émission est très dégradée.
• Rapport cyclique atteint : le nœud a épuisé son quota d'émission et attend. Vérifiez get dutycycle.
• repeat désactivé sur un répéteur : get repeat doit renvoyer on.

« Le réseau est lent, les messages se perdent »

Symptôme d'encombrement.

• Annonces trop fréquentes. Le réglage le plus souvent mal ajusté. flood.advert.interval en dessous de 12 heures sur plusieurs répéteurs suffit à saturer une zone.
• Trop de trafic en diffusion large. Les messages de canal inondent par construction : sur un réseau chargé, privilégiez les messages directs.
• Répéteurs redondants. Deux répéteurs qui s'entendent parfaitement et couvrent la même zone doublent le trafic sans rien apporter.
• Boucles. Vérifiez get loop.detect ; minimal est le réglage courant en France.

« Mon répéteur redémarre tout seul »

• Alimentation. Cause n°1. Bloc USB de mauvaise qualité, câble trop fin, chute de tension en pic d'émission.
• Batterie en fin de vie ou trop froide. Relevez get pwrmgt.bootmv et get pwrmgt.bootreason.
• Surchauffe en plein soleil dans un boîtier étanche noir.
• Condensation dans le boîtier : à suspecter si les pannes suivent la météo.

« Je n'arrive pas à flasher »

• Câble USB sans fils de données — de très loin la cause la plus fréquente. Essayez un autre câble.
• Navigateur incompatible : le flasheur web exige Web Serial, donc Chrome, Edge ou Opera. Ni Firefox ni Safari.
• Pilote USB-série manquant (CP2102 ou CH340 selon la carte).
• Carte pas en mode bootloader : maintenir BOOT au branchement, ou double appui sur RESET selon le modèle.
• Port déjà occupé par un moniteur série resté ouvert.

« J'ai perdu l'accès à mon répéteur distant »

• Si vous aviez utilisé tempradio, attendez : le nœud revient de lui-même aux réglages précédents.
• Sinon, essayez de le joindre avec les anciens paramètres radio.
• En dernier recours, un déplacement et une liaison série s'imposent.

C'est précisément le scénario que tempradio permet d'éviter : prenez-en l'habitude.

« J'ai oublié le mot de passe administrateur »

Il n'y a pas de récupération à distance. Il faut un accès série, et éventuellement une réinitialisation d'usine :

erase

Destructif : toute la configuration, y compris l'identité du nœud, est perdue.

Commandes de diagnostic

ver              # version du micrologiciel
board            # matériel
get radio        # paramètres LoRa
get tx           # puissance
get repeat       # relayage actif
neighbors        # nœuds entendus récemment
stats-radio      # bruit, RSSI/SNR, temps d'antenne   (série)
stats-packets    # compteurs de paquets                (série)
stats-core       # batterie, uptime, file d'attente    (série)

Demander de l'aide

Si rien de ce qui précède ne s'applique, exposez le problème à la communauté en fournissant systématiquement :

• la sortie de ver et board ;
• la sortie de get radio ;
• le rôle du nœud et le matériel employé ;
• ce que vous avez déjà essayé.

Ces quatre éléments évitent trois allers-retours.