Rain Bird Smart-Home-Integration, kostenlos und Open Source
Rain-Bird-Bewässerungssteuerungen (LNK-WLAN), lokal: Zonen, Regensensor, Regenpause, Programme.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Verfolge und steuere dein Rain-Bird-Bewässerungssteuergerät von Gladys aus, über dein lokales Netzwerk: Sieh, welche Zone bewässert, ob der Regensensor Regen erkennt und ob eine Regenpause den Zeitplan anhält; bewässere eine Zone ein paar Minuten, stoppe alles, starte ein Programm oder pausiere den Zeitplan für die angekündigten Regentage. Kein Rain-Bird-Konto, keine Cloud: Gladys spricht direkt mit dem WLAN-Modul des Steuergeräts.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde aus dem Protokoll der freien Bibliothek pyrainbird und den Antworten echter Steuergeräte gebaut, die in deren Tests und in denen von Home Assistant aufgezeichnet sind, nicht an einem echten Steuergerät. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.
Diese Integration ist weder mit der Rain Bird Corporation verbunden noch von ihr unterstützt.
Was du brauchst
- Gladys Assistant 5.2.0 oder neuer.
- Ein Rain-Bird-Steuergerät mit LNK- oder LNK2-WLAN-Modul (ESP-TM2, ESP-Me, ESP-ME3, ESP-RZXe, ST8x-WiFi, ARC8, TRU…), bereits mit der Rain-Bird-App eingerichtet und mit deinem WLAN verbunden.
- Die IP-Adresse des Moduls in deinem Netzwerk: Such sie in der Geräteliste deines Routers. Gib ihm eine feste Adresse (DHCP-Reservierung), damit sie sich nicht ändert.
- Das Passwort des Steuergeräts, das du in der Rain-Bird-App beim Einrichten des Moduls gewählt hast. Es verschlüsselt jeden Austausch mit dem Modul.
Das Modul bedient nur einen Client gleichzeitig und antwortet langsam. Während Gladys es liest (standardmäßig ein paar Sekunden pro Minute), muss die Rain-Bird-App eventuell warten oder zeigt einen Fehler: Versuch es einen Moment später noch einmal, oder wähle ein längeres Leseintervall.
Einrichtung
- Installiere die Integration aus dem Gladys-Katalog.
- Gib unter Konfiguration die Adresse des Moduls ein (zum Beispiel
192.168.1.20), sein Modul-Passwort und, wenn du willst, einen Namen. Zwei oder drei Steuergeräte? Fülle auch die Abschnitte Zweites Steuergerät und Drittes Steuergerät aus. - Wähle die Optionen: Bewässerung per Zonenschalter (min) (standardmäßig 10), das Leseintervall (standardmäßig 1 Minute, 2 oder 5 Minuten lassen das Modul freier für die App) und die Sprache der Funktionsnamen.
- Speichere, dann klicke auf Verbindung testen: Die Meldung unter der Schaltfläche nennt für jedes Steuergerät sein Modell, seine Zonen, was bewässert, den Regensensor und die Regenpause.
- Öffne den Reiter Entdecken: ein Gerät pro Steuergerät. Klicke auf Zu Gladys hinzufügen, wähle einen Raum, speichere.
Die Adresse kann auch https://192.168.1.20 oder http://192.168.1.20 lauten:
Ohne Präfix versucht die Integration zuerst HTTPS (die neueren LNK2-Firmwares,
mit ihrem selbstsignierten Zertifikat), dann HTTP (die älteren), und behält das,
was antwortet.
Das Gerät jedes Steuergeräts
Das Gerät trägt den Namen aus der Konfiguration, oder „Rain Bird“ gefolgt vom Modell. Es wird über die MAC-Adresse seines WLAN-Moduls erkannt: Eine neue IP-Adresse des Steuergeräts behält das Gerät und seinen Verlauf.
| Funktion | Was sie tut |
|---|---|
| Zone 1, Zone 2… (eine pro angeschlossener Zone) | Ein Schalter, an, solange die Zone bewässert. Einschalten bewässert die Zone für die Minuten der Konfiguration (das Steuergerät stoppt sie selbst); Ausschalten stoppt die Bewässerung aller Zonen: Das Steuergerät hat keinen Befehl „nur diese Zone stoppen“. |
| Regensensor | An (1), wenn der am Steuergerät angeschlossene Regensensor Regen erkennt. Bleibt ohne Sensor aus. Fehlt, wenn das Steuergerät diese Abfrage ablehnt. |
| Regenpause | Die Tage, die der Zeitplan pausiert (0: keine). Ein Schieberegler von 0 bis 14 Tagen (30 bei den Modellen BAT-PRO und LX): Ihn zu bewegen stellt die Pause am Steuergerät ein. |
| Online | An, solange das Steuergerät antwortet; aus nach zwei Abfragen in Folge ohne Antwort. |
| Bewässerung stoppen | Eine Taste: stoppt alle Zonen. |
| Programm A starten, Programm B starten… | Eine Taste pro Programm des Modells (höchstens A bis H; keine beim ESP-RZXe und ST8x-WiFi, die jede Zone einzeln planen): startet das Programm jetzt, wie zu seiner Startzeit. |
Rain Bird benennt die Zonen in seiner App, in der Cloud: Die Integration liest diese Namen nicht. Benenne die Funktionen in Gladys um (Geräteeinstellungen), zum Beispiel in „Rasen“ oder „Gemüsegarten“.
Die Funktionen werden in der Sprache der Funktionsnamen der Konfiguration angelegt (standardmäßig Französisch) und behalten danach ihren Namen.
Dashboard
Das Widget Rain Bird zeigt ein Steuergerät (das in seinen Einstellungen gewählte, oder das erste der Konfiguration):
- die Zonen, die bewässernden zuerst, mit einem Abzeichen Bewässert oder Inaktiv (höchstens 8; die Zahl der übrigen steht darunter);
- den Regensensor, die Regenpause, und die Verbindung, wenn das Steuergerät nicht antwortet;
- vier Schaltflächen: Bewässern… (Zone und Minuten wählen), Stoppen (alle Zonen; ein Häkchen, wenn nichts bewässert), Programm… (Programm wählen; fehlt, wenn das Modell keins hat) und Regenpause… (Tage wählen, 0 hebt die Pause auf).
Szenen
Auslöser
- Rain-Bird-Bewässerung gestartet: Eine Zone beginnt zu bewässern. Filter: das Steuergerät, die Zone, und Gestartet durch: Das Steuergerät (Zeitplan, App) oder Gladys. Weitergegebene Informationen: die Zone, wer sie gestartet hat, der Name des Steuergeräts.
- Rain-Bird-Bewässerung beendet: Eine Zone hört auf zu bewässern. Dieselben Filter. Weitergegebene Informationen: die Zone, die von Gladys gesehenen bewässerten Minuten (auf das Leseintervall genau; leer, wenn die Bewässerung vor der Integration begann), wer sie gestartet hat, der Name des Steuergeräts.
Eine Bewässerung wird bei der nächsten Abfrage gesehen: Bei einem Intervall von einer Minute erscheint ein Beginn oder ein Ende innerhalb einer Minute. Der Schalter einer Zone liefert den Szenen bereits „Zone an/aus“; diese Auslöser fügen hinzu, wer sie gestartet hat, wie lange sie bewässert hat, und einen einzigen Auslöser für alle Zonen.
Aktionen
- Rain-Bird-Zone bewässern: ein Steuergerät, eine Zonennummer, eine Dauer in Minuten (standardmäßig 10). Das Steuergerät stoppt die Zone selbst.
- Rain-Bird-Bewässerung stoppen: alle Zonen eines Steuergeräts, oder aller, wenn das Steuergerät leer bleibt.
- Rain-Bird-Programm starten: ein Steuergerät und ein Programm (A bis H).
- Rain-Bird-Regenpause einstellen: ein Steuergerät und eine Anzahl Tage (0 hebt die Pause auf; begrenzt auf das Limit des Modells).
Szenen-Ideen
- Regen angesagt: Wenn die Wettervorhersage Regen für morgen ankündigt, Rain-Bird-Regenpause einstellen auf 2 Tage.
- Jemand im Garten: Wenn das Gartentor aufgeht, Rain-Bird-Bewässerung stoppen.
- Bewässerungsbericht: Bei Rain-Bird-Bewässerung beendet, gestartet durch Das Steuergerät, die Nachricht „Zone {zone} bewässert {minutes} min“ senden.
- Aussaat: Bei Hitzewelle jeden Tag um 14 Uhr Rain-Bird-Zone bewässern: die Gemüsegarten-Zone für 5 Minuten.
Fehlerbehebung
- „antwortet nicht“: Prüfe die Adresse (sie kann sich geändert haben: Gib dem Modul eine feste Adresse in deinem Router), ob das Steuergerät Strom hat und ob die WLAN-Anzeige des Moduls leuchtet. Gladys muss das Netzwerk des Moduls erreichen können.
- „Passwort abgelehnt (oder kein Rain-Bird-Modul)“: Gib das Passwort des Steuergeräts erneut ein (das der Rain-Bird-App, Groß- und Kleinschreibung beachten). Prüfe auch, ob die Adresse die des Rain-Bird-Moduls ist. Nach einem abgelehnten Passwort versucht die Integration es nur alle 10 Minuten erneut (das Modul kann wiederholte Versuche sperren); die Konfiguration zu speichern versucht es sofort.
- „mit einem anderen Client beschäftigt“: Die Rain-Bird-App (oder eine andere Hausautomation) sprach gerade mit dem Modul. Die Integration versucht es ein paar Mal, dann bei der nächsten Abfrage. Zwei Systeme, die das Modul jede Minute lesen, stören sich ständig: Behalte nur eins.
- Die Rain-Bird-App kann sich nicht verbinden: Das Modul ist ein paar Sekunden mit Gladys beschäftigt; versuch es noch einmal, oder wähle ein Leseintervall von 2 oder 5 Minuten.
- Der Schalter einer Zone springt zurück: Das Steuergerät hat den Befehl abgelehnt oder ignoriert. Die Integration liest das Steuergerät fünf Sekunden nach jedem Befehl erneut und zeigt, was es wirklich tut.
- Eine neue Zone fehlt: Klicke im Reiter Entdecken auf Scannen (oder auf Verbindung testen), dann Aktualisieren beim Gerät.
- Mehr Details: Starte die Integration mit
LOG_LEVEL=debug, um jede Abfrage in ihren Protokollen zu sehen. Passwörter und WLAN-Einstellungen erscheinen dort nie.
Grenzen
- Ohne die Hardware entwickelt: Rückmeldungen willkommen. Getestet mit den aufgezeichneten Antworten echter Steuergeräte, nicht mit einem echten Steuergerät.
- Nur im lokalen Netzwerk, über ein LNK- oder LNK2-WLAN-Modul: Ein Steuergerät ohne ein solches (nur Bluetooth, oder nur Cloud) ist so nicht erreichbar.
- Die Integration liest das Steuergerät höchstens einmal pro Minute (das Modul bedient nur einen Client gleichzeitig): Eine am Steuergerät gestartete Bewässerung erscheint innerhalb des Leseintervalls.
- Keine Zonennamen (sie liegen in der Rain-Bird-Cloud) und keine Änderung des Zeitplans.
- Eine Zone auszuschalten stoppt alle Zonen (der einzige Stoppbefehl des Steuergeräts). Eine Zone starten, während eine andere bewässert: Je nach Modell stoppt das Steuergerät die erste oder reiht die neue ein.
- Dauern von 1 bis 240 Minuten (weniger, wenn das Limit des Modells niedriger ist).
Konfigurationseinstellungen
Diese Einstellungen fragt Rain Bird in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Rain-Bird-Steuergerät | section | Nein | Ein Steuergerät mit LNK- oder LNK2-WLAN-Modul, eingerichtet mit der Rain-Bird-App. Das Modul bedient nur einen Client gleichzeitig: Die App muss eventuell warten, während Gladys es liest. |
| Adresse | string | Ja | IP-Adresse des WLAN-Moduls in deinem Netzwerk (siehe Router; am besten eine feste Adresse). |
| Modul-Passwort | secret | Ja | Das Passwort des Steuergeräts aus der Rain-Bird-App, das jeden Austausch verschlüsselt. |
| Name | string | Nein | Name des Geräts in Gladys. Leer: „Rain Bird“ gefolgt vom Modell. |
| Zweites Steuergerät (optional) | section | Nein | Dieselben Felder, für ein weiteres Rain-Bird-Steuergerät in deinem Netzwerk. |
| Adresse | string | Nein | |
| Modul-Passwort | secret | Nein | |
| Name | string | Nein | |
| Drittes Steuergerät (optional) | section | Nein | Dieselben Felder, für ein drittes Rain-Bird-Steuergerät. |
| Adresse | string | Nein | |
| Modul-Passwort | secret | Nein | |
| Name | string | Nein | |
| Optionen | section | Nein | |
| Bewässerung per Zonenschalter (min) | number | Nein | So lange bewässert eine in Gladys eingeschaltete Zone; das Steuergerät stoppt sie selbst. |
| Leseintervall | select | Nein | Wie oft die Steuergeräte gelesen werden. Länger lässt das Modul für die Rain-Bird-App frei. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen, wenn das Gerät zu Gladys hinzugefügt wird, und Meldungen. |
So installierst du Rain Bird in Gladys
- Öffne in Gladys Integrationen: Rain Bird erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-rainbird:1.0.1) 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/guim31/gladys-rainbird.
Rain Bird benötigt Gladys >=5.2.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
Rain Bird 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 guim31 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