WEBDYN WebdynRF Manuel d’exploitation SOMMAIRE SOMMAIRE ........................ 2 Remarques concernant ce manuel ..............4 Champ d'application ................... 4 Versions de produits................... 4 Groupe cible ....................5 Principe général de fonctionnement ..............5 Communication avec le serveur distant ............6 Modes de connexion .................. 7 3.1.1...
WEBDYN WebdynRF Manuel d’exploitation Remarques concernant ce manuel Ce guide décrit l’exploitation d’une passerelle WebdynRF. Il décrit notamment le format des fichiers échangés entre la passerelle et le serveur distant et le mécanisme mis en œuvre dans ces échanges. Pour les instructions d’installation se référer au manuel d’installation de la passerelle WebdynRF (cf.
à distance. Principe général de fonctionnement La plate-forme WebdynRF est la nouvelle gamme de concentrateurs Webdyn dédiée aux réseaux sans fil. Collecter des données de compteurs ou de capteurs, contrôler des E/S sont les fonctionnalités de base de la passerelle WebdynRF.
WEBDYN WebdynRF Manuel d’exploitation Spécifications Techniques : WebdynRF Communication avec le serveur distant La passerelle communique avec un serveur distant via un serveur FTP et/ou un serveur Web Services. Gestion du serveur Web Services non-implémenté Chaque fois que sa configuration est modifiée, la passerelle peut soit la télécharger sur un serveur FTP soit l'envoyer vers un serveur Web Services (WS).
WEBDYN WebdynRF Manuel d’exploitation De même, les alarmes et les données collectées peuvent être téléchargés sur un serveur FTP ou envoyées à un serveur Web Services. Lorsque vous utilisez le transfert FTP, la passerelle peut également informer un serveur Web Services de tout téléchargement FTP.
Page 8
WEBDYN WebdynRF Manuel d’exploitation Description Configuration actuelle de la passerelle. Ce fichier est CONFIG/<uid>.xml transféré par la passerelle après chaque modification de sa configuration. La modification de ce fichier n’a pas d’effet sur la passerelle. La passerelle va simplement l’écraser la prochaine fois que sa configuration est modifiée (voir ci-dessous INBOX).
WEBDYN WebdynRF Manuel d’exploitation Le schéma XML des commandes est présenté dans le paragraphe 22. Un exemple de fichier XML de commande est présenté dans le paragraphe 23. Les schémas XML spécifiant le format des différents fichiers XML utilisés par la passerelle peut évoluer dans les futures versions lorsque de nouvelles...
Page 10
WEBDYN WebdynRF Manuel d’exploitation En cas d'échec de la connexion GPRS, une nouvelle connexion va être tentée une heure plus tard, à moins qu’une nouvelle connexion n’ait été lancée dans l'intervalle (sur demande explicite, ou déclenchée par une alarme ou par un envoi périodique).
WEBDYN WebdynRF Manuel d’exploitation Process de téléchargement sur le serveur distant (Upload) 3.4.1 Configuration, alarme, supervision et données sont téléchargées sur le serveur distant par la passerelle de façon indépendante comme décrit dans le schéma ci- dessous. Dans ce diagramme, X représente le type de téléchargement (configuration, alarme, supervision ou données).
WEBDYN WebdynRF Manuel d’exploitation Remarque : La gestion du mode WS n’est pas implémentée Inbox 3.4.2 La passerelle vérifie les actions en attente comme suit: WebdynRF - Manuel d’exploitation - Version 1.0...
WEBDYN WebdynRF Manuel d’exploitation Bouton Request Par défaut, appuyer sur le bouton «request» va déclencher une connexion au serveur distant et le téléchargement, en plus des données en attente, du status de la passerelle. Les deux peuvent être sélectivement désactivés avec les paramètres de...
WEBDYN WebdynRF Manuel d’exploitation Command Description Retour reboot Redémarre la passerelle Aucun factory Restaure les paramètres usine de la passerelle Aucun Lance la mise à jour du firmware de la passerelle Alarme (SW) update scan Lance un scan des valeurs instantanées de modules Données Supervision...
Page 15
WEBDYN WebdynRF Manuel d’exploitation <timesync> <address>011A0A30AAA0</address> <address>011A0A30AAA1</address> </timesync> </cmd> SMS: cmd=timesync cid=C_1234 address=011A0A30AAA0 address=011A0A30AAA1 La commande «scan» doit préciser les types d'informations demandées, dont: • data : les données instantanées • rssi : niveau RSSI • life-counter : compteur de durée de vie de la batterie •...
WEBDYN WebdynRF Manuel d’exploitation SMS: cmd=scan cid=C_1236 mode=data Commandes spécifiques Wavenis Les commandes Wavenis spécifiques peuvent être envoyées à un module Wavenis connue en utilisant la commande "wavenis". La liste des sous-commandes supportées est: Sous-commande Description moduflow-open Demande d’ouverture de la vanne associée à un moduflow moduflow-close Demande de fermeture de la vanne associée à...
WEBDYN WebdynRF Manuel d’exploitation Par exemple, pour lire l’octet de statut applicatif (0x20) d’un module connu (011A0A30AAA0), vous pouvez utiliser la commande applicative Wavenis 0x10 (Read parameter): XML: <cmd cid=’C_1240’> <wavenis subcmd=’raw’ data=’10012001’> <address>011A0A30AAA0</address> </wavenis> </cmd> SMS: cmd=wavenis cid=C_1240 subcmd=raw...
WEBDYN WebdynRF Manuel d’exploitation SMS: cmd=status cid=C_1238 Les informations suivantes sont renvoyées au demandeur : Nom XML Nom SMS Description Identifiant unique de la passerelle /app/version version Version logicielle de la passerelle /app/kernel kernel Linux kernel version. Présence de l’alimentation externe (booléen)
WEBDYN WebdynRF Manuel d’exploitation Le fichier du firmware doit être disponible dans le répertoire BIN sur le serveur FTP (voir paragraphe 3.2). Le checksum correspond au checksum md5 du fichier. Commande d’un contact sec (sortie numérique) Exemple: Ouvrir un contact sec de la passerelle (sortie numérique) : XML: <cmd cid=’C_1239’>...
Page 20
WEBDYN WebdynRF Manuel d’exploitation alwaysoff, alwayson non-implémenté /com/modem/delay Délais en secondes avant déconnexion dans le mode de connexion ondemand non-implémenté /com/modem/whitelist/caller_id Liste blanche de numéros d’appelants autorisés pour la réception de SMS de commande. Si vide, pas de vérification /com/ethernet/use_dhcp false, true Activation/désactivation du client...
WEBDYN WebdynRF Manuel d’exploitation /upload/config/method ftp|ws|none Méthode utilisée pour le téléchargement de la configuration ws non implémenté ftp|ws Méthode utilisée pour le /upload/alarm/method téléchargement des alarmes ws non implémenté ftp|ws /upload/supervision/method Méthode utilisée pour le téléchargement des données de supervision ws non implémenté...
WEBDYN WebdynRF Manuel d’exploitation Par exemple, le SHORTNAME de «com/modem/login» est LMC. Le contenu SMS est soumis aux règles suivantes: • Les caractères espace en fin de ligne sont ignorés. • Les SHORTNAME ne sont pas sensibles à la casse.
WEBDYN WebdynRF Manuel d’exploitation Exemples : CMD=config CTNS=1.2.3.4 Après le traitement de ce SMS, la passerelle va utiliser le serveur DNS 1.2.3.4. CMD=config CTNS=1.2.3.4 CTNS=1.2.3.5 Après le traitement de ce SMS, la passerelle va utiliser 2 serveurs DNS 1.2.3.4 et 1.2.3.5.
WEBDYN WebdynRF Manuel d’exploitation Lorsque factory n’est pas présent ou égale à false, seuls les valeurs des paramètres de configuration présents dans le nouveau fichier de configuration sont mises à jour. Lorsqu’une liste est présente dans le nouveau fichier de configuration, la liste entière est remplacée.
WEBDYN WebdynRF Manuel d’exploitation Configuration Etat Configuration Actions passerelle passerelle admin install data passe associé niveaux d’accès sont configurés dans /system/password. Ils peuvent être modifiés uniquement par un fichier de configuration depuis le serveur distant ou localement par l’administrateur. Il est fortement recommandé de modifié ces mots de passe avant déploiement.
WEBDYN WebdynRF Manuel d’exploitation Remarque : La spécification Modbus précise que si aucun bit de parité n’est utilisé, 2 bits de stop bits doivent être utilisés. Wavenis Mode transparent La passerelle dispose d'un mode transparent TCP / Wavenis. Ce mode permet à...
WEBDYN WebdynRF Manuel d’exploitation La passerelle ne gère pas la configuration de ces modules. Configuration Wavenis Valeur Description false, true /wavenis/bridge/enabled Activation/désactivation du mode transparent Wavenis 4000 Port TCP utilisé par le mode /wavenis/bridge/port transparent Wavenis utc,local,nodst Mode de gestion du temps (voir /wavenis/time/mode §6.5)
WEBDYN WebdynRF Manuel d’exploitation Si l'alarme provient d'un module inconnu, une alarme Wavenis_unknown est déclenchée. Cette alarme sera envoyée qu'une seule fois par module et peut être immédiatement envoyée (on) ou à la prochaine connexion (delayed). Si l'alarme se déclenche à partir d'un module connu mais a suivi un chemin radio différent de celui configuré, une alarme Incorrect route est déclenchée.
WEBDYN WebdynRF Manuel d’exploitation Dans tous les cas, la passerelle convertit tous les horodatages contenus dans les données Wavenis à son heure locale (les horodatages des journaux, les horodatages d'alarme, les lectures rtc). La passerelle prend également en compte le mode de temps lors du réglage de l’horloge RTC d'un module Wavenis.
WEBDYN WebdynRF Manuel d’exploitation Erreurs de communication Wavenis Pendant le processus de collecte des données, si un module ne répond pas, le fichier de données XML contiendra une entrée avec un élément «err_status" indiquant l'origine de l'erreur qui peut être :...
WEBDYN WebdynRF Manuel d’exploitation Name Description schedule Schedule ID for M-Bus data collection Wireless M-Bus En version de carte radio Wireless M-Bus la passerelle WebdynRF peut recevoir des données provenant de modules Wireless M-Bus connus en mode S1 ou T1.
WEBDYN WebdynRF Manuel d’exploitation Si le tag est de type ID (le bit de poids fort de l’ID est égal à 0), les 3 bits suivants sont traités comme des indicateurs d'alarme et ne sont donc pas considérés comme faisant partie de l'ID.
WEBDYN WebdynRF Manuel d’exploitation La configuration Modbus de la passerelle consiste en une liste d'ensembles de données et une liste de modules. Un ensemble de données est une liste de registres pour un type donné d’équipement esclave Modbus. La liste des modules associe un module esclave Modbus à...
WEBDYN WebdynRF Manuel d’exploitation Variables 11.2.1 Chaque variable est définie dans /config/modbus/datasets/dataset/vars/var par les paramètres suivants : Description name Nom de la variable (uniquement informatif) Type de variable (S0, S1, S3, S4) type address Adresse de registre étendue 16-bit size...
WEBDYN WebdynRF Manuel d’exploitation is_status En mode polling, tout changement de cette variable va déclencher une lecture de l'ensemble de données. is_alarm Comme is_status mais aussi déclenche une demande de connexion. Paramètre “alarm” Pour les variables flottantes et entières, deux seuils peuvent être définis (alarm/low et alarm/high) avec une valeur d'hystérésis.
WEBDYN WebdynRF Manuel d’exploitation Description label Nom uniquement informatif dataset Identifiant de l’ensemble de données address Adresse Modbus (1-247) Adresse IP (vide pour les équipements RTU) schedule Identifiant du schedule Remarque : Les équipements Modbus/TCP doivent être configurés pour écouter le port Modbus TCP par défaut (502).
Page 37
WEBDYN WebdynRF Manuel d’exploitation Description Identifiant unique de schedule (Entier) schedule/id schedule/label Nom uniquement informatif du schedule schedule/type Daily, Weekly, Monthly, Yearly ou Follower : voir description ci- dessous schedule/parent Référence au schedule parent pour un schedule de type Follower.
Page 38
WEBDYN WebdynRF Manuel d’exploitation Schedule de type Monthly : Chaque mois, la première occurrence T0 est donnée par le numéro de jour du mois renseigné dans dayofmonth et l’heure renseignée dans time. Le format de la variable time est le suivant : HH:MM:SS Par exemple 09:30:00 Les occurrences suivantes interviendront à...
WEBDYN WebdynRF Manuel d’exploitation <id>2</id> <label>Data upload</label> <type>follow</type> <parent>1</parent> </schedule> </schedules> Exemples : Besoin type time dayofweek dayofm datetime interval count onth Tous les week 15:00:00 mardi à 15:00:00 ème Tous les 2 month 00:00:00 jour du mois à 00:00:00...
Page 40
WEBDYN WebdynRF Manuel d’exploitation Code Description D_MODEM Défaut du modem D_MODEM_PUK Carte SIM bloquée D_ETHERNET Défaut de l’interface Ethernet D_WAVENIS Défaut radio Wavenis D_RFID Défaut du récepteur RFID D_INTERNAL_BAT Défaut batterie interne Lorsque l’alarme "power" est activée, le moteur d'alarme enverra une alarme sur la perte et la récupération de son alimentation.
WEBDYN WebdynRF Manuel d’exploitation 14 Fichiers de log La passerelle enregistre les principaux événements dans des fichiers de log. La taille du fichier de log est limitée à 200Ko. Sur demande, les fichiers de log précédents et actuels sont concaténés et téléchargés vers le serveur distant en tant que données de supervision.
WEBDYN WebdynRF Manuel d’exploitation Debug Logs le plus détaillé Le paramètre de niveau de log peut également être défini par source. Le format est alors : default_level,source:level,source:level,… Par exemple, pour utiliser le niveau 5 pour toutes les sources sauf pour la source Coronis avec le niveau 1 : /system/log/level=”2,Coronis:1”...
Le checksum correspond au checksum md5 du fichier. 17 Support En cas de problèmes techniques relatifs à nos produits, contactez le support de WEBDYN : Webdyn SA 26 Rue des Gaudines - 78100 Saint-Germain-en-Laye Tel.: +33 1 39 04 29 40 Fax.: +33 1 39 04 29 41...
WEBDYN WebdynRF Manuel d’exploitation 25 ANNEXE H Format CSV – Données Le format CSV (Comma Separated Values) est un format sans définition formelle. Néanmoins, il suit les règles suivantes : • Une ligne contient un seul enregistrement • Chaque enregistrement correspond à une seule ligne •...