À propos du fichier d'importation
Ce sujet décrit le contenu du fichier CSV que vous devez créer pour ajouter, mettre à jour ou supprimer massivement des capteurs comme expliqué dans Exécution d’opérations en masse. Chaque ligne du fichier CSV permet soit de :
- Ajouter ou mettre à jour un capteur LoRaWAN® OTAA
- Ajouter ou mettre à jour un capteur LoRaWAN® ABP
- Ajouter ou mettre à jour un capteur cellulaire
- Supprimer un capteur
Pour en savoir plus sur les paramètres à renseigner dans le fichier CSV, voir Attributs de capteur.
-
Séparateur de champ
- La virgule (
,) est utilisée comme séparateur de colonnes. - Chaque ligne représente une opération.
- Chaque colonne d’une opération doit être séparée par une virgule.
- La virgule (
-
Valeurs contenant des virgules
- Si la valeur d’une colonne contient une virgule (comme une liste d’étiquettes ou de domaines), la valeur entière doit être encadrée par des guillemets doubles (
"). - Cela empêche la virgule à l’intérieur de la valeur d’être interprétée comme un séparateur de champ.
- Si la valeur d’une colonne contient une virgule (comme une liste d’étiquettes ou de domaines), la valeur entière doit être encadrée par des guillemets doubles (
-
Guillemets doubles à l’intérieur des valeurs
- Si une valeur contient des guillemets doubles :
- La colonne doit être encadrée par des guillemets doubles.
- Les guillemets doubles internes doivent être échappés en les doublant (
"").
- Si une valeur contient des guillemets doubles :
Ajout ou mise à jour d’un capteur LoRaWAN® OTAA
Les colonnes suivantes doivent être renseignées pour ajouter ou mettre à jour un capteur LoRaWAN® OTAA.
| Colonne | Définition | Ajout | Mise à jour |
|---|---|---|---|
| A | Type d’opération
| Obligatoire | Obligatoire |
| B | DevEUI LoRaWAN® ou QR code d’onboarding Si un QR code d’onboarding est fourni dans la colonne B lors de l’ajout d’un capteur, les éléments des colonnes D, E et F deviennent facultatifs. Mais si les éléments des colonnes D, E et F sont tout de même fournis, ces éléments seront pris en compte à la place du QR code d’onboarding fourni dans la colonne B. Pour en savoir plus sur les QR codes d’onboarding, voir TR005 LoRaWAN® Device Identification QR Codes. | Obligatoire | Obligatoire : seul DevEUI est supporté |
| C | DevAddr LoRaWAN® Applicable uniquement à un capteur LoRaWAN 1.0 migré depuis un autre network server. | Facultatif | n/a |
| D | ID de modèle de capteur Les ID de modèles de capteur disponibles peuvent être récupérés dans un fichier CSV via le bouton LISTE DES MODÈLES. | Facultatif si un QR code d’onboarding est fourni dans la colonne B, obligatoire sinon. | Facultatif |
| E | JoinEUI/AppEUI LoRaWAN | Facultatif si un QR code d’onboarding est fourni dans la colonne B ou si le join server local est utilisé, obligatoire sinon. | Facultatif |
| F | AppKey LoRaWAN Modes de codage supportés :
Lors de l’ajout d’un capteur : si l’AppKey est fournie, le capteur OTAA utilise le join server local ; sinon, un join server externe (identifié par son JoinEUI) est utilisé. | Facultatif | Facultatif si le join server local est utilisé, interdit sinon. |
| G | n/a | n/a | n/a |
| H | Fonctionnalités / ID de plan de connectivité Fonctionnalités (si les Plans de connectivité ne sont pas affichés dans le menu principal) :
ID du plan de connectivité (si les plans de connectivité sont affichés dans le menu principal) :
| Facultatif | Facultatif |
| I | n/a | n/a | n/a |
| J | n/a | n/a | n/a |
| K | Nom du capteur | Facultatif : le nom du capteur est automatiquement défini sur le DevEUI lorsqu’il n’est pas fourni. | Facultatif |
| L | Latitude du capteur (degrés décimaux) Si fourni, le mode d’emplacement manuel est automatiquement activé.
Si vide (lors de l’ajout d’un capteur) ou | Facultatif | Facultatif |
| M | Longitude du capteur (degrés décimaux) Si fourni, le mode d’emplacement manuel est automatiquement activé.
Si vide (lors de l’ajout d’un capteur) ou | Facultatif | Facultatif |
| N | Informations supplémentaires | Facultatif | Facultatif |
| O | Configuration d’alarme d’absence d’activité uplink Document XML :
Valeur par défaut lors de l’ajout d’un capteur : | Facultatif | Facultatif |
| P | n/a | n/a | n/a |
| Q | Indicateur de mouvement La valeur est l'une des suivantes :
| Facultatif : l’indicateur de mouvement du profil de capteur sera utilisé lorsqu’aucun indicateur de mouvement n’est spécifié. | Facultatif |
| R | ID de groupe HSM | Facultatif si le join server local est utilisé, interdit sinon. | Facultatif si le join server local est utilisé, interdit sinon. |
| S | n/a | n/a | n/a |
| T | ID de connexions Plusieurs ID de connexion peuvent être fournis, séparés par une virgule. | Facultatif | Facultatif |
| U | NwkKey LoRaWAN Modes de codage supportés :
| Obligatoire pour un capteur LoRaWAN 1.1 si le join server local est utilisé, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.1 si le join server local est utilisé, interdit sinon. |
| V | n/a | n/a | n/a |
| W | ID de clé de transport AS | Facultatif si le join server local est utilisé avec HSM, interdit sinon. | Facultatif si le join server local est utilisé avec HSM, interdit sinon. |
| X | Version de clé publique utilisée pour chiffrer les clés Version de la clé publique RSA utilisée pour chiffrer les clés du capteur. | Obligatoire si le join server local est utilisé avec HSM, facultatif si le join server local est utilisé sans HSM, interdit avec un join server externe. | Obligatoire si le join server local est utilisé avec HSM, facultatif si le join server local est utilisé sans HSM, interdit avec un join server externe. |
| Y | Jeton propriétaire | Facultatif si un join server externe est utilisé, interdit sinon. | n/a |
| Z | Identifiant de protocole (driver système ou driver personnalisé) | Facultatif : l’identifiant de protocole par défaut défini dans le modèle de capteur sera utilisé lorsqu’aucun identifiant de protocole n’est spécifié. | Facultatif |
| AA | Contexte de session de capteur LoRaWAN® (utilisation interne uniquement) | Facultatif | Facultatif |
| AB | Liste de noms d’étiquettes séparés par des virgules | Facultatif | Facultatif |
| AC | Liste de domaines associés séparés par des virgules Le nom du groupe de domaines et le nom de domaine doivent être fournis comme suit : | Facultatif | Facultatif |
| AD | Représentation entière sur 32 bits du dernier compteur de trames downlink (FCntDn) reçu par le capteur | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AE | Représentation entière sur 32 bits du dernier compteur de trames uplink (FCntUp) envoyé par le capteur | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AF | Offset de data rate RX1 (0..7) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AG | Fréquence RX2 en MHz (433..928 avec jusqu’à 6 décimales) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AH | Data rate RX2 (0..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AI | Délai RX1 en secondes (1..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AJ | Dwell time downlink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et devant être resynchronisé avec le network server, interdit sinon. |
| AK | Dwell time uplink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et devant être resynchronisé avec le network server, interdit sinon. |
| AL | Représentation hexadécimale sur 24 bits du dernier JoinNonce utilisé par le join server | Obligatoire pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Obligatoire pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AM | Représentation hexadécimale sur 16 bits du dernier DevNonce utilisé par le capteur | Facultatif pour un capteur LoRaWAN 1.0 utilisant le join server local et migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 utilisant le join server local et devant être resynchronisé avec le network server, interdit sinon. |
| AN | NwkSKey LoRaWAN Modes de codage supportés :
| Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AO | AppSKey LoRaWAN Modes de codage supportés :
| Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
-
Lorsque le capteur OTAA ajouté est migré depuis un autre network server (limité aux capteurs LoRaWAN 1.0.x) :
-
Vous pouvez importer le contexte de session LoRaWAN du capteur migré, pour informer le réseau du DevAddr, des clés de session, des compteurs de trames et des paramètres de configuration downlink RX1/RX2 actuellement utilisés par le capteur.
Ce processus permet une migration transparente du capteur sans forcer le capteur à revenir à l’état JOIN. -
Si le contexte de session LoRaWAN du capteur migré n’est pas importé, le capteur doit refaire la procédure JOIN pour obtenir une nouvelle session LoRaWAN dans ThingPark. Néanmoins, vous devez renseigner la colonne
ALpour informer le réseau du dernier JoinNonce/AppNonce utilisé par ce capteur. Si vous ne le connaissez pas, saisissez une valeur raisonnablement élevée que vous pensez que le capteur n’a pas encore atteinte.
-
-
Lors de la mise à jour d’un capteur OTAA :
- Si une colonne facultative est vide, la valeur actuellement utilisée est conservée.
- Le mot‑clé
_unsetpeut être utilisé pour réinitialiser les colonnes suivantes : G, H, K, L, M, N, O, T, Z, AB et AC. - Si l’état LoRaWAN a été désynchronisé entre votre capteur et le network server, vous pouvez utiliser les colonnes AD à AO pour informer le réseau des clés/paramètres actuellement utilisés par votre capteur.
Ajout ou mise à jour d’un capteur LoRaWAN® ABP
Les colonnes suivantes doivent être renseignées pour ajouter ou mettre à jour un capteur LoRaWAN® ABP.
| Colonne | Définition | Ajout | Mise à jour |
|---|---|---|---|
| A | Type d’opération
| Obligatoire | Obligatoire |
| B | DevEUI LoRaWAN® | Obligatoire | Obligatoire |
| C | DevAddr LoRaWAN® | Obligatoire | n/a |
| D | ID de modèle de capteur Les ID de modèles de capteur peuvent être récupérés dans un fichier CSV via le bouton LISTE DES MODÈLES. | Obligatoire | Facultatif |
| E | FNwkSIntKey/NwkSKey LoRaWAN® Modes de codage supportés :
| Obligatoire | Facultatif |
| F | AppSKey LoRaWAN® Modes de codage supportés :
| Facultatif | Facultatif |
| G | n/a | n/a | n/a |
| H | Fonctionnalités / ID de plan de connectivité Fonctionnalités (si les Plans de connectivité ne sont pas affichés dans le menu principal) :
ID du plan de connectivité (si les plans de connectivité sont affichés dans le menu principal) :
| Facultatif | Facultatif |
| I | n/a | n/a | n/a |
| J | n/a | n/a | n/a |
| K | Nom du capteur | Facultatif : le nom du capteur est automatiquement défini sur le DevEUI lorsqu’il n’est pas fourni. | Facultatif |
| L | Latitude du capteur (degrés décimaux) Si fourni, le mode d’emplacement manuel est automatiquement activé.
Si vide (lors de l’ajout d’un capteur) ou | Facultatif | Facultatif |
| M | Longitude du capteur (degrés décimaux) Si fourni, le mode d’emplacement manuel est automatiquement activé.
Si vide (lors de l’ajout d’un capteur) ou | Facultatif | Facultatif |
| N | Informations supplémentaires | Facultatif | Facultatif |
| O | Configuration d’alarme d’absence d’activité uplink Document XML :
Valeur par défaut lors de l’ajout d’un capteur : | Facultatif | Facultatif |
| P | n/a | n/a | n/a |
| Q | Indicateur de mouvement La valeur est l'une des suivantes :
| Facultatif : l’indicateur de mouvement du profil de capteur sera utilisé lorsqu’aucun indicateur de mouvement n’est spécifié. | Facultatif |
| R | n/a | n/a | n/a |
| S | n/a | n/a | n/a |
| T | ID de connexions Plusieurs ID de connexion peuvent être fournis, séparés par une virgule. | Facultatif | Facultatif |
| U | SNwkSIntKey LoRaWAN® Modes de codage supportés :
| Obligatoire en LoRaWAN® 1.1, interdit sinon. | Facultatif en LoRaWAN® 1.1, interdit sinon. |
| V | NwkSEncKey LoRaWAN® Modes de codage supportés :
| Obligatoire en LoRaWAN® 1.1, interdit sinon. | Facultatif en LoRaWAN® 1.1, interdit sinon. |
| W | n/a | n/a | n/a |
| X | Version de clé publique utilisée pour chiffrer les clés Version de la clé publique RSA utilisée pour chiffrer les clés du capteur. | Facultatif | Facultatif |
| Y | n/a | n/a | n/a |
| Z | Identifiant de protocole (driver système ou driver personnalisé) | Facultatif : l’identifiant de protocole par défaut défini dans le modèle de capteur sera utilisé lorsqu’aucun identifiant de protocole n’est spécifié. | Facultatif |
| AA | Contexte de session de capteur LoRaWAN® (utilisation interne uniquement) | Facultatif | Facultatif |
| AB | Liste de noms d’étiquettes séparés par des virgules | Facultatif | Facultatif |
| AC | Liste de domaines associés séparés par des virgules Le nom du groupe de domaines et le nom de domaine doivent être fournis comme suit : | Facultatif | Facultatif |
| AD | Représentation entière sur 32 bits du dernier compteur de trames downlink (FCntDn) reçu par le capteur | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AE | Représentation entière sur 32 bits du dernier compteur de trames uplink (FCntUp) envoyé par le capteur | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AF | Offset de data rate RX1 (0..7) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AG | Fréquence RX2 en MHz (433..928 avec jusqu’à 6 décimales) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AH | Data rate RX2 (0..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AI | Délai RX1 en secondes (1..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 devant être resynchronisé avec le network server, interdit sinon. |
| AJ | Dwell time downlink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et devant être resynchronisé avec le network server, interdit sinon. |
| AK | Dwell time uplink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | Facultatif pour un capteur LoRaWAN 1.0 en bande ISM AS923 ou AU915 utilisant le join server local et devant être resynchronisé avec le network server, interdit sinon. |
-
Lorsque le capteur ABP ajouté est migré depuis un autre network server (limité aux capteurs LoRaWAN 1.0.x), vous devez importer le contexte de session LoRaWAN du capteur migré, pour informer le réseau des compteurs de trames et des paramètres de configuration downlink RX1/RX2 actuellement utilisés par le capteur.
-
Lors de la mise à jour d’un capteur ABP :
- Si une colonne facultative est vide, la valeur actuellement utilisée est conservée.
- Le mot‑clé
_unsetpeut être utilisé pour réinitialiser les colonnes suivantes : F, G, H, K, L, M, N, O, T, Z, AB et AC. - Si l’état LoRaWAN a été désynchronisé entre votre capteur et le network server, vous pouvez utiliser les colonnes AD à AK pour informer le réseau des paramètres actuellement utilisés par votre capteur.
Ajout ou mise à jour d’un capteur cellulaire
Les colonnes suivantes doivent être renseignées pour ajouter ou mettre à jour un capteur cellulaire.
| Colonne | Définition | Ajout | Mise à jour |
|---|---|---|---|
| A | Type d’opération
| Obligatoire | Obligatoire |
| B | IMEI imposé (15 chiffres) ou DevEUI | Facultatif : seul l’IMEI imposé est supporté | Obligatoire : seul DevEUI est supporté |
| C | ID de la carte SIM | Obligatoire | n/a |
| D | ID de modèle de capteur Les ID de modèles de capteur peuvent être récupérés dans un fichier CSV via le bouton LISTE DES MODÈLES. | Obligatoire | Facultatif |
| E | n/a | n/a | n/a |
| F | n/a | n/a | n/a |
| G | n/a | n/a | n/a |
| H | ID de plan de connectivité Si vide (lors de l’ajout d’un capteur) ou | Facultatif | Facultatif |
| I | n/a | n/a | n/a |
| J | n/a | n/a | n/a |
| K | Nom du capteur | Facultatif : le nom du capteur est automatiquement défini sur le DevEUI lorsqu’il n’est pas fourni. | Facultatif |
| L | Latitude du capteur (degrés décimaux) | Facultatif | Facultatif |
| M | Longitude du capteur (degrés décimaux) | Facultatif | Facultatif |
| N | Informations supplémentaires | Facultatif | Facultatif |
| O | Configuration d’alarme d’absence d’activité uplink Document XML :
Valeur par défaut lors de l’ajout d’un capteur : | Facultatif | Facultatif |
| P | n/a | n/a | n/a |
| Q | Indicateur de mouvement La valeur est l'une des suivantes :
| Facultatif : l’indicateur de mouvement du profil de capteur sera utilisé lorsqu’aucun indicateur de mouvement n’est spécifié. | Facultatif |
| R | n/a | n/a | n/a |
| S | n/a | n/a | n/a |
| T | ID de connexions Plusieurs ID de connexion peuvent être fournis, séparés par une virgule. | Facultatif | Facultatif |
| U | n/a | n/a | n/a |
| V | n/a | n/a | n/a |
| W | ID de contexte réseau | Facultatif | Facultatif |
| X | n/a | n/a | n/a |
| Y | n/a | n/a | n/a |
| Z | n/a | n/a | n/a |
| AA | n/a | n/a | n/a |
| AB | Liste de noms d’étiquettes séparés par des virgules | Facultatif | Facultatif |
| AC | Liste de domaines associés séparés par des virgules Le nom du groupe de domaines et le nom de domaine doivent être fournis comme suit : | Facultatif | Facultatif |
Suppression d’un capteur
Les colonnes suivantes doivent être remplies pour supprimer un capteur.
| Colonne | Définition | Suppression |
|---|---|---|
| A | Type d’opération : DELETE | Obligatoire |
| B | DevEUI | Obligatoire |