沁恒微 RISC-V 开发实战：MounRiver Studio 工程配置与蓝牙移植指南

1. 初识 MounRiver Studio：你的 RISC-V 开发“瑞士军刀”

如果你刚拿到一块沁恒微的 RISC-V 开发板，比如热门的 CH32V307 或者带蓝牙的 CH58x 系列，第一件事肯定是琢磨怎么把代码写进去、跑起来。这时候，一个趁手的集成开发环境（IDE）就至关重要了。沁恒微官方推出的 MounRiver Studio，就是为自家 RISC-V 芯片量身打造的这么一把“瑞士军刀”。我用了挺长一段时间，从最早基于 Eclipse 的版本，到后来全面转向 VSCode 内核的 MRS2，感觉它确实在朝着“让开发更简单”这个目标不断进化。

简单来说，MounRiver Studio（后面我们简称 MRS）就是一个一站式的开发平台。你不需要自己去折腾复杂的 RISC-V 工具链安装、环境变量配置，或者到处找烧录工具。MRS 把这些都打包好了，从创建工程、编写代码、编译、调试到最终烧录进芯片，所有环节都能在一个软件里完成。特别是对于从 ARM 平台转过来，或者刚接触嵌入式的新手，这种开箱即用的体验能省下大量摸索环境的时间。我刚开始用的时候，最直观的感受就是：官网下载安装包，一路下一步装好，新建个工程点个编译，嘿，hex 文件就出来了，还能清楚地看到占用了多少 Flash 和 RAM，非常直观。

现在主推的 MounRiver Studio II 是基于 VSCode 深度定制的，界面和操作习惯对现代开发者更友好。如果你习惯用 VSCode 写代码，那几乎可以无缝切换过来，主题、快捷键都能按自己习惯来。更重要的是，它保留了第一代 MRS 对沁恒芯片的深度支持，比如工程模板、芯片支持包、调试配置都是预置好的，同时又吸收了 VSCode 强大的代码编辑和扩展能力。我实测下来，代码补全、跳转定义、实时语法检查这些功能都很稳，写起代码来流畅不少。

2. 从零开始：创建你的第一个工程

万事开头难，但用 MRS 创建第一个工程，真的不难。咱们就以最常见的点灯实验为例，手把手走一遍。

2.1 软件安装与初体验

首先，去 MounRiver 官网下载最新版的 MRS2 安装包。安装过程没什么坑，基本就是“下一步”到底。安装完成后打开，如果你喜欢暗色主题，可以在设置里调成类似 VSCode 的 Dark+，眼睛会舒服很多。软件界面主要分几个区域：左侧是工程文件管理器，中间是代码编辑区，下方是编译输出、调试控制台等。顶部工具栏集成了编译、下载、调试等最常用的按钮，非常醒目。

2.2 新建工程与编译下载

点击菜单栏的 File -> New -> MounRiver Project，就会弹出新建工程向导。这里你会看到一个沁恒全系列芯片的列表，从低端的 CH32V003 到高端的 CH32V307、带蓝牙的 CH58x 系列都有。假设我们手头有一块 CH32V307 的开发板，那就选中它。在下一步，你可以选择工程模板，比如基础的“Empty Project”（空工程）或者“GPIO_Toggle”（GPIO 翻转示例）。对于第一次接触，我建议直接选“GPIO_Toggle”，这样生成的工程里已经包含了系统时钟初始化、延时函数和一个最简单的 LED 闪烁主循环。

点击完成后，工程就创建好了。你会看到工程目录下自动生成了 main.c、CH32V30x.h、system_ch32v30x.c 等核心文件，以及链接脚本 .ld 文件。这些文件构成了一个最小可运行工程的基础骨架。这时候，你直接点击工具栏上的“Build”按钮（那个小锤子图标），IDE 就会自动调用内置的 RISC-V GCC 工具链进行编译。几秒钟后，在底部的“Build”窗口就能看到“Build Finished”的提示，并且会显示生成的 *.hex 文件路径，以及 Flash 和 RAM 的使用情况，比如 text data bss dec hex filename 后面跟着的具体数值，让你对代码体积一目了然。

编译成功后，接下来就是下载。你需要一个 WCH-LinkE 调试器（这是沁恒官方的，兼容性最好），通过 SWD 接口连接到你的开发板。在 MRS 里，下载配置基本是自动的。确保 WCH-LinkE 驱动装好并被系统识别后，点击工具栏上的“Download”按钮（那个向下的箭头），IDE 就会自动擦除芯片、编程、校验，一气呵成。下载完成后，复位一下开发板，你就能看到 LED 开始规律地闪烁了。整个过程，你几乎不需要手动配置任何