B4A Library [B4X] BLE 2 - Bluetooth Low Energy

This library replaces the previous BLE library.
It is simpler to use and it is more powerful. Its API is based on B4i iBLE library which makes it easy to reuse B4i code.

See the iBLE tutorial: https://www.b4x.com/android/forum/threads/ble-bluetooth-low-energy-library.46099/#content

Tips & Notes

- You can call Manager.Scan2 with AllowDuplicates set to True if you want to monitor the state of an unconnected device.
- The AdvertisingData map in DeviceFound event holds pairs of integers as keys (data types) and bytes arrays as values.
- Call ReadData2 if you are only interested in a single characteristic.
- BLE is only supported on Android 4.3+.

See the attached example. Note that the important code in in the Starter service module.

Edit:

A new version of BLE_Example was uploaded. targetSdkVersion is now set to 29
Setting the targetSdkVersion to 29 requires some changes:

1. Add the fine location permission in the manifest editor.
2. Request this permission with RuntimePermissions.

Otherwise scanning will fail with a message visible in the unfiltered logs.

BLE2 is an internal library now. It is included in the IDE.

Example is based on B4XPages and will work with B4A and B4i.

Updates:
- Example updated with targetSdkVersion = 31. Note the permissions in the manifest editor:

AddPermission(android.permission.ACCESS_FINE_LOCATION)
AddPermission(android.permission.BLUETOOTH_SCAN)
AddPermission(android.permission.BLUETOOTH_CONNECT)

And requesting at runtime:

Dim Permissions As List
Dim phone As Phone
If phone.SdkVersion >= 31 Then
    Permissions = Array("android.permission.BLUETOOTH_SCAN", "android.permission.BLUETOOTH_CONNECT", rp.PERMISSION_ACCESS_FINE_LOCATION)
Else
    Permissions = Array(rp.PERMISSION_ACCESS_FINE_LOCATION)
End If
For Each per As String In Permissions
    rp.CheckAndRequest(per)
    Wait For B4XPage_PermissionResult (Permission As String, Result As Boolean)
    If Result = False Then
        ToastMessageShow("No permission: " & Permission, True)
        Return
    End If
Next

 

[Erel]

Example updated. See first post.

 

[Erel]

v1.36 released. Fixes a potential crash when the advertising message is not set properly.

 

[Erel]

Thread is locked. Please start a new thread for any question you have.

 

[Erel]

V1.37 released. SetNotify and SetIndication methods return 'True' when the change was successful.

 

[Erel]

Example updated with an updated layout based on xCustomListView library.

 

[Erel]

Example updated. With targetSdkVersion=29 the fine location permission is required instead of the coarse location:

AddPermission(android.permission.ACCESS_FINE_LOCATION)

 

[Erel]

Example updated and it is based on B4XPages. This makes things simpler as there is no need to move back and forth between the activity and the service.

 

[Erel]

Example updated and will work with B4i as well.

 

[Erel]

Example updated with targetSdkVersion = 31. See first post.