【ESP32-IDF】04-2 存储-NVS

最新推荐文章于 2024-02-17 21:14:26 发布
最新推荐文章于 2024-02-17 21:14:26 发布
阅读量2.1k 收藏 17
点赞数 2
分类专栏： esp32-idf 文章标签： 嵌入式
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_41741344/article/details/116465404
版权

NVS

文章目录

1. NVS

1.1 概述

   NVS全称是非易失性存储。用在flash中以键值对的形成存储数据。

  NVS 适合存储一些小数据，如果对象占用空间比较大，使用负载均衡的fat文件系统

  如果nvs分区被截断，比如更改分区表布局的时候，应该擦除分区内容。可以使用idf.py erase_flash 命令擦除flash上全部的内容

1.2 键值对

  key最大键长为154字符

  value可以使用以下数据类型

  • 整数型：uint8_t、int8_t、uint16_t、int16_t、uint32_t、int32_t、uint64_t 和 int64_t；
  • 以 \0 结尾的字符串；
  • 可变长度的二进制数据 (BLOB)

1.2 命名空间

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

1.3 NVS使用流程

1.3.1 配置分区表

  配置分区表: 我们也可以使用默认的分区表。默认分区表中nvs大小是24k(0x6000),可以根据自己需要对nvs空间进行修改

1.3.2 擦除nvs空间

   如果nvs空间已经满了，或者希望清空原来的数据，就需要执行这一步

nvs_flash_erase()
1.3.3 初始化nvs空间

  nvs 空间使用前要进行初始化


nvs_flash_init();
1.3.4 获取nvs空间的操作句柄

   对nvs空间进行操作的时候，是使用句柄实现的。

  同时，为了尽可能减少键值对的冲突，nvs引入了命名空间的概念，不同命名空间下的key捕获产生冲突。

  同时也要在这里配置对nvs空间进行操作的权限，分为读和读写两种


 nvs_handle_t my_handle;
nvs_open("storage", NVS_READWRITE, &my_handle);
1.3.4 读写nvs空间

  按照不同的数据类型，对数据进行get和set操作

nvs_set_i8(nvs_handle_thandle, const char *key, int8_t value);
nvs_set_u8(nvs_handle_thandle, const char *key, uint8_t value);
nvs_set_i16(nvs_handle_thandle, const char *key, int16_t value);
nvs_set_u16(nvs_handle_thandle, const char *key, uint16_t value);
nvs_set_i32(nvs_handle_thandle, const char *key, int32_t value);
nvs_set_u32(nvs_handle_thandle, const char *key, uint32_t value);
nvs_set_i64(nvs_handle_thandle, const char *key, int64_t value);
nvs_set_u64(nvs_handle_thandle, const char *key, uint64_t value);
nvs_set_str(nvs_handle_thandle, const char *key, const char *value);
nvs_get_blob(nvs_handle_thandle, const char *key, void *out_value, size_t *length);
1.3.4 提交修改

nvs_commit(my_handle); //在修改被提交之前，是不会写入到falsh中的
1.3.5 关闭nvs空间
 nvs_close(my_handle);

2. 使用案例

2.1 单变量操作


/*
 Name:		Sketch1.ino
 Created:	2021/4/12 18:46:05
 Author:	hp
*/



// the setup function runs once when you press reset or power the board



#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_system.h"
#include "nvs_flash.h"
#include "nvs.h"



void setup() {
   
    //01 初始化nvs flash
    esp_err_t err = nvs_flash_init();

    //02 如果nvs flash 满了就清空
    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();
    }
    ESP_ERROR_CHECK(err);

    //03 打开nvs，配置句柄
    printf("\n");
    printf("Opening Non-Volatile Storage (NVS) handle... ");
    nvs_handle my_handle;
    err = nvs_open("storage", NVS_READWRITE, &my_handle);
    if (err != ESP_OK) {
        printf("Error (%s) opening NVS handle!\n", esp_err_to_name(err));
    }
    else {
        printf("Done\n");

        //04 读操作
        printf("Reading restart counter from NVS ... ");
        int32_t restart_counter = 0; // value will default to 0, if not set yet in NVS
        err = nvs_get_i32(my_handle, "restart_counter", &restart_counter);
        switch (err) {
        case ESP_OK:
            printf("Done\n");
            printf("Restart counter = %d\n", restart_counter);
            break;
        case ESP_ERR_NVS_NOT_FOUND:
            printf("The value is not initialized yet!\n");
            break;
        default:
            printf("Error (%s) reading!\n", esp_err_to_name(err));
        }

        //05 写操作
        printf("Updating restart counter in NVS ... ");
        restart_counter++;
        err = nvs_set_i32(my_handle, "restart_counter", restart_counter);
        printf((err != ESP_OK) ? "Failed!\n" : "Done\n");

        //06 提交修改
        printf("Committing updates in NVS ... ");
        err = nvs_commit(my_handle);
        printf((err != ESP_OK) ? "Failed!\n" : "Done\n");

        //07 关闭nvs
        nvs_close(my_handle);
    }

    printf("\n");

    // Restart module
    for (int i = 10; i >= 0; i--) {
        printf("Restarting in %d seconds...\n", i);
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
    printf("Restarting now.\n");
    fflush(stdout);
    esp_restart();
	
}


void loop() {



}

2.2 复杂结构体操作

/*
 Name:		Sketch1.ino
 Created:	2021/4/12 18:46:05
 Author:	hp
*/



// the setup function runs once when you press reset or power the board



#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_system.h"
#include "nvs_flash.h"
#include "nvs.h"

#define NameSpace "store"  //定义命名空间标志
#define BufferSize 20   //定义buffer大小
#define Name "nvs"  //定义要被使用的nvs区域的名称
#define Key "wrt"  //定义键名

typedef  uint32_t DataType; //给数据类型起别名
DataType wrt[5] = { 0,1,2,3,4 }; //用于测试写入的数据
DataType buffer[20]; //用于测试读取的buffer
size_t required_sise; //用于读取数据的时候，说明数据的大小



void setup() {


   //01 初始化分区表命名为nvs的区域
    //如果使用nvs_flash_init 是对所有type为data，subtype为nvs的区域进行初始化操作

      esp_err_t err;  //定义错误标志位
     err=nvs_flash_init_partition(Name);

     if (err == ESP_OK)
     {
         printf("初始化成功\n");


         //02 打开nvs区域，并配置句柄
         nvs_handle my_handle;  //定义句柄
         //这里也是如果使用nvs_open 就会让句柄指向所有type为data，subtype为nvs的区域
         err = nvs_open_from_partition(Name, NameSpace, NVS_READWRITE, &my_handle);

         if (err != ESP_OK)
         {
             printf("打开失败 !\n");
         }
         else
         {

             printf("打开成功\n");

             //03 执行写入操作
             nvs_set_blob(my_handle, Key, wrt, sizeof(wrt));

             //04 确认写入
             //写入操作在进行commit之前，都没有进行真正的执行
             err = nvs_commit(my_handle);
          
             if (err != ESP_OK)
             {
                 printf("写入失败\n");
             }
             else
             {
                 printf("写入成功\n");

                 //05 进行数据的读取
                 //05-1 确定数据的长度
                 //有的时候，我们并不知道要读取的数据要多长，因此要先确认一下长度
                 //对于nvs_get_blob函数，如果输入的length为0，会有0字节的数据被存储到out_value中
                 //不过键key对于的值value的大小，会被写到length中，这样我们就知道了value的长度
                 //如果我们已经提前知道了这个数据的长度，可以直接进行读取，跳过这一步
                 err = nvs_get_blob(my_handle, Key, NULL, &required_sise);
                 if (err != ESP_OK)
                 {
                     printf("数据不存在\n");
                 }
                 else
                 {
                     //05-2 读取数据
                     err = nvs_get_blob(my_handle, Key,buffer, &required_sise);
                     if (err != ESP_OK)
                     {
                         printf("get error %s\n", esp_err_to_name(err));
                     }
                     else
                     {
                         for (int i = 0; i < required_sise / sizeof(DataType); i++)
                         {
                             printf("%d\n", buffer[i]);
                         }
                     }

                 }

                 
                
                
                  
             }
        

          

            
         }
     }
     else
     {
         printf("初始化失败\n");
     }
     
    
}


void loop() {



}

3. 参考资料

[1] 非易失性存储库

Ciaran-byte
关注
  • 2
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
esp-idf-zh:ESP-IDF 中文文档
05-01
ESP-IDF 编程指南 - 中文版 本文档是 ESP-IDF 官方文档的中文翻译版。 在线阅读： 中文版地址： 英文版地址： 参与翻译： 所有的.rst文件和部分的.h文件是需要翻译的源文件。翻译前求务必阅读 。 同时也欢迎修您正在阅读时发现的错误，例如错别字、格式错误等。 关于如何将.rst文件转换成html文件，请参考 。 翻译进度
esp32c3 nvs存取大数组结构体方法
qq_15017779的博客
09-15 1098
esp32c3 nvs存取大数组结构体方法
乐鑫ESP32 NVS读错误BUG：nvs_get_blob
光密信息
11-22 704
ESP32 nvs_get_blob
ESP32 非易失性存储器NVS，实现数据掉电存储（ESP-IDF）
最新发布
weixin_49337111的博客
02-17 1446
NVS即Non-volatile storage，是一种非易失性存储技术，用于在嵌入式系统中保存持久化数据。它主要用于在flash存储器中存储键值格式的数据，提供了一种简单且有效的方法来保存和读取配置信息、状态数据、用户设置等应用程序数据。NVS在设备重新启动或断电后能够恢复状态，因此非常适合保存需要长期存储的数据。
esp32-idf-sqlite3:用于esp-idf（esp32）框架SQLite库
05-08
SQLite3库 概述 使用此库通过SPIFFS / SD卡创建/访问SQLite3数据库文件。 有关更多信息，请参见 安装 使用说明安装ESP-IDF sdk。 将此项目解压缩到esp-idf / components文件夹下。 或者，如果您要在上克隆存储库，使用以下命令将此存储库添加为子模块： git子模块添加组件/ esp32-idf-sqlite3。 使用例子 下载[esp-idf-v4.1.1.zip]（ ）包含子模块并解压缩 cd esp-idf-v4.1.1，使用sudo安装。 git子模块添加组件/ esp32-idf-sqlite3 git子模块添加示例/ esp32-idf-sqlite3-examples cd examples / esp32-idf-sqlite3-examples / spiffs 制作闪光灯 要检查输出，请使用miniterm.
esp-idf-json:ESP-IDF中的JSON序列化和反序列化的示例
05-22
esp-idf-json 使用ESP-IDF进行JSON序列化和反序列化的示例。 ESP-IDF包含cJSON库（版本：1.7.12）。 您可以将JSON组件用作标准组件。 但是文档非常差。 JSON组件的官方文档在。 是Dave Gamble的示例。 如何使用 git clone https://github.com/nopnop2002/esp-idf-json cd esp-idf-json/json-basic make flash monitor
ESP32 通过NVS存储WiFi账号和密码至Flash
weixin_43880799的博客
10-04 3672
在ESP32板子重启之后，自动从Flash中寻找已经存储好的WiFi账号和秘密，连接到网络。要想能够很好的理解如何将WiFi的账号和密码如何写入到Flash的什么地方，首先需要了解下ESP32中Flash的特点。
ESP32专栏八 NVS存储
dingyc_ee的博客
01-16 1080
NVS
ESP32-IDF开发实例-非易失性存储(NVS)数据存取
视觉与物联智能
09-22 1171
非易失性存储(NVS)数据存取 ESP32是一系列高度集成的、专为移动设备、可穿戴电子产品设计的物联网模块，其集成了天线开关、RF balun、功率放大器、低接收噪声放大器，滤波器、电源管理模块等，可以独立运行应用，也可以通过SPI/SDIO或I2C/UART接口为其他设备提供WiFi和蓝牙功能。 在ESP32-IDF中，NVS主要用于将键值对存储在闪存中，并提供了支持NVS操作的库。比如，ESP32的WiFi相关数据就储存在NVS中。 本次实例将实现NVS数据和简单存取。 1、硬件准备 NodeMCU
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的介绍 先来看看官网文.
ESP32S3学习——nvs_非易失性存储
HandBAI的博客
06-23 936
ESP32S3学习——nvs_非易失性存储
ESP-IDF构建自定义组件模板，ESP32
08-23
ESP-IDF构建自定义组件模板，ESP32
esp32-cam-ai-thinker:有关使用ESP-IDF的AI Thinker ESP32-CAM的信息和示例
05-05
ESP32-CAM-AI思想家 该存储库的目的是集中ESP32-CAM AI Thinker的信息和示例。 ESP32-CAM AI Thinker通常与OV2640传感器一起出售 例子 与PlatformIO一起运行 要运行示例，请确保已安装PlatformIO 。 如果还没有的话，请参考。 闪烁的 要求 要刷新开发板，您需要一个USB到TTL加密狗。 使用外部电源也很重要。 USB通常无法提供足够的电流，这会导致电路板环路brownout错误。 接线 接线图 指示 闪烁时： 把板子调低 按住复位按钮（将GPIO0与GND短接） 打开板子 引导以运行草图时，请保持GPIO0打开。 该评估板还具有一个内置的重置按钮。 能力 该评估板和随附的OV2640可以完成以下任务： 外部64MBit PSRAM（ IPUS IPS6404 ） 嵌入式闪光灯 SD卡使用FatFS
ESP8266/ESP32 NVS获取动态长度的数据
SimonLiu的博客
11-08 742
以下代码来自乐鑫官方文档： 非易失性存储库 — ESP-IDF 编程指南 v4.1-dev-802-ga45e99853 文档 // Example (without error checking) of using nvs_get_str to get a string into dynamic array: size_t required_size; nvs_get_str(my_handle...
ESP32 学习笔记（二十六）NVS
InfiniteYuan
04-12 2637
非易失性存储（NVS）库主要用于在闪存中存储键值对。
esp32-idf eclipse 分区表(partition table / NVS)的读写demo
枕上青灯竹书香的博客
01-22 1189
分区表中的 partition table 和 NVS
ESP32学习笔记 -- ESP32-S3使用NVS存储数据
EmbedIoT Studio
05-09 2105
非易失性存储（Non-Volatile Storage）简称NVS，是用来保存一些设备断电后不能丢失的数据，乐鑫的ESP32-S3芯片使用了一套NVS库函数对外置的SPI FLASH进行读、写、擦除等操作。
ESP32-C3入门教程 基础篇（八、NVS — 非易失性存储库的使用）
不浮夸，不将就，认真对待学知识的我们
01-31 8139
前面的7节课把开发板上基本的外设都测试过一边，接下来马上就要进入wifi和蓝牙应用的测试了 在此之前，还需要把掉电数据保存的功能给实现，在STM32中，可以使用内部的flash或者有些自带的EEPROM 在 ESP32-C3 上，使用非易失性存储 (NVS) 库的方式，进行简单数据的掉电保存
ESP32----NVS使用
a3748622的博客
02-28 7346
NVS是什么参考这个：https://blog.csdn.net/xuanze0/article/details/79486512 总的来说，就是非易失性存储，类似MCU EEPROM，但实际上调用ESP32这些函数，数据是存储在FLASH中的。 它的管理方式类似数据库的表，在NVS里面可以存储很多个不同的表，每个表下面有不同的键值，每个键值可以存储8位， 16位，32位...
ESP32-C3， esp-idf 4.3.5，nvs_flash_init函数的讲解
06-01
nvs_flash_init函数是ESP-IDF（ESP32 IoT Development Framework）中的一个重要函数，用于初始化Flash驱动器的非易失性存储（NVS）分区。NVS分区是ESP32中用于存储应用程序参数和配置的重要分区之一。该函数的目的是在ESP32启动时初始化NVS分区，以便应用程序可以访问和写入NVS存储器。以下是nvs_flash_init()函数的详细讲解： 函数原型：esp_err_t nvs_flash_init(void) 函数返回值：esp_err_t类型，如果函数执行成功，则返回ESP_OK，否则返回错误代码 函数功能：该函数用于初始化Flash驱动器的NVS分区。在ESP32启动时，该函数应该被调用一次，以便应用程序可以访问和写入NVS存储器。 函数说明：该函数是ESP-IDF中的一个重要函数，需要在应用程序主函数之前调用。如果未初始化NVS分区，则应用程序将无法访问和写入NVS存储器。在调用该函数之前，需要确保已经初始化了ESP32的Flash驱动器。 函数示例： ``` #include <nvs_flash.h> void app_main(void) { // 初始化Flash驱动器的NVS分区 esp_err_t ret = nvs_flash_init(); if (ret == ESP_OK) { printf("NVS分区初始化成功"); } else { printf("NVS分区初始化失败"); } } ``` 需要注意的是，nvs_flash_init()函数仅需要在ESP32首次启动时调用一次，并且不应该在应用程序的主循环中重复调用该函数。如果应用程序需要重新初始化NVS分区，则可以使用nvs_flash_erase()函数清除NVS分区中的数据，并再次调用nvs_flash_init()函数以重新初始化NVS分区。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值