# komparator07-jpg/pid_ten_esp_oled architecture

> Architecture diagram of the GitHub repository komparator07-jpg/pid_ten_esp_oled, 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/komparator07-jpg/pid_ten_esp_oled
- Repository: https://github.com/komparator07-jpg/pid_ten_esp_oled

## Overview

This repository describes an ESP32 PID controller for a flow-through water heater, with an SSR power switch, OLED display, temperature presets, and screen animations. The documented workflow is controller to heater control and on-screen presentation; animation files are grouped as display content. No source excerpts are available, so relationships are limited to capabilities stated in the README.

Main entry points: [`README.md`](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md) (ESP32 controller), [`animation/Clock.ino`](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/animation/Clock.ino) (Clock animation), [`animation/other`](https://github.com/komparator07-jpg/pid_ten_esp_oled/tree/main/animation/other) (Other animations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Heater control"]
  node_controller["ESP32 controller<br/>[README.md]"]
  node_pid["PID regulation<br/>[README.md]"]
  node_heater["Heater SSR<br/>[README.md]"]
  node_presets["Temperature presets<br/>[README.md]"]
end

subgraph group_display["OLED display"]
  node_oled["OLED screen<br/>[README.md]"]
  node_clock["Clock animation<br/>[Clock.ino]"]
  node_animations["Other animations"]
end

node_operator(("Operator"))

node_operator -->|"operates"| node_controller
node_controller -->|"regulates"| node_pid
node_controller -->|"controls"| node_heater
node_controller -->|"offers"| node_presets
node_controller -->|"displays on"| node_oled
node_oled -->|"shows animation"| node_clock
node_oled -->|"shows animation"| node_animations

click node_controller "https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md"
click node_pid "https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md"
click node_heater "https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md"
click node_presets "https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md"
click node_oled "https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md"
click node_clock "https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/animation/Clock.ino"
click node_animations "https://github.com/komparator07-jpg/pid_ten_esp_oled/tree/main/animation/other"

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_controller,node_pid,node_heater,node_presets toneBlue
class node_oled,node_clock,node_animations toneAmber
class node_operator toneIndigo
```

## Components

### Heater control

- [ESP32 controller](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md): `README.md`
- [PID regulation](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md): `README.md`
- [Heater SSR](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md): `README.md`
- [Temperature presets](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md): `README.md`

### OLED display

- [OLED screen](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/README.md): `README.md`
- [Clock animation](https://github.com/komparator07-jpg/pid_ten_esp_oled/blob/main/animation/Clock.ino): `animation/Clock.ino`
- [Other animations](https://github.com/komparator07-jpg/pid_ten_esp_oled/tree/main/animation/other): `animation/other`

### Other components

- **Operator**

## Connections

- Operator → ESP32 controller: operates (evidence: `README.md`)
- ESP32 controller → PID regulation: regulates (evidence: `README.md`)
- ESP32 controller → Heater SSR: controls (evidence: `README.md`)
- ESP32 controller → Temperature presets: offers (evidence: `README.md`)
- ESP32 controller → OLED screen: displays on (evidence: `README.md`)
- OLED screen → Clock animation: shows animation (evidence: `README.md`)
- OLED screen → Other animations: shows animation (evidence: `README.md`)
