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

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

工欲善其事，必先利其器。做嵌入式开发，第一道坎就是搭环境。我记得刚入行那会儿，光装个Keil就折腾了一下午，各种破解、路径配置，头都大了。好在咱们这次用的MounRiver Studio（简称MRS）是专门为RISC-V芯片量身定制的IDE，安装过程非常清爽，基本上一路“下一步”就能搞定。

说白了，MRS就是基于Eclipse做的一个集成开发环境，但它把GCC编译器、调试器、烧录工具都给你打包好了。你不需要自己去配那些复杂的工具链路径，这对新手特别友好。我建议你直接去官网下载最新版，别用那些第三方渠道的旧版本，容易踩坑。

2.1 MounRiver Studio 安装步骤

安装过程没什么玄学，但有几个细节我提一下：

下载安装包：去MounRiver官网，找到对应操作系统的版本。Windows就下.exe，Linux就下.run。
关闭杀毒软件：嗯，这个很重要。有些杀毒软件会把MRS的驱动识别成威胁，导致安装失败。我遇到过两次，关了就好了。
安装路径不要有中文：这是Eclipse系IDE的老毛病了，路径里有中文或者空格，编译的时候会报一些莫名其妙的错。
安装完成后重启：让系统把驱动和路径变量刷新一下。

小提示： 安装完成后，第一次打开MRS会提示你选择工作空间（Workspace）。我个人习惯把每个项目单独建一个文件夹，比如“D:\CH32V203_Projects”，这样好管理。别放在C盘，万一系统重装，项目文件还在。

2.2 配置调试器：WCH-LinkE

CH32V203用的是沁恒自家的调试器——WCH-LinkE。这东西很小巧，但功能挺全的，支持SWD和串口。你拿到手之后，先别急着插板子，看看驱动装没装好。

怎么检查？打开设备管理器，看看有没有“WCH-LinkE”或者“USB Serial Device”的条目。如果有个黄色感叹号，那就是驱动没装上。MRS安装目录下其实自带驱动，路径一般在：

MounRiverStudio\toolchain\WCH-LinkE\驱动

手动更新一下驱动就行了。我曾经有一次怎么都连不上芯片，折腾了半天，最后发现是USB线的问题——那根线只能充电，不能传数据。你想想看，这种低级错误多耽误事。

2.3 创建第一个工程：LED闪烁

环境搭好了，咱们来点实际的。让板子上的LED闪起来，这是嵌入式界的“Hello World”。

2.3.1 新建工程

打开MRS，点击菜单栏的 File → New → MounRiver Project。会弹出一个对话框，你需要填几个关键信息：

配置项	推荐值	说明
Project Name	LED_Blink	工程名，别用中文
MCU Type	CH32V203C8T6	选对型号，不然外设地址不对
Project Template	CH32V203C8T6	选带外设库的模板
Toolchain	RISC-V GCC	默认就是，不用改

点击Finish，MRS会自动帮你生成一套完整的工程模板，包括启动文件、链接脚本、外设库。你不需要从零开始写寄存器，直接调用库函数就行。

2.3.2 编写代码

打开工程里的 main.c，你会看到一堆初始化代码。别慌，咱们只关心LED控制的部分。先看看原理图，找到LED接在哪个GPIO上。CH32V203的开发板，LED通常接在 PC13 或者 PA0 上，具体看你手里的板子。

下面是我写的一个最简单的闪烁程序：

#include "debug.h"

/* LED引脚定义，假设是PC13 */
#define LED_GPIO_PORT   GPIOC
#define LED_GPIO_PIN    GPIO_Pin_13

void Delay_Ms(uint32_t ms)
{
    uint32_t i;
    for(i = 0; i < ms; i++)
    {
        uint32_t j;
        for(j = 0; j < 1200; j++);
    }
}

int main(void)
{
    /* 初始化系统时钟，默认是96MHz */
    SystemCoreClockUpdate();
    /* 初始化延时函数 */
    Delay_Init();

    /* 使能GPIOC时钟 */
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE);

    /* 配置PC13为推挽输出，速度50MHz */
    GPIO_InitTypeDef GPIO_InitStructure = {0};
    GPIO_InitStructure.GPIO_Pin = LED_GPIO_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(LED_GPIO_PORT, &GPIO_InitStructure);

    while(1)
    {
        /* 输出低电平，LED亮（取决于硬件设计） */
        GPIO_ResetBits(LED_GPIO_PORT, LED_GPIO_PIN);
        Delay_Ms(500);

        /* 输出高电平，LED灭 */
        GPIO_SetBits(LED_GPIO_PORT, LED_GPIO_PIN);
        Delay_Ms(500);
    }
}

  关键点： 代码里的 Delay_Ms 是我自己写的简易延时函数，实际项目中建议用定时器中断来做延时，更精准。这里只是为了演示，让LED肉眼可见地闪烁。

2.3.3 编译与下载

代码写完了，点一下工具栏上的小锤子图标（Build），或者按 Ctrl+B。MRS会调用GCC编译器，把C代码编译成RISC-V的机器码。如果代码没问题，控制台会输出：

Build Finished. 0 errors, 0 warnings.

看到这个就说明编译通过了。接下来是下载，把WCH-LinkE连接到开发板的SWD接口，注意线序：

SWDIO：数据线
SWCLK：时钟线
GND：地线
3.3V：电源（可选，如果板子已经供电就不用接）

连接好后，点击工具栏上的绿色虫子图标（Debug），或者按 F11。MRS会自动识别WCH-LinkE，把程序烧录到芯片里，然后进入调试模式。如果你只想烧录不调试，点那个向下箭头旁边的“Download”按钮就行。

注意： 如果下载失败，提示“Cannot connect to target”，先检查接线。我曾经遇到过SWD线太长导致信号衰减的问题，后来把线剪短到10厘米以内就正常了。另外，确保板子供电正常，有些开发板需要单独供电，光靠调试器的3.3V带不动。

2.4 知识结构图：开发环境搭建全流程

下面这张图把整个流程串起来了，从安装IDE到LED闪烁，每一步都离不开。你可以把它当作一个检查清单：

2.5 调试技巧：让LED真正“听话”

程序下载进去了，LED闪了吗？如果没闪，别急。我教你一个排查思路：

先看电源：板子上的电源指示灯亮不亮？万用表量一下3.3V和GND，确保供电正常。
再看GPIO：用示波器或者逻辑分析仪抓一下PC13的波形。如果有方波，说明程序在跑，可能是LED接反了或者限流电阻不对。
最后看代码：检查一下GPIO的时钟使能了没有，引脚号对不对。我犯过最蠢的错误是把PC13写成了PC3，查了半天。

调试小技巧： 在MRS里，你可以设置断点，然后单步执行。看看程序是不是卡在了某个循环里，或者变量值对不对。右键点击变量，选择“Add Watch Expression”，就能实时看到它的值。这个功能在排查逻辑错误时特别好用。

好了，到这里你的第一个RISC-V程序就跑起来了。虽然只是让LED闪了闪，但背后的流程——从环境搭建、工程创建、代码编写到调试下载——是后面所有复杂项目的基础。把这个流程跑通，后面的事情就顺了。