RISC-V单片机开发踩坑记：我的第一个MounRiver Studio项目从安装到点灯
第一次接触RISC-V架构单片机时，我完全是个门外汉。作为从传统ARM架构转过来的开发者，本以为能快速上手，结果从开发环境安装到第一个LED灯点亮，整整折腾了两天。这篇文章记录了我使用MounRiver Studio开发CH32V103系列芯片的完整过程，包括那些让我抓狂的坑和最终找到的解决方案。
1. 开发环境搭建：从下载到配置
MounRiver Studio作为专为RISC-V设计的IDE，官网提供了Windows和Linux两个版本。我选择了Windows版本，下载过程很顺利，但安装后立即遇到了第一个问题——驱动识别失败。
1.1 驱动安装的玄学问题
连接开发板后，设备管理器显示黄色感叹号。按照官方文档安装CH341SER驱动后，情况更糟——设备直接消失了。经过多次尝试，发现需要以下步骤：
- 完全卸载原有驱动
- 禁用驱动程序强制签名（Win10需要重启按F8）
- 安装特定版本的CH340驱动（v3.5版本最稳定）
提示：不同Windows版本对USB转串口芯片的兼容性差异很大，建议准备多个版本的驱动备用。
1.2 工程模板的隐藏陷阱
新建工程时，我直接选择了官方提供的GPIO例程模板，结果编译时报出大量头文件错误。原来MounRiver Studio的工程模板存在路径依赖问题，必须遵循以下目录结构：
ProjectRoot/ ├── User/ # 用户代码 ├── RVMS/ # 系统库文件 └── MounRiver.ini # 工程配置文件解决方法是将所有系统头文件路径改为相对路径，并在工程属性中添加预定义宏CH32V10x。
2. GPIO控制：点亮LED的曲折之路
开发板上的LED连接在PC13引脚，参考手册显示需要配置为推挽输出模式。但当我按照常规ARM开发习惯编写代码时，LED毫无反应。
2.1 时钟使能的特殊性
RISC-V的GPIO外设时钟默认是关闭的，这点与STM32不同。必须显式开启对应GPIO组的时钟：
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE);更坑的是，CH32V103的时钟树配置非常特殊，上电后默认使用内部8MHz RC振荡器，需要通过以下代码切换到72MHz：
RCC_DeInit(); RCC_HSEConfig(RCC_HSE_ON); while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET); RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); RCC_PLLCmd(ENABLE); while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET); RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK);2.2 引脚配置的细节差异
GPIO初始化结构体也有微妙差别，输出模式必须明确指定速度：
GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOC, &GPIO_InitStructure);3. 下载与调试：那些让人崩溃的瞬间
代码编译通过后，下载环节又给了我当头一棒。点击下载按钮后，IDE提示"No ST-LINK detected"，可我明明用的是WCH-Link。
3.1 调试器配置的隐藏选项
MounRiver Studio默认使用OpenOCD进行调试，但需要手动指定调试器类型。在工程属性中：
- 进入"Debug Configurations"
- 选择"WCH-Link (RISC-V)"作为调试器
- 勾选"Reset after connect"选项
3.2 下载算法的小众设定
CH32V103的Flash编程算法需要特殊配置。在"Flash Download"标签页中：
| 参数项 | 推荐值 |
|---|---|
| Programming Alg | CH32V1xx_128K |
| Verify | Full Chip |
| Reset and Run | Enabled |
4. 进阶技巧：提升开发效率的实战经验
经过多次项目实践，我总结出几个关键技巧：
4.1 自定义代码片段
MounRiver Studio支持代码模板功能。例如创建GPIO初始化模板：
<template name="GPIO Init"> <![CDATA[ GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = ${pin}; GPIO_InitStructure.GPIO_Mode = ${mode}; GPIO_InitStructure.GPIO_Speed = ${speed}; GPIO_Init(${port}, &GPIO_InitStructure); ]]> </template>4.2 串口打印调试法
在没有仿真器时，可以用串口输出调试信息。需要先初始化USART：
void USART_Config(void) { USART_InitTypeDef USART_InitStructure; USART_InitStructure.USART_BaudRate = 115200; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &USART_InitStructure); USART_Cmd(USART1, ENABLE); }然后重定向printf：
int _write(int fd, char *buf, int size) { for(int i=0; i<size; i++) { while(USART_GetFlagStatus(USART1, USART_FLAG_TXE)==RESET); USART_SendData(USART1, buf[i]); } return size; }4.3 低功耗模式实战
RISC-V在低功耗方面有独特优势。进入停止模式的完整流程：
- 配置所有GPIO为模拟输入
- 关闭不需要的外设时钟
- 执行WFI指令
void Enter_StopMode(void) { PWR_EnterSTOPMode(PWR_Regulator_LowPower, PWR_STOPEntry_WFI); SystemInit(); // 唤醒后必须重新初始化时钟 }开发过程中最让我意外的是，同样的代码在不同批次的CH32V103芯片上表现不一致。后来发现早期版本芯片的Flash等待周期需要设置为2，而新版芯片设置为0即可。这个细节在数据手册的勘误表中才有说明。
