Quelltext betrachten

= Z-Wave Dämmerungsschalter - Astronomische Dämmerung online - Berechneter Sonnenuntergang<br>  =

== Einleitung<br>  ==

Aufgesetzt auf einem Raspberry mit dem "Z-Wave.Me RaZberry"-Modul (razberry.z-wave.me) wollte ich gern einen Dämmerungsschalter über eine Astro-Funktion realisieren.<br> 

<br> 

== Vorgehensweise<br>  ==

- Preference -&gt; Modules -&gt; Devices -&gt; HTTPDevice hinzufügen<br> 

<br> 

Hier sind folgende Einstellungen vorzunehmen:<br> 

Typ: sensorBinary<br> 

URL: http://ebs-gera.de/prog/astrouhr_json.php?latitude=50.11111&amp;longitude=12.11111&amp;offset=0<br> 

Inline Javascript: JSON.parse($$).is_dark<br> 

Intervall: 60<br> 

HTTP-method: GET<br> 

<br> 

== Beschreibung<br>  ==

Für Latitude und Longitude müsst ihr euren Standort eingeben. Am Besten zu maps.google.de gehen, den Standort eingeben und dann oben in der Adresszeile die Parameter herauslesen. 

Kurz zur Erklärung: Ein PHP-Skript auf meinem Webserver berechnet anhand der übergebenen Werte zum ungefähren Standort den Sonnenaufgang und den Sonnenuntergang. Diese Werte werden im sogenannten JSON-Format zurückgegeben. Dieses Format ist einfach auswertbar und besitzt nicht so viel Overhead wie z.B. XML.<br> 

Zurückgegebener String:'''{ "status": "ok", "now": "11:37", "sunrise": "04:57", "sunset": "21:25", "is_dark": "off", "offset": "60" } '''<br> 

<br> 

Der Parameter "is_dark" wechselt dabei (hier um 21:25) von "off" auf "on" und 04:57 wieder zurück. 

<br> 

== Offset - Parameter<br>  ==

Der Offset-Parameter kann bei Bedarf mit übergeben werden, ist aber nicht zwingend notwendig. Er wird in Minuten angegeben und zu der Sunrise-Zeit (Aufgang) hinzuaddiert und von der Sunset (Untergang) - Zeit subtrahiert.<br> 

So verschiebt ein positiver offset-Parameter die Kurve in Richtung Helligkeit und ein negativer Parameter in Richtung Dunkelheit.<br> 

<br> 

== Fehlermeldungen<br>  ==

Sollte ein Parameter fehlen oder im falschen Format angegeben sein, so wird ein Fehler als JSON-Objekt ausgegeben:<br> 

'''{ "status"&nbsp;: "error", "desc": "bitte Parameter übergeben Beispiel:&nbsp;?latitude=50.1111&amp;longitude=10.5555"}'''<br> 

oder<br> 

'''{ "status"&nbsp;: "error", "desc": "Das Offset muss numerisch sein."}'''<br> 

Bitte gebt statt Komma einen Punkt ein. 

<br> 

== Verwendung<br>  ==

Ihr könnt diese "Schnittstelle" ruhig mit verwenden, der Server hält größere Lasten aus. Außerdem werde ich das Script so belassen und nicht ändern, ihr könnt also eure Lösungen damit implementieren, denn ich benutze diese selbst in mehreren Lösungen. 

[[Category:Z-Wave]] [[Category:Z-Way]] [[Category:RaZBerry]] [[Category:AJAX]] [[Category:Javascript]] [[Category:PHP]] [[Category:Snippet]]