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

GD32F105RBT6 Keil工程模板搭建全攻略（附LED闪烁调试）

news 2026/7/15 19:46:03

GD32F105RBT6 Keil工程模板搭建实战指南

第一次接触GD32系列MCU时，最让人头疼的就是如何快速搭建一个可靠的开发环境。作为国产MCU中的佼佼者，GD32F105RBT6以其出色的性能和兼容性赢得了不少工程师的青睐。本文将手把手带你完成从零开始的Keil工程搭建，最后还会通过一个LED闪烁实例验证工程是否正常工作。

1. 开发环境准备

在开始之前，我们需要准备好所有必要的工具和文件。不同于STM32丰富的生态系统，GD32的官方资源相对集中，需要特别注意获取正确的开发包。

首先确保你已经安装了Keil MDK开发环境（建议使用5.25以上版本）。接下来需要获取GD32F10x系列的标准外设库和器件支持包：

访问GD32官网下载中心（https://www.gd32mcu.com/cn/download）
搜索并下载"GD32F10x_Demo_Suites_V2.2.0"完整开发包
同时下载"GigaDevice.GD32F10x_DFP.2.0.2.pack"器件支持包

下载完成后，先安装器件支持包。双击.pack文件，Keil会自动识别并完成安装。验证安装是否成功：

# 在Keil中新建工程时，应该能在Device列表中找到GD32F105RB型号

开发包解压后的目录结构如下：

GD32F10x_Demo_Suites_V2.2.0/ ├── GD32F10x_AddOn ├── GD32F10x_Firmware_Library # 标准外设库 └── Projects # 示例工程

特别提醒：GD32F105属于互联型(Connectivity Line)产品，与基础型(F103系列)在启动文件和配置上有差异，务必使用对应的文件。

2. 工程目录结构设计

一个良好的工程目录结构能极大提高开发效率。我推荐采用模块化设计，便于后期功能扩展和维护。以下是经过多个项目验证的目录方案：

gd32f105_project/ ├── Core/ # 内核相关文件 ├── Drivers/ # 外设驱动 ├── GD32F10x_FWLib/ # 标准外设库 ├── Project/ # Keil工程文件 │ ├── Output/ # 编译输出 │ └── User/ # 用户代码 └── System/ # 系统级配置

具体操作步骤：

新建工程根目录gd32f105_project
从开发包复制以下文件：
- CMSIS文件夹 →Core/
- GD32F10x_standard_peripheral内容 →GD32F10x_FWLib/
特别注意启动文件的选择：
- 互联型号使用startup_gd32f10x_cl.s
- 位置在CMSIS/GD/GD32F10x/Source/ARM/

提示：创建目录时建议使用英文路径，避免某些工具链可能出现的编码问题。

3. Keil工程详细配置

打开Keil MDK，点击Project→New μVision Project，选择刚才创建的Project目录，命名为gd32f105_demo。

3.1 器件选择与组配置

在Device选择界面，找到GigaDevice→GD32F10x系列→GD32F105RB。创建以下组(Group)结构：

Target 1 ├── CMSIS ├── FWLib ├── User └── Startup

向各组添加对应文件：

1. **Startup组**: - 添加`startup_gd32f10x_cl.s` 2. **CMSIS组**: - `system_gd32f10x.c` - `gd32f10x.h` 3. **FWLib组**: - 选择必要的外设库.c文件 - 初期只需添加`gd32f10x_gpio.c`和`gd32f10x_rcu.c` 4. **User组**: - 新建`main.c`

3.2 关键工程选项设置

进入Options for Target配置界面，有几个关键设置：

Output选项卡:
- 勾选"Create HEX File"
- 设置输出目录为Project/Output
Listing选项卡:
- 设置列表文件输出目录
C/C++选项卡:
- 添加预定义宏：USE_STDPERIPH_DRIVER,GD32F10X_CL
- 包含路径设置：
```
../Core ../GD32F10x_FWLib ../User
```
Debug选项卡:
- 根据你的调试器选择（如ST-Link、J-Link等）
- 勾选"Run to main()"
Utilities选项卡:
- 设置生成.bin文件的指令：
```
fromelf --bin --output "$L@L.bin" "#L"
```

4. 基础代码实现

在main.c中实现最基本的系统初始化和LED闪烁功能。首先确保硬件连接正确：

LED接在PC13（开发板常用配置）
8MHz外部晶振（HXTAL）

#include "gd32f10x.h" #include "systick.h" void GPIO_Config(void) { rcu_periph_clock_enable(RCU_GPIOC); gpio_init(GPIOC, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_13); } int main(void) { systick_config(); // 初始化SysTick GPIO_Config(); // 配置GPIO while(1){ gpio_bit_write(GPIOC, GPIO_PIN_13, SET); delay_1ms(500); gpio_bit_write(GPIOC, GPIO_PIN_13, RESET); delay_1ms(500); } }

时钟配置是GD32开发中最容易出问题的部分。在system_gd32f10x.c中修改如下：

#define __SYSTEM_CLOCK_108M_PLL_HXTAL (uint32_t)(108000000) /* 修改系统时钟初始化配置 */ static void system_clock_108m_hxtal(void) { /* 具体参数根据实际晶振调整 */ rcu_osci_on(RCU_HXTAL); rcu_osci_stab_wait(RCU_HXTAL); rcu_ahb_clock_config(RCU_AHB_CKSYS_DIV1); rcu_apb2_clock_config(RCU_APB2_CKAHB_DIV1); rcu_apb1_clock_config(RCU_APB1_CKAHB_DIV2); rcu_pll_config(RCU_PLLSRC_HXTAL, 25, 216, 2); rcu_osci_on(RCU_PLL_CK); rcu_osci_stab_wait(RCU_PLL_CK); rcu_ck_sys_config(RCU_CKSYSSRC_PLL); SystemCoreClock = __SYSTEM_CLOCK_108M_PLL_HXTAL; }

5. 调试与验证

完成上述步骤后，点击Rebuild编译工程。常见问题及解决方法：

问题现象	可能原因	解决方案
找不到头文件	路径配置错误	检查C/C++选项卡中的包含路径
链接错误	缺少必要文件	确认所有.c文件已添加到对应组
LED不闪烁	时钟配置错误	检查system_clock_108m_hxtal配置
无法下载	调试器配置不当	确认Utilities和Debug选项卡设置