Publicité
21. Utilisation avec des langages non supportés
Un des gros avantages de cette technique est que les tests préliminaires sont très faciles à mettre en
u v r e , il suffit d'un Virtual Hub et d'un simple browser Web. Ainsi, si vous copiez l'URL suivante dans
votre browser favori, alors que le Virtual Hub est en train de tourner, vous obtiendrez la liste des
modules présents.
http://127.0.0.1:4444/api/services/whitePages.txt
Remarquez que le résultat est présenté sous forme texte, mais en demandant whitePages.xml vous
auriez obtenu le résultat en XML. De même, whitePages.json aurait permis d'obtenir le résultat en
JSON. L'extension html vous permet même d'afficher une interface sommaire vous permettant de
changer les valeurs en direct. Toute l'API REST est disponible dans ces différents formats.
Contrôle d'un module par l'interface REST
Chaque module Yoctopuce a sa propre interface REST disponible sous différentes formes.
Imaginons un Yocto-Temperature-IR avec le numéro de de série YTEMPIR1-12345 et le nom
logique monModule. l'URL suivante permettra de connaître l'état du module.
http://127.0.0.1:4444/bySerial/YTEMPIR1-12345/api/module.txt
Il est bien entendu possible d'utiliser le nom logique des modules plutôt que leur numéro de série.
http://127.0.0.1:4444/byName/monModule/api/module.txt
Vous pouvez retrouver la valeur d'une des propriétés d'un module, il suffit d'ajouter le nom de la
propriété en dessous de module. Par exemple, si vous souhaitez connaître la luminosité des LEDs
de signalisation, il vous suffit de faire la requête suivante:
http://127.0.0.1:4444/bySerial/YTEMPIR1-12345/api/module/luminosity
Pour modifier la valeur d'une propriété, il vous suffit de modifier l'attribut correspondant. Ainsi, pour
modifier la luminosité il vous suffit de faire la requête suivante:
http://127.0.0.1:4444/bySerial/YTEMPIR1-12345/api/module?luminosity=100
Contrôle des différentes fonctions du module par l'interface REST
Les fonctionnalités des modules se manipulent de la même manière. Pour connaître l'état de la
fonction temperature, il suffit de construire l'URL suivante.
http://127.0.0.1:4444/bySerial/YTEMPIR1-12345/api/temperature.txt
En revanche, si vous pouvez utiliser le nom logique du module en lieu et place de son numéro de
série, vous ne pouvez pas utiliser les noms logiques des fonctions, seuls les noms hardware sont
autorisés pour les fonctions.
Vous pouvez retrouver un attribut d'une fonction d'un module d'une manière assez similaire à celle
utilisée avec les modules, par exemple:
http://127.0.0.1:4444/bySerial/YTEMPIR1-12345/api/temperature/logicalName
Assez logiquement, les attributs peuvent être modifiés de la même manière.
http://127.0.0.1:4444/bySerial/YTEMPIR1-12345/api/temperature?logicalName=maFonction
Vous trouverez la liste des attributs disponibles pour votre Yocto-Temperature-IR au début du
chapitre Programmation, concepts généraux.
160
www.yoctopuce.com
Publicité
Chapitres
