Table des Matières
Publicité
Liens rapides
Publicité
Table des Matières
Manuels Connexes pour ATIM AGT/NS
Sommaire des Matières pour ATIM AGT/NS
- Page 1 1Gate Passerelles LoRaWAN Versions Compacte, Industrielle et Outdoor Guide d’utilisation Modèles concernés : AGT/NS AGT/NSGPS AGTKIT/NS AGTKIT/NSGPS AGT/INDUS AGT/INDUSGPS AGT/OUTDOOR ATIM Radiocommunications www.atim.com Chemin des Guillets info@atim.com 38250 Villard de Lans France...
-
Page 2: Table Des Matières
ABLE DES ATIERES Historique ..............................4 Caractéristiques techniques ........................6 Carte Calculateur ............................... 7 Carte Radio ................................. 7 Logiciel ................................8 Mécanique ................................. 8 Environnement ..............................9 Mise en service de la gateway ....................... 10 Vérifier le contenu du kit ..........................10 Prérequis avant installation .......................... - Page 3 Mise à jour logiciel ..........................40 Support Technique ..........................41 ATIM_1GATE_UG_FR_V2.0...
-
Page 4: Historique
Historique Date Note(s) Auteur Version 27/07/2017 Création du document Draft 18/10/2017 Description détaillée concentrateur LoRa V1.0 Apple Bonjour Service Configuration WiFi (Client / Point Accès) 28/03/2019 Remise en forme / MAJ #1 V1.1 24/02/2020 Actualisation des informations : V1.2 Suppression webmin Suppression packet forwarder TTN / loriot Mise à... - Page 5 à votre service informatique qui devrait pouvoir facilement appréhender la gateway à l’aide des documents fournis par ATIM et de la documentation officielle du network serveur à cette adresse : https://github.com/gotthardp/lorawan-server avant tout contact.
-
Page 6: Caractéristiques Techniques
Caractéristiques techniques ATIM commercialise trois types de gateways LoRaWAN : Compacte Industrielle Outdoor ATIM_1GATE_UG_FR_V2.0... -
Page 7: Carte Calculateur
a. Carte Calculateur Gateway LoRaWAN Compacte Industrielle Outdoor Processeur ARMv7 Broadcom BCM3837 (4 cœurs Cortex A53) @ 1.2GHz Lecteur de cartes Micro-SD (16Go en standard), 1Go de LPDDR2 HDMI USB 2.0 Ethernet 10/100 Bluetooth BLE 4.1, antenne intégrée WLAN WiFi 802.11 b/g/n, antenne intégrée, sans diversité +5V / 2.5A via 9-36Vdc / 2.5A via Alimentation... -
Page 8: Logiciel
c. Logiciel Gateway LoRaWAN Compacte Industrielle Outdoor Raspbian Linux 9 DHCP Client, OpenSSH Partie Système OpenVPN, iptables, fail2ban, monit, logwatch Node.js, Node.RED Mosquitto, Mosquitto Clients Driver/HAL Semtech (https://github.com/Lora-net/lora_gateway) Packet Forwarder Semtech (https://github.com/Lora-net/packet_forwarder) Partie LoRaWAN Serveur Réseau de Petr Gotthard v0.5.5 (https://github.com/gotthardp/lorawan-server) d. -
Page 9: Environnement
e. Environnement Gateway LoRaWAN Compacte Industrielle Outdoor Température d’utilisation [°C] -20 / +55 -20 / +70 -20/ +55 Température de stockage [°C] -30 / +85 Humidité 5 à 95% sans condensation Indice de protection IP30 IP66 Indice d’inflammabilité UL94 V-0 ATIM_1GATE_UG_FR_V2.0... -
Page 10: Mise En Service De La Gateway
Mise en service de la gateway Vérifier le contenu du kit ✓ Une gateway LoRaWAN version compacte ✓ Une carte Micro-SD préinstallée ✓ Une alimentation (voir tableau avec les différents types d’alimentation en fonction du modèle) Prérequis avant installation ✓ La gateway doit pouvoir accéder au réseau internet via un modem / routeur ADSL, 4G ou autre ✓... -
Page 11: Connexion À La Gateway
Connexion à la gateway a. Se connecter en mode local (version compacte) Ce mode de connexion requiert le matériel suivant à bracher directement sur la gateway : ✓ 1x écran via HDMI ✓ 1x clavier + souris via USB En mode local, vous êtes directement relié à la gateway LoRaWAN. Dès que le calculateur a démarré vous pouvez ouvrir une session de travail avec les identifiants suivants : login: ogate password: ogate... -
Page 12: Se Connecter En Mode Réseau (Toutes Versions)
b. Se connecter en mode réseau (toutes versions) Ce mode de connexion requiert le matériel suivant afin d’ouvrir une session de travail sur la gateway : ✓ Poste de travail distant (Linux, Windows) ✓ Avoir installer le service Apple Bonjour sur le poste de travail Il existe deux moyens pour se connecter en mode réseau : En établissant une connexion SSH avec l’adresse MAC de la gateway... - Page 13 Etablir une connexion SSH avec l’adresse IP de la gateway Cette connexion est à réaliser si la précédente avec l’adresse MAC n’est pas réalisable (DNS local de votre modem / routeur ne fonctionne pas). Il y a plusieurs façons de trouver l'adresse IP de la gateway : –...
-
Page 14: Activer Le Wifi
Activer le WiFi 1GATE utilise connman pour gérer les connections réseaux. sudo connmanctl Autoriser WiFi connmanctl > enable wifi Configurer le WiFi en mode client connmanctl > scan wifi connmanctl > services connmanctl > agent on connmanctl > connect <nom du service> Exemple: connect wifi_0013ef20018a_4d6f7468_managed_psk connmanctl >... -
Page 15: Activer Le Bluetooth
Activer le Bluetooth 1GATE utilise connman pour gérer les connections réseaux. Pour ajouter ou modifier les interfaces réseaux : sudo connmanctl connmanctl > enable bluetooth connmanctl > exit Il faut maintenant lancer la commande : bluetoothctl [bluetooth]# scan on [bluetooth]# agent on [bluetooth]# pair suivi de l'id du périphérique [bluetooth]# trust suivi de l'id du périphérique [bluetooth]# exit... -
Page 16: Administration De La Gateway Lorawan
Administration de la gateway LoRaWAN Le "Driver" et la "HAL" de la carte radio (SX1301, SX1255/SX1257) sont installés dans le répertoire /opt/semtech/lora_gateway. Il y a dans ce répertoire la librairie "libloragw", des outils de test et des utilitaires. Par défaut la gateway démarre le "packet forwarder" de Semtech. Le "packet forwarder"... -
Page 17: Serveur Lorawan Pour Réseaux Privés
Serveur LoRaWAN pour réseaux privés Serveur LoRaWAN open source qui intègre à la fois le serveur réseau et le serveur d'application. Ceci est utile pour les fournisseurs d'applications qui exploitent leur propre réseau LoRaWAN, ou pour les développeurs d'appareils et d'applications. Le serveur : –... -
Page 18: Administration Du Serveur Lorawan
Administration du serveur LoRAWAN Avant tout contact avec le Support Technique, veuillez-vous référer à la documentation du serveur LoRaWAN disponible intégralité à l’adresse suivante : https://github.com/gotthardp/lorawan-server Vous pouvez administrer et gérer le serveur via un ensemble de pages Web ou via une API REST. Par défaut, le serveur écoute sur le port HTTP 8080. - Page 19 Une fenêtres Paramètres s’ouvrira alors et vous aurez accès aux Propriétés détaillées sur la capture d’écran. Vous devrez noter et copier l’adresse IP du serveur DNS IPv4. Ici : 192.168.0.1 Renseigner ensuite les identifiants suivants : Nom d’utilisateur admin ogate Mot de passe admin ogate...
-
Page 20: Modification Des Informations D'identification
b. Modification des informations d’identification Le port et les informations d'identification par défaut (définis lors de la création de la base de données du serveur). Ceux-ci peuvent être modifiés dans sys.config si besoin. Les informations d'identification peuvent ensuite être modifiées via l'interface d'administration. Les pages Web de gestion sont disponibles sous /admin. -
Page 21: Présentation De L'administrateur Web
2. Présentation de l’administrateur Web a. Tableau de bord Le tableau de bord du serveur affiche : • Liste des Serveurs (Servers), des Gateways et des Nœuds (Nodes). • Les 7 événements (Events) les plus récents et sept dernières trames reçues. ATIM_1GATE_UG_FR_V2.0... -
Page 22: Onglets De Configuration Du Menu
b. Onglets de configuration du menu Users contient une liste d'identités pouvant gérer le serveur. Tous ont les mêmes droits d'accès. Infrastructure couvre la configuration des gateways LoRa, des canaux de diffusion et de la liste des nœuds ignorés. Devices liste les périphériques autorisés à se connecter à l'aide de l'activation OTAA (over-the-air-activation). -
Page 23: Créer Une Nouvelle Gateway
d. Créer une nouvelle gateway Pour accéder à cette page suivez la route suivante : Pour chaque gateway LoRaWAN, vous pouvez définir et afficher : * Champ obligatoire Description MAC * Désigne L‘adresse MAC de la gateway Group Désigne un groupe de périphériques ou un comportement spécifique à l'application Identifie la "chaîne radio"... -
Page 24: Créer Un Nouveau Canal De Multidiffusion
e. Créer un nouveau canal de multidiffusion Pour accéder à cette page suivez la route suivante : Pour définir un canal de multidiffusion, vous devez définir : * Champ obligatoire Description DevAddr * DevAddr du canal, elle ne doit pas se superposer avec aucune Node address. Profiles Désigne un groupe de périphériques [voir Créer un nouveau... -
Page 25: Créer Un Nouveau Nœud À Ignorer
f. Créer un nouveau nœud à ignorer Pour accéder à cette page suivez la route suivante : Pour définir un nœud à ignorer, vous devez définir : * Champ obligatoire Description DevAddr * DevAddr du nœud Mask Données utilisées dans des opérations bit à bit Si deux réseaux fonctionnent dans la même zone, le serveur recevra des trames issues de périphériques utilisant l'autre réseau. -
Page 26: Liste Des Évènements
g. Liste des évènements Pour accéder à cette page suivez la route suivante : Cette liste comprend un aperçu des erreurs et des avertissements survenus au cours des dernières 24 heures. Voir le guide de la liste des événements pour plus de détails. ATIM_1GATE_UG_FR_V2.0... -
Page 27: Créer Un Nouveau Périphérique
h. Créer un nouveau périphérique Pour accéder à cette page suivez la route suivante : Cet onglet montre les périphériques qui peuvent rejoindre le réseau LoRaWAN à l’aide de l’activation OTAA. Les nœuds de réseau actif qui ont déjà été appairés ou activés par l‘activation ABP. Pour chaque périphérique, pouvant rejoindre votre réseau, les configurations à... -
Page 28: Créer Un Nouveau Nœud
i. Créer un nouveau nœud Pour accéder à cette page suivez la route suivante : Cet onglet contient les nœuds actifs du réseau qui ont déjà rejoint le réseau à l'aide de l'activation OTAA (Over The Air) ou qui ont été activés par ABP (activated-by-personalization). Tous les périphériqiues pouvant rejoindre le réseau via OTAA sont répertoriés dans la liste des périphériques. - Page 29 La table des downlinks contient les trames créées par l'application, dont la transmission est planifiée. Les périphériques de classe A n’écoutent les liaisons descendantes que pendant 2 secondes après une transmission en liaison montante. Par conséquent, la transmission de tous les messages peut prendre un certain temps.
-
Page 30: Créer Un Nouveau Gestionnaire D'évènement (Handler)
j. Créer un nouveau gestionnaire d’évènement (handler) Pour accéder à cette page suivez la route suivante : Pour créer un nouveau gestionnaire, vous pouvez le définir : Description * Champ obligatoire Application * Nom de l’application Uplink Fields * Champs uplink qui seront transmis au connecteur du backend Payload Format du message payload, peut-être : ASCII Text ou Cayenne LPP... - Page 31 Vous devez configurer l'application Appareil / Nœud sur backend et saisir un nom de Groupe pour cet appareil/nœud. Le Groupe de périphériques/nœuds doit correspondre au nom du Groupe de gestionnaires. Si le Connecteur n’est pas défini, le Gestionnaire s’appliquera à une connexion en WebSocket exclusivement.
- Page 32 Le nombre binaire est ensuite obtenu en suivant une approche similaire au modèle explicité précédemment. Par exemple, <<A, B, C>> consiste en un nombre binaire de trois nombres entier d’1 byte. Afin d’obtenir une matrice à taille variable, vous pouvez coder : fun(_Port, #{data := Data}) ->...
-
Page 33: Créer Un Nouveau Connecteur
k. Créer un nouveau connecteur Pour accéder à cette page suivez la route suivante : Pour créer un nouveau connecteur, vous pouvez le définir, dans l’onglet General * Champ obligatoire Description Connector Name * Nom du connecteur Application Fait référence à un backend gestionnaire d'évènement (Handler) spécifique Format de la charge utile du message Format * Raw Data →... - Page 34 Pour créer un nouveau connecteur, vous pouvez le définir, dans l’onglet Authentification * Champ obligatoire Description Client ID Est un paramètre MQTT Identifie le type d’authentification : Auth → Username+Password pour les serveurs communs → Shared Access Signature pour les serveurs Microsoft Name ID pour une authentication simple Password/Key...
- Page 35 Veuillez lire le Guide d'intégration pour des informations détaillées sur la connexion à un serveur MQTT générique tel que RabbitMQ ou à une plate-forme IoT telle qu'AWS IoT, IBM Watson IoT et Azure IoT Hub. Concernant le fonctionnement et la création de connecteurs : −...
-
Page 36: Gérer Le Serveur Via Les Api
3. Gérer le serveur via les API Les ressources REST suivantes sont disponibles : Resource Methods Explanation /applications Supported LoRaWAN applications /users GET, POST Users of the admin interface /users/ABC GET, PUT, DELETE User ABC /gateways GET, POST LoRaWAN gateways /gateways/123 GET, PUT, DELETE Gateway with MAC=123... -
Page 37: Obtenir La Liste De Tous Les Utilisateurs
a. Obtenir la liste de tous les utilisateurs GET /users HTTP/1.1 HTTP/1.1 200 OK Content-Type: application/json [{"name":"admin","pass":"admin"}, {"name":"backup","pass":"backup"}] b. Créer ou mettre à jour un ensemble d'utilisateurs POST /users HTTP/1.1 Content-Type: application/json [{"name":"admin","pass":"admin"}, {"name":"backup","pass":"backup"}] HTTP/1.1 204 No Content c. Rechercher les informations d’un utilisateur GET /users/backup HTTP/1.1 HTTP/1.1 200 OK Content-Type: application/json... -
Page 38: Pagination
h. Pagination L'API REST accepte les paramètres de requête _page et _perPage pour paginer les listes, par exemple : http://server:8080/rxframes?_page=2&_perPage=20 Le serveur insère également l'en-tête HTTP X-Total-Count indiquant le nombre total d'éléments. Proxy Configuration Lorsque le serveur LoRaWAN est installé derrière un proxy HTTP, vous devrez peut-être ajuster la configuration du proxy comme suit. -
Page 39: Node-Red
4. Node-RED ATIM n’assure aucun support technique sur la partie applicative Node-RED qui est mis à votre disposition pour que vous puissiez développer vos propres applications. Afin de se connecter à l’interface Node-RED, il conviendra, via un navigateur Web, d’entrer l'URL... -
Page 40: Mise À Jour Logiciel
Mise à jour logiciel Pour la partie Linux la mise à jour s’effectue en ligne de commande. Pour la partie LoRaWAN, nous avons mis en place des dépôts Github à l'adresse suivante : https://github.com/1gate Le dépôt "tools" contient des utilitaires pour : –... -
Page 41: Support Technique
Démarrage de la gateway • Configuration de la gateway dans les différents modes ATIM vous fournit une gateway mais pas le permis de conduire qui va avec, à vous d’apprendre à l’utiliser et à la programmer : • Pour les questions techniques concernant le Packet Forwarder, veuillez consulter la page : https://github.com/Lora-net/packet_forwarder...