📚 课程目录第2章开发环境搭建

2. 开发环境搭建：IDE安装与配置、调试器配置、第一个LED闪烁程序

说实话，很多初学者在学嵌入式时，第一步就被环境搭建给劝退了。我当年第一次用RISC-V内核的芯片时，也折腾了好几天才把点灯程序跑起来。这一章，咱们就把GD32V的开发环境从头捋一遍，保证你跟着做完，LED能亮起来。

2.1 IDE的选择：Nuclei Studio vs SEGGER Embedded Studio

GD32V是RISC-V内核，所以不能用Keil或者IAR（它们不支持RISC-V）。目前主流的选择有两个：

对比项	Nuclei Studio	SEGGER Embedded Studio (SES)
开发商	芯来科技（Nuclei）	SEGGER
内核支持	Nuclei RISC-V全系列	ARM + RISC-V
免费程度	完全免费	有免费版（代码大小限制）
调试器支持	J-Link、DAP-Link、自家调试器	J-Link（原生最佳）
上手难度	中等（基于Eclipse）	较低（界面简洁）
工程模板	自带GD32V例程	需手动导入

我个人习惯用Nuclei Studio，因为它对GD32V的支持最直接，开箱就能用。但如果你之前用过SEGGER的工具链，SES的编译速度确实更快。怎么选？我的建议是：新手先用Nuclei Studio，省心。

2.2 Nuclei Studio的安装与配置

安装过程其实没什么坑，但有几个细节我提醒一下：

下载地址：去芯来科技官网找“Nuclei Studio IDE”，注意选对操作系统版本。
安装路径：不要有中文和空格。我曾经见过有人装在“C:\程序 Files\”下面，结果编译报错找半天原因。
JDK依赖：Nuclei Studio基于Eclipse，需要JDK 11以上。如果电脑没有，安装包会提示你下载。
首次启动：会弹出一个Workspace路径选择，我建议单独建一个文件夹，比如 D:\GD32V_Workspace。

小技巧：安装完成后，打开菜单栏 Window → Preferences → Nuclei，检查一下“RISC-V Toolchain”路径是否自动识别。如果没有，手动指向安装目录下的 toolchain 文件夹。

2.3 调试器配置：J-Link与DAP-Link

调试器是连接电脑和开发板的桥梁。GD32V开发板通常板载DAP-Link，也可以用外接J-Link。我两种都用过，说说区别：

2.3.1 DAP-Link（板载调试器）

大部分GD32V开发板（比如GD32VF103C-START）自带DAP-Link，插上USB就能识别。驱动是免装的，Windows 10/11会自动识别为“CMSIS-DAP”设备。

2.3.2 J-Link（外接调试器）

如果你手头有J-Link，速度确实比DAP-Link快。但要注意：J-Link需要安装RISC-V专属驱动。普通J-Link驱动只支持ARM，你得去SEGGER官网下载“J-Link Software and Documentation Pack”，安装时勾选RISC-V支持。

避坑提醒：我曾经用J-Link调试GD32V时，发现连接不上。折腾了半天，最后发现是J-Link的SWD接口电压不匹配。GD32V是3.3V，而有些J-Link默认输出5V。解决办法：在J-Link的引脚上接一个3.3V的电压转换模块，或者用杜邦线把J-Link的Vref接到板子的3.3V上。

2.4 第一个LED闪烁程序

环境搭好了，咱们来写个点灯程序。这是嵌入式的“Hello World”，跑通了，后面的事就好办了。

2.4.1 创建工程

打开Nuclei Studio，点击 File → New → Nuclei RISC-V C/C++ Project。
输入工程名：LED_Blink。
选择芯片型号：GD32VF103（或者你板子对应的型号）。
选择调试器：如果你用板载DAP-Link，选“CMSIS-DAP”；如果用J-Link，选“J-Link”。
点击Finish，IDE会自动生成一个带main函数的模板工程。

2.4.2 编写代码

打开 main.c，把下面的代码贴进去：

#include "gd32vf103.h"
#include "systick.h"

void delay_ms(uint32_t ms) {
    uint32_t i;
    for(i = 0; i < ms; i++) {
        delay_1ms(1);
    }
}

int main(void) {
    // 使能GPIOC时钟
    rcu_periph_clock_enable(RCU_GPIOC);
    
    // 配置PC13为推挽输出
    gpio_init(GPIOC, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_13);
    
    while(1) {
        gpio_bit_reset(GPIOC, GPIO_PIN_13);  // LED亮（低电平有效）
        delay_ms(500);
        gpio_bit_set(GPIOC, GPIO_PIN_13);    // LED灭
        delay_ms(500);
    }
}

    注意：GD32VF103开发板上的LED通常接在PC13引脚，且是低电平点亮。如果你的板子不一样，记得查一下原理图，改引脚号和电平逻辑。

2.4.3 编译与下载

点击工具栏上的锤子图标（Build），观察控制台输出。如果没有报错，会生成 .hex 或 .elf 文件。
用USB线连接开发板到电脑。
点击绿色虫子图标（Debug），IDE会自动下载并进入调试模式。
点击 Resume（F8），LED应该开始闪烁了。

如果LED没亮，别急。我遇到过的情况：调试器驱动没装好。去设备管理器看看，有没有出现“CMSIS-DAP”或“J-Link”设备。如果没有，重新插拔USB，或者手动安装驱动。

2.5 本章知识体系

下面这张图，把开发环境搭建的核心流程串起来了：

嗯，到这里，你的开发环境就搭好了，LED也亮起来了。后面咱们要做的所有低功耗和FreeRTOS移植工作，都是在这个环境上进行的。所以，这一步走稳了，后面就顺了。