+-----------+--------------+---+------------+---+------------+---+-------------------+
|           |              |   |            |   |            |   |                   |
|           |              |   | MS-FLASHFS |   | MS-FLASHFS |   |                   |
|  MS-BOOT  |   MS-RTOS    | ~ |            | ~ |            | ~ |  MS-FLASHFS DATA  |
|           |              |   |  MAIN TBL  |   |  SEC TBL   |   |                   |
|           |              |   |            |   |            |   |                   |
+-----------+--------------+---+------------+---+------------+---+-------------------+

ms_err_t ms_apps_update(const char *update_req_path, const char *log_path);

MS_STRUCT_PACK_BEGIN
struct ms_flashfs_action {
    // 动作 id
#define MS_FLASHFS_ACTION_CREATE_FILE       0U // 创建文件
#define MS_FLASHFS_ACTION_UPDATE_FILE       1U // 升级文件
#define MS_FLASHFS_ACTION_REMOVE_FILE       2U // 删除文件
#define MS_FLASHFS_ACTION_DEFRAG            3U // 磁盘碎片整理
#define MS_FLASHFS_ACTION_UPDATE_OS         4U // 升级 OS 镜像（该类型动作由 MS-BOOT 执行） 
    MS_STRUCT_PACK_FIELD(ms_uint32_t  id);           // 动作 id
    MS_STRUCT_PACK_FIELD(ms_uint32_t  reserve_size); // 预留给未来升级的大小
    MS_STRUCT_PACK_FIELD(ms_uint32_t  crc32);        // 文件的 CRC32
    MS_STRUCT_PACK_FIELD(ms_err_t     err);          // 动作执行的错误码
    MS_STRUCT_PACK_FIELD(char         name[MS_FLASHFS_NAME_BUF_SIZE]);   // 文件名
    MS_STRUCT_PACK_FIELD(char         source[MS_FLASHFS_PATH_BUF_SIZE]); // 外部文件系统中的源文件
} MS_STRUCT_PACK_STRUCT;
MS_STRUCT_PACK_END
typedef struct ms_flashfs_action ms_flashfs_action_t;

static void boot_thread(ms_ptr_t arg)
{
    // do something

    ms_launcher_init(rsa_pub_key, rsa_pub_key_len);

    ms_apps_update("/nor/update/firmware/update_req", "/nor/update/firmware/update_log");

    // do something
}

// 注册 MS-FLASHFS 文件系统
ms_err_t ms_flashfs_register(void);

// 分区的扇区大小表（扇区大小可以不同）
static const ms_uint32_t flash_sectors_size[] = {
        128U * 1024U,     /* FLASH_SECTOR_6  */
        128U * 1024U,     /* FLASH_SECTOR_7  */
        128U * 1024U,     /* FLASH_SECTOR_8  */
        128U * 1024U,     /* FLASH_SECTOR_9  */
};

// 分区信息
static ms_flashfs_partition_t flash_partition = {
        .flash_base   = ADDR_FLASH_SECTOR_6,               // 分区的第一个扇区的地址
        .n_sector     = MS_ARRAY_SIZE(flash_sectors_size), // 分区有多少个扇区
        .sectors_size = flash_sectors_size,                // 提供扇区大小表
};

// 获得分区信息
static ms_err_t __stm32_flash_get_part_info(ms_ptr_t priv, const ms_flashfs_partition_t **part)
{
    *part = &flash_partition;

    return MS_ERR_NONE;
}

// 擦除指定的扇区
static ms_err_t __stm32_flash_erase_sector(ms_ptr_t priv, ms_uint32_t sector_id)
{
    // sector_id 0 -> FLASH_SECTOR_6
    // sector_id 1 -> FLASH_SECTOR_7
    // sector_id 2 -> FLASH_SECTOR_8
    // sector_id 3 -> FLASH_SECTOR_9
    
    // do something 
}

// 对指定地址进行编程
static ms_err_t __stm32_flash_program(ms_ptr_t priv, ms_addr_t addr, ms_const_ptr_t buf, ms_uint32_t len)
{
    // do something 
}

// 擦除指定的文件系统表并编程
static ms_err_t __stm32_flash_erase_program_tbl(ms_ptr_t priv, ms_addr_t tbl_addr, ms_const_ptr_t buf, ms_uint32_t len)
{
    // do something 
}

// 无效指定的文件系统表
static ms_err_t __stm32_flash_invalid_tbl(ms_ptr_t priv, ms_addr_t tbl_addr)
{
    // 文件系统表第一个字写为 0 则可以无效文件系统表
    ms_uint32_t data = 0;

    return __stm32_flash_program(priv, tbl_addr, &data, sizeof(data));
}

// 定义 MS-FLASHFS 驱动
static ms_flashfs_drv_t stm32_flash_drv = {
        .get_part_info      = __stm32_flash_get_part_info,
        .erase_sector       = __stm32_flash_erase_sector,
        .program            = __stm32_flash_program,
        .erase_program_tbl  = __stm32_flash_erase_program_tbl,
        .invalid_tbl        = __stm32_flash_invalid_tbl,
};

// 挂载 MS-FLASHFS
ms_err_t stm32_flash_mount(const char *mnt_path)
{
    // 挂载参数
    ms_flashfs_mount_param_t mount_param;

    mount_param.main_tbl_addr        = BSP_CFG_FLASHFS_MAIN_TBL_ADDR;  // 主文件系统表扇区地址
    mount_param.sec_tbl_addr         = BSP_CFG_FLASHFS_SEC_TBL_ADDR;   // 从文件系统表扇区地址
    mount_param.drv                  = &stm32_flash_drv;               // MS-FLASHFS 驱动
    mount_param.priv                 = MS_NULL;                        // 私有信息
    mount_param.readonly             = MS_FALSE;                       // 是否只读
    mount_param.calc_crc32           = ms_crc32;                       // 提供 CRC32 函数
    mount_param.mkfs_param.max_file  = BSP_CFG_FLASHFS_MAX_FILE;       // 如果没有格式化，则用这参数进行格式化，最大存放多少个文件
    mount_param.mkfs_param.unit_size = BSP_CFG_FLASHFS_UNIT_SIZE;      // 如果没有格式化，则用这参数进行格式化，分配单元的大小(字节单位)
    mount_param.update_req_path      = MS_NULL;

    return ms_io_mount(mnt_path, MS_NULL, MS_FLASHFS_NAME, &mount_param);
}

static void boot_thread(ms_ptr_t arg)
{
    // do something 

    // 注册 MS-FLASHFS 文件系统
    ms_flashfs_register();

    // 挂载到 /flash 目录
    stm32_flash_mount("/flash");

    // do something 
}