KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #codex #claude-code #cli #react #mcp #open-source #deepseek-harness #dsh-plugin #ai

mips-simulator

★ 36 Open GitHub ↗

💻 A 5-stage pipeline MIPS CPU design in Haskell.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MIPS-Simulator

![build](https://github.com/skyzh/mips-simulator/workflows/build/badge.svg)

A functional MIPS CPU simulator implemented in Haskell.

A year ago, I implemented
[a RISC-V simulator in C++](https://github.com/skyzh/RISCV-Simulator).
I had long dreamed of using a functional programming language to express
the circuit of a CPU. But at that time, implementing lazy-evalution
in C++ is slow and painful. So the semester in Computer Architecture
course, I made this MIPS simulator.

As functional programming language works well in expressing this
hardware circuit logic, I'm implementing [A MIPS CPU](https://github.com/skyzh/mips-cpu),
just by directly translating Haskell into Verilog.

All CPU and CPU simulators I've made are listed below.

|                                                                     | Technique                                      | Implementation |
|---------------------------------------------------------------------|------------------------------------------------|----------------|
| [RISC-V v1](https://github.com/skyzh/RISCV-Simulator/tree/pipeline) | 5-stage pipeline  simulator                 | C++            |
| [RISC-V v2](https://github.com/skyzh/RISCV-Simulator)               | dynamic scheduling simulator <br> Tomasulo + Speculation | C++            |
| [MIPS](https://github.com/skyzh/mips-simulator)                     | 5-stage pipeline  simulator                             | Haskell        |
| [MIPS](https://github.com/skyzh/mips-cpu)                           | 5-stage pipeline CPU         | Verilog        |

## Usage

Currently I haven't implemented a command-line interface for interacting with
this simulator. You can only run tests or hack it yourself for now.

Install [Stack](https://docs.haskellstack.org/en/stable/README/) and simply run:

```bash
stack test
```

## Roadmap
* Single-Cycle Processor
    - [x] R type
    - [x] I type
    - [x] ALU test
    - [x] Compare and shift
    - [ ] Support HI and LO, multiply and division
    - [x] Branch instruction
    - [x] jump and link
    - [x] J type
    - [x] Memory operations
    - [ ] unsigned / high addr memory operations
* Multi-Cycle Processor
    - [x] Data path
    - [x] Stalling
    - [x] Forwarding
    - [x] Branch Prediction
    - [ ] Advanced Branch Predictor
    - [x] Hazard Tests

## Reference

* https://uweb.engr.arizona.edu/~ece369/Resources/spim/MIPSReference.pdf (some opcode is wrong in this pdf)
* http://www.mrc.uidaho.edu/mrc/people/jff/digital/MIPSir.html

mips-simulator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README