Dépannage des uplinks et downlinks

Utilisez cette page lorsqu’un appareil LoRaWAN est connecté (ou est un appareil ABP) mais que ses mesures n’arrivent pas, arrivent erronées, ou que ses downlinks ne lui parviennent pas. Commencez par le journal des trames et l’onglet LoRaWAN de l’appareil.

Les uplinks n’arrivent pas

Le journal des trames affiche	Cause	Que faire
Rien de la part de l’appareil	Aucune passerelle ne l’a reçu.	Vérifiez qu’une passerelle proche est Online ; vérifiez la batterie de l’appareil et qu’il émet (sa propre LED ou son outil).
Adresse d’appareil inconnue	Aucune de vos sessions ne possède ce DevAddr. OTAA : l’appareil utilise une ancienne session (par exemple après que vous avez utilisé Reset session), ou il ne s’est jamais connecté. ABP : le DevAddr diffère de celui enregistré.	OTAA : faites-le se reconnecter. ABP : vérifiez le DevAddr.
Échec du contrôle d’intégrité	Le MIC de la trame ne correspond pas à la clé de session. ABP : le NwkSKey diffère. OTAA : ancienne session après une reconnexion de l’appareil ailleurs.	ABP : saisissez à nouveau les clés avec Replace keys. OTAA : faites-le se reconnecter.
Trame rejouée	Le compteur n’a pas avancé.	Appareil ABP redémarré : Reset counters. Sinon, quelqu’un peut rejouer des trames enregistrées.
Saut du compteur de trames	Le compteur a sauté de plus de 16 384.	ABP : Reset counters. OTAA : faites-le se reconnecter.
Traitée	Le serveur de réseau l’a acceptée.	Le problème se situe après le serveur de réseau ; voir ci-dessous.

Traitée, mais aucune mesure sur l’appareil

Vérification	Cause et correction
FPort est 0	Trame MAC uniquement ; elle ne transporte jamais de mesures. Normal.
Le message de l’appareil ne contient que `raw`	Aucun codec ne l’a décodé. Choisissez un codec sur l’appareil ou le profil ; voir Codecs. Testez avec le Test bench du codec.
Les valeurs arrivent avec des noms étranges	Le codec utilise les noms de clés du fabricant. Voir Nettoyer les valeurs décodées.
Aucune donnée enregistrée	Le flux racine (organisation ou profil) n’a pas d’étape Save telemetry, ou un flux échoue. Vérifiez le flux et ses messages en échec.
L’appareil est retenu	Un appareil ajouté par le mode appairage n’enregistre rien tant qu’il n’est pas approuvé.

Les mesures sont erronées

Décodez la même charge utile sur le Test bench du codec et comparez avec la documentation du fabricant.
Vérifiez qu’un autre codec n’a pas été choisi que vous ne le pensez : d’abord le choix de l’appareil, puis le profil, puis le choix automatique.
Lorsque le codec choisi a été retiré ou supprimé, l’appareil revient au choix automatique ; choisissez à nouveau un codec.

Doublons et trames manquantes

Un uplink reçu par plusieurs passerelles correspond à un seul message de l’appareil. Les copies sont fusionnées dans une courte fenêtre (200 ms par défaut). Une copie arrivant plus tard est ignorée comme tardive ; elle ne crée jamais un second message.
Un uplink confirmé que l’appareil répète parce qu’il n’a pas reçu l’acquittement apparaît comme Retransmission. Il est acquitté à nouveau, jamais enregistré deux fois.
Les trous dans FCnt correspondent à des trames qu’aucune passerelle n’a reçues. Quelques trous sont normaux pour la radio. De nombreux trous indiquent une couverture faible : consultez le RSSI et le SNR dans Latest reception et envisagez une autre passerelle.

L’appareil apparaît hors ligne alors qu’il émet

Les appareils LoRaWAN du profil intégré sont en ligne tant que le dernier uplink est plus récent que trois intervalles attendus (3 heures avec l’intervalle par défaut de 3 600 s). Un appareil qui émet moins souvent qu’une fois par heure apparaît hors ligne entre deux envois. Augmentez l’intervalle attendu dans l’onglet Online status du profil pour correspondre à l’appareil. Voir État de connexion et activité.

Les downlinks n’arrivent pas

Symptôme	Cause	Que faire
La commande reste en file d’attente (Class A)	Un appareil Class A ne reçoit qu’après avoir émis.	Attendez le prochain uplink, ou faites émettre l’appareil.
La commande reste en file d’attente (Class C)	Le dernier uplink de l’appareil date de plus de 15 minutes, donc il attend le suivant. Ou l’appareil est enregistré en Class A.	Vérifiez la classe dans l’onglet LoRaWAN.
Commande EXPIRED	Son délai d’expiration est dépassé, ou les paramètres étaient incorrects (`fPort` hors de 1–223, `data` ni hexadécimal ni base64), ou la charge utile était trop volumineuse.	Vérifiez les paramètres et les tailles dans Envoi de downlinks.
Commande TIMEOUT	Elle a été envoyée en bidirectionnel ; les appareils LoRaWAN ne répondent pas aux commandes.	Envoyez `lora.downlink` en unidirectionnel.
Downlink Sent via … mais l’appareil ne fait rien	FPort ou octets incorrects pour cet appareil, ou l’appareil n’a pas reçu la commande.	Vérifiez le format de downlink du fabricant. Utilisez `"confirmed": true` pour savoir si l’appareil l’a reçu.
Les downlinks passent souvent par RX2	L’aller-retour de la passerelle est trop lent pour RX1, ou le cycle d’utilisation RX1 est épuisé.	Vérifiez le Round trip de la passerelle et `lora.gw.dc_used_pct.*`. Gardez le délai RX1 à 5 s.

Cycle d’utilisation

Lorsque le budget de cycle d’utilisation d’une passerelle dans une sous-bande est presque épuisé, les downlinks attendent ou passent par une autre passerelle, et l’alarme par défaut de la passerelle avertit au-delà de 80 %. Causes fréquentes :

Nombreux appareils envoyant des uplinks confirmés ; chacun nécessite un acquittement. Passez les capteurs en uplinks non confirmés.
Changements ADR fréquents sur des appareils au signal instable. Désactivez l’ADR pour les appareils mobiles.
Nombreux downlinks confirmés avec retransmissions.

Voir Régions et plans de fréquences.

Problèmes de passerelle

Symptôme	Points à vérifier
Passerelle Offline	Son alimentation et sa liaison internet ; son jeton et son adresse. Voir Connecter une passerelle Basics Station.
Round trip supérieur à 800 ms	La liaison internet de la passerelle (réseau mobile, Wi-Fi).
Nombreux downlinks en échec	Le journal propre de la passerelle ; une radio surchargée ou son cycle d’utilisation.