# alexforencich/verilog-axi architecture

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

- Interactive diagram: https://gitdiagram.com/alexforencich/verilog-axi
- Repository: https://github.com/alexforencich/verilog-axi

## Overview

This repository is a collection of parametrizable Verilog AXI4 and AXI4-Lite hardware components, rather than a single end-user application. Designers select and integrate modules to adapt buses, move data, interconnect masters and slaves, and provide memory or register endpoints. The README explicitly documents wrapper composition for several modules and shared-engine descriptor multiplexers. The supplied source excerpts focus on wrapper generators and testbench utilities, so internal RTL call relationships are not inferred; links without documentation are omitted.

Main entry points: [`rtl/axi_dma.v`](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma.v) (Stream DMA), [`rtl/axi_adapter.v`](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_adapter.v) (AXI width adapter), [`rtl/axi_crossbar.v`](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_crossbar.v) (Nonblocking crossbar), [`rtl/axi_cdma.v`](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_cdma.v) (Memory DMA)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_axi_data["AXI data movement"]
  node_axi_adapter["AXI width adapter<br/>[axi_adapter.v]"]
  node_axi_adapter_rd["Read adapter<br/>[axi_adapter_rd.v]"]
  node_axi_adapter_wr["Write adapter<br/>[axi_adapter_wr.v]"]
  node_axil_converter["AXI-Lite converter<br/>[axi_axil_adapter.v]"]
  node_cdma["Memory DMA<br/>[axi_cdma.v]"]
  node_cdma_mux["CDMA descriptor mux"]
  node_dma["Stream DMA<br/>[axi_dma.v]"]
  node_dma_rd["DMA read engine<br/>[axi_dma_rd.v]"]
  node_dma_wr["DMA write engine<br/>[axi_dma_wr.v]"]
  node_dma_mux["DMA descriptor mux<br/>[axi_dma_desc_mux.v]"]
end

subgraph group_axi_fabric["AXI interconnect"]
  node_axi_crossbar["Nonblocking crossbar<br/>[axi_crossbar.v]"]
  node_axi_crossbar_addr["Address decode"]
  node_axi_interconnect["Shared interconnect<br/>[axi_interconnect.v]"]
  node_axi_wrapper_generators["AXI wrapper generators"]
end

subgraph group_axi_storage["Memory endpoints"]
  node_axi_ram[("AXI RAM<br/>[axi_ram.v]")]
  node_axi_dp_ram[("Dual-port RAM<br/>[axi_dp_ram.v]")]
  node_axi_ram_if["RAM burst interfaces<br/>[axi_ram_wr_rd_if.v]"]
end

subgraph group_axil["AXI-Lite components"]
  node_axil_wrapper_generators["AXI-Lite wrapper generators"]
  node_axil_crossbar["AXI-Lite crossbar<br/>[axil_crossbar.v]"]
  node_axil_interconnect["AXI-Lite interconnect"]
  node_axil_adapter["AXI-Lite width adapter<br/>[axil_adapter.v]"]
  node_axil_cdc["Clock-domain crossing<br/>[axil_cdc.v]"]
  node_axil_ram[("AXI-Lite RAM<br/>[axil_ram.v]")]
  node_axil_register_file["Register interface<br/>[axil_reg_if.v]"]
end

subgraph group_support["AXI buffering"]
  node_axi_fifo["AXI FIFO<br/>[axi_fifo.v]"]
  node_axi_register["AXI channel registers<br/>[axi_register.v]"]
  node_vfifo["Virtual FIFO<br/>[axi_vfifo.v]"]
end

node_designer(("Hardware designer"))

node_designer -->|"integrates"| node_axi_adapter
node_designer -->|"integrates"| node_axil_converter
node_designer -->|"integrates"| node_cdma
node_designer -->|"integrates"| node_dma
node_designer -->|"integrates"| node_axi_crossbar
node_designer -->|"integrates"| node_axi_interconnect
node_designer -->|"integrates"| node_axi_ram
node_designer -->|"integrates"| node_axil_crossbar
node_designer -->|"integrates"| node_axil_interconnect
node_designer -->|"integrates"| node_axil_cdc
node_designer -->|"integrates"| node_vfifo
node_axi_adapter -->|"wraps"| node_axi_adapter_rd
node_axi_adapter -->|"wraps"| node_axi_adapter_wr
node_cdma -->|"shares engine via"| node_cdma_mux
node_dma -->|"wraps"| node_dma_rd
node_dma -->|"wraps"| node_dma_wr
node_dma -->|"shares engine via"| node_dma_mux
node_axi_crossbar -->|"uses decode"| node_axi_crossbar_addr
node_axi_crossbar -->|"has generated wrappers"| node_axi_wrapper_generators
node_axil_crossbar -->|"has generated wrappers"| node_axil_wrapper_generators

click node_axi_adapter "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_adapter.v"
click node_axi_adapter_rd "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_adapter_rd.v"
click node_axi_adapter_wr "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_adapter_wr.v"
click node_axil_converter "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_axil_adapter.v"
click node_cdma "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_cdma.v"
click node_cdma_mux "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_cdma_desc_mux.v"
click node_dma "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma.v"
click node_dma_rd "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma_rd.v"
click node_dma_wr "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma_wr.v"
click node_dma_mux "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma_desc_mux.v"
click node_axi_crossbar "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_crossbar.v"
click node_axi_crossbar_addr "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_crossbar_addr.v"
click node_axi_interconnect "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_interconnect.v"
click node_axi_wrapper_generators "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_crossbar_wrap.py"
click node_axil_wrapper_generators "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_crossbar_wrap.py"
click node_axi_ram "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_ram.v"
click node_axi_dp_ram "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dp_ram.v"
click node_axi_ram_if "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_ram_wr_rd_if.v"
click node_axil_crossbar "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_crossbar.v"
click node_axil_interconnect "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_interconnect.v"
click node_axil_adapter "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_adapter.v"
click node_axil_cdc "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_cdc.v"
click node_axil_ram "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_ram.v"
click node_axil_register_file "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_reg_if.v"
click node_axi_fifo "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_fifo.v"
click node_axi_register "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_register.v"
click node_vfifo "https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_vfifo.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_axi_adapter,node_axi_adapter_rd,node_axi_adapter_wr,node_axil_converter,node_cdma,node_cdma_mux,node_dma,node_dma_rd,node_dma_wr,node_dma_mux toneBlue
class node_axi_crossbar,node_axi_crossbar_addr,node_axi_interconnect,node_axi_wrapper_generators toneAmber
class node_axi_ram,node_axi_dp_ram,node_axi_ram_if toneMint
class node_axil_wrapper_generators,node_axil_crossbar,node_axil_interconnect,node_axil_adapter,node_axil_cdc,node_axil_ram,node_axil_register_file toneRose
class node_axi_fifo,node_axi_register,node_vfifo,node_designer toneIndigo
```

## Components

### AXI data movement

- [AXI width adapter](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_adapter.v): `rtl/axi_adapter.v`
- [Read adapter](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_adapter_rd.v): `rtl/axi_adapter_rd.v`
- [Write adapter](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_adapter_wr.v): `rtl/axi_adapter_wr.v`
- [AXI-Lite converter](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_axil_adapter.v): `rtl/axi_axil_adapter.v`
- [Memory DMA](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_cdma.v): `rtl/axi_cdma.v`
- [CDMA descriptor mux](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_cdma_desc_mux.v): `rtl/axi_cdma_desc_mux.v`
- [Stream DMA](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma.v): `rtl/axi_dma.v`
- [DMA read engine](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma_rd.v): `rtl/axi_dma_rd.v`
- [DMA write engine](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma_wr.v): `rtl/axi_dma_wr.v`
- [DMA descriptor mux](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dma_desc_mux.v): `rtl/axi_dma_desc_mux.v`

### AXI interconnect

- [Nonblocking crossbar](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_crossbar.v): `rtl/axi_crossbar.v`
- [Address decode](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_crossbar_addr.v): `rtl/axi_crossbar_addr.v`
- [Shared interconnect](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_interconnect.v): `rtl/axi_interconnect.v`
- [AXI wrapper generators](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_crossbar_wrap.py): `rtl/axi_crossbar_wrap.py`

### Memory endpoints

- [AXI RAM](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_ram.v): `rtl/axi_ram.v`
- [Dual-port RAM](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_dp_ram.v): `rtl/axi_dp_ram.v`
- [RAM burst interfaces](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_ram_wr_rd_if.v): `rtl/axi_ram_wr_rd_if.v`

### AXI-Lite components

- [AXI-Lite wrapper generators](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_crossbar_wrap.py): `rtl/axil_crossbar_wrap.py`
- [AXI-Lite crossbar](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_crossbar.v): `rtl/axil_crossbar.v`
- [AXI-Lite interconnect](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_interconnect.v): `rtl/axil_interconnect.v`
- [AXI-Lite width adapter](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_adapter.v): `rtl/axil_adapter.v`
- [Clock-domain crossing](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_cdc.v): `rtl/axil_cdc.v`
- [AXI-Lite RAM](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_ram.v): `rtl/axil_ram.v`
- [Register interface](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axil_reg_if.v): `rtl/axil_reg_if.v`

### AXI buffering

- [AXI FIFO](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_fifo.v): `rtl/axi_fifo.v`
- [AXI channel registers](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_register.v): `rtl/axi_register.v`
- [Virtual FIFO](https://github.com/alexforencich/verilog-axi/blob/master/rtl/axi_vfifo.v): `rtl/axi_vfifo.v`

### Other components

- **Hardware designer**

## Connections

- Hardware designer → AXI width adapter: integrates (evidence: `README.md`)
- Hardware designer → AXI-Lite converter: integrates (evidence: `README.md`)
- Hardware designer → Memory DMA: integrates (evidence: `README.md`)
- Hardware designer → Stream DMA: integrates (evidence: `README.md`)
- Hardware designer → Nonblocking crossbar: integrates (evidence: `README.md`)
- Hardware designer → Shared interconnect: integrates (evidence: `README.md`)
- Hardware designer → AXI RAM: integrates (evidence: `README.md`)
- Hardware designer → AXI-Lite crossbar: integrates (evidence: `README.md`)
- Hardware designer → AXI-Lite interconnect: integrates (evidence: `README.md`)
- Hardware designer → Clock-domain crossing: integrates (evidence: `README.md`)
- Hardware designer → Virtual FIFO: integrates (evidence: `README.md`)
- AXI width adapter → Read adapter: wraps (evidence: `README.md`)
- AXI width adapter → Write adapter: wraps (evidence: `README.md`)
- Memory DMA → CDMA descriptor mux: shares engine via (evidence: `README.md`)
- Stream DMA → DMA read engine: wraps (evidence: `README.md`)
- Stream DMA → DMA write engine: wraps (evidence: `README.md`)
- Stream DMA → DMA descriptor mux: shares engine via (evidence: `README.md`)
- Nonblocking crossbar → Address decode: uses decode (evidence: `README.md`)
- Nonblocking crossbar → AXI wrapper generators: has generated wrappers (evidence: `README.md`)
- AXI-Lite crossbar → AXI-Lite wrapper generators: has generated wrappers (evidence: `README.md`)
