GD32F105RBT6 Keil工程搭建与调试实战指南

最新推荐文章于 2026-06-13 05:30:29 发布

原创

最新推荐文章于 2026-06-13 05:30:29 发布 · 227 阅读

1. 从零开始：认识你的新伙伴GD32F105RBT6

最近几年，国产的微控制器发展得特别快，很多朋友都开始从熟悉的STM32转向了国产的GD32系列。我自己也是从STM32转过来的，刚开始确实有点不习惯，感觉资料没那么多，社区讨论也没那么热闹。但实际用下来，特别是像GD32F105RBT6这颗芯片，我发现它性能扎实，性价比高，完全能扛起项目大梁。今天，我就以一个过来人的身份，手把手带你搭建一个最基础、最干净的Keil工程，让你能快速上手，把精力集中在业务逻辑上，而不是在环境配置上折腾。

GD32F105RBT6属于GD32F1系列的“互联型”产品。简单来说，你可以把它看作是GD32F103的“增强版”。最大的区别就是外设更丰富了，比如它原生就带两个CAN总线控制器，这对于需要做车载或者工业通信的项目来说，简直是福音，不用再外挂芯片了。它的主频能跑到108MHz，闪存有128KB，RAM有32KB，对于大多数中小型项目来说，这个配置是绰绰有余的。我当初选它，就是看中了它的双CAN和USB OTG功能，做一个小型的网关设备特别合适。

很多朋友会问，我之前STM32的代码能不能移植过来？答案是：可以，而且移植起来比想象中要简单。因为GD32的固件库（标准外设库）在函数命名、编程风格上都高度借鉴了STM32的标准库，如果你有STM32F1系列的标准库开发经验，那几乎就是“无缝切换”。当然，底层寄存器地址和某些细微的时钟配置会有差异，但这些差异在官方库的封装下，对我们应用层开发者来说，感知已经非常弱了。我们搭建这个基础工程，就是为了建立一个稳定可靠的“地基”，以后所有外设驱动、业务代码都基于这个地基往上盖，这样代码结构清晰，也方便管理。

2. 万事开头难：工程搭建前的准备工作

2.1 获取官方“武器库”：固件库与支持包

搭建工程的第一步，不是急着打开Keil，而是要把“弹药”备齐。对于GD32开发，最重要的就是官方的固件库和Keil器件支持包。你直接去兆易创新的官网，在下载中心搜索“GD32F10x”就能找到。我通常下载那个叫“GD32F10x_Demo_Suites”的压缩包，里面包含了所有你需要的东西：库文件、示例工程、文档以及最重要的——Keil支持包。

下载解压后，你会看到一堆文件夹。别慌，我们重点关注两个。第一个是 GD32F10x_AddOn\Keil\Keil5 路径下的那个 .pack 文件，比如 GigaDevice.GD32F10x_DFP.2.0.2.pack。直接双击它安装，这个操作会让Keil MDK认识GD32这个“新朋友”。安装成功后，你打开Keil，在新建工程选择设备时，就能在列表里找到“GigaDevice”分类下的“GD32F105RBT6”了。这一步千万不能省，否则后面编译会出一堆找不到头文件的错误。

第二个重点是 GD32F10x_Firmware_Library 文件夹。这里面就是芯片的“灵魂”——固件库。它主要包含两个子文件夹：CMSIS 和 GD32F10x_standard_peripheral。CMSIS 是ARM公司定义的一套内核接口标准，里面包含了启动文件、内核相关的头文件；GD32F10x_standard_peripheral 就是GD官方写的针对每个外设（比如GPIO、USART、SPI）的驱动函数库。我们搭建基础工程，其实就是把这些必要的文件，按照一个合理的目录结构组织起来。