zigbee2mqtt
1.41.0
Le permite utilizar sus dispositivos Zigbee sin el puente o puerta de enlace del proveedor.
Une eventos y le permite controlar sus dispositivos Zigbee a través de MQTT. De esta manera, puede integrar sus dispositivos Zigbee con cualquier infraestructura doméstica inteligente que esté utilizando.
¡La documentación le proporciona toda la información necesaria para comenzar a trabajar! Asegúrese de no omitir secciones si esta es su primera visita, ya que podría haber detalles importantes allí para usted.
Si no está familiarizado con la terminología de Zigbee , asegúrese de leer esto para ayudarle.
Zigbee2MQTT se integra bien con (casi) todas las soluciones de automatización del hogar porque utiliza MQTT. Sin embargo, vale la pena mencionar las siguientes integraciones:
Zigbee2MQTT se compone de tres módulos, cada uno desarrollado en su propio proyecto Github. Comenzando desde el hardware (adaptador) y subiendo; zigbee-herdsman se conecta a su adaptador Zigbee y pone una API a disposición de los niveles superiores de la pila. Por ejemplo, para el hardware de Texas Instruments, zigbee-herdsman utiliza la API de prueba y monitoreo de TI zStack para comunicarse con el adaptador. Zigbee-herdsman maneja la comunicación central de Zigbee. El módulo zigbee-herdsman-converters maneja el mapeo de modelos de dispositivos individuales a los grupos Zigbee que admiten. Los clústeres de Zigbee son las capas del protocolo Zigbee además del protocolo base que definen cosas como cómo las luces, los sensores y los interruptores se comunican entre sí a través de la red Zigbee. Finalmente, el módulo Zigbee2MQTT controla zigbee-herdsman y asigna los mensajes zigbee a mensajes MQTT. Zigbee2MQTT también realiza un seguimiento del estado del sistema. Utiliza un archivo database.db para almacenar este estado; un archivo de texto con una base de datos JSON de los dispositivos conectados y sus capacidades. Zigbee2MQTT proporciona una interfaz basada en web que permite el monitoreo y la configuración.
Zigbee2MQTT usa TypeScript (parcialmente por ahora). Por lo tanto, después de realizar cambios en los archivos en el directorio lib/ necesita volver a compilar Zigbee2MQTT. Esto se puede hacer ejecutando npm run build . Para un desarrollo más rápido, en lugar de ejecutar npm run build , puede ejecutar npm run build-watch en otra sesión de terminal; esto se volverá a compilar a medida que cambie los archivos. La primera vez, antes de compilar, debe ejecutar npm install --include=dev Antes de enviar los cambios, ejecute npm run test-with-coverage , npm run pretty:check y npm run eslint
Consulte Dispositivos compatibles para comprobar si su dispositivo es compatible. Hay una lista bastante extensa, que incluye dispositivos de proveedores como Xiaomi, Ikea, Philips, OSRAM y más.
Si no aparece en Dispositivos compatibles, la compatibilidad se puede agregar (bastante) fácilmente; consulte Cómo admitir nuevos dispositivos.
Si necesita ayuda, puede consultar los problemas abiertos. No dudes en ayudar con las solicitudes de extracción cuando hayas podido arreglar cosas, agregar nuevos dispositivos o simplemente compartir tu amor en las redes sociales.
