# cs231-dldca-lab/cs231-2026 architecture

> Architecture diagram of the GitHub repository cs231-dldca-lab/cs231-2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cs231-dldca-lab/cs231-2026
- Repository: https://github.com/cs231-dldca-lab/cs231-2026

## Overview

This repository is a CS231 lab course workspace, not a single application: students work through weekly in-lab and out-lab exercises, primarily in Verilog, then assembly and performance measurement, with Champ-Sim named in the schedule. The useful workflow is a student completing a lab task and obtaining a result from its hardware simulation, assembly program, or timing experiment. The graph groups the substantial exercise areas and includes the interactive switch lab’s documented test-generation/autograding path. Source excerpts are sparse, so links among unsampled exercises are omitted rather than inferred.

Main entry points: [`03_outlab/task5/interactive_tester.py`](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5/interactive_tester.py) (Test generator and grader), [`07_inlab/task4/matmul.c`](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task4/matmul.c) (Matrix benchmark), [`07_inlab/task5/chrono_demo.cpp`](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task5/chrono_demo.cpp) (Timer experiment), [`07_inlab/task7/dotprod.cpp`](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task7/dotprod.cpp) (Dot product timing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_verilog["Verilog labs"]
  node_intro["Setup exercises"]
  node_verilog_in["Verilog in-labs"]
  node_verilog_out["Verilog out-labs"]
  node_fsm_crc_in["FSM and CRC labs"]
  node_protocol_out["Protocol labs"]
  node_crc_checker["CRC verifier<br/>[verify_task3.py]"]
end

subgraph group_assembly["Assembly labs"]
  node_assembly_in["Assembly in-labs"]
  node_assembly_out["Assembly out-labs"]
  node_calling["Calling conventions"]
  node_assembly_more["Assembly exercises"]
  node_assembly_advanced["Advanced assembly"]
end

subgraph group_performance["Performance labs"]
  node_perf_in["Performance exercises"]
  node_perf_out["Performance out-labs"]
  node_matrix["Matrix benchmark<br/>[matmul.c]"]
  node_chrono["Timer experiment<br/>[chrono_demo.cpp]"]
  node_dotprod["Dot product timing<br/>[dotprod.cpp]"]
  node_dotprod_solution["Corrected timing"]
end

subgraph group_switchsim["Champ-Sim labs"]
  node_switch_tasks["Switch assignment"]
  node_tester["Test generator and grader"]
  node_command_file["Command input<br/>[input.txt]"]
  node_testbench["Verilog testbench<br/>[tb_task5.v]"]
  node_simlog["Simulation log<br/>[task5_output.txt]"]
end

node_student(("Student"))
node_clock["Timing runtime"]

node_student -->|"works through"| node_intro
node_student -->|"works through"| node_verilog_in
node_student -->|"works through"| node_verilog_out
node_student -->|"works through"| node_fsm_crc_in
node_student -->|"works through"| node_protocol_out
node_student -->|"works through"| node_assembly_in
node_student -->|"works through"| node_assembly_out
node_student -->|"works through"| node_calling
node_student -->|"works through"| node_assembly_more
node_student -->|"works through"| node_assembly_advanced
node_student -->|"works through"| node_perf_in
node_student -->|"works through"| node_perf_out
node_student -->|"works through"| node_switch_tasks
node_student -->|"runs"| node_tester
node_tester -->|"reads"| node_command_file
node_tester -->|"updates"| node_testbench
node_tester -->|"checks"| node_simlog
node_tester -.->|"tests"| node_switch_tasks
node_student -->|"runs"| node_matrix
node_matrix -->|"measures with"| node_clock
node_student -->|"runs"| node_chrono
node_chrono -->|"measures with"| node_clock
node_student -->|"runs"| node_dotprod
node_dotprod -->|"measures with"| node_clock
node_student -->|"runs"| node_dotprod_solution
node_dotprod_solution -->|"measures with"| node_clock
node_student -->|"runs"| node_crc_checker

click node_intro "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/00_inlab"
click node_verilog_in "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/01_inlab"
click node_verilog_out "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/01_outlab"
click node_fsm_crc_in "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/03_inlab"
click node_protocol_out "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/03_outlab"
click node_assembly_in "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/04_inlab"
click node_assembly_out "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/04_outlab"
click node_calling "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/05_inlab"
click node_assembly_more "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/05_outlab"
click node_assembly_advanced "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/06_inlab"
click node_perf_in "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/07_inlab"
click node_matrix "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task4/matmul.c"
click node_chrono "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task5/chrono_demo.cpp"
click node_dotprod "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task7/dotprod.cpp"
click node_dotprod_solution "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task7/dotprod_solution.cpp"
click node_switch_tasks "https://github.com/cs231-dldca-lab/cs231-2026/tree/main/03_outlab/task5"
click node_tester "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5/interactive_tester.py"
click node_command_file "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5/input.txt"
click node_testbench "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5/tb_task5.v"
click node_simlog "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5_output.txt"
click node_crc_checker "https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task3/verify_task3.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_intro,node_verilog_in,node_verilog_out,node_fsm_crc_in,node_protocol_out,node_crc_checker toneBlue
class node_assembly_in,node_assembly_out,node_calling,node_assembly_more,node_assembly_advanced toneAmber
class node_perf_in,node_perf_out,node_matrix,node_chrono,node_dotprod,node_dotprod_solution toneMint
class node_switch_tasks,node_tester,node_command_file,node_testbench,node_simlog toneRose
class node_student,node_clock toneIndigo
```

## Components

### Verilog labs

- [Setup exercises](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/00_inlab): `00_inlab`
- [Verilog in-labs](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/01_inlab): `01_inlab`
- [Verilog out-labs](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/01_outlab): `01_outlab`
- [FSM and CRC labs](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/03_inlab): `03_inlab`
- [Protocol labs](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/03_outlab): `03_outlab`
- [CRC verifier](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task3/verify_task3.py): `03_outlab/task3/verify_task3.py`

### Assembly labs

- [Assembly in-labs](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/04_inlab): `04_inlab`
- [Assembly out-labs](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/04_outlab): `04_outlab`
- [Calling conventions](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/05_inlab): `05_inlab`
- [Assembly exercises](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/05_outlab): `05_outlab`
- [Advanced assembly](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/06_inlab): `06_inlab`

### Performance labs

- [Performance exercises](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/07_inlab): `07_inlab`
- **Performance out-labs**
- [Matrix benchmark](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task4/matmul.c): `07_inlab/task4/matmul.c`
- [Timer experiment](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task5/chrono_demo.cpp): `07_inlab/task5/chrono_demo.cpp`
- [Dot product timing](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task7/dotprod.cpp): `07_inlab/task7/dotprod.cpp`
- [Corrected timing](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/07_inlab/task7/dotprod_solution.cpp): `07_inlab/task7/dotprod_solution.cpp`

### Champ-Sim labs

- [Switch assignment](https://github.com/cs231-dldca-lab/cs231-2026/tree/main/03_outlab/task5): `03_outlab/task5`
- [Test generator and grader](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5/interactive_tester.py): `03_outlab/task5/interactive_tester.py`
- [Command input](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5/input.txt): `03_outlab/task5/input.txt`
- [Verilog testbench](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5/tb_task5.v): `03_outlab/task5/tb_task5.v`
- [Simulation log](https://github.com/cs231-dldca-lab/cs231-2026/blob/main/03_outlab/task5_output.txt): `03_outlab/task5_output.txt`

### Other components

- **Student**
- **Timing runtime**

## Connections

- Student → Setup exercises: works through (evidence: `README.md`)
- Student → Verilog in-labs: works through (evidence: `README.md`)
- Student → Verilog out-labs: works through (evidence: `README.md`)
- Student → FSM and CRC labs: works through (evidence: `README.md`)
- Student → Protocol labs: works through (evidence: `README.md`)
- Student → Assembly in-labs: works through (evidence: `README.md`)
- Student → Assembly out-labs: works through (evidence: `README.md`)
- Student → Calling conventions: works through (evidence: `README.md`)
- Student → Assembly exercises: works through (evidence: `README.md`)
- Student → Advanced assembly: works through (evidence: `README.md`)
- Student → Performance exercises: works through (evidence: `README.md`)
- Student → Performance out-labs: works through (evidence: `README.md`)
- Student → Switch assignment: works through (evidence: `README.md`)
- Student → Test generator and grader: runs (evidence: `03_outlab/task5/interactive_tester.py`)
- Test generator and grader → Command input: reads (evidence: `03_outlab/task5/interactive_tester.py`)
- Test generator and grader → Verilog testbench: updates (evidence: `03_outlab/task5/interactive_tester.py`)
- Test generator and grader → Simulation log: checks (evidence: `03_outlab/task5/interactive_tester.py`)
- Test generator and grader → Switch assignment: tests
- Student → Matrix benchmark: runs (evidence: `07_inlab/task4/matmul.c`)
- Matrix benchmark → Timing runtime: measures with (evidence: `07_inlab/task4/matmul.c`)
- Student → Timer experiment: runs (evidence: `07_inlab/task5/chrono_demo.cpp`)
- Timer experiment → Timing runtime: measures with (evidence: `07_inlab/task5/chrono_demo.cpp`)
- Student → Dot product timing: runs (evidence: `07_inlab/task7/dotprod.cpp`)
- Dot product timing → Timing runtime: measures with (evidence: `07_inlab/task7/dotprod.cpp`)
- Student → Corrected timing: runs (evidence: `07_inlab/task7/dotprod_solution.cpp`)
- Corrected timing → Timing runtime: measures with (evidence: `07_inlab/task7/dotprod_solution.cpp`)
- Student → CRC verifier: runs (evidence: `03_outlab/task3/verify_task3.py`)
