Proyecto 1: Comunicación Bi-direccional ESP32 - Computador

/*
  Proyecto 1: Comunicación bi-direccional ESP32 <-> Computador
  ---------------------------------------------------------------
  Flujo:
    1. El usuario presiona el botón conectado al ESP32.
    2. El ESP32 envía "BTN_PRESS" por el puerto serial (USB).
    3. La aplicación puente en el computador recibe el aviso, baja
       el brillo de la pantalla y responde con "LED_ON".
    4. El ESP32 enciende el LED al recibir "LED_ON".
    5. Un segundo click vuelve todo a su estado normal: el puente
       sube el brillo de nuevo y envía "LED_OFF".

  Protocolo serial (115200 baudios, mensajes de una línea, '\n' al final):
    ESP32 -> PC : "BTN_PRESS"
    PC -> ESP32 : "LED_ON" | "LED_OFF"
*/

const int PIN_BOTON = 4;   // Botón entre GPIO4 y GND (usa pull-up interno)
const int PIN_LED   = 2;   // LED + resistencia limitadora (~220-330 ohm) a GND

const unsigned long DEBOUNCE_MS = 50;

int estadoBotonAnterior = HIGH;
unsigned long ultimoCambio = 0;

String bufferSerial = "";

void setup() {
  Serial.begin(115200);
  pinMode(PIN_BOTON, INPUT_PULLUP);
  pinMode(PIN_LED, OUTPUT);
  digitalWrite(PIN_LED, LOW);
}

void loop() {
  leerBoton();
  leerSerial();
}

// Detecta el flanco de bajada del botón (con debounce por tiempo)
// y avisa al computador.
void leerBoton() {
  int lectura = digitalRead(PIN_BOTON);

  if (lectura != estadoBotonAnterior) {
    ultimoCambio = millis();
  }

  if ((millis() - ultimoCambio) > DEBOUNCE_MS) {
    if (lectura == LOW && estadoBotonAnterior == HIGH) {
      Serial.println("BTN_PRESS");
    }
  }

  estadoBotonAnterior = lectura;
}

// Arma línea por línea lo que llega desde el computador y ejecuta
// el comando correspondiente sobre el LED.
void leerSerial() {
  while (Serial.available() > 0) {
    char c = Serial.read();

    if (c == '\n') {
      bufferSerial.trim();

      if (bufferSerial == "LED_ON") {
        digitalWrite(PIN_LED, HIGH);
      } else if (bufferSerial == "LED_OFF") {
        digitalWrite(PIN_LED, LOW);
      }

      bufferSerial = "";
    } else if (c != '\r') {
      bufferSerial += c;
    }
  }
}