From f473846a8b833b06a9a62dc90cb2548ee94f1f0c Mon Sep 17 00:00:00 2001
From: klassm <klassm@2b470e98-0d58-463d-a4d8-8e2adae1ed80>
Date: Sun, 9 Sep 2012 10:58:37 +0000
Subject: [PATCH] HOL device for presence simulation

git-svn-id: https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem@1833 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 docs/commandref.html | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/docs/commandref.html b/docs/commandref.html
index 5e3a6770b..b968348aa 100644
--- a/docs/commandref.html
+++ b/docs/commandref.html
@@ -96,6 +96,7 @@
       <a href="#FS20">FS20</a> &nbsp;
       <a href="#HMS">HMS</a> &nbsp;
       <a href="#HMLAN">HMLAN</a> &nbsp;
+      <a href="#HOL">HOL</a> &nbsp;
       <a href="#HTTPSRV">HTTPSRV</a> &nbsp;
       <a href="#IPCAM">IPCAM</a> &nbsp;
       <a href="#IPWE">IPWE</a> &nbsp;
@@ -2621,6 +2622,37 @@ A line ending with \ will be concatenated with the next one, so long lines
   </ul>
 </ul>
 
+<a name="HOL"></a>
+<h3>HOL</h3>
+<ul>
+  <tr>The HOL module attempts to simulate your presence using your FHEM devices.<br/>
+  Device support: All devices that are able to handle on-for-timer and on commands.<td>
+
+  <br /><br />
+  <a name="HOLdefine"></a>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; HOL</code><br>
+    <br>
+    To make the module find the devices you want to switch in holiday mode, 
+    you have to specify a global user attribute (attr global userattr holidaySwitchTime).
+    The attribute tells the HOL module how long each device should be switched on.
+    If you want to switch a device in your FHEM configuration, just add this attribute as device attribute
+    with your defined duration.
+    When being switched to on, the module chooses a random defined device
+    having the <i>holidaySwitchTime</i> attribute and trigger it to on-for-timer.
+    After the on-timespan, this device is switched to off and another random one triggered to on-for-timer.
+  </ul>
+  <br>
+
+  <a name="HOLset"></a>
+  <b>Set</b>
+  <ul>
+    <li>on</li>
+    <li>off</li>
+  </ul>
+</ul>
+
 
 <a name="CUL"></a>
 <h3>CUL</h3>