🚀 RISC-V and HDL Learning Project

[ English | 中文 ]

📂 Project Structure

├── src
│   └── main
│       └── scala
│           └── markorv
│               ├── backend   # Execution units
│               ├── cache     # Cache
│               ├── frontend  # Frontend
│               └── io        # External bus
└── tests
    ├── asmtst                # Assembly tests
    └── emulator              # Test stimulus generation

Program Order Definition

This is a temporary program order definition. Write-back order in the cache is not guaranteed, but the consistency of instruction effects on the internal CPU state is ensured (non-out-of-order execution).

Update Roadmap

Please refer to TODO.md for future update plans.

Architecture and Update Log

Check the docs folder for detailed architecture information and update logs.

Usage Instructions

1. Clone and init the project

   git clone https://github.com/marko1616/marko-riscv.git
   make init

2. Install build tools

   • Install mill 0.11.5 It is recommended to run the following commands:

   curl -L https://github.com/com-lihaoyi/mill/releases/download/0.11.5/0.11.5 > mill && chmod +x mill
   export PATH="$(pwd):/$PATH" # Needs to be added each time you run. Alternatively, modify your bashrc.

3. Run Makefile options

   make gen-rom           # ⚙️ Generate hex ROM image
   make gen-tests         # ⚙️ Generate hex test assembly programs
   make compile           # ⚙️ Compile C++ emulator

How to Run Simulation

1. Modify the parameters in tests/emulator/stimulus.cpp
2. Generate and run the simulation:

   make gen-rom
   make gen-tests
   make emu
   obj_dir/VMarkoRvCore --rom-path tests/emulator/assets/boot.bin --ram-path tests/asmtst/xxx.bin