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

1. CH32V203开发环境搭建：MounRiver Studio安装、驱动安装、第一个LED工程编译下载

做嵌入式开发，第一步永远是搭环境。这事说简单也简单，说烦人也烦人。我见过不少新手卡在驱动安装上，折腾半天点不亮LED，最后发现是USB识别出了问题。所以这一章，咱们把MounRiver Studio（简称MRS）的安装、驱动配置、第一个工程的编译下载，一步步走通。

1.1 开发环境全景概览

在动手之前，先搞清楚我们要装哪些东西。CH32V203用的是沁恒自研的RISC-V内核，调试工具链和传统的ARM开发不太一样。下面这张图帮你理清整体结构：

说白了，整个链条就是：PC上的MRS → USB → WCH-LinkE调试器 → SWD接口 → CH32V203芯片。中间任何一个环节断了，灯都点不亮。

1.2 MounRiver Studio 安装

MRS是沁恒基于Eclipse二次开发的IDE，集成了GCC交叉编译器、调试器和一堆外设库。我个人习惯直接去官网下最新版，目前稳定版是V1.9.x。

安装步骤

下载安装包：从MounRiver官网下载Windows版本（.exe）。注意区分32位和64位。
运行安装程序：双击exe，一路Next。建议安装路径不要带中文和空格，比如 D:\MounRiver。
选择组件：默认会勾选所有组件，包括Eclipse平台、GCC工具链、调试插件。保持默认即可。
完成安装：安装结束后，桌面会出现MounRiver Studio图标。

我的经验：第一次启动MRS时，Eclipse会初始化工作空间。我建议单独建一个文件夹，比如 D:\CH32V203_Workspace，不要把工程堆在桌面。后面项目多了你就知道好处了。

1.3 WCH-Link 驱动安装

WCH-LinkE调试器插上电脑后，系统会尝试自动识别。但Windows 10/11的自动驱动库不一定能正确匹配。我曾经遇到过插上后设备管理器里显示“未知设备”，折腾了半小时才发现是驱动没装对。

驱动安装流程

步骤	操作	说明
1	连接WCH-LinkE到电脑USB口	板载调试器通常已集成，外置版需单独接线
2	打开设备管理器	Win+X → 设备管理器
3	查看端口(COM和LPT)或通用串行总线设备	正常应出现 "WCH-Link" 或 "WCH-LinkE"
4	若显示黄色感叹号	右键 → 更新驱动程序 → 浏览我的电脑 → 选择MRS安装目录下的 `Driver` 文件夹
5	手动指定驱动	选择 "WCH-Link" 或 "WCH-LinkE" 对应的inf文件
6	验证安装成功	设备管理器中出现 "WCH-LinkE" 且无感叹号

注意：WCH-LinkE有两种模式：RISC-V模式和ARM模式。默认是RISC-V模式，用于CH32V203。如果你之前用过STM32，调试器可能被切换到了ARM模式。切换方法：按住调试器上的按键再插USB，指示灯会闪烁，松开后模式切换完成。

1.4 第一个LED工程：创建、编译、下载

环境搭好了，驱动也认了，接下来就是经典的“点灯”环节。CH32V203的GPIO操作和STM32有点像，但寄存器地址和库函数有差异。MRS自带了很多例程，咱们直接拿现成的改。

1.4.1 导入官方例程

打开MRS，选择工作空间（就是刚才建的文件夹）。
菜单栏：File → Import → Existing Projects into Workspace。
选择例程路径：MRS安装目录 / CH32V203EVT / EVT / EXAMP / GPIO / GPIO_Toggle。
勾选工程，点击Finish。

1.4.2 工程结构解析

导入后你会看到这样的目录结构：

GPIO_Toggle/
├── User/
│   ├── main.c
│   ├── ch32v20x_it.c
│   └── ch32v20x_it.h
├── Periph/
│   ├── inc/          (外设头文件)
│   └── src/          (外设源文件)
├── Startup/
│   └── startup_ch32v20x.S   (启动文件)
├── Ld/
│   └── link.ld              (链接脚本)
└── .project / .cproject

main.c里就是核心逻辑。咱们打开看看：

#include "ch32v20x.h"

void Delay_Init(void);
void Delay_Ms(uint32_t n);

int main(void)
{
    GPIO_InitTypeDef GPIO_InitStructure = {0};

    // 使能GPIO时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOD, ENABLE);

    // 配置PD0为推挽输出
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOD, &GPIO_InitStructure);

    Delay_Init();

    while(1)
    {
        GPIO_SetBits(GPIOD, GPIO_Pin_0);   // 亮
        Delay_Ms(500);
        GPIO_ResetBits(GPIOD, GPIO_Pin_0); // 灭
        Delay_Ms(500);
    }
}

  关键点：CH32V203的GPIO引脚功能复用和STM32类似，但库函数名称略有不同。比如 GPIO_Mode_Out_PP 对应推挽输出，GPIO_Speed_50MHz 是输出速度。这些在沁恒的库函数手册里都有。

1.4.3 编译工程

点击工具栏上的锤子图标（Build），或者按 Ctrl+B。
观察控制台输出。第一次编译会下载依赖库，稍等片刻。
编译成功会显示 Build Finished，生成 .hex 和 .elf 文件。

避坑指南：如果编译报错“找不到头文件”，检查工程属性中的Include路径。右键工程 → Properties → C/C++ Build → Settings → Tool Settings → Includes，确保 Periph/inc 和 User 路径已添加。

1.4.4 下载到开发板

用USB线连接WCH-LinkE到电脑，另一端SWD接口连到CH32V203开发板。
在MRS中点击绿色虫子图标（Debug），或者右键工程 → Debug As → WCH-Link Debug。
弹出调试配置窗口，确认调试器选择为 WCH-Link，接口为 SWD。
点击Debug，MRS会自动下载固件并进入调试模式。
按F8（Resume）运行程序，开发板上的LED应该开始闪烁。

注意：如果下载失败，检查以下几点：
- 调试器是否被识别（设备管理器查看）
- SWD接线是否正确（VCC、GND、SWDIO、SWCLK四根线）
- 开发板供电是否正常（有些板子需要外部供电）
- 调试器模式是否为RISC-V模式

1.5 常见问题与解决

问题现象	可能原因	解决方法
设备管理器显示未知设备	驱动未安装或安装错误	手动指定驱动路径为MRS的Driver文件夹
编译报错：找不到头文件	工程Include路径缺失	添加Periph/inc和User路径
下载失败：无法连接目标	SWD接线错误或调试器模式不对	检查接线，切换调试器模式
LED不闪烁	GPIO引脚配置错误或延时不对	核对原理图，检查GPIO_Pin定义
MRS启动卡死	工作空间路径有中文或权限不足	更换纯英文路径，以管理员身份运行

嗯，到这里，你的CH32V203开发环境就算正式搭好了。LED闪烁的那一刻，是不是有点小成就感？后面咱们会深入调试器的使用、外设驱动编写、RTOS移植等内容。每一步我都会把项目中踩过的坑、总结的经验分享出来。