Module storage 

NVS persistent storage for device configuration and crash reports.

Wraps esp-nvs behind a process-wide singleton so the panic handler can persist a crash snapshot even though the FLASH peripheral is consumed at init time. Every operation runs synchronously (no await inside) and is serialized through NVS_BUSY, which lets the panic handler decide in one load whether the flash is safe to touch right now.

Constants

KEY_CFG 🔒

NVS key for the config blob.

KEY_PANIC 🔒

NVS key for the persisted last-panic snapshot.

NS_CONFIG 🔒

NVS namespace for config storage.

NS_DIAG 🔒

NVS namespace for diagnostics.

NVS_OFFSET 🔒

NVS partition offset (default for ESP32-S2).

NVS_SIZE 🔒

NVS partition size (default for ESP32-S2: 24 KiB).

Statics

NVS 🔒

The global handle, set once by init.

NVS_BUSY 🔒

Set while any NVS operation is in flight.

Functions

busy_clear 🔒

Clear the busy flag.

busy_swap 🔒

Atomically set the busy flag and return its previous value.

clear

Clear all config data from NVS (reverts to defaults on next load).

init

Initialize the global NVS handle. Takes ownership of the FLASH peripheral.

load

Load the persisted device configuration.

load_panic 🔒

Load the persisted last-panic snapshot, if any.

persist_panic 🔒

Persist the last-panic snapshot (overwrites the previous one).

save

Save the device configuration to NVS (serialized via postcard).

with_nvs 🔒

Run f against the global handle if storage is up and the flash is idle.

Type Aliases

Storage 🔒

Concrete storage type: NVS on the internal flash.