保姆级教程：用STM32标准库开发GD32F103（基于Keil5和J-Link）-平芜编程栈

从零开始：Keil5环境下GD32F103标准库开发实战指南

在嵌入式开发领域，ST公司的STM32系列长期占据主流地位，而近年来国产芯片厂商如兆易创新推出的GD32系列凭借优异的性价比和良好的兼容性逐渐获得市场认可。许多工程师和学生开始尝试在项目中采用GD32作为替代方案，但在实际操作中常会遇到各种"水土不服"的问题。本文将基于Keil MDK-ARM开发环境和J-Link调试器，手把手带你完成GD32F103开发环境的搭建、工程配置到第一个LED闪烁程序的完整流程。

1. 开发环境准备与芯片选型

工欲善其事，必先利其器。在开始GD32开发前，我们需要做好以下准备工作：

硬件准备清单：

GD32F103C8T6最小系统板（与STM32F103C8T6引脚兼容）
J-Link调试器（建议使用V9或以上版本）
4线SWD连接线（建议长度不超过15cm）
USB转串口模块（可选，用于串口调试）

软件工具准备：

Keil MDK-ARM v5.25或更新版本
GD32F10x系列器件支持包
J-Link驱动软件
STM32标准外设库（作为开发基础）

提示：GD32官方提供了与STM32标准库高度兼容的固件库，但本文采用更通用的STM32标准库进行修改适配，这种方式更适合已有STM32项目迁移的场景。

芯片选型方面，GD32F103系列与STM32F103的对应关系如下表所示：

STM32型号	GD32对应型号	主要差异点
STM32F103C8T6	GD32F103C8T6	Flash等待周期不同
STM32F103RCT6	GD32F103RCT6	时钟树配置差异
STM32F103VET6	GD32E103VET6	工作电压范围不同

2. Keil工程创建与基础配置

2.1 安装GD32器件支持包

虽然GD32与STM32引脚兼容，但Keil默认不包含GD32的器件支持，需要手动安装：

从GD32官网下载最新的Device Family Pack(DFP)
双击下载的.GDFP文件自动安装到Keil
在Keil中点击"Pack Installer"图标，确认GD32设备包已正确安装

2.2 新建工程关键步骤

打开Keil MDK，按照以下流程创建新工程：

Project → New μVision Project → 选择保存路径 → 选择器件型号(GD32F103C8T6)

在弹出对话框中选择运行环境时，我们需要手动添加标准外设库：

取消默认选择的"CMSIS → CORE"和"Device → Startup"
右键工程目录，选择"Add Group"创建以下组：
- User：存放用户代码
- Libraries：存放STM32标准库文件
- CMSIS：存放核心支持文件

2.3 文件添加与路径设置

将STM32标准库中的关键文件复制到工程目录并添加到对应组：

/* 必须包含的核心文件 */ CMSIS/core_cm3.c CMSIS/system_gd32f10x.c Libraries/stm32f10x_rcc.c Libraries/stm32f10x_gpio.c

在工程选项"Options for Target"中设置以下关键参数：

选项卡	配置项	推荐值
Target	Xtal(MHz)	8.0
C/C++	Define	USE_STDPERIPH_DRIVER
C/C++	Include Paths	添加所有库文件路径
Debug	Use	J-Link / JTAG / SWD

3. 关键代码修改与适配

3.1 时钟系统配置调整

GD32与STM32在时钟初始化时序上有显著差异，必须按照以下顺序操作：

void RCC_Configuration(void) { /* 1. 必须先开启时钟再配置 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); /* 2. 修改HSE启动超时时间 */ #define HSE_STARTUP_TIMEOUT ((uint16_t)0xFFFF) /* 3. 时钟配置 */ RCC_HSEConfig(RCC_HSE_ON); while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET); RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); RCC_PLLCmd(ENABLE); while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET); RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); while(RCC_GetSYSCLKSource() != 0x08); }

3.2 GPIO驱动LED示例

虽然GPIO接口兼容，但在实际使用中需要注意GD32的驱动能力更强：

void GPIO_Configuration(void) { GPIO_InitTypeDef GPIO_InitStructure; /* 必须时钟使能在前 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOC, &GPIO_InitStructure); }

4. J-Link调试器特殊配置

GD32的SWD接口驱动能力较弱，需要进行以下优化设置：

硬件连接优化：
- 使用短而粗的连接线（建议<15cm）
- 在SWDIO信号线添加10K上拉电阻
- 在SWCLK信号线添加10K下拉电阻
软件参数调整：
- 在Keil的Debug选项卡中，点击"Settings"
- 将"Max Clock"从1MHz降低到100-200KHz
- 勾选"Connect under reset"选项

注意：如果仍无法连接，尝试按住复位键的同时点击下载，待开始擦除Flash后再释放复位键。

5. 常见问题解决方案

在实际开发中，开发者常会遇到以下典型问题：

问题1：程序下载后无法运行

检查BOOT0引脚是否可靠接地（必须接10K下拉）
确认复位电路完整（GD32对复位电路要求更严格）
验证电源电压是否稳定（建议保持在2.6V以上）

问题2：精确延时函数不准确

// STM32下的1ms延时 void delay_ms(uint32_t ms) { while(ms--) { uint32_t i = 12000; // STM32F103@72MHz while(i--); } } // GD32需要调整循环次数 void delay_ms(uint32_t ms) { while(ms--) { uint32_t i = 8000; // GD32F103@72MHz while(i--); } }

问题3：Flash读写异常