La plupart des capteurs LoRaWAN utilisent OTAA (activation over-the-air) : l’appareil rejoint le réseau avec son AppKey, et le serveur réseau lui attribue une nouvelle session. Cette page explique comment enregistrer un tel appareil. Pour les appareils livrés avec des clés de session fixes, voir Ajouter un appareil ABP. Pour ajouter de nombreux appareils partageant une même clé, voir Mode appairage.
Vous devez disposer de l’autorisation d’ajouter, de modifier et de supprimer des appareils LoRaWAN (administrateurs par défaut).
Ce dont vous avez besoin auprès du fournisseur de l’appareil
| Valeur | Aussi appelé | Format |
|---|---|---|
| DevEUI | Device EUI | 16 chiffres hexadécimaux |
| JoinEUI | AppEUI (en LoRaWAN 1.0.x) | 16 chiffres hexadécimaux. Beaucoup d’appareils utilisent 0000000000000000. |
| AppKey | Clé d’application | 32 chiffres hexadécimaux |
| Version LoRaWAN | Version MAC | 1.0.2, 1.0.3 ou 1.0.4 |
| Classe | — | A (sur batterie) ou C (alimenté secteur, toujours à l’écoute) |
Ces valeurs figurent sur l’étiquette de l’appareil, sur une fiche fournie avec lui, ou dans le portail du fournisseur. L’appareil doit être un appareil EU868.
Ajouter l’appareil
- Ouvrez Appareils et sélectionnez Nouvel appareil.
- Choisissez Appareil LoRaWAN (« Un appareil final, identifié par son DevEUI, son JoinEUI et son AppKey. »).
- Remplissez le formulaire :
| Champ | Quoi saisir | Règles |
|---|---|---|
| Activation | OTAA (rejoint avec son AppKey) | Par défaut |
| Nom | Un nom que vous reconnaissez. | Obligatoire, 128 caractères au maximum |
| DevEUI | L’EUI de l’appareil. | 16 chiffres hexadécimaux ; ni tous zéros, ni tous F |
| JoinEUI (AppEUI) | Le JoinEUI. Utilisez 0000000000000000 si l’appareil n’en a pas. | 16 chiffres hexadécimaux. Prérempli avec des zéros. |
| AppKey | La clé à 32 chiffres. | 32 chiffres hexadécimaux |
| Version LoRaWAN | La version de l’appareil. | 1.0.2, 1.0.3 (par défaut), 1.0.4 |
| Classe | A (sur batterie, répond après chaque message montant) ou C (alimenté secteur, toujours à l’écoute) | A par défaut |
Les espaces, - et : présents dans les EUI et les clés sont supprimés automatiquement.
- Sélectionnez Ajouter l’appareil.
Le panneau indique L’appareil a été ajouté. Il apparaît comme rejoint après sa première demande de jonction. Sélectionnez Ouvrir l’appareil pour accéder à son onglet LoRaWAN, ou Ajouter un autre pour vider le formulaire.
- Mettez l’appareil sous tension, ou faites-le rejoindre à nouveau le réseau (de nombreux appareils ont un bouton ou un aimant pour cela). Lorsque la jonction réussit, le badge de jonction de son onglet LoRaWAN affiche Rejoint.
Avertissement
L’AppKey est stockée chiffrée et n’est plus jamais affichée. Conservez la fiche du fournisseur. Seule une personne disposant de l’autorisation distincte de révéler les AppKey peut la relire, via l’API, et chaque révélation est consignée dans le journal d’audit.
Ce que Hermetry crée
| Créé | Détails |
|---|---|
| Un appareil | Sur le profil intégré LoRaWAN EU868 Classe A OTAA (1.0.3). Il compte pour une unité dans votre limite d’appareils. Il n’a pas de jeton d’accès : les appareils LoRaWAN ne se connectent jamais eux-mêmes à la plateforme. |
| Un enregistrement LoRaWAN | DevEUI, JoinEUI, version, classe, l’AppKey chiffrée, codec Automatique. |
| Une réservation de DevEUI à l’échelle de la plateforme | Le DevEUI est désormais réservé à votre organisation. |
Les paramètres radio (délai RX1, ADR) proviennent du profil. Voir Profils d’appareils LoRaWAN.
Erreurs
| Message | Cause |
|---|---|
| 16 chiffres hexadécimaux. | Le DevEUI ou le JoinEUI a une longueur incorrecte ou contient d’autres caractères. |
| 32 chiffres hexadécimaux. | L’AppKey a une longueur incorrecte ou contient d’autres caractères. |
| Donnez un nom à l’appareil. | Le nom est vide. |
Ce DevEUI est déjà enregistré. (deveui_taken) | Un autre appareil de la plateforme possède ce DevEUI. Hermetry ne précise pas où. |
| Cette version LoRaWAN n’est pas encore prise en charge. Utilisez 1.0.2, 1.0.3 ou 1.0.4. | LoRaWAN 1.1 a été envoyé via l’API. |
| La limite d’appareils de votre forfait est atteinte. | Il n’y a plus de place pour un appareil supplémentaire. |
Si vous êtes certain que le DevEUI vous appartient et qu’il est indiqué comme « déjà enregistré », vérifiez s’il a été ajouté auparavant dans votre organisation, ou via le mode appairage.
Modifier l’AppKey plus tard
Dans l’onglet LoRaWAN de l’appareil, sous Clés, saisissez la Nouvelle AppKey et sélectionnez Remplacer les clés. Confirmez Remplacer les clés : « L’appareil doit rejoindre à nouveau le réseau avec la nouvelle AppKey. Configurez la même clé dans l’appareil, sinon il cesse d’être entendu. » Une nouvelle AppKey efface aussi l’historique DevNonce de l’appareil, qui repart donc de zéro. Voir L’onglet LoRaWAN de l’appareil.
Ajouter un appareil via l’API
POST /tenant/<tenantId>/api/iot/lorawan/devices
Content-Type: application/json
{
"name": "Cold room 3",
"devEui": "1122334455667701",
"joinEui": "0000000000000000",
"appKey": "2B7E151628AED2A6ABF7158809CF4F3C",
"macVersion": "1.0.3",
"class": "A",
"codecId": "auto",
"anyJoinEui": false
}Seuls name, devEui et appKey sont obligatoires ; les autres prennent les valeurs par défaut indiquées. La réponse ne contient jamais l’AppKey ; elle renvoie hasAppKey: true. Voir l’API LoRaWAN.