Aprender

Home Assistant y dispositivos ESPHome en un ESP32

Intermedio

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
ESP32-C3: un multisensores de salaen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
Haz clic en el PIR para iniciar el movimiento y observa el monitor serie. La pestaña Web sirve /state.

La mayoría de los dispositivos de una casa inteligente casera son pequeños: una placa que lee unos sensores en una habitación, un relé que presiona un botón, una tira de LEDs que se desvanece. Un ESP32 los controla a todos, y ESPHome ha hecho fácil cargarlos sin escribir código. Lo que sigue siendo difícil es lo que el YAML esconde: qué pin puede usar un sensor, por qué una lectura no tiene sentido, por qué una luz parpadea al atardecer.

El circuito de arriba es un multisensor de habitación en un ESP32-C3 en Mokxi: un DHT22 para temperatura y humedad, un BH1750 para luz y un PIR para movimiento. Presiona Ejecutar, haz clic en el PIR, y el monitor serie muestra cada lectura como el mensaje que la placa publicaría. Abre la pestaña Web y los mismos valores regresan como JSON desde el propio servidor de la placa.

Dos cosas antes de empezar, porque importan. Mokxi ejecuta sketches de Arduino, no ESPHome, así que aquí cada dispositivo hace a mano lo que harían los componentes de ESPHome, y la página de ayuda muestra el YAML equivalente para cuando cargues el firmware en una placa real. Y la red está simulada, sin broker MQTT y sin salida hacia tu Home Assistant real: la placa imprime lo que enviaría en lugar de enviarlo.

¿Quieres la versión paso a paso? La lección "Inicia el curso de dispositivos para Home Assistant" recorre esto con puntos de control.

Abrir la lección

Cinco dispositivos que la gente construye primero

Mokxi tiene una plantilla para cada uno: el multisensor; un sensor de pasillo con radar que mantiene la luz encendida durante diez segundos en silencio y solo la enciende en la oscuridad; un abrepuertas de cochera con un relé en paralelo con el botón de pared y dos interruptores magnéticos; un controlador de tira WS2812 con encendido, apagado, brillo, color y efectos que se desvanecen; y un sensor de plantas que convierte una sonda capacitiva de humedad de suelo en un porcentaje calibrado con una alerta de sed.

Cada uno está cableado como lo construirías, con los sensores que se comunican con los pines de la placa a 3.3 V y los módulos que necesitan 5 V, como un PIR o una placa de radar, en su propio riel. Un pull-up de 5 V en un pin de 3.3 V es una de las formas más fáciles de dañar un ESP32, y una protoboard en el simulador es un lugar seguro para aprender a dónde va cada cable.

Movimiento no es presencia

Una pregunta común en los foros de Home Assistant es por qué un sensor de movimiento apaga las luces cuando alguien lee en el sofá. Tanto el PIR como el radar de microondas RCWL-0516 detectan movimiento, no personas. Las placas mmWave de 24 GHz que se venden para presencia, como la LD2410, también detectan a alguien sentado sin moverse, y se comunican por una conexión serie.

Mokxi modela el RCWL-0516, así que la plantilla de radar usa el truco que todos usan con un sensor de movimiento: un retardo de apagado. El pasillo cuenta como ocupado en cuanto algo se mueve, y solo se despeja después de diez segundos en silencio. ESPHome llama a la misma idea un filtro delayed_off. La plantilla es honesta sobre el límite: si te quedas perfectamente quieto el tiempo suficiente, la luz se apaga.

La puerta de la cochera, con seguridad

El abrepuertas de cochera es la construcción más popular y la que más arriesga. El patrón seguro es el que sigue el propio ejemplo de puerta de cochera de ESPHome y la mayoría de las guías de la comunidad: un relé cableado en paralelo con las terminales de bajo voltaje del botón de pared, cerrado durante medio segundo aproximadamente, nunca conectado a la red eléctrica ni al motor, y uno o dos interruptores magnéticos para que el dispositivo sepa dónde está realmente la puerta.

El relé debe arrancar apagado y nunca quedarse encendido, y nada debe anular las fotocélulas del abridor ni su reversa cuando la puerta topa con algo. La plantilla pone el pin del relé en bajo antes de configurarlo como salida para que no pueda activarse al encender, ignora una segunda pulsación dentro de un segundo y medio, y reporta un problema si la puerta no llegó a un interruptor a tiempo.

Una pulsación del botón de pared, del sketch de la puerta de cochera
digitalWrite(RELAY_PIN, HIGH);   // the relay closes across the button
pressedAt = millis();
// ...and in loop(), half a second later:
if (pressing && millis() - pressedAt >= PRESS_MS) {
  digitalWrite(RELAY_PIN, LOW);
}

Del simulador a ESPHome

Cuando el circuito se comporta bien, el paso al hardware real suele ser ESPHome. La página de ayuda de cada plantilla incluye el YAML que hace el mismo trabajo: un sensor dht y un bh1750 y un sensor binario gpio para el multisensor, una cover template con device_class garage para la puerta, una luz esp32_rmt_led_strip para la tira y un sensor adc con calibrate_linear para la sonda de la planta. Leer el sketch junto al YAML es una buena forma de entender qué hace cada componente por dentro, que es lo que necesitas el día que una lectura sale mal.

El curso de dispositivos para Home Assistant recorre los cinco, una lección por cada uno, con una verificación en cada paso que lee la simulación en ejecución. Empieza con el multisensor, porque todos los dispositivos posteriores reutilizan su patrón: leer un componente, decidir cuándo vale la pena reportar un cambio, publicarlo y servir el mismo estado a quien lo pida.

Abre este circuito en el editor. ESP32-C3: un multisensor de habitación, cableado tal como se ejecuta arriba de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Mokxi corre ESPHome?

No. Mokxi ejecuta sketches de Arduino en un ESP32-C3 simulado. Cada plantilla hace a mano lo que harían los componentes de ESPHome, y su página de ayuda muestra el YAML equivalente para cuando grabes una placa real.

¿La placa simulada puede comunicarse con mi Home Assistant?

No. La red está simulada y se queda dentro de la pestaña del navegador, sin broker MQTT. Los sketches imprimen los mensajes que publicarían y sirven su estado como JSON en la pestaña Web.

¿El RCWL-0516 es un sensor de presencia mmWave?

No. Es un sensor Doppler de microondas que detecta movimiento. Las placas mmWave como la LD2410 también detectan a alguien quieto; Mokxi no las modela.

¿Cómo se debe cablear un abridor de puerta de cochera?

A las terminales de bajo voltaje del botón de pared del abridor con un relé que arranque apagado y cierre un instante, nunca a la red eléctrica ni al motor, conservando las fotocélulas y la reversa del abridor.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.