Skip to content

[bsp][spi flash]: 优化GD32F470 SPI Flash初始化和UART0配置#10983

Merged
kurisaW merged 2 commits intoRT-Thread:masterfrom
godmial:master
Dec 1, 2025
Merged

[bsp][spi flash]: 优化GD32F470 SPI Flash初始化和UART0配置#10983
kurisaW merged 2 commits intoRT-Thread:masterfrom
godmial:master

Conversation

@godmial
Copy link
Contributor

@godmial godmial commented Nov 28, 2025 •
edited
Loading

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

[

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

当前GD32F470 BSP的SPI Flash驱动存在以下问题：

  1. 当用户启用RT_USING_SFUD并配置多个SPI接口时，驱动会自动在所有启用的SPI总线上调用rt_sfud_flash_probe进行Flash初始化，这会导致问题。因为某些SPI接口可能用于其他设备（如OLED显示屏、WIFI模块等），在这些接口上尝试初始化Flash会导致其他设备初始化异常。
  2. UART0的AFIO默认配置为AF1，但实际硬件需要使用AF7才能正常工作，导致串口无响应。

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

  1. SPI Flash初始化优化：

    • 在board/Kconfig中添加了BSP_USING_SPI_FLASH菜单配置选项，允许用户选择是否启用SPI Flash自动初始化
    • 为每个SPI总线（SPI0-SPI5）添加了独立的Flash初始化配置选项（BSP_USING_SPIx_FLASH），用户可以选择在哪些SPI总线上初始化Flash
    • 修改drv_spi_flash.c，使Flash初始化仅在用户明确配置的SPI总线上进行，避免与其他SPI设备冲突
    • 添加了SPI5 Flash支持
    • 使用条件编译#ifdef BSP_USING_SPI_FLASH包裹整个初始化函数，当用户禁用自动初始化时，不会编译相关代码

  2. UART0配置修复：

    • 将BSP_UART0_AFIO的默认值从"AF1"改为"AF7"，修复串口无响应问题

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

  • BSP: bsp/gd32/arm/gd32470z-lckfb

  • .config:

    • CONFIG_BSP_USING_SPI=y - 启用SPI总线支持
    • CONFIG_BSP_USING_SPI_FLASH=y - 启用SPI Flash自动初始化（可选）
    • CONFIG_BSP_USING_SPIx_FLASH=y - 选择在哪些SPI总线上初始化Flash（x为0-5，根据实际硬件连接选择）
    • CONFIG_BSP_UART0_AFIO="AF7" - UART0复用功能配置为AF7
    • CONFIG_RT_USING_SFUD=y - 启用SFUD驱动（当启用SPI Flash时自动选择）

  • action:

]

当前拉取/合并请求的状态 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自查

@godmial
feat(gd32): 优化GD32F470 SPI Flash初始化和UART0配置
b8803c3 
主要修改：
1. SPI Flash初始化优化
   - 添加可配置的SPI Flash自动初始化选项(BSP_USING_SPI_FLASH)
   - 支持按SPI总线独立配置Flash初始化(BSP_USING_SPIx_FLASH)
   - 避免SPI Flash初始化与其他SPI设备(如OLED、WIFI)冲突
   - 添加SPI5 Flash支持
   - 修改drv_spi_flash.c，仅在明确配置的SPI总线上初始化Flash

2. UART0配置修复
   - 将UART0的AFIO默认值从AF1改为AF7
   - 修复串口无响应问题

这些修改使得用户可以更灵活地配置SPI Flash初始化，避免自动初始化导致的设备冲突问题。
@godmial godmial requested a review from kurisaW as a code owner November 28, 2025 07:56
@github-actions
Copy link

github-actions bot commented Nov 28, 2025

👋 感谢您对 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：master
  • 设置PR number为 \ Set the PR number to：10983
  1. 等待工作流完成 | Wait for the workflow to complete
    格式化后的代码将自动推送至你的分支。
    The formatted code will be automatically pushed to your branch.

完成后，提交将自动更新至 master 分支，关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the master 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 github-actions bot added BSP BSP: GD32 BSP related with GD32 labels Nov 28, 2025
@github-actions
Copy link

github-actions bot commented Nov 28, 2025 •
edited
Loading

📌 Code Review Assignment

🏷️ Tag: bsp_gd32470z-lckfb

Reviewers: godmial

Changed Files (Click to expand)
  • bsp/gd32/arm/gd32470z-lckfb/.config
  • bsp/gd32/arm/gd32470z-lckfb/board/Kconfig
  • bsp/gd32/arm/gd32470z-lckfb/rtconfig.h

📊 Current Review Status (Last Updated: 2025-12-01 11:58 CST)

  • ⌛ godmial 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.

@ReviewSun
Copy link
Contributor

ReviewSun commented Nov 28, 2025

LGTM

@kurisaW
Copy link
Member

kurisaW commented Nov 30, 2025

GD/arm 每个系列都会有一个板载flash吗？如果只是某个bsp带flash，其实这个drv_spi_flash.c更建议放到bsp/board级别下作为一个demo，没必要上升到通用驱动级别

@godmial
Copy link
Contributor Author

godmial commented Dec 1, 2025

GD/arm 每个系列都会有一个板载flash吗？如果只是某个bsp带flash，其实这个drv_spi_flash.c更建议放到bsp/board级别下作为一个demo，没必要上升到通用驱动级别

这是之前的解决方案，如果放到具体某个bsp/board的话，那就需要你们官方来做了

kurisaW
kurisaW reviewed Dec 1, 2025
View reviewed changes
@kurisaW
Copy link
Member

kurisaW commented Dec 1, 2025

GD/arm 每个系列都会有一个板载flash吗？如果只是某个bsp带flash，其实这个drv_spi_flash.c更建议放到bsp/board级别下作为一个demo，没必要上升到通用驱动级别

这是之前的解决方案，如果放到具体某个bsp/board的话，那就需要你们官方来做了

那就先放到这里吧，另外请针对这个bsp补充对BSP_USING_SPI的配置项，确保一键开启可用，并测试通过后提交截图

@godmial
Copy link
Contributor Author

godmial commented Dec 1, 2025

GD/arm 每个系列都会有一个板载flash吗？如果只是某个bsp带flash，其实这个drv_spi_flash.c更建议放到bsp/board级别下作为一个demo，没必要上升到通用驱动级别

这是之前的解决方案，如果放到具体某个bsp/board的话，那就需要你们官方来做了

那就先放到这里吧，另外请针对这个bsp补充对BSP_USING_SPI的配置项，确保一键开启可用，并测试通过后提交截图

初始化正常：
Snipaste_2025-12-01_11-10-51

SFUD挂载flash正常：
Snipaste_2025-12-01_11-11-26

sf bench命令运行正常：
Snipaste_2025-12-01_11-13-26

@kurisaW kurisaW changed the title [bsp] 优化GD32F470 SPI Flash初始化和UART0配置 [bsp][spi flash]: 优化GD32F470 SPI Flash初始化和UART0配置 Dec 1, 2025
@kurisaW
Copy link
Member

kurisaW commented Dec 1, 2025

请压缩一下提交

@godmial godmial requested a review from kurisaW December 1, 2025 05:23
@kurisaW kurisaW merged commit 2fb53c8 into RT-Thread:master Dec 1, 2025
30 checks passed
Dailingxiang1 pushed a commit to Dailingxiang1/rt-thread that referenced this pull request Dec 11, 2025
@godmial @Dailingxiang1
[bsp][spi flash]: 优化GD32F470 SPI Flash初始化和UART0配置 (RT-Thread#10983)
a8c548d 
* feat(gd32): 优化GD32F470 SPI Flash初始化和UART0配置

主要修改：
1. SPI Flash初始化优化
   - 添加可配置的SPI Flash自动初始化选项(BSP_USING_SPI_FLASH)
   - 支持按SPI总线独立配置Flash初始化(BSP_USING_SPIx_FLASH)
   - 避免SPI Flash初始化与其他SPI设备(如OLED、WIFI)冲突
   - 添加SPI5 Flash支持
   - 修改drv_spi_flash.c，仅在明确配置的SPI总线上初始化Flash

2. UART0配置修复
   - 将UART0的AFIO默认值从AF1改为AF7
   - 修复串口无响应问题

这些修改使得用户可以更灵活地配置SPI Flash初始化，避免自动初始化导致的设备冲突问题。

* feat(gd32): 解耦SPI Flash与SFUD的依赖关系
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@kurisaW kurisaW Awaiting requested review from kurisaW kurisaW is a code owner

Assignees

No one assigned

Labels

BSP: GD32 BSP related with GD32 BSP

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@godmial @ReviewSun @kurisaW