Loko · Guide de configuration

Connexion du Loko au ChirpStack

Exécutez votre propre serveur réseau LoRaWAN ? Voici comment obtenir vos trackers Loko Air rejoint, décodé et cartographié sur un site auto-hébergé ChirpStack exemple - dans six des étapes courtes.

~20 min · Adapté aux débutants

Les trackers Loko Air parlent clairement LoRaWAN, ils fonctionnent donc avec n'importe quel serveur réseau — pas seulement le Things Network. Si vous préférez conserver vos données par vous-même les infrastructures, ChirpStack est un serveur réseau LoRaWAN gratuit et open source que vous pouvez héberger vous-même.

Tout ce qui suit se passe à l'intérieur du Locataire section du site Web ChirpStack console. La barre latérale comporte deux groupes de navigation : Serveur réseau détient mondial, paramètres à l’échelle du serveur pour tous les locataires, tandis que Locataire contient tout pour votre propre organisation – c’est là que tout le travail se déroule.

Ce dont vous aurez besoin

  • Une instance ChirpStack en cours d'exécutionCelui auquel vous pouvez vous connecter (ce guide utilise le admin compte).
  • Une passerelle LoRaWANCela peut atteindre votre serveur ChirpStack - ainsi que son ID de passerelle.
  • Les identifiants de votre appareil Loko AirLe DevEUI, JoinEUI (AppEUI) et Clé d'application programmed sur l'appareil.
🎯
À la fin, vous aurez un passerelle en ligne, un appareil qui termine son rejoindre, et les mesures décodées rendues sous forme jauges sur le tableau de bord de l'appareil.
1

Assurez-vous qu'une passerelle est en ligne

Ouvrir Locataire → Passerelles. Vous avez besoin d'au moins une passerelle affichant un vert En ligne statut avant qu’un appareil puisse se joindre. Si la liste est vide, cliquez sur Ajouter une passerelle et enregistrez le vôtre.

ChirpStack Gateways list showing gateway ID and online status 1 2 3 4
① Passerelles · ② Ajouter une passerelle · ③ ID de passerelle · ④ Statut (doit devenir vert)
🆔
La seule chose que vous devez fournir lors de l'ajout d'une passerelle est son ID de passerelle — un EUI hexadécimal de 16 caractères comme 782184ffff9f3249. Trouvez-le sur l'écran de la passerelle, sur une étiquette ou dans sa page d'administration/manuel. Aussi choisissez la correspondance Région (par ex. EU868).
⚠️
Attendez le vert. Dans la capture d'écran ci-dessus, la passerelle affiche un rouge Hors ligne point (④). Ne continuez pas avant Vu pour la dernière fois mises à jour et statut tourne En ligne — une passerelle hors ligne ne reçoit aucun trafic radio, donc rien ne le fera jamais rejoindre.
2

Créer un profil d'appareil

Un profil d'appareil décrit le comportement d'une classe d'appareils : région, Version LoRaWAN, méthode de jointure et codec de charge utile. Ouvrir Locataire → Profils de périphérique et cliquez Ajouter un profil d'appareil.

ChirpStack Device profiles list with the Add device profile button 1 2
① Ouvrir les profils d'appareil · ② Ajouter un profil d'appareil

Sur le Général onglet, remplissez l'essentiel - un nom, votre région et le Version MAC LoRaWAN utilisée par votre Loko Air.

ChirpStack Add device profile General tab with name, region and MAC version 1 2 3
① Nom (par exemple Generic-OTAA-EU868) · ② Région (EU868) · ③ Version MAC
📡
Choisissez le Région et Version MAC qui correspondent à votre Loko Air et votre passerelle (par ex. EU868 et LoRaWAN 1.0.3). Partir Révision des paramètres régionaux et Algorithme ADR à leur valeurs par défaut.

Passez au Rejoindre (OTAA / ABP) onglet et allumer L'appareil prend en charge OTAA — Les trackers Loko Air se rejoignent par voie aérienne.

ChirpStack device profile Join OTAA tab with Device supports OTAA enabled 1 2
① Onglet Rejoindre (OTAA / ABP) · ② L'appareil prend en charge OTAA = activé

Enfin, ouvrez le Codec de charge utile onglet et sélectionnez Cayenne LPP, alors cliquez Soumettre.

ChirpStack device profile Payload codec tab set to Cayenne LPP 1 2 3
① Onglet Codec de charge utile · ② Cayenne LPP · ③ Soumettre
🧩
Cayenne LPP permet au ChirpStack de décoder automatiquement le brut charge utile en mesures nommées (position du GPS, batterie, etc.) - c'est ce qui fait les jauges de l'étape 6 sont possibles.
3

Créer une application

Ouvrir Locataire → Applications et cliquez Ajouter une application. Donnez-lui un nom (par ex. Loko) et enregistrez. Une application n'est que le conteneur qui regroupe vos appareils.

ChirpStack Applications list with the Add application button 1 2
① Ouvrir des applications · ② Ajouter une application
4

Ajoutez vos appareils

Cliquez sur l'application que vous venez de créer pour l'ouvrir. Il atterrit sur le Appareils onglet, où un Ajouter un appareil Le bouton apparaît. Une fois les appareils existants, leur DevEUI et Profil d'appareil afficher sous forme de liens cliquables.

ChirpStack application Devices tab listing a Loko device 1 2 3
① Ajouter un appareil · ② DevEUI (ouvre l'appareil) · ③ Profil de l'appareil

Cliquez Ajouter un appareil et remplissez les détails de votre Loko Air, puis Soumettre:

ChirpStack Add device form with name, Device EUI, Join EUI and device profile 1 2 3 4 5
① Nom · ② Appareil EUI (DevEUI) · ③ Rejoindre EUI · ④ Profil de l'appareil · ⑤ Soumettre
🔑
La clé d'application vient ensuite. Étant donné que le profil utilise OTAA, après avoir soumis, ChirpStack ouvre le Clés OTAA languette. Entrez (ou collez) le l'appareil Clé d'application (AppKey) là et Soumettre.
⚠️
Tout doit correspondre à l'appareil physique. Le DevEUI, JoinEUI et AppKey vous entrez doit être identique à ce qui est programmé sur programmed le Loko Air – sinon la jointure échouera silencieusement. Répétez cette étape pour chaque tracker que vous possédez.
5

Confirmez la participation et regardez les images

De retour dans la liste des appareils de l'application, cliquez sur l'icône d'un appareil. DevEUI à ouvrez-le, puis explorez les onglets - Clés OTAA, Activation, Événements et Trames LoRaWAN. La vue frames montre le trafic radio brut en temps réel.

ChirpStack device LoRaWAN frames showing JoinRequest and JoinAccept 1 2
① Onglet Trames LoRaWAN · ② JoinRequest → JoinAccept, puis trames de données
Un appareil sain affiche un RejoindreDemande suivi d'un RejoindreAccepter, alors Données non confirmées / Données en baisse non confirmées cadres - chacun répertoriant les DevEUI et le ID de passerelle qui a reçu eux. Si seulement tu voyais RejoindreDemande en répétant, revérifiez le DevEUI / JoinEUI / AppKey et que votre passerelle est en ligne.
6

Visualisez les mesures sous forme de jauges

Une fois les données décodées circulent (grâce au codec Cayenne LPP), ouvert Locataire → Profils d'appareil → votre profil → Mesures. Avec Détecter automatiquement les clés de mesure allumé, ChirpStack liste les clés dont il dispose vu - comme Battery_Voltage, gpsLocation_1_latitude et gpsLocation_1_longitude - alors définissez ceux qui vous tiennent à cœur Jauge.

ChirpStack device profile Measurements tab with keys set to Gauge 1 2 3
① Onglet Mesures · ② Touches de détection automatique · ③ Définir le type sur Jauge
📊
Choisissez le bon gentil pour chaque clé : Jauge pour les lectures comme la tension, la température ou la position ; Comptoir pour incrémenter continuellement compteurs; Absolu pour les compteurs réinitialisés à chaque liaison montante ; Chaîne pour texte ou valeurs booléennes. Donnez-lui un amical Nom de la mesure, cliquez Soumettre, et les valeurs s'affichent sous forme de jauges et de graphiques sur l'écran de l'appareil. Tableau de bord.

Liste de contrôle rapide

  • Passerelle ajoutée et affichée vert / En ligne
  • Profil d'appareil créé : région, version MAC, OTAA activé, Cayenne LPP codec
  • Application créée
  • Appareil ajouté avec correspondance DevEUI + JoinEUI
  • Clé d'application renseigné sur l'onglet Clés du OTAA
  • RejoindreDemande / RejoindreAccepter et trames de données visibles sous les trames LoRaWAN
  • Mesures réglées sur Jauge pour visualiser les données

🎉 Vous êtes opérationnel !

Votre passerelle est en ligne, votre appareil Loko Air a rejoint et son décodé les mesures sont visualisées sous forme de jauges. De là, vous pouvez ajouter plus d'appareils, connectez les intégrations pour faire avancer les données ou créez des tableaux de bord au-dessus des API ChirpStack.

Vous préférez un réseau hébergé ? Connexion du Loko au The Things Network → La configuration TTN en quatre étapes : créez une application, enregistrez les appareils, générez une clé API et connectez-vous à partir de l'application Loko.
💬
Besoin d'aide ? Si vous rencontrez des problèmes lors de l'installation, consultez notre Section FAQ ou contactez notre équipe d'assistance - nous sommes là pour vous aider vous êtes connecté.