From 2a5b73f294deb2bec220e172eae7b490efac3274 Mon Sep 17 00:00:00 2001 From: Alexander Krikun Date: Thu, 10 Oct 2024 04:35:10 +0400 Subject: docs: document nrf528xx-nosd snippets --- docs/docs/config/system.md | 49 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/docs/docs/config/system.md b/docs/docs/config/system.md index 1a5306bda5..ad719541a3 100644 --- a/docs/docs/config/system.md +++ b/docs/docs/config/system.md @@ -135,3 +135,52 @@ 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 + +:::danger +Using these snippets can erase the SoftDevice on your board. +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. +::: + +[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. + +Enable snippets by adding `snippet: ` to your `build.yaml` for the appropriate board: + +```yaml +- board: nrfmicro_13_52833 + snippet: nrf52833-nosd + shield: corne_left +``` + +For local builds, add `-S ` to your build command. For example: + +```sh +west build -b nrfmicro_13_52833 -S nrf52833-nosd -- -DSHIELD=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. -- cgit v1.2.3