This page describes the Non-Volatile-Storage (NVS) functions of the machine API. This NVS is used to store settings such as WiFi credentials and your nickname.
The NVS storage is a function of the ESP-IDF which allows for settings to be stored in a special partition on the flash of the ESP32 and is ment for small quantities of data. If you want to store large(er) amounts of data we suggest you use the filesystem functions of MicroPython to store your data on the FAT partition instead.
| Command | Parameters | Description |
|---|---|---|
| nvs_set_u8 | [space], [key], [value] | Store an unsigned 8-bit value |
| nvs_get_u8 | [space], [key] | Retrieve an unsigned 8-bit value |
| nvs_set_u16 | [space], [key[, [value] | Store an unsigned 16-bit value |
| nvs_get_u16 | [space], [key] | Retreive an unsigned 16-bit value |
| nvs_setint | [space], [key], [value] | Store a signed integer value |
| nvs_getint | [space], [key] | Retreive a signed integer value |
| nvs_setstr | [space], [key], [value] | Store a string |
| nvs_getstr | [space], [key] | Retreive a string |
| nvs_erase | [space], [key] | Remove an entry from the NVS |
| nvs_erase_all | [space] | Remove all entries in a space from the NVS |
The following list describes the settings stored by the BADGE.TEAM firmware.
| Space | Key | Type | Function |
|---|---|---|---|
| owner | nickname | string | The nickname of the owner of the badge |
Please use the slug name of your app as the name of the space used to store your settings.
import machine
nickname = machine.nvs_getstr("owner", "name")
print("Your nickname is '{}'!".format(nickname))
import machine
machine.nvs_setstr("owner", "name", "badge.team")