Avisar cuándo ventilar por temperatura

// Aviso de ventilación por temperatura: un sensor DHT11 mide la temperatura
// del aire del invernadero y, cuando supera el umbral, un LED PARPADEA para
// avisar que hay que ventilar. Mientras la temperatura esté por debajo del
// umbral, el LED queda apagado.
//
// ¿Por qué parpadea y no queda fijo? Así lo plantea el original: un LED que
// titila llama más la atención que uno encendido de forma continua. En el
// nivel avanzado, ya con pantalla y monitoreo, el aviso evoluciona a
// encendido fijo (encendido = ventilar / apagado = todo en orden).
//
// Plataforma: Arduino UNO.
// Conexión (la del esquema original): dato del DHT11 → pin 2; pata larga
// (positiva) del LED → pin 13, con su resistencia a GND. El pin 13 tiene
// además el LED integrado de la placa, útil para probar sin LED externo.
//
// Basado en: Fragmento de código del Nivel Inicial (Paso 6) — Invernadero
// Inteligente, Saberes Digitales (INET/EDUCAR 2019)
// Modernización: (1) se reemplazó el C generado por mBlock3 (_delay, _loop)
// por C++ idiomático con constantes nombradas. (2) Se usa la librería "DHT
// sensor library" de Adafruit (instalar desde el Library Manager; arrastra
// como dependencia "Adafruit Unified Sensor"), que reemplaza a la vieja
// "DHT.h" genérica del original — ya no se consigue igual. Requiere
// dht.begin() en setup(), que el código viejo no llamaba.

#include "DHT.h"

// Pin de datos del sensor y tipo de sensor (DHT11).
const int PIN_DHT = 2;
#define DHTTYPE DHT11

// LED indicador de "hay que ventilar".
const int PIN_LED_VENTILACION = 13;

// Umbral del original: por encima de 25 °C hay que ventilar.
const float UMBRAL_TEMP_C = 25.0;

// Tiempos del parpadeo del aviso (medio segundo encendido, medio apagado),
// como en el original.
const unsigned long PARPADEO_ENCENDIDO_MS = 500;
const unsigned long PARPADEO_APAGADO_MS   = 500;

// El DHT11 no admite más de una lectura por segundo (es su límite físico).
// Medimos cada 2 s: margen seguro, y la librería de Adafruit además cachea
// la lectura durante 2 s. El original pedía 1 s; 2 s es el valor honesto
// para este sensor.
const unsigned long INTERVALO_MEDICION_MS = 2000;

// Creamos el objeto del sensor: pin de datos + tipo.
DHT dht(PIN_DHT, DHTTYPE);

void setup() {
  pinMode(PIN_LED_VENTILACION, OUTPUT);
  // La librería de Adafruit necesita esta inicialización (la vieja no).
  dht.begin();
}

void loop() {
  // readTemperature() devuelve la temperatura en grados Celsius.
  float temperatura = dht.readTemperature();

  if (temperatura > UMBRAL_TEMP_C) {
    // Demasiado calor: un parpadeo del LED para avisar que hay que ventilar.
    digitalWrite(PIN_LED_VENTILACION, HIGH);
    delay(PARPADEO_ENCENDIDO_MS);
    digitalWrite(PIN_LED_VENTILACION, LOW);
    delay(PARPADEO_APAGADO_MS);
  }
  // Si la temperatura no supera el umbral, el LED simplemente queda apagado
  // (no se toca, y quedó en LOW del parpadeo anterior o del arranque).

  // Espera entre mediciones (respeta el límite del DHT11). En este nivel
  // usamos delay(): es la herramienta que ya conocemos y hace que el
  // programa se lea de arriba hacia abajo igual que su comportamiento.
  delay(INTERVALO_MEDICION_MS);
}

// Aviso de ventilación por temperatura: un sensor DHT11 mide la temperatura
// del aire del invernadero y, cuando supera el umbral, un LED PARPADEA para
// avisar que hay que ventilar. Mientras la temperatura esté por debajo del
// umbral, el LED queda apagado.
//
// ¿Por qué parpadea y no queda fijo? Así lo plantea el original: un LED que
// titila llama más la atención. En el nivel avanzado el aviso evoluciona a
// encendido fijo.
//
// Plataforma: ESP32 (DevKit v1).
// Conexión: dato del DHT11 → GPIO 4; pata larga (positiva) del LED → GPIO 16,
// con su resistencia a GND.
// Decisión de plataforma: se usa un LED EXTERNO en GPIO 16, no el LED
// integrado del DevKit (GPIO 2). Motivo: el GPIO 2 es un "strapping pin"
// (interviene en el arranque de la placa) y conviene dejarlo libre; además,
// el indicador de "ventilar" se ve mejor como un LED discreto montado en el
// invernadero. Documentado también en el README.
// Nota eléctrica: el ESP32 trabaja a 3,3 V (no 5 V como el UNO); el DHT11
// funciona bien a 3,3 V.
//
// Basado en: Fragmento de código del Nivel Inicial (Paso 6) — Invernadero
// Inteligente, Saberes Digitales (INET/EDUCAR 2019)
// Modernización: (1) C++ idiomático con constantes nombradas en vez del C
// de mBlock3; portado a ESP32. (2) Librería "DHT sensor library" de Adafruit
// (instalar desde el Library Manager con su dependencia "Adafruit Unified
// Sensor"), que reemplaza la vieja "DHT.h" del original y requiere
// dht.begin() en setup().

#include "DHT.h"

// Pin de datos del sensor y tipo de sensor (DHT11).
const int PIN_DHT = 4;
#define DHTTYPE DHT11

// LED externo indicador de "hay que ventilar".
const int PIN_LED_VENTILACION = 16;

// Umbral del original: por encima de 25 °C hay que ventilar.
const float UMBRAL_TEMP_C = 25.0;

// Tiempos del parpadeo del aviso, como en el original.
const unsigned long PARPADEO_ENCENDIDO_MS = 500;
const unsigned long PARPADEO_APAGADO_MS   = 500;

// El DHT11 no admite más de una lectura por segundo; medimos cada 2 s
// (margen seguro; la librería de Adafruit además cachea 2 s).
const unsigned long INTERVALO_MEDICION_MS = 2000;

// Objeto del sensor: pin de datos + tipo.
DHT dht(PIN_DHT, DHTTYPE);

void setup() {
  pinMode(PIN_LED_VENTILACION, OUTPUT);
  dht.begin();
}

void loop() {
  // readTemperature() devuelve la temperatura en grados Celsius.
  float temperatura = dht.readTemperature();

  if (temperatura > UMBRAL_TEMP_C) {
    // Demasiado calor: un parpadeo del LED para avisar que hay que ventilar.
    digitalWrite(PIN_LED_VENTILACION, HIGH);
    delay(PARPADEO_ENCENDIDO_MS);
    digitalWrite(PIN_LED_VENTILACION, LOW);
    delay(PARPADEO_APAGADO_MS);
  }
  // Si la temperatura no supera el umbral, el LED queda apagado.

  // Espera entre mediciones (respeta el límite del DHT11).
  delay(INTERVALO_MEDICION_MS);
}