mirror of
https://github.com/eledio-devices/thirdparty-littlefs.git
synced 2025-10-31 16:14:16 +01:00
789286a257
Before, the lfs had multiple paths to determine config options: - lfs_config struct passed during initialization - lfs_bd_info struct passed during block device initialization - compile time options This allowed different developers to provide their own needs to the filesystem, such as the block device capabilities and the higher level user's own tweaks. However, this comes with additional complexity and action required when the configurations are incompatible. For now, this has been reduced to all information (including block device function pointers) being passed through the lfs_config struct. We just defer more complicated handling of configuration options to the top level user. This simplifies configuration handling and gives the top level user the responsibility to handle configuration, which they probably would have wanted to do anyways.
79 lines
1.7 KiB
C
79 lines
1.7 KiB
C
/*
|
|
* Block device emulated on standard files
|
|
*
|
|
* Copyright (c) 2017 Christopher Haster
|
|
* Distributed under the MIT license
|
|
*/
|
|
#ifndef LFS_EMUBD_H
|
|
#define LFS_EMUBD_H
|
|
|
|
#include "lfs.h"
|
|
#include "lfs_util.h"
|
|
|
|
|
|
// Config options
|
|
#ifndef LFS_EMUBD_READ_SIZE
|
|
#define LFS_EMUBD_READ_SIZE 1
|
|
#endif
|
|
|
|
#ifndef LFS_EMUBD_PROG_SIZE
|
|
#define LFS_EMUBD_PROG_SIZE 1
|
|
#endif
|
|
|
|
#ifndef LFS_EMUBD_ERASE_SIZE
|
|
#define LFS_EMUBD_ERASE_SIZE 512
|
|
#endif
|
|
|
|
#ifndef LFS_EMUBD_TOTAL_SIZE
|
|
#define LFS_EMUBD_TOTAL_SIZE 524288
|
|
#endif
|
|
|
|
|
|
// The emu bd state
|
|
typedef struct lfs_emubd {
|
|
char *path;
|
|
char *child;
|
|
|
|
struct {
|
|
uint64_t read_count;
|
|
uint64_t prog_count;
|
|
uint64_t erase_count;
|
|
} stats;
|
|
|
|
struct {
|
|
uint32_t read_size;
|
|
uint32_t prog_size;
|
|
uint32_t block_size;
|
|
uint32_t block_count;
|
|
} cfg;
|
|
} lfs_emubd_t;
|
|
|
|
|
|
// Create a block device using path for the directory to store blocks
|
|
int lfs_emubd_create(const struct lfs_config *cfg, const char *path);
|
|
|
|
// Clean up memory associated with emu block device
|
|
void lfs_emubd_destroy(const struct lfs_config *cfg);
|
|
|
|
// Read a block
|
|
int lfs_emubd_read(const struct lfs_config *cfg, lfs_block_t block,
|
|
lfs_off_t off, lfs_size_t size, void *buffer);
|
|
|
|
// Program a block
|
|
//
|
|
// The block must have previously been erased.
|
|
int lfs_emubd_prog(const struct lfs_config *cfg, lfs_block_t block,
|
|
lfs_off_t off, lfs_size_t size, const void *buffer);
|
|
|
|
// Erase a block
|
|
//
|
|
// A block must be erased before being programmed. The
|
|
// state of an erased block is undefined.
|
|
int lfs_emubd_erase(const struct lfs_config *cfg, lfs_block_t block);
|
|
|
|
// Sync the block device
|
|
int lfs_emubd_sync(const struct lfs_config *cfg);
|
|
|
|
|
|
#endif
|