Déclarer un objet connecté sur The Things Network
Présentation
Ce tutoriel vous permet d’enregistrer un objet connecté sur The Things Network. Son enregistrement est nécessaire pour déclarer où les données de votre objet connecté vont arriver, et quels sont les codes d’accès à cet endroit (en toute logique, ces codes seront à renseigner à un unique objet connecté : si vous voulez avoir un deuxième objet connecté, il faudra plutôt répéter la même opération)
Etapes du tutoriel
Ce tutoriel est découpé en plusieurs étapes :
- Création d’un compte sur TheThingsNetwork
- Création d’une application ( = un dossier qui regroupera vos différents objets connectés)
- Déclaration d’un objet connecté dans votre application
1. Création d'un compte sur TheThingsNetwork
Si vous aviez déja un compte, vous pouvez déjà passer à la section n°2.
TheThingsNetwork (ou TTN) est une plateforme qui permet de récupérer les données issues de vos objets connectés pour les visualiser. Votre compte sur cette plateforme permettra, entre autres, de visualiser l’état de votre flotte d’objets connectés ainsi que vos antennes LoRa si vous en avez (tutoriel à disposition ici). Une inscription à TTN est nécessaire :
Etape 1 :
Accédez à la page d’accueil de TTN :
https://www.thethingsnetwork.org/
(vous pouvez y accéder également depuis Google en tapant TTN)
Cliquez sur le bouton « Sign Up » en haut à droite
Etape 2 :
Descendez dans la page suivante jusqu’à observer le bouton « Join The Things Network » (entouré en rouge ci-contre)
Etape 3 :
A priori vous n’avez pas encore de compte, cliquez sur « Sign up for free«
Etape 4 : Dans cette nouvelle page, il faut remplir :
- le Username (ou pseudo) : ne doit contenir QUE des minuscules ou des chiffres! (pas de caractères spéciaux, pas de majuscule !)
- l’email : un mail de confirmation vous sera envoyé, il faudra le valider impérativement
- votre mot de passe (en double)
- la case des conditions d’utilisation
Terminer par cliquer sur le bouton bleu « Sign up to The Things ID »
Etape 5 : Un mail de confirmation vous a été envoyé. Ouvrez le dans votre boite mail, vous devrez cliquer sur le bouton bleu « confirm account » dans le mail.
Ce bouton vous redirige vers un autre bouton bleu « confirm account », puis sur un bouton « login now ». Identifiez vous avec vous nouveaux identifiants.
Etape 6 :
Retournez sur le site de The Things Network, en tapant « TTN » sur google ou en allant directement sur le site :
https://www.thethingsnetwork.org/
De nouveau sur la page d’accueil, vous devriez voir votre nom de pseudo en haut à droite. Si ce n’est pas le cas, cliquez sur Login en haut à droite, renseignez vos identifiants et vous verrez alors votre pseudo.
Etape 7 :
Cliquez en haut à droite sur votre pseudo, puis dans la liste déroulante, cliquez sur « Console »
Etape 8 :
Choisissez « Europe 1 » dans la nouvelle page
Etape 9 :
Bienvenue sur la page d’accueil de votre console TTN !
2. Création d'une application
Si vous aviez déja une application active, vous pouvez déjà passer à la section n°3.
Vous êtes sur la page d’accueil de la console de TTN (ou TheThingsNetwork). En haut à gauche, vous avez 3 boutons : « Home », « Applications » et « Gateways » :
- « Home » est la page d’accueil, celle où vous êtes !
- « Gateways » sert à enregistrer et visualiser l’état d’une passerelle (ou box) LoRa. C’est ici qu’il faudra aller si vous avez acheté une passerelle LoRa, pour couvrir un lieu avec ce réseau.
- « Applications » est le bouton qui nous intéresse : On va créer une application (ou App), c’est à dire une sorte de dossier qui va regrouper plusieurs objets connectés. On peut voir ça comme un groupe d’objets connectés. Vous pouvez par exemple créer une application pour un projet, ou pour une exploitation, pour une parcelle, etc… Vous pouvez créer plusieurs applications.
Etape 1 : On Clique donc sur le bouton en haut à gauche « Applications »
Etape 2 :
Vous arrivez sur la page de vos applications. A priori, vous n’en n’avez pas encore.
Cliquez en haut à droite sur le bouton bleu « add application »
Etape 3 : Une page s’ouvre, avec 3 champs à remplir.
- Application ID est le seul obligatoire. Par exemple le nom de votre entreprise, votre nom, … Attention, cet identifiant d’application ne doit contenir QUE des minuscules ou des chiffres ! (le « – » est également autorisé).
- Application name est optionnel. C’est un nom plus détaillé de votre application.
- Description permet de remplir des détails éventuels sur votre application
Terminez par le bouton bleu « Create application »
Etape 4 : Vous êtes redirigés sur la page principale de l’application. Votre app est créée !
Sur la page principale Overview, plusieurs onglets sont disponibles à gauche :
- Overview : cette page
- End devices : Pour afficher la liste des objets connectés déclarés dans cette app
- Live Data : Pour afficher les données en temps réel de tous les objets connectés présents dans cette app.
- Collaborators : pour donner accès à votre app à un autre utilisateur de TTN. Cela peut-être utile si vous êtes plusieurs à gérer la flotte d’objets connectés. L’identifiant de la personne supplémentaire est nécessaire.
- Les autres onglets seront détaillés plus tard.
Etape 5 : Si jamais vous êtes perdus, vous pouvez revenir à l’application de votre choix en cliquant dans l’onglet ‘Application’ tout en haut de la page, puis en cliquant sur le nom de l’application que vous souhaitez accéder.
Etape 6 : Sur la page principale de votre application, allez à gauche dans Payload formatters puis Uplink.
Dans le champ Formatter type, choississez Custom Javascript formatter.
N’oubliez pas de cliquer sur le bouton bleu « Save changes » en bas de cette page.
3. Lier l'application à la console mobilab
Si votre application est déja liée à la console mobilab, vous pouvez passer directement à la section 4.
TTN permet de déclarer des nouveaux objets connectés, de visualiser s’il sont fonctionnels, mais ne stocke pas indéfiniment les données des capteurs. Pour cela, il est nécessaire de lier votre application avec l’outil qui vous permettra de visualiser les données : la console mobilab. L’utilisation de la console mobilab vous sera détaillé plus tard, pour l’instant nous allons juste faire le lien entre TTN et la console mobilab
Etape 1 : on clique sur l’onglet Integrations puis sur MQTT.
Dans la page qui s’ouvre, on observe la partie « connection credentials ».
Cliquez sur « Generate new API key »
Etape 2 : un mot de passe apparaît, vous pouvez le copier avec le logo à sa droite 
en passant la souris sur le mot de passe.
Pour lier TTN à la console mobilab, il faudra envoyer un mail à mobilab@agrotic.org avec les infos suivantes :
- Le Username ci-dessus
- le password ci-dessus
- votre numéro de telephone (si vous voulez recevoir une alerte de votre objet connecté par exemple)
- votre mail
- votre nom
Etape 3 : Quelques temps après l’envoi du mail, vous recevrez une réponse contenant vos identifiants pour se connecter à la console mobilab, ainsi que les Conditions Générales d’Utilisation de la console.
En attendant de recevoir ce mail, vous pouvez continuer ce tutoriel !
4. Enregistrement d'un Objet connecté
On arrive enfin à la partie importante : enregistrer un objet connecté dans notre app. On va créer « virtuellement » notre objet connecté dans l’app, et récupérer des codes d’accès que l’on va donner à notre Objet Connecté. Il pourra alors envoyer ses données à cet endroit précis de notre app.
Etape 1 : On clique sur l’onglet End Devices à gauche de la page principale Overview. Aucun objet connecté n’est encore déclaré sur cette page. On clique sur le bouton bleu Register end device
Etape 2 : Sur la page suivante, on choisit Input Method : « Enter end device specifics manually ». Trois champs apparaissent, ils permettent de définir quel est le type de communication de notre objet connecté :
- Frequency plan : Choisir Europe 863-870MHz (SF9 for RX2 – recommended). C’est la fréquence d’émission : elle dépend du continent.
- LoRaWAN version : choisir « v1.0.2 ».
- Regional Parameters : Choisir « 1.0.2 revision B »
Etape 3 : Si vous avez rempli les 3 champs ci-dessus, un dernier champ apparait :
- Join EUI : C’est un code d’accès du futur objet connecté pour se connecter à l’application. Remplir de chiffres aléatoires. Deux capteurs d’une même application ne doivent pas avoir le même Join EUI ! Cela provoquerait une collision entre les données si elles arrivent en même temps.
Etape 4 : Après avoir cliqué sur ‘Confirm’, 3 nouveaux champs apparaissent :
- DevEUI : Cliquer sur le bouton Generate. C’est un identifiant d’accès unique à l’objet connecté pour pouvoir envoyer les données sur notre application.
- AppKey : Cliquer sur le bouton Generate. C’est le mot de passe pour que notre objet connecté puisse se connecter à l’application
- End device ID: A remplir uniquement avec des minuscules et des chiffres : par exemple pilowtech-1. C’est l’identifiant unique à l’objet connecté. Référez vous au tutoriel pour savoir comment votre objet connecté doit s’appeler !! (il doit commencer obligatoirement par « pilowtech- » pour les pilowtechs, « irritrace- » pour les irritrace, etc.)
Etape 5 : Notre objet connecté est enfin enregistré ! on arrive sur sa page principale. On y retrouve plusieurs onglets (notamment Live data) qui permettront de voir quand les données de l’objet connécté arriveront.
Etape 6 : Sur cette page principale de notre objet connecté, on descend dans le secteur Activation information. On trouve ici tous les clefs d’accès qu’il faudra donner à notre carte CubeCell : AppEUI, DevEUI, AppKey. AppKey est masquée.
Gardez cette fenêtre de côté, vous pourrez copier tout à l’heure ces 3 clefs dans le code en cliquant sur le bouton .
Ce tutoriel est désormais terminé, vous pouvez revenir à votre projet initial pour envoyer ces clefs à l’objet connecté!
