Initial Bluetooth LE Central/Client implementation

[AdrianSoundy]

Description

Initial implementation of Bluetooth Central/Client.

This covers the base implementation for : -

• Watching for Bluetooth Server devices
• Creating a BluetoothLEDevice object for the device
• Connecting & Discovering available services from device
• Discovering available characteristics in a service
• Discovering available descriptors in a characteristic
• Read / Write to an attribute ( Characteristic/Descriptor)
• Notify events for changes in attributes

See nanoFramework.Device.Bluetooth for full details/examples code

Currently no support for pairing/bonding and authentication. This will be in next PR

There is still a fair amount of commented/disabled code and you may also find some TODO comments

Motivation and Context

• Resolves Add Central/Client capability to Bluetooth Home#981

How Has This Been Tested?

Tested with sample code in separate PR. Will be available once main parts merges and nuget available.

Types of changes

• Improvement (non-breaking change that improves a feature, code or algorithm)
• Bug fix (non-breaking change which fixes an issue with code or algorithm)
• New feature (non-breaking change which adds functionality to code)
• Breaking change (fix or feature that would cause existing functionality to change)
• Config and build (change in the configuration and build system, has no impact on code or features)
• Dev Containers (changes related with Dev Containers, has no impact on code or features)
• Dependencies (update dependencies and changes associated, has no impact on code or features)
• Documentation (changes or updates in the documentation, has no impact on code or features)

Checklist

• My code follows the code style of this project (only if there are changes in source code).
• My changes require an update to the documentation (there are changes that require the docs website to be updated).
• I have updated the documentation accordingly (the changes require an update on the docs in this repo).
• I have read the CONTRIBUTING document.
• I have tested everything locally and all new and existing tests passed (only if there are changes in source code).

[josesimoes]

WOW!! Lot's of work here. Great job. 👏🏻
Just some minor changes requested. 😅

[alberk8]

nf-interpreter/targets/ESP32/_nanoCLR/nanoFramework.Device.Bluetooth/nimble_utils.cpp

Line 85 in 189eaa8

int map[16]{15, 14, 13, 12, 11, 10, 9, 8, 6, 7, 4, 5, 0, 1, 2, 3};

I need to change this so that custom uuid to Guid would work.
int map[16]{12, 13, 14, 15, 10, 11, 8, 9, 7, 6, 5, 4, 3, 2, 1, 0};

[AdrianSoundy]

nf-interpreter/targets/ESP32/_nanoCLR/nanoFramework.Device.Bluetooth/nimble_utils.cpp

Line 85 in 189eaa8

int map[16]{15, 14, 13, 12, 11, 10, 9, 8, 6, 7, 4, 5, 0, 1, 2, 3};

I need to change this so that custom uuid to Guid would work. int map[16]{12, 13, 14, 15, 10, 11, 8, 9, 7, 6, 5, 4, 3, 2, 1, 0};

Can you please explain where you are seeing a problem. I tried BluetoothLEDevcie.GetGattServices() and it returns correct UUID. Also the line you are changing is not called by anything so it won't make any difference. I made the GuidToNimbleUUID() method but didn't change the code to call it.
@alberk8

[alberk8]

nf-interpreter/targets/ESP32/_nanoCLR/nanoFramework.Device.Bluetooth/nimble_utils.cpp

Line 85 in 189eaa8

int map[16]{15, 14, 13, 12, 11, 10, 9, 8, 6, 7, 4, 5, 0, 1, 2, 3};

I need to change this so that custom uuid to Guid would work. int map[16]{12, 13, 14, 15, 10, 11, 8, 9, 7, 6, 5, 4, 3, 2, 1, 0};

Can you please explain where you are seeing a problem. I tried BluetoothLEDevcie.GetGattServices() and it returns correct UUID. Also the line you are changing is not called by anything so it won't make any difference. I made the GuidToNimbleUUID() method but didn't change the code to call it. @alberk8

Sorry for pointing to the wrong line, it should be line 25 under the function NimbleUUID128ToGuid. Below is what I get from running the Ble Central and displaying the UUID of the services and Characteristic of the BluetoothLESample3. The incorrect one is only the Custom Services and Characteristics. The correct uuid should be

Guid serviceUuid = new Guid("A7EEDF2C-DA87-4CB5-A9C5-5151C78B0057");
Guid readStaticCharUuid = new Guid("A7EEDF2C-DA89-4CB5-A9C5-5151C78B0057");

@AdrianSoundy

[AdrianSoundy]

Looks like a good time to merge now. More things to be done but these can be done in next PR

[bbhxwl]

If I scan, stop, connect the client, and continue scanning while connecting, will it affect the connected client? Because I want to connect five different Bluetooth client devices, but I'm not sure when they start up, so I need to scan regularly.

[josesimoes]

@bbhxwl this is a question, nothing related with PR workflow. Can you please use our Discord server for these?