2018-10-26 08:00:11 +02:00
|
|
|
# Split Keyboards
|
|
|
|
Split keyboards are mostly the same as unsplit and very easy to adapt a keymap for. Currently
|
|
|
|
UART is supported, though other modes will come later such as Bluetooth and i2c.
|
|
|
|
|
2019-07-13 02:11:36 +02:00
|
|
|
|
|
|
|
## UART
|
|
|
|
To enable uart it's as simple as adding this line, of course changing the pin
|
|
|
|
```python
|
|
|
|
keyboard.split_type = "UART"
|
|
|
|
keyboard.uart_pin = board.SCL
|
|
|
|
```
|
|
|
|
|
|
|
|
## Config
|
2018-10-26 08:00:11 +02:00
|
|
|
Useful config options:
|
|
|
|
```python
|
|
|
|
keyboard.split_flip = True # If your boards are identical but one is flipped, this option is for you
|
2020-09-29 20:39:20 +02:00
|
|
|
keyboard.split_offsets = [6, 6, 6, 6] # This is the how many keys are on each column on the "target" half
|
2018-10-26 08:00:11 +02:00
|
|
|
```
|
|
|
|
|
2019-07-13 02:11:36 +02:00
|
|
|
### EE HANDS
|
2018-10-26 08:00:11 +02:00
|
|
|
If you want to plug in on either side, it can be done fairly easily but requires setup.
|
|
|
|
|
2020-10-13 20:06:05 +02:00
|
|
|
On each half of your keyboard make a file called kmk_side.py and add one of these lines to the file
|
2018-10-26 08:00:11 +02:00
|
|
|
depending on where each piece is physically located.
|
|
|
|
```python
|
2020-09-29 20:39:20 +02:00
|
|
|
split_target = "Left"
|
2018-10-26 08:00:11 +02:00
|
|
|
OR
|
2020-09-29 20:39:20 +02:00
|
|
|
split_target = "Right"
|
2018-10-26 08:00:11 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
and then in your keymap, add the line
|
|
|
|
```python
|
2020-10-13 20:06:05 +02:00
|
|
|
from kmk_side import split_target
|
2018-10-26 08:00:11 +02:00
|
|
|
```
|
|
|
|
|