Contrôle par Home Assistant
Une porte rapide, basée sur un jeton : collez une fois un bloc rest_command dans le YAML de Home Assistant, puis appelez-le depuis n'importe quelle automatisation.
Les trois portes ci-dessous font exactement les deux mêmes choses et communiquent avec le même appareil Piazza HQ — choisissez-en une pour un appareil donné, pas plus. En faire tourner deux à la fois ne produit que des entités en double dans Home Assistant pour le même écran.
configuration.yaml de Home Assistant — le module File Editor ou Studio Code Server convient si vous n'avez pas d'autre moyen d'y accéderDans Piazza HQ : Paramètres → Contrôle par Home Assistant → Générer le jeton. Ce jeton ne déverrouille jamais que deux choses — allumer/éteindre le téléviseur/moniteur d'un écran, et appliquer une disposition enregistrée à un affichage. Il ne peut pas lire votre calendrier, modifier un autre réglage, ni rien faire d'autre.
rest_command:Dans le fichier configuration.yaml de Home Assistant, en remplaçant <host-pi-ip> par la véritable adresse réseau local de votre appareil Piazza HQ et YOUR_TOKEN par le jeton de l'étape 1 :
L'identifiant d'appareil d'un écran se trouve dans Piazza HQ sous Paramètres → Plusieurs appareils, ou en demandant à votre jeton de les lister (voir la FAQ ci-dessous).
Paramètres → Système → Redémarrer — un nouveau bloc rest_command: n'est pris en compte qu'après le redémarrage de Home Assistant. À partir de là, toute automatisation (une personne qui quitte la maison, un capteur de suivi du sommeil, un déclencheur horaire) peut appeler rest_command.piazzahq_screen_off / _on comme action.
Même principe, un autre point d'accès — envoyez un POST à /api/saved-layouts/<layout-id>/apply avec un corps JSON de {"display": "<display-slug>"} et le même en-tête Authorization. Appliquer une disposition enregistrée change aussi le thème clair/sombre de cet affichage, puisque chaque disposition enregistrée stocke le sien. L'identifiant d'une disposition enregistrée se trouve dans la bibliothèque de dispositions de l'onglet Disposition, et le slug d'un affichage dans Paramètres → Plusieurs appareils.
Vérifiez bien l'identifiant d'appareil et l'adresse IP dans le YAML — une faute de frappe échoue silencieusement du côté de Home Assistant (il reçoit juste un 404). Vérifiez que Home Assistant a bien redémarré après l'ajout du bloc ; il ne reconnaîtra pas rest_command.piazzahq_screen_off avant cela.
Le même jeton déverrouille aussi trois points d'accès de consultation en lecture seule, utiles si vous scriptez cela à la main : GET /api/automation/screens, /api/automation/displays et /api/automation/saved-layouts — chacun renvoie les identifiants et noms exacts dont vous avez besoin, avec le même en-tête Authorization: Bearer que ci-dessus.
Oui — un simple curl avec la même URL, la même méthode et le même en-tête qu'à l'étape 2 fonctionne depuis n'importe quelle machine de votre réseau. Si cela marche mais que l'automatisation Home Assistant ne marche pas, le problème vient du déclencheur/de la condition de l'automatisation, pas de la connexion à Piazza HQ.
Dans Home Assistant : Paramètres → Modules complémentaires → Boutique → cherchez « Mosquitto broker » → installez. Quelques clics, rien à configurer à part l'activer.
Dans Piazza HQ : Paramètres → Contrôle par Home Assistant → cochez MQTT, puis saisissez l'URL du broker (p. ex. mqtt://homeassistant.local:1883), et un nom d'utilisateur/mot de passe si votre broker en exige. Tester la connexion, puis Enregistrer.
Une fois connecté, un interrupteur Marche (par écran avec contrôle du téléviseur configuré) et une sélection Disposition (par affichage) apparaissent automatiquement dans Home Assistant via la découverte MQTT — sans redémarrage, sans YAML. Cherchez sous Paramètres → Appareils et services → MQTT si vous ne les voyez pas tout de suite.
Vérifiez que Tester la connexion a bien réussi dans les paramètres de Piazza HQ avant d'enregistrer — une mauvaise URL de broker ou de mauvais identifiants s'enregistrent sans problème mais ne se connectent jamais. Vérifiez aussi que l'intégration MQTT de Home Assistant est configurée et pointe vers le même broker ; Piazza HQ publie des messages de découverte, mais c'est l'intégration MQTT de Home Assistant qui doit les écouter.
Exact — Piazza HQ se connecte à un broker, il n'en exécute pas lui-même. Le module Mosquitto (étape 1) est le moyen le plus simple d'en obtenir un si vous partez de zéro.
Non, et ce n'est pas un bogue — la plupart des télécommandes et des implémentations CEC n'ont aucun signal fiable « êtes-vous allumé ? » à interroger. Les entités interrupteur et sélection sont en commande seule (Home Assistant les affiche comme état supposé) : elles feront ce qu'il faut quand on les actionne, mais ne reflèteront pas un téléviseur que quelqu'un a éteint avec sa propre télécommande.
HACS est la boutique de modules communautaires de Home Assistant — un projet distinct et bien établi, pas quelque chose que Piazza HQ intègre. L'installation officielle s'exécute depuis un terminal ayant accès au dossier de configuration de votre Home Assistant (le module Terminal & SSH, si vous utilisez Home Assistant OS) :
Redémarrez Home Assistant, puis terminez la configuration unique propre à HACS : Paramètres → Appareils et services → Ajouter une intégration → HACS, et suivez son invite de connexion GitHub (elle affiche un code et un lien où le saisir). Vous avez déjà HACS ? Passez directement à l'étape 2.
Le plus simple : dans Piazza HQ, allez dans Paramètres → Contrôle par Home Assistant et cliquez sur Ajouter à Home Assistant — cela passe la main à votre propre instance Home Assistant et vous amène directement dans la boîte de dialogue « ajouter ce dépôt » de HACS.
Vous préférez le faire à la main ? Dans HACS : Intégrations → ⋮ (en haut à droite) → Dépôts personnalisés, collez https://github.com/jlauty21/piazzahq-homeassistant, catégorie Intégration.
Dans tous les cas, cherchez ensuite « Piazza HQ » dans HACS et touchez Télécharger, puis redémarrez Home Assistant quand il le demande.
Paramètres → Appareils et services → Ajouter une intégration, cherchez Piazza HQ. Saisissez l'adresse de votre appareil (port 3000) et un jeton d'automatisation — générez-en d'abord un dans Piazza HQ sous Paramètres → Contrôle par Home Assistant → Générer le jeton, si ce n'est pas déjà fait.
Un interrupteur Marche apparaît pour chaque écran avec contrôle du téléviseur configuré, et une sélection Disposition pour chaque affichage — de vraies entités Home Assistant avec une vraie page d'appareil, utilisables dans les tableaux de bord et les automatisations comme n'importe quoi d'autre. Les nouveaux écrans ou dispositions ajoutés plus tard dans Piazza HQ apparaissent ici automatiquement en quelques minutes, sans rechargement.
Deux choses distinctes peuvent en être la cause. D'abord, ce bouton s'appuie sur un service (my.home-assistant.io) qui doit connaître l'adresse de votre Home Assistant — la première fois que vous utilisez un tel lien dans un navigateur donné, il vous la demandera. Ensuite, et plus souvent : une adresse de type .local là n'est souvent pas résolue si votre téléphone/ordinateur n'est pas exactement sur le même réseau local que Home Assistant (cela ne fonctionne pas via Tailscale, le réseau mobile ou un autre Wi-Fi) — si cela reste bloqué, essayez plutôt la véritable adresse IP de Home Assistant.
Cela signifie que HACS n'est pas encore installé — ce bouton précis ne fonctionne que lorsque HACS existe sur votre instance, car c'est HACS qui enregistre la capacité de comprendre ce lien. Retournez à l'étape 1.
Techniquement oui, mais pas pour le même appareil — vous obtiendriez des entités interrupteur/sélection en double pour les mêmes écrans et affichages. Choisissez la porte qui correspond à votre façon de travailler.
Vous cherchez l'autre sens — des capteurs et appareils Home Assistant qui s'affichent sur on votre affichage Piazza HQ ? Cela est traité dans la section Paramètres du guide d'utilisation.