[bsp][nxp] support qspi flash and filesystem for imxrt1180-evk board

Author: CoreBoxer

bsp/nxp/imx/imxrt/imxrt1180-nxp-evk/README_zh.md

@@ -27,7 +27,7 @@ CM33对CM7的kick off将在后续版本中支持。
 | **板载外设**      | **支持情况** | **备注**                              |
 | :----------------- | :----------: | :------------------------------------|
 | USB 转串口        |     暂不支持     |                                       |
-| SPI Flash         |     暂不支持     |                                       |
+| SPI Flash         |     支持     |                                       |
 | 以太网            |     暂不支持     |                                       |
 | **片上外设** | **支持情况** | **备注**                              |
 | GPIO         |     暂不支持     |                                       |

bsp/nxp/imx/imxrt/imxrt1180-nxp-evk/cm33/.ci/attachconfig/ci.attachconfig.yml

@@ -0,0 +1,11 @@
+scons.args: &scons
+  scons_arg:
+    - '--strict'
+
+# ------ component CI ------
+
+# ------ Peripheral CI ------
+Peripheral.flash_fs:
+  <<: *scons
+  kconfig:
+    - CONFIG_BSP_USING_QSPI_FLASH_FS=y

bsp/nxp/imx/imxrt/imxrt1180-nxp-evk/cm33/applications/mnt.c

@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2019-2024, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date           Author       Notes
+ * 2026-06-02     CoreBoxer    add LittleFS on QSPI NOR Flash (IMXRT1180-EVK)
+ */
+
+#include <rtthread.h>
+
+/* ====================================================================
+ * QSPI NOR Flash LittleFS (controlled by BSP_USING_QSPI_FLASH_FS)
+ *
+ * Dependencies:
+ *   - drv_flash.c (Flash read/write/erase driver via ROM API)
+ *   - FAL framework (partition management)
+ *   - LittleFS component (RT-Thread package)
+ *
+ * FAL partition configuration (fal_cfg.h):
+ *   "filesystem" partition → filesystem area of norflash0
+ *
+ * Mount procedure:
+ *   1. Find FAL partition to confirm correct configuration
+ *   2. Create MTD NOR block device
+ *   3. Try direct mount (for already formatted filesystem)
+ *   4. If failed, perform mkfs then remount (first use or format scenario)
+ * ==================================================================== */
+#ifdef BSP_USING_QSPI_FLASH_FS
+#include <dfs_fs.h>
+#include <fal.h>
+
+#define FS_PARTITION_NAME  "filesystem"
+#define FS_TYPE_NAME       "lfs"
+#define FS_MOUNT_POINT     "/"
+
+static int _qspi_flash_fs_mount(void)
+{
+    struct fal_mtd_nor_device *mtd_dev;
+    int ret;
+
+    /* Find FAL partition to confirm configuration is correct */
+    if (fal_partition_find(FS_PARTITION_NAME) == RT_NULL)
+    {
+        rt_kprintf("[qspi_fs] partition '%s' not found, check fal_cfg.h\n",
+                   FS_PARTITION_NAME);
+        return -RT_ERROR;
+    }
+
+    /* Create MTD NOR block device for filesystem partition */
+    mtd_dev = (struct fal_mtd_nor_device *)fal_mtd_nor_device_create(FS_PARTITION_NAME);
+    if (mtd_dev == RT_NULL)
+    {
+        rt_kprintf("[qspi_fs] failed to create MTD NOR device for '%s'\n",
+                   FS_PARTITION_NAME);
+        return -RT_ERROR;
+    }
+
+    /* Try direct mount (for already formatted flash) */
+    ret = dfs_mount(FS_PARTITION_NAME, FS_MOUNT_POINT, FS_TYPE_NAME, 0, 0);
+    if (ret == 0)
+    {
+        rt_kprintf("[qspi_fs] '%s' mounted at '%s'\n",
+                   FS_PARTITION_NAME, FS_MOUNT_POINT);
+        return RT_EOK;
+    }
+
+    /* Mount failed, indicating flash is not formatted (first use scenario), perform mkfs */
+    rt_kprintf("[qspi_fs] mount failed (ret=%d), formatting '%s'...\n",
+               ret, FS_PARTITION_NAME);
+
+    ret = dfs_mkfs(FS_TYPE_NAME, FS_PARTITION_NAME);
+    if (ret != 0)
+    {
+        rt_kprintf("[qspi_fs] mkfs failed (ret=%d)\n", ret);
+        return -RT_ERROR;
+    }
+
+    /* Remount after successful mkfs */
+    ret = dfs_mount(FS_PARTITION_NAME, FS_MOUNT_POINT, FS_TYPE_NAME, 0, 0);
+    if (ret != 0)
+    {
+        rt_kprintf("[qspi_fs] mount failed after mkfs (ret=%d)\n", ret);
+        return -RT_ERROR;
+    }
+
+    rt_kprintf("[qspi_fs] '%s' formatted and mounted at '%s'\n",
+               FS_PARTITION_NAME, FS_MOUNT_POINT);
+    return RT_EOK;
+}
+INIT_APP_EXPORT(_qspi_flash_fs_mount);
+/*
+ * FAL initialization registered as INIT_COMPONENT_EXPORT:
+ *   after Flash driver (INIT_DEVICE_EXPORT)
+ *   before filesystem mount (INIT_APP_EXPORT)
+ */
+INIT_COMPONENT_EXPORT(fal_init);
+
+#endif /* BSP_USING_QSPI_FLASH_FS */

bsp/nxp/imx/imxrt/imxrt1180-nxp-evk/cm33/board/Kconfig

@@ -229,6 +229,16 @@ menu "Onboard Peripheral Drivers"
                 select BSP_USING_SDIO
                 select RT_USING_DFS_ELMFAT
                 default n
+
+            config BSP_USING_QSPI_FLASH_FS
+                bool "Enable QSPI Flash (LittleFS)"
+                select BSP_USING_FLEXSPI
+                select BSP_USING_FLEXSPI1
+                select RT_USING_FAL
+                select FAL_PART_HAS_TABLE_CFG
+                select RT_USING_MTD_NOR
+                select PKG_USING_LITTLEFS
+                default n
         endif
 
 endmenu

bsp/nxp/imx/imxrt/imxrt1180-nxp-evk/cm33/board/SConscript

@@ -12,6 +12,9 @@ MCUX_Config/clock_config.c
 MCUX_Config/pin_mux.c
 """)
 
+if GetDepend(['BSP_USING_QSPI_FLASH_FS']):
+    src += ['ports/drv_flexspi_nor_flash.c', 'ports/fal_flash_port.c']
+
 CPPPATH = [cwd,cwd + '/MCUX_Config',cwd + '/ports']
 CPPDEFINES = ['CPU_MIMXRT1189CVM8C_cm33', 'MCUXPRESSO_SDK', 'MCUX_META_BUILD', 'MIMXRT1189_cm33_SERIES', 'XIP_BOOT_HEADER_ENABLE=1', 'XIP_BOOT_HEADER_DCD_ENABLE=1', 'XIP_EXTERNAL_FLASH=1', 'ARM_MATH_CM33']
 

bsp/nxp/imx/imxrt/imxrt1180-nxp-evk/cm33/board/linker_scripts/link.scf

@@ -173,6 +173,7 @@ LR_m_text   m_text_start   m_text_size
 
   ER_m_QuickAccessCode    m_qacode_start                                   m_qacode_size
   {
+    fsl_flexspi.o (+RO-CODE)
     .ANY (CodeQuickAccess)
   }