企业官网建设流程全解析

简介：这份《GD32F10X中文用户手册》面向使用GD32F10X系列Arm Cortex-M3 32位MCU进行嵌入式开发的工程师与学习者，是官方技术文档的中文版本，可帮助读者理解芯片系统架构、外设接口与底层编程机制。手册内容覆盖Cortex-M3处理器、时钟与电源管理、复位与中断系统、存储器映射、位带操作、片上SRAM与FLASH、引导配置及设备电子签名等核心模块，并延伸至FMC闪存控制器、UART、SPI、I2C、定时器、ADC、GPIO、DMA、CRC等外设说明，适合系统设计、编程调试与故障排查时查阅。资源包共1个PDF文件，大小约26.43MB，版本为2.6（2022年6月），目录与图表索引完整，便于按章节快速定位。目前已有606人学习下载，可作为GD32F10X开发过程中的常备参考资料。

1. 从一份中文用户手册说起：GD32F10X 到底该怎么上手

GD32F10X 中文用户手册，是很多人从 STM32 转国产 MCU 时翻得最勤的一份文档。它不像数据手册那样只给电气参数，而是把时钟树、中断向量、外设寄存器、Flash 控制器、电源管理这些真正决定代码能不能跑起来的东西，按模块拆开讲清楚。我见过太多人拿到一块 GD32F10X 的开发板，照着 STM32 的例程改个型号就烧进去，结果串口不出数、定时器不翻转、中断进不去，最后翻回手册才发现是时钟源默认配置不同、AFIO 重映射没开、或者中断优先级分组没设。这份手册解决的就是这类问题：它告诉你每个外设的寄存器位怎么配、复位值是多少、有哪些隐藏约束。适合谁？适合已经会写 C、用过一款 Cortex-M3 芯片、现在要切到 GD32F10X 做量产或替换方案的嵌入式工程师。新手能靠它把第一个点灯和串口跑通，熟手能靠它查边界条件，比如 Flash 擦写时的等待周期、ADC 采样时间与外部阻抗的关系。

2. 时钟树与启动流程：为什么你的第一个工程跑不起来

2.1 上电后芯片到底走了哪几步

GD32F10X 上电复位后，默认使用内部 8MHz RC 振荡器（IRC8M）作为系统时钟源，经过 PLL 倍频后最高可到 108MHz。但很多从 STM32F103 转过来的人会默认以为外部晶振自动起振，实际上手册里写得很清楚：复位后 SYSCLK 选择 IRC8M，外部高速晶振（HXTAL）需要软件使能并等待稳定标志。如果你直接写SystemInit()然后配外设，而SystemInit()里没有等 HXTAL 稳定，就会出现“程序跑起来了但串口波特率差一倍”的玄学现象。常见做法是：先使能 HXTAL，轮询RCU_CTL的HXTALSTB位，稳定后再切换 PLL 源并配置分频系数。下面这段初始化代码是我在多个 GD32F10X 项目里反复用的最小版本。

#include "gd32f10x.h" void system_clock_config(void) { /* 使能外部高速晶振 */ RCU_CTL |= RCU_CTL_HXTALEN; /* 等待 HXTAL 稳定，超时则退回 IRC8M */ while(!(RCU_CTL & RCU_CTL_HXTALSTB)) { if(timeout--) { /* 超时处理：保持 IRC8M，记录错误标志 */ return; } } /* 配置 PLL：HXTAL 8MHz 倍频到 108MHz */ RCU_CFG0 &= ~(RCU_CFG0_PLLSEL | RCU_CFG0_PLLMF); RCU_CFG0 |= RCU_PLLSRC_HXTAL | RCU_PLL_MUL27; /* 8M * 27 = 216M，再二分频 */ /* 使能 PLL 并等待锁定 */ RCU_CTL |= RCU_CTL_PLLEN; while(!(RCU_CTL & RCU_CTL_PLLSTB)); /* 切换系统时钟到 PLL */ RCU_CFG0 &= ~RCU_CFG0_SCS; RCU_CFG0 |= RCU_CKSYSSRC_PLL; while((RCU_CFG0 & RCU_CFG0_SCSS) != RCU_SCSS_PLL); }

逻辑说明：RCU_CTL_HXTALEN打开外部晶振，HXTALSTB是稳定标志，必须轮询等待，不能直接延时了事。PLL 倍频系数根据目标频率算，GD32F10X 的 PLL 输出范围有上限，108MHz 是常见安全值。参数说明：RCU_PLL_MUL27对应 27 倍频，若你的板子焊的是 8MHz 晶振，得到 216MHz，再经 AHB 二分频得到 108MHz；若焊的是 12MHz，倍频系数要改，否则超频翻车。切换系统时钟后一定要读SCSS状态位确认，不能只写不读。

2.2 中断向量表重映射与启动文件选择

GD32F10X 的中断向量表默认从 Flash 0x08000000 开始，但如果你用了 IAP 升级或者把程序放到别的地址，就需要重映射。手册里SCB->VTOR寄存器就是干这个的。另一个容易踩的坑是启动文件：GD32F10X 的启动文件里中断服务函数名和 STM32 不完全一样，比如USART0_IRQHandler而不是USART1_IRQHandler。如果你直接拿 STM32 的stm32f10x_it.c改，编译能过但中断永远不进。我一般会从官方固件库的startup_gd32f10x_hd.s里复制中断向量表，再对照手册的中断章节逐个核对。下面是一个重映射向量的写法。

/* 将中断向量表偏移到 0x08004000，用于 Bootloader 跳转 */ #define VECT_TAB_OFFSET 0x4000 SCB->VTOR = FLASH_BASE | VECT_TAB_OFFSET; /* 开全局中断前先关，配完再开 */ __disable_irq(); /* 外设中断优先级配置 */ nvic_irq_enable(USART0_IRQn, 1, 0); __enable_irq();

逻辑说明：SCB->VTOR告诉内核去哪里取中断入口，偏移量必须是 0x200 的整数倍。nvic_irq_enable的第二个参数是抢占优先级，第三个是子优先级，GD32F10X 支持 4 位优先级，分组方式在SCB->AIRCR里设。参数说明：偏移量根据你的 Bootloader 大小定，常见 0x4000 对应 16KB。注意：改 VTOR 之前要确保新向量表已经烧录到对应地址，否则中断一来就 HardFault。

3. 外设寄存器操作：从 GPIO 到 USART 的落地路径

3.1 GPIO 模式配置的四个必调参数

GD32F10X 的 GPIO 每个引脚有 4 个配置位：模式（输入/输出）、输出类型（推挽/开漏）、输出速度、上下拉。手册里GPIOx_CTL0和GPIOx_CTL1两个寄存器管 16 个引脚，每 4 位一个引脚。很多人点灯不亮，就是因为把输出速度设成了 2MHz 却驱动了长走线，或者开漏输出没加上拉。我一般按这个顺序配：先使能 RCU 时钟，再设模式，最后设上下拉。下面以 PA9 推挽输出、PA10 浮空输入为例。

/* 使能 GPIOA 时钟 */ RCU_APB2EN |= RCU_APB2EN_PAEN; /* PA9：推挽输出，速度 50MHz */ GPIOA_CTL1 &= ~(0xF << 4); /* 清 4 位 */ GPIOA_CTL1 |= (0x3 << 4) | (0x3 << 6); /* 输出模式，50MHz */ /* PA10：浮空输入 */ GPIOA_CTL1 &= ~(0xF << 8); GPIOA_CTL1 |= (0x4 << 8); /* 输入模式，浮空 */ /* 若需要上拉，操作 GPIOA_BOP 和 GPIOA_BC 寄存器 */ GPIOA_BOP = GPIO_PIN_10; /* 置位上拉 */

逻辑说明：CTL1管引脚 8 到 15，每 4 位一组。0x3表示输出模式 50MHz，0x4表示输入浮空。参数说明：输出速度不是越高越好，50MHz 适合 SPI 和高速串口，普通 LED 用 2MHz 就够，减少 EMI。上下拉通过BOP（置位）和BC（复位）寄存器操作，写 1 有效，写 0 无影响。注意：配置输入前最好先写BOP或BC确定上下拉状态，否则浮空输入在悬空时读数随机。

3.2 USART 波特率计算与中断收发

USART 是调试阶段最常用的外设，GD32F10X 的波特率计算公式在手册里写得很清楚：baud = fCK / (16 * USARTDIV)，其中USARTDIV是整数部分加小数部分，小数部分用 4 位表示。很多人直接用 STM32 的库函数算，结果波特率偏差大，串口出乱码。我一般直接按手册公式手算，再写进USART_BAUD寄存器。下面以 108MHz 系统时钟、115200 波特率为例。

/* 使能 USART0 和 GPIOA 时钟 */ RCU_APB2EN |= RCU_APB2EN_USART0EN | RCU_APB2EN_PAEN; /* PA9 TX 复用推挽，PA10 RX 浮空输入 */ GPIOA_CTL1 &= ~(0xF << 4); GPIOA_CTL1 |= (0xB << 4); /* 复用推挽输出，50MHz */ GPIOA_CTL1 &= ~(0xF << 8); GPIOA_CTL1 |= (0x4 << 8); /* 浮空输入 */ /* 波特率计算：108000000 / (16 * 115200) = 58.59375 */ /* 整数部分 58 = 0x3A，小数部分 0.59375 * 16 = 9.5 ≈ 10 = 0xA */ USART_BAUD = (0x3A << 4) | 0x0A; /* 使能收发和 USART */ USART_CTL0 |= USART_CTL0_TEN | USART_CTL0_REN | USART_CTL0_UEN; /* 使能接收中断 */ USART_CTL0 |= USART_CTL0_RBNEIE; nvic_irq_enable(USART0_IRQn, 0, 0);

逻辑说明：USART_BAUD的高 12 位是整数部分，低 4 位是小数部分。小数部分四舍五入到最接近的 1/16。参数说明：108MHz 下 115200 的误差约 0.15%，在容忍范围内；若用 8MHz 时钟，误差会大到 7%，必须换晶振或改波特率。中断收发时，读USART_DATA会自动清RBNE标志，但要注意溢出错误ORERR，一旦置位必须读STAT再读DATA才能清。

3.3 定时器 PWM 输出的占空比与频率联动

GD32F10X 的高级定时器 TIMER0 和通用定时器 TIMER1~4 都支持 PWM。手册里TIMERx_CAR是自动重装载值，TIMERx_CH0CV是捕获比较值，PWM 频率 = 时钟 / (CAR + 1)，占空比 = CH0CV / (CAR + 1)。很多人改占空比时只改 CH0CV，忘了 CAR 决定频率，结果频率也跟着变。我一般先定频率再调占空比。下面以 TIMER1 通道 0 输出 1kHz、占空比 50% 为例，系统时钟 108MHz，APB1 定时器时钟 54MHz。

/* 使能 TIMER1 时钟 */ RCU_APB1EN |= RCU_APB1EN_TIMER1EN; /* 预分频 54-1，得到 1MHz 计数时钟 */ TIMER1_PSC = 54 - 1; /* 自动重装载 1000-1，得到 1kHz */ TIMER1_CAR = 1000 - 1; /* 通道 0 比较值 500，占空比 50% */ TIMER1_CH0CV = 500; /* 配置通道 0 为 PWM 模式 0 */ TIMER1_CHCTL0 &= ~TIMER_CHCTL0_CH0COMCTL; TIMER1_CHCTL0 |= (0x7 << 4); /* PWM 模式 0 */ /* 使能通道 0 输出和定时器 */ TIMER1_CHCTL2 |= TIMER_CHCTL2_CH0EN; TIMER1_CTL0 |= TIMER_CTL0_CEN;

逻辑说明：PSC是预分频，实际分频系数是PSC + 1。CAR是重装载值，实际周期是CAR + 1个计数。CH0CV决定高电平时间。参数说明：PWM 模式 0 是向上计数时CNT < CH0CV输出有效电平，模式 1 相反。注意：改CAR或PSC时最好先关定时器CEN，改完再开，否则可能出现一个异常周期。

4. 避坑与排查：GD32F10X 手册里没明说但一定会遇到的 5 个问题

4.1 现象：程序烧进去不跑，复位后无反应

原因：GD32F10X 的 Flash 等待周期和 STM32 不同。手册里FMC_WS寄存器需要根据系统时钟设置等待周期，108MHz 下需要 2 个等待周期。如果你直接拿 STM32 的FLASH_SetLatency(FLASH_Latency_2)改过来但没改寄存器名，或者忘了设，CPU 取指就会出错。解决：在时钟切换前设置FMC_WS = FMC_WC_WSCNT_2，并确保FMC_WS的WSCNT位正确。

4.2 现象：串口能发不能收，或者收几个字节就死

原因：GD32F10X 的 USART 状态寄存器里RBNE和ORERR是联动的。如果你在中断里只读DATA不清ORERR，溢出后接收就卡死。手册里写了清除顺序：先读STAT，再读DATA。解决：中断服务函数里先判断ORERR，如果置位就按顺序读STAT和DATA，再继续正常接收。

4.3 现象：ADC 采样值跳动大，或者一直为 0

原因：手册里 ADC 采样时间寄存器ADC_SAMPT0/1需要根据外部输入阻抗设置。如果外部阻抗高而采样时间短，采样电容充不满，读数就偏小。另外 ADC 使能后需要先校准，很多人跳过校准直接采。解决：先ADC_CTL1 |= ADC_CTL1_ADCON，再ADC_CTL1 |= ADC_CTL1_CLB，等CLB自动清零后再开始转换。采样时间按外部阻抗查手册表格，一般选 55.5 个周期以上。

4.4 现象：I2C 通信卡在总线忙，或者从机不响应

原因：GD32F10X 的 I2C 在总线出错后不会自动复位，I2C_STAT0的BERR或AERR置位后需要手动清。另外 GPIO 必须配成复用开漏，并且外部要有上拉电阻。手册里写了 I2C 引脚必须开漏，但没强调上拉阻值。解决：出错后先I2C_CTL0 |= I2C_CTL0_SRESET软复位，再重新初始化。上拉电阻一般 4.7kΩ 到 10kΩ，总线电容大时取小值。

4.5 现象：中断嵌套时高优先级被打断，或者优先级不生效

原因：GD32F10X 的优先级分组在SCB->AIRCR的PRIGROUP位，默认分组可能和你想的不一样。手册里写了 4 位优先级，但没强调分组。如果你用nvic_irq_enable时抢占优先级和子优先级设反了，嵌套行为就乱。解决：先nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2)确定分组，再按分组范围填优先级。注意：分组一旦设定，整个工程统一，不要中途改。

5. 进阶技巧：用手册里的寄存器位做低功耗与 Flash 擦写

5.1 低功耗模式的选择与唤醒源配置

GD32F10X 支持睡眠、深度睡眠和待机三种低功耗模式。手册里RCU_CTL的SLEEPDEEP位决定进深度睡眠还是睡眠，PMU_CTL的STBMOD决定待机。我一般用深度睡眠加 RTC 唤醒，因为待机模式会复位，所有寄存器丢失，适合极端省电但不利于快速恢复。配置步骤：先关不用的外设时钟，设SLEEPDEEP = 1，使能 RTC 唤醒中断，执行WFI。唤醒后要重新配置系统时钟，因为深度睡眠下 PLL 会关。下面是一个最小配置。

/* 使能 PMU 和 RTC 时钟 */ RCU_APB1EN |= RCU_APB1EN_PMUEN | RCU_APB1EN_RTCEN; /* 使能 RTC 唤醒中断 */ RTC_CTL |= RTC_CTL_WTIE; /* 设置唤醒周期，假设 RTC 时钟 32.768kHz，唤醒周期 1 秒 */ RTC_WUT = 32768 - 1; /* 进入深度睡眠 */ SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk; __WFI(); /* 唤醒后重新配置时钟 */ system_clock_config();

逻辑说明：RTC_WUT是唤醒定时器重装载值，实际周期 = (WUT + 1) / RTC 时钟。参数说明：深度睡眠下 1.8V 域保持，SRAM 和寄存器不丢，但 PLL 和 HXTAL 会停，唤醒后必须重新配时钟。注意：进低功耗前把不用的 GPIO 配成模拟输入或输出低，避免漏电。

5.2 Flash 擦写时的等待周期与中断处理

GD32F10X 的 Flash 擦写需要按页操作，手册里FMC_CTL的PG和PER位分别控制编程和页擦除。关键点：擦写期间 CPU 从 Flash 取指会暂停，如果中断向量表在 Flash 里，中断响应会延迟。我一般把擦写函数放到 RAM 里执行，或者擦写前关全局中断。下面是一个页擦除加编程的流程。

/* 解锁 Flash */ FMC_KEY = 0x45670123; FMC_KEY = 0xCDEF89AB; /* 页擦除：FMC_ADDR 填页起始地址 */ FMC_CTL |= FMC_CTL_PER; FMC_ADDR = 0x08004000; FMC_CTL |= FMC_CTL_START; while(FMC_STAT & FMC_STAT_BUSY); FMC_CTL &= ~FMC_CTL_PER; /* 编程：每次 16 位 */ FMC_CTL |= FMC_CTL_PG; *(volatile uint16_t*)0x08004000 = 0x1234; while(FMC_STAT & FMC_STAT_BUSY); FMC_CTL &= ~FMC_CTL_PG; /* 上锁 */ FMC_CTL |= FMC_CTL_LK;

逻辑说明：FMC_KEY要连续写两个特定值才能解锁，顺序不能反。FMC_STAT的BUSY位必须轮询等待。参数说明：页大小根据型号不同，GD32F10X 大容量产品一般是 2KB 一页，地址要按页对齐。注意：擦写前确保FMC_WS等待周期正确，否则擦写会失败。中断处理上，如果必须在擦写期间响应中断，把中断服务函数和向量表都放到 RAM，或者用双 Bank 交替擦写。

5.3 用 CRC 和外设自查做固件完整性验证

GD32F10X 内置 CRC 计算单元，手册里CRC_CTL和CRC_DATA寄存器可以算任意数据的 CRC32。我一般在固件末尾放一个 CRC 值，启动时算一遍 Flash 内容对比，不一致就停在错误状态。这个技巧在量产时特别有用，能挡住 Flash 位翻转和烧录不完整。配置很简单：使能 CRC 时钟，复位CRC_CTL的RST位，然后逐字写CRC_DATA，最后读CRC_DATA就是结果。注意：CRC 单元一次写 32 位，数据要按字对齐，最后不足 32 位的补 0。这个习惯我保持了几年，每次新板子首件必跑一遍，比事后查玄学问题省事得多。希望帮到你。

本文还有配套的精品资源，点击获取