MounRiver Studio 创建自定义模板工程&内置工程模板管理
-
打开MRS创建工程界面,勾选“Self-define template”,设置工程名以及存放位置。
-
点击“Finish”完成自定义模板框架创建,MRS返回主界面,并在资源区显示刚创建的工程。
-
添加工程所需的各类文件。
方法一:要添加的文件、文件夹直接拖拽到创建的工程,可选择复制添加的内容到本工程目录,或只添加对该文件夹/文件的引用。
方法二:在工程资源区选中工程后点击右键菜单新建/添加文件、文件夹
-
工程内资源文件添加完毕,开始进行编译参数配置:
-
选中目标工程,点击工具栏 按钮,打开工程属性页。
-
配置编译参数:
1)默认参数
Target Processor:目标平台设置
Optimization: 代码优化等级
Warnings: 代码警告等级
Debugging : 调试等级设置
以上几项内容在工程创建时会自动加载默认参数,如有需要可自行修改。
2)添加引用
GNU RISC-V Cross Assembler->Includes: 启动文件路径
点击下图所示按钮,选择启动文件路径。
GNU RISC-V Cross C Compiler->Includes:头文件引用
点击如下图所示的按钮,添加需要引用的头文件路径。
GNU RISC-V Cross C Linker->General:链接脚本文件
点击如下图所示按钮,添加工程编译链接脚本文件。
GNU RISC-V Cross Create Flash Image->General:编译输出文件
如下图所示,可指定编译输出的文件类型:.hex .bin…
3)工具链配置
工程创建时会默认使用MRS安装路径下toolchain文件夹内定制版的GCC工具链及OpenOCD,可根据需求,自定义引用外部的工具链及相关编译工具:
4)编译目标类型
点击属性页Build Artifact按钮,可选择编译类型:可执行文件、共享库、静态库:
-
编译工程。
完成编译配置后,选中当前工程,点击工具栏
按钮进行增量编译,或者点击
按钮进行重新编译。此时显示编译成功,并在obj文件夹下生成输出文件:
-
配置调试参数。
选中目标工程,点击工具栏上
按钮,进入调试配置界面,双击左侧“GDB OpenOCD Debugging”选项,MRS会根据创建工程时选择的工具链内核(RISC-C/ARM)来自动创建调试配置。如用户采用MRS默认调试参数,则此时可直接点击底部“Debug”按钮,开始进行调试(假设此时调试器已连接)。
点击右侧“Debugger”标签页,用户可指定需要调用的OpenOCD.exe、配置文件、GDB工具、命令行参数等:
点击右侧“Startup”标签页,用户可指定默认断点等调试选项:
点击“SVD Path”标签页则可以选择目标芯片对应的SVD文件,用于在单步调试时显示各寄存器数值。
-
调试配置设置完毕后可点击底部“Apply”按钮保存并退出调试配置界面,或者点击“Debug”按钮直接使用该配置进行调试。
-
用户可选择将本次新建的工程添加到内置工程模板(使用MRS内置模板创建的工程也支持该功能)。
选中目标工程,点击右键菜单“Save As Project Template”按钮。
在弹出的配置对话框中,指定该工程对应芯片的厂商、系列、型号、芯片描述以及模板包导出位置:
点击“OK”,完成自定义工程模板创建:
- 导入自定义工程模板。
点击MRS主菜单“Project->Template Management”,打开模板管理界面。
该管理界面展示了当前MRS所有的内置工程模板列表,用户可进行模板包导入、导出、复制、删除等操作:
点击“Import”按钮,选择之前创建的自定义工程模板包“RV_1.zip”,即可将其添加到MRS内置工程模板列表:
此时选择新建MRS工程时,可见用户自定义的工程模板已经添加成功: