Plugin do Home Assistant: guia completo para os principais complementos e integrações.

Informatec Digital » Recursos » Plugin do Home Assistant: guia completo para os principais complementos e integrações.

Se você atua no mundo da automação residencial, mais cedo ou mais tarde vai se deparar com isso. O Home Assistant e seu enorme ecossistema de plug-ins, complementos e integraçõesO problema é que, ao pesquisar algo tão específico como "plug-in para Home Assistant", o que você encontra é uma confusão de informações: complementos, integrações, HACS, Matter, Zigbee, Z-Wave... e no final você não sabe por onde começar.

Neste guia, vamos organizar tudo isso. Vejamos O que exatamente é um plug-in no Home Assistant, quais são os tipos existentes e quais são os mais importantes? Para configurar uma casa inteligente estável, segura e fácil de manter. Também revisaremos conceitos-chave de Zigbee, Z-Wave, MQTT, Matter e as melhores práticas para evitar que sua rede se torne um pesadelo sempre que você atualizar ou adicionar um novo dispositivo.

O que significa realmente "plug-in" no Home Assistant?

Quando falamos de "plug-ins" no Home Assistant, na verdade estamos nos referindo a várias coisas diferentes: complementos, integrações e extensões da comunidade (HACS)Compreender a diferença é essencial para evitar problemas durante a instalação ou atualização.

De um lado estão os add-onsSão pequenos aplicativos ou serviços que são executados dentro do Home Assistant OS ou do Home Assistant Supervised. Não são configurações simples; são serviços completos (servidores MQTT, editores de código, proxies, VPNs, etc.) que o Supervisor gerencia como contêineres, com sua própria configuração e registros.

Então nós temos o integraçõesEssas são as integrações que permitem ao Home Assistant se comunicar diretamente com seus dispositivos ou serviços: Zigbee, Z-Wave, Philips Hue, câmeras, serviços em nuvem, etc. Elas são gerenciadas na seção Integrações da interface e são a maneira "oficial" de conectar dispositivos ao sistema.

E, finalmente, há HACS (Loja Comunitária de Assistentes Domésticos), que funciona como uma loja comunitária de plugins: cartões Lovelace, integrações não oficiais, temas e ferramentas que não vêm por padrão, mas expandem muito o que você pode fazer.

Um detalhe importante: Os complementos estão disponíveis apenas no Home Assistant OS e no Home Assistant Supervised.Porque essas são as variantes que incluem o Supervisor. Se você usar o Home Assistant Container ou Core instalado "puro" no Linux, poderá usar integrações, mas terá que configurar os complementos manualmente como serviços separados.

Complementos essenciais para o bom funcionamento do Home Assistant.

Existem dezenas de complementos, mas alguns são praticamente essenciais. Elementos estruturais para o funcionamento de uma casa inteligente modernaEles não são os mais chamativos, mas sem eles tudo o resto desmorona como um castelo de cartas.

Z-Wave JS (anteriormente Zwavejs2mqtt)

Se você utiliza dispositivos Z-Wave, o complemento Z-Wave JS é o núcleo do sistema. Ele funciona como uma ponte entre sua rede Z-Wave e o Home Assistant.Gerenciar o dongle USB (como o Aeotec Z-Stick 7 Plus) e expor sensores, luzes, tomadas, fechaduras e outros dispositivos como entidades no HA.

Em muitas casas, a maioria dos sistemas de automação mais críticos (luzes, interruptores, sensores de movimento, abridores de portas de garagem, até mesmo) são automatizados. parte do alarme) dependem de dezenas de dispositivos Z-WaveSem esse complemento, esses dispositivos simplesmente não existiriam para o Home Assistant.

Zigbee: Zigbee2MQTT e ZHA

No mundo Zigbee, você tem dois caminhos principais: Zigbee2MQTT como um complemento ou ZHA (Zigbee Home Automation) como uma integração nativa.Ambos transformam seu coordenador USB Zigbee no centro de uma rede mesh de sensores, tomadas, lâmpadas e controles remotos.

ZHA, por outro lado, é o Integração oficial do Zigbee no Home Assistant.Utilize a biblioteca zigpy para se comunicar com diferentes tipos de coordenadores (Silicon Labs, Texas Instruments, ConBee/RaspBee, ZiGate, XBee…) e configurar a rede diretamente da interface HA, sem a necessidade de um serviço intermediário.

Em ambos os casos, o que eles procuram é o mesmo: Configure uma rede Zigbee estável com um coordenador, vários roteadores e diversos dispositivos finais., aproveitando a malha para ter alcance e capacidade suficientes.

Zigbee em detalhes com ZHA: conceitos que você precisa entender

A integração da ZHA tornou-se Uma das maneiras mais robustas e simples de integrar o Zigbee ao Home Assistant.Ele permite substituir os hubs proprietários típicos (Hue, Aqara, etc.) e centralizar tudo em um único sistema local.

Noções básicas de Zigbee

Antes de se preocupar com dispositivos e emparelhamentos, vale a pena entender como o Zigbee funciona. A rede é composta por Existem três tipos de elementos: coordenador, roteadores e dispositivos finais..

• Coordenador ZigbeeEste é o adaptador principal (normalmente um dispositivo USB conectado ao mesmo computador onde o Home Assistant está sendo executado). Cada rede Zigbee só pode ter um.
• Roteadores ZigbeeDispositivos alimentados pela rede elétrica (tomadas, lâmpadas, ventiladores…) que repetem o sinal e permitem ampliar o alcance e o número de nós.
• Dispositivos finaisGeralmente são alimentados por bateria (sensores de movimento, sensores de temperatura, controles remotos, etc.) e estão conectados ao coordenador ou a um roteador próximo.

A chave do Zigbee é que ele forma uma rede meshOs roteadores transmitem mensagens uns para os outros, permitindo alcançar áreas da casa distantes do coordenador sem a necessidade de aumentar a potência de transmissão.

Seleção do coordenador e compatibilidade

A ZHA trabalha com muitos coordenadores diferentes, desde que eles sejam compatível com a biblioteca zigpyOs recomendados utilizam chips da Silicon Labs EmberZNet (EZSP) ou da Texas Instruments (Z-Stack) e também são compatíveis com ConBee/RaspBee da Dresden Elektronik.

Há mais hardware compatível (ZiGate, XBee, modelos mais antigos da Silabs ou da TI), mas a própria documentação deixa claro que Nem todos os adaptadores estão no mesmo nível em termos de estabilidade e suporte.Se você pretende instalar um sistema de grande porte, é recomendável optar por um coordenador moderno e com histórico comprovado.

Canais Zigbee e coexistência com Wi-Fi

O Zigbee de 2,4 GHz usa 16 canais entre o dia 11 e o dia 26.O problema é o coexistência com Wi-FiÉ fácil que haja sobreposição entre os canais. A recomendação geral é usar os canais 15, 20 ou 25, que geralmente evitam os maiores problemas de sobreposição com os canais Wi-Fi domésticos típicos.

A partir da página da rede ZHA, você pode Alterar o canal ZigbeeExiste uma opção "Inteligente" que analisa e escolhe a que parece melhor, priorizando as opções 15, 20 e 25. Essa alteração é feita apenas uma vez: os dispositivos podem levar até uma hora para se reconectarem, então é melhor fazê-la quando você tiver um tempo livre.

Gerenciamento e migração de rede Zigbee

O ZHA não se limita ao emparelhamento de dispositivos. Ele inclui Informações detalhadas da rede (canal, ID PAN, endereço IEEE do coordenador, tipo de rádio, porta serial, taxa de transmissão, etc.) E, acima de tudo, um sistema de backup e migração de coordenadores muito poderoso.

Ao fazer uma cópia do ZHA, você pode migre toda a sua rede para outro adaptador. (por exemplo, de um dongle antigo para um mais novo) sem precisar emparelhar todos os dispositivos novamente. O processo pode até clonar o endereço IEEE do coordenador para que os nós continuem reconhecendo a rede como a mesma.

Como emparelhar, organizar e manter uma rede Zigbee estável

Uma coisa é o ZHA detectar o seu coordenador, e outra é a rede funcionar sem problemas. Grande parte do sucesso reside em como você posiciona os dispositivos, quais roteadores utiliza e como evita interferências..

Emparelhe dispositivos com ZHA

Para adicionar um novo dispositivo com o ZHA, basta acessar Configurações > Zigbee > Adicionar dispositivoAbra a rede para permitir novas conexões e coloque o dispositivo no modo de emparelhamento ou realize uma restauração de fábrica (de acordo com as instruções do fabricante).

Recomenda-se emparelhar os dispositivos. exatamente onde eles vão morarNão os coloque perto do coordenador e depois os mova. Se você os emparelhar perto do coordenador e depois os mover para o fundo da casa, eles podem acabar com rotas subótimas ou instáveis.

Se algo estiver se mostrando difícil, três coisas precisam ser verificadas: interferência, quantidade e qualidade dos roteadores e estado da bateriaMuitos dispositivos Zigbee com baterias fracas simplesmente não entram no modo de emparelhamento de forma confiável.

Limites de uso e dispositivos do roteador Zigbee

Todos os coordenadores têm um limite de dispositivos de controle parental (dispositivos finais conectados diretamente a ele). O Zigpy normalmente funciona com um máximo de 32 dispositivos filhos diretos, mas isso não significa que a rede esteja limitada a 32 dispositivos: com roteadores, você pode facilmente alcançar centenas.

A ideia é encher a casa com Roteadores Zigbee sempre ligadosTomadas, lâmpadas que nunca precisam ser desligadas pelo interruptor físico, módulos embutidos, etc. Cada roteador, por sua vez, pode aceitar vários dispositivos filhos, e é assim que se faz a expansão.

Em um exemplo simples, um coordenador com limite de 32 dispositivos e três roteadores que aceitam 16 dispositivos cada poderiam alcançar um total de cerca de 77 unidades. Em residências reais, se você busca confiabilidade, o mais sensato é... Priorize sempre mais roteadores e um melhor posicionamento. em vez de explorar os limites teóricos dos dispositivos.

Visualização da topologia e qualidade dos links

A ZHA inclui um mapa de rede que permite que você Veja como os nós se conectam uns aos outros.Exibe relações de múltiplos saltos e, se reportadas pelo dispositivo, os valores de RSSI e LQI.

Esses números devem ser encarados com cautela: Cada fabricante calcula o RSSI e o LQI à sua maneira.Portanto, não são comparáveis ​​ao milímetro. São mais úteis para detectar problemas graves: um dispositivo conectado a um único roteador distante, valores consistentemente muito baixos, falhas inesperadas na rede mesh, etc.

Interferência e posicionamento do coordenador

Um dos maiores inimigos do Zigbee é o ruído do Portas e cabos USB 3.x, Roteadores Wi-Fi e caixas de metalUm adaptador Zigbee conectado a um NAS com discos rígidos, um roteador Wi-Fi e vários cabos é quase garantia de problemas.

As diretrizes básicas para aprimorar a rede são claras: Utilize um cabo extensor USB 2.0 bem blindado e coloque o coordenador no centro da casa, longe de roteadores Wi-Fi e outros dispositivos que emitam ruído.E, se possível, use um dongle com antena externa.

MQTT, Mosquitto e por que eles são tão importantes.

Muitos plug-ins importantes do Home Assistant dependem de MQTT como uma camada de comunicação leve e flexívelÉ o caso do Zigbee2MQTT, de algumas pontes Z-Wave mais antigas e de muitos projetos "faça você mesmo".

O complemento Mosquitto implementa um corretor MQTT Concluído dentro do Home Assistant

Se você abrir um cliente como o MQTT Explorer, verá uma infinidade de tópicos e mensagens circulando constantemente: Leituras de sensores, estados do dispositivo, comandos de ligar e desligarQuando suas redes Zigbee e Z-Wave são integradas via MQTT, o broker se torna um componente literalmente crítico.

Automação avançada com Node-RED e automação nativa.

O Home Assistant melhorou muito sua capacidade de... editor de automação visualVocê não precisa mais se preocupar com YAML para coisas simples... mas quando a lógica fica complexa, o Node-RED continua sendo uma ferramenta muito poderosa.

O Node-RED é instalado como um complemento e oferece Interface web onde você arrasta nós e cria "fluxos". que encadeiam condições, temporizadores, chamadas de serviço e processamento de dados. É especialmente útil para automações, onde visualizar o fluxo como um diagrama ajuda a entender o que está acontecendo.

Muitas pessoas combinam os dois mundos: Automações simples no editor nativo do Home Assistant.e fluxos de trabalho mais complexos (lógica de agendamento complexa, integração de múltiplas fontes de dados, etc.) no Node-RED. Não é obrigatório, mas oferece muita flexibilidade.

Complementos para desenvolvimento, administração e acesso remoto.

Além da camada básica de automação residencial, existem diversos plug-ins que Eles facilitam muito a vida diária, gerenciando e ampliando o Home Assistant..

Servidor Studio Code

O Studio Code Server integra uma versão de Visual Studio Code diretamente no navegadorComo um complemento para o Home Assistant, ele permite editar o arquivo configuration.yaml, automações, scripts e qualquer outro arquivo sem sair da interface.

Inclui Realce de sintaxe e autocompletar para esquemas YAML e do Home Assistant.E você pode personalizar o editor, instalar extensões e fazer upload de arquivos. Para quem ainda faz muita configuração manual, é indispensável.

SSH avançado e terminal web

Este complemento fornece um Terminal SSH acessível a partir do navegadorCom suporte para chaves e opções avançadas, é a maneira mais conveniente de executar comandos no host, revisar logs, instalar o HACS ou fazer pequenos ajustes sem depender de um cliente SSH externo.

Também é muito útil em diagnósticos: Quando algo não inicia, um log do sistema ou um comando "docker ps" executado corretamente podem ajudar. Isso evita muitos problemas.

Tailscale e Cloudflare para acesso remoto seguro

Se você deseja acessar o Home Assistant de fora de casa, existem várias opções, mas dois complementos se destacam pela segurança que oferecem: Escama de cauda e erupção de nuvem.

A escama de cauda monta um VPN em malha entre seus dispositivosBaseado no WireGuard, mas com uma configuração muito mais amigável ao usuário.

A Cloudflare, por sua vez, cria túneis criptografados da sua instância do Home Assistant para a rede CloudflareIsso permite expor alta disponibilidade à internet sem abrir portas, usando seu próprio domínio e certificados gerenciados pela Cloudflare. É uma das maneiras mais seguras e limpas de ter acesso remoto sempre disponível, ao custo de exigir um domínio e alguma configuração inicial.

Monitoramento, privacidade e serviços adicionais que fazem toda a diferença.

Depois de estabelecer as bases (Zigbee/Z-Wave, MQTT, automação e acesso remoto), é hora de... Aprimore a experiência com complementos que melhoram a visibilidade, a segurança e a conveniência..

Tempo de atividade Kuma

Uptime Kuma é uma ferramenta para monitoramento de disponibilidade Você pode usá-lo como um complemento para monitorar seu Home Assistant, outros serviços de rede, dispositivos críticos, câmeras, etc. Ele permite definir verificações HTTP, ping, portas, certificados e receber alertas caso algo dê errado.

Com seus painéis e gráficos, é fácil visualizar. padrões de corte, tempos de resposta e pequenos problemas intermitentes Isso normalmente passaria despercebido.

Página inicial do AdGuard

Integrá-lo como um complemento no Home Assistant permite que você Centralize as estatísticas de navegação, melhore a privacidade e aumente a velocidade de carregamento. em toda a rede doméstica, além de oferecer controles parentais e listas negras personalizadas.

Grocy, Jellyfin, Assistente de Música e outros serviços úteis

O Home Assistant não serve apenas para controlar luzes e tomadas. Graças aos complementos, você pode transformá-lo em... Centro nevrálgico para gestão doméstica e de lazer:

• merceariaGerenciador de estoque (despensa), tarefas domésticas e planejamento que se integra ao Home Assistant para criar lembretes e automações com base em datas de validade ou estoque.
• JellyfinServidor de mídia de código aberto que organiza e disponibiliza seus filmes, músicas e séries sem taxas ou nuvens externas.
• Assistente de músicaCamada de gerenciamento de áudio multiroom que integra fontes locais, rádios online e serviços de streaming sob controle centralizado do Home Assistant.

ESPHome, Frigate e Matter: o futuro dos plug-ins em automação residencial.

Um dos maiores pontos fortes do Home Assistant é a facilidade com que o utiliza. Aposte no "faça você mesmo" quando quiser ir além do que é vendido nas lojas.É aí que entram em cena o ESPHome, o Frigate e o Matter Bridge.

ESPHome para dispositivos DIY baseados em ESP

O ESPHome é praticamente indispensável para quem gosta de fazer experiências. Ele permite Configurar e manter dispositivos baseados em ESP8266/ESP32 (sensores, relés, displays, etc.) usando YAML e com atualizações OTA integradas.

Através do Home Assistant, você pode compilar o firmware, instalá-lo e manter todos os seus dispositivos atualizados. Isso facilita bastante o uso. Faça com que seus dispositivos DIY funcionem como se fossem integrações oficiais., com entidades perfeitamente expostas e sem depender de nuvens chinesas.

Frigate como um NVR inteligente

Frigate é um NVR (Gravador de Vídeo em Rede) com detecção de objetos por IA em tempo realEle se integra ao Home Assistant e pode acionar automações quando detecta pessoas, veículos, animais, etc., em sua propriedade. Câmeras IP.

Isso permite configurar cenários do tipo “Se houver alguém no jardim e o alarme estiver ativado, ele envia uma notificação e acende as luzes.” Com grande precisão, evitando disparos falsos devido ao movimento das árvores, chuva, etc.

Ponte de matéria e ecossistemas externos

A Matter Bridge serve como uma ponte entre Dispositivos Matter e Home Assistant sem precisar emparelhar tudo novamente. Além disso, você pode expor suas entidades do Home Assistant como dispositivos Matter para outros controladores (como Google Home, Apple HomeKit etc.).

Com uma interface simples projetada para escalabilidade, esta peça se tornará fundamental como Mais dispositivos Matter aparecerão no mercado. E você quer ter todos eles sob o controle do Home Assistant sem abrir mão dos seus assistentes de voz habituais.

Backups: o plugin que não parece urgente… até que se torna.

Por último, mas não menos importante: Se você não tiver um sistema de backup bem configurado, estará brincando com fogo.O Home Assistant é atualizado com frequência, os complementos estão em constante mudança e erros ou falhas de hardware não são ficção científica.

Complementos como o Samba Backup ou o Home Assistant Google Drive Backup permitem Automatize backups completos da sua instância e salve-os fora do dispositivo principal. (um NAS via Samba, Google Drive, etc.). A ideia é que você possa restaurar toda a instalação ou um complemento específico sem perder semanas de trabalho.

A experiência de muitos usuários deixa claro que Cedo ou tarde, uma grande reforma chegará a sua vez.Ter snapshots recentes, testados e acessíveis faz toda a diferença entre uma tarde assustadora e ter que reconstruir toda a sua casa inteligente do zero.

Com todos esses plugins e conceitos claramente explicados — desde ZHA e MQTT até complementos para desenvolvimento, monitoramento, acesso remoto e backups — fica bastante evidente que o Home Assistant é muito mais do que “um aplicativo de iluminação”: é Uma plataforma completa onde os plug-ins certos transformam uma instalação padrão em um ecossistema de automação residencial robusto e flexível, totalmente sob seu controle.desde que você dedique algum tempo a escolher bem as peças e a entender como elas se encaixam.