From f8120510865dae009a5598c54ac03e3e8e5106aa Mon Sep 17 00:00:00 2001 From: bluedrink9 Date: Sun, 25 Feb 2024 16:01:51 +1300 Subject: [PATCH] Give example of SPLIT_HAND_MATRIX_GRID usage and wiring --- docs/features/split_keyboard.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/features/split_keyboard.md b/docs/features/split_keyboard.md index 6efa1c2a35c..c9eb298b053 100644 --- a/docs/features/split_keyboard.md +++ b/docs/features/split_keyboard.md @@ -139,6 +139,28 @@ Note that adding a diode at a previously unused intersection will effectively te While `MATRIX_MASKED` isn't necessary to use `SPLIT_HAND_MATRIX_GRID` successfully, without it you may experience issues trying to suspend your computer with your keyboard attached as the matrix will always report at least one key-press. + +For example, suppose you have the following keyboard. + +```c +#define MATRIX_ROW_PINS { D4, C6, D7, E6, B4 } +#define MATRIX_COL_PINS { F4, F5, F6, F7, B1, B3, B2 } + +/* COL2ROW, ROW2COL*/ +#define DIODE_DIRECTION COL2ROW +``` + +IMG_4592 + +You can add a diode to the circuit as below and further configuration as below. + +IMG_4593 + +```c +/* Split hand configration */ +#define SPLIT_HAND_MATRIX_GRID D4,B2 +``` + #### Handedness by EEPROM This method sets the keyboard's handedness by setting a flag in the persistent storage (`EEPROM`). This is checked when the controller first starts up, and determines what half the keyboard is, and how to orient the keyboard layout.