From 4ab5cb816810d168db70b0d36185bcc77b5258c7 Mon Sep 17 00:00:00 2001 From: Asurada Date: Wed, 3 Jul 2024 07:38:37 +0000 Subject: [PATCH] update rt-thread-version/rt-thread-standard/programming-manual/fal/fal.md. Signed-off-by: Asurada --- .../rt-thread-standard/programming-manual/fal/fal.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) 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 8a0adfd..fb76b76 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 函数中调用。 @@ -59,8 +59,8 @@ FAL 相关的 API 如图所示，[点击此处查看 API 参数详解](./fal_api 在定义 Flash 设备表前，需要先定义 Flash 设备。可以是片内 flash, 也可以是片外基于 SFUD 的 spi flash： -- 定义片外 spi flash 设备可以参考 [`fal_flash_sfud_port.c`](https://github.com/RT-Thread-packages/fal/blob/master/samples/porting/fal_flash_sfud_port.c) 。 -- 定义片内 flash 设备可以参考 [`fal_flash_stm32f2_port.c`](https://github.com/RT-Thread-packages/fal/blob/master/samples/porting/fal_flash_stm32f2_port.c) 。 +- 定义片外 spi flash 设备可以参考 [`fal_flash_sfud_port.c`](https://github.com/RT-Thread/rt-thread/blob/master/components/fal/samples/porting/fal_flash_sfud_port.c) 。 +- 定义片内 flash 设备可以参考 [`fal_flash_stm32f2_port.c`](https://github.com/RT-Thread/rt-thread/blob/master/components/fal/samples/porting/fal_flash_stm32f2_port.c) 。 定义具体的 Flash 设备对象，用户需要根据自己的 Flash 情况分别实现 `init`、 `read`、 `write`、 `erase` 这些操作函数： @@ -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,4 +283,4 @@ msh /> **1、使用 FAL 时，无法找到 `fal_cfg.h` 头文件** -`fal_cfg.h` 为 fal 软件包的配置文件，需要用户手动新建，并定义相关的分区表信息。请将该文件统一放在 BSP 的 port 文件夹下或工程目录的 port 文件夹下（若没有则新建 port 文件夹），并将该头文件路径加入到工程，详见本文 "`2.2、定义 flash 设备表`" 小节。 \ No newline at end of file +`fal_cfg.h` 为 fal 软件包的配置文件，需要用户手动新建，并定义相关的分区表信息。请将该文件统一放在 BSP 的 ports 文件夹下或工程目录的 ports 文件夹下（若没有则新建 ports 文件夹），并将该头文件路径加入到工程，详见本文 "`2.2、定义 flash 设备表`" 小节。 \ No newline at end of file -- Gitee