EspNvs.h

Go to the documentation of this file.

 
#pragma once
 
#include "BaseNvs.h"
#include "PlatformMutex.h"          // Thread-safe mutex support if enabled
#include "utils/EspTypes_NVS.h" // Centralized ESP32 NVS type definitions
#include <cstdint>
 
// ESP32-C6 NVS abstracted types for portability
 
class EspNvs : public BaseNvs {
public:
  explicit EspNvs(const char* namespace_name) noexcept;
 
  ~EspNvs() noexcept override;
 
  //==============================================//
  // OVERRIDDEN PURE VIRTUAL FUNCTIONS            //
  //==============================================//
 
  hf_nvs_err_t Initialize() noexcept override;
 
  hf_nvs_err_t Deinitialize() noexcept override;
 
  hf_nvs_err_t SetU32(const char* key, hf_u32_t value) noexcept override;
 
  hf_nvs_err_t GetU32(const char* key, hf_u32_t& value) noexcept override;
 
  hf_nvs_err_t SetString(const char* key, const char* value) noexcept override;
 
  hf_nvs_err_t GetString(const char* key, char* buffer, size_t buffer_size,
                         size_t* actual_size = nullptr) noexcept override;
 
  hf_nvs_err_t SetBlob(const char* key, const void* data, size_t data_size) noexcept override;
 
  hf_nvs_err_t GetBlob(const char* key, void* buffer, size_t buffer_size,
                       size_t* actual_size = nullptr) noexcept override;
 
  hf_nvs_err_t EraseKey(const char* key) noexcept override;
 
  hf_nvs_err_t Commit() noexcept override;
 
  bool KeyExists(const char* key) noexcept override;
 
  hf_nvs_err_t GetSize(const char* key, size_t& size) noexcept override;
 
  const char* GetDescription() const noexcept override;
 
  size_t GetMaxKeyLength() const noexcept override;
 
  size_t GetMaxValueSize() const noexcept override;
 
  //==============================================//
  // STATISTICS AND DIAGNOSTICS                   //
  //==============================================//
 
  hf_nvs_err_t GetStatistics(hf_nvs_statistics_t& statistics) const noexcept override;
 
  hf_nvs_err_t GetDiagnostics(hf_nvs_diagnostics_t& diagnostics) const noexcept override;
 
private:
  //==============================================//
  // PRIVATE HELPER FUNCTIONS                     //
  //==============================================//
 
  hf_nvs_err_t ConvertMcuError(int mcu_error) const noexcept;
 
  void UpdateStatistics(bool error_occurred) noexcept;
 
  bool IsValidKey(const char* key) const noexcept;
 
  //==============================================//
  // PRIVATE MEMBER VARIABLES                     //
  //==============================================//
 
  void* nvs_handle_;            
  mutable int last_error_code_; 
 
  // Statistics and performance monitoring
  mutable hf_nvs_statistics_t statistics_;   
  mutable hf_nvs_diagnostics_t diagnostics_; 
 
  // Thread safety
  mutable PlatformMutex mutex_; 
};