Como adicionar dispositivos Z-Wave ao Home Assistant

 

Introdução

Quer adicionar um interruptor, sensor, fechadura, termóstato ou outro dispositivo Z-Wave ao Home Assistant? O processo básico é simples: primeiro, certifique-se de que o Home Assistant tem uma ligação Z-Wave funcional; em seguida, utilize o método de inclusão adequado para adicionar o dispositivo à rede.

Se estiver a começar do zero, precisará primeiro de um adaptador Z-Wave compatível. Este guia explica a configuração básica do Z-Wave no Home Assistant, como escolher um adaptador e os principais passos para adicionar dispositivos.  

A SONOFF disponibiliza duas opções de adaptadores Z-Wave para diferentes configurações: Dongle-PZG23 (USB Dongle Plus) para utilização direta por USB e Dongle-MZG23 (PoE Dongle Max) para uma utilização mais flexível por USB ou baseada em rede.  

 

1. O que precisa antes de adicionar um dispositivo Z-Wave

Antes de começar, certifique-se de que tem:  

● Uma instalação funcional do Home Assistant. O Home Assistant OS é o tipo de instalação recomendado para a maioria dos utilizadores e suporta a aplicação oficial Z-Wave JS. Se utilizar o Home Assistant Container, terá de executar um servidor Z-Wave JS separadamente.  

● Um adaptador Z-Wave compatível. Este fornece a ligação de rádio à sua rede Z-Wave. Também poderá encontrar este hardware referido como um controlador Z-Wave; os modelos USB são frequentemente chamados dongles.  

● A integração Z-Wave do Home Assistant e um servidor Z-Wave JS. Para a maioria dos utilizadores do Home Assistant OS, a configuração recomendada é a integração Z-Wave + a aplicação Z-Wave JS.  

● Um dispositivo final Z-Wave para a sua região. O Z-Wave utiliza frequências de rádio diferentes em regiões diferentes, por isso verifique a compatibilidade regional antes de comprar.  

● As instruções e as informações de segurança do fabricante do dispositivo. Tenha disponíveis durante a configuração as instruções de inclusão/exclusão e qualquer código QR, DSK ou PIN.  

O software do Home Assistant, por si só, não fornece um rádio Z-Wave. Precisa de hardware Z-Wave compatível e da camada de software que liga a rede Z-Wave ao Home Assistant.  

👉 Para consultar os requisitos atuais e as opções de configuração, consulte a documentação da integração Z-Wave do Home Assistant.

👉 Para obter informações sobre as frequências regionais, consulte as orientações do Home Assistant sobre a definição da região de radiofrequência do adaptador Z-Wave.  

 

2. Escolha um adaptador Z-Wave para o Home Assistant

A principal decisão é onde posicionar o adaptador Z-Wave e como ligá-lo ao Home Assistant.

● Escolha USB se o host Home Assistant tiver uma porta USB acessível e permitir um posicionamento adequado do adaptador.

● Considere um adaptador ligado à rede se pretender posicionar o rádio separadamente do host, especialmente quando o host se encontra dentro de um armário metálico ou rack de servidores.

SONOFF Dongle-PZG23: adaptador USB Z-Wave simples

O SONOFF Dongle-PZG23 é um adaptador USB Z-Wave da série 800 baseado no chip EFR32ZG23.

É uma opção simples para ligar um controlador Z-Wave ao host Home Assistant através de USB. O cabo de extensão USB incluído permite posicionar o adaptador afastado do host e de equipamentos USB próximos.

O posicionamento é importante: mantenha o rádio afastado de caixas metálicas e de potenciais fontes de interferência, em vez de escolher a localização apenas por existir uma porta USB disponível. Consulte as orientações do Z-Wave JS sobre o posicionamento do controlador e a interferência para obter recomendações práticas.

 

SONOFF Dongle-MZG23: implementação USB ou em rede flexível

O SONOFF Dongle-MZG23 (PoE Dongle Max) também utiliza o chip Z-Wave EFR32ZG23 e suporta ligações Ethernet, Wi-Fi e USB.

As opções de ligação à rede são úteis quando pretende colocar o controlador separadamente do host Home Assistant. Escolha um local com acesso adequado à rede e à alimentação.

Para uma implementação Ethernet, utilize equipamento PoE compatível para fornecer dados e alimentação, ou ligue a Ethernet para os dados e forneça a alimentação separadamente através de USB-C.

👉 Siga o guia de alimentação e ligação do Dongle-MZG23 para conhecer as configurações suportadas.

A principal vantagem da implementação em rede é a flexibilidade de posicionamento. O método de ligação, por si só, não garante um alcance Z-Wave superior, menor latência ou maior fiabilidade.

Comparação rápida

● Se o seu anfitrião do Home Assistant já tiver uma localização adequada e uma porta USB disponível, o Dongle-PZG23 proporciona uma configuração mais simples.

● Se a colocação do adaptador tiver de ser independente do anfitrião do Home Assistant, o Dongle-MZG23 oferece mais opções de implementação. 

 

3. Formas de ligar um adaptador Z-Wave ao Home Assistant

O Home Assistant utiliza a integração Z-Wave para se ligar a um servidor Z-Wave JS, que comunica com o seu adaptador. As opções abaixo mostram como o servidor e a gestão dos dispositivos podem ser implementados. Para a maioria dos principiantes que utilizam o Home Assistant OS, comece pela primeira opção.

Para a configuração recomendada do Home Assistant OS, siga as instruções de instalação para configurar o seu controlador. Para obter instruções específicas do produto e informações sobre outras configurações suportadas, consulte:

👉 Guia de configuração do Dongle-PZG23 no Home Assistant

👉 Guia de configuração do Dongle-MZG23 no Home Assistant

 

 

4. Como adicionar um dispositivo Z-Wave ao Home Assistant

Depois de configurar o adaptador Z-Wave e o servidor Z-Wave no Home Assistant, pode adicionar dispositivos Z-Wave individuais à rede.

No Home Assistant:

1. Aceda a Definições → Conectividade → Z-Wave. 

2. Selecione Adicionar dispositivo. O Home Assistant colocará o adaptador Z-Wave no modo de inclusão. 

3. Verifique se o dispositivo suporta SmartStart.

4. Siga o método de inclusão adequado:

• • SmartStart: Com o dispositivo desligado, leia o respetivo código QR Z-Wave e siga as instruções. Se for disponibilizada essa opção, selecione Long Range ou Mesh, conforme apropriado. Ligue o dispositivo e siga quaisquer instruções adicionais do fabricante.
  • Inclusão clássica: Coloque o dispositivo no modo de inclusão de acordo com as instruções do fabricante.

5. Conclua qualquer pedido de segurança, se necessário. Para uma inclusão protegida por S2, o Home Assistant poderá solicitar o PIN fornecido com o dispositivo.  

6. Aguarde até o Home Assistant confirmar que o dispositivo foi adicionado e até a configuração estar concluída; depois, verifique as entidades ou os eventos disponíveis.  

👉 Para consultar o procedimento completo e atualizado, incluindo SmartStart, segurança S2, Long Range e resolução de problemas, siga o guia oficial do Home Assistant para adicionar um novo dispositivo à rede Z-Wave.

Nota: Mantenha o controlador Z-Wave no seu local habitual durante a inclusão e inicie o processo a partir da interface Z-Wave do Home Assistant, em vez de o iniciar no próprio controlador.

Depois de o dispositivo ser adicionado

Depois de a inclusão ser concluída, o Z-Wave JS entrevista o dispositivo para identificar as respetivas capacidades suportadas. O Home Assistant disponibiliza então as funções através de entidades ou eventos.

Pode ser necessário ativar manualmente os dispositivos alimentados por bateria antes de a entrevista terminar.
Após a conclusão da configuração, teste as funções que pretende utilizar, como ligar uma tomada, abrir um sensor de contacto, verificar uma leitura de temperatura ou acionar um evento de botão.

👉 Se um dispositivo aparecer no Home Assistant, mas faltarem algumas funções, consulte as orientações do Home Assistant sobre dispositivos Z-Wave com entidades em falta ou indisponíveis.

Mover um dispositivo Z-Wave de outro hub

Um dispositivo Z-Wave não pode aderir a uma nova rede enquanto ainda estiver emparelhado com outro controlador. Se o dispositivo ainda estiver ligado a um hub anterior, exclua-o dessa rede antes de o adicionar ao Home Assistant.

Se o hub original estiver disponível, utilize o respetivo processo de exclusão e siga as instruções do fabricante do dispositivo. Se o hub original já não estiver disponível, pode utilizar o processo de exclusão de dispositivo externo do Home Assistant.

Inicie a exclusão no Home Assistant e, em seguida, siga as instruções do fabricante para colocar o dispositivo no modo de exclusão. Quando a exclusão estiver concluída, prossiga com a adição do dispositivo à rede controlada pelo Home Assistant.  

👉 Para obter instruções detalhadas, consulte o guia do Home Assistant para remover um dispositivo de uma rede Z-Wave externa.

Perguntas frequentes

P1: Preciso de um adaptador Z-Wave para o Home Assistant?

Sim. O software Home Assistant não inclui um rádio Z-Wave, pelo que necessita de um adaptador Z-Wave compatível para comunicar com dispositivos Z-Wave.

Se estiver a iniciar uma nova configuração Z-Wave, o Home Assistant recomenda a utilização de um adaptador da série 800 com firmware atual. O adaptador funciona com o Z-Wave JS e a integração Z-Wave do Home Assistant para gerir a rede.

P2: Posso utilizar um dongle Zigbee para Z-Wave?

Não. Zigbee e Z-Wave utilizam protocolos de rádio diferentes, pelo que um dongle exclusivamente Zigbee não pode funcionar como adaptador Z-Wave.

Utilize antes hardware concebido para Z-Wave. Atualmente, a SONOFF disponibiliza duas opções Z-Wave da série 800: Dongle-PZG23 para utilização por USB e Dongle-MZG23 para utilização por USB ou através da rede. 

P3: Qualquer dispositivo Z-Wave funciona com o Home Assistant?

O Home Assistant e o Z-Wave JS são compatíveis com muitos dispositivos Z-Wave comuns, mas a compatibilidade pode variar consoante o dispositivo e as Command Classes Z-Wave que utiliza. Um dispositivo pode ligar-se à rede com sucesso, mesmo que algumas funcionalidades específicas do fabricante não sejam disponibilizadas no Home Assistant.

Antes de comprar, certifique-se também de que o dispositivo utiliza a frequência Z-Wave correta para a sua região.

P4: Por que motivo o meu dispositivo Z-Wave não tem entidades no Home Assistant?

As entidades são criadas depois de o Z-Wave JS terminar a entrevista do dispositivo. Pode ser necessário acordar manualmente os dispositivos alimentados por bateria para que a entrevista seja concluída.

Além disso, nem todos os dispositivos Z-Wave criam entidades padrão. Alguns comandos remotos com botões, por exemplo, geram principalmente eventos. Se a entrevista tiver sido concluída, mas as entidades esperadas continuarem em falta, consulte as orientações do Home Assistant sobre dispositivos Z-Wave com entidades em falta.