zigbee2mqtt
1.41.0
Permite que você use seus dispositivos Zigbee sem a ponte ou gateway do fornecedor.
Ele conecta eventos e permite controlar seus dispositivos Zigbee via MQTT. Desta forma, você pode integrar seus dispositivos Zigbee com qualquer infraestrutura doméstica inteligente que estiver usando.
A documentação fornece todas as informações necessárias para começar a funcionar! Certifique-se de não pular seções se esta for sua primeira visita, pois pode haver detalhes importantes para você.
Se você não está familiarizado com a terminologia Zigbee , leia isto para ajudá-lo.
Zigbee2MQTT integra-se bem com (quase) todas as soluções de automação residencial porque usa MQTT. No entanto, vale a pena mencionar as seguintes integrações:
Zigbee2MQTT é composto por três módulos, cada um desenvolvido em seu próprio projeto Github. Começando pelo hardware (adaptador) e subindo; O zigbee-herdsman se conecta ao seu adaptador Zigbee e disponibiliza uma API para os níveis mais altos da pilha. Por exemplo, para hardware da Texas Instruments, o zigbee-herdsman usa a API de monitoramento e teste TI zStack para se comunicar com o adaptador. Zigbee-herdsman cuida da comunicação central do Zigbee. O módulo zigbee-herdsman-converters lida com o mapeamento de modelos de dispositivos individuais para os clusters Zigbee que eles suportam. Clusters Zigbee são as camadas do protocolo Zigbee no topo do protocolo base que definem coisas como como as luzes, sensores e interruptores se comunicam entre si na rede Zigbee. Finalmente, o módulo Zigbee2MQTT aciona o zigbee-herdsman e mapeia as mensagens zigbee para mensagens MQTT. Zigbee2MQTT também monitora o estado do sistema. Ele usa um arquivo database.db para armazenar esse estado; um arquivo de texto com um banco de dados JSON de dispositivos conectados e seus recursos. Zigbee2MQTT fornece uma interface baseada na web que permite monitoramento e configuração.
Zigbee2MQTT usa TypeScript (parcialmente por enquanto). Portanto, depois de fazer alterações nos arquivos no diretório lib/ você precisa recompilar o Zigbee2MQTT. Isso pode ser feito executando npm run build . Para um desenvolvimento mais rápido, em vez de executar npm run build você pode executar npm run build-watch em outra sessão de terminal, isso será recompilado conforme você altera os arquivos. Na primeira vez, antes de compilar, você precisa executar npm install --include=dev Antes de enviar alterações, execute npm run test-with-coverage , npm run pretty:check e npm run eslint
Consulte Dispositivos suportados para verificar se o seu dispositivo é compatível. Há uma lista bastante extensa, incluindo dispositivos de fornecedores como Xiaomi, Ikea, Philips, OSRAM e muito mais.
Se não estiver listado em Dispositivos suportados, o suporte pode ser adicionado (bastante) facilmente, consulte Como oferecer suporte a novos dispositivos.
Se precisar de ajuda, você pode verificar os problemas abertos. Sinta-se à vontade para ajudar com solicitações pull quando você conseguir consertar coisas ou adicionar novos dispositivos ou apenas compartilhar seu amor nas redes sociais.
