Saltar al contenido principal

Integración domótica Logitech Harmony Hub, gratuita y de código abierto

Integración Logitech Harmony Hub para Gladys Assistant

Logitech Harmony Hub en la red local: actividades, comandos del mando, escenas.

Ver en GitHubTodas las integraciones

Controle su Logitech Harmony Hub desde Gladys, en la red local: inicie una actividad («Ver la tele», «Escuchar música»), apáguelo todo, envíe cualquier tecla del mando a los dispositivos que controla el hub (TV, amplificador, reproductor multimedia…) e inicie escenas cuando empiece una actividad — atenúe las luces cuando empiece «Ver una película», tanto si se inició desde el mando Harmony, la aplicación o Gladys.

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración no tiene ninguna relación con Logitech; Harmony es una marca de Logitech.

Requisitos​

  • Un Logitech Harmony Hub (solo, o el hub de un Harmony Companion, Elite, Pro o Smart Control), configurado con la aplicación Harmony, en la misma red local que Gladys.
  • Gladys 5.1 o posterior.
  • Idealmente, una dirección fija para el hub en su router (reserva DHCP): la integración sigue a un hub que cambia de dirección, pero con una dirección fija la conexión vuelve antes.

No hace falta ninguna cuenta de Logitech, contraseña ni acceso a la nube: la integración habla directamente con el hub, por su puerto local 8088 (la API WebSocket que usa la aplicación Harmony). La antigua API XMPP, desactivada por defecto en los firmwares recientes, no se utiliza.

Configuración​

  1. Instale la integración (Integraciones → Instalar desde GitHub).
  2. Abra su pestaña Configuración. Los hubs de la red local se buscan automáticamente (SSDP, retransmitido por Gladys). Si no se encuentra el suyo, introduzca su dirección IP en Direcciones IP de los hubs (varios hubs: sepárelos con comas). La aplicación Harmony la muestra en Menú → Configuración de Harmony → Añadir/editar dispositivos y actividades → Hub → Información de red; su router también la muestra.
  3. Idioma fija los nombres dados a las funciones de los nuevos dispositivos, el nombre de la opción «Apagado» y el idioma de los mensajes de error (francés por defecto).
  4. Buscar hubs inicia una búsqueda y enumera los hubs encontrados, con su dirección, su número de actividades y de dispositivos, y si responden.
  5. Abra la pestaña Descubrir y añada los dispositivos que desee (véase más abajo).

Los dispositivos​

Cada hub da tres tipos de dispositivos, que se añaden uno a uno desde la pestaña Descubrir. Su nombre empieza por el del hub, por ejemplo «Harmony Living Room · Watch TV».

El hub​

  • Actividad actual: el nombre de la actividad en curso, o «Apagado».
  • Actividad: una lista de las actividades del hub, más «Apagado». Elegir una la inicia (o lo apaga todo). En una escena, la acción del núcleo «Establecer valor del dispositivo» ofrece la misma lista.

Las actividades​

Un dispositivo por actividad, con un único interruptor, En curso: encendido mientras la actividad funciona. Encenderlo inicia la actividad; apagarlo lo apaga todo (si esa actividad estaba en curso). Al ser dispositivos, las actividades se eligen en listas en los desencadenantes y las acciones de escena y en la configuración del widget.

Los dispositivos controlados por el hub​

Un dispositivo por cada aparato que controla el hub (TV, amplificador, Apple TV…):

  • Comando: la lista de todos los comandos que el hub conoce para el aparato (entradas, modos de sonido, botones de colores…). Elegir uno lo envía.
  • Botones pulsadores para las teclas habituales que tiene el aparato: subir y bajar volumen, silenciar, canales, flechas y aceptar, menú, guía, información, volver, salir, reproducir, pausar, detener, retroceder, avanzar, anterior, siguiente, grabar.

Los comandos son los de la configuración del hub: modifíquelos en la aplicación Harmony y la integración leerá la nueva configuración por sí sola.

Tiempo real​

El hub avisa a la integración en el acto cuando empieza una actividad o cuando todo se apaga, sea cual sea el origen: los estados cambian en Gladys en menos de un segundo. Además, la integración lee la actividad actual cada 30 segundos (una notificación perdida, una conexión caída) y vuelve a enviar los estados sin cambios cada 6 horas para que Gladys nunca los muestre como antiguos. El planificador de Gladys no es necesario.

Cuando el hub deja de responder, sus dispositivos muestran la insignia «inaccesible» y la integración se vuelve a conectar sola, cada vez más despacio (hasta una vez por minuto).

Uso de la red​

Todo se queda en la red local: no se contacta con ningún servidor de Logitech. La integración mantiene una conexión abierta por hub y le envía una pequeña petición cada 30 segundos, más una por comando; la configuración se lee cuando cambia. Una búsqueda (al arrancar, cada 15 minutos y con el botón) envía una petición SSDP a través de Gladys y pregunta a cada dirección encontrada si es un hub.

Escenas​

Desencadenantes​

  • Actividad Harmony iniciada: empieza una actividad, desde el mando, la aplicación o Gladys. Filtros (opcionales): la actividad, el hub. Información transmitida a las acciones: la actividad, la actividad anterior, el hub.
  • Harmony lo ha apagado todo: el hub lo apaga todo. Filtro (opcional): el hub. Información: la actividad anterior, el hub.

Se activan cuando el hub comunica el cambio mientras está conectado: un cambio hecho durante un corte actualiza los estados cuando vuelve la conexión, sin iniciar escenas. Si las actividades cambian más de seis veces en un minuto (dos escenas que inician la actividad de la otra), los desencadenantes se pausan durante un minuto.

Acciones​

  • Iniciar una actividad Harmony: elija el dispositivo de actividad; la acción espera a que el hub encienda cada dispositivo (hasta 90 segundos).
  • Apagarlo todo (Harmony): elija el hub, o cualquiera de sus dispositivos.
  • Enviar un comando Harmony: elija el dispositivo y luego un comando de la lista de habituales, o escriba el nombre de cualquier otro en Otro comando (su nombre o su etiqueta, como en la lista Comando del dispositivo, por ejemplo InputHdmi1). Repeticiones lo envía varias veces, con Pausa entre repeticiones (en milisegundos) entre dos.

Ideas de escenas​

  • Desencadenante «Actividad Harmony iniciada», actividad «Ver una película» → bajar las luces del salón al 20 %, cerrar las persianas.
  • Desencadenante «Harmony lo ha apagado todo» → volver a encender las luces del salón.
  • Cada noche a la 1 h → acción «Apagarlo todo (Harmony)» (no se envía nada si todo ya está apagado).
  • Suena el timbre → acción «Enviar un comando Harmony», dispositivo «Denon AV Receiver», comando «Silenciar».

Widget del panel​

Mando Harmony muestra la actividad actual, un botón para hasta tres actividades favoritas (las primeras del hub si no se elige ninguna en su configuración) y un botón Apagar. La actividad en curso lleva una marca. Una pulsación responde en cuanto el hub acepta la orden; el widget sigue el cambio. Con varios hubs, elija uno en la configuración del widget.

Solución de problemas​

  • No se encuentra ningún hub: compruebe que el hub está en la misma red que Gladys e introduzca su dirección IP en la configuración. La búsqueda a través de Gladys necesita un Gladys que retransmita SSDP; las direcciones introducidas siempre funcionan.
  • «Ningún hub responde en…»: la dirección no responde en el puerto 8088. Compruebe la dirección y que el hub está alimentado (su luz).
  • El hub está inaccesible: la integración sigue intentándolo; compruebe el Wi-Fi del hub. Un hub que ha cambiado de dirección se vuelve a encontrar en la siguiente búsqueda (cada 15 minutos, o con el botón Buscar hubs).
  • Un comando no hace nada: el hub lo ha enviado por infrarrojos; compruebe que no hay nada entre el hub (o su emisor IR) y el aparato, y que el comando funciona desde la aplicación Harmony.
  • Falta una actividad nueva: aparece en la pestaña Descubrir cuando el hub se ha sincronizado con la aplicación Harmony (más o menos un minuto).
  • Más detalles: ponga la variable de entorno LOG_LEVEL en debug y lea los registros de la integración.

Límites​

  • Desarrollada sin el hardware: el protocolo sigue a aioharmony, la biblioteca de la integración de Home Assistant, pero esta integración aún no se ha probado con un hub real. Díganos qué funciona y qué no.
  • La acción de escena «Enviar un comando Harmony» ofrece los comandos habituales en una lista; los demás se escriben. La lista completa de un aparato es su función Comando (acción del núcleo «Establecer valor del dispositivo»).
  • Elegir dos veces seguidas el mismo comando en la lista Comando del panel no hace nada la segunda vez (la lista conserva su elección): use los botones pulsadores, el widget o una escena para repetir una tecla.
  • Una tecla se pulsa y se suelta enseguida: no hay pulsación larga.
  • El hub solo conoce lo que ha enviado: el estado de la TV o del amplificador (encendido, volumen, entrada) no se conoce, solo la actividad en curso.
  • Las «Secuencias» de Harmony, las luces Hue y los objetos conectados emparejados con el hub no se exponen.
  • Logitech ya no vende ni desarrolla productos Harmony; una actualización del firmware que cerrara la API local detendría esta integración.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Encontrar sus hubssectionNoLos Harmony Hub de la misma red que Gladys se buscan automáticamente: abra la pestaña Descubrir. Si falta el suyo, introduzca su dirección IP a continuación (aplicación Harmony: Menú, Configuración de Harmony, Añadir/editar dispositivos y actividades, Hub, Información de red). Desarrollada sin el hardware: sus comentarios son bienvenidos. Sin relación con Logitech.
Direcciones IP de los hubsstringNoOpcional, separadas por comas. Solo para los hubs que la búsqueda automática no encuentra. Asigne al hub una dirección fija en su router.
IdiomaselectNoNombres dados a las funciones de los nuevos dispositivos (Actividad, Comando…), nombre de la opción «Apagado» e idioma de los mensajes de error.

Cómo instalar Logitech Harmony Hub en Gladys​

  1. En Gladys, abre Integraciones: Logitech Harmony Hub 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-harmony: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-harmony.

Logitech Harmony Hub 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​

Logitech Harmony Hub 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.

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