# zedattran/smart_irrigation architecture

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

## Overview

This is ESP32/Arduino IoT device firmware, not the PlatformIO platform described by the README. The visible runtime starts FreeRTOS tasks for status LEDs, temperature/humidity monitoring, and CoreIOT; its main loop checks network status and reconnects Wi-Fi and the web server. The tree also shows web-server, RS485, boot-toggle, and anomaly-model subsystems, but their implementation and wiring were not sampled. Dashed, uncited links mark those uncertain connections; the README does not document this product’s capabilities.

Main entry points: [`src/main.cpp`](https://github.com/zedattran/smart_irrigation/blob/main/src/main.cpp) (Firmware entry), [`src/temp_humi_monitor.cpp`](https://github.com/zedattran/smart_irrigation/blob/main/src/temp_humi_monitor.cpp) (Climate monitor), [`src/mainserver.cpp`](https://github.com/zedattran/smart_irrigation/blob/main/src/mainserver.cpp) (Web server), [`src/coreiot.cpp`](https://github.com/zedattran/smart_irrigation/blob/main/src/coreiot.cpp) (CoreIOT client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and control"]
  node_firmware["Firmware entry<br/>[main.cpp]"]
  node_shared_state["Shared state<br/>[global.cpp]"]
  node_status_check["Status check"]
  node_boot_toggle["Boot toggle"]
end

subgraph group_device["Device features"]
  node_led["Status LED<br/>[led_blinky.cpp]"]
  node_neo_led["NeoPixel LED<br/>[neo_blinky.cpp]"]
  node_climate["Climate monitor"]
  node_anomaly["Anomaly model"]
  node_tinyml["TinyML runtime<br/>[tinyml.cpp]"]
  node_rs485["RS485 task<br/>[task_rs485.cpp]"]
end

subgraph group_connectivity["Connectivity and services"]
  node_wifi["Wi-Fi management<br/>[task_wifi.cpp]"]
  node_webserver["Web server<br/>[mainserver.cpp]"]
  node_web_task["Web-server task<br/>[task_webserver.cpp]"]
  node_web_script["Web interface script<br/>[script.js]"]
  node_coreiot_task["CoreIOT task<br/>[task_core_iot.cpp]"]
  node_coreiot["CoreIOT client<br/>[coreiot.cpp]"]
end

subgraph group_libraries["Supporting libraries"]
  node_dht20["DHT20 sensor<br/>[DHT20.cpp]"]
  node_lcd["LCD display"]
  node_thingsboard_mqtt["ThingsBoard MQTT"]
  node_pubsub["MQTT client<br/>[PubSubClient.cpp]"]
end

node_device_user(("Device operator"))

node_device_user -.->|"starts device"| node_firmware
node_firmware -->|"checks status"| node_status_check
node_firmware -->|"starts task"| node_led
node_firmware -->|"starts task"| node_neo_led
node_firmware -->|"starts task"| node_climate
node_firmware -->|"starts task"| node_coreiot_task
node_firmware -->|"reconnects Wi-Fi"| node_wifi
node_firmware -->|"reconnects server"| node_webserver
node_firmware -->|"stops server"| node_webserver
node_shared_state -.->|"shares measurements"| node_climate
node_climate -.->|"reads sensor"| node_dht20
node_climate -.->|"updates display"| node_lcd
node_climate -.->|"evaluates readings"| node_anomaly
node_tinyml -.->|"uses model"| node_anomaly
node_web_task -.->|"runs server"| node_webserver
node_webserver -.->|"serves interface"| node_web_script
node_coreiot_task -.->|"runs client"| node_coreiot
node_coreiot -.->|"uses transport"| node_thingsboard_mqtt
node_coreiot -.->|"uses MQTT"| node_pubsub
node_firmware -.->|"may start task"| node_rs485
node_firmware -.->|"may start task"| node_boot_toggle

click node_firmware "https://github.com/zedattran/smart_irrigation/blob/main/src/main.cpp"
click node_shared_state "https://github.com/zedattran/smart_irrigation/blob/main/src/global.cpp"
click node_status_check "https://github.com/zedattran/smart_irrigation/blob/main/src/task_check_info.cpp"
click node_led "https://github.com/zedattran/smart_irrigation/blob/main/src/led_blinky.cpp"
click node_neo_led "https://github.com/zedattran/smart_irrigation/blob/main/src/neo_blinky.cpp"
click node_climate "https://github.com/zedattran/smart_irrigation/blob/main/src/temp_humi_monitor.cpp"
click node_dht20 "https://github.com/zedattran/smart_irrigation/blob/main/lib/DHT20/DHT20.cpp"
click node_lcd "https://github.com/zedattran/smart_irrigation/blob/main/lib/LCD/LiquidCrystal_I2C.cpp"
click node_anomaly "https://github.com/zedattran/smart_irrigation/blob/main/src/dht_anomaly_model.h"
click node_tinyml "https://github.com/zedattran/smart_irrigation/blob/main/src/tinyml.cpp"
click node_wifi "https://github.com/zedattran/smart_irrigation/blob/main/src/task_wifi.cpp"
click node_webserver "https://github.com/zedattran/smart_irrigation/blob/main/src/mainserver.cpp"
click node_web_task "https://github.com/zedattran/smart_irrigation/blob/main/src/task_webserver.cpp"
click node_web_script "https://github.com/zedattran/smart_irrigation/blob/main/data/script.js"
click node_coreiot_task "https://github.com/zedattran/smart_irrigation/blob/main/src/task_core_iot.cpp"
click node_coreiot "https://github.com/zedattran/smart_irrigation/blob/main/src/coreiot.cpp"
click node_thingsboard_mqtt "https://github.com/zedattran/smart_irrigation/blob/main/lib/ThingsBoard/Espressif_MQTT_Client.cpp"
click node_pubsub "https://github.com/zedattran/smart_irrigation/blob/main/lib/PubSubClient/PubSubClient.cpp"
click node_rs485 "https://github.com/zedattran/smart_irrigation/blob/main/src/task_rs485.cpp"
click node_boot_toggle "https://github.com/zedattran/smart_irrigation/blob/main/src/task_toogle_boot.cpp"

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_firmware,node_shared_state,node_status_check,node_boot_toggle toneBlue
class node_led,node_neo_led,node_climate,node_anomaly,node_tinyml,node_rs485 toneAmber
class node_wifi,node_webserver,node_web_task,node_web_script,node_coreiot_task,node_coreiot toneMint
class node_dht20,node_lcd,node_thingsboard_mqtt,node_pubsub toneRose
class node_device_user toneIndigo
```

## Components

### Runtime and control

- [Firmware entry](https://github.com/zedattran/smart_irrigation/blob/main/src/main.cpp): `src/main.cpp`
- [Shared state](https://github.com/zedattran/smart_irrigation/blob/main/src/global.cpp): `src/global.cpp`
- [Status check](https://github.com/zedattran/smart_irrigation/blob/main/src/task_check_info.cpp): `src/task_check_info.cpp`
- [Boot toggle](https://github.com/zedattran/smart_irrigation/blob/main/src/task_toogle_boot.cpp): `src/task_toogle_boot.cpp`

### Device features

- [Status LED](https://github.com/zedattran/smart_irrigation/blob/main/src/led_blinky.cpp): `src/led_blinky.cpp`
- [NeoPixel LED](https://github.com/zedattran/smart_irrigation/blob/main/src/neo_blinky.cpp): `src/neo_blinky.cpp`
- [Climate monitor](https://github.com/zedattran/smart_irrigation/blob/main/src/temp_humi_monitor.cpp): `src/temp_humi_monitor.cpp`
- [Anomaly model](https://github.com/zedattran/smart_irrigation/blob/main/src/dht_anomaly_model.h): `src/dht_anomaly_model.h`
- [TinyML runtime](https://github.com/zedattran/smart_irrigation/blob/main/src/tinyml.cpp): `src/tinyml.cpp`
- [RS485 task](https://github.com/zedattran/smart_irrigation/blob/main/src/task_rs485.cpp): `src/task_rs485.cpp`

### Connectivity and services

- [Wi-Fi management](https://github.com/zedattran/smart_irrigation/blob/main/src/task_wifi.cpp): `src/task_wifi.cpp`
- [Web server](https://github.com/zedattran/smart_irrigation/blob/main/src/mainserver.cpp): `src/mainserver.cpp`
- [Web-server task](https://github.com/zedattran/smart_irrigation/blob/main/src/task_webserver.cpp): `src/task_webserver.cpp`
- [Web interface script](https://github.com/zedattran/smart_irrigation/blob/main/data/script.js): `data/script.js`
- [CoreIOT task](https://github.com/zedattran/smart_irrigation/blob/main/src/task_core_iot.cpp): `src/task_core_iot.cpp`
- [CoreIOT client](https://github.com/zedattran/smart_irrigation/blob/main/src/coreiot.cpp): `src/coreiot.cpp`

### Supporting libraries

- [DHT20 sensor](https://github.com/zedattran/smart_irrigation/blob/main/lib/DHT20/DHT20.cpp): `lib/DHT20/DHT20.cpp`
- [LCD display](https://github.com/zedattran/smart_irrigation/blob/main/lib/LCD/LiquidCrystal_I2C.cpp): `lib/LCD/LiquidCrystal_I2C.cpp`
- [ThingsBoard MQTT](https://github.com/zedattran/smart_irrigation/blob/main/lib/ThingsBoard/Espressif_MQTT_Client.cpp): `lib/ThingsBoard/Espressif_MQTT_Client.cpp`
- [MQTT client](https://github.com/zedattran/smart_irrigation/blob/main/lib/PubSubClient/PubSubClient.cpp): `lib/PubSubClient/PubSubClient.cpp`

### Other components

- **Device operator**

## Connections

- Device operator → Firmware entry: starts device
- Firmware entry → Status check: checks status (evidence: `src/main.cpp`)
- Firmware entry → Status LED: starts task (evidence: `src/main.cpp`)
- Firmware entry → NeoPixel LED: starts task (evidence: `src/main.cpp`)
- Firmware entry → Climate monitor: starts task (evidence: `src/main.cpp`)
- Firmware entry → CoreIOT task: starts task (evidence: `src/main.cpp`)
- Firmware entry → Wi-Fi management: reconnects Wi-Fi (evidence: `src/main.cpp`)
- Firmware entry → Web server: reconnects server (evidence: `src/main.cpp`)
- Firmware entry → Web server: stops server (evidence: `src/main.cpp`)
- Shared state → Climate monitor: shares measurements
- Climate monitor → DHT20 sensor: reads sensor
- Climate monitor → LCD display: updates display
- Climate monitor → Anomaly model: evaluates readings
- TinyML runtime → Anomaly model: uses model
- Web-server task → Web server: runs server
- Web server → Web interface script: serves interface
- CoreIOT task → CoreIOT client: runs client
- CoreIOT client → ThingsBoard MQTT: uses transport
- CoreIOT client → MQTT client: uses MQTT
- Firmware entry → RS485 task: may start task
- Firmware entry → Boot toggle: may start task
