# minusojoaquin/termostato-pico-w architecture

> Architecture diagram of the GitHub repository minusojoaquin/termostato-pico-w, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/minusojoaquin/termostato-pico-w
- Repository: https://github.com/minusojoaquin/termostato-pico-w

## Overview

This is MicroPython firmware for an ESP32 thermostat controlled and monitored over MQTT. Its workflow restores settings, samples a DHT11 sensor, drives a relay according to automatic or manual mode, publishes telemetry, and applies MQTT commands that can update persistent settings or trigger an LED blink. The MQTT library provides message queuing, protocol operations, and connection handling. The README is only a title, and the excerpts do not show all MQTT networking internals, so those links are omitted or marked unverified.

Main entry points: [`main.py`](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py) (Firmware startup), [`lib/mqtt_as.py`](https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py) (MQTT client), [`lib/mqtt_local.py`](https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_local.py) (Local MQTT config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_firmware["Thermostat firmware"]
  node_startup["Firmware startup<br/>[main.py]"]
  node_state["Persistent settings<br/>[main.py]"]
  node_thermostat["Thermostat control<br/>[main.py]"]
  node_telemetry["Telemetry publisher<br/>[main.py]"]
  node_commands["Command processor<br/>[main.py]"]
  node_subscriptions["Topic subscriptions<br/>[main.py]"]
  node_blink["LED blink task<br/>[main.py]"]
end

subgraph group_messaging["MQTT messaging"]
  node_localconfig["Local MQTT config<br/>[mqtt_local.py]"]
  node_mqttclient["MQTT client<br/>[mqtt_as.py]"]
  node_messagequeue["Message queue<br/>[mqtt_as.py]"]
  node_mqttprotocol["MQTT protocol<br/>[mqtt_as.py]"]
  node_connectivity["Connection recovery<br/>[mqtt_as.py]"]
end

subgraph group_hardware["Device hardware"]
  node_sensor["DHT11 sensor"]
  node_relay["Relay output"]
  node_led["Status LED"]
end

node_flash[("Device flash file")]
node_broker(("MQTT broker"))
node_settingsmodule["Device settings module"]

node_startup -->|"imports config"| node_localconfig
node_localconfig -->|"imports defaults"| node_mqttclient
node_startup -->|"creates client"| node_mqttclient
node_startup -->|"loads settings"| node_state
node_state -->|"reads and writes"| node_flash
node_startup -->|"starts task"| node_thermostat
node_startup -->|"starts task"| node_telemetry
node_startup -->|"starts task"| node_commands
node_startup -->|"starts task"| node_subscriptions
node_thermostat -->|"reads measurements"| node_sensor
node_thermostat -->|"sets output"| node_relay
node_thermostat -->|"uses settings"| node_state
node_telemetry -->|"reads values"| node_state
node_telemetry -->|"publishes state"| node_mqttclient
node_commands -->|"consumes messages"| node_messagequeue
node_commands -->|"updates settings"| node_state
node_commands -->|"schedules task"| node_blink
node_blink -->|"toggles"| node_led
node_subscriptions -->|"subscribes topics"| node_mqttclient
node_startup -->|"connects"| node_mqttclient
node_mqttclient -.->|"exchanges MQTT"| node_broker
node_mqttclient -->|"queues messages"| node_messagequeue
node_mqttclient -.->|"implements protocol"| node_mqttprotocol
node_mqttclient -.->|"handles reconnection"| node_connectivity
node_startup -->|"reads credentials"| node_settingsmodule

click node_startup "https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py"
click node_state "https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py"
click node_thermostat "https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py"
click node_telemetry "https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py"
click node_commands "https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py"
click node_subscriptions "https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py"
click node_blink "https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py"
click node_localconfig "https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_local.py"
click node_mqttclient "https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py"
click node_messagequeue "https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py"
click node_mqttprotocol "https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py"
click node_connectivity "https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.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_startup,node_state,node_thermostat,node_telemetry,node_commands,node_subscriptions,node_blink toneBlue
class node_localconfig,node_mqttclient,node_messagequeue,node_mqttprotocol,node_connectivity,node_flash toneAmber
class node_sensor,node_relay,node_led toneMint
class node_broker,node_settingsmodule toneIndigo
```

## Components

### Thermostat firmware

- [Firmware startup](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py): `main.py`
- [Persistent settings](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py): `main.py`
- [Thermostat control](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py): `main.py`
- [Telemetry publisher](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py): `main.py`
- [Command processor](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py): `main.py`
- [Topic subscriptions](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py): `main.py`
- [LED blink task](https://github.com/minusojoaquin/termostato-pico-w/blob/main/main.py): `main.py`

### MQTT messaging

- [Local MQTT config](https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_local.py): `lib/mqtt_local.py`
- [MQTT client](https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py): `lib/mqtt_as.py`
- [Message queue](https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py): `lib/mqtt_as.py`
- [MQTT protocol](https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py): `lib/mqtt_as.py`
- [Connection recovery](https://github.com/minusojoaquin/termostato-pico-w/blob/main/lib/mqtt_as.py): `lib/mqtt_as.py`

### Device hardware

- **DHT11 sensor**
- **Relay output**
- **Status LED**

### Other components

- **Device flash file**
- **MQTT broker**
- **Device settings module**

## Connections

- Firmware startup → Local MQTT config: imports config (evidence: `main.py`)
- Local MQTT config → MQTT client: imports defaults (evidence: `lib/mqtt_local.py`)
- Firmware startup → MQTT client: creates client (evidence: `main.py`)
- Firmware startup → Persistent settings: loads settings (evidence: `main.py`)
- Persistent settings → Device flash file: reads and writes (evidence: `main.py`)
- Firmware startup → Thermostat control: starts task (evidence: `main.py`)
- Firmware startup → Telemetry publisher: starts task (evidence: `main.py`)
- Firmware startup → Command processor: starts task (evidence: `main.py`)
- Firmware startup → Topic subscriptions: starts task (evidence: `main.py`)
- Thermostat control → DHT11 sensor: reads measurements (evidence: `main.py`)
- Thermostat control → Relay output: sets output (evidence: `main.py`)
- Thermostat control → Persistent settings: uses settings (evidence: `main.py`)
- Telemetry publisher → Persistent settings: reads values (evidence: `main.py`)
- Telemetry publisher → MQTT client: publishes state (evidence: `main.py`)
- Command processor → Message queue: consumes messages (evidence: `main.py`)
- Command processor → Persistent settings: updates settings (evidence: `main.py`)
- Command processor → LED blink task: schedules task (evidence: `main.py`)
- LED blink task → Status LED: toggles (evidence: `main.py`)
- Topic subscriptions → MQTT client: subscribes topics (evidence: `main.py`)
- Firmware startup → MQTT client: connects (evidence: `main.py`)
- MQTT client → MQTT broker: exchanges MQTT
- MQTT client → Message queue: queues messages (evidence: `lib/mqtt_as.py`)
- MQTT client → MQTT protocol: implements protocol (evidence: `lib/mqtt_as.py`)
- MQTT client → Connection recovery: handles reconnection (evidence: `lib/mqtt_as.py`)
- Firmware startup → Device settings module: reads credentials (evidence: `main.py`)
