FYTA plant sensors / FYTA Pflanzensensoren
Quick setup (English)
FYTA sensors integrate soil moisture and soil temperature from the FYTA cloud into OpenSprinkler. The values can be used for sensor-program adjustments, monitors and notifications.
- Open https://web.fyta.de/api-token, sign in and copy an API token.
- In the OpenSprinkler UI, open Settings -> Sensor Settings -> FYTA Setup and enter either the API token (recommended) or FYTA email/password.
- Add a new sensor and choose FYTA Moisture or FYTA Temperature.
- Click Select FYTA plant and sensor, choose a plant with an assigned FYTA sensor and save.
- Use the value in program adjustments or monitors. Recommended polling interval: 15-60 minutes.
Platform notes: ESP32/ESP32-C5 and OSPi use HTTPS; ESP8266 uses HTTP because of platform TLS limits.
Einrichtung (Deutsch)
FYTA-Sensoren ermöglichen es, Bodenfeuchtigkeit und Temperatur direkt aus dem FYTA-Cloud-Dienst in OpenSprinkler zu integrieren. Die Messwerte können dann für automatische Bewässerungsanpassungen oder Monitore genutzt werden.
Voraussetzungen
- FYTA-Konto mit mindestens einer registrierten Pflanze und einem zugeordneten FYTA-Sensor
- OpenSprinkler ESP32 oder OSPi (ESP8266 wird unterstützt, aber nur via HTTP)
- Aktive WLAN-/Netzwerkverbindung des Controllers
Schritt 1: FYTA-Anmeldedaten hinterlegen
Die Verbindung zur FYTA-Cloud erfordert entweder einen API-Token (empfohlen) oder deine FYTA-Login-Daten (E-Mail + Passwort).
API-Token (empfohlen)
- Öffne https://web.fyta.de/api-token in deinem Browser.
- Melde dich mit deinem FYTA-Konto an.
- Kopiere den angezeigten Token.
In OpenSprinkler eintragen
- Öffne die OpenSprinkler-Weboberfläche.
- Navigiere zu Einstellungen → Sensor-Einstellungen.
- Klappe den Bereich „FYTA Setup" aus.
- Klicke auf „Setup FYTA credentials".
Der Dialog fragt die folgenden Felder ab:
Im Dialog:
| Feld | Beschreibung |
|---|---|
| API Token | Füge hier deinen Token aus web.fyta.de ein (empfohlen) |
| Alternativ: deine FYTA-Login-E-Mail | |
| Passwort | Alternativ: dein FYTA-Passwort |
Hinweis: Wenn ein API-Token eingetragen ist, werden E-Mail und Passwort ignoriert. Lasse E-Mail und Passwort leer, wenn du einen Token verwendest.
- Klicke auf „Submit" – die Zugangsdaten werden gespeichert.
Schritt 2: FYTA-Sensor anlegen
- Gehe zu Einstellungen → Sensor-Einstellungen → Neuer Sensor.
- Wähle als Typ:
- „FYTA Moisture" – für Bodenfeuchte (Einheit: %)
- „FYTA Temperature" – für Bodentemperatur (Einheit: °C oder °F je nach FYTA-Kontoeinstellung)
- Klicke auf den Button „Select FYTA plant and sensor".
OpenSprinkler verbindet sich nun mit der FYTA-Cloud und lädt deine Pflanzenliste.
Schritt 3: Pflanze auswählen
Nach dem Klick auf „Select FYTA plant and sensor" erscheint eine Liste aller Pflanzen deines FYTA-Kontos mit Vorschaubild, Spitzname und wissenschaftlichem Namen.
Es werden nur Pflanzen angezeigt, denen ein FYTA-Sensor zugeordnet ist.
- Klicke auf die gewünschte Pflanze.
- Der Name und die Pflanzen-ID werden automatisch im Sensor-Formular eingetragen.
- Passe den Sensor-Namen bei Bedarf an.
- Klicke auf Speichern.
Messwerte und Abfrage-Intervall
| Parameter | Wert |
|---|---|
| Bodenfeuchte | 0–100 % |
| Temperatur | °C oder °F (gemäß FYTA-Kontoeinstellung) |
| Abfrage-Quelle | FYTA Cloud API (HTTPS) |
| Abfrage-Intervall | Konfigurierbar im Sensor-Dialog (Empfehlung: 15–60 Minuten) |
Die Daten werden nicht direkt vom Sensor abgerufen, sondern von der FYTA-Cloud. Das Intervall sollte daher nicht zu kurz gewählt werden, um das FYTA-API-Limit nicht zu überschreiten.
Sensor in Bewässerungsprogramme integrieren
Sobald ein FYTA-Sensor angelegt ist, kann er in zwei Arten von Automatisierungen genutzt werden:
Programmanpassungen (Adjustments)
Passt die Bewässerungsdauer automatisch an den aktuellen Messwert an.
→ Einstellungen → Sensor-Einstellungen → Programmanpassungen
Beispiel: Bewässerung bei hoher Bodenfeuchte reduzieren.
Monitore (Monitors)
Startet oder stoppt ein Programm, wenn ein Schwellenwert über- oder unterschritten wird.
→ Einstellungen → Sensor-Einstellungen → Monitore
Beispiel: Bewässerung starten, wenn Bodenfeuchte unter 30 % fällt.
Mehrere FYTA-Sensoren
Du kannst für jede Pflanze/jeden Sensor-Typ einen eigenen Sensor-Eintrag anlegen:
- Pflanze A → FYTA Moisture (ID: 12345)
- Pflanze A → FYTA Temperature (ID: 12345)
- Pflanze B → FYTA Moisture (ID: 67890)
Alle Sensoren teilen dieselben Zugangsdaten (Token/Login) aus den FYTA-Einstellungen.
Fehlerbehebung
| Problem | Ursache / Lösung |
|---|---|
| Pflanzenliste leer | Keine FYTA-Zugangsdaten hinterlegt oder Token abgelaufen → Schritt 1 wiederholen |
| Kein Messwert | Pflanze hat keinen aktiven FYTA-Sensor → in der FYTA-App prüfen |
| Temperatursensor zeigt falsches °C/°F | Wird automatisch aus der FYTA-Kontoeinstellung übernommen → in der FYTA-App unter Kontoeinstellungen ändern |
| Verbindungsfehler | Netzwerkverbindung des Controllers prüfen; FYTA-API unter web.fyta.de erreichbar? |
| ESP8266: Keine HTTPS-Verbindung | ESP8266 verwendet HTTP statt HTTPS – sicherheitsbedingte Einschränkung der Plattform |
Plattform-Verfügbarkeit
| Plattform | Unterstützt | Protokoll |
|---|---|---|
| ESP32 | ✅ | HTTPS |
| ESP8266 | ✅ | HTTP (kein TLS) |
| OSPi (Linux) | ✅ | HTTPS |