Encender y apagar el radiador por tiempo

// Calefaccion temporizada: un modulo rele enciende y apaga un radiador
// electrico siguiendo tiempos fijos, sin sensores. Es el prototipo mas
// simple del sistema: "prender 10 min, apagar 15 min", como un temporizador.
//
// !! SEGURIDAD 220V !!  El radiador es una carga de 220V conmutada por el
// rele. En el aula, usar una carga de BAJA TENSION (o directamente el LED de
// prueba del pin 13) para ver el ciclo sin riesgo. La conexion real a 220V
// queda reservada al docente o a una instalacion supervisada, y el rele con
// su cableado de 220V van SIEMPRE fuera de la protoboard (ver README).
//
// Plataforma: Arduino UNO.
// Conexion (la del esquema original): senal del modulo rele -> pin 3 (con su
// alimentacion de 5V y GND). El rele se comporta como el interruptor del
// radiador.
//
// Basado en: Fragmento de codigo del Nivel Inicial (Paso 4) - Sistema de
// Calefaccion Automatico, Saberes Digitales (INET/EDUCAR 2019)
// Modernizacion: se reemplaza el C generado por mBlock3 (_delay, _loop) por
// C++ idiomatico con constantes nombradas; los tiempos quedan como constantes
// claras en milisegundos, y el estado del rele por constantes invertibles.

// Pin de la senal del modulo rele.
const int PIN_RELE = 3;

// El modulo rele de la guia es ACTIVO-ALTO: HIGH cierra el contacto y el
// radiador se enciende. Muchos modulos comerciales son activo-bajo: si el
// tuyo enciende al reves, invertí estas dos constantes (ENCENDIDO = LOW /
// APAGADO = HIGH) y el resto del programa no cambia.
const int RELE_ENCENDIDO = HIGH;
const int RELE_APAGADO   = LOW;

// Tiempos del ejemplo original: 10 minutos encendido, 15 minutos apagado
// (600 s y 900 s en el PDF, aca expresados en milisegundos).
// NOTA PARA EL AULA: 10 y 15 minutos hacen la demostracion muy lenta. Para
// ver el ciclo en clase, bajá estos valores a algo corto, por ejemplo
// 5000UL / 5000UL (5 s encendido / 5 s apagado); una vez entendido el
// comportamiento, volvé a los tiempos reales.
const unsigned long TIEMPO_ENCENDIDO_MS = 600000UL; // 10 min
const unsigned long TIEMPO_APAGADO_MS   = 900000UL; // 15 min

void setup() {
  pinMode(PIN_RELE, OUTPUT);
  // Arrancamos con el radiador apagado.
  digitalWrite(PIN_RELE, RELE_APAGADO);
}

void loop() {
  // Encender el radiador y esperar el tiempo de encendido.
  digitalWrite(PIN_RELE, RELE_ENCENDIDO);
  delay(TIEMPO_ENCENDIDO_MS);

  // Apagar el radiador y esperar el tiempo de apagado. 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.
  digitalWrite(PIN_RELE, RELE_APAGADO);
  delay(TIEMPO_APAGADO_MS);
}

// Calefaccion temporizada: un modulo rele enciende y apaga un radiador
// electrico siguiendo tiempos fijos, sin sensores. Es el prototipo mas
// simple del sistema: "prender 10 min, apagar 15 min", como un temporizador.
//
// !! SEGURIDAD 220V !!  El radiador es una carga de 220V conmutada por el
// rele. En el aula, usar una carga de BAJA TENSION (o directamente un LED de
// prueba) para ver el ciclo sin riesgo. La conexion real a 220V queda
// reservada al docente o a una instalacion supervisada, y el rele con su
// cableado de 220V van SIEMPRE fuera de la protoboard (ver README).
//
// Plataforma: ESP32 (DevKit v1).
// Conexion: senal del modulo rele -> GPIO 25. Nota electrica: el ESP32
// trabaja a 3,3 V; usar un modulo rele con entrada compatible con 3,3 V (o
// con optoacoplador) para que conmute de forma confiable.
//
// Basado en: Fragmento de codigo del Nivel Inicial (Paso 4) - Sistema de
// Calefaccion Automatico, Saberes Digitales (INET/EDUCAR 2019)
// Modernizacion: se reemplaza el C generado por mBlock3 (_delay, _loop) por
// C++ idiomatico con constantes nombradas; los tiempos quedan como constantes
// claras en milisegundos, y el estado del rele por constantes invertibles.

// Pin de la senal del modulo rele (GPIO seguro del contrato ESP32).
const int PIN_RELE = 25;

// El modulo rele de la guia es ACTIVO-ALTO: HIGH cierra el contacto y el
// radiador se enciende. Muchos modulos comerciales son activo-bajo: si el
// tuyo enciende al reves, invertí estas dos constantes (ENCENDIDO = LOW /
// APAGADO = HIGH) y el resto del programa no cambia.
const int RELE_ENCENDIDO = HIGH;
const int RELE_APAGADO   = LOW;

// Tiempos del ejemplo original: 10 minutos encendido, 15 minutos apagado
// (600 s y 900 s en el PDF, aca expresados en milisegundos).
// NOTA PARA EL AULA: 10 y 15 minutos hacen la demostracion muy lenta. Para
// ver el ciclo en clase, bajá estos valores a algo corto, por ejemplo
// 5000UL / 5000UL (5 s encendido / 5 s apagado); una vez entendido el
// comportamiento, volvé a los tiempos reales.
const unsigned long TIEMPO_ENCENDIDO_MS = 600000UL; // 10 min
const unsigned long TIEMPO_APAGADO_MS   = 900000UL; // 15 min

void setup() {
  pinMode(PIN_RELE, OUTPUT);
  // Arrancamos con el radiador apagado.
  digitalWrite(PIN_RELE, RELE_APAGADO);
}

void loop() {
  // Encender el radiador y esperar el tiempo de encendido.
  digitalWrite(PIN_RELE, RELE_ENCENDIDO);
  delay(TIEMPO_ENCENDIDO_MS);

  // Apagar el radiador y esperar el tiempo de apagado. 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.
  digitalWrite(PIN_RELE, RELE_APAGADO);
  delay(TIEMPO_APAGADO_MS);
}