SUNRISE_EL update to new functionallity. Added CIVIL, NAUTIC, ASTRONOMIC,

REAL and HORIZON parameter


git-svn-id: https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem@1857 2b470e98-0d58-463d-a4d8-8e2adae1ed80

docs/commandref.html

@@ -11050,7 +11050,7 @@ isday</pre>
   values, which should be in the form of a floating point value).  The default
   value is Frankfurt am Main, Germany.
   <br><br>
-  The default altitude ($altit in SUNRISE_EL.pm) defines the sunrise/sunset
+  The default altitude ($defaultaltit in SUNRISE_EL.pm) defines the sunrise/sunset
   for Civil twilight (i.e. one can no longer read outside without artificial
   illumination), which differs from sunrise/sunset times found on different
   websites.  See perldoc "DateTime::Event::Sunrise" for alternatives.
@@ -11071,11 +11071,31 @@ isday</pre>
     <li>The second and third specify min and max values (format: "HH:MM").
   </ul>
   <br>
-
   isday() can be used in some notify or at commands to check if the sun is up or
-  down.
+  down.<br><br>
-  <br><br>
 
+  Optionally, for all functions you can set first argument which defines a horizon value
+  which then is used instead of the $defaultaltit in SUNRISE_EL.pm.<br>
+  Possible values are: "REAL", "CIVIL", "NAUTIC", "ASTRONOMIC" or a 
+  positive or negative number preceded by "HORIZON"<br>
+  REAL is 0, CIVIL is -6, NATUIC is -12, ASTRONOMIC is -18 degrees above horizon.<br><br>
+  Example:<br>
+  <ul>
+  <PRE>
+    # When sun is 6 degrees below horizon - same as sunrise();
+    sunrise("CIVIL");
+
+    # When sun is 3 degrees below (-3 above) horizon (Between real and civil sunset)
+    sunset("HORIZON -3");
+
+    # When sun is 1 degree above horizon
+    sunset("HORIZON 1");
+
+    # Switch lamp1 on at real sunset, not before 18:00 and not after 21:00
+    define a15 at *{sunset("REAL",0,"18:00","21:00")} set lamp1 on
+  </PRE>
+  </ul>
+  
   <b>Define</b> <ul>N/A</ul><br>
 
   <b>Set</b> <ul>N/A</ul><br>