LabVIEW Bluetooth Low Energy Driver development using Universal Windows Platform (UWP)

[Bharathi|CLA]

Description

Description-Separate-1

This example demonstrate on how to use the windows 10 BLE native library to communicate with BLE devices (Smart watch, bulb or any device which support BLE). Developed the DLL to interact with windows 10 BLE library in C# platform and integrated the dll into LabVIEW by using .Net constructor node.

Here demonstrates usage of the Bluetooth Generic Attribute (GATT) Client APIs for Universal Windows Platform (UWP), along with sample code for common GATT client tasks:

• Query for nearby devices
• Connect to device
• Enumerate the supported services and characteristics of the device
• Read and write to a characteristic
• Subscribe for notifications when characteristic value change

Description-Separate-2

How to Use

How-Separate-1

Following are the methods available in BLE library:

Methods:

1. BLE_Initialize.vi - Initialize the DLL
2. BLE_StartWatcher.vi - listening advertisement of near by BLE devices
3. BLE_Get_WatcherResponse.vi - Gets the manufacture data, BLE address from BLE advertisement
4. BLE_Get_WatcherReceivedData.vi - Decodes the watcher response
5. BLE_StopWatcher.vi - Stop getting advertisement from near by BLE devices
6. BLE_Request_Connect.vi - Initiates the connection to BLE device and returns with response of connection status and GATT Services list from BLE device
7. BLE_Get_ServicesUUIDs_Property.vi - Gets the GATT service UUIDs and Property UUIDS from BLE device
8. BLE_Notify.vi - Initiate the BLE notification of UUIDs from BLE device
9. BLE_Notify_Listener.vi - Gets the notification of UUIDs from BLE device
10. BLE_Read_Characteristic.vi - Reads the UUIDs of BLE device
11. BLE_Read_CharacteristicArray.vi - Reads the array of UUIDs of BLE device
12. BLE_Request_ServiceUUIDs.vi - Get the Service UUIDs
13. BLE_Write.vi - Write the UUIDs of BLE device
14. BLE_Write_Without_Response.vi - Write the without response UUIDs of BLE device and not return response

How-Separate-2

Additional Information

Additional-Separate-1

When setting the debug logs to true, C# library created the BLE log files under C drive

Development Environment:

LabVIEW 2020 32 Bit

OS: Win 10 64 bit

Added the Example code in HLD where user has to change the BLE address before run. The BLE address can be get after running the watcher.

Additional-Separate-2

[Bharathi|CLA]

Screen shot of BLE device communication using windows UWP library. I have used my smart watch to communicate by using LabVIEW and C# library

[yokohama_turkey]

Great!
I was waiting for this.
I was able to capture my heart rate monitor with this example.
Thank you Bharathi-CLD.😆

[FMonteiro]

Hi, I´m trying to use the write function using:

0000fff2-0000-1000-8000-00805f9b34fb as UUID.

Converting the command string (F0;) to byte array, but I don´t know how to extract the response.

[tcie]

hi, suddenly I started to get "Object reference not set to an instance of an object." error. even using simple code:

and now it works again, can it be antivirus?

[tcie]

in order to receive the data stream from the BLE device using Notify you have to remove for loop and wait from BLE_Notify_Listener.vi and control it from your app. Also it's good to remove key from the Gatt_Characteristic_NotifyValue after read so you don't read same value over and over.

example: config notify using BLE_Notify.vi, get Gatt_Characteristic_NotifyValue, check if it contains key - new packet of data, if no write "NO DATA/FAILURE" if yes read data and remove it from Gatt_Characteristic_NotifyValue so it's not read multiple times

[tcie]

I got "Object reference not set to an instance of an object." error agian

https://knowledge.ni.com/KnowledgeArticleDetails?id=kA00Z000000P8XnSAK&l=en-CH

[Bharathi|CLA]

Hello,

Pls. let me know are you still getting Object reference not set to an instance of an object error. And let me know if you need any inputs on the driver.

Thanks

Bharathi T

[tcie]

the issue appeared again and tips from the link above do not work...

just tried on LV2021 SP1 32 and 64 bit

Could you please share source code of the library too?

[tcie]

debug info:

Log : 28.01.2021 20:29:12 ,ConnectBLE method called with address:123456789
Log : 28.01.2021 20:29:12 ,Waiting for BLE to connect with address:123456789
Log : 28.01.2021 20:29:12 ,Exception in ConnectBLE method:Object reference not set to an instance of an object.

vs debug without error:

Log : 26.01.2021 13:49:56 ,BLE_LIB method called
Log : 26.01.2021 13:49:56 ,ConnectBLE method called with address:123456789
Log : 26.01.2021 13:49:56 ,Waiting for BLE to connect with address:123456789
Log : 26.01.2021 13:49:56 ,Received the BLE Reference
Log : 26.01.2021 13:49:56 ,Connected with address:123456789
Log : 26.01.2021 13:50:04 ,ConnectBLE method pairstatus:Device unreachable

[steve_morris]

Hi,

I am using the library and am able to pair with my device and get the available UUIDs.  I can read the values for the 'standard' UUIDs like device name, serial number, manufacturer.  But when I try to read the custom UUIDs I get ProtocolError.  Any idea how to correct this?

[FMonteiro]

"in order to receive the data stream from the BLE device using Notify you have to remove for loop and wait from BLE_Notify_Listener.vi and control it from your app. Also it's good to remove key from the Gatt_Characteristic_NotifyValue after read so you don't read same value over and over.

example: config notify using BLE_Notify.vi, get Gatt_Characteristic_NotifyValue, check if it contains key - new packet of data, if no write "NO DATA/FAILURE" if yes read data and remove it from Gatt_Characteristic_NotifyValue so it's not read multiple times"

Still not working.

First i´m using write function sending the command "J;", than your notify process with UUID selected, is that correct?

[FMonteiro]

[LvTech]

Hi,

Can this library be used in tandem with the BLE toolkit using the BLED112 dongle? I have an application built around the BLE Toolkit, but now need a way to connect to a device and set some values in the attribute table. 

Thanks,

George

[Bharathi|CLA]

BLED112 has its own LabVIEW library APIs to perform read / write.

[User002]

Hi

Program is very good. I use this program connected bluefruit32.              Bluefruit32     https://learn.adafruit.com/adafruit-feather-32u4-bluefruit-le

As far as I know Notify is data. And bluefruit32 send data every 1000ms.

The program always doesn't read Notify.

And I use BLE_Notify_Listener.vi. But data is empty.

Try BLE_Notify_Listener.vi add 'remove key' but same result.

Please help me.

Thanks.

regards.

[Bharathi|CLA]

Hi,

We need to register for notification using 'NotifyCharacteristicUUIDValue (BLE_Notify.vi)'. Once you register for this notification, then the new value gets retrived using BLE_Notify_Listener.vi. We have option to see the notification value in the BLE log as well. You may need to add logic to check whether the values are notified for every 1000msec.

[SmithGPI]

I have a customer that has created a beacon using the Silicone Labs BLE Blue Gecko.  The beacon is non-connectable - undirected.  The devices show up under the watcher scan, but since the devices are not connectable I cannot pair with them to retrieve data.  If I use a sniffer, I can see the raw data string with GAP data types 0x09 and 0x16.  Is there a way to access the raw data from a beacon using UWP?

[djac91]

How to monitor connection status?

[leapBenjamin]

We are developing a Sensor, that has to send quite some data to the LabView GUI which I am currently developing. In order not to handle too many "packets", the Characteristics is larger than the "standard" max 20 byte payload. But I cannot get more than 20 bytes out via the API, the rest is just ignored apparently. Can I do something to set-up this functionality?

[caleris491]

Hi, thanks for the library.

I am using it to connect to an Arduino MKR Wifi 1010 and I noticed that disconnecting does nothing, in fact the arduino detects the disconnection 3 seconds after the program closed. Using the disconnection methods DisConnect_BLE_ByAddress and DisConnect_BLE changes nothing.

Is there a proper way to disconnect the devices ?

Thanks.

[CRE]

Hi,

this library is very nice to use. Thanks for that.

But not all bytes are coming during data read. It seems also to me that 20bytes is the limit.

Can you change that or share the code for the dll here or on github?

Best regards

[Ansonngoo84]

Hi, I´m trying to use the write function using:

0000fff2-0000-1000-8000-00805f9b34fb as UUID.

Converting the command string (F0;) to byte array, but I don´t know how to extract the response.

[mikoborn]

Hello you all,

the photo attached of the invoke node belongs to the Notify_listener.vi. As the key I tried connecting either one of the UUIDs that have "notify" as a property. However "ContainsKey" is false for both cases. I am somwhat lost on what to do/try next. Is there any way to view what keys are acceptet for the "ContainsKey" function? Any advice would be welcome.

 

[m2ochi]

Hi,

Thank you for providing such a wonderful library.
Is it possible to use indicate instead of notify in this library? Or is it possible to write directly to CCCD?

Best regards.

[WillHill]

Hi you all,

Thanks and congratulations to the developer for this very usefull library !

My problem is that I need to obtain the adittional data on 2nd advertising from a peripheral in my application.

Is there any way to send a Scan Request and then receive the Scan Response ?

thank in advanced !!

Best Regards.

[Vijey123]

Hello, 

I have a critical issue. I need to pair a cluster that displays a pair key to connect with it. The pass key has to be entered in the Labview. I am using BLE_Notify _Listener.vi to send it to the cluster. Is there any specific format to send the key along with UUID?

Any leads would be appreciated.

Regards,

Vijey.

[1530971125@qq.com]

hello，

We are control a ble device, that has to send some command. But I cannot get more than 20 bytes out via the API, the rest is just ignored apparently. Can I do something to set-up this functionality?

Thanks!