Se aplica a: LOQED Touch y LOQED Pure.
Esta guía explica la integración Fibaro/Yubii para cerraduras inteligentes LOQED. Está destinado a usuarios avanzados que se sienten cómodos con las integraciones de redes locales.
La disponibilidad de las funciones puede depender del puente/puerta de enlace LOQED conectado y del firmware del controlador de terceros. Es posible que algunas capturas de pantalla más antiguas aún muestren nombres de la era Touch.
¿Qué características ofrece la cerradura inteligente LOQED con Fibaro?
La integración de la cerradura inteligente LOQED y Fibaro se realiza a través de la API del puente local.
Actualmente, se admiten las siguientes funcionalidades:
Envíe cambios de estado en tiempo real de la cerradura (abrir, desbloquear, bloquear) y la batería, estado Wi-Fi, Bluetooth a la puerta de enlace Fibaro. El nivel de batería, si es inferior al 5%, mostrará que QuickApp está agotada.
Reciba comandos de la puerta de enlace Fibaro para cambiar el estado de bloqueo (abrir, desbloquear, bloquear).
Idioma inglés, alemán y holandés. Puede agregar idiomas adicionales agregándolos usted mismo al código fuente.
Cuando utilice múltiples bloqueos LOQED, simplemente agregue una instancia adicional de QuickApp y configúrela con los datos adecuados.
Actualmente, esta QuickApp no puede decodificar datos json PUBLICADOS por el puente, ya que la API FIBARO/Yubii/elero/zooz simplemente ignora cualquier dato desconocido y acepta solo argumentos de clave JSON:[{}]. Por lo tanto, no se puede decodificar quién abrió/cerró el LOQED a través de la aplicación (o si fue manualmente, con la perilla).
Consideración de seguridad: el puente LOQED envía cualquier cambio de estado (por ejemplo, "se abrió la puerta") a Fibaro a través de una conexión HTTP no segura en su red Wi-Fi, pero con una firma digital. Fibaro utiliza la firma digital para garantizar que el cambio de estado no sea enviado por otra persona que no sea el LOQED Bridge (por lo tanto, para garantizar que nadie pueda hacer que el dispositivo Fibaro piense que la puerta se abrió, cuando en realidad ese no fue el caso). Sólo el HC3 (no el Yubii Home/HC3L) admite esto. Tenga en cuenta que esto no afecta la apertura/bloqueo de la puerta, solo se refiere a la información de estado.
Requisitos
Una puerta de enlace compatible, como por ejemplo:
Fibaro Centro de inicio 3 (tenga en cuenta que Home Center 2 no es compatible)
Instalación
Paso 1: crear clave API
Ir a https://app.loqed.com/API-Config e inicie sesión con su dirección de correo electrónico y contraseña de LOQED app (tenga en cuenta que se cerrará su sesión en LOQED app). Haga clic en el botón "Herramienta de configuración API". Haga clic en el botón "Agregar nueva clave API". Establezca cualquier nombre y cree la clave API. Es normal que la casilla "Eliminar desbloqueo/bloqueo" esté atenuada.
Una vez creada la clave, haga clic en el botón "ver/editar". Deje esta pantalla abierta.
Paso 2: instale la QuickApp Fibaro
Inicie sesión en su puerta de enlace Fibaro. Si tiene un dispositivo de la marca Fibaro, debería poder ir a http://find.fibaro.com/para encontrar la dirección IP de su puerta de enlace.
Descargue el archivo de la aplicación rápida y extrae el ZIP. Vaya a "configuración" -> "Dispositivos" y haga clic en el ícono más para agregar un nuevo dispositivo. A continuación, busque el dispositivo llamado "Cargar archivo" y cargue el archivo de la aplicación rápida.
Paso 3: cree un usuario en la puerta de enlace Fibaro
Cree un usuario local en su puerta de enlace con permisos para la aplicación rápida LOQED. Por favor no utilice ningún carácter especial. Este usuario se utiliza para actualizar la puerta de enlace de los cambios de estado de bloqueo tan pronto como ocurren. Si bien no se recomienda, también puede omitir este paso y utilizar su nombre de usuario y contraseña de administrador (si no contienen caracteres especiales).
Paso 4: configura la aplicación rápida
Haga clic en la pestaña de variables.
Ahora, establezca las variables en el valor correcto. Cada valor se puede encontrar en https://app.loqed.com/API-Config.
variable | Dónde encontrar el valor |
puente_ip | Configuración de API LOQED -> "Webhooks salientes a través de LOQED puente" -> "Dirección IP" |
puente_auth_key | Configuración de API LOQED -> "Webhooks salientes a través de LOQED Bridge" -> "Clave de autenticación (base64)" |
clave | Configuración de API LOQED -> "Claves API (webhooks entrantes)" -> "Clave" |
id_bloqueo | Configuración de API LOQED -> "Claves API (webhooks entrantes)" -> "ID de bloqueo" |
id_clave_local | Configuración de API LOQED -> "Claves API (webhooks entrantes)" -> "ID de clave local" |
tiempo de actualización (predeterminado 600) | Con qué frecuencia (en segundos) la aplicación rápida sondeará un cambio de estado de bloqueo. Recomendamos mantener este valor bajo. En realidad, solo es necesario realizar un sondeo después de que se inicia la puerta de enlace, ya que cualquier cambio de estado de bloqueo se envía directamente a la puerta de enlace. La información del estado de la batería y en línea solo se recibe mediante sondeo, aunque el puente LOQED admite el envío. |
errores_extra (predeterminado 0) | Establezca en 1 para ver información HTTP. |
usuario_webhook | Utilice el nombre de usuario del paso 3. |
webhook_pass | Utilice la contraseña del paso 3. Nota: hay que eliminar este campo "secreto" y luego crearlo nuevamente, dándole nuevamente el nombre "webhook_pass". |
home_center_ip | Configure aquí la dirección IP de su puerta de enlace. No utilice una IP de loopback (127.0.0.1), sino la dirección IP de la red local. |
use_webhooks (predeterminado 1) | Cuando se establece en 1, todas las funciones de la aplicación rápida (relacionadas con los webhooks) se habilitan utilizando el usuario/contraseña que creó. Configúrelo en 0 si desea utilizar bucle/encuesta en su lugar (consulte el tiempo de actualización más arriba). |
Paso 5: cree webhooks en el puente LOQED
El puente LOQED puede enviar cualquier cambio de estado de la cerradura a su puerta de enlace tan pronto como ocurra. Para esto, necesita configurar algunas URL en el LOQED Bridge. Hay dos maneras de hacer esto:
Si tienes un Home Center 3 Fibaro, puedes hacerlo con solo hacer clic en un botón.
Estos botones no están disponibles en las puertas de enlace Home Center 3 Lite, Yubii Home ni Z-Box, debido a que falta soporte para números de punto flotante de 53 bits en el entorno CPU LUA de 32 bits (tal como lo utilizan estas puertas de enlace).De lo contrario, tendrás que hacerlo manualmente.
Paso 5a: crea webhooks si tienes Fibaro Home Center 3
Vaya a la pestaña "Editar y vista previa". Haga clic en el botón "Crear webhooks".
Puedes verificar que la acción fue exitosa yendo a https://app.loqed.com/API-Config --> "Webhooks salientes a través de LOQED Bridge" --> haga clic en el botón "Agregar/eliminar webhooks". En esa página, debería ver varias entradas con una URL a su puerta de enlace.
Nota: si hace clic por error varias veces en el botón, no se preocupe, ya que el puente no creará webhooks duplicados.
Esta QuickApp generará solo webhooks para eventos "abierto", "cerrado", "bloqueo nocturno" y "desconocido", ya que normalmente son suficientes para la mayoría de los usuarios. Los eventos de estado de batería o en línea se sondean cada 10 minutos de forma predeterminada.
Paso 5b: crea webhooks manualmente (si no tienes un Home Center 3 Fibaro)
Omita este paso si ha realizado el paso 5a.
Debe crear 4 webhooks en LOQED Bridge para informar a la puerta de enlace sobre los 4 estados de bloqueo diferentes.
Ir a https://app.loqed.com/API-Config--> "Webhooks salientes a través de LOQED Bridge" --> haga clic en el botón "Agregar/eliminar webhooks". En esa página, agregue las siguientes URL:
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookNightLock (sólo para el gatillo de bloqueo nocturno)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookDayLock (solo para el gatillo del pestillo)
http://gw_user:gw_password@gw_ip/api/devices/thisQAID/action/webhookOpen (solo para el gatillo abierto)
http://gw_user:gw_password@gw_ip/api/devices/QAID/action/webhookUnknown (sólo para el disparador de estado desconocido)
Arriba, "gw_user" y "gw_password" son el nombre de usuario y la contraseña de su puerta de enlace creados en el paso 3, "gw_ip" es la IP de la puerta de enlace, "QAID" es el ID del dispositivo de QuickApp, que se puede encontrar en la lista de dispositivos (vea la imagen a continuación donde es 22)
hecho
¡Eso es todo! Ahora puede controlar su LOQED Touch usando Fibaro.
Gracias a
Muchas gracias a "tinman". Si tiene preguntas e informes de errores, puede comunicarse con Tinman a través del foro Fibaro o del mercado Fibaro.