MounRiver Studio 开发环境的使用简介 ...... 矜辰所致 ...更新修改文件关联路径部分说明 2025/10/23 ...更新第四章节如何将工程独立出来 2026/1/13 ...增加文件加入工程编译说明 2026/7/8 ...增加构建后步骤使用说明 2026/8/18 ... MRS 附带工具说明 2026/8/25前言工欲善其事必先利其器在开始学习 沁恒微 RISC-V 芯片之前我们先来了解一下它的开发工具 MounRiver Studio 。所以本文其实也算比较简单介绍一下我们要使用的 IDE - MounRiver Studio 。在CSDN 上有一个博主专门介绍这个 IDE 的博主推荐给大家 MounRiver_Studio 博客沁恒微 RISC-V 芯片学习系列博文【导航】沁恒微 RISC-V 蓝牙 入门教程目录 【快速跳转】.我是矜辰所致全网同名尽量用心写好每一系列文章不浮夸不将就认真对待学知识的我们矜辰所致金石为开目录前言一、 基础介绍1.1 下载安装1.2 工程创建与编译官方 EVT 包1.3 关于下载二、 常见配置修改2.1 打印浮点数2.2 配置头文件路径2.3 配置链接文件和库文件链接文件库文件添加 math 库2.4 生成Bin文件2.5 修改 DEBUG LOG 串口2.6 修改文件关联路径2.7 文件加入工程编译2.8 构建后步骤说明三、 蓝牙工程创建示例四、 如何将工程独立出来五、 附带工具说明结语一、 基础介绍MounRiver StudioMRS基于Eclipse平台开发支持 RISC-V 和 ARM 内核的微控制器MCU提供一站式的嵌入式项目开发、调试、烧录和项目管理等功能。1.1 下载安装大家可以自行上官网下载 MounRiver Studio官网 安装流程就省略了傻瓜式安装。这里需要说明一下的是工具现在新出了第二代 MounRiver Studio II相对于第一代来说它将开发框架更换为 VSCode并深度定制开发在代码编辑、编译、调试等环节兼容旧版本同时提升效率与智能化水平。随便版本不同但是在一些基本的配置方面和第一代类似所以大家在网上查看的一些一代的配置方法同样适用于第二代。安装完成以后界面如下对于习惯 VScode 的大家可以修改一下主题基本上就变成 VScode 编辑器啦对了语言选择在最上面栏目帮助语言中勾选1.2 工程创建与编译创建工程步骤如下图博主手头有 CH585M 的开发板所以这里以 CH585 为例上面步骤完成来到下面界面这里我们保持默认直接点击完成完成以后工程就创建完毕了示例工程结构如下我们直接编译如下图可以看到最后生成了 hex 文件而且工具很直观的现实出来我们工程占用了多大的 FLASH 和 RAM 空间非常的方便。上面是讲的我们自己新建的工程对于我们使用官方的 SDK 每个示例工程都可以直接打开下面也来介绍一下。官方 EVT 包EVT 包就是官方的 SDK 包里面有完善的应用示例文档说明所有的芯片都可以在官网找到比如博主用的 CH585 直接搜索就能找到如下图下载后解压出来就是一个 CH585EVT 文件夹这里我们暂且不讨论里面的格局内容我们随便打开一个工程都可以直接打开进入到 MounRiver Studio 界面如下图1.3 关于下载使用 MounRiver Studio 工具一键下载需要使用 WCH-LinkE工具 可以博主手头没有这个工具但是我们可以使用 ISP 下载烧录这部分我们后面会单独写一篇文章详细介绍一下 ISP 下载的相关知识。所以这里暂时没法介绍 使用 WCH-LinkE 工具的下载。那对于上面我们新建的测试工程我们使用 ISP 下载先看一下结果完成这个示例创建步骤基本的使用也就是这么简单而且对于我们开发者官方的每个工程基本都已经做好了配置直接打开 EVT 的示例都可以直接使用没有什么特别难以理解的地方。二、 常见配置修改上面介绍了基本的使用那我们的开发中难免会遇到一些情况需要特别的修改配置对于新手而言会比较头疼所以本小节博主会把一些常见的配置修改罗列出来方便大家使用。2.1 打印浮点数本文虽然是以 MRSII 为例子但是第一代也是类似的比如如果工程中要开启浮点数打印我们的设置方式为右键工程名字点击属性这里说明一下后期针对工程的所有配置都是以这种方式开头我们后面的说明就会直接省去这一步的说明了。然后进行如下设置那对应的在第一代中的操作方式如下除了界面有一点点区别然后因为我设置了中文设置的地方和方法都是一样的所以在后面的配置介绍中我只上一个版本的介绍说明。 因为博主使用不同的电脑可能版本不一样所以后期更新的配置说明不会刻意的保持某一个版本。更新一下2.2 配置头文件路径配置头文件路径的地方如下测试如下比如我新建了一个自己的文件夹如下没有配置头文件路径会配置失败我们只要加上路径就可以了2.3 配置链接文件和库文件链接文件如果不小心移动了链接文件在此处修改保证链接文件的路径正确库文件库的添加如下方式在后面我们需要使用蓝牙库的时候也会需要再这里包含官方工程已经包含了自己独立创建工程需要自己包含添加 math 库如果想使用 C 语言数学库除了需要在文件中包含math.h头文件后需要增加 math 库如下图2.4 生成Bin文件默认只生成 hex 文件需要生成 bin 文件设置如下2.5 修改 DEBUG LOG 串口在官方工程代码中所有的串口都可以用来做打印输出调试除了代码中需要初始化不同的IO还需要在开发环境中设置DEBUG 的值 0~ 3 对应串口 0~3在 MRSII 中对应配置如下不要忘记代码上的初始化2.6 修改文件关联路径起因是博主修改从机例程为支持 IAP 的需要修改 ld 文件和启动文件但是 EVT 工程中 我们知道不带 IAP 的示例程序公用一套链接文件和启动文件然后我需要给这个可以支持 IAP 的程序单独的给一份 ld 文件和 启动文件于是然后检查了一下头文件路径和连接文件路径看上去都没有问题可是发现工程文件中还是使用的外面的连接文件和启动文件它并不是加载的工程目录下的链接文件。其实这里只需要修改一个地方如下图点击我们需要修改的 Ld 和启动文件进行修改刚才是设置肯定是绝对路径点击右边的 Convert 会自动生产相对路径一路 OK 点下去就行最后设置完成结果如下这样子这个工程的链接文件和启动文件就可以设置成自己工程目录下新创建的文件了。更新说明这部分还是以前自己的理解不到位实际上这个地方设置就是文件不在本工程文件目录下面的链接处理假如说我们需要一个独立的工程我们只要把工程中所有的文件拷贝到工程目录下面这个Linked Resources是不需要填写的因为我们本来在工程添加头文件连接文件库文件的时候都是使用${workspace_loc:/${ProjName}来设置的所以是当我们关联的文件其实不在我们的工程目录下面的时候就需要使用Linked Resources关联到文件真实的位置。2.7 文件加入工程编译为了节约内存空间 EVT 中在某些工程下面会屏蔽一些当前工程用不到的功能模块使其不参与编译如果我们自己应用需要用到对应功能我们需要把对应的文件加入工程编译操作如下往往自己移植了一个普通外设代码编译出错提示找不到对应的函数就可以查一下对应驱动文件是否参与了编译2.8 构建后步骤说明在之前使用 Keil 环境中我们在下图所示的地方设置编译后执行的操作在 MRS 环境中也有一样的功能位置如下 使用方式说明绝对位置如下图相对位置如下图这个指令的执行是在工程目录下面的 obj 文件夹下面的如果把脚本放在工程文件根目录可以直接这样三、 蓝牙工程创建示例最后我们来做个示范把上面我们自己新建的工程变成一个带蓝牙库的蓝牙示例实际应用中更多的是在示例基础上面修改使用更多的方式见下一章节《如何将工程独立出来》。我们可以在 EVT 里面找一个工程模板打开然后对比不同的地方先移动过来这一看怎么还少了点进工程一看才明白这是因为新的 EVT 把一些通用的文件放在一个文件夹里面了所有的工程共用的如下图那这四个文件通用的我们新建的工程里面也有那就不用管我们再看看其他地方因为我们在从机工程下面也没有找到库文件我们根据上面学习过的找到库的位置以同样的找不同的方式我们还需要一个 HAL 文件如下图不同的 EVT 版本可能架构有些不一样反正大家能够理解需要什么东西怎么配置就行了。我们的目的是在我们自己新建立的工程上面跑起蓝牙按理来说我们直接修改路径改成 EVT 里面现有的也是可以的但是为了方便我们自己的工程可以复制我们把我们没有的东西需要的都复制到我们刚才的示例文件夹中。先把这 4 个我们没有的文件夹复制到我们自己的工程下面然后点击重新加载可以看到我们的文件夹就出来了因为 app 就是我们从机工程 main.c 函数的所在我们原来工程里面的 src 文件夹就可以删除使用 app 中的这时候我们肯定是无法成功编译的我们接下来就得添加头文件路径然后还要添加库文件。添加头文件路径不要忘记点右下角的应用根据从机例程添加需要的蓝牙库不要忘记点右下角的应用完成以后我们尝试编译一下发现有问题这里至少不是找不到文件定义的问题我们进去看看发现是由于 IDE 工具自动生成的CH58x_common.h和最新 EVT 里面的不同这种问题我们只需要把最新的 EVT 中的这个文件内容复制一下就好。最后再来一次 对比一下也是很简单可以找到原因新的文件比旧的文件多点东西这种细节也只有在调试的时候才回发现把哈哈这里建议大家把需要的文件都复制一遍毕竟 MRS 自带的库的更新可能没有 EVT 更新得快避免某些额外问题。最后我们成功编译了最后测试就是和官方从机效果一致移植完成。说明一下博主因为在边写文章边修改参数其实第一次移植也失败了编译正常但是程序不运行也找了许久问题没找到 所以我自己干脆重新新建了一个工程按照上面自己写的步骤移植当然我有注意把需要用到的文件都复制过来就算是自动生成里面有的那几个链接文件启动文件 等等我也是用的 EVT 里面的最后一次编译成功测试通过。最后再提一句强烈建议用最新 EVT 里面的文件四、 如何将工程独立出来虽然上面介绍了新建蓝牙示例但是我们并不建议自己新建都是在示例工程上面修改但是呢因为官方的 EVT 工程有很多文件都是公用的你修改某些文件会导致做其他测试的时候库被修改了所以增加本小节说明一下如何在 EVT 现有的例程上将自己的工程独立出来这样不影响整个 EVT 其他的例程测试 。首先我们先把我们需要使用的模板工程复制一份然后拷贝一些文件夹到这个复制的文件夹里面这里我们使用从机示例演示拷贝完后面我们复制的工程目录下面如下图我们下面需要打开工程进行设置如下图进行如下操作操作完成以后我们的独立工程就好了我们可以任意移动这个文件夹的位置也能正常进行编译当然我们也可以给工程改自己的名字OK工程独立完成五、 附带工具说明在 MRS 有一个工具栏目这些工具都是我们使用沁恒芯片开发可能需要用到的一般我们开发都是需要什么去官网下载什么现在 MRS 直接把常用的集成在软件中方便大家使用。第一个是 WCH_Link 使用的工具。软件基础操作如下本文对工具不做详细使用说明这个有必要的详细说明博主都会单独写博文或者给大家推荐使用说明的博文第二个是我们最常用的 ISP 下载工具第三个是触摸调试软件使用方式参考博主的博文 沁恒 RISC-V 蓝牙芯片触摸按键应用调试说明 。第四个是屏显界面设计软件这个是针对 MCU 产品线的BLE 系列芯片暂时不支持可参考博文 https://www.cnblogs.com/liaigu/p/22529496第五个是 HEX 和 BIN 转换工具也是我们在生成下载文件的时候有时候需要用到的再下面的一些串口终端串口助手设备管理器等都是开发者常用的大家自己试一试看一看 。结语本文我们介绍了 MounRiver Studio 开发工具的使用基本使用还是很简单的可能就是在某些需要特除配置的时候因为对工具的不熟悉需要花点时间这个是不可避免的但是在后期的学习使用中遇到不同的配置需求博主也回来更新文章当然网上也有许多前辈已经记录了很多问题和解决办法只要能够解决我们开发中的问题就行。需要说明的是 EVT 版本最一直更新有时候工程结构会有调整大家在开发的时候需要注意一下只要熟悉了工程配置再怎么改也可以得心应手好了本文就到这里谢谢大家