Démarrer avec le mode VCP sous Windows

VCP icon with a tutorial icon merged togetherLa majorité des capteurs de précision de Dracal Technologies peuvent être livrés avec l'option VCP: Virtual COM Port. Ceux-ci sont identifiables par la présence du préfice "VCP-" dans leur nom de produit (ex. VCP-RTD300). Cette option permet à l'instrument de communiquer par protocole de port série en plus du protocole USB qui est celui par défaut. Les commandes disponibles en mode VCP sont disponibles dans la documentation suivante: accédez aux données de vos instruments communiquant par port série virtuel (VCP). La présente documentation se veut un outil complémentaire, voué à guider étape par étape les utilisateurs dans leur processus de mise en marche de leurs instruments Dracal communiquant en mode VCP sous Windows.

Cette documentation offre une avenue d'utilisation possible et ne prétends en rien être la seule, ni la meilleure, parmi toutes les options possibles.

Utilisateur sous Windows

1 Installation

Lors de la réception de votre capteur supportant l'option VCP, celui-ci est en mode "USB". La première étape pour la mise en marche de votre instrument est de télécharger le logiciel DracalView, qui inclut en plus de l'interface graphique toute la suite de nos outils en ligne de commande.

2. Naviguer dans le répertoire de DracalView

Au téléchargement, le répertoire par défaut dans lequel est téléchargé le logiciel est : C:\Program Files (x86)\DracalView. Pour utiliser les outils en ligne de commande, vous devez ouvrir un terminal et naviguer dans ce répertoire. Dracal Technologies a mis à votre disposition un outil nommée "command-line tools" que vous pouvez appeler depuis votre barre de recherche et qui, lorsque vous cliquerez dessus, vous ouvrira un terminal déjà positionné au bon endroit.

 

3. Passer du mode USB au mode VCP

Le protocole de communication des produits de la série VCP- est modifié du mode USB vers le mode VCP via notre outil en ligne de commande dracal-usb-set. Pour ce faire, la commande de conversion set_protocol VCP doit d'abord être exécutée, puis être suivie du débranchement de l'instrument. Dans l'exemple suivant, le débranchement de l'instrument a été effectué virtuellement via la commande reset disponible avec dracal-usb-set.

C:\Program Files (x86)\DracalView>  dracal-usb-set -s E16026 set_protocol VCP
C:\Program Files (x86)\DracalView>  dracal-usb-set -s E16026 reset

Si un seul instrument Dracal est connecté à votre ordinateur au moment de l'exécution de ces commandes, vous pouvez omettre de préciser la numéro de série de votre appareil (comme il n'y en a qu'un seul) en utilisant l'option -f comme dans l'exemple suivant:

C:\Program Files (x86)\DracalView>  dracal-usb-set -f set_protocol VCP
C:\Program Files (x86)\DracalView>  dracal-usb-set -f reset

Notes pour les utilisateurs de Windows: À l'exécution de la commande reset, l'écho suivant sera retourné dans votre outil de terminal:

C:\Program Files (x86)\DracalView>  dracal-usb-set -f reset
USB control message error: usb_control_msg: sending control message failed, win error: The device does not recognize the command.

Ce comportement est normal et confirme que le débranchement a été complété avec succès.

Une fois basculé en mode VCP, tous les outils logiciels de DracalView (interface graphique et outils en ligne de commande) ne pourront plus communiquer avec votre instrument Dracal. C'est une particularité du système d'exploitation Windows qui impose cette contrainte, car elle n'autorise pas un appareil à communiquer dans plusieurs langages. Cette contrainte n'existe pas sous Mac OS et Linux.

4. Déterminer l'identificateur COM de votre capteur

Utilisez votre barre de recherche Windows pour accéder à votre "gestionnaire de périphériques" ("device manager"). Dans cette fenêtre, naviguez jusqu'à la section "Ports (COM & LPT)". Dans l'image ci-dessous par exemple, le capteur Dracal connecté est identifié en tant que "COM3".

 

5. Interagir avec l'instrument lorsqu'il est en mode VCP - Configurer PuTTY

Comme ni DracalView, ni les outils en ligne de commande ne nous permettent d'interagir avec l'instrument une fois qu'il est en mode VCP, nous utiliserons PuTTY comme intermédiaire de communication. Vous pouvez le télécharger sur https://putty.org/ et suivre les étapes d'installation par défaut. Suite à son installation, vous devriez y avoir accès par votre fenêtre de recherche: 

Pour accéder aux données du périphérique, nous allons créer un nouveau profile dans PuTTY avec comme type de connexion ("Connection type") "Serial". Puis dans la zone "Serial line", nous allons inscrire le nom de notre périphérique, ayant été identifié précédemment en tant que COM3 dans cet exemple. Il est recommandé de sauvegarder immédiatement la session en lui donnant un nom, comme par exemple ici "Dracal COM".

 

 

Avant d'interroger l'instrument, nous devons faire d'autres configurations:

Sous "Terminal", désactiver l'écho en cochant "Force off" aux deux options sous "Line discipline options". Ensuite, sous "Connection->Serial", nous allons désactiver le "Flow control" en sélectionnant "None":

 

Les éléments de configuration sont terminés. Retournez sous "Sessions" et sauvegardez de nouveau:

Note: Lors du lancement de la prochaine session sous PuTTY dans l'optique d'accéder aux données de vos capteurs Dracal communiquant par port série, vous n'aurez qu'à sélectionner votre session "Dracal COM" et cliquer sur "Load". Ainsi, il ne vous restera qu'à vous assurer d'inscrire l'identificateur série de l'instrument en question, qui fort probablement aura un autre identificateur (qui est COM4 comme dans l'image ci-dessous par exemple):

 

Vous êtes prêt à interroger votre instrument, en cliquant maintenant sur "Open"

 

Un fenêtre s'ouvrira alors, vous permettant non seulement de visualiser les données retournées par votre instrument, mais également d'interagir avec lui via l'appel de toutes les commandes qu'il supporte et qui sont documentées dans cette section du guide d'utilisation pour les produits VCP. Entre autres, l'envoi des commandes PROTOCOL USB suivi de la commande RESET vous permettra de faire pivoter votre instrument du mode VCP au mode USB, vous permettant à nouveau d'utiliser les outils de visualisation et d'acquisition disponibles au téléchargement de DracalView.

Note: Lors de l'appel des différentes commandes dans le terminal, bien que celles-ci ne seront pas affichées dans l'écran terminal, elles seront bel et bien exécutées et une ligne d'écho vous confirmera que celle-ci a bel et bien été reçue. 

6. Enregistrer les données avec PuTTY

Pour enregistrer les données dans un fichier, il suffit de naviguer dans "Session -> Logging". Sous "Session logging:", nous recommandons de cocher l'option "All session output". Ensuite, il est nécessaire de choisir le nom du fichier ainsi que son emplacement dans la section "Log file name:". Dans l'exemple ci-dessous, nous avons imposé ".csv" pour le format du fichier de sortie, sans quoi PuTTY propose une extension ".log" par défaut. Enfin, il suffit de cliquer sur "Open":

 

Lorsque la fenêtre s'ouvre, nous recommandons de rapidement invoquer la commande "INFO" afin que le nom des colonnes soient identifiables très rapidement à l'ouverture du fichier d'enregistrement:

 

Laissez la fenêtre ouverte: le fichier est en cours d'enregistrement. Lorsque votre tâche d'acquisition de données est terminée, vous pouvez tout simplement fermer la fenêtre PuTTY et ouvrir le fichier que vous aurez créé.

Note: Notez que vous devrez nécessairement supprimer les premières lignes de votre fichier. Si vous avez invoqué la commande "INFO" tel que suggéré, le nom de vos colonnes sera disponible à quelques lignes du début de votre fichier.

 

En conclusion

De par son mode de fonctionnement, le système d'exploitation Windows impose aux utilisateurs d'instruments Dracal de pivoter entre les modes USB et VCP selon que l'utilisateur désire utiliser tous nos outils d'acquisition de données (mode USB) ou bien intégrer les données par mode VCP. Si vous jugez que la présente documentation aurait avantage à couvrir d'autres éléments, nous vous invitons chaudement à nous faire part de vos suggestions.