Table des Matières
Publicité
8. Utilisation du Yocto-PowerRelay-V2 en C++
YAPI::RegisterHub("usb",
[...]
// On récupère l'objet permettant d'intéragir avec le module
YRelay
*relay;
relay
= YRelay::FindRelay("RELAYHI2-123456.relay1");
// Pour gérer le hot-plug, on vérifie que le module est là
if(relay->isOnline())
{
// Utiliser relay->set_state()
[...]
}
Voyons maintenant en détail ce que font ces quelques lignes.
yocto_api.h et yocto_relay.h
Ces deux fichiers inclus permettent d'avoir accès aux fonctions permettant de gérer les modules
Yoctopuce.
yocto_api.h
les modules contenant un relais, comme le Yocto-PowerRelay-V2.
YAPI::RegisterHub
La fonction
YAPI::RegisterHub
doivent être recherchés. Utilisée avec le paramètre
modules connectés localement à la machine. Si l'initialisation se passe mal, cette fonction renverra
une valeur différente de
problème.
YRelay::FindRelay
La fonction
YRelay::FindRelay
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-PowerRelay-V2
avec le numéros de série RELAYHI2-123456 que vous auriez appelé "MonModule" et dont vous
auriez nommé la fonction relay1 "MaFonction", les cinq appels suivants seront strictement
équivalents (pour autant que MaFonction ne soit définie qu'une fois, pour éviter toute ambiguïté):
YRelay
*relay
= YRelay::FindRelay("RELAYHI2-123456.relay1");
YRelay
*relay
= YRelay::FindRelay("RELAYHI2-123456.MaFonction");
YRelay
*relay
= YRelay::FindRelay("MonModule.relay1");
YRelay
*relay
= YRelay::FindRelay("MonModule.MaFonction");
YRelay
*relay
= YRelay::FindRelay("MaFonction");
YRelay::FindRelay
relais.
isOnline
La méthode
isOnline()
module correspondant est présent et en état de marche.
set_state
La méthode
set_state()
l'une ou l'autre de ses sorties. Les deux paramètres possibles sont
pour la sortie B.
Y_STATE_B
Un exemple réel
Lancez votre environnement C++ et ouvrez le projet exemple correspondant, fourni dans le
répertoire Examples/Doc-GettingStarted-Yocto-PowerRelay-V2 de la librairie Yoctopuce. Si vous
préférez travailler avec votre éditeur de texte préféré, ouvrez le fichier
simplement
dans le répertoire de l'exemple pour le compiler.
make
Vous reconnaîtrez dans cet exemple l'utilisation des fonctions expliquées ci-dessus, cette fois
utilisées avec le décorum nécessaire à en faire un petit programme d'exemple concret.
38
errmsg);
doit toujours être utilisé,
initialise l'API de Yoctopuce en indiquant où les modules
, et retournera via le paramètre
YAPI_SUCCESS
permet de retrouver un relais en fonction du numéro de série de
renvoie un objet que vous pouvez ensuite utiliser à loisir pour contrôler le
de l'objet renvoyé par
de l'objet renvoyé par
yocto_relay.h
, elle permet de travailler avec les
"usb"
YRelay::FindRelay
permet faire basculer le relais vers
yFindRelay
Y_STATE_A
est nécessaire pour gérer
un explication du
errmsg
permet de savoir si le
pour la sortie A et
, vous taperez
main.cpp
www.yoctopuce.com
Publicité
Table des Matières
