CH592F开发入门2
沁恒微 CH592F 开发板入门 2：MRS2 编译器常规使用
一、工程基础操作
1. 打开工程
2. 查看头文件和源文件
在左侧「Project Explorer」面板中，展开工程目录树：
Include 文件夹：存放头文件（.h）
App 等文件夹：存放源文件（.c）
双击文件即可在右侧编辑区打开查看 / 修改
3. 高频快捷键（新手必记）
二、工程属性核心配置（新手常用）
配置入口
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"
)
)
)
