Déploiement d'un réseau LoRaWAN : Différence entre versions

De Wiki d'activités IMA
(→‎Configuration du LoRaServer)
 
(117 révisions intermédiaires par le même utilisateur non affichées)
Ligne 12 : Ligne 12 :
  
 
==LoRaWAN==
 
==LoRaWAN==
−
 
 
[https://fr.wikipedia.org/wiki/LoRaWAN LoRaWAN] est un protocole de télécommunication permettant la communication à bas débit, par radio, d'objets à faible consommation électrique communiquant selon la technologie LoRa et connectés à l'Internet via des passerelles, participant ainsi à l'Internet des objets. Ce protocole est utilisé dans le cadre des villes intelligentes, le monitoring industriel ou encore l'agriculture. La technologie de modulation liée à LoRaWAN est LoRa, née à la suite de l'acquisition de la startup grenobloise Cycléo par Semtech en 2012. Semtech promeut sa plateforme LoRa grâce à la LoRa Alliance, dont elle fait partie. Le protocole LoRaWAN sur la couche physique LoRa permet de connecter des capteurs ou des objets nécessitant une longue autonomie de batterie (comptée en années), dans un volume (taille d'une boite d'allumettes ou d'un paquet de cigarettes) et un coût réduits.
 
[https://fr.wikipedia.org/wiki/LoRaWAN LoRaWAN] est un protocole de télécommunication permettant la communication à bas débit, par radio, d'objets à faible consommation électrique communiquant selon la technologie LoRa et connectés à l'Internet via des passerelles, participant ainsi à l'Internet des objets. Ce protocole est utilisé dans le cadre des villes intelligentes, le monitoring industriel ou encore l'agriculture. La technologie de modulation liée à LoRaWAN est LoRa, née à la suite de l'acquisition de la startup grenobloise Cycléo par Semtech en 2012. Semtech promeut sa plateforme LoRa grâce à la LoRa Alliance, dont elle fait partie. Le protocole LoRaWAN sur la couche physique LoRa permet de connecter des capteurs ou des objets nécessitant une longue autonomie de batterie (comptée en années), dans un volume (taille d'une boite d'allumettes ou d'un paquet de cigarettes) et un coût réduits.
  
 
LoRaWAN est l'acronyme de Long Range Wide-area network que l'on peut traduire par « réseau étendu à longue portée ».
 
LoRaWAN est l'acronyme de Long Range Wide-area network que l'on peut traduire par « réseau étendu à longue portée ».
  
−
==Matériel==
+
==Matériel fourni==
  
−
*1 [https://www.raspberrypi.org/products/raspberry-pi-3-model-b/ Raspberry Pi 3 Model B] : utilisé pour héberger le serveur LoRaWAN et la passerelle
+
*1 [https://www.raspberrypi.org/products/raspberry-pi-3-model-b/ Raspberry Pi 3 Model B] + carte SD minimum 8go : utilisé pour héberger le serveur LoRaWAN et la passerelle
  
 
*1 [https://wireless-solutions.de/products/radiomodules/ic880a.html Concentrateur IC880A-LoRaWAN] : utilisé comme passerelle
 
*1 [https://wireless-solutions.de/products/radiomodules/ic880a.html Concentrateur IC880A-LoRaWAN] : utilisé comme passerelle
  
−
*X [https://os.mbed.com/platforms/ST-Nucleo-F401RE/ ST-NUCLEO-F401RE] : composé d'un microcontrôleur STM32F4 et d'une connectivité type Arduino Uno Revision 3
+
*3 [https://os.mbed.com/platforms/ST-Nucleo-F401RE/ ST-NUCLEO-F401RE] : composé d'un microcontrôleur STM32F4 et d'une connectivité type Arduino Uno Revision 3
  
−
*X [https://www.st.com/en/evaluation-tools/i-nucleo-lrwan1.html Shield USI I-NUCLEO-LRWAN1 WM-SG-42] : shield radio LoRa
+
*3 [https://www.st.com/en/evaluation-tools/i-nucleo-lrwan1.html Shield USI I-NUCLEO-LRWAN1 WM-SG-42] : shield radio LoRa
  
−
*Capteurs... (HT11 pour la température et l'humidité, PIR pour détection de mouvement infrarouge)
+
*Capteurs... (DHT11 pour la température et l'humidité, PIR pour détection de mouvement infrarouge)
  
 
*Lecteur de carte SD
 
*Lecteur de carte SD
Ligne 33 : Ligne 32 :
 
*Câble USB vers série
 
*Câble USB vers série
  
 +
=Configuration du Rasperry Pi=
 +
 +
==Installation de l'OS et configuration initiale==
 +
 +
Tout d'abord, télécharger [https://www.raspberrypi.org/downloads/raspbian/ Raspbian Stretch Lite], Lite car l'interface graphique n'est pas utile pour notre utilisation. Ensuite, il s'agit simplement de suivre le [https://www.raspberrypi.org/documentation/installation/installing-images/README.md guide d'installation] de l'image sur la carte SD qui sera ensuite insérée dans le Pi.
 +
 +
Avant d'insérér la carte, pensé à ajouter la ligne <code>enable_uart=1</code> à la fin du fichier ''config.txt'' situé dans la partition '''BOOT''' de la carte pour activer la liaison série du Raspberry. Une fois insérer, connecter le câble USB vers série sur le PC et les fils TX et RX sur les pins RX et TX du Pi respectivement. Les pins 8 et 10 de la liaison série du Pi sont visibles ci-dessous :
 +
 +
[[Fichier:gpio_pi3b.png|600px|center|middle|thumb|GPIO Raspberry Pi 3 Model B]]
 +
 +
Le Pi peut maintenant être alimenté, et on peut y accéder via un terminal à l'aide de la commande <code>minicom -8 -b 9600 -o -D /dev/ttyUSB0</code>. Les logins par défaut sont ''pi'' : ''raspberry'' .
 +
 +
Maintenant, il est nécessaire de connecter l'appareil à Internet, relier le ainsi par Ethernet, et il devrait se configurer automatiquement par DHCP. Par la suite, on souhaite se connecter par SSH au Pi, il est ainsi nécessaire de mettre en place une IP statique, pour cela, il faut au préalable récupérer des informations.
 +
 +
Lancer <code>ip -4 addr show | grep global</code> qui retournera ce genre de résultat <code>inet 192.168.42.12/24 brd 192.168.42.255 scope global eth0</code>. On connaît maintenant l'adresse IP du Pi, mais l'IP statique qu'on lui attribuera sera 192.168.42.250 pour s'assurer qu'aucun autre appareil utilise la même IP.
 +
 +
Ensuite, trouver l'adresse du routeur (ou de la gateway) avec <code>ip route | grep default | awk '{print $3}'</code>, dans notre cas on obtient <code>192.168.42.1</code>.
 +
 +
Enfin, récupérer l'adresse du serveur DNS à l'aide de <code>cat /etc/resolv.conf</code> et garder en tête l'adresse après <code>nameserver</code>.
 +
 +
La méthode dhcpcd sera utilisée pour définir l'IP statique:
 +
 +
Edité <code>/etc/dhcpcd.conf</code> comme suit à l'aide de l'éditeur de votre choix (dans mon cas '''nano'''):
 +
 +
# Example static IP configuration:
 +
interface eth0
 +
static ip_address=192.168.42.250/24
 +
#static ip6_address=fd51:42f8:caae:d92e::ff/64
 +
static routers=192.168.42.1
 +
static domain_name_servers=192.168.42.12
 +
 +
Changer le mot de passe du Pi à l'aide de <code>passwd</code> puis rédemarrer le avec <code>sudo halt</code>.
 +
 +
Il est maintenant possible de se connecter en SSH au Pi avec <code>ssh pi@192.168.42.250</code>, il n'est plus nécessaire d'utiliser le câble série.
 +
 +
==Configuration du iC880A-SPI==
 +
 +
Tout d'abord, on configure les ''locales'' pour éviter d'éventuel problèmes, pour cela, taper <code>sudo raspi-config</code>, et naviguer vers Localisation Options/Change Locale. Une fois dans le menu Locale, sélectionner les locales en_GB.UTF-8 et fr_FR.UTF-8 avec la touche espace, puis entrée, et sélectionner fr_FR.UTF-8.
 +
 +
Mettez à jour les pacquettages du Pi avec <code>sudo apt-get update && sudo apt-get upgrade -y</code>.
 +
 +
Il existe un [https://github.com/Lora-net/lora_gateway driver open source] sur le github de [https://github.com/Lora-net Semtech] pour les appareils LoRa basé sur un SX1301, et le concentrateur est justement équipé d'un SX1301. Installez git sur le Pi avec <code>sudo apt-get install git</code>, créé un dossier <code>mkdir -p ~/LoRa/</code>, navigué dedans <code>cd ~/LoRa/</code> et cloné le git <code>https://github.com/Lora-net/lora_gateway</code>. Pour des raisons de débuguage, il faut modifier au préalable la ligne <code>DEBUG_HAL= 1</code> dans <code>/lora_gateway/libloragw/library.cfg</code>.
 +
 +
Compilez la librairie et les quelques programmes de test situés dans les sous-dossiers de ''lora_gateway'' avec <code>make</code>. Si la compilation est réussie, la librairie ''libloragw.a'' a dû être créée et est prête à l'usage par le ''packet tracer'' qui sera installé par la suite.
 +
 +
Ce driver nécessite une interface SPI pour fonctionner, et elle doit être activée sur le Pi. Pour cela, retourner dans le menu <code>raspi-config</code>, puis dans '''Interfacing Options''', activer '''SPI'''. Maintenant que SPI est activé, il faut préparer le ''Reset Pin Control'', pour contrôler le pin du GPIO qui sera connecté au pin Reset du iC880A. C'est très simple, il existe dans le dossier ''lora_gateway'' un fichier shell nommé ''reset_lgw.sh'' et il est lancé de cette manière <code>./reset_lgw.sh {start|stop} [<gpio number>]</code>, dans notre cas, 17 est le pin du GPIO. Plus tard, on configurera le lancement de cette commande au démarrage du Pi. Reliez le concentrateur au Pi comme indiquez ci-dessous:
 +
 +
[[File:P62017_PINIC880ASPI.jpg|500px|left|thumb|Aperçu des composants du concentrateur]]
 +
 +
 +
 +
 +
 +
 +
 +
{| class="wikitable" style="margin: 0 auto;"
 +
|+Correspondance des PINS IC880A <> RaspBerry Pi 3
 +
|-
 +
|21 (VDD)
 +
|2  (+5V)
 +
|-
 +
|22 (GND)
 +
|6  (GND)
 +
|-
 +
|14 (SPI_CLOCK)
 +
|23 (SPI0_CLOCK)
 +
|-
 +
|15 (SPI_MISO)
 +
|21 (SPI0_MISO)
 +
|-
 +
|16 (SPI_MOSI)
 +
|19 (SPI0_MOSI)
 +
|-
 +
|17 (SPI_NSS)
 +
|24 (SPI0_CE0)
 +
|-
 +
|13 (Reset)
 +
|11 (GPIO_17)
 +
|}
 +
<br clear=all>
 +
Pour s'assurer que tout fonctionne bien, lancez l'utilitaire ''util_tx_test'' avec <code>./util_tx_test -r 1257 -f 866.5</code> et vous devriez observer un résultat de ce genre:
 +
 +
Sending -1 LoRa packets on 866500000 Hz (BW 125 kHz, SF 10, CR 1, 16 bytes payload, 8 symbols preamble) at 14 dBm, with 1000 ms between each
 +
lgw_board_setconf:427: Note: board configuration; lorawan_public:1, clksrc:1
 +
lgw_rxrf_setconf:488: Note: rf_chain 0 configuration; en:1 freq:866500000 rssi_offset:0.000000 radio_type:2 tx_enable:1 tx_notch_freq:129000
 +
lgw_rxrf_setconf:488: Note: rf_chain 1 configuration; en:1 freq:866500000 rssi_offset:0.000000 radio_type:2 tx_enable:0 tx_notch_freq:129000
 +
lgw_start:823: Note: calibration started (time: 2300 ms)
 +
lgw_start:844: Note: calibration finished (status = 159)
 +
WARNING: problem in calibration of radio A for TX DC offset
 +
Info: Initialising AGC firmware...
 +
Info: putting back original RADIO_SELECT value
 +
INFO: concentrator started, packet can be sent
 +
Sending packet number 1 ...INFO: tx_start_delay=1495 (1495.500000) - (1497, bw_delay=1.500000, notch_delay=0.000000)
 +
INFO: Enabling TX notch filter
 +
58.a0.0.0.6a.5.1.2.0.9a.10.0.0.8.0.0.54.45.53.54.0.1.61.62.63.64.65.66.67.68.69.6a.end
 +
OK
 +
Sending packet number 2 ...INFO: tx_start_delay=1495 (1495.500000) - (1497, bw_delay=1.500000, notch_delay=0.000000)
 +
INFO: Enabling TX notch filter
 +
58.a0.0.3.3d.5.1.2.0.9a.10.0.0.8.0.0.54.45.53.54.0.2.61.62.63.64.65.66.67.68.69.6a.end
 +
OK
 +
 +
Pour arrêter l'utilitaire, appuyer sur ''Ctrl+C''. Si le test est bien réussi, on peut passer à la mise en place du serveur LoRa.
 +
 +
==Configuration du [https://www.loraserver.io/ LoRaServer]==
 +
 +
===Packet Forwarder de Semtech===
 +
Au préalable, il faut installer le [https://github.com/Lora-net/packet_forwarder ''packet forwarder'' de Semtech], il tournera sur le Pi et permettra de transmettre les paquets RF reçus par le concentrateur vers le serveur LoRa à l'aide d'une liaison IP/UDP.
 +
 +
Comme pour ''lora_gateway'', dans le même dossier, on clone le projet avec <code>git clone https://github.com/Lora-net/packet_forwarder</code>. Il faut maintenant le configurer.
 +
 +
Dans <code>lora_pkt_fwd/cfg/</code>, choisir le <code>global_conf.json</code> adapté à votre utilisation (référez-vous au git du packet_forwarder en cas de doute), '''global_conf.json.PCB_E286.EU868.basic''' dans notre cas, renommez-le en <code>global_conf.json</code> avec <code>mv global_conf.json.PCB_E286.EU868.basic global_conf.json</code>, et remplacer le ''global_conf.json'' dans lora_pkt_fwd/ par celui que vous venez de renommer avec <code>mv global_conf.json ..</code> si vous êtes situé dans le dossier cfg/.
 +
 +
Lorsque le programme est lancé, il effectue une analyse grammaticale des fichiers json :
 +
*s'il détecte un ''debug_conf.json'', il ignore tout autre fichier de configuration
 +
*si c'est un ''global_conf.json'', il l'analyse et passe au fichier suivant
 +
*si il y a un ''local_conf.json qui redéfinit des paramètres présents dans le ''global_conf.json'', alors la configuration locale écrase celle globale.
 +
Ainsi, dans le fichier local, ajouter les lignes comme suit :
 +
"gateway_conf": {
 +
  "serv_port_down": 1700,                    // port de réception
 +
  "serv_port_up": 1700,                      // port d'envoi
 +
  "server_address": "localhost",              // adresse du serveur, localhost comme il est hébergé directement sur le Pi
 +
  "gateway_ID": "<ID de votre concentrateur>" // l'ID peut être obtenu en utilisant le shell update_gwid.sh fournit dans lora_pkt_fwd/,
 +
                                              // utiliser la commande ./update_gwid.sh local_conf.json et le gateway_ID devrait
 +
                                              // être automatiquement mis à jour, et doit ressembler à <code>B827EBFFFE87BD11</code>
 +
}
 +
<span style="color: red;">Attention, si vous souhaitez un '''réseau privé''', il faut modifier la variable ''lorawan_public'' en ''false'' à la 3ième ligne du fichier ''global_conf.json''.</span>
 +
 +
Vous pouvez maintenant compiler le programme avec <code>make</code> dans le dossier packet_forwarder/ et lancer l'exécutable avec <code>./lora_pkt_fwd/lora_pkt_fwd</code>. Si tout fonctionne correctement, le programme affiche la configuration puis la réception et l'envoi de données.
 +
 +
===Installation LoRaServer===
 +
L'installation du LoRaServer est simple, en effet, il existe un guide bien détaillé à ce sujet : https://www.loraserver.io/guides/debian-ubuntu/
 +
 +
N'hésitez pas à utiliser un autre mot de passe que celui par défaut (''dbpassword'') pour la base de données, et dans ce cas là, pensez à modifier loraserver.toml et lora-app-server.toml.
 +
 +
Une fois l'installation terminée, vous devriez être capable d'accéder à l'interface web de LoRa App Server à partir de n'importe quel ordinateur sur le même réseau à l'adresse '''<IP du Pi>:8080'''. Les identifiants par défaut sont '''admin:admin''', il est maintenant possible d'ajouter votre première passerelle ainsi qu'un noeud.
 +
 +
#Sélectionner le menu : Network-servers
 +
#:Appuyer sur : ADD
 +
#:Onglet : GENERAL
 +
#:Network-server name : <nom quelconque>
 +
#:Network-server server : localhost:8000
 +
#:Onglet : GATEWAY DISCOVERY
 +
#:Décocher : Enable gateway discovery (à activer si vous utilisez plusieurs gateways)
 +
#:Sélectionner : ADD NETWORK-SERVER
 +
#Sélectionner le menu : Service-profiles
 +
#:Appuyer sur : CREATE
 +
#:Service-profile name : <nom quelconque>
 +
#:Network-server : sélectionner le Network-server créé précédemment
 +
#:Cocher : Add gateway meta-data
 +
#:Décocher : Enable network geolocation
 +
#:Device-status request frequency : 0
 +
#:Minimum allowed data-rate : 0
 +
#:Maximum allowed data-rate : 5
 +
#:Sélectionner : CREATE SERVICE-PROFILE
 +
#Sélectionner le menu : Device-Profiles
 +
#:Appuyer sur : CREATE
 +
#:Device-profile name : <nom quelconque>
 +
#:Network-server : sélectionner le Network-server créé précédemment
 +
#:LoRaWAN MAC version : 1.0.1 (est obtenue avec la commande AT: AT+VER lorsque vous êtes connecté en série au module I-NUCLEO-LRWAN1)
 +
#:LoRaWAN Regional Parameters revision : A
 +
#:MAX EIRP : 0
 +
#:Sélectionner : CREATE DEVICE-PROFILE
 +
#Sélectionner le Device-profile que vous venez de créer
 +
#:Onglet : JOIN(OTAA/ABP)
 +
#:Cocher : Device supports OTAA
 +
#:Sélectionner : UPDATE DEVICE-PROFILE
 +
#Sélectionner le menu : Gateways
 +
#:Appuyer sur : CREATE
 +
#:Gateway name : <nom quelconque>
 +
#:Gateway description : <description quelconque>
 +
#:Gateway ID : <ID du concentrateur> (se trouve dans /LoRa/packet_forwarder/lora_pkt_fwd/local_conf.json)
 +
#:Network-server : sélectionner le network-server créé précédemment
 +
#:Gateway altitude : altitude où est située la gateway
 +
#:Gateway location : placé le marqueur où sera localisé la gateway
 +
#:Appuyer sur : CREATE GATEWAY
 +
#Sélectionner le menu : Applications
 +
#:Appuyer sur : CREATE
 +
#:Application name : <nom quelconque>
 +
#:Application description : <description quelconque>
 +
#:Service-profile : sélectionner le service-profile créé précédemment
 +
#:Appuyer sur : CREATE APPLICATION
 +
#Sélectionner l'application qui vient d'être créée
 +
#:Onglet : Devices
 +
#:Appuyer sur : Create
 +
#:Device name : <nom du noeud>
 +
#:Device description : <description quelconque>
 +
#:Device EUI : est obtenu avec la commande AT: AT+EUI lorsque vous êtes connecté en série au module I-NUCLEO-LRWAN1, par exemple e24f43abce39cb7d
 +
#:Device-profile : sélectionner le device-profile créé précédemment
 +
#:Cocher : Disable frame-counter validation
 +
#:Appuyer sur : CREATE DEVICE
 +
#:Onglet : KEYS (OTAA)
 +
#:Application key : générer une clé
 +
#:Gen application key : générer une clé
 +
#:Appuyer sur : SET DEVICE-KEYS
 +
 +
Votre passerelle et un nœud sont maintenant configurés, on peut passer à la programmation du NUCLEO-F401RE.
  
−
=Configuration du Rasperry Pi=
+
==Création systemd==
 +
 
 +
Pour ne plus avoir besoin d'effectuer ces manipulations manuellement par terminal, le concentrateur doit être reset et le programme lora_pkt_fwd doit être lancé lors du démarrage du Pi. Pour cela, il est nécessaire de créer un service qui executera les 2 exécutables au démarrage. Commencez par créer un fichier <code>/etc/systemd/system/pkt_fwd.service</code> :
 +
 
 +
[Unit]
 +
Description=Service packet forwarder & reset concentrateur
 +
After=network.target
 +
StartLimitIntervalSec=0
 +
 
 +
[Service]
 +
Type=simple
 +
Restart=always
 +
RestartSec=1
 +
User=pi
 +
ExecStartPre=/home/pi/LoRa/lora_gateway/reset_lgw.sh start
 +
WorkingDirectory=/home/pi/LoRa/packet_forwarder/lora_pkt_fwd
 +
ExecStart=/home/pi/LoRa/packet_forwarder/lora_pkt_fwd/lora_pkt_fwd
 +
 
 +
[Install]
 +
WantedBy=multi-user.target
 +
 
 +
Démarrer le service avec <code>systemctl start pkt_fwd</code> et automatiser son lancement au démarrage avec <code>systemctl enable pkt_fwd</code>.
 +
 
 +
Si vous voulez observer les logs, utiliser <code>journalctl -f -n 100 -u pkt_fwd</code>.
 +
 
 +
Pour la compréhension des lignes de code, référez-vous aux pages ''man'' [https://www.freedesktop.org/software/systemd/man/systemd.service.html systemd.service] & [https://www.freedesktop.org/software/systemd/man/systemd.unit.html systemd.unit].
 +
 +
=Programmation du NUCLEO-F401RE=
 +
 
 +
Le NUCLEO-F401RE permet d'automatiser l'envoi de données, en effet, s'il est connecté en série avec avec le I-NUCLEO-LRWAN1, il peut lui envoyer des commandes AT. Les pins UART TX et RX sur le NUCLEO-F401RE sont PA_11 et PA_12 respectivement sur l'en-tête CN10 et D0 et D1 sur l'en-tête CN9 pour le I-NUCLEO-LRWAN1. Connectez ainsi PA_11 à D1 et PA_12 à D0.
 +
<gallery  mode="slideshow">
 +
File:Nucleo_f401re_2017_9_19_morpho_right.png|''Description en-tête CN10 NUCLEO-F401RE''
 +
File:uart_sm_42.png|''Description en-tête CN9 I-NUCLEO-LRWAN1''
 +
</gallery>
 +
Il faut également connecter le capteur DHT11, placer le sur une mini-breadboard et connecter VCC, GND et DATA aux pins U5V, GND et PC_7 respectivement du NUCLEO-F401RE.
 +
[[File:dht11_recent.png|500px|center|thumb|Pins DHT11]]
 +
Il est maintenant possible de programmer la board avec le compilateur [https://ide.mbed.com/ mbed]. Copiez le programme suivant [[Media:dht11_sm_42.zip]] sur mbed, compléter les variables globales selon ce qui vous convient (APPKEY est la clé d'application générée plus tôt sur le serveur applicatif, unique à chaque nœud), et compilez le, une fois le fichier .bin télécharger, transférer le vers le dossier NUCLEO qui apparaît lorsque le NUCLEO-F401RE est connecté par USB.
 +
 
 +
Le micro-contrôleur se redémarre et le module LoRa est prêt à rejoindre le réseau LoRaWAN et envoyer les données du capteur DHT11.
 +
 
 +
Maintenant il faut mettre en place l'application sur laquelle on lira les résultats.
 +
 
 +
=Implémentation Grafana=
 +
 
 +
'''Grafana''' est un logiciel libre sous licence Apache 2 qui permet la visualisation et la mise en forme de données métriques sous des tableaux de bord depuis plusieurs sources dont des bases de données de série temporelle (Time Series Database) comme Graphite, '''InfluxDB''' ... Et par chance, LoRaServer permet l'intégration d'une base de données InfluxDB, c'est à dire que lorsque le serveur applicatif reçoit les données des capteurs, il peut directement les stocker dans une base de donnée, et cette base de données peut ensuite être utilisée par Grafana.
 +
 
 +
Pour configurer l'intégration, il faut revenir sur le LoRa App Server, et suivre les étapes suivantes:
 +
 
 +
;Sélectionner le menu Applications
 +
:Sélectionner l'application existante
 +
:Onglet : INTEGRATIONS
 +
:Appuyer sur : CREATE
 +
:Integration kind : InfluxDB integration
 +
:API endpoint : http://localhost:8086/write
 +
:Username : admin (dépend des identifiants utilisés pour la base de données)
 +
:Password : admin
 +
:Database name : lora
 +
:Appuyer sur : UPDATE INTEGRATION
 +
 
 +
L'intégration est maintenant configurée pour rediriger les données vers la base de données nommée ''lora'' qui sera créée plus tard. Il faut également programmer le codec Javascript pour décoder les trames reçues des noeuds. Pour cela:
 +
;Sélectionner le menu Device-profiles
 +
:Sélectionner le device-profile existant
 +
:Onglet : CODEC
 +
:Sélectionner : Custom JavaScript codec functions
 +
:Compléter la fonction Decode avec le code ci-dessous :
 +
function Decode(fPort, bytes) {
 +
  var decoded = {};
 +
  if(bytes[1] == 1) { //le premier octet est l'octet d'identification du type de capteur, et 1 correspond au DHT11
 +
    decoded.t = bytes[2]; //la température est envoyée sur le 2nd octet (voir mbed)
 +
    decoded.h = bytes[3]; //humidité 3ème octet
 +
    return decoded; //envoi les valeurs t et h vers influxdb et il ne reste plus qu'à les lire sur grafana
 +
  }
 +
}
 +
 
 +
Dorénavant, si vous souhaitez utiliser d'autres types de capteur, selon la manière que vous encodez les trames que les noeuds envoient, il est nécessaire d'ajouter au codec une condition pour le décodage de la dite trame.
 +
 
 +
Passons maintenant à [https://grafana.com/grafana/download?platform=arm l'installation de Grafana] sur le Raspberry Pi. Reconnectez-vous au Pi par SSH si vous ne l'êtes pas déjà, et tapez
 +
 
 +
<code>wget https://dl.grafana.com/oss/release/grafana_6.2.4_armhf.deb
 +
 
 +
sudo dpkg -i grafana_6.2.4_armhf.deb</code>
 +
 
 +
pour installer Grafana. La version 6.2.4 était la version la plus récente lors de la rédaction de ce wiki, n'hésitez pas à utilisez l'hyperlien précédent pour obtenir la version la plus récente.
 +
 
 +
Il faut également installer InfluxDB, pour cela, utiliser les commandes suivantes :
 +
 
 +
<code>wget -qO- https://repos.influxdata.com/influxdb.key | sudo apt-key add -
 +
 
 +
test $VERSION_ID = "7" && echo "deb https://repos.influxdata.com/debian wheezy stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
 +
 
 +
test $VERSION_ID = "8" && echo "deb https://repos.influxdata.com/debian jessie stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
 +
 
 +
test $VERSION_ID = "9" && echo "deb https://repos.influxdata.com/debian stretch stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
 +
 
 +
sudo apt-get update && sudo apt-get install influxdb
 +
 
 +
sudo systemctl unmask influxdb.service
 +
 
 +
sudo systemctl start influxdb
 +
 
 +
sudo systemctl enable influxdb</code>
 +
 
 +
Pour accéder à l'interface InfluxDB, utiliser <code>influx -precision rfc3339</code> et créer la base de donnée ''lora'' avec <code>CREATE DATABASE lora</code>. Pour plus d'informations sur l'utilisation de InfluxDB, rendez vous à ce [https://docs.influxdata.com/influxdb/v1.7/introduction/getting-started/ lien].
  
−
==Installation de l'OS et configuration==
+
Identifiez vous à l'adresse '''<IP du Pi>:3000''' pour accéder à l'interface Grafana, sur la première page, appuyer sur ''Create your first data source'' et choisissez ''InfluxDB''. Ajoutez ''http://localhost:8086'' dans '''URL''', et ''lora'' dans '''Database'''. Revenez maintenant à l'interface Grafana pour créer le tableau de bord qui permettra d'observer les données de température et d'humidité du capteur DHT11.
  
−
Tout d'abord, télécharger [https://www.raspberrypi.org/downloads/raspbian/ Raspbian Stretch Lite], Lite car l'interface graphique n'est pas utile. Ensuite il s'agit simplement de suivre le [https://www.raspberrypi.org/documentation/installation/installing-images/README.md guide d'installation] de l'image sur la carte SD qui sera ensuite insérée dans le Pi.
+
<gallery mode="packed-hover" heights="400px"  caption="Ajout d'un panneau Grafana">
 +
ajout_dashboard_grafana.gif
 +
</gallery>
  
−
Avant d'insérér la carte, il faut penser à ajouter la ligne <code>enable_uart=1</code> à la fin du fichier ''config.txt'' situé dans la partition '''BOOT''' de la carte
+
La prise en main de Grafana est simple, n'hésitez pas à explorer les différentes options disponibles. Ci-dessous un aperçu d'un tableau de bord pour des capteurs DHT11 et PIR :
 +
[[Fichier:graf_tab_bord.png|800px|center|middle|thumb|Tableau de bord Grafana]]

Version actuelle datée du 27 juin 2019 à 09:44


Présentation générale

  • Nom du projet : Déploiement d'un réseau LoRaWAN
  • Stagiaire : Ibrahim BEN DHIAB

Sujet de stage

Dans le cadre des travaux de recherches menés sur les objets connectés, l'étudiant devra déployer au sein de l'IRCICA un réseau expérimental LoRaWan. Pour cela, il devra installer et configurer une passerelle LoRaWAN pour la réception des données. Puis, il déploiera une dizaine de noeuds. Chaque noeud est composé d'un microcontrôleur STM32F4, d'une radio LoRa I-NUCLEO-LRWAN1 et de capteurs (température, ouverture de porte, ...). L'étudiant devra réaliser la programmation de chaque noeud et mettre en place une solution pour faciliter le redéploiement du code. Les noeuds seront ensuite installés dans différents bureaux.

LoRaWAN

LoRaWAN est un protocole de télécommunication permettant la communication à bas débit, par radio, d'objets à faible consommation électrique communiquant selon la technologie LoRa et connectés à l'Internet via des passerelles, participant ainsi à l'Internet des objets. Ce protocole est utilisé dans le cadre des villes intelligentes, le monitoring industriel ou encore l'agriculture. La technologie de modulation liée à LoRaWAN est LoRa, née à la suite de l'acquisition de la startup grenobloise Cycléo par Semtech en 2012. Semtech promeut sa plateforme LoRa grâce à la LoRa Alliance, dont elle fait partie. Le protocole LoRaWAN sur la couche physique LoRa permet de connecter des capteurs ou des objets nécessitant une longue autonomie de batterie (comptée en années), dans un volume (taille d'une boite d'allumettes ou d'un paquet de cigarettes) et un coût réduits.

LoRaWAN est l'acronyme de Long Range Wide-area network que l'on peut traduire par « réseau étendu à longue portée ».

Matériel fourni

  • 1 Raspberry Pi 3 Model B + carte SD minimum 8go : utilisé pour héberger le serveur LoRaWAN et la passerelle
  • 3 ST-NUCLEO-F401RE : composé d'un microcontrôleur STM32F4 et d'une connectivité type Arduino Uno Revision 3
  • Capteurs... (DHT11 pour la température et l'humidité, PIR pour détection de mouvement infrarouge)
  • Lecteur de carte SD
  • Câble USB vers série

Configuration du Rasperry Pi

Installation de l'OS et configuration initiale

Tout d'abord, télécharger Raspbian Stretch Lite, Lite car l'interface graphique n'est pas utile pour notre utilisation. Ensuite, il s'agit simplement de suivre le guide d'installation de l'image sur la carte SD qui sera ensuite insérée dans le Pi.

Avant d'insérér la carte, pensé à ajouter la ligne enable_uart=1 à la fin du fichier config.txt situé dans la partition BOOT de la carte pour activer la liaison série du Raspberry. Une fois insérer, connecter le câble USB vers série sur le PC et les fils TX et RX sur les pins RX et TX du Pi respectivement. Les pins 8 et 10 de la liaison série du Pi sont visibles ci-dessous :

GPIO Raspberry Pi 3 Model B

Le Pi peut maintenant être alimenté, et on peut y accéder via un terminal à l'aide de la commande minicom -8 -b 9600 -o -D /dev/ttyUSB0. Les logins par défaut sont pi : raspberry .

Maintenant, il est nécessaire de connecter l'appareil à Internet, relier le ainsi par Ethernet, et il devrait se configurer automatiquement par DHCP. Par la suite, on souhaite se connecter par SSH au Pi, il est ainsi nécessaire de mettre en place une IP statique, pour cela, il faut au préalable récupérer des informations.

Lancer ip -4 addr show | grep global qui retournera ce genre de résultat inet 192.168.42.12/24 brd 192.168.42.255 scope global eth0. On connaît maintenant l'adresse IP du Pi, mais l'IP statique qu'on lui attribuera sera 192.168.42.250 pour s'assurer qu'aucun autre appareil utilise la même IP.

Ensuite, trouver l'adresse du routeur (ou de la gateway) avec ip route | grep default | awk '{print $3}', dans notre cas on obtient 192.168.42.1.

Enfin, récupérer l'adresse du serveur DNS à l'aide de cat /etc/resolv.conf et garder en tête l'adresse après nameserver.

La méthode dhcpcd sera utilisée pour définir l'IP statique:

Edité /etc/dhcpcd.conf comme suit à l'aide de l'éditeur de votre choix (dans mon cas nano): 

# Example static IP configuration:
interface eth0
static ip_address=192.168.42.250/24
#static ip6_address=fd51:42f8:caae:d92e::ff/64
static routers=192.168.42.1
static domain_name_servers=192.168.42.12

Changer le mot de passe du Pi à l'aide de passwd puis rédemarrer le avec sudo halt.

Il est maintenant possible de se connecter en SSH au Pi avec ssh pi@192.168.42.250, il n'est plus nécessaire d'utiliser le câble série.

Configuration du iC880A-SPI

Tout d'abord, on configure les locales pour éviter d'éventuel problèmes, pour cela, taper sudo raspi-config, et naviguer vers Localisation Options/Change Locale. Une fois dans le menu Locale, sélectionner les locales en_GB.UTF-8 et fr_FR.UTF-8 avec la touche espace, puis entrée, et sélectionner fr_FR.UTF-8.

Mettez à jour les pacquettages du Pi avec sudo apt-get update && sudo apt-get upgrade -y.

Il existe un driver open source sur le github de Semtech pour les appareils LoRa basé sur un SX1301, et le concentrateur est justement équipé d'un SX1301. Installez git sur le Pi avec sudo apt-get install git, créé un dossier mkdir -p ~/LoRa/, navigué dedans cd ~/LoRa/ et cloné le git https://github.com/Lora-net/lora_gateway. Pour des raisons de débuguage, il faut modifier au préalable la ligne DEBUG_HAL= 1 dans /lora_gateway/libloragw/library.cfg.

Compilez la librairie et les quelques programmes de test situés dans les sous-dossiers de lora_gateway avec make. Si la compilation est réussie, la librairie libloragw.a a dû être créée et est prête à l'usage par le packet tracer qui sera installé par la suite.

Ce driver nécessite une interface SPI pour fonctionner, et elle doit être activée sur le Pi. Pour cela, retourner dans le menu raspi-config, puis dans Interfacing Options, activer SPI. Maintenant que SPI est activé, il faut préparer le Reset Pin Control, pour contrôler le pin du GPIO qui sera connecté au pin Reset du iC880A. C'est très simple, il existe dans le dossier lora_gateway un fichier shell nommé reset_lgw.sh et il est lancé de cette manière ./reset_lgw.sh {start|stop} [<gpio number>], dans notre cas, 17 est le pin du GPIO. Plus tard, on configurera le lancement de cette commande au démarrage du Pi. Reliez le concentrateur au Pi comme indiquez ci-dessous:

Aperçu des composants du concentrateur




Correspondance des PINS IC880A <> RaspBerry Pi 3
21 (VDD) 2 (+5V)
22 (GND) 6 (GND)
14 (SPI_CLOCK) 23 (SPI0_CLOCK)
15 (SPI_MISO) 21 (SPI0_MISO)
16 (SPI_MOSI) 19 (SPI0_MOSI)
17 (SPI_NSS) 24 (SPI0_CE0)
13 (Reset) 11 (GPIO_17)


Pour s'assurer que tout fonctionne bien, lancez l'utilitaire util_tx_test avec ./util_tx_test -r 1257 -f 866.5 et vous devriez observer un résultat de ce genre: 

Sending -1 LoRa packets on 866500000 Hz (BW 125 kHz, SF 10, CR 1, 16 bytes payload, 8 symbols preamble) at 14 dBm, with 1000 ms between each
lgw_board_setconf:427: Note: board configuration; lorawan_public:1, clksrc:1
lgw_rxrf_setconf:488: Note: rf_chain 0 configuration; en:1 freq:866500000 rssi_offset:0.000000 radio_type:2 tx_enable:1 tx_notch_freq:129000
lgw_rxrf_setconf:488: Note: rf_chain 1 configuration; en:1 freq:866500000 rssi_offset:0.000000 radio_type:2 tx_enable:0 tx_notch_freq:129000
lgw_start:823: Note: calibration started (time: 2300 ms)
lgw_start:844: Note: calibration finished (status = 159)
WARNING: problem in calibration of radio A for TX DC offset
Info: Initialising AGC firmware...
Info: putting back original RADIO_SELECT value
INFO: concentrator started, packet can be sent
Sending packet number 1 ...INFO: tx_start_delay=1495 (1495.500000) - (1497, bw_delay=1.500000, notch_delay=0.000000)
INFO: Enabling TX notch filter
58.a0.0.0.6a.5.1.2.0.9a.10.0.0.8.0.0.54.45.53.54.0.1.61.62.63.64.65.66.67.68.69.6a.end
OK
Sending packet number 2 ...INFO: tx_start_delay=1495 (1495.500000) - (1497, bw_delay=1.500000, notch_delay=0.000000)
INFO: Enabling TX notch filter
58.a0.0.3.3d.5.1.2.0.9a.10.0.0.8.0.0.54.45.53.54.0.2.61.62.63.64.65.66.67.68.69.6a.end
OK

Pour arrêter l'utilitaire, appuyer sur Ctrl+C. Si le test est bien réussi, on peut passer à la mise en place du serveur LoRa.

Configuration du LoRaServer

Packet Forwarder de Semtech

Au préalable, il faut installer le packet forwarder de Semtech, il tournera sur le Pi et permettra de transmettre les paquets RF reçus par le concentrateur vers le serveur LoRa à l'aide d'une liaison IP/UDP.

Comme pour lora_gateway, dans le même dossier, on clone le projet avec git clone https://github.com/Lora-net/packet_forwarder. Il faut maintenant le configurer.

Dans lora_pkt_fwd/cfg/, choisir le global_conf.json adapté à votre utilisation (référez-vous au git du packet_forwarder en cas de doute), global_conf.json.PCB_E286.EU868.basic dans notre cas, renommez-le en global_conf.json avec mv global_conf.json.PCB_E286.EU868.basic global_conf.json, et remplacer le global_conf.json dans lora_pkt_fwd/ par celui que vous venez de renommer avec mv global_conf.json .. si vous êtes situé dans le dossier cfg/.

Lorsque le programme est lancé, il effectue une analyse grammaticale des fichiers json :

  • s'il détecte un debug_conf.json, il ignore tout autre fichier de configuration
  • si c'est un global_conf.json, il l'analyse et passe au fichier suivant
  • si il y a un local_conf.json qui redéfinit des paramètres présents dans le global_conf.json, alors la configuration locale écrase celle globale.

Ainsi, dans le fichier local, ajouter les lignes comme suit : 

"gateway_conf": {
 "serv_port_down": 1700,                     // port de réception
 "serv_port_up": 1700,                       // port d'envoi
 "server_address": "localhost",              // adresse du serveur, localhost comme il est hébergé directement sur le Pi
 "gateway_ID": "<ID de votre concentrateur>" // l'ID peut être obtenu en utilisant le shell update_gwid.sh fournit dans lora_pkt_fwd/, 
                                             // utiliser la commande ./update_gwid.sh local_conf.json et le gateway_ID devrait 
                                             // être automatiquement mis à jour, et doit ressembler à B827EBFFFE87BD11
}

Attention, si vous souhaitez un réseau privé, il faut modifier la variable lorawan_public en false à la 3ième ligne du fichier global_conf.json.

Vous pouvez maintenant compiler le programme avec make dans le dossier packet_forwarder/ et lancer l'exécutable avec ./lora_pkt_fwd/lora_pkt_fwd. Si tout fonctionne correctement, le programme affiche la configuration puis la réception et l'envoi de données.

Installation LoRaServer

L'installation du LoRaServer est simple, en effet, il existe un guide bien détaillé à ce sujet : https://www.loraserver.io/guides/debian-ubuntu/

N'hésitez pas à utiliser un autre mot de passe que celui par défaut (dbpassword) pour la base de données, et dans ce cas là, pensez à modifier loraserver.toml et lora-app-server.toml.

Une fois l'installation terminée, vous devriez être capable d'accéder à l'interface web de LoRa App Server à partir de n'importe quel ordinateur sur le même réseau à l'adresse <IP du Pi>:8080. Les identifiants par défaut sont admin:admin, il est maintenant possible d'ajouter votre première passerelle ainsi qu'un noeud.

  1. Sélectionner le menu : Network-servers
    Appuyer sur : ADD
    Onglet : GENERAL
    Network-server name : <nom quelconque>
    Network-server server : localhost:8000
    Onglet : GATEWAY DISCOVERY
    Décocher : Enable gateway discovery (à activer si vous utilisez plusieurs gateways)
    Sélectionner : ADD NETWORK-SERVER
  2. Sélectionner le menu : Service-profiles
    Appuyer sur : CREATE
    Service-profile name : <nom quelconque>
    Network-server : sélectionner le Network-server créé précédemment
    Cocher : Add gateway meta-data
    Décocher : Enable network geolocation
    Device-status request frequency : 0
    Minimum allowed data-rate : 0
    Maximum allowed data-rate : 5
    Sélectionner : CREATE SERVICE-PROFILE
  3. Sélectionner le menu : Device-Profiles
    Appuyer sur : CREATE
    Device-profile name : <nom quelconque>
    Network-server : sélectionner le Network-server créé précédemment
    LoRaWAN MAC version : 1.0.1 (est obtenue avec la commande AT: AT+VER lorsque vous êtes connecté en série au module I-NUCLEO-LRWAN1)
    LoRaWAN Regional Parameters revision : A
    MAX EIRP : 0
    Sélectionner : CREATE DEVICE-PROFILE
  4. Sélectionner le Device-profile que vous venez de créer
    Onglet : JOIN(OTAA/ABP)
    Cocher : Device supports OTAA
    Sélectionner : UPDATE DEVICE-PROFILE
  5. Sélectionner le menu : Gateways
    Appuyer sur : CREATE
    Gateway name : <nom quelconque>
    Gateway description : <description quelconque>
    Gateway ID : <ID du concentrateur> (se trouve dans /LoRa/packet_forwarder/lora_pkt_fwd/local_conf.json)
    Network-server : sélectionner le network-server créé précédemment
    Gateway altitude : altitude où est située la gateway
    Gateway location : placé le marqueur où sera localisé la gateway
    Appuyer sur : CREATE GATEWAY
  6. Sélectionner le menu : Applications
    Appuyer sur : CREATE
    Application name : <nom quelconque>
    Application description : <description quelconque>
    Service-profile : sélectionner le service-profile créé précédemment
    Appuyer sur : CREATE APPLICATION
  7. Sélectionner l'application qui vient d'être créée
    Onglet : Devices
    Appuyer sur : Create
    Device name : <nom du noeud>
    Device description : <description quelconque>
    Device EUI : est obtenu avec la commande AT: AT+EUI lorsque vous êtes connecté en série au module I-NUCLEO-LRWAN1, par exemple e24f43abce39cb7d
    Device-profile : sélectionner le device-profile créé précédemment
    Cocher : Disable frame-counter validation
    Appuyer sur : CREATE DEVICE
    Onglet : KEYS (OTAA)
    Application key : générer une clé
    Gen application key : générer une clé
    Appuyer sur : SET DEVICE-KEYS

Votre passerelle et un nœud sont maintenant configurés, on peut passer à la programmation du NUCLEO-F401RE.

Création systemd

Pour ne plus avoir besoin d'effectuer ces manipulations manuellement par terminal, le concentrateur doit être reset et le programme lora_pkt_fwd doit être lancé lors du démarrage du Pi. Pour cela, il est nécessaire de créer un service qui executera les 2 exécutables au démarrage. Commencez par créer un fichier /etc/systemd/system/pkt_fwd.service : 

[Unit]
Description=Service packet forwarder & reset concentrateur
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
Restart=always
RestartSec=1
User=pi
ExecStartPre=/home/pi/LoRa/lora_gateway/reset_lgw.sh start
WorkingDirectory=/home/pi/LoRa/packet_forwarder/lora_pkt_fwd
ExecStart=/home/pi/LoRa/packet_forwarder/lora_pkt_fwd/lora_pkt_fwd

[Install]
WantedBy=multi-user.target

Démarrer le service avec systemctl start pkt_fwd et automatiser son lancement au démarrage avec systemctl enable pkt_fwd.

Si vous voulez observer les logs, utiliser journalctl -f -n 100 -u pkt_fwd.

Pour la compréhension des lignes de code, référez-vous aux pages man systemd.service & systemd.unit.

Programmation du NUCLEO-F401RE

Le NUCLEO-F401RE permet d'automatiser l'envoi de données, en effet, s'il est connecté en série avec avec le I-NUCLEO-LRWAN1, il peut lui envoyer des commandes AT. Les pins UART TX et RX sur le NUCLEO-F401RE sont PA_11 et PA_12 respectivement sur l'en-tête CN10 et D0 et D1 sur l'en-tête CN9 pour le I-NUCLEO-LRWAN1. Connectez ainsi PA_11 à D1 et PA_12 à D0.

  • Description en-tête CN10 NUCLEO-F401RE

  • Description en-tête CN9 I-NUCLEO-LRWAN1

Il faut également connecter le capteur DHT11, placer le sur une mini-breadboard et connecter VCC, GND et DATA aux pins U5V, GND et PC_7 respectivement du NUCLEO-F401RE.

Pins DHT11

Il est maintenant possible de programmer la board avec le compilateur mbed. Copiez le programme suivant Media:dht11_sm_42.zip sur mbed, compléter les variables globales selon ce qui vous convient (APPKEY est la clé d'application générée plus tôt sur le serveur applicatif, unique à chaque nœud), et compilez le, une fois le fichier .bin télécharger, transférer le vers le dossier NUCLEO qui apparaît lorsque le NUCLEO-F401RE est connecté par USB.

Le micro-contrôleur se redémarre et le module LoRa est prêt à rejoindre le réseau LoRaWAN et envoyer les données du capteur DHT11.

Maintenant il faut mettre en place l'application sur laquelle on lira les résultats.

Implémentation Grafana

Grafana est un logiciel libre sous licence Apache 2 qui permet la visualisation et la mise en forme de données métriques sous des tableaux de bord depuis plusieurs sources dont des bases de données de série temporelle (Time Series Database) comme Graphite, InfluxDB ... Et par chance, LoRaServer permet l'intégration d'une base de données InfluxDB, c'est à dire que lorsque le serveur applicatif reçoit les données des capteurs, il peut directement les stocker dans une base de donnée, et cette base de données peut ensuite être utilisée par Grafana.

Pour configurer l'intégration, il faut revenir sur le LoRa App Server, et suivre les étapes suivantes:

Sélectionner le menu Applications
Sélectionner l'application existante
Onglet : INTEGRATIONS
Appuyer sur : CREATE
Integration kind : InfluxDB integration
API endpoint : http://localhost:8086/write
Username : admin (dépend des identifiants utilisés pour la base de données)
Password : admin
Database name : lora
Appuyer sur : UPDATE INTEGRATION

L'intégration est maintenant configurée pour rediriger les données vers la base de données nommée lora qui sera créée plus tard. Il faut également programmer le codec Javascript pour décoder les trames reçues des noeuds. Pour cela:

Sélectionner le menu Device-profiles
Sélectionner le device-profile existant
Onglet : CODEC
Sélectionner : Custom JavaScript codec functions
Compléter la fonction Decode avec le code ci-dessous :
function Decode(fPort, bytes) { 
 var decoded = {};
 if(bytes[1] == 1) {				//le premier octet est l'octet d'identification du type de capteur, et 1 correspond au DHT11
    decoded.t = bytes[2];			//la température est envoyée sur le 2nd octet (voir mbed)
    decoded.h = bytes[3];			//humidité 3ème octet
    return decoded;				//envoi les valeurs t et h vers influxdb et il ne reste plus qu'à les lire sur grafana
  }
}

Dorénavant, si vous souhaitez utiliser d'autres types de capteur, selon la manière que vous encodez les trames que les noeuds envoient, il est nécessaire d'ajouter au codec une condition pour le décodage de la dite trame.

Passons maintenant à l'installation de Grafana sur le Raspberry Pi. Reconnectez-vous au Pi par SSH si vous ne l'êtes pas déjà, et tapez

wget https://dl.grafana.com/oss/release/grafana_6.2.4_armhf.deb

sudo dpkg -i grafana_6.2.4_armhf.deb

pour installer Grafana. La version 6.2.4 était la version la plus récente lors de la rédaction de ce wiki, n'hésitez pas à utilisez l'hyperlien précédent pour obtenir la version la plus récente.

Il faut également installer InfluxDB, pour cela, utiliser les commandes suivantes :

wget -qO- https://repos.influxdata.com/influxdb.key | sudo apt-key add -

test $VERSION_ID = "7" && echo "deb https://repos.influxdata.com/debian wheezy stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

test $VERSION_ID = "8" && echo "deb https://repos.influxdata.com/debian jessie stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

test $VERSION_ID = "9" && echo "deb https://repos.influxdata.com/debian stretch stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

sudo apt-get update && sudo apt-get install influxdb

sudo systemctl unmask influxdb.service

sudo systemctl start influxdb

sudo systemctl enable influxdb

Pour accéder à l'interface InfluxDB, utiliser influx -precision rfc3339 et créer la base de donnée lora avec CREATE DATABASE lora. Pour plus d'informations sur l'utilisation de InfluxDB, rendez vous à ce lien.

Identifiez vous à l'adresse <IP du Pi>:3000 pour accéder à l'interface Grafana, sur la première page, appuyer sur Create your first data source et choisissez InfluxDB. Ajoutez http://localhost:8086 dans URL, et lora dans Database. Revenez maintenant à l'interface Grafana pour créer le tableau de bord qui permettra d'observer les données de température et d'humidité du capteur DHT11.

  • Ajout d'un panneau Grafana
  • Ajout dashboard grafana.gif

La prise en main de Grafana est simple, n'hésitez pas à explorer les différentes options disponibles. Ci-dessous un aperçu d'un tableau de bord pour des capteurs DHT11 et PIR :

Tableau de bord Grafana
Récupérée de « https://wiki-ima.plil.fr/mediawiki//index.php?title=Déploiement_d%27un_réseau_LoRaWAN&oldid=50338 »