BTLEInitialize (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Communication / BTLE functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BTLEInitialize (Function)

In french: BTLEInitialise

Initializes Bluetooth Low Energy.

This function must be called before any other WLanguage function for managing Bluetooth Low Energy.

This function is useless in Android. The initialization is automatically performed.

Example

BTLEInitialize(InitBTLE)

INTERNAL PROCEDURE InitBTLE(nStatus is int)
IF nStatus = btEnabled THEN
BTLEListDevice(ScanBTLE)
END
END

Syntax

BTLEInitialize(<WLanguage procedure>)

<WLanguage procedure>: Procedure name

Name of the WLangage procedure ("callback" procedure) that will be called when Bluetooth Low Energy is initialized on the device. This procedure has the following format:
PROCEDURE <Procedure name> (<Status of Bluetooth Low Energy>)

where <Status of Bluetooth Low Energy> corresponds to the activation status of Bluetooth Low Energy on the device. This status can correspond to one of the following constants (integer type):
btActivationInProgress The Bluetooth is being enabled on the device.
This constant is not available.
btDeactivationInProgress The Bluetooth is being disabled on the device.
This constant is not available.
btDisabled The Bluetooth is disabled on the device.
btEnabled The Bluetooth is enabled on the device.

Remarks

If Bluetooth Low Energy is not available (iOS version earlier than version 9.0), the ErrorOccurred variable is set to True and ErrorInfo returns more details about the problem.
Necessary versions
- Android applications:
  - Bluetooth Low Energy WLanguage functions are only available on devices with Android 4.3 or later (api level 18).
  - A fatal error occurs if the function is used with an earlier system version.
  - To determine the version of Android the application is running on, use SysAndroidVersion.
- iOS applications:
  The WLanguage Bluetooth Low Energy functions are available for the devices running iOS 9.
- WINDEV applications:
  - Bluetooth Low Energy WLanguage functions are only available on:
    PCs that support at least Bluetooth Low Energy 5.
    PCs using a Bluetooth device that supports at least Bluetooth Low Energy 5.
  - If necessary, you can check the Bluetooth version of a PC in the Windows device manager: https://support.microsoft.com/en-us/windows/what-bluetooth-version-is-on-my-pc-f5d4cff7-c00d-337b-a642-d2d23b082793
  - Pairing must be done via Windows. Therefore, BTLEListDevice will only list devices that are visible and associated in the Windows Bluetooth settings.

Related Examples:

Cross-platform examples (WINDEV Mobile): WM Bluetooth 4

[ + ] This example explains how to use the Bluetooth Low Energy functions (Bluetooth LE): BTLExxx.

It is an application allowing you to find the nearby BTLE devices, to connect to them and to interact with the proposed services.

Business / UI classification: Business Logic

Component: wd290com.dll