Zum Hauptinhalt springen

Flair Smart-Home-Integration, kostenlos und Open Source

Flair-Integration für Gladys Assistant

Steuere Flair Smart Vents, Raum-Sollwerte und Zuhause/Abwesend, lies die Flair Pucks.

Steuere deine Flair Smart Vents (smarte Lüftungsklappen) aus Gladys, verfolge die Temperatur jedes Raums und schalte dein Zuhause zwischen Zuhause und Abwesend um.

Was du bekommst​

Nach der Konfiguration listet der Tab Erkennung ein Gerät pro Flair-Element:

Flair-ElementIn Gladys
ZuhauseSchalter Zuhause (aus = Abwesend), Auto-Modus (aus = Manuell)
RaumSollwert (Thermostat), Temperatur, Luftfeuchtigkeit, Aktiv
Smart VentÖffnung (0 % zu bis 100 % offen) und die Tasten Öffnen / Schließen
PuckTemperatur, Luftfeuchtigkeit

Jedes Gerät zeigt ein Cloud-Abzeichen: Flair ist nur über seine Cloud erreichbar. Das Abzeichen wechselt auf nicht erreichbar, wenn Flair nicht antwortet oder wenn sich eine Klappe oder ein Puck nicht mehr meldet (leere Batterie, außer Reichweite).

Vorab: API-Zugangsdaten besorgen​

Flair gibt den API-Zugang auf Anfrage frei: Schreibe dem Flair-Support (über die Flair-Website oder die Flair-App) und bitte um API-Zugangsdaten für dein Konto. Du erhältst eine Client-ID und ein Client-Secret.

Konfiguration​

  1. Öffne den Tab Konfiguration der Integration.
  2. Füge die Client-ID und das Client-Secret ein.
  3. Ändere bei Bedarf das Aktualisierungsintervall: Die Integration liest dein Flair-Konto standardmäßig alle 2 Minuten (mindestens eine Minute).
  4. Speichere und klicke auf Verbindung testen: Die Antwort listet die gefundenen Zuhause, Räume, Klappen und Pucks.
  5. Öffne den Tab Erkennung und füge die gewünschten Geräte hinzu.

Gut zu wissen​

  • Im Auto-Modus öffnet und schließt Flair die Klappen selbst, um den Sollwert jedes Raums zu erreichen. Eine in Gladys gesetzte Öffnung hält bis zur nächsten Entscheidung von Flair. Damit die Klappen bleiben, wo du sie hinstellst, schalte das Zuhause auf Manuell (Schalter Auto-Modus).
  • Ein inaktiver Raum wird von Flair ausgelassen: Seine Klappen bleiben geschlossen.
  • Eine Änderung in der Flair-App erscheint bei der nächsten Aktualisierung in Gladys.

Szenen​

Die Integration fügt dem Szenen-Editor eigene Karten hinzu, in der Kategorie Integrationen.

Auslöser:

  • Flair Zuhause/Abwesend geändert — ein Zuhause wechselte zwischen Zuhause und Abwesend (Flair-App, Geofencing oder Gladys … außer einer Änderung durch dieselbe Szene). Wähle optional das Zuhause und den neuen Modus. Die folgenden Aktionen können {{triggerEvent.data.mode}} (home oder away) und {{triggerEvent.data.home_name}} lesen.
  • Flair-Gerät online oder offline — eine Klappe oder ein Puck meldet sich nicht mehr oder ist zurück. Wähle optional das Gerät und den Status. Variablen: {{triggerEvent.data.status}} (offline oder online) und {{triggerEvent.data.device_name}}.

Aktionen:

  • Öffnung einer Flair-Klappe setzen — 0 bis 100 %. Gibt die Öffnung zurück und ob das Zuhause im Auto-Modus ist (Flair kann die Klappe dann wieder verstellen).
  • Sollwert eines Flair-Raums setzen — 10 bis 32 °C. Gibt den Sollwert zurück.
  • Flair-Zuhause auf Zuhause oder Abwesend setzen — gibt zurück, ob das Zuhause auf Zuhause steht.
  • Flair-Zuhause auf Auto oder Manuell setzen — gibt zurück, ob Auto aktiv ist.

Dashboard​

Füge das Widget Flair-Übersicht einem Dashboard hinzu. Es zeigt die durchschnittliche Raumtemperatur, die Zahl der offenen Klappen, die Offline-Geräte, dann jedes Zuhause (Zuhause / Abwesend, Auto / Manuell) und jeden Raum (Temperatur → Sollwert, grün wenn nah, orange oder rot wenn weit entfernt). Seine Tasten schalten das erste Zuhause zwischen Zuhause und Abwesend, zwischen Auto und Manuell um und aktualisieren die Daten sofort.

Fehlerbehebung​

  • „Flair hat die API-Zugangsdaten abgelehnt“ — prüfe Client-ID und Client-Secret, ohne Leerzeichen davor oder danach. Wende dich an den Flair-Support, wenn es weiterhin scheitert.
  • „Die Flair-Cloud antwortet nicht“ — Flair oder deine Internetverbindung ist ausgefallen. Die Integration versucht es bei jeder Aktualisierung erneut.
  • Ein Gerät bleibt nicht erreichbar — prüfe in der Flair-App seine Batterie und seinen Abstand zur Flair-Bridge.
  • Mehr Details in den Logs der Integration (Gladys-Oberfläche oder docker logs auf dem Host), mit LOG_LEVEL=debug.

Konfigurationseinstellungen​

Diese Einstellungen fragt Flair in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinFlair wird über seine Cloud-API mit OAuth-2.0-Zugangsdaten (Client-ID und Client-Secret) gesteuert, die der Flair-Support auf Anfrage ausstellt. Gib sie unten ein, speichere und klicke auf „Verbindung testen“: Deine Zuhause, Räume, Klappen und Pucks erscheinen im Tab „Erkennung“.
Client-IDstringJaOAuth-2.0-Client-ID der Flair-API.
Client-SecretsecretJaOAuth-2.0-Client-Secret der Flair-API. Als Geheimnis gespeichert, nie protokolliert.
Aktualisierungsintervall (s)numberNeinWie oft das Flair-Konto gelesen wird, in Sekunden (mindestens eine Minute).

So installierst du Flair in Gladys​

  1. Öffne in Gladys Integrationen: Flair 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-flair:1.0.1) 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-flair.

Flair benötigt Gladys >=5.3.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​

Flair 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 🙂