Se aplica a: LOQED Touch y LOQED Pure.
Esta guía explica cómo integrar una cerradura inteligente LOQED con Loxone. Está destinado a usuarios avanzados de hogares inteligentes.
Es posible que algunas capturas de pantalla y plantillas antiguas aún mencionen LOQED Touch o textos específicos de Bridge. Verifique su modelo y dispositivo de conexión en línea antes de configurar los comandos.
¿Qué características ofrece la cerradura inteligente LOQED con Loxone?
La integración de la cerradura inteligente LOQED y Loxone se realiza a través de la API del puente local.
Actualmente, se admiten las siguientes funcionalidades:
Envíe cambios de estado de la cerradura en tiempo real (abrir, desbloquear, bloquear) al servidor Loxone.
Reciba comandos del servidor Loxone para cambiar el estado de bloqueo (abrir, desbloquear, bloquear).
Crea una salida virtual para enviar comandos a la cerradura.
1. Cree una clave API de puente saliente
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 "Agregar nueva clave API". Establezca cualquier nombre (usamos el servidor Loxone) y cree la clave API. Es normal que la casilla "Eliminar desbloqueo/bloqueo" esté atenuada.
Después de crear la clave API, ahora debería ver cuatro URL de API Bridge, que necesitará más adelante. Mantenga esta página abierta.
2. Crea una salida virtual
Seleccione 'Salidas virtuales' de la lista Periferia.
Haga clic en 'Plantillas de dispositivo' y haga clic en 'Importar plantilla...'.
Seleccione el archivo que acaba de descargar en su computadora.
Haga clic en "Plantillas de dispositivo" nuevamente y elija "LOQED".
Haga clic en la salida virtual 'LOQED'.
Haga clic en 'Dirección' en la pestaña de propiedades y cambie la URL a la IP de su puente.
(Asegúrese de que su puente tenga una dirección IP estática).
Seleccione el elemento 'Latch' de la salida virtual.
Cambie el 'Comando para ON' a la URL de la API del puente Latch que creó en el paso 1
¿A partir de/estado? Debería verse así:
/state?command=DAY_LOCK&local_key_id=[LOCAL_KEY_ID]&secret=[SECRETO]Haga lo mismo para Night Lock y Open.
3. Prueba de salida virtual
Guarde la configuración en su servidor Loxone, active la vista en vivo con ajuste de valores manual y pruebe si los comandos funcionan.
Crea una entrada virtual para recibir el estado de la cerradura.
El puente LOQED puede actualizar su servidor Loxone con cada cambio de estado, incluso cuando se usa la aplicación o cuando abre o cierra manualmente la cerradura. Para hacerlo, necesita una entrada virtual en Loxone para recibir el estado actual.
4. Creando una entrada virtual
Seleccione 'Entradas virtuales' de la lista Periferia.
Importe la plantilla de entrada virtual.
Si recibe el error "Error al guardar en la ubicación de destino", primero cree el directorio "VirtualIn" en el directorio "Loxone\Loxone Config\Templates" (distingue entre mayúsculas y minúsculas).Copie la URL 'Estado' de la página API y péguela en 'Configuración -> URL
Esto debería verse así: http://BRIDGE_IP/statusEstablezca el 'Intervalo' en '3600' (una hora).
Ahora, el servidor Loxone le preguntará al puente el estado actual cada hora.
Actualmente, no hay forma de que Loxone solicite el estado actual al iniciar. Entonces, después de que su servidor se inicie, el estado tardará una hora en aparecer si el bloqueo no se ha utilizado dentro de esa primera hora.
5. Crea un bloque de estado
Vaya a "Agregar bloque de funciones -> General -> Estado" y agregue el bloque de estado (no use el bloque de estado virtual). Configure el bloque de la siguiente manera:
Conecte el bloque de estado a la entrada virtual LOQED_LOCK_STATE dibujando una línea y mostrando los valores habilitando las casillas de verificación TQ y AQ.
6. Crea un usuario
Crea un nuevo usuario “loqed”. El nombre de usuario distingue entre mayúsculas y minúsculas y no admite caracteres especiales.
Haga clic derecho en Administración de usuarios y agregue un nuevo usuario.
Dale a este usuario acceso a:
Configuración Loxone (en la pestaña "Derechos")
Entrada virtual “LOQED_BATTERY” (en la pestaña “Bloques”)
“LOQEDBLOQUEAREntrada virtual STATE” (en la pestaña “Bloques”)
Una vez creado el usuario, asegúrese de establecer también una contraseña. La contraseña distingue entre mayúsculas y minúsculas y no admite caracteres especiales.
7. Pruebas
Guarde la configuración en su miniservidor Loxone y pruebe si funciona visitando la URL: http://loqed:password@LoxoneServerIP/dev/sps/io/LOQED_LOCK_STATE/2
Reemplace "loqed" con el nombre de usuario del paso 6 y "contraseña" con la contraseña del paso 6. Es posible que su navegador muestre un cuadro de diálogo de autenticación (porque su navegador está siendo redirigido), ingrese allí nuevamente los mismos detalles de inicio de sesión. Su navegador debería mostrar entonces el siguiente resultado:
<LL control="dev/sps/io/LOQED_LOCK_STATE/2" valor="2.000" Código="200"/>
Si no ve el resultado anterior, la entrada virtual no funciona correctamente.
También puedes presionar el botón “Iniciar LiveView” y verificar que el estado del bloqueo cambie a DAY_LOCK.
8. Conecte la API LOQED a la entrada virtual
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).
Crea un nuevo 'Webhooks salientes a través de LOQED Bridge'. haciendo clic en Agregar o eliminar webhooks.
Vuelva a crear el formulario como en la imagen a continuación. Utilice su propio nombre de usuario, contraseña e IP puente.
Haga clic en 'Enviar'.
Agregue otro webhook saliente para el porcentaje de batería. URL:
http://loqed:loqed@192.168.2.53/dev/sps/io/PORCENTAJE_BATERÍA/[porcentaje_batería]
Sólo marque 'Batería'.
Ahora deberías tener algo como esto:
Ahora el estado de bloqueo y el porcentaje de batería se enviarán al servidor Loxone en cada cambio de estado.
Consideraciones de seguridad
Recomendamos encarecidamente realizar solo una integración local entre Loxone y LOQED si su red Wi-Fi está correctamente protegida y confía en que todos los dispositivos tengan acceso a esta red Wi-Fi. Si no puede garantizar esto, le recomendamos utilizar nuestra API web en su lugar (Lea el artículo Web API aquí).
Explicación técnica:
Actualizaciones de estado de Loxone: dentro de su red local, las conexiones no se pueden proteger mediante certificados TLS firmados por una autoridad certificadora. Por tanto, el LOQED Bridge incluye una firma que, en teoría, podría ser validada por Loxone. Sin embargo, en el momento de escribir este artículo, Loxone aún no lo admite. Esto significa que cualquier persona o dispositivo con acceso a su red de área local podría hacer que Loxone “pensara” que la puerta estaba abierta. Esto podría desencadenar otras acciones sensibles dependiendo de su situación (por ejemplo, apagar su sistema de alarma).
Una solución alternativa a este problema es utilizar la API web LOQED, que valida el certificado de seguridad del dominio al que se está conectando. Comandos de apertura/bloqueo del LOQED Bridge: dentro de su red local, las conexiones no se pueden proteger mediante certificados TLS firmados por una autoridad certificadora. Por lo tanto, los comandos al puente se pueden firmar digitalmente, de modo que el puente LOQED pueda validar si el mensaje fue enviado por una parte confiable. Al momento de escribir este artículo, Loxone no admite la generación de dicha firma. Por lo tanto, Loxone envía la clave de cifrado al puente en texto sin formato. Cualquier persona o dispositivo con acceso a su red de área local puede ver esta clave de cifrado. Una solución alternativa a este problema es utilizar la API web LOQED, que está protegida mediante HTTPS.
Consejos
Después de reiniciar el miniservidor Loxone, el estado de bloqueo será desconocido, hasta que el estado de bloqueo cambie una vez o se active el intervalo de estado de entrada virtual.
Si envía el mismo comando (por ejemplo, ABRIR) dos veces en 10 segundos, la cerradura inteligente LOQED girará la cerradura lo más que pueda (una apertura de emergencia). Este es un comportamiento normal, simplemente no envíe comandos duplicados demasiado rápido.
El estado de cerradura "ABIERTO" solo está disponible para cerraduras sin manija móvil en el exterior de la puerta. Estas cerraduras tienen tres estados. Aproximadamente 2 segundos después de que dicha cerradura alcance el estado ABIERTO, la cerradura liberará automáticamente el pestillo y enviará el estado "DAY_LOCK" al servidor Loxone.
Si envías el comando “ABRIR” a una cerradura con sólo dos estados (DÍABLOQUEO y NOCHELOCK), la cerradura interpretará esto como si hubiera recibido el comando DAY_LOCK.
Actualmente, el LOQED Bridge no puede conectarse a redes Wi-Fi con caracteres especiales en el nombre de la red SSID o la contraseña (por ejemplo, las letras é o ï).
Funcionalidad futura:
Soporte para solicitar el estado de bloqueo actual cuando se inicia el miniservidor Loxone.
Información de seguridad sobre la seguridad de su cerradura al utilizar esta integración
Físicamente, la cerradura inteligente LOQED tiene la calificación de tres estrellas SKG más alta posible (SKG es la autoridad holandesa de certificación de seguridad de cerraduras, con requisitos más estrictos que los que prescribe la legislación de la UE). La cerradura está firmemente fijada a la puerta y viene con un cilindro incluido. Especialmente para las empresas, esto es más seguro, en comparación con las cerraduras inteligentes que se colocan encima de una llave existente, uno podría acceder fácilmente a la llave tradicional.
Las llaves digitales de la cerradura inteligente LOQED se almacenan en la propia cerradura y en su teléfono. Las claves también se almacenan en el servidor LOQED, pero se cifran con la contraseña de su cuenta. Esto se puede comparar con el funcionamiento de las herramientas de administración de contraseñas en línea. Garantiza que incluso si los servidores LOQED se vieran comprometidos, sus claves seguirán estando seguras. Esto también significa que no podemos dejar de ofrecer la función "olvidé mi contraseña", así que no olvide su contraseña.
Cuando utilice esta integración, almacenará una clave digital en su miniservidor Loxone. Debido a que el sistema Loxone no puede calcular la "firma" de los comandos enviados al servidor LOQED, el miniservidor Loxone enviará la clave en el comando HTTPS y el servidor LOQED calcula la firma. El servidor LOQED envía el comando con la firma a la cerradura inteligente LOQED y olvida la clave inmediatamente después.