English version: README_EN.md
芯片型号：CH32V307VCT6
开发板型号：CH32F207&V307V-R3-2v0
本教程详细阐述从获取开发板到成功运行官方演示程序（Demo）的完整过程，旨在为初次使用 CH32V307 系列微控制器的开发者提供严谨、准确的指导。教程基于官方文档和实际操作经验，确保每一步骤的可重复性和可靠性。注意：所有操作需在安全的环境下进行，并遵守相关电子设备使用规范。
- CH343SER.ZIP —— CH343 USB 转串口芯片驱动，用于串口通信支持。
- WCH-LinkUtility.ZIP —— 独立本地烧录工具，可用于脱离 IDE 的程序下载（本教程中可选使用）。
- WCHISPTool Setup.exe —— 单片机 ISP 编程工具（本教程暂未涉及，如需高级应用可参考官方文档）。
- Demo —— 官方演示工程文件夹，必须与 SRC 文件夹搭配使用，否则将缺少必要的外设驱动和启动文件。根据实际需求，可对 Demo 文件进行裁剪优化。
- SRC —— 官方提供的驱动文件库，包括外设驱动、启动代码等。建议将 SRC 和 Demo 置于同一路径下，或在工程设置中自定义包含路径（详见后续步骤）。
用户需自行下载并安装 MounRiver Studio IDE，该工具集成了 WCH-LinkUtility 烧录功能，并支持代码编译、调试。官方下载地址：https://www.mounriver.com/download
安装前，请确保系统兼容性（Windows/macOS/Linux 支持），并安装必要的驱动。
注意：Demo 和 SRC 的结合使用是工程编译成功的关键。如果路径配置错误，将导致链接错误或外设初始化失败。请严格按照本教程步骤操作。
本节描述硬件准备和连接细节，确保连接正确以避免烧录失败或硬件损坏。
-
开发板
-
烧录器
使用杜邦线连接开发板与烧录器。连接时需注意以下要点：
- TXD 和 RXD 引脚必须交叉连接：开发板 TX → 烧录器 RX，开发板 RX → 烧录器 TX，以确保串口通信正常。
- 电源使用 Type-C 接口为开发板供电，烧录器可通过 USB 连接电脑供电。
- 连接前，确保所有引脚无短路风险，并断开电源以防静电损坏。
连接引脚对应表（严谨核对）：
| 烧录器引脚 | 开发板引脚 | 功能描述 |
|---|---|---|
| SWCK | SWCK | SWD 时钟线 |
| SWIO | SWIO | SWD 数据线 |
| GND | GND | 地线 |
| VDD | VDD | 电源（3.3V 或 5V，根据板子规格） |
| TXD | RXD | 串口发送（交叉连接） |
| RXD | TXD | 串口接收（交叉连接） |
连接示意图：
安全警告：连接不当可能导致短路或设备损坏。建议使用多米诺测试仪或万用表验证连接。首次操作时，推荐在有经验指导下进行。
本教程仅演示官方 Demo 的运行过程，旨在快速上手。更多高级功能（如代码调试、外围设备配置）请参考官方文档。操作前，确保已安装 CH343SER 驱动并连接硬件。
-
主界面：启动 IDE 后的默认界面，用于工程管理和代码编辑。
-
打开工程文件：选择 Demo 文件夹中的工程文件（.mrs 或类似）。
-
进入烧录工具：点击菜单“工具” → “RISC-V Debugger”。
-
更改语言：支持中英文切换，根据个人偏好选择。
-
选择芯片架构和型号：选择 RISC-V 架构和 CH32V307VCT6 型号(根据实际情况选择)。点击“获取模式”检查烧录器状态。
-
切换烧录器模式：如果当前模式非 WCH-LinkRV，则需更改并设置。成功后，烧录器仅亮红灯，表示处于 RISC-V 模式。
-
配置 SRC 路径：确保 SRC 和 Demo 在同一目录下。驱动文件相对路径示例：..\SRC\Startup。根据需求可自定义修改路径，并在工程属性中更新包含目录。路径错误将导致编译失败。
-
选择调试模式：提供三种模式（Download、Attach、Run），根据需求选择（如初次测试推荐 Download 模式）。
-
编译成功：点击编译按钮，检查无错误。
-
烧录成功：程序下载到开发板，确认无报错。
-
查看运行结果：程序已成功烧录到开发板中。使用串口助手（如 SSCOM 或 Putty）监控输出。
-
串口设置：波特率 115200，数据位 8，停止位 1，无奇偶校验。
-
运行成功：观察串口打印信息，确认程序正常执行。
常见问题排查：若烧录失败，检查驱动安装、模式切换和连接线缆；若无串口输出，验证波特率和交叉连接。更多细节请查阅官方文档。
（包含数据手册、SDK 和工具更新）。
- 沁恒官网CH32V307专区：https://www.wch.cn/products/CH32V307.html
- 所有资料&SDK下载：https://www.wch.cn/downloads/category/27.html
本教程基于 2025 年 11 月 官方版本编写，如有更新，请以官网为准。如对本仓库有疑问或改进建议，欢迎提交 Issue。