Saltar al contenido principal

Integración domótica August / Yale, gratuita y de código abierto

Integración August / Yale para Gladys Assistant

Cerraduras inteligentes y videoporteros August y Yale, a través de la nube August / Yale.

Ver en GitHubTodas las integraciones

Esta integración lleva sus cerraduras inteligentes y videoporteros August y Yale a Gladys Assistant, a través de la nube August / Yale — la misma que usan las apps oficiales.

Qué obtiene​

DispositivoEn Gladys
Cerradura inteligenteBloquear / desbloquear, batería, puerta abierta / cerrada (DoorSense), batería del teclado
VideoporteroÚltima imagen (cámara), timbre, movimiento, batería

Además de los dispositivos:

  • Disparadores de escena: Cerradura accionada (filtro por cerradura, acción — bloqueada, desbloqueada, abierta — y modo: app, a distancia, teclado, a mano, bloqueo automático, huella, llavero; el nombre del usuario está disponible como variable), Cerradura atascada, Timbre pulsado, Movimiento ante el timbre.
  • Acciones de escena: Bloquear una puerta, Desbloquear una puerta, Abrir una puerta (retraer el pestillo), Capturar una imagen del timbre. Cada una indica si ha tenido éxito, para condicionar las acciones siguientes.
  • Widgets del panel: Cerradura (una cerradura con sus botones, o un resumen de todas las cerraduras con un botón «Bloquear todo»), Videoportero (última imagen, último timbrazo y último movimiento), Actividad de puertas (quién hizo qué, cómo y cuándo).

Modelos compatibles: todas las cerraduras y timbres gestionados por las apps August, Yale Access y Yale Home — August Smart Lock (todas las generaciones), August Wi-Fi Smart Lock, Yale Linus, Yale Linus L2, Yale Assure Lock / Assure Lock 2, Yale Conexis L2, Yale Unity, August View, Yale Smart Video Doorbell…

Requisitos​

  • Gladys Assistant 5.1 o posterior.
  • Una cuenta en la app August, Yale Access o Yale Home, con sus dispositivos ya instalados.
  • Para ver el estado en directo y controlar una cerradura desde Gladys, la cerradura debe ser accesible desde la nube: un puente Wi-Fi (August Connect, Yale Connect Wi-Fi Bridge) o una cerradura con Wi-Fi integrado. Sin puente, la cerradura aparece con un punto naranja: su estado solo se actualiza cuando un teléfono con la app la encuentra por Bluetooth.

La integración funciona solo a través de la nube: el contenedor de Gladys no tiene acceso al Bluetooth, por lo que el control local no está disponible.

Configuración​

  1. Abra Integraciones → August / Yale → Configuración.
  2. Elija la app en la que están registradas sus cerraduras:
    • August — la app August;
    • Yale Access — la app Yale Access (Norteamérica);
    • Yale Home — la app Yale Home (Europa y resto del mundo).
  3. Elija el método de inicio de sesión (correo o número de teléfono), introduzca el usuario y la contraseña de su cuenta y guarde.
  4. La primera vez, la nube envía un código de verificación por correo o SMS. Introdúzcalo en la acción Validar el código de la pantalla de configuración. ¿No lo ha recibido? Use Enviar un código nuevo.
  5. Abra la pestaña Descubrimiento: sus cerraduras y timbres aparecen en la lista. Créelos.

El código solo se pide una vez: la sesión se conserva en el almacenamiento de la integración. Cambiar de cuenta o de app pide un código nuevo.

Opciones​

  • Eventos en tiempo real (activado por defecto): los eventos (cerradura accionada, timbre pulsado…) llegan en pocos segundos por el canal que usan las apps. Desactivado, la actividad se lee cada minuto.
  • Permitir el desbloqueo desde Gladys (activado por defecto): desactívelo para garantizar que Gladys puede bloquear pero nunca desbloquear ni abrir una puerta — los widgets solo muestran entonces el botón «Bloquear» y las acciones de escena de desbloqueo se rechazan.
  • Intervalo de actualización: frecuencia de relectura de todos los dispositivos (5 minutos por defecto, 1 minuto como mínimo).

Valores​

  • Cerradura: 1 = bloqueada, 0 = desbloqueada (un pestillo retraído vale 0).
  • Puerta: 1 = cerrada, 0 = abierta.
  • Timbre y movimiento: 1 durante unos segundos y después 0.

Solución de problemas​

  • «Inicio de sesión rechazado»: compruebe la app (August / Yale Access / Yale Home), el método de inicio de sesión y la contraseña. Inicie sesión en la app con los mismos datos para asegurarse.
  • No llega el código: revise la carpeta de spam y use Enviar un código nuevo. Un número de teléfono debe estar en formato internacional (p. ej. +34612345678).
  • Una cerradura aparece inaccesible: su puente Wi-Fi está desconectado. Compruebe su alimentación y su Wi-Fi.
  • Cuentas Yale Home: Yale está migrando las cuentas Yale Home a un nuevo sistema de inicio de sesión. Si el inicio de sesión se rechaza aunque los datos funcionen en la app, abra una issue en el repositorio.
  • Use Probar la conexión para volver a leer la cuenta y ver cuántas cerraduras y timbres se han encontrado. Los registros de la integración (Gladys → Ajustes → Sistema → Integraciones) dan más detalles; nunca contienen su contraseña ni su token.

Privacidad y seguridad​

La contraseña permanece en la configuración de Gladys; el token de sesión se guarda en el volumen privado de la integración. Solo se contacta con la nube August / Yale, su servicio en tiempo real (PubNub) y el alojamiento de las imágenes de los timbres (Cloudinary). Comunique cualquier problema de seguridad en privado, consulte SECURITY.md en el repositorio.

Parámetros de configuración​

Estos son los parámetros que August / Yale te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Su cuenta August / YalesectionNoUtilice la cuenta de la app August, Yale Access o Yale Home. En la primera conexión, la nube le envía un código de verificación por correo o SMS: introdúzcalo con la acción «Validar el código» de abajo. Se necesita un puente Wi-Fi (August Connect, Yale Connect) o una cerradura Wi-Fi para ver el estado en directo y controlar la cerradura desde Gladys.
AplicaciónselectSíLa app en la que están registradas sus cerraduras.
Método de inicio de sesiónselectSí
Correo o número de teléfonostringSíUn número de teléfono en formato internacional, p. ej. +34612345678.
ContraseñasecretSí
OpcionessectionNoEl canal en tiempo real trae los eventos (cerradura accionada, timbre pulsado) en pocos segundos; el intervalo de actualización vuelve a leer todos los dispositivos en segundo plano.
Eventos en tiempo realbooleanNo
Permitir el desbloqueo desde GladysbooleanNoDesactivado, Gladys puede bloquear pero nunca desbloquear ni abrir una puerta.
Intervalo de actualización (s)numberNoFrecuencia de relectura de todos los dispositivos, en segundos (un minuto como mínimo).

Cómo instalar August / Yale en Gladys​

  1. En Gladys, abre Integraciones: August / Yale aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/gboulvin/gladys-august-yale:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-August-Yale.

August / Yale requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

August / Yale es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en