Geräteprofil · Verschiedenes

OpenSprinkler

Hinweis: Dieses Profil beruht auf der dokumentierten HTTP-Schnittstelle von OpenSprinkler (Firmware 2.1.9 und neuer).

Was dieses Profil abbildet

Ein nomos-Gerät ist der ganze Controller mit seinen acht Grundzonen. Das ist keine Designvorliebe, sondern folgt der Schnittstelle: OpenSprinkler meldet die Zonen als ein einziges Feld ("sn":[0,0,1,…]) und bietet keine Abfrage je Zone.

Voraussetzungen

1. Ein OpenSprinkler oder OSPi mit Firmware 2.1.9 oder neuer im lokalen Netz.
2. Das Kennwort als MD5-Hash. OpenSprinkler erwartet in der Adresse nicht das Kennwort, sondern dessen Hash:

   printf 'meinKennwort' | md5sum     # Linux
   md5 -q -s 'meinKennwort'           # macOS
   

   Für das Werkskennwort opendoor ist der Hash a6d82bced638de3def1e9bbb4983225c; er ist im Profil voreingestellt.

3. Prüfen lässt sich alles im Browser:

   http://<IP>/js?pw=<MD5-Hash>
   

   Es muss {"sn":[0,0,…],"nstations":8} zurückkommen. Kommt {"result":2}, ist der Hash falsch.

Einrichtung

1. Dem Controller im Router eine feste IP-Adresse geben
2. Skills → Add-ons: Profil importieren
3. Gerät anlegen und eintragen:
   • IP-Adresse und Port (Standard 80; OSPi-Installationen nutzen oft 8080)
   • PASSWORD_MD5 – der Hash aus dem Schritt oben
   • RUNTIME_SECONDS – wie lange eine Zone läuft, wenn sie aus nomos eingeschaltet wird (Standard 600 = 10 Minuten)

Datenbereich

Abgefragt werden alle 10 Sekunden die Zonen, jede Minute der Controller-Zustand und einmal pro Stunde die Zonennamen. Die ersten beiden Intervalle lassen sich ändern.

• Betrieb (state): der Hauptschalter des Controllers
• Es wird bewässert (active): mindestens eine der acht Zonen läuft
• Zone 1 bis 8 (station1 … station8): läuft/läuft nicht
• Regenverzögerung aktiv (raindelay) und Regensensor (rainsensor)
• Zonennamen, Anzahl der Zonen, Boards, Ende der Regenverzögerung, WLAN-Signal (ausgeblendet)
• Erreichbarkeit (reachable)

Schreibbar sind: Betrieb ein/aus, jede Zone einzeln ein- und ausschalten, alle Zonen stoppen, Regenverzögerung in Stunden setzen und beenden.

Hinweise

• Eine Zone einschalten heißt: für die eingestellte Laufzeit. OpenSprinkler kennt kein „an, bis ich sage stopp” – jeder Start braucht eine Dauer. Das Profil schickt dafür RUNTIME_SECONDS mit. Ausschalten geht jederzeit.
• Nur die ersten acht Zonen. Mit Erweiterungsmodulen hat ein Controller mehr; die zusätzlichen Zonen sind in diesem Profil nicht enthalten. Die Zahl aller Zonen steht ausgeblendet unter „Stations in total” – weicht sie von 8 ab, sehen Sie in nomos nur den ersten Block. Die ersten acht bleiben dabei korrekt.
• Programme und Zeitpläne bleiben beim Controller. Das Profil schaltet Zonen und den Betrieb, es verwaltet keine Programme. So bleibt die Bewässerungslogik dort, wo sie auch ohne nomos funktioniert.
• Die Regenverzögerung wird in Stunden gesetzt (0 beendet sie). Wie lange sie noch läuft, steht als UNIX-Zeit im ausgeblendeten Wert „Rain delay until”.
• Das Kennwort steht als Hash in der Geräteadresse. Ein MD5-Hash ist kein Schutz, sondern nur eine Verschleierung – den Controller bitte nicht aus dem Internet erreichbar machen.
• Nicht im Profil enthalten: Programme anlegen und starten, Zonennamen ändern, Wetteranpassung, Durchflusssensor, Master-Zonen und die Protokolldaten.