# nnanna-1/hvac-controller architecture

> Architecture diagram of the GitHub repository nnanna-1/hvac-controller, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nnanna-1/hvac-controller
- Repository: https://github.com/nnanna-1/hvac-controller

## Overview

This is ESP32 HVAC-controller firmware. Startup configures button interrupts and launches FreeRTOS tasks; sensor tasks update shared state, and the safety task applies temperature, override, and emergency rules to HVAC and alarm outputs. The README describes an industrial IoT controller, but the available source shows no networking or remote-control subsystem.

Main entry points: [`src/main.c`](https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c) (System Startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup &amp; Inputs"]
  node_startup["System Startup<br/>[main.c]"]
  node_button_setup["Button Interrupts<br/>[main.c]"]
end

subgraph group_sensing["Sensor Tasks"]
  node_dht_task["DHT Acquisition<br/>[main.c]"]
  node_adc_task["ADC Acquisition<br/>[main.c]"]
  node_shared_state["Shared State<br/>[main.c]"]
end

subgraph group_control["Safety &amp; Outputs"]
  node_safety_task["Safety Control<br/>[main.c]"]
end

node_operator(("Operator"))
node_dht_sensor["DHT22 Sensor"]
node_adc_input["ADC Input"]
node_hvac_relay["HVAC Relay"]
node_alarm_outputs["Alarm Outputs"]

node_startup -->|"configures"| node_button_setup
node_startup -->|"launches"| node_dht_task
node_startup -->|"launches"| node_adc_task
node_startup -->|"launches"| node_safety_task
node_operator -->|"presses buttons"| node_button_setup
node_dht_task -->|"reads temperature"| node_dht_sensor
node_adc_task -->|"samples voltage"| node_adc_input
node_dht_task -->|"writes readings"| node_shared_state
node_adc_task -->|"writes readings"| node_shared_state
node_button_setup -->|"sets flags"| node_shared_state
node_safety_task -->|"reads and updates"| node_shared_state
node_safety_task -->|"drives relay"| node_hvac_relay
node_safety_task -->|"drives indicators"| node_alarm_outputs

click node_startup "https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c"
click node_button_setup "https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c"
click node_dht_task "https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c"
click node_adc_task "https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c"
click node_shared_state "https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c"
click node_safety_task "https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c"

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_startup,node_button_setup toneBlue
class node_dht_task,node_adc_task,node_shared_state toneAmber
class node_safety_task toneMint
class node_operator,node_dht_sensor,node_adc_input,node_hvac_relay,node_alarm_outputs toneIndigo
```

## Components

### Startup & Inputs

- [System Startup](https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c): `src/main.c`
- [Button Interrupts](https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c): `src/main.c`

### Sensor Tasks

- [DHT Acquisition](https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c): `src/main.c`
- [ADC Acquisition](https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c): `src/main.c`
- [Shared State](https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c): `src/main.c`

### Safety & Outputs

- [Safety Control](https://github.com/nnanna-1/hvac-controller/blob/main/src/main.c): `src/main.c`

### Other components

- **Operator**
- **DHT22 Sensor**
- **ADC Input**
- **HVAC Relay**
- **Alarm Outputs**

## Connections

- System Startup → Button Interrupts: configures (evidence: `src/main.c`)
- System Startup → DHT Acquisition: launches (evidence: `src/main.c`)
- System Startup → ADC Acquisition: launches (evidence: `src/main.c`)
- System Startup → Safety Control: launches (evidence: `src/main.c`)
- Operator → Button Interrupts: presses buttons (evidence: `src/main.c`)
- DHT Acquisition → DHT22 Sensor: reads temperature (evidence: `src/main.c`)
- ADC Acquisition → ADC Input: samples voltage (evidence: `src/main.c`)
- DHT Acquisition → Shared State: writes readings (evidence: `src/main.c`)
- ADC Acquisition → Shared State: writes readings (evidence: `src/main.c`)
- Button Interrupts → Shared State: sets flags (evidence: `src/main.c`)
- Safety Control → Shared State: reads and updates (evidence: `src/main.c`)
- Safety Control → HVAC Relay: drives relay (evidence: `src/main.c`)
- Safety Control → Alarm Outputs: drives indicators (evidence: `src/main.c`)
