Skip to content

Commit

Permalink
docs: document nrf528xx-nosd snippets
Browse files Browse the repository at this point in the history
  • Loading branch information
krikun98 committed Oct 10, 2024
1 parent 4c9087d commit 74f1895
Showing 1 changed file with 50 additions and 0 deletions.
50 changes: 50 additions & 0 deletions docs/docs/config/system.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,3 +135,53 @@ Following [split keyboard](../features/split-keyboards.md) settings are defined
| `CONFIG_ZMK_SPLIT_BLE_PERIPHERAL_STACK_SIZE` | int | Stack size of the BLE split peripheral notify thread | 650 |
| `CONFIG_ZMK_SPLIT_BLE_PERIPHERAL_PRIORITY` | int | Priority of the BLE split peripheral notify thread | 5 |
| `CONFIG_ZMK_SPLIT_BLE_PERIPHERAL_POSITION_QUEUE_SIZE` | int | Max number of key state events to queue to send to the central | 10 |

## Snippets

Snippets are a way to save common configuration separately when it applies to multiple different applications.

More documentation is available from [Zephyr](https://docs.zephyrproject.org/3.5.0/build/snippets/index.html).

Enable snippets with `-S <snippet>` for local builds, for example:

```sh
west build -b nrfmicro_13_52833 -S nrf52833-nosd -- -DSHIELD=corne_left
```

Or by adding `snippet: <snippet>` to your `build.yaml` for the appropriate board:

```yaml
- board: nrfmicro_13_52833
snippet: nrf52833-nosd
shield: corne_left
```
ZMK implements the following system configuration snippets:
### nrf52833-nosd
Definition: [zmk/app/snippets/nrf52833-nosd](https://github.com/zmkfirmware/zmk/blob/main/app/snippets/nrf52833-nosd)
On memory-constrained nRF52833 boards this snippet will extend the code partition to overwrite the Nordic SoftDevice.
This gives 428KB for the code partition as opposed to 280KB with the Nordic SoftDevice.
The added memory allows the nRF52833 to fit displays and other memory-intensive features.
### nrf52840-nosd
Definition: [zmk/app/snippets/nrf52840-nosd](https://github.com/zmkfirmware/zmk/blob/main/app/snippets/nrf52840-nosd)
On nRF52840 boards this snippet will overwrite the Nordic SoftDevice, extending both the code and storage partitions.
This gives 844KB/128KB for the code/storage partitions as opposed to 792KB/32KB with the Nordic SoftDevice.
Firmware built with this snippet can work on boards after accidentally erasing the SoftDevice.
It can also be useful for especially memory-intensive applications.
:::danger
Erasing the SoftDevice will prevent the board from using firmware built without these snippets.
Flashing such firmware **will** totally brick the board, disabling the USB flashing functionality.
The only way to restore functionality after that is to re-flash the bootloader.
Re-flashing a bootloader built without the SoftDevice will require firmware built with these snippets.
:::

0 comments on commit 74f1895

Please sign in to comment.