Repolode
Enviar
Koenkk

Koenkk/zigbee2mqtt

Uma ponte que conecta dispositivos Zigbee de casa inteligente ao MQTT, permitindo que funcionem sem o hub ou gateway do fabricante.

Alternativa open source a:Philips Hue Bridge

Ver no GitHubSite
Estrelas
15,755
Forks
2,029
Issues abertas
487
Último commit
há 3 dias

O que é?

O Zigbee2MQTT se comunica diretamente com um adaptador coordenador Zigbee e republica eventos e estados dos dispositivos via MQTT. Os usuários podem controlar lâmpadas, sensores, interruptores e outros dispositivos Zigbee por meio de tópicos MQTT, conectando o hardware Zigbee a qualquer sistema de automação residencial compatível com MQTT.

O projeto é desenvolvido em TypeScript e executado como um serviço em um host com um adaptador Zigbee compatível. Ele é dividido em três camadas: zigbee-herdsman gerencia a comunicação com o adaptador, zigbee-herdsman-converters associa os modelos de dispositivos aos clusters Zigbee, e o próprio Zigbee2MQTT faz a tradução entre mensagens Zigbee e MQTT. O projeto inclui interfaces web para monitoramento e configuração.

O suporte a dispositivos é mantido por meio de uma lista publicada de hardware compatível, e novos dispositivos podem ser adicionados com código de converter. As integrações oficiais estão documentadas para Home Assistant, Homey, Domoticz, Gladys Assistant e ioBroker.

Recursos principais

  • 01Controla dispositivos Zigbee publicando e assinando tópicos MQTT.
  • 02Funciona sem uma ponte ou gateway Zigbee específico do fabricante.
  • 03Inclui interfaces web para monitorar e configurar a rede.
  • 04Mantém uma lista pública de dispositivos compatíveis de diversos fabricantes.
  • 05Oferece integrações documentadas com Home Assistant, Homey, Domoticz e outros.

Casos de uso

  • Manter uma casa inteligente local sem hubs de fabricantes que dependem exclusivamente da nuvem.
  • Enviar leituras de sensores Zigbee para um sistema de automação existente baseado em MQTT.
  • Adicionar dispositivos Zigbee não compatíveis com o fabricante ao Home Assistant ou a plataformas semelhantes.

Início rápido

  1. 1

    Siga o guia de introdução da documentação oficial

Antes de usar

  • É licenciado sob a GPL-3.0, uma licença copyleft que exige que trabalhos derivados sejam disponibilizados como código aberto sob os mesmos termos.
  • Nem todos os dispositivos Zigbee são compatíveis; pode ser necessário adicionar suporte para dispositivos que não estão na lista.

Tópicos

#zigbee#mqtt#iot#smart-home#home-automation#typescript#hacktoberfest

Perguntas frequentes

O que é zigbee2mqtt?
Uma ponte que conecta dispositivos Zigbee de casa inteligente ao MQTT, permitindo que funcionem sem o hub ou gateway do fabricante. O Zigbee2MQTT se comunica diretamente com um adaptador coordenador Zigbee e republica eventos e estados dos dispositivos via MQTT. Os usuários podem controlar lâmpadas, sensores, interruptores e outros dispositivos Zigbee por meio de tópicos MQTT, conectando o hardware Zigbee a qualquer sistema de automação residencial compatível com MQTT.
zigbee2mqtt é gratuito? Qual é a licença?
zigbee2mqtt é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
zigbee2mqtt ainda é mantido?
Manutenção ativa. O último commit de zigbee2mqtt foi em 21 de out. de 2026.
Para que posso usar zigbee2mqtt?
Manter uma casa inteligente local sem hubs de fabricantes que dependem exclusivamente da nuvem. Enviar leituras de sensores Zigbee para um sistema de automação existente baseado em MQTT. Adicionar dispositivos Zigbee não compatíveis com o fabricante ao Home Assistant ou a plataformas semelhantes.
Como instalar zigbee2mqtt?
Siga o guia de introdução da documentação oficial
Onde consigo zigbee2mqtt?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Koenkk/zigbee2mqtt

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados