À propos du fichier d'importation

Ce sujet décrit le contenu du fichier CSV que vous devez créer pour ajouter ou supprimer massivement des capteurs comme expliqué dans Executing bulk operations. Chaque ligne du fichier CSV permet soit d'ajouter un capteur LoRaWAN® OTAA, soit d'ajouter un capteur LoRaWAN® ABP, soit d'ajouter un capteur cellulaire, soit de supprimer un capteur.

Provisionnement d'un capteur LoRaWAN® OTAA

Les colonnes suivantes doivent être remplies pour ajouter un capteur LoRaWAN® OTAA.

Colonne	Définition
A	Directive (obligatoire) CREATE_OTAA pour le provisionnement OTAA de capteur
B	DevEUI ou tag d'onboarding (obligatoire) DevEUI: Identifiant unique global du capteur Est composé de 32 chiffres hexadécimaux (0 à 9 et A à F). Les 6, 7 ou 9 premiers chiffres identifient le fabricant du capteur. Exemple : F0-3D-29-00-0B-B1-7A-AA Tag d'onboarding: Le tag inclut : DevEUI : identifiant unique du capteur (8 octets), JoinEUI : identifiant unique du Join Server LoRaWAN® où le capteur a été pré-commissionné (8 octets), ProfileID : identifiant du modèle de Capteur à associer au Capteur. Le tag peut également inclure le jeton du propriétaire en tant qu'élément optionnel. Si un QR code est fourni dans la colonne B, les éléments des colonnes D, E et F deviennent facultatifs. Cependant, si des éléments des colonnes D, E et F sont malgré tout fournis, ces éléments seront traités en priorité par rapport au QR code fourni dans la colonne B. Pour en savoir plus sur les QR code, voir TR005 LoRaWAN® Device Identification QR Codes.
C	n/a
D	Identifiant du modèle de capteur Les identifiants des modèles de Capteur peuvent être récupérés dans un fichier CSV via le bouton MODELS LIST lors de l'importation des capteurs. Cette colonne est optionnelle si un tag d'onboarding est fourni dans la colonne B, sinon obligatoire.
E	JoinEUI (AppEUI) Identifiant global d'application qui identifie de façon unique le Join-Server capable d'assister le traitement de la procédure Join et la dérivation des clés de session. Composé de 16 chiffres hexadécimaux (0 à 9 et A à F), il est fourni par le fabricant du capteur. Cette colonne est obligatoire lorsqu'un Join Server externe est utilisé, optionnelle sinon. Exemple : 8899AABBCCDDEEFF
F	AppKey Chiffre la communication du capteur avec le réseau. Composé de 32 chiffres hexadécimaux (0 à 9 et A à F), il est fourni par le fabricant du capteur. Cette colonne est obligatoire lorsque le Join Server local est utilisé, interdite sinon. Exemple : 1B3E11A6A8CE91C6A1F12581D9CC4A2C
G	n/a
H	Fonctionnalités / Identifiant du plan de connectivité (optionnel) Fonctionnalités (si les Plans de connectivité ne sont pas affichés dans le menu principal) : Une liste de fonctionnalités séparées par des virgules à activer pour le capteur. Les fonctionnalités supportées sont NetworkGeolocation et PassiveRoaming. Si une fonctionnalité invalide est définie, le capteur n'est pas provisionné ; une erreur est renvoyée. Identifiant du plan de connectivité associé au Capteur (si les Plans de connectivité sont affichés dans le menu principal) : Le plan de connectivité sélectionné détermine l'activation de la fonctionnalité de géolocalisation réseau et d'itinérance passive. Si la colonne est vide, le capteur est créé sans plan de connectivité (capteur suspendu).
I	n/a
J	n/a
K	Nom du capteur (optionnel) Un nom que vous souhaitez attribuer au Capteur qui vous permet de l'identifier sur votre réseau IoT Le nom du capteur est automatiquement défini sur le DevEUI s'il n'est pas fourni lors de la création.
L	Latitude du capteur (optionnelle) Latitude administrative du capteur en coordonnées décimales. Cette colonne ne doit pas être remplie si la géolocalisation réseau est activée pour ce Capteur (voir colonne H).
M	Longitude du capteur (optionnelle) Longitude administrative du capteur en coordonnées décimales. Cette colonne ne doit pas être remplie si la géolocalisation réseau est activée pour ce Capteur (voir colonne H).
N	Informations supplémentaires (optionnelles) Toute information utile liée au capteur. Exemples : bâtiment A, intérieur, sous-sol, etc…
O	Configuration d'alerte en cas d'absence d'activité d'uplink (optionnelle) Document XML de configuration d'alerte en cas d'absence d'activité d'uplink : L'élément XML racine est alarm004 L'élément XML auto-clos threshold1 inclus configure le premier seuil de l'alerte L'élément XML auto-clos threshold2 inclus configure le second seuil de l'alerte Pour chaque élément XML de seuil, les attributs suivants sont disponibles : status : ENABLE ou DISABLE pour ce seuil level : sévérité (2-6) de l'alerte pour ce seuil duration: période d'inactivité (durée ISO 8601 parmi PT1H, PT2H, PT5H, PT10H, P1D, P2D, P4D, P7D et P15D) après laquelle l'alarme est déclenchée pour ce seuil Les contraintes suivantes doivent être respectées : threshold2@status can be set to ENABLE only if threshold1@status is ENABLE threshold1@level must be lower than threshold2@level threshold1@duration must be lower than threshold2@duration Exemple : <alarm004> <threshold1 status="ENABLE" level="3" duration="P2D"/> <threshold2 status="ENABLE" level="5" duration="P7D"/> </alarm004>
P	n/a
Q	Indicateur de mouvement (optionnel) La valeur est l'une des suivantes : NEAR_STATIC WALKING_SPEED BIKE_SPEED VEHICLE_SPEED RANDOM L'indicateur de mouvement par défaut du modèle de Capteur est utilisé lorsqu'il n'est pas fourni.
R	HSM Group ID (optionnel) Identifiant du Hardware Security Module (HSM) où les clés du capteur sont stockées Optionnel si un Local Join Server est utilisé, interdit sinon
S	n/a
T	ID des connexions (optionnel) Identifiants des Connexions qui reçoivent des uplinks et, si la fonctionnalité est supportée, peuvent aussi envoyer des downlinks. Pour récupérer l'ID de la Connexion : allez dans Connections, cliquez sur la connexion, et copiez la valeur de la case ID dans INFORMATION. Si vous souhaitez associer le capteur à plusieurs connexions, séparez les ID par une virgule à l'intérieur de guillemets doubles : "value1,value2".
U	NwkKey Chiffre la communication du capteur avec le réseau. Composé de 32 chiffres hexadécimaux (0 à 9 et A à F). Composé de 32 chiffres hexadécimaux (0 à 9 et A à F), il est fourni par le fabricant du capteur uniquement lorsque la version LoRaWAN® implémentée par le capteur est 1.1. Cette colonne est obligatoire lorsque la version LoRaWAN® implémentée par le capteur est 1.1 et que le Local Join Server est utilisé, interdite sinon. Exemple : 1B3E11A6A8CE91C6A1F12581D9CC4A2C.
V	n/a
W	n/a
X	Version de la Exchange Key utilisée pour chiffrer les clés du capteur Version de la clé publique RSA utilisée pour chiffrer les clés du capteur Obligatoire si un Local Join Server est utilisé avec HSM, optionnel si un Local Join Server est utilisé sans HSM, interdit avec un External Join Server
Y	Jeton propriétaire Jeton propriétaire prouvant la propriété d'un capteur. Cet élément est fourni lorsque les capteurs sont pré-commissionnés sur un External Join Server par le fabricant du capteur. Cette colonne est optionnelle lorsqu'un External Join Server est utilisé, interdite sinon.
Z	Identifiant de protocole (optionnel) Identifiant de protocole du driver système ou du driver personnalisé.

Provisionnement d'un capteur LoRaWAN® ABP

Les colonnes suivantes doivent être remplies pour ajouter un capteur LoRaWAN® ABP.

Colonne	Définition
A	Directive (obligatoire) CREATE_ABP pour le provisionnement ABP de capteur
B	DevEUI (obligatoire) Identifiant unique global du capteur Est composé de 32 chiffres hexadécimaux (0 à 9 et A à F). Les 6, 7 ou 9 premiers chiffres identifient le fabricant du capteur. Exemple : F0-3D-29-00-0B-B1-7A-AA
C	DevAddr (obligatoire) Une adresse de Capteur composée de 8 chiffres hexadécimaux (0 à 9 et A à F). Elle est utilisée pour identifier le capteur au sein du réseau et est transmise dans chaque trame échangée entre le capteur et le réseau LoRaWAN®. Exemple : 00ABC489
D	Identifiant du modèle de capteur (obligatoire) Les identifiants des modèles de Capteur peuvent être récupérés dans un fichier CSV via le bouton MODELS LIST lors de l'importation des capteurs.
E	NwkSKey ou FNwkSIntKey (obligatoire) Clé de session réseau fournissant la protection d'intégrité et le chiffrement des commandes MAC en LoRaWAN® 1.0, ou clé d'intégrité de session réseau de transit fournissant une protection d'intégrité aux Capteurs en itinérance en LoRaWAN® 1.1. Composé de 32 chiffres hexadécimaux (0 à 9 et A à F), il est fourni par le fabricant du capteur. Exemple : 1B3E11A6A8CE91C6A1F12581D9CC4A2C
F	AppSKey (optionnel) Document XML contenant la clé de session applicative utilisée par l'application et le capteur pour chiffrer et déchiffrer le payload applicatif : L'élément XML racine est AppSKeys L'élément XML AppSKey inclus contient la valeur AppSKey (voir ci‑dessous les modes d'encodage supportés) L'attribut AppSKey@Port doit être défini sur * La valeur AppSKey est composée de 32 chiffres hexadécimaux (0 à 9 et A à F), elle est fournie par le fabricant du capteur. Exemple : <AppSKeys> <AppSKey Port="*">1B3E11A6A8CE91C6A1F12581D9CC4A2C</AppSKey> </AppSKeys>
G	n/a
H	Fonctionnalités / Identifiant du plan de connectivité (optionnel) Fonctionnalités (si les Plans de connectivité ne sont pas affichés dans le menu principal) : Une liste de fonctionnalités séparées par des virgules à activer pour le capteur. Les fonctionnalités supportées sont NetworkGeolocation et PassiveRoaming. Si une fonctionnalité invalide est définie, le capteur n'est pas provisionné ; une erreur est renvoyée. Identifiant du plan de connectivité associé au Capteur (si les Plans de connectivité sont affichés dans le menu principal) : Le plan de connectivité sélectionné détermine l'activation de la fonctionnalité de géolocalisation réseau et d'itinérance passive. Si la colonne est vide, le capteur est créé sans plan de connectivité (capteur suspendu).
I	n/a
J	n/a
K	Nom du capteur (optionnel) Un nom que vous souhaitez attribuer au Capteur qui vous permet de l'identifier sur votre réseau IoT Le nom du capteur est automatiquement défini sur le DevEUI s'il n'est pas fourni lors de la création.
L	Latitude du capteur (optionnelle) Latitude administrative du capteur en coordonnées décimales. Cette colonne ne doit pas être remplie si la géolocalisation réseau est activée pour ce Capteur (voir colonne H).
M	Longitude du capteur (optionnelle) Longitude administrative du capteur en coordonnées décimales. Cette colonne ne doit pas être remplie si la géolocalisation réseau est activée pour ce Capteur (voir colonne H).
N	Informations supplémentaires (optionnelles) Toute information utile liée au capteur. Exemples : bâtiment A, intérieur, sous-sol, etc…
O	Configuration d'alerte en cas d'absence d'activité d'uplink (optionnelle) Document XML de configuration d'alerte en cas d'absence d'activité d'uplink : L'élément XML racine est alarm004 L'élément XML auto-clos threshold1 inclus configure le premier seuil de l'alerte L'élément XML auto-clos threshold2 inclus configure le second seuil de l'alerte Pour chaque élément XML de seuil, les attributs suivants sont disponibles : status : ENABLE ou DISABLE pour ce seuil level : sévérité (2-6) de l'alerte pour ce seuil duration: période d'inactivité (durée ISO 8601 parmi PT1H, PT2H, PT5H, PT10H, P1D, P2D, P4D, P7D et P15D) après laquelle l'alarme est déclenchée pour ce seuil Les contraintes suivantes doivent être respectées : threshold2@status can be set to ENABLE only if threshold1@status is ENABLE threshold1@level must be lower than threshold2@level threshold1@duration must be lower than threshold2@duration Exemple : <alarm004> <threshold1 status="ENABLE" level="3" duration="P2D"/> <threshold2 status="ENABLE" level="5" duration="P7D"/> </alarm004>
P	n/a
Q	Indicateur de mouvement (optionnel) La valeur est l'une des suivantes : NEAR_STATIC WALKING_SPEED BIKE_SPEED VEHICLE_SPEED RANDOM L'indicateur de mouvement par défaut du modèle de Capteur est utilisé lorsqu'il n'est pas fourni.
R	n/a
S	n/a
T	ID des connexions (optionnel) Identifiants des Connexions qui reçoivent des uplinks et, si la fonctionnalité est supportée, peuvent aussi envoyer des downlinks. Pour récupérer l'ID de la Connexion : allez dans Connections, cliquez sur la connexion, et copiez la valeur de la case ID dans INFORMATION. Si vous souhaitez associer le capteur à plusieurs connexions, séparez les ID par une virgule à l'intérieur de guillemets doubles : "value1,value2".
U	SNwkSIntKey Clé d'intégrité de session du réseau Serving fournissant une protection d'intégrité. Disponible uniquement lorsque la version LoRaWAN® implémentée par le capteur est 1.1. Composé de 32 chiffres hexadécimaux (0 à 9 et A à F), il est fourni par le fabricant du capteur. Cette colonne est obligatoire lorsque la version LoRaWAN® implémentée par le capteur est 1.1, interdite sinon. Exemple : 1B3E11A6A8CE91C6A1F12581D9CC4A2C.
V	NwkSEncKey Clé de chiffrement de session réseau utilisée pour le chiffrement des commandes MAC entre le capteur et le réseau LoRaWAN®. Disponible uniquement lorsque la version LoRaWAN® implémentée par le capteur est 1.1. Composé de 32 chiffres hexadécimaux (0 à 9 et A à F), il est fourni par le fabricant du capteur. Cette colonne est obligatoire lorsque la version LoRaWAN® implémentée par le capteur est 1.1, interdite sinon. Exemple : 1B3E11A6A8CE91C6A1F12581D9CC4A2C.
W	n/a
X	Version de la clé publique utilisée pour chiffrer les clés du capteur (optionnel) Version de la clé publique RSA utilisée pour chiffrer les clés du capteur
Y	n/a
Z	Identifiant de protocole (optionnel) Identifiant de protocole du driver système ou du driver personnalisé.

Provisionnement d'un capteur cellulaire

Les colonnes suivantes doivent être remplies pour ajouter un capteur cellulaire.

Colonne	Définition
A	Directive (obligatoire) CREATE_CELLULAR pour le provisionnement de capteur cellulaire
B	IMEI imposé (optionnel) IMEI de votre Capteur si vous souhaitez que ThingPark rejette tout trafic correspondant à un autre IMEI.
C	Identifiant de la SIM (obligatoire) IMSI, ICCID ou eID selon le type de SIM.
D	Identifiant du modèle de capteur (obligatoire) Les identifiants des modèles de Capteur peuvent être récupérés dans un fichier CSV via le bouton MODELS LIST lors de l'importation des capteurs.
E	n/a
F	n/a
G	n/a
H	ID du plan de connectivité (optionnel) Si la colonne est vide, le capteur est créé sans plan de connectivité (capteur suspendu).
I	n/a
J	n/a
K	Nom du capteur (optionnel) Un nom que vous souhaitez attribuer au Capteur qui vous permet de l'identifier sur votre réseau IoT Le nom du capteur est automatiquement défini sur le DevEUI s'il n'est pas fourni lors de la création.
L	Latitude du capteur (optionnelle) Latitude administrative du capteur en coordonnées décimales.
M	Longitude du capteur (optionnelle) Longitude administrative du capteur en coordonnées décimales.
N	Informations supplémentaires (optionnelles) Toute information utile liée au capteur. Exemples : bâtiment A, intérieur, sous-sol, etc…
O	Configuration d'alerte en cas d'absence d'activité d'uplink (optionnelle) Document XML de configuration d'alerte en cas d'absence d'activité d'uplink : L'élément XML racine est alarm004 L'élément XML auto-clos threshold1 inclus configure le premier seuil de l'alerte L'élément XML auto-clos threshold2 inclus configure le second seuil de l'alerte Pour chaque élément XML de seuil, les attributs suivants sont disponibles : status : ENABLE ou DISABLE pour ce seuil level : sévérité (2-6) de l'alerte pour ce seuil duration: période d'inactivité (durée ISO 8601 parmi PT1H, PT2H, PT5H, PT10H, P1D, P2D, P4D, P7D et P15D) après laquelle l'alarme est déclenchée pour ce seuil Les contraintes suivantes doivent être respectées : threshold2@status can be set to ENABLE only if threshold1@status is ENABLE threshold1@level must be lower than threshold2@level threshold1@duration must be lower than threshold2@duration Exemple : <alarm004> <threshold1 status="ENABLE" level="3" duration="P2D"/> <threshold2 status="ENABLE" level="5" duration="P7D"/> </alarm004>
P	n/a
Q	Indicateur de mouvement (optionnel) La valeur est l'une des suivantes : NEAR_STATIC WALKING_SPEED BIKE_SPEED VEHICLE_SPEED RANDOM L'indicateur de mouvement par défaut du modèle de Capteur est utilisé lorsqu'il n'est pas fourni.
R	n/a
S	n/a
T	ID des connexions (optionnel) Identifiants des Connexions qui reçoivent des uplinks et, si la fonctionnalité est supportée, peuvent aussi envoyer des downlinks. Pour récupérer l'ID de la Connexion : allez dans Connections, cliquez sur la connexion, et copiez la valeur de la case ID dans INFORMATION. Si vous souhaitez associer le capteur à plusieurs connexions, séparez les ID par une virgule à l'intérieur de guillemets doubles : "value1,value2".
U	n/a
V	n/a
W	ID du contexte réseau (obligatoire)

Suppression de capteur

Les colonnes suivantes doivent être remplies pour supprimer un capteur.

Colonne	Définition
A	Directive (obligatoire) DELETE pour supprimer un capteur.
B	DevEUI (obligatoire) DevEUI du capteur à supprimer.