Browse Source

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

xmkb
Nick Winans 4 years ago committed by Pete Johanson
parent
commit
a470353760
  1. 34
      docs/docs/development/new-shield.md

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

@ -91,6 +91,9 @@ endif @@ -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.
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
@ -98,6 +101,9 @@ if SHIELD_MY_BOARD_LEFT @@ -98,6 +101,9 @@ if SHIELD_MY_BOARD_LEFT
config ZMK_KEYBOARD_NAME
default "My Awesome Keyboard Left"
config ZMK_SPLIT_BLE_ROLE_CENTRAL
default y
endif
if SHIELD_MY_BOARD_RIGHT
@ -105,6 +111,16 @@ if SHIELD_MY_BOARD_RIGHT @@ -105,6 +111,16 @@ if SHIELD_MY_BOARD_RIGHT
config ZMK_KEYBOARD_NAME
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
```
@ -265,23 +281,7 @@ For example, a split board called `my_awesome_split_board` would have the follow @@ -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_right.conf` - Configuration elements only affect right half
For proper communication between keyboard halves and that between the central half and the computer,
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.
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.
```
// my_awesome_split_board.conf

Loading…
Cancel
Save