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 (L signifie « 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 (R signifie « Itinérance »). Pour en savoir plus, voir Paquets d'itinérance passive.
• illustre un paquet uplink acheminé via un relais LoRaWAN. F signifie "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 .
• Lorsque la livraison échoue complètement pour au moins un serveur d'application, un point rouge s'affiche.
  • Exemple : , ou .

Dans chaque cas, le statut détaillé de la transmission est affiché dans le panneau extensible.

note

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 requête join	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 requête join (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	L'EUI du capteur (8 octets) est un identifiant global de l'équipement terminal dans l'espace d'adresses IEEE EUI64 qui identifie de manière unique l'équipement. Si le network server agit en tant que forwarding network server (fNS) et que le type de message est data, le DevEUI n'est disponible que si la version des interfaces backend LoRaWAN® 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	Spreading factor ou data rate 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 la meilleure LRR / affiche le capteur et la passerelle LRR sur une carte / affiche le chemin de localisation du capteur (si la localisation du capteur est disponible). Les données GPS ne sont renseignées que si le capteur communique sa position : - Localisation manuelle : configurée dans l'application Device Manager - Localisation GPS rapportée par le capteur dans la payload en uplink : cette option n'est valide que si le décodeur de payload est sélectionné et que la clé de session d'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�a0: ConfirmedDataUp, UnConfirmedDataUp ou JoinRequest�a0: - La requête join 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 et le type de message (Mtype) comme JoinRequest. - 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é à 1 par le capteur, celui-ci autorise le network server LRC à optimiser le spreading factor (SF) en uplink, le nombre de transmissions et la puissance d'émission selon l'algorithme ADR configuré dans le LRC. - ACK : défini à 1 si le paquet contient un accusé de réception du paquet downlink précédent, 0 sinon. - ADRACKReq : défini à 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 du rapport uplink vers le réseau central ThingPark : - À l'heure : le paquet uplink a été envoyé par la LRR au LRC du réseau central sans retard significatif. - En retard : le paquet uplink a été retardé dans la 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 basique). Deux valeurs possibles sont : Ok ou Erreur. En cas d'erreur de transmission, le message d'erreur associé est affiché dans la colonne "Erreurs de transmission". Remarque : ce statut n'est pertinent que pour les connexions de type "Basic HTTP". 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 : - Délai d'attente : le rapport n'a pas été accusé de réception avec succès par la destination dans les délais attendus. - Erreur : le rapport a été rejeté par la destination. (Erreur HTTP, erreur réseau, erreur DNS). - Surcharge : le rapport n'a pas été envoyé à la destination parce que le network server a atteint l'état OVERLOAD et que le temps moyen aller-retour de la destination est trop élevé. - Liste noire : le rapport n'a pas été envoyé à la destination parce que le network server a atteint l'état BLACKLIST et que le temps moyen aller-retour de la destination est mauvais. - Injoignable : le rapport n'a pas été envoyé à la destination car celle-ci a été jugée injoignable en raison d'un comportement non réactif durant la dernière fenêtre d'observation. Remarque : ces informations ne sont pertinentes que pour les connexions de type "Basic HTTP". 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.