FYTA Smart-Home-Integration, kostenlos und Open Source
FYTA-Beam-Pflanzensensoren: Bodenfeuchte, Licht, Temperatur und Pflegehinweise.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.1.0
- ★ 0
Überblick
Diese Integration bringt die Pflanzen deines FYTA-Kontos in Gladys: die Messwerte deiner FYTA-Beam-Pflanzensensoren (Bodenfeuchte, Licht, Temperatur, Batterie) und was FYTA davon hält (zu niedrig, perfekt, zu hoch), über die offizielle FYTA Public API mit der E-Mail-Adresse und dem Passwort deines FYTA-Kontos. Sie liest nur. Sie ist nicht mit FYTA verbunden.
- Ein Gerät pro Pflanze mit Sensor: Bodenfeuchte, Licht, Temperatur, Sensorbatterie und ihr Hinweis auf schwache Batterie, der pH-Wert, wenn FYTA einen liefert, und die Zustände von FYTA (Pflanze, Bodenfeuchte, Licht, Temperatur, Salzgehalt, Nährstoffe).
- Zwei Dashboard-Widgets: die Pflanzen, die Pflege brauchen, die dringendsten zuerst; eine Pflanze mit ihrem Foto.
- Szenen-Auslöser: Pflanze braucht Pflege, Pflanze durstig, Messwert außerhalb des Bereichs, Messwert wieder im Bereich, Sensorbatterie schwach, Sensor stumm, Sensor wieder da, Düngung fällig, Zugriff verweigert.
- Szenen-Aktionen: jetzt aktualisieren, die Werte einer Pflanze, die Zusammenfassung der Pflanzen, die Pflege brauchen.
Transport: Cloud. E-Mail-Adresse und Passwort gehen zur Anmeldung an FYTA (web.fyta.de); die Messwerte deiner Pflanzen kommen aus der FYTA-Cloud, die sie von deinen Beams über den FYTA Hub oder die FYTA-App erhält.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer.
- Ein FYTA-Konto (das der FYTA-App) mit mindestens einer Pflanze, die mit einem FYTA-Beam-Sensor verbunden ist. Pflanzen ohne Sensor werden nicht angeboten.
- Die Messwerte müssen in die FYTA-Cloud gelangen: über einen FYTA Hub oder über die FYTA-App, wenn dein Telefon in der Nähe des Beams ist. Ohne Hub ändern sich die Werte nur, wenn die App synchronisiert.
- Die API meldet sich nur mit E-Mail-Adresse und Passwort an: nimm die, mit denen du dich in der FYTA-App anmeldest.
Aktualität der Daten: Ein Beam sendet seine Messwerte etwa einmal pro Stunde. Häufiger bei FYTA abzufragen bringt nichts Neues; FYTA meldet einen Sensor nach 1,5 Stunden ohne Messwert als fehlerhaft.
Konfiguration
| Feld | Bedeutung |
|---|---|
| E-Mail-Adresse | Die E-Mail deines FYTA-Kontos |
| Passwort | Sein Passwort (ein Geheimnis: nie wieder angezeigt, nie in die Logs oder nach /data geschrieben) |
| Abfrage der Pflanzen | Alle 10, 15 (Standard), 30 oder 60 Minuten; die Details einer Pflanze werden nur bei Neuigkeiten gelesen |
| Sensor ohne Daten nach | 2, 3 (Standard), 6, 12 oder 24 Stunden ohne neuen Messwert |
| Sprache der Texte | Namen der Funktionen, Zustände (zu niedrig, perfekt…), Szenentexte und Fehler; automatisch folgt dem letzten Widget |
Schaltflächen:
- Verbindung testen meldet sich bei FYTA an und listet die Pflanzen mit Sensor auf (und wie viele keinen haben).
- Diagnose schreibt den Zustand der Integration in ihre Logs, ohne Passwort und Token.
Die Integration speichert das Zugriffstoken, das FYTA bei der Anmeldung liefert, in /data (nur für sie lesbar), bis es abläuft (laut FYTA-Dokumentation 60 Tage), damit ein Neustart keine neue Anmeldung braucht.
Verwendung
Geräte
Öffne nach der Konfiguration Entdecken: Jede Pflanze mit Sensor wird als Gerät angeboten, benannt nach ihrem Spitznamen in der FYTA-App. Füge die gewünschten hinzu.
| Funktion | Kategorie / Typ | Einheit |
|---|---|---|
| Bodenfeuchte | soil-moisture-sensor / decimal | % |
| Licht (Photonenfluss, wie FYTA es misst) | light-sensor / decimal | µmol/m²/s |
| Temperatur | temperature-sensor / decimal | °C |
| Boden-pH (nur wenn FYTA einen liefert) | ph-sensor / decimal | pH |
| Sensorbatterie | battery / integer | % |
| Sensorbatterie schwach | battery-low / binary | — |
| Zustände: Pflanze, Bodenfeuchte, Licht, Temperatur, Salzgehalt, Nährstoffe | text / text | — |
Das Licht ist ein Photonenfluss (PPFD, µmol/m²/s), keine Lux: Gladys hat dafür keine Einheit, der Wert erscheint also ohne Einheit und sein Name sagt es. Der Salzgehalt (Dünger, mS/cm) hat in Gladys keine passende Kategorie: Sein Zustand ist eine Funktion, sein Wert steht im Widget und in den Szenen.
Dashboard-Widgets
- Pflanzen zu pflegen: wie viele Pflanzen Pflege brauchen, bestens dastehen, keine Daten senden; dann die Pflanzen, um die du dich kümmern solltest, die dringendsten zuerst (durstig, weit außerhalb des Bereichs, außerhalb des Bereichs, stummer Sensor, schwache Batterie). Tippe auf eine Pflanze für die Werte und ihren idealen Bereich. Die Schaltfläche Aktualisieren liest FYTA sofort (höchstens einmal pro Minute).
- FYTA-Pflanze: eine Pflanze (in den Einstellungen des Widgets wählen; standardmäßig die erste): ihr Foto aus der FYTA-App, Bodenfeuchte, Licht, Temperatur, Salzgehalt und Batterie nach Zustand gefärbt, der Zustand der Pflanze und ihrer Nährstoffe, der letzte Messwert und das nächste Düngedatum.
Szenen
Auslöser (einmal pro Änderung, nie bei der ersten Abfrage, nie wegen einer Szenen-Aktion), nach Pflanze filterbar:
- Pflanze braucht Pflege: Der FYTA-Zustand der Pflanze wechselt von „alles bestens“ zu „braucht Pflege“.
- Pflanze durstig: Die Bodenfeuchte fällt in den niedrigen oder zu niedrigen Bereich der Pflanze.
- Messwert außerhalb des Bereichs: Bodenfeuchte, Licht, Temperatur, Salzgehalt oder Nährstoffe wechseln zu niedrig, zu niedrig, hoch oder zu hoch (Filter: Messwerte, Stufen).
- Messwert wieder im Bereich: Ein Messwert ist wieder perfekt.
- Sensorbatterie schwach: FYTA meldet die Batterie des Sensors.
- Sensor stumm / Sensor wieder da: kein Messwert während der eingestellten Zeit, dann wieder Messwerte.
- Düngung fällig: Das von FYTA geplante Datum ist erreicht, um 9:00 Uhr.
- Zugriff verweigert: FYTA lehnt die E-Mail-Adresse, das Passwort oder das Konto ab.
Aktionen:
- Jetzt aktualisieren: liest alle Pflanzen (höchstens einmal pro Minute); gibt die Zahl der Pflanzen und der Pflanzen zurück, die Pflege brauchen.
- Werte einer Pflanze: Bodenfeuchte, Licht, Temperatur, Salzgehalt, Batterie, ihre Zustände und ein Satz, aus der letzten Abfrage.
- Pflanzen zu pflegen: wie viele, welche und warum, in einem Satz – für eine tägliche Nachricht.
Beispiele:
- Wenn FYTA: Pflanze durstig → sende „{{triggerEvent.data.plant_name}} hat Durst ({{triggerEvent.data.moisture}} %)“.
- Jeden Tag um 8:00 Uhr → FYTA: Pflanzen zu pflegen; wenn die Zahl größer als 0 ist → sende die Zusammenfassung.
- Wenn FYTA: Sensor stumm → sende „Keine Nachricht von {{triggerEvent.data.plant_name}} seit {{triggerEvent.data.hours_without_data}} Std.: Ist der Hub an?“.
Fehlerbehebung
- „FYTA kennt diese E-Mail-Adresse nicht“ oder „hat das Passwort abgelehnt“: Prüfe beides, indem du dich mit derselben E-Mail-Adresse und demselben Passwort in der FYTA-App anmeldest.
- Kein Gerät angeboten: Nur Pflanzen mit einem Beam werden angeboten; drücke Verbindung testen, um zu sehen, was FYTA liefert.
- Werte, die sich nicht ändern: Der Beam braucht einen FYTA Hub oder die geöffnete FYTA-App in der Nähe, um seine Messwerte zu senden; die Zeile „Letzte Messung“ des Pflanzen-Widgets zeigt, wann FYTA zuletzt einen erhalten hat.
- Licht ohne Einheit: Absicht, siehe Geräte.
- Eine Temperatur in °F in der FYTA-App: Die Integration rechnet sie in °C um, wenn FYTA das angibt (nicht mit einem echten Konto getestet).
- Für ein Issue: die Versionen von Gladys und der Integration, die Meldung von Verbindung testen und die Zeilen „FYTA diagnostic“, die Diagnose in die Logs der Integration schreibt. Füge nie dein Passwort ein.
Konfigurationseinstellungen
Diese Einstellungen fragt FYTA in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| FYTA-Konto | section | Nein | Gib die E-Mail-Adresse und das Passwort ein, die du in der FYTA-App verwendest. Die Integration meldet sich bei der offiziellen FYTA-API (web.fyta.de) an und liest deine Pflanzen nur: Die Messwerte laufen über die FYTA-Cloud, gesendet vom FYTA Hub oder von der App. Pflanzen ohne FYTA-Beam-Sensor werden nicht angeboten. Diese Integration ist nicht mit FYTA verbunden. |
| E-Mail-Adresse | string | Ja | |
| Passwort | secret | Ja | |
| Abfragen und Auslöser | section | Nein | Ein FYTA Beam sendet seine Messwerte etwa einmal pro Stunde (über den FYTA Hub oder die App, wenn das Telefon in der Nähe ist): Häufiger abzufragen bringt nichts Neues. Die Details einer Pflanze werden nur gelesen, wenn FYTA etwas Neues für sie zeigt. |
| Abfrage der Pflanzen | select | Nein | Wie oft die Liste der Pflanzen gelesen wird (eine Anfrage für alle). |
| Sensor ohne Daten nach | select | Nein | Zeit ohne neuen Messwert, bevor ein Sensor als ohne Daten gilt und der Auslöser „Sensor stumm“ auslöst. |
| Sprache der Texte | select | Nein | Namen der Funktionen, Zustände (zu niedrig, perfekt…), Szenentexte und Fehler. Automatisch: die Sprache des zuletzt angezeigten Widgets. |
So installierst du FYTA in Gladys
- Öffne in Gladys Integrationen: FYTA erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-fyta:0.1.0) 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/William-De71/gladys-fyta.
FYTA 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
FYTA 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 William-De71 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