Saltar al contenido principal

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

Integración Philips TV para Gladys Assistant

Televisores Philips Android y Saphi: encendido, volumen, fuentes, apps, Ambilight, teclas, en local.

Controle sus televisores Philips desde Gladys, en su red local: encenderlos y apagarlos, ajustar el volumen, cambiar de fuente, abrir una aplicación, cambiar de canal, ajustar el Ambilight (estilo, color fijo, encendido o apagado), pulsar cualquier tecla del mando, desde el panel o desde una escena. Y reaccionar a lo que pasa en pantalla: «cuando Netflix se abra en el televisor, bajar las luces».

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha construido y probado con las respuestas reales de televisores Philips que conserva la biblioteca libre ha-philipsjs (la que usa Home Assistant) y con la documentación comunitaria de la API JointSpace, con un televisor simulado, no con un televisor Philips real. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.

Lo que necesita​

  • Gladys Assistant 5.1.0 o posterior.
  • Un televisor Philips con la API JointSpace 6, en la misma red local que Gladys, con una dirección IP fija (una reserva DHCP en su router):
    • un modelo Android TV o Google TV (2016 y posteriores): emparejado una vez con Gladys, con un código que muestra el televisor;
    • o un modelo Saphi (Linux): sin emparejamiento.
  • Para encender el televisor desde Gladys: en el televisor, Encender con Wi-Fi (WoWLAN) o Encender con Chromecast activado (normalmente en Ajustes → Redes inalámbricas y redes → Con cable o Wi-Fi). Sin ello, muchos televisores apagan su red en espera.

Puesta en marcha​

  1. Instale la integración desde el catálogo de Gladys.

  2. Encienda el televisor. En Configuración, haga clic en Buscar televisores: los televisores que responden en su red se colocan en las posiciones libres (televisor 1, 2, 3), con su dirección. O escriba usted mismo la Dirección del televisor (por ejemplo 192.168.1.20). Si quiere, dele un Nombre, y guarde.

  3. Un televisor Android se empareja después una vez:

    1. haga clic en Mostrar un código de emparejamiento en el televisor (elija el televisor): aparece un código de 4 cifras en pantalla;
    2. escríbalo en Confirmar el código de emparejamiento (el mismo televisor) y ejecútela, rápido: el televisor espera unos 30 segundos.

    Gladys aparece en el televisor como Gladys Assistant. La integración conserva el emparejamiento: no volverá a pedirse ningún código. Un televisor Saphi no necesita emparejamiento.

  4. Haga clic en Probar la conexión: el mensaje bajo el botón indica, para cada televisor, si responde, su modelo, si está encendido y emparejado.

  5. Abra la pestaña Descubrir: un dispositivo por televisor. Haga clic en Añadir, elija una estancia, guarde. Un televisor aparece en cuanto ha respondido una vez: enciéndalo si no aparece. Buscar en esta pestaña también busca televisores nuevos.

Las opciones al final de la página:

  • Wake-on-LAN (activado por defecto): un televisor cuya red se duerme en espera ya no responde. Gladys pide entonces a su núcleo que envíe un paquete Wake-on-LAN a la dirección MAC que dio el televisor, que lo despierta. La integración lo declara, como muestra la pantalla de instalación.
  • Intervalo de actualización: con qué frecuencia se leen los televisores (10 s por defecto). A un televisor en espera solo se le pregunta su estado y su Ambilight.
  • Idioma de los nombres de funciones: los nombres dados a las funciones al añadir un dispositivo, y los textos de las listas y de los eventos de escena.

El dispositivo de cada televisor​

FunciónLo que hace
EncendidoEncendido o en espera. El encendido se lo pide al televisor, o envía un paquete Wake-on-LAN si no responde en absoluto.
VolumenEl volumen, como control deslizante, dentro de los límites del televisor (0 a 60 en la mayoría de los modelos).
Bajar volumenUn paso más bajo, como el mando.
Subir volumenUn paso más alto.
SilenciarSilencia o restablece el sonido.
FuenteTelevisores Android: TV (el sintonizador) o HDMI 1 a HDMI 4, y para cambiar. Otra es una aplicación; elegirla pulsa Inicio.
AplicaciónTelevisores Android: la aplicación en primer plano (el televisor la indica), y para abrir otra. Inicio u otra pulsa Inicio.
CanalEl número del canal en pantalla, y para cambiar a otro número.
Canal anteriorCanal anterior.
Canal siguienteCanal siguiente.
En reproducciónLo que hay en pantalla, como texto: 5 · La 1, Netflix, HDMI 2, Fuente HDMI o Apagada.
AmbilightAmbilight encendido o apagado.
Estilo AmbilightEl estilo, de los menús del televisor: Seguir el vídeo (Estándar, Intenso, Juego…), Seguir el audio (Lumina, Retro…), Lounge light (Lava ardiente…) o Color fijo.
Color AmbilightUn color fijo, con el selector de color de Gladys.
Ambilight + HueLas lámparas Hue que siguen al Ambilight, encendidas o apagadas (solo televisores con Ambilight + Hue).

El televisor indica lo que sabe hacer: un televisor Saphi no tiene Fuente ni Aplicación, un televisor sin Ambilight ninguna función Ambilight. Las listas (aplicaciones, estilos Ambilight, canales) se leen en el televisor y la integración las conserva: están ahí incluso cuando duerme. Un comando que necesita la pantalla (una fuente, una aplicación, un canal) enciende primero el televisor y lo espera, hasta 25 segundos.

Panel​

Cuatro widgets, para colocar uno al lado de otro; cada uno muestra un televisor (el primero de la configuración si no se elige ninguno en sus ajustes). El núcleo permite cuatro botones por widget, de ahí los cuatro.

  • Mando Philips: el estado del televisor, lo que hay en pantalla, el volumen, y los botones Encender (o Apagar), Volumen −, Volumen + y Silenciar.
  • Ambilight Philips: el Ambilight y su estilo, un botón para encenderlo o apagarlo, y tres estilos elegidos en los ajustes del widget (entre ellos un color fijo); el actual aparece marcado.
  • Teclas Philips: cuatro teclas del mando, elegidas en los ajustes del widget: las flechas por defecto. Añada un segundo con OK, Volver, Inicio, Fuentes o Reproducir / pausa…
  • Accesos directos Philips: hasta cuatro fuentes o aplicaciones favoritas, escritas por su nombre en los ajustes (HDMI 2, Netflix…); TV y HDMI 1 a HDMI 3 si no se escribe nada. Un toque la muestra, con el televisor encendido primero. Un nombre que el televisor no conoce se indica bajo los botones.

Escenas​

Desencadenante​

TV: aplicación, canal o fuente cambiada: lo que hay en pantalla ha cambiado, encendido incluido. Filtros: el televisor, lo que hay ahora en pantalla (aplicación o pantalla de inicio, canal, fuente HDMI), su nombre exactamente como lo muestra el televisor (Netflix, YouTube), y quién lo cambió (Gladys, o el televisor y su mando, una consola por HDMI-CEC…). Variables: el televisor, el tipo (app, channel, source), el nombre (de la aplicación, el canal o la fuente), el número de canal, y quién lo cambió.

El televisor indica qué aplicación está en primer plano: pasar de una aplicación a otra activa la escena. Para una fuente HDMI, el televisor no dice cuál: el nombre es el que eligió Gladys, si no Fuente HDMI.

No hay desencadenante «televisor encendido» o «televisor apagado»: la función Encendido ya activa escenas, como cualquier dispositivo.

Acciones​

  • Abrir una aplicación en el televisor: por su nombre como en el televisor (Netflix, youtube: mayúsculas, acentos y espacios no importan). Salida: la aplicación abierta.
  • Elegir una fuente del televisor: TV o HDMI 1 a HDMI 4. Salida: la fuente elegida.
  • Ajustar el Ambilight: un estilo (Seguir el vídeo · Estándar, Lounge light · Lava ardiente…), un color fijo (escrito #FF8800, el último si está vacío) o apagado. Un estilo que el televisor no tiene se rechaza. Salida: el estilo aplicado.
  • Enviar una tecla del mando: Inicio, Volver, flechas, OK, Fuentes, volumen, canal, reproducción, colores, cifras, Ambilight…, de una a diez veces. Salida: las pulsaciones enviadas.

Las dos primeras requieren un televisor Android, y encienden primero el televisor si hace falta. Con varios televisores, elija el televisor en la acción. Las funciones Encendido, Volumen, Canal y Ambilight están en la acción habitual Controlar un dispositivo.

Ideas de escenas​

  • Noche de cine: los viernes a las 21 h, Abrir una aplicación en el televisor Netflix, Ajustar el Ambilight en Seguir el vídeo · Inmersivo, bajar las luces del salón.
  • Netflix abierto: desencadenante TV: aplicación, canal o fuente cambiada, ahora en pantalla Aplicación, nombre Netflix: cerrar las persianas.
  • Buenas noches: a las 23 h, Ajustar el Ambilight en un color fijo #FF6A00, y apagar el televisor (Encendido) unos minutos después.
  • Salir de casa: en la escena «todos se han ido», poner el Encendido de los televisores en apagado.

Solución de problemas​

  • «Aún no se ha conectado: encienda el televisor una vez»: el televisor nunca ha respondido. Compruebe su dirección y enciéndalo.
  • «Aún no emparejado»: un televisor Android necesita el emparejamiento: Mostrar un código de emparejamiento en el televisor y luego Confirmar el código de emparejamiento.
  • «Emparejamiento rechazado por el televisor: vuelva a emparejarlo»: el emparejamiento se borró en el televisor (un restablecimiento, un software nuevo). Vuelva a emparejarlo del mismo modo.
  • «Código incorrecto»: escriba de nuevo las 4 cifras mostradas. «El código ha caducado»: muestre uno nuevo y confírmelo en menos de 30 segundos.
  • «No hay API de televisor Philips en esta dirección»: responde otro dispositivo.
  • «Televisor anterior a 2016 (JointSpace 1)»: estos modelos antiguos no son compatibles.
  • El televisor no se enciende: active Encender con Wi-Fi (WoWLAN) o Encender con Chromecast en el televisor, y mantenga Wake-on-LAN activado; el paquete no atraviesa routers ni VLAN.
  • Buscar televisores no encuentra nada: el televisor debe estar encendido, en la misma red; escriba su dirección en su lugar.
  • Una fuente HDMI no cambia: las direcciones HDMI son las de los modelos de 2019 y posteriores; en los televisores Android más antiguos, use la tecla Fuentes.
  • Los registros de la integración (pestaña Configuración) indican lo que responde cada televisor; nunca se escribe en ellos ninguna clave de emparejamiento.

Límites​

  • Desarrollada sin el hardware: los comportamientos vienen de ha-philipsjs, de pylips y de sus respuestas reales, no de un televisor real.
  • Televisores Philips con la API JointSpace 6: modelos Android TV y Google TV desde 2016, modelos Saphi. Los modelos anteriores a 2016 (JointSpace 1) no son compatibles.
  • Fuentes y aplicaciones: solo televisores Android. El televisor no dice qué entrada HDMI está en pantalla.
  • Ambilight: los estilos de los menús del televisor y un color fijo; los colores píxel a píxel y el brillo del Ambilight no se controlan.
  • Canales: los de las listas de canales del televisor, leídas una vez al día.
  • Todo se queda en su red local: sin nube, sin cuenta Philips. La integración solo habla con los televisores configurados, y pide al núcleo de Gladys los paquetes Wake-on-LAN y las búsquedas SSDP.
  • Sin relación con Philips ni con TP Vision. Philips y Ambilight son marcas de Koninklijke Philips N.V.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Su televisor PhilipssectionNoPhilips Android TV, Google TV (2016 y posteriores) o Saphi. Encienda el televisor, ejecute «Buscar televisores» más abajo o escriba su dirección, y guarde. Un televisor Android se empareja después una vez con las dos acciones de emparejamiento. Hasta tres televisores.
DirecciónstringNoDirección IP del televisor. Fíjela en su router.
NombrestringNoNombre del dispositivo en Gladys. Vacío: Philips y el modelo.
Segundo televisor (opcional)sectionNoLos mismos campos, para otro televisor Philips.
DirecciónstringNoDirección IP del televisor. Fíjela en su router.
NombrestringNoNombre del dispositivo en Gladys. Vacío: Philips y el modelo.
Tercer televisor (opcional)sectionNoLos mismos campos, para otro televisor Philips.
DirecciónstringNoDirección IP del televisor. Fíjela en su router.
NombrestringNoNombre del dispositivo en Gladys. Vacío: Philips y el modelo.
OpcionessectionNo
Wake-on-LANbooleanNoDespierta un televisor cuya red se duerme cuando está apagado (Gladys envía el paquete).
Intervalo de actualizaciónselectNoCon qué frecuencia se leen los televisores.
Idioma de los nombres de funcionesselectNoNombres de las funciones al añadir un dispositivo, y textos de las listas y eventos de escena.

Cómo instalar Philips TV en Gladys​

  1. En Gladys, abre Integraciones: Philips TV 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-philips-tv:1.0.3), 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-philips-tv.

Philips TV 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​

Philips TV 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 🙂