# raddyn/vhdl-de1-semestral-project-pwm-sound-generator architecture

> Architecture diagram of the GitHub repository raddyn/vhdl-de1-semestral-project-pwm-sound-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator
- Repository: https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator

## Overview

This is a Nexys A7 VHDL PWM sound-generator design. Users adjust frequency or duty with the rotary encoder and buttons, choose the active parameter with a switch, and view values on a seven-segment display; the design also generates a PWM output. The README documents the top-level wiring and these capabilities, but no source excerpts were provided, so internal connections beyond those explicit descriptions are omitted.

Main entry points: [`Design sources/top_level.vhd`](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/top_level.vhd) (Top-Level Wiring), [`Design sources/encoder.vhd`](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/encoder.vhd) (Rotary Encoder), [`Design sources/debounce.vhd`](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/debounce.vhd) (Button Debounce), [`Design sources/frequency.vhd`](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/frequency.vhd) (Frequency Setting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["User Controls"]
  node_switches["Mode Switch"]
  node_encoder["Rotary Encoder<br/>[encoder.vhd]"]
  node_debounce["Button Debounce<br/>[debounce.vhd]"]
  node_mode["Mode Selector<br/>[mode_selector.vhd]"]
end

subgraph group_values["Signal Settings"]
  node_frequency["Frequency Setting<br/>[frequency.vhd]"]
  node_duty["Duty Setting<br/>[duty.vhd]"]
  node_frequency_helper["Frequency Logic<br/>[frequency.vhd]"]
end

subgraph group_output["PWM and Display"]
  node_pwm["PWM Generation<br/>[pwm_module.vhd]"]
  node_pwmv2["PWM Variant<br/>[pwmV2.vhd]"]
  node_display["Seven-Segment Display<br/>[x7seg.vhd]"]
  node_segments["Digit Encoding<br/>[bin2seg.vhd]"]
end

subgraph group_timing["Timing and Interface"]
  node_top["Top-Level Wiring<br/>[top_level.vhd]"]
  node_clock["Clock Source<br/>[clock.vhd]"]
  node_clock_enable["Clock Enable<br/>[clock_enable.vhd]"]
  node_counter["Counter<br/>[counter.vhd]"]
end

node_user(("Operator"))
node_audio(("PWM-Driven Device"))

node_user -->|"turns"| node_encoder
node_user -->|"presses buttons"| node_debounce
node_user -->|"selects mode"| node_switches
node_encoder -->|"adjusts"| node_frequency
node_encoder -->|"adjusts"| node_duty
node_debounce -.->|"button input"| node_frequency
node_debounce -.->|"button input"| node_duty
node_top -->|"wires"| node_mode
node_top -->|"wires"| node_frequency
node_top -->|"wires"| node_duty
node_top -.->|"wires"| node_pwm
node_top -->|"wires"| node_display
node_mode -->|"selects display data"| node_display
node_pwm -.->|"drives"| node_audio

click node_encoder "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/encoder.vhd"
click node_debounce "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/debounce.vhd"
click node_top "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/top_level.vhd"
click node_mode "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/mode_selector.vhd"
click node_frequency "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/frequency.vhd"
click node_duty "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/duty.vhd"
click node_pwm "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/pwm_module.vhd"
click node_pwmv2 "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/pwmV2.vhd"
click node_display "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/x7seg.vhd"
click node_segments "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/bin2seg.vhd"
click node_clock "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/clock.vhd"
click node_clock_enable "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/clock_enable.vhd"
click node_counter "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/counter.vhd"
click node_frequency_helper "https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/frequency.vhd"

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_switches,node_encoder,node_debounce,node_mode toneBlue
class node_frequency,node_duty,node_frequency_helper toneAmber
class node_pwm,node_pwmv2,node_display,node_segments toneMint
class node_top,node_clock,node_clock_enable,node_counter toneRose
class node_user,node_audio toneIndigo
```

## Components

### User Controls

- **Mode Switch**
- [Rotary Encoder](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/encoder.vhd): `Design sources/encoder.vhd`
- [Button Debounce](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/debounce.vhd): `Design sources/debounce.vhd`
- [Mode Selector](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/mode_selector.vhd): `Design sources/mode_selector.vhd`

### Signal Settings

- [Frequency Setting](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/frequency.vhd): `Design sources/frequency.vhd`
- [Duty Setting](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/duty.vhd): `Design sources/duty.vhd`
- [Frequency Logic](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/frequency.vhd): `Design sources/frequency.vhd`

### PWM and Display

- [PWM Generation](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/pwm_module.vhd): `Design sources/pwm_module.vhd`
- [PWM Variant](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/pwmV2.vhd): `Design sources/pwmV2.vhd`
- [Seven-Segment Display](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/x7seg.vhd): `Design sources/x7seg.vhd`
- [Digit Encoding](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/bin2seg.vhd): `Design sources/bin2seg.vhd`

### Timing and Interface

- [Top-Level Wiring](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/top_level.vhd): `Design sources/top_level.vhd`
- [Clock Source](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/clock.vhd): `Design sources/clock.vhd`
- [Clock Enable](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/clock_enable.vhd): `Design sources/clock_enable.vhd`
- [Counter](https://github.com/raddyn/vhdl-de1-semestral-project-pwm-sound-generator/blob/main/Design%20sources/counter.vhd): `Design sources/counter.vhd`

### Other components

- **Operator**
- **PWM-Driven Device**

## Connections

- Operator → Rotary Encoder: turns (evidence: `README.md`)
- Operator → Button Debounce: presses buttons (evidence: `README.md`)
- Operator → Mode Switch: selects mode (evidence: `README.md`)
- Rotary Encoder → Frequency Setting: adjusts (evidence: `README.md`)
- Rotary Encoder → Duty Setting: adjusts (evidence: `README.md`)
- Button Debounce → Frequency Setting: button input
- Button Debounce → Duty Setting: button input
- Top-Level Wiring → Mode Selector: wires (evidence: `README.md`)
- Top-Level Wiring → Frequency Setting: wires (evidence: `README.md`)
- Top-Level Wiring → Duty Setting: wires (evidence: `README.md`)
- Top-Level Wiring → PWM Generation: wires
- Top-Level Wiring → Seven-Segment Display: wires (evidence: `README.md`)
- Mode Selector → Seven-Segment Display: selects display data (evidence: `README.md`)
- PWM Generation → PWM-Driven Device: drives
