Mode appairage

Le mode appairage ajoute des appareils sans saisir chaque DevEUI. Pendant quelques minutes, tout appareil non encore enregistré qui rejoint avec la clé AppKey partagée du profil est ajouté à ce profil. Il convient aux lots de capteurs identiques que le fournisseur a livrés avec une AppKey commune.

Le mode appairage est désactivé par défaut et s’exécute par profil. Vous devez disposer de l’autorisation d’ajouter, de modifier et de supprimer des appareils LoRaWAN pour le démarrer et l’arrêter.

Avant de commencer

• Utilisez un profil LoRaWAN pour le lot, par exemple un profil que vous avez créé pour ce type de capteur. L’appairage ajoute les appareils au profil dans lequel il s’exécute.
• Renseignez la Shared AppKey du profil dans son onglet LoRaWAN (32 chiffres hexadécimaux), puis enregistrez. Sans elle, la section affiche Pairing mode needs a shared AppKey on this profile. et ne propose rien.
• Vérifiez la LoRaWAN version et la Class du profil : les appareils ajoutés par le mode appairage reçoivent ces valeurs.
• Décidez de l’approbation avec Devices added by pairing mode are ready at once (no approval). Désactivé (par défaut), chaque nouvel appareil attend qu’un utilisateur l’approuve. Voir Approving devices added by pairing.
• Assurez-vous qu’une passerelle proche des appareils est Online, et que votre offre dispose de la capacité nécessaire pour les appareils.

Lancer le mode appairage

1. Ouvrez le profil et son onglet LoRaWAN. Faites défiler jusqu’à Pairing mode ; son badge indique Off.
2. Sous For how long, choisissez 5, 15 (par défaut), 30, 60 ou 120 minutes.
3. Sélectionnez Start pairing puis confirmez Start pairing mode : « Pendant n minutes, tout appareil qui rejoint avec la clé AppKey partagée de ce profil est ajouté à vos appareils. Ne le démarrez que lorsque vous mettez sous tension vos propres appareils. »
4. Le badge indique maintenant On: avec le temps restant, qui diminue.
5. Mettez les appareils sous tension, ou faites-les rejoindre le réseau.
6. Suivez Devices added. La liste est relue toutes les 10 secondes tant que l’appairage est actif.
7. Lorsque tous les appareils figurent dans la liste, sélectionnez Stop. Sinon, la fenêtre se ferme d’elle-même à expiration du délai.

Sélectionner à nouveau Start pairing pendant que le mode est actif repousse la fin de la fenêtre ; les appareils déjà trouvés restent dans la liste.

Ce qui se passe pour chaque appareil

1. L’appareil envoie une demande de jonction. Son DevEUI n’est enregistré nulle part sur la plateforme.
2. Le serveur réseau essaie la clé AppKey partagée de chacun de vos profils qui est en mode appairage. Si le contrôle d’intégrité de la demande correspond à l’une d’elles, l’appareil est reconnu. Le serveur réseau ne répond pas à cette première demande.
3. Hermetry ajoute l’appareil à ce profil, nommé LoRa <DevEUI>, avec le codec Automatic, en utilisant la clé partagée, la version et la classe du profil. Il compte dans votre limite d’appareils.
4. Les propriétaires et administrateurs de votre organisation reçoivent une notification : LoRaWAN device DevEUI added by pairing mode.
5. L’appareil envoie sa demande de jonction suivante (les appareils réessaient d’eux-mêmes) :
   • Si l’approbation est requise, la demande est refusée avec Waiting for approval jusqu’à ce qu’un utilisateur approuve l’appareil.
   • Avec ready at once, la demande reçoit une réponse et l’appareil rejoint le réseau.

Le journal des trames affiche la première demande avec la mention Being added by pairing mode.

La liste Devices added

Colonne	Affiche
Name	LoRa <DevEUI> jusqu’à ce que vous le renommiez
DevEUI	L’EUI de l’appareil
Added	Moment où le mode appairage l’a ajouté
Status	Waiting for approval (avec un bouton Approve) ou Ready

La liste affiche les appareils de la fenêtre en cours (ou de la dernière), du plus récent au plus ancien, jusqu’à 200. No device has been added by pairing mode yet. lorsqu’elle est vide.

Règles et garde-fous

• Un DevEUI déjà enregistré, dans votre organisation ou dans une autre, n’est jamais ajouté par appairage. L’appareil d’une autre organisation reste « A device of another network ».
• Un appareil dont la jonction ne correspond à aucune clé AppKey partagée d’un profil en mode appairage est refusé avec Unknown DevEUI, comme d’habitude.
• L’appairage ne fonctionne que dans la fenêtre. Une demande vue dans la fenêtre mais traitée plus tard est vérifiée par rapport au début et à la fin de la fenêtre.
• Lorsque votre limite d’appareils est atteinte, les appareils suivants sont ignorés.
• Un profil sans clé AppKey partagée ne peut pas démarrer l’appairage : Hermetry refuse avec Pairing mode needs a shared AppKey on the profile. (no_shared_appkey).
• Le démarrage et l’arrêt sont inscrits dans le journal d’audit (iot_lorawan.profile.pairing_started, iot_lorawan.profile.pairing_stopped) ; chaque appareil ajouté est journalisé sous iot_lorawan.device.paired.

Via l’API

Requête	Action
GET /tenant/<tenantId>/api/iot/lorawan/profiles/<profileId>/pairing	La fenêtre et les appareils qu’elle a ajoutés
POST …/pairing avec { "minutes": 15 }	Démarre ou prolonge la fenêtre (1–120 minutes)
DELETE …/pairing	L’arrête immédiatement

La réponse est { pairing: { active, until, startedAt, hasSharedAppKey, found: [...] } }.