Panasonic Comfort Cloud Smart-Home-Integration, kostenlos und Open Source
Panasonic-Klimageräte und Wärmepumpen über Comfort Cloud: Modus, Sollwert, Lüfter, Schwenk, Energie.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Steuere deine Panasonic-Klimageräte und Luft-Luft-Wärmepumpen aus Gladys über die Panasonic Comfort Cloud: Ein/Aus, Modus, Sollwert, Lüftergeschwindigkeit, Lamellen, Powerful- und leiser Modus, nanoe, ECONAVI und AI Eco, Innen- und Außentemperatur und die verbrauchte Energie.
Developed without the hardware: feedback welcome. Diese Integration wurde gegen aufgezeichnete Antworten der Comfort-Cloud-API und des Open-Source-Referenzclients geschrieben und getestet, nicht mit einem echten Konto oder Gerät. Melde auf GitHub, was funktioniert und was nicht.
Diese Integration steht in keiner Verbindung zu Panasonic.
Kompatible Hardware
Jedes Panasonic-Klimagerät oder jede Luft-Luft-Wärmepumpe (Etherea, TZ, Z, Kanal- und Kassettengeräte...), das in der App Panasonic Comfort Cloud eingerichtet ist, mit seinem WLAN-Adapter (eingebaut, oder CZ-TACG1 / CZ-CAPWFC1). Jedes Innengerät wird ein Gladys-Gerät.
Nicht unterstützt: die Luft-Wasser-Wärmepumpen Aquarea und die Warmwasserspeicher, auch wenn sie in derselben App erscheinen (die Suche zählt sie als „nicht unterstützt“).
Voraussetzungen
- Gladys 5.2.0 oder neuer.
- Eine Panasonic ID (E-Mail und Passwort) mit den Geräten in ihrer Comfort-Cloud-App.
- Internetzugang für Gladys: Alles läuft über die Panasonic-Cloud, nichts ist lokal.
- Wenn dein Konto die Zwei-Faktor-Authentifizierung nutzt, deine Authenticator-App für die erste Anmeldung griffbereit.
Installation und Konfiguration
- Öffne in Gladys Integrationen → Von GitHub installieren und gib
https://github.com/guim31/gladys-panasonic-ccein. - Öffne den Tab Konfiguration der Integration. Die Einstellungen:
- Panasonic ID (E-Mail) und Passwort: die der Comfort-Cloud-App. Tipp: Panasonic erlaubt es, die Geräte in der App mit einem zweiten Konto zu teilen; ein eigenes Konto für Gladys hält seine Sitzungen von deinen getrennt.
- Aktualisierungsintervall: wie oft jedes Gerät gelesen wird (standardmäßig 2 Minuten, wie bei der Home-Assistant-Integration).
- Sprache der Funktionsnamen: Sprache der Funktionsnamen neuer Geräte (standardmäßig Französisch). Die Geräte selbst behalten die Namen aus der App.
- Erweitert, Version der Comfort-Cloud-App: leer lassen. Panasonic antwortet nur aktuellen Versionen seiner App; die Integration liest die aktuelle selbst aus Google Play. Fülle sie nur aus, wenn der Verbindungsstatus meldet, dass die Version abgelehnt wird.
- Öffne den Tab Entdecken: Jedes Innengerät des Kontos erscheint unter seinem Namen aus der App. Füge die gewünschten zu Gladys hinzu.
Die Schaltfläche Klimageräte suchen (Tab Konfiguration) liest das Konto erneut und listet jedes Gerät, sein Modell und ob es antwortet.
Zwei-Faktor-Authentifizierung
Verlangt Panasonic einen Code, sagt es der Verbindungsstatus. Öffne die Authenticator-App und starte dann Mit 2FA-Code anmelden (Tab Konfiguration) mit dem angezeigten 6-stelligen Code, innerhalb von 30 Sekunden. Die Sitzung bleibt danach in Gladys erhalten: Der Code ist erst wieder nötig, wenn Panasonic eine neue Anmeldung verlangt.
Was gespeichert wird
Die Integration speichert in ihrem eigenen Volume (/data, nur für den Container lesbar) die Comfort-Cloud-Sitzung (Zugriffs- und Erneuerungstoken), die App-Version und den Energiezähler jedes Geräts. Das Passwort bleibt in der Gladys-Konfiguration und wird nur dann an Panasonic gesendet, wenn die Sitzung nicht erneuert werden kann. Weder Passwort noch Token werden je in die Protokolle geschrieben.
Geräte und Funktionen
Jedes Innengerät ist ein Gladys-Gerät. Seine Funktionen hängen davon ab, was das Gerät meldet:
| Funktion | Was sie tut |
|---|---|
| Ein/Aus | Schaltet das Gerät ein oder aus. |
| Modus | Automatisch, Kühlen, Heizen, Entfeuchten, Lüften (nur die Modi des Geräts). Die Wahl eines Modus schaltet das Gerät ein. |
| Solltemperatur | Der Sollwert in halben Grad, von 16 bis 30 °C (ab 8 °C bei Geräten mit dem Frostschutz 8/15 °C). |
| Lüftergeschwindigkeit | Automatisch, Niedrig, Niedrig-Mittel, Mittel, Mittel-Hoch, Hoch. |
| Vertikaler Schwenk, Horizontaler Schwenk | Schwenken („Auto“ bei Panasonic) oder eine von fünf festen Positionen; der horizontale nur bei Geräten mit Links/Rechts-Lamelle. |
| Innentemperatur | Die vom Innengerät gemessene Temperatur. |
| Außentemperatur | Die vom Außengerät gemessene Temperatur, wenn es eine meldet. |
| Powerful-Modus, Leiser Modus | Die Sondermodi von Panasonic; sie schließen sich aus. Nur bei Geräten, die sie haben. |
| nanoe, ECONAVI, AI Eco | Die Luftreinigung und die Eco-Sensoren der Geräte, die sie haben. |
| Energie heute | Was das Gerät heute verbraucht hat (kWh), aus dem Comfort-Cloud-Verlauf. |
| Verbrauchte Energie | Ein Zähler (kWh), der nur steigt, aus dem Tagesverlauf gebildet, für das Energie-Monitoring von Gladys. Er beginnt mit dem aktuellen Monat. |
Ein Sollwert, eine Lamellenposition oder ein Sondermodus, der bei ausgeschaltetem Gerät angefordert wird, schaltet es nicht ein: Er wird sofort angezeigt, gespeichert und beim nächsten Einschalten gesendet (wie beim Referenzclient ohne automatisches Einschalten). Eine Szene, die den Nacht-Sollwert vorbereitet, startet das Gerät also nie überraschend. Lüftergeschwindigkeit, nanoe, ECONAVI und AI Eco werden sofort gesendet.
Änderungen per Fernbedienung oder App werden beim nächsten Lesen übernommen.
Widget
Das Widget Klimaanlage (wähle das Gerät in seinen Einstellungen) zeigt die Raumtemperatur, den Sollwert und die Außentemperatur (oder die Energie des Tages), dann den Modus, die Lüftergeschwindigkeit, den Sondermodus und die Energie des Tages. Seine Tasten:
- Einschalten / Ausschalten;
- −0,5 °C und +0,5 °C;
- Modus und Lüfter: ein kleines Formular, um Modus, Lüftergeschwindigkeit und Sondermodus zusammen zu wählen, in einem Aufruf gesendet; das Gerät wird eingeschaltet.
Szenen-Auslöser
- Panasonic-Anmeldung nötig: Comfort Cloud akzeptiert die Sitzung nicht mehr. Der Grund steht der Szene als Variable zur Verfügung (
reason):password(Passwort abgelehnt),two_factor(ein Code wird verlangt) oderterms(neue Nutzungsbedingungen in der App zu akzeptieren). Er löst einmal pro Problem aus, nicht bei jedem Versuch: praktisch, um dir eine Nachricht zu schicken, statt Tage später zu merken, dass die Klimaanlage nicht mehr antwortet.
Szenen-Aktion
- Klima-Voreinstellung anwenden: schaltet das Gerät mit Modus, Sollwert, Lüftergeschwindigkeit und Sondermodus in einem einzigen Comfort-Cloud-Aufruf ein, wo die Standardaktionen von Gladys einen Aufruf pro Funktion senden würden (jeder dauert mehrere Sekunden). Ein leeres Feld behält die aktuelle Einstellung. Der Sollwert akzeptiert halbe Grad (
22,5oder22.5). Der übernommene Sollwert wird an die Szene zurückgegeben.
Zum Ausschalten oder um eine einzelne Einstellung zu ändern, dient die Standardaktion „Gerät steuern“ von Gladys.
Szenen-Beispiele
- Wohnzimmer vor dem Aufstehen heizen: werktags um 6:30 Uhr „Klima-Voreinstellung anwenden“ in Heizen auf 21 °C, Lüfter Automatisch, Sondermodus Normal.
- Schlafzimmer leise kühlen: um 22 Uhr, wenn das Schlafzimmer über 26 °C hat, „Klima-Voreinstellung anwenden“ in Kühlen auf 25 °C, Lüfter Niedrig, Sondermodus Leise.
- Niemand zu Hause: Wenn die letzte Person geht, alle Klimageräte ausschalten.
- Anmelde-Warnung: Bei „Panasonic-Anmeldung nötig“ die Nachricht „Panasonic braucht deine Aufmerksamkeit: {{triggerEvent.data.reason}}“ senden.
Aktualisierung und Kontingente
- Panasonic veröffentlicht kein Kontingent, aber Comfort Cloud ist langsam (ein Lesen dauert einige Sekunden) und bremst Konten, die es zu oft aufrufen. Die Integration macht daher einen Aufruf nach dem anderen, liest nur die zu Gladys hinzugefügten Geräte, standardmäßig alle 2 Minuten (der Takt der Home-Assistant-Integration), und den Energieverlauf höchstens alle 5 Minuten.
- Die Integration liest die Geräte selbst; das Polling von Gladys ist nur eine Rückfallebene.
- Nach einem Befehl wird das Gerät 3 Sekunden später erneut gelesen, um den Zustand zu bestätigen.
- Wenn Comfort Cloud ausfällt, verlangsamt sich der Takt (bis zu 10 Minuten), bis es wieder antwortet. Ein Gerät, das die Cloud nicht erreicht, wird eine Weile aus der letzten Kopie der Cloud gelesen und dann als nicht antwortend markiert.
- Die Geräteliste wird alle 30 Minuten neu gelesen (neue oder umbenannte Geräte).
- Nur geänderte Werte werden an Gladys gesendet, dazu alle 6 Stunden eine Erinnerung, damit ein stabiler Wert nie veraltet wirkt.
Fehlerbehebung
- „Panasonic lehnt diese E-Mail-Adresse oder dieses Passwort ab“: Prüfe, ob du dich damit in der Comfort-Cloud-App anmelden kannst, und korrigiere sie dann in der Konfiguration. Die Integration versucht ein abgelehntes Passwort nie von selbst erneut (das könnte das Konto sperren): Das Speichern der Konfiguration oder Klimageräte suchen versucht es erneut.
- „Panasonic verlangt einen Zwei-Faktor-Code“: Starte Mit 2FA-Code anmelden mit einem frischen Code.
- „Panasonic hat neue Nutzungsbedingungen“: Öffne die Comfort-Cloud-App und akzeptiere sie; die Integration versucht es alle 30 Minuten erneut.
- „Comfort Cloud lehnt die angegebene App-Version ab“: Schau die Version der Comfort-Cloud-App in ihrem Store nach und gib sie unter Version der Comfort-Cloud-App ein.
- Ein Gerät antwortet nicht: Prüfe es in der App; der WLAN-Adapter hat vielleicht seine Verbindung verloren.
- Mehr Details: Setze die Umgebungsvariable
LOG_LEVELdes Containers aufdebug.
Einschränkungen
- Developed without the hardware: feedback welcome auf GitHub.
- Nur Cloud: keine lokale Steuerung, und die Integration funktioniert nicht mehr, wenn Panasonic seine Anmeldung oder seine API ändert, bis sie aktualisiert wird.
- Die Energiewerte stammen aus dem Comfort-Cloud-Verlauf, der etwa eine Stunde hinterherhinkt; Geräte ohne Energiemessung haben keine Energiefunktionen.
- Nicht unterstützt: der Modus iAuto-X, die Frostschutz-Voreinstellung 8/15 °C (der Sollwertbereich erlaubt sie), die Wochentimer, die Zonen der Kanalgeräte, die Innenreinigung.
- Aquarea-Wärmepumpen und Warmwasserspeicher werden nicht unterstützt.
Konfigurationseinstellungen
Diese Einstellungen fragt Panasonic Comfort Cloud in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Panasonic-Konto | section | Nein | Die in der App Panasonic Comfort Cloud eingerichteten Klimageräte werden automatisch gefunden: Gib die E-Mail-Adresse und das Passwort der Panasonic ID aus der App ein und öffne dann den Tab „Entdecken“. Gladys spricht über die Panasonic-Cloud mit ihnen. |
| Panasonic ID (E-Mail) | string | Ja | |
| Passwort | secret | Ja | |
| Aktualisierungsintervall | select | Nein | Wie oft jedes zu Gladys hinzugefügte Klimagerät gelesen wird. Comfort Cloud ist langsam und begrenzt die Aufrufe: 2 Minuten ist der Takt der Home-Assistant-Integration. |
| Sprache der Funktionsnamen | select | Nein | Namen für die Funktionen neuer Geräte (Modus, Lüftergeschwindigkeit...). Die Geräte behalten die Namen aus der Comfort-Cloud-App. |
| Erweitert | section | Nein | Panasonic antwortet nur aktuellen Versionen seiner App. Die Integration liest die aktuelle Version selbst aus Google Play; fülle dies nur aus, wenn der Verbindungsstatus meldet, dass die Version abgelehnt wird. |
| Version der Comfort-Cloud-App | string | Nein |
So installierst du Panasonic Comfort Cloud in Gladys
- Öffne in Gladys Integrationen: Panasonic Comfort Cloud erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-panasonic-cc:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-panasonic-cc.
Panasonic Comfort Cloud benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Panasonic Comfort Cloud ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation