Interface Dewesoft NET

Qu’est-ce que l’interface Dewesoft NET?

L’interface Dewesoft NETutilise les standards de communication TCP/IP entre des unités de mesure et des poste Client. Une unité de mesure DEWESoft doit-être pré-configuré avant qu’un client puisse s’y connecter.

Configuration d’une unité de mesure DEWESoft

Lorsqu’une unité de mesure Dewesoft est définie en tant qu “Unité de Mesure Esclave”, elle se retrouve en attente d’une connexion entrante TCP sur le port 8999. Cette propriété doit-être activée une seule fois, les réglages étant conservé pour les prochains redémarrages.

Si votre configuration système utilise un pare-feu actif sur l’unité de mesure, il est important d’ouvrir et autoriser l’accès au port 8999 pour les connexions entrantes, ou simplement de désactiver le pare-feu. Si le client utilise un routeur pour communiquer avec l’unité de mesure, alors le pare-feu du routeur devra être correctement configuré.

Configuration d’un poste Client

La plus simple des connexions NET consiste à utiliser un terminal réseau type Telnet (disponible de base sur de nombreux systèmes d’exploitation type Windows, Linux, etc…).

Pour se connecter à une unité de mesure DEWESoft depuis Windows par exemple, saisissez simplement ces information sur un invite de commande Windows »telnet nom_ordinateur 8999«. »Nom-ordinateur« sera soit le système de noms de domaine de la machine (son DNS) ou son adresse IP. Sous Windows, vous pouvez également utiliser le nom NETBIOS de l’ordinateur, puisque les noms NETBIOS sont résolus en noms DNS / IP (uniquement à l’intérieur du réseau LAN)

Si la connexion a réussie, DEWESoft répondera avec un message de bienvenue.

Une application Client peut contrôler la bonne connexion au système DEWESoft distant si le message de bienvenue commence par »+CONNECTED«. Suite à ce message de connexion accepté, l’application Client pourra envoyer des requètes au système DEWESoft, qui répondra soit par “+OK message”, indiquant que la requètes à été accepté, soit par “+ERR message”, indiquant que la requête à échouée.

Les Clients DEWESoft NET disposent de deux mode opératoire : le mode MAITRE ou SPECTATEUR. Lorsqu’un Client se connecte à une unité de mesure, il est automatiquement configuré en tant que SPECTATEUR. Dans ce mode de foncctionnement, le Client ne êut envoyer uniquement des requêtes qui ne pilote par le fonctionnement de DEWESoft sur l’unité de mesure. Par exemple, un Spectateur, ne peut pas démarrer ou arreter un enregistrement, charger un setup, etc.. Cependant un Client peut envoyer différentes commandes permettant d’avoir un retour sur l’état de fonctionnement et récupérer un flux de données en provenance de l’unité de mesure (seulement si l’acquisirtion est en cours coté unité de mesure).

Démarrer l’acquisition sur une une unité de mesure DEWESoft. En mode SPECTATEUR, il n’est pas possible de démarrer une acquisition. Le Client doit tout d’abord se configurer en mode MAITRE pour pouvoir envoyer ces requêtes.

Si votre application Client nécessite de devoir contrôler complètement DEWESoft, alors il vous faudra utiliser le mode MAITRE. Pour se faire, il faut envoyer la commande “SETMODE 1”. Un seul Client à la fois peux utiliser le mode MAITRE. Si un autre Client est déjà connecté à DEWESoft en mode MAITRE, alors l’envoi de la commande “SETMODE 1” sera sans succée (non pris en compte). Tout Client peut basculer en mode SPECTATEUR en utilisant la commande “SETMODE 0”. Un nombre illimité de Clients peuvent se connecter sur les unités de mesure DEWESoft en mode SPECTATEUR.

Capture de données en direct depuis une unité de mesure

La première étape pour réaliser cette action consiste à envoyer une requête avec la liste des voies à transférer via Ethernet. Le Client peux tout d’abord obtenir la liste des voies disponible avec la commande »LISTUSEDCHS«. Une réponse vous sera transmise sur plusieurs ligne depuis l’unité de mesure, indiquant les voies disponibles avec quelques paramètres (nom des voies/réglages par voie). La réponse sera contenu entre les balises “+STX” et “+ETX”.

Lorsque vous demander le transfert de données depuis une unité de mesure, un port TCP supplémentaire devra être défini. C’est le rôle du Client d’ouvrir ce port TCP pour le transfert de données. Avant que le transfert de données en direct ne commence, un Client doit ouvrir un port de TCP dédié au transfert de données. Après cela, le Client devra envoyer les commandes “STARTTRANSFER TCP_port” et l’unité de mesure DEWESoft va tenter de ce connecter à ce port de donnée sur le poste Client. Si la connexion est établie, l’unité de mesure passe en mode acquisition et commence le transfert des mesures binaires sur le port spécifié. Le format du flux de données binaires est décrit dans le chapître Information voies de mesure chapter.

Le client doit au préalable utiliser la commande “PREPARETRANSFER” avec la liste des voies concernées. Ces entrées multi-lignes sont à délimiter par les balises “/STX” et “/ETX”.

Immédiatement après la commande “Startacq”, les données seront transférées.