Browse Source

feat(docs) Clarify Bluetooth profile pairing

xmkb
Michael van Eerd 3 years ago committed by Pete Johanson
parent
commit
05b0353219
  1. 8
      docs/docs/behaviors/bluetooth.md

8
docs/docs/behaviors/bluetooth.md

@ -9,12 +9,12 @@ The bluetooth behavior allows management of various settings and states related
between the keyboard and the host. By default, ZMK supports five "profiles" for selecting which bonded host between the keyboard and the host. By default, ZMK supports five "profiles" for selecting which bonded host
computer/laptop/keyboard should receive the keyboard input; many of the commands here operation on those profiles. computer/laptop/keyboard should receive the keyboard input; many of the commands here operation on those profiles.
:::note Number of Profiles
Please note there are only five available Bluetooth profiles by default. If you need to increase the number of available profiles you can set `CONFIG_BT_MAX_CONN` in your `zmk-config` `.conf` file.
:::
:::note Connection Management :::note Connection Management
When pairing to a host device ZMK saves bond information to the selected profile. It will not replace this when you initiate pairing with another device. To pair with a new device select an unused profile with `BT_SEL`, `BT_NXT` or by clearing an existing profile using `BT_CLR`.
A ZMK device may show as "connected" on multiple hosts at the same time. This is working as intended, and only the host associated with the active profile will receive keystrokes. A ZMK device may show as "connected" on multiple hosts at the same time. This is working as intended, and only the host associated with the active profile will receive keystrokes.
Please note there are only five available Bluetooth profiles by default. If you need to increase the number of available profiles you can set `CONFIG_BT_MAX_CONN` in your `zmk-config` `.conf` file.
::: :::
## Bluetooth Command Defines ## Bluetooth Command Defines

Loading…
Cancel
Save