mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-02-01 13:29:26 +00:00
2364 lines
101 KiB
Perl
2364 lines
101 KiB
Perl
###############################################################################
|
|
# $Id$
|
|
package main;
|
|
use strict;
|
|
use warnings;
|
|
use POSIX;
|
|
|
|
use RESIDENTStk;
|
|
our ( %RESIDENTStk_types, %RESIDENTStk_subTypes );
|
|
|
|
# initialize ##################################################################
|
|
sub RESIDENTS_Initialize($) {
|
|
my ($hash) = @_;
|
|
|
|
$hash->{InitDevFn} = "RESIDENTStk_InitializeDev";
|
|
$hash->{DefFn} = "RESIDENTStk_Define";
|
|
$hash->{UndefFn} = "RESIDENTStk_Undefine";
|
|
$hash->{SetFn} = "RESIDENTStk_Set";
|
|
$hash->{AttrFn} = "RESIDENTStk_Attr";
|
|
$hash->{NotifyFn} = "RESIDENTStk_Notify";
|
|
|
|
$hash->{AttrPrefix} = "rgr_";
|
|
|
|
$hash->{AttrList} =
|
|
"disable:1,0 disabledForIntervals do_not_notify:1,0 "
|
|
. "rgr_states:multiple-strict,home,gotosleep,asleep,awoken,absent,gone "
|
|
. "rgr_lang:EN,DE "
|
|
. "rgr_noDuration:0,1 "
|
|
. "rgr_showAllStates:0,1 "
|
|
. "rgr_wakeupDevice "
|
|
. "rgr_homealoneInStatus:0,1 "
|
|
. "rgr_homealoneSubTypes:multiple-strict,pet,bird,pig,monkey,cat,dog,baby,toddler,childcare,child,guest,domesticWorker,vacationer,teenager,senior "
|
|
. $readingFnAttributes;
|
|
|
|
return FHEM::Meta::InitMod( __FILE__, $hash );
|
|
}
|
|
|
|
# module Fn ####################################################################
|
|
sub RESIDENTS_UpdateReadings (@) {
|
|
my ($hash) = @_;
|
|
my $name = $hash->{NAME};
|
|
my $state = ReadingsVal( $name, "state", "none" );
|
|
my $presence = ReadingsVal( $name, "presence", "absent" );
|
|
my $homealoneInStatus = AttrVal( $name, 'rgr_homealoneInStatus', '0' );
|
|
my @homealoneSubTypes = split(
|
|
/,/,
|
|
AttrVal(
|
|
$name,
|
|
"rgr_homealoneSubTypes",
|
|
"pet,bird,pig,monkey,cat,dog,baby,toddler,childcare,child,guest,domesticWorker,vacationer,teenager,senior"
|
|
)
|
|
);
|
|
|
|
my $state_home = 0;
|
|
my $state_gotosleep = 0;
|
|
my $state_asleep = 0;
|
|
my $state_awoken = 0;
|
|
my $state_absent = 0;
|
|
my $state_gone = 0;
|
|
my $state_total = 0;
|
|
my $state_totalPresent = 0;
|
|
my $state_homealone = 1;
|
|
my $state_totalAbsent = 0;
|
|
my $state_totalGuests = 0;
|
|
my $state_totalGuestsPresent = 0;
|
|
my $state_totalGuestsAbsent = 0;
|
|
my $state_totalPets = 0;
|
|
my $state_totalPetsPresent = 0;
|
|
my $state_totalPetsAbsent = 0;
|
|
my $state_totalRoommates = 0;
|
|
my $state_totalRoommatesPresent = 0;
|
|
my $state_totalRoommatesAbsent = 0;
|
|
my $state_totalPeople = 0;
|
|
my $state_totalPeoplePresent = 0;
|
|
my $state_totalPeopleAbsent = 0;
|
|
my $residentsDevs_home = "-";
|
|
my $residentsDevs_absent = "-";
|
|
my $residentsDevs_asleep = "-";
|
|
my $residentsDevs_awoken = "-";
|
|
my $residentsDevs_gone = "-";
|
|
my $residentsDevs_gotosleep = "-";
|
|
my $residentsDevs_wakeup = "-";
|
|
my $residentsDevs_wayhome = "-";
|
|
my $residentsDevs_wayhomeDelayed = "-";
|
|
my $residentsDevs_totalAbsent = "-";
|
|
my $residentsDevs_totalPresent = "-";
|
|
my $residentsDevs_totalAbsentGuests = "-";
|
|
my $residentsDevs_totalPresentGuests = "-";
|
|
my $residentsDevs_totalAbsentPets = "-";
|
|
my $residentsDevs_totalPresentPets = "-";
|
|
my $residentsDevs_totalAbsentRoommates = "-";
|
|
my $residentsDevs_totalPresentRoommates = "-";
|
|
my $residentsDevs_totalAbsentPeople = "-";
|
|
my $residentsDevs_totalPresentPeople = "-";
|
|
my $residents_home = "-";
|
|
my $residents_absent = "-";
|
|
my $residents_asleep = "-";
|
|
my $residents_awoken = "-";
|
|
my $residents_gone = "-";
|
|
my $residents_gotosleep = "-";
|
|
my $residents_wakeup = "-";
|
|
my $residents_wayhome = "-";
|
|
my $residents_wayhomeDelayed = "-";
|
|
my $residents_totalAbsent = "-";
|
|
my $residents_totalPresent = "-";
|
|
my $residents_totalAbsentGuests = "-";
|
|
my $residents_totalPresentGuests = "-";
|
|
my $residents_totalAbsentPets = "-";
|
|
my $residents_totalPresentPets = "-";
|
|
my $residents_totalAbsentRoommates = "-";
|
|
my $residents_totalPresentRoommates = "-";
|
|
my $residents_totalAbsentPeople = "-";
|
|
my $residents_totalPresentPeople = "-";
|
|
my $wayhome = 0;
|
|
my $wayhomeDelayed = 0;
|
|
my $wakeup = 0;
|
|
my $newstate;
|
|
|
|
my @registeredRoommates =
|
|
split( /,/, $hash->{ROOMMATES} )
|
|
if ( defined( $hash->{ROOMMATES} )
|
|
&& $hash->{ROOMMATES} ne "" );
|
|
|
|
my @registeredGuests =
|
|
split( /,/, $hash->{GUESTS} )
|
|
if ( defined( $hash->{GUESTS} )
|
|
&& $hash->{GUESTS} ne "" );
|
|
|
|
my @registeredPets =
|
|
split( /,/, $hash->{PETS} )
|
|
if ( defined( $hash->{PETS} )
|
|
&& $hash->{PETS} ne "" );
|
|
|
|
# count child states for ROOMMATE devices
|
|
foreach my $roommate (@registeredRoommates) {
|
|
$state_total++;
|
|
$state_totalPeople++;
|
|
$state_totalRoommates++;
|
|
|
|
my $roommateName =
|
|
AttrVal( $roommate,
|
|
AttrVal( $roommate, "rr_realname", "group" ), "" );
|
|
|
|
Log3 $name, 5,
|
|
"RESIDENTS $name: considering $roommate for state change";
|
|
|
|
if ( ReadingsVal( $roommate, "state", "initialized" ) eq "home" ) {
|
|
$state_home++;
|
|
$residentsDevs_home .= "," . $roommate
|
|
if ( $residentsDevs_home ne "-" );
|
|
$residentsDevs_home = $roommate
|
|
if ( $residentsDevs_home eq "-" );
|
|
$residents_home .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_home ne "-" );
|
|
$residents_home = $roommateName
|
|
if ( $roommateName ne "" && $residents_home eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalRoommatesPresent++;
|
|
$residentsDevs_totalPresent .= "," . $roommate
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $roommate
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPeople .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $roommate
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentRoommates .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentRoommates ne "-" );
|
|
$residentsDevs_totalPresentRoommates = $roommate
|
|
if ( $residentsDevs_totalPresentRoommates eq "-" );
|
|
$residents_totalPresent .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentRoommates .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates ne "-" );
|
|
$residents_totalPresentRoommates = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates eq "-" );
|
|
}
|
|
|
|
elsif (
|
|
ReadingsVal( $roommate, "state", "initialized" ) eq "gotosleep" )
|
|
{
|
|
$state_gotosleep++;
|
|
$residentsDevs_gotosleep .= "," . $roommate
|
|
if ( $residentsDevs_gotosleep ne "-" );
|
|
$residentsDevs_gotosleep = $roommate
|
|
if ( $residentsDevs_gotosleep eq "-" );
|
|
$residents_gotosleep .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_gotosleep ne "-" );
|
|
$residents_gotosleep = $roommateName
|
|
if ( $roommateName ne "" && $residents_gotosleep eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalRoommatesPresent++;
|
|
$residentsDevs_totalPresent .= "," . $roommate
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $roommate
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPeople .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $roommate
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentRoommates .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentRoommates ne "-" );
|
|
$residentsDevs_totalPresentRoommates = $roommate
|
|
if ( $residentsDevs_totalPresentRoommates eq "-" );
|
|
$residents_totalPresent .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentRoommates .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates ne "-" );
|
|
$residents_totalPresentRoommates = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $roommate, "state", "initialized" ) eq "asleep" ) {
|
|
$state_asleep++;
|
|
$residentsDevs_asleep .= "," . $roommate
|
|
if ( $residentsDevs_asleep ne "-" );
|
|
$residentsDevs_asleep = $roommate
|
|
if ( $residentsDevs_asleep eq "-" );
|
|
$residents_asleep .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_asleep ne "-" );
|
|
$residents_asleep = $roommateName
|
|
if ( $roommateName ne "" && $residents_asleep eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalRoommatesPresent++;
|
|
$residentsDevs_totalPresent .= "," . $roommate
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $roommate
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPeople .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $roommate
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentRoommates .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentRoommates ne "-" );
|
|
$residentsDevs_totalPresentRoommates = $roommate
|
|
if ( $residentsDevs_totalPresentRoommates eq "-" );
|
|
$residents_totalPresent .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentRoommates .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates ne "-" );
|
|
$residents_totalPresentRoommates = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $roommate, "state", "initialized" ) eq "awoken" ) {
|
|
$state_awoken++;
|
|
$residentsDevs_awoken .= "," . $roommate
|
|
if ( $residentsDevs_awoken ne "-" );
|
|
$residentsDevs_awoken = $roommate
|
|
if ( $residentsDevs_awoken eq "-" );
|
|
$residents_awoken .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_awoken ne "-" );
|
|
$residents_awoken = $roommateName
|
|
if ( $roommateName ne "" && $residents_awoken eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalRoommatesPresent++;
|
|
$residentsDevs_totalPresent .= "," . $roommate
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $roommate
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPeople .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $roommate
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentRoommates .= "," . $roommate
|
|
if ( $residentsDevs_totalPresentRoommates ne "-" );
|
|
$residentsDevs_totalPresentRoommates = $roommate
|
|
if ( $residentsDevs_totalPresentRoommates eq "-" );
|
|
$residents_totalPresent .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $roommateName
|
|
if ( $roommateName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentRoommates .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates ne "-" );
|
|
$residents_totalPresentRoommates = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalPresentRoommates eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $roommate, "state", "initialized" ) eq "absent" ) {
|
|
$state_absent++;
|
|
$residentsDevs_absent .= "," . $roommate
|
|
if ( $residentsDevs_absent ne "-" );
|
|
$residentsDevs_absent = $roommate
|
|
if ( $residentsDevs_absent eq "-" );
|
|
$residents_absent .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_absent ne "-" );
|
|
$residents_absent = $roommateName
|
|
if ( $roommateName ne "" && $residents_absent eq "-" );
|
|
|
|
$state_totalAbsent++;
|
|
$state_totalPeopleAbsent++;
|
|
$state_totalRoommatesAbsent++;
|
|
$residentsDevs_totalAbsent .= "," . $roommate
|
|
if ( $residentsDevs_totalAbsent ne "-" );
|
|
$residentsDevs_totalAbsent = $roommate
|
|
if ( $residentsDevs_totalAbsent eq "-" );
|
|
$residentsDevs_totalAbsentPeople .= "," . $roommate
|
|
if ( $residentsDevs_totalAbsentPeople ne "-" );
|
|
$residentsDevs_totalAbsentPeople = $roommate
|
|
if ( $residentsDevs_totalAbsentPeople eq "-" );
|
|
$residentsDevs_totalAbsentRoommates .= "," . $roommate
|
|
if ( $residentsDevs_totalAbsentRoommates ne "-" );
|
|
$residentsDevs_totalAbsentRoommates = $roommate
|
|
if ( $residentsDevs_totalAbsentRoommates eq "-" );
|
|
$residents_totalAbsent .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_totalAbsent ne "-" );
|
|
$residents_totalAbsent = $roommateName
|
|
if ( $roommateName ne "" && $residents_totalAbsent eq "-" );
|
|
$residents_totalAbsentPeople .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentPeople ne "-" );
|
|
$residents_totalAbsentPeople = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentPeople eq "-" );
|
|
$residents_totalAbsentRoommates .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentRoommates ne "-" );
|
|
$residents_totalAbsentRoommates = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentRoommates eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $roommate, "state", "initialized" ) eq "gone" ) {
|
|
$state_gone++;
|
|
$residentsDevs_gone .= "," . $roommate
|
|
if ( $residentsDevs_gone ne "-" );
|
|
$residentsDevs_gone = $roommate
|
|
if ( $residentsDevs_gone eq "-" );
|
|
$residents_gone .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_gone ne "-" );
|
|
$residents_gone = $roommateName
|
|
if ( $roommateName ne "" && $residents_gone eq "-" );
|
|
|
|
$state_totalAbsent++;
|
|
$state_totalPeopleAbsent++;
|
|
$state_totalRoommatesAbsent++;
|
|
$residentsDevs_totalAbsent .= "," . $roommate
|
|
if ( $residentsDevs_totalAbsent ne "-" );
|
|
$residentsDevs_totalAbsent = $roommate
|
|
if ( $residentsDevs_totalAbsent eq "-" );
|
|
$residentsDevs_totalAbsentPeople .= "," . $roommate
|
|
if ( $residentsDevs_totalAbsentPeople ne "-" );
|
|
$residentsDevs_totalAbsentPeople = $roommate
|
|
if ( $residentsDevs_totalAbsentPeople eq "-" );
|
|
$residentsDevs_totalAbsentRoommates .= "," . $roommate
|
|
if ( $residentsDevs_totalAbsentRoommates ne "-" );
|
|
$residentsDevs_totalAbsentRoommates = $roommate
|
|
if ( $residentsDevs_totalAbsentRoommates eq "-" );
|
|
$residents_totalAbsent .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_totalAbsent ne "-" );
|
|
$residents_totalAbsent = $roommateName
|
|
if ( $roommateName ne "" && $residents_totalAbsent eq "-" );
|
|
$residents_totalAbsentPeople .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentPeople ne "-" );
|
|
$residents_totalAbsentPeople = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentPeople eq "-" );
|
|
$residents_totalAbsentRoommates .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentRoommates ne "-" );
|
|
$residents_totalAbsentRoommates = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_totalAbsentRoommates eq "-" );
|
|
}
|
|
|
|
if ( ReadingsVal( $roommate, "wakeup", "0" ) > 0 ) {
|
|
$wakeup++;
|
|
$residentsDevs_wakeup .= "," . $roommate
|
|
if ( $residentsDevs_wakeup ne "-" );
|
|
$residentsDevs_wakeup = $roommate
|
|
if ( $residentsDevs_wakeup eq "-" );
|
|
$residents_wakeup .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_wakeup ne "-" );
|
|
$residents_wakeup = $roommateName
|
|
if ( $roommateName ne "" && $residents_wakeup eq "-" );
|
|
}
|
|
|
|
if ( ReadingsVal( $roommate, "wayhome", "0" ) > 0 ) {
|
|
$wayhome++;
|
|
$residentsDevs_wayhome .= "," . $roommate
|
|
if ( $residentsDevs_wayhome ne "-" );
|
|
$residentsDevs_wayhome = $roommate
|
|
if ( $residentsDevs_wayhome eq "-" );
|
|
$residents_wayhome .= ", " . $roommateName
|
|
if ( $roommateName ne "" && $residents_wayhome ne "-" );
|
|
$residents_wayhome = $roommateName
|
|
if ( $roommateName ne "" && $residents_wayhome eq "-" );
|
|
|
|
if ( ReadingsVal( $roommate, "wayhome", "0" ) == 2 ) {
|
|
$wayhomeDelayed++;
|
|
|
|
$residentsDevs_wayhomeDelayed .= "," . $roommate
|
|
if ( $residentsDevs_wayhomeDelayed ne "-" );
|
|
$residentsDevs_wayhomeDelayed = $roommate
|
|
if ( $residentsDevs_wayhomeDelayed eq "-" );
|
|
$residents_wayhomeDelayed .= ", " . $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_wayhomeDelayed ne "-" );
|
|
$residents_wayhomeDelayed = $roommateName
|
|
if ( $roommateName ne ""
|
|
&& $residents_wayhomeDelayed eq "-" );
|
|
}
|
|
}
|
|
|
|
if ( $state_homealone
|
|
&& ReadingsVal( $roommate, "presence", "absent" ) eq "present" )
|
|
{
|
|
my $TYPE = GetType($roommate);
|
|
my $SubType =
|
|
defined( $defs{$roommate}{SUBTYPE} )
|
|
? $defs{$roommate}{SUBTYPE}
|
|
: 'adult';
|
|
|
|
$state_homealone = 0
|
|
unless ( grep m/^$SubType$/, @homealoneSubTypes );
|
|
}
|
|
}
|
|
|
|
# count child states for PET devices
|
|
foreach my $pet (@registeredPets) {
|
|
$state_total++;
|
|
$state_totalPets++;
|
|
|
|
my $petName =
|
|
AttrVal( $pet, AttrVal( $pet, "rp_realname", "group" ), "" );
|
|
|
|
Log3 $name, 5, "RESIDENTS $name: considering $pet for state change";
|
|
|
|
if ( ReadingsVal( $pet, "state", "initialized" ) eq "home" ) {
|
|
$state_home++;
|
|
$residentsDevs_home .= "," . $pet
|
|
if ( $residentsDevs_home ne "-" );
|
|
$residentsDevs_home = $pet
|
|
if ( $residentsDevs_home eq "-" );
|
|
$residents_home .= ", " . $petName
|
|
if ( $petName ne "" && $residents_home ne "-" );
|
|
$residents_home = $petName
|
|
if ( $petName ne "" && $residents_home eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPetsPresent++;
|
|
$residentsDevs_totalPresent .= "," . $pet
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $pet
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPets .= "," . $pet
|
|
if ( $residentsDevs_totalPresentPets ne "-" );
|
|
$residentsDevs_totalPresentPets = $pet
|
|
if ( $residentsDevs_totalPresentPets eq "-" );
|
|
$residents_totalPresent .= ", " . $petName
|
|
if ( $petName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $petName
|
|
if ( $petName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPets .= ", " . $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets ne "-" );
|
|
$residents_totalPresentPets = $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $pet, "state", "initialized" ) eq "gotosleep" ) {
|
|
$state_gotosleep++;
|
|
$residentsDevs_gotosleep .= "," . $pet
|
|
if ( $residentsDevs_gotosleep ne "-" );
|
|
$residentsDevs_gotosleep = $pet
|
|
if ( $residentsDevs_gotosleep eq "-" );
|
|
$residents_gotosleep .= ", " . $petName
|
|
if ( $petName ne "" && $residents_gotosleep ne "-" );
|
|
$residents_gotosleep = $petName
|
|
if ( $petName ne "" && $residents_gotosleep eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPetsPresent++;
|
|
$residentsDevs_totalPresent .= "," . $pet
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $pet
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPets .= "," . $pet
|
|
if ( $residentsDevs_totalPresentPets ne "-" );
|
|
$residentsDevs_totalPresentPets = $pet
|
|
if ( $residentsDevs_totalPresentPets eq "-" );
|
|
$residents_totalPresent .= ", " . $petName
|
|
if ( $petName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $petName
|
|
if ( $petName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPets .= ", " . $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets ne "-" );
|
|
$residents_totalPresentPets = $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $pet, "state", "initialized" ) eq "asleep" ) {
|
|
$state_asleep++;
|
|
$residentsDevs_asleep .= "," . $pet
|
|
if ( $residentsDevs_asleep ne "-" );
|
|
$residentsDevs_asleep = $pet
|
|
if ( $residentsDevs_asleep eq "-" );
|
|
$residents_asleep .= ", " . $petName
|
|
if ( $petName ne "" && $residents_asleep ne "-" );
|
|
$residents_asleep = $petName
|
|
if ( $petName ne "" && $residents_asleep eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPetsPresent++;
|
|
$residentsDevs_totalPresent .= "," . $pet
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $pet
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPets .= "," . $pet
|
|
if ( $residentsDevs_totalPresentPets ne "-" );
|
|
$residentsDevs_totalPresentPets = $pet
|
|
if ( $residentsDevs_totalPresentPets eq "-" );
|
|
$residents_totalPresent .= ", " . $petName
|
|
if ( $petName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $petName
|
|
if ( $petName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPets .= ", " . $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets ne "-" );
|
|
$residents_totalPresentPets = $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $pet, "state", "initialized" ) eq "awoken" ) {
|
|
$state_awoken++;
|
|
$residentsDevs_awoken .= "," . $pet
|
|
if ( $residentsDevs_awoken ne "-" );
|
|
$residentsDevs_awoken = $pet
|
|
if ( $residentsDevs_awoken eq "-" );
|
|
$residents_awoken .= ", " . $petName
|
|
if ( $petName ne "" && $residents_awoken ne "-" );
|
|
$residents_awoken = $petName
|
|
if ( $petName ne "" && $residents_awoken eq "-" );
|
|
|
|
$state_totalPresent++;
|
|
$state_totalPetsPresent++;
|
|
$residentsDevs_totalPresent .= "," . $pet
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $pet
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residentsDevs_totalPresentPets .= "," . $pet
|
|
if ( $residentsDevs_totalPresentPets ne "-" );
|
|
$residentsDevs_totalPresentPets = $pet
|
|
if ( $residentsDevs_totalPresentPets eq "-" );
|
|
$residents_totalPresent .= ", " . $petName
|
|
if ( $petName ne "" && $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $petName
|
|
if ( $petName ne "" && $residents_totalPresent eq "-" );
|
|
$residents_totalPresentPets .= ", " . $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets ne "-" );
|
|
$residents_totalPresentPets = $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalPresentPets eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $pet, "state", "initialized" ) eq "absent" ) {
|
|
$state_absent++;
|
|
$residentsDevs_absent .= "," . $pet
|
|
if ( $residentsDevs_absent ne "-" );
|
|
$residentsDevs_absent = $pet
|
|
if ( $residentsDevs_absent eq "-" );
|
|
$residents_absent .= ", " . $petName
|
|
if ( $petName ne "" && $residents_absent ne "-" );
|
|
$residents_absent = $petName
|
|
if ( $petName ne "" && $residents_absent eq "-" );
|
|
|
|
$state_totalAbsent++;
|
|
$state_totalPetsAbsent++;
|
|
$residentsDevs_totalAbsent .= "," . $pet
|
|
if ( $residentsDevs_totalAbsent ne "-" );
|
|
$residentsDevs_totalAbsent = $pet
|
|
if ( $residentsDevs_totalAbsent eq "-" );
|
|
$residentsDevs_totalAbsentPets .= "," . $pet
|
|
if ( $residentsDevs_totalAbsentPets ne "-" );
|
|
$residentsDevs_totalAbsentPets = $pet
|
|
if ( $residentsDevs_totalAbsentPets eq "-" );
|
|
$residents_totalAbsent .= ", " . $petName
|
|
if ( $petName ne "" && $residents_totalAbsent ne "-" );
|
|
$residents_totalAbsent = $petName
|
|
if ( $petName ne "" && $residents_totalAbsent eq "-" );
|
|
$residents_totalAbsentPets .= ", " . $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalAbsentPets ne "-" );
|
|
$residents_totalAbsentPets = $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalAbsentPets eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $pet, "state", "initialized" ) eq "gone" ) {
|
|
$state_gone++;
|
|
$residentsDevs_gone .= "," . $pet
|
|
if ( $residentsDevs_gone ne "-" );
|
|
$residentsDevs_gone = $pet
|
|
if ( $residentsDevs_gone eq "-" );
|
|
$residents_gone .= ", " . $petName
|
|
if ( $petName ne "" && $residents_gone ne "-" );
|
|
$residents_gone = $petName
|
|
if ( $petName ne "" && $residents_gone eq "-" );
|
|
|
|
$state_totalAbsent++;
|
|
$state_totalPetsAbsent++;
|
|
$residentsDevs_totalAbsent .= "," . $pet
|
|
if ( $residentsDevs_totalAbsent ne "-" );
|
|
$residentsDevs_totalAbsent = $pet
|
|
if ( $residentsDevs_totalAbsent eq "-" );
|
|
$residentsDevs_totalAbsentPets .= "," . $pet
|
|
if ( $residentsDevs_totalAbsentPets ne "-" );
|
|
$residentsDevs_totalAbsentPets = $pet
|
|
if ( $residentsDevs_totalAbsentPets eq "-" );
|
|
$residents_totalAbsent .= ", " . $petName
|
|
if ( $petName ne "" && $residents_totalAbsent ne "-" );
|
|
$residents_totalAbsent = $petName
|
|
if ( $petName ne "" && $residents_totalAbsent eq "-" );
|
|
$residents_totalAbsentPets .= ", " . $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalAbsentPets ne "-" );
|
|
$residents_totalAbsentPets = $petName
|
|
if ( $petName ne ""
|
|
&& $residents_totalAbsentPets eq "-" );
|
|
}
|
|
|
|
if ( ReadingsVal( $pet, "wakeup", "0" ) > 0 ) {
|
|
$wakeup++;
|
|
$residentsDevs_wakeup .= "," . $pet
|
|
if ( $residentsDevs_wakeup ne "-" );
|
|
$residentsDevs_wakeup = $pet
|
|
if ( $residentsDevs_wakeup eq "-" );
|
|
$residents_wakeup .= ", " . $petName
|
|
if ( $petName ne "" && $residents_wakeup ne "-" );
|
|
$residents_wakeup = $petName
|
|
if ( $petName ne "" && $residents_wakeup eq "-" );
|
|
}
|
|
|
|
if ( ReadingsVal( $pet, "wayhome", "0" ) > 0 ) {
|
|
$wayhome++;
|
|
$residentsDevs_wayhome .= "," . $pet
|
|
if ( $residentsDevs_wayhome ne "-" );
|
|
$residentsDevs_wayhome = $pet
|
|
if ( $residentsDevs_wayhome eq "-" );
|
|
$residents_wayhome .= ", " . $petName
|
|
if ( $petName ne "" && $residents_wayhome ne "-" );
|
|
$residents_wayhome = $petName
|
|
if ( $petName ne "" && $residents_wayhome eq "-" );
|
|
|
|
if ( ReadingsVal( $pet, "wayhome", "0" ) == 2 ) {
|
|
$wayhomeDelayed++;
|
|
|
|
$residentsDevs_wayhomeDelayed .= "," . $pet
|
|
if ( $residentsDevs_wayhomeDelayed ne "-" );
|
|
$residentsDevs_wayhomeDelayed = $pet
|
|
if ( $residentsDevs_wayhomeDelayed eq "-" );
|
|
$residents_wayhomeDelayed .= ", " . $petName
|
|
if ( $petName ne ""
|
|
&& $residents_wayhomeDelayed ne "-" );
|
|
$residents_wayhomeDelayed = $petName
|
|
if ( $petName ne ""
|
|
&& $residents_wayhomeDelayed eq "-" );
|
|
}
|
|
}
|
|
|
|
if ( $state_homealone
|
|
&& ReadingsVal( $pet, "presence", "absent" ) eq "present" )
|
|
{
|
|
my $TYPE = GetType($pet);
|
|
my $SubType =
|
|
defined( $defs{$pet}{SUBTYPE} )
|
|
? $defs{$pet}{SUBTYPE}
|
|
: 'generic';
|
|
$SubType = 'pet' if ( $SubType eq 'generic' );
|
|
|
|
$state_homealone = 0
|
|
unless ( grep m/^$SubType$/, @homealoneSubTypes );
|
|
}
|
|
}
|
|
|
|
# count child states for GUEST devices
|
|
foreach my $guest (@registeredGuests) {
|
|
my $guestName =
|
|
AttrVal( $guest, AttrVal( $guest, "rg_realname", "group" ), "" );
|
|
|
|
Log3 $name, 5, "RESIDENTS $name: considering $guest for state change";
|
|
|
|
if ( ReadingsVal( $guest, "state", "initialized" ) eq "home" ) {
|
|
$state_home++;
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalGuestsPresent++;
|
|
$state_totalPeople++;
|
|
$state_totalGuests++;
|
|
$state_total++;
|
|
|
|
$residentsDevs_totalPresentPeople .= "," . $guest
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $guest
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentGuests .= "," . $guest
|
|
if ( $residentsDevs_totalPresentGuests ne "-" );
|
|
$residentsDevs_totalPresentGuests = $guest
|
|
if ( $residentsDevs_totalPresentGuests eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentGuests .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests ne "-" );
|
|
$residents_totalPresentGuests = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests eq "-" );
|
|
|
|
$residentsDevs_totalPresent .= "," . $guest
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $guest
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residents_totalPresent .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $guest, "state", "initialized" ) eq "gotosleep" ) {
|
|
$state_gotosleep++;
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalGuestsPresent++;
|
|
$state_totalPeople++;
|
|
$state_totalGuests++;
|
|
$state_total++;
|
|
|
|
$residentsDevs_totalPresentPeople .= "," . $guest
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $guest
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentGuests .= "," . $guest
|
|
if ( $residentsDevs_totalPresentGuests ne "-" );
|
|
$residentsDevs_totalPresentGuests = $guest
|
|
if ( $residentsDevs_totalPresentGuests eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentGuests .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests ne "-" );
|
|
$residents_totalPresentGuests = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests eq "-" );
|
|
|
|
$residentsDevs_totalPresent .= "," . $guest
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $guest
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residents_totalPresent .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $guest, "state", "initialized" ) eq "asleep" ) {
|
|
$state_asleep++;
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalGuestsPresent++;
|
|
$state_totalPeople++;
|
|
$state_totalGuests++;
|
|
$state_total++;
|
|
|
|
$residentsDevs_totalPresentPeople .= "," . $guest
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $guest
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentGuests .= "," . $guest
|
|
if ( $residentsDevs_totalPresentGuests ne "-" );
|
|
$residentsDevs_totalPresentGuests = $guest
|
|
if ( $residentsDevs_totalPresentGuests eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentGuests .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests ne "-" );
|
|
$residents_totalPresentGuests = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests eq "-" );
|
|
|
|
$residentsDevs_totalPresent .= "," . $guest
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $guest
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residents_totalPresent .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $guest, "state", "initialized" ) eq "awoken" ) {
|
|
$state_awoken++;
|
|
$state_totalPresent++;
|
|
$state_totalPeoplePresent++;
|
|
$state_totalGuestsPresent++;
|
|
$state_totalPeople++;
|
|
$state_totalGuests++;
|
|
$state_total++;
|
|
|
|
$residentsDevs_totalPresentPeople .= "," . $guest
|
|
if ( $residentsDevs_totalPresentPeople ne "-" );
|
|
$residentsDevs_totalPresentPeople = $guest
|
|
if ( $residentsDevs_totalPresentPeople eq "-" );
|
|
$residentsDevs_totalPresentGuests .= "," . $guest
|
|
if ( $residentsDevs_totalPresentGuests ne "-" );
|
|
$residentsDevs_totalPresentGuests = $guest
|
|
if ( $residentsDevs_totalPresentGuests eq "-" );
|
|
$residents_totalPresentPeople .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople ne "-" );
|
|
$residents_totalPresentPeople = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentPeople eq "-" );
|
|
$residents_totalPresentGuests .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests ne "-" );
|
|
$residents_totalPresentGuests = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresentGuests eq "-" );
|
|
|
|
$residentsDevs_totalPresent .= "," . $guest
|
|
if ( $residentsDevs_totalPresent ne "-" );
|
|
$residentsDevs_totalPresent = $guest
|
|
if ( $residentsDevs_totalPresent eq "-" );
|
|
$residents_totalPresent .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent ne "-" );
|
|
$residents_totalPresent = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalPresent eq "-" );
|
|
}
|
|
|
|
elsif ( ReadingsVal( $guest, "state", "initialized" ) eq "absent" ) {
|
|
$state_absent++;
|
|
$state_totalAbsent++;
|
|
$state_totalPeopleAbsent++;
|
|
$state_totalGuestsAbsent++;
|
|
$state_totalPeople++;
|
|
$state_totalGuests++;
|
|
$state_total++;
|
|
|
|
$residentsDevs_totalAbsentPeople .= "," . $guest
|
|
if ( $residentsDevs_totalAbsentPeople ne "-" );
|
|
$residentsDevs_totalAbsentPeople = $guest
|
|
if ( $residentsDevs_totalAbsentPeople eq "-" );
|
|
$residentsDevs_totalAbsentGuests .= "," . $guest
|
|
if ( $residentsDevs_totalAbsentGuests ne "-" );
|
|
$residentsDevs_totalAbsentGuests = $guest
|
|
if ( $residentsDevs_totalAbsentGuests eq "-" );
|
|
$residents_totalAbsentPeople .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalAbsentPeople ne "-" );
|
|
$residents_totalAbsentPeople = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalAbsentPeople eq "-" );
|
|
$residents_totalAbsentGuests .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalAbsentGuests ne "-" );
|
|
$residents_totalAbsentGuests = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalAbsentGuests eq "-" );
|
|
|
|
$residentsDevs_totalAbsent .= "," . $guest
|
|
if ( $residentsDevs_totalAbsent ne "-" );
|
|
$residentsDevs_totalAbsent = $guest
|
|
if ( $residentsDevs_totalAbsent eq "-" );
|
|
$residents_totalAbsent .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalAbsent ne "-" );
|
|
$residents_totalAbsent = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_totalAbsent eq "-" );
|
|
}
|
|
|
|
if ( ReadingsVal( $guest, "wakeup", "0" ) > 0 ) {
|
|
$wakeup++;
|
|
$residentsDevs_wakeup .= "," . $guest
|
|
if ( $residentsDevs_wakeup ne "-" );
|
|
$residentsDevs_wakeup = $guest
|
|
if ( $residentsDevs_wakeup eq "-" );
|
|
$residents_wakeup .= ", " . $guestName
|
|
if ( $guestName ne "" && $residents_wakeup ne "-" );
|
|
$residents_wakeup = $guestName
|
|
if ( $guestName ne "" && $residents_wakeup eq "-" );
|
|
}
|
|
|
|
if ( ReadingsVal( $guest, "wayhome", "0" ) > 0 ) {
|
|
$wayhome++;
|
|
$residents_wayhome .= "," . $guest
|
|
if ( $residents_wayhome ne "-" );
|
|
$residents_wayhome = $guest if ( $residents_wayhome eq "-" );
|
|
$residents_wayhome .= ", " . $guestName
|
|
if ( $guestName ne "" && $residents_wayhome ne "-" );
|
|
$residents_wayhome = $guestName
|
|
if ( $guestName ne "" && $residents_wayhome eq "-" );
|
|
|
|
if ( ReadingsVal( $guest, "wayhome", "0" ) == 2 ) {
|
|
$wayhomeDelayed++;
|
|
|
|
$residentsDevs_wayhomeDelayed .= "," . $guest
|
|
if ( $residentsDevs_wayhomeDelayed ne "-" );
|
|
$residentsDevs_wayhomeDelayed = $guest
|
|
if ( $residentsDevs_wayhomeDelayed eq "-" );
|
|
$residents_wayhomeDelayed .= ", " . $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_wayhomeDelayed ne "-" );
|
|
$residents_wayhomeDelayed = $guestName
|
|
if ( $guestName ne ""
|
|
&& $residents_wayhomeDelayed eq "-" );
|
|
}
|
|
}
|
|
|
|
if ( $state_homealone
|
|
&& ReadingsVal( $guest, "presence", "absent" ) eq "present" )
|
|
{
|
|
my $TYPE = GetType($guest);
|
|
my $SubType =
|
|
defined( $defs{$guest}{SUBTYPE} )
|
|
? $defs{$guest}{SUBTYPE}
|
|
: 'generic';
|
|
$SubType = 'guest' if ( $SubType eq 'generic' );
|
|
|
|
$state_homealone = 0
|
|
unless ( grep m/^$SubType$/, @homealoneSubTypes );
|
|
}
|
|
}
|
|
|
|
# update counter
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotal", $state_total );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalGuests",
|
|
$state_totalGuests );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPets",
|
|
$state_totalPets );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalGuestsPresent",
|
|
$state_totalGuestsPresent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPetsPresent",
|
|
$state_totalPetsPresent );
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalGuestsPresentDevs",
|
|
$residentsDevs_totalPresentGuests
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalPetsPresentDevs",
|
|
$residentsDevs_totalPresentPets
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalGuestsPresentNames",
|
|
$residents_totalPresentGuests );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPetsPresentNames",
|
|
$residents_totalPresentPets );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalGuestsAbsent",
|
|
$state_totalGuestsAbsent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPetsAbsent",
|
|
$state_totalPetsAbsent );
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalGuestsAbsentDevs",
|
|
$residentsDevs_totalAbsentGuests
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalPetsAbsentDevs",
|
|
$residentsDevs_totalAbsentPets
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalGuestsAbsentNames",
|
|
$residents_totalAbsentGuests );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPetsAbsentNames",
|
|
$residents_totalAbsentPets );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalRoommates",
|
|
$state_totalRoommates );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalRoommatesPresent",
|
|
$state_totalRoommatesPresent );
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalRoommatesPresentDevs",
|
|
$residentsDevs_totalPresentRoommates
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalRoommatesPresentNames",
|
|
$residents_totalPresentRoommates
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalRoommatesAbsent",
|
|
$state_totalRoommatesAbsent );
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalRoommatesAbsentDevs",
|
|
$residentsDevs_totalAbsentRoommates
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalRoommatesAbsentNames",
|
|
$residents_totalAbsentRoommates
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPeople",
|
|
$state_totalPeople );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPeoplePresent",
|
|
$state_totalPeoplePresent );
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalPeoplePresentDevs",
|
|
$residentsDevs_totalPresentPeople
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPeoplePresentNames",
|
|
$residents_totalPresentPeople );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPeopleAbsent",
|
|
$state_totalPeopleAbsent );
|
|
|
|
readingsBulkUpdateIfChanged(
|
|
$hash,
|
|
"residentsTotalPeopleAbsentDevs",
|
|
$residentsDevs_totalAbsentPeople
|
|
);
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPeopleAbsentNames",
|
|
$residents_totalAbsentPeople );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPresent",
|
|
$state_totalPresent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPresentDevs",
|
|
$residentsDevs_totalPresent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalPresentNames",
|
|
$residents_totalPresent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalAbsent",
|
|
$state_totalAbsent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalAbsentDevs",
|
|
$residentsDevs_totalAbsent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalAbsentNames",
|
|
$residents_totalAbsent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsHome", $state_home );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsHomeDevs",
|
|
$residentsDevs_home );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsHomeNames", $residents_home );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsGotosleep",
|
|
$state_gotosleep );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsGotosleepDevs",
|
|
$residentsDevs_gotosleep );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsGotosleepNames",
|
|
$residents_gotosleep );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAsleep", $state_asleep );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAsleepDevs",
|
|
$residentsDevs_asleep );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAsleepNames",
|
|
$residents_asleep );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAwoken", $state_awoken );
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAwokenDevs",
|
|
$residentsDevs_awoken );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAwokenNames",
|
|
$residents_awoken );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAbsent", $state_absent );
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAbsentDevs",
|
|
$residentsDevs_absent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsAbsentNames",
|
|
$residents_absent );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsGone", $state_gone );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsGoneDevs",
|
|
$residentsDevs_gone );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsGoneNames", $residents_gone );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWakeup", $wakeup );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWakeupDevs",
|
|
$residentsDevs_wakeup );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWakeupNames",
|
|
$residents_wakeup );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWayhome", $wayhome );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWayhomeDevs",
|
|
$residentsDevs_wayhome );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWayhomeNames",
|
|
$residents_wayhome );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWayhomeDelayed",
|
|
$wayhomeDelayed );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWayhomeDelayedDevs",
|
|
$residentsDevs_wayhomeDelayed );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "residentsTotalWayhomeDelayedNames",
|
|
$residents_wayhomeDelayed );
|
|
|
|
#
|
|
# state calculation
|
|
#
|
|
|
|
# gotosleep
|
|
if ( $state_home == 0
|
|
&& $state_gotosleep > 0
|
|
&& $state_asleep >= 0
|
|
&& $state_awoken == 0 )
|
|
{
|
|
$newstate = "gotosleep";
|
|
}
|
|
|
|
# asleep
|
|
elsif ($state_home == 0
|
|
&& $state_gotosleep == 0
|
|
&& $state_asleep > 0
|
|
&& $state_awoken == 0 )
|
|
{
|
|
$newstate = "asleep";
|
|
}
|
|
|
|
# awoken
|
|
elsif ($state_home == 0
|
|
&& $state_gotosleep >= 0
|
|
&& $state_asleep >= 0
|
|
&& $state_awoken > 0 )
|
|
{
|
|
$newstate = "awoken";
|
|
}
|
|
|
|
# general presence
|
|
elsif ($state_home > 0
|
|
|| $state_gotosleep > 0
|
|
|| $state_asleep > 0
|
|
|| $state_awoken > 0 )
|
|
{
|
|
$newstate = "home";
|
|
}
|
|
|
|
# absent
|
|
elsif ($state_absent > 0
|
|
&& $state_home == 0
|
|
&& $state_gotosleep == 0
|
|
&& $state_asleep == 0
|
|
&& $state_awoken == 0 )
|
|
{
|
|
$newstate = "absent";
|
|
}
|
|
|
|
# gone
|
|
elsif ($state_gone > 0
|
|
&& $state_absent == 0
|
|
&& $state_home == 0
|
|
&& $state_gotosleep == 0
|
|
&& $state_asleep == 0
|
|
&& $state_awoken == 0 )
|
|
{
|
|
$newstate = "gone";
|
|
}
|
|
|
|
# none
|
|
elsif ($state_totalGuests == 0
|
|
&& $state_totalPets == 0
|
|
&& $state_totalRoommates == 0
|
|
&& $state_gone == 0
|
|
&& $state_absent == 0
|
|
&& $state_home == 0
|
|
&& $state_gotosleep == 0
|
|
&& $state_asleep == 0
|
|
&& $state_awoken == 0 )
|
|
{
|
|
$newstate = "none";
|
|
}
|
|
|
|
# unspecified; this should not happen
|
|
else {
|
|
$newstate = "unspecified";
|
|
}
|
|
|
|
# calculate presence state
|
|
my $newpresence =
|
|
( $newstate ne "none" && $newstate ne "gone" && $newstate ne "absent" )
|
|
? "present"
|
|
: "absent";
|
|
|
|
# calculate homealone state
|
|
$state_homealone = 0 if ( $newpresence eq "absent" );
|
|
my $homealone_type;
|
|
my $homealone_subtype;
|
|
my $newstate_prefix;
|
|
if ($state_homealone) {
|
|
foreach my $obj ( split( /,/, $residentsDevs_totalPresent ) ) {
|
|
my $TYPE = GetType($obj);
|
|
next unless $TYPE;
|
|
|
|
my $subtype = 'generic';
|
|
$subtype = InternalVal( $obj, 'SUBTYPE', 'generic' )
|
|
if ( $TYPE eq 'PET' );
|
|
$subtype = InternalVal( $obj, 'SUBTYPE', 'adult' )
|
|
if ( $TYPE eq 'ROOMMATE' );
|
|
$subtype = InternalVal( $obj, 'SUBTYPE', 'generic' )
|
|
if ( $TYPE eq 'GUEST' );
|
|
|
|
$subtype = $RESIDENTStk_types{en}{$TYPE}
|
|
if ( $subtype eq 'generic' );
|
|
|
|
my $importance = 99;
|
|
my (@index) = grep { $homealoneSubTypes[$_] eq $subtype }
|
|
0 .. scalar @homealoneSubTypes - 1;
|
|
$importance = $index[0] if ( scalar @index );
|
|
|
|
my $importance2 = 99;
|
|
if ($homealone_subtype) {
|
|
my (@index2) =
|
|
grep { $homealoneSubTypes[$_] eq $homealone_subtype }
|
|
0 .. scalar @homealoneSubTypes - 1;
|
|
$importance2 = $index2[0] if ( scalar @index2 );
|
|
}
|
|
|
|
$homealone_type = $TYPE
|
|
if ( !$homealone_type || $importance2 < $importance );
|
|
$homealone_subtype = $subtype
|
|
if ( !$homealone_subtype || $importance2 < $importance );
|
|
$newstate_prefix = ( $TYPE eq 'PET' ? 'pet' : $subtype )
|
|
if ( !$newstate_prefix || $importance2 < $importance );
|
|
}
|
|
}
|
|
readingsBulkUpdateIfChanged( $hash, "lastHomealoneType",
|
|
ReadingsVal( $name, "homealoneType", "-" ) )
|
|
if ( ReadingsVal( $name, "homealoneType", undef ) );
|
|
readingsBulkUpdateIfChanged( $hash, "lastHomealoneSubtype",
|
|
ReadingsVal( $name, "homealoneSubtype", "-" ) )
|
|
if ( ReadingsVal( $name, "homealoneSubtype", undef ) );
|
|
|
|
readingsBulkUpdateIfChanged( $hash, "homealoneType",
|
|
$homealone_type ? $homealone_type : '-' );
|
|
readingsBulkUpdateIfChanged( $hash, "homealoneSubtype",
|
|
$homealone_subtype ? $homealone_subtype : '-' );
|
|
|
|
$newstate = $newstate_prefix . '_' . $newstate
|
|
if ( $homealoneInStatus ne '0' && $newstate_prefix );
|
|
|
|
Log3 $name, 4,
|
|
"RESIDENTS $name: calculation result - residentsTotal:$state_total residentsTotalRoommates:$state_totalRoommates residentsTotalRoommatesPresent:$state_totalRoommatesPresent residentsTotalRoommatesAbsent:$state_totalRoommatesAbsent residentsTotalGuests:$state_totalGuests residentsTotalPets:$state_totalPets residentsTotalGuestsPresent:$state_totalGuestsPresent residentsTotalPetsPresent:$state_totalPetsPresent residentsTotalGuestsAbsent:$state_totalGuestsAbsent residentsTotalPetsAbsent:$state_totalPetsAbsent residentsTotalPresent:$state_totalPresent residentsTotalAbsent:$state_totalAbsent residentsHome:$state_home residentsGotosleep:$state_gotosleep residentsAsleep:$state_asleep residentsAwoken:$state_awoken residentsAbsent:$state_absent residentsGone:$state_gone presence:$newpresence state:$newstate homealone:$state_homealone";
|
|
|
|
# safe current time
|
|
my $datetime = FmtDateTime(time);
|
|
|
|
# if state changed
|
|
if ( $state ne $newstate ) {
|
|
|
|
# stop any running wakeup-timers in case state changed
|
|
my $wakeupState = AttrVal( $name, "wakeup", 0 );
|
|
if ($wakeupState) {
|
|
my $wakeupDeviceList = AttrVal( $name, "rgr_wakeupDevice", 0 );
|
|
|
|
for my $wakeupDevice ( split /,/, $wakeupDeviceList ) {
|
|
next if !$wakeupDevice;
|
|
|
|
if ( IsDevice( $wakeupDevice, "dummy" ) ) {
|
|
|
|
# forced-stop only if resident is not present anymore
|
|
if ( $newpresence eq "present" ) {
|
|
fhem "set $wakeupDevice:FILTER=running!=0 end";
|
|
}
|
|
else {
|
|
fhem "set $wakeupDevice:FILTER=running!=0 stop";
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
# if newstate is asleep, start sleep timer
|
|
readingsBulkUpdate( $hash, "lastSleep", $datetime )
|
|
if ( $newstate eq "asleep" );
|
|
|
|
# if prior state was asleep, update sleep statistics
|
|
if ( $state eq "asleep"
|
|
&& ReadingsVal( $name, "lastSleep", "" ) ne "" )
|
|
{
|
|
readingsBulkUpdate( $hash, "lastAwake", $datetime );
|
|
readingsBulkUpdate(
|
|
$hash,
|
|
"lastDurSleep",
|
|
UConv::duration(
|
|
$datetime, ReadingsVal( $name, "lastSleep", "" )
|
|
)
|
|
);
|
|
readingsBulkUpdate(
|
|
$hash,
|
|
"lastDurSleep_cr",
|
|
UConv::duration(
|
|
$datetime, ReadingsVal( $name, "lastSleep", "" ), "min"
|
|
)
|
|
);
|
|
}
|
|
|
|
readingsBulkUpdate( $hash, "lastState",
|
|
ReadingsVal( $name, "state", "initialized" ) );
|
|
readingsBulkUpdate( $hash, "state", $newstate );
|
|
}
|
|
|
|
# if presence changed
|
|
if ( $newpresence ne $presence ) {
|
|
readingsBulkUpdate( $hash, "presence", $newpresence );
|
|
|
|
# update statistics
|
|
if ( $newpresence eq "present" ) {
|
|
readingsBulkUpdate( $hash, "lastArrival", $datetime );
|
|
|
|
# absence duration
|
|
if ( ReadingsVal( $name, "lastDeparture", "-" ) ne "-" ) {
|
|
readingsBulkUpdate(
|
|
$hash,
|
|
"lastDurAbsence",
|
|
UConv::duration(
|
|
$datetime, ReadingsVal( $name, "lastDeparture", "-" )
|
|
)
|
|
);
|
|
readingsBulkUpdate(
|
|
$hash,
|
|
"lastDurAbsence_cr",
|
|
UConv::duration(
|
|
$datetime, ReadingsVal( $name, "lastDeparture", "-" ),
|
|
"min"
|
|
)
|
|
);
|
|
}
|
|
}
|
|
else {
|
|
readingsBulkUpdate( $hash, "lastDeparture", $datetime );
|
|
|
|
# presence duration
|
|
if ( ReadingsVal( $name, "lastArrival", "-" ) ne "-" ) {
|
|
readingsBulkUpdate(
|
|
$hash,
|
|
"lastDurPresence",
|
|
UConv::duration(
|
|
$datetime, ReadingsVal( $name, "lastArrival", "-" )
|
|
)
|
|
);
|
|
readingsBulkUpdate(
|
|
$hash,
|
|
"lastDurPresence_cr",
|
|
UConv::duration(
|
|
$datetime, ReadingsVal( $name, "lastArrival", "-" ),
|
|
"min"
|
|
)
|
|
);
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
# calculate duration timers
|
|
RESIDENTStk_DurationTimer( $hash, 1 );
|
|
}
|
|
|
|
1;
|
|
|
|
=pod
|
|
=item helper
|
|
=item summary combines ROOMMATE, GUEST and PET devices to a residential community
|
|
=item summary_de fasst ROOMMATE, GUEST und PET Geräte zu einer Wohngemeinschaft zusammen
|
|
=begin html
|
|
|
|
<p>
|
|
<a name="RESIDENTS" id="RESIDENTS"></a>
|
|
</p>
|
|
<h3>
|
|
RESIDENTS
|
|
</h3>
|
|
<ul>
|
|
<a name="RESIDENTSdefine" id="RESIDENTSdefine"></a> <b>Define</b>
|
|
<ul>
|
|
<code>define <rgr_ResidentsName> RESIDENTS</code><br>
|
|
<br>
|
|
Provides a special virtual device to represent a group of individuals living at your home.<br>
|
|
It locically combines individual states of <a href="#ROOMMATE">ROOMMATE</a>, <a href="#GUEST">GUEST</a> and <a href="#PET">PET</a> devices and allows state changes for all members.<br>
|
|
Based on the current state and other readings, you may trigger other actions within FHEM.<br>
|
|
<br>
|
|
Example:<br>
|
|
<ul>
|
|
<code># Standalone<br>
|
|
define rgr_Residents RESIDENTS</code>
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<a name="RESIDENTSset" id="RESIDENTSset"></a> <b>Set</b>
|
|
<ul>
|
|
<code>set <rgr_ResidentsName> <command> [<parameter>]</code><br>
|
|
<br>
|
|
Currently, the following commands are defined.<br>
|
|
<ul>
|
|
<li>
|
|
<b>addGuest</b> - creates a new GUEST device and adds it to the current RESIDENTS group. Just enter the dummy name and there you go.
|
|
</li>
|
|
<li>
|
|
<b>addPet</b> - creates a new PET device and adds it to the current RESIDENTS group. Just enter the dummy name and there you go.
|
|
</li>
|
|
<li>
|
|
<b>addRoommate</b> - creates a new ROOMMATE device and adds it to the current RESIDENTS group. Just enter the first name and there you go.
|
|
</li>
|
|
<li>
|
|
<b>removeGuest</b> - shows all GUEST members and allows to delete their dummy devices easily.
|
|
</li>
|
|
<li>
|
|
<b>removePet</b> - shows all PET members and allows to delete their dummy devices easily.
|
|
</li>
|
|
<li>
|
|
<b>removeRoommate</b> - shows all ROOMMATE members and allows to delete their dummy devices easily.
|
|
</li>
|
|
<li>
|
|
<b>state</b> home,gotosleep,asleep,awoken,absent,gone switch between states for all group members at once; see attribute rgr_states to adjust list shown in FHEMWEB
|
|
</li>
|
|
<li>
|
|
<b>create</b> wakeuptimer add several pre-configurations provided by RESIDENTS Toolkit. See separate section for details.
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<u>Note:</u> If you would like to restrict access to admin set-commands (-> addGuest, addPet, addRoommate, removeGuest, removePet, create) you may set your FHEMWEB instance's attribute allowedCommands like 'set,set-user'.
|
|
The string 'set-user' will ensure only non-admin set-commands can be executed when accessing FHEM using this FHEMWEB instance.
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<ul>
|
|
<u>Possible states and their meaning</u><br>
|
|
<br>
|
|
<ul>
|
|
This module differs between 7 states:<br>
|
|
<br>
|
|
<ul>
|
|
<li>
|
|
<b>home</b> - residents are present at home and at least one of them is not asleep
|
|
</li>
|
|
<li>
|
|
<b>gotosleep</b> - present residents are on their way to bed (if they are not asleep already)
|
|
</li>
|
|
<li>
|
|
<b>asleep</b> - all present residents are currently sleeping
|
|
</li>
|
|
<li>
|
|
<b>awoken</b> - at least one resident just woke up from sleep
|
|
</li>
|
|
<li>
|
|
<b>absent</b> - no resident is currently at home but at least one will be back shortly
|
|
</li>
|
|
<li>
|
|
<b>gone</b> - all residents left home for longer period
|
|
</li>
|
|
<li>
|
|
<b>none</b> - no active member
|
|
</li>
|
|
</ul><br>
|
|
<br>
|
|
Note: State 'none' cannot explicitly be set. Setting state to 'gone' will be handled as 'none' for GUEST or PET member devices.
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<a name="RESIDENTSattr" id="RESIDENTSattr"></a> <b>Attributes</b><br>
|
|
<ul>
|
|
<ul>
|
|
<li>
|
|
<b>rgr_homealoneInStatus</b> - if set, state will have a prefix of the value of residentsHomealoneSubtype; In case it is a pet, it will only be copied to state as 'pet'. Defaults to "0"
|
|
</li>
|
|
<li>
|
|
<b>rgr_homealoneSubTypes</b> - a list of subTypes that will trigger home alone status if they are the only ones present at home. The order here will also affect the determination of the person with the most responsibility at home. The sorting order starts with least important to most important.
|
|
</li>
|
|
<li>
|
|
<b>rgr_lang</b> - overwrite global language setting; helps to set device attributes to translate FHEMWEB display text
|
|
</li>
|
|
<li>
|
|
<b>rgr_noDuration</b> - may be used to disable continuous, non-event driven duration timer calculation (see readings durTimer*)
|
|
</li>
|
|
<li>
|
|
<b>rgr_showAllStates</b> - states 'asleep' and 'awoken' are hidden by default to allow simple gotosleep process via devStateIcon; defaults to 0
|
|
</li>
|
|
<li>
|
|
<b>rgr_states</b> - list of states to be shown in FHEMWEB; separate entries by comma only and do NOT use spaces; unsupported states will lead to errors though
|
|
</li>
|
|
<li>
|
|
<b>rgr_wakeupDevice</b> - reference to enslaved DUMMY devices used as a wake-up timer (part of RESIDENTS Toolkit's wakeuptimer)
|
|
</li>
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<br>
|
|
<b>Generated Readings/Events:</b><br>
|
|
<ul>
|
|
<ul>
|
|
<li>
|
|
<b>homealoneSubtype</b> - subType of the residential object in charge
|
|
</li>
|
|
<li>
|
|
<b>homealoneType</b> - type of the residential object in charge
|
|
</li>
|
|
<li>
|
|
<b>lastActivity</b> - the last state change of one of the group members
|
|
</li>
|
|
<li>
|
|
<b>lastActivityBy</b> - the realname of the last group member with changed state
|
|
</li>
|
|
<li>
|
|
<b>lastArrival</b> - timestamp of last arrival at home
|
|
</li>
|
|
<li>
|
|
<b>lastAwake</b> - timestamp of last sleep cycle end
|
|
</li>
|
|
<li>
|
|
<b>lastDeparture</b> - timestamp of last departure from home
|
|
</li>
|
|
<li>
|
|
<b>lastDurAbsence</b> - duration of last absence from home in human readable format (hours:minutes:seconds)
|
|
</li>
|
|
<li>
|
|
<b>lastDurAbsence_cr</b> - duration of last absence from home in computer readable format (minutes)
|
|
</li>
|
|
<li>
|
|
<b>lastDurPresence</b> - duration of last presence at home in human readable format (hours:minutes:seconds)
|
|
</li>
|
|
<li>
|
|
<b>lastDurPresence_cr</b> - duration of last presence at home in computer readable format (minutes)
|
|
</li>
|
|
<li>
|
|
<b>lastDurSleep</b> - duration of last sleep in human readable format (hours:minutes:seconds)
|
|
</li>
|
|
<li>
|
|
<b>lastDurSleep_cr</b> - duration of last sleep in computer readable format (minutes)
|
|
</li>
|
|
<li>
|
|
<b>lastSleep</b> - timestamp of last sleep cycle begin
|
|
</li>
|
|
<li>
|
|
<b>lastState</b> - the prior state
|
|
</li>
|
|
<li>
|
|
<b>lastWakeup</b> - time of last wake-up timer run
|
|
</li>
|
|
<li>
|
|
<b>lastWakeupDev</b> - device name of last wake-up timer
|
|
</li>
|
|
<li>
|
|
<b>nextWakeup</b> - time of next wake-up program run
|
|
</li>
|
|
<li>
|
|
<b>nextWakeupDev</b> - device name for next wake-up program run
|
|
</li>
|
|
<li>
|
|
<b>presence</b> - reflects the home presence state, depending on value of reading 'state' (can be 'present' or 'absent')
|
|
</li>
|
|
<li>
|
|
<b>residentsAbsent</b> - number of residents with state 'absent'
|
|
</li>
|
|
<li>
|
|
<b>residentsAbsentDevs</b> - device name of residents with state 'absent'
|
|
</li>
|
|
<li>
|
|
<b>residentsAbsentNames</b> - device alias of residents with state 'absent'
|
|
</li>
|
|
<li>
|
|
<b>residentsAsleep</b> - number of residents with state 'asleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsAsleepDevs</b> - device name of residents with state 'asleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsAsleepNames</b> - device alias of residents with state 'asleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsAwoken</b> - number of residents with state 'awoken'
|
|
</li>
|
|
<li>
|
|
<b>residentsAwokenDevs</b> - device name of residents with state 'awoken'
|
|
</li>
|
|
<li>
|
|
<b>residentsAwokenNames</b> - device alias of residents with state 'awoken'
|
|
</li>
|
|
<li>
|
|
<b>residentsGone</b> - number of residents with state 'gone'
|
|
</li>
|
|
<li>
|
|
<b>residentsGoneDevs</b> - device name of residents with state 'gone'
|
|
</li>
|
|
<li>
|
|
<b>residentsGoneNames</b> - device alias of residents with state 'gone'
|
|
</li>
|
|
<li>
|
|
<b>residentsGotosleep</b> - number of residents with state 'gotosleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsGotosleepDevs</b> - device name of residents with state 'gotosleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsGotosleepNames</b> - device alias of residents with state 'gotosleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsHome</b> - number of residents with state 'home'
|
|
</li>
|
|
<li>
|
|
<b>residentsHomeDevs</b> - device name of residents with state 'home'
|
|
</li>
|
|
<li>
|
|
<b>residentsHomeNames</b> - device alias of residents with state 'home'
|
|
</li>
|
|
<li>
|
|
<b>residentsTotal</b> - total number of all active residents despite their current state
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalAbsent</b> - number of all residents who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalAbsentDevs</b> - device name of all residents who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalAbsentNames</b> - device alias of all residents who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuests</b> - number of active guests who are currently treated as part of the residents scope
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsAbsent</b> - number of all active guests who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsAbsentDevs</b> - device name of all active guests who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsAbsentNames</b> - device alias of all active guests who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsPresent</b> - number of all active guests who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsPresentDevs</b> - device name of all active guests who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsPresentNames</b> - device alias of all active guests who are currently at home
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
<b>residentsTotalPeople</b> - number of active people who are currently treated as part of the residents scope
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeopleAbsent</b> - number of all active people who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeopleAbsentDevs</b> - device name of all active people who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeopleAbsentNames</b> - device alias of all active people who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeoplePresent</b> - number of all active people who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeoplePresentDevs</b> - device name of all active people who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeoplePresentNames</b> - device alias of all active people who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPets</b> - number of pets treated as being a permanent resident
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsAbsent</b> - number of all pets who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsAbsentDevs</b> - device name of all pets who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsAbsentNames</b> - device alias of all pets who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsPresent</b> - number of all pets who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsPresentDevs</b> - device name of all pets who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsPresentNames</b> - device alias of all pets who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommates</b> - number of residents treated as being a permanent resident
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesAbsent</b> - number of all roommates who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesAbsentDevs</b> - device name of all roommates who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesAbsentNames</b> - device alias of all roommates who are currently underway
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesPresent</b> - number of all roommates who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesPresentDevs</b> - device name of all roommates who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesPresentNames</b> - device alias of all roommates who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPresent</b> - number of all residents who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPresentDevs</b> - device name of all residents who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPresentNames</b> - device alias of all residents who are currently at home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWakeup</b> - number of all residents which currently have a wake-up program being executed
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWakeupDevs</b> - device name of all residents which currently have a wake-up program being executed
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWakeupNames</b> - device alias of all residents which currently have a wake-up program being executed
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhome</b> - number of all active residents who are currently on their way back home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDevs</b> - device name of all active residents who are currently on their way back home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeNames</b> - device alias of all active residents who are currently on their way back home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDelayed</b> - number of all residents who are delayed on their way back home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDelayedDevs</b> - device name of all delayed residents who are currently on their way back home
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDelayedNames</b> - device alias of all delayed residents who are currently on their way back home
|
|
</li>
|
|
<li>
|
|
<b>state</b> - reflects the current state
|
|
</li>
|
|
<li>
|
|
<b>wakeup</b> - becomes '1' while a wake-up program of this resident group is being executed
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<br>
|
|
<br>
|
|
<b>RESIDENTS Toolkit</b><br>
|
|
<ul>
|
|
<ul>
|
|
Using set-command <code>create</code> you may add pre-configured configurations to your RESIDENTS, <a href="#ROOMMATE">ROOMMATE</a>, <a href="#GUEST">GUEST</a> or <a href="#PET">PET</a> devices for your convenience.<br>
|
|
The following commands are currently available:<br>
|
|
<br>
|
|
<li>
|
|
<b>wakeuptimer</b> - adds a wake-up timer dummy device with enhanced functions to start with wake-up automations
|
|
<ul>
|
|
A notify device is created to be used as a Macro to carry out your actual automations. The macro is triggered by a normal at device you may customize as well. However, a special RESIDENTS Toolkit function is handling the wake-up trigger event for you.<br>
|
|
The time of activated wake-up timers may be relatively increased or decreased by using +<MINUTES> or -<MINUTES> respectively. +HH:MM can be used as well.<br>
|
|
<br>
|
|
The wake-up behaviour may be influenced by the following device attributes:<br>
|
|
<li>
|
|
<i>wakeupAtdevice</i> - backlink the at device (mandatory)
|
|
</li>
|
|
<li>
|
|
<i>wakeupDays</i> - only trigger macro at these days. Mon=1,Tue=2,Wed=3,Thu=4,Fri=5,Sat=6,Sun=0 (optional)
|
|
</li>
|
|
<li>
|
|
<i>wakeupDefaultTime</i> - after triggering macro reset the wake-up time to this default value (optional)
|
|
</li>
|
|
<li>
|
|
<i>wakeupEnforced</i> - Enforce wake-up (optional; 0=no, 1=yes, 2=if wake-up time is not wakeupDefaultTime, 3=if wake-up time is earlier than wakeupDefaultTime)
|
|
</li>
|
|
<li>
|
|
<i>wakeupHolidays</i> - May trigger macro on holidays or non-holidays (optional; andHoliday=on holidays also considering wakeupDays, orHoliday=on holidays independently of wakeupDays, andNoHoliday=on non-holidays also considering wakeupDays, orNoHoliday=on non-holidays independently of wakeupDays)
|
|
</li>
|
|
<li>
|
|
<i>wakeupMacro</i> - name of the notify macro device (mandatory)
|
|
</li>
|
|
<li>
|
|
<i>wakeupOffset</i> - value in minutes to trigger your macro earlier than the user requested to be woken up, e.g. if you have a complex wake-up program over 30 minutes (defaults to 0)
|
|
</li>
|
|
<li>
|
|
<i>wakeupResetSwitcher</i> - DUMMY device to quickly turn on/off reset function (optional, device will be auto-created)
|
|
</li>
|
|
<li>
|
|
<i>wakeupResetdays</i> - if wakeupDefaultTime is set you may restrict timer reset to specific days only. Mon=1,Tue=2,Wed=3,Thu=4,Fri=5,Sat=6,Sun=0 (optional)
|
|
</li>
|
|
<li>
|
|
<i>wakeupUserdevice</i> - backlink to RESIDENTS, ROOMMATE, GUEST or PET device to check its status (mandatory)
|
|
</li>
|
|
<li>
|
|
<i>wakeupWaitPeriod</i> - waiting period threshold in minutes until wake-up program may be triggered again, e.g. if you manually set an earlier wake-up time than normal while using wakeupDefaultTime. Does not apply in case wake-up time was changed during this period; defaults to 360 minutes / 6h (optional)
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
</ul>
|
|
|
|
=end html
|
|
|
|
=begin html_DE
|
|
|
|
<p>
|
|
<a name="RESIDENTS" id="RESIDENTS"></a>
|
|
</p>
|
|
<h3>
|
|
RESIDENTS
|
|
</h3>
|
|
<ul>
|
|
<a name="RESIDENTSdefine" id="RESIDENTSdefine"></a> <b>Define</b>
|
|
<ul>
|
|
<code>define <rgr_ResidentsName> RESIDENTS</code><br>
|
|
<br>
|
|
Stellt ein spezielles virtuelles Device bereit, um eine Gruppe von Personen zu repräsentieren, die zusammen wohnen.<br>
|
|
Es kombiniert dabei logisch die individuellen Status von <a href="#ROOMMATE">ROOMMATE</a>, <a href="#GUEST">GUEST</a> und <a href="#PET">PET</a> Devices und erlaubt den Status für alle Mitglieder zeitgleich zu ändern. Basierend auf dem aktuellen Status und anderen Readings können andere Aktionen innerhalb von FHEM angestoßen werden.<br>
|
|
<br>
|
|
Beispiele:<br>
|
|
<ul>
|
|
<code># Einzeln<br>
|
|
define rgr_Residents RESIDENTS</code>
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<a name="RESIDENTSset" id="RESIDENTSset"></a> <b>Set</b>
|
|
<ul>
|
|
<code>set <rgr_ResidentsName> <command> [<parameter>]</code><br>
|
|
<br>
|
|
Momentan sind die folgenden Kommandos definiert.<br>
|
|
<ul>
|
|
<li>
|
|
<b>addGuest</b> - erstellt ein neues GUEST Device und fügt es der aktuellen RESIDENTS Gruppe hinzu. Einfach den Platzhalternamen eingeben und das wars.
|
|
</li>
|
|
<li>
|
|
<b>addPet</b> - erstellt ein neues PET Device und fügt es der aktuellen RESIDENTS Gruppe hinzu. Einfach den Platzhalternamen eingeben und das wars.
|
|
</li>
|
|
<li>
|
|
<b>addRoommate</b> - erstellt ein neues ROOMMATE Device und fügt es der aktuellen RESIDENTS Gruppe hinzu. Einfach den Vornamen eingeben und das wars.
|
|
</li>
|
|
<li>
|
|
<b>removeGuest</b> - zeigt alle Mitglieder vom Typ GUEST an und ermöglicht ein einfaches löschen des dazugehörigen Dummy Devices.
|
|
</li>
|
|
<li>
|
|
<b>removePet</b> - zeigt alle Mitglieder vom Typ PET an und ermöglicht ein einfaches löschen des dazugehörigen Dummy Devices.
|
|
</li>
|
|
<li>
|
|
<b>removeRoommate</b> - zeigt alle Mitglieder vom Typ ROOMMATE an und ermöglicht ein einfaches löschen des dazugehörigen Dummy Devices.
|
|
</li>
|
|
<li>
|
|
<b>state</b> home,gotosleep,asleep,awoken,absent,gone wechselt den Status für alle Gruppenmitglieder gleichzeitig; siehe Attribut rgr_states, um die angezeigte Liste in FHEMWEB abzuändern
|
|
</li>
|
|
<li>
|
|
<b>create</b> wakeuptimer fügt diverse Vorkonfigurationen auf Basis von RESIDENTS Toolkit hinzu. Siehe separate Sektion.
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<u>Hinweis:</u> Sofern der Zugriff auf administrative set-Kommandos (-> addGuest, addPet, addRoommate, removeGuest, removePet, create) eingeschränkt werden soll, kann in einer FHEMWEB Instanz das Attribut allowedCommands ähnlich wie 'set,set-user' erweitert werden.
|
|
Die Zeichenfolge 'set-user' stellt dabei sicher, dass beim Zugriff auf FHEM über diese FHEMWEB Instanz nur nicht-administrative set-Kommandos ausgeführt werden können.
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<ul>
|
|
<u>Mögliche Status und ihre Bedeutung</u><br>
|
|
<br>
|
|
<ul>
|
|
Dieses Modul unterscheidet 7 verschiedene Status:<br>
|
|
<br>
|
|
<ul>
|
|
<li>
|
|
<b>home</b> - Bewohner sind zu Hause und mindestens einer schläft nicht
|
|
</li>
|
|
<li>
|
|
<b>gotosleep</b> - alle anwesenden Bewohner sind auf dem Weg ins Bett (wenn sie nicht schon schlafen)
|
|
</li>
|
|
<li>
|
|
<b>asleep</b> - alle anwesenden Bewohner schlafen
|
|
</li>
|
|
<li>
|
|
<b>awoken</b> - mindestens einer der anwesenden Bewohner ist gerade aufgewacht
|
|
</li>
|
|
<li>
|
|
<b>absent</b> - keiner der Bewohner ist momentan zu Hause; mindestens einer ist aber in Kürze zurück
|
|
</li>
|
|
<li>
|
|
<b>gone</b> - alle Bewohner sind für längere Zeit verreist
|
|
</li>
|
|
<li>
|
|
<b>none</b> - kein Mitglied aktiv
|
|
</li>
|
|
</ul><br>
|
|
<br>
|
|
Hinweis: Der Status 'none' kann nicht explizit gesetzt werden. Das setzen von 'gone' wird bei Mitgliedern vom Typ GUEST oder PET als 'none' behandelt.
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<a name="RESIDENTSattr" id="RESIDENTSattr"></a> <b>Attribute</b><br>
|
|
<ul>
|
|
<ul>
|
|
<li>
|
|
<b>rgr_homealoneInStatus</b> - wenn aktiviert, dann erhält state den Wert von HomealoneSubtype als Präfix; Standard ist "0"
|
|
</li>
|
|
<li>
|
|
<b>rgr_homealoneSubTypes</b> - eine Liste von subTypes, die den Home Alone Status auslösen, sofern sie diese die einzigen Anwesenden zu Hause sind. Die Reihenfolge beeinflusst die Bestimmung der Person mit der höchsten Verantwortung im Haus. Die Sortierung geht vom unwichtigsten zum wichtigsten.
|
|
</li>
|
|
<li>
|
|
<b>rgr_lang</b> - überschreibt globale Spracheinstellung; hilft beim setzen von Device Attributen, um FHEMWEB Anzeigetext zu übersetzen
|
|
</li>
|
|
<li>
|
|
<b>rgr_noDuration</b> - deaktiviert die kontinuierliche, nicht Event-basierte Berechnung der Zeitspannen (siehe Readings durTimer*)
|
|
</li>
|
|
<li>
|
|
<b>rgr_showAllStates</b> - die Status 'asleep' und 'awoken' sind normalerweise nicht immer sichtbar, um einen einfachen Zubettgeh-Prozess über das devStateIcon Attribut zu ermöglichen; Standard ist 0
|
|
</li>
|
|
<li>
|
|
<b>rgr_states</b> - Liste aller in FHEMWEB angezeigter Status; Eintrage nur mit Komma trennen und KEINE Leerzeichen benutzen; nicht unterstützte Status führen zu Fehlern
|
|
</li>
|
|
<li>
|
|
<b>rgr_wakeupDevice</b> - Referenz zu versklavten DUMMY Geräten, welche als Wecker benutzt werden (Teil von RESIDENTS Toolkit's wakeuptimer)
|
|
</li>
|
|
</ul>
|
|
</ul><br>
|
|
<br>
|
|
<br>
|
|
<b>Generierte Readings/Events:</b><br>
|
|
<ul>
|
|
<ul>
|
|
<li>
|
|
<b>homealoneSubtype</b> - subType des Bewohner Objekts in Verantwortung
|
|
</li>
|
|
<li>
|
|
<b>homealoneType</b> - type des Bewohner Objekts in Verantwortung
|
|
</li>
|
|
<li>
|
|
<b>lastActivity</b> - der letzte Status Wechsel eines Gruppenmitglieds
|
|
</li>
|
|
<li>
|
|
<b>lastActivityBy</b> - der Name des Gruppenmitglieds, dessen Status zuletzt geändert wurde
|
|
</li>
|
|
<li>
|
|
<b>lastArrival</b> - Zeitstempel der letzten Ankunft zu Hause
|
|
</li>
|
|
<li>
|
|
<b>lastAwake</b> - Zeitstempel des Endes des letzten Schlafzyklus
|
|
</li>
|
|
<li>
|
|
<b>lastDeparture</b> - Zeitstempel des letzten Verlassens des Zuhauses
|
|
</li>
|
|
<li>
|
|
<b>lastDurAbsence</b> - Dauer der letzten Abwesenheit in normal lesbarem Format (Stunden:Minuten:Sekunden)
|
|
</li>
|
|
<li>
|
|
<b>lastDurAbsence_cr</b> - Dauer der letzten Abwesenheit in Computer lesbarem Format (Minuten)
|
|
</li>
|
|
<li>
|
|
<b>lastDurPresence</b> - Dauer der letzten Anwesenheit in normal lesbarem Format (Stunden:Minuten:Sekunden)
|
|
</li>
|
|
<li>
|
|
<b>lastDurPresence_cr</b> - Dauer der letzten Anwesenheit in Computer lesbarem Format (Minuten)
|
|
</li>
|
|
<li>
|
|
<b>lastDurSleep</b> - Dauer des letzten Schlafzyklus in normal lesbarem Format (Stunden:Minuten:Sekunden)
|
|
</li>
|
|
<li>
|
|
<b>lastDurSleep_cr</b> - Dauer des letzten Schlafzyklus in Computer lesbarem Format (Minuten)
|
|
</li>
|
|
<li>
|
|
<b>lastSleep</b> - Zeitstempel des Beginns des letzten Schlafzyklus
|
|
</li>
|
|
<li>
|
|
<b>lastState</b> - der vorherige Status
|
|
</li>
|
|
<li>
|
|
<b>lastWakeup</b> - Zeit der letzten Wake-up Timer Ausführing
|
|
</li>
|
|
<li>
|
|
<b>lastWakeupDev</b> - Device Name des zuletzt verwendeten Wake-up Timers
|
|
</li>
|
|
<li>
|
|
<b>nextWakeup</b> - Zeit der nächsten Wake-up Timer Ausführung
|
|
</li>
|
|
<li>
|
|
<b>nextWakeupDev</b> - Device Name des als nächstes ausgefährten Wake-up Timer
|
|
</li>
|
|
<li>
|
|
<b>presence</b> - gibt den zu Hause Status in Abhängigkeit des Readings 'state' wieder (kann 'present' oder 'absent' sein)
|
|
</li>
|
|
<li>
|
|
<b>residentsAbsent</b> - Anzahl der Bewohner mit Status 'absent'
|
|
</li>
|
|
<li>
|
|
<b>residentsAbsentDevs</b> - Gerätename der Bewohner mit Status 'absent'
|
|
</li>
|
|
<li>
|
|
<b>residentsAbsentNames</b> - Gerätealias der Bewohner mit Status 'absent'
|
|
</li>
|
|
<li>
|
|
<b>residentsAsleep</b> - Anzahl der Bewohner mit Status 'asleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsAsleepDevs</b> - Gerätename der Bewohner mit Status 'asleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsAsleepNames</b> - Gerätealias der Bewohner mit Status 'asleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsAwoken</b> - Anzahl der Bewohner mit Status 'awoken'
|
|
</li>
|
|
<li>
|
|
<b>residentsAwokenDevs</b> - Gerätename der Bewohner mit Status 'awoken'
|
|
</li>
|
|
<li>
|
|
<b>residentsAwokenNames</b> - Gerätealias der Bewohner mit Status 'awoken'
|
|
</li>
|
|
<li>
|
|
<b>residentsGone</b> - Anzahl der Bewohner mit Status 'gone'
|
|
</li>
|
|
<li>
|
|
<b>residentsGoneDevs</b> - Gerätename der Bewohner mit Status 'gone'
|
|
</li>
|
|
<li>
|
|
<b>residentsGoneNames</b> - Gerätealias der Bewohner mit Status 'gone'
|
|
</li>
|
|
<li>
|
|
<b>residentsGotosleep</b> - Anzahl der Bewohner mit Status 'gotosleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsGotosleepDevs</b> - Gerätename der Bewohner mit Status 'gotosleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsGotosleepNames</b> - Gerätealias der Bewohner mit Status 'gotosleep'
|
|
</li>
|
|
<li>
|
|
<b>residentsHome</b> - Anzahl der Bewohner mit Status 'home'
|
|
</li>
|
|
<li>
|
|
<b>residentsHomeDevs</b> - Gerätename der Bewohner mit Status 'home'
|
|
</li>
|
|
<li>
|
|
<b>residentsHomeNames</b> - Gerätealias der Bewohner mit Status 'home'
|
|
</li>
|
|
<li>
|
|
<b>residentsTotal</b> - Summe aller aktiven Bewohner unabhängig von ihrem aktuellen Status
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalAbsent</b> - Summe aller aktiven Bewohner, die unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalAbsentDevs</b> - Gerätename aller aktiven Bewohner, die unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalAbsentNames</b> - Gerätealias aller aktiven Bewohner, die unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuests</b> - Anzahl der aktiven Gäste, welche momentan zu den Bewohnern dazugezählt werden
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsAbsent</b> - Anzahl der aktiven Gäste, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsAbsentDevs</b> - Gerätename der aktiven Gäste, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsAbsentNames</b> - Gerätealias der aktiven Gäste, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsPresent</b> - Anzahl der aktiven Gäste, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsPresentDevs</b> - Gerätename der aktiven Gäste, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalGuestsPresentNames</b> - Gerätealias der aktiven Gäste, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeople</b> - Anzahl der aktiven Personen, welche momentan zu den Bewohnern dazugezählt werden
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeopleAbsent</b> - Anzahl der aktiven Personen, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeopleAbsentDevs</b> - Gerätename der aktiven Personen, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeopleAbsentNames</b> - Gerätealias der aktiven Personen, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeoplePresent</b> - Anzahl der aktiven Personen, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeoplePresentDevs</b> - Gerätename der aktiven Personen, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPeoplePresentNames</b> - Gerätealias der aktiven Personen, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPets</b> - Anzahl der Haustiere, die als permanente Bewohner behandelt werden
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsAbsent</b> - Anzahl der Haustiere, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsAbsentDevs</b> - Gerätename der Haustiere, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsAbsentNames</b> - Gerätealias der Haustiere, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsPresent</b> - Anzahl der Haustiere, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsPresentDevs</b> - Gerätename der Haustiere, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPetsPresentNames</b> - Gerätealias der Haustiere, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommates</b> - Anzahl der Bewohner, die als permanente Bewohner behandelt werden
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesAbsent</b> - Anzahl der Besitzer, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesAbsentDevs</b> - Gerätename der Besitzer, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesAbsentNames</b> - Gerätealias der Besitzer, die momentan unterwegs sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesPresent</b> - Anzahl der Besitzer, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesPresentDevs</b> - Gerätename der Besitzer, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalRoommatesPresentNames</b> - Gerätealias der Besitzer, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPresent</b> - Summe aller aktiven Bewohner, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPresentDevs</b> - Gerätename aller aktiven Bewohner, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalPresentNames</b> - Gerätealias aller aktiven Bewohner, die momentan zu Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWakeup</b> - Summe aller Bewohner, bei denen aktuell ein Weckprogramm ausgeführt wird
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWakeupDevs</b> - Gerätename aller Bewohner, bei denen aktuell ein Weckprogramm ausgeführt wird
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWakeupNames</b> - Gerätealias aller Bewohner, bei denen aktuell ein Weckprogramm ausgeführt wird
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhome</b> - Summe aller aktiven Bewohner, die momentan auf dem Weg zurück nach Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDevs</b> - Gerätename aller aktiven Bewohner, die momentan auf dem Weg zurück nach Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeNames</b> - Gerätealias aller aktiven Bewohner, die momentan auf dem Weg zurück nach Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDelayed</b> - Summe aller Bewohner, die momentan mit Verspätung auf dem Weg zurück nach Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDelayedDevs</b> - Gerätename aller Bewohner, die momentan verspätet auf dem Weg zurück nach Hause sind
|
|
</li>
|
|
<li>
|
|
<b>residentsTotalWayhomeDelayedNames</b> - Gerätealias aller Bewohner, die momentan verspätet auf dem Weg zurück nach Hause sind
|
|
</li>
|
|
<li>
|
|
<b>state</b> - gibt den aktuellen Status wieder
|
|
</li>
|
|
<li>
|
|
<b>wakeup</b> - hat den Wert '1' während ein Weckprogramm dieser Bewohner-Gruppe ausgeführt wird
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
<br>
|
|
<br>
|
|
<b>RESIDENTS Toolkit</b><br>
|
|
<ul>
|
|
<ul>
|
|
Mit dem set-Kommando <code>create</code> können zur Vereinfachung vorkonfigurierte Konfigurationen zu RESIDENTS, <a href="#ROOMMATE">ROOMMATE</a>, <a href="#GUEST">GUEST</a> oder <a href="#PET">PET</a> Geräten hinzugefügt werden.<br>
|
|
Die folgenden Kommandos sind momentan verfügbar:<br>
|
|
<br>
|
|
<li>
|
|
<b>wakeuptimer</b> - fügt ein Dummy Gerät mit erweiterten Funktionen als Wecker hinzu, um darauf Weck-Automationen aufzubauen.
|
|
<ul>
|
|
Ein notify Gerät wird als Makro erstellt, um die eigentliche Automation auszuführen. Das Makro wird durch ein normales at-Gerät ausgelöst und kann ebenfalls angepasst werden. Die Hauptfunktion wird dabei trotzdem von einer speziellen RESIDENTS Toolkit funktion gehandhabt.<br>
|
|
Die Zeit aktiver Wecker kann mittels +<MINUTEN> oder -<MINUTEN> relativ erhöht bzw. verringert werden. Die Angabe als +HH:MM ist auch möglich.<br>
|
|
<br>
|
|
Die Weckfunktion kann wie folgt über Attribute beinflusst werden:<br>
|
|
<li>
|
|
<i>wakeupAtdevice</i> - Backlink zum at Gerät (notwendig)
|
|
</li>
|
|
<li>
|
|
<i>wakeupDays</i> - Makro nur an bestimmten Tagen auslösen. Mon=1,Di=2,Mi=3,Do=4,Fr=5,Sa=6,So=0 (optional)
|
|
</li>
|
|
<li>
|
|
<i>wakeupDefaultTime</i> - Stellt die Weckzeit nach dem auslösen zurück auf diesen Standardwert (optional)
|
|
</li>
|
|
<li>
|
|
<i>wakeupEnforced</i> - Forciertes wecken (optional; 0=nein, 1=ja, 2=wenn Weckzeit ungleich wakeupDefaultTime, 3=wenn Weckzeit früher ist als wakeupDefaultTime)
|
|
</li>
|
|
<li>
|
|
<i>wakeupHolidays</i> - Makro u.U. an Feiertagen oder Nicht-Feiertagen ausführen (optional; andHoliday=an Feiertagen ggf. zusammen mit wakeupDays, orHoliday=an Feiertagen unabhängig von wakeupDays, andNoHoliday=an Nicht-Feiertagen ggf. zusammen mit wakeupDays, orNoHoliday=an Nicht-Feiertagen unabhängig von wakeupDays)
|
|
</li>
|
|
<li>
|
|
<i>wakeupMacro</i> - Name des notify Makro Gerätes (notwendig)
|
|
</li>
|
|
<li>
|
|
<i>wakeupOffset</i> - Wert in Minuten, die das Makro früher ausgelöst werden soll, z.B. bei komplexen Weckprogrammen über einen Zeitraum von 30 Minuten (Standard ist 0)
|
|
</li>
|
|
<li>
|
|
<i>wakeupResetSwitcher</i> - das DUMMY Device, welches zum schnellen ein/aus schalten der Resetfunktion verwendet wird (optional, Device wird automatisch angelegt)
|
|
</li>
|
|
<li>
|
|
<i>wakeupResetdays</i> - sofern wakeupDefaultTime gesetzt ist, kann der Reset hier auf betimmte Tage begrenzt werden. Mon=1,Di=2,Mi=3,Do=4,Fr=5,Sa=6,So=0 (optional)
|
|
</li>
|
|
<li>
|
|
<i>wakeupUserdevice</i> - Backlink zum RESIDENTS, ROOMMATE, GUEST oder PET Gerät, um dessen Status zu prüfen (notwendig)
|
|
</li>
|
|
<li>
|
|
<i>wakeupWaitPeriod</i> - Schwelle der Wartezeit in Minuten bis das Weckprogramm erneut ausgeführt werden kann, z.B. wenn manuell eine frühere Weckzeit gesetzt wurde als normal während wakeupDefaultTime verwendet wird. Greift nicht, wenn die Weckzeit während dieser Zeit geändert wurde; Standard ist 360 Minuten / 6h (optional)
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
</ul>
|
|
|
|
=end html_DE
|
|
|
|
=for :application/json;q=META.json 10_RESIDENTS.pm
|
|
{
|
|
"author": [
|
|
"Julian Pawlowski <julian.pawlowski@gmail.com>"
|
|
],
|
|
"x_fhem_maintainer": [
|
|
"loredo"
|
|
],
|
|
"x_fhem_maintainer_github": [
|
|
"jpawlowski"
|
|
],
|
|
"keywords": [
|
|
"Attendence",
|
|
"Family",
|
|
"People",
|
|
"Presence",
|
|
"RESIDENTS"
|
|
]
|
|
}
|
|
=end :application/json;q=META.json
|
|
|
|
=cut
|