rt-thread/bsp/wch/risc-v/ch32v307v-r1/README_zh.md

113 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ch32v307v-r1 BSP 说明
[English](README.md) | **中文**
## 1 开发板简介
CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主频为 144Mhz。比较适合入门学习 RISC-V 架构。
![board](./figures/ch32v307.jpg)
**基本特性:**
- MCUCH32V307VCT6主频 144MHzFLASH和RAM可配置
- LED2个用户 LEDs LED1blueLED2blue
- 按键2个Reset User 。
- USB2个Tpye-C。
- 网口1个内置 10M PHY。
- 板载 WCH-Link 下载调试工具。
更多信息和资源请访问[互联型RISC-V单片机 CH32V307](https://www.wch.cn/products/CH32V307.html)
## 2 编译说明
板级包支持 RISC-V GCC 开发环境,以下是具体版本信息:
| IDE/编译器 | 已测试版本 |
| ---------- | -------------------- |
| GCC | WCH RISC-V GCC 8.2.0 |
## 3 使用说明
>本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。
### 3.1 使用Env编译BSP
本节讲解如何使用Env工具来编译BSP工程。
#### 3.1.1 编译BSP
1. [下载WCH编译工具链](https://github.com/NanjingQinheng/sdk-toolchain-RISC-V-GCC-WCH/archive/refs/tags/V1.0.0.zip)
2. 下载Env工具[最新版本](https://github.com/RT-Thread/env-windows/releases)
3. 下载RT-Thread[最新源码](https://github.com/RT-Thread/rt-thread/archive/refs/heads/master.zip)
4. 并在当前BSP根目录下打开Env工具并执行 `scons --exec-path=D:\sdk-toolchain-RISC-V-GCC-WCH-1.0.0\bin` 命令,在指定工具链位置的同时直接编译。
5. 编译完成之后会生成 **rtthread.bin** 文件。
![sconscompile](./figures/sconscompile.jpg)
#### 3.1.2 硬件连接
使用数据线连接板载 wch-link 到 PC打开电源开关。
#### 3.1.3 下载
打开 WCH RISC-V MCU ProgrammerTool 下载软件,选择刚刚生成的 **rtthread.bin** 文件,进行下载。
![tool](./figures/tool.png)
> 注意这里Chip Mem 设置为224K ROM + 96K RAM。不要以参考手册为准。
#### 3.1.4 运行结果
在终端工具里打开板载 wch-link 串口WCHDapLink SERIAL默认115200-8-1-N复位设备后在串口上可以看到 RT-Thread 的输出信息:
![end](./figures/end.png)
### 3.2 使用VSCode编译工程
在Env终端中敲入命令 `scons --target=vsc` 来生成VSCode工程. 接着敲入命令 `code .` 来打开VSCode.
使用 **VSCode 终端** 敲入命令 `scons -j12 --exec-path=D:\sdk-toolchain-RISC-V-GCC-WCH-1.0.0bin` 来编译工程。
![vscode-terminal](./figures/vscode-terminal.png)
### 3.3 导入 RT-Thread Studio 工程
#### 3.3.1 导入
打开 RT-Thread Studio 后点击:文件->导入:
![import](./figures/import.png)
选择“RT-Thread Bsp 到工作空间中”:
![windows](./figures/windows.png)
填写项目信息Bsp 根目录为 `\rt-thread\bsp\wch\risc-v\ch32v307v-r1` 目录:
![config](./figures/config.png)
#### 3.3.2 配置环境
工程导入后进行编译环境的设置,首先点击“打开构建设置”进入设置界面:
![set](./figures/set.png)
将编译链路径复制到 Toolchain path 中:
![toolchain](./figures/toolchain.png)
如图更改 Prefix
![prefix](./figures/prefix.png)
进行工具设置:
![toolset](./figures/toolset.png)
#### 3.3.3 编译
编译结果如下:
![success](./figures/success.png)