Paquets Uplink LoRaWAN®
Ce sujet décrit les informations de référence sur les paquets uplink LoRaWAN®.
Paquets uplink
Les paquets uplink sont des paquets LoRaWAN® envoyés par les capteurs au réseau ThingPark, soit directement, soit par l'intermédiaire d'un relais LoRaWAN®. Ils sont représentés dans le Wireless Logger par des icônes bleues :
illustre un paquet uplink reçu à l'heure par le réseau central LRC et signalé avec succès aux destinations d'application associées à ce capteur. À l'heure signifie que le paquet a été immédiatement transmis par la passerelle au cœur de réseau.
illustre un paquet uplink reçu en retard par le réseau central LRC (
Lsignifie « En retard »). Cela serait typiquement le cas d'un paquet mis en attente par la passerelle en raison d'un problème temporaire de connexion au réseau avec le cœur de réseau, puis transmis plus tard au réseau après rétablissement de la connexion.illustre un paquet uplink reçu dans le cadre d'un accord d'itinérance passive avec un réseau LoRaWAN® pair (
Rsignifie « Itinérance »). Pour en savoir plus, voir Paquets d'itinérance passive.illustre un paquet uplink acheminé via un relais LoRaWAN.
Fsignifie "Transmis". Pour en savoir plus, voir Utilisation des relais LoRaWAN.
Le statut de livraison du paquet uplink aux serveurs d'application externes via le protocole HTTPS est illustré comme suit :
- En cas de signalement réussi à toutes les applications cibles, aucun point coloré n'apparaît, par exemple
.
- Lorsque la livraison échoue à la destination préférée pour au moins un serveur d'application
mais que le paquet est livré avec succès à une destination secondaire associée à cette même application, un point orange s'affiche.
- Exemple :
,
ou
.
- Exemple :
- Lorsque la livraison échoue complètement pour au moins un serveur d'application, un point rouge
s'affiche.
- Exemple :
,
ou
.
- Exemple :
Dans chaque cas, le statut détaillé de la transmission est affiché dans le panneau extensible.
L'affichage du statut de la transmission vers les serveurs d'application externes ne s'applique que aux applications intégrées à ThingPark via le type de connexion HTTP basique (également appelé interface tunnel NS/AS). Il ne s'applique pas aux connexions utilisant ThingPark X IoT Flow.
Vous pouvez afficher et filtrer plusieurs catégories de paquets uplink dans Wireless Logger en fonction de leur contenu. Une trame est un paquet.
| Paquet uplink | Contenu | Description |
|---|---|---|
| Trames MAC | Lorsqu'un paquet uplink est étiqueté uniquement mac, cela signifie qu'il ne contient aucun Payload de données applicatives à destination du serveur d'applications. Ces paquets sont soit des paquets uplink transportant uniquement des commandes MAC de couche 2 LoRaWAN® et/ou des accusés de réception MAC d'un paquet downlink confirmé précédent. | |
| Trames de données | Ces paquets uplink contiennent un Payload de données applicatives qui est routé vers les serveurs d'applications mais ne contiennent aucune commande MAC. | |
| Trames MAC + Données | Ces paquets uplink contiennent à la fois des commandes/accusés de réception MAC et un Payload de données applicatives. | |
| Trames de demande d'adhésion | Ces paquets uplink sont pertinents uniquement pour les capteurs OTAA. |
Déduplication des paquets uplink
Les paquets uplink répétés sont dédupliqués par le network server LRC, de sorte qu'ils ne sont pas envoyés plusieurs fois aux serveurs d'applications ou à TWA/Wireless Logger. Ensuite, lorsqu'un capteur envoie le même paquet uplink plusieurs fois au LRC network server (en cas de répétition de trame), un seul paquet uplink est affiché dans Wireless Logger.
Exemple Si le capteur transmet 3 fois le même paquet uplink avec le compteur de trame numéro 39 (si le nombre de transmissions contrôlé par l'algorithme ADR est réglé sur 3 dans ce cas), et si ce même paquet est reçu plus d'une fois par le network server, seule la première copie reçue est affichée par Wireless Logger tandis que les autres copies reçues pour ce même paquet ne sont pas visibles.
Réception des passerelles et meilleur LRR
Wireless Logger peut afficher jusqu'à dix passerelles qui ont reçu le même paquet uplink.
Chaque passerelle est identifiée par le LRR ID recevant le paquet uplink et affiche les métadonnées radio associées à la réception telles que le RSSI, le SNR et l'ESP. Pour plus d'informations, métriques radio LoRaWAN®.
Lorsque le même paquet uplink est reçu par plusieurs passerelles, ThingPark identifie le meilleur-LRR comme étant le LRR qui a reçu le paquet uplink avec le plus haut SNR (Rapport Signal sur Bruit).
Pour plus d'informations, voir le tableau LRR dans Panneau extensible uplink.
Colonnes de métadonnées uplink
Les métadonnées constituent une série d'informations relatives à la transmission ou à la réception de chaque paquet uplink. Pour plus d'informations, voir Uplinks passifs roaming LoRaWAN®.
Les métadonnées uplink les plus importantes sont affichées directement sous forme de colonnes distinctes dans Wireless Logger et sont répertoriées dans le tableau suivant. Pour plus d'informations sur les autres métadonnées affichées dans le panneau extensible du paquet, voir Panneau extensible uplink.
Cet ensemble de métadonnées s'applique également aux montées en itinérance passive. Pour plus d'informations, voir Paquets LoRaWAN® en itinérance passive.
| Métadonnées | Description |
|---|---|
| Direction du message | La flèche verte montre le paquet uplink (du capteur au réseau) ; la flèche rouge montre le paquet Downlink (du réseau au capteur). |
| Type de message | data indique que le paquet contient une Payload applicative mesurée par le capteur (température, coordonnées GPS, etc.). mac indique que le paquet contient certaines commandes de service de couche MAC (modification ADR, etc.). join indique le message de demande d'adhésion (pour les capteurs OTAA). Voir Paquets uplink pour plus de détails. |
| Horodatage UTC | Horodatage UTC, utilisant le format ISO 8601. |
| Horodatage local | Horodatage traduit dans le fuseau horaire du navigateur, utilisant le format ISO 8601. |
| DevAddr | Adresse du capteur (4 octets). |
| DevEUI | Device EUI (8 octets) est un identifiant global de capteur dans l'espace d'adressage IEEE EUI64 qui identifie de manière unique le capteur. Si le network server agit comme forwarding network server (fNS) et que le type de message est data, le DevEUI n'est disponible que si la version des LoRaWAN® Backend Interfaces est > 1.0. |
| FPort | Port d'application du paquet. |
| FCnT | Compteur de trame uplink. |
| LRR RSSI | RSSI (Indicateur de force du signal reçu) du paquet uplink reçu côté LRR. Pour en savoir plus sur la définition du RSSI, voir Métriques RF. |
| LRR SNR | SNR (Rapport signal sur bruit) du paquet uplink reçu côté LRR. Pour en savoir plus sur la définition du SNR, voir Métriques RF. |
| LRR ESP | ESP (Puissance de signal estimée) du paquet uplink reçu sur le côté LRR. Pour en savoir plus sur la définition de l'ESP, voir Métriques RF. |
| SF/DR | Facteur de Spreading ou Taux de Données du paquet uplink. |
| Sous-bande | Sous-bande de fréquence radio correspondant au canal logique utilisé pour transmettre le paquet uplink par le capteur. |
| Canal | Canal logique utilisé pour transmettre le paquet uplink par le capteur. |
| LRC Id | Identifiant du network server LRC. |
| Relay Id | DevEUI du relais qui a transmis le paquet uplink à partir de l'Device de terminaison. |
| LRR ID | ID du meilleur LRR ayant reçu le paquet uplink avec le SNR le plus élevé. Pour le cas d'utilisation en itinérance (itinérance passive sNS), l'identifiant LRR correspond à l'identité de la meilleure passerelle étrangère si cet identifiant a été signalé par fNS, sinon un identifiant LRR virtuel est affiché dans le Wireless Logger. |
| LRR Lat | Latitude du meilleur LRR. |
| LRR Long | Longitude du meilleur LRR. |
| LRR GwCnt | Nombre de passerelles LRR (passerelles LRR) recevant le paquet uplink. Le système effectue un tampon de 250 ms lors de la réception d'un paquet uplink pour vérifier si le même paquet arrive par d'autres LRR, et le décompte LRR est alors agrégé dans cette fenêtre de déduplication de 250 ms. |
| Latitude du capteur / Longitude du capteur / Distance LoS (m) / Carte / Trajet | Respectivement : Latitude du capteur / Longitude du capteur / Distance entre le capteur et le meilleur LRR / Affiche le capteur et la passerelle LRR sur une carte / Affiche le chemin d'emplacement du capteur (si l'emplacement du capteur est disponible). Les données GPS sont renseignées uniquement si le capteur donne son emplacement : - Emplacement manuel : Provisionné dans l'application Gestionnaire de capteur - Emplacement GPS signalé par le capteur dans le payload uplink : Cette option n'est valide que si le décodeur de payload est sélectionné et que la clé de session de l'application (AppSKey) du capteur est connue de ThingPark.Pour plus d'informations, voir Affichage des Payloads décodés - Géolocalisation basée sur le réseau : basée sur des algorithmes de géolocalisation TDoA/RSSI. |
| MIC | Somme de contrôle de l'intégrité du message. |
Panneau extensible uplink
Les éléments suivants sont affichés dans le panneau extensible pour chaque
paquet uplink LoRaWAN®. Pour accéder au panneau extensible de chaque paquet,
cliquez sur le côté gauche du paquet.
Ce sujet s'applique également aux montées en itinérance passive. Pour plus d'informations, voir Paquets LoRaWAN® en itinérance passive.
| Champ | Description |
|---|---|
| Mtype | Indique le type de message : ConfirmedDataUp, UnConfirmedDataUp, ou JoinRequest: - La demande d'adhésion est envoyée par les capteurs OTAA pour demander un accès initial au réseau. Elle est affichée dans Wireless Logger avec le logo - Si le paquet uplink nécessite un accusé de réception par le réseau, il est envoyé en mode CONFIRMÉ. Dans ce cas, Wireless Logger affiche le type de message (Mtype) comme ConfirmedDataUp. - Sinon, les paquets uplink peuvent être envoyés en mode NON CONFIRMÉ, ce qui signifie que le capteur ne demande pas d'accusé de réception du réseau sur ses données uplink. Cela correspond au type de message UnconfirmedDataUp. |
| Drapeaux | Indicateurs de couche MAC disponibles dans l'en-tête de trame (pour plus de détails, voir les spécifications de la couche MAC LoRaWAN®): - ADR: réglé sur 1 si ADR activé par le capteur, 0 sinon. Lorsque ADR est réglé sur 1 par le capteur, celui-ci autorise le network server LRC à optimiser le facteur d'étalement (Spreading Factor, SF) de l'uplink, le nombre de transmissions et la puissance d'émission selon l'algorithme ADR configuré dans le LRC. - ACK : réglé sur 1 si le paquet contient un accusé de réception du paquet downlink précédent, 0 sinon. - ADRACKReq : réglé sur 1 lorsque le capteur demande un accusé de réception pour valider l'ADR contrôlé par le réseau conformément aux spécifications LoRaWAN. |
| MAC (hex) | Contient les commandes MAC uplink au format hexadécimal, suivies du contenu décodé de chaque commande MAC. |
| Données (hex) | Contient le Payload applicatif de l'uplink au format hexadécimal. Remarque Ce Payload peut être masqué pour des raisons de confidentialité. Pour en savoir plus, voir Affichage des Payloads décodés. L'état de chiffrement du Payload (chiffré vs non chiffré) est affiché entre crochets. |
| Métadonnées du driver | Métadonnées associées au profil de capteur correspondant au capteur en question. Ces métadonnées permettent à l'application Wireless Logger de mapper automatiquement le capteur au bon décodeur de Payload de la liste des drivers IoT Flow. Pour plus d'informations, voir Affichage des Payloads décodés. |
| Données décodées | Payload applicatif décodé, disponible uniquement lorsqu'un driver de Payload valide existe pour ce modèle de capteur et que le décodeur Wireless Logger n'est pas réglé sur "pas de décodage". Pour plus d'informations, voir Affichage des Payloads décodés. |
| Taille des données (octets) | Taille du Payload applicatif en octets. |
| Temps d'antenne (s) | Durée de l'émission du paquet dans l'air (en secondes). |
| Tableau LRR | Métadonnées de réception pour chaque LRR qui a reçu le paquet uplink (jusqu'à 10 LRR), classées de la plus haute à la plus basse SNR uplink. Pour en savoir plus sur les métriques RSSI/SNR/ESP, voir RF metrics. Pour chaque LRR, l'horodatage de réception par chaque chaîne RF (correspondant à une antenne RF) est affiché. Remarque Lorsque le paquet est horodaté finement par le LRR récepteur, Wireless Logger affiche {GPS_RADIO} à côté de l'horodatage, comme dans l'exemple suivant : GWID, GWToken, DLAllowed et Foreign Operator NetID/NSID sont des métadonnées spécifiques au trafic d'itinérance passive. Pour en savoir plus, voir Paquets de roaming passif. Note Si le paquet est retransmis par un relais LoRaWAN, l'ID du relais (DevEUI du relais) est reporté dans la colonne "Relais". |
| Position du capteur | Position du capteur (Longitude/Latitude) issue de la géolocalisation basée sur le réseau, si la fonction est activée pour ce capteur et que le résolveur de géolocalisation peut résoudre la position du capteur en se basant sur les algorithmes TDoA/RSSI. Les détails de géolocalisation fournis ici (rayon, précision, estimation de la vélocité, etc.) sont les mêmes que ceux fournis dans les Rapports de localisation. |
| Statut du Rapport | Statut de la transmission uplink au réseau central ThingPark : - À l'heure : le paquet uplink a été envoyé par le LRR au réseau central LRC sans délai significatif. - En retard : le paquet uplink a été retardé dans le LRR (c'est-à-dire mis en tampon) avant d'atteindre le réseau central LRC. Cela est généralement dû à une instabilité du backhaul ou à une panne temporaire. |
| Bande ISM | Bande ISM LoRaWAN® (également connue sous le nom de profil régional selon la spécification des paramètres régionaux de LoRaWAN) associée au capteur et à son meilleur LRR (BestLRR ou BestGWID). |
| RF region | RF region de la meilleure passerelle (BestLRR ou BestGWID). |
| AS ID | ID ThingPark du/des serveur(s) d'application auquel/auxquels les paquets uplink sont acheminés. |
| Fréquence | Fréquence physique (en MHz) utilisée par le capteur pour transmettre le paquet uplink. Le Canal Logique correspondant est affiché dans la colonne Canal. |
| Classe actuelle | Classe LoRaWAN® actuelle utilisée par le capteur, c'est-à-dire classe A/B/C. Remarque Pour les capteurs LoRaWAN® 1.0.x, les capteurs de classe A et de classe C ne peuvent pas changer dynamiquement de classe ; alors que les capteurs de classe B peuvent passer entre la classe A et la classe B en fonction de leur couche applicative et de l'état de synchronisation du capteur via les signaux de beacon. |
| Étiquettes | Liste des étiquettes administratives associées au capteur en question, le cas échéant. |
| Statut de transmission vers l'AS via l'interface tunnel | Statut de transmission du rapport envoyé par le LRC au serveur d'applications identifié par l'ID AS, via l'interface tunnel (également connu sous le nom de connexions de type HTTPS de base). Deux valeurs possibles sont : Ok ou Erreur. En cas d'erreur de transmission, le message d'erreur correspondant est affiché dans la colonne "Erreurs de transmission". Note Ce statut n'est pertinent que pour les connexions de type "HTTP de base". Les erreurs de livraison liées aux connexions TPX ne sont actuellement pas visibles dans le Wireless Logger. |
| Erreurs de transmission | Applicable uniquement si le statut de transmission est Erreur. Idx: Index de la destination qui a causé l'erreur. Valeur de départ à 0. Url: L'URL de destination qui a retourné l'erreur. Un serveur d'applications HTTP peut être configuré avec plusieurs URLs de destinations. Statut: - Timeout : Le rapport n'a pas été accusé de réception avec succès par la destination dans le délai attendu. - Erreur : Le rapport a été rejeté par la destination. (Erreur HTTP, erreur réseau, erreur DNS). - Overload : Le rapport n'a pas été envoyé vers la destination car le network server a atteint l'état OVERLOAD et le temps aller-retour moyen vers la destination est trop élevé. - Blacklist : Le rapport n'a pas été envoyé vers la destination car le network server a atteint l'état BLACKLIST et le temps aller-retour moyen vers la destination est mauvais. - Inaccessible : Le rapport n'a pas été envoyé à la destination car cette destination a été jugée inaccessible en raison d'un comportement non réactif au cours de la dernière fenêtre d'observation. Note Ces informations ne sont pertinentes que pour des connexions de type "HTTP de base". Les erreurs de livraison liées aux connexions TPX ne sont actuellement pas visibles dans le Wireless Logger. |
| Période de pingslot actuelle | Valide uniquement pour les capteurs de classe B, cela définit la périodicité du créneau de ping signalée par le capteur lorsqu'il utilise la classe B. Ce champ est affiché uniquement lorsque le capteur utilise le mode classe B. |
| Compteur de trames d'application confirmé downlink (ConfAFCntDn) | Valide uniquement pour les capteurs LoRaWAN® 1.1 lorsque le paquet monté reconnaît le dernier paquet Downlink envoyé en mode confirmé. Le compteur de trame Downlink AFCntDown reconnu par le capteur est récupéré par le LRC après la procédure de vérification MIC. |
| Compteur de trames réseau confirmé downlink (ConfNFCntDn) | Valide uniquement pour les capteurs LoRaWAN® 1.1 lorsque le paquet monté reconnaît le dernier paquet Downlink envoyé en mode confirmé. Le compteur de trame Downlink NFCntDown reconnu par le capteur est récupéré par le LRC après la procédure de vérification MIC. |