zms.h

Go to the documentation of this file.

/* Copyright (c) 2018 Laczen
 * Copyright (c) 2024 BayLibre SAS
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * ZMS: Zephyr Memory Storage
 */

 
#ifndef ZEPHYR_INCLUDE_KVSS_ZMS_H_
#define ZEPHYR_INCLUDE_KVSS_ZMS_H_
 
#include <sys/types.h>
#include <zephyr/drivers/flash.h>
#include <zephyr/kernel.h>
#include <zephyr/device.h>
#include <zephyr/toolchain.h>
 
#ifdef __cplusplus
extern "C" {
#endif



enum zms_mount_flags {
        ZMS_MOUNT_FLAG_NO_FORMAT = BIT(0),
};

struct zms_fs {
        off_t offset;
        uint64_t ate_wra;
        uint64_t data_wra;
        uint32_t sector_size;
        uint32_t sector_count;
        uint32_t mount_flags;
        uint8_t sector_cycle;
        bool ready;
        struct k_mutex zms_lock;
        const struct device *flash_device;
        const struct flash_parameters *flash_parameters;
        size_t ate_size;
#if CONFIG_ZMS_LOOKUP_CACHE
#if CONFIG_ZMS_LOOKUP_CACHE_MANUAL
        uint64_t *lookup_cache;
        size_t lookup_cache_size;
#else
        uint64_t lookup_cache[CONFIG_ZMS_LOOKUP_CACHE_SIZE];
#endif
#endif
};



#if CONFIG_ZMS_ID_64BIT
typedef uint64_t zms_id_t;
#else
typedef uint32_t zms_id_t;
#endif

int zms_mount(struct zms_fs *fs);

int zms_mount_force(struct zms_fs *fs);

int zms_clear(struct zms_fs *fs);

ssize_t zms_write(struct zms_fs *fs, zms_id_t id, const void *data, size_t len);

int zms_delete(struct zms_fs *fs, zms_id_t id);

ssize_t zms_read(struct zms_fs *fs, zms_id_t id, void *data, size_t len);

ssize_t zms_read_hist(struct zms_fs *fs, zms_id_t id, void *data, size_t len, uint32_t cnt);

ssize_t zms_get_data_length(struct zms_fs *fs, zms_id_t id);

ssize_t zms_calc_free_space(struct zms_fs *fs);

ssize_t zms_active_sector_free_space(struct zms_fs *fs);

int zms_sector_use_next(struct zms_fs *fs);
 
#if CONFIG_ZMS_LOOKUP_CACHE_MANUAL
int zms_set_lookup_cache(struct zms_fs *fs, uint64_t *buffer, size_t size);
#endif

int zms_get_num_cycles(struct zms_fs *fs, uint32_t *cycles);

int zms_get_sector_num_cycles(struct zms_fs *fs, uint32_t sector, uint32_t *cycles);

 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_KVSS_ZMS_H_ */