Publicité
23. Référence de l'API de haut niveau
YAPI.RegisterHub()
YAPI.RegisterHub()
Configure la librairie Yoctopuce pour utiliser les modules connectés sur une machine donnée.
function yRegisterHub( url, errmsg)
js
YRETCODE RegisterHub( string url, string errmsg)
cpp
+(YRETCODE) RegisterHub :(NSString *)
m
integer yRegisterHub( url: string, var errmsg: string): integer
pas
function RegisterHub( ByVal
vb
static int RegisterHub( string url, ref string errmsg)
cs
int RegisterHub( String url)
java
async Task<int> RegisterHub( string url)
uwp
RegisterHub( url, errmsg=None)
py
function RegisterHub( $url, &$errmsg)
php
async RegisterHub( url: string, errmsg: YErrorMsg): Promise<number>
ts
async RegisterHub( url, errmsg)
es
static string RegisterHub( string url)
dnp
static string RegisterHub( string url)
cp
Le premier paramètre détermine le fonctionnement de l'API, il peut prendre les valeurs suivantes:
usb: Si vous utilisez le mot-clé usb, l'API utilise les modules Yoctopuce connectés directement par
USB. Certains languages comme PHP, Javascript et Java ne permettent pas un accès direct aux
couches matérielles, usb ne marchera donc pas avec ces languages. Dans ce cas, utilisez un
VirtualHub ou un YoctoHub réseau (voir ci-dessous).
x.x.x.x ou hostname: L'API utilise les modules connectés à la machine dont l'adresse IP est x.x.x.x, ou
dont le nom d'hôte DNS est hostname. Cette machine peut être un ordinateur classique faisant tourner
un VirtualHub, ou un YoctoHub avec réseau (YoctoHub-Ethernet / YoctoHub-Wireless). Si vous désirez
utiliser le VirtualHub tournant sur votre machine locale, utilisez l'adresse IP 127.0.0.1.
callback Le mot-clé callback permet de faire fonctionnner l'API dans un mode appélé "callback HTTP".
C'est un mode spécial permettant, entre autres, de prendre le contrôle de modules Yoctopuce à travers
un filtre NAT par l'intermédiaire d'un VirtualHub ou d'un Hub Yoctopuce. Il vous suffit de configuer le
hub pour qu'il appelle votre script à intervalle régulier. Ce mode de fonctionnement n'est disponible
actuellement qu'en PHP et en Node.JS.
Attention, seule une application peut fonctionner à la fois sur une machine donnée en accès direct à
USB, sinon il y aurait un conflit d'accès aux modules. Cela signifie en particulier que vous devez
stopper le VirtualHub avant de lancer une application utilisant l'accès direct à USB. Cette limitation peut
être contournée en passant par un VirtualHub plutôt que d'utiliser directement USB.
Si vous désirez vous connecter à un Hub, virtuel ou non, sur lequel le controle d'accès a été activé,
vous devez donner le paramètre url sous la forme:
http://nom:mot_de_passe@adresse:port
Vous pouvez appeller RegisterHub plusieurs fois pour vous connecter à plusieurs machines différentes.
Paramètres :
206
url
:(NSError**)
url
As String,
ByRef
errmsg
As String) As Integer
errmsg
YAPI
www.yoctopuce.com
Publicité
Chapitres
