Super-2024-Swadge-FW/hdw-nvs_8h_source.html

#ifndef _NVS_MANAGER_H_

#define _NVS_MANAGER_H_


#include <stdbool.h>

#include <stdint.h>

#include <stddef.h>


#include "nvs.h"


//==============================================================================

// Defines

//==============================================================================


#define NVS_PART_NAME_MAX_SIZE 16

#define NVS_KEY_NAME_MAX_SIZE  16

#define NVS_NAMESPACE_NAME     "storage"

//==============================================================================

// Function Prototypes

//==============================================================================


bool initNvs(bool firstTry);

bool deinitNvs(void);

bool eraseNvs(void);

bool readNvs32(const char* key, int32_t* outVal);

bool writeNvs32(const char* key, int32_t val);

bool readNamespaceNvs32(const char* namespace, const char* key, int32_t* outVal);

bool writeNamespaceNvs32(const char* namespace, const char* key, int32_t val);

bool readNvsBlob(const char* key, void* out_value, size_t* length);

bool writeNvsBlob(const char* key, const void* value, size_t length);

bool readNamespaceNvsBlob(const char* namespace, const char* key, void* out_value, size_t* length);

bool writeNamespaceNvsBlob(const char* namespace, const char* key, const void* value, size_t length);

bool eraseNvsKey(const char* key);

bool eraseNamespaceNvsKey(const char* namespace, const char* key);

bool readNvsStats(nvs_stats_t* outStats);

bool readAllNvsEntryInfos(nvs_stats_t* outStats, nvs_entry_info_t* outEntryInfos, size_t* numEntryInfos);

bool readNamespaceNvsEntryInfos(const char* namespace, nvs_stats_t* outStats, nvs_entry_info_t* outEntryInfos,

                                size_t* numEntryInfos);

bool nvsNamespaceInUse(const char* namespace);

#endif

eraseNamespaceNvsKey
bool eraseNamespaceNvsKey(const char *namespace, const char *key)
Delete the value with the given key from NVS.
Definition hdw-nvs.c:485

eraseNvsKey
bool eraseNvsKey(const char *key)
Delete the value with the given key from NVS.
Definition hdw-nvs.c:473

readNamespaceNvs32
bool readNamespaceNvs32(const char *namespace, const char *key, int32_t *outVal)
Read a 32 bit value from NVS with a given string key.
Definition hdw-nvs.c:166

readAllNvsEntryInfos
bool readAllNvsEntryInfos(nvs_stats_t *outStats, nvs_entry_info_t *outEntryInfos, size_t *numEntryInfos)
Read info about each used entry in the default NVS namespace. Typically, this should be called once w...
Definition hdw-nvs.c:585

readNvsStats
bool readNvsStats(nvs_stats_t *outStats)
Read info about used memory in NVS.
Definition hdw-nvs.c:554

readNamespaceNvsBlob
bool readNamespaceNvsBlob(const char *namespace, const char *key, void *out_value, size_t *length)
Read a blob from NVS with a given string key. Typically, this should be called once with NULL passed ...
Definition hdw-nvs.c:337

writeNamespaceNvsBlob
bool writeNamespaceNvsBlob(const char *namespace, const char *key, const void *value, size_t length)
Write a blob to NVS with a given string key.
Definition hdw-nvs.c:405

writeNvs32
bool writeNvs32(const char *key, int32_t val)
Write a 32 bit value to NVS with a given string key.
Definition hdw-nvs.c:153

eraseNvs
bool eraseNvs(void)
Erase and re-initialize the nonvolatile storage.
Definition hdw-nvs.c:101

readNvsBlob
bool readNvsBlob(const char *key, void *out_value, size_t *length)
Read a blob from NVS with a given string key. Typically, this should be called once with NULL passed ...
Definition hdw-nvs.c:307

readNvs32
bool readNvs32(const char *key, int32_t *outVal)
Read a 32 bit value from NVS with a given string key.
Definition hdw-nvs.c:141

deinitNvs
bool deinitNvs(void)
Deinitialize NVS.
Definition hdw-nvs.c:91

readNamespaceNvsEntryInfos
bool readNamespaceNvsEntryInfos(const char *namespace, nvs_stats_t *outStats, nvs_entry_info_t *outEntryInfos, size_t *numEntryInfos)
Read info about each used entry in a specific NVS namespace. Typically, this should be called once wi...
Definition hdw-nvs.c:603

writeNvsBlob
bool writeNvsBlob(const char *key, const void *value, size_t length)
Write a blob to NVS with a given string key.
Definition hdw-nvs.c:320

nvsNamespaceInUse
bool nvsNamespaceInUse(const char *namespace)
Quickly return whether or not any entries exist in a given NVS namespace.
Definition hdw-nvs.c:652

initNvs
bool initNvs(bool firstTry)
Initialize the nonvolatile storage.
Definition hdw-nvs.c:34

writeNamespaceNvs32
bool writeNamespaceNvs32(const char *namespace, const char *key, int32_t val)
Write a 32 bit value to NVS with a given string key.
Definition hdw-nvs.c:234