Integración domótica DoorBird, gratuita y de código abierto

Porteros DoorBird en local: imagen, timbre, movimiento, infrarrojos, apertura en escenas.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Integra sus porteros de vídeo DoorBird (D10x, D11x, D21x, D2101V…) en Gladys, en local, mediante su API LAN oficial: la imagen de la cámara, los timbrazos, el detector de movimiento, la luz infrarroja y —solo si usted lo autoriza— la apertura de la puerta desde una escena. Nada pasa por una nube.

Developed without the hardware: feedback welcome. Desarrollada sin el hardware: sus comentarios son bienvenidos, lo que funciona y lo que no, en GitHub.

Esta integración no está afiliada a Bird Home Automation (DoorBird).

Requisitos previos

• Gladys 5.1.0 o posterior.
• Un portero DoorBird en la misma red que Gladys, con una dirección fija (configúrela en su router).
• La app DoorBird, con las credenciales de administrador del portero (en el «Digital Passport» entregado con él), para crear un usuario para Gladys.

Crear un usuario DoorBird dedicado

Gladys no debe usar la cuenta de administrador. En la app DoorBird: Ajustes → Administración, inicie sesión con las credenciales de administrador y luego Usuario → +. La app da al nuevo usuario un nombre como abcdef0001 y una contraseña: anote ambos. Concédale solo lo que Gladys necesita:

• Watch always (vista en directo en cualquier momento): la imagen de la cámara en cualquier momento y la luz infrarroja. Sin este permiso, el DoorBird solo abre su imagen durante 5 minutos tras un timbrazo.
• Los relés que podrá usar la apertura de la puerta, y solo si usted la autoriza en Gladys (vea más abajo).
• Nada más: Gladys no necesita ni «API-Operator», ni el historial, ni los favoritos.

Compruebe también que el detector de movimiento está activado en el DoorBird (Administración → Detector de movimiento); de lo contrario, no se indica ningún movimiento. Los nombres de los permisos pueden variar según la versión y el idioma de la app.

Configuración

En Gladys: Integraciones → DoorBird → Configuración.

• Dirección del DoorBird: la dirección IP del portero, p. ej. 192.168.1.50 (con :puerto si no es 80, https:// para HTTPS).
• Usuario DoorBird y Contraseña: el usuario creado arriba. La contraseña solo se envía al DoorBird. Tras un rechazo, la integración deja de intentarlo (nunca insiste) hasta que usted la corrija o pulse «Probar la conexión».
• Segundo DoorBird (opcional): Su dirección, Su usuario y Su contraseña, para un portón o una puerta trasera.
• Imagen del DoorBird: frecuencia de actualización de la imagen de cada DoorBird (solo con eventos, cada minuto, cada 5 minutos —por defecto—, cada 15 minutos o cada hora). Un timbre o un movimiento siempre toman una nueva.
• Permitir abrir la puerta: desactivado por defecto. Vea «Abrir la puerta (relé DoorBird)» más abajo.
• Idioma de los nombres: idioma de los nombres de funciones (francés por defecto) y de los textos enviados a las escenas. Los nombres se fijan al añadir el dispositivo: cambie el idioma antes de añadirlo.

Abra después la pestaña Descubrir y añada el DoorBird a Gladys.

El dispositivo DoorBird

Un dispositivo por DoorBird, con el nombre de su modelo (por ejemplo «DoorBird D2101V»), con estas funciones:

Función	Tipo	Qué hace
Imagen	cámara	La imagen de la cámara, actualizada al intervalo elegido, en cada timbre y cada movimiento.
En línea	entrada	1 mientras el DoorBird responde, 0 cuando no se puede alcanzar.
Timbre	timbre	1 cuando alguien llama, vuelve a 0 diez segundos después.
Movimiento	detector de movimiento	1 mientras el detector del DoorBird indica movimiento.
Luz infrarroja	luz	Enciende la luz infrarroja. Se apaga sola tras unos 3 minutos.

La luz infrarroja no se puede apagar por orden: el DoorBird no lo ofrece, y la integración lo dice en lugar de fingir. La puerta nunca es una función del dispositivo: ningún interruptor, ningún asistente de voz, ningún botón del panel puede abrirla.

Widget del panel

El widget DoorBird muestra, para todos los DoorBird o el elegido en su configuración («DoorBird (vacío: todos)»):

• el número de timbrazos y de movimientos de las últimas 24 horas;
• los últimos timbrazos y movimientos, del más reciente al más antiguo, cada uno con la imagen tomada en ese momento;
• si cada DoorBird está en línea;
• con un solo DoorBird añadido a Gladys, un botón Luz infrarroja.

La lista se guarda en memoria: vuelve a estar vacía cuando la integración se reinicia.

Disparadores de escena

• Alguien llama al DoorBird: un timbrazo. Filtro: el DoorBird (vacío: cualquiera). Variable: Nombre del DoorBird.
• Movimiento delante del DoorBird: el inicio de un movimiento. Filtro: el DoorBird. Variable: Nombre del DoorBird.

La imagen del DoorBird se actualiza antes del disparo: una acción «enviar la imagen de la cámara» en la misma escena envía al visitante. Un disparo por DoorBird cada 15 segundos como máximo (una pulsación larga, una persona que se queda delante de la cámara cuentan una vez).

Acciones de escena

• Actualizar la imagen del DoorBird: toma ahora una imagen nueva, para enviarla después en un mensaje.
• Abrir la puerta (relé DoorBird): activa un Relé del DoorBird (cerradura, portón): 1 o 2 para los relés del DoorBird, abcdef@1 para un relé de un controlador de puerta asociado («Probar la conexión» los lista). Solo funciona una vez marcado Permitir abrir la puerta. Solo se acepta un relé que el DoorBird lista, y la orden se envía una vez, nunca se repite.

Atención. Una escena que abre una puerta la abre a quien esté delante. No la vincule nunca a un disparador que cualquiera desde fuera pueda provocar (un timbrazo, un movimiento): úsela con una condición que solo usted controle (una confirmación, su presencia en casa). Conceda al usuario de Gladys solo los relés necesarios.

Acciones de configuración

• Probar la conexión: vuelve a leer cada DoorBird e indica su modelo, su firmware y sus relés, y si su usuario puede tomar una imagen. También reanuda un DoorBird detenido tras una contraseña rechazada.
• Mostrar la dirección del flujo de vídeo: la dirección RTSP de un DoorBird (rtsp://usuario:PASSWORD@dirección:554/mpeg/media.amp), para añadir el vídeo en directo a la integración «Cámara RTSP» de Gladys. Sustituya PASSWORD usted mismo: la integración nunca la muestra.

Ejemplos de escenas

• Alguien llama → foto en el teléfono: disparador «Alguien llama al DoorBird», acción «enviar un mensaje con la imagen de la cámara» (la imagen del DoorBird).
• Movimiento de noche → luz de la entrada: disparador «Movimiento delante del DoorBird», condición «después de la puesta de sol», acción «encender la luz de la entrada 5 minutos».
• Movimiento en su ausencia → alerta: disparador «Movimiento delante del DoorBird», condición «nadie en casa», acciones «Actualizar la imagen del DoorBird» y luego «enviar un mensaje con la imagen de la cámara».

Funcionamiento

• Eventos: la integración mantiene una conexión abierta al flujo de eventos del DoorBird (monitor.cgi): los timbrazos y movimientos llegan en menos de un segundo. El DoorBird repite su estado cada 20 segundos aproximadamente; una conexión muda durante un minuto se vuelve a abrir.
• Por qué no los favoritos DoorBird: un DoorBird también puede llamar a una dirección HTTP en cada evento, pero el entorno aislado de Gladys no acepta ninguna conexión entrante. El flujo de eventos es una conexión saliente, la vía fiable aquí. No se usa el historial en la nube del DoorBird.
• Carga en el DoorBird (su API LAN no tiene cuota publicada, la integración es ligera): la conexión de eventos, info.cgi cada 5 minutos (cada minuto mientras el flujo de eventos está cortado), una imagen al intervalo elegido y en cada evento (12 imágenes por minuto y por DoorBird como máximo, el límite de Gladys), dos solicitudes a la vez como máximo. Los estados solo se envían a Gladys cuando cambian, y si no cada 6 horas.

Solución de problemas

• «Nombre de usuario o contraseña rechazados»: compruebe el usuario (no el administrador) y su contraseña, y pulse Probar la conexión. La integración se detiene al primer rechazo y nunca insiste.
• «Este usuario DoorBird no tiene ese permiso»: conceda al usuario «Watch always» (imagen, infrarrojos) o el relé (puerta) en la app DoorBird.
• Sin imagen entre dos timbrazos: la misma causa, falta «Watch always».
• Ningún movimiento: active el detector de movimiento del DoorBird y compruebe su zona de detección.
• «No hay API LAN de DoorBird en esta dirección»: dirección incorrecta, o un dispositivo sin la API LAN.
• Detalles: los registros de la integración (Integraciones → DoorBird) indican cuándo se pierde y se recupera un DoorBird. Para todo lo demás, configure LOG_LEVEL=debug.

Limitaciones

• Desarrollada sin el hardware: las respuestas proceden del código publicado de DoorBirdPy, Home Assistant, Homebridge y openHAB. Sus comentarios son bienvenidos.
• Las tarjetas RFID y los códigos del teclado no se indican: el flujo de eventos de la API LAN solo lleva el timbre y el detector de movimiento; los demás eventos pasan por los favoritos DoorBird (una conexión entrante, imposible en el entorno aislado).
• El vídeo en directo no forma parte de esta integración: use la dirección RTSP en la integración «Cámara RTSP».
• Sin audio bidireccional, sin SIP, sin historial DoorBird (nube).
• Dos DoorBird como máximo. Un controlador de puerta (A1081) se usa mediante los relés de su DoorBird asociado.
• La luz infrarroja no se puede apagar por orden; sus 3 minutos los decide el DoorBird.
• Un timbrazo o un movimiento ocurrido mientras la integración está detenida no se recupera.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Su DoorBird	section	No	Porteros de vídeo DoorBird de su red, mediante su API LAN oficial. Cree un usuario dedicado en la app DoorBird, solo con los permisos necesarios (vea la documentación). Nada pasa por una nube.
Dirección del DoorBird	string	Sí	Dirección IP o nombre del portero, con :puerto si no es 80, https:// para HTTPS. Asígnele una dirección fija en su router.
Usuario DoorBird	string	Sí	Un usuario creado en la app DoorBird (Administración, Usuario), no el administrador.
Contraseña	secret	Sí	Solo se envía al DoorBird, nunca a una nube. Tras un rechazo, la integración no reintenta hasta que la corrija.
Segundo DoorBird	section	No	Opcional: un segundo portero (portón, puerta trasera), con su propio usuario.
Su dirección	string	No
Su usuario	string	No
Su contraseña	secret	No
Imagen del DoorBird	select	No	Frecuencia de actualización de la imagen de los DoorBird añadidos. Un timbre o un movimiento siempre envían una nueva.
Permitir abrir la puerta	boolean	No	Permite que las escenas activen un relé del DoorBird (cerradura, portón): solo acción de escena, nunca un interruptor. Desactivado por defecto.
Idioma de los nombres	select	No	Idioma de los nombres de funciones y de los textos enviados a las escenas. Se fijan al añadir un dispositivo.

Cómo instalar DoorBird en Gladys

1. En Gladys, abre Integraciones: DoorBird 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/guim31/gladys-doorbird:1.0.1), 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/guim31/gladys-doorbird.

DoorBird 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

DoorBird 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 guim31, no el equipo principal de Gladys.

• Explorar todas las integraciones, nativas y de la comunidad
• Crear y publicar tu propia integración externa
• Código fuente en GitHub — fuente de esta documentación

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 🙂