DRAFT — Preliminary version, do not share. · Version préliminaire, ne pas partager.

Appareils LoRaWAN

Fundamentum inclut un Join Server LoRaWAN, ce qui permet à vos appareils LoRaWAN de rejoindre le réseau avec des clés gérées dans la plateforme. Cette page vous explique comment enregistrer des appareils LoRaWAN, gérer leur AppKey et pointer votre serveur réseau vers le Join Server.

Fonctionnement

Les appareils LoRaWAN ne se connectent pas directement à Fundamentum. Ils rejoignent le réseau par l'intermédiaire de votre serveur réseau LoRaWAN, qui transmet chaque demande de jonction au Join Server de Fundamentum :

  1. L'appareil envoie une Join Request par voie radio.
  2. Votre serveur réseau envoie un message JoinReq au Join Server par HTTP (POST /join), en utilisant le format LoRaWAN Backend Interfaces.
  3. Le Join Server trouve l'appareil grâce à son DevEUI, vérifie la demande avec l'AppKey de l'appareil et dérive les clés de session (NwkSKey et AppSKey).
  4. Il répond par un message JoinAns, que votre serveur réseau utilise pour terminer la jonction.

Le Join Server prend en charge les jonctions LoRaWAN 1.0.x (par exemple, MACVersion 1.0.2). Il ne crée jamais d'appareils : un appareil doit déjà exister dans un registre avant de pouvoir rejoindre le réseau.

Avant de commencer

1. Enregistrer chaque appareil avec son DevEUI

Créez l'appareil dans le registre avec son DevEUI comme numéro de série, écrit en hexadécimal minuscule (par exemple, 0080000000012345). Utilisez un type d'appareil dont la méthode de communication est Lora : cela indique à la plateforme qu'il s'agit d'un appareil LoRaWAN.

2. Définir l'AppKey

Dans le Hub, ouvrez la page de l'appareil, sélectionnez l'onglet Authentication, puis utilisez Set à côté de l'AppKey LoRa.

La plateforme enregistre l'AppKey avec l'appareil et envoie une commande set-lora-app-key à l'appareil par l'intermédiaire de sa passerelle. Tant que la modification est en attente, le Join Server accepte les jonctions avec l'ancienne ou la nouvelle clé, ce qui permet à l'appareil de continuer à rejoindre le réseau pendant la mise à jour.

3. Pointer votre serveur réseau vers le Join Server

Configurez votre serveur réseau pour qu'il envoie les demandes de jonction de vos appareils au Join Server de Fundamentum.

Une demande de jonction se présente ainsi :

{
  "ProtocolVersion": "1.0",
  "MessageType": "JoinReq",
  "SenderID": "<network-server-id>",
  "ReceiverID": "<join-eui>",
  "TransactionID": 1,
  "MACVersion": "1.0.2",
  "PHYPayload": "<join-request-hex>",
  "DevEUI": "<dev-eui>",
  "DevAddr": "<dev-addr>",
  "DLSettings": "<dl-settings>",
  "RxDelay": 1,
  "CFList": ""
}

4. Rejoindre le réseau et vérifier l'appareil

Mettez l'appareil sous tension. Dès que votre serveur réseau reçoit un JoinAns réussi, l'appareil est sur le réseau.

Étapes suivantes