diff --git a/rt-thread-version/rt-thread-standard/programming-manual/fal/fal.md b/rt-thread-version/rt-thread-standard/programming-manual/fal/fal.md index 5938878757aa39fecd703dea493e8050ab3c9535..1c8dea70661f74e28cfac0fbe816d5def47439ca 100644 --- a/rt-thread-version/rt-thread-standard/programming-manual/fal/fal.md +++ b/rt-thread-version/rt-thread-standard/programming-manual/fal/fal.md @@ -49,7 +49,7 @@ FAL 相关的 API 如图所示,[点击此处查看 API 参数详解](./fal_api 使用 FAL 的基本步骤如下所示: -1. 打开 FAL:从 Env 中打开 fal 软件包并下载到工程。 +1. 打开 FAL:从 Env 中打开 FAL 组件。 2. FAL 移植:定义 flash 设备、定义 flash 设备表、定义 flash 分区表。以下主要对步骤 2 展开讲解。 3. 调用 fal_init() 初始化该库:移植完成后,可在应用层调用,如在 main 函数中调用。 @@ -118,7 +118,7 @@ const struct fal_flash_dev stm32f2_onchip_flash = ### 2.2、定义 flash 设备表 -Flash 设备表定义在 `fal_cfg.h` 头文件中,定义分区表前需 **新建 `fal_cfg.h` 文件** ,请将该文件统一放在对应 BSP 或工程目录的 port 文件夹下,并将该头文件路径加入到工程。fal_cfg.h 可以参考 [示例文件 fal/samples/porting/fal_cfg.h](https://github.com/RT-Thread-packages/fal/blob/master/samples/porting/fal_cfg.h) 完成。 +Flash 设备表定义在 `fal_cfg.h` 头文件中,定义分区表前需 **新建 `fal_cfg.h` 文件** ,请将该文件统一放在对应 BSP 或工程目录的 ports 文件夹下,并将该头文件路径加入到工程。fal_cfg.h 可以参考 [示例文件 fal/samples/porting/fal_cfg.h](https://github.com/RT-Thread/rt-thread/blob/master/components/fal/samples/porting/fal_cfg.h) 完成。 设备表示例: @@ -139,7 +139,7 @@ Flash 设备表中,有两个 Flash 对象,一个为 STM32F2 的片内 Flash ### 2.3、定义 flash 分区表 -分区表也定义在 `fal_cfg.h` 头文件中。Flash 分区基于 Flash 设备,每个 Flash 设备又可以有 N 个分区,这些分区的集合就是分区表。在配置分区表前,务必保证已定义好 **Flash 设备** 及 **设备表**。fal_cfg.h 可以参考 [示例文件 fal/samples/porting/fal_cfg.h](https://github.com/RT-Thread-packages/fal/blob/master/samples/porting/fal_cfg.h) 完成。 +分区表也定义在 `fal_cfg.h` 头文件中。Flash 分区基于 Flash 设备,每个 Flash 设备又可以有 N 个分区,这些分区的集合就是分区表。在配置分区表前,务必保证已定义好 **Flash 设备** 及 **设备表**。fal_cfg.h 可以参考 [示例文件 fal/samples/porting/fal_cfg.h](https://github.com/RT-Thread/rt-thread/blob/master/components/fal/samples/porting/fal_cfg.h) 完成。 分区表示例: @@ -283,7 +283,7 @@ msh /> **1、使用 FAL 时,无法找到 `fal_cfg.h` 头文件** -`fal_cfg.h` 为 fal 软件包的配置文件,需要用户手动新建,并定义相关的分区表信息。请将该文件统一放在 BSP 的 port 文件夹下或工程目录的 port 文件夹下(若没有则新建 port 文件夹),并将该头文件路径加入到工程,详见本文 "`2.2、定义 flash 设备表`" 小节。 +`fal_cfg.h` 为 fal 软件包的配置文件,需要用户手动新建,并定义相关的分区表信息。请将该文件统一放在 BSP 的 ports 文件夹下或工程目录的 ports 文件夹下(若没有则新建 port 文件夹),并将该头文件路径加入到工程,详见本文 "`2.2、定义 flash 设备表`" 小节。 添加 `fal_cfg.h` 文件后,检查此文件所在文件夹或其上一级文件夹下的 `SConscript` 文件内容,比如 `fal_cfg.h` 文件在 `stm32f072-st-nucleo/board/ports` 文件夹下,则检查 `stm32f072-st-nucleo\board\SConscript` 文件中是否有如下内容: