IMPORTANTE
Documentación en proceso, no dudes en volver a ver de vez en cuando para saber más sobre este plugin
El complemento Jeezigbee para Jeedom se basa en el excelente trabajo realizado alrededor la biblioteca de código abierto zigbee2mqtt para ofrecer un compatibilidad generalizada con diferentes hardware Zigbee. Permite la comunicación con los siguientes controladores Zigbee :
IMPORTANTE
En primer lugar, debe actualizar el firmware de su clave (especialmente para EZSP, clave popp en particular) de lo contrario, el demonio no puede funcionar, debe consultar la documentación del fabricante. No dudes en consultar la página oficial de Zigbee2MQTT para encontrar el firmware disponible para tu llave aquí
Además, el complemento está equipado con muchas herramientas que permiten :
MUY IMPORTANTE
Debido al vals de firmware/hardware por parte de los fabricantes y posibles errores en su firmware (sin necesariamente tener la posibilidad de actualizarlo desde Jeedom porque la mayoría de los fabricantes no los comunican), es posible que un módulo marcado como compatible solo parcialmente (un Botón que no funciona, o no hay diferencia entre el botón arriba y abajo, no hay aumento de CO2 o un sensor de módulo…). Lamentablemente, no podemos avisarle con antelación en la lista porque :
- no necesariamente tenemos el módulo en cuestión, muchos módulos se agregan por comentarios de los usuarios
- de una semana a otra el módulo puede haber cambiado (nuevo hardware, nuevo firmware o incluso un nuevo módulo que no ha cambiado de nombre)) Bajo ninguna circunstancia Jeedom se hace responsable en caso de que falte una función (o incluso un módulo que no funcione) aunque esté indicado como compatible. Al igual que usted, estamos sujetos a los cambios impuestos por el fabricante. . (s)
Plugin jeezigbee usa dependencias que deben instalarse primero (dependiendo de su sistema, esto puede llevar varias horas)).
El complemento utiliza el protocolo MQTT para chatear con Jeedom; por lo tanto, es necesario tener el complemento del administrador MQTT instalado y configurado correctamente (en la práctica, si este no es el caso, Jeedom debería hacer todo por su cuenta).
Una vez instaladas las dependencias, puede configurar un controlador Zigbee ingresando tipo de controlador, puerto de controlador, luego (re)iniciar el demonio.
Puedes hacerlo en la configuración del complemento :
IMPORTANTE
Hay 2 modos para el plugin : local, todo está en su Jeedom, este es el modo recomendado. Para usuarios avanzados, es posible utilizar el modo remoto; en este caso, Jeedom no administra Zigbee2mqtt, debe instalarlo usted (generalmente en una ventana acoplable en Jeedom o en otra máquina)). Tenga cuidado en modo remoto, Mqtt manager y Zigbee2MQTT deben estar conectados al mismo mqtt broker (mosquitto)
IMPORTANTE
Durante el primer uso, si está en modo local, es ABSOLUTAMENTE necesario iniciar las dependencias (incluso si está bien). Tenga en cuenta que para actualizar Zigbee2MQTT solo necesita iniciar las dependencias, puede ver las nuevas versiones de Zigbee2MQTT aquí
Para ir a Zigbee2MQTT desde el plugin Jeezigbee (por ejemplo para forzar el borrado de un módulo) debes ir a la configuración del plugin Jeezgibee luego en la sección “Configuración”, pulsa en Interfaz z2m “Aquí” se abrirá la web de Zigbee2MQTT interfaz, una vez en el módulo se le pedirá el identificador que se encuentra en la página de configuración de Jeezigbee.
Atención, esto solo es posible si está en la instalación local de zigbee2mqtt.
Puedes encontrar aquí la lista de módulos compatibles con el plugin
IMPORTANTE
Por el momento el plugin hace autoconfiguración, es decir que no contiene ninguna configuración específica para un módulo dado, recupera la información de zigbee2mqtt para generar automáticamente los comandos. Esto implica que cualquier módulo compatible con zigbee2mqtt debería funcionar inmediatamente con el complemento. Por otro lado, esto tiene como consecuencia generar muchos comandos que no siempre son todos útiles. Estamos en proceso de agregar un sistema de configuración específico para ciertos módulos y así mejorar los comandos y su presentación
La inclusión es la parte más compleja de Zigbee. Aunque simple, la operación a menudo tiene que repetirse varias veces para lograr. En el lado del complemento Jeedom es fácil, solo haga clic en el botón Incluir modo después de lo cual tienes 3 minutos para incluir el equipo.
El procedimiento de inclusión es específico para cada módulo. Consulte la documentación del fabricante para lograrlo.
TRUCO
No olvides reiniciar (reset) del módulo antes de cualquier inclusión. También hay que pensar detenidamente, durante la inclusión, en mantener el módulo despierto (cuidado de no mantenerlo demasiado despierto y lanzar un reset sin hacerlo expresamente))
Como de costumbre, puedes darle un nombre a tu equipo, darle una categoría o un objeto padre y activarlo o hacerlo visible.
También se puede acceder a otros parámetros más específicos :
La parte Información permite ver el modelo del equipo. También encontramos el visual del equipo (no modificable porque proviene de zigbee2mqtt) y el acceso a la configuración del módulo
En la pestaña Pedidos, encontramos, como de costumbre, los comandos que permiten interactuar con el módulo.
Esta es una ventana importante que encontrarás aquí :
Si el complemento no reconoce el módulo (sin comando), debe buscar aquí, si es compatible, debe ponerse en contacto con el soporte de Jeedom (o escribir en la comunidad) para ver por qué. Si su módulo no está en la lista de módulos compatibles con Zigbee2MQTT, deberá esperar a que se agregue.
INFORMACIÓN
El equipo de Jeedom se reserva el derecho de rechazar cualquier solicitud de integración. Siempre es mejor optar por equipos cuya compatibilidad ya está confirmada.
Actualizaciones OTA (Over-The-Air) son las actualizaciones de firmware de los modulos. El proceso puede tomar algún tiempo (varias horas dependiendo de la cantidad de módulos) pero permite una mejor confiabilidad de la red Zigbee en general. Para poder actualizar un módulo, el fabricante debe comunicar su firmware :
Puede desde la configuración del módulo solicitar una verificación de firmware, así como iniciar la actualización OTA.
La tecnología Greenpower normalmente es compatible con el complemento; está siendo calificado por Jeedom SAS
Las herramientas disponibles en el complemento ayudan mucho a la constitución de una red Zigbee de buena calidad. Vaya a la página general del complemento que enumera todos los equipos y haga clic en el botón Redes zigbee para acceder a diversa información y acciones en torno a la red Zigbee así como a la gráfica representativa de la misma.
Aquí es donde encuentras todas las configuraciones avanzadas de Zigbee2MQTT, ojo que es una lista generada desde Zigbee2MQTT (de ahí que todo esté en inglés))
El gráfico de red proporciona una visión general de la red Zigbee y la calidad de las comunicaciones con los diferentes módulos. Recuerde lanzar una actualización de vez en cuando (tarda unos diez minutos y puede ralentizar su red zigbee), una vez realizada la actualización, debe cerrar la ventana Redes zigbee y vuelve a abrirlo.
IMPORTANTE
El gráfico de red está ahí solo con fines informativos y puede no ser exacto (particularmente en los módulos de batería que a menudo o incluso a veces no informan su enrutamiento))
Para optimizar la confiabilidad de su red Zigbee, es más que recomendable tener al menos 3 módulos router alimentados permanentemente y evitar desconectarlos. De hecho, durante nuestras pruebas notamos una marcada mejora en la confiabilidad y resistencia de la red Zigbee al agregar módulos de enrutador. También es recomendable incluirlos primero, de lo contrario tendrás que esperar de 24 a 48 horas para que el “dispositivo final” (módulos no enrutadores) descúbrelos.
Otro punto importante, es posible, durante la eliminación de un módulo de enrutador, que parte del “dispositivo final” (módulos no enrutadores) se pierde por un tiempo más o menos largo (en diez horas o más) o incluso de forma permanente y hay que volver a incluirlos. Lamentablemente, esto se debe a la forma en que el fabricante ha planificado la integración de su hardware dentro de una red Zigbee y, por lo tanto, no puede corregirse mediante el complemento que no gestiona la parte de enrutamiento.
Por último, y aunque a algunos les parezca una obviedad, os recordamos que las pasarelas Zigbee en Wifi o remotas son por definición menos fiables que las pasarelas USB. Por lo tanto, el equipo de Jeedom recomienda el uso de una puerta de enlace Zigbee en USB.
Es posible en caso de necesidad crear grupos de equipos zigbee. Los grupos pueden contener todo y cualquier cosa, no es posible que jeedom administre los pedidos en estos, por lo que depende de usted agregarlos. Para ello, nada podría ser más sencillo, basta con hacer clic en el botón para agregar un comando, darle un nombre y tomar el ID lógico, tipo y subtipo de uno de los dispositivos del grupo que contiene el comando deseado. Tenga en cuenta que Jeedom gestiona comandos de tipo acción e información en grupos.
Zigbee2mqtt le permite agregar convertidores externos (para admitir módulos no admitidos oficialmente)). Pour ajouter un convertisseur externe il suffit dans la configuration du plugin (Plugin -> Gestion de plugins -> Jeezigbee) de cliquer sur le bouton “Editer” au niveau de la ligne converter et de déposer/éditer votre converter dans le dossier que jeedom vous Reloj.
IMPORTANTE
El soporte no cubre la parte de creación/uso de convertidores externos.
El caso de los módulos que envían códigos IR es un poco específico porque no hay una lista predefinida de códigos IR, por lo que debe encontrar el comando IR usted mismo y, por desgracia, agregar un comando con ID lógica : `ir_code_to_send::TU CÓDIGO IR
Esta parte es más para usuarios avanzados que desean agregar comandos específicos. Todo sucede en el id lógico del comando :
json::{"temperature":25} para enviar {"temperatura":25} sobre el tema set del equipo, para enviar un comando sobre un subtema solo debes poner /arm_mode en subtema y json por ejemplo::{"mode":"arming_stay"} en ID lógica para enviar {"modo":"arming_stay"} en set/arm_modetemperatura para recuperar el campo temperatura del json del equipo o temperatura::min para recuperar el subcampo min de la tabla de temperatura` del equipoNOTA
Para comandos de tipo acción, puede utilizar etiquetas
#slider#,#message#,#title#o#select#dependiendo del subtipo del comando para pasar un parámetro
Enlace a las preguntas frecuentes de Zigbee2mqtt
Tengo muchos mensajes de información (azul) abajo a la derecha y no entiendo nada
Actualmente estamos clasificando los mensajes útiles o no que devuelve Zigbee2mqtt; pero por defecto preferimos mostrar todo.
Tengo errores extraños en los módulos de las baterías o problemas con la inclusión
Hemos notado que buena parte de los problemas de los módulos en batería se deben a las baterías o posiblemente problemas de reseteo de los módulos antes de su inclusión. Aunque estos parezcan nuevos, es recomendable probar con pilas nuevas para descartar esta hipótesis.
Mi módulo agota sus baterías muy rápido
Compruebe que tiene un firmware actualizado en su clave zigbee. En el 90% de los casos, el consumo excesivo de batería proviene del firmware que tiene un problema.
No puedo incluir nuevos módulos
Varias posibilidades para esto :
- Ya tienes muchos módulos y has excedido el límite de la cantidad de módulos en vivo (generalmente 31). Debe intentar agregar nodos de enrutador (tenga cuidado, no existe un estándar claro sobre los nodos de enrutador, por lo que existen incompatibilidades entre fabricantes)…)
- Estás en Conbee : intente desconectar la clave durante 2 minutos, volver a colocarla y reiniciar el demonio; es una enfermedad conocida de las teclas Conbee (incluso bajo deconz), necesita un “reinicio en frío” para que la inclusión vuelva a funcionar
- Tiene un SSD conectado a USB3, intente conectarlo a un puerto USB2
No tengo tantos comandos como botones en mi control remoto
En mi control remoto tengo por ejemplo 2 botones pero en la lista de comandos de Jeedom solo tengo un comando !!! Es normal; el comando en jeedom toma un valor diferente dependiendo del botón físico presionado. La forma más sencilla de verlo es ir a “Configuración avanzada” (arriba a la derecha), luego a “Registros” (también arriba a la derecha) y presionar los botones del control remoto para ver los diferentes valores de los comandos.
No tengo la imagen de mi módulo
Nada grave, eso no quiere decir que no pueda ser usado o reconocido, la imagen solo sirve como ilustración. Si realmente lo deseas, debes comunicarte con soporte para que vean por qué no lo tienes (normalmente se debe a un carácter no estándar en el nombre del modelo del módulo))
Cambiar el PAN_ID y la clave de red
Una vez realizado el cambio en la interfaz jeedom o en zigbee2mqtt, debes detener el demonio, eliminar el archivo coordinador_backup.json (está en
/var/www/html/plugins/z2m/data), reinicie el demonio.
Recibí el error
Error: Restablecer error: Error: {"sequence":-1} después de 10000msy una clave ELELABS o una caja AtlasDebes actualizar el firmware de tu llave zigbee, para ello en la configuración del plugin jeezigbee haz clic en actualizar firmware y llena los diferentes campos en la ventana luego valida. Tenga cuidado de no hacer esto en una caja luna, se rompe la tecla zigbee. Si la actualización no funciona, entonces debes intentar hacer una “Corrección del cargador de arranque””.
Mi equipo no es reconocido
Si tu equipo no es reconocido es porque aún no es soportado por la librería Zigbee2mqtt. Es posible crear un conversor para su equipo. Debes consultar el documento Soporte para nuevos dispositivos y también para hardware Tuya. Admite nuevos dispositivos TuYa.
En cualquier caso, debemos abrir una salida github aquí
Una vez creado el convertidor, tendrás que ponerlo en el complemento para probarlo. 1) Desde el editor de archivos Jeedom,
- Crea una carpeta con la marca de tu equipo en plugin/z2m/core/converters>
- Ingrese a esta carpeta
- Cree un archivo llamado Marca de referencia del equipo.js Para el ejemplo usaremos Tuya_TZE204_81yrt3lo.js
- En este archivo, pegue los elementos del convertidor.
- Guarde y cierre el archivo.
2) Reinicie el demonio del complemento
Tecla SONOFF modelo P: Intermitente y solución del problema del “tipo de registro desconocido 3”
Se propuso una explicación sobre cómo mostrar la clave en el foro. Si tiene el error “tipo de registro desconocido 3”, es necesario convertir su archivo .hexadecimal a .bin como se explica en el tutorial. Gracias a JeedGeek por la explicación aquí
Tengo error al actualizar firmware en Luna
Debe desactivar el demonio del complemento (Complemento -> Administración de complementos -> Jeezigbee luego Administración automática -> desactivar), reiniciar la luna (Configuración -> Sistema -> Reiniciar). Una vez reiniciada la caja deberás reiniciar la actualización del firmware. Tenga en cuenta que esto puede tardar hasta 10 minutos. No olvides una vez realizada la actualización reactivar la gestión automática de demonios.