drashna/qmk_firmware
1
0
Fork 0
Code Activity Actions

[MERGE] Consolidate EE Hands with MASTER_LEFT/RIGHT and simplify behavior (24162)

Browse source
This commit is contained in:
Drashna Jael're 2024-07-20 17:20:01 -07:00
parent 9e7acf446f
commit 70b56b2074
Signed by: drashna
GPG key ID: DBA1FD3A860D1B11
143 changed files with 159 additions and 1220 deletions
Download patch file Download diff file Expand all files Collapse all files

26
docs/features/split_keyboard.md
View file

@ -143,13 +143,6 @@ While `MATRIX_MASKED` isn't necessary to use `SPLIT_HAND_MATRIX_GRID` successful
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.
To enable this method, add the following to your `config.h` file:
```c
#define EE_HANDS
```
Next, you will have to flash the correct handedness option to the controller on each halve. You can do this manually with the following bootloader targets using `qmk flash -kb <keyboard> -km <keymap> -bl <bootloader>` command to flash:
|Microcontroller Type|Bootloader Parameter|
@ -181,25 +174,6 @@ This setting is not changed when re-initializing the EEPROM using the `EE_CLR` k
You can find the `EEPROM` files in the QMK firmware repo, [here](https://github.com/qmk/qmk_firmware/tree/master/quantum/split_common).
#### Handedness by `#define`
You can use this option when USB cable is always connected to just one side of the split keyboard.
If the USB cable is always connected to the right side, add the following to your `config.h` file and flash both sides with this option:
```c
#define MASTER_RIGHT
```
If the USB cable is always connected to the left side, add the following to your `config.h` file and flash both sides with this option:
```c
#define MASTER_LEFT
```
::: tip
If neither options are defined, the handedness defaults to `MASTER_LEFT`.
:::
### Communication Options
Because not every split keyboard is identical, there are a number of additional options that can be configured in your `config.h` file.