Fuxi (伏羲) is a 32-bit pipelined RISC-V processor written in Chisel3.

• RV32I 2.1
• Zifencei extension 2.0
• Zicsr extension 2.0
• M extension 2.0
• A extension 2.0
• Machine-level ISA 1.11
• Supervisor-level ISA 1.11

Fuxi processor is designed for running GeeOS, or other simple operating systems or bare-metal software. Considering the complexity, the following functions has not yet been implemented:

• Memory privilege in mstatus register: MPRV bit and MXR bit are hardwired to 0.
• Virtualization support in mstatus register: TVM bit, TW bit and TSR bit are hardwired to 0.
• Physical Memory Protection: all PMP registers are hardwired to 0.

With default configuration:

• Dhrystone 2.1: 0.60 DMIPS/MHz.
• CoreMark: 2.15 CoreMark/MHz.

By issuing the following command lines, you can get generated verilog file in directory verilog/build:

$ git clone https://github.com/MaxXSoft/Fuxi
$ cd Fuxi
$ make

All unit tests are available in directory src/test/scala. For example, unit test for decode stage is available in core/DecoderTest.scala, you can run this test by executing the following command lines:

$ sbt
> test:runMain core.DecoderTest

CoreTest is a special unit test provided in this repository, it can run simple RISC-V programs using the Fuxi core. We also provided some programs in directory src/test/resources. For example, you can run one of it:

$ sbt
> test:runMain core.CoreTest -if src/test/resources/fib.txt

Trace information during running program fib.txt will be printed to the console.

CoreTest supports the following command line arguments:

So you can test the core using a trace file generated by other processor or emulator:

> test:runMain core.CoreTest -if src/test/resources/fib.txt -tf src/test/resources/fib_trace.txt

For other details, please read the source file of CoreTest.scala.

All provided programs:

This part is under construction.

As we see in the top level module, the complete Fuxi processor consists of Core and CoreBus, the latter provides MMU, cache system and AXI4 interface for the Core part.

All of the unit test cases currently contained in this repository can only test modules in the Core part, we are still preparing the test bench the entire processor system. For now, you can build a tiny SoC by yourself based on some AXI4 IP cores to run other test benches you want.

Copyright (C) 2010-2020 MaxXing. License GPLv3.

Special thanks to @Yukiteru Lee.