gitbot/qmk_firmware
0
0
Fork 0
mirror of https://github.com/qmk/qmk_firmware.git synced 2025-07-22 15:42:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

Give example of SPLIT_HAND_MATRIX_GRID usage and wiring

Browse Source
This commit is contained in:
bluedrink9 2024-02-25 16:01:51 +13:00
parent 260e9a546e
commit f812051086
1 changed files with 22 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/features/split_keyboard.md
View File

@ -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 alt="IMG_4592" width="1389" src="https://private-user-images.githubusercontent.com/2170248/302690105-8172daba-ce51-44bf-87e8-3003b9dfdf57.PNG?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MDg4MzAwOTgsIm5iZiI6MTcwODgyOTc5OCwicGF0aCI6Ii8yMTcwMjQ4LzMwMjY5MDEwNS04MTcyZGFiYS1jZTUxLTQ0YmYtODdlOC0zMDAzYjlkZmRmNTcuUE5HP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDIyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDAyMjVUMDI1NjM4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MWQzZTBmOTdhOWM5OGI1NjdlMmU1NTBjY2NiODU1ZmYzZmYwMDA3NGQ4M2FkNDkzNTIwMTk3NTJmNGRiMDhlMyZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.FHPKAjiecrzeVfnqJ7NUlA08M4Xus4oJ_vp6iD2B7IM">
You can add a diode to the circuit as below and further configuration as below.
<img alt="IMG_4593" width="1389" src="https://private-user-images.githubusercontent.com/2170248/302690284-109ea260-0633-4404-901f-7931384d3782.PNG?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MDg4MzAwOTgsIm5iZiI6MTcwODgyOTc5OCwicGF0aCI6Ii8yMTcwMjQ4LzMwMjY5MDI4NC0xMDllYTI2MC0wNjMzLTQ0MDQtOTAxZi03OTMxMzg0ZDM3ODIuUE5HP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDIyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDAyMjVUMDI1NjM4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MTRlOGYxYTlkNWNlZTFhYmE5N2VhZjQzMTljOGRiYzdmYTYzZTMyZDJiNmU5NDYzMTYwYzkzODdiOTQ1YTdhYiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.OGFeGDN5wNomA5J4-YSkaz0ubzbOHp5ZW8A_Fnwfu1E">
```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.