Saltar al contenido principal

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

Integración Somfy TaHoma para Gladys Assistant

Caja Somfy TaHoma: persianas, luces, enchufes y sensores, en local o por la nube.

Presentación​

Esta integración trae una caja Somfy TaHoma (TaHoma, TaHoma Switch, TaHoma Beecon, Connexoon) a Gladys: persianas, estores, screens, toldos, cortinas, ventanas de tejado, pérgolas, puertas de garaje y portones (io-homecontrol y RTS), luces, enchufes y los sensores de la caja.

Accede a la caja de dos maneras:

  • en la red local, con la API local del modo desarrollador de Somfy: órdenes y estados ya no pasan por Somfy y funcionan sin internet;
  • a través de la nube de Somfy, con la cuenta de la aplicación TaHoma.

Primero en local por defecto, la nube como respaldo. Gladys muestra en cada dispositivo cuál se usa.

La tienda de Gladys ya ofrece una integración Overkiz (de cicoub13), solo en la nube, que cubre también las cuentas Atlantic Cozytouch, Flexom, Rexel e Hitachi. Esta está dedicada a las cajas Somfy y añade el modo local.

Sin relación con Somfy.

Requisitos​

  • Gladys Assistant 5.3.0 o posterior.
  • Una caja TaHoma, TaHoma Switch, TaHoma Beecon o Connexoon configurada en la aplicación TaHoma.
  • Para el modo local: una caja compatible con el modo desarrollador (no la primera TaHoma cuadrada, no el kit de conectividad), en la misma red que Gladys.
  • Para la nube y los escenarios TaHoma: el correo y la contraseña de la aplicación TaHoma.

Configuración​

Cuenta TaHoma​

Elija la región de su cuenta (Europa para la mayoría), escriba el correo y la contraseña de la aplicación TaHoma y guarde. Gladys se conecta una vez y luego renueva su acceso sola: Somfy bloquea una cuenta que se conecta demasiado a menudo.

La cuenta es opcional si solo usa el modo local, pero es necesaria para los escenarios TaHoma y para el botón Activar el modo local.

Modo local​

Lo más sencillo: guarde su cuenta y pulse Activar el modo local. Gladys enciende el modo desarrollador de la caja, crea un token llamado «Gladys Assistant» y pasa a la red local.

A mano: en la aplicación TaHoma, Configurar la instalación › parámetros de la caja, toque 7 veces el PIN de la caja (del tipo 1234-5678-9012) para abrir el modo desarrollador, cree un token y péguelo en Token local.

Gladys encuentra la caja sola en la red (mDNS). Escriba su dirección IP solo si no la encuentra (otra subred, multicast filtrado); lo mejor es una dirección fija en su router. El PIN de la caja solo sirve para una cuenta con varias cajas.

El interruptor Preferir la conexión local de Gladys (activado por defecto) elige el canal que se prueba primero.

Idioma​

Gladys no comunica su idioma a la integración al buscar o al ejecutar una escena: elija el idioma de los nombres de las funciones y de los errores de las escenas.

Uso​

Dispositivos​

Abra la pestaña Descubrir: cada dispositivo de la caja que Gladys sabe mostrar aparece con el nombre dado en la aplicación TaHoma. Añada los que quiera.

Dispositivo TaHomaEn Gladys
Persiana, estor, screen, ventana, pérgola, puerta de garaje, portónPersiana: abrir / parar / cerrar, posición cuando el motor la indica, lamas si las tiene
ToldoPersiana, posición = despliegue
CortinaCortina
Motor de un solo botónPersiana, abrir y cerrar pulsan el botón
Motor RTSPersiana sin respuesta de estado (el RTS es unidireccional)
LuzLuz: encendido / apagado, intensidad si es regulable
Enchufe, relé, piscinaInterruptor
SensoresTemperatura, luminosidad, humedad, apertura, movimiento, humo, fuga de agua, batería, CO2, potencia, índice de energía (kWh)

Las posiciones indican cuánto está abierto (100 % = abierto), como en todo Gladys. La caja envía los cambios: no se consulta nada en bucle.

Aún no gestionados: la calefacción (termostatos, válvulas, bombas de calor), las alarmas, las cámaras y las lámparas Hue detrás de la caja.

Transporte​

Cada dispositivo muestra una insignia local o nube. Un punto naranja significa que el canal preferido no responde y que Gladys usa el otro: la información emergente da el motivo. Gladys vuelve a probar el canal preferido cada 5 minutos.

En modo local, nada sale de su red, salvo la lectura de los escenarios TaHoma cada hora si hay una cuenta. En modo nube, órdenes y estados pasan por Somfy.

Widgets​

Los widgets Persiana TaHoma, Caja TaHoma y Escenarios TaHoma (ilustración generada, no una captura de pantalla)

  • Persiana TaHoma: una persiana, cuánto está abierta, su estado, sus lamas y su posición «My», con los botones abrir, parar, «My» y cerrar.
  • Caja TaHoma: las persianas de un vistazo, el canal en uso, el firmware, los dispositivos que no responden y un botón para leer de nuevo los estados.
  • Escenarios TaHoma: sus escenarios TaHoma y botones para ejecutar hasta cuatro (ajuste: nombres separados por comas).

Disparadores de escena​

  • Una orden TaHoma ha fallado: desde Gladys, la aplicación TaHoma o un escenario; variables: nombre del dispositivo, código de fallo Overkiz, nombre de la ejecución.
  • Un dispositivo TaHoma deja de responder o vuelve a hacerlo: pila agotada, corte de luz, fuera de alcance.
  • La caja TaHoma se pierde o vuelve: ningún canal la alcanza durante un minuto, o Somfy la indica desconectada.

Acciones de escena​

  • Ejecutar un escenario TaHoma, por su nombre. En modo local, sus órdenes se repiten en la red local.
  • Enviar una orden TaHoma: «My», abrir, cerrar, parar, identificar.

Ejemplos de escenas​

  • Cuando la caja se pierde → enviar un mensaje: «La caja TaHoma ya no responde».
  • Cuando falla una orden de la persiana del salón → avisar con el código de fallo (un obstáculo, una persiana helada).
  • Al anochecer → ejecutar el escenario TaHoma «Buenas noches».

Solución de problemas​

  • Probar la conexión indica qué canal responde y por qué el otro no.
  • «Somfy rechazó el correo o la contraseña»: compruébelos en la aplicación TaHoma. Tras muchos fallos, Somfy bloquea las conexiones un tiempo: espere antes de volver a intentarlo.
  • «Caja no encontrada en la red local»: escriba su dirección IP y compruebe que el modo desarrollador sigue activo (un reinicio de fábrica o algunas actualizaciones lo desactivan).
  • «La caja rechazó el token local»: el token se revocó o pertenece a otra caja: pulse de nuevo Activar el modo local o cree uno nuevo.
  • «El certificado no es el de una caja TaHoma»: la dirección no es la de su caja.
  • Un motor RTS no muestra posición: el RTS es unidireccional, la caja no la conoce.
  • Registros: pestaña Logs de la integración; añada DEBUG=gladys-integration-sdk al contenedor para ver el detalle del SDK. Informe de los problemas en GitHub.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Su cuenta TaHomasectionNoPara una caja TaHoma, TaHoma Switch o Connexoon. Con el correo y la contraseña de la aplicación TaHoma, Gladys accede a la caja por la nube de Somfy, lee sus escenarios TaHoma y puede activar el modo local por usted (botón de arriba). Cada dispositivo de la caja aparece después en la pestaña Descubrir. La cuenta es opcional si solo usa el modo local de abajo. Sin relación con Somfy.
Región de la cuentaselectNo
Correo de la aplicación TaHomastringNo
Contraseña de la aplicación TaHomasecretNo
Modo local (modo desarrollador)sectionNoEn la red local, órdenes y estados ya no pasan por Somfy y funcionan sin internet. Lo más sencillo: guarde su cuenta y pulse «Activar el modo local» arriba. O a mano: en la aplicación TaHoma, Configurar la instalación › parámetros de la caja, toque 7 veces el PIN para abrir el modo desarrollador, cree un token y péguelo abajo. Gladys encuentra la caja sola; escriba su dirección solo si no. No disponible en la primera TaHoma (caja cuadrada) ni en el kit de conectividad.
Token local (opcional)secretNoCreado en el modo desarrollador de la aplicación TaHoma. Déjelo vacío si usa el botón «Activar el modo local».
Dirección IP de la caja (opcional)stringNoSolo si Gladys no encuentra la caja sola (otra subred, multicast filtrado). Lo mejor es una dirección fija en su router.
PIN de la caja (opcional)stringNoSolo para una cuenta con varias cajas: la que se usará, tal como figura bajo la caja. Si no, la primera caja.
Idioma de los textosselectNoNombres de las funciones y mensajes de error de las escenas: Gladys no comunica su idioma a la integración para ellos.

Cómo instalar Somfy TaHoma en Gladys​

  1. En Gladys, abre Integraciones: Somfy TaHoma 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/william-de71/gladys-somfy-tahoma:0.1.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/William-De71/gladys-somfy-tahoma.

Somfy TaHoma requiere Gladys >=5.3.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​

Somfy TaHoma 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 William-De71, 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 🙂