Aziz Bench

Gerador de configuração ESPHome

Escolha a placa, adicione sensores e saídas e receba uma configuração pronta para gravar, com as chaves de criptografia da API e do OTA geradas no seu navegador. Os pinos que podem impedir a placa de dar boot são sinalizados antes de você ligar qualquer fio.

Ir para o YAML gerado ↓
Dispositivo
Framework

Nas versões atuais do ESPHome, o ESP-IDF é o framework padrão para o ESP32. Escolha Arduino só se algum componente de que você precisa exigir isso.

Letras minúsculas, números e hífens. Ele vira o hostname, por exemplo sensor-node.local.

Sensores e saídas

Nenhum componente ainda: adicione um da lista abaixo.

Rede e Home Assistant

Se o Wi-Fi falhar, a placa abre a própria rede para você digitar novas credenciais pelo celular.

Economiza um ou dois segundos a cada conexão, o que faz diferença com deep sleep.

As chaves e senhas são geradas no seu navegador e salvas só nele, então continuam as mesmas quando você volta. Crie novas para cada dispositivo novo.

Extras

sensor-node.yaml

esphome:
  name: sensor-node
  friendly_name: "Nó 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: "Nó de sensores Fallback"
    password: "GENERATED-IN-YOUR-BROWSER"

captive_portal:

sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature:
      name: "Clima temperatura"
    humidity:
      name: "Clima umidade"
    update_interval: 60s
  - platform: wifi_signal
    name: "Sinal WiFi"
    update_interval: 60s
  - platform: uptime
    name: "Tempo de atividade"

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

Salve este arquivo ao lado da configuração, na pasta do ESPHome, com o nome e a senha do seu Wi-Fi.

Como usar o arquivo

Instale o ESPHome, seja como o add-on ESPHome Device Builder no Home Assistant, seja com pip install esphome no seu computador. Salve a configuração com o nome do dispositivo, por exemplo sensor-node.yaml, e coloque na mesma pasta um secrets.yaml com o nome e a senha do seu Wi-Fi.

Grave a placa pela primeira vez via USB, com esphome run sensor-node.yaml ou pelo Device Builder. Depois disso, as atualizações vão pelo Wi-Fi. O Home Assistant descobre o dispositivo na rede e pede a chave de criptografia da API, que está na configuração.

Pinos que podem impedir a placa de dar boot

Alguns pinos são lidos no reset para decidir como o chip inicia. No ESP32 são os GPIO 0, 2, 5, 12 e 15; no ESP8266, D3, D4 e D8. Um sensor ou módulo relé que puxe um deles para o nível errado ao ligar pode deixar a placa travada. O gerador marca esses pinos nas listas; a pinagem interativa do ESP32 explica cada um.

Atualizações OTA criptografadas

Desde a versão 2026.9, o ESPHome pode criptografar as atualizações pela rede com a mesma chave da API do Home Assistant, e recomenda isso no lugar da antiga senha de OTA. O gerador usa criptografia por padrão. Se o seu ESPHome for mais antigo, escolha a opção com senha, ou atualize o ESPHome primeiro.

Deep sleep com bateria

Com deep sleep (sono profundo), a placa acorda, envia as leituras e volta a dormir. Um IP estático encurta a conexão e economiza energia a cada despertar. Para estimar quanto tempo uma bateria dura com o seu intervalo entre despertares, use a calculadora de autonomia de bateria para ESP32.

Perguntas frequentes

Preciso do Home Assistant para usar o ESPHome?

Não. A API é para o Home Assistant, mas o ESPHome também funciona sozinho com a página web na porta 80, ou com MQTT. Sem Home Assistant, você pode desligar a opção da API e ativar a página web.

Onde coloco a senha do Wi-Fi?

No secrets.yaml, um arquivo separado na mesma pasta da configuração. A configuração só faz referência a ele com !secret wifi_ssid e !secret wifi_password, então você pode compartilhar o YAML sem expor sua senha.

Para que serve a chave de criptografia da API?

Ela criptografa o tráfego entre o dispositivo e o Home Assistant. O Home Assistant pede a chave quando você adiciona o dispositivo. Com OTA criptografado, a mesma chave também protege as atualizações de firmware.

Por que o ESPHome me avisa sobre um pino de strapping?

O chip lê os pinos de strapping no reset para decidir como dar boot. Usar esses pinos é permitido, mas um circuito que os puxe para o nível errado ao ligar pode impedir a placa de iniciar. Prefira outros pinos, ou garanta que nada os controle durante o boot.

Qual placa escolher para um ESP32 DevKit genérico?

esp32dev serve para a maioria das placas com módulo ESP32-WROOM-32, incluindo o DevKitC e o DOIT DevKit V1 de 30 pinos. Escolha as opções C3 ou S3 só se o chip da sua placa for um ESP32-C3 ou um ESP32-S3.

Posso adicionar mais sensores depois?

Sim. Edite o YAML no ESPHome e envie de novo pelo Wi-Fi. Você também pode voltar a esta página: suas configurações e chaves ficam salvas no seu navegador.