Browse Source

[ch32v307][readme] 增加vscode编译介绍 (#6540)

Man, Jianting (Meco) 2 years ago
parent
commit
2bcc22f6b0

+ 18 - 10
bsp/wch/risc-v/ch32v307v-r1/README.md

@@ -2,7 +2,7 @@
 
 
 **English** | [中文](README_zh.md)
 **English** | [中文](README_zh.md)
 
 
-## Introduction
+## 1 Introduction
 
 
 CH32V307V-R1 is a RISC-V core-based development board with a maximum main frequency of 144Mhz. It delivers the best value for developers to try and get started with RISC-V architecture. 
 CH32V307V-R1 is a RISC-V core-based development board with a maximum main frequency of 144Mhz. It delivers the best value for developers to try and get started with RISC-V architecture. 
 
 
@@ -29,7 +29,7 @@ By reading the Quickly Get Started section developers can quickly get their hand
 
 
 For more details about this board, please refer to: [CH32V307](https://www.wch.cn/products/CH32V307.html)
 For more details about this board, please refer to: [CH32V307](https://www.wch.cn/products/CH32V307.html)
 
 
-## Compiling
+## 2 Compiling
 
 
 The BSP supports the RISC-V GCC development environment, here's the specific version information:
 The BSP supports the RISC-V GCC development environment, here's the specific version information:
 
 
@@ -37,18 +37,18 @@ The BSP supports the RISC-V GCC development environment, here's the specific ver
 | ------------ | -------------------- |
 | ------------ | -------------------- |
 | GCC          | WCH RISC-V GCC 8.2.0 |
 | GCC          | WCH RISC-V GCC 8.2.0 |
 
 
-## Quickly Get Started
+## 3 Quickly Get Started
 
 
-#### 3.1 Using [Env](https://www.rt-thread.io/download.html?download=Env) to compile BSP
+### 3.1 Using [Env](https://www.rt-thread.io/download.html?download=Env) to compile BSP
 
 
 This section is about to introduce how to use Env to compile the BSP.
 This section is about to introduce how to use Env to compile the BSP.
 
 
 #### 3.1.1 Compile BSP
 #### 3.1.1 Compile BSP
 
 
-1. [Download WCH Compile Toolchain](https://github.com/NanjingQinheng/sdk-toolchain-RISC-V-GCC-WCH/archive/refs/tags/V1.0.0.zip)
+1. [Download WCH Compile Toolchain](https://github.com/NanjingQinheng/sdk-toolchain-RISC-V-GCC-WCH/releases)
 2. [Download the Env tool latest version](https://github.com/RT-Thread/env-windows/releases)
 2. [Download the Env tool latest version](https://github.com/RT-Thread/env-windows/releases)
 3. [Download the RT-Thread latest code](https://github.com/RT-Thread/rt-thread/archive/refs/heads/master.zip)
 3. [Download the RT-Thread latest code](https://github.com/RT-Thread/rt-thread/archive/refs/heads/master.zip)
-4. Open the Env tool in the current BSP root directory and execute the `scons --exec-path=D:sdk-toolchain-RISC-V-GCC-WCH-1.0.0bin` command, compile it directly while specifying the toolchain location. 
+4. Open the Env tool in the current BSP root directory and execute the `scons -j12 --exec-path=D:\sdk-toolchain-RISC-V-GCC-WCH-1.0.0bin` command, compile it directly while specifying the toolchain location. 
 5. After compilation, the **rtthread.bin** file will be generated
 5. After compilation, the **rtthread.bin** file will be generated
 
 
 ![sconscompile](./figures/sconscompile.jpg)
 ![sconscompile](./figures/sconscompile.jpg)
@@ -72,11 +72,19 @@ In the terminal tool, open the onboard wch-link serial port (WCHDapLink SERIAL,
 ![end](./figures/end.png)
 ![end](./figures/end.png)
 
 
 
 
-<!-- ### 3.2 Import RT-Thread Studio Project
+### 3.2 Use VSCode to edit and compile the project
+
+In the Env terminal, type command `scons --target=vsc` to generate the VSCode project. Then, type command `code .` in the Env terminal to open the VSCode.
+
+Use **VSCode terminal** to type command `scons -j12 --exec-path=D:\sdk-toolchain-RISC-V-GCC-WCH-1.0.0bin` to compile the project in VSCode.
+
+![vscode-terminal](./figures/vscode-terminal.png)
+
+<!-- ### 3.3 Import RT-Thread Studio Project
 
 
 **CH32V307V-R1 is pending upgrade in Studio. It's not encouraged now to use Studio to compile this BSP.**
 **CH32V307V-R1 is pending upgrade in Studio. It's not encouraged now to use Studio to compile this BSP.**
 
 
-#### 3.2.1 Import
+#### 3.3.1 Import
 
 
 Open RT-Thread Studio and click: File-> Import:
 Open RT-Thread Studio and click: File-> Import:
 
 
@@ -93,7 +101,7 @@ Fill in the project info, the BSP root directory is \rt-thread\bsp\wch\risc-v\ch
 ![config](./figures/config.png)
 ![config](./figures/config.png)
 
 
 
 
-#### 3.2.2 Compilation Environment
+#### 3.3.2 Compilation Environment
 
 
 工程导入后进行编译环境的设置,首先点击“打开构建设置”进入设置界面:
 工程导入后进行编译环境的设置,首先点击“打开构建设置”进入设置界面:
 
 
@@ -114,7 +122,7 @@ Set the tool:
 
 
 ![toolset](./figures/toolset.png)
 ![toolset](./figures/toolset.png)
 
 
-#### 3.2.3 Compiling 
+#### 3.3.3 Compiling 
 
 
 The result is shown as below:
 The result is shown as below:
 
 

+ 12 - 5
bsp/wch/risc-v/ch32v307v-r1/README_zh.md

@@ -63,9 +63,17 @@ CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主
 
 
 ![end](./figures/end.png)
 ![end](./figures/end.png)
 
 
-### 3.2 导入 RT-Thread Studio 工程
+### 3.2 使用VSCode编译工程
 
 
-#### 3.2.1 导入
+在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 后点击:文件->导入:
 打开 RT-Thread Studio 后点击:文件->导入:
 
 
@@ -79,8 +87,7 @@ CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主
 
 
 ![config](./figures/config.png)
 ![config](./figures/config.png)
 
 
-
-#### 3.2.2 配置环境
+#### 3.3.2 配置环境
 
 
 工程导入后进行编译环境的设置,首先点击“打开构建设置”进入设置界面:
 工程导入后进行编译环境的设置,首先点击“打开构建设置”进入设置界面:
 
 
@@ -98,7 +105,7 @@ CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主
 
 
 ![toolset](./figures/toolset.png)
 ![toolset](./figures/toolset.png)
 
 
-#### 3.2.3 编译
+#### 3.3.3 编译
 
 
 编译结果如下:
 编译结果如下:
 
 

BIN
bsp/wch/risc-v/ch32v307v-r1/figures/vscode-terminal.png