基于ELM CHAN FatFS快速扫描STM32 USB MSC中含MP3的文件夹

针对多层目录（如8层）且文件量大时扫描耗时过长的问题，核心优化思路是减少无意义的目录遍历次数和降低USB磁盘IO操作，以下是具体可行的方案：

1. 基于FatFS的定向扫描+提前剪枝 #

利用FatFS的f_findfirst/f_findnext接口直接过滤MP3后缀，跳过无MP3文件的目录及其子目录：

• 遍历目录时，先通过通配符"*.mp3"/"*.MP3"快速检测当前目录是否存在目标文件
• 若当前目录无MP3，直接跳过其所有子目录的扫描（剪枝），避免深层无意义遍历
• 若存在MP3，记录该目录后再扫描其子目录（子目录可能也包含MP3）

示例代码 #

#include "ff.h"

// 检查指定目录是否包含MP3文件
static uint8_t has_mp3_files(const TCHAR *dir_path) {
    DIR dir;
    FILINFO file_info;
    FRESULT res;

    // 查找小写后缀MP3
    res = f_findfirst(&dir, &file_info, dir_path, _T("*.mp3"));
    if (res == FR_OK && !(file_info.fattrib & AM_DIR)) {
        f_closedir(&dir);
        return 1;
    }
    f_closedir(&dir);

    // 查找大写后缀MP3
    res = f_findfirst(&dir, &file_info, dir_path, _T("*.MP3"));
    if (res == FR_OK && !(file_info.fattrib & AM_DIR)) {
        f_closedir(&dir);
        return 1;
    }
    f_closedir(&dir);

    return 0;
}

// 迭代式扫描（避免递归栈溢出）
void scan_mp3_containing_dirs(void) {
    // 用数组模拟栈，存储待扫描的目录路径，适配8层以上目录
    TCHAR dir_stack[16][256];
    int stack_ptr = 0;
    DIR dir;
    FILINFO file_info;
    TCHAR sub_dir[256];

    // 根目录入栈
    _tcscpy(dir_stack[stack_ptr++], _T("/"));

    while (stack_ptr > 0) {
        TCHAR *current_dir = dir_stack[--stack_ptr];

        // 打开当前目录失败则跳过
        if (f_opendir(&dir, current_dir) != FR_OK) {
            continue;
        }

        // 检查当前目录是否有MP3，有则记录
        if (has_mp3_files(current_dir)) {
            // 替换为你的目录记录逻辑，比如存入链表或数组
            printf("MP3 directory found: %s\n", current_dir);
        }

        // 遍历子目录，入栈待扫描
        while (f_readdir(&dir, &file_info) == FR_OK && file_info.fname[0] != '\0') {
            if ((file_info.fattrib & AM_DIR) && 
                _tcscmp(file_info.fname, _T(".")) != 0 && 
                _tcscmp(file_info.fname, _T("..")) != 0) {
                // 拼接子目录路径
                _sntprintf(sub_dir, sizeof(sub_dir)/sizeof(TCHAR), _T("%s/%s"), current_dir, file_info.fname);
                // 栈未满则入栈
                if (stack_ptr < sizeof(dir_stack)/sizeof(dir_stack[0])) {
                    _tcscpy(dir_stack[stack_ptr++], sub_dir);
                }
            }
        }

        f_closedir(&dir);
    }
}

2. 优化FatFS配置减少IO开销 #

调整FatFS的配置参数，提升文件查找效率：

• 开启_USE_FIND宏（必须），启用f_findfirst/f_findnext接口
• 增大_MAX_SS（扇区大小）和缓存相关配置，减少磁盘读写次数
• 设置_FS_RPATH为1，支持相对路径，简化目录路径拼接
• 关闭_FS_TINY（若内存充足），使用更大的缓存区

3. 异步分块扫描（RTOS环境下） #

如果使用RTOS，将扫描任务拆分为小批量操作：

• 每次只扫描1~2个目录块，扫描完成后主动让出CPU
• 降低扫描任务的优先级，避免阻塞音频播放等核心任务
• 后台渐进式完成扫描，用户无感知

关键注意事项 #

• 大小写兼容：部分U盘的MP3后缀为大写.MP3，需同时处理两种后缀
• 栈溢出防范：避免递归扫描8层以上目录，改用迭代式栈结构实现
• 路径长度限制：确保_MAX_PATH配置足够覆盖最长目录路径

内容的提问来源于stack exchange，提问作者Nima Aghayan