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

1. CH32V203开发环境搭建：MounRiver Studio安装与配置、调试器连接、第一个点灯程序

做嵌入式开发，第一步永远是搭环境。这事听起来简单，但我在带新人时发现，很多人卡在工具链配置和调试器连接上。CH32V203用的是RISC-V内核，跟ARM那套不太一样，IDE、编译器、调试器都得重新熟悉。

这一章，咱们就把MounRiver Studio装好，把调试器连上，再跑个点灯程序。嗯，点灯是嵌入式界的"Hello World"，跑通了，后面的事就好办了。

1.1 MounRiver Studio是什么？

MounRiver Studio（简称MRS）是沁恒官方推出的IDE，基于Eclipse框架，集成了GCC编译器、调试器和烧录工具。说白了，它把编辑、编译、下载、调试全打包了，你装一个软件就够。

我个人习惯用MRS而不是自己搭命令行工具链，原因很简单：省时间。沁恒的芯片有一些私有寄存器和外设配置，MRS的工程模板和链接脚本都是调好的，拿来就能用。

特性	说明
IDE基础	Eclipse 4.x + CDT插件
编译器	GCC for RISC-V（带沁恒扩展）
调试器	OpenOCD + GDB，支持WCH-Link
烧录工具	内置ISP和SWD模式
支持芯片	CH32V系列、CH56x系列等

1.2 安装与配置步骤

去沁恒官网下载MounRiver Studio，目前最新稳定版是V1.9.x。安装包大概500MB，Windows和Linux都有。我建议用Windows，调试器驱动更省心。

下载安装包：官网找到"MounRiver Studio"页面，选对应操作系统版本。
运行安装程序：一路Next就行。注意安装路径不要有中文和空格，我吃过这个亏——Eclipse对中文路径支持不好，编译会报奇奇怪怪的错误。
安装WCH-Link驱动：在MRS安装目录下找到toolchain\openocd\wch-link\driver，运行WCH-Link驱动安装.exe。插上调试器，如果设备管理器里出现"WCH-Link"设备，说明驱动装好了。
配置调试器：打开MRS，菜单栏选 Window → Preferences → MCU → Debugger，确认调试器类型选的是"WCH-Link"，接口选"SWD"。速度默认4MHz，如果线长超过20cm，我建议降到1MHz，否则容易连接失败。

⚠ 注意：WCH-Link有两种模式——SWD模式和ISP模式。调试必须用SWD模式。如果调试器红灯常亮，说明在ISP模式，按住板子上的复位键再上电，或者用MRS的"切换到SWD模式"工具切换。

1.3 第一个工程：点灯

环境搭好了，咱们建个工程试试。CH32V203开发板上通常有个LED接在PC0或PD0，具体看原理图。我手头这块板子是PC0。

1.3.1 新建工程

MRS菜单栏选 File → New → MounRiver Project。
芯片型号选 CH32V203C8T6（或其他具体型号）。
工程模板选 CH32V203C8T6 → GPIO_Toggle。这个模板已经配好了时钟和GPIO初始化，省事。
工程名写 LED_Blink，点Finish。

MRS会自动生成main.c、system_ch32v20x.c、ch32v20x_it.c等文件。你打开main.c，会看到类似下面的代码：

#include "ch32v20x.h"

void Delay_Ms(uint32_t ms) {
    uint32_t i;
    for (i = 0; i < ms * 8000; i++) {
        __NOP();
    }
}

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

    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE);

    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOC, &GPIO_InitStructure);

    while(1) {
        GPIO_SetBits(GPIOC, GPIO_Pin_0);
        Delay_Ms(500);
        GPIO_ResetBits(GPIOC, GPIO_Pin_0);
        Delay_Ms(500);
    }
}

这段代码逻辑很清楚：开GPIOC时钟，配PC0为推挽输出，然后循环拉高拉低，延时500ms。注意那个延时函数是软件空转，精度不高，但点灯够用。

1.3.2 编译与下载

点工具栏的锤子图标（Build），或者按 Ctrl+B。MRS会调用GCC编译，输出在Console窗口。第一次编译会慢一点，因为要编译库文件。
编译成功后，点绿色虫子图标（Debug），或者按 F11。MRS会自动启动OpenOCD，连接WCH-Link，下载固件到Flash。
下载完成后，程序自动运行。如果LED没亮，检查接线和调试器模式。

💡 小技巧：如果Debug时卡在"Connecting to target..."，先拔掉调试器USB线再插上，或者按一下板子上的复位键。我曾经遇到过WCH-Link固件版本太旧导致连接失败，去沁恒官网更新一下固件就好了。

1.4 调试器连接与故障定位

点灯程序跑起来了，但实际项目中总会遇到连不上调试器的情况。我总结了几种常见问题：

现象	可能原因	解决办法
OpenOCD报"no device found"	驱动未安装或调试器模式错误	重装驱动，切换到SWD模式
连接成功但无法下载	Flash写保护或芯片锁死	按住复位键再点下载，松开复位
下载后程序不运行	启动文件配置错误或时钟配置不对	检查system_ch32v20x.c中的时钟设置
调试时单步执行卡住	优化等级太高，代码被优化掉了	工程属性里把优化等级改成-O0或-Og

嗯，这里要特别说一下芯片锁死的问题。CH32V203的Flash有写保护，如果你用ISP模式烧录了错误的程序，或者调试时意外断电，芯片可能进入保护状态。解决办法是：用MRS的"擦除芯片"功能，或者短接BOOT0到3.3V再上电，进入系统存储器模式重新烧录。

1.5 知识体系总览

下面这张图把本章的核心流程串起来了。从安装IDE到最终跑通点灯，每一步都有坑，但走一遍就熟了。

1.6 避坑指南

最后，分享几个我踩过的坑：

路径问题：MRS工程路径和安装路径都不要有中文和空格。我曾经把工程放在"桌面"上，结果编译报错找不到头文件，折腾了半天才发现是路径里有中文。
调试器固件：WCH-Link出厂固件可能比较旧，如果连接不稳定，去沁恒官网下载"WCH-Link Utility"更新固件。更新后记得重新拔插USB。
优化等级：调试阶段把优化等级设为-O0或-Og，否则单步执行时变量值可能看不到，代码行也会跳来跳去。发布时再改成-Os或-O2。
复位电路：CH32V203的复位引脚是低电平复位，如果板子上的复位电容太大（超过10μF），上电时复位时间过长，调试器可能连不上。我遇到过一块板子用100μF电容，每次都要手动复位才能下载。

好了，环境搭好了，灯也亮了。后面咱们就可以开始折腾外设了——GPIO、UART、SPI、I2C，一个一个来。