当前位置：首页 > news >正文

GD32 Flash擦写异常排查：EXMC配置陷阱与pgerr的深层解析

news 2026/3/27 1:56:40

1. GD32 Flash擦写异常现象解析

最近在调试GD32芯片时遇到了一个诡异的问题：Flash擦写操作总是失败，wait状态持续返回pgerr错误。这个问题困扰了我整整两天，最后发现根源竟然在EXMC（外部存储器控制器）的配置上。相信不少朋友在用GD32做开发时都踩过类似的坑，今天我就把这个案例的排查过程完整分享出来。

先描述下具体现象：当调用flash_erase_page()函数时，程序会卡在wait状态，最终返回PGERR（编程错误）标志。更奇怪的是，这个问题不是每次必现，有时候能正常擦写，有时候又会莫名其妙失败。我用逻辑分析仪抓取总线信号发现，在失败时Flash芯片根本没有收到正确的擦除指令序列。

2. EXMC配置的隐藏陷阱

2.1 初始化结构体的内存分配问题

问题的核心出在EXMC初始化结构体的使用方式上。查看GD32的标准库，EXMC的配置结构体定义如下：

typedef struct { uint32_t norsram_region; uint32_t write_mode; //...其他配置项省略... exmc_norsram_timing_parameter_struct* read_write_timing; exmc_norsram_timing_parameter_struct* write_timing; } exmc_norsram_parameter_struct;

这里有个非常容易忽略的细节：最后两个时序参数是以指针形式定义的。很多开发者（包括我）会直接这样初始化：

exmc_norsram_parameter_struct exmc_init_struct; exmc_init_struct.read_write_timing->asyn_access_mode = EXMC_ACCESS_MODE_A; //...其他赋值操作...

这种写法其实存在严重问题。我们只是声明了结构体变量，但read_write_timing和write_timing这两个指针并没有指向有效的内存空间。直接对野指针进行赋值操作会导致未定义行为。

2.2 正确的初始化方式

正确的做法应该是先为时序参数分配内存：

exmc_norsram_timing_parameter_struct read_write_timing; exmc_norsram_timing_parameter_struct write_timing; exmc_norsram_parameter_struct exmc_init_struct; exmc_init_struct.read_write_timing = &read_write_timing; exmc_init_struct.write_timing = &write_timing; //...然后才能安全地进行赋值操作...

在实际项目中，我发现即使不初始化这两个时序结构体（保留默认值），只要指针指向了有效内存，Flash操作就能正常进行。这解释了为什么有些情况下代码能"偶然"工作。

3. pgerr错误的深层原因

3.1 EXMC总线冲突分析

当EXMC配置不正确时，会导致总线访问时序异常。Flash芯片对操作时序有严格要求，特别是擦除和编程操作。以GD32F303系列为例，擦除一个page的标准流程应该是：

发送解锁序列（0x45670123, 0xCDEF89AB）
发送擦除命令（0x00000080）
发送确认命令（0x00000030）
等待操作完成（检查BUSY位）

但在EXMC配置错误的情况下，逻辑分析仪捕获到的信号显示：第二步和第三步的命令有时会合并成一个异常的总线周期，导致Flash控制器无法识别有效命令序列，最终触发pgerr。

3.2 硬件调试技巧

遇到这类问题时，建议采用以下调试方法：

用逻辑分析仪抓取EXMC总线信号，重点检查：
- 地址线/数据线的建立和保持时间
- 片选信号和写使能的时序关系
- 命令序列的完整性
在代码中插入多个flash操作检查点，通过读取Flash状态寄存器（FSR）来定位失败的具体阶段。
尝试降低系统时钟频率，观察问题是否消失。如果问题与频率相关，很可能是时序配置不当。

4. 完整解决方案与优化建议

4.1 修复代码示例

基于以上分析，给出一个完整的EXMC初始化示例：

void EXMC_Config(void) { exmc_norsram_timing_parameter_struct timing_init_struct; exmc_norsram_parameter_struct exmc_init_struct; /* 配置时序参数 */ timing_init_struct.asyn_access_mode = EXMC_ACCESS_MODE_A; timing_init_struct.asyn_data_setuptime = 5; timing_init_struct.asyn_address_holdtime = 1; timing_init_struct.asyn_address_setuptime = 5; /* 配置EXMC参数 */ exmc_init_struct.norsram_region = EXMC_BANK0_NORSRAM_REGION0; exmc_init_struct.write_mode = EXMC_ASYN_WRITE; //...其他参数配置... exmc_init_struct.read_write_timing = &timing_init_struct; exmc_init_struct.write_timing = &timing_init_struct; /* 初始化EXMC */ exmc_norsram_init(&exmc_init_struct); exmc_norsram_enable(EXMC_BANK0_NORSRAM_REGION0); }