Documentation de dracal-sensgate-get

[Dernière mise à jour: 04/05/2023]

[Basée sur la version logicielle: v3.2.1]

• Introduction
• 1. Mise en place
  • 1.1. Installation
  • 1.2. Prérequis
  • 1.3. Notre configuration pour monter cette documentation
    • • Installation en entreprise
      • Inquiets des aspects de sécurité?
      • Un routeur est-il nécessaire?
• 2. Découvrir les SensGate présent sur le réseau: l'outil dracal-sensgate-scan
• 3. Commande d'aide: --help ou -h
• 4. Lister les capteurs: commandes -l et -H
• 5. Accéder aux données des différents canaux: commandes -i et -s
  • 5.1. Accéder à tous les canaux sans les lister: paramètre a
  • 5.2. Détailler les canaux:  commande: -p
  • 5.3. Détailler les canaux sans symbole spécial:  commande -7
  • 5.4. Accéder aux données du premier capteur rencontré:  commande -f
  • 5.5. Choisir le nombre de décimales à afficher: commande -x
• 6. Spécifier des unités:  commandes -T,-P,-F,-M,...
• 7. Calcul de hauteur:  commande -S
• 8. Gestion des données étalonnées:  commandes -u
• 9. Enregistrer les données dans un fichier:  commande -L
  • 9.1. Spécifier le nombre de prises de mesures à enregistrer: commande -r
  • 9.2. Modifier la fréquence d'enregistrement: commande -I
• 10. Rediriger la sortie vers un autre programme

Introduction

Tout d'abord, qu'est ce qu'un SensGate? Le SensGate est un appareil de communication Ethernet/Wi-Fi qui permet d'accéder à distance aux données des instruments Dracal qui y sont connectés. C'est la pierre angulaire qui permet aux utilisateurs Dracal de passer de l'USB au IoT en l'espace de 5 minutes. Il possède également d'autres capacités (tel que l'enregistrement autonome des données "data logger") documentées dans sa datasheet ici. Cependant, pour la présente documentation, nous nous intéresserons à la manière d'intégrer ses données à vos propres logiciels via l'utilisation de l'outil en ligne de commande dracal-sensgate-get.

Avant d'aller de l'avant, il est avantageux d'effectuer un petit détour par son outil jumeau, dracal-usb-get, qui, lui, permet d'accéder aux données des instruments Dracal qui sont directement connectés par USB à un ordinateur et les intégrer à vos propres systèmes. Et voici pourquoi:

1. Toujours fidèles à notre promesse de vous simplifier la vie, l'outil dracal-sensgate-get a été développé pour fonctionner exactement sur le même format que dracal-usb-get. En d'autres mots, nos utilisateurs ayant déjà mis en place une infrastructure utilisant l'outil dracal-usb-get pour accéder à des capteurs connectés localement en USB sont à un "search and replace" près de délocaliser leur installation et entrer dans le monde de l'IoT.

2. Les exemples de codes dans plus d'une dizaines de langages de programmation pour l'outil dracal-usb-get, l'exemple d'intégration dans LabVIEW ^TM, et même la documentation de dracal-usb-get se transposent intégralement d'un outil à l'autre.

Ainsi, dans la présente documentation, nous allons d'abord mettre l'accent sur les aspects qui sont uniques à l'outil dracal-sensgate-get, et ensuite reproduire l'équivalence des commandes disponibles autant dans l'outil dracal-sensgate-get que dracal-usb-get, en prenant toutefois la liberté de vous référer à cette dernière documentation pour obtenir une description plus détaillée de l'effet des différentes commandes disponibles. 

1. Mise en place

1.1. Installation

L'outil en ligne de commande dracal-sensgate-get est disponible dans les versions de DracalView 3.2.1 et suivantes.

Utilisateurs sous Windows ou Mac OS X: Comment obtenir dracal-sensgate-get

L'outil en ligne de commande dracal-sensgate-get est fourni avec DracalView. Sous Windows ou Mac OS X, installez d'abord DracalView. Après l'installation, vous trouverez dracal-sensgate-get dans le répertoire d'installation (généralement, il s'agira de C:\Program Files\DracalView ou C:\Program Files (x86)\DracalView).

Utilisateurs sous Linux: Comment compiler dracal-sensgate-get

Sous Linux, l'outil en ligne de commande dracal-sensgate-get doit être compilé à partir du code source. Suivez les instructions de la page Utilisation des capteurs Dracal sous Linux.

1.2. Prérequis

Prendre connaissance de la documentation de dracal-usb-get, ou du moins l'ouvrir dans un onglet à côté de la présente documentation, car pour éviter la redondance, plusieurs explications plus détaillées pour les commandes communes aux 2 outils ne seront pas répétées ici.

1.3. Notre configuration pour monter cette documentation

Il est possible de combiner autant de SensGate que désiré, et plusieurs configurations sont possibles pour construire un large écosystème. Notre environnement de travail pour construire la présente documentation est le suivant. Nous avons créé un réseau Ethernet parallèle sécurisé de test (que nous allons appeler "Network_SensGate") avec un routeur indépendant sur lequel nous avons connecté 3 SensGate. Nous avons ensuite créé un accès sans-fil Wi-Fi à ce réseau (réseau n'ayant pas accès à internet, mais uniquement aux SensGate) pour permettre à l'ordinateur de travail d'accéder aux 3 SensGate à distance. Le réseau a été configuré de sorte que les ports puissent être détectables par un ordinateur connecté sur ce même réseau, afin de nous permettre de vous présenter l'outil de détection automatique dracal-sensgate-scan ci-dessous. L'ordinateur de travail est enfin simultanément connecté au réseau sans-fil "Network_SensGate" ainsi qu'au réseau Ethernet d'entreprise filaire (permettant l'accès à internet par exemple).

Installation en entreprise

Typiquement , dans le cas où les SensGate seraient connectés sur votre réseau d'entreprise, votre équipe TI voudra avoir le plein contrôle sur l'assignation des adresses et ports de chacun de vos SensGate, et ceux-ci pourraient ne pas être découvrables par l'outil dracal-sensgate-scan. Demandez tout simplement à votre équipe TI de vous communiquer explicitement l'adresse et le port où se trouvent vos SensGate.

Inquiets des aspects de sécurité?

Sachez que vos SensGate n'ont aucune capacité de routage et leur accès peut être sécurisé par mot de passe (recommandé en situation d'entreprise).

Un routeur est-il nécessaire?

Si vous désirez créer un réseau indépendant pour vos SensGate, il n'est pas nécessaire d'utiliser un routeur. Il est possible de configurer l'un de vos SensGate afin qu'il crée son propre réseau parallèle, sécurisé par mot de passe, auquel il sera connecté. Ce mode est le mode "Access point". Il suffit ensuite de connecter jusqu'à 6 autres SensGate sur ce réseau nouvellement créé, et y connecter également votre ordinateur, et le tour est joué. Pour démystifier la relation entre "routeur", "access point", "Wi-Fi", nous vous invitons à consulter l'article suivant.

2. Découvrir les SensGate présents sur le réseau: l'outil dracal-sensgate-scan

Dans le répertoire où se situent vos outils Dracal se trouve également l'outil dracal-sensgate-scan. Celui-ci balaie le réseau et liste les SensGate découvrables. Tel que discuté plus haut, il se peut que votre installation d'entreprise empêche cet outil de découvrir automatique vos SensGate. Dans ce cas, l'outil ne vous est tout simplement pas utile. Dans notre cas, voici le résultat obtenu:

 

C:\Program Files (x86)\DracalView>  dracal-sensgate-scan
Sending 50 broadcast packets to port 10395 at a 100 ms interval (total duration: 5.000 s)

192.168.20.172:10395    SensGate Test, G00007, v1.0.1 [Devices: 7]
192.168.20.174:10395    SensGate Production, G00008, v1.0.1 [Devices: 6]
192.168.20.167:10395    SensGate R&D, G00002, v1.0.1 [Devices: 7]

L'outil nous indique que 3 SensGate sont disponibles et nous communique l'information pertinente les concernant. Si nous regardons le dernier élément dans cet exemple, le SensGate que nous avons décidé de nommer  "SensGate R&D" est localisé à l'adresse 192.168.20.167 sur le port 10395 (d'où la nomenclature 192.168.20.167:10395), possède le numéro de série unique "G00002", est à la version "v1.0.1" et 7 instruments Dracal y sont connectés.

3. Commande d'aide: --help ou -h

Accédez à la liste complète et détaillée des commandes disponibles en exécutant la commande dracal-sensgate-get --help (version courte: dracal-sensgate-get -h). Nous avons souligné en jaune les commandes qui sont uniques à l'outil dracal-sensgate-get, les autres étant identiques en nom et en fonction à l'outil dracal-usb-get. Quelques exemples d'utilisation pour démarrage rapide sont aussi disponibles:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -h
Valid arguments:
    -V           Display version information
    -v           Verbose mode
    -h           Displays help
    -l           List and display info about available sensors
    -H host      Host address (IPV4), name or serial number
    -s serial    Use USB sensor with matching serial number. Default: Use first.
    -i id<,id,id...>  Use specific channel(s) id(s) or 'a' for all. Default: 0
    -R retry     Number of extra sensgate discovery messages to send. Default: 0
    -T unit      Select the temperature unit to use. Default: Celsius
    -P unit      Select the pressure unit to use. Default: kPa
    -F unit      Select the frequency unit to use. Default: Hz
    -M unit      Select the length unit to use. Default: m
    -C unit      Select the concentration unit to use. Default: Sensor default
    -p           Enable pretty output
    -7           Use 7-bit ASCII output (no Unicode degree symbols)
    -u           Print uncalibrated values, i.e. do not apply user calibration configured by dracal-usb-cal
    -L logfile   Log to specified file (use - for none)
    -I interval  Log interval. In milliseconds. Default: 1000
    -r rows      Number of log rows. Default: 0, i.e. do not stop
    -x digits    Set number of digits to display after the decimal separator. Default: 2
    -S value     Set standard sea level pressure (Pascals) used to compute altitude. Default: 101325
    -o option    Enable specified option (see below). You may use -o multiple times.

Options:
    no_humidex_range     Calculate humidex even if input values are out of range.
    no_heat_index_range  Calculate heat index even if the input values are out of range.

Valid temperature units:
    Celsius, C, Fahrenheit, F, Kelvin, K

Valid pressure units:
    kPa, hPa, Pa, bar, at (98.0665 kPa), atm (101.325 kPa), Torr, psi, inHg

Valid frequency units:
    mHz, Hz, kHz, MHz, rpm

Valid length units:
    mm, cm, dm, m, mil, in, ft, yd

Valid concentration units:
    ppb, ppm, percent

Errors:

When an error occurs reading a channel, the value is replaced by an error string:
    Undefined            Unknown/undefined error.
    Saturated            Sensor (or resulting value) is saturated and unusable.
    SensorError          The physical sensor or interface circuitry is not working properly
    ProbeDisconnected    Indicates that the probe is disconnected or cable is cut/open
    OutOfRange           The reading falls outside the sensor possible or supported range
    InvalidData          The data received from the sensor did not make sense or was incomplete

Examples:

1. Access all data from sensor with serial number E22826 on SensGate at address 192.168.20.167:10395
    dracal-sensgate-get -H 192.168.20.167:10395 -s E22826

2. Access all data from sensor with serial number E22826 on SensGate with serial number G00002
    dracal-sensgate-get -H G00002 -s E22826

3. Access all data from sensor with serial number E22826, finding SensGate automatically
    dracal-sensgate-get -s E22826

Return value:
 - On success, dracal-usb-get returns 0.
 - If the requested serial number (see -s) was not found, or if no devices were found (-f and -l) a non-zero value is returned.

4. Lister les capteurs: commandes -l et -H

Tout comme pour dracal-usb-get, la commande -l permet de lister les tous capteurs connectés sur un SensGate spécifié par la commande -H. On peut ainsi obtenir la liste des capteurs connectés sur le SensGate dont le numéro de série est le G00002 situé à l'adresse 192.168.20.167 sur le port 10395 en utilisant son adresse IP et son port:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -l
# SensGate R&D [G00002 @ 192.168.20.167:10395]
Found: 'VCP-BAR20', Serial: 'E20310', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
Found: 'VCP-BAR20', Serial: 'E20290', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
Found: 'VCP-PTH450-CAL', Serial: 'E22826', Version 2.9, Channels: 7
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: SHT31 Temperature [Temperature]
    Channel 2: SHT31 Relative Humidity [Relative Humidity]
    Virtual Channel 256: Dew point [Dew point]
    Virtual Channel 257: Humidex [Humidex]
    Virtual Channel 258: Heat index [Heat index]
    Virtual Channel 262: Altitude [Height]
[...]

Dans le cas où les SensGate sont découvrables ( voir point 2) il est possible de tout simplement spécifier un SensGate en utilisant son numéro de série:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H G00002 -l
# SensGate R&D [G00002 @ 192.168.20.167:10395]
Found: 'VCP-BAR20', Serial: 'E20310', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
Found: 'VCP-BAR20', Serial: 'E20290', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
Found: 'VCP-PTH450-CAL', Serial: 'E22826', Version 2.9, Channels: 7
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: SHT31 Temperature [Temperature]
    Channel 2: SHT31 Relative Humidity [Relative Humidity]
    Virtual Channel 256: Dew point [Dew point]
    Virtual Channel 257: Humidex [Humidex]
    Virtual Channel 258: Heat index [Heat index]
    Virtual Channel 262: Altitude [Height]
[...]

 

Enfin, sans spécification d'un SensGate en particulier (c-à-d sans utiliser la commande-H), la commande dracal-sensgate-get -l retourne la liste de tous les capteurs accessibles sur tous les SensGate, comme illustré ci-dessous:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -l
# SensGate R&D [G00002 @ 192.168.20.167:10395]
Found: 'VCP-BAR20', Serial: 'E20310', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
Found: 'VCP-BAR20', Serial: 'E20290', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
Found: 'VCP-PTH450-CAL', Serial: 'E22826', Version 2.9, Channels: 7
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: SHT31 Temperature [Temperature]
    Channel 2: SHT31 Relative Humidity [Relative Humidity]
    Virtual Channel 256: Dew point [Dew point]
    Virtual Channel 257: Humidex [Humidex]
    Virtual Channel 258: Heat index [Heat index]
    Virtual Channel 262: Altitude [Height]
[...]
# SensGate Test [G00007 @ 192.168.20.172:10395]
Found: 'USB-RTD300', Serial: 'E20339', Version 2.1, Channels: 1
    Channel 0: 3-Wire PT100 Temperature sensor [Temperature]
Found: 'VCP-BAR20', Serial: 'E20295', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
Found: 'VCP-BAR20', Serial: 'E20304', Version 2.1, Channels: 3
    Channel 0: MS5611 Pressure [Pressure]
    Channel 1: MS5611 Temperature [Temperature]
    Virtual Channel 262: Altitude [Height]
[...]
# SensGate Production [G00008 @ 192.168.20.174:10395]
Found: 'USB-SPECTRUM', Serial: 'E13572', Version 1.0, Channels: 8
    Channel 0: IR light intensity [IR light intensity]
    Channel 1: Green light intensity [Green light intensity]
    Channel 2: Blue light intensity [Blue light intensity]
    Channel 3: Red light intensity [Red light intensity]
    Channel 4: VEML6075 UVA [UVA]
    Channel 5: VEML6075 UVB [UVB]
    Channel 6: VEML6030 ALS [Ambient light]
    Channel 7: VEML6030 WHITE [White light]
Found: 'VCP-TMC200k-CAL', Serial: '016504', Version 2.4, Channels: 2
    Channel 0: Type-K Thermocouple [Temperature]
    Channel 1: Thermocouple cold junction temperature [Temperature]
[...]

Pour chacun des capteurs détectés, vous trouverez le code de produit (Found:), le numéro de série (Serial:), la version de l'appareil (Version), le nombre de canaux de données disponibles (Channels:) ainsi que leur description.

Note 1: Un canal virtuel est un canal dont les données sont calculées à partir des canaux "réels" qui eux, correspondent à des grandeurs physiques directement mesurées par le capteur.

Note 2: Sous Linux, si aucun capteur n'est détecté, il est probable que votre compte utilisateur n'ait pas les droits requis. Consultez la section sur la configuration des droits d'accès au besoin.

 

À partir de maintenant, nous allons nous intéresser aux données générées par le VCP-PTH450-CAL dont le numéro de série est le E22826 et qui est situé sur le SensGate dont le numéro de série est le G00002 situé à l'adresse 192.168.20.167 sur le port 10395.

Une fois votre SensGate et instrument identifiés, il est possible d'utiliser de manière identique toutes les commandes disponibles avec dracal-usb-get, ainsi que quelques-unes de plus. Ci-dessous, nous faisons un survol des différences commandes et nous vous indiquons la section équivalente de la documentation de dracal-usb-get pour obtenir un peu plus de détails.

5. Accéder aux données des différents canaux: commandes -i et -s

Identiques à dracal-usb-get. Voir la section équivalente.

Exemple d'utilisation pour accéder aux données des trois premiers canaux (-i 0,1,2) pour le capteur dont le numéro de série est le E22826 (-s E22826):

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i 0,1,2
103.17, 25.11, 28.40

Si votre installation est telle que vos SensGate sont automatiquement découvrables ( voir point 2) , il n'est pas nécessaire de spécifier le SensGate sur lequel se trouve l'instrument à interroger; seul le numéro de série du capteur est nécessaire, tel qu'illustré dans l'exemple ci-dessous:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -s E22826 -i 0,1,2
103.17, 25.11, 28.40

Dans la suite de cette documentation, afin de couvrir les cas d'utilisation où les SensGate ne seraient pas découvrables (installation typique en entreprise), nous spécifierons tout de même par son adresse IP le SensGate sur lequel se trouve le capteur à être interrogé et laissons au lecteur le soin de déterminer s'il peut et veut omettre ce paramètre.

5.1. Accéder à tous les canaux sans les lister: paramètre a

Identique à dracal-usb-get. Voir la section équivalente.

Exemple d'utilisation pour accéder à l'entièreté des canaux (ici au nombre de 7) en remplaçant la liste des canaux par l'optiona, comme ceci:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a
103.17, 25.11, 28.38, 5.50, 24.57, 25.11, -152.22

5.2. Détailler les canaux: commande -p

Identique à dracal-usb-get. Voir la section équivalente.

Exemple d'utilisation, pour détailler le contenu chaque canal en ajoutant l'option -p ("pretty output"):

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -p
MS5611 Pressure: 99.27 kPa
SHT31 Temperature: 36.70 ┬░C
SHT31 Relative Humidity: 31.21 %
Dew point: 16.92 ┬░C
Humidex: 41.94 ┬░C
Heat index: 36.70 ┬░C
Altitude: 172.48 m

5.3. Détailler les canaux sans caractères spéciaux: commande -7

Identique à dracal-usb-get. Voir la section équivalente.

Exemple d'utilisation du paramètre -7 pour éliminer les caractères spéciaux:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -p -7
MS5611 Pressure: 99.28 kPa
SHT31 Temperature: 36.72 C
SHT31 Relative Humidity: 29.65 %
Dew point: 16.13 C
Humidex: 41.42 C
Heat index: 36.72 C
Altitude: 171.89 m

5.4. Accéder aux données du premier capteur rencontré: commande -f

Ajout par rapport à dracal-usb-get: Accéder au premier capteur rencontré sur le premier SensGate rencontré également. Voir la section équivalente.

Il est possible de ne pas avoir à préciser le numéro de série d'un capteur et d'un SensGate pour accéder à ses données si celui-ci correspond exactement au premier capteur du premier SensGate "rencontré". C'est le cas, entre autres chose, lorsqu'un seul capteur est connecté sur un seul SensGate; il est nécessairement le premier (et seul!) rencontré. Nous recommandons donc d'utiliser le paramètre -f avec prudence dans les cas où plusieurs capteurs sont connectés à votre ordinateur. Enfin, nous rappelons qu'il existe un raccourci à la commande -f qui consiste tout simplement à ne pas l'écrire, tel que ci-dessous:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -i a -p -7
Type-K Thermocouple: 25.33 C
Thermocouple cold junction temperature: 26.28 C

5.5. Choisir le nombre de décimales à afficher: commande -x

Identique à dracal-usb-get. Voir la section équivalente.

Exemple d'utilisation où il est spécifié d'afficher une seule décimale via la commande -x:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i 0,1,2,262 -p -7 -x 1
MS5611 Pressure: 99.2 kPa
SHT31 Temperature: 37.2 C
SHT31 Relative Humidity: 31.1 %
Altitude: 175.0 m

6. Spécifier des unités: commandes -T,-P,-F,-M,...

Identique à dracal-usb-get. Voir la section équivalente.

Exemple de conversion des unités de pression en bar et des unités de température en Fahrenheit par l'ajout des commandes et options -P bar et -T f :

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -p -7 -P bar -T f
MS5611 Pressure: 1.02  bar 
SHT31 Temperature: 74.41  F 
SHT31 Relative Humidity: 34.66 %
Dew point: 44.71  F 
Humidex: 74.48  F 
Heat index: 74.41  F 
Altitude: -52.48 m

7. Calcul de hauteur: commande -S

Identique à dracal-usb-get. Voir la section équivalente.

Exemple d'utilisation où l'on calcule la hauteur d'une table en utilisant la pression mesurée lorsque le capteur est déposé sur la table comme hauteur de référence égale à 0 m.

Tout d'abord, mesurer la pression atmosphérique lorsque le capteur est déposé sur la table:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i 0,262 -7 -p -P Pa
Pressure: 101167.00 Pa
Height: 13.16 m

Établir la valeur de la pression de référence à la valeur de la pression que nous venons juste de mesurer, soit 101167 Pa:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i 0,262 -7 -p -P Pa -S 101167
Pressure: 101167.00 Pa
Height: 0.00 m

Tel qu'attendu, avec la pression actuelle comme pression de référence, la valeur mesurée de la hauteur est zéro. Maintenant, si nous plaçons le capteur sur le sol (il était sur une table) et lançons à nouveau la même commande, nous obtenons:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i 0,262 -7 -p -P Pa -S 101167
Pressure: 101179.00 Pa
Height: -0.58 m

qui se trouve à être effectivement la hauteur de la table sur lequel le capteur se trouvait initialement.

8. Gestion des données étalonnées: commande -u

Identique à dracal-usb-get. Voir la section équivalente.

Exemple d'utilisation où nous constatons l'effet de la saisie d'un point d'étalonnage effectuant un décalage de +10 °C en température, avant et après étalonnage:

C:\Program Files (x86)\DracalView>dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i 1 -p -7 -u && dracal-sensgate-get -H G00002 -s E22826 -i 1 -p -7
SHT31 Temperature: 26.62 C
SHT31 Temperature: 36.62 C

9. Enregistrer les données dans un fichier: commande -L

Ajout par rapport à dracal-usb-get: Affichage à l'écran du contenu exact du fichier, incluant la date et l'heure. Voir la section équivalente.

Exemple d'utilisation de la commande -L pour enregistrer dans un flot continu et illimité les données dans un fichier au format csv nommé test.csv se situant au C:\Users\Public\Documents:

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -L C:\Users\Public\Documents\test.csv
Log mode on.
Opened file 'C:\Users\Public\Documents\test.csv' for logging. Append mode.
101.57, 24.47, 33.85, 7.51, 24.68, 24.47, -20.12
101.57, 24.47, 33.84, 7.51, 24.68, 24.47, -20.21
101.57, 24.51, 33.88, 7.56, 24.75, 24.51, -20.21
101.57, 24.51, 33.85, 7.55, 24.74, 24.51, -20.12
101.57, 24.50, 33.87, 7.55, 24.73, 24.50, -20.21
101.57, 24.47, 33.84, 7.51, 24.68, 24.47, -20.04
^C

9.1. Spécifier le nombre de prises de mesures à enregistrer: commande -r

Nouvelle commande: Fixer le nombre de mesures à enregistrer dans un fichier.

En conjonction avec la commande -L, la commande -r permet de spécifier un nombre exact de prises de mesures à enregistrer dans un fichier. Par exemple, ci-dessous, le nombre de prises de mesures a été limité à 3:

C:\Program Files (x86)\DracalView> dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -L C:\Users\Public\Documents\test2.csv -r 3
Opened file 'C:\Users\Public\Documents\test2.csv' for logging.
99.24, 38.16, 28.05, 16.49, 43.09, 38.16, 175.36
99.24, 38.14, 28.09, 16.50, 43.08, 38.14, 175.19
99.24, 38.14, 28.02, 16.46, 43.05, 38.14, 175.36

C:\Program Files (x86)\DracalView> 

9.2. Modifier la fréquence d'enregistrement: commande -I

Identique à dracal-usb-get. Voir la section équivalente.

L'exemple ci-dessous est l'enregistrement subséquent dans un même fichier de mesures prises en spécifiant 2 intervalles différents (-I 100 suivi de -I 2000). Ainsi:

C:\Program Files (x86)\DracalView> dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -r 5-L C:\Users\Public\Documents\test2.csv -I 100

suivi de

C:\Program Files (x86)\DracalView> dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -r 5-L C:\Users\Public\Documents\test2.csv -I 2000

Voici ce qui est visible dans la lecture du fichier final:

C:\Program Files (x86)\DracalView> type C:\Users\Public\Documents\test2.csv
2023-05-03 11:22:10.540, 99.88, 35.77, 31.40, 16.21, 40.53, 35.77, 121.32
2023-05-03 11:22:10.640, 99.88, 35.77, 31.40, 16.21, 40.53, 35.77, 121.15
2023-05-03 11:22:10.740, 99.88, 35.76, 31.38, 16.19, 40.50, 35.76, 121.24
2023-05-03 11:22:10.840, 99.88, 35.76, 31.38, 16.19, 40.50, 35.76, 121.15
2023-05-03 11:22:10.941, 99.88, 35.76, 31.38, 16.19, 40.50, 35.76, 121.32
2023-05-03 11:22:22.584, 99.88, 35.76, 31.37, 16.19, 40.49, 35.76, 120.90
2023-05-03 11:22:24.585, 99.88, 35.75, 31.38, 16.18, 40.47, 35.75, 120.90
2023-05-03 11:22:26.585, 99.88, 35.77, 31.37, 16.20, 40.52, 35.77, 120.82
2023-05-03 11:22:28.586, 99.88, 35.77, 31.31, 16.17, 40.50, 35.77, 120.90
2023-05-03 11:22:30.585, 99.88, 35.75, 31.38, 16.18, 40.47, 35.75, 121.15

10. Rediriger la sortie vers un autre programme

Identique à dracal-usb-get. Voir la section équivalente.

Si, au lieu d'enregistrer les données dans un fichier .csv, vous désirez utiliser la sortie comme intrant d'un autre programme, il suffit de donner le paramètre - en argument à la commande -L. Cette commande enregistrera les données dans la variable stdout (standard output):

C:\Program Files (x86)\DracalView>  dracal-sensgate-get -H 192.168.20.167:10395 -s E22826 -i a -r 5 -L - 
Log mode on.
Logging to stdout
99.89, 35.73, 31.39, 16.18, 40.46, 35.73, 120.23
99.89, 35.76, 31.38, 16.19, 40.50, 35.76, 120.48
99.89, 35.77, 31.40, 16.21, 40.53, 35.77, 120.40
99.89, 35.73, 31.38, 16.17, 40.45, 35.73, 120.40
99.89, 35.75, 31.34, 16.16, 40.46, 35.75, 120.31

C:\Program Files (x86)\DracalView>