Le journal des trames indique ce que vos passerelles ont entendu et ce que le serveur réseau en a fait : jointures, liaisons montantes, liaisons descendantes et trames rejetées, avec la raison. C’est le premier endroit où regarder lorsqu’un appareil n’affiche pas de données.
Ouvrir
- Ouvrez Appareils.
- Ouvrez le menu ⋯ et sélectionnez Trames LoRaWAN.
Le tiroir Journal des trames affiche les 200 dernières trames de votre organisation, les plus récentes en premier, et les relit toutes les 5 secondes tant qu’il est ouvert. Sélectionnez le nom d’un appareil pour ouvrir son onglet LoRaWAN.
Le même tableau apparaît dans l’onglet LoRaWAN d’un appareil (ses propres trames) et dans l’onglet d’une passerelle (Trames entendues par cette passerelle).
Vous devez disposer de l’autorisation de consulter les trames LoRaWAN en direct (utilisateurs par défaut).
Durée de conservation des trames
Le journal est volontairement court : le dernier jour, au maximum 1 000 trames par organisation. Il n’est pas stocké dans la base de données et n’est pas exporté. Lorsqu’aucune trame n’a été reçue, le tableau indique No frames in the last day. Frames appear here as soon as a gateway hears one of your devices.
Pour conserver l’historique du signal, gardez les clés radio lora.* dans les messages de vos appareils et laissez votre flux racine les enregistrer.
Colonnes
| Colonne | Affiche |
|---|---|
| Heure | Moment où la trame a été traitée |
| Trame | Le type de trame (voir ci-dessous) |
| Appareil | Le nom de l’appareil, sinon son DevEUI, sinon le DevAddr en gris (une trame qui n’a pu être associée à aucun de vos appareils) |
| FCnt | Le compteur de trames |
| FPort | Le port applicatif. 0 signifie commandes MAC uniquement. |
| DR / MHz | Débit de données et fréquence, par exemple DR5 · 868.1 |
| Passerelles | Nombre de passerelles ayant entendu la trame, avec le meilleur RSSI et le SNR : 2 · best -97 dBm / 7.5 dB |
| Résultat | Ce qui s’est passé (voir ci-dessous) |
La recherche porte sur les noms d’appareils, DevEUI, DevAddr et mots de résultat. Filtrez par Trame et par Résultat. Triez par heure, FCnt ou FPort.
Types de trames
| Type | Signification |
|---|---|
| Liaison montante | Une trame de données non confirmée émise par un appareil |
| Liaison montante confirmée | Une trame de données dont l’appareil demande un accusé de réception |
| Demande de jointure | Un appareil OTAA demandant à rejoindre le réseau |
| Acceptation de jointure | La réponse du serveur réseau à une demande de jointure |
| Liaison descendante | Une trame envoyée à un appareil : un accusé de réception, des commandes MAC ou vos données |
| Rejetée | Une trame de données refusée par le serveur réseau |
Résultats
| Résultat | Signification |
|---|---|
| Traitée | Acceptée et transmise |
| Envoyée via passerelle (RX1 / RX2 / RXC) | Une liaison descendante ou une acceptation de jointure remise à cette passerelle dans cette fenêtre. RXC est une liaison descendante de classe C. |
| Retransmission | L’appareil a répété sa dernière liaison montante confirmée. Elle est de nouveau acquittée mais n’est pas livrée deux fois. |
| Raisons de rejet | Affiché en rouge ; voir ci-dessous |
Raisons de rejet
Trames de données
| Affiché comme | Code | Signification | Quoi vérifier |
|---|---|---|---|
| Adresse d’appareil inconnue | unknown_devaddr | Aucune session de vos appareils n’utilise ce DevAddr. | Un appareil OTAA qui n’a pas rejoint le réseau (ou dont la session a été réinitialisée) doit rejoindre. Pour un appareil ABP : vérifiez son DevAddr. |
| Un appareil d’un autre réseau | foreign_tenant | L’adresse appartient à un appareil d’une autre organisation que votre passerelle a entendu. | Rien ; c’est normal à proximité d’autres réseaux. |
| Échec du contrôle d’intégrité | mic_failed | Le MIC de la trame ne correspond pas à la clé de session. | ABP : le NwkSKey diffère de celui de l’appareil. OTAA : l’appareil utilise peut-être une ancienne session ; faites-le rejoindre à nouveau. |
| Trame rejouée | replay | Le compteur de trames n’a pas avancé. | Appareil ABP ayant redémarré ses compteurs : Réinitialiser les compteurs. Sinon, tentative de rejeu. |
| Saut du compteur de trames | fcnt_gap | Le compteur a sauté de plus de 16 384. | Un appareil ayant perdu l’état de son compteur. ABP : Réinitialiser les compteurs. OTAA : faites-le rejoindre à nouveau. |
bad_mtype, malformed | — | Pas une liaison montante LoRaWAN valide. | Généralement du bruit radio ou un émetteur non LoRaWAN. |
Demandes de jointure
| Affiché comme | Code | Signification |
|---|---|---|
| DevEUI inconnu | unknown_deveui | Le DevEUI n’est pas enregistré et aucune fenêtre d’appairage ne correspond. |
| Un appareil d’un autre réseau | foreign_tenant | Le DevEUI appartient à une autre organisation. |
| AppKey incorrecte | join_mic_failed | L’AppKey ne correspond pas à celle de l’appareil. |
| DevNonce déjà utilisé | devnonce_replay | La protection contre le rejeu a refusé le DevNonce. |
| Ajout en cours par le mode appairage | pairing_pending | Une fenêtre d’appairage a reconnu l’appareil et l’ajoute. Attendu une fois par appareil. |
| En attente d’approbation | pending_approval | L’appairage l’a ajouté ; il attend l’approbation. |
| Appareil ABP ayant envoyé une demande de jointure | not_otaa | L’appareil est enregistré en ABP mais tente une jointure OTAA. |
join_eui_mismatch | — | Le JoinEUI diffère de celui enregistré. |
no_appkey | — | Aucune AppKey n’est enregistrée pour l’appareil. |
mac_version_not_supported | — | La fiche de l’appareil indique une version LoRaWAN non prise en charge. |
Voir Dépannage des jointures et Dépannage des liaisons montantes et descendantes.
Confidentialité entre organisations
Une trame rejetée d’un appareil d’une autre organisation n’affiche que sa raison. Son adresse, son DevEUI et son propriétaire ne vous sont jamais montrés.
Via l’API
GET /tenant/<tenantId>/api/iot/lorawan/frames?deviceId=<id>&gatewayId=<id>&limit=200
limit va de 1 à 1 000 (par défaut 200). Les deux filtres sont facultatifs. Chaque trame contient t, type, result, reason, deviceId, deviceName, devEui, devAddr, fCnt, fPort, dr, freq, gateways (gatewayId, eui, rssi, snr), chosenGatewayId, window et bytes lorsqu’ils s’appliquent, ainsi que les valeurs décodées (decoded) d’une liaison montante traitée.

