Les réglages radio LoRaWAN se trouvent sur le profil d’appareil, dans son onglet LoRaWAN. Chaque appareil LoRaWAN du profil les utilise. L’onglet apparaît sur les profils dont le transport est LoRaWAN ; tout autre profil affiche This profile is not a LoRaWAN profile.
Pour les profils en général, voir Device profiles.
Les profils intégrés
Hermetry crée deux profils la première fois que vous ajoutez une passerelle ou un appareil LoRaWAN :
| Profil | Utilisé par | Règle de connexion |
|---|---|---|
| LoRaWAN EU868 Class A OTAA (1.0.3) | Chaque appareil final que vous ajoutez avec New device > LoRaWAN device | Recent message : en ligne tant que la dernière liaison montante est plus récente que trois intervalles attendus (intervalle attendu de 3 600 s, soit 3 heures) |
| LoRaWAN gateway | Chaque passerelle Basics Station | Live connection : en ligne tant que la connexion de la passerelle est ouverte |
Les deux profils sont retrouvés par une clé interne, donc les renommer est possible. Ils ne peuvent pas être supprimés et leur transport ne peut pas changer.
Vous pouvez aussi créer votre propre profil avec le transport LoRaWAN, par exemple un par type de capteur. Les appareils ajoutés par le mode appairage sont placés dans le profil où vous avez lancé l’appairage.
Ouvrir l’onglet
- Ouvrez Device Profiles dans le menu IoT et ouvrez le profil.
- Sélectionnez l’onglet LoRaWAN.
- Modifiez les champs et sélectionnez Save. Seuls les champs modifiés sont envoyés.
La consultation nécessite l’autorisation de voir les appareils LoRaWAN ; l’enregistrement nécessite l’autorisation d’ajouter, modifier et supprimer les appareils LoRaWAN (administrateurs par défaut). Chaque enregistrement est audité sous iot_lorawan.profile.settings_updated.
Radio
| Champ | Signification | Par défaut | Valeurs autorisées |
|---|---|---|---|
| Region | Le plan de fréquences. | EU868 | EU868 uniquement (le champ est verrouillé) |
| LoRaWAN version | La version donnée aux appareils ajoutés par le mode appairage. Un appareil ajouté à la main conserve la version choisie dans son propre formulaire. | 1.0.3 | 1.0.2, 1.0.3, 1.0.4 |
| Class | La classe donnée aux appareils ajoutés par le mode appairage. La classe de chaque appareil se règle sur son propre onglet LoRaWAN. | A | A, C |
| RX1 delay (seconds) | Délai entre une liaison montante et l’ouverture de la première fenêtre de réception de l’appareil. Envoyé à l’appareil lors de son join ; un appareil qui fonctionne déjà avec un autre délai reçoit une demande de changement par commande MAC jusqu’à confirmation. | 5 | Secondes entières 1–15 |
| Adaptive data rate (ADR) | Permet au serveur réseau d’augmenter le débit de données et de réduire la puissance d’émission des appareils ayant un bon signal. | On | On ou off |
| Lowest data rate (DR) | Le débit de données le plus bas que l’ADR peut utiliser. | DR0 | DR0–DR5, sans dépasser le plus élevé |
| Highest data rate (DR) | Le débit de données le plus élevé vers lequel l’ADR peut faire passer un appareil. | DR5 | DR0–DR5 |
| De-duplication window (ms) | Durée pendant laquelle les copies d’une même liaison montante reçues de plusieurs passerelles sont collectées. | 200 | Millisecondes entières 50–1 000 |
| Confirmed downlink: wait for the acknowledgement (seconds) | Classe C uniquement : une liaison descendante confirmée est renvoyée si l’appareil ne l’a pas acquittée dans ce délai. | 60 | Secondes entières 5–3 600 |
Gardez le RX1 delay à 5 secondes, sauf si toutes vos passerelles disposent d’une liaison internet rapide et stable. Un serveur réseau dans le cloud a besoin de temps pour répondre via internet ; avec un délai de 1 seconde, les passerelles lentes manquent RX1.
Décodage
| Champ | Signification | Par défaut |
|---|---|---|
| Codec | Le codec des appareils du profil réglés sur Automatic. Voir Codecs. | Automatique (par fabricant et port) |
| Ajouter les valeurs radio (lora.rssi, lora.snr, …) à chaque message | Ajoute lora.rssi, lora.snr, lora.gw_count, lora.dr, lora.freq, lora.fcnt_up (et, lorsque l’appareil les transmet, lora.battery_level et lora.margin_db) à chaque message de l’appareil. | On |
Les clés décodées entrent dans vos flux ; elles ne sont stockées que là où un flux les enregistre (le flux racine par défaut le fait).
Join
| Champ | Signification | Par défaut |
|---|---|---|
| Accept any JoinEUI | Un interrupteur au niveau du profil pour les appareils dont le JoinEUI n’est pas connu. | Off |
| Devices added by pairing mode are ready at once (no approval) | Off : les appareils ajoutés par le mode appairage attendent une approbation. On : ils fonctionnent immédiatement. | Off |
| Shared AppKey | Une AppKey pour les appareils du profil. Nécessaire pour le mode appairage. | Aucune |
La vérification du join compare elle-même le JoinEUI de chaque appareil, sauf si le réglage anyJoinEui propre à cet appareil est activé. Vous le réglez par appareil via l’API (PATCH /tenant/<tenantId>/api/iot/lorawan/devices/<deviceId> avec { "anyJoinEui": true }).
La shared AppKey
- L’onglet affiche A shared AppKey is stored (never shown). ou No shared AppKey.
- Pour la définir ou la remplacer, saisissez 32 chiffres hexadécimaux dans New shared AppKey (32 hexadecimal digits) et sélectionnez Save.
- Pour la supprimer, cochez Remove the shared key et enregistrez.
- La clé est stockée chiffrée et n’est jamais réaffichée.
Les appareils ajoutés par le mode appairage utilisent la clé partagée du profil. Les appareils ajoutés à la main ont toujours leur propre AppKey.
Statut en ligne
L’onglet affiche la règle de connexion du profil en lecture seule, par exemple Online rule: Recent message. Modifiez-la sur l’onglet Online status du profil.
Réglages disponibles uniquement via l’API
PUT /tenant/<tenantId>/api/iot/lorawan/profiles/<profileId>/settings accepte ces champs en plus de ceux ci-dessus :
| Champ | Signification | Par défaut | Valeurs autorisées |
|---|---|---|---|
rx1DrOffset | Décalage du débit de données RX1 | 0 | 0–5 |
rx2Dr | Débit de données RX2 ; null = valeur par défaut de la région (DR0) | null | 0–7 ou null |
rx2Freq | Fréquence RX2 en Hz ; null = valeur par défaut de la région (869,525 MHz) | null | 100 000 000–1 000 000 000 ou null |
installationMarginDb | Marge de sécurité conservée par l’ADR, en dB | 10 | 0–30 |
devStatusIntervalH | Fréquence à laquelle l’appareil est interrogé sur sa batterie et sa marge de liaison, en heures ; 0 = jamais | 24 | 0–720 |
maxRetries | Envois d’une liaison descendante confirmée avant abandon | 3 | 0–10 |
classCMaxAgeS | Délai après sa dernière liaison montante pendant lequel un appareil de classe C est encore joint directement, en secondes | 900 | 60–86,400 |
maxDutyCycle | Limite de cycle d’utilisation agrégé demandée à l’appareil (0 = aucune) | 0 | 0–15 |
Le corps est strict : un champ inconnu est refusé. sharedAppKey est en écriture seule ; null le supprime.
Mode appairage
Sous les réglages, l’onglet contient la section Pairing mode. Voir Pairing mode.