diff --git a/bsp/wch/risc-v/ch32v307v-r1/README.md b/bsp/wch/risc-v/ch32v307v-r1/README.md index 7724886fc3..067b1952df 100644 --- a/bsp/wch/risc-v/ch32v307v-r1/README.md +++ b/bsp/wch/risc-v/ch32v307v-r1/README.md @@ -1,13 +1,12 @@ # ch32v307v-r1 BSP 说明 -## 开发板简介 + +## 1 开发板简介 CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主频为 144Mhz。比较适合入门学习 RISC-V 架构。 -## 开发板图片 - ![board](./figures/ch32v307.jpg) -## 基本特性: +**基本特性:** - MCU:CH32V307VCT6,主频 144MHz,FLASH和RAM可配置 - LED:2个,用户 LEDs, LED1(blue),LED2(blue)。 @@ -18,7 +17,7 @@ CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主 更多信息和资源请访问[互联型RISC-V单片机 CH32V307](https://www.wch.cn/products/CH32V307.html) -## 编译说明 +## 2 编译说明 板级包支持 RISC-V GCC 开发环境,以下是具体版本信息: @@ -26,15 +25,15 @@ CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主 | ---------- | -------------------- | | GCC | WCH RISC-V GCC 8.2.0 | -## 使用说明 +## 3 使用说明 >本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。 -### 快速上手 +### 3.1 快速上手 本 BSP 为开发者提供 Scons 编译配置。下面介绍如何将系统运行起来。 -#### 1、指定RISC-V GCC编译器 +#### 3.1.1 指定RISC-V GCC编译器 推荐使用 RT-Thread Studio 软件里面的编译器。 @@ -54,7 +53,7 @@ set RTT_EXEC_PATH=D:\RT-ThreadStudio\repo\Extract\ToolChain_Support_Packages\WCH > 注意:如果使用第二种方法,第一种方法设置的路劲将会失效。 -#### 2、生成dist文件夹 +#### 3.1.2 生成dist文件夹 ```shell scons --dist @@ -62,7 +61,7 @@ scons --dist ![dist](./figures/dist.png) -#### 3、进入dist文件夹scons编译 +#### 3.1.3 进入dist文件夹scons编译 ```shell scons @@ -72,11 +71,11 @@ scons 最终会生成 **rtthread.bin** 文件。 -#### 4、硬件连接 +#### 3.1.4 硬件连接 使用数据线连接板载 wch-link 到 PC,打开电源开关。 -#### 5、下载 +#### 3.1.5 下载 打开 WCH RISC-V MCU ProgrammerTool 下载软件,选择刚刚生成的 **rtthread.bin** 文件,进行下载。 @@ -84,8 +83,49 @@ scons > 注意:这里Chip Mem 设置为224K ROM + 96K RAM。不要以参考手册为准。 -#### 运行结果 +#### 3.1.6 运行结果 在终端工具里打开板载 wch-link 串口(WCHDapLink SERIAL,默认115200-8-1-N),复位设备后,在串口上可以看到 RT-Thread 的输出信息: ![end](./figures/end.png) + +### 3.2 导入 RT-Thread Studio 工程 + +#### 3.2.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.2.2 配置环境 + +工程导入后进行编译环境的设置,首先点击“打开构建设置”进入设置界面: + +![set](./figures/set.png) + +将编译链路径复制到 Toolchain path 中: + +![toolchain](./figures/toolchain.png) + +如图更改 Prefix : + +![prefix](./figures/prefix.png) + +进行工具设置: + +![toolset](./figures/toolset.png) + +#### 3.2.3 编译 + +编译结果如下: + +![success](./figures/success.png) diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/config.png b/bsp/wch/risc-v/ch32v307v-r1/figures/config.png new file mode 100644 index 0000000000..775a280346 Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/config.png differ diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/import.png b/bsp/wch/risc-v/ch32v307v-r1/figures/import.png new file mode 100644 index 0000000000..eaf0f2213d Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/import.png differ diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/prefix.png b/bsp/wch/risc-v/ch32v307v-r1/figures/prefix.png new file mode 100644 index 0000000000..9542d60a29 Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/prefix.png differ diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/set.png b/bsp/wch/risc-v/ch32v307v-r1/figures/set.png new file mode 100644 index 0000000000..573a45c34e Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/set.png differ diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/success.png b/bsp/wch/risc-v/ch32v307v-r1/figures/success.png new file mode 100644 index 0000000000..812a5680c5 Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/success.png differ diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/toolchain.png b/bsp/wch/risc-v/ch32v307v-r1/figures/toolchain.png new file mode 100644 index 0000000000..610e67cc91 Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/toolchain.png differ diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/toolset.png b/bsp/wch/risc-v/ch32v307v-r1/figures/toolset.png new file mode 100644 index 0000000000..3fd87da63f Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/toolset.png differ diff --git a/bsp/wch/risc-v/ch32v307v-r1/figures/windows.png b/bsp/wch/risc-v/ch32v307v-r1/figures/windows.png new file mode 100644 index 0000000000..5deed9009e Binary files /dev/null and b/bsp/wch/risc-v/ch32v307v-r1/figures/windows.png differ