# youssef-fd/fifo-verification-with-uvm architecture

> Architecture diagram of the GitHub repository youssef-fd/fifo-verification-with-uvm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/youssef-fd/fifo-verification-with-uvm
- Repository: https://github.com/youssef-fd/fifo-verification-with-uvm

## Overview

This repository combines a synchronous FIFO design with a UVM verification environment. The workflow starts at the testbench, whose selected test chooses random, overflow, or underflow stimulus; transactions pass through the sequencer and driver to the FIFO pins, while the monitor reports observed activity to the scoreboard for checking against a software reference queue. The README documents the main connections and test scenarios; source excerpts were not available, so the graph does not assert implementation details beyond those documented relationships.

Main entry points: [`uvm/sequence/fifo_sequence.sv`](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/sequence/fifo_sequence.sv) (Sequences), [`uvm/agent/fifo_agent.sv`](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/agent/fifo_agent.sv) (FIFO agent), [`uvm/scoreboard/fifo_scoreboard.sv`](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/scoreboard/fifo_scoreboard.sv) (Scoreboard), [`uvm/env/fifo_env.sv`](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/env/fifo_env.sv) (UVM environment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["FIFO design"]
  node_fifo["FIFO DUT<br/>[FIFO.sv]"]
  node_interface["FIFO interface<br/>[fifo_if.sv]"]
end

subgraph group_stimulus["Test scenarios"]
  node_random_test["Random test<br/>[fifo_test.sv]"]
  node_overflow_test["Overflow test"]
  node_underflow_test["Underflow test"]
  node_sequence["Sequences<br/>[fifo_sequence.sv]"]
  node_transaction["Transaction"]
end

subgraph group_execution["UVM execution"]
  node_testbench["Testbench<br/>[Testbench.sv]"]
  node_environment["UVM environment<br/>[fifo_env.sv]"]
  node_agent["FIFO agent<br/>[fifo_agent.sv]"]
  node_sequencer["Sequencer<br/>[fifo_sequencer.sv]"]
  node_driver["Driver<br/>[fifo_driver.sv]"]
end

subgraph group_checking["Observation and checking"]
  node_monitor["Monitor<br/>[fifo_monitor.sv]"]
  node_scoreboard["Scoreboard<br/>[fifo_scoreboard.sv]"]
  node_reference_queue[("Reference queue<br/>[fifo_scoreboard.sv]")]
end

node_testbench -->|"instantiates"| node_fifo
node_testbench -->|"selects test"| node_random_test
node_random_test -->|"runs sequence"| node_sequence
node_overflow_test -->|"runs sequence"| node_sequence
node_underflow_test -->|"runs sequence"| node_sequence
node_sequence -->|"generates"| node_transaction
node_sequence -->|"supplies transactions"| node_sequencer
node_sequencer -->|"feeds transactions"| node_driver
node_driver -->|"drives pins"| node_interface
node_interface -->|"carries signals"| node_fifo
node_environment -->|"instantiates"| node_agent
node_environment -->|"instantiates"| node_scoreboard
node_agent -->|"bundles"| node_sequencer
node_agent -->|"bundles"| node_driver
node_agent -->|"bundles"| node_monitor
node_monitor -->|"samples pins"| node_interface
node_environment -->|"connects monitor output"| node_scoreboard
node_scoreboard -->|"updates model"| node_reference_queue
node_scoreboard -->|"checks expected data"| node_reference_queue

click node_testbench "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/tb/Testbench.sv"
click node_fifo "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/rtl/FIFO.sv"
click node_interface "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/fifo_if.sv"
click node_random_test "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/tests/fifo_test.sv"
click node_overflow_test "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/tests/fifo_overflow_test.sv"
click node_underflow_test "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/tests/fifo_underflow_test.sv"
click node_sequence "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/sequence/fifo_sequence.sv"
click node_transaction "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/sequence/fifo_transaction.sv"
click node_environment "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/env/fifo_env.sv"
click node_agent "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/agent/fifo_agent.sv"
click node_sequencer "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/sequence/fifo_sequencer.sv"
click node_driver "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/driver/fifo_driver.sv"
click node_monitor "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/monitor/fifo_monitor.sv"
click node_scoreboard "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/scoreboard/fifo_scoreboard.sv"
click node_reference_queue "https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/scoreboard/fifo_scoreboard.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_fifo,node_interface toneBlue
class node_random_test,node_overflow_test,node_underflow_test,node_sequence,node_transaction toneAmber
class node_testbench,node_environment,node_agent,node_sequencer,node_driver toneMint
class node_monitor,node_scoreboard,node_reference_queue toneRose
```

## Components

### FIFO design

- [FIFO DUT](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/rtl/FIFO.sv): `rtl/FIFO.sv`
- [FIFO interface](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/fifo_if.sv): `uvm/fifo_if.sv`

### Test scenarios

- [Random test](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/tests/fifo_test.sv): `uvm/tests/fifo_test.sv`
- [Overflow test](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/tests/fifo_overflow_test.sv): `uvm/tests/fifo_overflow_test.sv`
- [Underflow test](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/tests/fifo_underflow_test.sv): `uvm/tests/fifo_underflow_test.sv`
- [Sequences](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/sequence/fifo_sequence.sv): `uvm/sequence/fifo_sequence.sv`
- [Transaction](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/sequence/fifo_transaction.sv): `uvm/sequence/fifo_transaction.sv`

### UVM execution

- [Testbench](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/tb/Testbench.sv): `tb/Testbench.sv`
- [UVM environment](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/env/fifo_env.sv): `uvm/env/fifo_env.sv`
- [FIFO agent](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/agent/fifo_agent.sv): `uvm/agent/fifo_agent.sv`
- [Sequencer](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/sequence/fifo_sequencer.sv): `uvm/sequence/fifo_sequencer.sv`
- [Driver](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/driver/fifo_driver.sv): `uvm/driver/fifo_driver.sv`

### Observation and checking

- [Monitor](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/monitor/fifo_monitor.sv): `uvm/monitor/fifo_monitor.sv`
- [Scoreboard](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/scoreboard/fifo_scoreboard.sv): `uvm/scoreboard/fifo_scoreboard.sv`
- [Reference queue](https://github.com/youssef-fd/fifo-verification-with-uvm/blob/main/uvm/scoreboard/fifo_scoreboard.sv): `uvm/scoreboard/fifo_scoreboard.sv`

## Connections

- Testbench → FIFO DUT: instantiates (evidence: `README.md`)
- Testbench → Random test: selects test (evidence: `README.md`)
- Random test → Sequences: runs sequence (evidence: `README.md`)
- Overflow test → Sequences: runs sequence (evidence: `README.md`)
- Underflow test → Sequences: runs sequence (evidence: `README.md`)
- Sequences → Transaction: generates (evidence: `README.md`)
- Sequences → Sequencer: supplies transactions (evidence: `README.md`)
- Sequencer → Driver: feeds transactions (evidence: `README.md`)
- Driver → FIFO interface: drives pins (evidence: `README.md`)
- FIFO interface → FIFO DUT: carries signals (evidence: `README.md`)
- UVM environment → FIFO agent: instantiates (evidence: `README.md`)
- UVM environment → Scoreboard: instantiates (evidence: `README.md`)
- FIFO agent → Sequencer: bundles (evidence: `README.md`)
- FIFO agent → Driver: bundles (evidence: `README.md`)
- FIFO agent → Monitor: bundles (evidence: `README.md`)
- Monitor → FIFO interface: samples pins (evidence: `README.md`)
- UVM environment → Scoreboard: connects monitor output (evidence: `README.md`)
- Scoreboard → Reference queue: updates model (evidence: `README.md`)
- Scoreboard → Reference queue: checks expected data (evidence: `README.md`)
