1. 课程导入

各位同学，咱们直接进入正题。做嵌入式开发，第一件事就是把环境搭好。这步搞不定，后面全是纸上谈兵。今天这一章，我带你走一遍完整流程——从IDE安装、工具链配置，到把第一个LED工程烧进CH32V307里跑起来。

1.1 开发环境概览

CH32V307是沁恒基于RISC-V内核的工业控制MCU。开发它，我们主要用官方提供的MounRiver Studio（简称MRS）。这套IDE集成了编辑器、编译器、调试器，开箱即用。我个人习惯用MRS做快速原型验证，效率很高。

整个环境包含以下核心组件：

说白了，你只需要装一个MRS，其他东西它都帮你打包好了。但驱动得自己装，这个别漏掉。

1.2 安装MounRiver Studio

去沁恒官网下载MRS安装包。Windows版本大概500MB左右。下载后直接双击安装，路径建议不要带中文和空格。我一般放在 D:\MounRiver 下面，清爽。

安装过程很简单，一路Next就行。但注意这一步：

安装完成后，桌面会出现MounRiver Studio的图标。第一次启动会提示选择工作空间（Workspace），我建议单独建一个文件夹，比如 D:\CH32V307_Workspace。这样项目文件好管理。

1.3 安装WCH-Link驱动

CH32V307开发板通常自带WCH-Link调试器。把开发板用USB线连到电脑，系统会提示安装驱动。驱动在MRS安装目录下的 LinkDrv 文件夹里，或者去沁恒官网下载WCH-Link驱动包。

安装完成后，打开设备管理器，你应该能看到：

• WCH-Link 出现在“端口（COM和LPT）”或“通用串行总线设备”下
• 如果没有，检查USB线是否支持数据传输（有些线只能充电）

嗯，这里要注意：WCH-Link驱动和ST-Link驱动有时会冲突。如果你之前装过ST-Link，建议先卸载再装WCH的。我遇到过两次，驱动冲突导致OpenOCD死活连不上芯片。

1.4 第一个LED工程：创建与编译

环境搭好了，咱们来写第一个程序。打开MRS，按以下步骤操作：

1. 点击菜单栏 File → New → MounRiver Project
2. 选择芯片型号：CH32V307
3. 选择模板：GPIO_Toggle（这就是LED闪烁的例程）
4. 输入项目名称，比如 LED_Blink
5. 点击Finish，项目自动生成

你会看到工程里已经包含了main.c、ch32v30x_it.c、ch32v30x_gpio.c等文件。沁恒的库函数风格跟STM32很像，如果你用过HAL库，上手会很快。

打开main.c，核心代码是这样的：

int main(void)
{
    NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
    Delay_Init();
    USART_Printf_Init(115200);
    printf("CH32V307 LED Blink Test\r\n");

    GPIO_Toggle_INIT();

    while(1)
    {
        GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_SET);   // LED亮
        Delay_Ms(500);
        GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_RESET); // LED灭
        Delay_Ms(500);
    }
}

这段代码逻辑很清楚：初始化GPIO，然后循环点亮、延时、熄灭、延时。PA0引脚控制板载LED。

点击工具栏的锤子图标（Build），开始编译。第一次编译会慢一些，因为要生成依赖文件。如果一切顺利，控制台会输出：

Build Finished. 0 errors, 0 warnings.

1.5 下载与运行

编译通过后，把开发板用USB线连到电脑。点击工具栏的绿色虫子图标（Debug），或者直接点向下箭头（Download）。MRS会自动调用OpenOCD，通过WCH-Link把固件烧进CH32V307。

下载成功后，程序自动运行。你应该能看到板载LED以0.5秒间隔闪烁。如果没反应，别急，按一下开发板上的复位键。

1.6 知识体系：开发环境全流程

下面这张图总结了从零开始到LED闪烁的完整流程。你可以把它当作一个检查清单，每次搭建新环境时对照着走一遍。

1.7 避坑总结

最后，我把这些年遇到的环境搭建问题整理成一张表。你遇到问题时，先对照看看：

好了，环境搭建就到这儿。你跟着走一遍，应该能顺利点亮LED。这步走通了，后面学外设驱动心里就有底了。