La plupart des capteurs LoRaWAN utilisent OTAA (activation par voie radio) : l’appareil rejoint le réseau avec sa AppKey, et le serveur réseau lui attribue une nouvelle session. Cette page explique comment enregistrer un tel appareil. Pour les appareils fournis avec des clés de session fixes, voir Ajouter un appareil ABP. Pour ajouter plusieurs appareils qui partagent 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 | EUI de l’appareil | 16 chiffres hexadécimaux |
| JoinEUI | AppEUI (en LoRaWAN 1.0.x) | 16 chiffres hexadécimaux. De nombreux 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é au secteur, toujours en écoute) |
Ces valeurs figurent sur l’étiquette de l’appareil, sur une fiche fournie avec lui, ou dans le portail du fournisseur. Son plan de fréquences doit correspondre à celui de vos passerelles.
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 maximum |
| DevEUI | L’EUI de l’appareil. | 16 chiffres hexadécimaux ; pas uniquement des zéros, pas uniquement des 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 émission) ou C (alimenté au secteur, toujours en écoute) | A par défaut |
Les espaces, - et : 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 joint après sa première demande de jonction. Sélectionnez Ouvrir l’appareil pour accéder à son onglet LoRaWAN, ou En 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 indique Joint.
Avertissement
L’AppKey est stockée chiffrée et n’est jamais ré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 un appareil dans votre limite. 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 n’indique 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 « déjà enregistré », vérifiez s’il a été ajouté auparavant dans votre propre organisation, ou par le mode appairage.
Modifier l’AppKey ultérieurement
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. Réglez la même clé dans l’appareil, sinon il n’est plus 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 ont les valeurs par défaut indiquées. La réponse ne contient jamais l’AppKey ; elle renvoie hasAppKey: true. Voir l’API LoRaWAN.

