À 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 Si un QR code 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 des é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 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 le DevEUI est supporté |
| C | DevAddr LoRaWAN® Uniquement applicable à un capteur LoRaWAN 1.0 migré depuis un autre network server. | Facultatif | n/a |
| D | ID du 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 MODEL LIST. | Facultatif si un QR code est fourni dans la colonne B, obligatoire sinon. | Facultatif |
| E | LoRaWAN JoinEUI/AppEUI | Facultatif si un QR code est fourni dans la colonne B ou si le join server local est utilisé, obligatoire sinon. | Facultatif |
| F | LoRaWAN AppKey Modes de codage supportés :
Lors de l’ajout d’un capteur : si 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 du plan de connectivité Fonctionnalités (si les Connectivity Plans ne sont pas affichés dans le menu principal) :
ID du plan de connectivité (si les Connectivity Plans 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 elle est fournie, le mode de localisation manuelle est automatiquement activé.
Si vide (lors de l’ajout d’un capteur) ou | Facultatif | Facultatif |
| M | Longitude du capteur (degrés décimaux) Si elle est fournie, le mode de localisation manuelle 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 connexion Plusieurs ID de connexion peuvent être fournis, séparés par une virgule. | Facultatif | Facultatif |
| U | LoRaWAN NwkKey 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 la 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 | Owner Token | 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). Lorsqu’il est fourni, le contexte de session du capteur LoRaWAN® actuel est entièrement remplacé. | Facultatif | Facultatif |
| AB | Liste de noms d’étiquette 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 en entier 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. | n/a |
| AE | Représentation en entier 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. | n/a |
| AF | Décalage de débit de données RX1 (0..7) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AG | Fréquence RX2 en MHz (433..928 jusqu’à 6 décimales) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AH | Débit de données RX2 (0..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AI | Délai RX1 en secondes (1..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AJ | Temps de séjour downlink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 dans la bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | n/a |
| AK | Temps de séjour uplink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 dans la bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | n/a |
| AL | Représentation hexadécimale 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. | n/a |
| AM | Représentation hexadécimale 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. | n/a |
| AN | LoRaWAN NwkSKey Modes de codage supportés :
| Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AO | LoRaWAN AppSKey Modes de codage supportés :
| Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AP | Chemin de topic de capteur Segment(s) de chemin de topic MQTT personnalisé utilisé(s) pour résoudre les modèles de topic pour ce capteur dans les connexions MQTT basiques associées. La valeur peut contenir un ou plusieurs niveaux de rubrique séparés par « / ». Il peut également représenter le topic MQTT complet lorsqu’il est utilisé avec un modèle de topic ne contenant que | Facultatif | Facultatif |
-
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.
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 du modèle de capteur Les ID de modèles de capteur peuvent être récupérés dans un fichier CSV via le bouton MODEL LIST. | Obligatoire | Facultatif |
| E | LoRaWAN® FNwkSIntKey/NwkSKey Modes de codage supportés :
| Obligatoire | Facultatif |
| F | LoRaWAN® AppSKey Modes de codage supportés :
| Facultatif | Facultatif |
| G | n/a | n/a | n/a |
| H | Fonctionnalités / ID du plan de connectivité Fonctionnalités (si les Connectivity Plans ne sont pas affichés dans le menu principal) :
ID du plan de connectivité (si les Connectivity Plans 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 elle est fournie, le mode de localisation manuelle est automatiquement activé.
Si vide (lors de l’ajout d’un capteur) ou | Facultatif | Facultatif |
| M | Longitude du capteur (degrés décimaux) Si elle est fournie, le mode de localisation manuelle 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 connexion Plusieurs ID de connexion peuvent être fournis, séparés par une virgule. | Facultatif | Facultatif |
| U | LoRaWAN® SNwkSIntKey Modes de codage supportés :
| Obligatoire en LoRaWAN® 1.1, interdit sinon. | Facultatif en LoRaWAN® 1.1, interdit sinon. |
| V | LoRaWAN® NwkSEncKey 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 la 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). Lorsqu’il est fourni, le contexte de session du capteur LoRaWAN® actuel est entièrement remplacé. | Facultatif | Facultatif |
| AB | Liste de noms d’étiquette 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 en entier 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. | n/a |
| AE | Représentation en entier 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. | n/a |
| AF | Décalage de débit de données RX1 (0..7) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AG | Fréquence RX2 en MHz (433..928 jusqu’à 6 décimales) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AH | Débit de données RX2 (0..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AI | Délai RX1 en secondes (1..15) | Facultatif pour un capteur LoRaWAN 1.0 migré depuis un autre network server, interdit sinon. | n/a |
| AJ | Temps de séjour downlink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 dans la bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | n/a |
| AK | Temps de séjour uplink : 0 (aucune limite) ou 1 (400 ms) | Facultatif pour un capteur LoRaWAN 1.0 dans la bande ISM AS923 ou AU915 utilisant le join server local et migré depuis un autre network server, interdit sinon. | n/a |
| AL | n/a | n/a | n/a |
| AM | n/a | n/a | n/a |
| AN | n/a | n/a | n/a |
| AO | n/a | n/a | n/a |
| AP | Chemin de topic de capteur Segment(s) de chemin de topic MQTT personnalisé utilisé(s) pour résoudre les modèles de topic pour ce capteur dans les connexions MQTT basiques associées. La valeur peut contenir un ou plusieurs niveaux de rubrique séparés par « / ». Il peut également représenter le topic MQTT complet lorsqu’il est utilisé avec un modèle de topic ne contenant que | Facultatif | Facultatif |
-
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.
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 le DevEUI est supporté |
| C | ID de la carte SIM | Obligatoire | n/a |
| D | ID du modèle de capteur Les ID de modèles de capteur peuvent être récupérés dans un fichier CSV via le bouton MODEL LIST. | 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 du 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 connexion 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’étiquette 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 |