Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Developing an HID input device driver for a BLE GATT device on Windows 10

(This is a crosspost from the MSDN forums since there hasn't been any response there for quite some time and I thought I would get better answers here.)

I have a BLE device containing a custom GATT service, of which I cannot modify the firmware. I want to listen for the GATT characteristic events from that service, and make Windows consume them as HID reports to make Windows recognize it as another device. How would I go about doing this?

I conducted some research, and found the information below:

  • There were BLE GATT Profile driver samples in WDK 8.0, but they are outdated and do not compile with VS2017 / WDK10
  • In order to inject HID reports from a non-HID device, you need to use the virtual HID framework for which there are a more detailed page and a sample.
  • There is also a sample for Windows IoT Core
  • It seems to be not allowed to create filter drivers for BthLeEnum
  • The available BLE GATT functions for C++ are on MSDN
  • There is a sample on using them for a client app (not a driver)

My question is, what approach is needed here to create this driver?

  • Do I need to create two drivers (a virtual HID driver and a GATT Profile driver), and then somehow connect them to each other?
  • Do I need to make the Bluetooth LE API calls from the virtual HID driver?
  • Do I need to create a GATT Profile driver that makes HID calls?
  • Or something else entirely?

Are GATT Profile drivers even still allowed on Windows 10, since it seems it is not allowed to create filter drivers for BthLeEnum?

Update

I really appreciate that Alain took the time to answer the question and therefore I marked his answer as answer to the question; however for me the question is not completely answered yet. Seeing that the question already got more than 10 votes, I think it deserves a more extensive answer. Points that could be improved / added are:

  • the argumentation behind the advice (e.g. why UMDF minidriver instead of VHF driver, why to use UWP bluetooth APIs requiring to use cppwinrt instead of simply using the C++ Bluetooth functions that I found in my research, what about writing a GATT Profile driver, etc.). Without that argumentation I won't learn much from the advice.
  • answers to my subquestions
  • examples of using cppwinrt code from a driver and whether it is possible to access those APIs there. Are there any limitations to that (since the code will not be running from an appx)? Cppwinrt is pitched here as something new, but I can't find any documentation of using cppwinrt in the context of a driver.
  • some reflection on my own research - the current answer doesn't touch upon what points I found are good or not. This reflection would help me to understand the topic better.

Update 2

I suppose that Alain recommended a UMDF HID minidriver over VHF because VHF requires writing a KMDF driver. UMDF has the benefits of easier debugging (can be debugged on local pc), less security (and signing) restrictions and no risk of bugchecking a machine when there is a bug in the driver.

Update 3

In order to make it possible to create a client application that injects RadialController events (rather than having to write a driver which is a very high barrier for private developers), I posted a request for it on Feedback Hub. Please consider voting for it if you think that is worth supporting.

like image 624
hansmbakker Avatar asked Aug 19 '17 16:08

hansmbakker


People also ask

How do I fix Bluetooth HID Error Code 10?

Type device manager on the Windows search bar and select device manager. Click on Keyboard to expand, right click on the device and update the driver. For Bluetooth issue, right click on Bluetooth to expand, click on the device and update the driver.

How do I fix my Bluetooth HID error?

Perform a reboot and go to Start > Settings > Update & security > Windows Update > Check for updates to reinstall the driver. 5. Go back to the Device Manager > Click on the Action tab > select "Scan for hardware changes", and check if it will scan and reinstall your microphone driver.

What is i2c HID device driver?

The HID I²C driver enables devices and system manufacturers to reduce the total number of drivers they have to develop to support common device types like keyboards, touchpads, touch screens, sensors, and so on. The HID I²C driver is available on all client SKUs of Windows and is included in WinPE.


1 Answers

The best approach to this would be to create a UMDF HID driver (https://docs.microsoft.com/en-us/windows-hardware/drivers/wdf/creating-umdf-hid-minidrivers) that installs on the bthleenum device node that is created for the device's custom service and use the new Bluetooth LE UWP apis (https://docs.microsoft.com/en-us/uwp/api/windows.devices.bluetooth.genericattributeprofile).

There is some ambiguity about the use of UWP Apis from non store application, but this is incorrect. These Apis are usable in pretty much every conditions. In case you need help setting up your project, here is a C++/UWP sample that can help you get started.

I hope this helps! Alain

like image 63
Alain Avatar answered Oct 01 '22 04:10

Alain