summaryrefslogtreecommitdiff
path: root/docs/feature_bootmagic.md
diff options
context:
space:
mode:
authorAlbert Y <76888457+filterpaper@users.noreply.github.com>2022-03-15 16:31:17 +0800
committerGitHub <noreply@github.com>2022-03-15 01:31:17 -0700
commit9aaf4a5a9b19f1e2a12c3f2508e2083f7ec58bec (patch)
treed4de6d9e89fc926122d509db0e7bcd353c919ef0 /docs/feature_bootmagic.md
parent92a9e7c50b8577e76f2bee9719b344af0e639494 (diff)
Add split keyboard example for Bootmagic Lite (#16349)
* Add split keyboard example for bootmagic lite * Add handedness link * Edit sentence structure * Apply suggested language correction
Diffstat (limited to 'docs/feature_bootmagic.md')
-rw-r--r--docs/feature_bootmagic.md27
1 files changed, 24 insertions, 3 deletions
diff --git a/docs/feature_bootmagic.md b/docs/feature_bootmagic.md
index 6b3c7e45fd..4239cdfd2a 100644
--- a/docs/feature_bootmagic.md
+++ b/docs/feature_bootmagic.md
@@ -23,14 +23,35 @@ And to trigger the bootloader, you hold this key down when plugging the keyboard
## Split Keyboards
-When handedness is predetermined via an option like `SPLIT_HAND_PIN`, you might need to configure a different key between halves. To do so, add these entries to your `config.h` file:
+When [handedness](feature_split_keyboard.md#setting-handedness) is predetermined via options like `SPLIT_HAND_PIN` or `EE_HANDS`, you might need to configure a different key between halves. To identify the correct key for the right half, examine the split key matrix defined in the `<keyboard>.h` file, e.g.:
+
+```c
+#define LAYOUT_split_3x5_2( \
+ L01, L02, L03, L04, L05, R01, R02, R03, R04, R05, \
+ L06, L07, L08, L09, L10, R06, R07, R08, R09, R10, \
+ L11, L12, L13, L14, L15, R11, R12, R13, R14, R15, \
+ L16, L17, R16, R17 \
+ ) \
+ { \
+ { L01, L02, L03, L04, L05 }, \
+ { L06, L07, L08, L09, L10 }, \
+ { L11, L12, L13, L14, L15 }, \
+ { L16, L17, KC_NO, KC_NO, KC_NO }, \
+ { R01, R02, R03, R04, R05 }, \
+ { R06, R07, R08, R09, R10 }, \
+ { R11, R12, R13, R14, R15 }, \
+ { R16, R17, KC_NO, KC_NO, KC_NO } \
+ }
+```
+
+If you pick the top right key for the right half, it is `R05` on the top layout. Within the key matrix below, `R05` is located on row 4 columnn 4. To use that key as the right half's Bootmagic Lite trigger, add these entries to your `config.h` file:
```c
#define BOOTMAGIC_LITE_ROW_RIGHT 4
-#define BOOTMAGIC_LITE_COLUMN_RIGHT 1
+#define BOOTMAGIC_LITE_COLUMN_RIGHT 4
```
-By default, these values are not set.
+?> These values are not set by default.
## Advanced Bootmagic Lite