# chipsalliance/cores-veer-el2 architecture

> Architecture diagram of the GitHub repository chipsalliance/cores-veer-el2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chipsalliance/cores-veer-el2
- Repository: https://github.com/chipsalliance/cores-veer-el2

## Overview

##### Main Components

a) Core Processing Blocks:
- Instruction Fetch Unit (IFU)
- Decode Unit (DEC)
- Execution Unit (EXU)
- Load/Store Unit (LSU)
- Debug Module (DBG)
- Physical Memory Protection (PMP)

b) Memory Components:
- ICCM (Instruction Closely Coupled Memory)
- DCCM (Data Closely Coupled Memory)
- Memory Interface

c) Bus Interfaces:
- AXI4 Interface
- AHB Interface (alternative configuration)
- DMI (Debug Module Interface)

**┌─────────────────────────────────────── VeeR EL2 Core ───────────────────────────────────────┐**

- ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐   │
- IFU   │ -> │   DEC   │ -> │   EXU   │ -> │   LSU   │ <- │  DCCM   │    │  ICCM   │   │
- ┘    └─────────┘    └─────────┘    └─────────┘    └─────────┘    └─────────┘   │
- ↑             ↑              ↑               ↑                                         │

- ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐                                 │
- PMP   │    │   DBG   │    │  Timer  │    │   PIC   │                                 │
- ┘    └─────────┘    └─────────┘    └─────────┘                                 │

- ┘

##### Connection Types

Use different line styles to represent:
- Double lines: Bus interfaces

##### Implementation Details

- Clock domains
- Reset structure
- Interrupt handling paths
- Exception handling paths
- Pipeline stages in the core

##### Additional Elements

- Verification components
- Test interfaces
- Performance counters
- CSR access paths

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph VeeR_EL2_Core["VeeR EL2 Core"]
        direction TB
        
        subgraph Processing_Pipeline
            direction TB
            IFU["Instruction Fetch Unit (IFU)"]:::core
            DEC["Decode Unit (DEC)"]:::core
            EXU["Execution Unit (EXU)"]:::core
            LSU["Load/Store Unit (LSU)"]:::core
            
            IFU --> DEC
            DEC --> EXU
            EXU --> LSU
        end
        
        subgraph Memory_Components
            direction TB
            ICCM["ICCM"]:::memory
            DCCM["DCCM"]:::memory
        end
        
        subgraph Control_Components
            direction TB
            DBG["Debug Module"]:::control
            PMP["Physical Memory Protection"]:::control
            Timer["Timer"]:::control
            PIC["PIC"]:::control
        end
        
        subgraph Interfaces
            direction TB
            AXI4["AXI4 Interface"]:::interface
            AHB["AHB Interface"]:::interface
            MemIF["Memory Interface"]:::interface
        end
        
        %% Memory Connections
        IFU <--> ICCM
        LSU <--> DCCM
        
        %% Control Connections
        DBG -.-> IFU
        DBG -.-> DEC
        DBG -.-> EXU
        DBG -.-> LSU
        
        PMP -.-> IFU
        PMP -.-> LSU
        
        %% Interface Connections
        LSU <--> MemIF
        MemIF <--> AXI4
        MemIF <--> AHB
    end
    
    %% Styling
    classDef core fill:#a8d1f0,stroke:#000
    classDef memory fill:#90EE90,stroke:#000
    classDef control fill:#FFE5B4,stroke:#000
    classDef interface fill:#FFA07A,stroke:#000
    
    %% Legend
    subgraph Legend
        L_CORE["Core Component"]:::core
        L_MEM["Memory Component"]:::memory
        L_CTRL["Control Component"]:::control
        L_IF["Interface Component"]:::interface
    end
    
    %% Click Events
    click IFU "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/ifu/el2_ifu.sv"
    click DEC "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/dec/el2_dec.sv"
    click EXU "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/exu/el2_exu.sv"
    click LSU "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/lsu/el2_lsu.sv"
    click DBG "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/dbg/el2_dbg.sv"
    click PMP "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/el2_pmp.sv"
    click ICCM "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/ifu/el2_ifu_iccm_mem.sv"
    click DCCM "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/lsu/el2_lsu_dccm_mem.sv"
    click AXI4 "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/lib/ahb_to_axi4.sv"
    click AHB "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/lib/axi4_to_ahb.sv"
    click MemIF "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/lib/el2_mem_if.sv"
    click VeeR_EL2_Core "https://github.com/chipsalliance/Cores-VeeR-EL2/blob/main/design/el2_veer.sv"
```
