# vulcainreo/dvid architecture

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

- Interactive diagram: https://gitdiagram.com/vulcainreo/dvid
- Repository: https://github.com/vulcainreo/dvid

## Overview

DVID is an intentionally vulnerable ATmega328P training device, intended to let learners explore firmware and hardware attack surfaces. The README describes flashing challenge firmware, viewing information on an OLED, and using plug-in connectivity extensions and external attack tools. The supplied tree, however, is principally a collection of OLED and graphics libraries; it contains no evident DVID challenge firmware or application entry point. The diagram therefore distinguishes documented product workflow from the display-library code actually present; unsampled connectivity and challenge implementations are left as documented subsystems rather than inferred code paths.

Main entry points: [`ino/Adafruit_SSD1306/Adafruit_SSD1306.cpp`](https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_SSD1306/Adafruit_SSD1306.cpp) (Adafruit SSD1306), [`ino/Adafruit_GFX_Library/Adafruit_GFX.cpp`](https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_GFX_Library/Adafruit_GFX.cpp) (GFX primitives), [`ino/Cytron_SSD1306/src/Cytron_SSD1306.cpp`](https://github.com/vulcainreo/dvid/blob/master/ino/Cytron_SSD1306/src/Cytron_SSD1306.cpp) (Cytron SSD1306), [`ino/SSD1306Ascii/src/SSD1306Ascii.cpp`](https://github.com/vulcainreo/dvid/blob/master/ino/SSD1306Ascii/src/SSD1306Ascii.cpp) (SSD1306Ascii)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["DVID device"]
  node_board["ATmega328P board"]
  node_challenge_fw["Challenge firmware"]
  node_oled["OLED screen"]
end

subgraph group_graphics["Graphics and display"]
  node_gfx["GFX primitives<br/>[Adafruit_GFX.cpp]"]
  node_gfx_api["GFX API and fonts<br/>[Adafruit_GFX.h]"]
  node_adafruit_driver["Adafruit SSD1306"]
  node_splash["Splash bitmap<br/>[splash.h]"]
  node_cytron_driver["Cytron SSD1306<br/>[Cytron_SSD1306.cpp]"]
  node_cytron_i2c["AVR I2C transport<br/>[AvrI2c.h]"]
  node_ascii_driver["SSD1306Ascii<br/>[SSD1306Ascii.cpp]"]
  node_ascii_fonts["ASCII font catalog<br/>[allFonts.h]"]
  node_busio["Bus I/O helpers"]
end

subgraph group_connectivity["Connectivity extensions"]
  node_uart["UART extension"]
  node_bluetooth["Bluetooth extension"]
  node_wireless["Wi-Fi / 2.4 GHz extension"]
end

subgraph group_training["Training and access"]
  node_attack_tools["USBasp / USB-UART"]
end

node_learner(("IoT learner"))

node_learner -->|"selects challenge"| node_challenge_fw
node_attack_tools -->|"flashes firmware"| node_board
node_challenge_fw -->|"runs on"| node_board
node_challenge_fw -.->|"presents output"| node_oled
node_board -->|"drives display"| node_oled
node_adafruit_driver -->|"inherits graphics"| node_gfx
node_gfx -->|"implements API"| node_gfx_api
node_adafruit_driver -->|"uses bitmap"| node_splash
node_cytron_driver -->|"uses transport"| node_cytron_i2c
node_ascii_driver -->|"offers fonts"| node_ascii_fonts
node_challenge_fw -.->|"uses extension"| node_uart
node_challenge_fw -.->|"uses extension"| node_bluetooth
node_challenge_fw -.->|"uses extension"| node_wireless
node_learner -->|"probes device"| node_uart
node_learner -->|"probes device"| node_bluetooth
node_learner -->|"probes device"| node_wireless
node_busio -.->|"supports bus access"| node_adafruit_driver

click node_gfx "https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_GFX_Library/Adafruit_GFX.cpp"
click node_gfx_api "https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_GFX_Library/Adafruit_GFX.h"
click node_adafruit_driver "https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_SSD1306/Adafruit_SSD1306.cpp"
click node_splash "https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_SSD1306/splash.h"
click node_cytron_driver "https://github.com/vulcainreo/dvid/blob/master/ino/Cytron_SSD1306/src/Cytron_SSD1306.cpp"
click node_cytron_i2c "https://github.com/vulcainreo/dvid/blob/master/ino/Cytron_SSD1306/src/utility/AvrI2c.h"
click node_ascii_driver "https://github.com/vulcainreo/dvid/blob/master/ino/SSD1306Ascii/src/SSD1306Ascii.cpp"
click node_ascii_fonts "https://github.com/vulcainreo/dvid/blob/master/ino/SSD1306Ascii/src/fonts/allFonts.h"
click node_busio "https://github.com/vulcainreo/dvid/tree/master/ino/Adafruit_BusIO"

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_board,node_challenge_fw,node_oled toneBlue
class node_gfx,node_gfx_api,node_adafruit_driver,node_splash,node_cytron_driver,node_cytron_i2c,node_ascii_driver,node_ascii_fonts,node_busio toneAmber
class node_uart,node_bluetooth,node_wireless toneMint
class node_attack_tools toneRose
class node_learner toneIndigo
```

## Components

### DVID device

- **ATmega328P board**
- **Challenge firmware**
- **OLED screen**

### Graphics and display

- [GFX primitives](https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_GFX_Library/Adafruit_GFX.cpp): `ino/Adafruit_GFX_Library/Adafruit_GFX.cpp`
- [GFX API and fonts](https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_GFX_Library/Adafruit_GFX.h): `ino/Adafruit_GFX_Library/Adafruit_GFX.h`
- [Adafruit SSD1306](https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_SSD1306/Adafruit_SSD1306.cpp): `ino/Adafruit_SSD1306/Adafruit_SSD1306.cpp`
- [Splash bitmap](https://github.com/vulcainreo/dvid/blob/master/ino/Adafruit_SSD1306/splash.h): `ino/Adafruit_SSD1306/splash.h`
- [Cytron SSD1306](https://github.com/vulcainreo/dvid/blob/master/ino/Cytron_SSD1306/src/Cytron_SSD1306.cpp): `ino/Cytron_SSD1306/src/Cytron_SSD1306.cpp`
- [AVR I2C transport](https://github.com/vulcainreo/dvid/blob/master/ino/Cytron_SSD1306/src/utility/AvrI2c.h): `ino/Cytron_SSD1306/src/utility/AvrI2c.h`
- [SSD1306Ascii](https://github.com/vulcainreo/dvid/blob/master/ino/SSD1306Ascii/src/SSD1306Ascii.cpp): `ino/SSD1306Ascii/src/SSD1306Ascii.cpp`
- [ASCII font catalog](https://github.com/vulcainreo/dvid/blob/master/ino/SSD1306Ascii/src/fonts/allFonts.h): `ino/SSD1306Ascii/src/fonts/allFonts.h`
- [Bus I/O helpers](https://github.com/vulcainreo/dvid/tree/master/ino/Adafruit_BusIO): `ino/Adafruit_BusIO`

### Connectivity extensions

- **UART extension**
- **Bluetooth extension**
- **Wi-Fi / 2.4 GHz extension**

### Training and access

- **USBasp / USB-UART**

### Other components

- **IoT learner**

## Connections

- IoT learner → Challenge firmware: selects challenge
- USBasp / USB-UART → ATmega328P board: flashes firmware
- Challenge firmware → ATmega328P board: runs on
- Challenge firmware → OLED screen: presents output
- ATmega328P board → OLED screen: drives display
- Adafruit SSD1306 → GFX primitives: inherits graphics
- GFX primitives → GFX API and fonts: implements API (evidence: `ino/Adafruit_GFX_Library/Adafruit_GFX.cpp`)
- Adafruit SSD1306 → Splash bitmap: uses bitmap (evidence: `ino/Adafruit_SSD1306/Adafruit_SSD1306.cpp`)
- Cytron SSD1306 → AVR I2C transport: uses transport
- SSD1306Ascii → ASCII font catalog: offers fonts
- Challenge firmware → UART extension: uses extension
- Challenge firmware → Bluetooth extension: uses extension
- Challenge firmware → Wi-Fi / 2.4 GHz extension: uses extension
- IoT learner → UART extension: probes device
- IoT learner → Bluetooth extension: probes device
- IoT learner → Wi-Fi / 2.4 GHz extension: probes device
- Bus I/O helpers → Adafruit SSD1306: supports bus access
