kb01/zmk
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update dongle configuration for split keyboard support.

Browse source 
Fixes pwr choice config
improves wording
This commit is contained in:
rasmuskoit 2024-08-18 16:14:45 +03:00
parent 344936eb02
commit 0eb377049c
No known key found for this signature in database
GPG key ID: 99709B876A0CD268
1 changed files with 42 additions and 43 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
docs/docs/features/dongle.mdx
View file

@ -26,9 +26,9 @@ Disadvantages:
:::note
Depending on how the dongle is used, there are some additional [latency considerations](./split-keyboards.md#latency-considerations) to keep in mind.
On average, the latency increase is around 3.75ms, in worst case scenario, the latency increase can be up to 7.5ms compared to a unibody keyboard.
:::
## Editing a Keyboard Definition to Support a Dongle
You will modify the [files defining your keyboard](../config/index.md#shield-folder) to support a dongle.
@ -37,7 +37,6 @@ This is done to ensure that backwards compatibility is maintained for users who
### Shield Configuration Files
Start by adding the dongle body to the shield configuration.
```kconfig title="Kconfig.shield"
@ -45,7 +44,6 @@ config SHIELD_MY_KEYBOARD_DONGLE
def_bool $(shields_list_contains,my_keyboard_dongle)
```
Next, add the dongle configuration to your keyboard's `Kconfig.defconfig`.
<Tabs
@ -71,8 +69,9 @@ if SHIELD_MY_KEYBOARD_DONGLE
# Increase the transmit power of the dongle
config BT_CLTR_TX_PWR_PLUS_8
default y
choice BT_CTLR_TX_PWR
default BT_CTLR_TX_PWR_PLUS_8
endchoice
endif
@ -85,7 +84,7 @@ endif
</TabItem>
<TabItem value="split">
Add the following to your `Kconfig.defconfig` file.
Modify the following `Kconfig.defconfig` file to include the dongle in the split keyboard configuration.
```kconfig title="Kconfig.defconfig"
if SHIELD_MY_KEYBOARD_DONGLE || SHIELD_MY_KEYBOARD_LEFT || SHIELD_MY_KEYBOARD_RIGHT
@ -166,10 +165,11 @@ Your keyboard's matrix transform must be both defined and selected under the `ch
```
## Enabling the Dongle
Now it is possible to enable the dongle in the user configuration.
When the above has been implemented in the keyboard definition.
The dongle can be enabled by implementing the following changes in the user config file.
For a split keyboard, change this
@ -185,7 +185,6 @@ For a unibody keyboard, change this
CONFIG_ZMK_SPLIT=y
```
## Building the firmware
Add the appropriate lines to your `build.yml` file to build the firmware for your dongle, in addition to the other parts of your keyboard.
@ -201,10 +200,10 @@ include:
shield: settings_reset
```
:::warning
Before flashing your new firmware, flash the `settings_reset` [UF2 firmware](../troubleshooting/connection-issues.mdx#acquiring-a-reset-uf2) on all devices.
:::
:::note
Any microcontroller with BLE support can be used as a dongle.
:::
:::warning
Before flashing your new firmware, flash the `settings_reset` [UF2 firmware](../troubleshooting/connection-issues.mdx#acquiring-a-reset-uf2) on all devices.
:::