HID Gamepad Client & Central HID Gamepad example

[OstlerDev]

Hello! I have been working on a personal project recently and came across some missing functionality inside of the library. There was no way to connect as a Central role to an HID Gamepad peripheral. I went ahead and implemented it myself closely mirroring the Keyboard support.

This work is related to and extends upon the following old issues and pull requests.

• Please add BLEHID gamepad support and example #228
• Arduino BLE HID Gamepad support #622
• Ble gamepad #688

The testing process I took is as follows:

1. Upload the (newly updated) example at examples/Central/central_hid/central_hid.ino to an Adafruit Feather NRF52840 Express board
2. Upload the example at examples/Peripheral/blehid_gamepad/blehid_gamepad.ino to an Adafruit Feather NRF52840 Express board
3. View each's Serial Console to verify:

• They both fully pair to each other
• The Central feather is able to receive gamepad reports from the Periph feather
• Both polling and callback functionality works from the Central role

I am fairly confident it should be ready to be merged in, however I would greatly appreciate feedback on what to change.

Changelog

Added

• Example for connecting to BLE Gamepads from a Central role
• Support for HID Gamepad Clients in BLEClientHidAdafruit

Changed

• Allow for up to 8 BLE Characteristics inside of BLEDiscovery (This is likely something that will need discussion and feedback on it)
• Add Debug logging to log UUID of all BLE Characteristics for a service inside of BLEDiscovery

[willwade]

+1 for merging this! It looks great

[someburner]

bump- I see no reason to not merge this, works fine!

[OstlerDev]

It would be great to see this merged in! 😸

[hathach]

sorry for late response, I am wrapping other works and will review this as soon as I could. Thank you for your patient.

[hathach]

Perfect ! Thank you very much for the PR, this is spot-on, very clean modification. I have nothing to add. I have tested with central/peripearl gamepad and they are able to connect and send gamepad reprot. Sorry for the huge delay, this somehow falls off my radar.

Note: the hid_gamepad_report_t is specific to the peripheral implementation of gamepad report. For usig with other gamepad, an parser is required to know which report key is for which button. Thank you again.