# jose-otero-m/qpsk-baseband-tx-basys3 architecture

> Architecture diagram of the GitHub repository jose-otero-m/qpsk-baseband-tx-basys3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jose-otero-m/qpsk-baseband-tx-basys3
- Repository: https://github.com/jose-otero-m/qpsk-baseband-tx-basys3

## Overview

This repository appears to implement a QPSK baseband transmitter in RTL. Its named modules cover symbol input, QPSK mapping and pulse-shaping-related logic, plus an NCO and a top-level transmitter. The tree also includes coefficient memory. No README or source excerpts were provided, so module responsibilities are inferred from filenames only; relationships between modules and the runtime workflow cannot be verified and are omitted.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tx_control["Transmit control"]
  node_top_tx["Baseband TX top"]
  node_nco["Overflow NCO"]
end

subgraph group_signal_path["Signal processing"]
  node_sipo_sampler["SIPO QPSK sampler"]
  node_sipo["2-bit SIPO<br/>[sipo_2bit.v]"]
  node_mapper["QPSK mapper<br/>[qpsk_mapper.v]"]
  node_zero_stuffer["I/Q zero stuffer<br/>[iq_zero_stuffer.v]"]
  node_fir["FIR filter<br/>[fir.v]"]
  node_delay_line["Word delay line"]
end

subgraph group_coefficients["Coefficient data"]
  node_rrc_taps["RRC tap memory"]
end

click node_top_tx "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/top_QPSK_baseband_tx.v"
click node_nco "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/NCO_stb_on_overflow.v"
click node_sipo_sampler "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/SIPO_sampler_and_QPSK.v"
click node_sipo "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/sipo_2bit.v"
click node_mapper "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/qpsk_mapper.v"
click node_zero_stuffer "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/iq_zero_stuffer.v"
click node_fir "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/fir.v"
click node_delay_line "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/delay_line_M_words_N_bits.v"
click node_rrc_taps "https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/rrc_taps_q15_energy.mem"

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_top_tx,node_nco toneBlue
class node_sipo_sampler,node_sipo,node_mapper,node_zero_stuffer,node_fir,node_delay_line toneAmber
class node_rrc_taps toneMint
```

## Components

### Transmit control

- [Baseband TX top](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/top_QPSK_baseband_tx.v): `qpsk_tx/rtl/top_QPSK_baseband_tx.v`
- [Overflow NCO](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/NCO_stb_on_overflow.v): `qpsk_tx/rtl/NCO_stb_on_overflow.v`

### Signal processing

- [SIPO QPSK sampler](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/SIPO_sampler_and_QPSK.v): `qpsk_tx/rtl/SIPO_sampler_and_QPSK.v`
- [2-bit SIPO](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/sipo_2bit.v): `qpsk_tx/rtl/sipo_2bit.v`
- [QPSK mapper](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/qpsk_mapper.v): `qpsk_tx/rtl/qpsk_mapper.v`
- [I/Q zero stuffer](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/iq_zero_stuffer.v): `qpsk_tx/rtl/iq_zero_stuffer.v`
- [FIR filter](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/fir.v): `qpsk_tx/rtl/fir.v`
- [Word delay line](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/delay_line_M_words_N_bits.v): `qpsk_tx/rtl/delay_line_M_words_N_bits.v`

### Coefficient data

- [RRC tap memory](https://github.com/jose-otero-m/qpsk-baseband-tx-basys3/blob/main/qpsk_tx/rtl/rrc_taps_q15_energy.mem): `qpsk_tx/rtl/rrc_taps_q15_energy.mem`
