pwarren/zmk_mf68
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs(shield): Add docs based on #510 changes

Browse source
This commit is contained in:
Nick Winans 2021-01-04 12:42:22 -06:00 committed by Pete Johanson
parent e5b1f1e1be
commit a470353760
1 changed files with 17 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

34
docs/docs/development/new-shield.md
View file

@ -91,6 +91,9 @@ endif
``` ```
Similarly to defining the halves of a split board in `Kconfig.shield` it is important to set the `ZMK_KEYBOARD_NAME` for each half of a split keyboard. Similarly to defining the halves of a split board in `Kconfig.shield` it is important to set the `ZMK_KEYBOARD_NAME` for each half of a split keyboard.
You'll also want to set which half is the central side. Most boards set it to the left.
Then on the peripheral half, you'll want to turn USB on so that it shows USB status on displays properly.
Finally, you'll want to turn on the split option for both sides. This can all be seen below.
``` ```
if SHIELD_MY_BOARD_LEFT if SHIELD_MY_BOARD_LEFT
@ -98,6 +101,9 @@ if SHIELD_MY_BOARD_LEFT
config ZMK_KEYBOARD_NAME config ZMK_KEYBOARD_NAME
default "My Awesome Keyboard Left" default "My Awesome Keyboard Left"
config ZMK_SPLIT_BLE_ROLE_CENTRAL
default y
endif endif
if SHIELD_MY_BOARD_RIGHT if SHIELD_MY_BOARD_RIGHT
@ -105,6 +111,16 @@ if SHIELD_MY_BOARD_RIGHT
config ZMK_KEYBOARD_NAME config ZMK_KEYBOARD_NAME
default "My Awesome Keyboard Right" default "My Awesome Keyboard Right"
config USB
default y
endif
if SHIELD_MY_BOARD_LEFT || SHIELD_MY_BOARD_RIGHT
config ZMK_SPLIT
default y
endif endif
``` ```
@ -265,23 +281,7 @@ For example, a split board called `my_awesome_split_board` would have the follow
- `my_awesome_split_board_left.conf` - Configuration elements only affect left half - `my_awesome_split_board_left.conf` - Configuration elements only affect left half
- `my_awesome_split_board_right.conf` - Configuration elements only affect right half - `my_awesome_split_board_right.conf` - Configuration elements only affect right half
For proper communication between keyboard halves and that between the central half and the computer, In most case you'll only need to use the .conf file that affects both halves of a split board. It's used for adding features like deep-sleep or rotary encoders.
the **the central and peripheral halves of the keyboard must be defined**. This can be seen below.
```
// Central Half (Usually the left side: my_awesome_split_board_left.conf)
CONFIG_ZMK_SPLIT=y
CONFIG_ZMK_SPLIT_BLE_ROLE_CENTRAL=y
```
```
// Peripheral Half (Usually the right side: my_awesome_split_board_right.conf)
CONFIG_ZMK_SPLIT=y
```
Using the .conf file that affects both halves of a split board would be for adding features like deep-sleep or rotary encoders.
``` ```
// my_awesome_split_board.conf // my_awesome_split_board.conf