当前位置：首页 > news >正文

MounRiver Studio与WCH-Link实战：从零点亮CH32V103C的LED与串口通信

news 2026/6/28 20:40:06

1. 环境准备与硬件连接

第一次接触嵌入式开发的朋友可能会觉得硬件连接很复杂，其实只要按照步骤来，整个过程就像拼乐高积木一样简单。我们先来看看需要准备哪些东西：

MounRiver Studio：这是沁恒官方推出的集成开发环境，基于Eclipse打造，专门为RISC-V芯片优化。我实测安装包只有200MB左右，对电脑配置要求很低，老笔记本也能流畅运行。下载后直接解压就能用，不需要复杂的安装过程。
WCH-Link调试器：这个小巧的蓝色工具是连接电脑和开发板的桥梁。最新版的WCH-Link同时支持RISC-V和ARM架构，通过指示灯颜色就能区分当前模式（红色代表RISC-V模式）。建议到手后先检查固件版本，我遇到过因为固件太旧导致无法识别设备的情况。
CH32V103C开发板：这块板子尺寸比信用卡还小，但该有的外设一应俱全。板载的Type-C接口可以直接供电，对于初学者特别友好。记得下载官方提供的EVT包，里面包含原理图、例程等关键资料。

硬件连接时最容易出错的就是杜邦线接法。根据我的踩坑经验，一定要按照这个顺序操作：

先给WCH-Link接上USB线（但先别插电脑）
用杜邦线连接SWD接口：SWCLK接PA14、SWDIO接PA13、GND接GND
串口线单独连接：TX接PA9、RX接PA10
最后把LED正极接到PA0，负极接GND

注意：很多新手会忽略线序问题，建议用不同颜色的杜邦线区分功能。我习惯红色接电源、黑色接地、黄色接时钟线，这样排查问题时一目了然。

2. 工程创建与基础配置

打开MounRiver Studio后，我建议先做两件事：设置工作空间路径和检查工具链。工作空间最好不要放在中文路径下，我之前因为路径包含中文导致编译报错，排查了半天才发现问题。

创建新工程时，有经验的开发者可能会选择空工程，但作为新手，我强烈建议直接导入官方例程：

点击File -> Import -> General -> Existing Projects into Workspace
选择EVT包中的GPIO_Toggle例程
勾选"Copy projects into workspace"选项

这个例程已经配置好了基本的时钟树和调试参数，能帮我们避开很多坑。比如CH32V103的默认时钟是24MHz，但通过例程里的SystemInit()函数可以看到，实际运行时会切换到72MHz。

在Project Explorer中展开工程目录，重点关注这几个文件：

main.c：主程序入口
debug.h：串口打印相关的宏定义
CH32V10x.h：芯片寄存器映射
ld链接脚本：决定代码和数据在Flash中的分布

编译前记得检查Build Configuration。我遇到过因为选了错误的目标芯片导致程序跑飞的情况。正确的做法是：

右键工程 -> Properties -> C/C++ Build
在Configuration下拉框选择"Debug"
确保Toolchain是RISC-V GCC

3. 代码解析与LED控制

打开main.c文件，我们会看到一个典型的嵌入式程序结构。先看GPIO初始化部分：

GPIO_InitTypeDef GPIO_InitStructure = {0}; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz; GPIO_Init(GPIOA, &GPIO_InitStructure);

这段代码做了三件重要的事：

通过RCC_APB2PeriphClockCmd使能GPIOA的时钟（所有外设使用前都要先开时钟）
配置PA0为推挽输出模式（GPIO_Mode_Out_PP）
设置输出速度为2MHz（低速足够驱动LED）

在while循环中，控制LED闪烁的核心代码是：

GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_SET); Delay_Ms(500); GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_RESET); Delay_Ms(500);

这里有个新手常犯的错误：以为Bit_SET是点亮LED。实际上这取决于电路设计，在CH32V103开发板上，LED采用共阳接法，所以给低电平（Bit_RESET）才会亮。如果发现LED状态相反，检查硬件连接或者修改代码逻辑即可。

4. 串口通信实现与调试

串口是嵌入式开发中最常用的调试手段。在例程中，串口初始化是通过USART_Printf_Init函数完成的：

USART_Printf_Init(115200); printf("SystemClk:%d\r\n", SystemCoreClock);

这里设置的115200波特率需要与串口调试工具保持一致。我推荐使用MounRiver Studio自带的串口监视器，相比第三方工具，它能自动识别WCH-Link的虚拟串口，减少配置步骤。

如果遇到乱码问题，按这个步骤排查：

确认双方波特率一致（精确到个位数）
检查时钟配置（SystemCoreClock打印值应该是72000000）
验证串口线序（TX接RX，RX接TX）
查看USB转串口芯片驱动是否正常

为了提高代码可读性，我习惯用条件编译来管理调试信息：

#define DEBUG 1 #if DEBUG printf("当前LED状态:%s\r\n", GPIO_ReadOutputDataBit(GPIOA, GPIO_Pin_0)?"灭":"亮"); #endif

这样在发布版本时，只需将DEBUG改为0就能关闭所有调试输出，不影响程序性能。

5. 程序下载与调试技巧

点击工具栏上的下载按钮时，MounRiver Studio会执行以下操作：

自动检测WCH-Link模式（必须处于RISC-V模式）
如果有新固件会提示升级（建议保持最新固件）
擦除Flash并烧录程序
可选是否复位运行

遇到下载失败时，可以尝试：

重新插拔USB线
检查SWD连接是否松动
在Download Configuration里勾选"Reset after download"

调试时特别实用的两个功能：

实时变量监控：在Expressions窗口添加要监视的变量
断点调试：在代码行号左侧双击添加断点，支持条件断点

我常用的调试组合键：

F5：开始/继续调试
F6：单步跳过
F7：单步进入
F8：恢复运行

6. 功能扩展实战

现在我们来升级例程，实现两个LED交替闪烁，同时串口打印状态变化。首先修改GPIO初始化：

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1;

然后在主循环中添加控制逻辑：

while(1) { GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_SET); GPIO_WriteBit(GPIOA, GPIO_Pin_1, Bit_RESET); printf("LED1:灭 LED2:亮\r\n"); Delay_Ms(1000); GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_RESET); GPIO_WriteBit(GPIOA, GPIO_Pin_1, Bit_SET); printf("LED1:亮 LED2:灭\r\n"); Delay_Ms(1000); }

这个修改过程中有几个注意点：