YAPI (Yoctopuce Java API 2.1.11632-SNAPSHOT API)

java.lang.Object
- com.yoctopuce.YoctoAPI.YAPI

```
public class YAPI
extends Object
```

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`YAPI.CalibrationHandlerCallback`
`static interface`	`YAPI.DeviceArrivalCallback`
`static interface`	`YAPI.DeviceChangeCallback`
`static interface`	`YAPI.DeviceRemovalCallback`
`static interface`	`YAPI.HubDiscoveryCallback`
`static interface`	`YAPI.LogCallback`

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`BUFFER_TOO_SMALL`
`static int`	`DETECT_ALL`
`static int`	`DETECT_NET`
`static int`	`DETECT_NONE`
`static int`	`DETECT_USB`
`static int`	`DEVICE_BUSY`
`static int`	`DEVICE_NOT_FOUND`
`static int`	`DNS_ERROR`
`static int`	`DOUBLE_ACCES`
`static int`	`EXHAUSTED`
`static int`	`FILE_NOT_FOUND`
`static int`	`INVALID_ARGUMENT`
`static double`	`INVALID_DOUBLE`
`static int`	`INVALID_INT`
`static long`	`INVALID_LONG`
`static String`	`INVALID_STRING`
`static int`	`INVALID_UINT`
`static int`	`IO_ERROR`
`static int`	`LEGACY`
`static int`	`NO_EXPIRATION_CHECK`
`static int`	`NO_HOSTNAME_CHECK`
`static int`	`NO_MORE_DATA`
`static int`	`NO_TRUSTED_CA_CHECK`
`static int`	`NOT_INITIALIZED`
`static int`	`NOT_SUPPORTED`
`static int`	`RESEND_MISSING_PKT`
`static int`	`RFID_HARD_ERROR`
`static int`	`RFID_SOFT_ERROR`
`static int`	`RTC_NOT_READY`
`static int`	`SSL_ERROR`
`static int`	`SSL_UNK_CERT`
`static int`	`SUCCESS`
`static int`	`TIMEOUT`
`static int`	`UNAUTHORIZED`
`static int`	`UNCONFIGURED`
`static int`	`VERSION_MISMATCH`
`static String`	`YOCTO_API_BUILD_STR`
`static String`	`YOCTO_API_VERSION_STR`
`static int`	`YOCTO_BASE_SERIAL_LEN`
`static int`	`YOCTO_DEFAULT_HTTPS_PORT`
`static int`	`YOCTO_DEFAULT_PORT`
`static int`	`YOCTO_DEVID_BOOTLOADER`
`static int`	`YOCTO_DEVID_FACTORYBOOT`
`static int`	`YOCTO_FIRMWARE_LEN`
`static int`	`YOCTO_FUNCTION_LEN`
`static int`	`YOCTO_LOGICAL_LEN`
`static int`	`YOCTO_MANUFACTURER_LEN`
`static int`	`YOCTO_PRODUCTNAME_LEN`
`static int`	`YOCTO_SERIAL_LEN`
`static int`	`YOCTO_VENDORID`

Constructor Summary

Constructors
Constructor and Description

YAPI()

Constructors
Constructor and Description
`YAPI()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`_bincrc(byte[] content, int ofs, int len)`
`static String`	`AddTrustedCertificates(String certificate)` Adds a TLS/SSL certificate to the list of trusted certificates.
`static String`	`AddUdevRule(boolean force)` Adds a UDEV rule which authorizes all users to access Yoctopuce modules connected to the USB ports.
`static boolean`	`CheckLogicalName(String name)` Checks if a given string is valid as logical name for a module or a function.
`void`	`ClearHTTPCallbackCacheDir(boolean removeFiles)` Disables the HTTP callback cache.
`static String`	`DownloadHostCertificate(String url, long mstimeout)` Download the TLS/SSL certificate from the hub.
`static void`	`EnableUSBHost(Object osContext)` This function is used only on Android.
`static YHub`	`findYHubFromID(String id)`
`static void`	`FreeAPI()` Waits for all pending communications with Yoctopuce devices to be completed then frees dynamically allocated resources used by the Yoctopuce library.
`static String`	`GetAPIVersion()` Returns the version identifier for the Yoctopuce library in use.
`static long`	`GetCacheValidity()` Returns the validity period of the data loaded by the library.
`static int`	`GetDeviceListValidity()` Returns the delay between each forced enumeration of the used YoctoHubs.
`static int`	`GetNetworkTimeout()` Returns the network connection delay for yRegisterHub() and yUpdateDeviceList().
`static long`	`GetTickCount()` Returns the current value of a monotone millisecond-based time counter.
`static String`	`GetYAPISharedLibraryPath()` Returns the path to the dynamic YAPI library.
`static YHub`	`getYHubObj(int hubref)`
`static int`	`HandleEvents()` Maintains the device-to-library communication channel.
`static int`	`InitAPI(int mode)` Initializes the Yoctopuce programming library explicitly.
`static YHub`	`nextHubInUseInternal(int hubref)`
`static int`	`PreregisterHub(String url)` Fault-tolerant alternative to yRegisterHub().
`static int`	`PreregisterHubWebSocketCallback(Object session)`
`static int`	`PreregisterHubWebSocketCallback(Object session, String user, String pass)`
`static void`	`RegisterDeviceArrivalCallback(YAPI.DeviceArrivalCallback arrivalCallback)` Register a callback function, to be called each time a device is plugged.
`static void`	`RegisterDeviceChangeCallback(YAPI.DeviceChangeCallback changeCallback)`
`static void`	`RegisterDeviceRemovalCallback(YAPI.DeviceRemovalCallback removalCallback)` Register a callback function, to be called each time a device is unplugged.
`static int`	`RegisterHub(String url)` Set up the Yoctopuce library to use modules connected on a given machine.
`static int`	`RegisterHub(String url, InputStream request, OutputStream response)`
`static void`	`RegisterHubDiscoveryCallback(YAPI.HubDiscoveryCallback hubDiscoveryCallback)` Register a callback function, to be called each time an Network Hub send an SSDP message.
`static void`	`RegisterLogFunction(YAPI.LogCallback logfun)` Registers a log callback function.
`static void`	`SetCacheValidity(long cacheValidityMs)` Change the validity period of the data loaded by the library.
`static void`	`SetDeviceListValidity(int deviceListValidity)` Modifies the delay between each forced enumeration of the used YoctoHubs.
`void`	`SetHTTPCallbackCacheDir(String directory)` Enables the HTTP callback cache.
`static String`	`SetNetworkSecurityOptions(int opts)` Enables or disables certain TLS/SSL certificate checks.
`static void`	`SetNetworkTimeout(int networkMsTimeout)` Modifies the network connection delay for yRegisterHub() and yUpdateDeviceList().
`static void`	`SetThreadSpecificMode()`
`static String`	`SetTrustedCertificatesList(String certificatePath)` Set the path of Certificate Authority file on local filesystem.
`static void`	`SetUSBPacketAckMs(int pktAckDelay)` Enables the acknowledge of every USB packet received by the Yoctopuce library.
`static int`	`Sleep(long ms_duration)` Pauses the execution flow for a specified duration.
`static int`	`TestHub(String url, int mstimeout)` Test if the hub is reachable.
`static int`	`TriggerHubDiscovery()` Force a hub discovery, if a callback as been registered with yRegisterHubDiscoveryCallback it will be called for each net work hub that will respond to the discovery.
`static void`	`UnregisterHub(String url)` Set up the Yoctopuce library to no more use modules connected on a previously registered machine with RegisterHub.
`static void`	`UnregisterHubWebSocketCallback(Object session)`
`static int`	`UpdateDeviceList()` Triggers a (re)detection of connected Yoctopuce modules.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - INVALID_STRING
```
public static final String INVALID_STRING
```
    See Also:
    
    Constant Field Values
  - INVALID_DOUBLE
```
public static final double INVALID_DOUBLE
```
    See Also:
    
    Constant Field Values
  - INVALID_INT
```
public static final int INVALID_INT
```
    See Also:
    
    Constant Field Values
  - INVALID_LONG
```
public static final long INVALID_LONG
```
    See Also:
    
    Constant Field Values
  - INVALID_UINT
```
public static final int INVALID_UINT
```
    See Also:
    
    Constant Field Values
  - YOCTO_API_VERSION_STR
```
public static final String YOCTO_API_VERSION_STR
```
    See Also:
    
    Constant Field Values
  - YOCTO_API_BUILD_STR
```
public static final String YOCTO_API_BUILD_STR
```
    See Also:
    
    Constant Field Values
  - YOCTO_VENDORID
```
public static final int YOCTO_VENDORID
```
    See Also:
    
    Constant Field Values
  - YOCTO_DEVID_FACTORYBOOT
```
public static final int YOCTO_DEVID_FACTORYBOOT
```
    See Also:
    
    Constant Field Values
  - YOCTO_DEVID_BOOTLOADER
```
public static final int YOCTO_DEVID_BOOTLOADER
```
    See Also:
    
    Constant Field Values
  - YOCTO_DEFAULT_PORT
```
public static final int YOCTO_DEFAULT_PORT
```
    See Also:
    
    Constant Field Values
  - YOCTO_DEFAULT_HTTPS_PORT
```
public static final int YOCTO_DEFAULT_HTTPS_PORT
```
    See Also:
    
    Constant Field Values
  - SUCCESS
```
public static final int SUCCESS
```
    See Also:
    
    Constant Field Values
  - NOT_INITIALIZED
```
public static final int NOT_INITIALIZED
```
    See Also:
    
    Constant Field Values
  - INVALID_ARGUMENT
```
public static final int INVALID_ARGUMENT
```
    See Also:
    
    Constant Field Values
  - NOT_SUPPORTED
```
public static final int NOT_SUPPORTED
```
    See Also:
    
    Constant Field Values
  - DEVICE_NOT_FOUND
```
public static final int DEVICE_NOT_FOUND
```
    See Also:
    
    Constant Field Values
  - VERSION_MISMATCH
```
public static final int VERSION_MISMATCH
```
    See Also:
    
    Constant Field Values
  - DEVICE_BUSY
```
public static final int DEVICE_BUSY
```
    See Also:
    
    Constant Field Values
  - TIMEOUT
```
public static final int TIMEOUT
```
    See Also:
    
    Constant Field Values
  - IO_ERROR
```
public static final int IO_ERROR
```
    See Also:
    
    Constant Field Values
  - NO_MORE_DATA
```
public static final int NO_MORE_DATA
```
    See Also:
    
    Constant Field Values
  - EXHAUSTED
```
public static final int EXHAUSTED
```
    See Also:
    
    Constant Field Values
  - DOUBLE_ACCES
```
public static final int DOUBLE_ACCES
```
    See Also:
    
    Constant Field Values
  - UNAUTHORIZED
```
public static final int UNAUTHORIZED
```
    See Also:
    
    Constant Field Values
  - RTC_NOT_READY
```
public static final int RTC_NOT_READY
```
    See Also:
    
    Constant Field Values
  - FILE_NOT_FOUND
```
public static final int FILE_NOT_FOUND
```
    See Also:
    
    Constant Field Values
  - SSL_ERROR
```
public static final int SSL_ERROR
```
    See Also:
    
    Constant Field Values
  - RFID_SOFT_ERROR
```
public static final int RFID_SOFT_ERROR
```
    See Also:
    
    Constant Field Values
  - RFID_HARD_ERROR
```
public static final int RFID_HARD_ERROR
```
    See Also:
    
    Constant Field Values
  - BUFFER_TOO_SMALL
```
public static final int BUFFER_TOO_SMALL
```
    See Also:
    
    Constant Field Values
  - DNS_ERROR
```
public static final int DNS_ERROR
```
    See Also:
    
    Constant Field Values
  - SSL_UNK_CERT
```
public static final int SSL_UNK_CERT
```
    See Also:
    
    Constant Field Values
  - UNCONFIGURED
```
public static final int UNCONFIGURED
```
    See Also:
    
    Constant Field Values
  - NO_TRUSTED_CA_CHECK
```
public static final int NO_TRUSTED_CA_CHECK
```
    See Also:
    
    Constant Field Values
  - NO_EXPIRATION_CHECK
```
public static final int NO_EXPIRATION_CHECK
```
    See Also:
    
    Constant Field Values
  - NO_HOSTNAME_CHECK
```
public static final int NO_HOSTNAME_CHECK
```
    See Also:
    
    Constant Field Values
  - LEGACY
```
public static final int LEGACY
```
    See Also:
    
    Constant Field Values
  - YOCTO_MANUFACTURER_LEN
```
public static final int YOCTO_MANUFACTURER_LEN
```
    See Also:
    
    Constant Field Values
  - YOCTO_SERIAL_LEN
```
public static final int YOCTO_SERIAL_LEN
```
    See Also:
    
    Constant Field Values
  - YOCTO_BASE_SERIAL_LEN
```
public static final int YOCTO_BASE_SERIAL_LEN
```
    See Also:
    
    Constant Field Values
  - YOCTO_PRODUCTNAME_LEN
```
public static final int YOCTO_PRODUCTNAME_LEN
```
    See Also:
    
    Constant Field Values
  - YOCTO_FIRMWARE_LEN
```
public static final int YOCTO_FIRMWARE_LEN
```
    See Also:
    
    Constant Field Values
  - YOCTO_LOGICAL_LEN
```
public static final int YOCTO_LOGICAL_LEN
```
    See Also:
    
    Constant Field Values
  - YOCTO_FUNCTION_LEN
```
public static final int YOCTO_FUNCTION_LEN
```
    See Also:
    
    Constant Field Values
  - DETECT_NONE
```
public static final int DETECT_NONE
```
    See Also:
    
    Constant Field Values
  - DETECT_USB
```
public static final int DETECT_USB
```
    See Also:
    
    Constant Field Values
  - DETECT_NET
```
public static final int DETECT_NET
```
    See Also:
    
    Constant Field Values
  - RESEND_MISSING_PKT
```
public static final int RESEND_MISSING_PKT
```
    See Also:
    
    Constant Field Values
  - DETECT_ALL
```
public static final int DETECT_ALL
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - YAPI
```
public YAPI()
```
- Method Detail
  - _bincrc
```
public static int _bincrc(byte[] content,
                          int ofs,
                          int len)
```
  - SetThreadSpecificMode
```
public static void SetThreadSpecificMode()
                                  throws YAPI_Exception
```
    Throws:
    
    YAPI_Exception
  - SetUSBPacketAckMs
```
public static void SetUSBPacketAckMs(int pktAckDelay)
```
    Enables the acknowledge of every USB packet received by the Yoctopuce library. This function allows the library to run on Android phones that tend to loose USB packets. By default, this feature is disabled because it doubles the number of packets sent and slows down the API considerably. Therefore, the acknowledge of incoming USB packets should only be enabled on phones or tablets that loose USB packets. A delay of 50 milliseconds is generally enough. In case of doubt, contact Yoctopuce support. To disable USB packets acknowledge, call this function with the value 0. Note: this feature is only available on Android.
    
    Parameters:
    
    pktAckDelay - : then number of milliseconds before the module resend the last USB packet.
  - GetAPIVersion
```
public static String GetAPIVersion()
```
    Returns the version identifier for the Yoctopuce library in use. The version is a string in the form "Major.Minor.Build", for instance "1.01.5535". For languages using an external DLL (for instance C#, VisualBasic or Delphi), the character string includes as well the DLL version, for instance "1.01.5535 (1.01.5439)". If you want to verify in your code that the library version is compatible with the version that you have used during development, verify that the major number is strictly equal and that the minor number is greater or equal. The build number is not relevant with respect to the library compatibility.
    
    Returns:
    
    a character string describing the library version.
  - InitAPI
```
public static int InitAPI(int mode)
                   throws YAPI_Exception
```
    Initializes the Yoctopuce programming library explicitly. It is not strictly needed to call yInitAPI(), as the library is automatically initialized when calling yRegisterHub() for the first time. When YAPI.DETECT_NONE is used as detection mode, you must explicitly use yRegisterHub() to point the API to the VirtualHub on which your devices are connected before trying to access them.
    
    Parameters:
    
    mode - : an integer corresponding to the type of automatic device detection to use. Possible values are YAPI.DETECT_NONE, YAPI.DETECT_USB, YAPI.DETECT_NET, and YAPI.DETECT_ALL.
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - FreeAPI
```
public static void FreeAPI()
```
    Waits for all pending communications with Yoctopuce devices to be completed then frees dynamically allocated resources used by the Yoctopuce library. From an operating system standpoint, it is generally not required to call this function since the OS will automatically free allocated resources once your program is completed. However, there are two situations when you may really want to use that function: - Free all dynamically allocated memory blocks in order to track a memory leak. - Send commands to devices right before the end of the program. Since commands are sent in an asynchronous way the program could exit before all commands are effectively sent. You should not call any other library function after calling yFreeAPI(), or your program will crash.
  - RegisterHub
```
public static int RegisterHub(String url)
                       throws YAPI_Exception
```
    Set up the Yoctopuce library to use modules connected on a given machine. Idealy this call will be made once at the begining of your application. The parameter will determine how the API will work. Use the following values: usb: When the usb keyword is used, the API will work with devices connected directly to the USB bus. Some programming languages such a JavaScript, PHP, and Java don't provide direct access to USB hardware, so usb will not work with these. In this case, use a VirtualHub or a networked YoctoHub (see below). x.x.x.x or hostname: The API will use the devices connected to the host with the given IP address or hostname. That host can be a regular computer running a native VirtualHub, a VirtualHub for web hosted on a server, or a networked YoctoHub such as YoctoHub-Ethernet or YoctoHub-Wireless. If you want to use the VirtualHub running on you local computer, use the IP address 127.0.0.1. If the given IP is unresponsive, yRegisterHub will not return until a time-out defined by ySetNetworkTimeout has elapsed. However, it is possible to preventively test a connection with yTestHub. If you cannot afford a network time-out, you can use the non-blocking yPregisterHub function that will establish the connection as soon as it is available. callback: that keyword make the API run in "HTTP Callback" mode. This a special mode allowing to take control of Yoctopuce devices through a NAT filter when using a VirtualHub or a networked YoctoHub. You only need to configure your hub to call your server script on a regular basis. This mode is currently available for PHP and Node.JS only. Be aware that only one application can use direct USB access at a given time on a machine. Multiple access would cause conflicts while trying to access the USB modules. In particular, this means that you must stop the VirtualHub software before starting an application that uses direct USB access. The workaround for this limitation is to set up the library to use the VirtualHub rather than direct USB access. If access control has been activated on the hub, virtual or not, you want to reach, the URL parameter should look like: http://username:password@address:port You can call RegisterHub several times to connect to several machines. On the other hand, it is useless and even counterproductive to call RegisterHub with to same address multiple times during the life of the application.
    
    Parameters:
    
    url - : a string containing either "usb","callback" or the root URL of the hub to monitor
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - RegisterHub
```
public static int RegisterHub(String url,
                              InputStream request,
                              OutputStream response)
                       throws YAPI_Exception
```
    Throws:
    
    YAPI_Exception
  - PreregisterHubWebSocketCallback
```
public static int PreregisterHubWebSocketCallback(Object session)
                                           throws YAPI_Exception
```
    Throws:
    
    YAPI_Exception
  - PreregisterHubWebSocketCallback
```
public static int PreregisterHubWebSocketCallback(Object session,
                                                  String user,
                                                  String pass)
                                           throws YAPI_Exception
```
    Throws:
    
    YAPI_Exception
  - UnregisterHubWebSocketCallback
```
public static void UnregisterHubWebSocketCallback(Object session)
```
  - EnableUSBHost
```
public static void EnableUSBHost(Object osContext)
                          throws YAPI_Exception
```
    This function is used only on Android. Before calling yRegisterHub("usb") you need to activate the USB host port of the system. This function takes as argument, an object of class android.content.Context (or any subclass). It is not necessary to call this function to reach modules through the network.
    
    Parameters:
    
    osContext - : an object of class android.content.Context (or any subclass).
    
    Throws:
    
    YAPI_Exception - on error
  - PreregisterHub
```
public static int PreregisterHub(String url)
                          throws YAPI_Exception
```
    Fault-tolerant alternative to yRegisterHub(). This function has the same purpose and same arguments as yRegisterHub(), but does not trigger an error when the selected hub is not available at the time of the function call. If the connexion cannot be established immediately, a background task will automatically perform periodic retries. This makes it possible to register a network hub independently of the current connectivity, and to try to contact it only when a device is actively needed.
    
    Parameters:
    
    url - : a string containing either "usb","callback" or the root URL of the hub to monitor
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - UnregisterHub
```
public static void UnregisterHub(String url)
```
    Set up the Yoctopuce library to no more use modules connected on a previously registered machine with RegisterHub.
    
    Parameters:
    
    url - : a string containing either "usb" or the root URL of the hub to monitor
  - TestHub
```
public static int TestHub(String url,
                          int mstimeout)
                   throws YAPI_Exception
```
    Test if the hub is reachable. This method do not register the hub, it only test if the hub is usable. The url parameter follow the same convention as the yRegisterHub method. This method is useful to verify the authentication parameters for a hub. It is possible to force this method to return after mstimeout milliseconds.
    
    Parameters:
    
    url - : a string containing either "usb","callback" or the root URL of the hub to monitor
    
    mstimeout - : the number of millisecond available to test the connection.
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - UpdateDeviceList
```
public static int UpdateDeviceList()
                            throws YAPI_Exception
```
    Triggers a (re)detection of connected Yoctopuce modules. The library searches the machines or USB ports previously registered using yRegisterHub(), and invokes any user-defined callback function in case a change in the list of connected devices is detected. This function can be called as frequently as desired to refresh the device list and to make the application aware of hot-plug events. However, since device detection is quite a heavy process, UpdateDeviceList shouldn't be called more than once every two seconds.
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - HandleEvents
```
public static int HandleEvents()
                        throws YAPI_Exception
```
    Maintains the device-to-library communication channel. If your program includes significant loops, you may want to include a call to this function to make sure that the library takes care of the information pushed by the modules on the communication channels. This is not strictly necessary, but it may improve the reactivity of the library for the following commands. This function may signal an error in case there is a communication problem while contacting a module.
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - Sleep
```
public static int Sleep(long ms_duration)
                 throws YAPI_Exception
```
    Pauses the execution flow for a specified duration. This function implements a passive waiting loop, meaning that it does not consume CPU cycles significantly. The processor is left available for other threads and processes. During the pause, the library nevertheless reads from time to time information from the Yoctopuce modules by calling yHandleEvents(), in order to stay up-to-date. This function may signal an error in case there is a communication problem while contacting a module.
    
    Parameters:
    
    ms_duration - : an integer corresponding to the duration of the pause, in milliseconds.
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - TriggerHubDiscovery
```
public static int TriggerHubDiscovery()
                               throws YAPI_Exception
```
    Force a hub discovery, if a callback as been registered with yRegisterHubDiscoveryCallback it will be called for each net work hub that will respond to the discovery.
    
    Returns:
    
    YAPI.SUCCESS when the call succeeds. On failure returns a negative error code.
    
    Throws:
    
    YAPI_Exception
  - GetTickCount
```
public static long GetTickCount()
```
    Returns the current value of a monotone millisecond-based time counter. This counter can be used to compute delays in relation with Yoctopuce devices, which also uses the millisecond as timebase.
    
    Returns:
    
    a long integer corresponding to the millisecond counter.
  - CheckLogicalName
```
public static boolean CheckLogicalName(String name)
```
    Checks if a given string is valid as logical name for a module or a function. A valid logical name has a maximum of 19 characters, all among A...Z, a...z, 0...9, _, and -. If you try to configure a logical name with an incorrect string, the invalid characters are ignored.
    
    Parameters:
    
    name - : a string containing the name to check.
    
    Returns:
    
    true if the name is valid, false otherwise.
  - RegisterDeviceArrivalCallback
```
public static void RegisterDeviceArrivalCallback(YAPI.DeviceArrivalCallback arrivalCallback)
```
    Register a callback function, to be called each time a device is plugged. This callback will be invoked while yUpdateDeviceList is running. You will have to call this function on a regular basis.
    
    Parameters:
    
    arrivalCallback - : a procedure taking a YModule parameter, or null to unregister a previously registered callback.
  - RegisterDeviceChangeCallback
```
public static void RegisterDeviceChangeCallback(YAPI.DeviceChangeCallback changeCallback)
```
  - RegisterDeviceRemovalCallback
```
public static void RegisterDeviceRemovalCallback(YAPI.DeviceRemovalCallback removalCallback)
```
    Register a callback function, to be called each time a device is unplugged. This callback will be invoked while yUpdateDeviceList is running. You will have to call this function on a regular basis.
    
    Parameters:
    
    removalCallback - : a procedure taking a YModule parameter, or null to unregister a previously registered callback.
  - RegisterHubDiscoveryCallback
```
public static void RegisterHubDiscoveryCallback(YAPI.HubDiscoveryCallback hubDiscoveryCallback)
```
    Register a callback function, to be called each time an Network Hub send an SSDP message. The callback has two string parameter, the first one contain the serial number of the hub and the second contain the URL of the network hub (this URL can be passed to RegisterHub). This callback will be invoked while yUpdateDeviceList is running. You will have to call this function on a regular basis.
    
    Parameters:
    
    hubDiscoveryCallback - : a procedure taking two string parameter, the serial number and the hub URL. Use null to unregister a previously registered callback.
  - RegisterLogFunction
```
public static void RegisterLogFunction(YAPI.LogCallback logfun)
```
    Registers a log callback function. This callback will be called each time the API have something to say. Quite useful to debug the API.
    
    Parameters:
    
    logfun - : a procedure taking a string parameter, or null to unregister a previously registered callback.
  - SetHTTPCallbackCacheDir
```
public void SetHTTPCallbackCacheDir(String directory)
                             throws YAPI_Exception
```
    Enables the HTTP callback cache. When enabled, this cache reduces the quantity of data sent to the PHP script by 50% to 70%. To enable this cache, the method ySetHTTPCallbackCacheDir() must be called before any call to yRegisterHub(). This method takes in parameter the path of the directory used for saving data between each callback. This folder must exist and the PHP script needs to have write access to it. It is recommended to use a folder that is not published on the Web server since the library will save some data of Yoctopuce devices into this folder. Note: This feature is supported by YoctoHub and VirtualHub since version 27750.
    
    Parameters:
    
    directory - : the path of the folder that will be used as cache.
    
    Throws:
    
    YAPI_Exception - on error
  - ClearHTTPCallbackCacheDir
```
public void ClearHTTPCallbackCacheDir(boolean removeFiles)
```
    Disables the HTTP callback cache. This method disables the HTTP callback cache, and can additionally cleanup the cache directory.
    
    Parameters:
    
    removeFiles - : True to clear the content of the cache.
    
    Throws:
    
    YAPI_Exception - on error
  - SetDeviceListValidity
```
public static void SetDeviceListValidity(int deviceListValidity)
```
    Modifies the delay between each forced enumeration of the used YoctoHubs. By default, the library performs a full enumeration every 10 seconds. To reduce network traffic, you can increase this delay. It's particularly useful when a YoctoHub is connected to the GSM network where traffic is billed. This parameter doesn't impact modules connected by USB, nor the working of module arrival/removal callbacks. Note: you must call this function after yInitAPI.
    
    Parameters:
    
    deviceListValidity - : nubmer of seconds between each enumeration.
  - GetDeviceListValidity
```
public static int GetDeviceListValidity()
```
    Returns the delay between each forced enumeration of the used YoctoHubs. Note: you must call this function after yInitAPI.
    
    Returns:
    
    the number of seconds between each enumeration.
  - GetYAPISharedLibraryPath
```
public static String GetYAPISharedLibraryPath()
```
    Returns the path to the dynamic YAPI library. This function is useful for debugging problems loading the dynamic library YAPI. This function is supported by the C#, Python and VB languages. The other libraries return an empty string.
    
    Returns:
    
    a string containing the path of the YAPI dynamic library.
  - AddUdevRule
```
public static String AddUdevRule(boolean force)
```
    Adds a UDEV rule which authorizes all users to access Yoctopuce modules connected to the USB ports. This function works only under Linux. The process that calls this method must have root privileges because this method changes the Linux configuration.
    
    Parameters:
    
    force - : if true, overwrites any existing rule.
    
    Returns:
    
    an empty string if the rule has been added. On failure, returns a string that starts with "error:".
  - DownloadHostCertificate
```
public static String DownloadHostCertificate(String url,
                                             long mstimeout)
```
    Download the TLS/SSL certificate from the hub. This function allows to download a TLS/SSL certificate to add it to the list of trusted certificates using the AddTrustedCertificates method.
    
    Parameters:
    
    url - : the root URL of the VirtualHub V2 or HTTP server.
    
    mstimeout - : the number of milliseconds available to download the certificate.
    
    Returns:
    
    a string containing the certificate. In case of error, returns a string starting with "error:".
  - AddTrustedCertificates
```
public static String AddTrustedCertificates(String certificate)
```
    Adds a TLS/SSL certificate to the list of trusted certificates. By default, the library library will reject TLS/SSL connections to servers whose certificate is not known. This function function allows to add a list of known certificates. It is also possible to disable the verification using the SetNetworkSecurityOptions method.
    
    Parameters:
    
    certificate - : a string containing one or more certificates.
    
    Returns:
    
    an empty string if the certificate has been added correctly. In case of error, returns a string starting with "error:".
  - SetTrustedCertificatesList
```
public static String SetTrustedCertificatesList(String certificatePath)
```
    Set the path of Certificate Authority file on local filesystem. This method takes as a parameter the path of a file containing all certificates in PEM format. For technical reasons, only one file can be specified. So if you need to connect to several Hubs instances with self-signed certificates, you'll need to use a single file containing all the certificates end-to-end. Passing a empty string will restore the default settings. This option is only supported by PHP library.
    
    Parameters:
    
    certificatePath - : the path of the file containing all certificates in PEM format.
    
    Returns:
    
    an empty string if the certificate has been added correctly. In case of error, returns a string starting with "error:".
  - SetNetworkSecurityOptions
```
public static String SetNetworkSecurityOptions(int opts)
```
    Enables or disables certain TLS/SSL certificate checks.
    
    Parameters:
    
    opts - : The options are YAPI.NO_TRUSTED_CA_CHECK, YAPI.NO_EXPIRATION_CHECK, YAPI.NO_HOSTNAME_CHECK.
    
    Returns:
    
    an empty string if the options are taken into account. On error, returns a string beginning with "error:".
  - SetNetworkTimeout
```
public static void SetNetworkTimeout(int networkMsTimeout)
```
    Modifies the network connection delay for yRegisterHub() and yUpdateDeviceList(). This delay impacts only the YoctoHubs and VirtualHub which are accessible through the network. By default, this delay is of 20000 milliseconds, but depending on your network you may want to change this delay, gor example if your network infrastructure is based on a GSM connection.
    
    Parameters:
    
    networkMsTimeout - : the network connection delay in milliseconds.
  - GetNetworkTimeout
```
public static int GetNetworkTimeout()
```
    Returns the network connection delay for yRegisterHub() and yUpdateDeviceList(). This delay impacts only the YoctoHubs and VirtualHub which are accessible through the network. By default, this delay is of 20000 milliseconds, but depending on your network you may want to change this delay, for example if your network infrastructure is based on a GSM connection.
    
    Returns:
    
    the network connection delay in milliseconds.
  - SetCacheValidity
```
public static void SetCacheValidity(long cacheValidityMs)
```
    Change the validity period of the data loaded by the library. By default, when accessing a module, all the attributes of the module functions are automatically kept in cache for the standard duration (5 ms). This method can be used to change this standard duration, for example in order to reduce network or USB traffic. This parameter does not affect value change callbacks Note: This function must be called after yInitAPI.
    
    Parameters:
    
    cacheValidityMs - : an integer corresponding to the validity attributed to the loaded function parameters, in milliseconds.
  - GetCacheValidity
```
public static long GetCacheValidity()
```
    Returns the validity period of the data loaded by the library. This method returns the cache validity of all attributes module functions. Note: This function must be called after yInitAPI .
    
    Returns:
    
    an integer corresponding to the validity attributed to the loaded function parameters, in milliseconds
  - nextHubInUseInternal
```
public static YHub nextHubInUseInternal(int hubref)
```
  - getYHubObj
```
public static YHub getYHubObj(int hubref)
```
  - findYHubFromID
```
public static YHub findYHubFromID(String id)
```

Class YAPI

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

INVALID_STRING

INVALID_DOUBLE

INVALID_INT

INVALID_LONG

INVALID_UINT

YOCTO_API_VERSION_STR

YOCTO_API_BUILD_STR

YOCTO_VENDORID

YOCTO_DEVID_FACTORYBOOT

YOCTO_DEVID_BOOTLOADER

YOCTO_DEFAULT_PORT

YOCTO_DEFAULT_HTTPS_PORT

SUCCESS

NOT_INITIALIZED

INVALID_ARGUMENT

NOT_SUPPORTED

DEVICE_NOT_FOUND

VERSION_MISMATCH

DEVICE_BUSY

TIMEOUT

IO_ERROR

NO_MORE_DATA

EXHAUSTED

DOUBLE_ACCES

UNAUTHORIZED

RTC_NOT_READY

FILE_NOT_FOUND

SSL_ERROR

RFID_SOFT_ERROR

RFID_HARD_ERROR

BUFFER_TOO_SMALL

DNS_ERROR

SSL_UNK_CERT

UNCONFIGURED

NO_TRUSTED_CA_CHECK

NO_EXPIRATION_CHECK

NO_HOSTNAME_CHECK

LEGACY

YOCTO_MANUFACTURER_LEN

YOCTO_SERIAL_LEN

YOCTO_BASE_SERIAL_LEN

YOCTO_PRODUCTNAME_LEN

YOCTO_FIRMWARE_LEN

YOCTO_LOGICAL_LEN

YOCTO_FUNCTION_LEN

DETECT_NONE

DETECT_USB

DETECT_NET

RESEND_MISSING_PKT

DETECT_ALL

Constructor Detail

YAPI

Method Detail

_bincrc

SetThreadSpecificMode

SetUSBPacketAckMs

GetAPIVersion

InitAPI

FreeAPI

RegisterHub

RegisterHub

PreregisterHubWebSocketCallback

PreregisterHubWebSocketCallback

UnregisterHubWebSocketCallback

EnableUSBHost

PreregisterHub

UnregisterHub

TestHub

UpdateDeviceList

HandleEvents

Sleep

TriggerHubDiscovery

GetTickCount