Zum Hauptinhalt springen

Flume Smart-Home-Integration, kostenlos und Open Source

Flume-Integration für Gladys Assistant

Wasserverbrauch, Durchfluss und Leckalarme deines Flume-Wasserzählers.

Auf GitHub ansehenAlle Integrationen

Diese Integration verbindet Gladys mit einem intelligenten Flume-Wasserzähler: dem Sensor an deinem Wasserzähler und der Bridge, die ihn an die Flume-Cloud weiterleitet. Gladys erhält deinen Wasserverbrauch, den aktuellen Durchfluss, Leckalarme und den Batteriezustand des Sensors und kann sie in Szenen und auf dem Dashboard verwenden.

Bevor du beginnst​

  • Dein Flume-Sensor und deine Bridge müssen in der Flume-App eingerichtet sein und funktionieren.
  • Flume hat keine lokale API: Alles läuft über die Flume-Cloud. Gladys braucht Internetzugang, und die Messwerte kommen mit der Verzögerung der Flume-Cloud an (etwa eine Minute).

Deinen API-Client holen​

Jedes Flume-Konto kann einen persönlichen API-Client erstellen. Mit ihm spricht Gladys in deinem Namen mit der Flume-Cloud.

  1. Melde dich mit deinem Flume-Konto auf portal.flumewater.com an.
  2. Öffne Settings und dann API Access.
  3. Erstelle einen Client, falls noch keiner existiert, und kopiere seine Client ID und sein Client Secret.

Konfiguration​

Öffne in Gladys Integrationen, dann Flume, dann den Reiter Konfiguration.

FeldWas eintragen
Flume-E-MailDie E-Mail, mit der du dich in der Flume-App anmeldest.
Flume-PasswortDas Passwort dieses Kontos. Es wird nur an Flume gesendet.
Client-IDDie Client ID deines API-Clients.
Client-SecretDas Client Secret desselben API-Clients.
Aktualisierungsintervall (s)Wie oft der Verbrauch gelesen wird, 60 bis 3600 Sekunden. Standard: 120.
Schwelle für fließendes Wasser (L/min)Liter in der letzten Minute, ab denen das Wasser als fließend gilt. Standard: 0,5.

Speichere und klicke dann auf Verbindung testen: Die Antwort listet jeden Sensor mit seinem Tagesverbrauch, seinem Leckzustand und seiner Verbindung auf.

Warum nicht jede Sekunde aktualisieren?​

Flume erlaubt etwa 120 Anfragen pro Stunde und Konto. Jede Aktualisierung kostet eine Anfrage pro Sensor; die Geräteliste und die Alarme werden zusätzlich alle 5 Minuten gelesen. Mit den standardmäßigen 120 Sekunden braucht ein Haushalt mit einem Sensor etwa 54 Anfragen pro Stunde. Meldet Flume, dass das Limit erreicht ist, pausiert die Integration von selbst 10 Minuten und zeigt das im Konfigurationsbildschirm an.

Geräte​

Öffne den Reiter Entdecken der Integration: Jeder Flume-Sensor erscheint dort, benannt nach seinem Flume-Standort. Füge ihn zu Gladys hinzu. Er hat:

FunktionEinheitBedeutung
Water flow (last minute)LLiter in der letzten vollständigen Minute, also L/min.
Water used todayLSeit Mitternacht, in der Zeitzone des Zählers.
Water used this monthLSeit dem 1. des Monats.
Leak0/11, solange ein Flume-Leckalarm ungelesen ist.
Low battery0/11, wenn Flume eine schwache Batterie meldet oder ein Batteriealarm ungelesen ist.

Die Namen der Funktionen werden auf Englisch vorgeschlagen: Benenne sie in Gladys nach Belieben um. Alle Mengen sind in Litern.

Das Badge des Geräts zeigt cloud, wenn alles funktioniert, und unreachable (nicht erreichbar), wenn der Sensor, seine Bridge oder die Flume-Cloud offline ist.

Wie das Leck wieder auf 0 geht​

Flume behält einen Alarm, solange er ungelesen ist. Öffne ihn in der Flume-App (oder markiere ihn als gelesen): Bei der nächsten Prüfung, spätestens 5 Minuten später, geht die Funktion Leak wieder auf 0.

Szenen​

Auslöser​

  • Ein Flume-Alarm wird ausgelöst: ein neuer Alarm von Flume — Leck, hoher Durchfluss, schwache Batterie, Bridge offline oder ein anderer. Filtere nach Sensor und Alarmart. Die folgenden Aktionen können alert, title und message lesen. Ein Alarm, der beim Start der Integration schon bestand, löst ihn nicht erneut aus.
  • Wasser beginnt oder hört auf zu fließen: Die Liter der letzten Minute haben die Schwelle für fließendes Wasser aus der Konfiguration überschritten. Filtere nach Sensor und nach beginnt / hört auf; die folgenden Aktionen können state und liters lesen.

Für eine Schwelle auf einem Wert (zum Beispiel mehr als 500 L heute) verwende den Standardauslöser von Gladys auf den Gerätefunktionen: Es sind normale Sensoren.

Aktionen​

  • Flume-Wasserverbrauch lesen: liest bei Flume die über einen Zeitraum verbrauchten Liter (letzte Stunde, heute, letzte 24 Stunden, diese Woche, diesen Monat). Ausgaben: liters und cubic_meters.
  • Flume jetzt aktualisieren: liest Flume sofort, statt auf die nächste Aktualisierung zu warten. Ausgaben: leak, water_running, liters_last_minute, liters_today — für einen Sensor oder für alle, wenn keiner gewählt ist.

Beispiel: „Jeden Tag um 22:00 Uhr den Tagesverbrauch lesen und mir eine Nachricht schicken, wenn er über 800 Liter liegt.“

Dashboard-Widget​

Füge das Widget Flume-Wasser zu einem Dashboard hinzu. Es zeigt die letzte Minute, den Tag und den Monat als Live-Kacheln, den Durchfluss der letzten 24 Stunden, den Leck-, Wasser-, Batterie- und Verbindungsstatus, den letzten Alarm und eine Schaltfläche Aktualisieren. Wähle in seinen Einstellungen einen Sensor oder lass das Feld leer für den ersten Sensor des Kontos.

Fehlerbehebung​

  • „Flume hat die Anmeldung abgelehnt“: Prüfe E-Mail und Passwort in der Flume-App, dann Client ID und Client Secret auf portal.flumewater.com. Ein in der Flume-App geändertes Passwort muss auch hier geändert werden.
  • Kein Sensor im Reiter Entdecken: Klicke auf Verbindung testen. Meldet er „kein Sensor in diesem Konto“, schließe die Einrichtung in der Flume-App ab.
  • Badge nicht erreichbar: Die Flume-App zeigt denselben Zustand; prüfe die Bridge (Strom, WLAN) und die Batterien des Sensors.
  • Werte eine oder zwei Minuten zu spät: Das ist die Verzögerung der Flume-Cloud selbst.

Die Protokolle der Integration (Gladys, Integrationen, Flume, Protokolle) enthalten nie dein Passwort, dein Client Secret oder deine Tokens.

Konfigurationseinstellungen​

Diese Einstellungen fragt Flume in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinFlume antwortet nur über seine Cloud: Die Integration braucht dein Flume-Konto und den persönlichen API-Client dieses Kontos. Erstelle den Client auf portal.flumewater.com (Settings, API Access) und kopiere seine Client-ID und sein Client-Secret unten hinein.
Flume-E-MailstringJaDie E-Mail, mit der du dich in der Flume-App anmeldest.
Flume-PasswortsecretJaDas Passwort dieses Flume-Kontos. Es wird nur an Flume gesendet.
Client-IDstringJaClient-ID deines API-Clients (portal.flumewater.com, Settings, API Access).
Client-SecretsecretJaClient-Secret desselben API-Clients.
Aktualisierungsintervall (s)numberNeinWie oft der Wasserverbrauch gelesen wird, in Sekunden (60 bis 3600). Flume erlaubt etwa 120 Anfragen pro Stunde: Jede Aktualisierung kostet eine Anfrage pro Sensor, dazu die Geräteliste und die Alarme alle 5 Minuten.
Schwelle für fließendes Wasser (L/min)numberNeinLiter in der letzten Minute, ab denen das Wasser als fließend gilt, für den Auslöser „Wasser beginnt oder hört auf zu fließen“. 0 zählt jeden Tropfen.

So installierst du Flume in Gladys​

  1. Öffne in Gladys Integrationen: Flume 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-flume: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-flume.

Flume 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​

Flume 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 🙂
Zuletzt aktualisiert am