Zum Hauptinhalt springen

Faikout Smart-Home-Integration, kostenlos und Open Source

Faikout-Integration für Gladys Assistant

Steuere deine Daikin-Klimageräte lokal über ihr Faikout-Modul.

Diese Integration verbindet Gladys mit deinen Daikin-Klimageräten, die mit einem Faikout-Modul (früher Faikin) ausgestattet sind. Der Faikout ersetzt das ursprüngliche WLAN-Modul und wird lokal in deinem eigenen Netzwerk gesteuert: keine Cloud, kein Konto, kein Internet nötig.

In Gladys wird jedes Klimagerät zu einem Gerät mit:

  • Ein/Aus, Modus (Auto, Kühlen, Heizen, Entfeuchten, nur Lüften), Sollwert und Lüftergeschwindigkeit;
  • horizontalem und vertikalem Schwenken (ein oder aus: keine feste Position) sowie den Modi Econo, Powerful, Comfort, Streamer und leises Außengerät, sofern dein Gerät sie hat;
  • den Messwerten: Raumtemperatur, Außentemperatur, Ansaug- und Kältemitteltemperatur, Luftfeuchtigkeit, Leistungsaufnahme und Energiezähler (kWh).

Die Integration legt nur an, was dein Klimagerät tatsächlich meldet: Eine Funktion, die deinem Modell fehlt, erscheint nicht.

Bevor du beginnst​

  1. Baue das Faikout-Modul in das Klimagerät ein (siehe die Faikout-Installationsanleitung).
  2. Verbinde es mit deinem WLAN: Beim ersten Start öffnet es einen eigenen Zugangspunkt mit einer Einrichtungsseite.
  3. Prüfe, dass du seine Webseite (http://<module address>/) aus deinem Netzwerk öffnen und das Klimagerät darüber steuern kannst.
  4. Gib ihm eine feste IP-Adresse (eine DHCP-Reservierung in deinem Router). Diese Adresse verwendet Gladys.

Gladys spricht mit dem Modul so wie dessen eigene Webseite: Lass die Websteuerung des Faikout aktiviert (webcontrol, standardmäßig aktiv).

Konfiguration​

Unter Integrationen → Faikout → Konfiguration:

FeldRolle
Faikout-GeräteDie Adresse jedes Moduls, durch Kommas getrennt. Ein Name gefolgt von = vor der Adresse benennt das Gerät.
Web-PasswortNur wenn in den Faikout-Einstellungen ein Web-Passwort festgelegt ist (dasselbe für alle Geräte). Sonst leer lassen. Das Passwort der Einstellungen wird nicht benötigt.
AktualisierungsintervallWie oft jedes Klimagerät gelesen wird, in Sekunden (standardmäßig 30, 5 bis 600). Eine Änderung mit der Fernbedienung erscheint innerhalb dieser Zeit in Gladys.

Beispiel:

Living room=192.168.1.50, Bedroom=192.168.1.51, 192.168.1.52
  • Ohne Namen übernimmt das Gerät den eigenen Namen des Moduls (seinen Hostnamen).
  • Ein Name auf .local (z. B. guestac.local) wird im Container der Integration oft nicht aufgelöst: Verwende lieber die IP-Adresse.
  • Ein anderer Port als 80 wird 192.168.1.50:8080 geschrieben.
  • Mit einem Web-Passwort sendet Gladys es so, wie es die Faikout-Seite nach der Anmeldung tut (ein Cookie, im Klartext in deinem Netzwerk, wie die Faikout-Einstellungen warnen). Das Passwort der Einstellungen bleibt Gladys unbekannt: Es wird nie benötigt.

Klicke dann auf Verbindung testen: Für jedes Gerät sagt die Meldung, ob es antwortet, sein Modell, sein Protokoll (S21, X50A…), seinen Modus und die Raumtemperatur.

Öffne schließlich den Tab Entdecken der Integration und lege die angebotenen Geräte an.

Was das Badge jedes Geräts bedeutet​

BadgeBedeutung
LokalDer Faikout antwortet, das Klimagerät ebenfalls.
Lokal + orangefarbener PunktDer Faikout antwortet, aber nicht das Klimagerät: Prüfe das S21/X50-Kabel.
Nicht erreichbarDer Faikout antwortet nicht: ausgeschaltet, nicht im WLAN oder eine neue Adresse.

Szenen​

Auslöser​

AuslöserWann
Ein Klimagerät geht offline oder ist wieder daDer Faikout antwortet nicht mehr (Grund unreachable), das Klimagerät antwortet dem Faikout nicht mehr (Grund aircon), und dann, wenn alles wieder antwortet.
Ein Klimagerät wird außerhalb von Gladys geändertEin/Aus, Modus, Sollwert oder Lüfter mit der IR-Fernbedienung, der Faikout-Webseite oder einem Faikout-Timer geändert. Nie durch Gladys selbst.
Ein Klimagerät beginnt oder beendet das AbtauenBeim Heizen bei Kälte stoppt das Außengerät für einige Minuten, um sein Eis abzutauen.

Jeder Auslöser kann nach Klimagerät und nach Zustand (oder danach, was sich geändert hat) gefiltert werden. Die Werte sind in der Szene verfügbar, z. B. {{triggerEvent.data.mode}} oder {{triggerEvent.data.temperature}}.

Änderungen durch Faikout auto (das den Sollwert und den Modus selbst verändert) lösen „außerhalb von Gladys geändert“ nicht aus.

Aktionen​

AktionRolle
Ein Klimagerät einstellenEin/Aus, Modus, Sollwert und Lüfter auf einmal. Ein leer gelassenes Feld behält seinen Wert.
Faikout auto einstellenDer Faikout heizt oder kühlt selbst, um den Raum zwischen Ziel − Spanne und Ziel + Spanne zu halten. Eine Spanne von 0 stoppt ihn.
Ein Klimagerät lesenEin frischer Messwert: online, Ein/Aus, Modus, Sollwert, Raum- und Außentemperatur, Luftfeuchtigkeit. Schlägt nie fehl: Prüfe die Ausgabe Online.

Ihre Ausgaben können von den nächsten Aktionen der Szene verwendet werden (Bedingungen, Nachrichten…).

Für einen einzelnen Befehl (einschalten, den Sollwert ändern) funktioniert auch die Standardaktion Gerätewert setzen von Gladys.

Energieüberwachung​

Wenn das Klimagerät seinen Energiezähler meldet (Faikout-Feld Whoutside, meist mit dem S21-Protokoll), erhält das Gerät eine Funktion Energiezähler in kWh. Es ist ein Zählerstand: Gladys leitet daraus selbst den Verbrauch pro 30 Minuten und seine Kosten ab und zeigt sie in der Integration Energieüberwachung an.

  • Sobald das Gerät angelegt ist, öffne Integrationen → Energieüberwachung in Gladys: Das Klimagerät ist dort aufgeführt, an deinen Hauptzähler angehängt, falls du einen hast.
  • Der Zähler bewegt sich in Schritten von 100 Wh: Über einen kurzen Zeitraum erscheint der Verbrauch in Stufen.
  • Die Leistungsaufnahme (in W) bleibt für Live-Werte verfügbar.
  • Ein Klimagerät, das diesen Zähler nicht meldet, erhält die Funktion nicht.
  • Multi-Split (mehrere Innengeräte an einem Außengerät): Der Zähler ist der des Außengeräts, daher kann jeder Faikout denselben melden: Prüfe unter Energieüberwachung, dass er nicht doppelt gezählt wird.

Dashboard-Widgets​

  • Faikout-Klimagerät: ein Gerät. Live-Kacheln (Raum, Sollwert, außen, Leistung), eine Kurve der Raum-, Soll- und Außentemperatur über 24 h, dann Zustand, Modus, Lüfter, Lamellen, Komfortmodi sowie Faikout auto oder Abtauen, solange sie laufen. Eine Schaltfläche Einschalten oder Ausschalten (das Gegenteil des aktuellen Zustands) und Aktualisieren. Wähle das Gerät in den Widget-Einstellungen.
  • Faikout-Übersicht: alle deine Klimageräte auf einer Karte, mit ihrem Modus und der Raumtemperatur.

Fehlerbehebung​

  • „keine Antwort“ beim Verbindungstest: Öffne http://<address>/ von einem Computer im selben Netzwerk wie Gladys. Wenn sich die Seite nicht öffnet, liegt das Problem am Netzwerk (Adresse, WLAN, VLAN), nicht an Gladys.
  • „Web-Passwort fehlt oder ist falsch“: Auf dem Faikout ist ein Web-Passwort festgelegt. Gib dasselbe unter Web-Passwort ein (kopiere es aus den Faikout-Einstellungen).
  • Ein Befehl schlägt mit „did not apply“ fehl: Das Klimagerät hat diese Funktion nicht, oder der Faikout kann sie nicht steuern.
  • Faikout auto greift nicht: Der Faikout wird von einem externen Regler gesteuert (EnvMon, MQTT-Befehl control), der Vorrang hat.
  • Ein Gerät bleibt nach einer Adressänderung nicht erreichbar: Trage die neue Adresse unter Faikout-Geräte ein. Das Gladys-Gerät ist an die MAC-Adresse des Moduls gebunden: Es behält seinen Verlauf und seine Szenen.

Datenschutz​

Alles bleibt in deinem Netzwerk: Die Integration spricht nur mit den Adressen, die du ihr gibst, über lokales HTTP und WebSocket. Das Web-Passwort, falls vorhanden, wird von Gladys mit der Konfiguration gespeichert und nur an die Geräte gesendet. In ihrem Volume /data speichert sie nur die MAC-Adresse, den Namen, das Modell und die Funktionsliste jedes Geräts, um seine Geräte auch dann wiederzufinden, wenn ein Klimagerät beim Start ausgeschaltet ist.

Konfigurationseinstellungen​

Diese Einstellungen fragt Faikout in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinFaikout ersetzt das WLAN-Modul eines Daikin-Klimageräts und wird in deinem Netzwerk gesteuert, ohne Cloud. Verbinde zuerst jedes Gerät mit deinem WLAN (siehe Faikout-Installationsanleitung), lass seine Websteuerung aktiviert (standardmäßig der Fall) und trage die Geräte dann unten ein. Gladys erkennt ihre Funktionen selbst.
Faikout-GerätestringNeinDie Adresse jedes Geräts, durch Kommas getrennt. Verwende lieber eine feste IP-Adresse: Namen auf .local werden in der Integration oft nicht aufgelöst. Setze einen Namen und = davor, um das Gerät zu benennen, z. B. Wohnzimmer=192.168.1.50.
Web-PasswortsecretNeinNur wenn in den Faikout-Einstellungen ein Web-Passwort festgelegt ist: dasselbe für alle Geräte. Sonst leer lassen. Das Passwort der Einstellungen wird nicht benötigt.
Aktualisierungsintervall (s)numberNeinWie oft jedes Gerät gelesen wird, in Sekunden. Eine mit der Fernbedienung vorgenommene Änderung erscheint spätestens nach dieser Zeit in Gladys.

So installierst du Faikout in Gladys​

  1. Öffne in Gladys Integrationen: Faikout erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-faikout:1.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-faikout.

Faikout benötigt Gladys >=5.1.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​

Faikout 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 prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂