当前位置：首页 > news >正文

RVSTAR开发板RISC-V开发环境搭建与调试指南

news 2026/7/17 4:56:02

1. RVSTAR开发板与RISC-V生态初探

RVSTAR是一款基于GD32VF103 RISC-V内核的开发板，作为国内最早一批支持RISC-V架构的硬件平台，它搭载了兆易创新(GigaDevice)设计的32位RISC-V内核。这颗芯片采用Bumblebee处理器内核，主频108MHz，内置128KB Flash和32KB SRAM，外设资源丰富程度与STM32F103系列相当。

RISC-V作为一种开源指令集架构，近年来在IoT和边缘计算领域发展迅猛。与ARM架构相比，RISC-V的最大优势在于免授权费和高度模块化设计。GD32VF103作为商用RISC-V MCU的代表作之一，其开发环境的选择尤为重要。目前主流的开发方式包括：

基于Eclipse的IDE（如PlatformIO）
命令行工具链（riscv-gcc + openocd）
商业IDE（SEGGER Embedded Studio）

其中SEGGER Embedded Studio（简称SES）以其高度集成化和出色的调试体验著称。它原生支持J-Link调试器家族，而蜂鸟调试器正是基于J-Link协议设计的国产调试工具，这使得二者的组合成为RVSTAR开发的黄金搭档。

2. 开发环境搭建全流程

2.1 软件安装与配置

首先需要从SEGGER官网下载Embedded Studio for RISC-V版本。安装时需注意：

选择"Custom"安装模式
勾选RISC-V工具链支持
安装路径避免中文和空格
安装完成后运行License Manager激活（教育用户可申请免费授权）

安装完成后，首次启动时需要配置工具链路径。SES默认会自带GCC工具链，但建议额外安装最新版riscv-none-embed-gcc以获取更好的代码优化。在"Tools->Options->Toolchain"中：

设置GCC路径为：C:\Program Files\SEGGER\Embedded Studio\gcc\riscv-embed
勾选"Use external make"以支持自定义构建脚本

2.2 硬件连接准备

蜂鸟调试器与RVSTAR的连接方式如下：

将调试器的20pin接口与RVSTAR的JTAG插座对接
- 注意1脚对齐（接口上有三角标记）
USB端接入电脑，Windows会自动安装驱动
开发板供电可选择：
- 通过调试器供电（跳线JP1短接）
- 外部5V供电（跳线JP1断开）

连接完成后，在设备管理器中应能看到"USB Serial Device"和"J-Link"两个设备。如果出现黄色感叹号，需要手动安装驱动（驱动包随调试器附带）。

3. 创建首个RVSTAR工程

3.1 新建项目向导

在SES中点击File->New Project，选择"RISC-V C/C++ Executable"，项目模板选择"Empty Project"。关键配置项：

Device选择：GigaDevice GD32VF103CBT6
Toolchain：GCC
勾选"Use SEFFER Runtime Library"
输出格式选择"ELF"

项目创建完成后，需要手动添加启动文件(startup_GD32VF103.S)和链接脚本(GD32VF103xB.ld)。这些文件可以从GD32VF103的SDK包中获取，也可以从GitHub上的开源项目克隆。

3.2 基础代码编写

新建main.c文件，编写一个简单的LED闪烁程序：

#include "gd32vf103.h" void delay_ms(uint32_t count) { uint32_t i; for(; count!=0; count--) { for(i=0; i<5000; i++); } } int main(void) { // 使能GPIOA时钟 rcu_periph_clock_enable(RCU_GPIOA); // 配置PA1为推挽输出 gpio_init(GPIOA, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_1); while(1) { gpio_bit_set(GPIOA, GPIO_PIN_1); // LED亮 delay_ms(500); gpio_bit_reset(GPIOA, GPIO_PIN_1); // LED灭 delay_ms(500); } }

3.3 工程配置要点

在Project->Options中需要特别关注以下设置：

Preprocessor：
- 添加宏定义：GD32VF103CBT6
- 包含路径添加设备头文件目录
Linker：
- Heap Size设置为0x400
- Stack Size设置为0x800
- 勾选"Use memory segments from target dialog"
Debugger：
- 选择J-Link
- Interface选择JTAG
- Speed设为1000kHz
- 勾选"Reset and run after programming"

4. 调试实战与技巧

4.1 基础调试流程

点击Debug->Go开始调试，SES会自动完成以下步骤：

编译工程
启动J-Link GDB Server
下载程序到Flash
复位芯片并停在main()入口

调试界面主要功能区：

反汇编窗口：查看机器指令
寄存器窗口：实时监控CPU寄存器
内存窗口：查看任意地址数据
变量窗口：跟踪局部和全局变量
调用栈：显示函数调用关系

4.2 高级调试技巧

实时变量监控：
- 在Watch窗口添加变量
- 右键变量选择"Refresh Periodically"
- 可设置刷新频率（默认1Hz）
数据断点：
- 在内存窗口右键地址
- 选择"Set Data Breakpoint"
- 可设置读/写/访问触发
性能分析：
- 使用Trace功能需要SWD接口
- 可统计函数执行时间
- 显示CPU利用率曲线
串口调试：
- 在Terminal窗口添加UART通道
- 配置波特率（115200）
- 支持printf重定向

4.3 常见问题排查

无法识别调试器：
- 检查USB连接
- 尝试更换USB端口
- 重启J-Link Config服务
下载失败：
- 确认JTAG连接可靠
- 降低调试速度（尝试500kHz）
- 检查芯片供电稳定
程序跑飞：
- 检查堆栈设置是否足够
- 验证中断向量表是否正确
- 查看HardFault寄存器

5. 进阶开发指南

5.1 外设库使用技巧

GD32VF103提供了标准外设库（类似STM32的HAL库），使用时需要注意：

时钟配置：

rcu_deinit(); // 复位时钟 SystemCoreClockUpdate(); // 更新系统时钟变量

中断处理：

void EXTI0_IRQHandler(void) { if(RESET != exti_interrupt_flag_get(EXTI_0)) { exti_interrupt_flag_clear(EXTI_0); // 中断处理代码 } }

DMA配置：

dma_parameter_struct dma_init_struct; dma_struct_para_init(&dma_init_struct); dma_init_struct.direction = DMA_MEMORY_TO_PERIPHERAL; dma_init_struct.memory_addr = (uint32_t)src_buf; // ...其他参数 dma_init(DMA0, DMA_CH0, &dma_init_struct);

5.2 低功耗开发

RVSTAR支持多种低功耗模式：

Sleep模式：

pmu_to_sleepmode(WFI_CMD); // 等待中断唤醒

DeepSleep模式：

pmu_to_deepsleepmode(PMU_LDO_NORMAL, WFI_CMD);

Standby模式：
```
pmu_to_standbymode(WFI_CMD);
```

唤醒源配置示例：

exti_interrupt_flag_clear(EXTI_13); exti_init(EXTI_13, EXTI_INTERRUPT, EXTI_TRIG_RISING); exti_interrupt_enable(EXTI_13);

5.3 性能优化建议

编译器优化：
- 在Project Options->Code->Optimization中选择-O2
- 启用Link Time Optimization (LTO)

关键代码处理：

__attribute__((section(".fast_code"))) void critical_func(void) { // 关键代码 }

然后在链接脚本中定义.fast_code段到RAM中

中断优化：
- 使用__attribute__((interrupt))修饰中断函数
- 避免在中断中进行复杂计算
- 优先使用DMA传输

6. 项目实战：温度监测系统

6.1 硬件设计

使用RVSTAR内置的ADC采集NTC热敏电阻电压：

电路连接：
- NTC一端接3.3V
- 另一端接10K电阻到GND
- 中间节点接PA0（ADC0通道0）

配置ADC：

rcu_periph_clock_enable(RCU_ADC0); adc_deinit(ADC0); adc_mode_config(ADC_MODE_FREE); adc_special_function_config(ADC0, ADC_CONTINUOUS_MODE, ENABLE); adc_resolution_config(ADC0, ADC_RESOLUTION_12B);

6.2 软件实现

温度计算算法：

float read_temperature(void) { uint16_t adc_value = adc_regular_data_read(ADC0); float voltage = adc_value * 3.3f / 4095.0f; float resistance = 10000.0f * voltage / (3.3f - voltage); // Steinhart-Hart方程 float temp_k = 1.0f / (1.0f/298.15f + 1.0f/3950.0f * log(resistance/10000.0f)); return temp_k - 273.15f; }

数据上传逻辑：

void uart_send_float(float value) { uint8_t buf[16]; int len = sprintf((char*)buf, "%.2f\n", value); for(int i=0; i<len; i++) { usart_data_transmit(USART0, buf[i]); while(RESET == usart_flag_get(USART0, USART_FLAG_TBE)); } }

6.3 系统集成

主程序框架：

int main(void) { hardware_init(); // 初始化所有外设 while(1) { float temp = read_temperature(); uart_send_float(temp); if(temp > 30.0f) { gpio_bit_set(GPIOA, GPIO_PIN_1); // 过热报警 } else { gpio_bit_reset(GPIOA, GPIO_PIN_1); } delay_ms(1000); } }

在调试这类实时系统时，可以充分利用SES的数据可视化功能：