# lyusupov/adsb-out architecture

> Architecture diagram of the GitHub repository lyusupov/adsb-out, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lyusupov/adsb-out
- Repository: https://github.com/lyusupov/adsb-out

## Overview

This is a compact command-line ADS-B Out encoder: it accepts an ICAO address and position, constructs ADS-B messages, modulates them into samples, and writes a raw IQ file for external SDR transmission. The README also documents buffer alignment and air transmission with HackRF, plus receiver-side validation with dump1090. The single source file excerpt shows encoding and output stages; finer internal call relationships are omitted where the excerpt does not establish them.

Main entry points: [`ADSB_Encoder.py`](https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py) (CLI arguments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_encoding["ADS-B encoding"]
  node_cli["CLI arguments<br/>[ADSB_Encoder.py]"]
  node_message["DF17 messages<br/>[ADSB_Encoder.py]"]
end

subgraph group_signal["Signal generation"]
  node_modulate["PPM modulation<br/>[ADSB_Encoder.py]"]
  node_iq["Raw IQ samples<br/>[ADSB_Encoder.py]"]
  node_file["Samples.iq8s"]
  node_align["Buffer alignment"]
end

node_operator(("Operator"))
node_hackrf["HackRF transmitter"]
node_dump["dump1090 receiver"]

node_operator -->|"provides inputs"| node_cli
node_cli -->|"builds frames"| node_message
node_message -->|"modulates frames"| node_modulate
node_modulate -->|"converts to IQ"| node_iq
node_iq -->|"writes samples"| node_file
node_file -->|"aligns buffer"| node_align
node_align -->|"transmits samples"| node_hackrf
node_hackrf -.->|"validates over air"| node_dump

click node_cli "https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py"
click node_message "https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py"
click node_modulate "https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py"
click node_iq "https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.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_cli,node_message toneBlue
class node_modulate,node_iq,node_file,node_align toneAmber
class node_operator,node_hackrf,node_dump toneIndigo
```

## Components

### ADS-B encoding

- [CLI arguments](https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py): `ADSB_Encoder.py`
- [DF17 messages](https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py): `ADSB_Encoder.py`

### Signal generation

- [PPM modulation](https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py): `ADSB_Encoder.py`
- [Raw IQ samples](https://github.com/lyusupov/adsb-out/blob/master/ADSB_Encoder.py): `ADSB_Encoder.py`
- **Samples.iq8s**
- **Buffer alignment**

### Other components

- **Operator**
- **HackRF transmitter**
- **dump1090 receiver**

## Connections

- Operator → CLI arguments: provides inputs (evidence: `README.md`)
- CLI arguments → DF17 messages: builds frames (evidence: `ADSB_Encoder.py`)
- DF17 messages → PPM modulation: modulates frames (evidence: `ADSB_Encoder.py`)
- PPM modulation → Raw IQ samples: converts to IQ (evidence: `ADSB_Encoder.py`)
- Raw IQ samples → Samples.iq8s: writes samples (evidence: `ADSB_Encoder.py`)
- Samples.iq8s → Buffer alignment: aligns buffer (evidence: `README.md`)
- Buffer alignment → HackRF transmitter: transmits samples (evidence: `README.md`)
- HackRF transmitter → dump1090 receiver: validates over air (evidence: `README.md`)
