Utilisez cette page lorsqu’un appareil OTAA reste sur Not joined yet ou affiche une jonction refusée. Partez des éléments concrets : le badge de jonction de l’appareil dans son onglet LoRaWAN, et ses demandes de jonction dans le journal des trames (Devices > ⋯ > LoRaWAN frames).
Étape 1 : la demande de jonction est-elle reçue ?
Recherchez les lignes Join request portant le DevEUI de l’appareil dans le journal des trames pendant que vous mettez l’appareil sous tension.
| Vous voyez | Signification | Action à mener |
|---|---|---|
| Aucune demande de jonction | Aucune de vos passerelles n’a reçu l’appareil. | Vérifiez qu’une passerelle proche de l’appareil est Online. Vérifiez que l’appareil est un appareil EU868 et qu’il tente bien de rejoindre le réseau (beaucoup d’appareils nécessitent une pression sur un bouton ou un aimant). Rapprochez l’appareil de la passerelle pour tester. |
| Demandes de jonction, mais le nom de l’appareil est absent | Le DevEUI ne correspond à aucun de vos appareils. | Voir « Unknown DevEUI » ci-dessous. |
| Demandes de jonction avec un résultat en rouge | Le serveur de jonction l’a refusée. | Trouvez la raison dans le tableau ci-dessous. |
| Une ligne Join accept avec Sent via … mais l’appareil continue de demander | L’appareil n’a pas reçu ou n’a pas accepté la réponse. | Voir « Join accept sent, device keeps trying » ci-dessous. |
Étape 2 : les motifs de refus
| Badge ou journal des trames | Code | Cause | Action à mener |
|---|---|---|---|
| Unknown DevEUI | unknown_deveui | Le DevEUI n’est pas enregistré et aucune fenêtre d’appairage ne correspond. | Vérifiez le DevEUI indiqué sur l’étiquette de l’appareil par rapport à celui que vous avez saisi (16 chiffres, sans inversion d’octets). Ajoutez l’appareil, ou activez le mode d’appairage. |
| Un appareil d’un autre réseau | foreign_tenant | Le DevEUI appartient à une autre organisation. | Si l’appareil vous appartient, il a été enregistré ailleurs auparavant. Il doit y être supprimé. Hermetry ne précise jamais où. |
| Jonction refusée : mauvais AppKey ? / Wrong AppKey | join_mic_failed | Le contrôle d’intégrité a échoué avec l’AppKey enregistrée. | Saisissez à nouveau l’AppKey depuis la fiche du fournisseur, sous Keys > New AppKey. Vérifiez que vous n’avez pas confondu l’AppKey avec une autre clé. Pour les appareils ajoutés par appairage : vérifiez l’AppKey partagée du profil. |
| Jonction refusée : autre JoinEUI | join_eui_mismatch | L’appareil envoie un JoinEUI différent de celui enregistré. | Remplacez le JoinEUI enregistré par celui envoyé par l’appareil (souvent 0000000000000000), ou activez anyJoinEui pour l’appareil via l’API. |
| Jonction refusée : DevNonce déjà utilisé / DevNonce used before | devnonce_replay | L’appareil a réutilisé un DevNonce. Cela arrive souvent avec les appareils 1.0.4 après une réinitialisation d’usine (leur DevNonce repart de 0). | Laissez l’appareil continuer d’essayer : il passe à de nouvelles valeurs. Sinon, définissez à nouveau son AppKey (Replace keys), ce qui efface l’historique des DevNonce. |
| Aucune AppKey enregistrée | no_appkey | L’appareil n’a pas de clé. | Définissez une AppKey sous Keys. |
| En attente d’approbation | pending_approval | Le mode d’appairage a ajouté l’appareil ; personne ne l’a approuvé. | Approuvez-le. |
| Ajout en cours par le mode d’appairage | pairing_pending | Normal : c’est la première demande reçue d’un appareil en mode d’appairage. | Attendez la prochaine demande de jonction de l’appareil. |
| Appareil ABP : il ne rejoint pas / ABP device sent a join request | not_otaa | L’appareil est enregistré en ABP mais fonctionne en OTAA. | Supprimez-le et ajoutez-le à nouveau en OTAA. |
| Jonction refusée (mac_version_not_supported) | mac_version_not_supported | La version LoRaWAN enregistrée n’est ni 1.0.2, ni 1.0.3, ni 1.0.4. | Définissez une version prise en charge. Les appareils LoRaWAN 1.1 doivent être basculés en mode 1.0.x. |
Join accept envoyé, l’appareil continue d’essayer
Le serveur de jonction a accepté la demande et une passerelle a envoyé la réponse, mais l’appareil renvoie à nouveau des demandes de jonction.
| Cause possible | Points à vérifier |
|---|---|
| L’appareil est trop loin de la passerelle pour recevoir la réponse | Les uplinks atteignent la passerelle mais la réponse n’atteint pas l’appareil. Vérifiez le RSSI et le SNR de la demande de jonction ; essayez plus près de la passerelle. |
| Une limite de duty cycle sur la passerelle | Les valeurs lora.gw.dc_used_pct.<band> de la passerelle ; de nombreux uplinks ou downlinks confirmés peuvent épuiser le budget. |
| Le temps d’aller-retour de la passerelle est trop long | La Round trip de la passerelle. Un join accept part 5 s (RX1) ou 6 s (RX2) après la demande ; une liaison plus lente manque les deux fenêtres. |
| Mauvaise région sur l’appareil | L’appareil doit être un appareil EU868. |
| La passerelle n’émet pas | Consultez le journal propre à la passerelle et lora.gw.dn_failed / lora.gw.dn_unknown. |
Join answer non envoyée (aucune passerelle à temps)
Le serveur de jonction a accepté la demande, mais aucune passerelle n’a pu envoyer la réponse à temps : toutes les passerelles ayant reçu la demande étaient hors ligne, désactivées, en mode local, à court de budget de duty cycle, ou trop lentes pour les deux fenêtres. Vérifiez les passerelles proches de l’appareil. L’appareil réessaie automatiquement.
Après une jonction réussie, aucune donnée
Le badge indique Joined, mais aucune mesure n’arrive. Voir Dépannage des uplinks et downlinks.
Toujours bloqué
Relevez le DevEUI de l’appareil, l’heure d’une tentative de jonction et une capture d’écran des lignes du journal des trames, puis contactez le support.