Mascote do HectorziN
Blog do HectorziN

Guia Completo: Instalação do ZHA e do Zigbee2MQTT no Home Assistant com SMLIGHT SLZB-07

Se queres melhorar a estabilidade e o alcance da tua rede Zigbee no Home Assistant, a escolha do coordenador é fundamental. Neste artigo, vamos ver passo a passo como configurar o SMLIGHT SLZB-07MG24, um dongle USB compacto e potente que se destaca pela grande capacidade de memória (RAM e Flash) e pelo excelente isolamento electrónico. O melhor deste dispositivo é que, graças ao seu design, normalmente não requer o habitual cabo prolongador USB para evitar interferências, e o seu tamanho permite ligá-lo juntamente com outros USB sem bloquear portas vizinhas.

No YouTube compartilho mais tutoriais, testes praticos e automacao residencial real. Inscrever-se no YouTube

Coordenador Zigbee SMLIGHT SLZB-07 ligado por USB configurado no Home Assistant com ZHA e Zigbee2MQTT

Video relacionado no YouTube

Video

1. Preparação: Drivers e Firmware

Antes de ligares o dispositivo ao Home Assistant, é aconselhável garantir que temos os controladores necessários e o firmware actualizado.

Instalação de Drivers (Windows)

Se utilizas o Home Assistant numa máquina virtual sobre Windows, vais precisar dos drivers do chip Silicon Labs CP210x.

  1. Descarrega os drivers a partir da página oficial da Silicon Labs.
  2. Descompacta o ficheiro e clica com o botão direito sobre o ficheiro .inf para seleccionares Instalar.

Actualização do Firmware

A SMLIGHT facilita bastante este processo com uma ferramenta web:

  1. Vai a SMLIGHT Flasher.
  2. Liga o teu dongle e selecciona o modelo exacto no menu da esquerda.
  3. Clica em Update e segue os passos para instalar a versão mais recente (ex.: v7.4.4).

2. Configuração em Máquinas Virtuais (VirtualBox)

Se usas VirtualBox, tens de "passar" o dispositivo USB da máquina real para a virtual:

  1. Vai a Configuração > USB.
  2. Clica no ícone de "Adicionar filtro" e selecciona o dongle (aparecerá como Silicon Labs).
  3. Aceita e reinicia a máquina virtual, se necessário.

3. Instalação do ZHA (Zigbee Home Automation)

O ZHA é a integração nativa do Home Assistant. É a opção mais simples para começar.

  1. Detecção automática: Ao ligares o dongle, o Home Assistant deverá mostrar uma notificação de "Novo dispositivo descoberto". Clica em Configurar.
  2. Configuração manual: Se não aparecer, vai a Definições > Dispositivos e Serviços > Adicionar Integração e procura Zigbee Home Automation.
  3. Selecciona a porta série correspondente (normalmente /dev/ttyUSB0 ou semelhante).
  4. Escolhe "Manter a configuração de rede actual" para finalizar.

4. Instalação do Zigbee2MQTT (Z2M)

Para utilizadores que procuram maior compatibilidade com dispositivos específicos ou uma gestão externa à base de dados do Home Assistant, Zigbee2MQTT é a opção ideal.

Importante: Não podes ter o ZHA e o Zigbee2MQTT activos ao mesmo tempo com o mesmo dongle. Se configuraste o ZHA, tens de o remover primeiro.

Pré-requisito: Mosquitto Broker

Deves ter instalado o complemento Mosquitto Broker e um utilizador configurado no Home Assistant.

Passo a passo para Z2M:

  1. Vai a Definições > Complementos > Loja de complementos.
  2. Clica nos três pontos (no canto superior direito) > Repositórios.
  3. Adiciona o URL: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
  4. Procura e instala o complemento Zigbee2MQTT.

Configuração YAML do Zigbee2MQTT

Abre o separador Configuração do complemento e adapta o código seguinte (alterando as tuas credenciais):

yaml
mqtt:
  server: mqtt://localhost:1883
  user: tu_usuario_mqtt
  password: tu_password_mqtt
serial:
  port: /dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_... # Sustituye por tu ID real
  adapter: ezsp
Nota técnica: Para o modelo SLZB-07MG24 (chip Silicon Labs), é essencial adicionar a linha adapter: ezsp (ou ember nas versões mais recentes do Z2M) para que a comunicação seja correcta.

Para encontrares o caminho exacto da porta, vai a Definições > Sistema > Hardware > Todo o hardware e procura "serial".

5. O Conselho de Ouro para a Estabilidade

Embora este modelo SLZB-07 tenha um excelente isolamento, recomendo sempre que vigies as interferências com o Wi-Fi de 2.4GHz. Se notares atrasos, tenta mudar o canal da tua rede Zigbee (o canal 25 costuma estar mais livre) ou, apesar disso, usa um pequeno prolongador USB se o teu servidor tiver muitos componentes electrónicos por perto.

E pronto! Já tens a tua rede Zigbee a funcionar com um dos melhores coordenadores qualidade-preço do mercado.

Queres ver o processo em vídeo? Podes ver o tutorial passo a passo aqui: Como Instalar ZHA e Zigbee2MQTT no HOME ASSISTANT no meu canal HectorziN | Domótica y Home Assistant.

Espero que este rascunho te sirva para o blog de HectorziN | Domótica y Home Assistant. Muito sucesso com o artigo!

Onde comprar

Se SMLIGHT SLZB-07MG24 interessa a voce, aqui estao as opcoes de compra disponiveis:

Video relacionado

CUPONS ALIEXPRESS
Guia Completo: Instalação do ZHA e do Zigbee2MQTT no Home Assistant com SMLIGHT SLZB-07 | HectorziN