*** empty log message ***

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

docs/commandref.html

@@ -73,6 +73,7 @@
       <a href="#structure">structure</a> &nbsp;
       <a href="#WS2000">WS2000</a> &nbsp;
       <a href="#WS300">WS300</a> &nbsp;
+      <a href="#Weather">Weather</a> &nbsp;
       <a href="#X10">X10</a> &nbsp;
       <a href="#FHEMRENDERER">FHEMRENDERER</a> &nbsp;
 
@@ -2186,6 +2187,84 @@ A line ending with \ will be concatenated with the next one, so long lines
 </ul>
 
 
+<a name="Weather"></a>
+<h3>Weather</h3>
+<ul>
+  <br>
+
+  <a name="Weather"></a>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; Weather &lt;location&gt; [&lt;interval&gt;]</code><br>
+    <br>
+    Defines a virtual device for weather forecasts. You need to have the perl
+    module Weather::Google installed to use this device. If you do not have it,
+    use <i>cpan -i Weather::Google</i> to install it.<br><br>
+
+    A Weather device periodically gathers current and forecast weather conditions
+    from the Google Weather API.<br><br>
+
+    The parameter <code>location</code> is any string that is recognized as a
+    location, either a town name or a zip code. Browse to the URL
+    <code>http://www.google.de/ig/api?weather=location&hl=en</code>
+    to see the raw output for your location.<br><br>
+
+    The parameter <code>interval</code> is the time between subsequent updates
+    in seconds. It defaults to 3600 (1 hour).<br><br>
+
+    Examples:
+    <pre>
+      define MyWeather Weather "Frankfurt,HE"
+      define Forecast Weather "Amsterdam,NL" 1800
+      define weather Weather "30000,France"
+    </pre>
+  </ul>
+  <br>
+
+  <a name="Weatherset"></a>
+  <b>Set </b>
+  <ul>
+    N/A
+  </ul>
+  <br>
+
+
+  <a name="Weatherget"></a>
+  <b>Get</b>
+  <ul>
+    <code>get &lt;name&gt; &lt;reading&gt;</code><br><br>
+
+    Valid readings and their meaning (? can be one of 0, 1, 2, 3 and stands
+    for today, tomorrow, ...):<br>
+    <table>
+	<tr><td>city</td><td>name of town returned for location</td></tr>
+	<tr><td>condition</td><td>current condition, one of Sunny, Clear, Partly Cloudy, Mostly Cloudy, Overcast, Chance of Rain</td></tr>
+	<tr><td>current_date_time</td><td>last update of forecast on server</td></tr>
+	<tr><td>fc?_condition</td><td>forecast condition</td></tr>
+	<tr><td>fc?_day_of_week</td><td>day of week for day +?</td></tr>
+	<tr><td>fc?_high_c</td><td>forecasted daily high in degrees centigrade</td></tr>
+	<tr><td>fc?_icon</td><td>relative path for forecast icon, prefix with <code>http://www.google.com</code> to form a valid URL for display in web interfaces</td></tr>
+	<tr><td>fc?_low_c</td><td>forecasted daily low in degrees centigrade</td></tr>
+	<tr><td>humidity</td><td>current humidity</td></tr>
+	<tr><td>icon</td><td>relative path for current icon</td></tr>
+	<tr><td>postal_code</td><td>location sent to server</td></tr>
+	<tr><td>temp_c</td><td>current temperature in degrees centigrade</td></tr>
+	<tr><td>temp_f</td><td>current temperature in degrees Fahrenheit</td></tr>
+	<tr><td>wind_condition</td><td>wind direction and speed</td></tr>
+    </table>
+
+  </ul>
+  <br>
+
+  <b>Attributes</b>
+  <ul>
+    N/A
+  </ul>
+  <br>
+</ul>
+
+
+
 <a name="SCIVT"></a>
 <h3>SCIVT</h3>
 <ul>
@@ -2297,7 +2376,8 @@ A line ending with \ will be concatenated with the next one, so long lines
     <code>get &lt;name&gt; counter</code>
     <br><br>
     Gets the number of ticks of the counter since the last reset. The counter
-    wraps around from 65535 to 0.
+    wraps around from 65,535 to 0 and <i>then stops</i>.
+    See <a href="#M232Counter">M232Counter</a> for how we care about this.
     <br><br>
   </ul>
 
@@ -2348,7 +2428,11 @@ A line ending with \ will be concatenated with the next one, so long lines
     <br>
     Do not forget to start the counter (with <code>set .. start</code> for
     M232) or to start the counter and set the reading to a specified value
-    (with <code>set ... value</code> for M232Counter).  <br><br>
+    (with <code>set ... value</code> for M232Counter).<br><br>
+    To avoid issues with the tick count reaching the end point, the device's
+    internal counter is automatically reset to 0 when the tick count is 64,000
+    or above and the reading <i>basis</i> is adjusted accordingly.
+    <br><br>
   </ul>
 
   <a name="M232Counterset"></a>
@@ -2449,7 +2533,7 @@ A line ending with \ will be concatenated with the next one, so long lines
 
     The structure device is used to organize/structure a devices in order to
     set groups of them at once (e.g. switching everything off in a house).<br>
-    
+
     The list of attached devices can be modified through the addstruct /
     delstruct commands. Each attached device will get the attribute
     &lt;struct_type&gt;=&lt;name&gt;<br> when it is added to the list, and the
@@ -2951,7 +3035,7 @@ A line ending with \ will be concatenated with the next one, so long lines
       <li>3<br>
           Month dependent date. Arguments: &lt;nth&gt; &lt;weekday&gt;
           &lt;month &lt;holiday-name&gt;.<br>
-          Examples:<br> 
+          Examples:<br>
           <ul>
             3  1 Mon 05 First Monday In May<br>
             3  2 Mon 05 Second Monday In May<br>
@@ -2962,7 +3046,7 @@ A line ending with \ will be concatenated with the next one, so long lines
       <li>4<br>
           Interval. Arguments: &lt;MM-DD&gt; &lt;MM-DD&gt; &lt;holiday-name&gt;
           .<br>
-          Example:<br> 
+          Example:<br>
           <ul>
             4 01-06 31-06 Summer holiday<br>
           </ul>
@@ -3611,7 +3695,7 @@ isday, sunrise_coord</pre>
      $month is in the range of 1 to 12, and $year is also corrected by 1900 (as
      one would normally expect). Additionally $we is 1 if it is weekend (i.e
      $wday == 0 || $wday == 6), and 0 otherwise. If the <a
-     href="#holiday2we>holida2we</a> global attribute is set, $we is 1 for
+     href="#holiday2we">holida2we</a> global attribute is set, $we is 1 for
      holidays too.
      Example: