验证环境
- Win10 64位
- Keil MDK 5.30
- ART-Pi 开发板：STM32H750XBH6开发板
- 工程：最小RT-Thread 系统，基于master分支，版本：4.1.0
需求
- ART-Pi 内部的Flash比较小，规格书里提示：只有128K，目前作为bootloader，跳转到外部8M SPI Flash上，也就是工程的代码，烧写在8M 外部SPI Flash上，这样的代码空间足够大，可以做很多事情
- ART-Pi 还有一个16M 外部SPI Flash，除了放置WIFI BLE固件外，还有12M的空间，可以用于挂在文件系统
- 外部16MB SPI Flash默认的分区表，可以查看：
fal_cfg.h
/* ====================== Partition Configuration ========================== */
#ifdef FAL_PART_HAS_TABLE_CFG
/* partition table */
#define FAL_PART_TABLE \
{ \
{FAL_PART_MAGIC_WORD, "wifi_image", NOR_FLASH_DEV_NAME, 0, 512*1024, 0}, \
{FAL_PART_MAGIC_WORD, "bt_image", NOR_FLASH_DEV_NAME, 512*1024, 512*1024, 0}, \
{FAL_PART_MAGIC_WORD, "download", NOR_FLASH_DEV_NAME, 1024*1024, 2*1024*1024, 0}, \
{FAL_PART_MAGIC_WORD, "easyflash", NOR_FLASH_DEV_NAME, 3*1024*1024, 1*1024*1024, 0}, \
{FAL_PART_MAGIC_WORD, "filesystem", NOR_FLASH_DEV_NAME, 4*1024*1024, 12*1024*1024, 0}, \
}
#endif /* FAL_PART_HAS_TABLE_CFG */
- 开启文件系统
- 可以使用menuconfig，配置使能外部的16M SPI Flash，使能文件系统（基于Flash的）
2022-04-01_000658.png
2022-03-31_234906.png
2022-04-01_000708.png
2022-04-01_000818.png
2022-04-01_000642.png
2022-04-01_000613.png
修改代码
- 默认
filesystem.c开启了 RT_USING_DFS_ROMFS ，发现是board\Kconfig默认配置的，这里去掉这个选项，这样文件系统可以写 - 修改
filesystem.c，默认lfs（littlefs）文件系统，改为elm(fatfs)文件系统 - 使用：RT_USING_DFS_ROMFS 屏蔽掉 只读分区的挂载操作
- 把 外部16M SPI Flash分区：
"filesystem"挂载为文件根目录/
/*
* Copyright (c) 2006-2022, RT-Thread Development Team
*
* SPDX-License-Identifier: Apache-2.0
*
* Change Logs:
* Date Author Notes
* 2018-12-13 balanceTWK add sdcard port file
* 2019-06-11 WillianChan Add SD card hot plug detection
*/
#include <rtthread.h>
#ifdef BSP_USING_FS
#if DFS_FILESYSTEMS_MAX < 4
#error "Please define DFS_FILESYSTEMS_MAX more than 4"
#endif
#if DFS_FILESYSTEM_TYPES_MAX < 4
#error "Please define DFS_FILESYSTEM_TYPES_MAX more than 4"
#endif
#include <dfs_fs.h>
#ifdef BSP_USING_SDCARD_FS
#include <board.h>
#include "drv_sdio.h"
#endif
#ifdef BSP_USING_SPI_FLASH_FS
#include "fal.h"
#endif
#define DBG_TAG "app.filesystem"
#define DBG_LVL DBG_INFO
#include <rtdbg.h>
#ifdef RT_USING_DFS_ROMFS /* 默认不使用 ROMFS */
#include "dfs_romfs.h"
static const struct romfs_dirent _romfs_root[] =
{
{ROMFS_DIRENT_DIR, "flash", RT_NULL, 0},
{ROMFS_DIRENT_DIR, "sdcard", RT_NULL, 0}
};
const struct romfs_dirent romfs_root =
{
ROMFS_DIRENT_DIR, "/", (rt_uint8_t *)_romfs_root, sizeof(_romfs_root) / sizeof(_romfs_root[0])
};
#endif
#ifdef BSP_USING_SDCARD_FS
/* SD Card hot plug detection pin */
#define SD_CHECK_PIN GET_PIN(D, 5)
static void _sdcard_mount(void)
{
rt_device_t device;
device = rt_device_find("sd0");
if (device == NULL)
{
mmcsd_wait_cd_changed(0);
sdcard_change();
mmcsd_wait_cd_changed(RT_WAITING_FOREVER);
device = rt_device_find("sd0");
}
if (device != RT_NULL)
{
if (dfs_mount("sd0", "/sdcard", "elm", 0, 0) == RT_EOK)
{
LOG_I("sd card mount to '/sdcard'");
}
else
{
LOG_W("sd card mount to '/sdcard' failed!");
}
}
}
static void _sdcard_unmount(void)
{
rt_thread_mdelay(200);
dfs_unmount("/sdcard");
LOG_I("Unmount \"/sdcard\"");
mmcsd_wait_cd_changed(0);
sdcard_change();
mmcsd_wait_cd_changed(RT_WAITING_FOREVER);
}
static void sd_mount(void *parameter)
{
rt_uint8_t re_sd_check_pin = 1;
rt_thread_mdelay(200);
if (rt_pin_read(SD_CHECK_PIN))
{
_sdcard_mount();
}
while (1)
{
rt_thread_mdelay(200);
if (!re_sd_check_pin && (re_sd_check_pin = rt_pin_read(SD_CHECK_PIN)) != 0)
{
_sdcard_mount();
}
if (re_sd_check_pin && (re_sd_check_pin = rt_pin_read(SD_CHECK_PIN)) == 0)
{
_sdcard_unmount();
}
}
}
#endif /* BSP_USING_SDCARD_FS */
#define BLK_DEV_NAME "filesystem"
int mnt_spi_flash_init(void) /* 外部SPI Flash 分区挂载 */
{
rt_thread_delay(RT_TICK_PER_SECOND);
fal_blk_device_create(BLK_DEV_NAME);
if (dfs_mount(BLK_DEV_NAME, "/", "elm", 0, 0) == 0)
{
rt_kprintf(BLK_DEV_NAME" mount to '/'\n");
}
else
{
if(dfs_mkfs("elm", BLK_DEV_NAME) == 0)
{
if (dfs_mount(BLK_DEV_NAME, "/", "elm", 0, 0) == 0)
{
rt_kprintf(BLK_DEV_NAME" mount to '/'\n");
}
else
{
rt_kprintf(BLK_DEV_NAME" mount to '/' failed!\n");
}
}
else
{
rt_kprintf(BLK_DEV_NAME" mkfs failed!");
}
}
return 0;
}
int mount_init(void)
{
#ifdef RT_USING_DFS_ROMFS /* 默认不使用ROMFS */
if (dfs_mount(RT_NULL, "/", "rom", 0, &(romfs_root)) != 0)
{
LOG_E("rom mount to '/' failed!");
}
#endif
#ifdef BSP_USING_SPI_FLASH_FS
mnt_spi_flash_init(); /* 挂载 SPI Flash 为 根目录 */
#if 0 /* 以下为 lfs 挂载，注释掉 */
struct rt_device *flash_dev = RT_NULL;
#ifndef RT_USING_WIFI
fal_init();
#endif
flash_dev = fal_mtd_nor_device_create("filesystem");
if (flash_dev)
{
//mount filesystem
if (dfs_mount(flash_dev->parent.name, "/", "elm", 0, 0) != 0)
{
LOG_W("mount to '/' failed! try to mkfs %s", flash_dev->parent.name);
dfs_mkfs("lfs", flash_dev->parent.name);
if (dfs_mount(flash_dev->parent.name, "/flash", "lfs", 0, 0) == 0)
{
LOG_I("mount to '/flash' success!");
}
}
else
{
LOG_I("mount to '/flash' success!");
}
}
else
{
LOG_E("Can't create block device filesystem or bt_image partition.");
}
#endif
#endif
#ifdef BSP_USING_SDCARD_FS
rt_thread_t tid;
rt_pin_mode(SD_CHECK_PIN, PIN_MODE_INPUT_PULLUP);
tid = rt_thread_create("sd_mount", sd_mount, RT_NULL,
2048, RT_THREAD_PRIORITY_MAX - 2, 20);
if (tid != RT_NULL)
{
rt_thread_startup(tid);
}
else
{
LOG_E("create sd_mount thread err!");
}
#endif
return RT_EOK;
}
INIT_APP_EXPORT(mount_init);
#endif /* BSP_USING_FS */
编译下载
___ ______ _____ ______ _ ______ _____ _____ _____
/ _ \ | ___ \|_ _| | ___ \(_) | ___ \/ _ \/ _ \|_ _|
/ /_\ \| |_/ / | | ______ | |_/ / _ | |_/ /| | | || | | | | |
| _ || / | | |______|| __/ | | | ___ \| | | || | | | | |
| | | || |\ \ | | | | | | | |_/ /\ \_/ /\ \_/ / | |
\_| |_/\_| \_| \_/ \_| |_| \____/ \___/ \___/ \_/
Powered by RT-Thread.
[D/drv.sdram] sdram init success, mapped at 0xC0000000, size is 33554432 bytes, data width is 16
\ | /
- RT - Thread Operating System
/ | \ 4.1.0 build Mar 31 2022 23:53:12
2006 - 2022 Copyright by RT-Thread team
[I/SFUD] Find a Winbond flash chip. Size is 16777216 bytes.
[I/SFUD] norflash0 flash device is initialize success.
[I/SFUD] Probe SPI flash norflash0 by SPI device spi10 success.
[D/FAL] (fal_flash_init:47) Flash device | norflash0 | addr: 0x00000000 | len: 0x01000000 | blk_size: 0x00001000 |initialized finish.
[I/FAL] ==================== FAL partition table ====================
[I/FAL] | name | flash_dev | offset | length |
[I/FAL] -------------------------------------------------------------
[I/FAL] | wifi_image | norflash0 | 0x00000000 | 0x00080000 |
[I/FAL] | bt_image | norflash0 | 0x00080000 | 0x00080000 |
[I/FAL] | download | norflash0 | 0x00100000 | 0x00200000 |
[I/FAL] | easyflash | norflash0 | 0x00300000 | 0x00100000 |
[I/FAL] | filesystem | norflash0 | 0x00400000 | 0x00c00000 |
[I/FAL] =============================================================
[I/FAL] RT-Thread Flash Abstraction Layer initialize success.
[I/FAL] The FAL block device (filesystem) created successfully
filesystem mount to '/'
- 注意这个工程，需要先烧写 bootloader，使用ART-Pi 的SDK bootloader工程
sdk-bsp-stm32h750-realthread-artpi\projects\art_pi_bootloader - 发现挂载成功了
msh />df
disk free: 11.9 MB [ 3063 block, 4096 bytes per block ]
- 发现可以创建目录与文件
msh />ls
Directory /:
msh />mkdir logs
msh />cd logs
msh /logs>ls
Directory /logs:
msh /logs>echo aaa log.txt
msh /logs>ls
Directory /logs:
log.txt 3
msh /logs>cat log.txt
aaa
msh /logs>
- 自此，ART-Pi 外部16MB SPI Flash的12MB 分区，成功挂载为 elm : FatFS 文件系统了
小结
- 熟悉RT-Thread 文件系统的框架
- 熟悉elm FatFS 文件系统的配置，如扇区（sector）大小的设置
