2.1.1. 在Keil4 中添加GD32 MCU Device
1. 从GD32官网下载相关系列插件。
下面以GD32F30x 为例，在官网上下载MDK-ARM_AddOn_GD32F30x_V1.0.0.rar，如图 2-1GD32F30x 系列 MCU 型号支持pack 包名称（keil4）所示。
图 2-1 GD32F30x 系列 MCU 型号支持pack 包名称（keil4）
2. 双击解压安装至Keil 4的目录，一般都会默认选择，如若同时安装了Keil 4和Keil 5才需要手动选择。
图 2-2 Pack 包安装示意图（keil4）
3. 安装成功后，重新打开Keil 4，则可以在File->Device Database中出现Gigadevice的下拉选项，点击可以查看到相应的型号。
图 2-3 Pack 包成功安装示意图（keil4）
4. 为了后续debug工作的顺利进行，建议检查一下安装路径下是否有下载算法，可以通过如下方式查看：打开一个工程，将型号选为GD32F30x的型号，然后Options for Target -> Debug->Settings -> Flash Download-> Add，如果下拉选项中有GD32F30x的下载算法则完全安装成功。
图 2-4 Flash 算法文件选择示意图（keil4）
2.1.2. 在Keil 5 中添加GD32 MCU Device
1. 从GD32官网下载相关系列插件。
下面以GD32F30x为例，在官网上下载MDK-ARM_AddOn_GD32F30x_V1.0.0.rar。
图 2-5 GD32 MCU 型号支持pack 包名称（keil5）
2. 解压并安装至Keil 5的目录，一般都会默认选择。
图 2-6 Pack 包安装示意图（keil5）
3. 安装完后重新打开keil5工程，即可在Device->Database中出现Gigadevice的型号。
图 2-7 Pack 包安装成功示意图（keil5）
4. 在Options for Target -> Debug ->Settings ->Flash Download 中添加flash算法，会出现
GD32F30X的算法，即说明安装成功。根据相应的芯片选择合适的算法，即可下载仿真。
图 2-8 Flash 算法文件添加示意图（keil5）
5. 用Keil 5打开Keil 4工程，如果报找不到器件信息等错误，将Keil 4的插件安装在Keil 5的目录下，具体操作方式参考Keil 4插件相关内容。
2.1.3. 使用GD-Link 开发GD32
GD32部分开发板自带GD-link，可以用电路板上的GD-link调试仿真代码，不带的可外接GD-link模块，具体操作方法如下。
1. 第一次使用GD-link插入电脑后，会自动安装驱动。
在Options for Target -> Debug 中选择“CMSIS-DAP Debugger”，部分客户反馈找不到这一驱动器选项，那是因为MDK版本过低，只有Keil4.74以上的版本和Keil5才支持CMSIS-DAP Debugger选项。
图 2-9 GD-Link 选择Debugger 类型
2. 在Options for Target -> Utilities，也要选择“CMSIS-DAP Debugger”。
图 2-10 GD-Link 在Utilities 中选择Debugger 类型
3. 在Options for Target -> Debug ->Settings勾选SWJ、Port选择 SW。右框IDcode会出
现”0xXBAXXXXX”。
图 2-11 GD-Link 成连接目标板示意图
4. 在Options for Target -> Debug ->Settings -> Flash Download中添加GD32的flash算法。
图 2-12 GD-Link 添加Flash 算法文件示意图
5. 单击下图的快捷方式“debug”，即可使用GD-Link进行仿真。
图 2-13 GD-Link 仿真示意图
2.1.4. 使用J-Link 开发GD32
使用J-Link来debug GD MCU，具体配置如下：
1. 在Options for Target -> Debug中选择“J-LINK/J-Trace Cortex“
图 2-14 J-Link 在Keil 中选择Debugger 示意图
2. 在Options for Target -> Debug ->Utilities,也要选择“J-LINK/J-Trace Cortex”。
图 2-15 J-Link 在Utilities 下选择Debugger 示意图
3. 在Options for Target -> Debug ->Settings勾选SWJ，Port选择 SW。右框IDcode会出现
“0xXBAXXXXX”。
图 2-16 J-Link 成功连接目标板示意图
4. 在Options for Target -> Debug ->Settings -> Flash Download中添加GD32的flash算法。
图 2-17 J-Link 在Keil 下添加flash 算法文件示意图
5. 单击下图的快捷方式“debug”，即可使用J-Link进行仿真。
图 2-18 J-Link 成功仿真示意图
2.1.5. 使用ULink2 开发GD32
使用ULink2来debug GD MCU，具体配置如下：
1. 在Options for Target -> Debug中选择“ULINK2/ME Cortex Debugger”
图 2-19 ULink2 在Keil 中选择Debugger 示意图
2. 在Options for Target -> Debug ->Settings勾选SWJ，Port选择 SW。右框IDcode会出现
“0xXBAXXXXX”。
图 2-20 ULink2 成功连接目标板示意图
3. 在Options for Target -> Debug ->Settings -> Flash Download中添加GD32的flash算法。
图 2-21 ULink2 在Keil 下添加flash 算法文件示意图
4. 单击下图的快捷方式“debug”，即可使用ULink2进行仿真。
图 2-22 ULink2 成功仿真示意图
2.1.6. MDK 使用常见问题解答
1. Keil4打开Keil5工程
如果没有安装Keil 5，也是能够使用Keil 4来编译Keil 5的工程，具体做法就是修改工程的后缀名，将Keil5工程的后缀名xxxx.uvprojx修改为xxxx.uvproj，即可使用Keil 4来查看编译了。
2. Keil5打开Keil4工程
如果使用Keil 5打开Keil 4工程，打开时会遇到找不到MCU器件的情况，这种可以直接将Keil4工程的后缀名xxxx.uvproj修改为xxxx.uvprojx，即可正常使用Keil 5来查看编译了。
3. Keil5打开Keil4工程，编译报错
图 2-23 编译错误示意图
错误原因是core_cmInstr.h文件的路径在Keil5和Keil4中不同，可在Option for Target的C/C++中添加core_cmInstr.h的文件路径，如图 2-24文件路径添加示意图所示：
图 2-24 文件路径添加示意图
