Skip to content

Conversation

@LinuxMint-User
Copy link
Contributor

@LinuxMint-User LinuxMint-User commented Jan 12, 2026

Add sdcard mount retries in case SDIO init done after mount.

拉取/合并请求描述:(PR description)

[

为什么提交这份PR (why to submit this PR)

修复 stm32f407-atk-explorer BSP 中 SD 卡挂载失败的问题。由于 SDIO 初始化(特别是高速模式切换)耗时较长,导致文件系统挂载时 SD 卡设备尚未就绪。

你的解决方案是什么 (what is your solution)

在文件系统挂载函数中添加延迟重试机制:

  1. 等待 SD 卡设备初始化完成后再尝试挂载
  2. 以 200ms 为间隔重试 15 次(共计 3 秒),覆盖典型初始化时间
  3. 仅在首次重试时打印等待提示,减少控制台干扰

此方案不修改 RT-Thread 框架初始化顺序,保持向后兼容。

请提供验证的bsp和config (provide the config and bsp)

  • BSP: bsp/stm32/stm32f407-atk-explorer
  • .config: 默认配置
  • 验证结果:SD 卡在启动后自动挂载成功
    ]

当前拉取/合并请求的状态 Intent for your PR

必须选择一项 Choose one (Mandatory):

  • 本拉取/合并请求是一个草稿版本 This PR is for a code-review and is intended to get feedback
  • 本拉取/合并请求是一个成熟版本 This PR is mature, and ready to be integrated into the repo

代码质量 Code Quality:

我在这个拉取/合并请求中已经考虑了 As part of this pull request, I've considered the following:

  • 已经仔细查看过代码改动的对比 Already check the difference between PR and old code
  • 代码风格正确,包括缩进空格,命名及其他风格 Style guide is adhered to, including spacing, naming and other styles
  • 没有垃圾代码,代码尽量精简,不包含#if 0代码,不包含已经被注释了的代码 All redundant code is removed and cleaned up
  • 所有变更均有原因及合理的,并且不会影响到其他软件组件代码或BSP All modifications are justified and not affect other components or BSP
  • 对难懂代码均提供对应的注释 I've commented appropriately where code is tricky
  • 代码是高质量的 Code in this PR is of high quality
  • 已经使用formatting 等源码格式化工具确保格式符合RT-Thread代码规范 This PR complies with RT-Thread code specification
  • 如果是新增bsp, 已经添加ci检查到.github/ALL_BSP_COMPILE.json 详细请参考链接BSP自查

@github-actions
Copy link

👋 感谢您对 RT-Thread 的贡献!Thank you for your contribution to RT-Thread!

为确保代码符合 RT-Thread 的编码规范,请在你的仓库中执行以下步骤运行代码格式化工作流(如果格式化CI运行失败)。
To ensure your code complies with RT-Thread's coding style, please run the code formatting workflow by following the steps below (If the formatting of CI fails to run).


🛠 操作步骤 | Steps

  1. 前往 Actions 页面 | Go to the Actions page
    点击进入工作流 → | Click to open workflow →

  2. 点击 Run workflow | Click Run workflow

  • 设置需排除的文件/目录(目录请以"/"结尾)
    Set files/directories to exclude (directories should end with "/")
  • 将目标分支设置为 \ Set the target branch to:dev
  • 设置PR number为 \ Set the PR number to:11134
  1. 等待工作流完成 | Wait for the workflow to complete
    格式化后的代码将自动推送至你的分支。
    The formatted code will be automatically pushed to your branch.

完成后,提交将自动更新至 dev 分支,关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the dev branch automatically, and the related Pull Request will be updated.

如有问题欢迎联系我们,再次感谢您的贡献!💐
If you have any questions, feel free to reach out. Thanks again for your contribution!

@github-actions
Copy link

github-actions bot commented Jan 12, 2026

📌 Code Review Assignment

🏷️ Tag: bsp_stm32

Reviewers: Liang1795 hamburger-os wdfk-prog

Changed Files (Click to expand)
  • bsp/stm32/stm32f407-atk-explorer/board/ports/drv_filesystem.c

📊 Current Review Status (Last Updated: 2026-01-13 22:41 CST)

  • Liang1795 Pending Review
  • hamburger-os Pending Review
  • wdfk-prog Pending Review

📝 Review Instructions

  1. 维护者可以通过单击此处来刷新审查状态: 🔄 刷新状态
    Maintainers can refresh the review status by clicking here: 🔄 Refresh Status

  2. 确认审核通过后评论 LGTM/lgtm
    Comment LGTM/lgtm after confirming approval

  3. PR合并前需至少一位维护者确认
    PR must be confirmed by at least one maintainer before merging

ℹ️ 刷新CI状态操作需要具备仓库写入权限。
ℹ️ Refresh CI status operation requires repository Write permission.

@github-actions github-actions bot added BSP: STM32 BSP related with ST/STM32 BSP labels Jan 12, 2026
@LinuxMint-User
Copy link
Contributor Author

大家好,

我注意到 Static code analysis(cppcheck)在 job #60071615567 失败,原因是在板级文件 bsp/stm32/stm32f407-atk-explorer/board/ports/drv_filesystem.c 中触发了预处理器错误:

#error "Please define DFS_FILESYSTEMS_MAX more than 4"

文件位置(触发该错误的提交):https://github.com/RT-Thread/rt-thread/blob/14e64b3fd2a1f901fab2cfa751288edcb737d4a8/bsp/stm32/stm32f407-atk-explorer/board/ports/drv_filesystem.c (ref: 14e64b3)

看起来这是由板级/配置差异导致的,会使 cppcheck 把检查视为致命错误并中断 CI��本人仍希望对本次变更开展功能和实现方面的审查,不希望该静态检查阻碍审查流程。

若大家同意,我可以提交一个小修复(例如将 #error 改为 #warning,或在 CI 中对 preprocessorErrorDirective 做 suppress),以避免 CI 因单板配置差异而阻断静态检查;如果你们希望由维护者来处理也没问题,请告知偏好方案。

感谢审查与指点!
— LinuxMint-User

@wdfk-prog
Copy link
Contributor

  • 这是ART-PI STM32H7的SD卡启动与检测代码;这样可以热插拔SD卡进行检测识别
  • 这样应该更好
static void _sdcard_mount(void)
{
    rt_device_t device;

    device = rt_device_find("sd0");

    if (device == NULL)
    {
        mmcsd_wait_cd_changed(0);
        stm32_mmcsd_change();
        mmcsd_wait_cd_changed(RT_WAITING_FOREVER);
        device = rt_device_find("sd0");
    }

    if (device != RT_NULL)
    {
        rt_err_t ret = RT_EOK;
        if (dfs_mount("sd0", "/sdcard", "elm", 0, 0) == RT_EOK)
        {
            LOG_I("sd card mount to '/sdcard'");
        }
        else
        {
            dfs_mkfs("elm", "sd0");
            if (dfs_mount("sd0", "/sdcard", "elm", 0, 0) == RT_EOK)
            {
                LOG_I("sd card mkfs to '/sdcard'");
            }
            else
            {
                LOG_W("sd card mount to '/sdcard' failed!");
                ret = -RT_ERROR;
            }
        }
#if (OUT_FILE_ENABLE == 1)
        if(ret == RT_EOK)
        {
            sdcard_sys_log_file_backend_init();
        }
#endif /*(OUT_FILE_ENABLE == 1)*/
    }
    else
    {
        LOG_E("find 'sd0' failed!");
    }
}

static void _sdcard_unmount(void)
{
    rt_thread_mdelay(200);
    dfs_unmount("/sdcard");
    LOG_I("Unmount \"/sdcard\"");

    mmcsd_wait_cd_changed(0);
    stm32_mmcsd_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();
        }
    }
}

@Rbb666
Copy link
Member

Rbb666 commented Jan 13, 2026

  • 这是ART-PI STM32H7的SD卡启动与检测代码;这样可以热插拔SD卡进行检测识别
  • 这样应该更好
static void _sdcard_mount(void)
{
    rt_device_t device;

    device = rt_device_find("sd0");

    if (device == NULL)
    {
        mmcsd_wait_cd_changed(0);
        stm32_mmcsd_change();
        mmcsd_wait_cd_changed(RT_WAITING_FOREVER);
        device = rt_device_find("sd0");
    }

    if (device != RT_NULL)
    {
        rt_err_t ret = RT_EOK;
        if (dfs_mount("sd0", "/sdcard", "elm", 0, 0) == RT_EOK)
        {
            LOG_I("sd card mount to '/sdcard'");
        }
        else
        {
            dfs_mkfs("elm", "sd0");
            if (dfs_mount("sd0", "/sdcard", "elm", 0, 0) == RT_EOK)
            {
                LOG_I("sd card mkfs to '/sdcard'");
            }
            else
            {
                LOG_W("sd card mount to '/sdcard' failed!");
                ret = -RT_ERROR;
            }
        }
#if (OUT_FILE_ENABLE == 1)
        if(ret == RT_EOK)
        {
            sdcard_sys_log_file_backend_init();
        }
#endif /*(OUT_FILE_ENABLE == 1)*/
    }
    else
    {
        LOG_E("find 'sd0' failed!");
    }
}

static void _sdcard_unmount(void)
{
    rt_thread_mdelay(200);
    dfs_unmount("/sdcard");
    LOG_I("Unmount \"/sdcard\"");

    mmcsd_wait_cd_changed(0);
    stm32_mmcsd_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();
        }
    }
}

我也赞同这种挂载方式,支持动态热插拔,如果硬件不支持CD引脚检测可以不添加热插拔线程

@LinuxMint-User LinuxMint-User changed the title Feature: Add sdcard mount retries Fix: Add sdcard detect before mount in case auto mount failed Jan 13, 2026
@LinuxMint-User
Copy link
Contributor Author

已按照示例修改代码。

改进说明

  • 采用ART-PI的SD卡检测模式,解决启动时挂载失败问题
  • 由于硬件无CD检测引脚,添加500ms超时机制,避免无卡时永久阻塞

测试结果

  • 插卡启动:SD卡自动挂载成功
  • 不插卡启动:500ms后跳过挂载,正常进入系统
  • 运行时插卡:需手动挂载(当前硬件设计限制)

@Rbb666
Copy link
Member

Rbb666 commented Jan 13, 2026

还请压缩成一个 commit 提交谢谢

Add sdcard detect before mount in case auto mount failed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

BSP: STM32 BSP related with ST/STM32 BSP

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants