feat(extension/fs): add littlefs, windows, arduino sd filesystem backend support

MDLZCOOL · MDLZCOOL · commit b8a2cc438c0f · 2026-02-23T12:52:10.000+08:00
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -48,6 +48,18 @@ if(CONFIG_CTSHELL_USE_FS)
         list(APPEND ctshell_srcs "${CMAKE_CURRENT_SOURCE_DIR}/extension/fs/ctshell_fs_posix.c")
         list(APPEND CTSHELL_DEFINITIONS "CONFIG_CTSHELL_USE_FS_POSIX=1")
     endif()
+    if(CONFIG_CTSHELL_USE_FS_LITTLEFS)
+        list(APPEND ctshell_srcs "${CMAKE_CURRENT_SOURCE_DIR}/extension/fs/ctshell_fs_littlefs.c")
+        list(APPEND CTSHELL_DEFINITIONS "CONFIG_CTSHELL_USE_FS_LITTLEFS=1")
+    endif()
+    if(CONFIG_CTSHELL_USE_FS_WINDOWS)
+        list(APPEND ctshell_srcs "${CMAKE_CURRENT_SOURCE_DIR}/extension/fs/ctshell_fs_windows.c")
+        list(APPEND CTSHELL_DEFINITIONS "CONFIG_CTSHELL_USE_FS_WINDOWS=1")
+    endif()
+    if(CONFIG_CTSHELL_USE_FS_ARDUINO_SD)
+        list(APPEND ctshell_srcs "${CMAKE_CURRENT_SOURCE_DIR}/extension/fs/ctshell_fs_arduino_sd.cpp")
+        list(APPEND CTSHELL_DEFINITIONS "CONFIG_CTSHELL_USE_FS_ARDUINO_SD=1")
+    endif()
 endif()
 
 if(CONFIG_CTSHELL_USE_DOUBLE)
diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@ Ctshell is a low-overhead shell designed specifically for resource-constrained e
 * Signal Handling (SIGINT): Implements setjmp/longjmp logic to abort long-running commands via `Ctrl+C`.
 * Built-in Argument Parser: Includes a strictly-typed argument parser to easily handle flags (bool), integers, strings, and verbs within custom commands.
 * ANSI Escape Sequence Support: Handles standard VT100/ANSI escape codes for arrow keys and screen control.
-* Filesystem Support: Out-of-box for `FatFS` now, other fs native support will come soon.
+* Filesystem Support: Out-of-box for FatFS, POSIX, Windows, littlefs, and Arduino SD.
 * Command Hierarchy Framework: Supports hierarchical command management.
 
 ## Porting
diff --git a/ctshell.h b/ctshell.h
@@ -305,6 +305,15 @@ extern void ctshell_fs_fatfs_init(ctshell_ctx_t *ctx);
 #ifdef CONFIG_CTSHELL_USE_FS_POSIX
 extern void ctshell_fs_posix_init(ctshell_ctx_t *ctx);
 #endif
+#ifdef CONFIG_CTSHELL_USE_FS_LITTLEFS
+extern void ctshell_fs_littlefs_init(ctshell_ctx_t *ctx, lfs_t *lfs);
+#endif
+#ifdef CONFIG_CTSHELL_USE_FS_WINDOWS
+extern void ctshell_fs_windows_init(ctshell_ctx_t *ctx);
+#endif
+#ifdef CONFIG_CTSHELL_USE_FS_ARDUINO_SD
+extern void ctshell_fs_arduino_sd_init(ctshell_ctx_t *ctx);
+#endif
 #endif
 
 #ifdef __cplusplus
diff --git a/ctshell_config.h b/ctshell_config.h
@@ -13,6 +13,9 @@
 //#define CONFIG_CTSHELL_USE_FS
 //#define CONFIG_CTSHELL_USE_FS_FATFS
 //#define CONFIG_CTSHELL_USE_FS_POSIX
+//#define CONFIG_CTSHELL_USE_FS_LITTLEFS
+//#define CONFIG_CTSHELL_USE_FS_WINDOWS
+//#define CONFIG_CTSHELL_USE_FS_ARDUINO_SD
 
 /* ================= Resource Limits ================= */
 #define CONFIG_CTSHELL_CMD_NAME_MAX_LEN    16
diff --git a/docs/en/api/api.rst b/docs/en/api/api.rst
@@ -196,17 +196,61 @@ Check if a termination signal (Ctrl+C) has been received.
 Filesystem API
 -------
 
-ctshell_fatfs_init
+ctshell_fs_fatfs_init
 ^^^^^^
-Initialize ctshell support for the FatFS file system. This should be called after ctshell initialization.
+Initialize ctshell support for the ``FatFS`` file system. This should be called after ctshell initialization.
 
 .. code-block:: c
 
-    void ctshell_fatfs_init(ctshell_ctx_t *ctx, ctshell_fs_t *fs);
+    void ctshell_fs_fatfs_init(ctshell_ctx_t *ctx);
+
+:Parameters:
+    * ``ctx``: A pointer to the Shell context.
+
+ctshell_fs_posix_init
+^^^^^^
+Initialize ctshell support for the ``POSIX`` file system. This should be called after ctshell initialization.
+
+.. code-block:: c
+
+    void ctshell_fs_posix_init(ctshell_ctx_t *ctx);
+
+:Parameters:
+    * ``ctx``: A pointer to the Shell context.
+
+ctshell_fs_windows_init
+^^^^^^
+Initialize ctshell support for the ``Win32`` file system. This should be called after ctshell initialization.
+
+.. code-block:: c
+
+    void ctshell_fs_windows_init(ctshell_ctx_t *ctx);
+
+:Parameters:
+    * ``ctx``: A pointer to the Shell context.
+
+ctshell_fs_littlefs_init
+^^^^^^
+Initialize ctshell support for the ``littlefs`` file system. This should be called after ctshell initialization.
+
+.. code-block:: c
+
+    void ctshell_fs_littlefs_init(ctshell_ctx_t *ctx, lfs_t *lfs);
+
+:Parameters:
+    * ``ctx``: A pointer to the Shell context.
+    * ``lfs``: A pointer to the LittleFS instance.
+
+ctshell_fs_arduino_sd_init
+^^^^^^
+Initialize ctshell support for the ``Arduino SD`` file system. This should be called after ctshell initialization.
+
+.. code-block:: c
+
+    void ctshell_fs_arduino_sd_init(ctshell_ctx_t *ctx);
 
 :Parameters:
     * ``ctx``: A pointer to the Shell context.
-    * ``fs``: A pointer to the file system interface structure.
 
 Command Register API
 -------
diff --git a/docs/en/index.rst b/docs/en/index.rst
@@ -18,7 +18,7 @@ Highlights
 * Signal Handling (SIGINT): Implements setjmp/longjmp logic to abort long-running commands via ``Ctrl+C``.
 * Built-in Argument Parser: Includes a strictly-typed argument parser to easily handle flags (bool), integers, strings, and verbs within custom commands.
 * ANSI Escape Sequence Support: Handles standard VT100/ANSI escape codes for arrow keys and screen control.
-* Filesystem Support: Out-of-box for ``FatFS`` now, other fs native support will come soon.
+* Filesystem Support: Out-of-box for FatFS, POSIX, Windows, littlefs, and Arduino SD.
 * Command Hierarchy Framework: Supports hierarchical command management.
 
 Porting
diff --git a/docs/en/quickstart/porting.rst b/docs/en/quickstart/porting.rst
@@ -70,7 +70,7 @@ Bare Metal Environment: Initialize the Shell after initializing the UART in the
         HAL_Init();
         MX_USART1_UART_Init();
 
-        ctshell_stm32_init(&ctx, &huart1);
+        ctshell_port_stm32_init(&ctx, &huart1);
 
         while (1) {
             ctshell_poll(&ctx);
@@ -82,7 +82,7 @@ RTOS Environment: It is recommended to create a dedicated task to run the Shell.
 .. code-block:: c
 
     void shell_task(void *argument) {
-        ctshell_stm32_init(&ctx, &huart1);
+        ctshell_port_stm32_init(&ctx, &huart1);
 
         while (1) {
             ctshell_poll(&ctx);
diff --git a/docs/zh/api/api.rst b/docs/zh/api/api.rst
@@ -196,17 +196,61 @@ ctshell_check_abort
 文件系统 API
 -------
 
-ctshell_fatfs_init
+ctshell_fs_fatfs_init
 ^^^^^^
 初始化 ctshell 对 ``FatFS`` 文件系统的支持。应当在ctshell初始化完成之后调用。
 
 .. code-block:: c
 
-    void ctshell_fatfs_init(ctshell_ctx_t *ctx, ctshell_fs_t *fs);
+    void ctshell_fs_fatfs_init(ctshell_ctx_t *ctx);
+
+:参数:
+    * ``ctx``: Shell 上下文指针。
+
+ctshell_fs_posix_init
+^^^^^^
+初始化 ctshell 对 ``POSIX`` 文件系统的支持。应当在ctshell初始化完成之后调用。
+
+.. code-block:: c
+
+    void ctshell_fs_posix_init(ctshell_ctx_t *ctx);
+
+:参数:
+    * ``ctx``: Shell 上下文指针。
+
+ctshell_fs_windows_init
+^^^^^^
+初始化 ctshell 对 ``Win32`` 文件系统的支持。应当在ctshell初始化完成之后调用。
+
+.. code-block:: c
+
+    void ctshell_fs_windows_init(ctshell_ctx_t *ctx);
+
+:参数:
+    * ``ctx``: Shell 上下文指针。
+
+ctshell_fs_littlefs_init
+^^^^^^
+初始化 ctshell 对 ``littlefs`` 文件系统的支持。应当在ctshell初始化完成之后调用。
+
+.. code-block:: c
+
+    void ctshell_fs_littlefs_init(ctshell_ctx_t *ctx, lfs_t *lfs);
+
+:参数:
+    * ``ctx``: Shell 上下文指针。
+    * ``lfs``: LittleFS 上下文指针。
+
+ctshell_fs_arduino_sd_init
+^^^^^^
+初始化 ctshell 对 ``Arduino SD`` 文件系统的支持。应当在ctshell初始化完成之后调用。
+
+.. code-block:: c
+
+    void ctshell_fs_arduino_sd_init(ctshell_ctx_t *ctx);
 
 :参数:
     * ``ctx``: Shell 上下文指针。
-    * ``fs``: 文件系统接口结构体指针。
 
 命令注册 API
 -------
diff --git a/docs/zh/index.rst b/docs/zh/index.rst
@@ -18,7 +18,7 @@ Ctshell 是一款小而美的、低开销的shell，专为资源受限的嵌入
 * 信号处理 (SIGINT)：实现 setjmp/longjmp 逻辑，可通过 Ctrl+C 中断长时间运行的命令。
 * 内置参数解析器：包含一个强类型参数解析器，可轻松处理自定义命令中的标志（布尔值）、整数、字符串和子命令。
 * ANSI 转义序列支持：处理用于箭头键和屏幕控制的标准 VT100/ANSI 转义码。
-* 文件系统支持：目前已原生支持 FatFS，其他文件系统的原生支持也将很快推出。
+* 文件系统支持：目前已原生支持 FatFS、POSIX、Windows、littlefs、Arduino SD。
 * 命令层级框架：支持层级式命令管理。
 
 移植
diff --git a/docs/zh/quickstart/porting.rst b/docs/zh/quickstart/porting.rst
@@ -70,7 +70,7 @@ stm32 使用中断接收示例：
         HAL_Init();
         MX_USART1_UART_Init();
 
-        ctshell_stm32_init(&ctx, &huart1);
+        ctshell_port_stm32_init(&ctx, &huart1);
 
         while (1) {
             ctshell_poll(&ctx);
@@ -82,7 +82,7 @@ RTOS 环境: 建议创建一个独立的任务来运行 Shell。
 .. code-block:: c
 
     void shell_task(void *argument) {
-        ctshell_stm32_init(&ctx, &huart1);
+        ctshell_port_stm32_init(&ctx, &huart1);
 
         while (1) {
             ctshell_poll(&ctx);
diff --git a/extension/fs/ctshell_fs_arduino_sd.cpp b/extension/fs/ctshell_fs_arduino_sd.cpp
diff --git a/extension/fs/ctshell_fs_littlefs.c b/extension/fs/ctshell_fs_littlefs.c
diff --git a/extension/fs/ctshell_fs_posix.c b/extension/fs/ctshell_fs_posix.c
diff --git a/extension/fs/ctshell_fs_windows.c b/extension/fs/ctshell_fs_windows.c
