mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-02-01 13:29:26 +00:00
771 lines
31 KiB
Perl
771 lines
31 KiB
Perl
# $Id$
|
||
##############################################
|
||
#
|
||
# Dewpoint computing
|
||
#
|
||
# based / modified from 98_average.pm (C) by Rudolf Koenig
|
||
#
|
||
# Copyright (C) 2012 Willi Herzig
|
||
#
|
||
# This program is free software; you can redistribute it and/or
|
||
# modify it under the terms of the GNU General Public License
|
||
# as published by the Free Software Foundation; either version 2
|
||
# of the License, or (at your option) any later version.
|
||
#
|
||
# This program is distributed in the hope that it will be useful,
|
||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
# GNU General Public License for more details.
|
||
#
|
||
# You should have received a copy of the GNU General Public License
|
||
# along with this program; if not, write to the Free Software
|
||
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||
#
|
||
# The GNU General Public License may also be found at http://www.gnu.org/licenses/gpl-2.0.html .
|
||
#
|
||
package main;
|
||
use strict;
|
||
use warnings;
|
||
|
||
# Debug this module? YES = 1, NO = 0
|
||
my $dewpoint_debug = 0;
|
||
# default maximum time_diff for dewpoint
|
||
my $dewpoint_time_diff_default = 1; # 1 Second
|
||
|
||
##########################
|
||
sub
|
||
dewpoint_Initialize($)
|
||
{
|
||
my ($hash) = @_;
|
||
$hash->{DefFn} = "dewpoint_Define";
|
||
$hash->{NotifyFn} = "dewpoint_Notify";
|
||
$hash->{NotifyOrderPrefix} = "10-"; # Want to be called before the rest
|
||
$hash->{AttrList} = "disable:0,1 max_timediff absFeuchte";
|
||
}
|
||
|
||
|
||
##########################
|
||
sub
|
||
dewpoint_Define($$)
|
||
{
|
||
my ($hash, $def) = @_;
|
||
my @a = split("[ \t][ \t]*", $def);
|
||
|
||
return "wrong syntax: define <name> dewpoint (dewpoint|fan|alarm) devicename [options]"
|
||
if(@a < 4);
|
||
|
||
|
||
my $name = $a[0];
|
||
my $cmd_type = $a[2]; # dewpoint, fan, alarm
|
||
my $devname = $a[3];
|
||
|
||
if ($cmd_type eq "dewpoint") {
|
||
# define <name> dewpoint dewpoint devicename-regex [temp_name hum_name new_name]
|
||
if(@a == 7) {
|
||
$hash->{TEMP_NAME} = $a[4];
|
||
$hash->{HUM_NAME} = $a[5];
|
||
$hash->{NEW_NAME} = $a[6];
|
||
} elsif (@a == 4) {
|
||
$hash->{TEMP_NAME} = "temperature";
|
||
$hash->{HUM_NAME} = "humidity";
|
||
$hash->{NEW_NAME} = "dewpoint";
|
||
} else {
|
||
return "wrong syntax: define <name> dewpoint dewpoint devicename-regex [temp_name hum_name new_name]"
|
||
}
|
||
} elsif ($cmd_type eq "fan") {
|
||
# define <name> dewpoint fan devicename-regex devicename-outside min_temp
|
||
if (@a == 6 || @a == 7) {
|
||
$hash->{DEVNAME_OUT} = $a[4];
|
||
$hash->{MIN_TEMP} = $a[5];
|
||
if (@a == 6) {
|
||
$hash->{DIFF_TEMP} = 0;
|
||
} else {
|
||
$hash->{DIFF_TEMP} = $a[6];
|
||
}
|
||
} else {
|
||
return "wrong syntax: define <name> dewpoint fan devicename-regex devicename-outside min_temp [diff_temp]"
|
||
}
|
||
} elsif ($cmd_type eq "alarm") {
|
||
# define <name> dewpoint alarm devicename-regex devicename-reference diff_temp
|
||
if (@a == 6) {
|
||
$hash->{DEVNAME_REF} = $a[4];
|
||
$hash->{DIFF_TEMP} = $a[5];
|
||
} else {
|
||
return "wrong syntax: define <name> dewpoint alarm devicename-regex devicename-reference diff_temp"
|
||
}
|
||
} else {
|
||
return "wrong syntax: define <name> dewpoint (dewpoint|fan|alarm) devicename-regex [options]"
|
||
}
|
||
|
||
$hash->{CMD_TYPE} = $cmd_type;
|
||
|
||
eval { "Hallo" =~ m/^$devname$/ };
|
||
return "Bad regecaxp: $@" if($@);
|
||
$hash->{DEV_REGEXP} = $devname;
|
||
|
||
|
||
$hash->{STATE} = "active";
|
||
return undef;
|
||
}
|
||
|
||
##########################
|
||
sub
|
||
dewpoint_Notify($$)
|
||
{
|
||
my ($hash, $dev) = @_;
|
||
my $hashName = $hash->{NAME};
|
||
|
||
return "" if(AttrVal($hashName, "disable", undef));
|
||
return "" if(!defined($hash->{DEV_REGEXP}));
|
||
|
||
my $devName = $dev->{NAME};
|
||
|
||
my $cmd_type = $hash->{CMD_TYPE};
|
||
my $re = $hash->{DEV_REGEXP};
|
||
|
||
# dewpoint
|
||
my $temp_name = "temperature";
|
||
my $hum_name = "humidity";
|
||
my $new_name = "dewpoint";
|
||
# fan
|
||
my $devname_out = "";
|
||
my $min_temp = 0;
|
||
# alarm
|
||
my $devname_ref = "";
|
||
my $diff_temp = 0;
|
||
|
||
|
||
if ($cmd_type eq "dewpoint") {
|
||
if (!defined($hash->{TEMP_NAME}) || !defined($hash->{HUM_NAME}) || !defined($hash->{NEW_NAME})) {
|
||
# should never happen!
|
||
Log 1, "Error dewpoint: TEMP_NAME || HUM_NAME || NEW_NAME undefined";
|
||
return "";
|
||
}
|
||
$temp_name = $hash->{TEMP_NAME};
|
||
$hum_name = $hash->{HUM_NAME};
|
||
$new_name = $hash->{NEW_NAME};
|
||
Log 1, "dewpoint_notify: cmd_type=$cmd_type devname=$devName dewname=$hashName, dev=$devName, dev_regex=$re temp_name=$temp_name hum_name=$hum_name" if ($dewpoint_debug == 1);
|
||
} elsif ($cmd_type eq "fan") {
|
||
if (!defined($hash->{DEVNAME_OUT}) || !defined($hash->{MIN_TEMP})) {
|
||
# should never happen!
|
||
Log 1, "Error dewpoint: DEVNAME_OUT || MIN_TEMP undefined";
|
||
return "";
|
||
}
|
||
$devname_out = $hash->{DEVNAME_OUT};
|
||
$min_temp = $hash->{MIN_TEMP};
|
||
$diff_temp = $hash->{DIFF_TEMP};
|
||
Log 1, "dewpoint_notify: cmd_type=$cmd_type devname=$devName dewname=$hashName, dev=$devName, dev_regex=$re, devname_out=$devname_out, min_temp=$min_temp, diff_temp=$diff_temp" if ($dewpoint_debug == 1);
|
||
|
||
} elsif ($cmd_type eq "alarm") {
|
||
if (!defined($hash->{DEVNAME_REF}) || !defined($hash->{DIFF_TEMP})) {
|
||
# should never happen!
|
||
Log 1, "Error dewpoint: DEVNAME_REF || DIFF_TEMP undefined";
|
||
return "";
|
||
}
|
||
$devname_ref = $hash->{DEVNAME_REF};
|
||
$diff_temp = $hash->{DIFF_TEMP};
|
||
Log 1, "dewpoint_notify: cmd_type=$cmd_type devname=$devName dewname=$hashName, dev=$devName, dev_regex=$re, devname_ref=$devname_ref, diff_temp=$diff_temp" if ($dewpoint_debug == 1);
|
||
} else {
|
||
# should never happen:
|
||
Log 1, "Error notify_dewpoint: <1> unknown cmd_type ".$cmd_type;
|
||
return "";
|
||
}
|
||
|
||
my $max = int(@{$dev->{CHANGED}});
|
||
my $tn;
|
||
my $n = -1;
|
||
my $lastval;
|
||
|
||
return "" if($devName !~ m/^$re$/);
|
||
|
||
my $temperature = "";
|
||
my $humidity = "";
|
||
my $time_diff;
|
||
|
||
for (my $i = 0; $i < $max; $i++) {
|
||
my $s = $dev->{CHANGED}[$i];
|
||
|
||
Log 1, "dewpoint_notify: s='$s'" if ($dewpoint_debug == 1);
|
||
|
||
################
|
||
# Filtering
|
||
next if(!defined($s));
|
||
my ($evName, $val, $rest) = split(" ", $s, 3); # resets $1
|
||
next if(!defined($evName));
|
||
next if(!defined($val));
|
||
Log 1, "dewpoint_notify: evName='$evName' val=$val'" if ($dewpoint_debug == 1);
|
||
if (($evName eq "T:") && ($temp_name eq "T")) {
|
||
$n = $i;
|
||
#my ($evName1, $val1, $evName2, $val2, $rest) = split(" ", $s, 5); # resets $1
|
||
#$lastval = $evName1." ".$val1." ".$evName2." ".$val2;
|
||
$lastval = $s;
|
||
if ($s =~ /T: ([-+]?[0-9]*\.[0-9]+|[-+]?[0-9]+)/) {
|
||
$temperature = $1;
|
||
}
|
||
if ($s =~ /H: [-+]?([0-9]*\.[0-9]+|[0-9]+)/) {
|
||
$humidity = $1;
|
||
}
|
||
Log 1, "dewpoint_notify T: H:, temp=$temperature hum=$humidity" if ($dewpoint_debug == 1);
|
||
} elsif ($evName eq $temp_name.":") {
|
||
$temperature = $val;
|
||
Log 1, "dewpoint_notify temperature! dev=$devName, temp_name=$temp_name, temp=$temperature" if ($dewpoint_debug == 1);
|
||
} elsif ($evName eq $hum_name.":") {
|
||
$humidity = $val;
|
||
Log 1, "dewpoint_notify humidity! dev=$devName, hum_name=$hum_name, hum=$humidity" if ($dewpoint_debug == 1);
|
||
}
|
||
|
||
}
|
||
|
||
if ($n == -1) { $n = $max; }
|
||
|
||
#if (($temperature eq "") || ($humidity eq "")) { return undef; } # no way to calculate dewpoint!
|
||
|
||
$time_diff = -1;
|
||
if (($humidity eq "") && (($temperature eq ""))) {
|
||
return undef; # no way to calculate dewpoint!
|
||
} elsif (($humidity eq "") && (($temperature ne ""))) {
|
||
# temperature set, but humidity not. Try to use a valid value from the appropiate reading
|
||
if (defined($dev->{READINGS}{$hum_name}{VAL}) && defined($dev->{READINGS}{$temp_name}{TIME})) {
|
||
# calculate time difference
|
||
$time_diff = time() - time_str2num($dev->{READINGS}{$hum_name}{TIME});
|
||
|
||
$humidity = $dev->{READINGS}{$hum_name}{VAL};
|
||
Log 1,">dev=$devName, hum_name=$hum_name, reference humidity=$humidity ($time_diff), temp=$temperature" if ($dewpoint_debug == 1);
|
||
} else { return undef; }
|
||
# Check if Attribute timeout is set
|
||
my $timeout = AttrVal($hash->{NAME},"max_timediff", undef);
|
||
if (defined($timeout)) {
|
||
Log 1,"dewpoint timeout=$timeout" if ($dewpoint_debug == 1);
|
||
} else {
|
||
$timeout = $dewpoint_time_diff_default;
|
||
}
|
||
if ($time_diff > 0 && $time_diff > $timeout) { return undef; }
|
||
} elsif (($temperature eq "") && ($humidity ne "")) {
|
||
# humdidity set, but temperature not. Try to use a valid value from the appropiate reading
|
||
if (defined($dev->{READINGS}{$temp_name}{VAL}) && defined($dev->{READINGS}{$temp_name}{TIME})) {
|
||
# calculate time difference
|
||
$time_diff = time() - time_str2num($dev->{READINGS}{$temp_name}{TIME});
|
||
|
||
$temperature = $dev->{READINGS}{$temp_name}{VAL};
|
||
Log 1,">dev=$devName, temp_name=$temp_name, reference temperature=$temperature ($time_diff), hum=$humidity" if ($dewpoint_debug == 1);
|
||
} else { return undef; }
|
||
# Check if Attribute timeout is set
|
||
my $timeout = AttrVal($hash->{NAME},"max_timediff", undef);
|
||
if (defined($timeout)) {
|
||
Log 1,"dewpoint timeout=$timeout" if ($dewpoint_debug == 1);
|
||
} else {
|
||
$timeout = $dewpoint_time_diff_default;
|
||
}
|
||
if ($time_diff > 0 && $time_diff > $timeout) { return undef; }
|
||
}
|
||
|
||
# We found temperature and humidity. so we can calculate dewpoint first
|
||
# Pr<50>fen, ob humidity im erlaubten Bereich ist
|
||
if (($humidity <= 0) || ($humidity >= 110)){
|
||
Log 1, "Error dewpoint: humidity invalid: $humidity";
|
||
return undef;
|
||
}
|
||
my $dewpoint = sprintf("%.1f", dewpoint_dewpoint($temperature,$humidity));
|
||
Log 1, "dewpoint_notify: dewpoint=$dewpoint" if ($dewpoint_debug == 1);
|
||
|
||
if ($cmd_type eq "dewpoint") {
|
||
# >define <name> dewpoint dewpoint <devicename> [<temp_name> <hum_name> <new_name>]
|
||
#
|
||
# Calculates dewpoint for device <devicename> from temperature and humidity and write it
|
||
# to new Reading dewpoint.
|
||
# If optional <temp_name>, <hum_name> and <newname> is specified
|
||
# then read temperature from reading <temp_name>, humidity from reading <hum_name>
|
||
# and write dewpoint to reading <temp_name>.
|
||
# if temp_name eq "T" then use temperature from state T: H:, add <newname> to the state
|
||
# Example:
|
||
# define dewtest1 dewpoint dewpoint .*
|
||
# define dewtest2 dewpoint dewpoint .* T H D
|
||
my $current;
|
||
my $sensor;
|
||
my $aFeuchte = AttrVal($hash->{NAME},"absFeuchte", undef);
|
||
if (defined($aFeuchte)) {
|
||
$sensor = "absFeuchte";
|
||
$current = sprintf("%.1f", dewpoint_absFeuchte($temperature,$humidity));
|
||
$tn = TimeNow();
|
||
$dev->{READINGS}{$sensor}{TIME} = $tn;
|
||
$dev->{READINGS}{$sensor}{VAL} = $current;
|
||
$dev->{CHANGED}[$n++] = $sensor . ": " . $current;
|
||
Log 1,"dewpoint absFeuchte= $current" if ($dewpoint_debug == 1);
|
||
$aFeuchte = "A: " . $current;
|
||
}
|
||
|
||
$sensor = $new_name;
|
||
if ($temp_name ne "T") {
|
||
$current = $dewpoint;
|
||
$tn = TimeNow();
|
||
$dev->{READINGS}{$sensor}{TIME} = $tn;
|
||
$dev->{READINGS}{$sensor}{VAL} = $current;
|
||
$dev->{CHANGED}[$n++] = $sensor . ": " . $current;
|
||
} else {
|
||
#Log 1,">dev=$devName, lastval='$lastval' devSTATE='".$dev->{STATE}."' state=".$dev->{READINGS}{state}{VAL}."'";
|
||
# state begins with "T:". append dewpoint or insert before BAT
|
||
if ($lastval =~ /BAT:/) {
|
||
$current = $lastval;
|
||
$current =~ s/BAT:/$sensor: $dewpoint BAT:/g;
|
||
} elsif ($lastval =~ /<</) {
|
||
$current = $lastval;
|
||
$current =~ s/<</$sensor:$dewpoint <</g;
|
||
} else {
|
||
$current = $lastval." ".$sensor.": ".$dewpoint;
|
||
if (defined($aFeuchte)) {
|
||
$current = $current." ".$aFeuchte;
|
||
}
|
||
}
|
||
$dev->{STATE} = $current;
|
||
$dev->{CHANGED}[$n++] = $current;
|
||
}
|
||
|
||
Log 1, "dewpoint_notify: current=$current" if ($dewpoint_debug == 1);
|
||
} elsif ($cmd_type eq "fan") {
|
||
# >define <name> dewpoint fan devicename devicename-outside min-temp [diff-temp]
|
||
#
|
||
# This define may be used to turn an fan on or off if the outside air has less
|
||
# water
|
||
#
|
||
# - Generate reading/event "fan: on" if (dewpoint of <devicename-outside>) + diff_temp is lower
|
||
# than dewpoint of <devicename> and temperature of <devicename-outside> is >= min-temp
|
||
# and reading "fan" was not already "on".
|
||
# - Generate reading/event "fan: off": else and if reading "fan" was not already "off".
|
||
Log 1, "dewpoint_notify: fan devname_out=$devname_out, min_temp=$min_temp, diff_temp=$diff_temp" if ($dewpoint_debug == 1);
|
||
my $sensor;
|
||
my $current;
|
||
if (exists $defs{$devname_out}{READINGS}{temperature}{VAL} && exists $defs{$devname_out}{READINGS}{humidity}{VAL}) {
|
||
my $temperature_out = $defs{$devname_out}{READINGS}{temperature}{VAL};
|
||
my $humidity_out = $defs{$devname_out}{READINGS}{humidity}{VAL};
|
||
my $dewpoint_out = sprintf("%.1f", dewpoint_dewpoint($temperature_out,$humidity_out));;
|
||
Log 1, "dewpoint_notify: fan dewpoint_out=$dewpoint_out" if ($dewpoint_debug == 1);
|
||
if (($dewpoint_out + $diff_temp) < $dewpoint && $temperature_out >= $min_temp) {
|
||
$current = "on";
|
||
Log 1, "dewpoint_notify: fan ON" if ($dewpoint_debug == 1);
|
||
} else {
|
||
$current = "off";
|
||
Log 1, "dewpoint_notify: fan OFF" if ($dewpoint_debug == 1);
|
||
}
|
||
$sensor = "fan";
|
||
if (!exists $defs{$devName}{READINGS}{$sensor}{VAL} || $defs{$devName}{READINGS}{$sensor}{VAL} ne $current) {
|
||
Log 1, "dewpoint_notify: CHANGE fan $current" if ($dewpoint_debug == 1);
|
||
$tn = TimeNow();
|
||
$dev->{READINGS}{$sensor}{TIME} = $tn;
|
||
$dev->{READINGS}{$sensor}{VAL} = $current;
|
||
$dev->{CHANGED}[$n++] = $sensor . ": " . $current;
|
||
}
|
||
|
||
} else {
|
||
Log 1, "dewpoint_notify: fan devname_out=$devname_out no temperature or humidity available for dewpoint calculation" if ($dewpoint_debug == 1);
|
||
}
|
||
} elsif ($cmd_type eq "alarm") {
|
||
# >define <name> dewpoint alarm devicename devicename-reference diff
|
||
#
|
||
# - Generate reading/event "alarm: on" if temperature of <devicename-reference>-<diff> is lower
|
||
# than dewpoint of <devicename> and reading "alarm" was not already "on".
|
||
# - Generate reading/event "alarm: off" if temperature of <devicename-reference>-<diff> is higher
|
||
# than dewpoint of <devicename> and reading "alarm" was not already "off".
|
||
#
|
||
# You have different options to use this define:
|
||
# * Use a temperature sensor in or on the wall (<devicename-reference>) and use a temp/hum sensor
|
||
# to measure the dewpoint of the air. Alarm if the temperature of the wall is lower than the dewpoint of the air.
|
||
# In this case the water of the air will condense on the wall because the wall is cold.
|
||
# Example: define alarmtest dewpoint alarm roomsensor wallsensor 0
|
||
# * If you do not have a temperature sensor in/on the wall, you may also compare the rooms dewpoint to the
|
||
# temperature of the same or another inside sensor. If you think that your walls are normally 5 degrees colder
|
||
# than the inside temperature, set diff to 5.
|
||
# Example: define alarmtest dewpoint alarm roomsensor roomsensor 5
|
||
Log 1, "dewpoint_notify: alarm devname_ref=$devname_ref, diff_temp=$diff_temp" if ($dewpoint_debug == 1);
|
||
my $sensor;
|
||
my $current;
|
||
if (exists $defs{$devname_ref}{READINGS}{temperature}{VAL}) {
|
||
my $temperature_ref = $defs{$devname_ref}{READINGS}{temperature}{VAL};
|
||
Log 1, "dewpoint_notify: alarm temperature_ref=$temperature_ref" if ($dewpoint_debug == 1);
|
||
if ($temperature_ref - $diff_temp < $dewpoint) {
|
||
$current = "on";
|
||
Log 1, "dewpoint_notify: alarm ON" if ($dewpoint_debug == 1);
|
||
} else {
|
||
$current = "off";
|
||
Log 1, "dewpoint_notify: alarm OFF" if ($dewpoint_debug == 1);
|
||
}
|
||
$sensor = "alarm";
|
||
if (!exists $defs{$devName}{READINGS}{$sensor}{VAL} || $defs{$devName}{READINGS}{$sensor}{VAL} ne $current) {
|
||
Log 1, "dewpoint_notify: CHANGE alarm $current" if ($dewpoint_debug == 1);
|
||
$tn = TimeNow();
|
||
$dev->{READINGS}{$sensor}{TIME} = $tn;
|
||
$dev->{READINGS}{$sensor}{VAL} = $current;
|
||
$dev->{CHANGED}[$n++] = $sensor . ": " . $current;
|
||
}
|
||
} else {
|
||
Log 1, "dewpoint_notify: alarm devname_out=$devname_out no temperature or humidity available for dewpoint calculation" if ($dewpoint_debug == 1);
|
||
}
|
||
|
||
} else {
|
||
# should never happen:
|
||
Log 1, "Error notify_dewpoint: <2> unknown cmd_type ".$cmd_type;
|
||
return "";
|
||
}
|
||
return undef;
|
||
}
|
||
# -----------------------------
|
||
# Dewpoint calculation.
|
||
# see http://www.faqs.org/faqs/meteorology/temp-dewpoint/ "5. EXAMPLE"
|
||
sub
|
||
dewpoint_dewpoint($$)
|
||
{
|
||
my ($temperature, $humidity) = @_;
|
||
my $dp;
|
||
my $A = 17.2694;
|
||
my $B = ($temperature > 0) ? 237.3 : 265.5;
|
||
my $es = 610.78 * exp( $A * $temperature / ($temperature + $B) );
|
||
my $e = $humidity/ 100 * $es;
|
||
if ($e == 0) {
|
||
Log 1, "Error: dewpoint() e==0: temp=$temperature, hum=$humidity";
|
||
return 0;
|
||
}
|
||
my $e1 = $e / 610.78;
|
||
my $f = log( $e1 ) / $A;
|
||
my $f1 = 1 - $f;
|
||
if ($f1 == 0) {
|
||
Log 1, "Error: dewpoint() (1-f)==0: temp=$temperature, hum=$humidity";
|
||
return 0;
|
||
}
|
||
$dp = $B * $f / $f1 ;
|
||
return($dp);
|
||
}
|
||
|
||
sub
|
||
dewpoint_absFeuchte ($$)
|
||
{
|
||
# Formeln von http://kellerlueftung.blogspot.de/p/blog-page_9.html
|
||
# http://www.wettermail.de/wetter/feuchte.html
|
||
my ($T, $rh) = @_;
|
||
if (($rh < 0) || ($rh > 110)){
|
||
Log 1, "Error dewpoint: humidity invalid: $rh";
|
||
return "";
|
||
}
|
||
# a = 7.5, b = 237.3 f<>r T >= 0
|
||
# a = 7.6, b = 240.7 f<>r T < 0 <20>ber Wasser (Taupunkt)
|
||
my $a = ($T > 0) ? 7.5 : 7.6;
|
||
my $b = ($T > 0) ? 237.3 : 240.7;
|
||
my $SDD = 6.1078 * 10**(($a*$T)/($b+$T));
|
||
my $DD = $rh/100 * $SDD;
|
||
my $AF = (10**5) * (18.016 / 8314.3) * ($DD / (273.15 + $T));
|
||
my $af = sprintf( "%.1f",$AF);
|
||
return($af); # $aF = absolute Feuchte in g Wasserdampf pro m3 Luft
|
||
}
|
||
|
||
1;
|
||
|
||
|
||
=pod
|
||
=begin html
|
||
|
||
<a name="dewpoint"></a>
|
||
<h3>dewpoint</h3>
|
||
<ul>
|
||
Dewpoint calculations. Offers three different ways to use dewpoint: <br>
|
||
<ul>
|
||
<li><b>dewpoint</b><br>
|
||
Compute additional event dewpoint from a sensor offering temperature and humidity.</li>
|
||
<li><b>fan</b><br>
|
||
Generate a event to turn a fan on if the outside air has less water than the inside.</li>
|
||
<li><b>alarm</b><br>
|
||
Generate a mold alarm if a reference temperature is lower that the current dewpoint.</li>
|
||
<br>
|
||
</ul>
|
||
|
||
<a name="dewpointdefine"></a>
|
||
<b>Define</b>
|
||
<ul>
|
||
<code>define <name> dewpoint dewpoint <devicename-regex> [<temp_name> <hum_name> <new_name>]</code><br>
|
||
<br>
|
||
<ul>
|
||
Calculates dewpoint for device <devicename-regex> from temperature and humidity
|
||
and write it to a new reading named dewpoint.
|
||
If optional <temp_name>, <hum_name> and <new_name> is specified
|
||
then read temperature from reading <temp_name>, humidity from reading <hum_name>
|
||
and write the calculated dewpoint to reading <new_name>.<br>
|
||
If <temp_name> is T then use temperature from state T: H:, add <new_name> to the state.
|
||
</ul>
|
||
<br>
|
||
|
||
Example:<PRE>
|
||
# Compute the dewpoint for the temperature/humidity
|
||
# events of the temp1 device and generate reading dewpoint.
|
||
define dew_temp1 dewpoint dewpoint temp1
|
||
define dew_temp1 dewpoint dewpoint temp1 temperature humidity dewpoint
|
||
|
||
# Compute the dewpoint for the temperature/humidity
|
||
# events of all devices offering temperature and humidity
|
||
# and generate reading dewpoint.
|
||
define dew_all dewpoint dewpoint .*
|
||
define dew_all dewpoint dewpoint .* temperature humidity dewpoint
|
||
|
||
# Compute the dewpoint for the temperature/humidity
|
||
# events of the device Aussen_1 offering temperature and humidity
|
||
# and insert is into STATE.
|
||
define dew_state dewpoint dewpoint Aussen_1 T H D
|
||
|
||
# Compute the dewpoint for the temperature/humidity
|
||
# events of all devices offering temperature and humidity
|
||
# and insert the result into the STATE.
|
||
# Example STATE: "T: 10 H: 62.5" will change to
|
||
# "T: 10 H: 62.5 D: 3.2"
|
||
define dew_state dewpoint dewpoint .* T H D
|
||
|
||
</PRE>
|
||
</ul>
|
||
|
||
<ul>
|
||
<code>define <name> dewpoint fan <devicename-regex> <devicename-outside> <min-temp> [<diff_temp>]</code><br>
|
||
<br>
|
||
<ul>
|
||
May be used to turn an fan on or off if the outside air has less water.
|
||
<ul>
|
||
<li>
|
||
Generate event "fan: on" if (dewpoint of <devicename-outside>) + <diff_temp> is lower
|
||
than dewpoint of <devicename> and temperature of <devicename-outside> is >= min-temp
|
||
and reading "fan" was not already "on". The event will be generated for <devicename>. Parameter <diff-temp> is optional</li>
|
||
<li>Generate event "fan: off": else and if reading "fan" was not already "off".</li>
|
||
</ul>
|
||
</ul>
|
||
<br>
|
||
|
||
Example:<PRE>
|
||
# Generate event "fan: on" when dewpoint of Aussen_1 is first
|
||
# time lower than basement_tempsensor and outside temperature is >= 0
|
||
# and change it to "fan: off" is this condition changes.
|
||
# Set a switch on/off (fan_switch) depending on the state.
|
||
define dew_fan1 dewpoint fan basement_tempsensor Aussen_1 0
|
||
define dew_fan1_on notify basement_tempsensor.*fan:.*on set fan_switch on
|
||
define dew_fan1_off notify basement_tempsensor.*fan:.*off set fan_switch off
|
||
|
||
</PRE>
|
||
</ul>
|
||
|
||
<ul>
|
||
<code>define <name> dewpoint alarm <devicename-regex> <devicename-reference> <diff-temp></code><br>
|
||
<br>
|
||
<ul>
|
||
Generate a mold alarm if a reference temperature is lower that the current dewpoint.
|
||
<ul>
|
||
<li>
|
||
Generate reading/event "alarm: on" if temperature of <devicename-reference> - <diff-temp> is lower
|
||
than dewpoint of <devicename> and reading "alarm" was not already "on". The event will be generated for <devicename>.</li>
|
||
<li>Generate reading/event "alarm: off" if temperature of <devicename-reference> - <diff-temp> is higher than dewpoint of <devicename> and reading "alarm" was not already "off".</li>
|
||
</ul>
|
||
</ul>
|
||
<br>
|
||
|
||
Example:<PRE>
|
||
# Using a wall temperature sensor (wallsensor) and a temp/hum sensor
|
||
# (roomsensor) to alarm if the temperature of the wall is lower than
|
||
# the dewpoint of the air. In this case the water of the air will
|
||
# condense on the wall because the wall is cold.
|
||
# Set a switch on (alarm_siren) if alarm is on using notify.
|
||
define dew_alarm1 dewpoint alarm roomsensor wallsensor 0
|
||
define roomsensor_alarm_on notify roomsensor.*alarm:.*on set alarm_siren on
|
||
define roomsensor_alarm_off notify roomsensor.*alarm:.*off set alarm_siren off
|
||
|
||
# If you do not have a temperature sensor in/on the wall, you may also
|
||
# compare the rooms dewpoint to the temperature of the same or another
|
||
# inside sensor. Alarm is temperature is 5 degrees colder than the
|
||
# inside dewpointinside.
|
||
define dev_alarm2 dewpoint alarm roomsensor roomsensor 5
|
||
|
||
</PRE>
|
||
</ul>
|
||
|
||
<a name="dewpointset"></a>
|
||
<b>Set</b> <ul>N/A</ul><br>
|
||
|
||
<a name="dewpointget"></a>
|
||
<b>Get</b> <ul>N/A</ul><br>
|
||
|
||
<a name="dewpointattr"></a>
|
||
<b>Attributes</b>
|
||
<ul>
|
||
<li><a href="#disable">disable</a></li>
|
||
<li>absFeuchte</li><br>
|
||
<ul>
|
||
AbsFeuchte also becomes by the absolute humidity set the attribute into the Readings of all things.
|
||
One can by these show information also in the status.
|
||
Example: (<Adapter> = the FHEM name of the adapter this one you must change)
|
||
<PRE>
|
||
stateFormat:
|
||
{sprintf("T: %.1f H: %.1f D: %.1f A: %.1f", ReadingsVal("<Adapter>","temperature",0), ReadingsVal("<Adapter>","H",0), ReadingsVal("<Adapter>","dewpoint",0), ReadingsVal("<Adapter>","absFeuchte",0))}
|
||
</PRE>
|
||
</ul>
|
||
<li>max_timediff<br>
|
||
Maximum time difference in seconds allowed between the temperature and humidity values for a device. dewpoint uses the Readings for temperature or humidity if they are not delivered in the event. This is necessary for using dewpoint with event-on-change-reading. Also needed for sensors that do deliver temperature and humidity in different events like for example technoline sensors TX3TH.<br>
|
||
If not set default is 1 second.
|
||
<br><br>
|
||
Examples:<PRE>
|
||
# allow maximum time difference of 60 seconds
|
||
define dew_all dewpoint dewpoint .*
|
||
attr dew_all max_timediff 60
|
||
</li><br>
|
||
</ul>
|
||
</ul>
|
||
|
||
=end html
|
||
|
||
=begin html_DE
|
||
|
||
<a name="dewpoint"></a>
|
||
<h3>dewpoint</h3>
|
||
<ul>
|
||
Berechnungen des Taupunkts. Es gibt drei Varianten, das Modul dewpoint zu verwenden: <br>
|
||
<ul>
|
||
<li><b>dewpoint</b>: Taupunkt<br>
|
||
Erzeugt ein zusätzliches Ereignis "dewpoint" aus Temperatur- und Luftfeuchtewerten eines Fühlers.</li>
|
||
<li><b>fan</b>: Lüfter<br>
|
||
Erzeugt ein Ereignis, um einen Lüfter einzuschalten, wenn die Außenluft
|
||
weniger Wasser als die Raumluft enthält.</li>
|
||
<li><b>alarm</b>: Alarm<br>
|
||
Erzeugt einen Schimmel-Alarm, wenn eine Referenz-Temperatur unter den Taupunkt fällt.</li>
|
||
</ul>
|
||
<br/>
|
||
|
||
<a name="dewpointdefine"></a>
|
||
<b>Define</b>
|
||
<ul>
|
||
<code>define <name> dewpoint dewpoint <devicename-regex> [<temp_name>
|
||
<hum_name> <new_name>]</code><br>
|
||
<br/>
|
||
Berechnet den Taupunkt des Geräts <devicename-regex> basierend auf Temperatur
|
||
und Luftfeuchte und erzeugt daraus ein neues Reading namens dewpoint.<br/>
|
||
Wenn <temp_name>, <hum_name> und <new_name> angegeben sind,
|
||
werden die Temperatur aus dem Reading <temp_name>, die Luftfeuchte aus dem
|
||
Reading <hum_name> gelesen und als berechneter Taupunkt ins Reading <new_name> geschrieben.<br>
|
||
Wenn <temp_name> T lautet, wird die Temperatur aus state T: H: benutzt
|
||
und <new_name> zu state hinzugefügt.
|
||
<br/>
|
||
Beispiele:
|
||
<pre>
|
||
# Berechnet den Taupunkt aufgrund von Temperatur und Luftfeuchte
|
||
# in Ereignissen, die vom Gerät temp1 erzeugt wurden und erzeugt ein Reading dewpoint.
|
||
define dew_temp1 dewpoint dewpoint temp1
|
||
define dew_temp1 dewpoint dewpoint temp1 temperature humidity dewpoint
|
||
|
||
# Berechnet den Taupunkt aufgrund von Temperatur und Luftfeuchte
|
||
# in Ereignissen, die von allen Geräten erzeugt wurden die diese Werte ausgeben
|
||
# und erzeugt ein Reading dewpoint.
|
||
define dew_all dewpoint dewpoint .*
|
||
define dew_all dewpoint dewpoint .* temperature humidity dewpoint
|
||
|
||
# Berechnet den Taupunkt aufgrund von Temperatur und Luftfeuchte
|
||
# in Ereignissen, die vom Gerät Aussen_1 erzeugt wurden und ergänzt
|
||
# mit diesem Wert den Status STATE.
|
||
define dew_state dewpoint dewpoint Aussen_1 T H D
|
||
|
||
# Berechnet den Taupunkt aufgrund von Temperatur und Luftfeuchte
|
||
# in Ereignissen, die von allen Geräten erzeugt wurden die diese Werte ausgeben
|
||
# und ergänzt mit diesem Wert den Status STATE.
|
||
# Beispiel STATE: "T: 10 H: 62.5" wird verändert nach
|
||
# "T: 10 H: 62.5 D: 3.2"
|
||
define dew_state dewpoint dewpoint .* T H D
|
||
</pre>
|
||
|
||
<br/>
|
||
<br/>
|
||
<code>define <name> dewpoint fan <devicename-regex> <devicename-outside> <min-temp> [<diff_temp>]</code><br>
|
||
<br>
|
||
<ul>
|
||
<li>Erzeugt ein Ereignis, um einen Lüfter einzuschalten, wenn die Außenluft
|
||
weniger Wasser als die Raumluft enthält.</li>
|
||
<li>Erzeugt das Ereignis "fan: on" wenn (Taupunkt von <devicename-outside>) +
|
||
<diff_temp> ist niedriger als der Taupunkt von <devicename> und die Temperatur
|
||
von <devicename-outside> >= min-temp ist. Das Ereignis wird nur erzeugt wenn das
|
||
Reading "fan" nicht schon "on" war. Das Ereignis wird für das Gerät <devicename> erzeugt.
|
||
Der Parameter <diff-temp> ist optional.</li>
|
||
<li>Andernfalls wird das Ereignis "fan: off" erzeugt, wenn das Reading von "fan" nicht bereits "off" war.</li>
|
||
</ul>
|
||
<br>
|
||
Beispiel:
|
||
<pre>
|
||
# Erzeugt das Ereignis "fan: on", wenn der Taupunkt des Geräts Aussen_1 zum ersten Mal
|
||
# niedriger ist als der Taupunkt des Geräts basement_tempsensor und die
|
||
# Außentemperatur >= 0 ist und wechselt nach "fan: off" wenn diese Bedingungen nicht
|
||
# mehr zutreffen.
|
||
# Schaltet den Schalter fan_switch abhängig vom Zustand ein oder aus.
|
||
define dew_fan1 dewpoint fan basement_tempsensor Aussen_1 0
|
||
define dew_fan1_on notify basement_tempsensor.*fan:.*on set fan_switch on
|
||
define dew_fan1_off notify basement_tempsensor.*fan:.*off set fan_switch off
|
||
</pre>
|
||
|
||
<code>define <name> dewpoint alarm <devicename-regex> <devicename-reference> <diff-temp></code><br>
|
||
<br>
|
||
<ul>
|
||
<li>Erzeugt einen Schimmel-Alarm, wenn eine Referenz-Temperatur unter den Taupunkt fällt.</li>
|
||
<li>Erzeugt ein Reading/Ereignis "alarm: on" wenn die Temperatur von
|
||
<devicename-reference> - <diff-temp> unter den Taupunkt von
|
||
<devicename> fällt und das Reading "alarm" nicht bereits "on" ist.
|
||
Das Ereignis wird für <devicename> erzeugt.</li>
|
||
<li>Erzeugt ein Reading/Ereignis "alarm: off" wenn die Temperatur von
|
||
<devicename-reference> - <diff-temp> über den Taupunkt
|
||
von <devicename> steigt und das Reading "alarm" nicht bereits "off" ist.</li>
|
||
</ul>
|
||
<br>
|
||
Beispiel:
|
||
<pre>
|
||
# Es wird ein Anlegefühler (Wandsensor) und ein Thermo-/Hygrometer (Raumfühler)
|
||
# verwendet, um einen Alarm zu erzeugen, wenn die Wandtemperatur
|
||
# unter den Taupunkt der Luft fällt. In diesem Fall würde sich Wasser an der Wand
|
||
# niederschlagen (kondensieren), weil die Wand zu kalt ist.
|
||
# Der Schalter einer Sirene (alarm_siren) wird über ein notify geschaltet.
|
||
define dew_alarm1 dewpoint alarm roomsensor wallsensor 0
|
||
define roomsensor_alarm_on notify roomsensor.*alarm:.*on set alarm_siren on
|
||
define roomsensor_alarm_off notify roomsensor.*alarm:.*off set alarm_siren off
|
||
|
||
# Ohne Wandsensor lässt sich auch der Taupunkt eines Raums mit der Temperatur desselben
|
||
# (oder eines anderen) Fühlers vergleichen.
|
||
# Die Alarmtemperatur ist 5 Grad niedriger gesetzt als die des Vergleichsthermostats.
|
||
define dev_alarm2 dewpoint alarm roomsensor roomsensor 5
|
||
</pre>
|
||
</ul>
|
||
|
||
<a name="dewpointset"></a>
|
||
<b>Set</b> <ul>N/A</ul><br>
|
||
|
||
<a name="dewpointget"></a>
|
||
<b>Get</b> <ul>N/A</ul><br>
|
||
|
||
<a name="dewpointattr"></a>
|
||
<b>Attributes</b>
|
||
<ul>
|
||
<li><a href="#disable">disable</a></li>
|
||
<li>absFeuchte</li><br>
|
||
<ul>
|
||
Durch setzen des Attributes absFeuchte wird in den Readings auch die absolute Feuchte mit ausgerechnet.
|
||
Durch <a href="#stateFormat">stateFormat</a> kann man diese Info auch im Status anzeigen.
|
||
Beispiel: (<Adapter> = Der FHEM Name des Adapters der ge<67>ndert werden muss)
|
||
<pre>
|
||
stateFormat:
|
||
{sprintf("T: %.1f H: %.1f D: %.1f A: %.1f", ReadingsVal("<Adapter>","temperature",0), ReadingsVal("<Adapter>","H",0), ReadingsVal("<Adapter>","dewpoint",0), ReadingsVal("<Adapter>","absFeuchte",0))}
|
||
</pre>
|
||
</ul>
|
||
<li>max_timediff</li><br>
|
||
<ul>
|
||
Maximale erlaubter Zeitunterschied in Sekunden zwischen den Temperatur- und Luftfeuchtewerten eines
|
||
Geräts. dewpoint verwendet Readings von Temperatur oder Luftfeuchte wenn sie nicht im Ereignis
|
||
mitgeliefert werden. Das ist sowohl für den Betrieb mit event-on-change-reading nötig
|
||
als auch bei Sensoren die Temperatur und Luftfeuchte in getrennten Ereignissen kommunizieren
|
||
(z.B. Technoline Sensoren TX3TH).<br/>
|
||
Der Standardwert ist 1 Sekunde.
|
||
<br><br>
|
||
Beispiel:
|
||
<pre>
|
||
# Maximal erlaubter Zeitunterschied soll 60 Sekunden sein
|
||
define dew_all dewpoint dewpoint .*
|
||
attr dew_all max_timediff 60
|
||
</pre>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
|
||
=end html_DE
|
||
|
||
=cut
|