The repository contains the source code for a 5-stage pipelined processor designed to run the RISC-V 32-bit base intruction set (RV32I).

The processor is interfaced with UART to communicate with a computer so that the content of the registers, data memory or instruction memory can be observed, and modified.

The source code is found in the src folder.

1. src/pipelined_processor - Verilog files for the processor

2. src/uart - Verilog files for UART communication

3. src/top_pipelined_processor_quartus.v - Top level entity for the Quartus project

To do simulation as described below, Icarus Verilog and GTKWave are required.

Once installed, follow these steps to run simulation. Otherwise, you are free to use any simulation tool you prefer.

Note that you should start executing commands from the repository root.

1. cd src/pipelined_processor/src

2. iverilog -g2012 -o ../sim/pipelined_processor_tb ../sim/pipelined_processor_tb.sv control.v control_main_decoder.v control_alu_decoder.v pc.v adder.sv imem.v register_file.v extend.v alu.v data_memory.v

3. cd ../sim

4. vvp processor_tb

5. gtkwave processor_tb.vcd

1. Clone the repository with --recursive flag, so that all submodules are also cloned.

git clone --recursive https://github.com/RISC-Processor/Pipelined-Processor.git

2. Add bin folder of your Quartus installation to the PATH (System Variables). For example:

set PATH=C:\intelFPGA\<VERSION>\quartus\bin;%PATH%

In Windows, use Git Bash, since Command Prompt/ PowerShell does not support the above command. Or do it manually.

3. In repo root, execute the following line to build the Quartus project.

./Hog/Do CREATE pipelined_processor_quartus

In Windows, use Git Bash, since Command Prompt/ PowerShell does not support the above command.

4. Navigate to Projects/pipelined_processor_quartus folder and open pipelined_processor_quartus.qpf.