13. Utilisation du Yocto-MaxiMicroVolt-Rx en TypeScript
vous référenciez au moins une fois dans votre projet soit la variante
yocto_api_html.js
Notez que cet exemple importe la librairie au format CommonJS, le plus utilisé avec Node.JS à ce
jour, mais si votre projet est construit pour utiliser les modules natifs EcmaScript, il suffit de remplace
dans l'import le préfix
YAPI.RegisterHub
La méthode
RegisterHub
Yoctopuce, ou plus exactement la machine sur laquelle tourne le programme VirtualHub. Dans notre
cas l'adresse
127.0.0.1:4444
standard utilisé par Yoctopuce). Vous pouvez parfaitement changer cette adresse, et mettre
l'adresse d'une autre machine sur laquelle tournerait un autre VirtualHub, ou d'un YoctoHub. Si l'hôte
n'est pas joignable, la fonction déclanche une exception.
Comme expliqué précédemment, il n'est pas possible d'utiliser directement
en TypeScript, car la machine virtuelle JavaScript n'a pas accès directement aux
("usb")
périphériques USB. Elle doit nécessairement passer par le programme VirtualHub via une
connection par l'adresse 127.0.0.1.
YGenericSensor.FindGenericSensor
La méthode
FindGenericSensor
numéro de série de son module hôte et de son nom de fonction. Mais vous pouvez tout aussi bien
utiliser des noms logiques que vous auriez préalablement configurés. Imaginons un module Yocto-
MaxiMicroVolt-Rx avec le numéros de série RXUVOLT1-123456 que vous auriez appelé
"MonModule" et dont vous auriez nommé la fonction genericSensor1 "MaFonction", les cinq appels
suivants seront strictement équivalents (pour autant que MaFonction ne soit définie qu'une fois, pour
éviter toute ambiguïté):
genericsensor
= YGenericSensor.FindGenericSensor("RXUVOLT1-123456.genericSensor1")
genericsensor
= YGenericSensor.FindGenericSensor("RXUVOLT1-123456.MaFonction")
genericsensor
= YGenericSensor.FindGenericSensor("MonModule.genericSensor1")
genericsensor
= YGenericSensor.FindGenericSensor("MonModule.MaFonction")
genericsensor
= YGenericSensor.FindGenericSensor("MaFonction")
YGenericSensor.FindGenericSensor
loisir pour contrôler le capteur générique.
isOnline
La méthode
isOnline()
module correspondant est présent et en état de marche.
get_currentValue
La
méthode
YGenericSensor.FindGenericSensor
Yocto-MaxiMicroVolt-Rx. La valeur de retour est un nombre flottant, correspondant généralement à
la mesure différentielle de tension mesurée en mV, sauf si le
effectuer une correspondance linéaire vers une autre grandeur physique.
Un exemple concret, en Node.js
Ouvrez une fenêtre de commande (un terminal, un shell...) et allez dans le répertoire
example_nodejs/Doc-GettingStarted-Yocto-MaxiMicroVolt-Rx de la librairie Yoctopuce pour
TypeScript. Vous y trouverez un fichier nommé
reprend les fonctions expliquées précédemment, mais cette fois utilisées avec le décorum
nécessaire à en faire un petit programme d'exemple concret.
Si le Yocto-MaxiMicroVolt-Rx n'est pas branché sur la machine où fonctionne le navigateur internet,
remplacez dans l'exemple l'adresse
Yocto-MaxiMicroVolt-Rx et où vous avez lancé le VirtualHub.
102
.
par
yoctolib-cjs
yoctolib-esm
permet d'indiquer sur quelle machine se trouvent les modules
indique la machine locale, en utilisant le port
permet de retrouver un capteur générique en fonction du
de l'objet renvoyé par
get_currentValue()
127.0.0.1
yocto_api_nodejs.js
.
renvoie un objet que vous pouvez ensuite utiliser à
FindGenericSensor
de
l'objet
permet d'obtenir la valeur actuelle mesurée par le
genericSensor
avec le code d'exemple ci-dessous, qui
demo.ts
par l'adresse IP de la machine où est branché le
, soit
(le port
4444
RegisterHub
permet de savoir si le
renvoyé
par
a été configuré pour
www.yoctopuce.com