zms.h

Go to the documentation of this file.

/* Copyright (c) 2024 BayLibre SAS
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * ZMS: Zephyr Memory Storage
 */
#ifndef ZEPHYR_INCLUDE_FS_ZMS_H_
#define ZEPHYR_INCLUDE_FS_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
 
struct zms_fs {
        off_t offset;
        uint64_t ate_wra;
        uint64_t data_wra;
        uint32_t sector_size;
        uint32_t sector_count;
        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
        uint64_t lookup_cache[CONFIG_ZMS_LOOKUP_CACHE_SIZE];
#endif
};
 
int zms_mount(struct zms_fs *fs);
 
int zms_clear(struct zms_fs *fs);
 
ssize_t zms_write(struct zms_fs *fs, uint32_t id, const void *data, size_t len);
 
int zms_delete(struct zms_fs *fs, uint32_t id);
 
ssize_t zms_read(struct zms_fs *fs, uint32_t id, void *data, size_t len);
 
ssize_t zms_read_hist(struct zms_fs *fs, uint32_t id, void *data, size_t len, uint32_t cnt);
 
ssize_t zms_get_data_length(struct zms_fs *fs, uint32_t id);
 
ssize_t zms_calc_free_space(struct zms_fs *fs);
 
size_t zms_active_sector_free_space(struct zms_fs *fs);
 
int zms_sector_use_next(struct zms_fs *fs);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_FS_ZMS_H_ */