README.md
1# RISC-V RV32M1 VEGA Board BSP(Board Support Package) Execution Instruction
2
3[中文页](README_zh.md) |
4
5## Introduction
6
7RV32M1_VEGA board is a heterogeneous multi-core RISC-V 32 development board that contains two RISC-V 32-bit cores, as well as BLE peripherals.
8
9| Hardware | Description |
10| -------------- | ------------------------------------------------------------ |
11| Chip Model | RV32M1 |
12| CPU | RV32IMC, with extensons for post-incrementing load and stores, |
13| | multiply-accumulate extensions, ALU extensions, hardware loops. |
14| | RV32IEMC |
15| Main Frequency | 48MHz or 72MHz |
16| | 48MHz or 72MHz |
17| On-chip SRAM | 256kB + 128kB |
18| On-chip Flash | 1MB + 256kB |
19
20## **Compilation**
21
22The toolchain currently used for test is built from the standard GNU GCC 7.2.0 and newlib 2.5.0 and for the standard RV32IMC architecture, so the extension instructions of RV32M1 is not supported, note that the version of RT-Thread ENV used in this BSP is 1.0.
23
24It's recommended to use the [env tool](https://www.rt-thread.io/download.html?download=Env) to compile programs on Windows. Switch to the directory `bsp/rv32m1_vega/ri5cy` in the console and run the following command to compile this BSP:
25
26```
27scons
28```
29
30If successfully compiled, a new 'rtthread.elf' and 'rtthread.bin' file will be generated. ‘rtthread.bin' needs to be burned to the device and run.
31
32## Burn and Execution
33
34Please use JLink to connect to the JTAG interface of the RISC-V core on the RV32M1_VEGA board, and change the JLink driver to WinUSB mode. The JTAG interface is located next to the RV32M1 chip and the antenna seat, with a small 20pin JTAG interface.
35
36Use a USB cable to connect to a USB port marked with SDA, then a serial device is recognized by PC, which can be opened with the configuration of 115200-N-8-1. The serial pins used by the device are: `[PTC7/PTC8]`
37
38When the rtthread.bin image file is generated after being correctly compiled, you can use gdb to connect to openocd and burn it to flash with the `load` command.
39
40For more information about how to use JTAG and how to use gdb to debug the RV32M1_VEGA development board, please refer to [Development Environment Construction](https://github.com/open-isa-org/open-isa-org/open-isa.org/blob/master/RV32M1_Vega_Develop_Environment_Setup.pdf).
41
42## Running Results
43
44When the compiling and burning are done correctly, press the reset button `SW1` to reset the device, the startup message of RT-Thread can be observed via the serial port :
45
46```
47 \ | /
48- RT - Thread Operating System
49 / | \ 4.0.0 build Dec 5 2018
50 2006 - 2018 Copyright by rt-thread team
51File System initialized!
52Hello RT-Thread!
53msh />
54```
55
56## Peripheral Condition
57
58| Drive | Support | Remark |
59| ------ | ------------------------------------------------------------ | --------------------------- |
60| UART | Support | UART0, RX(PTC7), TX(PTC8) |
61| | Support | UART1, RX(PTA25), TX(PTA26) |
62| clock | Support | |
63| GPIO | Support(The list may not complete, also you need to modify pinmux, clock according to the IO being used.) | |
64| MMC/SD | Support | |
65
66## **IO mapping in BSP**
67
68| IO Number | BSP Code Definition |
69| --------- | ------------------- |
70| PTA22 | LED_BLUE |
71| PTA23 | LED_GREEN |
72| PTA24 | LED_RED |
73| PTA24 | LED_STS |
74| PTA25 | UART1_RX |
75| PTA26 | UART1_TX |
76| PTE8 | BTN_SW3 |
77| PTE9 | BTN_SW4 |
78| PTE12 | BTN_SW5 |
79| PTA0 | BTN_SW2/BTN_NMI |
80
81## References
82
83- [User Guide](https://github.com/open-isa-org/open-isa.org/blob/master/RV32M1_VEGA_Board_User_Guide.pdf)
84- Chip [Reference Manual and Data Sheet](https://github.com/open-isa-org/open-isa.org/blob/master/Reference Manual and Data Sheet/RV32M1DS_Rev.1.1.pdf)
85- [open-isa](https://github.com/open-isa-org/open-isa.org)
86
87