# GD32G5
这个问题是 GD32G553CEU7 的 QSPI 在 Normal 模式写操作或 DMA 传输完成后,QSPI_STAT 寄存器的 BUSY 位没有自动清零,导致下一次传输前状态检测卡死。
根本原因通常不是时钟频率本身,而是 QSPI 状态机在写/DMA 传输结束后没有正确回到空闲状态,常见触发场景:
- DMA 传输完成中断里没有等 QSPI 真正空闲就清除了 DMA 标志,导致 QSPI 内部命令还没退完;
- Normal 模式写数据后,没有等待写 FIFO 完全排空(WTF 置位或 TXFL 归零)就结束;
- 连续切换 QSPI_MAP 和 QSPI_Normal 模式时,没有先复位 QSPI 状态机;
- 跨 4 字节边界的 DMA 传输在 G553CEU7 硅版本上存在已知的 QSPI BUSY 锁死 errata,某些版本需要软件规避。
立即排查步骤
-
DMA 完成中断里加 QSPI 空闲等待
在 DMA 传输完成中断里,先等待 QSPI_STAT 的 BUSY=0、WTF=1、RFF=1 全部满足,**再**清 DMA 中断标志。如果先清 DMA 标志,QSPI 内部状态机会卡死。// 在 DMA 完成中断里 while (qspi_stat_get() & QSPI_STAT_BUSY); // 等 BUSY 清零 while (!(qspi_stat_get() & QSPI_STAT_WTF)); // 等写传输完成 dma_interrupt_flag_clear(...); // 最后才清 DMA 标志 -
切换 QSPI_MAP / QSPI_Normal 前复位 QSPI
你的程序会切换 MAP 和 Normal 模式,切换前务必先关 QSPI,等 BUSY=0,再重新配置。qspi_disable(); while (qspi_stat_get() & QSPI_STAT_BUSY); // 确保状态机空闲 // 再切换模式 -
检查 Normal 模式写之后的等待
QSPI_Normal + DMA 写完数据后,只等 DMA 完成是不够的,必须再读一次 QSPI_STAT 确认 BUSY=0,否则下一个 qspi_config() 会卡住。 -
降低 QSPI 时钟测试
你已经在 54MHz、108MHz 都复现,说明不是单纯时钟过高,但可以试试 27MHz 看是否还会锁死。如果 27MHz 正常,108MHz 锁死,那就是 DMA 与 QSPI 时钟相位不匹配,需要在 DMA 配置里加一个周期延迟。 -
硅版本 Errata 规避
G553CEU7 早期版本在 DMA 传输非 4 字节对齐或跨页时,QSPI 状态机可能锁死。如果上述软件修改无效,尝试:- 强制 DMA 传输长度为 4 字节对齐;
- 在每次 DMA 传输前后加一个软件复位 QSPI(QSPI_SWRST = 1)再重新初始化;
- 避免在 QSPI_MAP 和 QSPI_Normal 之间快速切换,尽量保持一种模式。
快速临时恢复方案
既然重新下载程序能恢复,说明不是硬件损坏。你可以在每次检测 BUSY 卡死时,执行一次 QSPI 软件复位并重新初始化,而不是死等,避免整个程序卡死。
你用的是官方 GD32G5x 库还是自己写的寄存器操作?我可以给你一段完整的 QSPI 安全初始化和 DMA 完成中断模板。
1.检查下boot0引脚是否是悬空,怀疑是错误进BOOTLOADER导致错误。
👍

