# guru-p169/2-wide-superscalar-ooo-rv32im architecture

> Architecture diagram of the GitHub repository guru-p169/2-wide-superscalar-ooo-rv32im, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/guru-p169/2-wide-superscalar-ooo-rv32im
- Repository: https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im

## Overview

This repository is an RTL implementation of a 2-wide superscalar, out-of-order RV32IM processor. Its tree identifies the frontend, instruction-processing stages, execution, memory hierarchy, recovery, and AXI4 interface, but the README only gives the product name and no behavioral description. No source excerpts are available, so module-to-module calls, data transfers, and the precise user-to-result flow cannot be verified; the graph therefore shows subsystem boundaries without inferred connections.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Instruction frontend"]
  node_fetch["Fetch and PC"]
  node_prediction["Branch prediction"]
  node_fetch_queue["Fetch queue"]
end

subgraph group_pipeline["Core pipeline"]
  node_decode["Decode"]
  node_dispatch["Dispatch"]
  node_rename["Register rename"]
  node_issue["Issue queues"]
end

subgraph group_execution["Execution and recovery"]
  node_execute["Execution units"]
  node_writeback["Writeback"]
  node_commit["Commit and ROB"]
  node_recovery["Recovery control"]
end

subgraph group_memory["Memory system"]
  node_lsq["Load-store queue"]
  node_icache["L1 instruction cache"]
  node_dcache["L1 data cache"]
  node_l2["L2 cache"]
  node_memory_subsystem["Memory subsystem"]
end

subgraph group_interfaces["System interface"]
  node_axi_master["AXI4 master"]
  node_axi_read["AXI4 read engine"]
  node_axi_write["AXI4 write engine"]
  node_core["Out-of-order core"]
  node_top["Processor top"]
end

click node_fetch "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/frontend"
click node_prediction "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/frontend"
click node_fetch_queue "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/frontend/rv32im_fetch_queue_g.sv"
click node_decode "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/decode"
click node_dispatch "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/dispatch/rv32im_dispatch_g.sv"
click node_rename "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/rename"
click node_issue "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/issue"
click node_execute "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/execute"
click node_writeback "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/writeback"
click node_commit "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/commit"
click node_recovery "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/recovery"
click node_lsq "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/memory/lsq"
click node_icache "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/memory/l1_icache/rv32im_l1_icache_g.sv"
click node_dcache "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/memory/l1_dcache/rv32im_l1_dcache_g.sv"
click node_l2 "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/memory/l2_cache"
click node_memory_subsystem "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/soc/rv32im_memory_subsystem_g.sv"
click node_axi_master "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/axi4/rv32im_axi4_master_g.sv"
click node_axi_read "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/axi4/rv32im_axi4_read_engine_g.sv"
click node_axi_write "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/axi4/rv32im_axi4_write_engine_g.sv"
click node_core "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/soc/rv32im_ooo_core_g.sv"
click node_top "https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/top/rv32im_ooo_superscalar.sv"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_fetch,node_prediction,node_fetch_queue toneBlue
class node_decode,node_dispatch,node_rename,node_issue toneAmber
class node_execute,node_writeback,node_commit,node_recovery toneMint
class node_lsq,node_icache,node_dcache,node_l2,node_memory_subsystem toneRose
class node_axi_master,node_axi_read,node_axi_write,node_core,node_top toneIndigo
```

## Components

### Instruction frontend

- [Fetch and PC](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/frontend): `rtl/frontend`
- [Branch prediction](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/frontend): `rtl/frontend`
- [Fetch queue](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/frontend/rv32im_fetch_queue_g.sv): `rtl/frontend/rv32im_fetch_queue_g.sv`

### Core pipeline

- [Decode](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/decode): `rtl/decode`
- [Dispatch](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/dispatch/rv32im_dispatch_g.sv): `rtl/dispatch/rv32im_dispatch_g.sv`
- [Register rename](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/rename): `rtl/rename`
- [Issue queues](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/issue): `rtl/issue`

### Execution and recovery

- [Execution units](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/execute): `rtl/execute`
- [Writeback](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/writeback): `rtl/writeback`
- [Commit and ROB](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/commit): `rtl/commit`
- [Recovery control](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/recovery): `rtl/recovery`

### Memory system

- [Load-store queue](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/memory/lsq): `rtl/memory/lsq`
- [L1 instruction cache](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/memory/l1_icache/rv32im_l1_icache_g.sv): `rtl/memory/l1_icache/rv32im_l1_icache_g.sv`
- [L1 data cache](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/memory/l1_dcache/rv32im_l1_dcache_g.sv): `rtl/memory/l1_dcache/rv32im_l1_dcache_g.sv`
- [L2 cache](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/tree/main/rtl/memory/l2_cache): `rtl/memory/l2_cache`
- [Memory subsystem](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/soc/rv32im_memory_subsystem_g.sv): `rtl/soc/rv32im_memory_subsystem_g.sv`

### System interface

- [AXI4 master](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/axi4/rv32im_axi4_master_g.sv): `rtl/axi4/rv32im_axi4_master_g.sv`
- [AXI4 read engine](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/axi4/rv32im_axi4_read_engine_g.sv): `rtl/axi4/rv32im_axi4_read_engine_g.sv`
- [AXI4 write engine](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/axi4/rv32im_axi4_write_engine_g.sv): `rtl/axi4/rv32im_axi4_write_engine_g.sv`
- [Out-of-order core](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/soc/rv32im_ooo_core_g.sv): `rtl/soc/rv32im_ooo_core_g.sv`
- [Processor top](https://github.com/guru-p169/2-wide-superscalar-ooo-rv32im/blob/main/rtl/top/rv32im_ooo_superscalar.sv): `rtl/top/rv32im_ooo_superscalar.sv`
