Aziz Bench

Generador de configuraciones ESPHome

Elige la placa, añade sensores y salidas y obtén una configuración lista para cargar, con las claves de API y OTA generadas en tu navegador. Los pines que podrían impedir que la placa arranque se señalan antes de que conectes nada.

Ir al YAML generado ↓
Dispositivo
Framework

En las versiones actuales de ESPHome, ESP-IDF es el framework por defecto para el ESP32. Elige Arduino solo si lo necesita algún componente que vayas a usar.

Letras minúsculas, números y guiones. Se convierte en el nombre en la red, por ejemplo sensor-node.local.

Sensores y salidas

Todavía no hay componentes: añade uno de la lista de abajo.

Red y Home Assistant

Si el WiFi falla, la placa abre su propia red para que introduzcas nuevas credenciales desde el móvil.

Ahorra uno o dos segundos en cada conexión, algo que importa con el deep sleep.

Las claves y contraseñas se generan en tu navegador y solo se guardan ahí, así que seguirán siendo las mismas cuando vuelvas. Crea unas nuevas para cada dispositivo nuevo.

Extras

sensor-node.yaml

esphome:
  name: sensor-node
  friendly_name: "Nodo de sensores"

esp32:
  board: esp32dev
  framework:
    type: esp-idf

logger:

api:
  encryption:
    key: "GENERATED-IN-YOUR-BROWSER"

ota:
  - platform: esphome
    encryption:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  ap:
    ssid: "Nodo de sensores Fallback"
    password: "GENERATED-IN-YOUR-BROWSER"

captive_portal:

sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature:
      name: "Clima temperatura"
    humidity:
      name: "Clima humedad"
    update_interval: 60s
  - platform: wifi_signal
    name: "Señal WiFi"
    update_interval: 60s
  - platform: uptime
    name: "Tiempo encendido"

switch:
  - platform: gpio
    pin: GPIO26
    name: "Relé"
    restore_mode: RESTORE_DEFAULT_OFF
secrets.yaml 
wifi_ssid: "YourNetworkName"
wifi_password: "YourWiFiPassword"

Guarda este archivo junto a la configuración, en la carpeta de ESPHome, y escribe en él el nombre y la contraseña de tu WiFi.

Cómo usar el archivo

Instala ESPHome, ya sea como el complemento ESPHome Device Builder en Home Assistant o con pip install esphome en tu ordenador. Guarda la configuración con el nombre del dispositivo, por ejemplo sensor-node.yaml, y pon en la misma carpeta un secrets.yaml con el nombre y la contraseña de tu WiFi.

La primera vez carga el firmware por USB, con esphome run sensor-node.yaml o desde el Device Builder. Después, las actualizaciones van por WiFi. Home Assistant encuentra el dispositivo en la red y te pide la clave de cifrado de la API, que está en la configuración.

Pines que pueden impedir que la placa arranque

Algunos pines se leen en el reset para decidir cómo arranca el chip. En el ESP32 son los GPIO 0, 2, 5, 12 y 15; en el ESP8266, D3, D4 y D8. Un sensor o un módulo de relé que fuerce uno de ellos al nivel equivocado al encender puede dejar la placa bloqueada. El generador marca estos pines en las listas; el pinout interactivo del ESP32 explica cada uno.

Actualizaciones OTA cifradas

Desde la versión 2026.9, ESPHome puede cifrar las actualizaciones por red con la misma clave que la API de Home Assistant, y lo recomienda en lugar de la antigua contraseña OTA. El generador usa el cifrado por defecto. Si tu ESPHome es más antiguo, elige la opción con contraseña o actualiza antes ESPHome.

Deep sleep con batería

Con deep sleep la placa se despierta, envía sus lecturas y vuelve a dormir. Una IP estática acorta la conexión y ahorra energía en cada despertar. Para estimar cuánto dura la batería con tu intervalo de despertar, usa la calculadora de autonomía para ESP32.

Preguntas frecuentes

¿Necesito Home Assistant para usar ESPHome?

No. La API es para Home Assistant, pero ESPHome también funciona por su cuenta con la página web en el puerto 80, o con MQTT. Sin Home Assistant puedes desactivar la opción de la API y activar la página web.

¿Dónde pongo la contraseña del WiFi?

En secrets.yaml, un archivo aparte en la misma carpeta que la configuración. La configuración solo hace referencia a él con !secret wifi_ssid y !secret wifi_password, así que puedes compartir el YAML sin exponer tu contraseña.

¿Para qué sirve la clave de cifrado de la API?

Cifra el tráfico entre el dispositivo y Home Assistant. Home Assistant te la pide cuando añades el dispositivo. Con la OTA cifrada, la misma clave protege también las actualizaciones del firmware.

¿Por qué ESPHome me avisa de un pin de strapping?

El chip lee los pines de strapping en el reset para decidir cómo arrancar. Usarlos está permitido, pero un circuito que los fuerce al nivel equivocado al encender puede impedir que la placa arranque. Es mejor elegir otros pines, o asegurarte de que nada los controla durante el arranque.

¿Qué placa elijo para una ESP32 DevKit genérica?

esp32dev sirve para la mayoría de las placas con módulo ESP32-WROOM-32, incluidas la DevKitC y la DOIT DevKit V1 de 30 pines. Elige las opciones C3 o S3 solo si el chip de tu placa es un ESP32-C3 o un ESP32-S3.

¿Puedo añadir más sensores más adelante?

Sí. Edita el YAML en ESPHome y vuelve a cargarlo por WiFi. También puedes volver a esta página: tus ajustes y tus claves se quedan guardados en tu navegador.