From bc2def48ad5e4821c8554d5f69a1370eef35421c Mon Sep 17 00:00:00 2001
From: icinger <icinger@2b470e98-0d58-463d-a4d8-8e2adae1ed80>
Date: Sun, 17 Jan 2016 08:50:11 +0000
Subject: [PATCH] =?UTF-8?q?45=5FPlugwise:Deutsche=20commandref=20hinzugef?=
 =?UTF-8?q?=C3=BCgt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

git-svn-id: svn://svn.code.sf.net/p/fhem/code/trunk@10549 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 fhem/FHEM/45_Plugwise.pm  | 73 +++++++++++++++++++++++++++++++++++++++
 fhem/FHEM/46_PW_Circle.pm | 68 ++++++++++++++++++++++++++++++++++++
 fhem/FHEM/46_PW_Scan.pm   | 25 ++++++++++++++
 fhem/FHEM/46_PW_Sense.pm  | 25 ++++++++++++++
 fhem/FHEM/46_PW_Switch.pm | 59 +++++++++++++++++++++++++++++++
 5 files changed, 250 insertions(+)

diff --git a/fhem/FHEM/45_Plugwise.pm b/fhem/FHEM/45_Plugwise.pm
index 902f88efe..371fc3cb6 100755
--- a/fhem/FHEM/45_Plugwise.pm
+++ b/fhem/FHEM/45_Plugwise.pm
@@ -1352,6 +1352,7 @@ sub _pulsecorrection {
 "Cogito, ergo sum.";
 
 =pod
+=item device
 =begin html
 
 <a name="Plugwise"></a>
@@ -1422,6 +1423,78 @@ sub _pulsecorrection {
   <br>
 </ul>
 
+=end html
+
+=begin html_DE
+
+<a name="Plugwise"></a>
+<h3>Plugwise</h3>
+<ul>
+  Modul für das Plugwise-System.
+  <br>
+  Achtung: Dieses Modul benötigt folgende Perl-Module:
+  <ul><li>Device::SerialPort oder Win32::SerialPort</li>
+  <li>digest:CRC</li></ul>
+  <br><br>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; Plugwise &lt;device&gt; </code><br>
+  </ul>
+    <br>
+      &lt;device&gt; Gibt den COM-Port des Plugwise-Stick an.
+      Unter Linux ist dies im Normalfall /dev/ttyUSBx, wobei x eine fortlaufende Nummer ist. (zB /dev/ttyUSB0)
+      Wobei es unter Linux sinnvoller ist, den Port mittels UDEV-Regeln oder mittels /dev/by-id/ anzugeben.
+      Der Plugwise-Stick läuft fix auf 115200 Baud<br>
+      <br>
+      Beispiel: <br>
+    <code>define myPlugwise Plugwise /dev/ttyPlugwise</code>
+      <br>
+     </ul>
+    <br>
+ 
+  <a name="PLUGWISEset"></a>
+  <b>Set</b>
+  <ul>
+    <code>Scan_Circles</code>
+    <ul>
+        Startet eine Suche nach neuen Geräten und legt diese per Autocreate an.
+    </ul><br><br>
+    <code>syncTime</code>
+    <ul>
+        Syncronisiert die internen RTCs der Geräte mit der aktuellen Systemzeit.
+    </ul><br><br>
+    <code>reOpen</code>
+    <ul>
+        Öffnet den COM-Port neu (zB bei zu vielen Fehlern, nach deren Behebung)
+    </ul><br><br>
+  </ul>
+  <br><br>
+
+  <b>Attribute</b>
+  <ul>
+    <code>circlecount</code><br>
+    <ul>
+      Maximale Anzahl der Geräte, nach denengesucht wird.
+      <br><br>
+      </ul>
+   <code>interval</code><br>
+      <ul>Standard-Abfrageintervall der Circles
+      </ul><br><br>
+   <code>autosync</code><br>
+      <ul>Sendet alle >n< Sekunden ein "syncTime" an alle Geräte
+      </ul><br><br>
+   <code>WattFormat</code><br>
+      <ul>String, mit welchem die Power-Readings formatiert werden 
+      Standard: %0.f
+      </ul><br><br>
+   <code>showCom</code><br>
+      <ul>Schreibt die gesamte Kommunikation (gefiltern nach >regEx<) in das Reading "communication"
+      (Am besten mit FileLog oder dem Eventmonitor anzusehen)
+      </ul><br><br>      
+  
+  <br>
+</ul>
+
 =end html
 =cut
 
diff --git a/fhem/FHEM/46_PW_Circle.pm b/fhem/FHEM/46_PW_Circle.pm
index 73df16778..13ba074f2 100755
--- a/fhem/FHEM/46_PW_Circle.pm
+++ b/fhem/FHEM/46_PW_Circle.pm
@@ -273,6 +273,7 @@ if ($msg->{type} eq "err") {return undef};
 "Cogito, ergo sum.";
 
 =pod
+=item device
 =begin html
 
 <a name="PW_Circle"></a>
@@ -338,6 +339,73 @@ See <a href="#Plugwise">Plugwise</a>.
   <br>
 </ul>
 
+=end html
+
+=begin html_DE
+
+<a name="PW_Circle"></a>
+<h3>PW_Circles</h3>
+<ul>
+  Das PW_Circles Modul setzt auf das Plugwise-System auf. Es muss zuerst ein Plugwise-Stick angelegt werden. 
+  Siehe <a href="#Plugwise">Plugwise</a>.
+  <br>
+  <a name="PW_Circle define"></a>
+  <br>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; PW_Circle &lt;ShortAddress&gt;</code> <br>
+    <br>
+    <code>&lt;ShortAddress&gt;</code>
+    <ul>
+      gibt die Kurzadresse (die letzten 4 Bytes) des Circles an. <br>
+    </ul>
+  <br><br>    
+  </ul>
+  <b>Set</b>
+  <ul>
+    <code>on / off</code> <br>
+    <ul>
+      Schaltet den Circle ein oder aus<br><br>
+    </ul>
+    <code>on-for-timer / off-for-timer sec</code> <br>
+    <ul>
+      Schaltet den Circle für n Sekunden an oder aus<br><br>
+    </ul>
+    <code>syncTime</code> <br>
+    <ul>
+      Synchronisiert die interne Uhr des Circles mit der lokalen Systemzeit<br><br>
+    </ul>
+    <code>removeNode</code> <br>
+    <ul>
+      Entfernt den Circle aus dem Plugwise-Netzwerk<br><br>
+    </ul>
+    <code>ping</code> <br>
+    <ul>
+      Sendet ein Ping an den Circle und setzt das Reading "ping" im Format "q_in - q_out - pingZeit"<br><br>
+    </ul>
+    <code>status</code> <br>
+    <ul>
+      Liest den aktuellen Status des Circles aus<br><br>
+    </ul>
+    </ul>
+    
+  <br><br>
+  
+  <b>Attribute</b>
+  <ul>
+    <code>interval</code> <br>
+    <ul>
+      Setzt das Abruf-Intervall speziell für diesen einen Circle<br>
+    </ul>
+    </ul>
+    <br><br>
+      <b>Beispiel</b> <br>
+    	<ul><code>define Circle_2907CC9 PW_Circle 2907CC9</code></ul>
+      <br>
+  
+  <br>
+</ul>
+
 =end html
 =cut
 
diff --git a/fhem/FHEM/46_PW_Scan.pm b/fhem/FHEM/46_PW_Scan.pm
index e7db4b271..e99d1f452 100755
--- a/fhem/FHEM/46_PW_Scan.pm
+++ b/fhem/FHEM/46_PW_Scan.pm
@@ -144,6 +144,7 @@ sub PW_Scan_Parse($$)
 "Cogito, ergo sum.";
 
 =pod
+=item device
 =begin html
 
 <a name="PW_Scan"></a>
@@ -170,6 +171,30 @@ See <a href="#PW_Scan">PW_Scan</a>.
   <br>
 </ul>
 
+=end html
+
+=begin html_DE
+
+<a name="PW_Scan"></a>
+<h3>PW_Scan</h3>
+<ul>
+  Das PW_Scan Modul setzt auf das Plugwise-System auf. Es muss zuerst ein Plugwise-Stick angelegt werden. 
+  Siehe <a href="#Plugwise">Plugwise</a>.
+  <br>
+  <a name="PW_Scan define"></a>
+  <br>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; PW_Scan &lt;ShortAddress&gt;</code> <br>
+    <br>
+    <code>&lt;ShortAddress&gt;</code>
+    <ul>
+      gibt die Kurzadresse (die letzten 4 Bytes) des Gerätes an. <br>
+    </ul>
+  <br><br>    
+  </ul>
+</ul>
+
 =end html
 =cut
 
diff --git a/fhem/FHEM/46_PW_Sense.pm b/fhem/FHEM/46_PW_Sense.pm
index 7ce36e8fd..a0171ffac 100755
--- a/fhem/FHEM/46_PW_Sense.pm
+++ b/fhem/FHEM/46_PW_Sense.pm
@@ -146,6 +146,7 @@ sub PW_Sense_Parse($$)
 "Cogito, ergo sum.";
 
 =pod
+=item device
 =begin html
 
 <a name="PW_Sense"></a>
@@ -172,6 +173,30 @@ See <a href="#PW_Sense">PW_Sense</a>.
   <br>
 </ul>
 
+=end html
+
+=begin html_DE
+
+<a name="PW_Sense"></a>
+<h3>PW_Sense</h3>
+<ul>
+  Das PW_Sense Modul setzt auf das Plugwise-System auf. Es muss zuerst ein Plugwise-Stick angelegt werden. 
+  Siehe <a href="#Plugwise">Plugwise</a>.
+  <br>
+  <a name="PW_Sense define"></a>
+  <br>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; PW_Sense &lt;ShortAddress&gt;</code> <br>
+    <br>
+    <code>&lt;ShortAddress&gt;</code>
+    <ul>
+      gibt die Kurzadresse (die letzten 4 Bytes) des Gerätes an. <br>
+    </ul>
+  <br><br>    
+  </ul>
+</ul>
+
 =end html
 =cut
 
diff --git a/fhem/FHEM/46_PW_Switch.pm b/fhem/FHEM/46_PW_Switch.pm
index 3cdb9029e..6c1fa7453 100755
--- a/fhem/FHEM/46_PW_Switch.pm
+++ b/fhem/FHEM/46_PW_Switch.pm
@@ -155,6 +155,7 @@ sub PW_Switch_Parse($$)
 "Cogito, ergo sum.";
 
 =pod
+=item device
 =begin html
 
 <a name="PW_Switch"></a>
@@ -178,6 +179,64 @@ See <a href="#PW_Switch">PW_Switch</a>.
     	<code>define PW_Switch_2907CC9 PW_Switch 2907CC9</code>
       <br>
   </ul>
+  <b>Set</b>
+  <ul>
+    <code>syncTime</code> <br>
+    <ul>
+      Syncronises the internal clock of the Circle with your PC's clock<br><br>
+    </ul>
+    <code>removeNode</code> <br>
+    <ul>
+      Removes this device from your Plugwise-network<br><br>
+    </ul>
+    <code>ping</code> <br>
+    <ul>
+      Ping the circle and write the Ping-Runtime to reading "ping" in format "q_in - q_out - pingTime"<br><br>
+    </ul>
+    </ul>
+  <br>
+</ul>
+
+=end html
+
+=begin html_DE
+
+<a name="PW_Switch"></a>
+<h3>PW_Switch</h3>
+<ul>
+  Das PW_Switch Module basiert auf dem Plugwise-System. Es muss zuerst ein Plugwise-Stick angelegt werden. 
+Siehe <a href="#PW_Switch">PW_Switch</a>.
+  <br>
+  <a name="PW_Switch define"></a>
+  <br>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; PW_Switch &lt;ShortAddress&gt;</code> <br>
+    <br>
+    <code>&lt;ShortAddress&gt;</code>
+    <ul>
+      gibt die Kurzadresse (die letzten 4 Bytes) des Circles an. <br>
+    </ul>
+    <br>
+      Beispiel: <br>
+    	<code>define PW_Switch_2907CC9 PW_Switch 2907CC9</code>
+      <br>
+  </ul><br>
+    <b>Set</b>
+  <ul>
+    <code>syncTime</code> <br>
+    <ul>
+      Synchronisiert die interne Uhr des Circles mit der lokalen Systemzeit<br><br>
+    </ul>
+    <code>removeNode</code> <br>
+    <ul>
+      Entfernt den Circle aus dem Plugwise-Netzwerk<br><br>
+    </ul>
+    <code>ping</code> <br>
+    <ul>
+      Sendet ein Ping an den Circle und setzt das Reading "ping" im Format "q_in - q_out - pingZeit"<br><br>
+    </ul>
+    </ul>
   <br>
 </ul>