fhem-mirror/FHEM/21_OWCOUNT.pm
phenning e3607a76a9 00_OWX.pm: Neue Version, kleinere Fixes
11_OWX_CCC: Neue Version, kleinere Fixes
11_OWX_FRM: Neue Version, kleinere Fixes
11_OWX_SER: Neue Version, kleinere Fixes
11_OWX_TCP: Neue Version, kleinere Fixes
21_OWAD.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes
21_OWCOUNT.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes
21_OWID.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes
21_OWLCD.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes
21_OWMULTI.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes
21_OWSWITCH.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes
21_OWTHERM.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes
21_OWVAR.pm: Neue Version, Support für OWX_ASYNC entfernt, kleinere Fixes

git-svn-id: https://svn.fhem.de/fhem/trunk/fhem@23553 2b470e98-0d58-463d-a4d8-8e2adae1ed80
2021-01-19 13:51:06 +00:00

1970 lines
66 KiB
Perl

########################################################################################
#
# OWCOUNT.pm
#
# FHEM module to commmunicate with 1-Wire Counter/RAM DS2423
#
# Prof. Dr. Peter A. Henning
#
# $Id$
#
########################################################################################
#
# This programm 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.
#
# The GNU General Public License can be found at
# http://www.gnu.org/copyleft/gpl.html.
# A copy is found in the textfile GPL.txt and important notices to the license
# from the author is found in LICENSE.txt distributed with these scripts.
#
# This script 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.
#
########################################################################################
package main;
use vars qw{%attr %defs %modules $readingFnAttributes $init_done};
use strict;
use warnings;
use Time::HiRes qw( gettimeofday );
my $owx_version="7.23";
#-- fixed raw channel name, flexible channel name
my @owg_fixed = ("A","B");
my @owg_channel = ("A","B");
my @owg_rate = ("A_rate","B_rate");
#-- initially assume that both memory types (low, high) are present
my @owg_memory = (1,1,0);
my $owgmodel;
my $owgauto = 0;
my %gets = (
"id" => ":noArg",
"mcache" => "",
"memory" => "",
"midnight" => "",
"raw" => "",
"counters" => ":noArg",
"month" => ":noArg",
"year" => ":noArg",
"version" => ":noArg"
);
my %sets = (
"interval" => "",
"memory" => "",
"midnight" => "",
"counter" => ""
);
my %updates = (
"present" => "",
"counter" => ""
);
########################################################################################
#
# The following subroutines are independent of the bus interface
#
# Prefix = OWCOUNT
#
########################################################################################
#
# OWCOUNT_Initialize
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWCOUNT_Initialize ($) {
my ($hash) = @_;
$hash->{DefFn} = "OWCOUNT_Define";
$hash->{UndefFn} = "OWCOUNT_Undef";
$hash->{GetFn} = "OWCOUNT_Get";
$hash->{SetFn} = "OWCOUNT_Set";
$hash->{NotifyFn}= "OWCOUNT_Notify";
$hash->{InitFn} = "OWCOUNT_Init";
$hash->{AttrFn} = "OWCOUNT_Attr";
#-- see header for attributes
my $attlist = "IODev do_not_notify:0,1 showtime:0,1 model:DS2423,DS2423enew,DS2423eold LogM LogY ".
"nomemory:1,0 interval ".
$readingFnAttributes;
for( my $i=0;$i<int(@owg_fixed);$i++ ){
$attlist .= " ".$owg_fixed[$i]."Name";
$attlist .= " ".$owg_fixed[$i]."Rate";
$attlist .= " ".$owg_fixed[$i]."Offset";
$attlist .= " ".$owg_fixed[$i]."Factor";
$attlist .= " ".$owg_fixed[$i]."Unit";
$attlist .= " ".$owg_fixed[$i]."Mode:normal,daily";
$attlist .= " ".$owg_fixed[$i]."Period:hour,minute,second";
}
$hash->{AttrList} = $attlist;
#-- make sure OWX is loaded so OWX_CRC is available if running with OWServer
main::LoadModule("OWX");
}
#########################################################################################
#
# OWCOUNT_Define - Implements DefFn function
#
# Parameter hash = hash of device addressed, def = definition string
#
#########################################################################################
sub OWCOUNT_Define ($$) {
my ($hash, $def) = @_;
my @a = split("[ \t][ \t]*", $def);
my ($name,$model,$fam,$id,$crc,$interval,$scale,$ret);
#-- default
$name = $a[0];
$interval = 300;
$scale = "";
$ret = "";
#-- check syntax
return "OWCOUNT: Wrong syntax, must be define <name> OWCOUNT [<model>] <id> [interval] or OWCOUNT <fam>.<id> [interval]"
if(int(@a) < 2 || int(@a) > 5);
#-- different types of definition allowed
my $a2 = $a[2];
my $a3 = defined($a[3]) ? $a[3] : "";
#-- The model may be DS2423 or DS2423emu. Some weird people are violating 1-Wire integrity by using the
# the same family ID although the DS2423emu does not fully support the DS2423 commands.
# Model attribute will be modified later when memory is checked
#-- no model, 12 characters
if( $a2 =~ m/^[0-9|a-f|A-F]{12}$/ ) {
$model = "DS2423";
$owgauto =1;
#CommandAttr (undef,"$name model DS2423");
$fam = "1D";
$id = $a[2];
if(int(@a)>=4) { $interval = $a[3]; }
#-- no model, 2+12 characters
} elsif( $a2 =~ m/^[0-9|a-f|A-F]{2}\.[0-9|a-f|A-F]{12}$/ ) {
$fam = substr($a[2],0,2);
$id = substr($a[2],3);
if(int(@a)>=4) { $interval = $a[3]; }
if( $fam eq "1D" ){
$model = "DS2423";
$owgauto =1;
#CommandAttr (undef,"$name model DS2423");
}else{
return "OWCOUNT: Wrong 1-Wire device family $fam";
}
#-- model, 12 characters
} elsif( $a3 =~ m/^[0-9|a-f|A-F]{12}$/ ) {
$model = $a[2];
$id = $a[3];
if(int(@a)>=5) { $interval = $a[4]; }
if( $model eq "DS2423" ){
$fam = "1D";
#CommandAttr (undef,"$name model DS2423");
#-- Check, if name might be from autocreate -> checking memory
if( $name =~ /OWX\_$fam\_$id/ ){
$owgauto=1;
}
@owg_memory = (1,1,0);
}elsif( $model eq "DS2423enew" ){
$fam = "1D";
@owg_memory = (1,1,0);
#CommandAttr (undef,"$name model DS2423enew");
}elsif( $model eq "DS2423eold" ){
$fam = "1D";
#CommandAttr (undef,"$name model DS2423eold");
#CommandAttr (undef,"$name nomemory 1");
@owg_memory = (0,0,0);
}else{
return "OWCOUNT: Wrong 1-Wire device model $model";
}
} else {
return "OWCOUNT: $a[0] ID $a[2] invalid, specify a 12 or 2.12 digit value";
}
$owgmodel=$model;
# determine CRC Code - only if this is a direct interface
$crc = sprintf("%02x",OWX_CRC($fam.".".$id."00"));
#-- Define device internals
$hash->{ROM_ID} = "$fam.$id.$crc";
$hash->{OW_ID} = $id;
$hash->{OW_FAMILY} = $fam;
$hash->{ERRCOUNT} = 0;
$hash->{PRESENT} = 0;
$hash->{INTERVAL} = $interval;
#-- Couple to I/O device
AssignIoPort($hash);
if( !defined($hash->{IODev}) or !defined($hash->{IODev}->{NAME}) ){
return "OWCOUNT: Warning, no 1-Wire I/O device found for $name.";
}
$modules{OWCOUNT}{defptr}{$id} = $hash;
#--
readingsSingleUpdate($hash,"state","defined",1);
Log3 $name, 3, "OWCOUNT: Device $name defined.";
$hash->{NOTIFYDEV} = "global";
if ($init_done) {
OWCOUNT_Init($hash);
}
return undef;
}
#######################################################################################
#
# OWCOUNT_Notify - Implements Notify function
#
# Parameter hash = hash of device addressed
# dev = device
#
########################################################################################
sub OWCOUNT_Notify ($$) {
my ($hash,$dev) = @_;
if( grep(m/^(INITIALIZED|REREADCFG)$/, @{$dev->{CHANGED}}) ) {
OWCOUNT_Init($hash);
} elsif( grep(m/^SAVE$/, @{$dev->{CHANGED}}) ) {
}
}
#######################################################################################
#
# OWCOUNT_Init - Implements Init function
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWCOUNT_Init ($) {
my ($hash)=@_;
#-- Start timer for updates
RemoveInternalTimer($hash);
InternalTimer(gettimeofday()+10, "OWCOUNT_GetValues", $hash, 0);
return undef;
}
########################################################################################
#
# OWCOUNT_InitializeDevice - delayed setting of initial readings and channel names
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWCOUNT_InitializeDevice($) {
my ($hash) = @_;
my $name = $hash->{NAME};
#-- get memory page/counter according to interface type
my $master= $hash->{IODev};
my $interface= $hash->{IODev}->{TYPE};
my $olddata = "";
my ($olddata1,$olddata2);
my $newdata = "OWCOUNT ".$owx_version;
my $ret;
#-- post-define: check model
if( !defined($attr{$hash->{NAME}}{"model"}) ){
CommandAttr (undef,$hash->{NAME}." model $owgmodel");
}
#-- initial values
for( my $i=0;$i<int(@owg_fixed);$i++) {
#-- initial readings
$hash->{owg_val}->[$i] = "";
$hash->{owg_midnight}->[$i] = "";
$hash->{owg_str}->[$i] = "";
}
$hash->{DATA}{memory} = "";
#-- Set state to initialized
readingsSingleUpdate($hash,"state","initialized",1);
return undef;
}
#######################################################################################
#
# OWCOUNT_Attr - Set one attribute value for device
#
# Parameter hash = hash of device addressed
# a = argument array
#
#######################################################################################
sub OWCOUNT_Attr(@) {
my ($do,$name,$key,$value) = @_;
my $hash = $defs{$name};
my $ret;
if ( $do eq "set") {
ARGUMENT_HANDLER: {
#-- interval modified at runtime
$key eq "interval" and do {
#-- check value
return "OWCOUNT: set $name interval must be >= 0" if(int($value) < 0);
#-- update timer
$hash->{INTERVAL} = int($value);
if ($init_done) {
RemoveInternalTimer($hash);
InternalTimer(gettimeofday()+$hash->{INTERVAL}, "OWCOUNT_GetValues", $hash, 0);
}
last;
};
$key eq "IODev" and do {
AssignIoPort($hash,$value);
if( defined($hash->{IODev}) ) {
if ($init_done) {
OWCOUNT_Init($hash);
}
}
last;
};
}
}
return $ret;
}
########################################################################################
#
# OWCOUNT_ChannelNames - find the real channel names
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWCOUNT_ChannelNames($) {
my ($hash) = @_;
my $name = $hash->{NAME};
my $state = $hash->{READINGS}{"state"}{VAL};
my ($cname,@cnama,$unit,@unarr,$runit,$period);
my $nomemory = defined($attr{$name}{"nomemory"}) ? $attr{$name}{"nomemory"} : 0;
$gets{"memory"} = ($nomemory) ? ":noArg" : ":0,1,2,3,4,5,6,7,8,9,10,11,12,13";
$gets{"mcache"} = $gets{"memory"};
$gets{"midnight"}=":";
for (my $i=0;$i<int(@owg_fixed);$i++){
#-- name
$cname = defined($attr{$name}{$owg_fixed[$i]."Name"}) ? $attr{$name}{$owg_fixed[$i]."Name"} : "$owg_fixed[$i]";
@cnama = split(/\|/,$cname);
if( int(@cnama)!=2){
push(@cnama,$cnama[0]);
}
#-- unit
$unit = defined($attr{$name}{$owg_fixed[$i]."Unit"}) ? $attr{$name}{$owg_fixed[$i]."Unit"} : "cts";
if( $unit eq "none" ){
$unit = "";
}else{
$unit = " ".$unit;
}
#-- put into readings
$owg_channel[$i]=$cnama[0];
$hash->{READINGS}{$owg_channel[$i]}{ABBR} = $cnama[1];
$gets{"midnight"} .= $cnama[0];
$gets{"midnight"} .= ","
if ($i<(int(@owg_fixed)-1))
;
$hash->{READINGS}{$owg_channel[$i]}{UNIT} = $unit;
$period = defined($attr{$name}{$owg_fixed[$i]."Period"}) ? $attr{$name}{$owg_fixed[$i]."Period"} : "hour";
#-- put into readings
$hash->{READINGS}{$owg_channel[$i]}{PERIOD} = $period;
#-- rate
$cname = defined($attr{$name}{$owg_fixed[$i]."Rate"}) ? $attr{$name}{$owg_fixed[$i]."Rate"} :
(defined($attr{$name}{$owg_fixed[$i]."Name"}) ? "$cnama[0]_rate|$cnama[1]_r" : "$owg_fixed[$i]_rate|$owg_fixed[$i]_r");
@cnama = split(/\|/,$cname);
if( int(@cnama)!=2){
push(@cnama,$cnama[0]);
}
#-- rate unit
if( $unit ne " " ){
if( $period eq "hour" ){
$unit .= "/h";
}elsif( $period eq "minute" ){
$unit .= "/min";
} else {
$unit .= "/s";
}
}
#-- some special cases
# Energy/Power
$unit = " kW"
if ($unit eq " kWh/h" );
#-- put into readings
$owg_rate[$i]=$cnama[0];
$hash->{READINGS}{$owg_rate[$i]}{ABBR} = $cnama[1];
$hash->{READINGS}{$owg_rate[$i]}{UNIT} = $unit;
}
$gets{"raw"} = $gets{"midnight"};
}
########################################################################################
#
# OWCOUNT_FormatValues - put together various format strings and assemble STATE variable
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWCOUNT_FormatValues($) {
my ($hash) = @_;
my $name = $hash->{NAME};
my ($offset,$factor,$period,$unit,$runit,$vval,$vrate);
my ($svalue,$dvalue,$mvalue) = ("","","");
my $galarm = 0;
my ($sec, $min, $hour, $day, $month, $year, $wday,$yday,$isdst) = localtime(time);
my ($seco,$mino,$houro,$dayo,$montho,$yearo,$dayrest);
my ($daily, $dt,$dval,$dval2,$deltim,$delt,$delf);
my ($total,$total0,$total1,$total2,$total3,@monthv,@yearv);
my $daybreak = 0;
my $monthbreak = 0;
#-- no change in any value if invalid reading
for (my $i=0;$i<int(@owg_fixed);$i++){
return if( $hash->{owg_val}->[$i] eq "");
}
#-- obtain channel names
OWCOUNT_ChannelNames($hash);
#-- Check, whether we have a new day at the next reading
$deltim = $hour*60.0+$min+$sec/60.0 + $hash->{INTERVAL}/60.0 - 1440;
#$deltim = $min+$sec/60.0 - 55;
if( $deltim>=0 ){
$daybreak = 1;
$monthbreak = 0;
#-- Timer data from tomorrow
my ($secn,$minn,$hourn,$dayn,$monthn,$yearn,$wdayn,$ydayn,$isdstn) = localtime(time() + $hash->{INTERVAL} + 3600);
#-- Check, whether we have a new month
if( $dayn == 1 ){
$monthbreak = 1;
}
}
#-- put into READING
readingsBeginUpdate($hash);
#-- Check memory string only if model is defined automatically
# TODO: REMOVE THIS TAKES TOO MUCH TIME IN FORMAT
if( $owgauto ){
my $msg = "OWCOUNT: In device $name, ";
if( $owg_memory[2]==1 ){
if( ($owg_memory[0]==1) && ($owg_memory[1]==1) ){
Log 1, $msg."memory pages 0..13 and midnight store present, model should be DS2423"
if( $attr{$name}{"model"} ne "DS2423");
}elsif( ($owg_memory[0]==0) && ($owg_memory[1]==1) ){
Log 1, $msg."midnight store only, model should be DS2423enew"
if( $attr{$name}{"model"} ne "DS2423enew");
}else{
Log 1, $msg."no memory pages and no midnight store found, model should be DS2423eold"
if( $attr{$name}{"model"} ne "DS2423eold");
}
$owg_memory[2]=0;
}
$owgauto=0;
}
#-- formats for output
for (my $i=0;$i<int(@owg_fixed);$i++){
#-- mode normal or daily
$daily = 0;
if( defined($attr{$name}{$owg_fixed[$i]."Mode"} )){
if( $attr{$name}{$owg_fixed[$i]."Mode"} eq "daily"){
$daily = 1;
}
}
#-- offset and scale factor
$offset = defined($attr{$name}{$owg_fixed[$i]."Offset"}) ? $attr{$name}{$owg_fixed[$i]."Offset"} : 0;
$factor = defined($attr{$name}{$owg_fixed[$i]."Factor"}) ? $attr{$name}{$owg_fixed[$i]."Factor"} : 1;
#-- put into READINGS
$hash->{READINGS}{$owg_channel[$i]}{OFFSET} = $offset;
$hash->{READINGS}{$owg_channel[$i]}{FACTOR} = $factor;
$unit = $hash->{READINGS}{$owg_channel[$i]}{UNIT};
$period = $hash->{READINGS}{$owg_channel[$i]}{PERIOD};
$runit = $hash->{READINGS}{$owg_rate[$i]}{UNIT};
#-- skip some things if undefined
if( $hash->{owg_val}->[$i] eq ""){
$svalue .= $owg_channel[$i]." ???";
}else{
#-- only if attribute value mode=daily, take the midnight value from memory
if( $daily == 1){
$vval = int( (($hash->{owg_val}->[$i] + $offset)*$factor - $hash->{owg_midnight}->[$i])*10000+0.5)/10000;
} else {
$vval = int( ($hash->{owg_val}->[$i] + $offset)*$factor*10000+0.5)/10000;
}
#-- rate calculation: get the old values
my $oldval = $hash->{READINGS}{$owg_channel[$i]}{VAL};
my $oldtim = $hash->{READINGS}{$owg_channel[$i]}{TIME};
$oldtim = "" if(!defined($oldtim));
#-- safeguard against the case where no previous measurement
if( length($oldtim) > 0 ){
#-- correct counter wraparound since last reading
if( $vval < $oldval) {
$oldval -= (65536*$factor);
}
#-- previous measurement time
($yearo,$montho,$dayrest) = split(/-/,$oldtim);
$dayo = substr($dayrest,0,2);*60=
($houro,$mino,$seco) = split(/:/,substr($dayrest,3));
#-- time difference to previous measurement and to midnight
$delt = ($hour-$houro)*3600 + ($min-$mino)*60 + ($sec-$seco);
$delf = $hour *3600 + $min *60 + $sec - 86400;
#-- rate
if( $delt > 0.0){
$vrate = ($vval-$oldval)/$delt;
} else {
$vrate = 0.0;
}
#-- correct rate for period setting
if( $period eq "hour" ){
$vrate*=3600;
}elsif( $period eq "minute" ){
$vrate*=60;
}
$vrate = int($vrate * 10000+0.5)/10000;
#--midnight extrapolation only possible if previous measurement
if( $daybreak==1 ){
#-- linear extrapolation
if( $delt > 0.0 ){
$dt = -$delf/$delt;
$dval = int(($vval+($vval-$oldval)*$dt)*10000+0.5)/10000;
Log3 $name,5,"OWCOUNT: midnight extrapolation $name channel ".$owg_channel[$i]." with time delta $delt, dt $dt and dval=$dval";
}else{
Log3 $name,5,"OWCOUNT: midnight extrapolation $name channel ".$owg_channel[$i]." fails because of zero time delta. dval=$dval";
}
if( $daily == 1 ){
$dval2 = $dval+$hash->{owg_midnight}->[$i];
} else {
$dval2 = $dval;
}
#-- in any mode store the interpolated value in the midnight store
my $msg = sprintf("%4d-%02d-%02d midnight %7.2f ",
$year+1900,$month+1,$day,$dval2);
Log3 $name,5,"OWCOUNT: measured $name value $vval (midnight ".$hash->{owg_midnight}->[$i].") => extrapolated midnight $dval2";
OWCOUNT_SetPage($hash,14+$i,$msg);
#-- string buildup for monthly and yearly logging
$dvalue .= sprintf( " %s: %5.2f %s %sM: %%5.2f %s", $owg_channel[$i],$dval,$unit,$owg_channel[$i],$unit);
$mvalue .= sprintf( " %sM: %%5.2f %s %sY: %%5.2f %s", $owg_channel[$i],$unit,$owg_channel[$i],$unit);
} #-- end daybreak
#-- string buildup for return value and STATE
#-- 1 or 3 decimals
my $fs = ( $factor == 1.0 )? "%s: %5.2f %s %s: %5.2f %s" : "%s: %5.3f %s %s: %5.3f %s";
$svalue .= sprintf( $fs, $hash->{READINGS}{$owg_channel[$i]}{ABBR}, $vval,$unit,$hash->{READINGS}{$owg_rate[$i]}{ABBR},$vrate,$runit);
#-- 3 decimals
}
readingsBulkUpdate($hash,$owg_channel[$i],$vval);
readingsBulkUpdate($hash,$owg_rate[$i],$vrate);
}
#-- insert space
if( $i<int(@owg_fixed)-1 ){
$svalue .= " ";
$dvalue .= " ";
}
}#-- end channel loop
#-- daybreak postprocessing
if( $daybreak == 1 ){
#-- daily/monthly accumulated value
@monthv = OWCOUNT_GetMonth($hash);
@yearv = OWCOUNT_GetYear($hash);
#-- put in monthly and yearly sums
if( int(@monthv) == 2 ){
$total0 = $monthv[0]->[1];
$total1 = ($day==1)?$total0:$monthv[1]->[1];
$dvalue = sprintf("D%02d ",$day).$dvalue;
$dvalue = sprintf($dvalue,$total0,$total1);
readingsBulkUpdate($hash,"day",$dvalue);
}else{
Log3 $name,5,"OWCOUNT: No monthly summary possible, ".$monthv[0]." for device $name";
$total0 = 0;
$total1 = 0;
}
if( int(@yearv) == 2 ){
$total2 = $yearv[0]->[1];
$total3 = ($month==0)?$total2: $yearv[1]->[1];
if ( $monthbreak == 1){
$mvalue = sprintf("M%02d ",$month+1).$mvalue;
$mvalue = sprintf($mvalue,$total0,$total2,$total1,$total3);
readingsBulkUpdate($hash,"month",$mvalue);
}
}else{
Log3 $name,5,"OWCOUNT: No yearly summary possible, ".$yearv[0]." for device $name";
$total2 = 0;
$total3 = 0;
}
}
#--- memory most recently read
readingsBulkUpdate($hash,"memory",$hash->{DATA}{memory});
#-- STATE
readingsBulkUpdate($hash,"state",$svalue);
readingsEndUpdate($hash,1);
return $svalue;
}
########################################################################################
#
# OWCOUNT_Get - Implements GetFn function
#
# Parameter hash = hash of device addressed, a = argument array
#
########################################################################################
sub OWCOUNT_Get($@) {
my ($hash, @a) = @_;
my $reading = $a[1];
my $name = $hash->{NAME};
my $model = $hash->{OW_MODEL};
my $master = $hash->{IODev};
my $value = undef;
my $ret = "";
my $page;
my ($unit,$daily);
my ($ret1,$ret2);
#-- check syntax
return "OWCOUNT: get $name argument is missing @a"
if(int(@a) < 2);
#-- check argument
my $msg = "OWCOUNT: Get with unknown argument $a[1], choose one of ";
$msg .= "$_$gets{$_} " foreach (keys%gets);
return $msg
if(!defined($gets{$a[1]}));
#-- get id
if($a[1] eq "id") {
$value = $hash->{ROM_ID};
return "$name.id => $value";
}
#-- get version
if( $a[1] eq "version") {
return "$name.version => $owx_version";
}
#-- get channel names
OWCOUNT_ChannelNames($hash);
#-- get month
if($a[1] eq "month") {
$value="$name.month =>\n";
my @month2 = OWCOUNT_GetMonth($hash);
#-- error case
if( int(@month2) != 2 ){
return $value." no monthly summary possible, ".$month2[0];
}
#-- 3 entries for each day
for(my $i=0;$i<int(@month2);$i++){
$unit = $hash->{READINGS}{$owg_channel[$i]}{UNITABBR};
#-- mode = daily ?
$daily = 0;
if( defined($attr{$name}{$owg_fixed[$i]."Mode"} )){
if( $attr{$name}{$owg_fixed[$i]."Mode"} eq "daily"){
$daily = 1;
}
}
if( $daily==1){
$value .= $owg_channel[$i]."M: ".$month2[$i]->[1]." ".$unit.
" (monthly sum until now, average ".$month2[$i]->[2]." ".$unit."/d)\n";
}else{
$value .= $owg_channel[$i]."M: ".$month2[$i]->[1]." ".$unit." (last midnight)\n";
}
}
return $value;
}
#-- get year
if($a[1] eq "year") {
$value="$name.year =>\n";
my @year2 = OWCOUNT_GetYear($hash);
#-- error case
if( int(@year2) != 2 ){
return $value." no yearly summary possible, ".$year2[0];
}
#-- 3 entries for each month
for(my $i=0;$i<int(@year2);$i++){
$unit = $hash->{READINGS}{$owg_channel[$i]}{UNITABBR};
#-- mode = daily ?
$daily = 0;
if( defined($attr{$name}{$owg_fixed[$i]."Mode"} )){
if( $attr{$name}{$owg_fixed[$i]."Mode"} eq "daily"){
$daily = 1;
}
}
if( $daily==1){
$value .= $owg_channel[$i]."Y: ".$year2[$i]->[1]." ".$unit.
" (yearly sum until now, average ".$year2[$i]->[2]." ".$unit."/d)\n";
}else{
$value .= $owg_channel[$i]."Y: ".$year2[$i]->[1]." ".$unit."\n";
}
}
return $value;
}
#-- get memory page/counter according to interface type
my $interface= $hash->{IODev}->{TYPE};
#-- check syntax for getting memory page 0..13 or midnight A/B
my $nomemory = defined($attr{$name}{"nomemory"}) ? $attr{$name}{"nomemory"} : 0;
if( ($reading eq "memory") || ($reading eq "mcache") ){
return "OWCOUNT: Memory usage disabled in $name"
if( $nomemory==1 );
return "OWCOUNT: get $name memory/mcache: needs parameter <page>"
if( int(@a)<2 );
$page=int($a[2]);
if( ($page<0) || ($page>13) ){
return "OWCOUNT: get $name memory/mcache requested wrong page $page";
}
if( $reading eq "memory" ){
$ret = OWCOUNT_GetPage($hash,$page,1,1);
#-- process result
if( $master->{ASYNCHRONOUS} ){
#return "OWCOUNT: $name getting memory $page, please wait for completion";
return undef;
}else{
#-- when we have a return code, we have an error
if( $ret ){
return "OWCOUNT: get $name failed, reason: ".$ret;
}else{
return "OWCOUNT: $name.$reading [$page] =>".$hash->{owg_str}->[$page];
}
}
}else{
return "OWCOUNT: $name.$reading [$page] =>".$hash->{owg_str}->[$page];
}
}
#-- get midnight value
if( $reading eq "midnight" ){
return "OWCOUNT: get $name midnight needs parameter <channel>"
if( int(@a)<3 );
#-- find out which channel we have
if( ($a[2] eq $owg_channel[0]) || ($a[2] eq "A") ){
$page=14;
}elsif( ($a[2] eq $owg_channel[1]) || ($a[2] eq "B") ){
$page=15;
} else {
return "OWCOUNT: get $name midnight has invalid counter address, must be A, B or defined channel name"
}
$ret = OWCOUNT_GetPage($hash,$page,1,1);
#-- process result
if( $master->{ASYNCHRONOUS} ){
return undef;
}else{
#-- when we have a return code, we have an error
if( $ret ){
return "OWCOUNT: get $name midnight failed, reason: ".$ret;
}else{
return "OWCOUNT: $name.$reading [$page] =>".$hash->{owg_midnight}->[$page-14];
}
}
}
#-- check syntax for getting counter
if( $reading eq "raw" ){
return "OWCOUNT: get $name raw needs parameter <channel>"
if( int(@a)<2 );
#-- find out which channel we have
if( ($a[2] eq $owg_channel[0]) || ($a[2] eq "A") ){
$page=14;
}elsif( ($a[2] eq $owg_channel[1]) || ($a[2] eq "B") ){
$page=15;
} else {
return "OWCOUNT: get $name raw has invalid counter address, must be A, B or defined channel name"
}
$ret = OWCOUNT_GetPage($hash,$page,1,1);
#-- process result
if( $master->{ASYNCHRONOUS} ){
return undef;
}else{
#-- when we have a return code, we have an error
if( $ret ){
return "OWCOUNT: get $name raw failed, reason: ".$ret;
}
#-- only one counter will be returned
return "OWCOUNT: $name.raw $a[2] => ".$hash->{owg_val}->[$page-14];
}
#-- check syntax for getting counters
}elsif( $reading eq "counters" ){
return "OWCOUNT: get $name counters needs no parameter"
if( int(@a)==1 );
$ret1 = OWCOUNT_GetPage($hash,14,0,1);
$ret2 = OWCOUNT_GetPage($hash,15,1,1);
#-- process result
if( $master->{ASYNCHRONOUS} ){
return undef;
}else{
$ret .= $ret1
if( defined($ret1) );
$ret .= $ret2
if( defined($ret2) );
if( defined($ret1) || defined($ret2) ){
return "OWCOUNT: get $name counters failed, reason: ".$ret;
}
#-- both counters will be returned
return "OWCOUNT: $name.counters => ".$hash->{READINGS}{"state"}{VAL};
}
}
}
#######################################################################################
#
# OWCOUNT_GetPage - Get a memory page
#
# Parameter hash = hash of device addressed
# page = page addressed
# final= 1 if FormatValues is to be called
#
########################################################################################
sub OWCOUNT_GetPage ($$$@) {
my ($hash, $page,$final,$sync) = @_;
#-- get memory page/counter according to interface type
my $master= $hash->{IODev};
my $interface= $hash->{IODev}->{TYPE};
my $name = $hash->{NAME};
my $ret;
#-- check if memory usage has been disabled
my $nomemory = defined($attr{$name}{"nomemory"}) ? $attr{$name}{"nomemory"} : 0;
#-- even if memory usage has been disabled, we need to read the page because it contains the counter values
if( ($nomemory==0) || ($nomemory==1 && (($page==14)||($page==15))) ){
#-- OWX interface
if( $interface eq "OWX" ){
$ret = OWXCOUNT_GetPage($hash,$page,$final);
#-- OWFS interface
}elsif( $interface eq "OWServer" ){
$ret = OWFSCOUNT_GetPage($hash,$page,$final);
#-- Unknown interface
}else{
return "OWCOUNT: GetPage with wrong IODev type $interface";
}
#-- process results
if( defined($ret) ){
return "OWCOUNT: Could not get values from device $name, reason: ".$ret;
}
}
return undef
}
########################################################################################
#
# OWCOUNT_GetMonth Read monthly data from a file
#
# Parameter hash
#
# Returns total value up to last day, including this day and average including this day
#
########################################################################################
sub OWCOUNT_GetMonth($) {
my ($hash) = @_;
my $name = $hash->{NAME};
my $regexp = ".*$name.*";
my $val;
my @month = ();
my @month2 = ();
my @mchannel;
my @linarr;
my $day;
my $line;
my ($total,$total2,$daily,$deltim,$av);
#-- Check current logfile
my $ln = $attr{$name}{"LogM"};
if( !(defined($ln))){
return "attribute LogM is missing";
}
#-- get channel names
OWCOUNT_ChannelNames($hash);
my $lf = $defs{$ln}{currentlogfile};
if( !(defined($lf))){
return "logfile of LogM is missing";
}
#-- current date
my ($csec,$cmin,$chour,$cday,$cmonth,$cyear,$cwday,$cyday,$cisdst) = localtime(time);
my $ret = open(OWXFILE, "< $lf" );
if( $ret) {
while( <OWXFILE> ){
#-- line looks as
# 2013-06-25_23:57:57 DG.CT1 day: D25 W: 42.2 kWh Wm: 84.4 kWh B: 2287295.7 cts Bm: 2270341.0 cts
$line = $_;
chomp($line);
if ( $line =~ m/$regexp/i){
@linarr = split(' ',$line);
if( int(@linarr)==4+6*int(@owg_fixed) ){
$day = $linarr[3];
$day =~ s/D_+0+//;
@mchannel = ();
for (my $i=0;$i<int(@owg_fixed);$i++){
$val = $linarr[5+6*$i];
push(@mchannel,$val);
}
push(@month,[@mchannel]);
}
}
}
if( int(@month)<($cday-1) ){
Log3 $name,3, "OWCOUNT: warning, found only ".int(@month)." lines in logfile $lf of LogM";
}
} else {
return "cannot open logfile of LogM";
}
#-- sum and average
for (my $i=0;$i<int(@owg_fixed);$i++){
$total = 0.0;
#-- summing only if mode daily (means daily reset !)
$daily = 0;
if( defined($attr{$name}{$owg_fixed[$i]."Mode"} )){
if( $attr{$name}{$owg_fixed[$i]."Mode"} eq "daily"){
$daily = 1;
}
}
if( $daily==1){
for (my $j=0;$j<int(@month);$j++){
$total += $month[$j][$i];
}
}
#-- add data from current day also for non-summed mode
$total = int($total*100)/100;
$total2 = int(100*($total+$hash->{READINGS}{$owg_channel[$i]}{VAL}))/100;
#-- number of days so far, including the present day
my $deltim = int(@month)+($chour+$cmin/60.0 + $csec/3600.0)/24.0;
my $av = $deltim>0 ? int(100*$total2/$deltim)/100 : -1;
#-- output format
push(@month2,[($total,$total2,$av)]);
}
return @month2;
}
########################################################################################
#
# OWCOUNT_GetYear Read yearly data from a file
#
# Parameter hash
#
# Returns total value up to last month including this month and average including this day
#
########################################################################################
sub OWCOUNT_GetYear($) {
my ($hash) = @_;
my $name = $hash->{NAME};
my $regexp = ".*$name.*";
my $val;
my @year = ();
my @year2 = ();
my @mchannel;
my @linarr;
my $month;
my $line;
my ($total,$total2,$daily,$deltim,$av);
#-- Check current logfile
my $ln = $attr{$name}{"LogY"};
if( !(defined($ln))){
return "attribute LogY is missing";
}
#-- get channel names
OWCOUNT_ChannelNames($hash);
#-- current date
my ($csec,$cmin,$chour,$cday,$cmonth,$cyear,$cwday,$cyday,$cisdst) = localtime(time);
my $lf = $defs{$ln}{currentlogfile};
if( !(defined($lf))){
return "logfile of LogY is missing";
}
my $ret = open(OWXFILE, "< $lf" );
if( $ret) {
while( <OWXFILE> ){
#-- line looks as
# 2013-05-31_23:57:57 DG.CT1 month: M05 W: 42.2 kWh Wy: 84.4 kWh B: 2287295.7 cts By: 2270341.0 cts
$line = $_;
chomp($line);
if ( $line =~ m/$regexp/i){
@linarr = split(' ',$line);
if( int(@linarr)==4+6*int(@owg_fixed) ){
$month = $linarr[3];
$month =~ s/M_+0+//;
@mchannel = ();
for (my $i=0;$i<int(@owg_fixed);$i++){
$val = $linarr[5+6*$i];
push(@mchannel,$val);
}
push(@year,[@mchannel]);
}
}
}
if( int(@year)<($cmonth-1) ){
Log3 $name,3, "OWCOUNT: warning, found only ".int(@year)." lines in logfile $lf of LogY";
}
} else {
return "cannot open logfile of LogY";
}
#-- sum and average
my @month2 = OWCOUNT_GetMonth($hash);
for (my $i=0;$i<int(@owg_fixed);$i++){
$total = 0.0;
$daily = 0;
if( defined($attr{$name}{$owg_fixed[$i]."Mode"} )){
if( $attr{$name}{$owg_fixed[$i]."Mode"} eq "daily"){
$daily = 1;
}
}
#-- sum previous months only in daily mode
if( $daily==1){
for (my $j=0;$j<int(@year);$j++){
$total += $year[$j][$i];
}
}else{
$total = $year[int(@year)-1][$i]
if (int(@year)>0);
};
$total = int($total*100)/100;
#-- data from this month is
$total2 = int(100*($month2[$i]->[1]))/100;
#-- add data from this month and previous months in daily mode
$total2+=$total
if( $daily==1 );
#-- number of days so far, including the present day
my $deltim = $cyday+($chour+$cmin/60.0 + $csec/3600.0)/24.0;
my $av = $deltim>0 ? int(100*$total2/$deltim)/100 : -1;
#-- output format
push(@year2,[($total,$total2,$av)]);
}
return @year2;
}
#######################################################################################
#
# OWCOUNT_GetValues - Updates the reading from one device
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWCOUNT_GetValues($) {
my $hash = shift;
my $name = $hash->{NAME};
my $model = $hash->{OW_MODEL};
my $value = "";
my $ret = "";
my ($ret1,$ret2);
#-- check if device needs to be initialized
OWCOUNT_InitializeDevice($hash)
if( $hash->{READINGS}{"state"}{VAL} eq "defined");
RemoveInternalTimer($hash);
#-- auto-update for device disabled;
return undef
if( $hash->{INTERVAL} == 0 );
#-- restart timer for updates
InternalTimer(time()+$hash->{INTERVAL}, "OWCOUNT_GetValues", $hash, 0);
#-- Get readings
$ret1 = OWCOUNT_GetPage($hash,14,0);
$ret2 = OWCOUNT_GetPage($hash,15,1);
#-- process results
$ret .= $ret1
if( defined($ret1) );
$ret .= $ret2
if( defined($ret2) );
if( $ret ne "" ){
return "OWCOUNT: Could not get values from device $name, reason: ".$ret;
}
return undef;
}
#######################################################################################
#
# OWCOUNT_ParseMidnight - Read the stored midnight value
#
# Parameter hash = hash of device addressed
# strval = data string
# page = page number
#
########################################################################################
sub OWCOUNT_ParseMidnight($$$) {
my ($hash,$strval,$page) = @_;
my $name = $hash->{NAME};
#-- midnight value
#-- new format
if ( defined $strval and $strval =~ /^\d\d\d\d-\d\d-\d\d.*/ ) {
my @data=split(' ',$strval);
$strval = $data[2];
}
if ( defined $strval ) {
#-- parse float from midnight
$strval =~ s/[^-\d\.]+//g;
$strval = 0.0 if($strval !~ /^-?\d+\.\d*$/);
$strval = int($strval*100)/100;
} else {
$strval = 0.0;
}
$hash->{owg_midnight}->[$page-14] = $strval;
}
#######################################################################################
#
# OWCOUNT_Set - Set one value for device
#
# Parameter hash = hash of device addressed
# a = argument array
#
########################################################################################
sub OWCOUNT_Set($@) {
my ($hash, @a) = @_;
my $name = $hash->{NAME};
my $model = $hash->{OW_MODEL};
my $ret = undef;
my $page;
my $data;
my $key = $a[1];
my $value = $a[2];
my ($cname,@cnama,@channel);
#-- for the selector: which values are possible
if (@a == 2){
my $newkeys = join(" ", keys %sets);
return $newkeys ;
}
#-- check syntax
return "OWCOUNT: set $name needs at least one parameter"
if( int(@a)<3 );
#-- check argument
if( !defined($sets{$a[1]}) ){
return "OWCOUNT: set $name with unknown argument $a[1]";
}
#-- set new timer interval
if($key eq "interval") {
# check value
return "OWCOUNT: set $name interval must be >= 0"
if(int($value) < 0);
# update timer
$hash->{INTERVAL} = int($value);
RemoveInternalTimer($hash);
InternalTimer(gettimeofday()+$hash->{INTERVAL}, "OWCOUNT_GetValues", $hash, 0);
return undef;
}
#-- get channel names
OWCOUNT_ChannelNames($hash);
#-- set memory page/counter according to interface type
my $interface= $hash->{IODev}->{TYPE};
#-- check syntax for setting memory page 0..13
my $nomemory = defined($attr{$name}{"nomemory"}) ? $attr{$name}{"nomemory"} : 0;
if( $key eq "memory" ){
return "OWCOUNT: set $name memory usage disabled"
if( $nomemory==1 );
return "OWCOUNT: set $name memory needs parameter <page>"
if( int(@a)<2 );
$page=int($a[2]);
if( ($page<0) || ($page>13) ){
return "OWXCOUNT: set $name memory with wrong page $page attempted";
}
$data=$a[3];
for( my $i=4;$i<int(@a);$i++){
$data.=" ".$a[$i];
}
$ret = OWCOUNT_SetPage($hash,$page,$data);
}
#-- other commands are per channel
if( ($key eq "midnight") || ($key eq "counter" )){
return "OWCOUNT: set $name $key needs parameter: <channel>"
if( int(@a)<2 );
#-- find out which channel we have
if( ($a[2] eq $owg_channel[0]) || ($a[2] eq "A") ){
$page=14;
}elsif( ($a[2] eq $owg_channel[1]) || ($a[2] eq "B") ){
$page=15;
} else {
return "OWCOUNT: set $name $key has invalid counter address, must be A, B or defined channel name"
}
#-- mode normal or daily
my $daily = 0;
if( defined($attr{$name}{$owg_fixed[$page-14]."Mode"} )){
if( $attr{$name}{$owg_fixed[$page-14]."Mode"} eq "daily"){
$daily = 1;
}
}
return "OWCOUNT: set $name $key for channel $a[2] not possible, is not in daily mode"
if( $daily==0 );
my ($sec, $min, $hour, $day, $month, $year, $wday,$yday,$isdst) = localtime(time);
if( $key eq "midnight" ){
$data = sprintf("%4d-%02d-%02d midnight %7.2f ",
$year+1900,$month+1,$day,$a[3]);
$ret = OWCOUNT_SetPage($hash,$page,$data);
}
#--
if( $key eq "counter" ){
my $midnew=($hash->{owg_val}->[$page-14] + $hash->{READINGS}{$owg_channel[$page-14]}{OFFSET})*
$hash->{READINGS}{$owg_channel[$page-14]}{FACTOR} - $a[3];
$data = sprintf("%4d-%02d-%02d midnight %7.2f ",
$year+1900,$month+1,$day,$midnew);
Log3 $name,1,"OWCOUNT: old midnight value for device $name ".$hash->{owg_midnight}->[$page-14].", replaced by $midnew";
$ret = OWCOUNT_SetPage($hash,$page,$data);
}
}
#-- process results - we have to reread the device
if( defined($ret) && ($ret ne "") ){
return "OWCOUNT: set $name $key failed, reason: ".$ret;
}
#-- Took this out, not possible in asynchronous mode
#OWCOUNT_GetValues($hash);
Log3 $name,5, "OWCOUNT: set $name $key $value";
}
#######################################################################################
#
# OWCOUNT_SetPage - Set one value for device
#
# Parameter hash = hash of device addressed
# page = page addressed
# data = data
#
########################################################################################
sub OWCOUNT_SetPage ($$$) {
my ($hash, $page, $data) = @_;
#-- set memory page/counter according to interface type
my $interface= $hash->{IODev}->{TYPE};
my $name = $hash->{NAME};
my $ret;
#-- check if memory usage has been disabled
my $nomemory = defined($attr{$name}{"nomemory"}) ? $attr{$name}{"nomemory"} : 0;
$data=sprintf("%-32s",$data);
if( $nomemory==0 ){
#-- OWX interface
if( $interface eq "OWX" ){
$ret = OWXCOUNT_SetPage($hash,$page,$data);
#-- OWFS interface
}elsif( $interface eq "OWServer" ){
$ret = OWFSCOUNT_SetPage($hash,$page,$data);
#-- Unknown interface
}else{
return "OWCOUNT: SetPage $name with wrong IODev type $interface";
}
#-- process results
if( defined($ret) && ($ret ne "") ){
return "OWCOUNT: SetPage $name failed, reason: ".$ret;
}
}else{
if( $page==14 ){
return OWCOUNT_store($hash,"OWCOUNT_".$name."_14.dat",$data);
}elsif( $page==15 ){
return OWCOUNT_store($hash,"OWCOUNT_".$name."_15.dat",$data);
} else {
return "OWCOUNT: file store with wrong page number";
}
}
}
########################################################################################
#
# Store daily start value in a file
#
# Parameter hash, filename
#
########################################################################################
sub OWCOUNT_store($$$) {
my ($hash,$filename,$data) = @_;
my $name = $hash->{NAME};
my $mp = AttrVal("global", "modpath", ".");
my $ret = open(OWXFILE, "> $mp/FHEM/$filename" );
if( $ret) {
print OWXFILE $data;
Log3 $name,1, "OWCOUNT_store: $name $data";
close(OWXFILE);
return undef;
} else {
Log3 $name,1,"OWCOUNT_store: Cannot open $filename for writing!";
return $ret;
}
}
########################################################################################
#
# OWCOUNT_recall Recall daily start value from a file
#
# Parameter hash,filename
#
########################################################################################
sub OWCOUNT_recall($$) {
my ($hash,$filename) = @_;
my $name= $hash->{NAME};
my $mp = AttrVal("global", "modpath", ".");
my $ret = open(OWXFILE, "< $mp/FHEM/$filename" );
if( $ret ){
my $line = readline OWXFILE;
close(OWXFILE);
return $line;
}
Log3 $name,1, "OWCOUNT_recall: Cannot open $filename for reading, 2nd attempt";
$ret = OWCOUNT_store($hash,$filename,0);
if (!$ret){
$ret = open(OWXFILE, "< $mp/FHEM/$filename" );
if( $ret ){
my $line = readline OWXFILE;
close(OWXFILE);
return $line;
}
Log3 $name,1, "OWCOUNT_recall: Cannot open $filename for reading - tried twice";
return "error";
}
}
########################################################################################
#
# OWCOUNT_Undef - Implements UndefFn function
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWCOUNT_Undef ($) {
my ($hash) = @_;
delete($modules{OWCOUNT}{defptr}{$hash->{OW_ID}});
RemoveInternalTimer($hash);
return undef;
}
########################################################################################
#
# The following subroutines in alphabetical order are only for a 1-Wire bus connected
# via OWFS
#
# TODO: So far no automatic recognition of DS2423 / Emulator
#
# Prefix = OWFSCOUNT
#
########################################################################################
#
# OWFSCOUNT_GetPage - Get page from device
#
# Parameter hash = hash of device addressed
# page = page to be read
# final= 1 if FormatValues is to be called
#
########################################################################################
sub OWFSCOUNT_GetPage($$$) {
my ($hash,$page,$final) = @_;
#-- ID of the device
my $owx_add = substr($hash->{ROM_ID},0,15);
#-- hash of the busmaster
my $master = $hash->{IODev};
my $name = $hash->{NAME};
#-- reset presence
$hash->{PRESENT} = 0;
my $vval;
my $strval;
#=============== wrong value requested ===============================
if( ($page<0) || ($page>15) ){
return "wrong memory page requested";
}
my $nomemory = defined($attr{$name}{"nomemory"}) ? $attr{$name}{"nomemory"} : 0;
#-- get values - or shoud we rather get the uncached ones ?
if( $page == 14 || $page == 15 ) {
$vval = OWServer_Read($master,"/$owx_add/counters.$owg_fixed[$page-14]");
return "no return from OWServer for counter.$owg_fixed[$page-14]" unless defined $vval;
return "empty return from OWServer for counter.$owg_fixed[$page-14]" if($vval eq "");
if ($nomemory == 0) {
$strval = OWServer_Read($master,"/$owx_add/pages/page.$page");
return "no return from OWServer for page.$page" unless defined $strval;
return "empty return from OWServer for page.$page" if($strval eq "");
} else {
$strval = OWCOUNT_recall($hash,"OWCOUNT_".$hash->{NAME}."_".$page.".dat");
}
$hash->{owg_val}->[$page-14] = $vval;
$hash->{owg_str}->[$page] = defined $strval ? $strval : "";
#-- midnight value
OWCOUNT_ParseMidnight($hash,$strval,$page);
}else {
$strval = OWServer_Read($master,"/$owx_add/pages/page.".$page);
return "no return from OWServer"
if( !defined($strval) );
return "empty return from OWServer"
if( $strval eq "" );
$hash->{owg_str}->[$page] = $strval;
}
#-- and now from raw to formatted values
$hash->{PRESENT} = 1;
if($final==1){
my $value = OWCOUNT_FormatValues($hash);
Log3 $name,5, $value;
}
return undef;
}
########################################################################################
#
# OWFSCOUNT_SetPage - Set page in device
#
# Parameter hash = hash of device addressed
#
########################################################################################
sub OWFSCOUNT_SetPage($$$) {
my ($hash,$page,$data) = @_;
#-- ID of the device
my $owx_add = substr($hash->{ROM_ID},0,15);
#-- hash of the busmaster
my $master = $hash->{IODev};
my $name = $hash->{NAME};
#=============== wrong page requested ===============================
if( ($page<0) || ($page>15) ){
return "wrong memory page write attempt";
}
#=============== midnight value =====================================
if( ($page==14) || ($page==15) ){
OWCOUNT_ParseMidnight($hash,$data,$page);
}
OWServer_Write($master, "/$owx_add/pages/page.".$page,$data );
return undef
}
########################################################################################
#
# The following subroutines in alphabetical order are only for a 1-Wire bus connected
# directly to the FHEM server
#
# Prefix = OWXCOUNT
#
########################################################################################
#
# OWXCOUNT_BinValues - Process reading from one device - translate binary into raw
#
# Parameter hash = hash of device addressed
# context = mode for evaluating the binary data
# proc = processing instruction, also passed to OWX_Read.
# bitwise interpretation !!
# if 0, nothing special
# if 1 = bit 0, a reset will be performed not only before, but also after
# the last operation in OWX_Read
# if 2 = bit 1, the initial reset of the bus will be suppressed
# if 8 = bit 3, the fillup of the data with 0xff will be suppressed
# if 16= bit 4, the insertion will be at the top of the queue
# owx_dev = ROM ID of slave device
# crcpart = part of the data that needs to be part of the CRC check
# numread = number of bytes to receive
# res = result string
#
#
#######################################################################################
sub OWXCOUNT_BinValues($$$$$$$) {
my ($hash, $context, $proc, $owx_dev, $crcpart, $numread, $res) = @_;
#-- hash of the busmaster
my $master = $hash->{IODev};
my $name = $hash->{NAME};
my $error = 0;
my @data = [];
my $value;
my $msg;
OWX_WDBGL($name,4,"OWXCOUNT_BinValues called for device $name in context $context with data ",$res);
return undef unless (defined $context and $context =~ /^(get|set|check)page\.([\d]+)(\.final|)$/);
my $cmd = $1;
my $page = $2;
my $final = $3;
#=============== get memory + counter ===============================
if ($cmd eq "get") {
my (@data,$strval,$value);
my $change = 0;
#-- we have to get rid of the first 12 bytes
if( length($res) == 54 ){
$res=substr($res,12);
}
@data=split(//,$res);
$crcpart = $crcpart.substr($res,0,40);
#-- process results
if( int(@data) != 42){
$error = 1;
$msg = "$name: invalid data length, ".int(@data)." instead of 42 bytes ";
}elsif (OWX_CRC16($crcpart,$data[40],$data[41]) == 0){
$error = 1;
$msg = "$name: invalid CRC, ".ord($data[40])." ".ord($data[41])." ";
}else{
$msg = "$name: no error ";
}
OWX_WDBGL($name,5-$error*4,"OWXCOUNT_BinValues getpage: ".$msg,$res);
#--
my $nomemory = defined($attr{$name}{"nomemory"}) ? $attr{$name}{"nomemory"} : 0;
if( $nomemory==0 ){
#-- memory part, treated as string
$strval=substr($res,0,32);
} else {
$strval = OWCOUNT_recall($hash,"OWCOUNT_".$hash->{NAME}."_".$page.".dat");
}
$hash->{owg_str}->[$page] = defined $strval ? $strval : "";
$hash->{DATA}{memory} = defined $strval ? $strval : "";
#-- counter part
if( ($page == 14) || ($page == 15) ){
@data=split(//,substr($res,32));
#-- does not work with old emulator devices
#if ( ($data[4] | $data[5] | $data[6] | $data[7]) ne "\x00" ){
# $error = 1;
# my $msg = "$name: invalid data in counter page ".ord($data[4])." ".ord($data[5])." ".ord($data[6])." ".ord($data[7]);
# OWX_WDBGL($name,1,"OWXCOUNT_BinValues getpage counter: ".$msg,"")
#}
if( !$error ){
#-- counter value
$value = (ord($data[3])<<24) + (ord($data[2])<<16) +(ord($data[1])<<8) + ord($data[0]);
$hash->{owg_val}->[$page-14] = $value;
#-- midnight value
OWCOUNT_ParseMidnight($hash,$strval,$page);
}
}
if( $error ){
$hash->{ERRCOUNT}=$hash->{ERRCOUNT}+1;
}else{
$hash->{PRESENT} = 1;
#-- and now from raw to formatted values
OWCOUNT_FormatValues($hash)
if( $final );
}
#=============== set memory ===============================
#-- for setting a page we need a second step where the scratchpad is copied into memory
}elsif (($cmd eq "set") && !$final ) {
if( length($res) != 45){
$error = 1;
$msg = "$name: invalid data length, ".length($res)." instead of 45 bytes ";
}else{
$msg = "$name: no error ";
}
OWX_WDBGL($name,5-$error*4,"OWXCOUNT_BinValues: setpage ".$msg,$res);
#-- process results
my $select="\x5A".substr($res,10,3);
#### master slave context proc owx_dev data crcpart numread startread callback delay
# 16 inserts at top of queue
OWX_Qomplex($master, $hash, "setpage.$page.final", 16, $owx_dev, $select, 0, 16, 0, \&OWXCOUNT_BinValues, undef);
#-- and a third step where this is finalized
}elsif (($cmd eq "set") && $final ) {
#-- we have to get rid of the first 10 bytes
if( length($res) == 16 ){
$res=substr($res,10);
}
#-- process results
if( substr($res,4,1) ne "\xAA"){
$error = 1;
$msg = "$name: copy scratchpad to memory not successful ";
}else{
$msg = "$name: no error ";
}
OWX_WDBGL($name,5-$error*4,"OWXCOUNT_BinValues: setpage.$page.final ".$msg,$res);
}
return undef;
}
########################################################################################
#
# OWXCOUNT_GetPage - Get one memory page + counter from device
#
# Parameter hash = hash of device addressed
# page = 0..15
# final= 1 if FormatValues is to be called
#
########################################################################################
sub OWXCOUNT_GetPage($$$) {
my ($hash,$page,$final) = @_;
my ($select, $res, $res2, $res3, @data);
#-- ID of the device, hash of the busmaster
my $owx_dev = $hash->{ROM_ID};
my $master = $hash->{IODev};
#-- reset presence
$hash->{PRESENT} = 0;
#=============== wrong value requested ===============================
if( ($page<0) || ($page>15) ){
return "wrong memory page requested from $owx_dev";
}
#=============== get memory + counter ===============================
#-- issue the match ROM command \x55 and the read memory + counter command
# \xA5 TA1 TA2 reading 40 data bytes and 2 CRC bytes
my $ta2 = ($page*32) >> 8;
my $ta1 = ($page*32) & 255;
$select=sprintf("\xA5%c%c",$ta1,$ta2);
my $context = "getpage.".$page.($final ? ".final" : "");
#-- OLD OWX interface
if( !$master->{ASYNCHRONOUS} ){
#-- reset the bus
OWX_Reset($master);
#-- reading 9 + 3 + 40 data bytes (32 byte memory, 4 byte counter + 4 byte zeroes) and 2 CRC bytes = 54 bytes
$res=OWX_Complex($master,$owx_dev,$select,42);
if( $res eq 0 ){
return "$owx_dev not accessible in reading page $page";
}
#-- process results
if( length($res) < 54 ) {
#-- read the data in a second step
$res.=OWX_Complex($master,"","",0);
#-- process results
if( length($res) < 54 ) {
#-- read the data in a third step
$res.=OWX_Complex($master,"","",0);
}
}
#-- reset the bus (needed to stop receiving data ?)
OWX_Reset($master);
#-- for processing we need 45 bytes
return "$owx_dev not accessible in reading"
if( $res eq 0 );
return "$owx_dev has returned invalid data of length ".length($res)
if( length($res)!=54);
return OWXCOUNT_BinValues($hash,$context,0,$owx_dev,$select,44,substr($res,12));
#-- NEW OWX interface
}else{
#### master slave context proc owx_dev data crcpart numread startread callback delay
# 1 additional reset after last action
OWX_Qomplex($master, $hash, $context, 0, $owx_dev, $select, $select, 54, 0, \&OWXCOUNT_BinValues, undef);
return undef;
}
}
########################################################################################
#
# OWXCOUNT_SetPage - Set one memory page of device
#
# Parameter hash = hash of device addressed
# page = 0..15
# data = string to set into memory
#
########################################################################################
sub OWXCOUNT_SetPage($$$) {
my ($hash,$page,$data) = @_;
my ($select, $res, $res2, $res3);
#-- ID of the device, hash of the busmaster
my $owx_dev = $hash->{ROM_ID};
my $master = $hash->{IODev};
#=============== wrong page requested ===============================
if( ($page<0) || ($page>15) ){
return "OWCOUNT: device $owx_dev wrong memory page write attempt";
}
#=============== midnight value =====================================
if( ($page==14) || ($page==15) ){
OWCOUNT_ParseMidnight($hash,$data,$page);
}
#=============== set memory =========================================
#-- issue the match ROM command \x55 and the write scratchpad command
# \x0F TA1 TA2 followed by the data
my $ta2 = ($page*32) >> 8;
my $ta1 = ($page*32) & 255;
$select=sprintf("\x0F%c%c",$ta1,$ta2).$data;
#-- OLD OWX interface
if( !$master->{ASYNCHRONOUS} ){
#-- reset the bus
OWX_Reset($master);
$res=OWX_Complex($master,$owx_dev,$select,0);
if( $res eq 0 ){
return "OWCOUNT: device $owx_dev not accessible in writing scratchpad";
}
#-- issue the match ROM command \x55 and the read scratchpad command
# \xAA, receiving 2 address bytes, 1 status byte and scratchpad content
$select = "\xAA";
#-- reset the bus
OWX_Reset($master);
#-- reading 9 + 3 + up to 32 bytes
# TODO: sometimes much less than 28
$res=OWX_Complex($master,$owx_dev,$select,28);
if( length($res) < 13 ){
return "OWCOUNT: device $owx_dev not accessible in reading scratchpad";
}
#-- issue the match ROM command \x55 and the copy scratchpad command
# \x5A followed by 3 byte authentication code obtained in previous read
$select="\x5A".substr($res,10,3);
#-- reset the bus
OWX_Reset($master);
$res=OWX_Complex($master,$owx_dev,$select,6);
#-- process results
if( $res eq 0 ){
return "OWCOUNT: device $owx_dev not accessible for copying scratchpad";
}
return undef;
#-- NEW OWX interface
}else{
#### master slave context proc owx_dev data crcpart numread startread callback delay
# 8 prevents from filling up with 0xFF
OWX_Qomplex($master, $hash, "setscratch", 8, $owx_dev, $select, 0, 40, 0, undef, 0.05);
#-- The third step of copying the scratchpad into memory can be scheduled only when the authorization code has been received
# will be done in the callback of the following line
OWX_Qomplex($master, $hash, "setpage.".$page, 0, $owx_dev, "\xAA", 0, 45, 0, \&OWXCOUNT_BinValues, undef);
}
return undef;
}
1;
=pod
=item device
=item summary to commmunicate with 1-Wire Counter/RAM DS2423
=begin html
<a name="OWCOUNT"></a>
<h3>OWCOUNT</h3>
<ul>
<p>FHEM module to commmunicate with 1-Wire Counter/RAM DS2423 or its emulation DS2423emu <br />
<br />This 1-Wire module works with the OWX interface module or with the OWServer interface module
(prerequisite: Add this module's name to the list of clients in OWServer).
Please define an <a href="#OWX">OWX</a> device or <a href="#OWServer">OWServer</a> device first. <br/><p/>
<br /><h4>Example</h4><br />
<code>define OWC OWCOUNT 1D.CE780F000000 60</code>
<br />
<code>attr OWC AName energy|W</code>
<br />
<code>attr OWC AUnit kWh</code>
<br />
<code>attr OWC APeriod hour</code>
<br />
<code>attr OWC ARate power|P</code>
<br />
<code>attr OWX_AMode daily</code>
<br />
<br />
<a name="OWCOUNTdefine"></a>
<h4>Define</h4>
<p>
<code>define &lt;name&gt; OWCOUNT [&lt;model&gt;] &lt;id&gt; [&lt;interval&gt;]</code> or <br/>
<code>define &lt;name&gt; OWCOUNT &lt;fam&gt;.&lt;id&gt; [&lt;interval&gt;]</code>
<br /><br /> Define a 1-Wire counter.<br /><br /></p>
<ul>
<li>
<code>[&lt;model&gt;]</code><br /> Defines the counter model (and thus 1-Wire family
id), currently the following values are permitted: <ul>
<li>model DS2423 with family id 1D (default if the model parameter is
omitted)</li>
<li>model DS2423enew with family id 1D - emulator, works like DS2423</li>
<li>model DS2423eold with family id 1D - emulator, works like DS2423 except that the internal memory is not present</li>
</ul>
</li>
<li>
<code>&lt;fam&gt;</code>
<br />2-character unique family id, see above
</li>
<li>
<code>&lt;id&gt;</code>
<br />12-character unique ROM id of the converter device without family id and CRC
code </li>
<li>
<code>&lt;interval&gt;</code>
<br />Measurement interval in seconds. The default is 300 seconds, a value of 0 disables the automatic update. </li>
</ul>
<br />
<a name="OWCOUNTset"></a>
<h4>Set</h4>
<ul>
<li><a name="owcount_interval">
<code>set &lt;name&gt; interval &lt;int&gt;</code></a><br /> Measurement
interval in seconds. The default is 300 seconds, a value of 0 disables the automatic update.
Log line after each interval &lt;date&gt; &lt;name&gt; &lt;channel&gt;: &lt;value&gt; &lt;unit&gt; &lt;value&gt; /
&lt;unit&gt;/&lt;period&gt; &lt;channel&gt;: &lt;value&gt; &lt;unit&gt; / &lt;value&gt; &lt;unit&gt;/&lt;period&gt; <br />
example: 2012-07-30_00:07:55 OWX_C Taste: 17.03 p 28.1 p/h B: 7.0 cts 0.0 cts/min
</li>
<li><a name="owcount_memory">
<code>set &lt;name&gt; memory &lt;page&gt; &lt;string&gt;</code></a><br />Write 32 bytes to
memory page 0..13 </li>
<li><a name="owcount_midnight">
<code>set &lt;name&gt; midnight &lt;channel-name&gt; &lt;val&gt;</code></a><br />Write the
day's starting value for counter &lt;channel&gt; (A, B or named channel, see
below)</li>
<li><a name="owcount_counter">
<code>set &lt;name&gt; counter &lt;channel-name&gt; &lt;val&gt;</code></a><br />Correct the midnight
value such that counter &lt;channel&gt; (A, B or named channel, see
below) displays value &lt;val&gt;</li>
</ul>
<br />
<a name="OWCOUNTget"></a>
<h4>Get</h4>
<ul>
<li><a name="owcount_id">
<code>get &lt;name&gt; id</code></a>
<br /> Returns the full 1-Wire device id OW_FAMILY.ROM_ID.CRC </li>
<li><a name="owcount_memory2">
<code>get &lt;name&gt; memory &lt;page&gt;</code></a><br />Obtain 32 bytes from
memory page 0..13 and store in cache <i>$hash->{owg_str}->[page]</i> as well as in reading "memory"</li>
<li><a name="owcount_mcache">
<code>get &lt;name&gt; mcache &lt;page&gt;</code></a><br />Obtain 32 bytes from
cache <i>$hash->{owg_str}->[page]</i> and display.</li>
<li><a name="owcount_midnight2">
<code>get &lt;name&gt; midnight &lt;channel-name&gt;</code></a><br />Obtain the
day's starting value for counter &lt;channel&gt; (A, B or named channel, see
below)</li>
<li><a name="owcount_month">
<code>get &lt;name&gt; month</code></a><br />Returns cumulated and averaged monthly value if mode=daily, otherwise last day's and averaged value </li>
<li><a name="owcount_year">
<code>get &lt;name&gt; year</code></a><br />Returns cumulated and averaged yearly value if mode=daily, otherwise last months's and averaged value </li>
<li><a name="owcount_raw">
<code>get &lt;name&gt; raw &lt;channel-name&gt;</code></a><br />Obtain the
current raw value for counter &lt;channel&gt; (A, B or named channel, see below)</li>
<li><a name="owcount_counters">
<code>get &lt;name&gt; counters</code></a><br />Obtain the current value both
counters</li>
</ul>
<br />
<a name="OWCOUNTattr"></a>
<h4>Attributes</h4>
<ul>
<li><a name="owcount_logm"><code>attr &lt;name&gt; LogM
&lt;string&gt;</code></a>
<br />device name (not file name) of monthly log file.
Log line after midnight &lt;new date&gt; &lt;name&gt; &lt;old day&gt; &lt;old date&gt; &lt;channel&gt;: &lt;value&gt; &lt;unit&gt; &lt;channel&gt;: &lt;value&gt; &lt;unit&gt;
<br /> example: 2012-07-30_00:00:57 OWX_C D29: 2012-7-29_23:59:59 Taste: 110.0 p, B: 7.0 cts
</li>
<li><a name="owcount_logy"><code>attr &lt;name&gt; LogY
&lt;string&gt;</code></a>
<br />device name (not file name) of yearly log file.</li>
<li><a name="owcount_interval2">
<code>attr &lt;name&gt; interval &lt;int&gt;</code></a>
<br /> Measurement
interval in seconds. The default is 300 seconds, a value of 0 disables the automatic update. </li>
<li><a name="owcount_nomemory"><code>attr &lt;name&gt; nomemory
0|1</code></a>
<br />when set to 1, midnight values will be stored in files instead of the internal memory.</li>
</ul>
<p>For each of the following attributes, the channel identification A,B may be used.</p>
<ul>
<li><a name="owcount_cname"><code>attr &lt;name&gt; &lt;channel&gt;Name
&lt;string&gt;[|&lt;string&gt;]</code></a>
<br />name for the channel [|short name used in state reading]. </li>
<li><a name="owcount_cunit"><code>attr &lt;name&gt; &lt;channel&gt;Unit
&lt;string&</code></a>
<br />unit of measurement used in state reading (default "cts", set to "none" for empty).</li>
<li><a name="owcount_crate"><code>attr &lt;name&gt; &lt;channel&gt;Rate
&lt;string&gt;[|&lt;string&gt;]</code></a>
<br />name for the channel rate [|short name used in state reading]</li>
<li><a name="owcount_coffset"><code>attr &lt;name&gt; &lt;channel&gt;Offset
&lt;float&gt;</code></a>
<br />offset added to the reading in this channel. </li>
<li><a name="owcount_cfactor"><code>attr &lt;name&gt; &lt;channel&gt;Factor
&lt;float&gt;</code></a>
<br />factor multiplied to (reading+offset) in this channel. </li>
<li><a name="owcount_cmode"><code>attr &lt;name&gt; &lt;channel&gt;Mode daily |
normal</code></a>
<br />determines whether counter is nulled at start of day or running continuously </li>
<li><a name="owcount_cperiod"><code>attr &lt;name&gt; &lt;channel&gt;Period hour(default) | minute |
second</code></a>
<br />period for rate calculation </li>
<li><a href="#readingFnAttributes">readingFnAttributes</a></li>
</ul>
</ul>
=end html
=cut