diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index 0d276553..0f2ea4c9 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -51,27 +51,44 @@ If you are reviewing these errors in the GitHub Actions tab, the contents of `-settings_reset-zmk` zip file for the UF2 image. | ![Successful core-coverage Job](../docs/assets/troubleshooting/splitpairing/corecoverage.png) | | :-------------------------------------------------------------------------------------------: | | An example of a successful core-coverage job which will produce a settings_reset firmware. | -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. +#### Reset Split Keyboard Procedure + +Perform the following steps to reset both halves of your split keyboard: + +1. Put each half of the split keyboard into bootloader mode. +1. Flash one of the halves of the split with the downloaded settings reset UF2 image. Immediately after flashing the chosen half, put it into bootloader mode to avoid accidental bonding between the halves. +1. Repeat step 2 with the other half of the split keyboard. +1. Flash the actual image for each half of the split keyboard (e.g `my_board_left.uf2` to the left half, `my_board_right.uf2` to the right half). + +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. ### Connectivity Issues