2ccad46e26
* update modtap to holdtap * Update links * Revert "Update links" This reverts commit 8d0cda7c5a43c84dd18b927cb73672158e4f8abc. * updated docs links update links in docs * Update docs/en/Getting_Started.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/Getting_Started.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * rename modtap.md to holdtap.md * Update Getting_Started.md * Update main.py * Update modtap.py * Update modtap.py and add notice * Update docs/en/porting_to_kmk.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/handwiring.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/contributing.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/contributing.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/ble_hid.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/Getting_Started.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/Getting_Started.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Update docs/en/kmkpython_vs_circuitpython.md Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com> * Rename modtap.md to holdtap.md * fixup --------- Co-authored-by: xs5871 <60395129+xs5871@users.noreply.github.com>
34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# 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 from the
|
|
[Adafruit CircuitPython BLE repository](https://github.com/adafruit/Adafruit_CircuitPython_BLE/tree/master/adafruit_ble).
|
|
It is part of the [Adafruit CircuitPython Bundle](https://github.com/adafruit/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
|
|
|
|
```python
|
|
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](https://learn.adafruit.com/welcome-to-circuitpython/the-circuitpy-drive).
|
|
The second would be to change the keyboard.go() like this.
|
|
|
|
```python
|
|
if __name__ == '__main__':
|
|
keyboard.go(hid_type=HIDModes.BLE, ble_name='KMKeyboard')
|
|
```
|
|
|
|
|