Home-Assistant-Steuerung
Eine schnelle, tokenbasierte Tür: Füge einmalig einen rest_command-Block in das YAML von Home Assistant ein und rufe ihn dann aus jeder Automation auf.
Alle drei Türen unten tun genau dieselben zwei Dinge und sprechen mit demselben Piazza-HQ-Gerät – wähle für ein Gerät eine und nicht mehr als eine. Zwei gleichzeitig laufen zu lassen bedeutet nur doppelte Entitäten in Home Assistant für denselben Bildschirm.
configuration.yaml von Home Assistant – das Add-on File Editor oder Studio Code Server funktioniert, wenn du keinen anderen Zugang hastIn Piazza HQ: Einstellungen → Home-Assistant-Steuerung → Token erzeugen. Dieser Token schaltet immer nur zwei Dinge frei – den Fernseher/Monitor eines Bildschirms ein- und ausschalten und ein gespeichertes Layout auf eine Anzeige anwenden. Er kann deinen Kalender nicht lesen, keine anderen Einstellungen ändern und sonst nichts tun.
rest_command:-Block hinzufügenErsetze in der configuration.yaml von Home Assistant <host-pi-ip> durch die tatsächliche LAN-Adresse deines Piazza-HQ-Geräts und YOUR_TOKEN durch den Token aus Schritt 1:
Die Geräte-ID eines Bildschirms findest du in Piazza HQ unter Einstellungen → Mehrere Geräte, oder indem du deinen Token sie auflisten lässt (siehe die FAQ unten).
Einstellungen → System → Neu starten – ein neuer rest_command:-Block wird erst wirksam, wenn Home Assistant neu startet. Von da an kann jede Automation (eine Person verlässt das Haus, ein Schlaftracker-Sensor, ein Zeitauslöser) rest_command.piazzahq_screen_off / _on als Aktion aufrufen.
Dieselbe Idee, ein anderer Endpunkt – sende ein POST an /api/saved-layouts/<layout-id>/apply mit einem JSON-Body von {"display": "<display-slug>"} und demselben Authorization-Header. Das Anwenden eines gespeicherten Layouts schaltet auch das helle/dunkle Design dieser Anzeige um, da jedes gespeicherte Layout sein eigenes mitführt. Die ID eines gespeicherten Layouts findest du in der Layout-Bibliothek im Reiter Layout und den Slug einer Anzeige unter Einstellungen → Mehrere Geräte.
Prüfe Geräte-ID und IP-Adresse im YAML noch einmal – ein Tippfehler dort schlägt von Home Assistants Seite aus stillschweigend fehl (es bekommt nur eine 404 zurück). Vergewissere dich, dass Home Assistant nach dem Hinzufügen des Blocks tatsächlich neu gestartet wurde; es erkennt rest_command.piazzahq_screen_off erst danach.
Derselbe Token schaltet außerdem drei schreibgeschützte Abfrage-Endpunkte frei, nützlich, wenn du das von Hand skriptest: GET /api/automation/screens, /api/automation/displays und /api/automation/saved-layouts – jeder liefert die genauen IDs und Namen, die du brauchst, mit demselben Authorization: Bearer-Header wie oben.
Ja – ein einfaches curl mit derselben URL, Methode und demselben Header aus Schritt 2 funktioniert von jedem Rechner in deinem Netzwerk. Klappt das, die Home-Assistant-Automation aber nicht, liegt das Problem im Auslöser/in der Bedingung der Automation, nicht in der Verbindung zu Piazza HQ.
In Home Assistant: Einstellungen → Add-ons → Add-on-Store → suche nach „Mosquitto-Broker-“ → installieren. Ein paar Klicks, außer dem Einschalten ist nichts zu konfigurieren.
In Piazza HQ: Einstellungen → Home-Assistant-Steuerung → hake MQTT an und trage dann die Broker-URL ein (z. B. mqtt://homeassistant.local:1883) sowie Benutzername/Passwort, falls dein Broker sie verlangt. Verbindung testen, dann Speichern.
Sobald die Verbindung steht, erscheinen automatisch per MQTT Discovery ein Power--Schalter (pro Bildschirm mit eingerichteter Fernseher-Steuerung) und eine Layout-Auswahl (pro Anzeige) in Home Assistant – ohne Neustart, ohne YAML. Schau unter Einstellungen → Geräte & Dienste → MQTT nach, falls du sie nicht gleich siehst.
Vergewissere dich, dass Verbindung testen in den Einstellungen von Piazza HQ vor dem Speichern wirklich erfolgreich war – eine falsche Broker-URL oder falsche Zugangsdaten lassen sich problemlos speichern, verbinden sich aber nie. Prüfe auch, ob die MQTT-Integration von Home Assistant selbst eingerichtet ist und auf denselben Broker zeigt; Piazza HQ veröffentlicht Discovery-Nachrichten, aber die MQTT-Integration von Home Assistant muss darauf lauschen.
Richtig – Piazza HQ verbindet sich mit einem Broker, betreibt aber selbst keinen. Das Mosquitto-Add-on (Schritt 1) ist der einfachste Weg, einen zu bekommen, wenn du bei null anfängst.
Nein, und das ist kein Fehler – die meisten Fernbedienungen und CEC-Implementierungen haben kein verlässliches „Bist du an?“-Signal, das man abfragen könnte. Die Entitäten Schalter und Auswahl sind reine Befehlsentitäten (Home Assistant zeigt sie als angenommener Zustand): Sie tun beim Umschalten das Richtige, spiegeln aber nicht wider, dass jemand einen Fernseher mit seiner eigenen Fernbedienung ausgeschaltet hat.
HACS ist der Community-Add-on-Store von Home Assistant – ein eigenständiges, gut etabliertes Projekt, nichts, was Piazza HQ mitliefert. Die offizielle Installation läuft in einem Terminal mit Zugriff auf den Konfigurationsordner von Home Assistant (das Add-on Terminal & SSH, falls du Home Assistant OS nutzt):
Starte Home Assistant neu und schließe dann die eigene einmalige Einrichtung von HACS ab: Einstellungen → Geräte & Dienste → Integration hinzufügen → HACS und folge der GitHub-Anmeldeaufforderung (sie zeigt einen Code und einen Link, unter dem du ihn eingibst). Schon HACS vorhanden? Springe direkt zu Schritt 2.
Der einfachste Weg: Gehe in Piazza HQ zu Einstellungen → Home-Assistant-Steuerung und klicke auf Zu Home Assistant hinzufügen – das übergibt an deine eigene Home-Assistant-Instanz und führt dich direkt in den Dialog „Dieses Repository hinzufügen“ von HACS.
Lieber von Hand? In HACS: Integrationen → ⋮ (oben rechts) → Benutzerdefinierte Repositories, füge https://github.com/jlauty21/piazzahq-homeassistant ein, Kategorie Integration.
Finde in jedem Fall anschließend „Piazza HQ“ in HACS, tippe auf Herunterladen und starte Home Assistant neu, wenn es dazu auffordert.
Einstellungen → Geräte & Dienste → Integration hinzufügen, suche nach Piazza HQ. Gib die Adresse deines Geräts (Port 3000) und einen Automations-Token ein – erzeuge zuvor einen in Piazza HQ unter Einstellungen → Home-Assistant-Steuerung → Token erzeugen, falls du das noch nicht getan hast.
Ein Power--Schalter erscheint für jeden Bildschirm mit eingerichteter Fernseher-Steuerung und eine Layout-Auswahl für jede Anzeige – echte Home-Assistant-Entitäten mit einer richtigen Geräteseite, nutzbar in Dashboards und Automationen wie alles andere. Neue Bildschirme oder Layouts, die du später in Piazza HQ hinzufügst, erscheinen hier innerhalb weniger Minuten automatisch, ohne Neuladen.
Dafür kommen zwei Ursachen infrage. Erstens stützt sich diese Schaltfläche auf einen Dienst (my.home-assistant.io), der die Adresse deines Home Assistant kennen muss – beim ersten Mal, dass du in einem Browser einen solchen Link nutzt, fragt er danach. Zweitens, und häufiger: Eine Adresse vom Typ .local lässt sich dort oft nicht auflösen, wenn dein Handy/Computer nicht genau im selben lokalen Netzwerk wie Home Assistant ist (über Tailscale, Mobilfunk oder ein anderes WLAN funktioniert es nicht) – hängt es, probiere dort stattdessen die echte IP-Adresse von Home Assistant.
Das bedeutet, dass HACS noch nicht installiert ist – diese Schaltfläche funktioniert nur, wenn HACS auf deiner Instanz existiert, denn HACS registriert die Fähigkeit, diesen Link zu verstehen. Gehe zurück zu Schritt 1.
Technisch ja, aber tu es nicht für dasselbe Gerät – du bekämst doppelte Schalter-/Auswahl-Entitäten für dieselben Bildschirme und Anzeigen. Wähle die eine Tür, die zu deiner Arbeitsweise passt.
Du suchst die andere Richtung – Home-Assistant-Sensoren und -Geräte, die auf on deiner Piazza-HQ-Anzeige erscheinen? Das behandelt der Abschnitt Einstellungen im Benutzerhandbuch.