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

最新推荐文章于 2025-09-24 20:15:57 发布

原创

最新推荐文章于 2025-09-24 20:15:57 发布 · 1.6k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#单片机 #stm32 #mcu #物联网 #iot

NVS库在ESP32S3中用于存储键值对数据，适合小数据量，不适用于大对象。键值对包括各种整型和字符串，键必须唯一。命名空间减少冲突，每个键值对属于特定命名空间。初始化、读取、写入和异常处理步骤清晰，确保数据安全。

芯片：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)

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

如果新旧值数据类型相同，则更新值；
如果新旧值数据类型不同，则返回错误。</

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

HandBAI

关注关注

0
点赞
踩
7

收藏

觉得还不错? 一键收藏
1
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

(二十）ESP32-S3之NVS

小新的博客

09-11

1048

NVS（Non-volatile storage，非易失存储），意思是掉电后能依然能持久化保存数据。在我们应用 NVS 时，一般用于存储一些配置数据、状态数据等，一般不会用来存储存放大量的数据量。在嵌入式系统中，NVS 主要是在 Flash 进行键值对的存储。举个例子，假设我们要把东西存到 Flash 中，按照底层的操作习惯，我们要先指定一个地址，然后对这个地址执行擦除操作，然后才能写入；读取的时候也需要根据这个地址，然后指定读取长度。

12-ESP32-S3 的 NVS（Non-Volatile Storage）

宁子希的博客

04-19

2123

ESP32-S3 是一款集成了 Wi-Fi 和蓝牙功能的系统级芯片，适用于各种物联网应用。其中，NVS（Non-Volatile Storage，非易失性存储）是 ESP32-S3 的一个重要特性，它允许我们在芯片的闪存中存储和读取数据，即使在断电后，这些数据也不会丢失。

1 条评论您还未登录，请先登录后发表或查看评论

ESP32的NVS

CCPCCH的博客

04-08

1864

非易失性存储 (NVS) 库主要用于在 flash 中存储键值格式的数据。key和value，key相当是文件名（最大15个字节），value是文件内容（最大int64，8个字节）。NVS默认是24kb,page是4kb，entry是NVS最小储存单元（32个字节），一个键值对占一个entry单元（占不满也是一个entry单元）。

ESP32 IDF NVS离线存储

最新发布

m0_73991989的博客

09-24

866

在之前学习桌面小屏幕的时候，发现老师在为了能够使用https修改wifi密码和账号并保证下一次启动mcu能够自动加载wifi使用了一个叫做nvs的离线存储功能。

十九、【ESP32全栈开发指南——NVS(非易失性存储)接口使用】

宁可搬砖百片，不造轮子一边的博客

06-16

1530

ESP32的NVS（非易失性存储）库是专为在SPI Flash中存储键值对数据设计的核心组件。它支持整数、字符串和二进制数据，采用命名空间隔离数据，具有磨损均衡和掉电安全特性。主要API包括初始化（nvs_flash_init）、擦除（nvs_flash_erase）、打开命名空间（nvs_open）和读写操作。适用于存储配置参数、Wi-Fi凭证等中小规模数据，但不适合大文件存储。使用时需注意分区管理，修改分区表后需擦除Flash。

esp32-nvs

TKSY123的博客

05-18

1851

然后，我们使用 strncpy() 函数将新的字符串值写入 my_string 变量，使用 nvs_set_str() 函数将其写入 “my_string” 名称下的 NVS，并使用 nvs_commit() 函数保存更改。您可以使用 nvs_get_xxx() 和 nvs_set_xxx() 系列函数中的各种数据类型来存储您需要的数据，并通过 nvs_commit() 函数将数据更改保存到 NVS。使用 nvs_get_xxx() 系列函数读取 NVS 中的值。用于向 NVS 中写入相应类型的值。

ESP32_NVS操作

th576951469的专栏

05-03

1189

非易失性存储 (NVS) （掉电后可以保存），主要用于在 flash 中存储键值格式的数据。NVS因为无wear leveling技术（平均损耗技术），所以最适合存储一些较小的数据，最好是int类型，而非字符串或二进制大对象 (BLOB) 等较大的数据。如需存储较大的 BLOB 或者字符串，请考虑使用基于磨损均衡库的 FAT 文件系统。

esp32s3数据存储 nvs

m0_73253860的博客

11-02

1172

esp32s3数据存储 nvs

ESP32 开发笔记——NVS

Zs1379111341的博客

06-21

725

nvs_get_str读取数据时容易失败。，重复读取两次并加延时可以避免。

ESP32 非易失性存储器NVS，实现数据掉电存储（ESP-IDF）

weixin_49337111的博客

02-17

5036

NVS即Non-volatile storage，是一种非易失性存储技术，用于在嵌入式系统中保存持久化数据。它主要用于在flash存储器中存储键值格式的数据，提供了一种简单且有效的方法来保存和读取配置信息、状态数据、用户设置等应用程序数据。NVS在设备重新启动或断电后能够恢复状态，因此非常适合保存需要长期存储的数据。

ESP32-NVS存储（非易失性存储库）

努力加油，冲~

07-14

2906

简介　　非易失性存储 (NVS) 库主要用于在 flash 中存储键值格式的数据。底层存储　　NVS 通过调用spi_flash_{read|write|erase}API 对主 flash 的部分空间进行读、写、擦除操作，包括data类型和nvs子类型的所有分区。应用程序可调用nvs_openAPI 选择使用带有nvs标签的分区，也可以通过调用nvs_ope...

乐鑫esp8266学习rtos3.0笔记第3篇：一篇文章带你搞掂存储技术 NVS 的认识和使用，如何利用NVS保存整型、字符串、数组以及结构体。

03-13

乐鑫esp8266学习rtos3.0笔记第3篇：一篇文章带你搞掂存储技术 NVS 的认识和使用，如何利用NVS保存整型、字符串、数组以及结构体。。 - 优快云博客 https://blog.youkuaiyun.com/xh870189248/article/details/88537666

ESP32开发--使用NVS存储数据

热门推荐

啤酒的博客

09-22

1万+

ESP32基础系列 ESP32初体验之环境搭建 ESP32外设学习之GPIO ESP32外设学习之UART ESP32开发之给模块连上网络 ESP32的一键配网与Airkiss配网 ESP32使用NVS存储数据 ESP32一键配网+自动重连 ESP32之Cmake的介绍与组件的添加 ESP32之为配网模式添加按键和指示灯本章目录一.NVS的介绍二.ESP32的分区简单介绍三.NVS存储例程解析四.将例程修改为读写wifi名称和密码一.NVS的介绍先来看看官网文.

ESP32----NVS使用

a3748622的博客

02-28

8196

NVS是什么参考这个：https://blog.youkuaiyun.com/xuanze0/article/details/79486512 总的来说，就是非易失性存储，类似MCU EEPROM，但实际上调用ESP32这些函数，数据是存储在FLASH中的。它的管理方式类似数据库的表，在NVS里面可以存储很多个不同的表，每个表下面有不同的键值，每个键值可以存储8位， 16位，32位...

ESP32-C3入门教程基础篇（八、NVS — 非易失性存储库的使用）

不浮夸，不将就，认真对待学知识的我们

01-31

9736

前面的7节课把开发板上基本的外设都测试过一边，接下来马上就要进入wifi和蓝牙应用的测试了在此之前，还需要把掉电数据保存的功能给实现，在STM32中，可以使用内部的flash或者有些自带的EEPROM 在 ESP32-C3 上，使用非易失性存储 (NVS) 库的方式，进行简单数据的掉电保存

ESP32 通过NVS存储WiFi账号和密码至Flash

weixin_43880799的博客

10-04

4629

在ESP32板子重启之后，自动从Flash中寻找已经存储好的WiFi账号和秘密，连接到网络。要想能够很好的理解如何将WiFi的账号和密码如何写入到Flash的什么地方，首先需要了解下ESP32中Flash的特点。

ESP32 IDF开发驱动篇⑨ 存储NVS的基本应用

lu330274924的博客

11-10

2188

（1）NVS的介绍非易失性存储（Non-volatile storage）简称 NVS，乐鑫使用一套 NVS 库将键值对保存在 SPI flash 中。NVS 库可以使用 read、write、erase 的 API 操作 flash 的一部分，在系统分区表中该库使用 data 类型和 nvs 子类型的所有分区。应用程序可以使用 nvs_open API 选用 nvs 表中的分区或通过nvs_open_from_part API 指定其名称后使用其他分区。注：NVS分区表将在下一章讲解。

ESP32-C3 入门笔记06：存储 API - 非易失性存储库 (NVS) (读/写/删除数据)

Naiva的博客

11-08

2471

初始化 NVS: 初始化非易失性存储（NVS），并确保存储区没有问题（例如需要擦除）。打开 NVS 存储区: 打开"storage"存储区以便进行读写操作。读取数据: 读取存储区中的键的值。如果数据没有找到，则返回默认值 0，并提示用户。写入数据: 更新的值，并写入 NVS 存储区。提交更改: 调用确保所有更改都被写入闪存。关闭 NVS: 关闭存储区，释放资源。重启过程: 模拟设备重启，在重启前倒计时并打印信息，最后调用实际重启设备。

ESP32学习笔记 -- ESP32-S3使用NVS存储数据

EmbedIoT Studio

05-09

3491

非易失性存储（Non-Volatile Storage）简称NVS，是用来保存一些设备断电后不能丢失的数据，乐鑫的ESP32-S3芯片使用了一套NVS库函数对外置的SPI FLASH进行读、写、擦除等操作。

esp32s3数据存储 nvs arduino

02-07

### ESP32-S3 使用 Arduino NVS 存储数据教程 #### 初始化NVS存储模块为了确保能够正常读取和写入非易失性存储器，在程序启动时需要初始化NVS。这一步骤对于任何希望利用NVS功能的应用都是必不可少的。 ```cpp #include <nvs.h> #include <nvs_flash.h> void setup() { Serial.begin(115200); // 初始化NVS闪存 esp_err_t err = nvs_flash_init(); if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) { // 如果NVS分区尚未被擦除，则执行此操作后再尝试重新初始化 ESP_ERROR_CHECK(nvs_flash_erase()); err = nvs_flash_init(); } ESP_ERROR_CHECK(err); // 继续其他设置... } ``` 上述代码展示了如何安全地处理可能遇到的不同错误情况，比如当NVS页面已满或是版本不匹配时采取适当措施[^4]。 #### 向NVS中保存字符串类型的键值对下面的例子说明了怎样把一个简单的字符串保存到指定命名空间下的特定键名处： ```cpp void saveStringToNVS(const char* namespaceName, const char* key, const String& value){ nvs_handle myHandle; esp_err_t err; // 打开或创建一个新的/现有的名称空间用于读写访问权限 err = nvs_open(namespaceName, NVS_READWRITE, &myHandle); if (err != ESP_OK) { Serial.printf("Error (%u) opening NVS handle!\n", err); return; } // 将字符串写入给定的key位置 err = nvs_set_str(myHandle, key, value.c_str()); if (err != ESP_OK) { Serial.printf("Error (%u) writing string to NVS\n", err); } else { // 提交更改至持久化存储区 nvs_commit(myHandle); Serial.println("Data written successfully"); } // 关闭句柄以释放资源 nvs_close(myHandle); } ``` 这段代码实现了向NVS内设定具体名字空间里边的一个字符串型别的条目，并且确认这些改动已经被提交到了永久性的储存区域之中[^1]。 #### 从NVS读回之前存储的信息这里提供了一个函数来检索先前已经存在於相同命名空间内的某个键所对应的值： ```cpp String readStringFromNVS(const char* namespaceName, const char* key){ nvs_handle myHandle; size_t required_size; char *value = NULL; String result; esp_err_t err = nvs_open(namespaceName, NVS_READONLY, &myHandle); if (err != ESP_OK) { Serial.printf("Error (%u) opening NVS handle.\n", err); return ""; } // 获取所需缓冲区大小 err = nvs_get_str(myHandle, key, NULL, &required_size); if (err == ESP_OK && required_size > 0) { value = new char[required_size]; // 实际获取字符串内容 err = nvs_get_str(myHandle, key, value, &required_size); if (err == ESP_OK) { result = String(value); } else { Serial.printf("Error reading from NVS! %d\n", err); } delete[] value; // 清理动态分配的空间 } else { Serial.printf("Failed to determine the length of stored data or no such entry exists."); } nvs_close(myHandle); return result; } ``` 该部分逻辑负责查询并返回由`namespaceName`定义的作用域以及关联着`key`标识符的具体文本串对象；如果找不到对应记录则会给出提示信息。