Loko · Guide de configuration

Connecter Loko au réseau LoRaWAN

Associez vos traceurs Loko Air à The Things Network (TTN) et commencez à recevoir des positions en direct dans l'application, en quatre étapes rapides.

~10 min · Accessible aux débutants

Loko reçoit les positions de vos traceurs via LoRaWAN, un réseau radio longue portée et basse consommation. Pour acheminer ces messages radio vers votre téléphone, l'application se connecte à The Things Network (TTN), un réseau communautaire LoRaWAN mondial et gratuit.

La configuration se déroule à deux endroits : vous créez d'abord une application dans la console TTN et enregistrez vos appareils, puis vous collez deux identifiants dans l'application Loko. Voici tout ce dont vous avez besoin.

Ce dont vous aurez besoin

  • Un compte TTN gratuitInscrivez-vous sur thethingsnetwork.org si vous n'en avez pas.
  • Les informations de votre appareil Loko AirLes DevEUI / JoinEUI / clés — que vous définissez vous-même lors de l'enregistrement de l'appareil.
  • L'application Loko installéeSur le téléphone que vous utiliserez pour suivre vos appareils.
🎯
À la fin, vous aurez deux valeurs — un Application ID et une API Key — les seuls éléments dont l'application a besoin pour démarrer.
1

Créer une application sur TTN

Connectez-vous à la console TTN, ouvrez la section Applications et cliquez sur + Add application. Donnez-lui un ID et un nom, puis cliquez sur Create application.

Page Create application de TTN 1 2
① Choisissez votre Application ID · ② Cliquez sur Create application
📝
Notez votre Application ID. Vous en aurez besoin pour l'application. Dans l'exemple ci-dessus, c'est demolokoappid. L'ID doit être en minuscules et ne peut pas être modifié par la suite.
2

Enregistrer vos appareils Loko Air

Dans la barre latérale gauche, ouvrez End devices, puis cliquez sur Register end device.

Page End devices de TTN 1 2
① Ouvrez End devices · ② Register end device

Sur l'écran d'enregistrement, choisissez « Enter end device specifics manually », puis renseignez les détails de l'appareil de votre Loko Air (plan de fréquence, version LoRaWAN et les informations d'approvisionnement telles que JoinEUI / DevEUI).

Page Register end device de TTN 1 2
① Enter end device specifics manually · ② Renseignez les informations d'approvisionnement de votre appareil
📡
Choisissez le plan de fréquence de votre région (par ex. Europe 863–870 MHz) et faites correspondre la version LoRaWAN à votre Loko Air. Répétez cette étape pour chaque traceur que vous possédez.
3

Créer une clé d'API

De retour dans la barre latérale, ouvrez API keys et cliquez sur + Add API key. Accordez-lui les droits de lecture du trafic de l'application, puis enregistrez.

Page API keys de TTN 1 2
① Ouvrez API keys · ② Add API key
🔑
Copiez la clé d'API immédiatement. TTN n'affiche la clé complète qu'une seule fois, juste après sa création. Conservez-la en lieu sûr : si vous la perdez, vous devrez en générer une nouvelle.

Facultatif — testez avec MQTT Explorer

Avant de saisir les identifiants dans Loko, vous pouvez vérifier qu'ils fonctionnent avec n'importe quel client MQTT open source, par exemple MQTT Explorer. Il se connecte directement au serveur MQTT de TTN et affiche les messages uplink bruts, un moyen rapide de confirmer que tout est correctement configuré.

Paramètres de connexion MQTT Explorer pour TTN 1 2 3 4
① Protocole mqtt:// · Host · Port 1883 · ② Username = App ID @ttn · ③ Password = clé d'API · ④ Connect
🔌
Utilisez ces paramètres : Protocol mqtt://, Host eu1.cloud.thethings.network (selon votre région), Port 1883. Le Username est votre Application ID avec @ttn ajouté (la même règle que dans l'application !), et le Password est votre clé d'API. Cliquez sur Connect : si la connexion s'établit et que des topics apparaissent, vos identifiants sont valides.
4

Se connecter depuis l'application Loko

Ouvrez l'application Loko, accédez à la feuille LoRaWAN (TTN) et saisissez vos identifiants. Choisissez votre région avec les boutons Quick select (EU1 / NAM1 / AU1), puis collez l'Application ID et la clé d'API.

Feuille de paramètres LoRaWAN de l'application Loko 1 @ttn 2 3
① Application ID (ajoutez @ttn !) · ② clé d'API · ③ Save
⚠️
Important — ajoutez @ttn à votre Application ID. Dans le champ Application ID de l'application, ajoutez @ttn à la fin de l'ID que vous avez noté à l'étape 1. Sans ce suffixe, la connexion échouera.
Votre Application ID devient donc
demolokoappid@ttn

Appuyez sur Save. Lorsque l'indicateur d'état en haut de la feuille passe à ● Connected, l'application est active sur le réseau et les positions de votre traceur commencent à apparaître sur la carte.

🎉 Vous êtes connecté !

Vos appareils Loko Air transmettent désormais leurs positions à l'application via TTN. À partir d'ici, vous pouvez définir des géorepérages, consulter les trajets archivés et télécharger des cartes hors ligne pour le terrain.

💬
Besoin d'aide ? Si vous rencontrez des problèmes lors de la configuration, consultez notre section FAQ ou contactez notre équipe d'assistance — nous sommes là pour vous aider à vous connecter.