[----            32             ----]
[1|--  11   --|--  10  --|--  10  --]
 ^.     ^     .     ^          ^- length
 |.     |     .     '------------ id
 |.     '-----.------------------ type (type3)
 '.-----------.------------------ valid bit
  [-3-|-- 8 --]
    ^     ^- chunk
    '------- type (type1)

tag                          data
[--      32      --][--      32      --|--      32      --]
[1|- 11 -| 10 | 10 ][--      32      --|--      32      --]
 ^    ^     ^    ^            ^                  ^- file size
 |    |     |    |            '-------------------- file head
 |    |     |    '- size (8)
 |    |     '------ id
 |    '------------ type (0x202)
 '----------------- valid bit

typedef struct lfs_superblock {
    uint32_t version;           // littlefs版本
    lfs_size_t block_size;      // 一個塊的大小
    lfs_size_t block_count;     // 文件系統中塊的總數
    lfs_size_t name_max;        // 文件名字節數的最大值
    lfs_size_t file_max;        // 文件大小字節數的最大值
    lfs_size_t attr_max;        // 文件屬性字節數的最大值
} lfs_superblock_t;

typedef struct lfs_mdir {
    lfs_block_t pair[2];    // 元數據對塊指針
    uint32_t rev;           // revision count

    // 當前在元數據塊中的偏移
    // 用于commit和fetch相關函數
    // 作為起始偏移傳入，結束時保存了寫入后的偏移
    lfs_off_t off;

    // entry tag，用于記錄當前的ptag
    // ptag用于commit過程中計算異或tag、計算CRC等，見commit機制和tag的遍歷
    // 當fetch時，fetch到一個commit時，會將計算的ptag存入etag
    // 當進行commit時，ptag就可以初始化為etag
    uint32_t etag;

    uint16_t count;         // 目錄中屬性數量（文件、子目錄數）

    // 表示下一個commit是否寫入完成
    // 用于commit和fetch相關函數，見commit機制和tag的遍歷
    // 當fetch時，fetch到末尾還未匹配，會把erased置為true
    // 在commit函數中，只有erased為true才進行commit
    bool erased;

    bool split;             // 表示當前目錄塊后面是否還有塊，為false時表示末尾

    // 表示當前目錄塊中最后一個TAIL
    // 既可能是HARDTAIL，也可能是SOFTTAIL
    // 與fetch機制、目錄的遍歷等有關
    lfs_block_t tail[2];

    // 注：off、etag、erased、tail與commit機制、tag的遍歷等有關，見后面的文章
} lfs_mdir_t;

typedef struct lfs_file {
    // 以下4個成員與mlist相關，見后文mlist的介紹
    struct lfs_file *next;
    uint16_t id;
    uint8_t type;
    lfs_mdir_t m;

    struct lfs_ctz {
        lfs_block_t head;    // 跳表頭指針，inline文件時為LFS_BLOCK_INLINE
        lfs_size_t size;     // 文件大小，inline和outline文件均用此記錄
    } ctz;

    uint32_t flags;          // INLINE、OUTLINE、DIRTY、WRITING等標志
    lfs_off_t pos;           // 文件當前的偏移字節數
    lfs_block_t block;       // 文件當前的block
    lfs_off_t off;           // 文件在當前block的偏移
    lfs_cache_t cache;       // 文件緩存，用于讀寫等操作

    const struct lfs_file_config *cfg;    // 文件的其他配置信息
} lfs_file_t;

typedef struct lfs {
    ...
    struct lfs_mlist {
        struct lfs_mlist *next;    // 下一個鏈表中的節點
        uint16_t id;               // 文件或目錄在其父目錄中的id
        uint8_t type;              // 類型，表明是文件還是目錄
        lfs_mdir_t m;              // 父目錄元數據對信息
    } *mlist;
    ...
} lfs_t;

typedef struct lfs_file {
    struct lfs_file *next;   // 下一個鏈表中的節點
    uint16_t id;             // 文件在父目錄中的id
    uint8_t type;            // 類型，文件類型應為LFS_REG_TYPE
    lfs_mdir_t m;            // 父目錄元數據對信息

    // 以下成員見上文中存儲結構
    ...
} lfs_file_t;

typedef struct lfs_dir {
    struct lfs_dir *next;    // 下一個鏈表中的節點
    uint16_t id;             // 目錄在父目錄中的id
    uint8_t type;            // 類型，目錄應為LFS_DIR_TYPE
    lfs_mdir_t m;            // 父目錄元數據對信息

    lfs_off_t pos;           // 當前目錄或文件在父目錄中的位置，.和..分別為0和1
    lfs_block_t head[2];     // 第一個元數據對所在塊號
} lfs_dir_t;

lfs_file_open(lfs_t *lfs, lfs_file_t *file, const char *path, int flags)
|-> lfs_file_rawopen(lfs_t *lfs, lfs_file_t *file,
    |    const char *path, int flags)
    |-> lfs_file_rawopencfg(lfs_t *lfs, lfs_file_t *file,
        |   const char *path, int flags,
        |   const struct lfs_file_config *cfg)
        |-> ...
        |
        |   // 將file加入到mlist
        |-> lfs_mlist_append(lfs, (struct lfs_mlist *)file);
        |
        |-> ...

lfs_file_close(lfs_t *lfs, lfs_file_t *file)
|-> lfs_file_rawclose(lfs_t *lfs, lfs_file_t *file)
    |-> lfs_mlist_remove(lfs, (struct lfs_mlist*)file);
    |
    |-> ...

lfs_dir_open(lfs_t *lfs, lfs_dir_t *dir, const char *path)
|-> lfs_dir_rawopen(lfs_t *lfs, lfs_dir_t *dir, const char *path)
    |-> ...
    |
    |-> lfs_mlist_append(lfs, (struct lfs_mlist *)dir);

lfs_dir_close(lfs_t *lfs, lfs_dir_t *dir)
|-> lfs_dir_rawclose(lfs_t *lfs, lfs_dir_t *dir)
    |-> lfs_mlist_remove(lfs, (struct lfs_mlist *)dir);