Example project for RI5CY core of RV32M1 SoC
A Rust toolchain with riscv32imc-unknown-none-elf target installed is required.
Install the target to your existing Rust toolchain with:
rustup target add riscv32imc-unknown-none-elf
Both GNU and MSVC toolchains work for Windows users.
Minimum supported Rust version (MSRV) is 1.34.0, using latest stable Rust is strongly suggested.
An RV32M1 development board with JTAG is required. This project is tested on:
- VEGAboard from OpenISA
- VEGA-Lite from OpenISA China
An installation of RISC-V SDK and toolchain (including GDB and OpenOCD) from OpenISA Downloads page is required.
RV32M1 must be configured to boot from RI5CY core.
Both boards configure RV32M1 to boot from RI5CY core by default, so there is no need to consider unless you have once changed (or not sure about) current boot configuration.
See 'Boot Configuration' from RV32M1-VEGA Quick Start Guide for instructions to select which core to boot.
Build this project as any other Cargo crate:
cargo build
Compiled ELF file will be found at target/riscv32imc-unknown-none-elf/debug/rv32m1_ri5cy-example.
We use VEGAboard for the following steps. Details may vary if you have a different platform.
Remove J11 jumper and connect a J-Link external debugger to VEGAboard, then launch OpenOCD with:
C:\Vega\Toolchain_Windows\openocd\bin\openocd.exe -f C:\Vega\rv32m1_sdk_riscv\boards\rv32m1_vega\rv32m1_ri5cy.cfg
The following message will be shown on the console if the connection is up successfully:
Info : Listening on port 3333 for gdb connections
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
OpenOCD will expose multiple ports for interacting with the target.
Open the binary with GDB and connect to the target via OpenOCD with:
C:\Vega\Toolchain_Windows\riscv32-unknown-elf-gcc\bin\riscv32-unknown-elf-gdb.exe target\riscv32imc-unknown-none-elf\debug\rv32m1_ri5cy-example --eval-command="target remote localhost:3333"
Use following commands to program and run the target:
load
continue
Send SIGINT (Control+C) to terminal to halt the target and start debugging.
It's also possible to use OpenOCD without GDB to program the target. Connect to
localhost:4444with any preferred telnet client (like PuTTY), and use following commands to program and run:program target/riscv32imc-unknown-none-elf/debug/rv32m1_ri5cy-example reset
Issues and pull requests are welcome, always.
Copyright (c) 2019 SHA Miao
This project is licensed under either of
at your option.