# jeevamatrix/riscv-axi-soc architecture

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

- Interactive diagram: https://gitdiagram.com/jeevamatrix/riscv-axi-soc
- Repository: https://github.com/jeevamatrix/riscv-axi-soc

## Overview

This is a minimal RISC-V SoC whose CPU fetches instructions and performs data accesses through a CPU-to-AXI wrapper. The AXI interconnect routes requests to ROM, SRAM, or an AXI-to-APB bridge; the bridge and APB interconnect provide access to GPIO and an ID counter. The graph follows the README’s documented hierarchy and capabilities. No RTL excerpts were provided, so internal implementation details and undocumented connections are omitted.

Main entry points: [`src/top_soc.v`](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/top_soc.v) (SoC Top), [`src/axi_interconnect.v`](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_interconnect.v) (AXI Interconnect), [`src/apb_interconnect.v`](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/apb_interconnect.v) (APB Interconnect), [`src/cpu_axi_wrapper.v`](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/cpu_axi_wrapper.v) (CPU AXI Wrapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["SoC Integration"]
  node_soc["SoC Top<br/>[top_soc.v]"]
end

subgraph group_cpu_axi["CPU and AXI"]
  node_core["RISC-V Core<br/>[top.v]"]
  node_cpu_wrapper["CPU AXI Wrapper<br/>[cpu_axi_wrapper.v]"]
  node_axi_fabric["AXI Interconnect<br/>[axi_interconnect.v]"]
end

subgraph group_memory["Memory Subsystem"]
  node_rom[("AXI ROM<br/>[axi_rom_slave.v]")]
  node_rom_image["ROM Image<br/>[rom.hex]"]
  node_sram[("AXI SRAM<br/>[axi_sram_slave.v]")]
end

subgraph group_apb["APB Peripherals"]
  node_axi_apb["AXI-to-APB Bridge"]
  node_apb_fabric["APB Interconnect<br/>[apb_interconnect.v]"]
  node_gpio["GPIO Peripheral<br/>[apb_gpio.v]"]
  node_id_counter["ID Counter<br/>[apb_id_counter.v]"]
end

node_soc -->|"instantiates"| node_core
node_soc -->|"instantiates"| node_cpu_wrapper
node_soc -->|"instantiates"| node_axi_fabric
node_soc -->|"instantiates"| node_rom
node_soc -->|"instantiates"| node_sram
node_soc -->|"instantiates"| node_axi_apb
node_soc -->|"instantiates"| node_apb_fabric
node_soc -->|"instantiates"| node_gpio
node_soc -->|"instantiates"| node_id_counter
node_core -->|"requests access"| node_cpu_wrapper
node_cpu_wrapper -->|"issues AXI requests"| node_axi_fabric
node_axi_fabric -->|"routes reads"| node_rom
node_axi_fabric -->|"routes access"| node_sram
node_axi_fabric -->|"routes access"| node_axi_apb
node_rom -->|"loads contents"| node_rom_image
node_axi_apb -->|"converts transactions"| node_apb_fabric
node_apb_fabric -->|"selects slave"| node_gpio
node_apb_fabric -->|"selects slave"| node_id_counter

click node_soc "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/top_soc.v"
click node_core "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/core/top.v"
click node_cpu_wrapper "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/cpu_axi_wrapper.v"
click node_axi_fabric "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_interconnect.v"
click node_rom "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_rom_slave.v"
click node_rom_image "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/rom.hex"
click node_sram "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_sram_slave.v"
click node_axi_apb "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_to_apb_bridge.v"
click node_apb_fabric "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/apb_interconnect.v"
click node_gpio "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/apb_gpio.v"
click node_id_counter "https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/apb_id_counter.v"

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_soc toneBlue
class node_core,node_cpu_wrapper,node_axi_fabric toneAmber
class node_rom,node_rom_image,node_sram toneMint
class node_axi_apb,node_apb_fabric,node_gpio,node_id_counter toneRose
```

## Components

### SoC Integration

- [SoC Top](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/top_soc.v): `src/top_soc.v`

### CPU and AXI

- [RISC-V Core](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/core/top.v): `src/core/top.v`
- [CPU AXI Wrapper](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/cpu_axi_wrapper.v): `src/cpu_axi_wrapper.v`
- [AXI Interconnect](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_interconnect.v): `src/axi_interconnect.v`

### Memory Subsystem

- [AXI ROM](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_rom_slave.v): `src/axi_rom_slave.v`
- [ROM Image](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/rom.hex): `src/rom.hex`
- [AXI SRAM](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_sram_slave.v): `src/axi_sram_slave.v`

### APB Peripherals

- [AXI-to-APB Bridge](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/axi_to_apb_bridge.v): `src/axi_to_apb_bridge.v`
- [APB Interconnect](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/apb_interconnect.v): `src/apb_interconnect.v`
- [GPIO Peripheral](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/apb_gpio.v): `src/apb_gpio.v`
- [ID Counter](https://github.com/jeevamatrix/riscv-axi-soc/blob/main/src/apb_id_counter.v): `src/apb_id_counter.v`

## Connections

- SoC Top → RISC-V Core: instantiates (evidence: `README.md`)
- SoC Top → CPU AXI Wrapper: instantiates (evidence: `README.md`)
- SoC Top → AXI Interconnect: instantiates (evidence: `README.md`)
- SoC Top → AXI ROM: instantiates (evidence: `README.md`)
- SoC Top → AXI SRAM: instantiates (evidence: `README.md`)
- SoC Top → AXI-to-APB Bridge: instantiates (evidence: `README.md`)
- SoC Top → APB Interconnect: instantiates (evidence: `README.md`)
- SoC Top → GPIO Peripheral: instantiates (evidence: `README.md`)
- SoC Top → ID Counter: instantiates (evidence: `README.md`)
- RISC-V Core → CPU AXI Wrapper: requests access (evidence: `README.md`)
- CPU AXI Wrapper → AXI Interconnect: issues AXI requests (evidence: `README.md`)
- AXI Interconnect → AXI ROM: routes reads (evidence: `README.md`)
- AXI Interconnect → AXI SRAM: routes access (evidence: `README.md`)
- AXI Interconnect → AXI-to-APB Bridge: routes access (evidence: `README.md`)
- AXI ROM → ROM Image: loads contents (evidence: `README.md`)
- AXI-to-APB Bridge → APB Interconnect: converts transactions (evidence: `README.md`)
- APB Interconnect → GPIO Peripheral: selects slave (evidence: `README.md`)
- APB Interconnect → ID Counter: selects slave (evidence: `README.md`)
