Bare Metal Zephyr Memory Storage (BM_ZMS)

The BM_ZMS sample demonstrates how to use the Bare Metal ZMS (Zephyr Memory Storage) library to manage key-value pairs, counters, and long arrays in a storage system. It shows how to add, read, and delete items in the storage.

Refer to the Kconfig fragments section for more information on configuration.

Requirements

The sample supports the following development kits:

Simple board variantsMCUboot board variants

The following board variants do not have DFU capabilities:

S115:

Hardware platform	PCA	Board target
nRF54L15 DK	PCA10156	bm_nrf54l15dk/nrf54l15/cpuapp/s115_softdevice
nRF54L15 DK (emulating nRF54L10)	PCA10156	bm_nrf54l15dk/nrf54l10/cpuapp/s115_softdevice
nRF54L15 DK (emulating nRF54L05)	PCA10156	bm_nrf54l15dk/nrf54l05/cpuapp/s115_softdevice
nRF54LM20 DK	PCA10184	bm_nrf54lm20dk/nrf54lm20a/cpuapp/s115_softdevice
nRF54LS05 DK	PCA10214	bm_nrf54ls05dk/nrf54ls05b/cpuapp/s115_softdevice
nRF54LV10 DK	PCA10188	bm_nrf54lv10dk/nrf54lv10a/cpuapp/s115_softdevice

S145:

Hardware platform	PCA	Board target
nRF54L15 DK	PCA10156	bm_nrf54l15dk/nrf54l15/cpuapp/s145_softdevice
nRF54L15 DK (emulating nRF54L10)	PCA10156	bm_nrf54l15dk/nrf54l10/cpuapp/s145_softdevice
nRF54L15 DK (emulating nRF54L05)	PCA10156	bm_nrf54l15dk/nrf54l05/cpuapp/s145_softdevice
nRF54LM20 DK	PCA10184	bm_nrf54lm20dk/nrf54lm20a/cpuapp/s145_softdevice
nRF54LS05 DK	PCA10214	bm_nrf54ls05dk/nrf54ls05b/cpuapp/s145_softdevice
nRF54LV10 DK	PCA10188	bm_nrf54lv10dk/nrf54lv10a/cpuapp/s145_softdevice

Kconfig fragments

By default, the sample uses the SoftDevice storage backend. To configure it for this sample, follow the steps outlined in Configuring and building a sample.

User interface

LED 0:

Lit when the ZMS storage has been successfully initialized by mounting and clearing the storage.

Building and running

This sample can be found under samples/subsys/fs/bm_zms/ in the Bare Metal folder structure.

For details on how to create, configure, and program a sample, see Getting Started with the samples.

Testing

You can test this sample by performing the following steps:

1. Compile and program the application.

2. Observe that the following output is printed:

[00:00:00.012,012] <inf> app: BM_ZMS sample started
[00:00:00.012,033] <inf> nrf_sdh: State change request: enable
[00:00:00.018,839] <inf> bm_zms: 4 Sectors of 1024 bytes
[00:00:00.018,849] <inf> bm_zms: alloc wra: 0, 3c0
[00:00:00.018,856] <inf> bm_zms: data wra: 0, 0
[00:00:00.018,869] <inf> app: ITERATION: 0
[00:00:00.018,892] <inf> app: Adding IP_ADDRESS 172.16.254.1 at id 1
[00:00:00.021,326] <inf> app: Adding key/value at id beefdead
[00:00:00.022,575] <inf> app: Adding counter at id 2
[00:00:00.023,737] <inf> app: Adding Longarray at id 3
[00:00:00.027,990] <inf> bm_zms: 4 Sectors of 1024 bytes
[00:00:00.027,999] <inf> bm_zms: alloc wra: 0, 380
[00:00:00.028,006] <inf> bm_zms: data wra: 0, 90
[00:00:00.028,011] <inf> app: ITERATION: 1
[00:00:00.028,044] <inf> app: ID: 1, IP Address: 172.16.254.1
[00:00:00.028,062] <inf> app: Adding IP_ADDRESS 172.16.254.1 at id 1
[00:00:00.030,471] <inf> app: Id: beefdead
  [00:00:00.030,487] <inf> app: Key:
                              de ad be ef de ad be ef                          |........
[00:00:00.030,491] <inf> app: Adding key/value at id beefdead
[00:00:00.031,723] <inf> app: Id: 2, loop_cnt: 0
[00:00:00.031,729] <inf> app: Adding counter at id 2
[00:00:00.032,926] <inf> app: Id: 3
[00:00:00.032,946] <inf> app: Longarray:
                              00 01 02 03 04 05 06 07  08 09 0a 0b 0c 0d 0e 0f |........ ........
                              10 11 12 13 14 15 16 17  18 19 1a 1b 1c 1d 1e 1f |........ ........
                              20 21 22 23 24 25 26 27  28 29 2a 2b 2c 2d 2e 2f | !"#$%&' ()*+,-./
                              30 31 32 33 34 35 36 37  38 39 3a 3b 3c 3d 3e 3f |01234567 89:;<=>?
                              40 41 42 43 44 45 46 47  48 49 4a 4b 4c 4d 4e 4f |@ABCDEFG HIJKLMNO
                              50 51 52 53 54 55 56 57  58 59 5a 5b 5c 5d 5e 5f |PQRSTUVW XYZ[\]^_
                              60 61 62 63 64 65 66 67  68 69 6a 6b 6c 6d 6e 6f |`abcdefg hijklmno
                              70 71 72 73 74 75 76 77  78 79 7a 7b 7c 7d 7e 7f |pqrstuvw xyz{|}~.
[00:00:00.032,950] <inf> app: Adding Longarray at id 3
[00:00:00.563,183] <err> bm_zms: No space in flash, gc_count 3, sector_count 4
[00:00:00.630,422] <inf> app: Memory is full let's delete all items
[00:00:01.767,151] <inf> app: Free space in storage is 2848 bytes
[00:00:01.767,241] <inf> app: BM_ZMS sample finished Successfully