GD32F303 Keil 开发环境部署

1. 准备工作

1.1 软件版本

类别	版本
系统	WIN10
Keil	Keil MDK 5.15.0
开发板	星空派GD32F303开发板
GD32F30x 固件库	V2.1.2
GD32F30x Keil 5 支持包	V2.1.0

1.2 下载链接

• Keil MDK V5 下载链接
• GD32F30x 固件库 下载链接
  
• GD32F30x Keil 5 支持包
  

2. 部署环境

2.1 Keil 工程转换

本文以 GD32F30x 固件库中的 Template 工程作为示例基础工程

默认情况下，GD 官方给的例程都是基于 Keil V4 版本，博主安装的是 Keil V5 版本，直接双击下方图片工程文件会出问题。

工程文件格式是 uvproj 是 keil V4 版本的，uvprojx 是 Keil V5 版本。

Keil V4 工程转 Keil V5 版本操作如下：
打开项目 -> 单击 Project -> Manage -> Migrate Vewsion 5 Format 即可。

2.2 安装 GD32F30x pack 支持包

新安装的 Keil MDK 5 软件，需要安装 GD32F30x 芯片的 pack 支持包，安装步骤如下：
点击 Pack Installer -> File -> Import -> GigaDevice.GD32F30x_DFP.2.1.0.pack

导入完成即可。

2.3 设置目标选项

博主自己使用的是 GD32F303ZET6，以下设置根据自己 MCU 型号进行匹配设置

另外需要根据以下规则进行闪存控制器 FMC 存储容量的配置，即选择不同的启动文件。详情请参考该博文


根据以上介绍博主的芯片属于 HD 型，故编译选项应如下修改，之前默认是 CL 型，大家可根据自己的芯片找到对应型号进行修改即可。

2.4 下载软件

博主使用的 JLINK 仿真器下载程序，下载程序需要配置 FLASH 下载，如图所示：

3. 运行程序

GD32F30x 固件库中的 Template 工程 main 函数如下：

/*!
    \brief      main function
    \param[in]  none
    \param[out] none
    \retval     none
*/

int main(void)
{
    /* configure systick */
    systick_config();
    /* initilize the LEDs, USART and key */
    gd_eval_led_init(LED2); 
    gd_eval_led_init(LED3); 
    gd_eval_led_init(LED4);
    gd_eval_com_init(EVAL_COM0);
    gd_eval_key_init(KEY_WAKEUP, KEY_MODE_GPIO);
    
    /* print out the clock frequency of system, AHB, APB1 and APB2 */
    printf("\r\nCK_SYS is %d", rcu_clock_freq_get(CK_SYS));
    printf("\r\nCK_AHB is %d", rcu_clock_freq_get(CK_AHB));
    printf("\r\nCK_APB1 is %d", rcu_clock_freq_get(CK_APB1));
    printf("\r\nCK_APB2 is %d", rcu_clock_freq_get(CK_APB2));

    while (1){
        if(RESET == gd_eval_key_state_get(KEY_WAKEUP)){
            gd_eval_led_on(LED3);
            delay_1ms(500);
            gd_eval_led_off(LED3);
            gd_eval_led_toggle(LED4);
        }
    }
}

烧录程序串口窗口接收如下内容，大功告成：

4. 部署收尾

至此，开发环境部署完成，可以编译固件库提供的模版工程，愉快的在 GD32 的世界遨游了。

5. 附加配置

5.1 自动编译生成 bin 文件

如果想编译时自动生成 bin 文件，可如下操作，让 Keil 编译完成时运行命令：fromelf --bin -o “$L@L.bin” “#L” 即可。

编译完后便可在目录 Template->Keil_project->output 目录下查看到 bin 文件。

5.2 指定文件每次都重新编译

选中指定文件，右击 -> Options for File -> Properties，勾选 Always Build 即可，博主一般用此种方法来获取编译的时间，确定软件版本。

5.3 修改编译输出的目标文件名