Browse Source

Documented Issue #220

xmkb
kurtis-lew 4 years ago
parent
commit
a58a8412c7
  1. 4
      docs/docs/bond-reset.md
  2. 13
      docs/docs/troubleshooting.md
  3. 1
      docs/sidebars.js

4
docs/docs/bond-reset.md

@ -1,7 +1,7 @@ @@ -1,7 +1,7 @@
---
id: bond-reset
title: Reset BLE Connections
sidebar_label: BLE Reset
title: Reset BLE Connections (DEPRECATED)
sidebar_label: BLE Reset (DEPRECATED)
---
Known as a 'bond reset', each keyboard has a special key combination independent of the user defined key map which will

13
docs/docs/troubleshooting.md

@ -59,3 +59,16 @@ After opening the `<board>.dts.pre.tmp:<line number>` and scrolling down to the @@ -59,3 +59,16 @@ After opening the `<board>.dts.pre.tmp:<line number>` and scrolling down to the
| ![Healthy Keymap Temp](../docs/assets/troubleshooting/keymaps/healthyEDIT.png) |
| :-------------------------------------------------------------------------------: |
| A properly defined keymap with successful compilation. As shown in red, the corrected keycode (`&kp SPC`) references the proper Usage ID defined in the [USB HID Usage Tables](https://www.usb.org/document-library/hid-usage-tables-12)|
### Split Keyboard Halves Unable to Pair
The previous method of pairing split keyboard halves involved a **BLE Reset** with a specific combination of held keys that would remove all bluetooth profile information from the keyboard.
Since then, a much simpler procedure of performing a bluetooth reset for split keyboards has come about, without the need for any file modification:
1. Log into Github and download the "settings clear" UF2 image from latest GH actions from the `main` of ZMK
1. Put both sides into bootloader mode
1. Flash both sides with the "settings clear" UF2 images from step 1. After, put both sides into bootloader mode again.
1. Flash the actual image for each half of the split keyboard
After completing these steps, pair the halves of the split keyboard together by resetting them at the same time. Most commonly, this is done by grounding the reset pins
for each of your keyboard's microcontrollers or pressing the reset buttons at the same time.

1
docs/sidebars.js

@ -6,7 +6,6 @@ module.exports = { @@ -6,7 +6,6 @@ module.exports = {
"faq",
"user-setup",
"customization",
"bond-reset",
"troubleshooting"
],
Features: [

Loading…
Cancel
Save