FreeRTOS-Kernel/FreeRTOS/Demo/RISC-V-Qemu-virt_GCC
RichardBarry 4629138a42
Extend qemu virt riscv demo (#774)
* Simple blinky demo working.  Not tried full demo yet.

* Get the full demo running.

* Add Eclipse project to build the RISC-V_RV32_QEMU_VIRT_GCC gcc makefile.

* Add regtest tasks to the RISC-V_RV32_QEMU_VIRT_GCC demo.

* Update priority of the timer task.

* Adjust timer frequency and optimisation level before committing prior to rearranging the Eclipse project.

* Reorganise Eclipse project slightly.

* Add note to the RISC-V-Qemu-virt_GCC readme file about the updated version in RISC-V_RV32_QEMU_VIRT_GCC.

* Update headers in newly added source files so they pass the automated header check.

* Update lexicon to pass automated spell check.

Co-authored-by: none <>
2022-01-26 17:55:06 -08:00
..
fake_rom.lds Add Makefile project for RISC-V QEMU virtpc (#266) 2020-11-11 15:35:21 -08:00
FreeRTOSConfig.h RISC-V-Qemu-virt: Add assert macros in FreeRTOSConfig (#777) 2022-01-18 11:28:57 -08:00
main.c Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00
main_blinky.c Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00
Makefile Add Makefile project for RISC-V QEMU virtpc (#266) 2020-11-11 15:35:21 -08:00
ns16550.c Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00
ns16550.h Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00
Readme.md Extend qemu virt riscv demo (#774) 2022-01-26 17:55:06 -08:00
riscv-reg.h Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00
riscv-virt.c Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00
riscv-virt.h Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00
start.S Apply release changes to main branch (#759) 2021-12-23 10:16:27 -08:00

There is an updated version of this original submission from Katsuhiro Suzuki in the FreeRTOS/Demo/RISC-V_RV32_QEMU_VIRT_GCC directory.

Emulating generic RISC-V 32bit machine on QEMU

Requirements

  1. GNU RISC-V toolchains (tested on Crosstool-NG)
  2. qemu-riscv32-system (tested on Debian 10 package)
  3. Linux OS (tested on Debian 10)

How to build toolchain

Clone the Crosstool-NG and build.

$ git clone https://github.com/crosstool-ng/crosstool-ng
$ ./configure --enable-local
$ make

$ ./ct-ng menuconfig

Change the following configs:

CT_EXPERIMENTAL=y
CT_ARCH_RISCV=y
CT_ARCH_64=y
CT_ARCH_ARCH=rv32ima
CT_ARCH_ABI=ilp32
CT_MULTILIB=y
CT_DEBUG_GDB=y

Build the GNU toolchain for RISC-V.

$ ./ct-ng build

A toolchain is installed at ~/x-tools/riscv64-unknown-elf directory.

How to build

Add path of toolchain that is described above section.

$ export PATH=~/x-tools/riscv64-unknown-elf:$PATH

For release build:

$ make

For debug build:

$ make DEBUG=1

If success to build, executable file RTOSDemo.axf in ./build directory.

How to run

$ qemu-system-riscv32 -nographic -machine virt -net none \
  -chardev stdio,id=con,mux=on -serial chardev:con \
  -mon chardev=con,mode=readline -bios none \
  -smp 4 -kernel ./build/RTOSDemo.axf

How to debug with gdb

Append -s and -S options to the previous qemu command.

  • -s: enable to attach gdb to QEMU at port 1234
  • -S: start and halted CPU (wait for attach from gdb)

This is just recommend to use 'debug build' for more efficient debugging. Run these commands after starting the QEMU with above options:

$ riscv64-unknown-elf-gdb build/RTOSDemo.axf

(gdb) target remote localhost:1234
(gdb) break main
Breakpoint 1 at 0x80000110

(gdb) c
Continuing.

Breakpoint 1, 0x80000110 in main ()

Description

This demo just prints Tx/Rx message of queue to serial port, use no other hardware and use only primary core (currently hart 0). Other cores are simply going to wfi state and execute nothing else.