从零开始：用MounRiver Studio和WCH-Link玩转CH32V103C开发板

第一次拿到CH32V103C开发板和WCH-Link调试器时，那种既兴奋又忐忑的心情我至今记忆犹新。作为RISC-V架构的入门级MCU，CH32V103C以其高性价比和丰富的外设资源吸引了不少嵌入式爱好者，但对于新手来说，从开箱到成功运行第一个程序往往充满挑战。本文将带你一步步完成开发环境搭建、硬件连接、程序下载和调试的全过程，避开那些我当年踩过的坑。

1. 开发环境准备：打造你的嵌入式工作站

工欲善其事，必先利其器。在开始硬件操作前，我们需要先搭建好软件开发环境。MounRiver Studio作为沁恒官方推荐的集成开发环境(IDE)，为CH32V系列提供了完善的支持。

1.1 软件安装与配置

首先访问MounRiver Studio官网下载最新版本。安装过程中有几个关键点需要注意：

• 安装路径：建议使用默认路径，避免中文或特殊字符
• 组件选择：确保勾选"CH32V系列支持包"
• 驱动安装：安装完成后连接WCH-Link会自动安装驱动

安装完成后首次启动时，IDE会提示选择工作空间(Workspace)，这是存放你所有项目的地方。建议创建一个专门的文件夹，比如D:\CH32V_Projects。

bash复制# 检查WCH-Link驱动是否安装成功（设备管理器应显示如下）
USB-SERIAL CH340 (COMx)  # 串口部分
WCH-LinkRV Debugger      # 调试器部分

1.2 硬件开箱检查

打开CH32V103C开发板包装，你应该能看到以下部件：

• 开发板本体
• WCH-Link调试器
• USB数据线（Type-A转Micro-B）
• 杜邦线若干

注意：初次使用前建议检查开发板是否有明显物理损伤，特别是USB接口和排针部分。

2. 硬件连接：构建开发板与电脑的桥梁

正确的硬件连接是成功的第一步，也是最容易出错的地方之一。我们将分步完成WCH-Link与开发板的连接。

2.1 WCH-Link与开发板接线

使用杜邦线按照以下方式连接：

c复制// 开发板引脚定义参考（位于board.h）
#define LED1_PIN    GPIO_Pin_0  // PA0
#define LED2_PIN    GPIO_Pin_1  // PA1
#define UART_TX_PIN GPIO_Pin_9  // PA9
#define UART_RX_PIN GPIO_Pin_10 // PA10

2.2 电源与模式检查

连接完成后，按以下顺序上电：

1. 先将WCH-Link通过USB线连接到电脑
2. 观察WCH-Link指示灯：
   • 红色常亮：RISC-V模式（我们需要这个）
   • 红蓝交替：ARM模式
3. 开发板上的电源指示灯(PWR)应亮起

提示：如果WCH-Link指示灯异常，可能需要固件升级或模式切换，我们将在第4章详细说明。

3. 创建第一个工程：点亮LED

现在进入最激动人心的环节——让开发板上的LED按照我们的指令闪烁。

3.1 导入示例工程

在MounRiver Studio中：

1. 点击"File" → "New" → "CH32V Project"
2. 选择"GPIO_Toggle"示例工程
3. 设置工程名称和存储位置
4. 点击"Finish"完成创建

工程结构大致如下：

code复制GPIO_Toggle/
├── User/
│   ├── main.c          # 主程序
│   └── debug.c         # 串口调试相关
├── CH32V103C8T6.ld     # 链接脚本
└── MounRiver.ini       # IDE配置文件

3.2 代码解析与修改

打开main.c文件，我们可以看到基本的LED闪烁程序。让我们增强它的功能，实现双LED交替闪烁：

c复制#include "debug.h"

void GPIO_Config(void)
{
    GPIO_InitTypeDef GPIO_InitStructure = {0};
    
    // 启用GPIOA时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
    
    // 配置PA0和PA1为推挽输出
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz;
    GPIO_Init(GPIOA, &GPIO_InitStructure);
}

int main(void)
{
    // 系统初始化
    NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
    Delay_Init();
    USART_Printf_Init(115200);
    
    printf("SystemClk: %d\r\n", SystemCoreClock);
    printf("Dual LED Toggle Test\r\n");
    
    GPIO_Config();
    
    while(1)
    {
        // LED1亮，LED2灭
        GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_RESET);
        GPIO_WriteBit(GPIOA, GPIO_Pin_1, Bit_SET);
        printf("LED状态: ● ○\r\n");
        Delay_Ms(500);
        
        // LED1灭，LED2亮
        GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_SET);
        GPIO_WriteBit(GPIOA, GPIO_Pin_1, Bit_RESET);
        printf("LED状态: ○ ●\r\n");
        Delay_Ms(500);
    }
}

3.3 编译与下载

代码修改完成后：

1. 点击工具栏上的"Build"按钮（或Ctrl+B）编译工程
2. 确保没有错误后，点击"Flash" → "Download"
3. 首次下载时可能会提示WCH-Link固件升级，按照提示完成即可
4. 下载成功后，开发板上的两个LED应该开始交替闪烁

4. 串口调试与问题排查

串口调试是嵌入式开发中不可或缺的技能，它能帮助我们了解程序运行状态和排查问题。

4.1 串口助手配置

推荐使用以下任意一款串口工具：

• MounRiver Studio内置终端
• Putty
• Tera Term
• CoolTerm

基本配置参数：

bash复制# 在Linux下可以使用minicom
sudo minicom -D /dev/ttyUSB0 -b 115200

4.2 常见问题解决

在调试过程中可能会遇到以下问题：

1. WCH-Link无法识别

   • 检查USB线是否完好
   • 尝试更换USB端口
   • 重新安装驱动程序

2. 下载失败

   • 确认开发板供电正常
   • 检查SWD连接线是否松动
   • 尝试降低下载速度（在Download Configuration中设置）

3. 串口无输出

   • 确认TX/RX线连接正确
   • 检查波特率设置是否匹配
   • 确保代码中调用了USART_Printf_Init(115200)

提示：遇到问题时，先检查最基本的电源、接地和连接线，这些往往是问题的根源。

5. 进阶技巧：发挥WCH-Link的全部潜力

WCH-Link不仅仅是一个简单的下载器，它还提供了许多实用功能。

5.1 模式切换

WCH-Link支持两种工作模式：

• RISC-V模式：用于CH32V系列MCU
• ARM模式：用于ARM Cortex-M系列MCU

切换方法：

1. 硬件方式：断电状态下短接TX和GND，然后重新上电
2. 软件方式：在MounRiver Studio中通过"Flash" → "Download Configuration" → "Debugger Target Mode"选择

5.2 性能优化

通过调整以下参数可以提升调试体验：

ini复制# 在MounRiver.ini中可以保存这些设置
[Debug]
Clock=4000
Reset=Hardware

6. 项目实战：构建一个呼吸灯效果

现在让我们综合运用所学知识，实现一个PWM呼吸灯效果。

6.1 PWM基础配置

CH32V103C的定时器可以产生PWM信号，以下是配置步骤：

1. 启用TIM1和GPIOA时钟
2. 配置PA8为复用推挽输出
3. 初始化TIM1为PWM模式
4. 设置PWM周期和占空比

c复制void PWM_Config(void)
{
    GPIO_InitTypeDef GPIO_InitStructure = {0};
    TIM_OCInitTypeDef TIM_OCInitStructure = {0};
    TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure = {0};
    
    // 启用时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_TIM1, ENABLE);
    
    // 配置PA8为TIM1 CH1
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_8;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOA, &GPIO_InitStructure);
    
    // 定时器基础配置
    TIM_TimeBaseInitStructure.TIM_Period = 999;  // PWM周期
    TIM_TimeBaseInitStructure.TIM_Prescaler = 71; // 分频系数
    TIM_TimeBaseInitStructure.TIM_ClockDivision = TIM_CKD_DIV1;
    TIM_TimeBaseInitStructure.TIM_CounterMode = TIM_CounterMode_Up;
    TIM_TimeBaseInit(TIM1, &TIM_TimeBaseInitStructure);
    
    // PWM模式配置
    TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1;
    TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;
    TIM_OCInitStructure.TIM_Pulse = 500;  // 初始占空比50%
    TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;
    TIM_OC1Init(TIM1, &TIM_OCInitStructure);
    
    // 启用TIM1
    TIM_CtrlPWMOutputs(TIM1, ENABLE);
    TIM_Cmd(TIM1, ENABLE);
}

6.2 实现呼吸效果

在主循环中添加以下代码，实现平滑的亮度变化：

c复制int main(void)
{
    // ...之前的初始化代码...
    PWM_Config();
    
    uint16_t duty = 0;
    int8_t step = 5;
    
    while(1)
    {
        duty += step;
        if(duty >= 1000 || duty <= 0) {
            step = -step;
        }
        
        TIM_SetCompare1(TIM1, duty);
        Delay_Ms(10);
    }
}

6.3 效果优化建议

• 增加非线性变化：使用正弦函数计算duty值，效果更自然
• 添加串口控制：通过串口命令调整呼吸速度
• 多LED同步：扩展使用多个PWM通道控制不同LED

c复制// 非线性变化示例
duty = 500 + 500 * sin(cnt++ * 0.01f);
TIM_SetCompare1(TIM1, (uint16_t)duty);
Delay_Ms(20);

7. 开发效率提升技巧

经过几个项目的实践，我总结了一些能显著提升CH32V103C开发效率的技巧。

7.1 代码模板管理

MounRiver Studio支持代码模板功能，可以创建常用代码片段：

1. 打开"Window" → "Preferences" → "C/C++" → "Editor" → "Templates"
2. 点击"New"创建新模板
3. 例如创建一个GPIO初始化模板：

c复制void ${peripheral}_Config(void)
{
    GPIO_InitTypeDef GPIO_InitStructure = {0};
    
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_${GPIOx}, ENABLE);
    
    GPIO_InitStructure.GPIO_Pin = ${GPIO_Pin};
    GPIO_InitStructure.GPIO_Mode = ${Mode};
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(${GPIOx}, &GPIO_InitStructure);
}

7.2 调试技巧

充分利用MounRiver Studio的调试功能：

• 断点设置：在关键代码行左侧点击设置断点
• 变量监视：在"Expressions"窗口添加要监视的变量
• 内存查看：使用"Memory"视图查看特定地址的内存内容
• 外设寄存器：通过"Peripherals"菜单查看和修改外设寄存器

7.3 版本控制集成

虽然MounRiver Studio没有内置Git支持，但可以通过外部工具实现：

1. 安装Git并配置环境变量
2. 在项目根目录初始化仓库：

bash复制git init
git add .
git commit -m "Initial commit"

3. 使用SourceTree、GitKraken等图形化工具管理版本

8. 资源推荐与后续学习路径

掌握了基础开发流程后，你可能想进一步探索CH32V103C的更多可能性。

8.1 官方资源

• 沁恒官网：获取最新数据手册和参考设计
• MounRiver更新日志：了解IDE新增功能
• WCH社区论坛：与其他开发者交流经验

8.2 推荐外设探索顺序

1. GPIO：基础输入输出
2. USART：串口通信
3. TIM：定时器和PWM
4. ADC：模拟信号采集
5. I2C/SPI：与传感器通信
6. USB：设备/主机功能

8.3 项目创意

• 智能家居控制器
• 简易数据采集器
• 自定义HID设备
• 低功耗传感器节点
• 教育用示波器

第一次成功点亮LED时的成就感至今难忘，那种"我做到了！"的兴奋感是推动我继续学习嵌入式开发的原始动力。CH32V103C虽然定位入门级，但其丰富的外设和RISC-V的开放性架构为学习提供了绝佳平台。记得在初期遇到问题时不要气馁，嵌入式开发本就是不断试错和积累经验的过程。当你掌握了这些基础技能后，可以尝试挑战更复杂的项目，比如将多个外设组合使用，或者尝试RTOS等更高级的应用。