# ivanmilin/riscv_multicore_cache_controller architecture

> Architecture diagram of the GitHub repository ivanmilin/riscv_multicore_cache_controller, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ivanmilin/riscv_multicore_cache_controller
- Repository: https://github.com/ivanmilin/riscv_multicore_cache_controller

## Overview

This repository describes a dual-core RV32 processor with private L1 data caches, a shared L2 cache and memory, and MESI/snooping coherence. The README documents the core/cache topology and supported instruction families, but no source excerpts were provided; internal module-level calls and cache transaction details therefore cannot be verified here. The formal-verification subsystem is also represented because it is a stated project capability. Edges cite the README where that documentation supports them.

Main entry points: [`hdl/top.sv`](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/top.sv) (Dual-core system), [`hdl/Processor.sv`](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/Processor.sv) (RV32 core), [`verif`](https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif) (Formal verification), [`hdl/cache_subsystem_L1.sv`](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/cache_subsystem_L1.sv) (Private L1 caches)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cpu["Processor cores"]
  node_system["Dual-core system<br/>[top.sv]"]
  node_core["RV32 core<br/>[Processor.sv]"]
  node_control["Instruction control<br/>[Controller.sv]"]
  node_alu["ALU<br/>[ALU.sv]"]
  node_registers["Register file<br/>[RegisterFile.sv]"]
  node_immediate["Immediate generation"]
  node_branch["Branch conditions<br/>[BranchCondition.sv]"]
  node_writeback["Write-back<br/>[WriteBack.sv]"]
end

subgraph group_memory["Cache and memory"]
  node_l1["Private L1 caches"]
  node_bus["Cache bus control<br/>[bus_controller.sv]"]
  node_l2["Shared L2 cache"]
  node_memory[("Instruction and data memory<br/>[DataMemory.sv]")]
  node_instruction_memory[("Instruction memory")]
end

subgraph group_verify["Formal verification"]
  node_formal["Formal verification"]
  node_branch_checks["Branch properties"]
  node_controller_checks["Controller properties"]
  node_immediate_checks["Immediate properties"]
  node_reference["Reference model"]
  node_system_reference["System reference model"]
end

node_user(("System user"))
node_jasper["Cadence JasperGold"]

node_user -->|"runs"| node_system
node_system -->|"contains cores"| node_core
node_core -->|"uses private cache"| node_l1
node_system -->|"shares cache"| node_l2
node_system -->|"shares memory"| node_memory
node_system -->|"is formally verified"| node_formal
node_formal -->|"uses"| node_jasper

click node_system "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/top.sv"
click node_core "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/Processor.sv"
click node_control "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/Controller.sv"
click node_alu "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/ALU.sv"
click node_registers "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/RegisterFile.sv"
click node_immediate "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/ImmediateGenerator.sv"
click node_branch "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/BranchCondition.sv"
click node_writeback "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/WriteBack.sv"
click node_l1 "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/cache_subsystem_L1.sv"
click node_bus "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/bus_controller.sv"
click node_l2 "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/cache_subsystem_L2.sv"
click node_memory "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/DataMemory.sv"
click node_instruction_memory "https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/InstructionMemory.sv"
click node_formal "https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif"
click node_branch_checks "https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/branch_checking"
click node_controller_checks "https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/controller_checking"
click node_immediate_checks "https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/immediate_checking"
click node_reference "https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/reference_model"
click node_system_reference "https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/reference_model_top"

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_system,node_core,node_control,node_alu,node_registers,node_immediate,node_branch,node_writeback,node_user toneBlue
class node_l1,node_bus,node_l2,node_memory,node_instruction_memory toneAmber
class node_formal,node_branch_checks,node_controller_checks,node_immediate_checks,node_reference,node_system_reference toneMint
class node_jasper toneIndigo
```

## Components

### Processor cores

- [Dual-core system](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/top.sv): `hdl/top.sv`
- [RV32 core](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/Processor.sv): `hdl/Processor.sv`
- [Instruction control](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/Controller.sv): `hdl/Controller.sv`
- [ALU](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/ALU.sv): `hdl/ALU.sv`
- [Register file](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/RegisterFile.sv): `hdl/RegisterFile.sv`
- [Immediate generation](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/ImmediateGenerator.sv): `hdl/ImmediateGenerator.sv`
- [Branch conditions](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/BranchCondition.sv): `hdl/BranchCondition.sv`
- [Write-back](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/WriteBack.sv): `hdl/WriteBack.sv`

### Cache and memory

- [Private L1 caches](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/cache_subsystem_L1.sv): `hdl/cache_subsystem_L1.sv`
- [Cache bus control](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/bus_controller.sv): `hdl/bus_controller.sv`
- [Shared L2 cache](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/cache_subsystem_L2.sv): `hdl/cache_subsystem_L2.sv`
- [Instruction and data memory](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/DataMemory.sv): `hdl/DataMemory.sv`
- [Instruction memory](https://github.com/ivanmilin/riscv_multicore_cache_controller/blob/main/hdl/InstructionMemory.sv): `hdl/InstructionMemory.sv`

### Formal verification

- [Formal verification](https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif): `verif`
- [Branch properties](https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/branch_checking): `verif/branch_checking`
- [Controller properties](https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/controller_checking): `verif/controller_checking`
- [Immediate properties](https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/immediate_checking): `verif/immediate_checking`
- [Reference model](https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/reference_model): `verif/reference_model`
- [System reference model](https://github.com/ivanmilin/riscv_multicore_cache_controller/tree/main/verif/reference_model_top): `verif/reference_model_top`

### Other components

- **System user**
- **Cadence JasperGold**

## Connections

- System user → Dual-core system: runs (evidence: `README.md`)
- Dual-core system → RV32 core: contains cores (evidence: `README.md`)
- RV32 core → Private L1 caches: uses private cache (evidence: `README.md`)
- Dual-core system → Shared L2 cache: shares cache (evidence: `README.md`)
- Dual-core system → Instruction and data memory: shares memory (evidence: `README.md`)
- Dual-core system → Formal verification: is formally verified (evidence: `README.md`)
- Formal verification → Cadence JasperGold: uses (evidence: `README.md`)
