Casa inteligente · Ecossistemas de casa inteligente
Home Assistant Matter e Thread: roteadores de borda, IPv6, VLANs e compartilhamento de dispositivos
O Home Assistant é um software de automação residencial de código aberto executado no seu próprio hardware. Sua integração Matter adiciona dispositivos Matter pelo app Companion, e sua integração Thread acompanha as redes Thread da casa.
- Funciona em
- O Home Assistant OS é a instalação compatível com o app Matter Server; o app não é compatível com plataformas de 32 bits
- Adicionar dispositivos
- Apenas o app Companion: Android 8.1 ou posterior (12 recomendado) ou iOS 16 ou posterior
- Roteadores de borda Thread
- Home Assistant Yellow, Connect ZBT-1 ou ZBT-2 com o app OpenThread Border Router, ou uma central Apple ou Google
- Rede
- O multicast IPv6 deve alcançar o host do Home Assistant; uma rede plana única é a melhor opção
O que o Home Assistant faz com Matter e Thread
Adicionar a integração Matter no Home Assistant OS instala o app oficial Matter Server, que executa as funções do Matter. O Home Assistant apresenta o OS como sua opção recomendada e a única compatível. Executar o Matter Server por conta própria no Docker não é compatível, e dispositivos Matter baseados em Thread exigem Home Assistant OS 10 ou posterior.
Novos dispositivos são adicionados pelo app Companion em um telefone, não pelo navegador. No Android, instale o app Companion completo pela Play Store e permita a Localização o tempo todo. No iPhone, use a versão mais recente do app Companion.
A integração Thread aparece quando o Home Assistant encontra um roteador de borda. Ela armazena as credenciais de cada rede Thread, que funcionam como uma senha Wi-Fi, e permite escolher uma rede preferida para novos dispositivos.
Roteadores de borda Thread
O Home Assistant pode usar roteadores de borda de outros ecossistemas ou funcionar como um deles.
- Redes separadas: os roteadores de borda de cada fabricante geralmente formam sua própria rede Thread com credenciais próprias. Os dispositivos não podem alternar entre elas.
- Celular e roteador de borda: para adicionar dispositivos Thread de um celular Android, o Home Assistant indica Nest Hub (2ª geração) ou Nest Wifi Pro; de um iPhone, HomePod mini ou HomePod (2ª geração), ou Apple TV 4K. O próprio roteador de borda do Home Assistant funciona com ambos.
- Connect ZBT-1: não é mais fabricado, mas ainda recebe atualizações. O Home Assistant recomenda seu firmware Zigbee; o Thread funciona, mas ainda está sendo aprimorado. Para novos compradores, o Home Assistant indica o ZBT-2.
- Multiprotocolo (Zigbee e Thread em um único rádio) continua experimental e não é recomendado.
- Posicionamento: use o cabo de extensão USB. Portas USB 3 causam interferência que pode prejudicar Zigbee e Thread.
| Roteador de borda | Notas |
|---|---|
| Home Assistant Yellow, Connect ZBT-1 ou Connect ZBT-2 | Com o app OpenThread Border Router; o Home Assistant pode configurá-lo e controlá-lo |
| Google Nest Hub (2ª geração), Nest Hub Max, Nest Wifi Pro, Nest Wifi, Google TV Streamer | Configurado pelo Google Home; utilizável, mas não gerenciado |
| HomePod (2ª geração), HomePod mini, Apple TV 4K (2ª geração) e Wi-Fi + Ethernet da 3ª geração | Configurado pelo Apple Home; utilizável, não gerenciado |
| Outros, como dispositivos Nanoleaf ou Amazon | Utilizável, não gerenciado |
Compartilhar credenciais Thread com o celular
Android: no app Companion, abra Configurações › Companion app › Solução de problemas.
Toque em Sincronizar credenciais Thread.
No iPhone: abra Ajustes › Conectividade › Thread.
Toque em Enviar credenciais para o celular na caixa da rede preferida.
O que precisa da sua rede
O Home Assistant é especialmente específico aqui. O Matter foi projetado para redes domésticas comuns, e sua documentação alerta sobre ajustes “avançados” comuns.
- IPv6: o tráfego multicast IPv6 precisa circular livremente da rede até o host do Home Assistant. Defina o IPv6 como Automático ou estático em Configurações › Sistema › Rede. Não é necessária uma conexão de internet IPv6 nem um servidor DHCPv6.
- Roteamento IPv6 para Thread: o host, o roteador e qualquer camada Docker ou de hipervisor precisam rotear ou encaminhar IPv6.
- Multicast: ajustes de roteador ou ponto de acesso que “otimizam” multicast podem impedir a descoberta do Matter. IGMP snooping com falha e filtragem multicast também causam problemas.
- Wi-Fi mesh: alguns sistemas mesh filtram multicast, o que pode impedir que o celular encontre o roteador de borda. Verifique os ajustes de multicast, IGMP snooping e mDNS.
- VLANs: coloque dispositivos Matter Wi-Fi e roteadores de borda Thread na mesma VLAN que o Home Assistant. Mantenha a rede o mais simples e plana possível.
- 2,4 GHz: o telefone deve estar na mesma rede de 2,4 GHz que o dispositivo Matter Wi-Fi durante a adição.
Matter e compartilhamento de dispositivos com outros ecossistemas
Adicionar um dispositivo que o Apple Home ou Google Home já controla
Verifique se o app Companion está na versão mais recente.
Abra Configurações › Conectividade › Matter e selecione Adicionar dispositivo.
Selecione Sim. Ele já está em uso. e escolha o controlador, como Google Home.
Siga as etapas, nomeie o dispositivo, escolha uma área e selecione Concluir.
Compartilhar um dispositivo do Home Assistant com outro controlador
Abra Ajustes › Conectividade › Matter › Dispositivos e selecione o dispositivo.
Selecione Compartilhar dispositivo e depois Compartilhar dispositivo novamente. Não é necessário pressionar um botão no dispositivo.
No outro app, escaneie o QR code ou digite o código de compartilhamento.
Para verificar, abra o menu de três pontos do dispositivo e selecione Gerenciar fabrics.
Para remover outro controlador, apague-o em Gerenciar fabrics. No Apple Home, remova também o acessório da lista de acessórios Matter da Apple nas Chaves do iCloud.
Problemas comuns e soluções do Home Assistant
- “Você precisa usar o app Home Assistant Companion”: dispositivos só podem ser adicionados pelo app de celular, não pelo navegador.
- O Android informa que o Matter está indisponível: aguarde até 24 horas para que o Google Play Services baixe os módulos Matter. Depois, reinstale o app Companion ou o Google Home.
- Parado em “Verificando conectividade de rede”: mantenha o telefone perto do roteador de borda e do dispositivo. Para dispositivos Wi-Fi, use 2,4 GHz.
- “Este dispositivo precisa de um roteador de borda”: configure um, ou transforme o Home Assistant em um, e sincronize as credenciais Thread dele com o celular.
- “O nó de destino não processou o arquivo de atualização”: os roteadores de borda da Apple não encaminham os pacotes mDNS necessários às atualizações Matter. Adicione um roteador de borda que não seja da Apple ou desligue os da Apple por pelo menos 30 minutos e tente novamente.
- Dispositivos indisponíveis aleatoriamente ou erros de comissionamento: verifique as regras de rede acima, especialmente VLANs, ajustes de multicast e topologia plana.
- Precisa de mais detalhes: baixe o diagnóstico pelo menu de três pontos da integração Matter ou do dispositivo.
Perguntas
O Matter no Home Assistant precisa de IPv6?
Sim, na rede local. O multicast IPv6 precisa alcançar o host do Home Assistant, mas você não precisa de IPv6 da operadora de internet nem de um servidor DHCPv6.
Dispositivos Matter do Home Assistant podem ficar em uma VLAN separada?
O Home Assistant desaconselha: dispositivos Matter Wi-Fi e roteadores de borda Thread devem estar na mesma VLAN que o Home Assistant.
Posso usar meu HomePod ou Nest Hub como roteador de borda Thread do Home Assistant?
Sim. O Home Assistant pode usar roteadores de borda da Apple e do Google, embora apenas os apps de cada fabricante possam configurá-los.
Fontes
- Home Assistant: integração Matter
- Home Assistant: integração Thread
- Home Assistant: integração OpenThread Border Router
- Home Assistant: conectar o ZBT-1
- Ajuda do Google Home e Nest: prepare sua casa inteligente para Matter
- Suporte da Apple: emparelhar e gerenciar acessórios Matter
Verificado em 1º de novembro de 2026.
Veja sua rede doméstica a partir do Mac
O Kilobat é um app de barra de menus para Mac com uma CLI e um servidor MCP para agentes de IA. Ele lista os dispositivos no Wi-Fi e informa quando um novo entra, mantém um histórico da saúde do roteador e da internet, analisa canais próximos e mostra qual app do Mac usa a rede. Leia a documentação.
brew install seifip/kilobat/kilobat