Control desde Home Assistant
Una puerta rápida basada en un token: pega una vez un bloque rest_command en el YAML de Home Assistant y llámalo después desde cualquier automatización.
Las tres puertas de abajo hacen exactamente las mismas dos cosas y hablan con el mismo dispositivo Piazza HQ: elige una para un dispositivo concreto, no más de una. Ejecutar dos a la vez solo supone entidades duplicadas en Home Assistant para la misma pantalla.
configuration.yaml de Home Assistant — el complemento File Editor o Studio Code Server sirve si no tienes otra forma de entrarEn Piazza HQ: Ajustes → Control desde Home Assistant → Generar token. Este token solo desbloquea dos cosas: encender/apagar el televisor/monitor de una pantalla y aplicar un diseño guardado a una pantalla. No puede leer tu calendario, cambiar ningún otro ajuste ni hacer nada más.
rest_command:En el archivo configuration.yaml de Home Assistant, sustituyendo <host-pi-ip> por la dirección real de tu dispositivo Piazza HQ en la red local y YOUR_TOKEN por el token del paso 1:
El ID de dispositivo de una pantalla se encuentra en Piazza HQ en Ajustes → Varios dispositivos, o pidiéndole a tu token que los liste (consulta las preguntas frecuentes de abajo).
Ajustes → Sistema → Reiniciar: un nuevo bloque rest_command: no surte efecto hasta que Home Assistant se reinicia. A partir de ahí, cualquier automatización (una persona que sale de casa, un sensor de seguimiento del sueño, un disparador horario) puede llamar a rest_command.piazzahq_screen_off / _on como acción.
La misma idea, otro punto de acceso: envía un POST a /api/saved-layouts/<layout-id>/apply con un cuerpo JSON de {"display": "<display-slug>"} y la misma cabecera Authorization. Aplicar un diseño guardado también cambia el tema claro/oscuro de esa pantalla, ya que cada diseño guardado almacena el suyo. El ID de un diseño guardado está en la biblioteca de diseños de la pestaña Diseño, y el slug de una pantalla en Ajustes → Varios dispositivos.
Revisa bien el ID de dispositivo y la dirección IP en el YAML: una errata ahí falla en silencio desde el lado de Home Assistant (solo recibe un 404). Comprueba que Home Assistant se reinició de verdad después de añadir el bloque; no reconocerá rest_command.piazzahq_screen_off hasta entonces.
El mismo token también desbloquea tres puntos de consulta de solo lectura, útiles si lo programas a mano: GET /api/automation/screens, /api/automation/displays y /api/automation/saved-layouts — cada uno devuelve los IDs y nombres exactos que necesitas, con la misma cabecera Authorization: Bearer que arriba.
Sí: un sencillo curl con la misma URL, método y cabecera del paso 2 funciona desde cualquier equipo de tu red. Si eso funciona pero la automatización de Home Assistant no, el problema está en el disparador/la condición de la automatización, no en la conexión con Piazza HQ.
En Home Assistant: Ajustes → Complementos → Tienda de complementos → busca «Mosquitto broker» → instalar. Unos pocos clics, sin nada que configurar aparte de activarlo.
En Piazza HQ: Ajustes → Control desde Home Assistant → marca MQTT y luego introduce la URL del broker (p. ej., mqtt://homeassistant.local:1883), y un usuario/contraseña si tu broker los exige. Probar conexión y luego Guardar.
Una vez conectado, un interruptor de Encendido (por cada pantalla con control del televisor configurado) y un selector de Diseño (por cada pantalla) aparecen automáticamente en Home Assistant mediante el descubrimiento MQTT: sin reiniciar, sin YAML. Mira en Ajustes → Dispositivos y servicios → MQTT si no los ves enseguida.
Comprueba que Probar conexión realmente tuvo éxito en los ajustes de Piazza HQ antes de guardar: una URL de broker incorrecta o credenciales erróneas se guardan sin problema pero nunca se conectan. Comprueba también que la integración MQTT de Home Assistant está configurada y apunta al mismo broker; Piazza HQ publica mensajes de descubrimiento, pero es la integración MQTT de Home Assistant la que tiene que estar escuchándolos.
Correcto: Piazza HQ se conecta a un broker, no ejecuta uno por sí mismo. El complemento Mosquitto (paso 1) es la forma más fácil de conseguir uno si partes de cero.
No, y no es un fallo: la mayoría de los mandos y de las implementaciones de CEC no tienen una señal fiable de «¿estás encendido?» a la que preguntar. Las entidades interruptor y selector son solo de comando (Home Assistant las muestra como estado supuesto): harán lo correcto al accionarlas, pero no reflejarán un televisor que alguien apagó con su propio mando.
HACS es la tienda de complementos de la comunidad de Home Assistant: un proyecto aparte y bien establecido, no algo que Piazza HQ incluya. La instalación oficial se ejecuta desde un terminal con acceso a la carpeta de configuración de tu Home Assistant (el complemento Terminal & SSH, si usas Home Assistant OS):
Reinicia Home Assistant y termina la configuración puntual propia de HACS: Ajustes → Dispositivos y servicios → Añadir integración → HACS y sigue su aviso de inicio de sesión de GitHub (muestra un código y un enlace donde introducirlo). ¿Ya tienes HACS? Salta directamente al paso 2.
La forma más fácil: en Piazza HQ, ve a Ajustes → Control desde Home Assistant y haz clic en Añadir a Home Assistant: pasa el control a tu propia instancia de Home Assistant y te lleva directamente al cuadro de diálogo «añadir este repositorio» de HACS.
¿Prefieres hacerlo a mano? En HACS: Integraciones → ⋮ (arriba a la derecha) → Repositorios personalizados, pega https://github.com/jlauty21/piazzahq-homeassistant, categoría Integración.
En cualquier caso, busca después «Piazza HQ» en HACS y toca Descargar; luego reinicia Home Assistant cuando lo pida.
Ajustes → Dispositivos y servicios → Añadir integración, busca Piazza HQ. Introduce la dirección de tu dispositivo (puerto 3000) y un token de automatización; genera uno antes en Piazza HQ en Ajustes → Control desde Home Assistant → Generar token, si todavía no lo has hecho.
Aparece un interruptor de Encendido por cada pantalla con control del televisor configurado y un selector de Diseño por cada pantalla: entidades reales de Home Assistant con una página de dispositivo en condiciones, utilizables en paneles y automatizaciones como cualquier otra. Las pantallas o diseños nuevos que añadas más tarde en Piazza HQ aparecen aquí automáticamente en unos minutos, sin recargar.
Pueden causarlo dos cosas distintas. Primero, ese botón depende de un servicio (my.home-assistant.io) que necesita conocer la dirección de tu Home Assistant: la primera vez que uses un enlace así en un navegador, te la pedirá. Segundo, y más frecuente: una dirección de tipo .local ahí suele no resolverse a menos que tu teléfono/ordenador esté exactamente en la misma red local que Home Assistant (no funciona por Tailscale, datos móviles ni otro wifi); si se queda colgado, prueba ahí la dirección IP real de Home Assistant.
Esto significa que HACS aún no está instalado: ese botón concreto solo funciona cuando HACS existe en tu instancia, ya que es HACS quien registra la capacidad de entender ese enlace. Vuelve al paso 1.
Técnicamente sí, pero no para el mismo dispositivo: tendrías entidades de interruptor/selector duplicadas para las mismas pantallas. Elige la puerta que mejor encaje con tu forma de trabajar.
¿Buscas la dirección contraria: sensores y dispositivos de Home Assistant que aparezcan en on tu pantalla de Piazza HQ? Eso se trata en la sección de Ajustes de la guía de usuario.