# maaz-mk13/riscv-axi4lite-soc architecture

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

- Interactive diagram: https://gitdiagram.com/maaz-mk13/riscv-axi4lite-soc
- Repository: https://github.com/maaz-mk13/riscv-axi4lite-soc

## Overview

This tree contains generated Questa HTML coverage-report assets for an RISC-V AXI4-Lite SoC, rather than the SoC RTL itself. The principal workflow is browsing report navigation and summaries, then opening detailed design-unit, instance, source, and verification views. The report data and filenames support these capability areas; sampled JavaScript confirms frame navigation and some coverage-data processing, but does not establish every page-to-data connection.

Main entry points: [`coverage_html/scripts/sourceViewer.js`](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/sourceViewer.js) (Source viewer), [`coverage_html/scripts/summary.js`](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/summary.js) (Coverage summary), [`coverage_html/scripts/index.js`](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/index.js) (Report frame controller), [`coverage_html/scripts/testPlan.js`](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/testPlan.js) (Test-plan view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Report navigation"]
  node_index["Report frame controller<br/>[index.js]"]
  node_menu["Navigation menu<br/>[menu.js]"]
  node_routing["Shared routing<br/>[routing.js]"]
  node_toggle["View toggles<br/>[toggles.js]"]
end

subgraph group_coverage["Coverage summaries"]
  node_summary["Coverage summary<br/>[summary.js]"]
  node_overall["Overall design data<br/>[overalldu.js]"]
  node_units["Design-unit data<br/>[du.js]"]
end

subgraph group_details["Coverage details"]
  node_sourceviewer["Source viewer<br/>[sourceViewer.js]"]
  node_sourcecode["Source data<br/>[sourceCode.js]"]
  node_instances["Instance data<br/>[instlink.js]"]
  node_unitlinks["Design-unit links<br/>[dulink.js]"]
  node_statements["Statement coverage<br/>[statements.js]"]
  node_branches["Branch coverage<br/>[branches.js]"]
  node_conditions["Condition coverage<br/>[condExp.js]"]
  node_assertions["Assertion coverage"]
  node_covergroups["Covergroup coverage<br/>[cvg.js]"]
  node_bins["Coverage bins<br/>[cvgBins.js]"]
  node_block["Block coverage<br/>[blockCoverage.js]"]
  node_fsm["FSM coverage<br/>[fsm.js]"]
end

subgraph group_verification["Verification views"]
  node_testplan["Test-plan view<br/>[testPlan.js]"]
  node_testplanservice["Test-plan mapping<br/>[testPlanService.js]"]
  node_testhitdata["Test hit data<br/>[testHitdata.js]"]
  node_testrecords["Test records<br/>[testRecords.js]"]
end

node_browser(("Report user"))

node_browser -->|"opens report"| node_index
node_index -->|"forwards messages"| node_menu
node_menu -->|"requests navigation"| node_index
node_index -->|"loads view"| node_summary
node_overall -->|"processes data"| node_summary
node_units -->|"processes data"| node_summary
node_summary -->|"opens detail"| node_sourceviewer
node_sourceviewer -->|"uses source data"| node_sourcecode
node_testplan -->|"maps plan data"| node_testplanservice
node_testplan -->|"uses hit data"| node_testhitdata
node_testplan -->|"opens records"| node_testrecords
node_menu -->|"uses routing"| node_routing
node_sourceviewer -->|"opens coverage view"| node_statements
node_sourceviewer -->|"opens coverage view"| node_branches
node_sourceviewer -->|"opens coverage view"| node_conditions
node_sourceviewer -->|"opens coverage view"| node_assertions
node_sourceviewer -->|"opens coverage view"| node_covergroups
node_covergroups -->|"opens bin detail"| node_bins
node_sourceviewer -->|"opens coverage view"| node_block
node_sourceviewer -->|"opens coverage view"| node_fsm
node_toggle -->|"updates display"| node_sourceviewer
node_instances -->|"provides instance data"| node_sourceviewer
node_unitlinks -->|"provides unit links"| node_summary

click node_index "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/index.js"
click node_menu "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/menu.js"
click node_routing "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/routing.js"
click node_summary "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/summary.js"
click node_overall "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/overalldu.js"
click node_units "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/du.js"
click node_sourceviewer "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/sourceViewer.js"
click node_sourcecode "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/sourceCode.js"
click node_instances "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/instlink.js"
click node_unitlinks "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/dulink.js"
click node_statements "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/statements.js"
click node_branches "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/branches.js"
click node_conditions "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/condExp.js"
click node_assertions "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/assertionsDirectives.js"
click node_covergroups "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/cvg.js"
click node_bins "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/cvgBins.js"
click node_block "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/blockCoverage.js"
click node_testplan "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/testPlan.js"
click node_testplanservice "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/testPlanService.js"
click node_testhitdata "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/testHitdata.js"
click node_testrecords "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/testRecords.js"
click node_fsm "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/fsm.js"
click node_toggle "https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/toggles.js"

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_index,node_menu,node_routing,node_toggle,node_browser toneBlue
class node_summary,node_overall,node_units toneAmber
class node_sourceviewer,node_sourcecode,node_instances,node_unitlinks,node_statements,node_branches,node_conditions,node_assertions,node_covergroups,node_bins,node_block,node_fsm toneMint
class node_testplan,node_testplanservice,node_testhitdata,node_testrecords toneRose
```

## Components

### Report navigation

- [Report frame controller](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/index.js): `coverage_html/scripts/index.js`
- [Navigation menu](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/menu.js): `coverage_html/scripts/menu.js`
- [Shared routing](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/routing.js): `coverage_html/scripts/shared/routing.js`
- [View toggles](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/toggles.js): `coverage_html/scripts/toggles.js`

### Coverage summaries

- [Coverage summary](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/summary.js): `coverage_html/scripts/summary.js`
- [Overall design data](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/overalldu.js): `coverage_html/files/overalldu.js`
- [Design-unit data](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/du.js): `coverage_html/files/du.js`

### Coverage details

- [Source viewer](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/sourceViewer.js): `coverage_html/scripts/sourceViewer.js`
- [Source data](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/sourceCode.js): `coverage_html/scripts/shared/sourceCode.js`
- [Instance data](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/instlink.js): `coverage_html/files/instlink.js`
- [Design-unit links](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/files/dulink.js): `coverage_html/files/dulink.js`
- [Statement coverage](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/statements.js): `coverage_html/scripts/statements.js`
- [Branch coverage](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/branches.js): `coverage_html/scripts/branches.js`
- [Condition coverage](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/condExp.js): `coverage_html/scripts/condExp.js`
- [Assertion coverage](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/assertionsDirectives.js): `coverage_html/scripts/assertionsDirectives.js`
- [Covergroup coverage](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/cvg.js): `coverage_html/scripts/cvg.js`
- [Coverage bins](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/cvgBins.js): `coverage_html/scripts/cvgBins.js`
- [Block coverage](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/blockCoverage.js): `coverage_html/scripts/blockCoverage.js`
- [FSM coverage](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/fsm.js): `coverage_html/scripts/fsm.js`

### Verification views

- [Test-plan view](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/testPlan.js): `coverage_html/scripts/testPlan.js`
- [Test-plan mapping](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/testPlanService.js): `coverage_html/scripts/shared/testPlanService.js`
- [Test hit data](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/shared/testHitdata.js): `coverage_html/scripts/shared/testHitdata.js`
- [Test records](https://github.com/maaz-mk13/riscv-axi4lite-soc/blob/main/coverage_html/scripts/testRecords.js): `coverage_html/scripts/testRecords.js`

### Other components

- **Report user**

## Connections

- Report user → Report frame controller: opens report
- Report frame controller → Navigation menu: forwards messages
- Navigation menu → Report frame controller: requests navigation
- Report frame controller → Coverage summary: loads view
- Overall design data → Coverage summary: processes data
- Design-unit data → Coverage summary: processes data
- Coverage summary → Source viewer: opens detail
- Source viewer → Source data: uses source data
- Test-plan view → Test-plan mapping: maps plan data
- Test-plan view → Test hit data: uses hit data
- Test-plan view → Test records: opens records
- Navigation menu → Shared routing: uses routing
- Source viewer → Statement coverage: opens coverage view
- Source viewer → Branch coverage: opens coverage view
- Source viewer → Condition coverage: opens coverage view
- Source viewer → Assertion coverage: opens coverage view
- Source viewer → Covergroup coverage: opens coverage view
- Covergroup coverage → Coverage bins: opens bin detail
- Source viewer → Block coverage: opens coverage view
- Source viewer → FSM coverage: opens coverage view
- View toggles → Source viewer: updates display
- Instance data → Source viewer: provides instance data
- Design-unit links → Coverage summary: provides unit links