CH592F开发入门2

沁恒微 CH592F 开发板入门 2：MRS2 编译器常规使用

注意：本文基于 MRS2 开发环境编写，其操作界面与旧版 MRS 存在差异，请留意区分。

一、工程基础操作

1. 打开工程

（双击工程目录下的 WVPROJ 格式文件，或通过 MRS2 菜单栏 File -> Open Project 选择工程文件打开）

2. 查看头文件和源文件

在左侧「Project Explorer」面板中，展开工程目录树：

Include 文件夹：存放头文件（.h）

App 等文件夹：存放源文件（.c）

双击文件即可在右侧编辑区打开查看 / 修改

3. 高频快捷键（新手必记）

快捷键	功能说明	补充说明
Ctrl + F	当前文件内关键词搜索	支持大小写敏感 / 通配符搜索
Ctrl + H	整个工程内关键词搜索	可指定文件类型（如只搜.c）
F7	增量编译（仅编译修改文件）	编译速度快，日常调试首选
Shift + F7	全量重新编译（清除旧编译）	工程配置修改后建议使用

二、工程属性核心配置（新手常用）

配置入口

右键点击工程名称 → 选择「Properties」→ 首次打开会弹出芯片选择弹窗，点击「OK」后选择 CH592F 芯片型号即可进入配置界面。

1. 预编译宏配置（DEBUG 打印控制）

核心作用：控制串口打印功能的开启 / 关闭，指定打印使用的串口号

配置步骤：

1.进入 Properties -> C/C++ Build -> Build Settings -> Tool Settings -> GNU RISC-V Cross C Compiler -> Preprocessor

2.在「Defined symbols (-D)」栏中：

添加 DEBUG=0：使用串口 0 打印

添加 DEBUG=1：使用串口 1 打印

删除 DEBUG 宏：关闭所有打印（此时 PRINT 语句会变为空语句，不占用程序资源）

重要注意事项：

程序中必须使用大写 PRINT 宏打印，禁止使用小写 printf！

若使用 printf，删除 DEBUG 宏后程序会卡死（无对应的函数实现）,

配置完成后需点击右下角 Apply

2. 打印浮点数配置

问题：默认配置下，PRINT 无法打印浮点数，且无回车换行时内容无法输出（受打印库机制限制）

配置步骤：

1.进入 Properties -> C/C++ Build -> Build Settings -> Tool Settings -> GNU RISC-V Cross C Linker -> Miscellaneous

2.勾选「Use wchprintffloat(-lprintfloat)」

3.配置完成后需点击右下角 Apply

4.保存配置后，需执行 Shift + F7 全量编译生效

3. 生成 hex/bin 文件配置

默认情况：仅生成 .hex 文件，若需烧录 / 调试，可按需配置：

1.进入 Properties -> C/C++ Build -> Build Settings -> Tool Settings -> GNU RISC-V Cross Crate Flash Image -> General -> Output file Format(-O)

2.可选配置项：

生成 hex：选择「Intel HEX(.hex)」

仅生成 bin：选择「Raw Binary(.bin)」

同时生成 hex+bin：选择「Intel HEX(.hex)&Raw Binary(.bin)」

3.编译后，文件会生成在工程 Obj 目录下。

//此配置错误待更新

4. 仿真时保留 flash 数据配置

问题：默认 Debug 仿真时，会擦除 codeflash（代码区）和 dataflash（数据区），导致重要数据丢失

配置步骤：

1.进入 Properties -> Debug Settings ->  Debugger -> Config options

2.添加page_erase

5. 添加数学库（math.h 函数支持）

问题：直接包含 math.h 后，调用 sin()/cos()/sqrt() 等函数会提示未定义

配置步骤：

1.进入 Properties -> C/C++ Build -> Build Settings -> Tool Settings -> GNU RISC-V Cross C Linker -> Libraries

2.在「Libraries Name(-l)」栏中添加 m（数学库标识），注意是一个字母 m 而不是math

6. 添加自定义文件夹路径

场景：工程中新增文件夹（如 User_Driver）存放自定义代码，编译器无法识别头文件

配置步骤：

1.进入 Properties -> C/C++ Build -> Build Settings -> Tool Settings -> GNU RISC-V Cross C Compiler -> Includes

2.点击「Add」按钮，选择新增的文件夹路径（支持绝对路径 / 相对路径，推荐相对路径）

3.保存后，即可在代码中直接 #include "自定义头文件.h"

---

总结

1. MRS2 核心快捷键优先掌握 F7（增量编译）、Ctrl+H（工程搜索），提升操作效率；
2. 预编译宏 DEBUG 是控制打印的关键，且必须使用 PRINT 而非 printf；
3. 工程配置修改后（如浮点数、数学库），需执行 Shift+F7 全量编译才能生效。

额外建议

• 所有配置修改后，建议点击「Apply and Close」保存，避免配置丢失；
• 新手可将常用配置截图保存，或备份工程配置文件，便于恢复。