Utilisez cette page lorsqu’un appareil OTAA reste sur Not joined yet ou affiche un join refusé. Appuyez-vous sur les faits : le badge de join de l’appareil dans son onglet LoRaWAN, et ses requêtes de join dans le journal des trames (Devices > ⋯ > LoRaWAN frames).
Étape 1 : la requête de join est-elle reçue ?
Recherchez les lignes Join request avec le DevEUI de l’appareil dans le journal des trames pendant que vous mettez l’appareil sous tension.
| Vous voyez | Signification | Que faire |
|---|---|---|
| Aucune requête de join | 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 utilise le même plan de fréquences que la passerelle et qu’il tente réellement de joindre le réseau (beaucoup d’appareils nécessitent un appui sur un bouton ou un aimant). Rapprochez l’appareil de la passerelle pour tester. |
| Requêtes de join, mais le nom de l’appareil est absent | Le DevEUI ne correspond à aucun de vos appareils. | Voir « Unknown DevEUI » ci-dessous. |
| Requêtes de join avec un résultat en rouge | Le serveur de join 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 accepté la réponse. | Voir « Join accept sent, device keeps trying » ci-dessous. |
Étape 2 : les raisons de refus
| Badge ou journal des trames | Code | Cause | Que faire |
|---|---|---|---|
| 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 ordre des octets inversé). 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é auparavant ailleurs. Il doit y être supprimé. Hermetry n’indique jamais où. |
| Join refusé : AppKey incorrecte ? / Wrong AppKey | join_mic_failed | La vérification d’intégrité a échoué avec l’AppKey enregistrée. | Saisissez à nouveau l’AppKey à partir de 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. |
| Join refusé : 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. |
| Join refusé : DevNonce déjà utilisé / DevNonce used before | devnonce_replay | L’appareil a réutilisé un DevNonce. Fréquent 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, saisissez à 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. |
| En cours d’ajout par le mode d’appairage | pairing_pending | Normal : la première requête d’un appareil détectée en mode d’appairage. | Attendez la prochaine requête de join de l’appareil. |
| Appareil ABP : il ne joint 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. |
| Join refusé (mac_version_not_supported) | mac_version_not_supported | La version LoRaWAN enregistrée n’est pas 1.0.2, 1.0.3 ou 1.0.4. | Définissez une version prise en charge. Les appareils LoRaWAN 1.1 doivent passer en mode 1.0.x. |
Join accept envoyé, l’appareil continue d’essayer
Le serveur de join a accepté la requête et une passerelle a envoyé la réponse, mais l’appareil renvoie de nouvelles requêtes de join.
| 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 requête de join ; 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. |
| L’aller-retour de la passerelle est trop lent | Le Round trip de la passerelle. Un join accept part 5 s (RX1) ou 6 s (RX2) après la requête ; une liaison plus lente manque les deux fenêtres. |
| Mauvaise région sur l’appareil | L’appareil doit utiliser le même plan de fréquences que la passerelle. |
| La passerelle n’émet pas | Vérifiez le journal propre à la passerelle ainsi que lora.gw.dn_failed / lora.gw.dn_unknown. |
Réponse de join non envoyée (aucune passerelle à temps)
Le serveur de join a accepté la requête, mais aucune passerelle n’a pu envoyer la réponse à temps : toutes les passerelles qui l’ont reçue é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 de lui-même.
Après un join réussi, 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 join et une capture d’écran des lignes du journal des trames, puis contactez le support.

