Integración domótica Motionblinds, gratuita y de código abierto
Estores, persianas y cortinas Motionblinds con el puente Motion local: posición, lamas, batería.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Presentación
Esta integración controla desde Gladys los estores, persianas y cortinas Motionblinds (Coulisse) y las marcas hermanas vendidas en Europa en la misma plataforma (Brel Home, Bloc Blinds, Dooya, Acmeda Automate Pulse 2…), en local, a través del puente Wi-Fi Motion (CM-20, CM-32…) o de un motor Wi-Fi Motion. Sin nube ni cuenta: Gladys se comunica con el puente en su red, con el mismo protocolo que la aplicación Motion.
Cada estor se convierte en un dispositivo de Gladys: abrir / cerrar / detener, su posición, la inclinación de las lamas de las persianas venecianas, la batería de los motores con batería y la señal de radio.
Desarrollada sin el hardware: sus comentarios son bienvenidos. La integración se escribió a partir del protocolo tal como lo usan la biblioteca libre motionblinds y Home Assistant, y se probó contra un puente simulado. Si algo se comporta de forma extraña con sus estores, abra una incidencia en github.com/guim31/gladys-motionblinds/issues.
Esta integración no está afiliada a Coulisse / Motionblinds.
Requisitos
- Gladys Assistant 5.1 o posterior.
- Un puente Wi-Fi Motion (o motores Wi-Fi Motion), configurado en la aplicación Motion, en la misma red que Gladys.
- La clave de la aplicación Motion (véase más abajo).
- Mejor: una dirección IP fija para el puente (una reserva DHCP en su router).
Configuración
Instale la integración desde la tienda de Gladys y abra su pestaña Configuración.
La clave de la aplicación Motion
El puente solo obedece a las peticiones firmadas con la clave de su cuenta Motion:
- abra la aplicación Motion en su teléfono;
- toque ⋮ (arriba a la derecha) y luego Ajustes;
- abra la página Acerca de («Motion APP About») y tóquela cinco veces rápidamente;
- una ventana muestra la clave: 16 caracteres con guiones, como
12ab345c-d67e-8f.
Cópiela tal cual, guiones incluidos, en Clave de la aplicación Motion. Gladys la guarda como un secreto y nunca aparece en los registros de la integración. Si sus estores usan la aplicación de otra marca basada en la plataforma Motion, la clave suele esconderse de la misma forma en su página Acerca de.
La dirección del puente
Dirección IP del puente Motion: la dirección que su router dio al puente. Para varios puentes, o motores Wi-Fi Motion (cada uno es su propio puente), separe las direcciones con comas.
Si lo deja vacío, Gladys busca por sí misma los puentes Motion en la red (una petición de descubrimiento en el puerto UDP 32100, emitida por Gladys para la integración). Algunos puentes solo responden al grupo multicast de la aplicación Motion: si no se encuentra nada, introduzca la dirección.
Los demás ajustes
- Intervalo de actualización: frecuencia con la que Gladys lee el estado de los estores (de 10 a 60 segundos, 30 por defecto). Véase «Cómo se actualiza el estado».
- Permitir controlar las puertas de garaje: desactivado por defecto (véase más abajo).
- Idioma de los nombres de los dispositivos: nombres dados a los nuevos dispositivos y a sus funciones.
Después, ejecute Buscar puentes y estores: la acción enumera los puentes encontrados y sus estores, y comprueba la clave con una consulta de estado (nada se mueve). Abra la pestaña Descubrir y añada sus estores.
Dispositivos
Un dispositivo por estor, con el nombre de su tipo en la aplicación Motion («Estor enrollable 0001», «Persiana veneciana 0002»…): cámbielo en Gladys. Las cortinas están en la categoría cortina, todo lo demás en la categoría persiana.
Funciones
| Función | Lo que hace |
|---|---|
| Abrir / cerrar | Abrir, detener, cerrar. Indica abierto o cerrado en los extremos, detenido entre ambos, el sentido. |
| Posición | 0 % = cerrado, 100 % = abierto, como todas las persianas de Gladys. |
| Inclinación de las lamas | Persianas venecianas, Shangri-La, verticales, estores dobles: 100 % = lamas abiertas. |
| Posición del riel superior | Estores de doble apertura: el riel superior (la posición es la del riel inferior). |
| Batería | Motores con batería: el nivel, calculado a partir de la tensión de la batería. |
| Cargando | Motores con batería que lo indican (panel solar, cargador). |
| Señal de radio | Motores bidireccionales: la señal de radio entre el motor y el puente, en dBm. |
Lo que un motor no sabe decir no se publica: un motor unidireccional solo tiene Abrir / cerrar (muestra la última orden enviada), un motor que solo conoce sus finales de carrera no tiene posición. Una vez ajustada la inclinación, una nueva posición la conserva, como hace la aplicación Motion.
La inclinación de las lamas es un segundo control deslizante, porque Gladys no tiene función de inclinación: en HomeKit aparece como una segunda persiana con su nombre.
Puertas de garaje y puertas enrollables
Un motor Wi-Fi Motion de puerta de garaje y un estor de tipo «Puerta enrollable» abren la casa. Por defecto se publican en solo lectura: su estado se muestra, pero ni Gladys, ni una escena, ni un asistente de voz pueden moverlos. Active Permitir controlar las puertas de garaje para controlarlos y acepte la actualización que Gladys propone en la pestaña Descubrir. Los botones del widget nunca los mueven, ni siquiera entonces.
Widget
Estores Motion: todos los estores Motion añadidos a Gladys en una sola tarjeta, ordenados por nombre, con la posición de cada uno, una batería por debajo del 20 % y los estores que ya no responden. Sus botones actúan sobre todos a la vez:
- Abrir todo y Cerrar todo (con una confirmación);
- Detener todo.
Las puertas de garaje y las puertas enrollables aparecen en la lista, pero estos botones nunca las mueven.
Disparador de escena
Estor movido fuera de Gladys: un estor cambió de posición sin una orden de Gladys: desde su mando, la aplicación
Motion, una programación Motion o un sensor solar. Filtros: el estor y el sentido (Abierto, Cerrado; vacío para
ambos). La escena recibe el sentido (opening, closing) y la nueva posición en %.
Un cambio se detecta en la siguiente lectura (30 s por defecto). Los cambios en los 3 minutos posteriores a una orden de Gladys cuentan como propios de Gladys.
Acción de escena
Ir a la posición favorita: el estor va a la posición favorita guardada en su motor (ajustada antes con el mando Motion). Abrir, cerrar, una posición y una inclinación son las acciones habituales «Controlar un dispositivo» de Gladys.
Ejemplos de escenas
- Al atardecer, cerrar el dormitorio: disparador «Puesta de sol», acción «Controlar un dispositivo» → Abrir / cerrar del estor del dormitorio en «Cerrar».
- Ola de calor: si la temperatura exterior supera 28 °C entre las 12 y las 17 h, ajuste la Posición de los estores orientados al sur al 20 % y su Inclinación de las lamas al 30 %.
- Control manual: disparador Estor movido fuera de Gladys en el salón, sentido «Abierto» → enviar un mensaje «Estor del salón abierto a mano», y deje que sus escenas automáticas lo comprueben antes de volver a cerrarlo.
- Despertar: a las 7:30 los días laborables, Ir a la posición favorita para el estor del dormitorio.
- Batería: cuando una Batería baje del 15 %, enviar un mensaje.
Cómo se actualiza el estado
El puente difunde cada cambio en multicast, que nunca llega al contenedor de la integración (Gladys lo ejecuta en una red Docker privada). Por eso la integración lee los estores por sí misma:
- en cada intervalo de actualización (30 s por defecto), lee el estado que el puente guarda de cada estor añadido a Gladys. No les cuesta nada a los motores: sin tráfico de radio, el puente responde de memoria, y su memoria sigue los informes de los propios motores;
- cada 15 minutos, pregunta por radio su estado a cada motor bidireccional (Home Assistant lo hace cada 10). Un motor con batería se despierta brevemente para ello;
- tras una orden, consulta el motor cada 5 segundos (10 para un motor Wi-Fi) hasta que se detiene, 2 minutos como máximo.
Sin nube ni cuota: todo queda entre Gladys y el puente, una petición cada vez, como espera el puente. Gladys también puede consultar los estores; un estor leído hace menos de medio intervalo se omite entonces.
Solución de problemas
- «No se ha encontrado ningún puente Motion»: introduzca la dirección del puente en la configuración. Compruebe que Gladys y el puente están en la misma red y que el puente responde en la aplicación Motion.
- «El puente Motion ha rechazado la clave»: copie de nuevo la clave desde la aplicación Motion, guiones incluidos (16 caracteres). Una nueva cuenta Motion cambia la clave.
- «Ningún puente Motion responde»: el puente está apagado o ha cambiado de dirección: asígnele una dirección fija en su router.
- Falta un estor: vincúlelo con el puente en la aplicación Motion y ejecute Buscar puentes y estores.
- La posición va con retraso: un cambio hecho con el mando aparece en la siguiente lectura; reduzca el intervalo de actualización.
- Más detalles: ajuste
LOG_LEVEL=debugen la integración (los registros nunca muestran la clave).
Limitaciones
- Desarrollada sin el hardware: los detalles del protocolo provienen de la biblioteca libre motionblinds y de Home Assistant; los tipos de estores no probados (doble apertura, triangulares, estores dobles, puertas de garaje Wi-Fi) pueden necesitar correcciones.
- Los cambios hechos fuera de Gladys aparecen en la siguiente lectura, no al instante (sin multicast en el contenedor).
- El descubrimiento automático puede no encontrar todos los puentes: la dirección siempre puede introducirse.
- Un motor unidireccional no dice nada: Gladys muestra la última orden enviada, no lo que hizo el estor.
- Un estor de doble apertura: abrir / cerrar mueve ambos rieles; los dos controles deslizantes mueven un riel cada uno.
- La señal Wi-Fi del puente y los ajustes de los finales de carrera no están disponibles: ajústelos en la aplicación Motion.
Ayuda
Preguntas e incidencias: github.com/guim31/gladys-motionblinds/issues, o el foro de la comunidad Gladys. Indique el modelo de su puente, los tipos de estores y los registros de la integración (nunca contienen la clave).
Parámetros de configuración
Estos son los parámetros que Motionblinds te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectarse al puente Motion | section | No | Gladys se comunica con su puente Wi-Fi Motion en su red, sin la nube. Necesita la clave de la aplicación Motion: abra la aplicación, toque ⋮, Ajustes y luego toque cinco veces rápidamente la página «Acerca de». Aparece la clave, 16 caracteres con guiones. |
| Dirección IP del puente Motion | string | No | Aparece en su router. Varios puentes o motores Wi-Fi: sepárelos con comas. Si lo deja vacío, Gladys intenta encontrar el puente por sí misma. |
| Clave de la aplicación Motion | secret | Sí | 16 caracteres, guiones incluidos, tal como la muestra la aplicación. |
| Intervalo de actualización | select | No | Frecuencia con la que Gladys lee el estado que el puente guarda para cada estor, para seguir el mando, la aplicación Motion y las programaciones. No cuesta nada a los motores. |
| Permitir controlar las puertas de garaje | boolean | No | Desactivado: las puertas de garaje y enrollables se muestran sin sus controles y el widget nunca las mueve. Abren la casa: actívelo solo si lo necesita. |
| Idioma de los nombres de los dispositivos | select | No | Nombres dados a los nuevos estores y a sus funciones (Estor enrollable, Posición, Inclinación de las lamas…). |
Cómo instalar Motionblinds en Gladys
- En Gladys, abre Integraciones: Motionblinds aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-motionblinds: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). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-motionblinds.
Motionblinds 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
Motionblinds 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