ESPHome: tus propios sensores con un ESP32

Descripción general

ESPHome convierte una placa barata (ESP32, ESP8266, RP2040…) en un dispositivo de Home Assistant. Describes en YAML qué hay conectado a cada pin (un sensor, un relé, un LED), ESPHome genera el firmware y la placa se conecta a Home Assistant por su API nativa, cifrada y en tiempo real. Sin programar y sin MQTT.

Esquema: tu YAML se compila en firmware para la placa ESP32, que habla en tiempo real con Home Assistant por la API nativa cifrada en el puerto 6053 — Del YAML a la placa y de la placa a Home Assistant.

Esquema: NODARA.

Requisitos

Una placa ESP32 (o compatible) y lo que quieras conectarle.
La app ESPHome Device Builder (Ajustes → Aplicaciones) para crear, compilar y actualizar las placas. La primera vez se graba por USB desde el navegador; después, por Wi-Fi.
Home Assistant descubre la placa sola. Si no, añade la integración con su IP, el puerto 6053 y la clave de cifrado (api: encryption: key).
Fuente: documentación oficial de ESPHome y esphome.io.

Ideas de uso

Sensor de movimiento casero con un PIR. Es el ejemplo de abajo.
Proxy Bluetooth: una placa en cada planta y Home Assistant llega a todos los sensores Bluetooth de la casa.
Sensores de temperatura, humedad o CO₂ a medida, por pocos euros.
Relés para la puerta del garaje o el riego.
Pantallas y LED que muestran datos de Home Assistant.
Asistente de voz: el Voice Preview Edition funciona con ESPHome.

Ejemplo de uso

El YAML de la placa, en ESPHome Device Builder:

esphome:
  name: sensor-salon
  friendly_name: Sensor del salón

esp32:
  board: esp32dev

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

api:
  encryption:
    key: !secret api_key

ota:
  - platform: esphome

logger:

bluetooth_proxy:

binary_sensor:
  - platform: gpio
    pin: GPIO13
    name: "Movimiento"
    device_class: motion

Cómo funciona:

api con encryption activa la conexión cifrada con Home Assistant; la clave se genera al crear la placa.
ota permite actualizar el firmware por Wi-Fi las siguientes veces.
bluetooth_proxy convierte la placa en una antena Bluetooth más para Home Assistant.
El sensor PIR en el pin GPIO13 aparece como binary_sensor.sensor_del_salon_movimiento: el nombre de la entidad junta el friendly_name y el name.
Por seguridad, la opción Permitir que el dispositivo ejecute acciones de Home Assistant viene desactivada; actívala solo en placas de confianza.

Acción

PIR en GPIO13 detecta movimiento

Resultado

binary_sensor.sensor_del_salon_movimiento = on
al instante, por la API nativa