PT EN

Passo a passo

O que é Home Assistant?

Descubra automações, voz, aplicativos, marcas, ESPHome e câmeras em uma casa conectada com Home Assistant.

Imagine dizer “hora do cinema” e ver a TV ligar, as cortinas fecharem e as luzes assumirem a cor que você escolheu. Ou entrar no corredor à noite e encontrar uma luz suave, acesa apenas enquanto você precisa dela.

O Home Assistant reúne aparelhos compatíveis e transforma essas ideias em controles, cenas e automações. É gratuito, de código aberto e dá prioridade ao controle local. O Home Assistant OS (HAOS) cuida da instalação, das atualizações e dos Apps: é o caminho deste guia.

Um painel para a casa inteira#

Luzes, TVs, ar-condicionados, ventiladores, termostatos, interruptores (switches), tomadas, cortinas e alarmes podem aparecer no mesmo painel. Você escolhe os cômodos, os controles e as informações que fazem sentido para sua família.

Diagrama original conceitual: Controles em um painel
Diagrama conceitual original, não uma captura de tela. Consulte as instruções vinculadas para a interface atual. Instruções oficiais

RGBCCT combina cores RGB com ajuste da temperatura do branco. Assim, uma lâmpada ou fita compatível pode oferecer luz branca para trabalhar, um tom quente para jantar e cores para uma noite de cinema. Brilho e funções disponíveis dependem do produto.

Você controla pelo navegador, celular, voz ou automação. Um comando para ar-condicionado pode usar uma integração de rede ou um emissor infravermelho compatível; neste último caso, nem sempre há confirmação do estado real do aparelho.

As marcas conversam através do Home Assistant#

O catálogo oficial apresenta mais de 1.500 integrações. Elas conectam marcas, aparelhos e serviços; não é necessário que todos sejam do mesmo fabricante.

Como conectar cada marca?
  • LGTVs webOS com controle local; eletrodomésticos ThinQ usam outra integração, em nuvem.
  • SamsungTVs compatíveis pela rede local; outros aparelhos podem usar SmartThings, em nuvem.
  • Tuya / Smart LifeA integração oficial usa nuvem. Dispositivos Zigbee compatíveis podem entrar direto no ZHA.
  • AqaraSensores Zigbee compatíveis pelo ZHA; produtos Matter ou HomeKit seguem outro caminho.
  • SonyTVs Bravia compatíveis: volume, entradas e reprodução, conforme o modelo.
  • EveAcessórios HomeKit pelo HomeKit Device; versões Matter pela integração Matter.
  • Tapo / TP-LinkTomadas, interruptores, luzes e câmeras suportadas; confira a lista e a autenticação.
  • ReolinkVídeo e eventos locais nos modelos suportados; aparelhos a bateria têm requisitos próprios.
  • IntelbrasCâmeras com ONVIF Profile S compatível ou fluxo RTSP. Nem toda a linha oferece esses recursos.
  • Philips HueLuzes e cenas locais pela Hue Bridge. Lâmpadas Zigbee compatíveis também podem usar ZHA.
  • EpsonProjetores de rede compatíveis: energia e seleção de entrada para a cena de cinema.

Antes de comprar, confira modelo, firmware e funções disponíveis. Uma integração pode atender várias marcas; uma marca pode usar várias integrações.

Créditos dos logotipos · Marcas de seus respectivos titulares. Exemplos, sem vínculo oficial.

Uma TV LG, um sensor Aqara e uma luz Philips Hue podem participar da mesma automação. A compatibilidade é do modelo e da função, não apenas da marca. TVs LG webOS e Samsung têm opções locais; LG ThinQ e SmartThings usam nuvem nas respectivas integrações.

Cenas de luz: a mesma sala, seis climas#

Depois de escolher as lâmpadas, o que muda a casa de verdade são as cenas. Clique ou toque nas imagens ou nos botões para simular a iluminação em RGB, branco dia, leitura, manhã, pôr do sol e luz noturna.

RGBCCT junta duas coisas em uma lâmpada ou fita de LED: RGB, os LEDs coloridos, e CCT (temperatura de cor correlata), os LEDs brancos que vão do branco quente, parecido com vela, ao branco frio, parecido com o céu de meio-dia. A medida é em kelvin (K): 2.200 K é âmbar, 2.700 K é a lâmpada incandescente de antigamente, 4.000 K é neutro e 6.500 K é o branco azulado. Cor muda o clima; temperatura do branco muda o quanto o ambiente parece manhã ou noite.

Uma cena é um conjunto de estados salvos com nome: quais luzes acendem, em que cor, brilho e temperatura. É ela que transforma decoração fixa em decoração que muda ao longo do dia. Clique ou toque na imagem ou nos botões para trocar a cena aplicada. A simulação usa filtros de cor sobre imagens geradas por IA: a ideia é mostrar o efeito, não reproduzir um produto.

Imagens geradas por IA para o SmartHome-AI; cenas simuladas. Cores, brilho e transições reais dependem do produto e da integração.

Cinco cenas que valem a pena criar

Amanhecer

Começa em 1% e 2.200 K e sobe devagar até 60% e 4.000 K em 20 minutos, antes do alarme. Use transition na ação de luz ou a integração Adaptive Lighting, que segue o sol sozinha.

Branco dia e leitura

Branco neutro a frio (4.000–5.500 K) com brilho alto para trabalhar e ler. Fitas atrás de prateleiras e sob armários dão luz uniforme, sem sombras duras.

Pôr do sol

Ao entardecer, tons âmbar (2.200–2.700 K) a 30–40%, com um toque de laranja na sanca. Um gatilho de sunset na automação faz a casa acompanhar o horário do ano.

Home cinema

TV ou projetor ligado, cortinas fechadas, luz de contorno atrás da tela e um filete de luz no chão. Quando o filme pausa, as luzes sobem um pouco; quando volta, descem de novo.

Luz noturna

Entre 1% e 5% em 1.800–2.200 K, acesa por sensor de presença de madrugada e apagada depois de dois minutos. Ilumina o caminho sem acordar ninguém.

No Home Assistant, crie cenas no editor visual e chame-as em automações, botões ou por voz. Cenas no Home Assistant · Ações de luz e transição · Adaptive Lighting

Home cinema

O ritual em um toque.

A cena de cinema é o exemplo clássico porque envolve vários aparelhos ao mesmo tempo: o media player (TV, Apple TV, projetor) liga e escolhe a entrada, a cortina fecha, o ar-condicionado ajusta e as luzes assumem o tom da noite. No Home Assistant, isso vira um script ou uma cena com transição de alguns segundos, disparado por um botão físico, pelo painel, pela Siri ou por uma frase no Assist.

A luz de contorno (bias light) atrás da TV reduz o contraste entre a tela brilhante e a parede escura. A referência de cinema é um branco neutro de 6.500 K em brilho baixo; para efeito de ambiente, muita gente prefere cor. Sistemas como Hue Play HDMI Sync ou fitas endereçáveis com WLED podem acompanhar as cores do filme; o Home Assistant ainda cuida do resto da cena.

Uma automação simples fecha o ciclo: quando o estado do media player muda para pausado, as luzes sobem para 30% em dois segundos; quando volta a tocando, descem de novo. Ao desligar a TV, a cena “Noite” assume.

Philips Hue Entertainment · WLED

Music Assistant

A trilha sonora da casa.

Music Assistant é um projeto da Open Home Foundation que funciona como uma biblioteca musical única para a casa. Instala-se como App no HAOS (ou em Docker) e reúne serviços como Spotify, Apple Music, YouTube Music, Tidal, Deezer, Qobuz, rádios, podcasts e arquivos locais em uma só interface.

Do outro lado, ele toca em quase qualquer caixa: Sonos, Google Cast, AirPlay (HomePod e Apple TV), DLNA, Squeezelite e até um ESP32 com ESPHome, com grupos multi-room sincronizados. A integração oficial do Home Assistant expõe cada player como media player, permite transferir a fila entre cômodos e pausa a música para avisos de voz.

É o que fecha a cena: “Pôr do sol” pode acender a sanca em âmbar e iniciar uma playlist tranquila a 20% de volume na sala; “Home cinema” silencia as caixas da cozinha antes do filme começar. Com o Assist, dá para pedir uma música por voz e o pedido cai no player do cômodo onde você está.

music-assistant.io · Integração no Home Assistant

Automações: a parte mais divertida#

Pense em três perguntas: quando acontece, em quais condições e o que fazer? O editor visual organiza exatamente isso.

  • Ao chegar: acender a entrada se já estiver escuro.
  • Ao abrir a janela: pausar a climatização, se a integração permitir.
  • Ao anoitecer: fechar cortinas e escolher uma iluminação acolhedora.
  • Ao detectar alguém no portão: enviar uma notificação com imagem, usando uma câmera ou NVR compatível.
  • Ao sair: avisar se alguma porta ou janela ficou aberta.
Diagrama original conceitual: Uma automação
Diagrama conceitual original, não uma captura de tela. Consulte as instruções vinculadas para a interface atual. Instruções oficiais

Uma cena guarda estados desejados, como as luzes e cortinas para o cinema. Uma automação decide quando aplicar esses estados. Você pode criar ambas pelas telas. Blueprints são modelos reutilizáveis para certas automações: escolha um confiável e preencha os dispositivos pedidos.

Crie sua primeira automação sem código.

Alexa, Google Nest e Assist: pode falar#

Você pode usar Alexa em um Echo ou Google Assistant em um Google Nest para acionar os dispositivos e cenas que disponibilizar. O Home Assistant Cloud, da Nabu Casa, simplifica essa conexão. Esses serviços dependem da internet e têm limites próprios para tipos de aparelho e comandos.

O Assist é o assistente de voz do Home Assistant. Funciona no celular e em equipamentos dedicados. Com processamento, idioma e hardware adequados, pode trabalhar localmente; também pode usar os serviços de voz do Home Assistant Cloud.

Diagrama original conceitual: Uma conversa com a casa
Diagrama conceitual original; não é foto do modelo citado. Home Assistant Voice Preview Edition ao lado do Green. · Imagem oficial

Também existem pontos de voz feitos com ESP32 e ESPHome, como o ATOM Echo. Eles captam sua fala e a encaminham ao Home Assistant. Uma placa ESP32 comum precisa dos componentes de áudio adequados; o ATOM-S3 com tela não é, sozinho, esse conjunto.

O app no bolso e a casa ao alcance#

O aplicativo Home Assistant Companion, para iOS e Android, mostra seu painel e pode receber avisos. No iPhone, iPad ou Android, você consulta sensores, controla aparelhos e vê as câmeras integradas.

Com sua permissão, o telefone também pode informar localização e outros sensores para automações. Em casa, a conexão pode ser local. Fora de casa, é necessário configurar um caminho de acesso remoto, como Home Assistant Cloud ou VPN. O app não substitui a central que permanece ligada em casa.

Nabu Casa: praticidade e apoio ao projeto#

A assinatura opcional Home Assistant Cloud oferece acesso remoto criptografado sem abrir portas no roteador, conexão facilitada com Alexa e Google, backup na nuvem e processamento de voz para o Assist.

A Nabu Casa é parceira comercial da Open Home Foundation, organização dos projetos Home Assistant e ESPHome. A assinatura ajuda a financiar esse desenvolvimento. Você pode usar automações locais sem contratar o serviço.

Conheça as vantagens e a ativação pelas telas.

E quem gosta do app Casa da Apple?#

O ecossistema Apple Home / HomeKit é mais fechado, com critérios próprios de compatibilidade. A integração HomeKit Bridge permite levar funções suportadas do Home Assistant ao app Casa e à Siri, inclusive de dispositivos sem HomeKit nativo.

Você escolhe o que compartilhar. Nem todos os recursos têm equivalente no app Casa. Para acesso remoto por ele, é necessária uma central Apple compatível, como HomePod ou Apple TV. Acessórios Matter ampliam a interoperabilidade.

Conecte o Home Assistant ao app Casa.

IoT e DIY: crie o que está faltando#

IoT é a internet das coisas: objetos conectados trocando informações, inclusive dentro da sua rede local. DIY é fazer você mesmo. Uma placa ESP32 pode virar um sensor de temperatura, um botão de cena ou um pequeno painel.

Diagrama original conceitual: Um dispositivo ESPHome
Diagrama conceitual original; não é foto do modelo citado. ESP32-DevKitC: placa de desenvolvimento de uso geral, com componentes identificados. · Imagem oficial
Diagrama original conceitual: Um dispositivo ESPHome
Diagrama conceitual original; não é foto do modelo citado. M5Stack ATOM-S3: uma opção compacta com tela e botão. · Imagem oficial

O ESPHome, projeto da Open Home Foundation apoiado pela Nabu Casa, oferece o App Device Builder no HAOS. O assistente cria uma configuração inicial. Projetos prontos ajudam você a começar; personalizações costumam usar YAML, uma descrição do dispositivo, sem escrever um programa em C++.

Uma IA pode explicar as opções, propor uma configuração e ajudar a entender erros. Isso torna o aprendizado mais acessível, mas ainda é preciso conferir placa, pinos e documentação e validar antes de gravar. Comece com um projeto alimentado por USB, em baixa tensão.

Conheça o ESPHome pelas telas. Lá você encontra exemplos prontos para copiar: um Bluetooth Proxy com ATOM-S3, um receptor de infravermelho, um dispositivo Thread (NanoC6), um painel de toque (tela de clima e controles) uma tela Thread com temperatura/umidade (C6-GEEK) um painel de parede 7" para a casa toda (Waveshare 7B) um assistente de voz com tela (AtomS3R + Echo Base) e um leitor RFID/NFC com tela (AtomS3R + RFID 2).

Câmeras que ajudam a entender o que acontece#

Ver a imagem no painel já é útil. Um NVR, sistema que grava e organiza os vídeos, acrescenta histórico e eventos. O Frigate pode detectar pessoas, carros e animais conforme o modelo de IA e fornecer eventos ao Home Assistant.

Diagrama original conceitual: Vídeo na casa conectada
Diagrama conceitual original; não é foto do modelo citado. Documentação oficial do Frigate NVR com várias câmeras. · Imagem oficial

O reconhecimento facial compara rostos com uma biblioteca cadastrada e pode funcionar localmente, em hardware compatível. Já modelos de visão podem descrever ações, como alguém deixando uma caixa, usando processamento local ou nuvem conforme o provedor.

Esses recursos são adicionais, exigem configuração e podem errar. Use-os para enriquecer avisos; não para decidir sozinhos destrancar portas ou desarmar alarmes. Gravação e análise de várias câmeras precisam de armazenamento e processamento dimensionados.

Veja os próximos passos para câmeras e IA.

Local, remoto e automático: cada coisa no seu lugar#

Local: com aparelhos e integrações locais, as regras continuam sem internet, desde que a central, a rede e os dispositivos estejam ligados. Integrações de nuvem continuam dependendo dos serviços externos.

Remoto: você acessa a central de fora de casa por uma conexão configurada e protegida. Normalmente, isso exige internet nos dois lados.

Automático: sensores, horários e eventos iniciam regras na central, sem você precisar abrir o app.

Zigbee e Thread são especialmente interessantes para sensores a pilha: baixo consumo e rede em malha. Aparelhos adequados podem repetir o sinal. Eles precisam de uma central ou roteador de borda apropriado; Wi-Fi e Ethernet continuam úteis para câmeras, TVs e maior tráfego. Vamos detalhar isso depois, começando por ZHA + ZBT-2.

Dê o primeiro passo#

Você não precisa fazer tudo isso hoje. Escolha uma central, conecte uma luz e crie uma regra. A melhor parte é poder crescer no seu ritmo.

Escolher o hardware · Instalar o HAOS · Entender Zigbee.

Referências: catálogo de integrações, automações, cenas, Assist, aplicativos, HomeKit Bridge, Nabu Casa, ESPHome e Frigate.

  • Home Assistant