4、开发环境搭建：安装GD32开发工具链（Keil/IAR/CMake）、串口调试工具、烧录工具，并验证点灯程序
GD32系列MCU基于Arm Cortex-M内核，其开发环境搭建与STM32高度相似，但在芯片支持包（Pack）、烧录算法（Flash Algorithm）以及调试器配置上存在差异。本章将围绕“工具链选择→驱动安装→工程创建→编译烧录→串口验证”这条主线，完整搭建一套可复用的GD32开发环境，并以点灯程序作为板端验证的“Hello World”。无论你最终选择Keil MDK、IAR EWARM还是CMake+GCC，核心目标都是让编译产物（.hex/.bin）能够正确下载到目标芯片并运行。
4.1 工具链选型与核心原理
GD32开发工具链的选择直接影响编译效率、调试体验和项目可移植性。三种主流方案各有优劣：Keil MDK 在国产MCU生态中普及率最高，图形化界面友好，GD32官方提供的固件库和例程大多基于Keil工程；IAR EWARM 的代码优化能力更强，适合对代码体积和实时性要求苛刻的场景；CMake + GCC 则是开源、跨平台的选择，便于持续集成和版本管理，但需要手动配置链接脚本和启动文件。
无论选择哪种工具链，其底层原理都遵循“预处理→编译→汇编→链接→生成烧录文件”的流程。关键差异在于：Keil和IAR使用各自私有的工程文件格式（.uvprojx和.ewp），而CMake通过CMakeLists.txt描述构建规则，最终调用arm-none-eabi-gcc完成编译。对于GD32而言，还需要额外安装芯片支持包（Pack），其中包含芯片头文件、系统初始化代码、启动文件以及烧录算法。
| 对比维度 | Keil MDK | IAR EWARM | CMake + GCC |
|---|---|---|---|
| 工程文件格式 | .uvprojx | .ewp | CMakeLists.txt |
| 编译器 | Arm Compiler (AC5/AC6) | ICCARM | arm-none-eabi-gcc |
| 芯片支持包 | GD32 Pack (.pack) | GD32 IAR插件 | CMSIS + GD32 SVD |
| 调试器支持 | CMSIS-DAP/J-Link | J-Link/I-jet | OpenOCD + GDB |
| 适用场景 | 快速原型、官方例程 | 代码优化、量产固件 | Linux开发、CI/CD |
4.2 安装与配置操作流程
以Keil MDK + GD32 Pack为例，这是最快捷的搭建路径。首先从Keil官网下载MDK-ARM最新版本（V5.37+），安装时勾选CMSIS组件。然后从GD32官网（www.gd32mcu.com）下载对应芯片型号的Pack包，例如GD32F30x_AddOn_V3.x.x.pack，双击安装后，Keil的Device数据库中就会出现GD32系列芯片。
接下来配置调试器。将CMSIS-DAP调试器通过USB连接电脑，安装驱动后，在Keil的Options for Target → Debug选项卡中选择CMSIS-DAP Debugger，并在Settings中确认SWDIO和SWCLK引脚识别正常。若使用J-Link，则需安装J-Link驱动并选择J-LINK/J-TRACE Cortex。
对于CMake + GCC方案，需要安装arm-none-eabi-gcc工具链（推荐gcc-arm-none-eabi-10.3-2021.10），并安装OpenOCD（用于烧录和调试）。在Ubuntu下可通过sudo apt install gcc-arm-none-eabi openocd完成安装。Windows用户则需手动下载并添加环境变量。
# CMake工具链配置示例（GD32F303）
set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR arm)
set(CMAKE_C_COMPILER arm-none-eabi-gcc)
set(CMAKE_CXX_COMPILER arm-none-eabi-g++)
set(CMAKE_EXE_LINKER_FLAGS "--specs=nosys.specs -T link.ld")4.3 串口调试工具与烧录工具配置
串口调试是嵌入式开发中不可或缺的调试手段。推荐使用PuTTY（Windows/Linux通用）或XCOM（国产免费软件），配置参数为：波特率115200、数据位8、停止位1、无校验、无流控。连接开发板的UART接口时，注意TX/RX交叉连接，且共地。
烧录工具方面，Keil内置的Flash Download功能会调用Pack中的烧录算法，直接点击Download按钮即可完成烧录。若使用OpenOCD，则需要编写配置文件指定调试器和芯片型号：
# openocd.cfg
source [find interface/cmsis-dap.cfg]
source [find target/gd32f3x.cfg]
adapter speed 1000
init
targets
reset halt
flash write_image erase main.hex
reset run
shutdown烧录完成后，建议先使用readback命令校验Flash内容，确保固件正确写入。对于量产场景，可使用J-Flash Lite或GD32官方提供的GD32 All-In-One Programmer工具进行批量烧录。
4.4 点灯程序实战：从工程创建到板端验证
下面通过一个完整的点灯案例，串联整个工具链。以GD32F303CBT6开发板为例，板载LED连接到PC13引脚（高电平点亮）。在Keil中新建工程，选择GD32F303CB芯片，添加GD32标准固件库的gd32f30x_gpio.c和gd32f30x_rcu.c源文件，编写主程序：
#include "gd32f30x.h"
int main(void) {
rcu_periph_clock_enable(RCU_GPIOC);
gpio_init(GPIOC, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_13);
while(1) {
gpio_bit_set(GPIOC, GPIO_PIN_13); // LED亮
delay_1ms(500);
gpio_bit_reset(GPIOC, GPIO_PIN_13); // LED灭
delay_1ms(500);
}
}
void delay_1ms(uint32_t count) {
for(uint32_t i = 0; i < count; i++) {
for(uint32_t j = 0; j < 7200; j++);
}
}编译通过后，连接CMSIS-DAP调试器，点击Download烧录。此时观察板载LED是否以1Hz频率闪烁。若LED不亮，首先检查电源指示灯是否点亮，其次用万用表测量PC13引脚电压是否在0V和3.3V之间切换。若电压正常但LED不亮，可能是LED驱动电流不足，需要检查限流电阻。
4.5 常见误区与排障指南
在环境搭建过程中，以下问题出现频率最高：
- Pack安装失败：Keil版本过旧无法识别新Pack，需升级至V5.30以上；或Pack文件下载不完整，重新下载并校验MD5。
- 烧录报错“No Flash Device”：未正确选择芯片型号，或Flash算法未加载。在Options for Target → Utilities → Settings中确认Flash Download列表包含GD32的算法。
- 串口乱码：波特率不匹配或时钟配置错误。GD32默认使用内部8MHz RC振荡器，若系统时钟配置为108MHz，串口波特率需按实际时钟计算。
- 调试器连接失败：检查SWD线序是否正确，目标板是否供电，调试器固件是否需要升级。部分山寨J-Link需要安装旧版驱动。
4.6 环境验证与总结
完成点灯程序验证后，建议进一步测试串口打印功能，以确认UART外设工作正常。在main函数中添加printf重定向代码，通过串口助手观察输出信息。这为后续TFLite Micro的日志输出和调试信息打印奠定基础。
最后，整理一份环境清单：Keil MDK版本、Pack版本、调试器驱动版本、串口工具配置参数，并记录在项目README中。这样当团队成员协作或更换电脑时，可以快速复现开发环境。对于使用CMake的团队，建议将工具链版本固定，并编写自动化脚本一键安装依赖。