ESP32S3学习——nvs_非易失性存储

芯片：esp32s3

开发环境：espidfv4.4

一、官网相关资料

简介

非易失性存储 (NVS) 库主要用于在 flash 中存储键值格式的数据。本文档将详细介绍 NVS 常用的一些概念。

NVS 最适合存储一些较小的数据，而非字符串或二进制大对象 (BLOB) 等较大的数据。如需存储较大的 BLOB 或者字符串，请考虑使用基于磨损均衡库的 FAT 文件系统。

键值对

NVS 的操作对象为键值对，其中键是 ASCII 字符串，当前支持的最大键长为 15 个字符。值可以为以下几种类型：

• 整数型：uint8_t、int8_t、uint16_t、int16_t、uint32_t、int32_t、uint64_t 和 int64_t；

• 以 0 结尾的字符串；

• 可变长度的二进制数据 (BLOB)

键必须唯一。为现有的键写入新的值可能产生如下结果：

• 如果新旧值数据类型相同，则更新值；

• 如果新旧值数据类型不同，则返回错误。

读取值时也会执行数据类型检查。如果读取操作的数据类型与该值的数据类型不匹配，则返回错误。

命名空间

为了减少不同组件之间键名的潜在冲突，NVS 将每个键值对分配给一个命名空间。命名空间的命名规则遵循键名的命名规则，例如，最多可占 15 个字符。命名空间的名称在调用 nvs_open() 或 nvs_open_from_partition 中指定，调用后将返回一个不透明句柄，用于后续调用 nvs_get_*、nvs_set_* 和 nvs_commit 函数。这样，一个句柄关联一个命名空间，键名便不会与其他命名空间中相同键名冲突。请注意，不同 NVS 分区中具有相同名称的命名空间将被视为不同的命名空间。

二、简单上手

1、nvs_flash_init();：初始化

2、异常处理 if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {

// NVS partition was truncated and needs to be erased

// Retry nvs_flash_init

ESP_ERROR_CHECK(nvs_flash_erase());

err = nvs_flash_init();

}

3、创建句柄:nvs_handle_t my_handle;在nvs_open("storage", NVS_READWRITE, &my_handle);中更新

4.从nvs中读取数据：nvs_get_i32(my_handle, "restart_counter", &restart_counter);

5。向nvs写入数据

分两步：1.err = nvs_set_i32(my_handle, "restart_counter", restart_counter);更新值

2,err = nvs_commit(my_handle);使用返回的句柄提交新值

6、关闭nvs ：nvs_close(my_handle);