2. 开发环境部署：从零搭好你的GD32战场
说实话，很多做电机控制的工程师，最后卡住的不是算法本身，而是开发环境没配好。我见过太多人花了两周调SVPWM，结果发现是编译器优化等级设错了。所以这一章，咱们老老实实把环境搭结实。
我会带你走完五个步骤：装Keil、导固件库、建工程模板、配J-Link、最后点个灯验证。每一步我都会告诉你哪些坑我踩过。
2.1 Keil MDK安装：别选错版本
Keil MDK分好多版本。做GD32开发，我建议直接用MDK-ARM 5.38或更新版本。为什么？因为5.36之前对ARM Cortex-M4支持有点小毛病，我在一个项目中遇到过编译出来的代码跑飞，最后发现是编译器版本问题。
安装步骤其实很简单：
- 去ARM官网下载MDK-ARM安装包（约1.2GB）
- 双击安装，一路Next，路径不要有中文
- 安装完成后打开Keil uVision5，会提示注册
- 用License Manager生成并导入许可证
C:\Keil_v5，干净利落。如果你用默认路径，后面编译某些工程可能会因为路径长度超限报错。
装完之后，记得装一下Device Pack。GD32的Pack在Keil里可以直接搜：
- 打开Pack Installer（在Keil菜单栏的Tools里）
- 搜索"GigaDevice"
- 找到GD32F30x_DFP，点击Install
嗯，这一步很多人会忘。没有Pack，你连芯片型号都选不到。
2.2 GD32固件库导入：别用错版本
GD32的固件库，说白了就是官方给你封装好的寄存器操作函数。你不用它也可以，但自己从头写寄存器配置，那效率太低了。
我建议去GigaDevice官网下载 GD32F30x_Firmware_Library_V2.x.x。注意，V1.x和V2.x的API有差异，咱们这个课程统一用V2.x。
解压后，你会看到这样的目录结构：
GD32F30x_Firmware_Library_V2.1.2/
├── Firmware/
│ ├── GD32F30x_standard_peripheral/
│ │ ├── Include/ # 头文件
│ │ └── Source/ # 外设驱动源文件
│ └── CMSIS/
│ ├── GD32F30x/ # 芯片级启动文件
│ └── Include/ # CMSIS核心头文件
├── Template/ # 官方工程模板
├── Utilities/ # 工具函数
└── Doc/ # 文档
咱们做工程模板，只需要把 Firmware 目录下的东西拿过来用。我个人习惯把固件库单独放一个文件夹，不跟工程混在一起，这样多个工程可以共用同一份库文件。
C:\GigaDevice\GD32F30x_FWLib_V2，然后在Keil工程里用相对路径引用。这样换电脑或者分享工程时，不会出现路径找不到的问题。
2.3 工程模板建立：一次搭好，反复用
建工程模板，说白了就是搭一个骨架。以后每个新项目，直接复制这个模板改改就行。我自己的模板库里有十几个不同芯片的模板，每次开新项目，5分钟就能开始写代码。
具体步骤：
- 打开Keil，点击
Project → New uVision Project - 选择芯片型号：GD32F303CCT6（咱们课程用的这颗）
- 在弹出的Manage Run-Time Environment窗口里，直接点OK（咱们手动加文件）
- 在工程里新建几个Group：
Startup— 放启动文件CMSIS— 放CMSIS核心文件FWLib— 放外设驱动User— 放你的main.c
- 把对应的文件拖进去
文件对应关系如下：
| Group | 需要添加的文件 |
|---|---|
| Startup | startup_gd32f30x.s（汇编启动文件） |
| CMSIS | system_gd32f30x.c、core_cm4.h（路径引用） |
| FWLib | gd32f30x_rcu.c、gd32f30x_gpio.c 等外设驱动 |
| User | main.c（你自己写） |
然后配置编译选项：
- Target → ARM Compiler: 选V6.19或V5.06（我习惯用V6，编译快）
- C/C++ → Define: 加上
GD32F30X_HD（告诉编译器你是大容量型号） - Include Paths: 把固件库的Include目录加进来
GD32F30X_HD 这个宏定义，结果编译出来的程序跑起来外设全不工作。查了两天才发现是宏定义缺失导致外设地址映射错了。所以这一步千万别省。
2.4 J-Link调试器配置：连不上？多半是驱动问题
J-Link调试器，咱们课程用的是SEGGER原版或国产兼容版。配置其实不复杂，但很多人卡在驱动上。
步骤：
- 安装SEGGER J-Link驱动（去SEGGER官网下载最新版）
- 用USB线连接J-Link到电脑，确认设备管理器里能看到"J-Link"
- 在Keil里点击
Project → Options for Target → Debug - 右侧下拉框选 J-LINK / J-TRACE Cortex
- 点击
Settings，确认能识别到芯片ID
如果识别不到，别慌。先检查这几个地方：
- J-Link的SWD接口接线对不对？VCC、GND、SWDIO、SWCLK四根线必须接
- 目标板有没有供电？J-Link一般不对外供电
- 驱动版本是不是太老？我遇到过V6.48b驱动死活连不上GD32，换V6.50就好了
Reset 选项改成 SYSRESETREQ。这样下载完程序后芯片会自动复位运行，不用手动按复位键。
2.5 第一个LED点灯程序验证：环境通不通，点个灯就知道
好了，环境搭完了，咱们写个最简单的程序验证一下。说白了就是点个LED，让灯闪烁。如果灯能亮，说明编译、下载、运行全链路通了。
GD32F303CCT6开发板上，LED通常接在 PE2 或 PD7 引脚（具体看你的板子原理图）。咱们以PE2为例：
#include "gd32f30x.h"
void delay(void) {
volatile uint32_t i;
for(i = 0; i < 1000000; i++);
}
int main(void) {
// 使能GPIOE时钟
rcu_periph_clock_enable(RCU_GPIOE);
// 配置PE2为推挽输出，50MHz
gpio_init(GPIOE, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_2);
while(1) {
gpio_bit_set(GPIOE, GPIO_PIN_2); // 点亮LED
delay();
gpio_bit_reset(GPIOE, GPIO_PIN_2); // 熄灭LED
delay();
}
}
编译通过后，点击 Download 按钮。如果一切正常，你会看到LED开始闪烁。
- ✅ 编译无错误、无警告
- ✅ 下载进度条走完，提示"Verify OK"
- ✅ LED以约1Hz频率闪烁
如果灯不亮，别急着怀疑硬件。先检查：
- 代码里的引脚号对不对？我犯过把PE2写成PE3的蠢事
- 时钟使能了没？GD32的外设时钟默认是关闭的
- J-Link的SWD线有没有松动？有时候接触不良会导致下载失败
2.6 本章知识体系总览
下面这张图，把咱们这一章的核心流程串起来了。你以后每次搭环境，都可以拿它当checklist：
这张图里，五个步骤是串行的。你跳不过任何一步。我见过有人想省事，直接复制别人的工程，结果芯片型号不对、固件库版本不匹配，折腾一整天。所以，老老实实按流程走一遍，后面写代码才踏实。