mirror of
https://github.com/eledio-devices/thirdparty-littlefs.git
synced 2025-10-31 08:42:40 +01:00
133 lines
2.8 KiB
C
133 lines
2.8 KiB
C
/*
|
|
* The little filesystem
|
|
*
|
|
* Copyright (c) 2017 Christopher Haster
|
|
* Distributed under the MIT license
|
|
*/
|
|
#ifndef LFS_H
|
|
#define LFS_H
|
|
|
|
#include "lfs_config.h"
|
|
#include "lfs_bd.h"
|
|
|
|
|
|
// Data structures
|
|
enum lfs_error {
|
|
LFS_ERROR_OK = 0,
|
|
LFS_ERROR_CORRUPT = -3,
|
|
LFS_ERROR_NO_ENTRY = -4,
|
|
LFS_ERROR_EXISTS = -5,
|
|
LFS_ERROR_NOT_DIR = -6,
|
|
LFS_ERROR_INVALID = -7,
|
|
LFS_ERROR_NO_SPACE = -8,
|
|
};
|
|
|
|
enum lfs_type {
|
|
LFS_TYPE_REG = 1,
|
|
LFS_TYPE_DIR = 2,
|
|
};
|
|
|
|
enum lfs_open_flags {
|
|
LFS_O_RDONLY = 0,
|
|
LFS_O_WRONLY = 1,
|
|
LFS_O_RDWR = 2,
|
|
LFS_O_CREAT = 0x020,
|
|
LFS_O_EXCL = 0x040,
|
|
LFS_O_TRUNC = 0x080,
|
|
LFS_O_APPEND = 0x100,
|
|
LFS_O_SYNC = 0x200,
|
|
};
|
|
|
|
|
|
|
|
typedef struct lfs_entry {
|
|
lfs_block_t dir[2];
|
|
lfs_off_t off;
|
|
|
|
struct lfs_disk_entry {
|
|
uint16_t type;
|
|
uint16_t len;
|
|
union {
|
|
struct {
|
|
lfs_block_t head;
|
|
lfs_size_t size;
|
|
} file;
|
|
lfs_block_t dir[2];
|
|
} u;
|
|
} d;
|
|
} lfs_entry_t;
|
|
|
|
typedef struct lfs_file {
|
|
lfs_block_t head;
|
|
lfs_size_t size;
|
|
|
|
lfs_block_t wblock;
|
|
uint32_t windex;
|
|
|
|
lfs_block_t rblock;
|
|
uint32_t rindex;
|
|
lfs_off_t roff;
|
|
|
|
struct lfs_entry entry;
|
|
} lfs_file_t;
|
|
|
|
typedef struct lfs_dir {
|
|
lfs_block_t pair[2];
|
|
lfs_off_t off;
|
|
|
|
struct lfs_disk_dir {
|
|
uint32_t rev;
|
|
lfs_size_t size;
|
|
lfs_block_t tail[2];
|
|
|
|
struct lfs_disk_free {
|
|
uint32_t begin;
|
|
uint32_t end;
|
|
} free;
|
|
} d;
|
|
} lfs_dir_t;
|
|
|
|
typedef struct lfs_superblock {
|
|
lfs_block_t pair[2];
|
|
struct lfs_disk_superblock {
|
|
uint32_t rev;
|
|
uint32_t size;
|
|
lfs_block_t root[2];
|
|
char magic[8];
|
|
uint32_t block_size;
|
|
uint32_t block_count;
|
|
} d;
|
|
} lfs_superblock_t;
|
|
|
|
// Little filesystem type
|
|
typedef struct lfs {
|
|
lfs_bd_t *bd;
|
|
const struct lfs_bd_ops *bd_ops;
|
|
|
|
lfs_block_t cwd[2];
|
|
struct lfs_disk_free free;
|
|
|
|
lfs_size_t read_size; // size of read
|
|
lfs_size_t prog_size; // size of program
|
|
lfs_size_t block_size; // size of erase (block size)
|
|
lfs_size_t block_count; // number of erasable blocks
|
|
lfs_size_t words; // number of 32-bit words that can fit in a block
|
|
} lfs_t;
|
|
|
|
// Functions
|
|
int lfs_format(lfs_t *lfs, lfs_bd_t *bd, const struct lfs_bd_ops *bd_ops);
|
|
int lfs_mount(lfs_t *lfs, lfs_bd_t *bd, const struct lfs_bd_ops *bd_ops);
|
|
int lfs_unmount(lfs_t *lfs);
|
|
|
|
int lfs_mkdir(lfs_t *lfs, const char *path);
|
|
|
|
int lfs_file_open(lfs_t *lfs, lfs_file_t *file,
|
|
const char *path, int flags);
|
|
int lfs_file_close(lfs_t *lfs, lfs_file_t *file);
|
|
lfs_ssize_t lfs_file_write(lfs_t *lfs, lfs_file_t *file,
|
|
const void *buffer, lfs_size_t size);
|
|
lfs_ssize_t lfs_file_read(lfs_t *lfs, lfs_file_t *file,
|
|
void *buffer, lfs_size_t size);
|
|
|
|
#endif
|