ESPHome no Home Assistant
esphome
parte do Home Assistant desde 0.85
A integração ESPHome conecta dispositivos baseados em micro controladores ESPHome ao Home Assistant, permitindo automação residencial. É usada para controlar sensores, interruptores, câmeras e outros componentes via protocolos como MQTT e descoberta de rede.
Utilização típica
- Segurança residencial com sensores e alarmes
- Projetos DIY com micro controladores
- Controle remoto via radiofrequência
- Atualizações de firmware automatizadas
Factos sobre esta integração
- Compatível com o Home Assistant
- sim, integração oficial
- Ligação
- Local, empurrar – Fala com o dispositivo em sua própria rede e é informado sobre cada mudança imediatamente.
- Configurar
- na interface do utilizador
- Tipo
- Dispositivo único
- Escala de qualidade
- Platina – O nível mais alto: totalmente tipado, eficiente e mantido em todas as regras do projeto.
- Instalações
- 155.106 (21,6 % das instalações que partilham estatísticas)
- Categorias
- Alarme, DIY, Infravermelho, Radiofrequência, Serial, Atualizar
- Fornece
- Painel de controle de alarme, Satélite de voz, Sensor binário, Botão, Câmera, Clima, Coberturas, Data, Data e hora, Diagnósticos, Evento, Ventilador, Luz, Bloquear, Reprodutor de mídia, Número, Seleccionar, Sensor, Interruptor, Texto, Tempo, Atualizar, Válvula, Aquecedor de água
- Encontrado automaticamente através de
- Descoberta de rede (Zeroconf), Descoberta de rede (DHCP), MQTT
- Mantido por
- @jesserockz, @kbx81, @bdraco, @arturpragacz
- Pacotes Python
aioesphomeapi==46.21.0, esphome-dashboard-api==1.4.0, bleak-esphome==4.0.0
Configurar
- Home Assistant pode encontrar esta integração por conta própria: se for sugerido em Definições → Dispositivos e serviços, confirme-o lá.
- No Home Assistant abrir Definições → Dispositivos e serviços.
- Clique em "Adicionar integração" e procure por ESPHome.
- Siga o diálogo – pede tudo o que a integração precisa.
Adicionar ao meu Home Assistant
O link passa por my.home-assistant.io e abre o diálogo de configuração em sua própria instância – nenhum endereço nosso está envolvido.
Complementos compatíveis
Complementos que declaram uma conexão a esta integração em sua própria configuração.
Blueprints que usam esta integração
- Automação NSPanel Configuration
- Automação NSPanel Easy Configuration (v2026.10.7)
- Automação Automatic door unlock
- Automação Send a camera snapshot when doorbell was activated
- Automação Automatic door unlock
- Automação ESPHome Device Update
Problemas e correções conhecidos
No rastreador de problemas do Home Assistant estão registados para ESPHome 26 problemas abertos e 43 correções de erros nos últimos doze meses. Se algo não funcionar, atualize primeiro: a correção mais recente incluída com Home Assistant 2026.10.0.
Abrir
- aberto O assistente satélite usa a URL errada em vez da interna.
- aberto Sensores mostram mais casas decimais do que o esperado após a atualização.
- aberto Dispositivos configurados com hostname voltam para IP frequentemente.
- aberto Sensores ignoram a configuração de casas decimais definida.
- aberto O painel mostra erros de conexão mesmo quando o construtor de dispositivos é parado intencionalmente.
- aberto A automação do botão de pressão longa ativa quando a conexão é restaurada.
- aberto A informação de fuso horário enviada para dispositivos ESPHome está incorreta.
- aberto Logs do sistema mostram problemas relacionados ao gerenciador ESPHome.
Fixo
- fixado em 2026.10.0 O modo de pré-configuração não é enviado ao ligar o ventilador ESPHome.
- fixado em 2026.10.0 O fluxo de áudio para voz para dispositivos ESPHome para abruptamente em frames vazios.
- fixado em 2026.10.0 A configuração não espera a plataforma de assistente satélite estar pronta antes de finalizar.
- fixado em 2026.10.0 O estado importado não é enviado quando a entidade é criada após a subscrição.
- fixado em 2026.10.0 O ID da casa Z-Wave não é atualizado após uma mudança, causando falhas de conexão.
- fixado em 2026.9.2 A configuração falha mesmo quando o Supervisor não está pronto.
- fixado em 2026.9.0 As informações do projeto ESPHome são usadas incorretamente para dispositivo serial.
- fixado em 2026.8.0 Chaves de criptografia antigas são usadas em vez da atual durante o fluxo de configuração.
- fixado em 2026.8.0 A adoção do painel ESPHome bloqueia o acesso a dispositivos já provisionados.
- fixado em 2026.7.2 O bloqueio de atualização global é ignorado quando há uma fila de construção no painel.
- fixado em 2026.6.2 A inicialização não espera a conexão do proxy Bluetooth estar pronta.
- fixado em 2026.6.0 A entidade de atualização fica travada em versões com sufixo de construção.
Fonte: o rastreador de problemas do Home Assistant, a partir de 25 de Outubro, 2026. As frases são escritas por um modelo de linguagem a partir dos títulos das questões; os próprios relatórios estão no GitHub.
Verifique um dispositivo específico para problemas conhecidos na verificação do produto →
Dispositivos compatíveis
Fonte desta entrada: documentação oficial da integração
A descrição foi escrita por um modelo de linguagem a partir dos fatos aqui listados, não retirado da documentação.