Introduction :
Le plugins LoraNode va vous permettre de recevoir et d’envoyer des données venant d’un équipement connecté au réseau TTN (The Things Network).
Installation :
Dans le Market Jeedom, cherchez Lora :
TTN V3
Création de l’équipement TTN
Pour notre exemple, je vais ajouter un capteur d’humidité de sol, qui me donne aussi la température et humidité de l’air.
Dans un premier temps, il faut créer l’équipement sur la console TheThingNetworks.
Site de la console eu : https://eu1.cloud.thethings.network/console/applications
Application
Le site TTN fonctionne sur le principe que vous pouvez avoir plusieurs équipements qui ont la même fonctionnalité. Ils sont regroupés dans une un groupe nommé « application ».
On doit créer l’application, cliquez sur Add Application
Puis remplissez le formulaire :
« Application ID » a son importance. Notez le, car on devra le reporter dans Jeedom.
Pour valider : Cliquez sur « Create application ».
End device
Ensuite, on va ajouter notre capteur, allez à gauche dans la partie « End Devices » :
Cliquez à droite sur « Add end device »
Remplissez les champs et notez le « End device ID » que l’on devra reporter dans Jeedom.
Création de l’équipement Jeedom
Dans Jeedom, allez dans le menu Plugins > Protocol domotique > LoRa Node for TTN.
Cliquez sur « Ajouter un équipement » et donnez un nom à cet équipement.
Remplissez les éléments précédemment relevés :
C’est terminé si votre équipement n’a besoin que d’émettre des données.
Les commandes sont automatiquement crées lors de la réception de données, il ne vous reste plus qu’à les personnaliser :
Si Jeedom a besoin d’envoyer des ordres à votre équipement, continuez cette documentation :
Envoyer des données à l’équipement TTN via Jeedom
Pour cet exemple je veux envoyer une donnée wakeup à l’équipement TTN. Wakeup correspond aux intervalles de réveil de l’équipement (à chaque réveil, l’équipement TTN envoi les températures et humidités à Jeedom).
Création de la commande Jeedom
On va créer une commande pour envoyer la donnée. Cliquez sur
Et paramétrez la commande :
Clé API
Si vous avez besoin d’un dialogue Jeedom -> Equipement Lora, vous devez créer une clé API et un Webhook dans la console TTN
Nous avons besoin d’une clé API. A gauche cliquez sur « API Keys »
Puis cliquez sur « Add API Key »
Voici les droits à cocher
Intégration / Webhook
Pour l’échange de données entre Jeedom et TTN, nous allons créer un webhook.
A gauche cliquez sur « Integrations > Webhooks »
Puis cliquez sur « Add Webhook »
Allez tout en bas et cliquez sur « Custom Webhook »
Remplissez « Webhook ID » et notez le (nous allons le reporter dans Jeedom).
Dans « Base URL » copiez l’url donnée dans l’équipement Jeedom créé :
Dans « Downlink API Key », reportez la clé API.
Plus bas dans les « Enabled messages », cochez tout.
Configuration dans Jeedom
On revient maintenant dans Jeedom pour remplir la partie en bas :
Debug et log
Dans Jeedom, mettez le log en débug, il contiendra beaucoup d’informations.
Dans la console TTN, vous pourrez suivre les échanges de données dans Live Data :
TTN V2 (ancienne doc V2)
Principe de fonctionnement :
1- Dans TTN :
– Vous allez enregistrer votre équipement dans la console applications de TTN : https://console.thethingsnetwork.org/applications
(créez une application, puis un device dans l’application)
– Configurez le « Payload Format » de votre node : Seule la fonction Décoder est obligatoire pour la réception des données d’un Node Lora.
2- Dans Jeedom, vous allez créé un équipement LoRa Node. Renseignez les informations (laissez-vous guider).
3 – Retournez dans TTN, et créez une intégration HTTP dans TTN toujours (tout est expliqué dans la configuration d’un équipement dans le plugins). L’URL d’appel vous est donné dans l’équipement Jeedom.
4- Lorsque TTN reçoit une information de votre équipement (Node), il va l’envoyer sur votre Jeedom via un appel API (attention, votre Jeedom doit-être accessible en https de l’extérieur). Les commandes associées aux valeurs reçues seront automatiquement créées dans votre équipement Jeedom.
5- Si vous utilisez l’envoie de commande (Downlink), vous pouvez ajouter une commande directement dans Jeedom.
Besoin d’aide :
Posez vos questions sur le forum officiel de Jeedom dans ce sujet : https://www.jeedom.com/forum/viewtopic.php?p=743185