98 lines
3.7 KiB
Markdown
98 lines
3.7 KiB
Markdown
|
# YD-CH32V307VCT6 BSP Introduction
|
|||
|
|
|
|||
|
|
## 1 Introduction
|
|||
|
|
|
|||
|
|
YD-CH32V307VCT6 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.
|
|||
|
|
|
|||
|
|
This document records the execution instruction of the BSP (board support package) provided by the RT-Thread community for the CH32V307V-R1 development board.
|
|||
|
|
|
|||
|
|
The document is covered in three parts:
|
|||
|
|
|
|||
|
|
- Board Resources Introduction
|
|||
|
|
- Compiling
|
|||
|
|
- Quickly Get Started
|
|||
|
|
|
|||
|
|
By reading the Quickly Get Started section developers can quickly get their hands on this BSP and run RT-Thread on the board.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Features**
|
|||
|
|
|
|||
|
|
- MCU: CH32V307VCT6, main frequency 144MHz，FLASH and RAM are available for configuration.
|
|||
|
|
- LED: 2, user LEDs (blue and red).
|
|||
|
|
- Button: 3, Reset, Boot, User.
|
|||
|
|
- SPI Flash: 32M-bit serial flash memory (W25Q32).
|
|||
|
|
- I2C EEPROM: 64k-bit serial EEPROM (24C64).
|
|||
|
|
- USB: 2, Type-C.
|
|||
|
|
- Network Port: 1, 10M PHY inside.
|
|||
|
|
- SDIO: microSD connector.
|
|||
|
|
- Debug interface: SWD.
|
|||
|
|
- 8 MHz external quartz oscillator (HSE).
|
|||
|
|
- 32,768 Hz external RTC quartz oscillator (LSE).
|
|||
|
|
|
|||
|
|
For more details about this board, please refer to:
|
|||
|
|
- [Board YD-CH32V307VCT6 VCC-GND Studio](http://152.32.187.208:8080/yd-data/YD-CH32V307VCT6/YD-CH32V307VCT6/)
|
|||
|
|
- [CH32V307](https://www.wch.cn/products/CH32V307.html)
|
|||
|
|
- [CH32V307 official document](https://github.com/openwch/ch32v307)
|
|||
|
|
|
|||
|
|
## 2 Compiling
|
|||
|
|
|
|||
|
|
The BSP supports the RISC-V GCC development environment, here's the specific version information:
|
|||
|
|
|
|||
|
|
| IDE/Compiler | Version Tested |
|
|||
|
|
| ------------ | -------------------- |
|
|||
|
|
| GCC | WCH RISC-V GCC 8.2.0 |
|
|||
|
|
|
|||
|
|
## 3 Quickly Get Started
|
|||
|
|
|
|||
|
|
### 3.1 Using Linux to compile BSP
|
|||
|
|
|
|||
|
|
This section is about to introduce how to compile the BSP in Linux.
|
|||
|
|
|
|||
|
|
#### 3.1.1 Compile BSP
|
|||
|
|
|
|||
|
|
1. [Download WCH Compile Toolchain](https://github.com/NanjingQinheng/sdk-toolchain-RISC-V-GCC-WCH/releases)
|
|||
|
|
2. [Download the RT-Thread latest code](https://github.com/RT-Thread/rt-thread/archive/refs/heads/master.zip)
|
|||
|
|
3. Install SCons construction tool (similar GNU Make): sudo apt install scons
|
|||
|
|
4. Edit the variable **EXEC_PATH** in file **rtconfig.py** to point to the directory with executable WCH Compile Toolchain (file riscv-none-embed-gcc).
|
|||
|
|
5. Configure RT-Thread and hardware board: scons --menuconfig
|
|||
|
|
6. Start compilation: scons
|
|||
|
|
7. After compilation, the **rtthread.bin** file will be generated
|
|||
|
|
|
|||
|
|
#### 3.1.2 Download
|
|||
|
|
|
|||
|
|
1. Clone source file: git clone https://github.com/jmaselbas/wch-isp.git
|
|||
|
|
2. Compile and install :
|
|||
|
|
- cd wch-isp
|
|||
|
|
- make && sudo make install && sudo make load
|
|||
|
|
3. Use a USB cable Type-C to connect board to the PC. Hold button **BOOT0**, press briefly button **RST** and release button **BOOT0**.
|
|||
|
|
4. Check board connection:
|
|||
|
|
```sh
|
|||
|
|
wch-isp list
|
|||
|
|
0: BTVER v2.9 UID 10-46-89-26-3b-38-d4-a4 [0x1770] CH32V307VCT6
|
|||
|
|
MCU current flash size: 256 Kbyte
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> Note that Chip Mem here is set to 256K ROM + 64K RAM (see Table 2-1 of datasheet CH32V307, and chapter 32.6 "User Option Bytes" of Reference Manual CH32V2x_V3x).
|
|||
|
|
|
|||
|
|
5. Download firmware to board:
|
|||
|
|
```
|
|||
|
|
wch-isp -p flash ./rtthread.bin && wch-isp reset
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 3.1.3 Running Result
|
|||
|
|
|
|||
|
|
1. Connect USB-UART converter to board:
|
|||
|
|
- board pin A9 (UART1_TX) -> converter RX
|
|||
|
|
- board pin A10 (UART1_RX) -> converter TX (optional, for enter commands)
|
|||
|
|
2. In the terminal tool, open the converter serial port (default 115200-8-1-N), and after resetting the device, you can see the output information of RT-Thread on the serial port:
|
|||
|
|
```
|
|||
|
|
\ | /
|
|||
|
|
- RT - Thread Operating System
|
|||
|
|
/ | \ 5.1.0 build Jan 6 2024 17:12:03
|
|||
|
|
2006 - 2022 Copyright by RT-Thread team
|
|||
|
|
SystemClk: 144000000 Hz
|
|||
|
|
msh >
|
|||
|
|
```
|
|||
|
|
On board LEDs (red and blue) blinking.
|