PID moved from contrib into FHEM

git-svn-id: https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem@726 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rudolfkoenig
2010-10-10 13:35:54 +00:00
parent 30284087e6
commit bf60524a03
3 changed files with 314 additions and 4 deletions

View File

@@ -80,13 +80,10 @@
<a href="#CUL_RFR">CUL_RFR</a> &nbsp;
<a href="#CUL_WS">CUL_WS</a> &nbsp;
<a href="#DS18S20">DS18S20</a> &nbsp;
<a href="#DbLog">DbLog</a> &nbsp;
<a href="#EM">EM</a> &nbsp;
<a href="#EMEM">EMEM</a> &nbsp;
<a href="#EMGZ">EMGZ</a> &nbsp;
<a href="#EMWZ">EMWZ</a> &nbsp;
<a href="#FHEMRENDERER">FHEMRENDERER</a> &nbsp;
<a href="#FHEMWEB">FHEMWEB</a> &nbsp;
<a href="#FHT">FHT</a> &nbsp;
<a href="#FHT8V">FHT8V</a> &nbsp;
<a href="#FHZ">FHZ</a> &nbsp;
@@ -114,7 +111,6 @@
<a href="#WS3600">WS3600</a> &nbsp;
<a href="#Weather">Weather</a> &nbsp;
<a href="#X10">X10</a> &nbsp;
<a href="#structure">structure</a> &nbsp;
<a href="#xxLG7000">xxLG7000</a> &nbsp;
@@ -123,8 +119,12 @@
<br>
<b>Helper modules</b>
<ul>
<a href="#DbLog">DbLog</a> &nbsp;
<a href="#FHEMRENDERER">FHEMRENDERER</a> &nbsp;
<a href="#FHEMWEB">FHEMWEB</a> &nbsp;
<a href="#FileLog">FileLog</a> &nbsp;
<a href="#PachLog">PachLog</a> &nbsp;
<a href="#PID">PID</a> &nbsp;
<a href="#SUNRISE_EL">SUNRISE_EL</a> &nbsp;
<a href="#at">at</a> &nbsp;
<a href="#autocreate">autocreate</a> &nbsp;
@@ -132,6 +132,7 @@
<a href="#dumpdef">dumpdef</a> &nbsp;
<a href="#holiday">holiday</a> &nbsp;
<a href="#notify">notify</a> &nbsp;
<a href="#structure">structure</a> &nbsp;
<a href="#watchdog">watchdog</a> &nbsp;
<a href="#weblink">weblink</a> &nbsp;
@@ -1618,6 +1619,80 @@ A line ending with \ will be concatenated with the next one, so long lines
</ul>
<a name="PID"></a>
<h3>PID</h3>
<ul>
The PID device is a loop controller, used to set the value e.g of a heating
valve dependent of the current and desired temperature.
<br>
<br>
<a name="FHT8Vdefine"></a>
<b>Define</b>
<ul>
<code>define &lt;name&gt; PID sensor[:reading:regexp] actor[:cmd:min:max] [p i d]</code>
<br><br>
<code>sensor[:reading:regexp]</code> specifies the sensor, which is an
already defined fhem device, e.g. a S300TH temperature sensor. The reading
and regexp fields are necessary only for unknown devices (currently <a
href="#CUL_WS">CUL_WS</a> and <a href="#HMS">HMS</a> devices are "known").
Reading specifies the READINGS field of the sensor, and the regexp extracts
the number from this field. E.g. for the complete definition for a CUL_WS
device is: <code>s300th_dev:temperature:([\d\.]*)</code>
<br><br>
<code>actor[:cmd:min:max]</code> specifies the actor, which is an
already defined fhem device, e.g. an FHT8V valve. The cmd, min and max
fields are necessary only for unknown devices (currently <a
href="#FHT8V">FHT8V</a> is "known"). cmd specifies the command name for the
actor, min the minimum value and max the maximum value. The complete
definition for an FHT8V device is:<code>fht8v_dev:valve:0:100</code>
<br><br>
p, i and d are the parameters use to controlling, see also the <a
href="http://de.wikipedia.org/wiki/Regler">this</a> wikipedia entry.
The default values are around 25.5, 3 and 5.88, you probably need to tune
these values. They can be also changed later.
<br><br>
Examples:
<ul>
<code>define wz_pid PID wz_th wz_fht8v</code><br>
</ul>
</ul>
<br>
<a name="PIDset"></a>
<b>Set </b>
<ul>
<li>set &lt;name&gt; factors p i d<br>
Set the p, i and d factors, as described above.
</li>
<li>set &lt;name&gt; desired &lt;value&gt;<br>
Set the desired value (e.g. temperature). Note: until this value is not
set, no command is issued.
</li>
</ul>
<br>
<a name="FHT8Vget"></a>
<b>Get </b>
<ul>
N/A
</ul>
<br>
<a name="FHT8Vattr"></a>
<b>Attributes</b>
<ul>
<li><a href="#disable">disable</a></li>
<li><a href="#loglevel">loglevel</a></li>
</ul>
<br>
</ul>
<a name="CUL_FHTTK"></a>
<h3>CUL_FHTTK</h3>