# vbaczynski/rpi-usb-ip-display-headless architecture

> Architecture diagram of the GitHub repository vbaczynski/rpi-usb-ip-display-headless, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vbaczynski/rpi-usb-ip-display-headless
- Repository: https://github.com/vbaczynski/rpi-usb-ip-display-headless

## Overview

The product is a headless Raspberry Pi status display: a Pi periodically gathers its hostname and interface addresses, sends them over USB CDC serial, and an RP2350 firmware displays them on an LCD. The README documents the Pi-side service, udev detection, and refresh timer; the setup script and firmware entry point are present in the tree but were not excerpted, so their internal wiring is not asserted. The sampled firmware shows paint, LCD-driver, hardware-abstraction, and font layers.

Main entry points: [`raspberry-pi/setup-ip-display.sh`](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/raspberry-pi/setup-ip-display.sh) (Pi setup), [`firmware/HeadlessIpDisplay/GUI_Paint.cpp`](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/GUI_Paint.cpp) (Paint operations), [`firmware/HeadlessIpDisplay/LCD_1in47.cpp`](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/LCD_1in47.cpp) (LCD driver), [`raspberry-pi`](https://github.com/vbaczynski/rpi-usb-ip-display-headless/tree/main/raspberry-pi) (Refresh timer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pi["Pi data service"]
  node_setup["Pi setup"]
  node_udev["USB detection"]
  node_refresh["Refresh timer"]
  node_collector["Host and IP sender"]
end

subgraph group_firmware["Display firmware"]
  node_entry["Firmware application"]
end

subgraph group_graphics["Graphics and hardware"]
  node_paint["Paint operations<br/>[GUI_Paint.cpp]"]
  node_lcd["LCD driver<br/>[LCD_1in47.cpp]"]
  node_dev["Board hardware I/O<br/>[DEV_Config.cpp]"]
  node_font["Font bitmaps"]
end

node_operator(("Pi operator"))
node_host(("Raspberry Pi"))
node_usb["USB CDC serial"]
node_screen["LCD display"]

node_operator -->|"installs"| node_setup
node_setup -->|"configures"| node_udev
node_setup -->|"installs"| node_refresh
node_host -->|"provides host data"| node_collector
node_refresh -->|"triggers refresh"| node_collector
node_collector -->|"sends serial data"| node_usb
node_usb -->|"delivers serial data"| node_entry
node_entry -.->|"renders status"| node_paint
node_paint -->|"uses glyphs"| node_font
node_paint -.->|"draws via"| node_lcd
node_lcd -->|"uses hardware I/O"| node_dev
node_lcd -.->|"updates LCD"| node_screen

click node_setup "https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/raspberry-pi/setup-ip-display.sh"
click node_udev "https://github.com/vbaczynski/rpi-usb-ip-display-headless/tree/main/raspberry-pi"
click node_refresh "https://github.com/vbaczynski/rpi-usb-ip-display-headless/tree/main/raspberry-pi"
click node_collector "https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/raspberry-pi/setup-ip-display.sh"
click node_entry "https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/HeadlessIpDisplay.ino"
click node_paint "https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/GUI_Paint.cpp"
click node_lcd "https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/LCD_1in47.cpp"
click node_dev "https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/DEV_Config.cpp"
click node_font "https://github.com/vbaczynski/rpi-usb-ip-display-headless/tree/main/firmware/HeadlessIpDisplay"

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_setup,node_udev,node_refresh,node_collector toneBlue
class node_entry toneAmber
class node_paint,node_lcd,node_dev,node_font toneMint
class node_operator,node_host,node_usb,node_screen toneIndigo
```

## Components

### Pi data service

- [Pi setup](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/raspberry-pi/setup-ip-display.sh): `raspberry-pi/setup-ip-display.sh`
- [USB detection](https://github.com/vbaczynski/rpi-usb-ip-display-headless/tree/main/raspberry-pi): `raspberry-pi`
- [Refresh timer](https://github.com/vbaczynski/rpi-usb-ip-display-headless/tree/main/raspberry-pi): `raspberry-pi`
- [Host and IP sender](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/raspberry-pi/setup-ip-display.sh): `raspberry-pi/setup-ip-display.sh`

### Display firmware

- [Firmware application](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/HeadlessIpDisplay.ino): `firmware/HeadlessIpDisplay/HeadlessIpDisplay.ino`

### Graphics and hardware

- [Paint operations](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/GUI_Paint.cpp): `firmware/HeadlessIpDisplay/GUI_Paint.cpp`
- [LCD driver](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/LCD_1in47.cpp): `firmware/HeadlessIpDisplay/LCD_1in47.cpp`
- [Board hardware I/O](https://github.com/vbaczynski/rpi-usb-ip-display-headless/blob/main/firmware/HeadlessIpDisplay/DEV_Config.cpp): `firmware/HeadlessIpDisplay/DEV_Config.cpp`
- [Font bitmaps](https://github.com/vbaczynski/rpi-usb-ip-display-headless/tree/main/firmware/HeadlessIpDisplay): `firmware/HeadlessIpDisplay`

### Other components

- **Pi operator**
- **Raspberry Pi**
- **USB CDC serial**
- **LCD display**

## Connections

- Pi operator → Pi setup: installs (evidence: `README.md`)
- Pi setup → USB detection: configures (evidence: `README.md`)
- Pi setup → Refresh timer: installs (evidence: `README.md`)
- Raspberry Pi → Host and IP sender: provides host data (evidence: `README.md`)
- Refresh timer → Host and IP sender: triggers refresh (evidence: `README.md`)
- Host and IP sender → USB CDC serial: sends serial data (evidence: `README.md`)
- USB CDC serial → Firmware application: delivers serial data (evidence: `README.md`)
- Firmware application → Paint operations: renders status
- Paint operations → Font bitmaps: uses glyphs (evidence: `firmware/HeadlessIpDisplay/GUI_Paint.h`)
- Paint operations → LCD driver: draws via
- LCD driver → Board hardware I/O: uses hardware I/O (evidence: `firmware/HeadlessIpDisplay/LCD_1in47.cpp`)
- LCD driver → LCD display: updates LCD
