Frisquet Connect Smart-Home-Integration, kostenlos und Open Source
Frisquet-Heizkessel mit Connect-Box: Zonen, Sollwerte, Modi, Warmwasser, Alarme und Gasverbrauch.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Überblick
Diese Integration verbindet Gladys mit deinem Frisquet-Heizkessel mit Frisquet-Connect-Box, über denselben Online-Dienst wie die App „Frisquet Connect“. In Gladys bekommst du:
- jede Heizzone (Zone 1, Zone 2, Zone 3 je nach Anlage) mit Raumtemperatur, Sollwert, den Sollwerten Komfort / Absenkung / Frostschutz und ihrem Modus;
- den Heizkessel: Außentemperatur (wenn ein Fühler angeschlossen ist), Warmwasser (ein / aus und Modus), Alarme, Urlaubsmodus, Standby und Gasverbrauch für Heizung und Warmwasser;
- ein Widget fürs Dashboard, um den Modus mit einem Tippen zu wechseln, Szenen-Aktionen und einen Auslöser für Alarme.
Eine Community-Integration, nicht mit Frisquet verbunden. Frisquet Connect hat keine öffentliche API: Die Integration spricht die Sprache der offiziellen App, nach der Arbeit der im README genannten Projekte. Ohne die Hardware und ohne Konto entwickelt: Rückmeldungen sind willkommen, vor allem wenn sich ein Modus oder ein Befehl anders verhält als in der App.
Voraussetzungen
- Ein Frisquet-Heizkessel mit installierter und gekoppelter Frisquet-Connect-Box.
- Ein Konto in der App Frisquet Connect (E-Mail-Adresse und Passwort), das deinen Kessel sieht.
- Gladys Assistant 5.2.0 oder neuer (der Zonenmodus nutzt die mit 5.2.0 eingeführten Thermostat-Voreinstellungen).
- Internetzugang für Gladys: Alles läuft über den Online-Dienst von Frisquet, nichts über das lokale Netz.
Konfiguration
- In Gladys: Integrationen → Frisquet Connect → Konfiguration.
- Gib die E-Mail-Adresse und das Passwort der App Frisquet Connect ein.
- Wähle die Sprache der Namen (standardmäßig Französisch). Die Funktionsnamen werden beim Hinzufügen eines Geräts festgelegt: Ändere die Sprache vorher.
- Wähle das Abfrageintervall: alle 5 Minuten (Standard), 10 oder 15 Minuten.
- Speichere und klicke auf Verbindung testen: Die Meldung nennt die Zahl der gefundenen Kessel und Zonen.
- Tab Entdecken: Füge den Kessel und die gewünschten Zonen hinzu.
Enthält dein Konto mehrere Kessel (zum Beispiel ein Haus und eine Wohnung), erscheinen alle; der Name jeder Zone beginnt dann mit dem Namen der Anlage.
Was jedes Gerät macht
Der Heizkessel
| Funktion | Was sie zeigt oder macht |
|---|---|
| Außentemperatur | Der Außenfühler, wenn einer angeschlossen ist. |
| Warmwasser | Warmwasser ein / aus. „Ein“ stellt den zuletzt genutzten Modus wieder her. |
| Warmwassermodus | MAX, Eco, Eco mit Zeitplan, Eco+, Eco+ mit Zeitplan, Aus (je nach Kessel). |
| Alarm / Alarm aktiv | Der Text des Alarms, den Frisquet anzeigt, und eine Ja-/Nein-Anzeige. |
| Urlaubsmodus | Aktiv, solange ein geplanter Urlaub läuft (nur lesbar). |
| Heizkessel im Standby | Der Kessel ist im Standby. |
| Gas Heizung / Gas Warmwasser | Gasverbrauch in diesem Monat und diesem Jahr, in kWh, wie Frisquet ihn zählt. |
Hinweise für den Installateur (etwa eine dauerhafte Erinnerung zur Fußbodenheizung) sind keine Störungen und werden ignoriert.
Die Heizzonen
| Funktion | Was sie zeigt oder macht |
|---|---|
| Raumtemperatur | Die vom Raumfühler der Zone gemessene Temperatur. |
| Sollwert | Der gerade angewendete Sollwert. Eine Änderung ändert dauerhaft den Sollwert des laufenden Modus (Komfort oder Absenkung), wie in der App. |
| Sollwert Komfort / Absenkung / Frostschutz | Die drei Sollwerte der Zone, von 5 bis 30 °C in Schritten von 0,5 °C. |
| Modus | Zeitplan (folgt dem Wochenprogramm), dauerhaft Komfort, Absenkung oder Frostschutz. In Gladys erscheint „Absenkung“ als „Eco“. |
| Übersteuerung aktiv | Eine Übersteuerung läuft (ein Modus bis zur nächsten Änderung des Programms). |
| Boost | Nur wenn die Zone es anbietet: eine zeitweise verstärkte Heizung. |
| Aktueller Modus | Ein Satz: „Komfort (Zeitplan)“, „Absenkung (Übersteuerung)“, „Frostschutz (Urlaub)“… |
Zeitplan zu wählen beendet auch eine laufende Übersteuerung.
Takt, Verzögerungen und Kontingente
- Die Connect-Box gibt den Zustand des Kessels per Funk alle paar Minuten an den Dienst von Frisquet weiter. Häufiger zu lesen brächte nichts: Die Integration liest standardmäßig alle 5 Minuten (10 oder 15 nach Wahl) und den Gasverbrauch (monatlich) alle 6 Stunden.
- Der Dienst nimmt einen Befehl sofort an, aber der Kessel übernimmt ihn erst beim nächsten Austausch mit der Box: Rechne mit einigen Minuten. Gladys zeigt den angeforderten Wert sofort an, dann liest die Integration den Kessel 20 Sekunden und 3 Minuten später erneut.
- Der Dienst begrenzt die Zahl der Anfragen: Die Integration hält mindestens eine halbe Sekunde zwischen zwei Aufrufen ein und liest nur die Kessel, von denen ein Gerät in Gladys hinzugefügt ist. Nach einem abgelehnten Passwort wartet sie 30 Minuten, bevor sie es selbst erneut versucht (damit dein Konto nicht gesperrt wird); eine korrigierte Konfiguration startet sofort neu.
- Ein Wert, der sich nicht ändert, wird alle 6 Stunden erneut veröffentlicht, damit Gladys ihn nicht als veraltet anzeigt.
Widget
Füge das Widget Frisquet-Heizung zu einem Dashboard hinzu.
- Ohne Einstellung (oder mit einem Kessel): alle Zonen auf einen Blick, Temperatur und Sollwert jeder Zone und eine Zeile pro Zone mit ihrem aktuellen Modus.
- Mit einer gewählten Zone: ihre Temperatur und ihr Sollwert live, der aktuelle Modus, die Sollwerte Komfort / Absenkung / Frostschutz, die Außentemperatur und vier Tasten: Zeitplan, Komfort, Absenkung und Übersteuern (kehrt die laufende Periode bis zur nächsten Änderung des Programms um, wie die Übersteuerungstaste des Kessels) oder Übersteuern beenden. Der aktive Modus trägt einen Haken.
Frostschutz hat keine Taste im Widget, damit ein unglückliches Tippen nie den Komfort abschaltet: Wähle ihn am Gerät oder per Szene.
Szenen
Auslöser
- Alarm des Frisquet-Kessels — ein neuer Alarm ist am Kessel aufgetreten (Störung, Connect-Box getrennt…). Wähle den Kessel oder lass das Feld für alle leer. Der Alarmtext steht in der Variable „Alarm“. Ein Alarm, der bei der Installation oder beim Neustart schon da ist, löst nichts aus.
Aktionen
- Frisquet-Heizmodus — wähle eine Zone oder einen Kessel für alle seine Zonen und den Modus: zurück zum Zeitplan, dauerhaft Komfort / Absenkung / Frostschutz, Komfort oder Absenkung bis zur nächsten Änderung (Übersteuerung) oder Ende der Übersteuerung.
- Frisquet-Warmwasser — wähle den Kessel und den Modus: Ein (letzter Modus), Aus, MAX, Eco, Eco mit Zeitplan, Eco+, Eco+ mit Zeitplan.
Die Sollwerte stellst du mit der Standardaktion „Gerät steuern“ von Gladys ein.
Szenenbeispiele
- Wochenende weg: Wenn die Alarmanlage auf Abwesend schaltet, Frisquet-Heizmodus am Kessel mit „Frostschutz, dauerhaft“, dann Frisquet-Warmwasser auf „Aus“. Bei der Rückkehr „Zurück zum Zeitplan“ und „Ein“.
- Früher zu Hause als geplant: Wenn dein Handy an einem Wochentag in den Bereich des Hauses zurückkommt, „Komfort bis zur nächsten Änderung“ für die Wohnzimmerzone.
- Vor einer Störung warnen: Auslöser Alarm des Frisquet-Kessels, dann eine Telegram-Nachricht „Kessel: {{triggerEvent.data.alarm}}“.
- Nebentarif: um 22 Uhr Sollwert Absenkung 17 °C; um 6 Uhr Sollwert Komfort 20 °C (Aktion „Gerät steuern“).
Fehlerbehebung
- „Frisquet Connect hat die E-Mail-Adresse oder das Passwort abgelehnt“: Prüfe sie, indem du dich in der App Frisquet Connect anmeldest, und korrigiere dann die Konfiguration.
- „Frisquet Connect antwortet nicht“: Der Dienst ist nicht erreichbar oder wird gewartet; die Integration versucht es selbst erneut. Der Alarm „Box Frisquet Connect déconnectée“ bedeutet, dass die Box das Internet nicht mehr erreicht (Box ausgesteckt, WLAN aus).
- Ein Befehl ändert nichts: Warte einige Minuten (siehe Verzögerungen oben). Springt der Wert nach 5 Minuten auf den alten zurück, melde es mit den Protokollen.
- „Kein aktueller Wert“ beim Gasverbrauch: Dein Konto liefert ihn vielleicht nicht; alles andere funktioniert ohne.
- Protokolle: Im Normalbetrieb schreibt die Integration nichts. Für Details setze
LOG_LEVELaufdebug. Das Token und das Passwort erscheinen nie in den Protokollen.
Grenzen
- Ohne die Hardware und ohne Konto entwickelt: Die Antworten des Dienstes stammen aus anderen Community-Projekten, die sie an echten Kesseln aufgezeichnet haben. Rückmeldungen willkommen.
- Der Urlaubsmodus ist nur lesbar: Wie man ihn über den Dienst plant, ist nicht dokumentiert. Stelle ihn in der App oder am Kessel ein, oder nutze „Frostschutz, dauerhaft“.
- Die Übersteuerung ist im Dienst von Frisquet ein Befehl ohne Zonennummer: Bei mehreren Zonen kann sie je nach Kessel für Zone 1 oder für alle Zonen gelten. Bei dir zu prüfen.
- Das Wochenprogramm lässt sich in Gladys nicht bearbeiten (nur befolgen).
- Der Gasverbrauch ist der von Frisquet berechnete, pro Monat: kein Gaszähler, und er geht nicht an die Energieüberwachung von Gladys, die ihn als Strom zählen würde.
- Der Warmwassermodus von Solaranlagen wird nicht unterstützt.
- Alles läuft über das Internet: Ohne den Dienst von Frisquet sieht Gladys den Kessel nicht mehr (der Kessel selbst heizt normal weiter).
Konfigurationseinstellungen
Diese Einstellungen fragt Frisquet Connect in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Frisquet-Connect-Konto | section | Nein | Verwende die E-Mail-Adresse und das Passwort der App Frisquet Connect. Der Heizkessel braucht die Frisquet-Connect-Box. Die Cloud gibt den Kessel alle paar Minuten weiter: Eine Änderung braucht bis zu 5 Minuten. Nicht mit Frisquet verbunden. |
| E-Mail-Adresse | string | Ja | Die E-Mail-Adresse, mit der du dich in der App Frisquet Connect anmeldest. |
| Passwort | secret | Ja | Von Gladys gespeichert, nur an Frisquet Connect gesendet. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen (beim Hinzufügen eines Geräts festgelegt) und der Texte der Integration. |
| Abfrageintervall | select | Nein | Wie oft die Heizkessel gelesen werden. Die Connect-Box aktualisiert die Cloud alle paar Minuten: schneller bringt nichts. |
So installierst du Frisquet Connect in Gladys
- Öffne in Gladys Integrationen: Frisquet Connect erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-frisquet: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-frisquet.
Frisquet Connect 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
Frisquet Connect 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