FAL (Flash Abstraction Layer) Flash 抽象层（3）
使用 FAL 的基本步骤如下所示：
- 添加spi设备。
- 打开 FAL：从 Env 中打开 fal 软件包并下载到工程。
- FAL 移植：定义 flash 设备、定义 flash 设备表、定义 flash 分区表。以下主要对步骤 2 展开讲解。
- 调用 fal_init() 初始化该库：移植完成后，可在应用层调用，如在 main 函数中调用。
| 文件 | 说明 |
|---|---|
| applications/main.c | app 入口（fal 例程程序） |
| ports | fal 移植文件 |
| ports/fal/fal_cfg.h | fal 配置文件（Flash 设备配置 和 分区表配置） |
| ports/fal/fal_flash_sfud_port.c | fal 操作片外 Nor Flash 的移植文件（将 Flash 读写擦接口注册到 fal） |
| ports/fal/fal_flash_stm32l4_port.c | fal 操作片内 Flash 的移植文件（将 Flash 读写擦接口注册到 fal） |
| packages/fal | fal 软件包（fal 源码实现） |
| packages/fal/inc/fal.h | fal 软件包对外提供的操作接口 |
fal_partition 结构体定义如下所示：
struct fal_partition
{
uint32_t magic_word;
/* FLASH 分区名称 */
char name[FAL_DEV_NAME_MAX];
/* FLASH 分区所在的 FLASH 设备名称 */
char flash_name[FAL_DEV_NAME_MAX];
/* FLASH 分区在 FLASH 设备的偏移地址 */
long offset;
size_t len;
uint8_t reserved;
};| 成员变量 | 说明 |
|---|---|
| magic_word | 魔法数，系统使用，用户无需关心 |
| name | 分区名字，最大 23 个ASCII字符 |
| flash_name | 分区所属的 Flash 设备名字，最大 23 个ASCII字符 |
| offset | 分区起始地址相对 Flash 设备起始地址的偏移量 |
| len | 分区大小，单位字节 |
| reserved | 保留项 |
fal_flash_dev 结构体定义如下所示：
struct fal_flash_dev
{
char name[FAL_DEV_NAME_MAX];
/* FLASH 设备的起始地址 */
uint32_t addr;
size_t len;
/* FLASH 设备最小擦除的块大小 */
size_t blk_size;
struct
{
int (*init)(void);
int (*read)(long offset, uint8_t *buf, size_t size);
int (*write)(long offset, const uint8_t *buf, size_t size);
int (*erase)(long offset, size_t size);
} ops;
};| 成员变量 | 说明 |
|---|---|
| name | Flash 设备名字，最大 23 个ASCII字符 |
| addr | Flash 设备的起始地址（片内 Flash 为 0x08000000，片外 Flash 为 0x00） |
| len | Flash 设备容量，单位字节 |
| blk_size | Flash 设备最小擦除单元的大小，单位字节 |
| ops.init | Flash 设备的初始化函数，会在 fal_init 接口中调用 |
| ops.read | Flash 设备数据读取接口 |
| ops.write | Flash 设备数据写入接口 |
| ops.erase | Flash 设备数据擦除接口 |
具体操作
配置spi1
配置 FAL 分区
接添加 FAL 组件的初始化代码
extern const struct fal_flash_dev stm32_onchip_flash;
//extern const struct fal_flash_dev stm32_onchip_flash_128k;
extern struct fal_flash_dev nor_flash0;
/* flash device table */
#define FAL_FLASH_DEV_TABLE \
{ \
&stm32_onchip_flash, \
&nor_flash0, \
}
/* ====================== Partition Configuration ========================== */
#ifdef FAL_PART_HAS_TABLE_CFG
/* partition table */
#define FAL_PART_TABLE \
{ \
{FAL_PART_MAGIC_WROD, "boot", "onchip_flash", 0, 32 * 1024, 0}, \
{FAL_PART_MAGIC_WROD, "app", "onchip_flash", 32*1024, (512-32) * 1024, 0}, \
{FAL_PART_MAGIC_WROD, "download", "norflash0", 0 , 1024 * 1024, 0}, \
{FAL_PART_MAGIC_WROD, "font", "norflash0", 1024*1024, 512 * 1024, 0}, \
{FAL_PART_MAGIC_WROD, "ef", "norflash0", (1024+512)*1024, (3072) * 1024, 0}, \
}片内涉及到drv_flash_f4.c
//lash 设备名称为 onchip_flash，设备容量为 512K，最小擦除单元为 2K，无初始化接口。
const struct fal_flash_dev stm32_onchip_flash = { "onchip_flash", STM32_FLASH_START_ADRESS, STM32_FLASH_SIZE,(2 * 1024), {NULL, stm32_flash_read, stm32_flash_write, stm32_flash_erase} };
https://github.com/RT-Thread/IoT_Board/tree/master/examples/13_component_fal