kmk_firmware/docs/ble_hid.md
Ryan Rotter 1985712637 spelling/capitalization/usage on proper nouns
correct usage sourced from:
  * websites of respective trademark holders
  * Wiktionary
  * Wikipedia
2022-04-25 16:53:22 +00:00

1.2 KiB

BLE HID

Bluetooth connections help clean up the wire mess!

CircuitPython

If not running KMKPython, this does require the adafruit_ble library from Adafruit. This can be downloaded here. It is part of the Adafruit CircuitPython Bundle. Simply put this in the "root" of your CircuitPython device. If unsure, it's the folder with main.py in it, and should be the first folder you see when you open the device.

Enabling BLE

To enable BLE hid, change the keyboard.go(). By default, the advertised name will be the name of the "flash drive". By default this is CIRCUITPY

from kmk.hid import HIDModes

if __name__ == '__main__':
    keyboard.go(hid_type=HIDModes.BLE)

Changing the advertise name

There are two ways to change the advertising name. The first would be to change the name of the drive. The second would be to change the keyboard.go() like this.

if __name__ == '__main__':
    keyboard.go(hid_type=HIDModes.BLE, ble_name='KMKeyboard')