OVMS3-idf/examples/storage/nvs_rw_blob/README.md

Non-Volatile Storage (NVS) Read and Write Example

(See the README.md file in the upper level 'examples' directory for more information about examples.)

This example demonstrates how to read and write a single integer value and a blob (binary large object) using NVS to preserve them between ESP32 module restarts.

• value - tracks number of ESP32 module soft and hard restarts.
• blob - contains a table with module run times. The table is read from NVS to dynamically allocated RAM. New run time is added to the table on each manually triggered soft restart and written back to NVS. Triggering is done by pulling down GPIO0.

Example also shows how to implement diagnostics if read / write operation was successful.

Detailed functional description of NVS and API is provided in documentation.

If not done already, consider checking simpler example storage/nvs_rw_value, that has been used as a starting point for preparing this one.

How to use example

Hardware required

This example can be run on most common development boards which have an active button connected to GPIO0. On most boards, this button is labeled as "Boot". When pressed, the button connects GPIO0 to ground.

Configure the project

If using Make based build system, run make menuconfig and set serial port under Serial Flasher Options.

If using CMake based build system, no configuration is required.

Build and flash

Build the project and flash it to the board, then run monitor tool to view serial output:

make -j4 flash monitor

Or, for CMake based build system (replace PORT with serial port name):

idf.py -p PORT flash monitor

(To exit the serial monitor, type Ctrl-].)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Example Output

First run:

Restart counter = 0
Run time:
Nothing saved yet!

At this point, press "Boot" button and hold it for a second. The board will perform software restart, printing:

Restarting...

After booting again, restart counter and run time array will be printed:

Restart counter = 1
Run time:
1: 5110

After pressing "Boot" once more:

Restart counter = 2
Run time:
1: 5110
2: 5860

To reset the counter and run time array, erase the contents of flash memory using make erase_flash (or idf.py erase_flash, if using CMake build system), then upload the program again as described above.