# chatpimuk07/intro-to-signals-systems-mini-project2 architecture

> Architecture diagram of the GitHub repository chatpimuk07/intro-to-signals-systems-mini-project2, 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/chatpimuk07/intro-to-signals-systems-mini-project2
- Repository: https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2

## Overview

This repository is a three-part audio-sampling and DSP lab: Tasks 1 and 2 acquire analog or I2S microphone audio on ESP32 boards, while Task 3 samples through an FPGA and relays blocks through an ESP32 bridge. The host workflow receives blocks and visualizes audio; Task 3 also offers a Python workstation, standalone viewer, and sample-rate verification. README statements support the hardware and host flows; sampled Python imports support the viewer/workstation-to-stream links. The FPGA and firmware internals were not sampled, so their documented stages are represented at subsystem level.

Main entry points: [`task3/python/fpga_stream.py`](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/fpga_stream.py) (Stream Sources and Parser), [`task3/fpga/rtl`](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/tree/main/task3/fpga/rtl) (FPGA Sampling), [`task1/task1_esp32_audio/task1_esp32_audio.ino`](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task1/task1_esp32_audio/task1_esp32_audio.ino) (Task 1 ESP32), [`task2/esp32_digital_microphone/esp32_digital_microphone.ino`](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task2/esp32_digital_microphone/esp32_digital_microphone.ino) (Task 2 ESP32)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["Audio Acquisition"]
  node_task1_mic{{"Analog Microphone"}}
  node_task1_firmware["Task 1 ESP32"]
  node_task2_mic{{"I2S Microphone"}}
  node_task2_firmware["Task 2 ESP32"]
  node_task3_mic{{"Analog Microphone"}}
end

subgraph group_fpga_transport["FPGA and Transport"]
  node_fpga_sampling["FPGA Sampling"]
  node_fpga_buffer[("Ping-Pong Buffer")]
  node_fpga_spi["SPI Frame Output<br/>[spi_slave_tx.vhd]"]
  node_esp32_bridge["ESP32 Bridge"]
  node_serial["USB Serial Link"]
  node_lut_generator["DDS Tone Table<br/>[gen_sine_lut.py]"]
end

subgraph group_host_apps["Host DSP Applications"]
  node_task1_matlab["Task 1 MATLAB<br/>[untitled.m]"]
  node_task2_matlab["Task 2 MATLAB DSP<br/>[matlab.m]"]
  node_task3_gui["DSP Workstation<br/>[task3_gui_app.py]"]
  node_task3_viewer["Live Audio Viewer<br/>[task3_viewer.py]"]
  node_rate_verify["Sample-Rate Verification"]
end

subgraph group_stream_runtime["Stream Runtime"]
  node_stream_runtime["Stream Sources and Parser<br/>[fpga_stream.py]"]
end

node_user(("Lab User"))

node_user -->|"provides audio"| node_task1_mic
node_task1_mic -->|"analog input"| node_task1_firmware
node_task1_firmware -->|"streams sample blocks"| node_task1_matlab
node_user -->|"provides audio"| node_task2_mic
node_task2_mic -->|"I2S audio"| node_task2_firmware
node_task2_firmware -->|"streams PCM blocks"| node_task2_matlab
node_user -->|"provides audio"| node_task3_mic
node_task3_mic -->|"analog input"| node_fpga_sampling
node_fpga_sampling -->|"stores samples"| node_fpga_buffer
node_fpga_buffer -->|"supplies blocks"| node_fpga_spi
node_fpga_spi -->|"streams SPI frames"| node_esp32_bridge
node_esp32_bridge -->|"forwards packets"| node_serial
node_serial -->|"delivers bytes"| node_stream_runtime
node_stream_runtime -->|"provides blocks"| node_task3_gui
node_stream_runtime -->|"provides blocks"| node_task3_viewer
node_stream_runtime -->|"provides blocks"| node_rate_verify
node_user -->|"operates workstation"| node_task3_gui
node_user -->|"views stream"| node_task3_viewer
node_user -->|"checks timing"| node_rate_verify
node_lut_generator -->|"generates DDS table"| node_fpga_sampling

click node_task1_firmware "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task1/task1_esp32_audio/task1_esp32_audio.ino"
click node_task1_matlab "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task1/matlab/untitled.m"
click node_task2_firmware "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task2/esp32_digital_microphone/esp32_digital_microphone.ino"
click node_task2_matlab "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task2/matlab/matlab.m"
click node_fpga_sampling "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/tree/main/task3/fpga/rtl"
click node_fpga_buffer "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/fpga/rtl/pingpong_buffer.vhd"
click node_fpga_spi "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/fpga/rtl/spi_slave_tx.vhd"
click node_esp32_bridge "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/esp32/task3_esp32_bridge/task3_esp32_bridge.ino"
click node_stream_runtime "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/fpga_stream.py"
click node_task3_gui "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/task3_gui_app.py"
click node_task3_viewer "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/task3_viewer.py"
click node_rate_verify "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/verify_sample_rate.py"
click node_lut_generator "https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/gen_sine_lut.py"

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_task1_mic,node_task1_firmware,node_task2_mic,node_task2_firmware,node_task3_mic,node_user toneBlue
class node_fpga_sampling,node_fpga_buffer,node_fpga_spi,node_esp32_bridge,node_serial,node_lut_generator toneAmber
class node_task1_matlab,node_task2_matlab,node_task3_gui,node_task3_viewer,node_rate_verify toneMint
class node_stream_runtime toneRose
```

## Components

### Audio Acquisition

- **Analog Microphone**
- [Task 1 ESP32](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task1/task1_esp32_audio/task1_esp32_audio.ino): `task1/task1_esp32_audio/task1_esp32_audio.ino`
- **I2S Microphone**
- [Task 2 ESP32](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task2/esp32_digital_microphone/esp32_digital_microphone.ino): `task2/esp32_digital_microphone/esp32_digital_microphone.ino`
- **Analog Microphone**

### FPGA and Transport

- [FPGA Sampling](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/tree/main/task3/fpga/rtl): `task3/fpga/rtl`
- [Ping-Pong Buffer](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/fpga/rtl/pingpong_buffer.vhd): `task3/fpga/rtl/pingpong_buffer.vhd`
- [SPI Frame Output](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/fpga/rtl/spi_slave_tx.vhd): `task3/fpga/rtl/spi_slave_tx.vhd`
- [ESP32 Bridge](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/esp32/task3_esp32_bridge/task3_esp32_bridge.ino): `task3/esp32/task3_esp32_bridge/task3_esp32_bridge.ino`
- **USB Serial Link**
- [DDS Tone Table](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/gen_sine_lut.py): `task3/python/gen_sine_lut.py`

### Host DSP Applications

- [Task 1 MATLAB](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task1/matlab/untitled.m): `task1/matlab/untitled.m`
- [Task 2 MATLAB DSP](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task2/matlab/matlab.m): `task2/matlab/matlab.m`
- [DSP Workstation](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/task3_gui_app.py): `task3/python/task3_gui_app.py`
- [Live Audio Viewer](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/task3_viewer.py): `task3/python/task3_viewer.py`
- [Sample-Rate Verification](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/verify_sample_rate.py): `task3/python/verify_sample_rate.py`

### Stream Runtime

- [Stream Sources and Parser](https://github.com/chatpimuk07/intro-to-signals-systems-mini-project2/blob/main/task3/python/fpga_stream.py): `task3/python/fpga_stream.py`

### Other components

- **Lab User**

## Connections

- Lab User → Analog Microphone: provides audio (evidence: `README.md`)
- Analog Microphone → Task 1 ESP32: analog input (evidence: `README.md`)
- Task 1 ESP32 → Task 1 MATLAB: streams sample blocks (evidence: `README.md`)
- Lab User → I2S Microphone: provides audio (evidence: `README.md`)
- I2S Microphone → Task 2 ESP32: I2S audio (evidence: `README.md`)
- Task 2 ESP32 → Task 2 MATLAB DSP: streams PCM blocks (evidence: `README.md`)
- Lab User → Analog Microphone: provides audio (evidence: `README.md`)
- Analog Microphone → FPGA Sampling: analog input (evidence: `README.md`)
- FPGA Sampling → Ping-Pong Buffer: stores samples (evidence: `README.md`)
- Ping-Pong Buffer → SPI Frame Output: supplies blocks (evidence: `README.md`)
- SPI Frame Output → ESP32 Bridge: streams SPI frames (evidence: `README.md`)
- ESP32 Bridge → USB Serial Link: forwards packets (evidence: `README.md`)
- USB Serial Link → Stream Sources and Parser: delivers bytes (evidence: `task3/python/fpga_stream.py`)
- Stream Sources and Parser → DSP Workstation: provides blocks (evidence: `task3/python/task3_gui_app.py`)
- Stream Sources and Parser → Live Audio Viewer: provides blocks (evidence: `task3/python/task3_viewer.py`)
- Stream Sources and Parser → Sample-Rate Verification: provides blocks (evidence: `task3/python/verify_sample_rate.py`)
- Lab User → DSP Workstation: operates workstation (evidence: `README.md`)
- Lab User → Live Audio Viewer: views stream (evidence: `task3/python/task3_viewer.py`)
- Lab User → Sample-Rate Verification: checks timing (evidence: `task3/python/verify_sample_rate.py`)
- DDS Tone Table → FPGA Sampling: generates DDS table (evidence: `task3/python/gen_sine_lut.py`)
