Pular para o conteúdo principal

Conectar ao Home Assistant via XIAO ESP32-C5 Zigbee


A integração de dispositivos Zigbee em ecossistemas de casa inteligente tornou-se cada vez mais popular devido ao baixo consumo de energia, confiabilidade e facilidade de uso do Zigbee. Neste wiki, vamos guiá‑lo na conexão do XIAO ESP32-C5 ao Home Assistant por meio de sua funcionalidade Zigbee. Ao final deste guia, você terá uma demonstração funcional em que o XIAO ESP32-C5 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.

Preparação de Hardware​

Para acompanhar este guia, você vai precisar do seguinte:

  1. Home Assistant Green: Um dispositivo de hardware dedicado do Home Assistant para gerenciar sua casa inteligente.
  2. Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E: Um coordenador Zigbee para permitir a criação e comunicação da rede Zigbee.
  3. XIAO ESP32-C5: Uma placa de desenvolvimento com funcionalidade Zigbee habilitada por meio do SDK da Espressif.
Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-EXIAO ESP32-C5Home Assistant Green
Adquira agora 🖱️
Adquira agora 🖱️
Adquira agora 🖱️
dica

Se você não tiver um Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E em mãos, também pode escolher o Home Assistant Connect ZBT-2.

Integrando Zigbee com o Home Assistant​

Vamos mostrar como usar o XIAO ESP32-C5 como um dispositivo Zigbee para se conectar ao Home Assistant.

Conectar o ZBDongle-E​

Insira o Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E em um cabo de extensão USB. Conecte o cabo de extensão ao Home Assistant Green.

cuidado

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 ZBDongle-E. É importante usar o cabo de extensão USB e posicionar o Home Assistant Connect ZBDongle-E afastado de possíveis fontes de interferência.

Etapa 1. Descobrir Dispositivos Zigbee

  • Setting -> Devices & services

-Em Integrations, você encontrará o dispositivo SONOFF Zigbee 3.0 USB Dongle Plus V2, que é o Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E.


Etapa 2. Adicionar Dispositivos Zigbee


Etapa 3. Criar uma Rede Zigbee

  • Depois de clicar em Submit, será solicitado que você selecione o modo de dispositivo Zigbee. Escolha criar uma rede Zigbee no Home Assistant.

  • Quando concluído com sucesso, você verá que o dispositivo Zigbee foi adicionado em Configured.

  • O ZBDongle-E é definido como o coordenador, que pode controlar dispositivos finais Zigbee.

Gravar o Exemplo Zigbee​

Usaremos o exemplo Zigbee HA_On_Off_Light da Arduino IDE para esta demonstração.
Se você nunca usou a Arduino IDE antes, consulte Getting Started with Seeed Studio XIAO ESP32-C5 para começar.

Etapa 1. selecione o exemplo na Arduino IDE pelo caminho: File -> Examples -> Zigbee -> Zigbee_On_Off_Light.


Etapa 2. Definir o End Device e o Partition Scheme

  • Clique em Tools -> Zigbee Mode e selecione o modo como Zigbee ED (End Device).
  • Selecione Partition Scheme indo em Tools -> Partition Scheme -> Zigbee 8MB with spiffs

A memória FLASH do XIAO ESP32-C5 é de 8MB. Ao selecionar um esquema de partição, é recomendado escolher Zigbee 8MB with spiffs.


Etapa 3. Modificar o Pino e o Nome do LED

  • Localize o código relacionado à configuração de pinos no exemplo.
uint8_t led = RGB_BUILTIN;
  • No XIAO ESP32-C5, o LED USER onboard corresponde ao pino GPIO27, que precisa ser modificado.
uint8_t led = 27;

  • No XIAO ESP32-C5, o LED USER onboard corresponde ao pino GPIO27, que precisa ser modificado.
zbLight.setManufacturerAndModel("Espressif", "ZBLightBulb");
  • Modificado
zbLight.setManufacturerAndModel("XIAO-ESP32-C5", "ZBLightBulb");

Etapa 4. Upload

Envie o código de exemplo com os pinos modificados para o XIAO ESP32-C5.

Conectar à Rede Zigbee​

Conecte o XIAO ESP32-C5 (configurado como um Zigbee End Device) à rede Zigbee criada no Home Assistant.

Etapa 1. Descobrir Dispositivos Finais

  • Após gravar o código de exemplo no XIAO ESP32-C5, ele entrará automaticamente na rede Zigbee. Abra a página Integrations e você verá dois dispositivos Zigbee aparecerem.

  • Um é o dispositivo Coordinator (o ZBDongle-E conectado ao Home Assistant Green) e o outro é o End Device (XIAO-ESP32-C5 ZBLightBulb).

dica

Para entrar na rede Zigbee de forma mais rápida e estável, você pode conectar a antena flexível FPC do pacote ao XIAO ESP32-C5.

Etapa 2. Adicionar ao Dashboard

  • Clique no dispositivo XIAO-ESP32-C5 ZBLightBulb e adicione‑o ao dashboard.

  • Você pode encontrar o dispositivo XIAO-ESP32-C5 ZBLightBulb no dashboard, onde pode enviar comandos de controle para ele.

Demonstração do Efeito​

  • Quando o dispositivo final XIAO ESP32-C5 entrar na rede Zigbee com sucesso, isso será exibido no Serial Monitor.

  • Efeito Real

Conclusão​

A Espressif oferece uma ampla variedade de tipos de dispositivos Zigbee e um extenso Zigbee SDK, permitindo que desenvolvedores criem facilmente seus próprios dispositivos Zigbee. Seguindo este tutorial, você aprendeu como integrar o XIAO ESP32-C5 ao Home Assistant usando Zigbee, adicionando dispositivos personalizados ao seu ecossistema de casa inteligente.

Com a flexibilidade do Espressif Zigbee SDK, você pode começar a construir seus próprios dispositivos Zigbee para diversas 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 fornecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos diversos canais de comunicação para atender a diferentes preferências e necessidades.

Loading Comments...