从零开始玩转RISC-V单片机：手把手教你用GD32VF103点个灯（附VS Code环境配置）-编程实验室

从零开始玩转RISC-V单片机：手把手教你用GD32VF103点个灯（附VS Code环境配置）

第一次接触RISC-V架构的开发者，往往会被其开源特性与模块化设计所吸引。作为国产MCU领域的佼佼者，兆易创新推出的GD32VF103系列凭借RISC-V内核与完善生态，成为入门嵌入式开发的理想选择。本文将带您从硬件拆箱到代码烧录，完成第一个LED控制项目，过程中会穿插开发环境配置、调试技巧与常见问题排查。

1. 开发板开箱与硬件准备

GD32VF103系列开发板通常配备以下核心组件：

主控芯片：GD32VF103CBT6（LQFP48封装）
调试接口：标准JTAG/SWD接口
外设资源：用户按键、RGB LED、USB转串口芯片
扩展接口：Arduino兼容引脚布局

硬件连接注意事项：

使用Type-C数据线连接开发板的USB调试接口
检查板载电源指示灯（通常为红色）是否亮起
确认BOOT跳线帽处于默认位置（从Flash启动）

提示：部分批次开发板可能需要手动安装串口驱动，可在兆易创新官网下载CH340系列驱动

2. 开发环境搭建

2.1 工具链安装

推荐使用PlatformIO作为开发环境，其内置的RISC-V GCC工具链可自动处理编译依赖：

# 安装VS Code后添加PlatformIO插件 code --install-extension platformio.platformio-ide

关键配置参数对照表：

参数项	推荐值	说明
platform	gd32v	指定GD32V平台
board	gd32vf103c-start	开发板型号
framework	gd32vf103-sdk	官方SDK框架
upload_protocol	jlink	根据实际调试器选择

2.2 工程创建与配置

在PlatformIO中新建项目时，需特别注意：

选择"GD32VF103C_START"作为开发板模板
修改platformio.ini文件增加调试配置：

[env:gd32vf103c-start] platform = gd32v board = gd32vf103c-start framework = gd32vf103-sdk upload_protocol = jlink debug_tool = jlink

3. LED控制实战编程

3.1 引脚配置原理

GD32VF103的GPIO控制器支持多种工作模式，LED控制通常采用推挽输出模式。查看开发板原理图确认：

用户LED连接在PC13引脚
需启用GPIOC外设时钟

初始化代码示例：

#include "gd32vf103.h" void gpio_config(void) { // 启用GPIOC时钟 rcu_periph_clock_enable(RCU_GPIOC); // 配置PC13为推挽输出 gpio_init(GPIOC, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_13); }

3.2 主程序逻辑实现

添加简单的闪烁逻辑，包含按键检测功能：

int main(void) { gpio_config(); while(1){ // LED状态翻转 gpio_bit_write(GPIOC, GPIO_PIN_13, !gpio_input_bit_get(GPIOC, GPIO_PIN_13)); // 约500ms延时 delay_1ms(500); } }

常见问题排查：

若LED不亮，检查硬件连接和引脚定义
若编译报错，确认SDK路径配置正确
若下载失败，验证调试器连接状态

4. 进阶调试技巧

4.1 使用J-Link调试器

配置VS Code调试会话（launch.json）：

{ "version": "0.2.0", "configurations": [ { "name": "GD32VF103 Debug", "type": "cortex-debug", "request": "launch", "servertype": "jlink", "device": "GD32VF103CB", "executable": "${workspaceFolder}/.pio/build/gd32vf103c-start/firmware.elf" } ] }

4.2 串口输出调试信息

利用板载USB转串口输出日志：

void usart_config(void) { // 启用USART0和GPIOA时钟 rcu_periph_clock_enable(RCU_USART0); rcu_periph_clock_enable(RCU_GPIOA); // 配置TX(PA9)和RX(PA10) gpio_init(GPIOA, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_9); gpio_init(GPIOA, GPIO_MODE_IN_FLOATING, GPIO_OSPEED_50MHZ, GPIO_PIN_10); // USART参数配置 usart_deinit(USART0); usart_baudrate_set(USART0, 115200U); usart_word_length_set(USART0, USART_WL_8BIT); usart_stop_bit_set(USART0, USART_STB_1BIT); usart_enable(USART0); } void log_print(char *str) { while(*str){ usart_data_transmit(USART0, *str++); while(RESET == usart_flag_get(USART0, USART_FLAG_TBE)); } }

实际项目中，建议将调试信息分级输出，通过宏定义控制日志级别：

#define LOG_LEVEL_DEBUG 0 #define LOG_LEVEL_INFO 1 #define LOG_LEVEL_ERROR 2 #if LOG_LEVEL <= LOG_LEVEL_DEBUG #define LOG_DEBUG(fmt, ...) printf("[DEBUG] " fmt "\r\n", ##__VA_ARGS__) #else #define LOG_DEBUG(fmt, ...) #endif

5. 工程优化与扩展

5.1 电源管理配置

RISC-V内核的低功耗特性可通过以下方式优化：

void pmu_config(void) { // 进入睡眠模式时保持外设时钟 pmu_wakeup_pin_enable(PMU_WAKEUP_PIN0); pmu_ldo_output_voltage_set(PMU_LDOVS_LOW); pmu_to_sleepmode(WFI_CMD); }

5.2 使用硬件定时器

精确控制LED闪烁频率：

void timer_config(void) { rcu_periph_clock_enable(RCU_TIMER1); timer_deinit(TIMER1); timer_parameter_struct timer_initpara; timer_initpara.prescaler = 10799; // 108MHz/10800=10kHz timer_initpara.alignedmode = TIMER_COUNTER_EDGE; timer_initpara.counterdirection = TIMER_COUNTER_UP; timer_initpara.period = 4999; // 500ms周期 timer_initpara.clockdivision = TIMER_CKDIV_DIV1; timer_init(TIMER1, &timer_initpara); timer_interrupt_enable(TIMER1, TIMER_INT_UP); timer_enable(TIMER1); }

在中断服务函数中处理LED切换：

void TIMER1_IRQHandler(void) { if(timer_interrupt_flag_get(TIMER1, TIMER_INT_FLAG_UP)){ gpio_bit_write(GPIOC, GPIO_PIN_13, !gpio_input_bit_get(GPIOC, GPIO_PIN_13)); timer_interrupt_flag_clear(TIMER1, TIMER_INT_FLAG_UP); } }