# kalikibhuvanesh/know-knowledge architecture

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

- Interactive diagram: https://gitdiagram.com/kalikibhuvanesh/know-knowledge
- Repository: https://github.com/kalikibhuvanesh/know-knowledge

## Overview

This is an FPGA power-governor implementation with a Vitis demo application. The documented workflow is to configure the memory-mapped registers, run workload and thermal scenarios, then read and print status. The file tree names the hardware controller, activity monitor, and register file, but their source and interconnections were not sampled; those links are therefore omitted.

Main entry points: [`pwrgov_main.c`](https://github.com/kalikibhuvanesh/know-knowledge/blob/main/pwrgov_main.c) (Demo application), [`pwrgov_top.v`](https://github.com/kalikibhuvanesh/know-knowledge/blob/main/pwrgov_top.v) (Governor top)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_software["Software demo"]
  node_app["Demo application<br/>[pwrgov_main.c]"]
end

subgraph group_hardware["FPGA hardware"]
  node_top["Governor top<br/>[pwrgov_top.v]"]
  node_fsm["FSM controller<br/>[fsm_controller.v]"]
  node_monitor["Activity monitor<br/>[activity_monitor.v]"]
  node_registers["Register file<br/>[register_file.v]"]
end

node_app -->|"writes configuration"| node_top
node_top -->|"returns status"| node_app

click node_app "https://github.com/kalikibhuvanesh/know-knowledge/blob/main/pwrgov_main.c"
click node_top "https://github.com/kalikibhuvanesh/know-knowledge/blob/main/pwrgov_top.v"
click node_fsm "https://github.com/kalikibhuvanesh/know-knowledge/blob/main/fsm_controller.v"
click node_monitor "https://github.com/kalikibhuvanesh/know-knowledge/blob/main/activity_monitor.v"
click node_registers "https://github.com/kalikibhuvanesh/know-knowledge/blob/main/register_file.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_app toneBlue
class node_top,node_fsm,node_monitor,node_registers toneAmber
```

## Components

### Software demo

- [Demo application](https://github.com/kalikibhuvanesh/know-knowledge/blob/main/pwrgov_main.c): `pwrgov_main.c`

### FPGA hardware

- [Governor top](https://github.com/kalikibhuvanesh/know-knowledge/blob/main/pwrgov_top.v): `pwrgov_top.v`
- [FSM controller](https://github.com/kalikibhuvanesh/know-knowledge/blob/main/fsm_controller.v): `fsm_controller.v`
- [Activity monitor](https://github.com/kalikibhuvanesh/know-knowledge/blob/main/activity_monitor.v): `activity_monitor.v`
- [Register file](https://github.com/kalikibhuvanesh/know-knowledge/blob/main/register_file.v): `register_file.v`

## Connections

- Demo application → Governor top: writes configuration
- Governor top → Demo application: returns status