You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/docs/config/system.md
+49
Original file line number
Diff line number
Diff line change
@@ -135,3 +135,52 @@ Following [split keyboard](../features/split-keyboards.md) settings are defined
135
135
|`CONFIG_ZMK_SPLIT_BLE_PERIPHERAL_STACK_SIZE`| int | Stack size of the BLE split peripheral notify thread | 650 |
136
136
|`CONFIG_ZMK_SPLIT_BLE_PERIPHERAL_PRIORITY`| int | Priority of the BLE split peripheral notify thread | 5 |
137
137
|`CONFIG_ZMK_SPLIT_BLE_PERIPHERAL_POSITION_QUEUE_SIZE`| int | Max number of key state events to queue to send to the central | 10 |
138
+
139
+
## Snippets
140
+
141
+
:::danger
142
+
Using these snippets can erase the SoftDevice on your board.
143
+
Erasing the SoftDevice will prevent the board from using firmware built without these snippets.
144
+
145
+
Flashing such firmware **will** totally brick the board, disabling the USB flashing functionality.
146
+
The only way to restore functionality after that is to re-flash the bootloader.
147
+
148
+
Re-flashing a bootloader built without the SoftDevice will require firmware built with these snippets.
149
+
:::
150
+
151
+
[Snippets](https://docs.zephyrproject.org/3.5.0/build/snippets/index.html) are a way to save common configuration separately when it applies to multiple different applications.
152
+
153
+
Enable snippets by adding `snippet: <snippet>` to your `build.yaml` for the appropriate board:
154
+
155
+
```yaml
156
+
- board: nrfmicro_13_52833
157
+
snippet: nrf52833-nosd
158
+
shield: corne_left
159
+
```
160
+
161
+
For local builds, add `-S <snippet>` to your build command. For example:
162
+
163
+
```sh
164
+
west build -b nrfmicro_13_52833 -S nrf52833-nosd -- -DSHIELD=corne_left
165
+
```
166
+
167
+
ZMK implements the following system configuration snippets:
0 commit comments