smallin/my_nvs

readme

# MyNVS 组件

- MyNVS组件通过过封装 ESP-IDF 的 NVS API，提供了更易用且线程安全的接口来操作 ESP32 的非易失性存储(NVS)。

提供了一个相对统一的API来操作 ESP32 的非易失性存储(NVS)。通过封装 ESP-IDF 的 NVS API，提供了更易用且线程安全的接口包含一个管理器来高效管理多个命名空间的访问。它。

## 目录

- [主要特性](#主要特性)
- [API参考](#API参考)
- [使用例程](#使用例程)
- [注意事件](#注意事项)
- [配置选项](#配置选项)
- [依赖](#依赖)
- [许可](#许可)

## 主要特性

- **支持更多数据类型**
    1. 原生数据：```int8_t int16_t int32_t int64_t uint8_t uint16_t uint32_t uint64_t、字符串、blob```
    2. 扩展支持：```bool int long float double std::string```
- **统一的操作API**
    1. 读写操作统一使用read/write方法完成
- **线程操作安全**
    1. 通过线程锁std::lock保证同一时间单线程操作
    2. 命名空间管理，支持并行操作同一命名空间
- **自动提交**
    1. 在关闭命名空间时，自动提交更改
    2. 提供手动提交方法
- **错误处理**
    1. 所有方法返回原生API相同的错误代码，方便处理故障
    2. 操作失败时返回详细的日志

## API参考
- 读写类
```
esp_err_t read(TYPE1 key, TYPE2 value);
esp_err_t read(TYPE2 key, void* value, size_t* length);
esp_err_t write(TYPE1 key, TYPE3 value);
esp_err_t write(TYPE2 key, const void* value, size_t* length);


/*
 * TYPE1：const char*、const std::string&
 * TYPE2：支持更多数据类型中数据类型的引用、指针版本
 * TYPE3：支持更多数据类型中数据类型的引用
 */

```
- 查找
```
esp_err_t find(const char* key);
esp_err_t find(const std::string& key);
esp_err_t find(const char* key, nvs_type_t* out_type);
esp_err_t find(const std::string& key, nvs_type_t* out_type);
```
- 删除提交
```
esp_err_t erase_key(const char* key);
esp_err_t erase_key(const std::string& key);
esp_err_t erase_all();
esp_err_t commit();
```

## 使用例程
```
extern "C" void app_main()
{
    bool flag = true;
    char ch = 'a';
    int a = 32;
    long b = 43L;
    float c = 32.1;
    double d = 22.001;
    MyNVS nvs("test", NVS_READWRITE);
    nvs.write("flag", flag);
    nvs.write("ch", ch);
    nvs.write("a", a);
    nvs.write("b", b);
    nvs.write("c", c);
    nvs.write("d", d);

    bool f = false;
    char ch1 = 'z';
    int a1 = 10;
    long b1 = 7;
    float c1 = 0.0;
    double d1 = 0.0;
    nvs.read("flag", f);
    nvs.read("ch", ch1);
    nvs.read("a", a1);
    nvs.read("b", b1);
    nvs.read("c", c1);
    nvs.read("d", d1);

    ESP_LOGE(TAG, "flag=%d,ch=%c,a=%d,b=%ld,c1=%f,d1=%lf,c=%f,d=%lf",f,ch1,a1,b1,c1,d1,c,d);
}
```

## 注意事项
1. 不应当再进行```nvs_flash_init()```初始化操作；
2. 浮点类型存在精度问题，请慎用；

## 配置选项
- 在menuconfig中配置最大命名空间数量及特性
```
Component config -> MyNVS 组件配置 -> 
    (4) 操作名字空间数量
    [ ] 初始化NVS时，遇到没有空闲页面自动进行擦除
    [*] 初始化NVS时，发现新版本格式自动进行擦除
```
## 依赖
- ESP-IDF 5.4+（其他版本未测试）
- C++ 20标准

## 许可
- Licenses: Aapche 2.0 
- Copyright: samllin