# siddhi-95/ahb-to-apb-bridge-verification architecture

> Architecture diagram of the GitHub repository siddhi-95/ahb-to-apb-bridge-verification, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siddhi-95/ahb-to-apb-bridge-verification
- Repository: https://github.com/siddhi-95/ahb-to-apb-bridge-verification

## Overview

This repository is a UVM verification environment for an AHB-to-APB bridge. Its documented product workflow is an AHB master communicating through the bridge with one of four APB slaves, with verification of data transfer in both directions. The bridge also latches addresses, decodes peripheral selects, handles write/read data, and generates PENABLE. The tree identifies the verification components, but no source excerpts show their runtime wiring, so those relationships are not inferred here.

Main entry points: [`Bridge_rtl/ahb_apb_top.v`](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/Bridge_rtl/ahb_apb_top.v) (AHB-APB bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dut["Bridge DUT"]
  node_bridge["AHB-APB bridge<br/>[ahb_apb_top.v]"]
  node_ahb_interface["AHB interface<br/>[ahb_if.sv]"]
  node_apb_interface["APB interface<br/>[apb_if.sv]"]
end

subgraph group_agents["Bus Agents"]
  node_ahb_agent["AHB agent<br/>[ahb_agent.sv]"]
  node_ahb_agent_top["AHB agent top<br/>[ahb_agt_top.sv]"]
  node_ahb_config["AHB config<br/>[ahb_config.sv]"]
  node_ahb_driver["AHB driver<br/>[ahb_driver.sv]"]
  node_ahb_monitor["AHB monitor<br/>[ahb_monitor.sv]"]
  node_ahb_sequences["AHB sequences<br/>[ahb_seqs.sv]"]
  node_ahb_sequencer["AHB sequencer<br/>[ahb_sequencer.sv]"]
  node_ahb_transactions["AHB transactions<br/>[ahb_xtns.sv]"]
  node_apb_agent["APB agent<br/>[apb_agent.sv]"]
  node_apb_agent_top["APB agent top<br/>[apb_agt_top.sv]"]
  node_apb_config["APB config<br/>[apb_config.sv]"]
  node_apb_driver["APB driver<br/>[apb_driver.sv]"]
  node_apb_monitor["APB monitor<br/>[apb_monitor.sv]"]
  node_apb_sequences["APB sequences<br/>[apb_seqs.sv]"]
  node_apb_sequencer["APB sequencer<br/>[apb_sequencer.sv]"]
  node_apb_transactions["APB transactions<br/>[apb_xtns.sv]"]
end

subgraph group_verification["UVM Verification"]
  node_environment["Verification environment<br/>[AHB_APB_env.sv]"]
  node_environment_config["Environment config"]
  node_scoreboard["Scoreboard<br/>[scoreboard.sv]"]
  node_virtual_sequence["Virtual sequence"]
  node_virtual_sequencer["Virtual sequencer"]
  node_test_top["Testbench top<br/>[top.sv]"]
  node_test["UVM test<br/>[test.sv]"]
  node_test_package["Test package<br/>[APB_AHB_pkg.sv]"]
end

node_ahb_master(("AHB master"))
node_apb_slaves(("Four APB slaves"))

node_ahb_master -->|"sends transfers"| node_bridge
node_bridge -->|"routes transfers"| node_apb_slaves
node_apb_slaves -->|"returns read data"| node_bridge
node_bridge -->|"returns read data"| node_ahb_master

click node_bridge "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/Bridge_rtl/ahb_apb_top.v"
click node_ahb_interface "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/Bridge_rtl/ahb_if.sv"
click node_apb_interface "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/Bridge_rtl/apb_if.sv"
click node_ahb_agent "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_agent.sv"
click node_ahb_agent_top "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_agt_top.sv"
click node_ahb_config "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_config.sv"
click node_ahb_driver "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_driver.sv"
click node_ahb_monitor "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_monitor.sv"
click node_ahb_sequences "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_seqs.sv"
click node_ahb_sequencer "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_sequencer.sv"
click node_ahb_transactions "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_xtns.sv"
click node_apb_agent "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_agent.sv"
click node_apb_agent_top "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_agt_top.sv"
click node_apb_config "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_config.sv"
click node_apb_driver "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_driver.sv"
click node_apb_monitor "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_monitor.sv"
click node_apb_sequences "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_seqs.sv"
click node_apb_sequencer "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_sequencer.sv"
click node_apb_transactions "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_xtns.sv"
click node_environment "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/AHB_APB_env.sv"
click node_environment_config "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/AHB_APB_env_config.sv"
click node_scoreboard "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/scoreboard.sv"
click node_virtual_sequence "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/virtual_sequence.sv"
click node_virtual_sequencer "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/virtual_sequencer.sv"
click node_test_top "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/top.sv"
click node_test "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/test/test.sv"
click node_test_package "https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/test/APB_AHB_pkg.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_bridge,node_ahb_interface,node_apb_interface toneBlue
class node_ahb_agent,node_ahb_agent_top,node_ahb_config,node_ahb_driver,node_ahb_monitor,node_ahb_sequences,node_ahb_sequencer,node_ahb_transactions,node_apb_agent,node_apb_agent_top,node_apb_config,node_apb_driver,node_apb_monitor,node_apb_sequences,node_apb_sequencer,node_apb_transactions toneAmber
class node_environment,node_environment_config,node_scoreboard,node_virtual_sequence,node_virtual_sequencer,node_test_top,node_test,node_test_package toneMint
class node_ahb_master,node_apb_slaves toneIndigo
```

## Components

### Bridge DUT

- [AHB-APB bridge](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/Bridge_rtl/ahb_apb_top.v): `Bridge_rtl/ahb_apb_top.v`
- [AHB interface](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/Bridge_rtl/ahb_if.sv): `Bridge_rtl/ahb_if.sv`
- [APB interface](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/Bridge_rtl/apb_if.sv): `Bridge_rtl/apb_if.sv`

### Bus Agents

- [AHB agent](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_agent.sv): `AHB_agt/ahb_agent.sv`
- [AHB agent top](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_agt_top.sv): `AHB_agt/ahb_agt_top.sv`
- [AHB config](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_config.sv): `AHB_agt/ahb_config.sv`
- [AHB driver](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_driver.sv): `AHB_agt/ahb_driver.sv`
- [AHB monitor](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_monitor.sv): `AHB_agt/ahb_monitor.sv`
- [AHB sequences](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_seqs.sv): `AHB_agt/ahb_seqs.sv`
- [AHB sequencer](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_sequencer.sv): `AHB_agt/ahb_sequencer.sv`
- [AHB transactions](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/AHB_agt/ahb_xtns.sv): `AHB_agt/ahb_xtns.sv`
- [APB agent](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_agent.sv): `APB_agt/apb_agent.sv`
- [APB agent top](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_agt_top.sv): `APB_agt/apb_agt_top.sv`
- [APB config](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_config.sv): `APB_agt/apb_config.sv`
- [APB driver](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_driver.sv): `APB_agt/apb_driver.sv`
- [APB monitor](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_monitor.sv): `APB_agt/apb_monitor.sv`
- [APB sequences](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_seqs.sv): `APB_agt/apb_seqs.sv`
- [APB sequencer](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_sequencer.sv): `APB_agt/apb_sequencer.sv`
- [APB transactions](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/APB_agt/apb_xtns.sv): `APB_agt/apb_xtns.sv`

### UVM Verification

- [Verification environment](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/AHB_APB_env.sv): `tb/AHB_APB_env.sv`
- [Environment config](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/AHB_APB_env_config.sv): `tb/AHB_APB_env_config.sv`
- [Scoreboard](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/scoreboard.sv): `tb/scoreboard.sv`
- [Virtual sequence](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/virtual_sequence.sv): `tb/virtual_sequence.sv`
- [Virtual sequencer](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/virtual_sequencer.sv): `tb/virtual_sequencer.sv`
- [Testbench top](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/tb/top.sv): `tb/top.sv`
- [UVM test](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/test/test.sv): `test/test.sv`
- [Test package](https://github.com/siddhi-95/ahb-to-apb-bridge-verification/blob/main/test/APB_AHB_pkg.sv): `test/APB_AHB_pkg.sv`

### Other components

- **AHB master**
- **Four APB slaves**

## Connections

- AHB master → AHB-APB bridge: sends transfers (evidence: `README.md`)
- AHB-APB bridge → Four APB slaves: routes transfers (evidence: `README.md`)
- Four APB slaves → AHB-APB bridge: returns read data (evidence: `README.md`)
- AHB-APB bridge → AHB master: returns read data (evidence: `README.md`)
