From 7afc28163d85d955db83d370ed902302a4fdc2e0 Mon Sep 17 00:00:00 2001
From: borisneubert <>
Date: Sun, 21 Aug 2016 12:58:51 +0000
Subject: [PATCH] OWServer, OWDevice: commandref amended

git-svn-id: https://svn.fhem.de/fhem/trunk@12039 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 fhem/FHEM/10_OWServer.pm | 41 ++++++++++++++++++++++++++++++++++++----
 fhem/FHEM/11_OWDevice.pm |  5 +++++
 2 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/fhem/FHEM/10_OWServer.pm b/fhem/FHEM/10_OWServer.pm
index 74dce7ef7..ef65ca21e 100644
--- a/fhem/FHEM/10_OWServer.pm
+++ b/fhem/FHEM/10_OWServer.pm
@@ -524,13 +524,16 @@ OWServer_Set($@)
 
 
 =pod
+=item device
+=item summary controls a One-Wire (1Wire) server instance
+=item summary_DE steuert eine Ausgabe eines One-Wire (1Wire) Servers
 =begin html
 
 <a name="OWServer"></a>
 <h3>OWServer</h3>
 <ul>
   <br>
-  <a name="OWDevicedefine"></a>
+  <a name="OWServerdefine"></a>
   <b>Define</b>
   <ul>
     <code>define &lt;name&gt; OWServer &lt;protocol&gt;</code>
@@ -541,10 +544,25 @@ OWServer_Set($@)
     for any 1-wire devices on a host. &lt;protocol&gt; has
     format &lt;hostname&gt;:&lt;port&gt;. For details see
     <a href="http://owfs.org/index.php?page=owserver_protocol">owserver documentation</a>.
-    <br><br>
+    <p>
     You need <a href="http://owfs.cvs.sourceforge.net/viewvc/owfs/owfs/module/ownet/perl5/OWNet/lib/OWNet.pm">OWNet.pm from owfs.org</a>, which is normally deployed with FHEM. As at 2012-12-23 the OWNet module
     on CPAN has an issue which renders it useless for remote connections.
-    <br><br>
+    <p>
+    The ow* version 2.9 packages provided with Debian Jessie have issues. For Debian Jessie please unzip 
+    <a href="http://forum.fhem.de/index.php?action=dlattach;topic=12219.0;attach=2463">owfs_2.8p17-1_all.zip</a> and install
+    owserver, dependencies and what else you require with <code>dpkg -i &lt;package&gt;.deb</code>.
+    <p>
+    A typical working configuration file <code>/etc/owfs.conf</code> looks as follows:<p>
+    <code>
+    ! server: server = localhost:4304<br>
+    #server: FAKE = DS18S20,DS2405<br>
+    # USB device: DS9490<br>
+    server: usb = all<br>
+    http: port = 2121<br>
+    ftp: port = 2120<br>
+    server: port = localhost:4304<br>
+    </code>
+    <p>
     The actual 1-wire devices are defined as <a href="#OWDevice">OWDevice</a> devices.
     If <a href="#autocreate">autocreate</a> is enabled, all the devices found are created at
     start of FHEM automatically.
@@ -657,7 +675,7 @@ OWServer_Set($@)
 <h3>OWServer</h3>
 <ul>
   <br>
-  <a name="OWDevicedefine"></a>
+  <a name="OWServerdefine"></a>
   <b>Definition</b>
   <ul>
     <code>define &lt;name&gt; OWServer &lt;protocol&gt;</code>
@@ -672,6 +690,21 @@ OWServer_Set($@)
         Das auf CPAN erhältliche OWNet- Modul beinhaltet seit dem 23.12.2012 einen Fehler, der es für Fernzugriffe unbrauchbar macht.<p>
         Auf dem Computer, an dem der 1-Wire- Bus angeschlossen ist, muss die Software "owserver" installiert sein. Zusätzlich sollte auf diesem Rechner die Konfigurationsdatei "owfs.conf" eingesehen bzw. angepasst werden. <a href="http://www.fhemwiki.de/wiki/OWServer_%26_OWDevice#Tipps_und_Tricks"> Einen WIKI- Artikel dazu gibt es hier.</a>
     <br><br>
+    Die ow*-Pakete in der Version 2.9 von Debian Jessie haben Probleme. Bitte entpacke f&uuml;r Debian Jessie 
+    <a href="http://forum.fhem.de/index.php?action=dlattach;topic=12219.0;attach=2463">owfs_2.8p17-1_all.zip</a> und installiere
+    owserver, Abh&auml;ngigkeiten und was Du sonst noch brauchst mit <code>dpkg -i &lt;package&gt;.deb</code>.
+    <p>
+    Eine typische funktionierende Konfigurationsdatei <code>/etc/owfs.conf</code> sieht so aus:<p>
+    <code>
+    ! server: server = localhost:4304<br>
+    #server: FAKE = DS18S20,DS2405<br>
+    # USB device: DS9490<br>
+    server: usb = all<br>
+    http: port = 2121<br>
+    ftp: port = 2120<br>
+    server: port = localhost:4304<br>
+    </code>
+    <p>
     Die vorhandenen 1-Wire- Busteilnehmer werden als <a href="#OWDevice">OWDevice</a> -Geräte definiert.
     Wenn <a href="#autocreate">autocreate</a> aktiviert ist, werden beim Start von FHEM alle Geräte automatisch erkannt und eingerichtet.
     <br><br>
diff --git a/fhem/FHEM/11_OWDevice.pm b/fhem/FHEM/11_OWDevice.pm
index 54ff029fe..87cf38f7d 100644
--- a/fhem/FHEM/11_OWDevice.pm
+++ b/fhem/FHEM/11_OWDevice.pm
@@ -743,6 +743,9 @@ OWDevice_InitValues($)
 
 ###################################
 =pod
+=item device
+=item summary controls a One-Wire (1Wire) device
+=item summary_DE steuert ein One-Wire- (1Wire-) Gerät
 =begin html
 
 <a name="OWDevice"></a>
@@ -780,6 +783,7 @@ OWDevice_InitValues($)
       <li>DS2423 - 4kbit 1-Wire RAM with Counter</li>
       <li>DS2450 - Quad A/D Converter</li>
       <li>DS1822 - Econo 1-Wire Digital Thermometer</li>
+      <li>DS2433 - 4kbit 1-Wire RAM</li>
       <li>DS2415 - 1-Wire Time Chip</li>
       <li>DS1904 - RTC iButton</li>
       <li>DS2438 - Smart Battery Monitor</li>
@@ -936,6 +940,7 @@ OWDevice_InitValues($)
       <li>DS2423 - Dual-Zählerbaustein mit Speicherfunktion</li>
       <li>DS2450 - Vierfach-A/D Umsetzer</li>
       <li>DS1822 - Econo-Thermosensor</li>
+      <li>DS2433 - 4kbit 1-Wire RAM</li>
       <li>DS2415 - Zeitgeber- Schaltkreis </li>
       <li>DS1904 - iButton-Echtzeituhr</li>
       <li>DS2438 - Smart-Batterie-Monitor</li>