Conecte ao Home Assistant via o Zigbee do XIAO ESP32C6

A integração de dispositivos Zigbee em ecossistemas de casas inteligentes tornou‑se cada vez mais popular devido ao baixo consumo de energia, confiabilidade e facilidade de uso do Zigbee. Neste wiki, iremos guiá‑lo na conexão do XIAO ESP32C6 ao Home Assistant por meio da sua funcionalidade Zigbee. Ao final deste guia, você terá uma demonstração funcional em que o XIAO ESP32C6 atua como um dispositivo Zigbee que pode ser controlado diretamente pelo painel do Home Assistant.
Este tutorial destaca o uso do Zigbee SDK (Arduino) da Espressif e demonstra como desenvolver e integrar seus próprios dispositivos Zigbee ao Home Assistant.
Materiais Necessários
Para acompanhar este guia, você precisará do seguinte:
- Home Assistant Green: Um dispositivo de hardware dedicado do Home Assistant para gerenciar sua casa inteligente.
- Home Assistant Connect ZBT-1: Um coordenador Zigbee para habilitar a criação e comunicação da rede Zigbee.
- XIAO ESP32C6: Uma placa de desenvolvimento com funcionalidade Zigbee habilitada via SDK da Espressif.
| Home Assistant Connect ZBT-1 | XIAO ESP32C6 | Home Assistant Green |
|---|---|---|
![]() | ![]() | ![]() |
Guia Passo a Passo
Os dois primeiros passos se referem ao tutorial oficial do Home Assistant Connect ZBT-1, e você também pode ler o conteúdo desse tutorial através do link aqui.
Passo 1. Instale o Connect ZBT-1 no Home Assistant Green
Conecte o Home Assistant Connect ZBT-1 ao cabo de extensão USB. Conecte o cabo de extensão ao seu Home Assistant Green.
Portas USB 3.0 e unidades USB 3.0 podem causar interferência com protocolos de 2,4 GHz, incluindo aqueles fornecidos pelo Home Assistant Connect ZBT-1. É importante usar o cabo de extensão USB e posicionar o Home Assistant Connect ZBT-1 longe de possíveis fontes de interferência.
- Navegue até Settings na interface do Home Assistant.
- Vá para Devices & Services e localize a integração Zigbee.
- O Connect ZBT-1 agora deve ter sido descoberto.

- Selecione ADD.
- Na caixa de diálogo, selecione Zigbee.

- Selecione Submit para concluir a configuração da integração Connect ZBT-1.

- Seu Connect ZBT-1 agora é um coordenador Zigbee.
Passo 2. Crie uma Nova Rede Zigbee Usando o Connect ZBT-1
- Navegue até Settings na interface do Home Assistant.
- Vá para Devices & Services e localize a integração Zigbee.
- O Connect ZBT-1 será mostrado na sua integração Zigbee Home Automation. Selecione ADD.

- Para confirmar, selecione Submit.

- Selecione Create network.

- Siga as instruções para inicializar o coordenador Zigbee e prepará‑lo para o pareamento com dispositivos Zigbee.

Passo 3. Grave o XIAO ESP32C6 com o Programa de Exemplo Zigbee
- Configure a Arduino IDE:
- Instale a versão mais recente da Arduino IDE e adicione suporte ao XIAO ESP32C6 incluindo o pacote de placas da Espressif.
Se você estiver usando o XIAO ESP32C6 pela primeira vez, leia o link do wiki abaixo para adicionar corretamente a placa de desenvolvimento.
- Carregue o Exemplo Zigbee_On_Off_Light:
- Selecione o modelo correto de placa de desenvolvimento: XIAO_ESP32C6.
- Abra o exemplo
Zigbee_On_Off_Lightna Arduino IDE.
Recomendamos que você use o pacote de placas esp32-arduino mais recente para obter os exemplos Zigbee mais atuais e estáveis.

- Neste exemplo, utilizaremos os LEDs monocromáticos integrados na placa XIAO ESP32C6, então precisamos fazer alterações nos pinos do LED no programa. Modifique o código para substituir
RGB_BUILTINporLED_BUILTINpara utilizar o LED indicador onboard.

- Configure as Definições Zigbee:
- Defina o modo Zigbee para ZIGBEE_MODE_ED (End Device).
- Ajuste o esquema de partição para Zigbee:
Navegue atéTools -> Partition Schemee selecione Zigbee 4MB with spiffs.

- Envie o Programa:
- Conecte o XIAO ESP32C6 ao seu computador por meio de um cabo USB-C.
- Compile e envie o programa de exemplo modificado para o XIAO ESP32C6.
- Se o XIAO estiver funcionando corretamente, você deverá ver a mensagem serial mostrada abaixo. Se você vir o XIAO reiniciando constantemente, verifique se as configurações Zigbee estão corretas ou atualize a versão do pacote de placas da placa de desenvolvimento.

Passo 4. Descubra o XIAO ESP32C6 no Home Assistant
- Na interface do Home Assistant, navegue até Settings -> Devices & Services.
- Selecione a integração Zigbee (nome: ZHA).

- Clique em Nabu Casa HA Connect ZBT-1.

- Dentro da página de detalhes do dispositivo Connect ZBT-1, você pode ver ADD DEVICE VIA THIS DEVICE, clique nele para ir para a página de descoberta e pareamento de dispositivos Zigbee.

- Aguarde um momento, e o XIAO ESP32C6 aparecerá na lista de dispositivos Zigbee descobertos.

Você pode definir um nome e uma localização para ele nesta página.
- Você pode então encontrar este dispositivo na página de dispositivos do ZHA e adicionar sua entidade ao painel.

Passo 5. Adicione o XIAO ESP32C6 ao Painel
- Depois que o XIAO ESP32C6 for descoberto, adicione‑o ao painel do seu Home Assistant.
- Agora você pode controlar o XIAO ESP32C6 (por exemplo, alternar o LED onboard) diretamente a partir do Home Assistant.

Conclusão
A Espressif oferece uma ampla variedade de tipos de dispositivos Zigbee e um extenso Zigbee SDK, permitindo que os desenvolvedores criem seus próprios dispositivos Zigbee com facilidade. Seguindo este tutorial, você aprendeu como integrar o XIAO ESP32C6 ao Home Assistant usando Zigbee, adicionando um dispositivo personalizado ao seu ecossistema de casa inteligente.
Com a flexibilidade do Zigbee SDK da Espressif, você pode começar a construir seus próprios dispositivos Zigbee para uma variedade de aplicações e recursos, e adicioná‑los perfeitamente ao Home Assistant para controle centralizado. Boas construções!
Suporte Técnico e Discussão de Produtos
Obrigado por escolher nossos produtos! Estamos aqui para oferecer diferentes formas de suporte para garantir que sua experiência com nossos produtos seja o mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.


