2016-08-17 15:08:22 +00:00
|
|
|
// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
#ifndef nvs_storage_hpp
|
|
|
|
#define nvs_storage_hpp
|
|
|
|
|
|
|
|
#include <memory>
|
|
|
|
#include <string>
|
|
|
|
#include <unordered_map>
|
|
|
|
#include "nvs.hpp"
|
|
|
|
#include "nvs_types.hpp"
|
|
|
|
#include "nvs_page.hpp"
|
|
|
|
#include "nvs_pagemanager.hpp"
|
|
|
|
|
|
|
|
//extern void dumpBytes(const uint8_t* data, size_t count);
|
|
|
|
|
|
|
|
namespace nvs
|
|
|
|
{
|
|
|
|
|
2017-08-21 09:56:16 +00:00
|
|
|
class Storage : public intrusive_list_node<Storage>
|
2016-08-17 15:08:22 +00:00
|
|
|
{
|
|
|
|
enum class StorageState : uint32_t {
|
|
|
|
INVALID,
|
|
|
|
ACTIVE,
|
|
|
|
};
|
|
|
|
|
|
|
|
struct NamespaceEntry : public intrusive_list_node<NamespaceEntry> {
|
|
|
|
public:
|
|
|
|
char mName[Item::MAX_KEY_LENGTH + 1];
|
|
|
|
uint8_t mIndex;
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef intrusive_list<NamespaceEntry> TNamespaces;
|
|
|
|
|
2018-04-02 10:44:59 +00:00
|
|
|
struct UsedPageNode: public intrusive_list_node<UsedPageNode> {
|
|
|
|
public: Page* mPage;
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef intrusive_list<UsedPageNode> TUsedPageList;
|
|
|
|
|
|
|
|
struct BlobIndexNode: public intrusive_list_node<BlobIndexNode> {
|
|
|
|
public:
|
|
|
|
char key[Item::MAX_KEY_LENGTH + 1];
|
|
|
|
uint8_t nsIndex;
|
|
|
|
uint8_t chunkCount;
|
|
|
|
VerOffset chunkStart;
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef intrusive_list<BlobIndexNode> TBlobIndexList;
|
|
|
|
|
2016-08-17 15:08:22 +00:00
|
|
|
public:
|
|
|
|
~Storage();
|
|
|
|
|
2017-08-21 09:56:16 +00:00
|
|
|
Storage(const char *pName = NVS_DEFAULT_PART_NAME) : mPartitionName(pName) { };
|
|
|
|
|
2016-08-17 15:08:22 +00:00
|
|
|
esp_err_t init(uint32_t baseSector, uint32_t sectorCount);
|
|
|
|
|
2016-11-15 10:24:56 +00:00
|
|
|
bool isValid() const;
|
|
|
|
|
2016-08-17 15:08:22 +00:00
|
|
|
esp_err_t createOrOpenNamespace(const char* nsName, bool canCreate, uint8_t& nsIndex);
|
|
|
|
|
|
|
|
esp_err_t writeItem(uint8_t nsIndex, ItemType datatype, const char* key, const void* data, size_t dataSize);
|
|
|
|
|
|
|
|
esp_err_t readItem(uint8_t nsIndex, ItemType datatype, const char* key, void* data, size_t dataSize);
|
|
|
|
|
|
|
|
esp_err_t getItemDataSize(uint8_t nsIndex, ItemType datatype, const char* key, size_t& dataSize);
|
|
|
|
|
|
|
|
esp_err_t eraseItem(uint8_t nsIndex, ItemType datatype, const char* key);
|
|
|
|
|
|
|
|
template<typename T>
|
|
|
|
esp_err_t writeItem(uint8_t nsIndex, const char* key, const T& value)
|
|
|
|
{
|
|
|
|
return writeItem(nsIndex, itemTypeOf(value), key, &value, sizeof(value));
|
|
|
|
}
|
|
|
|
|
|
|
|
template<typename T>
|
|
|
|
esp_err_t readItem(uint8_t nsIndex, const char* key, T& value)
|
|
|
|
{
|
|
|
|
return readItem(nsIndex, itemTypeOf(value), key, &value, sizeof(value));
|
|
|
|
}
|
|
|
|
|
|
|
|
esp_err_t eraseItem(uint8_t nsIndex, const char* key)
|
|
|
|
{
|
2016-09-22 16:36:53 +00:00
|
|
|
return eraseItem(nsIndex, ItemType::ANY, key);
|
2016-08-17 15:08:22 +00:00
|
|
|
}
|
2016-09-22 16:36:53 +00:00
|
|
|
|
|
|
|
esp_err_t eraseNamespace(uint8_t nsIndex);
|
2016-09-22 13:05:47 +00:00
|
|
|
|
2017-08-21 09:56:16 +00:00
|
|
|
const char *getPartName() const
|
|
|
|
{
|
|
|
|
return mPartitionName;
|
|
|
|
}
|
|
|
|
|
2018-04-02 10:44:59 +00:00
|
|
|
esp_err_t writeMultiPageBlob(uint8_t nsIndex, const char* key, const void* data, size_t dataSize, VerOffset chunkStart);
|
|
|
|
|
|
|
|
esp_err_t readMultiPageBlob(uint8_t nsIndex, const char* key, void* data, size_t dataSize);
|
|
|
|
|
|
|
|
esp_err_t eraseMultiPageBlob(uint8_t nsIndex, const char* key, VerOffset chunkStart = VerOffset::VER_ANY);
|
|
|
|
|
2016-08-22 03:46:44 +00:00
|
|
|
void debugDump();
|
2016-09-22 16:36:53 +00:00
|
|
|
|
2016-08-22 03:46:44 +00:00
|
|
|
void debugCheck();
|
2016-08-17 15:08:22 +00:00
|
|
|
|
2018-02-20 07:11:56 +00:00
|
|
|
esp_err_t fillStats(nvs_stats_t& nvsStats);
|
|
|
|
|
|
|
|
esp_err_t calcEntriesInNamespace(uint8_t nsIndex, size_t& usedEntries);
|
2016-08-17 15:08:22 +00:00
|
|
|
|
|
|
|
protected:
|
|
|
|
|
|
|
|
Page& getCurrentPage()
|
|
|
|
{
|
|
|
|
return mPageManager.back();
|
|
|
|
}
|
|
|
|
|
|
|
|
void clearNamespaces();
|
|
|
|
|
2018-04-02 10:44:59 +00:00
|
|
|
void populateBlobIndices(TBlobIndexList&);
|
|
|
|
|
|
|
|
void eraseOrphanDataBlobs(TBlobIndexList&);
|
|
|
|
|
|
|
|
|
|
|
|
esp_err_t findItem(uint8_t nsIndex, ItemType datatype, const char* key, Page* &page, Item& item, uint8_t chunkIdx = Page::CHUNK_ANY, VerOffset chunkStart = VerOffset::VER_ANY);
|
2016-08-17 15:08:22 +00:00
|
|
|
|
|
|
|
protected:
|
2017-08-21 09:56:16 +00:00
|
|
|
const char *mPartitionName;
|
2016-08-17 15:08:22 +00:00
|
|
|
size_t mPageCount;
|
|
|
|
PageManager mPageManager;
|
|
|
|
TNamespaces mNamespaces;
|
|
|
|
CompressedEnumTable<bool, 1, 256> mNamespaceUsage;
|
|
|
|
StorageState mState = StorageState::INVALID;
|
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace nvs
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#endif /* nvs_storage_hpp */
|