# stevee87/radar-project-uconsole architecture

> Architecture diagram of the GitHub repository stevee87/radar-project-uconsole, 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/stevee87/radar-project-uconsole
- Repository: https://github.com/stevee87/radar-project-uconsole

## Overview

This is a standalone radar-display and sonification system: the RD-03D feeds an ESP32-S3 transmitter, which clusters targets and broadcasts them over its hosted Wi-Fi access point; a Linux/uConsole receiver then displays and sonifies the stream. The receiver excerpt shows packet handling, target smoothing, connection-loss clearing, and the display/audio loop. Transmitter internals are unsampled, so its processing details are based on README documentation.

Main entry points: [`Firmware/uconsole_radar_receiver.py`](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py) (uConsole receiver), [`Firmware/rd03d_xiao_s3_transmitter.ino`](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino) (XIAO transmitter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_transmitter["Radar transmitter"]
  node_xiao["XIAO transmitter"]
  node_target_cluster["Target clustering"]
  node_wifi_ap["Wi-Fi access point"]
  node_udp_broadcast["UDP broadcast"]
end

subgraph group_receiver["uConsole receiver"]
  node_receiver["uConsole receiver"]
  node_packet_decode["Packet decoding"]
  node_target_state["Target tracking"]
end

subgraph group_presentation["Display and audio"]
  node_audio["Sonar synthesis"]
  node_radar_display["Radar display"]
end

node_radar["RD-03D radar"]
node_operator(("Operator"))

node_radar -->|"UART data"| node_xiao
node_xiao -->|"clusters targets"| node_target_cluster
node_target_cluster -->|"sends stream"| node_wifi_ap
node_wifi_ap -->|"broadcasts over"| node_udp_broadcast
node_udp_broadcast -->|"UDP stream"| node_receiver
node_receiver -->|"receives packets"| node_packet_decode
node_packet_decode -->|"updates targets"| node_target_state
node_receiver -->|"synthesizes pings"| node_audio
node_receiver -->|"draws scope"| node_radar_display
node_target_state -->|"renders smoothed targets"| node_radar_display
node_operator -->|"views"| node_radar_display
node_operator -->|"hears"| node_audio

click node_xiao "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino"
click node_target_cluster "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino"
click node_wifi_ap "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino"
click node_udp_broadcast "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino"
click node_receiver "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py"
click node_packet_decode "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py"
click node_target_state "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py"
click node_audio "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py"
click node_radar_display "https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.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_xiao,node_target_cluster,node_wifi_ap,node_udp_broadcast toneBlue
class node_receiver,node_packet_decode,node_target_state toneAmber
class node_audio,node_radar_display toneMint
class node_radar,node_operator toneIndigo
```

## Components

### Radar transmitter

- [XIAO transmitter](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino): `Firmware/rd03d_xiao_s3_transmitter.ino`
- [Target clustering](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino): `Firmware/rd03d_xiao_s3_transmitter.ino`
- [Wi-Fi access point](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino): `Firmware/rd03d_xiao_s3_transmitter.ino`
- [UDP broadcast](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/rd03d_xiao_s3_transmitter.ino): `Firmware/rd03d_xiao_s3_transmitter.ino`

### uConsole receiver

- [uConsole receiver](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py): `Firmware/uconsole_radar_receiver.py`
- [Packet decoding](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py): `Firmware/uconsole_radar_receiver.py`
- [Target tracking](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py): `Firmware/uconsole_radar_receiver.py`

### Display and audio

- [Sonar synthesis](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py): `Firmware/uconsole_radar_receiver.py`
- [Radar display](https://github.com/stevee87/radar-project-uconsole/blob/main/Firmware/uconsole_radar_receiver.py): `Firmware/uconsole_radar_receiver.py`

### Other components

- **RD-03D radar**
- **Operator**

## Connections

- RD-03D radar → XIAO transmitter: UART data (evidence: `README.md`)
- XIAO transmitter → Target clustering: clusters targets (evidence: `README.md`)
- Target clustering → Wi-Fi access point: sends stream (evidence: `README.md`)
- Wi-Fi access point → UDP broadcast: broadcasts over (evidence: `README.md`)
- UDP broadcast → uConsole receiver: UDP stream (evidence: `README.md`)
- uConsole receiver → Packet decoding: receives packets (evidence: `Firmware/uconsole_radar_receiver.py`)
- Packet decoding → Target tracking: updates targets (evidence: `Firmware/uconsole_radar_receiver.py`)
- uConsole receiver → Sonar synthesis: synthesizes pings (evidence: `Firmware/uconsole_radar_receiver.py`)
- uConsole receiver → Radar display: draws scope (evidence: `Firmware/uconsole_radar_receiver.py`)
- Target tracking → Radar display: renders smoothed targets (evidence: `Firmware/uconsole_radar_receiver.py`)
- Operator → Radar display: views (evidence: `README.md`)
- Operator → Sonar synthesis: hears (evidence: `README.md`)
