PT EN

DIY & firmware

Sensores com ESPHome e ESP32

Monte sensores de temperatura, presença e energia com ESP32 e ESPHome, sem programar em C: componentes, primeiro projeto e integração com o HA.

Um sensor que cabe exatamente onde você precisa. Um botão que ativa sua cena favorita. Uma telinha com a temperatura do quarto. ESP32 + ESPHome permite criar esses pequenos projetos e conectá-los ao Home Assistant.

IoT significa objetos conectados trocando informações. DIY é fazer você mesmo. Aqui, sua placa conversa com a central pela rede local; não precisa de um aplicativo de fabricante para cada projeto.

Duas formas de começar#

Diagrama original conceitual: Um dispositivo ESPHome
Diagrama conceitual original; não é foto do modelo citado. ESP32-DevKitC: placa de uso geral para conectar sensores e outros componentes. · Imagem oficial

As placas ESP32 de desenvolvimento oferecem conexões para sensores, botões e telas. Existem muitas variantes: confira o chip, a pinagem, a memória e os componentes antes de seguir uma receita.

Diagrama original conceitual: Um dispositivo ESPHome
Diagrama conceitual original; não é foto do modelo citado. M5Stack ATOM-S3: ESP32-S3 com tela, botão e conectores em uma caixinha. · Imagem oficial

O ATOM-S3 inclui uma pequena tela e um botão, úteis para controles e informações. A configuração da tela e de seus componentes é específica. Ele não deve ser confundido com ATOM Echo, que possui hardware de áudio e tem um tutorial oficial para usar o Assist.

ESPHome Device Builder: o painel dos seus projetos#

O ESPHome é um projeto de código aberto da Open Home Foundation, apoiado pela Nabu Casa. O Device Builder pode ser instalado como App no HAOS e organiza seus dispositivos pelo navegador.

Diagrama original conceitual: Um dispositivo ESPHome
Diagrama conceitual original; não é foto do modelo citado. Documentação oficial do ESPHome Device Builder, com dispositivos e seu estado de conexão. · Imagem oficial
  1. Em Configurações → Apps, abra a loja e instale ESPHome Device Builder.
  2. Inicie o App e abra a interface web.
  3. Escolha Create device / Criar dispositivo e siga o assistente de nova configuração.
  4. Confirme o tipo de placa e a rede Wi-Fi.
  5. Use Install / Instalar e siga a opção de gravação por USB. Pelo navegador, use Chrome ou Edge no computador, com acesso seguro e suporte a Web Serial.
  6. Adicione o dispositivo descoberto em Configurações → Dispositivos e serviços → ESPHome.

Após a primeira instalação e com a rede funcionando, muitas atualizações podem ser enviadas por Wi-Fi. O caminho exato depende da placa e da configuração.

Preciso saber programar?#

Você não precisa começar escrevendo C++. O ESPHome usa YAML, um arquivo que descreve os componentes e o que eles devem fazer. O assistente monta a base; projetos prontos reduzem bastante o trabalho. Sensores e telas personalizados ainda podem exigir edição desse arquivo.

Uma IA pode ser uma boa tutora: explicar cada parte, adaptar um exemplo e ajudar a interpretar erros. Um pedido útil é:

“Tenho esta placa ESP32 e este sensor. Use a documentação atual do ESPHome, explique as conexões e proponha uma configuração mínima. Não invente pinos; indique o que preciso confirmar.”

Informe o modelo exato e não inclua senhas reais no pedido. Compare a resposta com a documentação, use Validate / Validar e teste um componente por vez. Uma configuração que compila ainda precisa corresponder à ligação física.

Voz com ESP32#

Com microfone, alto-falante e configuração compatíveis, um dispositivo ESP32 pode servir como ponto de voz para o Assist. O tutorial oficial do ATOM Echo oferece instalação pelo navegador.

A placa captura e reproduz áudio; o reconhecimento e a resposta podem usar processamento local no sistema ou serviços de nuvem, conforme a configuração. Não é necessário começar por voz: um botão de cena costuma ser um projeto mais simples.

Seu primeiro projeto#

Comece com um sensor de temperatura ou botão alimentado por USB, em baixa tensão. Depois que ele aparecer no Home Assistant, crie a automação pelo editor visual. Projetos ligados à rede elétrica exigem componentes adequados e instalação por profissional qualificado.

Exemplos prontos para copiar#

Reuni uma galeria com configurações completas de ESPHome — Bluetooth Proxy, receptor de IR, dispositivos Thread e telas — prontas para copiar e adaptar ao seu Home Assistant: a galeria de exemplos de ESPHome.

Voltar ao Home Assistant.

Fontes: iniciar no ESPHome, instalar ESPHome, ESP32-DevKitC, ATOM-S3 e Nabu Casa e Open Home Foundation.

  • ESPHome
  • ESP32
  • DIY
  • YAML
  • Sensores