FHEM/fhem-mirror
2
0
Fork 0
mirror of https://github.com/fhem/fhem-mirror.git synced 2025-04-06 18:28:44 +00:00
Code Issues Releases Wiki Activity
fhem-mirror/fhem/FHEM/10_EnOcean.pm
klaus-schauer b84ad9f3eb 10_EnOcean: Profil gateway/switching: Eltako FSA12 supported 
git-svn-id: https://svn.fhem.de/fhem/trunk@5218 2b470e98-0d58-463d-a4d8-8e2adae1ed80
2014-03-13 18:57:27 +00:00

5784 lines
232 KiB
Perl
Executable File
Raw Blame History

##############################################
# $Id$
package main;
use strict;
use warnings;
use SetExtensions;
sub EnOcean_Define($$);
sub EnOcean_Initialize($);
sub EnOcean_Parse($$);
sub EnOcean_Get($@);
sub EnOcean_Set($@);
sub EnOcean_hvac_01Cmd($$$);
sub EnOcean_CheckSenderID($$$);
sub EnOcean_SndRadio($$$$$$$);
sub EnOcean_ReadingScaled($$$$);
sub EnOcean_TimerSet($);
sub EnOcean_Undef($$);
my %EnO_rorgname = ("F6" => "switch", # RPS, org 05
"D5" => "contact", # 1BS, org 06
"A5" => "sensor", # 4BS, org 07
"D1" => "MSC", # MSC
"D2" => "VLD", # VLD
"D4" => "UTE", # UTE
);
my @EnO_ptm200btn = ("AI", "A0", "BI", "B0", "CI", "C0", "DI", "D0");
my %EnO_ptm200btn;
# Gateway commands
my @EnO_gwCmd = ("switching", "dimming", "setpointShift", "setpointBasic", "controlVar", "fanStage", "blindCmd");
my %EnO_gwCmd = (
"switching" => 1,
"dimming" => 2,
"setpointShift" => 3,
"setpointBasic" => 4,
"controlVar" => 5,
"fanStage" => 6,
"blindCmd" => 7,
);
# Some Manufacturers (e.g. Jaeger Direkt) also sell EnOcean products without an entry in the table below.
my %EnO_manuf = (
"000" => "Reserved",
"001" => "Peha",
"002" => "Thermokon",
"003" => "Servodan",
"004" => "EchoFlex Solutions",
"005" => "Omnio AG",
"006" => "Hardmeier electronics",
"007" => "Regulvar Inc",
"008" => "Ad Hoc Electronics",
"009" => "Distech Controls",
"00A" => "Kieback + Peter",
"00B" => "EnOcean GmbH",
"00C" => "Probare",
"00D" => "Eltako",
"00E" => "Leviton",
"00F" => "Honeywell",
"010" => "Spartan Peripheral Devices",
"011" => "Siemens",
"012" => "T-Mac",
"013" => "Reliable Controls Corporation",
"014" => "Elsner Elektronik GmbH",
"015" => "Diehl Controls",
"016" => "BSC Computer",
"017" => "S+S Regeltechnik GmbH",
"018" => "Masco Corporation",
"019" => "Intesis Software SL",
"01A" => "Viessmann",
"01B" => "Lutuo Technology",
"01C" => "Schneider Electric",
"01D" => "Sauter",
"01E" => "Boot-Up",
"01F" => "Osram Sylvania",
"020" => "Unotech",
"021" => "Delta Controls Inc",
"022" => "Unitronic AG",
"023" => "NanoSense",
"024" => "The S4 Group",
"025" => "MSR Solutions",
"026" => "GE",
"027" => "Maico",
"028" => "Ruskin Company",
"029" => "Magnum Engery Solutions",
"02A" => "KM Controls",
"02B" => "Ecologix Controls",
"02C" => "Trio 2 Sys",
"02D" => "Afriso-Euro-Index",
"030" => "NEC AccessTechnica Ltd",
"031" => "ITEC Corporation",
"032" => "Simix Co Ltd",
"034" => "Eurotronic Technology GmbH",
"035" => "Art Japan Co Ltd",
"036" => "Tiansu Automation Control System Co Ltd",
"038" => "Gruppo Giordano Idea Spa",
"039" => "alphaEOS AG",
"03A" => "Tag Technologies",
"03C" => "Cloud Buildings Ltd",
"03E" => "GIGA Concept",
"03F" => "Sensortec",
"040" => "Jaeger Direkt",
"041" => "Air System Components Inc",
"7FF" => "Multi user Manufacturer ID",
);
my %EnO_subType = (
"A5.02.01" => "tempSensor.01",
"A5.02.02" => "tempSensor.02",
"A5.02.03" => "tempSensor.03",
"A5.02.04" => "tempSensor.04",
"A5.02.05" => "tempSensor.05",
"A5.02.06" => "tempSensor.06",
"A5.02.07" => "tempSensor.07",
"A5.02.08" => "tempSensor.08",
"A5.02.09" => "tempSensor.09",
"A5.02.0A" => "tempSensor.0A",
"A5.02.0B" => "tempSensor.0B",
"A5.02.10" => "tempSensor.10",
"A5.02.11" => "tempSensor.11",
"A5.02.12" => "tempSensor.12",
"A5.02.13" => "tempSensor.13",
"A5.02.14" => "tempSensor.14",
"A5.02.15" => "tempSensor.15",
"A5.02.16" => "tempSensor.16",
"A5.02.17" => "tempSensor.17",
"A5.02.18" => "tempSensor.18",
"A5.02.19" => "tempSensor.19",
"A5.02.1A" => "tempSensor.1A",
"A5.02.1B" => "tempSensor.1B",
"A5.02.20" => "tempSensor.20",
"A5.02.30" => "tempSensor.30",
"A5.04.01" => "roomSensorControl.01",
"A5.04.02" => "tempHumiSensor.02",
"A5.06.01" => "lightSensor.01",
"A5.06.02" => "lightSensor.02",
"A5.06.03" => "lightSensor.03",
"A5.07.01" => "occupSensor.01",
"A5.07.02" => "occupSensor.02",
"A5.07.03" => "occupSensor.03",
"A5.08.01" => "lightTempOccupSensor.01",
"A5.08.02" => "lightTempOccupSensor.02",
"A5.08.03" => "lightTempOccupSensor.03",
"A5.09.01" => "COSensor.01",
"A5.09.02" => "COSensor.02",
"A5.09.04" => "tempHumiCO2Sensor.01",
"A5.09.05" => "vocSensor.01",
"A5.09.06" => "radonSensor.01",
"A5.09.07" => "particlesSensor.01",
"A5.10.01" => "roomSensorControl.05",
"A5.10.02" => "roomSensorControl.05",
"A5.10.03" => "roomSensorControl.05",
"A5.10.04" => "roomSensorControl.05",
"A5.10.05" => "roomSensorControl.05",
"A5.10.06" => "roomSensorControl.05",
"A5.10.07" => "roomSensorControl.05",
"A5.10.08" => "roomSensorControl.05",
"A5.10.09" => "roomSensorControl.05",
"A5.10.0A" => "roomSensorControl.05",
"A5.10.0B" => "roomSensorControl.05",
"A5.10.0C" => "roomSensorControl.05",
"A5.10.0D" => "roomSensorControl.05",
"A5.10.10" => "roomSensorControl.01",
"A5.10.11" => "roomSensorControl.01",
"A5.10.12" => "roomSensorControl.01",
"A5.10.13" => "roomSensorControl.01",
"A5.10.14" => "roomSensorControl.01",
"A5.10.15" => "roomSensorControl.02",
"A5.10.16" => "roomSensorControl.02",
"A5.10.17" => "roomSensorControl.02",
"A5.10.18" => "roomSensorControl.18",
"A5.10.19" => "roomSensorControl.19",
"A5.10.1A" => "roomSensorControl.1A",
"A5.10.1B" => "roomSensorControl.1B",
"A5.10.1C" => "roomSensorControl.1C",
"A5.10.1D" => "roomSensorControl.1D",
"A5.10.1E" => "roomSensorControl.1B",
"A5.10.1F" => "roomSensorControl.1F",
"A5.11.01" => "lightCtrlState.01",
"A5.11.02" => "tempCtrlState.01",
"A5.11.03" => "shutterCtrlState.01",
"A5.11.04" => "lightCtrlState.02",
"A5.12.00" => "autoMeterReading.00",
"A5.12.01" => "autoMeterReading.01",
"A5.12.02" => "autoMeterReading.02",
"A5.12.03" => "autoMeterReading.03",
"A5.13.01" => "environmentApp",
"A5.13.02" => "environmentApp",
"A5.13.03" => "environmentApp",
"A5.13.04" => "environmentApp",
"A5.13.05" => "environmentApp",
"A5.13.06" => "environmentApp",
"A5.13.10" => "environmentApp",
"A5.14.01" => "multiFuncSensor",
"A5.14.02" => "multiFuncSensor",
"A5.14.03" => "multiFuncSensor",
"A5.14.04" => "multiFuncSensor",
"A5.14.05" => "multiFuncSensor",
"A5.14.06" => "multiFuncSensor",
"A5.20.01" => "hvac.01",
#"A5.20.02" => "hvac.02",
#"A5.20.03" => "hvac.03",
#"A5.20.10" => "hvac.04",
#"A5.20.11" => "hvac.11",
#"A5.20.12" => "hvac.12",
"A5.30.01" => "digitalInput.01",
"A5.30.02" => "digitalInput.02",
"A5.38.08" => "gateway",
"A5.3F.7F" => "manufProfile",
"D2.01.00" => "actuator.01",
"D2.01.01" => "actuator.01",
"D2.01.02" => "actuator.01",
"D2.01.03" => "actuator.01",
"D2.01.04" => "actuator.01",
"D2.01.05" => "actuator.01",
"D2.01.06" => "actuator.01",
"D2.01.07" => "actuator.01",
"D2.01.08" => "actuator.01",
"D2.01.09" => "actuator.01",
"D2.01.10" => "actuator.01",
"D2.01.11" => "actuator.01",
"D5.00.01" => "contact",
"F6.02.01" => "switch",
"F6.02.02" => "switch",
"F6.02.03" => "switch",
#"F6.02.04" => "switch.04",
"F6.03.01" => "switch",
"F6.03.02" => "switch",
"F6.04.01" => "keycard",
#"F6.04.02" => "keycard.02",
"F6.10.00" => "windowHandle",
#"F6.10.01" => "windowHandle.01",
1 => "sensor",
2 => "FRW",
3 => "PM101",
4 => "raw",
);
my @EnO_models = qw (
other
FAE14 FHK14 FHK61
FSA12 FSB14 FSB61 FSB70
FSM12 FSM61
FT55
FTS12
);
# Initialize
sub
EnOcean_Initialize($)
{
my ($hash) = @_;
my %subTypeList;
my %subTypeSetList;
$hash->{Match} = "^EnOcean:";
$hash->{DefFn} = "EnOcean_Define";
$hash->{UndefFn} = "EnOcean_Undef";
$hash->{ParseFn} = "EnOcean_Parse";
$hash->{SetFn} = "EnOcean_Set";
$hash->{GetFn} = "EnOcean_Get";
#$hash->{NotifyFn} = "EnOcean_Notify";
$hash->{AttrFn} = "EnOcean_Attr";
$hash->{AttrList} = "IODev do_not_notify:1,0 ignore:0,1 dummy:0,1 " .
"showtime:1,0 " .
"actualTemp angleMax:slider,-180,20,180 angleMin:slider,-180,20,180 " .
"angleTime:0,1,2,3,4,5,6 comMode:biDir,uniDir destinationID " .
"devChannel devUpdate:off,auto,demand,polling,interrupt dimValueOn " .
"gwCmd:" . join(",", sort @EnO_gwCmd) . " humidityRefDev " .
"manufID:" . join(",", sort keys %EnO_manuf) . " " .
"model:" . join(",", @EnO_models) . " " .
"pollInterval rampTime repeatingAllowed:yes,no " .
"scaleDecimals:0,1,2,3,4,5,6,7,8,9 scaleMax scaleMin " .
"securityLevel:unencrypted sensorMode:switch,pushbutton " .
"shutTime shutTimeCloses subDef " .
"subDef0 subDefI " .
"subType:" . join(",", sort grep { !$subTypeList{$_}++ } values %EnO_subType) . " " .
"subTypeSet:" . join(",", sort grep { !$subTypeSetList{$_}++ } values %EnO_subType) . " " .
"switchMode:switch,pushbutton " .
"switchType:direction,universal,central temperatureRefDev " .
$readingFnAttributes;
for (my $i = 0; $i < @EnO_ptm200btn; $i++) {
$EnO_ptm200btn{$EnO_ptm200btn[$i]} = "$i:30";
}
$EnO_ptm200btn{released} = "0:20";
return undef;
}
# Define
sub
EnOcean_Define($$)
{
my ($hash, $def) = @_;
my @a = split("[ \t][ \t]*", $def);
my $name = $hash->{NAME};
return "wrong syntax: define <name> EnOcean 8-digit-hex-code"
if(int(@a) < 3 || int(@a) > 4 || $a[2] !~ m/^[A-Fa-f0-9]{8}$/i);
$modules{EnOcean}{defptr}{uc($a[2])} = $hash;
AssignIoPort($hash);
# Help FHEMWEB split up devices
$attr{$name}{subType} = $1 if($name =~ m/EnO_(.*)_$a[2]/);
$hash->{NOTIFYDEV} = "global";
if (int(@a) == 4) {
# parse received device data
$hash->{DEF} = uc($a[2]);
EnOcean_Parse($hash, $a[3]);
}
return undef;
}
# Get
sub
EnOcean_Get ($@)
{
my ($hash, @a) = @_;
return "no get value specified" if (@a < 2);
my $name = $hash->{NAME};
my $data;
my $destinationID = AttrVal($name, "destinationID", undef);
if (!defined $destinationID || $destinationID eq "multicast") {
$destinationID = "FFFFFFFF";
} elsif ($destinationID eq "unicast") {
$destinationID = $hash->{DEF};
} elsif ($destinationID !~ m/^[\dA-F]{8}$/) {
return "DestinationID $destinationID wrong, choose <8-digit-hex-code>.";
}
$destinationID = uc($destinationID);
my $manufID = uc(AttrVal($name, "manufID", ""));
my $model = AttrVal($name, "model", "");
my $rorg;
my $status = "00";
my $st = AttrVal($name, "subType", "");
my $stSet = AttrVal($name, "subTypeSet", undef);
if (defined $stSet) {$st = $stSet;}
my $subDef = uc(AttrVal($name, "subDef", $hash->{DEF}));
if ($subDef !~ m/^[\dA-F]{8}$/) {return "SenderID $subDef wrong, choose <8-digit-hex-code>.";}
my $tn = TimeNow();
shift @a;
for (my $i = 0; $i < @a; $i++) {
my $cmd = $a[$i];
if ($st eq "actuator.01") {
# Electronic switches and dimmers with Energy Measurement and Local Control
# (D2-01-00 - D2-01-11)
$rorg = "D2";
shift(@a);
my $cmdID;
my $channel = shift(@a);
if (!defined $channel || $channel eq "all") {
$channel = 30;
} elsif ($channel >= 0 || $channel <= 29) {
} elsif ($channel eq "input") {
$channel = 31;
} else {
return "$cmd <channel> wrong, choose 0...29|all|input.";
}
if ($cmd eq "state") {
$cmdID = 3;
$data = sprintf "%02X%02X", $cmdID, $channel;
} elsif ($cmd eq "measurement") {
$cmdID = 6;
my $query = shift(@a);
if ($query eq "energy") {
$query = 0;
} elsif ($query eq "power") {
$query = 1;
} else {
return "$cmd <query> wrong, choose energy|power.";
}
$data = sprintf "%02X%02X", $cmdID, $query << 5 | $channel;
} else {
return "Unknown argument $cmd, choose one of state measurement";
}
Log3 $name, 2, "EnOcean get $name $cmd";
} else {
# subtype does not support get commands
return;
}
EnOcean_SndRadio(undef, $hash, $rorg, $data, $subDef, $status, $destinationID);
# next commands will be sent with a delay
select(undef, undef, undef, 0.2);
}
}
# Set
sub
EnOcean_Set($@)
{
my ($hash, @a) = @_;
return "no set value specified" if (@a < 2);
my $name = $hash->{NAME};
my $data;
my $destinationID = AttrVal($name, "destinationID", undef);
if (!defined $destinationID || $destinationID eq "multicast") {
$destinationID = "FFFFFFFF";
} elsif ($destinationID eq "unicast") {
$destinationID = $hash->{DEF};
} elsif ($destinationID !~ m/^[\dA-Fa-f]{8}$/) {
return "DestinationID $destinationID wrong, choose <8-digit-hex-code>.";
}
$destinationID = uc($destinationID);
my $manufID = uc(AttrVal($name, "manufID", ""));
my $model = AttrVal($name, "model", "");
my $rorg;
my $sendCmd = "yes";
my $status = "00";
my $st = AttrVal($name, "subType", "");
my $stSet = AttrVal($name, "subTypeSet", undef);
if (defined $stSet) {$st = $stSet;}
my $subDef = uc(AttrVal($name, "subDef", $hash->{DEF}));
if ($subDef !~ m/^[\dA-F]{8}$/) {return "SenderID $subDef wrong, choose <8-digit-hex-code>.";}
my $switchMode = AttrVal($name, "switchMode", "switch");
my $tn = TimeNow();
# control set actions
# $updateState = -1: no set commands available e. g. sensors
# 0: execute set commands
# 1: execute set commands and and update reading state
# 2: execute set commands delayed
my $updateState = 1;
shift @a;
for (my $i = 0; $i < @a; $i++) {
my $cmd = $a[$i];
if ($st eq "roomSensorControl.05") {
# Room Sensor and Control Unit (EEP A5-10-01 ... A5-10-0D)
# [Eltako FTR55D, FTR55H, Thermokon SR04 *, Thanos SR *, untested]
# $db[3] is the fan speed or night reduction for Eltako
# $db[2] is the setpoint where 0x00 = min ... 0xFF = max or
# reference temperature for Eltako where 0x00 = 0<>C ... 0xFF = 40<34>C
# $db[1] is the temperature where 0x00 = +40<34>C ... 0xFF = 0<>C
# $db[1]_bit_1 is blocking the aditional Room Sensor and Control Unit for Eltako FVS
# $db[0]_bit_0 is the slide switch
$rorg = "A5";
# primarily temperature from the reference device then the attribute actualTemp is read
my $temperatureRefDev = AttrVal($name, "temperatureRefDev", undef);
my $actualTemp = AttrVal($name, "actualTemp", 20);
$actualTemp = ReadingsVal($temperatureRefDev, "temperature", 20) if (defined $temperatureRefDev);
$actualTemp = 20 if ($actualTemp !~ m/^[+-]?\d+(\.\d+)?$/);
$actualTemp = 0 if ($actualTemp < 0);
$actualTemp = 40 if ($actualTemp > 40);
my $setCmd = 8;
if ($manufID eq "00D") {
# EEP A5-10-06 plus DB3 [Eltako FVS]
my $setpointTemp = ReadingsVal($name, "setpointTemp", 20);
my $nightReduction = ReadingsVal($name, "nightReduction", 0);
my $block = ReadingsVal($name, "block", "unlock");
if ($cmd eq "teach") {
# teach-in EEP A5-10-06 plus "FVS", Manufacturer "Eltako"
$data = "40300D85";
CommandDeleteReading(undef, "$name .*");
} elsif ($cmd eq "desired-temp" || $cmd eq "setpointTemp") {
#
if (defined $a[1]) {
if (($a[1] =~ m/^[+-]?\d+(\.\d+)?$/) && ($a[1] >= 0) && ($a[1] <= 40)) {
$setpointTemp = $a[1];
shift(@a);
} else {
return "Usage: $a[1] is not numeric or out of range";
}
}
if (defined $a[1]) {
if (($a[1] =~ m/^(lock|unlock)$/) ) {
$block = $a[1];
shift(@a);
} else {
return "Usage: $a[1] is unknown";
}
}
readingsSingleUpdate($hash, "temperature", $actualTemp, 1);
readingsSingleUpdate($hash, "setpointTemp", $setpointTemp, 1);
readingsSingleUpdate($hash, "nightReduction", $nightReduction, 1);
readingsSingleUpdate($hash, "block", $block, 1);
readingsSingleUpdate($hash, "state", "T: $actualTemp SPT: $setpointTemp NR: $nightReduction", 1);
if ($nightReduction == 5) {
$nightReduction = 31;
} elsif ($nightReduction == 4) {
$nightReduction = 25;
} elsif ($nightReduction == 3) {
$nightReduction = 19;
} elsif ($nightReduction == 2) {
$nightReduction = 12;
} elsif ($nightReduction == 1) {
$nightReduction = 6;
} else {
$nightReduction = 0;
}
$actualTemp = (40 - $actualTemp) / 40 * 255;
$setpointTemp = $setpointTemp * 255 / 40;
# control of the aditional Room Sensor and Control Unit
if ($block eq "lock") {
# temperature setting is locked
$setCmd = 0x0D;
} else {
# setpointTemp may be subject to change at +/-3 K
$setCmd = 0x0F;
}
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", $nightReduction, $setpointTemp, $actualTemp, $setCmd;
} elsif ($cmd eq "nightReduction") {
#
if (defined $a[1]) {
if ($a[1] =~ m/^[0-5]$/) {
$nightReduction = $a[1];
shift(@a);
} else {
return "Usage: $a[1] is not numeric or out of range";
}
}
if (defined $a[1]) {
if (($a[1] =~ m/^(lock|unlock)$/) ) {
$block = $a[1];
shift(@a);
} else {
return "Usage: $a[1] is unknown";
}
}
readingsSingleUpdate($hash, "temperature", $actualTemp, 1);
readingsSingleUpdate($hash, "setpointTemp", $setpointTemp, 1);
readingsSingleUpdate($hash, "nightReduction", $nightReduction, 1);
readingsSingleUpdate($hash, "block", $block, 1);
readingsSingleUpdate($hash, "state", "T: $actualTemp SPT: $setpointTemp NR: $nightReduction", 1);
if ($nightReduction == 5) {
$nightReduction = 31;
} elsif ($nightReduction == 4) {
$nightReduction = 25;
} elsif ($nightReduction == 3) {
$nightReduction = 19;
} elsif ($nightReduction == 2) {
$nightReduction = 12;
} elsif ($nightReduction == 1) {
$nightReduction = 6;
} else {
$nightReduction = 0;
}
$actualTemp = (40 - $actualTemp) / 40 * 255;
$setpointTemp = $setpointTemp * 255 / 40;
# control of the aditional Room Sensor and Control Unit
if ($block eq "lock") {
# temperature setting is locked
$setCmd = 0x0D;
} else {
# setpointTemp may be subject to change at +/-3 K
$setCmd = 0x0F;
}
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", $nightReduction, $setpointTemp, $actualTemp, $setCmd;
} else {
return "Unknown argument " . $cmd . ", choose one of desired-temp nightReduction:0,1,2,3,4,5 setpointTemp teach"
}
} else {
# EEP A5-10-02
my $setpoint = ReadingsVal($name, "setpoint", 128);
my $setpointScaled = ReadingsVal($name, "setpointScaled", undef);
my $fanStage = ReadingsVal($name, "fanStage", "auto");
my $switch = ReadingsVal($name, "switch", "off");
$setCmd |= 1 if ($switch eq "on");
if ($cmd eq "teach") {
# teach-in EEP A5-10-02, Manufacturer "Multi user Manufacturer ID"
$data = "4017FF80";
CommandDeleteReading(undef, "$name .*");
} elsif ($cmd eq "fanStage") {
#
if (defined $a[1] && ($a[1] =~ m/^[0-3]$/ || $a[1] eq "auto")) {
$fanStage = $a[1];
shift(@a);
readingsSingleUpdate($hash, "temperature", $actualTemp, 1);
readingsSingleUpdate($hash, "setpointScaled", $setpointScaled, 1) if (defined $setpointScaled);
readingsSingleUpdate($hash, "setpoint", $setpoint, 1);
readingsSingleUpdate($hash, "fanStage", $fanStage, 1);
readingsSingleUpdate($hash, "switch", $switch, 1);
readingsSingleUpdate($hash, "state", "T: $actualTemp SP: $setpoint F: $fanStage SW: $switch", 1);
if ($fanStage eq "auto"){
$fanStage = 255;
} elsif ($fanStage == 0) {
$fanStage = 209;
} elsif ($fanStage == 1) {
$fanStage = 189;
} elsif ($fanStage == 2) {
$fanStage = 164;
} else {
$fanStage = 144;
}
} else {
return "Usage: $a[1] is not numeric, out of range or unknown";
}
$actualTemp = (40 - $actualTemp) / 40 * 255;
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", $fanStage, $setpoint, $actualTemp, $setCmd;
} elsif ($cmd eq "setpoint") {
#
if (defined $a[1]) {
if (($a[1] =~ m/^[+-]?\d+(\.\d+)?$/) && ($a[1] >= 0) && ($a[1] <= 255)) {
$setpoint = $a[1];
shift(@a);
if (defined $setpointScaled) {
$setpointScaled = EnOcean_ReadingScaled($hash, $setpoint, 0, 255);
}
} else {
return "Usage: $a[1] is not numeric or out of range";
}
}
readingsSingleUpdate($hash, "temperature", $actualTemp, 1);
readingsSingleUpdate($hash, "setpointScaled", $setpointScaled, 1) if (defined $setpointScaled);
readingsSingleUpdate($hash, "setpoint", $setpoint, 1);
readingsSingleUpdate($hash, "fanStage", $fanStage, 1);
readingsSingleUpdate($hash, "switch", $switch, 1);
readingsSingleUpdate($hash, "state", "T: $actualTemp SP: $setpoint F: $fanStage SW: $switch", 1);
if ($fanStage eq "auto"){
$fanStage = 255;
} elsif ($fanStage == 0) {
$fanStage = 209;
} elsif ($fanStage == 1) {
$fanStage = 189;
} elsif ($fanStage == 2) {
$fanStage = 164;
} else {
$fanStage = 144;
}
$actualTemp = (40 - $actualTemp) / 40 * 255;
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", $fanStage, $setpoint, $actualTemp, $setCmd;
} elsif ($cmd eq "setpointScaled") {
#
if (defined $a[1]) {
my $scaleMin = AttrVal($name, "scaleMin", undef);
my $scaleMax = AttrVal($name, "scaleMax", undef);
my ($rangeMin, $rangeMax);
if (defined $scaleMax && defined $scaleMin &&
$scaleMax =~ m/^[+-]?\d+(\.\d+)?$/ && $scaleMin =~ m/^[+-]?\d+(\.\d+)?$/) {
if ($scaleMin > $scaleMax) {
($rangeMin, $rangeMax)= ($scaleMax, $scaleMin);
} else {
($rangeMin, $rangeMax)= ($scaleMin, $scaleMax);
}
} else {
return "Usage: Attributes scaleMin and/or scaleMax not defined or not numeric.";
}
if ($a[1] =~ m/^[+-]?\d+(\.\d+)?$/ && $a[1] >= $rangeMin && $a[1] <= $rangeMax) {
$setpointScaled = $a[1];
shift(@a);
$setpoint = sprintf "%d", 255 * $scaleMin/($scaleMin-$scaleMax) - 255/($scaleMin-$scaleMax) * $setpointScaled;
} else {
return "Usage: $a[1] is not numeric or out of range";
}
}
readingsSingleUpdate($hash, "temperature", $actualTemp, 1);
readingsSingleUpdate($hash, "setpointScaled", $setpointScaled, 1);
readingsSingleUpdate($hash, "setpoint", $setpoint, 1);
readingsSingleUpdate($hash, "fanStage", $fanStage, 1);
readingsSingleUpdate($hash, "switch", $switch, 1);
readingsSingleUpdate($hash, "state", "T: $actualTemp SP: $setpoint F: $fanStage SW: $switch", 1);
if ($fanStage eq "auto"){
$fanStage = 255;
} elsif ($fanStage == 0) {
$fanStage = 209;
} elsif ($fanStage == 1) {
$fanStage = 189;
} elsif ($fanStage == 2) {
$fanStage = 164;
} else {
$fanStage = 144;
}
$actualTemp = (40 - $actualTemp) / 40 * 255;
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", $fanStage, $setpoint, $actualTemp, $setCmd;
} elsif ($cmd eq "switch") {
#
if (defined $a[1]) {
if ($a[1] eq "on") {
$switch = $a[1];
$setCmd |= 1;
shift(@a);
} elsif ($a[1] eq "off"){
$switch = $a[1];
shift(@a);
} else {
return "Usage: $a[1] is unknown";
}
}
readingsSingleUpdate($hash, "temperature", $actualTemp, 1);
readingsSingleUpdate($hash, "setpointScaled", $setpointScaled, 1) if (defined $setpointScaled);
readingsSingleUpdate($hash, "setpoint", $setpoint, 1);
readingsSingleUpdate($hash, "fanStage", $fanStage, 1);
readingsSingleUpdate($hash, "switch", $switch, 1);
readingsSingleUpdate($hash, "state", "T: $actualTemp SP: $setpoint F: $fanStage SW: $switch", 1);
if ($fanStage eq "auto"){
$fanStage = 255;
} elsif ($fanStage == 0) {
$fanStage = 209;
} elsif ($fanStage == 1) {
$fanStage = 189;
} elsif ($fanStage == 2) {
$fanStage = 164;
} else {
$fanStage = 144;
}
$actualTemp = (40 - $actualTemp) / 40 * 255;
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", $fanStage, $setpoint, $actualTemp, $setCmd;
} else {
return "Unknown argument " . $cmd . ", choose one of fanStage:auto,0,1,2,3 setpoint setpointScaled switch:on,off teach"
}
}
Log3 $name, 2, "EnOcean set $name $cmd";
} elsif ($st eq "hvac.01" || $st eq "MD15") {
# Battery Powered Actuator (EEP A5-20-01)
# [Kieback&Peter MD15-FTL-xx]
# See also http://www.oscat.de/community/index.php/topic,985.30.html
# Maintenance commands (runInit, liftSet, valveOpen, valveClosed)
$rorg = "A5";
my %sets = (
"desired-temp" => "\\d+(\\.\\d)?",
"actuator" => "\\d+",
"unattended" => "",
"initialize" => "",
"runInit" => "",
"liftSet" => "",
"valveOpen" => "",
"valveClosed" => "",
);
my $re = $sets{$a[0]};
return "Unknown argument $cmd, choose one of ".join(" ", sort keys %sets)
if (!defined($re));
return "Need a parameter" if ($re && @a < 2);
return "Argument $a[1] is incorrect (expect $re)" if ($re && $a[1] !~ m/^$re$/);
$updateState = 2;
$hash->{CMD} = $cmd;
$hash->{READINGS}{CMD}{TIME} = $tn;
$hash->{READINGS}{CMD}{VAL} = $cmd;
my $arg = "true";
if ($re) {
$arg = $a[1];
shift(@a);
}
$hash->{READINGS}{$cmd}{TIME} = $tn;
$hash->{READINGS}{$cmd}{VAL} = $arg;
} elsif ($st eq "gateway") {
# Gateway (EEP A5-38-08)
# select Command from attribute gwCmd or command line
my $gwCmd = AttrVal($name, "gwCmd", undef);
if ($gwCmd && $EnO_gwCmd{$gwCmd}) {
# command from attribute gwCmd
if ($EnO_gwCmd{$cmd}) {
# shift $cmd
$cmd = $a[1];
shift(@a);
}
} elsif ($EnO_gwCmd{$cmd}) {
# command from command line
$gwCmd = $cmd;
$cmd = $a[1];
shift(@a);
} else {
return "Unknown Gateway command " . $cmd . ", choose one of " . join(" ", sort keys %EnO_gwCmd);
}
my $gwCmdID;
$rorg = "A5";
my $setCmd = 0;
my $time = 0;
if ($gwCmd eq "switching") {
# Switching
$gwCmdID = 1;
if($cmd eq "teach") {
# teach-in EEP A5-38-08, Manufacturer "Multi user Manufacturer ID"
#$data = sprintf "%02X000000", $gwCmdID;
$data = "E047FF80";
} elsif ($cmd eq "on") {
$setCmd = 9;
readingsSingleUpdate($hash, "block", "unlock", 1);
if ($a[1]) {
return "Usage: $cmd [lock|unlock]" if (($a[1] ne "lock") && ($a[1] ne "unlock"));
if ($a[1] eq "lock") {
$setCmd = $setCmd | 4 ;
readingsSingleUpdate($hash, "block", "lock", 1);
}
shift(@a);
}
$updateState = 0;
$data = sprintf "%02X%04X%02X", $gwCmdID, $time, $setCmd;
} elsif ($cmd eq "off") {
if ($model eq "FSA12") {
$setCmd = 0x0E;
} else {
$setCmd = 8;
}
readingsSingleUpdate($hash, "block", "unlock", 1);
if ($a[1]) {
return "Usage: $cmd [lock|unlock]" if (($a[1] ne "lock") && ($a[1] ne "unlock"));
if ($a[1] eq "lock") {
$setCmd = $setCmd | 4 ;
readingsSingleUpdate($hash, "block", "lock", 1);
}
shift(@a);
}
$updateState = 0;
$data = sprintf "%02X%04X%02X", $gwCmdID, $time, $setCmd;
} else {
my $cmdList = "on:noArg off:noArg teach:noArg";
return SetExtensions ($hash, $cmdList, $name, @a);
$updateState = 0;
$data = sprintf "%02X%04X%02X", $gwCmdID, $time, $setCmd;
}
} elsif ($gwCmd eq "dimming") {
# Dimming
$gwCmdID = 2;
my $dimVal = ReadingsVal($name, "dim", undef);
my $rampTime = AttrVal($name, "rampTime", 1);
my $sendDimCmd = 0;
$setCmd = 9;
if ($cmd eq "teach") {
# teach-in EEP A5-38-08, Manufacturer "Multi user Manufacturer ID"
#$data = "E047FF80";
# teach-in Eltako
$data = "02000000";
} elsif ($cmd eq "dim") {
return "Usage: $cmd dim/% [rampTime/s lock|unlock]"
if(@a < 2 || $a[1] < 0 || $a[1] > 100 || $a[1] !~ m/^[+-]?\d+$/);
# for eltako relative (0-100) (but not compliant to EEP because DB0.2 is 0)
# >> if manufID needed: set DB2.0
$dimVal = $a[1];
if ($dimVal > 0) {
readingsSingleUpdate ($hash, "dimValueStored", $dimVal, 1);
}
shift(@a);
if (defined($a[1])) {
return "Usage: $cmd dim/% [rampTime/s lock|unlock]" if ($a[1] !~ m/^[+-]?\d+$/);
$rampTime = $a[1];
shift(@a);
}
$sendDimCmd = 1;
} elsif ($cmd eq "dimup") {
return "Usage: $cmd dim/% [rampTime/s lock|unlock]"
if(@a < 2 || $a[1] < 0 || $a[1] > 100 || $a[1] !~ m/^[+-]?\d+$/);
$dimVal += $a[1];
if ($dimVal > 0) {
readingsSingleUpdate ($hash, "dimValueStored", $dimVal, 1);
}
shift(@a);
if (defined($a[1])) {
return "Usage: $cmd dim/% [rampTime/s lock|unlock]" if ($a[1] !~ m/^[+-]?\d+$/);
$rampTime = $a[1];
shift(@a);
}
$sendDimCmd = 1;
} elsif ($cmd eq "dimdown") {
return "Usage: $cmd dim/% [rampTime/s lock|unlock]"
if(@a < 2 || $a[1] < 0 || $a[1] > 100 || $a[1] !~ m/^[+-]?\d+$/);
$dimVal -= $a[1];
if ($dimVal > 0) {
readingsSingleUpdate ($hash, "dimValueStored", $dimVal, 1);
}
shift(@a);
if (defined($a[1])) {
return "Usage: $cmd dim/% [rampTime/s lock|unlock]" if ($a[1] !~ m/^[+-]?\d+$/);
$rampTime = $a[1];
shift(@a);
}
$sendDimCmd = 1;
} elsif ($cmd eq "on") {
$rampTime = 1;
my $dimValueOn = AttrVal($name, "dimValueOn", 100);
if ($dimValueOn eq "stored") {
$dimVal = ReadingsVal($name, "dimValueStored", 100);
if ($dimVal < 1) {
$dimVal = 100;
readingsSingleUpdate ($hash, "dimValueStored", $dimVal, 1);
}
} elsif ($dimValueOn eq "last") {
$dimVal = ReadingsVal ($name, "dimValueLast", 100);
if ($dimVal < 1) { $dimVal = 100; }
} else {
if ($dimValueOn !~ m/^[+-]?\d+$/) {
$dimVal = 100;
} elsif ($dimValueOn > 100) {
$dimVal = 100;
} elsif ($dimValueOn < 1) {
$dimVal = 1;
} else {
$dimVal = $dimValueOn;
}
}
$sendDimCmd = 1;
} elsif ($cmd eq "off") {
$dimVal = 0;
$rampTime = 1;
$setCmd = 8;
$sendDimCmd = 1;
} else {
my $cmdList = "dim:slider,0,1,100 on:noArg off:noArg teach:noArg";
return SetExtensions ($hash, $cmdList, $name, @a);
}
if ($sendDimCmd) {
readingsSingleUpdate($hash, "block", "unlock", 1);
if (defined $a[1]) {
return "Usage: $cmd dim/% [rampTime/s lock|unlock]" if ($a[1] ne "lock" && $a[1] ne "unlock");
# Eltako devices: lock dimming value
if ($manufID eq "00D" && $a[1] eq "lock" ) {
$setCmd = $setCmd | 4;
readingsSingleUpdate($hash, "block", "lock", 1);
}
shift(@a);
} else {
# Dimming value relative
if ($manufID ne "00D") {$setCmd = $setCmd | 4;}
}
if ($dimVal > 100) { $dimVal = 100; }
if ($dimVal <= 0) { $dimVal = 0; $setCmd = 8; }
if ($rampTime > 255) { $rampTime = 255; }
if ($rampTime < 0) { $rampTime = 0; }
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", $gwCmdID, $dimVal, $rampTime, $setCmd;
}
} elsif ($gwCmd eq "setpointShift") {
$gwCmdID = 3;
if ($cmd eq "teach") {
# teach-in EEP A5-38-08, Manufacturer "Multi user Manufacturer ID"
$data = "E047FF80";
} elsif ($cmd eq "shift") {
if (($a[1] =~ m/^[+-]?\d+(\.\d+)?$/) && ($a[1] >= -12.7) && ($a[1] <= 12.8)) {
$updateState = 0;
$data = sprintf "%02X00%02X08", $gwCmdID, ($a[1] + 12.7) * 10;
shift(@a);
} else {
return "Usage: $a[1] is not numeric or out of range";
}
} else {
return "Unknown argument $cmd, choose one of teach:noArg shift";
}
} elsif ($gwCmd eq "setpointBasic") {
$gwCmdID = 4;
if($cmd eq "teach") {
# teach-in EEP A5-38-08, Manufacturer "Multi user Manufacturer ID"
$data = "E047FF80";
} elsif ($cmd eq "basic") {
if (($a[1] =~ m/^[+-]?\d+(\.\d+)?$/) && ($a[1] >= 0) && ($a[1] <= 51.2)) {
$updateState = 0;
$data = sprintf "%02X00%02X08", $gwCmdID, $a[1] * 5;
shift(@a);
} else {
return "Usage: $cmd parameter is not numeric or out of range.";
}
} else {
return "Unknown argument $cmd, choose one of teach:noArg basic";
}
} elsif ($gwCmd eq "controlVar") {
$gwCmdID = 5;
my $controlVar = ReadingsVal($name, "controlVar", 0);
if($cmd eq "teach") {
# teach-in EEP A5-38-08, Manufacturer "Multi user Manufacturer ID"
$data = "E047FF80";
} elsif ($cmd eq "presence") {
if ($a[1] eq "standby") {
$setCmd = 0x0A;
} elsif ($a[1] eq "absent") {
$setCmd = 9;
} elsif ($a[1] eq "present") {
$setCmd = 8;
} else {
return "Usage: $cmd parameter unknown.";
}
shift(@a);
$data = sprintf "%02X00%02X%02X", $gwCmdID, $controlVar, $setCmd;
} elsif ($cmd eq "energyHoldOff") {
if ($a[1] eq "normal") {
$setCmd = 8;
} elsif ($a[1] eq "holdoff") {
$setCmd = 0x0C;
} else {
return "Usage: $cmd parameter unknown.";
}
shift(@a);
$data = sprintf "%02X00%02X%02X", $gwCmdID, $controlVar, $setCmd;
} elsif ($cmd eq "controllerMode") {
if ($a[1] eq "auto") {
$setCmd = 8;
} elsif ($a[1] eq "heating") {
$setCmd = 0x28;
} elsif ($a[1] eq "cooling") {
$setCmd = 0x48;
} elsif ($a[1] eq "off" || $a[1] eq "BI") {
$setCmd = 0x68;
} else {
return "Usage: $cmd parameter unknown.";
}
shift(@a);
$data = sprintf "%02X00%02X%02X", $gwCmdID, $controlVar, $setCmd;
} elsif ($cmd eq "controllerState") {
if ($a[1] eq "auto") {
$setCmd = 8;
} elsif ($a[1] eq "override") {
$setCmd = 0x18;
if (defined $a[2] && ($a[2] =~ m/^[+-]?\d+$/) && ($a[2] >= 0) && ($a[2] <= 100) ) {
$controlVar = $a[2] * 255;
shift(@a);
} else {
return "Usage: Control Variable Override is not numeric or out of range.";
}
} else {
return "Usage: $cmd parameter unknown.";
}
shift(@a);
$updateState = 0;
$data = sprintf "%02X00%02X%02X", $gwCmdID, $controlVar, $setCmd;
} else {
return "Unknown argument, choose one of teach:noArg presence:absent,present,standby energyHoldOff:holdoff,normal controllerMode:cooling,heating,off controllerState:auto,override";
}
} elsif ($gwCmd eq "fanStage") {
$gwCmdID = 6;
if($cmd eq "teach") {
# teach-in EEP A5-38-08, Manufacturer "Multi user Manufacturer ID"
$data = "E047FF80";
} elsif ($cmd eq "stage") {
if ($a[1] eq "auto") {
$updateState = 0;
$data = sprintf "%02X00%02X08", $gwCmdID, 255;
} elsif ($a[1] && $a[1] =~ m/^[0-3]$/) {
$updateState = 0;
$data = sprintf "%02X00%02X08", $gwCmdID, $a[1];
} else {
return "Usage: $cmd parameter is not numeric or out of range"
}
shift(@a);
} else {
return "Unknown argument, choose one of teach:noArg stage:auto,0,1,2,3";
}
} elsif ($gwCmd eq "blindCmd") {
$gwCmdID = 7;
my %blindFunc = (
"status" => 0,
"stop" => 1,
"opens" => 2,
"closes" => 3,
"position" => 4,
"up" => 5,
"down" => 6,
"runtimeSet" => 7,
"angleSet" => 8,
"positionMinMax" => 9,
"angleMinMax" => 10,
"positionLogic" => 11,
"teach" => 255,
);
my $blindFuncID;
if (defined $blindFunc {$cmd}) {
$blindFuncID = $blindFunc {$cmd};
} else {
return "Unknown Gateway Blind Central Function " . $cmd . ", choose one of ". join(" ", sort keys %blindFunc);
}
my $blindParam1 = 0;
my $blindParam2 = 0;
$setCmd = $blindFuncID << 4 | 8;
if($blindFuncID == 255) {
# teach-in EEP A5-38-08, Manufacturer "Multi user Manufacturer ID"
$gwCmdID = 0xE0;
$blindParam1 = 0x47;
$blindParam2 = 0xFF;
$setCmd = 0x80;
#$setCmd = 0;
} elsif ($blindFuncID == 0) {
# status
$updateState = 0;
} elsif ($blindFuncID == 1) {
# stop
$updateState = 0;
} elsif ($blindFuncID == 2) {
# opens
$updateState = 0;
} elsif ($blindFuncID == 3) {
# closes
$updateState = 0;
} elsif ($blindFuncID == 4) {
# position
if (defined $a[1] && $a[1] =~ m/^[+-]?\d+$/ && $a[1] >= 0 && $a[1] <= 100) {
$blindParam1 = $a[1];
if (defined $a[2] && $a[2] =~ m/^[+-]?\d+$/ && $a[2] >= -180 && $a[2] <= 180) {
$blindParam2 = abs($a[2]) / 2;
if ($a[2] < 0) {$blindParam2 |= 0x80;}
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
$updateState = 0;
} elsif ($blindFuncID == 5 || $blindFuncID == 6) {
# up / down
if (defined $a[1] && $a[1] =~ m/^[+-]?\d+$/ && $a[1] >= 0 && $a[1] <= 255) {
$blindParam1 = $a[1];
if (defined $a[2] && $a[2] =~ m/^[+-]?\d+(\.\d+)?$/ && $a[2] >= 0 && $a[2] <= 25.5) {
$blindParam2 = $a[2] * 10;
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
$updateState = 0;
} elsif ($blindFuncID == 7) {
# runtimeSet
if (defined $a[1] && $a[1] =~ m/^[+-]?\d+$/ && $a[1] >= 0 && $a[1] <= 255) {
$blindParam1 = $a[1];
if (defined $a[2] && $a[2] =~ m/^[+-]?\d+$/ && $a[2] >= 0 && $a[2] <= 255) {
$blindParam2 = $a[2];
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
readingsSingleUpdate($hash, "runTimeUp", $blindParam1, 1);
readingsSingleUpdate($hash, "runTimeDown", $blindParam2, 1);
$updateState = 0;
} elsif ($blindFuncID == 8) {
# angleSet
if (defined $a[1] && $a[1] =~ m/^[+-]?\d+(\.\d+)?$/ && $a[1] >= 0 && $a[1] <= 25.5) {
$blindParam1 = $a[1] * 10;
##
readingsSingleUpdate($hash, "angleTime", (sprintf "%0.1f", $a[1]), 1);
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
$updateState = 0;
} elsif ($blindFuncID == 9) {
# positionMinMax
if (defined $a[1] && $a[1] =~ m/^[+-]?\d+$/ && $a[1] >= 0 && $a[1] <= 100) {
$blindParam1 = $a[1];
if (defined $a[2] && $a[2] =~ m/^[+-]?\d+$/ && $a[2] >= 0 && $a[2] <= 100) {
$blindParam2 = $a[2];
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
shift(@a);
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
if ($blindParam1 > $blindParam2) {($blindParam1, $blindParam2) = ($blindParam2, $blindParam1);}
readingsSingleUpdate($hash, "positionMin", $blindParam1, 1);
readingsSingleUpdate($hash, "positionMax", $blindParam2, 1);
$updateState = 0;
} elsif ($blindFuncID == 10) {
# angleMinMax
if (defined $a[1] && $a[1] =~ m/^[+-]?\d+$/ && $a[1] >= -180 && $a[1] <= 180) {
if (!defined $a[2] || $a[2] !~ m/^[+-]?\d+$/ || $a[2] < -180 || $a[2] > 180) {
return "Usage: $cmd variable is not numeric or out of range.";
}
if ($a[1] > $a[2]) {($a[1], $a[2]) = ($a[2], $a[1]);}
$blindParam1 = abs($a[1]) / 2;
if ($a[1] < 0) {$blindParam1 |= 0x80;}
$blindParam2 = abs($a[2]) / 2;
if ($a[2] < 0) {$blindParam2 |= 0x80;}
} else {
return "Usage: $cmd variable is not numeric or out of range.";
}
readingsSingleUpdate($hash, "angleMin", $a[1], 1);
readingsSingleUpdate($hash, "angleMax", $a[2], 1);
splice (@a, 0, 2);
$updateState = 0;
} elsif ($blindFuncID == 11) {
# positionLogic
if ($a[1] eq "normal") {
$blindParam1 = 0;
} elsif ($a[1] eq "inverse") {
$blindParam1 = 1;
} else {
return "Usage: $cmd variable is unknown.";
}
shift(@a);
$updateState = 0;
} else {
}
$data = sprintf "%02X%02X%02X%02X", $gwCmdID, $blindParam1, $blindParam2, $setCmd;
} else {
return "Unknown Gateway command " . $cmd . ", choose one of ". join(" ", sort keys %EnO_gwCmd);
}
Log3 $name, 2, "EnOcean set $name $cmd";
} elsif ($st eq "manufProfile") {
if ($manufID eq "00D") {
# Eltako Shutter
my $angleMax = AttrVal($name, "angleMax", 90);
my $angleMin = AttrVal($name, "angleMin", -90);
my $anglePos = ReadingsVal($name, "anglePos", undef);
my $anglePosStart;
my $angleTime = AttrVal($name, "angleTime", 0);
my $position = ReadingsVal($name, "position", undef);
my $positionStart;
if ($cmd ne "?") {
# check actual shutter position
my $actualState = ReadingsVal($name, "state", undef);
if (defined $actualState) {
if ($actualState eq "open") {
$position = 0;
$anglePos = 0;
} elsif ($actualState eq "closed") {
$position = 100;
$anglePos = $angleMax;
}
}
$anglePosStart = $anglePos;
$positionStart = $position;
readingsSingleUpdate($hash, ".anglePosStart", $anglePosStart, 0);
readingsSingleUpdate($hash, ".positionStart", $positionStart, 0);
}
$rorg = "A5";
my $shutTime = AttrVal($name, "shutTime", 255);
my $shutTimeCloses = AttrVal($name, "shutTimeCloses", $shutTime);
$shutTimeCloses = $shutTime if ($shutTimeCloses < $shutTimeCloses);
my $shutCmd = 0;
$angleMax = 90 if ($angleMax !~ m/^[+-]?\d+$/);
$angleMax = 180 if ($angleMax > 180);
$angleMax = -180 if ($angleMax < -180);
$angleMin = -90 if ($angleMin !~ m/^[+-]?\d+$/);
$angleMin = 180 if ($angleMin > 180);
$angleMin = -180 if ($angleMin < -180);
($angleMax, $angleMin) = ($angleMin, $angleMax) if ($angleMin > $angleMax);
$angleMax ++ if ($angleMin == $angleMax);
$angleTime = 6 if ($angleTime !~ m/^[+-]?\d+$/);
$angleTime = 6 if ($angleTime > 6);
$angleTime = 0 if ($angleTime < 0);
$shutTime = 255 if ($shutTime !~ m/^[+-]?\d+$/);
$shutTime = 255 if ($shutTime > 255);
$shutTime = 1 if ($shutTime < 1);
if ($cmd eq "teach") {
# teach-in EEP A5-3F-7F, Manufacturer "Eltako"
CommandDeleteReading(undef, "$name .*");
$data = "FFF80D80";
} elsif ($cmd eq "stop") {
# stop
# delete readings, as they are undefined
CommandDeleteReading(undef, "$name anglePos");
CommandDeleteReading(undef, "$name position");
readingsSingleUpdate($hash, "endPosition", "not_reached", 1);
readingsSingleUpdate($hash, "state", "stop", 1);
$shutCmd = 0;
} elsif ($cmd eq "opens") {
# opens >> B0
$anglePos = 0;
$position = 0;
readingsSingleUpdate($hash, "anglePos", $anglePos, 1);
readingsSingleUpdate($hash, "position", $position, 1);
readingsSingleUpdate($hash, "endPosition", "open", 1);
$cmd = "open";
$shutTime = $shutTimeCloses;
$shutCmd = 1;
$updateState = 0;
} elsif ($cmd eq "closes") {
# closes >> BI
$anglePos = $angleMax;
$position = 100;
readingsSingleUpdate($hash, "anglePos", $anglePos, 1);
readingsSingleUpdate($hash, "position", $position, 1);
readingsSingleUpdate($hash, "endPosition", "closed", 1);
$cmd = "closed";
$shutTime = $shutTimeCloses;
$shutCmd = 2;
$updateState = 0;
} elsif ($cmd eq "up") {
# up
if (defined $a[1]) {
if ($a[1] =~ m/^[+-]?\d+$/ && $a[1] >= 0 && $a[1] <= 255) {
$position = $positionStart - $a[1] / $shutTime * 100;
if ($angleTime) {
$anglePos = $anglePosStart - ($angleMax - $angleMin) * $a[1] / $angleTime;
if ($anglePos < $angleMin) {
$anglePos = $angleMin;
}
} else {
$anglePos = $angleMin;
}
if ($position <= 0) {
$anglePos = 0;
$position = 0;
readingsSingleUpdate($hash, "endPosition", "open", 1);
$cmd = "open";
} else {
readingsSingleUpdate($hash, "endPosition", "not_reached", 1);
$cmd = "not_reached";
}
$shutTime = $a[1];
shift(@a);
} else {
return "Usage: $a[1] is not numeric or out of range";
}
} else {
$anglePos = 0;
$position = 0;
readingsSingleUpdate($hash, "endPosition", "open", 1);
$cmd = "open";
}
readingsSingleUpdate($hash, "anglePos", sprintf("%d", $anglePos), 1);
readingsSingleUpdate($hash, "position", sprintf("%d", $position), 1);
$shutCmd = 1;
} elsif ($cmd eq "down") {
# down
if (defined $a[1]) {
if ($a[1] =~ m/^[+-]?\d+$/ && $a[1] >= 0 && $a[1] < 255) {
$position = $positionStart + $a[1] / $shutTime * 100;
if ($angleTime) {
$anglePos = $anglePosStart + ($angleMax - $angleMin) * $a[1] / $angleTime;
if ($anglePos > $angleMax) {
$anglePos = $angleMax;
}
} else {
$anglePos = $angleMax;
}
if($position >= 100) {
$anglePos = $angleMax;
$position = 100;
readingsSingleUpdate($hash, "endPosition", "closed", 1);
$cmd = "closed";
} else {
readingsSingleUpdate($hash, "endPosition", "not_reached", 1);
$cmd = "not_reached";
}
$shutTime = $a[1];
shift(@a);
} else {
return "Usage: $a[1] is not numeric or out of range";
}
} else {
$anglePos = $angleMax;
$position = 100;
readingsSingleUpdate($hash, "endPosition", "closed", 1);
$cmd = "closed";
}
readingsSingleUpdate($hash, "anglePos", sprintf("%d", $anglePos), 1);
readingsSingleUpdate($hash, "position", sprintf("%d", $position), 1);
$shutCmd = 2;
} elsif ($cmd eq "position") {
if (!defined $positionStart) {
return "Position unknown, please first opens the blinds completely."
} elsif ($angleTime > 0 && !defined $anglePosStart){
return "Slats angle position unknown, please first opens the blinds completely."
} else {
my $shutTimeSet = $shutTime;
if (defined $a[2]) {
if ($a[2] =~ m/^[+-]?\d+$/ && $a[2] >= $angleMin && $a[2] <= $angleMax) {
$anglePos = $a[2];
} else {
return "Usage: $a[1] $a[2] is not numeric or out of range";
}
splice(@a,2,1);
} else {
$anglePos = $angleMax;
}
if ($positionStart <= $angleTime * $angleMax / ($angleMax - $angleMin) / $shutTimeSet * 100) {
$anglePosStart = $angleMax;
}
if (defined $a[1] && $a[1] =~ m/^[+-]?\d+$/ && $a[1] >= 0 && $a[1] <= 100) {
if ($positionStart < $a[1]) {
# down
$angleTime = $angleTime * ($angleMax - $anglePos) / ($angleMax - $angleMin);
$shutTime = $shutTime * ($a[1] - $positionStart) / 100 + $angleTime;
# round up
$angleTime = int($angleTime) + 1 if ($angleTime > int($angleTime));
$shutTime = int($shutTime) + 1 if ($shutTime > int($shutTime));
$position = $a[1] + $angleTime / $shutTimeSet * 100;
if ($position >= 100) {
$position = 100;
}
$shutCmd = 2;
if ($angleTime) {
my @timerCmd = ($name, "up", $angleTime);
my %par = (hash => $hash, timerCmd => \@timerCmd);
InternalTimer(gettimeofday() + $shutTime + 1, "EnOcean_TimerSet", \%par, 0);
}
} elsif ($positionStart > $a[1]) {
# up
$angleTime = $angleTime * ($anglePos - $angleMin) /($angleMax - $angleMin);
$shutTime = $shutTime * ($positionStart - $a[1]) / 100 + $angleTime;
# round up
$angleTime = int($angleTime) + 1 if ($angleTime > int($angleTime));
$shutTime = int($shutTime) + 1 if ($shutTime > int($shutTime));
$position = $a[1] - $angleTime / $shutTimeSet * 100;
if ($position <= 0) {
$position = 0;
$anglePos = 0;
}
$shutCmd = 1;
if ($angleTime && $a[1] > 0) {
my @timerCmd = ($name, "down", $angleTime);
my %par = (hash => $hash, timerCmd => \@timerCmd);
InternalTimer(gettimeofday() + $shutTime + 1, "EnOcean_TimerSet", \%par, 0);
}
} else {
if ($anglePosStart > $anglePos) {
# up >> reduce slats angle
$shutTime = $angleTime * ($anglePosStart - $anglePos)/($angleMax - $angleMin);
# round up
$shutTime = int($shutTime) + 1 if ($shutTime > int($shutTime));
$shutCmd = 1;
} elsif ($anglePosStart < $anglePos) {
# down >> enlarge slats angle
$shutTime = $angleTime * ($anglePos - $anglePosStart) /($angleMax - $angleMin);
# round up
$shutTime = int($shutTime) + 1 if ($shutTime > int($shutTime));
$shutCmd = 2;
} else {
# position and slats angle ok
$shutCmd = 0;
}
}
if ($position == 0) {
readingsSingleUpdate($hash, "endPosition", "open", 1);
$cmd = "open";
} elsif ($position == 100) {
readingsSingleUpdate($hash, "endPosition", "closed", 1);
$cmd = "closed";
} else {
readingsSingleUpdate($hash, "endPosition", "not_reached", 1);
$cmd = "not_reached";
}
readingsSingleUpdate($hash, "anglePos", sprintf("%d", $anglePos), 1);
readingsSingleUpdate($hash, "position", sprintf("%d", $position), 1);
shift(@a);
} else {
return "Usage: $a[1] is not numeric or out of range";
}
}
} else {
return "Unknown argument " . $cmd . ", choose one of closes:noArg down opens:noArg position:slider,0,5,100 stop:noArg teach:noArg up"
}
if ($shutCmd || $cmd eq "stop") {
$updateState = 0;
$data = sprintf "%02X%02X%02X%02X", 0, $shutTime, $shutCmd, 8;
}
Log3 $name, 2, "EnOcean set $name $cmd";
}
} elsif ($st eq "actuator.01") {
# Electronic switches and dimmers with Energy Measurement and Local Control
# (D2-01-00 - D2-01-11)
$rorg = "D2";
$updateState = 0;
my $cmdID;
my $channel;
my $dimValTimer = 0;
my $outputVal;
if ($cmd eq "on") {
shift(@a);
$cmdID = 1;
my $dimValueOn = AttrVal($name, "dimValueOn", 100);
if ($dimValueOn eq "stored") {
$outputVal = ReadingsVal($name, "dimValueStored", 100);
if ($outputVal < 1) {
$outputVal = 100;
readingsSingleUpdate ($hash, "dimValueStored", $outputVal, 1);
}
} elsif ($dimValueOn eq "last") {
$outputVal = ReadingsVal ($name, "dimValueLast", 100);
if ($outputVal < 1) { $outputVal = 100; }
} else {
if ($dimValueOn !~ m/^[+-]?\d+$/) {
$outputVal = 100;
} elsif ($dimValueOn > 100) {
$outputVal = 100;
} elsif ($dimValueOn < 1) {
$outputVal = 1;
} else {
$outputVal = $dimValueOn;
}
}
$channel = shift(@a);
if (!defined $channel || $channel eq "all") {
CommandDeleteReading(undef, "$name channel.*");
CommandDeleteReading(undef, "$name dim.*");
readingsSingleUpdate($hash, "channelAll", "on", 1);
readingsSingleUpdate($hash, "dim", $outputVal, 1);
$channel = 30;
} elsif ($channel eq "input") {
readingsSingleUpdate($hash, "channelInput", "on", 1);
readingsSingleUpdate($hash, "dimInput", $outputVal, 1);
$channel = 31;
} elsif ($channel >= 0 && $channel <= 29) {
readingsSingleUpdate($hash, "channel" . $channel, "on", 1);
readingsSingleUpdate($hash, "dim" . $channel, $outputVal, 1);
} else {
return "$cmd $channel wrong, choose 0...39|all|input.";
}
readingsSingleUpdate($hash, "state", "on", 1);
$data = sprintf "%02X%02X%02X", $cmdID, $dimValTimer << 5 | $channel, $outputVal;
} elsif ($cmd eq "off") {
shift(@a);
$cmdID = 1;
$outputVal = 0;
$channel = shift(@a);
if (!defined $channel || $channel eq "all") {
CommandDeleteReading(undef, "$name channel.*");
CommandDeleteReading(undef, "$name dim.*");
readingsSingleUpdate($hash, "channelAll", "off", 1);
readingsSingleUpdate($hash, "dim", $outputVal, 1);
$channel = 30;
} elsif ($channel eq "input") {
readingsSingleUpdate($hash, "channelInput", "off", 1);
readingsSingleUpdate($hash, "dimInput", $outputVal, 1);
$channel = 31;
} elsif ($channel >= 0 && $channel <= 29) {
readingsSingleUpdate($hash, "channel" . $channel, "off", 1);
readingsSingleUpdate($hash, "dim" . $channel, $outputVal, 1);
} else {
return "$cmd $channel wrong, choose 0...39|all|input.";
}
readingsSingleUpdate($hash, "state", "off", 1);
$data = sprintf "%02X%02X%02X", $cmdID, $dimValTimer << 5 | $channel, $outputVal;
} elsif ($cmd eq "dim") {
shift(@a);
$cmdID = 1;
$outputVal = shift(@a);
if (!defined $outputVal || $outputVal !~ m/^[+-]?\d+$/ || $outputVal < 0 || $outputVal > 100) {
return "Usage: $cmd variable is not numeric or out of range.";
}
$channel = shift(@a);
if (!defined $channel) {
CommandDeleteReading(undef, "$name channel.*");
CommandDeleteReading(undef, "$name dim.*");
if ($outputVal == 0) {
readingsSingleUpdate($hash, "channelAll", "off", 1);
} else {
readingsSingleUpdate($hash, "channelAll", "on", 1);
}
readingsSingleUpdate($hash, "dim", $outputVal, 1);
$channel = 30;
} else {
if ($channel eq "all") {
CommandDeleteReading(undef, "$name channel.*");
CommandDeleteReading(undef, "$name dim.*");
if ($outputVal == 0) {
readingsSingleUpdate($hash, "channelAll", "off", 1);
} else {
readingsSingleUpdate($hash, "channelAll", "on", 1);
}
readingsSingleUpdate($hash, "dim", $outputVal, 1);
$channel = 30;
} elsif ($channel eq "input") {
if ($outputVal == 0) {
readingsSingleUpdate($hash, "channelInput", "off", 1);
} else {
readingsSingleUpdate($hash, "channelInput", "on", 1);
}
readingsSingleUpdate($hash, "dimInput", $outputVal, 1);
$channel = 31;
} elsif ($channel >= 0 && $channel <= 29) {
if ($outputVal == 0) {
readingsSingleUpdate($hash, "channel" . $channel, "off", 1);
} else {
readingsSingleUpdate($hash, "channel" . $channel, "on", 1);
}
readingsSingleUpdate($hash, "dim" . $channel, $outputVal, 1);
} else {
return "Usage: $cmd $channel wrong, choose 0...39|all|input.";
}
$dimValTimer = shift(@a);
if (defined $dimValTimer) {
if ($dimValTimer eq "switch") {
$dimValTimer = 0;
} elsif ($dimValTimer eq "stop") {
$dimValTimer = 4;
} elsif ($dimValTimer =~ m/^[1-3]$/) {
} else {
return "Usage: $cmd <channel> $dimValTimer wrong, choose 1..3|switch|stop.";
}
} else {
$dimValTimer = 0;
}
}
if ($outputVal == 0) {
readingsSingleUpdate($hash, "state", "off", 1);
} else {
readingsSingleUpdate($hash, "state", "on", 1);
}
$data = sprintf "%02X%02X%02X", $cmdID, $dimValTimer << 5 | $channel, $outputVal;
} elsif ($cmd eq "local") {
shift(@a);
$cmdID = 2;
# same configuration for all channels
$channel = 30;
my $dayNight = ReadingsVal($name, "dayNight", "day");
my $dayNightCmd = ($dayNight eq "night")? 1:0;
my $defaultState = ReadingsVal($name, "defaultState", "off");
my $defaultStateCmd;
if ($defaultState eq "off") {
$defaultStateCmd = 0;
} elsif ($defaultState eq "on") {
$defaultStateCmd = 1;
} elsif ($defaultState eq "last") {
$defaultStateCmd = 2;
} else {
$defaultStateCmd = 0;
}
my $localControl = ReadingsVal($name, "localControl", "disabled");
my $localControlCmd = ($localControl eq "enabled")? 1:0;
my $overCurrentShutdown = ReadingsVal($name, "overCurrentShutdown", "off");
my $overCurrentShutdownCmd = ($overCurrentShutdown eq "restart")? 1:0;
my $overCurrentShutdownReset = "not_active";
my $overCurrentShutdownResetCmd = 0;
my $rampTime1 = ReadingsVal($name, "rampTime1", 0);
my $rampTime1Cmd = $rampTime1 * 2;
if ($rampTime1Cmd <= 0) {
$rampTime1Cmd = 0;
} elsif ($rampTime1Cmd >= 15) {
$rampTime1Cmd = 15;
}
my $rampTime2 = ReadingsVal($name, "rampTime2", 0);
my $rampTime2Cmd = $rampTime2 * 2;
if ($rampTime2Cmd <= 0) {
$rampTime2Cmd = 0;
} elsif ($rampTime2Cmd >= 15) {
$rampTime2Cmd = 15;
}
my $rampTime3 = ReadingsVal($name, "rampTime3", 0);
my $rampTime3Cmd = $rampTime3 * 2;
if ($rampTime3Cmd <= 0) {
$rampTime3Cmd = 0;
} elsif ($rampTime3Cmd >= 15) {
$rampTime3Cmd = 15;
}
my $teachInDev = ReadingsVal($name, "teachInDev", "disabled");
my $teachInDevCmd = ($teachInDev eq "enabled")? 1:0;
my $localCmd = shift(@a);
my $localCmdVal = shift(@a);
if ($localCmd eq "dayNight") {
if ($localCmdVal eq "day") {
$dayNight = "day";
$dayNightCmd = 0;
} elsif ($localCmdVal eq "night") {
$dayNight = "night";
$dayNightCmd = 1;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose day night.";
}
} elsif ($localCmd eq "defaultState"){
if ($localCmdVal eq "off") {
$defaultState = "off";
$defaultStateCmd = 0;
} elsif ($localCmdVal eq "on") {
$defaultState = "on";
$defaultStateCmd = 1;
} elsif ($localCmdVal eq "last") {
$defaultState = "last";
$defaultStateCmd = 2;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose on off last.";
}
} elsif ($localCmd eq "localControl"){
if ($localCmdVal eq "disabled") {
$localControl = "disabled";
$localControlCmd = 0;
} elsif ($localCmdVal eq "enabled") {
$localControl = "enabled";
$localControlCmd = 1;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose disabled enabled.";
}
} elsif ($localCmd eq "overCurrentShutdown"){
if ($localCmdVal eq "off") {
$overCurrentShutdown = "off";
$overCurrentShutdownCmd = 0;
} elsif ($localCmdVal eq "restart") {
$overCurrentShutdown = "restart";
$overCurrentShutdownCmd = 1;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose off restart.";
}
} elsif ($localCmd eq "overCurrentShutdownReset"){
if ($localCmdVal eq "not_active") {
$overCurrentShutdownReset = "not_active";
$overCurrentShutdownResetCmd = 0;
} elsif ($localCmdVal eq "trigger") {
$overCurrentShutdownReset = "trigger";
$overCurrentShutdownResetCmd = 1;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose not_active trigger.";
}
} elsif ($localCmd eq "rampTime1"){
if ($localCmdVal >= 0 || $localCmdVal <= 7.5) {
$rampTime1 = $localCmdVal;
$rampTime1Cmd = $localCmdVal * 2;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose 0, 0.5, ..., 7, 7.5";
}
} elsif ($localCmd eq "rampTime2"){
if ($localCmdVal >= 0 || $localCmdVal <= 7.5) {
$rampTime2 = $localCmdVal;
$rampTime2Cmd = $localCmdVal * 2;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose 0, 0.5, ..., 7, 7.5";
}
} elsif ($localCmd eq "rampTime3"){
if ($localCmdVal >= 0 || $localCmdVal <= 7.5) {
$rampTime3 = $localCmdVal;
$rampTime3Cmd = $localCmdVal * 2;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose 0, 0.5, ..., 7, 7.5";
}
} elsif ($localCmd eq "teachInDev"){
if ($localCmdVal eq "disabled") {
$teachInDev = "disabled";
$teachInDevCmd = 0;
} elsif ($localCmdVal eq "enabled") {
$teachInDev = "enabled";
$teachInDevCmd = 1;
} else {
return "Usage: $cmd $localCmd <value> wrong, choose disabled enabled.";
}
} else {
return "Usage: $cmd <localCmd> wrong, choose defaultState|localControl|" .
"overCurrentShutdown|overCurrentShutdownReset|rampTime1|rampTime2|rampTime3|teachInDev.";
}
readingsSingleUpdate($hash, "dayNight", $dayNight, 1);
readingsSingleUpdate($hash, "defaultState", $defaultState, 1);
readingsSingleUpdate($hash, "localControl", $localControl, 1);
readingsSingleUpdate($hash, "overCurrentShutdown", $overCurrentShutdown, 1);
readingsSingleUpdate($hash, "overCurrentShutdownReset", $overCurrentShutdownReset, 1);
readingsSingleUpdate($hash, "rampTime1", $rampTime1, 1);
readingsSingleUpdate($hash, "rampTime2", $rampTime2, 1);
readingsSingleUpdate($hash, "rampTime3", $rampTime3, 1);
readingsSingleUpdate($hash, "teachInDev", $teachInDev, 1);
$data = sprintf "%02X%02X%02X%02X", $teachInDevCmd << 7 | $cmdID,
$overCurrentShutdownCmd << 7 | $overCurrentShutdownResetCmd << 6 | $localControlCmd << 5 | $channel,
int($rampTime2Cmd) << 4 | int($rampTime3Cmd),
$dayNightCmd << 7 | $defaultStateCmd << 4 | int($rampTime1Cmd);
} elsif ($cmd eq "measurement") {
shift(@a);
$cmdID = 5;
# same configuration for all channels
$channel = 30;
my $measurementMode = ReadingsVal($name, "measurementMode", "energy");
my $measurementModeCmd = ($measurementMode eq "power")? 0:1;
my $measurementReport = ReadingsVal($name, "measurementReport", "query");
my $measurementReportCmd = ($measurementReport eq "auto")? 0:1;
my $measurementReset = "not_active";
my $measurementResetCmd = 0;
my $measurementDelta = int(ReadingsVal($name, "measurementDelta", 0));
if ($measurementDelta <= 0) {
$measurementDelta = 0;
} elsif ($measurementDelta >= 4095) {
$measurementDelta = 4095;
}
my $unit = ReadingsVal($name, "measurementUnit", "Ws");
my $unitCmd;
if ($unit eq "Ws") {
$unitCmd = 0;
} elsif ($unit eq "Wh") {
$unitCmd = 1;
} elsif ($unit eq "KWh") {
$unitCmd = 2;
} elsif ($unit eq "W") {
$unitCmd = 3;
} elsif ($unit eq "KW") {
$unitCmd = 4;
} else {
$unitCmd = 0;
}
my $responseTimeMax = ReadingsVal($name, "responseTimeMax", 10);
my $responseTimeMaxCmd = $responseTimeMax / 10;
if ($responseTimeMaxCmd <= 0) {
$responseTimeMaxCmd = 0;
} elsif ($responseTimeMaxCmd >= 255) {
$responseTimeMaxCmd = 255;
}
my $responseTimeMin = ReadingsVal($name, "responseTimeMin", 0);
if ($responseTimeMin <= 0) {
$responseTimeMin = 0;
} elsif ($responseTimeMin >= 255) {
$responseTimeMin = 255;
}
my $measurementCmd = shift(@a);
my $measurementCmdVal = shift(@a);
if ($measurementCmd eq "mode") {
if ($measurementCmdVal eq "energy") {
$measurementMode = "energy";
$measurementModeCmd = 0;
} elsif ($measurementCmdVal eq "power") {
$measurementMode = "power";
$measurementModeCmd = 1;
} else {
return "Usage: $cmd $measurementCmd <value> wrong, choose energy power.";
}
} elsif ($measurementCmd eq "report"){
if ($measurementCmdVal eq "query") {
$measurementReport = "query";
$measurementReportCmd = 0;
} elsif ($measurementCmdVal eq "auto") {
$measurementReport = "auto";
$measurementReportCmd = 1;
} else {
return "Usage: $cmd $measurementCmd <value> wrong, choose query auto.";
}
} elsif ($measurementCmd eq "reset"){
if ($measurementCmdVal eq "not_active") {
$measurementReset = "not_active";
$measurementResetCmd = 0;
} elsif ($measurementCmdVal eq "trigger") {
$measurementReset = "trigger";
$measurementResetCmd = 1;
} else {
return "Usage: $cmd $measurementCmd <value> wrong, choose not_active trigger.";
}
} elsif ($measurementCmd eq "unit"){
if ($measurementCmdVal eq "Ws") {
$unit = "Ws";
$unitCmd = 0;
} elsif ($measurementCmdVal eq "Wh") {
$unit = "Wh";
$unitCmd = 1;
} elsif ($measurementCmdVal eq "KWh") {
$unit = "KWh";
$unitCmd = 2;
} elsif ($measurementCmdVal eq "W") {
$unit = "W";
$unitCmd = 3;
} elsif ($measurementCmdVal eq "KW") {
$unit = "KW";
$unitCmd = 4;
} else {
return "Usage: $cmd $measurementCmd <value> wrong, choose Ws Wh KWh W KW.";
}
} elsif ($measurementCmd eq "delta"){
if ($measurementCmdVal >= 0 || $measurementCmdVal <= 4095) {
$measurementDelta = int($measurementCmdVal);
} else {
return "Usage: $cmd $measurementCmd <value> wrong, choose 0 ... 4095";
}
} elsif ($measurementCmd eq "responseTimeMax"){
if ($measurementCmdVal >= 10 || $measurementCmdVal <= 2550) {
$responseTimeMax = int($measurementCmdVal);
$responseTimeMaxCmd = int($measurementCmdVal) / 10;
} else {
return "Usage: $cmd $measurementCmd <value> wrong, choose 10 ... 2550";
}
} elsif ($measurementCmd eq "responseTimeMin"){
if ($measurementCmdVal >= 0 || $measurementCmdVal <= 255) {
$responseTimeMin = int($measurementCmdVal);
} else {
return "Usage: $cmd $measurementCmd <value> wrong, choose 0 ... 255";
}
} else {
return "Usage: $cmd <measurementCmd> wrong, choose mode|report|" .
"reset|delta|unit|responseTimeMax|responseTimeMin.";
}
readingsSingleUpdate($hash, "measurementMode", $measurementMode, 1);
readingsSingleUpdate($hash, "measurementReport", $measurementReport, 1);
readingsSingleUpdate($hash, "measurementReset", $measurementReset, 1);
readingsSingleUpdate($hash, "measurementDelta", $measurementDelta, 1);
readingsSingleUpdate($hash, "measurementUnit", $unit, 1);
readingsSingleUpdate($hash, "responseTimeMax", $responseTimeMax, 1);
readingsSingleUpdate($hash, "responseTimeMin", $responseTimeMin, 1);
$data = sprintf "%02X%02X%02X%02X%02X%02X", $cmdID,
$measurementReportCmd << 7 | $measurementResetCmd << 6 | $measurementModeCmd << 5 | $channel,
($measurementDelta | 0x0F) << 4 | $unitCmd, ($measurementDelta | 0xFF00) >> 8,
$responseTimeMax, $responseTimeMin;
} else {
my $cmdList = "dim:slider,0,1,100 on:noArg off:noArg local measurement";
return SetExtensions ($hash, $cmdList, $name, @a);
}
Log3 $name, 3, "EnOcean set $name $cmd $data";
} elsif ($st eq "contact") {
# 1BS Telegram
# Single Input Contact (EEP D5-00-01)
$rorg = "D5";
my $setCmd;
if ($cmd eq "teach") {
$setCmd = 0;
} elsif ($cmd eq "closed") {
$setCmd = 9;
} elsif ($cmd eq "open") {
$setCmd = 8;
} else {
return "Unknown argument $cmd, choose one of open:noArg closed:noArg teach:noArg";
}
$data = sprintf "%02X", $setCmd;
Log3 $name, 2, "EnOcean set $name $cmd";
} elsif ($st eq "raw") {
# sent raw data
if ($cmd eq "4BS"){
# 4BS Telegram
if ($a[1] && $a[1] =~ m/^[\dA-Fa-f]{8}$/) {
$data = uc($a[1]);
$rorg = "A5";
} else {
return "Wrong parameter, choose 4BS <data 4 Byte hex> [status 1 Byte hex]";
}
} elsif ($cmd eq "1BS") {
# 1BS Telegram
if ($a[1] && $a[1] =~ m/^[\dA-Fa-f]{2}$/) {
$data = uc($a[1]);
$rorg = "D5";
} else {
return "Wrong parameter, choose 1BS <data 1 Byte hex> [status 1 Byte hex]";
}
} elsif ($cmd eq "RPS") {
# RPS Telegram
if ($a[1] && $a[1] =~ m/^[\dA-Fa-f]{2}$/) {
$data = uc($a[1]);
$rorg = "F6";
} else {
return "Wrong parameter, choose RPS <data 1 Byte hex> [status 1 Byte hex]";
}
} elsif ($cmd eq "MSC") {
# MSC Telegram
if ($a[1] && $a[1] =~ m/^[\dA-Fa-f]{2,28}$/ && !(length($a[1]) % 2)) {
$data = uc($a[1]);
$rorg = "D1";
} else {
return "Wrong parameter, choose MSC <data 1 ... 14 Byte hex> [status 1 Byte hex]";
}
} elsif ($cmd eq "UTE") {
# UTE Telegram
if ($a[1] && $a[1] =~ m/^[\dA-Fa-f]{14}$/) {
$data = uc($a[1]);
$rorg = "D4";
} else {
return "Wrong parameter, choose UTE <data 7 Byte hex> [status 1 Byte hex]";
}
} elsif ($cmd eq "VLD") {
# VLD Telegram
if ($a[1] && $a[1] =~ m/^[\dA-Fa-f]{2,28}$/ && !(length($a[1]) % 2)) {
$data = uc($a[1]);
$rorg = "D2";
} else {
return "Wrong parameter, choose VLD <data 1 ... 14 Byte hex> [status 1 Byte hex]";
}
} else {
return "Unknown argument $cmd, choose one of 1BS 4BS MSC RPS UTE VLD test";
}
if ($a[2]) {
if ($a[2] !~ m/^[\dA-Fa-f]{2}$/) {
return "Wrong status parameter, choose $cmd $a[1] [status 1 Byte hex]";
}
$status = uc($a[2]);
splice(@a,2,1);
}
$updateState = 0;
readingsSingleUpdate($hash, "RORG", $cmd, 1);
readingsSingleUpdate($hash, "dataSent", $data, 1);
readingsSingleUpdate($hash, "statusSent", $status, 1);
Log3 $name, 2, "EnOcean set $name $cmd $data $status";
shift(@a);
} elsif ($st eq "switch") {
# Rocker Switch, simulate a PTM200 switch module
# separate first and second action
my ($c1,$c2) = split(",", $cmd, 2);
# check values
if (!defined($EnO_ptm200btn{$c1}) || ($c2 && !defined($EnO_ptm200btn{$c2}))) {
my $list = join(" ", sort keys %EnO_ptm200btn);
return SetExtensions($hash, $list, $name, @a);
}
my $channelA = ReadingsVal($name, "channelA", undef);
my $channelB = ReadingsVal($name, "channelB", undef);
my $channelC = ReadingsVal($name, "channelC", undef);
my $channelD = ReadingsVal($name, "channelD", undef);
my $subDef0 = AttrVal($name, "subDef0", "$hash->{DEF}");
my $subDefI = AttrVal($name, "subDefI", "$hash->{DEF}");
my $switchType = AttrVal($name, "switchType", "direction");
# first action
if ($switchType eq "central") {
if ($c1 =~ m/.0/ || $c1 eq "released") {
$subDef = $subDef0;
} else {
$subDef = $subDefI;
}
}
if ($switchType eq "universal") {
if ($c1 =~ m/A0|AI/ && (!$channelA || ($c1 ne $channelA))) {
$c1 = "A0";
} elsif ($c1 =~ m/B0|BI/ && (!$channelB || $c1 ne $channelB)) {
$c1 = "B0";
} elsif ($c1 =~ m/C0|CI/ && (!$channelC || ($c1 ne $channelC))) {
$c1 = "C0";
} elsif ($c1 =~ m/D0|DI/ && (!$channelD || ($c1 ne $channelD))) {
$c1 = "D0";
} elsif ($c1 eq "released") {
} else {
$sendCmd = "no";
}
}
# second action
if ($c2 && $switchType eq "universal") {
if ($c2 =~ m/A0|AI/ && (!$channelA || ($c2 ne $channelA))) {
$c2 = "A0";
} elsif ($c2 =~ m/B0|BI/ && (!$channelB || $c2 ne $channelB)) {
$c2 = "B0";
} elsif ($c2 =~ m/C0|CI/ && (!$channelC || ($c2 ne $channelC))) {
$c2 = "C0";
} elsif ($c2 =~ m/D0|DI/ && (!$channelD || ($c2 ne $channelD))) {
$c2 = "D0";
} else {
$c2 = undef;
}
if ($c2 && $sendCmd eq "no") {
# only second action has changed, send as first action
$c1 = $c2;
$c2 = undef;
$sendCmd = "yes";
}
}
# convert and send first and second command
my $switchCmd;
($switchCmd, $status) = split(":", $EnO_ptm200btn{$c1}, 2);
$switchCmd <<= 5;
$switchCmd |= 0x10 if($c1 ne "released"); # set the pressed flag
if($c2 && $switchType ne "central") {
my ($d2, undef) = split(":", $EnO_ptm200btn{$c2}, 2);
$switchCmd |= ($d2<<1) | 0x01;
}
if ($sendCmd ne "no") {
$data = sprintf "%02X", $switchCmd;
$rorg = "F6";
Log3 $name, 2, "EnOcean set $name $cmd";
}
} else {
# subtype does not support set commands
$updateState = -1;
return;
}
# send commands
if($updateState != 2) {
EnOcean_SndRadio(undef, $hash, $rorg, $data, $subDef, $status, $destinationID);
if ($switchMode eq "pushbutton") {
$data = "00";
$rorg = "F6";
$status = "20";
# next commands will be sent with a delay
select(undef, undef, undef, 0.2);
Log3 $name, 2, "EnOcean set $name released";
EnOcean_SndRadio(undef, $hash, $rorg, $data, $subDef, $status, $destinationID);
}
}
# next commands will be sent with a delay
select(undef, undef, undef, 0.2);
}
# set reading state if acknowledge is not expected
$subDef = AttrVal($name, "subDef", undef);
if($updateState == 1 || !defined $subDef) {
readingsSingleUpdate($hash, "state", join(" ", @a), 1);
return undef;
}
}
# Parse
sub
EnOcean_Parse($$)
{
my ($iohash, $msg) = @_;
my (undef, $packetType, $rorg, $data, $id, $status, $odata) = split(":", $msg);
my $rorgname = $EnO_rorgname{$rorg};
if (!$rorgname) {
Log3 undef, 2, "EnOcean RORG ($rorg) received from $id unknown.";
return "";
}
my $hash = $modules{EnOcean}{defptr}{$id};
if (!$hash) {
if ($rorgname eq "UTE") {
if ($iohash->{Teach}) {
Log3 undef, 3, "EnOcean Unknown device with ID $id and RORG $rorgname, please define it.";
return "UNDEFINED EnO_${rorgname}_$id EnOcean $id $msg";
} else {
Log3 undef, 3, "EnOcean Unknown device with ID $id and RORG $rorgname, set transceiver in teach mode.";
return "";
}
} else {
Log3 undef, 3, "EnOcean Unknown device with ID $id and RORG $rorgname, please define it.";
return "UNDEFINED EnO_${rorgname}_$id EnOcean $id $msg";
}
}
my $name = $hash->{NAME};
my $teach = $defs{$name}{IODev}{Teach};
my $teachOut;
# extract data bytes $db[x] ... $db[0]
my @db;
my $dbCntr = 0;
for (my $strCntr = length($data) / 2 - 1; $strCntr >= 0; $strCntr--) {
$db[$dbCntr] = hex substr($data, $strCntr * 2, 2);
$dbCntr++;
}
my @event;
my $model = AttrVal($name, "model", "");
my $manufID = uc(AttrVal($name, "manufID", ""));
my $st = AttrVal($name, "subType", "");
Log3 $name, 5, "EnOcean $name PacketType:$packetType RORG:$rorg DATA:$data ID:$id STATUS:$status";
if ($rorg eq "F6") {
# RPS Telegram (PTM200)
# Rocker Switch (EEP F6-02-01 ... F6-03-02)
# Position Switch, Home and Office Application (EEP F6-04-01)
# Mechanical Handle (EEP F6-10-00)
my $event = "state";
my $nu = ((hex($status) & 0x10) >> 4);
# unused flags (AFAIK)
#push @event, "1:T21:".((hex($status) & 0x20) >> 5);
#push @event, "1:NU:$nu";
if ($st eq "FRW") {
# smoke detector Eltako FRW
if ($db[0] == 0x30) {
push @event, "3:battery:low";
} elsif ($db[0] == 0x10) {
push @event, "3:alarm:smoke-alarm";
$msg = "smoke-alarm";
} elsif ($db[0] == 0) {
push @event, "3:alarm:off";
push @event, "3:battery:ok";
$msg = "off";
}
} elsif ($model eq "FAE14" || $model eq "FHK14" || $model eq "FHK61") {
# heating/cooling relay FAE14, FHK14, untested
$event = "controllerMode";
if ($db[0] == 0x30) {
# night reduction 2 K
push @event, "3:energyHoldOff:holdoff";
$msg = "auto";
} elsif ($db[0] == 0x10) {
# off
push @event, "3:energyHoldOff:normal";
$msg = "off";
} elsif ($db[0] == 0x70) {
# on
push @event, "3:energyHoldOff:normal";
$msg = "auto";
} elsif ($db[0] == 0x50) {
# night reduction 4 K
push @event, "3:energyHoldOff:holdoff";
$msg = "auto";
}
} elsif ($st eq "gateway") {
# Eltako switching, dimming
if ($db[0] == 0x70) {
# on
$msg = "on";
} elsif ($db[0] == 0x50) {
# off
$msg = "off";
}
} elsif ($st eq "manufProfile" && $manufID eq "00D") {
# Eltako shutter
if ($db[0] == 0x70) {
# open
push @event, "3:endPosition:open_ack";
$msg = "open_ack";
} elsif ($db[0] == 0x50) {
# closed
push @event, "3:position:100";
push @event, "3:anglePos:" . AttrVal($name, "angleMax", 90);
push @event, "3:endPosition:closed";
$msg = "closed";
} elsif ($db[0] == 0) {
# not reached or not available
push @event, "3:endPosition:not_reached";
$msg = "not_reached";
} elsif ($db[0] == 1) {
# up
push @event, "3:endPosition:not_reached";
$msg = "up";
} elsif ($db[0] == 2) {
# down
push @event, "3:endPosition:not_reached";
$msg = "down";
}
} else {
if ($nu) {
# Theoretically there can be a released event with some of the A0, BI
# pins set, but with the plastic cover on this wont happen.
$msg = $EnO_ptm200btn[($db[0] & 0xE0) >> 5];
$msg .= "," . $EnO_ptm200btn[($db[0] & 0x0E) >> 1] if ($db[0] & 1);
$msg .= " released" if (!($db[0] & 0x10));
} else {
if ($db[0] == 112) {
# Key Card, not tested
$msg = "keycard inserted";
} elsif ($db[0] & 0xC0) {
# Only a Mechanical Handle is setting these bits when nu=0
$msg = "closed" if ($db[0] == 0xF0);
$msg = "open" if ($db[0] == 0xE0);
$msg = "tilted" if ($db[0] == 0xD0);
$msg = "open from tilted" if ($db[0] == 0xC0);
} else {
if($st eq "keycard") {
$msg = "keycard removed";
}
else {
$msg = (($db[0] & 0x10) ? "pressed" : "released");
}
}
}
push @event, "3:buttons:" . ($db[0] & 0x10 ? "pressed" : "released");
if ($msg =~ m/A0$/) {
push @event, "3:channelA:A0";
} elsif ($msg =~ m/AI$/) {
push @event, "3:channelA:AI";
} elsif ($msg =~ m/B0$/) {
push @event, "3:channelB:B0";
} elsif ($msg =~ m/BI$/) {
push @event, "3:channelB:BI";
} elsif ($msg =~ m/C0$/) {
push @event, "3:channelC:C0";
} elsif ($msg =~ m/CI$/) {
push @event, "3:channelC:CI";
} elsif ($msg =~ m/D0$/) {
push @event, "3:channelD:D0";
} elsif ($msg =~ m/DI$/) {
push @event, "3:channelD:DI";
}
# released events are disturbing when using a remote, since it overwrites
# the "real" state immediately. In the case of an Eltako FSB14, FSB61 ...
# the state should remain released. (by Thomas)
$event = "buttons" if ($msg =~ m/released$/ &&
$model ne "FT55" && $model ne "FSB14" &&
$model ne "FSB61" && $model ne "FSB70" &&
$model ne "FSM12" && $model ne "FSM61" &&
$model ne "FTS12" &&
AttrVal($name, "sensorMode", "switch") ne "pushbutton");
}
push @event, "3:$event:$msg";
} elsif ($rorg eq "D5") {
# 1BS telegram
# Single Input Contact (EEP D5-00-01)
# [Eltako FTK, STM-250]
push @event, "3:state:" . ($db[0] & 1 ? "closed" : "open");
push @event, "3:learnBtn:on" if (!($db[0] & 8));
} elsif ($rorg eq "A5") {
# 4BS telegram
if (($db[0] & 0x08) == 0) {
# Teach-In telegram
if ($db[0] & 0x80) {
# Teach-In telegram with EEP and Manufacturer ID
my $fn = sprintf "%02X", ($db[3] >> 2);
my $tp = sprintf "%02X", ((($db[3] & 3) << 5) | ($db[2] >> 3));
my $mf = sprintf "%03X", ((($db[2] & 7) << 8) | $db[1]);
# manufID to account for vendor-specific features
$attr{$name}{manufID} = $mf;
$mf = $EnO_manuf{$mf} if($EnO_manuf{$mf});
my $st = "A5.$fn.$tp";
if($EnO_subType{$st}) {
$st = $EnO_subType{$st};
push @event, "3:teach-in:EEP A5-$fn-$tp Manufacturer: $mf";
Log3 $name, 1, "EnOcean $name teach-in EEP A5-$fn-$tp Manufacturer: $mf";
$attr{$name}{subType} = $st;
} else {
push @event, "3:teach-in:EEP A5-$fn-$tp Manufacturer: $mf not supported";
Log3 $name, 1, "EnOcean $name teach-in EEP A5-$fn-$tp Manufacturer: $mf not supported";
$attr{$name}{subType} = "raw";
}
if ($st eq "hvac.01" || $st eq "MD15") {
if ($teach) {
# bidirectional Teach-In for EEP A5-20-01 (MD15)
$attr{$name}{comMode} = "biDir";
$attr{$name}{destinationID} = "unicast";
# SenderID = ChipID
$attr{$name}{subDef} = "00000000";
# next commands will be sent with a delay, max 10 s
select(undef, undef, undef, 0.1);
# teach-in response
EnOcean_SndRadio(undef, $hash, $rorg, "800FFFF0", "00000000", "00", $hash->{DEF});
#EnOcean_SndRadio(undef, $hash, $rorg, "800800F0", "00000000", "00", $hash->{DEF});
select(undef, undef, undef, 0.5);
EnOcean_hvac_01Cmd($hash, $name, 128); # 128 == 20 degree C
} else {
Log3 $name, 3, "EnOcean Unknown device $name and subType $st, set transceiver in teach mode.";
return "";
}
} elsif ($st eq "hvac.02") {
if ($teach) {
} else {
Log3 $name, 3, "EnOcean Unknown device $name and subType $st, set transceiver in teach mode.";
return "";
}
} elsif ($st eq "hvac.03") {
if ($teach) {
} else {
Log3 $name, 3, "EnOcean Unknown device $name and subType $st, set transceiver in teach mode.";
return "";
}
} elsif ($st eq "hvac.10") {
if ($teach) {
} else {
Log3 $name, 3, "EnOcean Unknown device $name and subType $st, set transceiver in teach mode.";
return "";
}
} elsif ($st eq "hvac.11") {
if ($teach) {
} else {
Log3 $name, 3, "EnOcean Unknown device $name and subType $st, set transceiver in teach mode.";
return "";
}
}
# store attr subType, manufID ...
CommandSave(undef, undef);
# delete standard readings
CommandDeleteReading(undef, "$name sensor[0-9]");
CommandDeleteReading(undef, "$name D[0-9]");
} else {
push @event, "3:teach-in:No EEP profile identifier and no Manufacturer ID";
}
} elsif ($st eq "hvac.01" || $st eq "MD15") {
# Battery Powered Actuator (EEP A5-20-01)
# [Kieback&Peter MD15-FTL-xx]
push @event, "3:state:$db[3]";
push @event, "3:currentValue:$db[3]";
push @event, "3:serviceOn:" . (($db[2] & 0x80) ? "yes" : "no");
push @event, "3:energyInput:" . (($db[2] & 0x40) ? "enabled":"disabled");
push @event, "3:energyStorage:". (($db[2] & 0x20) ? "charged":"empty");
push @event, "3:battery:" . (($db[2] & 0x10) ? "ok" : "low");
push @event, "3:cover:" . (($db[2] & 0x08) ? "open" : "closed");
push @event, "3:tempSensor:" . (($db[2] & 0x04) ? "failed" : "ok");
push @event, "3:window:" . (($db[2] & 0x02) ? "open" : "closed");
push @event, "3:actuatorStatus:".(($db[2] & 0x01) ? "obstructed" : "ok");
push @event, "3:measured-temp:". sprintf "%0.1f", ($db[1]*40/255);
push @event, "3:selfCtl:" . (($db[0] & 0x04) ? "on" : "off");
EnOcean_hvac_01Cmd($hash, $name, $db[1]);
} elsif ($st eq "PM101") {
# Light and Presence Sensor [Omnio Ratio eagle-PM101]
# The sensor also sends switching commands (RORG F6) with the senderID-1
# $db[2] is the illuminance where 0x00 = 0 lx ... 0xFF = 1000 lx
my $channel2 = $db[0] & 2 ? "yes" : "no";
push @event, "3:brightness:" . $db[2] << 2;
push @event, "3:channel1:" . ($db[0] & 1 ? "yes" : "no");
push @event, "3:channel2:" . $channel2;
push @event, "3:motion:" . $channel2;
push @event, "3:state:" . $channel2;
} elsif ($st =~ m/^tempSensor/) {
# Temperature Sensor with with different ranges (EEP A5-02-01 ... A5-02-1B)
# $db[1] is the temperature where 0x00 = max <20>C ... 0xFF = min <20>C
my $temp;
$temp = sprintf "%0.1f", 0 - $db[1] / 6.375 if ($st eq "tempSensor.01");
$temp = sprintf "%0.1f", 10 - $db[1] / 6.375 if ($st eq "tempSensor.02");
$temp = sprintf "%0.1f", 20 - $db[1] / 6.375 if ($st eq "tempSensor.03");
$temp = sprintf "%0.1f", 30 - $db[1] / 6.375 if ($st eq "tempSensor.04");
$temp = sprintf "%0.1f", 40 - $db[1] / 6.375 if ($st eq "tempSensor.05");
$temp = sprintf "%0.1f", 50 - $db[1] / 6.375 if ($st eq "tempSensor.06");
$temp = sprintf "%0.1f", 60 - $db[1] / 6.375 if ($st eq "tempSensor.07");
$temp = sprintf "%0.1f", 70 - $db[1] / 6.375 if ($st eq "tempSensor.08");
$temp = sprintf "%0.1f", 80 - $db[1] / 6.375 if ($st eq "tempSensor.09");
$temp = sprintf "%0.1f", 90 - $db[1] / 6.375 if ($st eq "tempSensor.0A");
$temp = sprintf "%0.1f", 100 - $db[1] / 6.375 if ($st eq "tempSensor.0B");
$temp = sprintf "%0.1f", 20 - $db[1] / 3.1875 if ($st eq "tempSensor.10");
$temp = sprintf "%0.1f", 30 - $db[1] / 3.1875 if ($st eq "tempSensor.11");
$temp = sprintf "%0.1f", 40 - $db[1] / 3.1875 if ($st eq "tempSensor.12");
$temp = sprintf "%0.1f", 50 - $db[1] / 3.1875 if ($st eq "tempSensor.13");
$temp = sprintf "%0.1f", 60 - $db[1] / 3.1875 if ($st eq "tempSensor.14");
$temp = sprintf "%0.1f", 70 - $db[1] / 3.1875 if ($st eq "tempSensor.15");
$temp = sprintf "%0.1f", 80 - $db[1] / 3.1875 if ($st eq "tempSensor.16");
$temp = sprintf "%0.1f", 90 - $db[1] / 3.1875 if ($st eq "tempSensor.17");
$temp = sprintf "%0.1f", 100 - $db[1] / 3.1875 if ($st eq "tempSensor.18");
$temp = sprintf "%0.1f", 110 - $db[1] / 3.1875 if ($st eq "tempSensor.19");
$temp = sprintf "%0.1f", 120 - $db[1] / 3.1875 if ($st eq "tempSensor.1A");
$temp = sprintf "%0.1f", 130 - $db[1] / 3.1875 if ($st eq "tempSensor.1B");
$temp = sprintf "%0.2f", 41.2 - (($db[2] << 8) | $db[1]) / 20 if ($st eq "tempSensor.20");
$temp = sprintf "%0.1f", 62.3 - (($db[2] << 8) | $db[1]) / 10 if ($st eq "tempSensor.30");
push @event, "3:temperature:$temp";
push @event, "3:state:$temp";
} elsif ($st eq "COSensor.01") {
# Gas Sensor, CO Sensor (EEP A5-09-01)
# [untested]
# $db[3] is the CO concentration where 0x00 = 0 ppm ... 0xFF = 255 ppm
# $db[1] is the temperature where 0x00 = 0 <20>C ... 0xFF = 255 <20>C
# $db[0] bit D1 temperature sensor available 0 = no, 1 = yes
my $coChannel1 = $db[3];
push @event, "3:CO:$coChannel1";
if ($db[0] & 2) {
my $temp = $db[1];
push @event, "3:temperature:$temp";
}
push @event, "3:state:$coChannel1";
} elsif ($st eq "COSensor.02") {
# Gas Sensor, CO Sensor (EEP A5-09-02)
# [untested]
# $db[3] is the voltage where 0x00 = 0 V ... 0xFF = 5.1 V
# $db[2] is the CO concentration where 0x00 = 0 ppm ... 0xFF = 1020 ppm
# $db[1] is the temperature where 0x00 = 0 <20>C ... 0xFF = 51 <20>C
# $db[0]_bit_1 temperature sensor available 0 = no, 1 = yes
my $coChannel1 = $db[2] << 2;
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
push @event, "3:CO:$coChannel1";
if ($db[0] & 2) {
my $temp = sprintf "%0.1f", $db[1] * 0.2;
push @event, "3:temperature:$temp";
}
push @event, "3:voltage:$voltage";
push @event, "3:state:$coChannel1";
} elsif ($st eq "tempHumiCO2Sensor.01") {
# Gas Sensor, CO2 Sensor (EEP A5-09-04)
# [Thermokon SR04 CO2 *, Eltako FCOTF63, untested]
# $db[3] is the humidity where 0x00 = 0 %rH ... 0xC8 = 100 %rH
# $db[2] is the CO2 concentration where 0x00 = 0 ppm ... 0xFF = 2500 ppm
# $db[1] is the temperature where 0x00 = 0<>C ... 0xFF = +51 <20>C
# $db[0] bit D2 humidity sensor available 0 = no, 1 = yes
# $db[0] bit D1 temperature sensor available 0 = no, 1 = yes
my $humi = "unknown";
my $temp = "unknown";
my $airQuality;
if ($db[0] & 4) {
$humi = $db[3] >> 1;
push @event, "3:humidity:$humi";
}
my $co2 = sprintf "%d", $db[2] * 10;
push @event, "3:CO2:$co2";
if ($db[0] & 2) {
$temp = sprintf "%0.1f", $db[1] * 51 / 255 ;
push @event, "3:temperature:$temp";
}
if ($co2 <= 400) {
$airQuality = "high";
} elsif ($co2 <= 600) {
$airQuality = "mean";
} elsif ($co2 <= 1000) {
$airQuality = "moderate";
} else {
$airQuality = "low";
}
push @event, "3:airQuality:$airQuality";
push @event, "3:state:CO2 $co2 AQ: $airQuality T: $temp H: $humi";
} elsif ($st eq "radonSensor.01") {
# Gas Sensor, Radon Sensor (EEP A5-09-06)
# [untested]
# $db[3]_bit_7 ... $db[2]_bit_6 is the radon activity where 0 = 0 Bq/m3 ... 1023 = 1023 Bq/m3
my $rn = $db[3] << 2 | $db[2] >> 6;
push @event, "3:Rn:$rn";
push @event, "3:state:$rn";
} elsif ($st eq "vocSensor.01") {
# Gas Sensor, VOC Sensor (EEP A5-09-05)
# [untested]
# $db[3]_bit_7 ... $db[2]_bit_0 is the VOC concentration where 0 = 0 ppb ... 65535 = 65535 ppb
# $db[1] is the VOC identification
# $db[0]_bit_1 ... $db[0]_bit_0 is the scale multiplier
my $vocSCM = $db[0] & 3;
if ($vocSCM == 3) {
$vocSCM = 10;
} elsif ($vocSCM == 2) {
$vocSCM = 1;
} elsif ($vocSCM == 1) {
$vocSCM = 0.1;
} else {
$vocSCM = 0.01;
}
my $vocConc = sprintf "%f", ($db[3] << 8 | $db[2]) * $vocSCM;
my %vocID = (
0 => "VOCT",
1 => "Formaldehyde",
2 => "Benzene",
3 => "Styrene",
4 => "Toluene",
5 => "Tetrachloroethylene",
6 => "Xylene",
7 => "n-Hexane",
8 => "n-Octane",
9 => "Cyclopentane",
10 => "Methanol",
11 => "Ethanol",
12 => "1-Pentanol",
13 => "Acetone",
14 => "Ethylene Oxide",
15 => "Acetaldehyde ue",
16 => "Acetic Acid",
17 => "Propionice Acid",
18 => "Valeric Acid",
19 => "Butyric Acid",
20 => "Ammoniac",
22 => "Hydrogen Sulfide",
23 => "Dimethylsulfide",
24 => "2-Butanol",
25 => "2-Methylpropanol",
26 => "Diethyl Ether",
255 => "Ozone",
);
if ($vocID{$db[1]}) {
push @event, "3:vocName:$vocID{$db[1]}";
} else {
push @event, "3:vocName:unknown";
}
push @event, "3:concentration:$vocConc";
push @event, "3:state:$vocConc";
} elsif ($st eq "particlesSensor.01") {
# Gas Sensor, Particles Sensor (EEP A5-09-07)
# [untested]
# $db[3]_bit_7 ... $db[2]_bit_7 is the particle concentration < 10 <20>m
# where 0 = 0 <20>g/m3 ... 511 = 511 <20>g/m3
# $db[2]_bit_6 ... $db[1]_bit_6 is the particle concentration < 2.5 <20>m
# where 0 = 0 <20>g/m3 ... 511 = 511 <20>g/m3
# $db[1]_bit_5 ... $db[0]_bit_5 is the particle concentration < 1 <20>m
# where 0 = 0 <20>g/m3 ... 511 = 511 <20>g/m3
# $db[0]_bit_2 = 1 = Sensor PM10 active
# $db[0]_bit_1 = 1 = Sensor PM2_5 active
# $db[0]_bit_0 = 1 = Sensor PM1 active
my $pm_10 = "inactive";
my $pm_2_5 = "inactive";
my $pm_1 = "inactive";
if ($db[0] & 4) {$pm_10 = $db[3] << 1 | $db[2] >> 7;}
if ($db[0] & 2) {$pm_2_5 = ($db[2] & 0x7F) << 1 | $db[1] >> 7;}
if ($db[0] & 1) {$pm_1 = ($db[1] & 0x3F) << 3 | $db[0] >> 5;}
push @event, "3:particles_10:$pm_10";
push @event, "3:particles_2_5:$pm_2_5";
push @event, "3:particles_1:$pm_1";
push @event, "3:state:PM10: $pm_10 PM2_5: $pm_2_5 PM1: $pm_1";
} elsif ($st eq "roomSensorControl.05") {
# Room Sensor and Control Unit (EEP A5-10-01 ... A5-10-0D)
# [Eltako FTR55D, FTR55H, Thermokon SR04 *, Thanos SR *, untested]
# $db[3] is the fan speed or night reduction for Eltako
# $db[2] is the setpoint where 0x00 = min ... 0xFF = max or
# reference temperature for Eltako where 0x00 = 0<>C ... 0xFF = 40<34>C
# $db[1] is the temperature where 0x00 = +40<34>C ... 0xFF = 0<>C
# $db[0]_bit_0 is the occupy button, pushbutton or slide switch
my $temp = sprintf "%0.1f", 40 - $db[1] / 6.375;
if ($manufID eq "00D") {
my $nightReduction = 0;
$nightReduction = 1 if ($db[3] == 0x06);
$nightReduction = 2 if ($db[3] == 0x0C);
$nightReduction = 3 if ($db[3] == 0x13);
$nightReduction = 4 if ($db[3] == 0x19);
$nightReduction = 5 if ($db[3] == 0x1F);
my $setpointTemp = sprintf "%0.1f", $db[2] / 6.375;
push @event, "3:state:T: $temp SPT: $setpointTemp NR: $nightReduction";
push @event, "3:nightReduction:$nightReduction";
push @event, "3:setpointTemp:$setpointTemp";
} else {
my $fspeed = 3;
$fspeed = 2 if ($db[3] >= 145);
$fspeed = 1 if ($db[3] >= 165);
$fspeed = 0 if ($db[3] >= 190);
$fspeed = "auto" if ($db[3] >= 210);
my $switch = $db[0] & 1;
push @event, "3:state:T: $temp SP: $db[2] F: $fspeed SW: $switch";
push @event, "3:fanStage:$fspeed";
push @event, "3:switch:$switch";
push @event, "3:setpoint:$db[2]";
my $setpointScaled = EnOcean_ReadingScaled($hash, $db[2], 0, 255);
if (defined $setpointScaled) {
push @event, "3:setpointScaled:" . $setpointScaled;
}
}
push @event, "3:temperature:$temp";
} elsif ($st eq "roomSensorControl.01") {
# Room Sensor and Control Unit (EEP A5-04-01, A5-10-10 ... A5-10-14)
# [Thermokon SR04 * rH, Thanus SR *, untested]
# $db[3] is the setpoint where 0x00 = min ... 0xFF = max
# $db[2] is the humidity where 0x00 = 0%rH ... 0xFA = 100%rH
# $db[1] is the temperature where 0x00 = 0<>C ... 0xFA = +40<34>C
# $db[0] bit D0 is the occupy button, pushbutton or slide switch
my $temp = sprintf "%0.1f", $db[1] * 40 / 250;
my $humi = sprintf "%d", $db[2] / 2.5;
my $switch = $db[0] & 1;
push @event, "3:humidity:$humi";
push @event, "3:temperature:$temp";
if ($manufID eq "039") {
my $brightness = sprintf "%d", $db[3] * 117;
push @event, "3:brightness:$brightness";
push @event, "3:state:T: $temp H: $humi B: $brightness";
} else {
push @event, "3:setpoint:$db[3]";
push @event, "3:state:T: $temp H: $humi SP: $db[3] SW: $switch";
push @event, "3:switch:$switch";
my $setpointScaled = EnOcean_ReadingScaled($hash, $db[3], 0, 255);
if (defined $setpointScaled) {
push @event, "3:setpointScaled:" . $setpointScaled;
}
}
} elsif ($st eq "roomSensorControl.02") {
# Room Sensor and Control Unit (A5-10-15 ... A5-10-17)
# [untested]
# $db[2] bit D7 ... D2 is the setpoint where 0 = min ... 63 = max
# $db[2] bit D1 ... $db[1] bit D0 is the temperature where 0 = -10<31>C ... 1023 = +41.2<EFBFBD>C
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $temp = sprintf "%0.2f", -10 + ((($db[2] & 3) << 8) | $db[1]) / 19.98;
my $setpoint = ($db[2] & 0xFC) >> 2;
my $presence = $db[0] & 1 ? "absent" : "present";
push @event, "3:state:T: $temp SP: $setpoint P: $presence";
push @event, "3:presence:$presence";
push @event, "3:setpoint:$setpoint";
push @event, "3:temperature:$temp";
my $setpointScaled = EnOcean_ReadingScaled($hash, $db[2], 0, 255);
if (defined $setpointScaled) {
push @event, "3:setpointScaled:" . $setpointScaled;
}
} elsif ($st eq "roomSensorControl.18") {
# Room Sensor and Control Unit (A5-10-18)
# [untested]
# $db[3] is the illuminance where min 0x00 = 0 lx, max 0xFA = 1000 lx
# $db[2] is the setpoint where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[1] is the temperature where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[0]_bit_6 ... $db[0]_bit_4 is the fan speed
# $db[0]_bit_1 is Occupany enable where 0 = enabled, 1 = disabled
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $lux = $db[3] << 2;
if ($db[3] == 251) {$lux = "over range";}
my $setpoint = sprintf "%0.1f", 40 - $db[2] * 40 / 250;
my $temp = sprintf "%0.1f", 40 - $db[1] * 40 / 250;
my $fanSpeed;
if ((($db[0] & 0x70) >> 4) == 0) {
$fanSpeed = "auto";
} elsif ((($db[0] & 0x70) >> 4) == 7) {
$fanSpeed = "off";
} else {
$fanSpeed = (($db[0] & 0x70) >> 4) - 1;
}
my $presence;
if ($db[0] & 2) {
$presence = "disabled";
} else {
$presence = $db[0] & 1 ? "absent" : "present";
}
push @event, "3:brightness:$lux";
push @event, "3:fan:$fanSpeed";
push @event, "3:presence:$presence";
push @event, "3:setpoint:$setpoint";
push @event, "3:temperature:$temp";
push @event, "3:state:T: $temp B: $lux F: $fanSpeed SP: $setpoint P: $presence";
} elsif ($st eq "roomSensorControl.19") {
# Room Sensor and Control Unit (A5-10-19)
# [untested]
# $db[3] is the humidity where min 0x00 = 0 %rH, max 0xFA = 10 %rH
# $db[2] is the setpoint where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[1] is the temperature where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[0]_bit_6 ... $db[0]_bit_4 is the fan speed
# $db[0]_bit_1 is Occupany Button where 0 = pressed, 1 = released
# $db[0]_bit_0 is Occupany enable where 0 = enabled, 1 = disabled
my $humi = $db[3] / 2.5;
my $setpoint = sprintf "%0.1f", 40 - $db[2] * 40 / 250;
my $temp = sprintf "%0.1f", 40 - $db[1] * 40 / 250;
my $fanSpeed;
if ((($db[0] & 0x70) >> 4) == 0) {
$fanSpeed = "auto";
} elsif ((($db[0] & 0x70) >> 4) == 7) {
$fanSpeed = "off";
} else {
$fanSpeed = (($db[0] & 0x70) >> 4) - 1;
}
my $presence;
if ($db[0] & 1) {
$presence = "disabled";
} else {
$presence = $db[0] & 2 ? "absent" : "present";
}
push @event, "3:fan:$fanSpeed";
push @event, "3:humidity:$humi";
push @event, "3:presence:$presence";
push @event, "3:setpoint:$setpoint";
push @event, "3:temperature:$temp";
push @event, "3:state:T: $temp H: $humi F: $fanSpeed SP: $setpoint P: $presence";
} elsif ($st eq "roomSensorControl.1A") {
# Room Sensor and Control Unit (A5-10-1A)
# [untested]
# $db[3] is the voltage where 0x00 = 0 V ... 0xFA = 5.0 V
# $db[3] > 0xFA is error code
# $db[2] is the setpoint where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[1] is the temperature where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[0]_bit_6 ... $db[0]_bit_4 is the fan speed
# $db[0]_bit_1 is Occupany enable where 0 = enabled, 1 = disabled
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
if ($db[3] > 250) {push @event, "3:errorCode:$db[3]";}
my $setpoint = sprintf "%0.1f", 40 - $db[2] * 40 / 250;
my $temp = sprintf "%0.1f", 40 - $db[1] * 40 / 250;
my $fanSpeed;
if ((($db[0] & 0x70) >> 4) == 0) {
$fanSpeed = "auto";
} elsif ((($db[0] & 0x70) >> 4) == 7) {
$fanSpeed = "off";
} else {
$fanSpeed = (($db[0] & 0x70) >> 4) - 1;
}
my $presence;
if ($db[0] & 2) {
$presence = "disabled";
} else {
$presence = $db[0] & 1 ? "absent" : "present";
}
push @event, "3:fan:$fanSpeed";
push @event, "3:presence:$presence";
push @event, "3:setpoint:$setpoint";
push @event, "3:temperature:$temp";
push @event, "3:voltage:$voltage";
push @event, "3:state:T: $temp F: $fanSpeed SP: $setpoint P: $presence U: $voltage";
} elsif ($st eq "roomSensorControl.1B") {
# Room Sensor and Control Unit (A5-10-1B)
# [untested]
# $db[3] is the voltage where 0x00 = 0 V ... 0xFA = 5.0 V
# $db[3] > 0xFA is error code
# $db[2] is the illuminance where min 0x00 = 0 lx, max 0xFA = 1000 lx
# $db[1] is the temperature where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[0]_bit_6 ... $db[0]_bit_4 is the fan speed
# $db[0]_bit_1 is Occupany enable where 0 = enabled, 1 = disabled
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
if ($db[3] > 250) {push @event, "3:errorCode:$db[3]";}
my $lux = $db[2] << 2;
if ($db[2] == 251) {$lux = "over range";}
my $temp = sprintf "%0.1f", 40 - $db[1] * 40 / 250;
my $fanSpeed;
if ((($db[0] & 0x70) >> 4) == 0) {
$fanSpeed = "auto";
} elsif ((($db[0] & 0x70) >> 4) == 7) {
$fanSpeed = "off";
} else {
$fanSpeed = (($db[0] & 0x70) >> 4) - 1;
}
my $presence;
if ($db[0] & 2) {
$presence = "disabled";
} else {
$presence = $db[0] & 1 ? "absent" : "present";
}
push @event, "3:brightness:$lux";
push @event, "3:fan:$fanSpeed";
push @event, "3:presence:$presence";
push @event, "3:temperature:$temp";
push @event, "3:voltage:$voltage";
push @event, "3:state:T: $temp B: $lux F: $fanSpeed P: $presence U: $voltage";
} elsif ($st eq "roomSensorControl.1C") {
# Room Sensor and Control Unit (A5-10-1C)
# [untested]
# $db[3] is the illuminance where min 0x00 = 0 lx, max 0xFA = 1000 lx
# $db[2] is the illuminance setpoint where min 0x00 = 0 lx, max 0xFA = 1000 lx
# $db[1] is the temperature where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[0]_bit_6 ... $db[0]_bit_4 is the fan speed
# $db[0]_bit_1 is Occupany enable where 0 = enabled, 1 = disabled
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $lux = $db[3] << 2;
if ($db[3] == 251) {$lux = "over range";}
my $setpoint = $db[2] << 2;
my $temp = sprintf "%0.1f", 40 - $db[1] * 40 / 250;
my $fanSpeed;
if ((($db[0] & 0x70) >> 4) == 0) {
$fanSpeed = "auto";
} elsif ((($db[0] & 0x70) >> 4) == 7) {
$fanSpeed = "off";
} else {
$fanSpeed = (($db[0] & 0x70) >> 4) - 1;
}
my $presence;
if ($db[0] & 2) {
$presence = "disabled";
} else {
$presence = $db[0] & 1 ? "absent" : "present";
}
push @event, "3:brightness:$lux";
push @event, "3:fan:$fanSpeed";
push @event, "3:presence:$presence";
push @event, "3:setpoint:$setpoint";
push @event, "3:temperature:$temp";
push @event, "3:state:T: $temp B: $lux F: $fanSpeed SP: $setpoint P: $presence";
} elsif ($st eq "roomSensorControl.1D") {
# Room Sensor and Control Unit (A5-10-1D)
# [untested]
# $db[3] is the humidity where min 0x00 = 0 %rH, max 0xFA = 10 %rH
# $db[2] is the humidity setpoint where min 0x00 = 0 %rH, max 0xFA = 10 %rH
# $db[1] is the temperature where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[0]_bit_6 ... $db[0]_bit_4 is the fan speed
# $db[0]_bit_1 is Occupany enable where 0 = enabled, 1 = disabled
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $humi = $db[3] / 2.5;
my $setpoint = $db[2] / 2.5;
my $temp = sprintf "%0.1f", 40 - $db[1] * 40 / 250;
my $fanSpeed;
if ((($db[0] & 0x70) >> 4) == 0) {
$fanSpeed = "auto";
} elsif ((($db[0] & 0x70) >> 4) == 7) {
$fanSpeed = "off";
} else {
$fanSpeed = (($db[0] & 0x70) >> 4) - 1;
}
my $presence;
if ($db[0] & 2) {
$presence = "disabled";
} else {
$presence = $db[0] & 1 ? "absent" : "present";
}
push @event, "3:fan:$fanSpeed";
push @event, "3:humidity:$humi";
push @event, "3:presence:$presence";
push @event, "3:setpoint:$setpoint";
push @event, "3:temperature:$temp";
push @event, "3:state:T: $temp H: $humi F: $fanSpeed SP: $setpoint P: $presence";
} elsif ($st eq "roomSensorControl.1F") {
# Room Sensor and Control Unit (A5-10-1F)
# [untested]
# $db[3] is the fan speed
# $db[2] is the setpoint where 0 = 0 ... 255 = 255
# $db[1] is the temperature where 250 = 0 <20>C ... 0 = 40 <20>C
# $db[0]_bit_6 ... $db[0]_bit_4 is the fan speed
# $db[0]_bit_6 ... $db[0]_bit_4 are flags
# $db[0]_bit_1 is Occupany enable where 0 = enabled, 1 = disabled
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $fanSpeed = "unknown";
if ($db[0] & 0x10) {
$fanSpeed = 3;
$fanSpeed = 2 if ($db[3] >= 145);
$fanSpeed = 1 if ($db[3] >= 165);
$fanSpeed = 0 if ($db[3] >= 190);
$fanSpeed = "auto" if ($db[3] >= 210);
}
my $setpoint = "unknown";
$setpoint = $db[2] if ($db[0] & 0x20);
my $temp = "unknown";
$temp = sprintf "%0.1f", 40 - $db[1] * 40 / 250 if ($db[0] & 0x40);
my $presence = "unknown";
$presence = "absent" if (!($db[0] & 2));
$presence = "present" if (!($db[0] & 1));
push @event, "3:fan:$fanSpeed";
push @event, "3:presence:$presence";
push @event, "3:setpoint:$setpoint";
push @event, "3:temperature:$temp";
push @event, "3:state:T: $temp F: $fanSpeed SP: $setpoint P: $presence";
my $setpointScaled = EnOcean_ReadingScaled($hash, $db[2], 0, 255);
if (defined $setpointScaled) {
push @event, "3:setpointScaled:" . $setpointScaled;
}
} elsif ($st eq "tempHumiSensor.02") {
# Temperatur and Humidity Sensor(EEP A5-04-02)
# [Eltako FAFT60, FIFT63AP]
# $db[3] is the voltage where 0x59 = 2.5V ... 0x9B = 4V, only at Eltako
# $db[2] is the humidity where 0x00 = 0%rH ... 0xFA = 100%rH
# $db[1] is the temperature where 0x00 = -20<32>C ... 0xFA = +60<36>C
my $humi = sprintf "%d", $db[2] / 2.5;
my $temp = sprintf "%0.1f", -20 + $db[1] * 80 / 250;
my $battery = "unknown";
if ($manufID eq "00D") {
# Eltako sensor
my $voltage = sprintf "%0.1f", $db[3] * 6.58 / 255;
my $energyStorage = "unknown";
if ($db[3] <= 0x58) {
$energyStorage = "empty";
$battery = "low";
}
elsif ($db[3] <= 0xDC) {
$energyStorage = "charged";
$battery = "ok";
}
else {
$energyStorage = "full";
$battery = "ok";
}
push @event, "3:battery:$battery";
push @event, "3:energyStorage:$energyStorage";
push @event, "3:voltage:$voltage";
}
push @event, "3:state:T: $temp H: $humi B: $battery";
push @event, "3:humidity:$humi";
push @event, "3:temperature:$temp";
} elsif ($st eq "lightSensor.01") {
# Light Sensor (EEP A5-06-01)
# [Eltako FAH60, FAH63, FIH63, Thermokon SR65 LI, untested]
# $db[3] is the voltage where 0x00 = 0 V ... 0xFF = 5.1 V
# $db[3] is the low illuminance for Eltako devices where
# min 0x00 = 0 lx, max 0xFF = 100 lx, if $db[2] = 0
# $db[2] is the illuminance (ILL2) where min 0x00 = 300 lx, max 0xFF = 30000 lx
# $db[1] is the illuminance (ILL1) where min 0x00 = 600 lx, max 0xFF = 60000 lx
# $db[0]_bit_0 is Range select where 0 = ILL1, 1 = ILL2
my $lux;
my $voltage = "unknown";
if ($manufID eq "00D") {
if($db[2] == 0) {
$lux = sprintf "%d", $db[3] * 100 / 255;
} else {
$lux = sprintf "%d", $db[2] * 116.48 + 300;
}
} else {
$voltage = sprintf "%0.1f", $db[3] * 0.02;
if($db[0] & 1) {
$lux = sprintf "%d", $db[2] * 116.48 + 300;
} else {
$lux = sprintf "%d", $db[1] * 232.94 + 600;
}
push @event, "3:voltage:$voltage";
}
push @event, "3:brightness:$lux";
push @event, "3:state:$lux";
} elsif ($st eq "lightSensor.02") {
# Light Sensor (EEP A5-06-02)
# $db[3] is the voltage where 0x00 = 0 V ... 0xFF = 5.1 V
# $db[2] is the illuminance (ILL2) where min 0x00 = 0 lx, max 0xFF = 510 lx
# $db[1] is the illuminance (ILL1) where min 0x00 = 0 lx, max 0xFF = 1020 lx
# $db[0]_bit_0 is Range select where 0 = ILL1, 1 = ILL2
my $lux;
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
if($db[0] & 1) {
$lux = $db[2] << 1;
} else {
$lux = $db[1] << 2;
}
push @event, "3:voltage:$voltage";
push @event, "3:brightness:$lux";
push @event, "3:state:$lux";
} elsif ($st eq "lightSensor.03") {
# Light Sensor (EEP A5-06-03)
# $db[3] is the voltage where 0x00 = 0 V ... 0xFA = 5.0 V
# $db[3] > 0xFA is error code
# $db[2]_bit_7 ... $db[1]_bit_6 is the illuminance where min 0x000 = 0 lx, max 0x3E8 = 1000 lx
my $lux = $db[2] << 2 | $db[1] >> 6;
if ($lux == 1001) {$lux = "over range";}
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
if ($db[3] > 250) {push @event, "3:errorCode:$db[3]";}
push @event, "3:voltage:$voltage";
push @event, "3:brightness:$lux";
push @event, "3:state:$lux";
} elsif ($st eq "occupSensor.01") {
# Occupancy Sensor (EEP A5-07-01)
# $db[3] is the voltage where 0x00 = 0 V ... 0xFA = 5.0 V
# $db[3] > 0xFA is error code
# $db[1] is PIR Status (motion) where 0 ... 127 = off, 128 ... 255 = on
my $motion = "off";
if ($db[1] >= 128) {$motion = "on";}
if ($db[0] & 1) {push @event, "3:voltage:" . sprintf "%0.1f", $db[3] * 0.02;}
if ($db[3] > 250) {push @event, "3:errorCode:$db[3]";}
push @event, "3:motion:$motion";
push @event, "3:state:$motion";
} elsif ($st eq "occupSensor.02") {
# Occupancy Sensor (EEP A5-07-02)
# $db[3] is the voltage where 0x00 = 0 V ... 0xFA = 5.0 V
# $db[3] > 0xFA is error code
# $db[0]_bit_7 is PIR Status (motion) where 0 = off, 1 = on
my $motion = $db[0] >> 7 ? "on" : "off";
if ($db[3] > 250) {push @event, "3:errorCode:$db[3]";}
push @event, "3:motion:$motion";
push @event, "3:voltage:" . sprintf "%0.1f", $db[3] * 0.02;
push @event, "3:state:$motion";
} elsif ($st eq "occupSensor.03") {
# Occupancy Sensor (EEP A5-07-03)
# $db[3] is the voltage where 0x00 = 0 V ... 0xFA = 5.0 V
# $db[3] > 0xFA is error code
# $db[2]_bit_7 ... $db[1]_bit_6 is the illuminance where min 0x000 = 0 lx, max 0x3E8 = 1000 lx
# $db[0]_bit_7 is PIR Status (motion) where 0 = off, 1 = on
my $motion = $db[0] >> 7 ? "on" : "off";
my $lux = $db[2] << 2 | $db[1] >> 6;
if ($lux == 1001) {$lux = "over range";}
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
if ($db[3] > 250) {push @event, "3:errorCode:$db[3]";}
push @event, "3:brightness:$lux";
push @event, "3:motion:$motion";
push @event, "3:voltage:$voltage";
push @event, "3:state:M: $motion E: $lux U: $voltage";
} elsif ($st =~ m/^lightTempOccupSensor/) {
# Light, Temperatur and Occupancy Sensor (EEP A5-08-01 ... A5-08-03)
# $db[3] is the voltage where 0x00 = 0 V ... 0xFF = 5.1 V
# $db[2] is the illuminance where min 0x00 = 0 lx, max 0xFF = 510 lx, 1020 lx, (2048 lx)
# $db[1] is the temperature whrere 0x00 = 0 <20>C ... 0xFF = 51 <20>C or -30 <20>C ... 50<35>C
# $db[0]_bit_1 is PIR Status (motion) where 0 = on, 1 = off
# $db[0]_bit_0 is Occupany Button where 0 = pressed, 1 = released
my $lux;
my $temp;
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
my $motion = $db[0] & 2 ? "off" : "on";
my $presence = $db[0] & 1 ? "absent" : "present";
if ($st eq "lightTempOccupSensor.01") {
# Light, Temperatur and Occupancy Sensor (EEP A5-08-01)
# [Eltako FABH63, FBH55, FBH63, FIBH63]
if ($manufID eq "00D") {
$lux = sprintf "%d", $db[2] * 2048 / 255;
push @event, "3:state:M: $motion E: $lux";
} else {
$lux = $db[2] << 1;
$temp = sprintf "%0.1f", $db[1] * 0.2;
push @event, "3:state:M: $motion E: $lux P: $presence T: $temp U: $voltage";
push @event, "3:presence:$presence";
push @event, "3:temperature:$temp";
push @event, "3:voltage:$voltage";
}
} elsif ($st eq "lightTempOccupSensor.02") {
# Light, Temperatur and Occupancy Sensor (EEP A5-08-02)
$lux = $db[2] << 2;
$temp = sprintf "%0.1f", $db[1] * 0.2;
push @event, "3:state:M: $motion E: $lux P: $presence T: $temp U: $voltage";
push @event, "3:presence:$presence";
push @event, "3:temperature:$temp";
push @event, "3:voltage:$voltage";
} elsif ($st eq "lightTempOccupSensor.03") {
# Light, Temperatur and Occupancy Sensor (EEP A5-08-03)
$lux = $db[2] * 6;
$temp = sprintf "%0.1f", -30 + $db[1] * 80 / 255;
push @event, "3:state:M: $motion E: $lux P: $presence T: $temp U: $voltage";
push @event, "3:presence:$presence";
push @event, "3:temperature:$temp";
push @event, "3:voltage:$voltage";
}
push @event, "3:brightness:$lux";
push @event, "3:motion:$motion";
} elsif ($st eq "lightCtrlState.01") {
# Lighting Controller State (EEP A5-11-01)
# $db[3] is the illumination where 0x00 = 0 lx ... 0xFF = 510 lx
# $db[2] is the illumination Setpoint where 0x00 = 0 ... 0xFF = 255
# $db[1] is the Dimming Output Level where 0x00 = 0 ... 0xFF = 255
# $db[0]_bit_7 is the Repeater state where 0 = disabled, 1 = enabled
# $db[0]_bit_6 is the Power Relay Timer state where 0 = disabled, 1 = enabled
# $db[0]_bit_5 is the Daylight Harvesting state where 0 = disabled, 1 = enabled
# $db[0]_bit_4 is the Dimming mode where 0 = switching, 1 = dimming
# $db[0]_bit_2 is the Magnet Contact state where 0 = open, 1 = closed
# $db[0]_bit_1 is the Occupancy (prensence) state where 0 = absent, 1 = present
# $db[0]_bit_0 is the Power Relay state where 0 = off, 1 = on
push @event, "3:brightness:" . ($db[3] << 1);
push @event, "3:illum:$db[2]";
push @event, "3:dim:$db[1]";
push @event, "3:powerRelayTimer:" . ($db[0] & 0x80 ? "enabled" : "disabled");
push @event, "3:repeater:" . ($db[0] & 0x40 ? "enabled" : "disabled");
push @event, "3:daylightHarvesting:" . ($db[0] & 0x20 ? "enabled" : "disabled");
push @event, "3:mode:" . ($db[0] & 0x10 ? "dimming" : "switching");
push @event, "3:contact:" . ($db[0] & 4 ? "closed" : "open");
push @event, "3:presence:" . ($db[0] & 2 ? "present" : "absent");
push @event, "3:powerSwitch:" . ($db[0] & 1 ? "on" : "off");
push @event, "3:state:" . ($db[0] & 1 ? "on" : "off");
} elsif ($st eq "tempCtrlState.01") {
# Temperature Controller Output (EEP A5-11-02)
# $db[3] is the Control Variable where 0x00 = 0 % ... 0xFF = 100 %
# $db[2] is the Fan Stage
# $db[1] is the Actual Setpoint where 0x00 = 0 <20>C ... 0xFF = 51.2 <20>C
# $db[0]_bit_7 is the Alarm state where 0 = no, 1 = yes
# $db[0]_bit_6 ... $db[0]_bit_5 is the Controller Mode
# $db[0]_bit_4 is the Controller State where 0 = auto, 1 = override
# $db[0]_bit_2 is the Energy hold-off where 0 = normal, 1 = hold-off
# $db[0]_bit_1 ... $db[0]_bit_0is the Occupancy (prensence) state where 0 = present
# 1 = absent, 3 = standby, 4 = frost
push @event, "3:controlVar:" . sprintf "%d", $db[3] * 100 / 255;
if (($db[2] & 3) == 0) {
push @event, "3:fan:0";
} elsif (($db[2] & 3) == 1){
push @event, "3:fan:1";
} elsif (($db[2] & 3) == 2){
push @event, "3:fan:2";
} elsif (($db[2] & 3) == 3){
push @event, "3:fan:3";
} elsif ($db[2] == 255){
push @event, "3:fan:unknown";
}
push @event, "3:fanMode:" . ($db[2] & 0x10 ? "auto" : "manual");
my $setpointTemp = sprintf "%0.1f", $db[1] * 0.2;
push @event, "3:setpointTemp:$setpointTemp";
push @event, "3:alarm:" . ($db[0] & 1 ? "on" : "off");
my $controllerMode = ($db[0] & 0x60) >> 5;
if ($controllerMode == 0) {
push @event, "3:controllerMode:auto";
} elsif ($controllerMode == 1) {
push @event, "3:controllerMode:heating";
} elsif ($controllerMode == 2) {
push @event, "3:controllerMode:cooling";
} elsif ($controllerMode == 3) {
push @event, "3:controllerMode:off";
}
push @event, "3:controllerState:" . ($db[0] & 0x10 ? "override" : "auto");
push @event, "3:energyHoldOff:" . ($db[0] & 4 ? "holdoff" : "normal");
if (($db[0] & 3) == 0) {
push @event, "3:presence:present";
} elsif (($db[0] & 3) == 1){
push @event, "3:presence:absent";
} elsif (($db[0] & 3) == 2){
push @event, "3:presence:standby";
} elsif (($db[0] & 3) == 3){
push @event, "3:presence:frost";
}
push @event, "3:state:$setpointTemp";
} elsif ($st eq "shutterCtrlState.01") {
# Blind Status (EEP A5-11-03)
# $db[3] is the Shutter Position where 0 = 0 % ... 100 = 100 %
# $db[2]_bit_7 is the Angle sign where 0 = positive, 1 = negative
# $db[2]_bit_6 ... $db[2]_bit_0 where 0 = 0<> ... 90 = 180<38>
# $db[1]_bit_7 is the Positon Value Flag where 0 = no available, 1 = available
# $db[1]_bit_6 is the Angle Value Flag where 0 = no available, 1 = available
# $db[1]_bit_5 ... $db[1]_bit_4 is the Error State (alarm)
# $db[1]_bit_3 ... $db[1]_bit_2 is the End-position State
# $db[1]_bit_1 ... $db[1]_bit_0 is the Shutter State
# $db[0]_bit_7 is the Service Mode where 0 = no, 1 = yes
# $db[0]_bit_6 is the Position Mode where 0 = normal, 1 = inverse
push @event, "3:positon:" . $db[3];
my $anglePos = ($db[2] & 0x7F) << 1;
if ($db[2] & 80) {$anglePos *= -1;}
push @event, "3:anglePos:" . $anglePos;
my $alarm = ($db[1] & 0x30) >> 4;
if ($alarm == 0) {
push @event, "3:alarm:off";
} elsif ($alarm == 1){
push @event, "3:alarm:no endpoints defined";
} elsif ($alarm == 2){
push @event, "3:alarm:on";
} elsif ($alarm == 3){
push @event, "3:alarm:not used";
}
my $endPosition = ($db[1] & 0x0C) >> 2;
if ($endPosition == 0) {
push @event, "3:endPosition:not_available";
push @event, "3:state:not_available";
} elsif ($endPosition == 1) {
push @event, "3:endPosition:not_reached";
push @event, "3:state:not_reached";
} elsif ($endPosition == 2) {
push @event, "3:endPosition:open";
push @event, "3:state:open";
} elsif ($endPosition == 3){
push @event, "3:endPosition:closed";
push @event, "3:state:closed";
}
my $shutterState = $db[1] & 3;
if (($db[1] & 3) == 0) {
push @event, "3:shutterState:not_available";
} elsif (($db[1] & 3) == 1) {
push @event, "3:shutterState:stopped";
} elsif (($db[1] & 3) == 2){
push @event, "3:shutterState:opens";
} elsif (($db[1] & 3) == 3){
push @event, "3:shutterState:closes";
}
push @event, "3:serviceOn:" . ($db[2] & 0x80 ? "yes" : "no");
push @event, "3:positionMode:" . ($db[2] & 0x40 ? "inverse" : "normal");
} elsif ($st eq "lightCtrlState.02") {
# Extended Lighting Status (EEP A5-11-04)
# $db[3] the contents of the variable depends on the parameter mode
# $db[2] the contents of the variable depends on the parameter mode
# $db[1] the contents of the variable depends on the parameter mode
# $db[0]_bit_7 is the Service Mode where 0 = no, 1 = yes
# $db[0]_bit_6 is the operating hours flag where 0 = not_available, 1 = available
# $db[0]_bit_5 ... $db[0]_bit_4 is the Error State (alarm)
# $db[0]_bit_2 ... $db[0]_bit_1 is the parameter mode
# $db[0]_bit_0 is the lighting status where 0 = off, 1 = on
push @event, "3:serviceOn:" . ($db[1] & 0x80 ? "yes" : "no");
my $alarm = ($db[0] & 0x30) >> 4;
if ($alarm == 0) {
push @event, "3:alarm:off";
} elsif ($alarm == 1){
push @event, "3:alarm:lamp failure";
} elsif ($alarm == 2){
push @event, "3:alarm:internal failure";
} elsif ($alarm == 3){
push @event, "3:alarm:external periphery failure";
}
my $mode = ($db[0] & 6) >> 1;
if ($mode == 0) {
# dimmer value and lamp operating hours
push @event, "3:dim:$db[3]";
if ($db[0] & 40) {
push @event, "3:lampOpHours:" . ($db[2] << 8 | $db[1]);
} else {
push @event, "3:lampOpHours:unknown";
}
} elsif ($mode == 1){
# RGB value
push @event, "3:RGB:$db[3] $db[2] $db[1]";
} elsif ($mode == 2){
# energy metering value
my @measureUnit = ("mW", "W", "kW", "MW", "Wh", "kWh", "MWh", "GWh",
"mA", "1/10 A", "mV", "1/10 V");
push @event, "3:measuredValue:" . ($db[3] << 8 | $db[2]);
if (defined $measureUnit[$db[1]]) {
push @event, "3:measureUnit:" . $measureUnit[$db[1]];
} else {
push @event, "3:measureUnit:unknown";
}
} elsif ($mode == 3){
# not used
}
push @event, "3:powerSwitch:" . ($db[0] & 1 ? "on" : "off");
push @event, "3:state:" . ($db[0] & 1 ? "on" : "off");
} elsif ($st =~ m/^autoMeterReading/) {
# Automated meter reading (AMR) (EEP A5-12-00 ... A5-12-03)
# $db[3] (MSB) + $db[2] + $db[1] (LSB) is the Meter reading
# $db[0]_bit_7 ... $db[0]_bit_4 is the Measurement channel
# $db[0]_bit_2 is the Data type where 0 = cumulative value, 1 = current value
# $db[0]_bit_1 ... $db[0]_bit_0 is the Divisor where 0 = x/1, 1 = x/10,
# 2 = x/100, 3 = x/1000
my $dataType = ($db[0] & 4) >> 2;
my $divisor = $db[0] & 3;
if ($divisor == 3) {
$divisor = 1000;
} elsif ($divisor == 2) {
$divisor = 100;
} elsif ($divisor == 1) {
$divisor = 10;
} else {
$divisor = 1;
}
my $meterReading = sprintf "%0.1f", ($db[3] << 16 | $db[2] << 8 | $db[1]) / $divisor;
my $channel = $db[0] >> 4;
if ($st eq "autoMeterReading.00") {
# Automated meter reading (AMR), Counter (EEP A5-12-01)
# [Thermokon SR-MI-HS, untested]
if ($dataType == 1) {
# current value
push @event, "3:currentValue:$meterReading";
push @event, "3:state:$meterReading";
} else {
# cumulative counter
push @event, "3:counter$channel:$meterReading";
}
} elsif ($st eq "autoMeterReading.01") {
# Automated meter reading (AMR), Electricity (EEP A5-12-01)
# [Eltako FSS12, FWZ12, DSZ14DRS, DSZ14WDRS, DWZ61]
# $db[0]_bit_7 ... $db[0]_bit_4 is the Tariff info
# $db[0]_bit_2 is the Data type where 0 = cumulative value kWh,
# 1 = current value W
if ($dataType == 1) {
# momentary power
push @event, "3:power:$meterReading";
push @event, "3:state:$meterReading";
} elsif ($db[0] == 0x8F && $manufID eq "00D") {
# Eltako, read meter serial number
my $serialNumber;
if ($db[0] == 0) {
# first 2 digits of the serial number
$serialNumber = printf "S-%01x%01x", $db[3] >> 4, $db[3] & 0x0F;
} else {
# last 4 digits of the serial number
$serialNumber = substr(ReadingsVal($name, "serialNumber", "S---"), 0, 4);
$serialNumber = printf "%4c%01x%01x%01x%01x", $serialNumber,
$db[2] >> 4, $db[2] & 0x0F, $db[3] >> 4, $db[3] & 0x0F;
}
push @event, "3:serialNumber:$serialNumber";
} else {
# power consumption
push @event, "3:energy$channel:$meterReading";
push @event, "3:currentTariff:$channel";
}
} elsif ($st eq "autoMeterReading.02" | $st eq "autoMeterReading.03") {
# Automated meter reading (AMR), Gas, Water (EEP A5-12-02, A5-12-03)
if ($dataType == 1) {
# current value
push @event, "3:flowrate:$meterReading";
push @event, "3:state:$meterReading";
} else {
# cumulative counter
push @event, "3:consumption$channel:$meterReading";
push @event, "3:currentTariff:$channel";
}
}
} elsif ($st eq "environmentApp") {
# Environmental Applications (EEP A5-13-01 ... EEP A5-13-06, EEP A5-13-10)
# [Eltako FWS61, untested]
# $db[0]_bit_7 ... $db[0]_bit_4 is the Identifier
my $identifier = $db[0] >> 4;
if ($identifier == 1) {
# Weather Station (EEP A5-13-01)
# $db[3] is the dawn sensor where 0x00 = 0 lx ... 0xFF = 999 lx
# $db[2] is the temperature where 0x00 = -40 <20>C ... 0xFF = 80 <20>C
# $db[1] is the wind speed where 0x00 = 0 m/s ... 0xFF = 70 m/s
# $db[0]_bit_2 is day / night where 0 = day, 1 = night
# $db[0]_bit_1 is rain indication where 0 = no (no rain), 1 = yes (rain)
my $dawn = sprintf "%d", $db[3] * 999 / 255;
my $temp = sprintf "%0.1f", -40 + $db[2] * 120 / 255;
my $windSpeed = sprintf "%0.1f", $db[1] * 70 / 255;
my $dayNight = $db[0] & 2 ? "night" : "day";
my $isRaining = $db[0] & 1 ? "yes" : "no";
push @event, "3:brightness:$dawn";
push @event, "3:dayNight:$dayNight";
push @event, "3:isRaining:$isRaining";
push @event, "3:temperature:$temp";
push @event, "3:windSpeed:$windSpeed";
push @event, "3:state:T: $temp B: $dawn W: $windSpeed IR: $isRaining";
} elsif ($identifier == 2) {
# Sun Intensity (EEP A5-13-02)
# $db[3] is the sun exposure west where 0x00 = 1 lx ... 0xFF = 150 klx
# $db[2] is the sun exposure south where 0x00 = 1 lx ... 0xFF = 150 klx
# $db[1] is the sun exposure east where 0x00 = 1 lx ... 0xFF = 150 klx
# $db[0]_bit_2 is hemisphere where 0 = north, 1 = south
push @event, "3:hemisphere:" . ($db[0] & 4 ? "south" : "north");
push @event, "3:sunWest:" . sprintf "%d", 1 + $db[3] * 149999 / 255;
push @event, "3:sunSouth:" . sprintf "%d", 1 + $db[2] * 149999 / 255;
push @event, "3:sunEast:" . sprintf "%d", 1 + $db[1] * 149999 / 255;
} elsif ($identifier == 7) {
# Sun Position and Radiation (EEP A5-13-10)
# $db[3]_bit_7 ... $db[3]_bit_1 is Sun Elevation where 0 = 0 <20> ... 90 = 90 <20>
# $db[3]_bit_0 is day / night where 0 = day, 1 = night
# $db[2] is Sun Azimuth where 0 = -90 <20> ... 180 = 90 <20>
# $db[1] and $db[0]_bit_2 ... $db[0]_bit_0 is Solar Radiation where
# 0 = 0 W/m2 ... 2000 = 2000 W/m2
my $sunElev = $db[3] >> 1;
my $sunAzim = $db[2] - 90;
my $solarRad = $db[1] << 3 | $db[0] & 7;
push @event, "3:dayNight:" . ($db[3] & 1 ? "night" : "day");
push @event, "3:solarRadiation:$solarRad";
push @event, "3:sunAzimuth:$sunAzim";
push @event, "3:sunElevation:$sunElev";
push @event, "3:state:SRA: $solarRad SNA: $sunAzim SNE: $sunElev";
} else {
# EEP A5-13-03 ... EEP A5-13-06 not implemented
}
} elsif ($st eq "multiFuncSensor") {
# Multi-Func Sensor (EEP A5-14-01 ... A5-14-06)
# $db[3] is the voltage where 0x00 = 0 V ... 0xFA = 5.0 V
# $db[3] > 0xFA is error code
# $db[2] is the illuminance where min 0x00 = 0 lx, max 0xFA = 1000 lx
# $db[0]_bit_1 is Vibration where 0 = off, 1 = on
# $db[0]_bit_0 is Contact where 0 = closed, 1 = open
my $lux = $db[2] << 2;
if ($db[2] == 251) {$lux = "over range";}
my $voltage = sprintf "%0.1f", $db[3] * 0.02;
if ($db[3] > 250) {push @event, "3:errorCode:$db[3]";}
my $vibration = $db[0] & 2 ? "on" : "off";
my $contact = $db[0] & 1 ? "open" : "closed";
push @event, "3:brightness:$lux";
push @event, "3:contact:$contact";
push @event, "3:vibration:$vibration";
push @event, "3:voltage:$voltage";
push @event, "3:state:C: $contact V: $vibration E: $lux U: $voltage";
} elsif ($st =~ m/^digitalInput/) {
# Digital Input (EEP A5-30-01, A5-30-02)
my $contact;
if ($st eq "digtalInput.01") {
# Single Input Contact, Batterie Monitor (EEP A5-30-01)
# [Thermokon SR65 DI, untested]
# $db[2] is the supply voltage, if >= 121 = battery ok
# $db[1] is the input state, if <= 195 = contact closed
my $battery = $db[2] >= 121 ? "ok" : "low";
$contact = $db[1] <= 195 ? "closed" : "open";
push @event, "3:battery:$battery";
} else {
# Single Input Contact (EEP A5-30-01)
# $db[0]_bit_0 is the input state where 0 = closed, 1 = open
$contact = $db[0] & 1 ? "open" : "closed";
}
push @event, "3:contact:$contact";
push @event, "3:state:$contact";
} elsif ($st eq "gateway") {
# Gateway (EEP A5-38-08)
# $db[3] is the command ID ($gwCmdID)
# Eltako devices not send teach-in telegrams
if(($db[0] & 8) == 0) {
# teach-in, identify and store command type in attr gwCmd
my $gwCmd = AttrVal($name, "gwCmd", undef);
if (!$gwCmd) {
$gwCmd = $EnO_gwCmd[$db[3] - 1];
$attr{$name}{gwCmd} = $gwCmd;
}
}
if ($db[3] == 1) {
# Switching
# Eltako devices not send A5 telegrams
push @event, "3:executeTime:" . sprintf "%0.1f", (($db[2] << 8) | $db[1]) / 10;
push @event, "3:lock:" . ($db[0] & 4 ? "lock" : "unlock");
push @event, "3:executeType" . ($db[0] & 2 ? "delay" : "duration");
push @event, "3:state:" . ($db[0] & 1 ? "on" : "off");
} elsif ($db[3] == 2) {
# Dimming
# $db[0]_bit_2 is store final value, not used, because
# dimming value is always stored
push @event, "3:rampTime:$db[1]";
push @event, "3:state:" . ($db[0] & 0x01 ? "on" : "off");
if ($db[0] & 4) {
# Relative Dimming Range
push @event, "3:dim:" . sprintf "%d", $db[2] * 100 / 255;
} else {
push @event, "3:dim:$db[2]";
}
push @event, "3:dimValueLast:$db[2]" if ($db[2] > 0);
} elsif ($db[3] == 3) {
# Setpoint shift
# $db1 is setpoint shift where 0 = -12.7 K ... 255 = 12.8 K
my $setpointShift = sprintf "%0.1f", -12.7 + $db[1] / 10;
push @event, "3:setpointShift:$setpointShift";
push @event, "3:state:$setpointShift";
} elsif ($db[3] == 4) {
# Basic Setpoint
# $db1 is setpoint where 0 = 0 <20>C ... 255 = 51.2 <20>C
my $setpoint = sprintf "%0.1f", $db[1] / 5;
push @event, "3:setpoint:$setpoint";
push @event, "3:state:$setpoint";
} elsif ($db[3] == 5) {
# Control variable
# $db1 is control variable override where 0 = 0 % ... 255 = 100 %
push @event, "3:controlVar:" . sprintf "%d", $db[1] * 100 / 255;
my $controllerMode = ($db[0] & 0x60) >> 5;
if ($controllerMode == 0) {
push @event, "3:controllerMode:auto";
push @event, "3:state:auto";
} elsif ($controllerMode == 1) {
push @event, "3:controllerMode:heating";
push @event, "3:state:heating";
} elsif ($controllerMode == 2){
push @event, "3:controllerMode:cooling";
push @event, "3:state:cooling";
} elsif ($controllerMode == 3){
push @event, "3:controllerMode:off";
push @event, "3:state:off";
}
push @event, "3:controllerState:" . ($db[0] & 0x10 ? "override" : "auto");
push @event, "3:energyHoldOff:" . ($db[0] & 4 ? "holdoff" : "normal");
my $occupancy = $db[0] & 3;
if ($occupancy == 0) {
push @event, "3:presence:present";
} elsif ($occupancy == 1){
push @event, "3:presence:absent";
} elsif ($occupancy == 2){
push @event, "3:presence:standby";
}
} elsif ($db[3] == 6) {
# Fan stage
if ($db[1] == 0) {
push @event, "3:fan:0";
push @event, "3:state:0";
} elsif ($db[1] == 1) {
push @event, "3:fan:1";
push @event, "3:state:1";
} elsif ($db[1] == 2) {
push @event, "3:fan:2";
push @event, "3:state:2";
} elsif ($db[1] == 3) {
push @event, "3:fan:3";
push @event, "3:state:3";
} elsif ($db[1] == 255) {
push @event, "3:fan:auto";
push @event, "3:state:auto";
}
} else {
push @event, "3:state:Gateway Command ID $db[3] unknown.";
}
} elsif ($st eq "manufProfile") {
# Manufacturer Specific Applications (EEP A5-3F-7F)
if ($manufID eq "002") {
# [Thermokon SR65 3AI, untested]
# $db[3] is the input 3 where 0x00 = 0 V ... 0xFF = 10 V
# $db[2] is the input 2 where 0x00 = 0 V ... 0xFF = 10 V
# $db[1] is the input 1 where 0x00 = 0 V ... 0xFF = 10 V
my $input3 = sprintf "%0.2f", $db[3] * 10 / 255;
my $input2 = sprintf "%0.2f", $db[2] * 10 / 255;
my $input1 = sprintf "%0.2f", $db[1] * 10 / 255;
push @event, "3:input1:$input1";
push @event, "3:input2:$input2";
push @event, "3:input3:$input3";
push @event, "3:state:I1: $input1 I2: $input2 I3: $input3";
} elsif ($manufID eq "00D") {
# [Eltako shutters, untested]
my $angleMax = AttrVal($name, "angleMax", 90);
my $angleMin = AttrVal($name, "angleMin", -90);
my $anglePos = ReadingsVal($name, ".anglePosStart", undef);
my $angleTime = AttrVal($name, "angleTime", 0);
my $position = ReadingsVal($name, ".positionStart", undef);
my $shutTime = AttrVal($name, "shutTime", 255);
my $shutTimeStop = ($db[3] << 8 | $db[2]) * 0.1;
my $state;
$angleMax = 90 if ($angleMax !~ m/^[+-]?\d+$/);
$angleMax = 180 if ($angleMax > 180);
$angleMax = -180 if ($angleMax < -180);
$angleMin = -90 if ($angleMin !~ m/^[+-]?\d+$/);
$angleMin = 180 if ($angleMin > 180);
$angleMin = -180 if ($angleMin < -180);
($angleMax, $angleMin) = ($angleMin, $angleMax) if ($angleMin > $angleMax);
$angleMax ++ if ($angleMin == $angleMax);
$angleTime = 6 if ($angleTime !~ m/^[+-]?\d+$/);
$angleTime = 6 if ($angleTime > 6);
$angleTime = 0 if ($angleTime < 0);
$shutTime = 255 if ($shutTime !~ m/^[+-]?\d+$/);
$shutTime = 255 if ($shutTime > 255);
$shutTime = 1 if ($shutTime < 1);
if ($db[0] == 0x0A) {
push @event, "3:block:unlock";
} elsif ($db[0] == 0x0E) {
push @event, "3:block:lock";
}
if (defined $position) {
if ($db[1] == 1) {
# up
$position -= $shutTimeStop / $shutTime * 100;
if ($angleTime) {
$anglePos -= ($angleMax - $angleMin) * $shutTimeStop / $angleTime;
if ($anglePos < $angleMin) {
$anglePos = $angleMin;
}
} else {
$anglePos = $angleMin;
}
if ($position <= 0) {
$anglePos = 0;
$position = 0;
push @event, "3:endPosition:open";
$state = "open";
} else {
push @event, "3:endPosition:not_reached";
$state = "stop";
}
push @event, "3:anglePos:" . sprintf("%d", $anglePos);
push @event, "3:position:" . sprintf("%d", $position);
} elsif ($db[1] == 2) {
# down
$position += $shutTimeStop / $shutTime * 100;
if ($angleTime) {
$anglePos += ($angleMax - $angleMin) * $shutTimeStop / $angleTime;
if ($anglePos > $angleMax) {
$anglePos = $angleMax;
}
} else {
$anglePos = $angleMax;
}
if($position > 100) {
$anglePos = $angleMax;
$position = 100;
push @event, "3:endPosition:closed";
$state = "closed";
} else {
push @event, "3:endPosition:not_reached";
$state = "stop";
}
push @event, "3:anglePos:" . sprintf("%d", $anglePos);
push @event, "3:position:" . sprintf("%d", $position);
} else {
$state = "not_reached";
}
push @event, "3:state:$state";
}
} else {
# Unknown Application
push @event, "3:state:Manufacturer Specific Application unknown";
}
} elsif ($st eq "raw") {
# raw
push @event, "3:state:RORG: $rorg DATA: $data STATUS: $status ODATA: $odata";
} else {
# unknown devices
push @event, "3:state:$db[3]";
push @event, "3:sensor1:$db[3]";
push @event, "3:sensor2:$db[2]";
push @event, "3:sensor3:$db[1]";
push @event, "3:D3:".(($db[0] & 8) ? 1:0);
push @event, "3:D2:".(($db[0] & 4) ? 1:0);
push @event, "3:D1:".(($db[0] & 2) ? 1:0);
push @event, "3:D0:".(($db[0] & 1) ? 1:0);
}
} elsif ($rorg eq "D1") {
# MSC telegram
if ($st eq "test") {
} elsif ($st eq "raw") {
# raw
push @event, "3:state:RORG: $rorg DATA: $data STATUS: $status ODATA: $odata";
push @event, "3:manufID:" . substr($data, 0, 3);
# display data bytes $db[0] ... $db[x]
for (my $dbCntr = 0; $dbCntr <= $#db; $dbCntr++) {
push @event, "3:DB_" . $dbCntr . ":" . $db[$dbCntr];
}
} else {
# unknown devices
push @event, "3:manufID:" . substr($data, 0, 3);
push @event, "3:state:$data";
}
} elsif ($rorg eq "D2") {
# VLD telegram
if ($st eq "test") {
} elsif ($st eq "actuator.01") {
# Electronic switches and dimmers with Energy Measurement and Local Control
# (D2-01-00 - D2-01-11)
my $channel = (hex substr($data, 2, 2)) | 0x1F;
if ($channel == 31) {$channel = "Input";}
my $cmd = hex substr($data, 1, 1);
if ($cmd == 4) {
# actuator status response
my $overCurrentOff;
my $error;
my $localControl;
my $dim;
if ( hex(substr($data, 2, 2)) | 0x80 == 1) {
$overCurrentOff = "executed";
} else {
$overCurrentOff = "ready";
}
push @event, "3:overCurrentOff" . $channel . ":" . $overCurrentOff;
if (substr($data, 2, 2) | 0x60 == 1) {
$error = "warning";
} elsif (hex(substr($data, 2, 2)) | 0x60 == 2) {
$error = "failure";
} else {
$error = "ok";
}
push @event, "3:error" . $channel . ":" . $error;
if (hex(substr($data, 4, 2)) | 0x80 == 1) {
$localControl = "enabled";
} else {
$localControl = "disabled";
}
push @event, "3:localControl" . $channel . ":" . $localControl;
my $dimValue = hex(substr($data, 4, 2)) | 0x1F;
if (hex(substr($data, 4, 2)) | 0x1F == 0) {
push @event, "3:channel" . $channel . ":off";
push @event, "3:state:off";
} else {
push @event, "3:channel" . $channel . ":on";
push @event, "3:state:on";
}
push @event, "3:dim" . $channel . ":" . $dimValue;
} elsif ($cmd == 7) {
# actuator measurement response
my $unit = hex(substr($data, 2, 2)) | 0xE0;
if ($unit == 1) {
$unit = "Wh";
push @event, "3:energyUnit" . $channel . ":" . $unit;
push @event, "3:energy" . $channel . ":" . hex substr($data, 4, 8);
} elsif ($unit == 2) {
$unit = "KWh";
push @event, "3:energyUnit" . $channel . ":" . $unit;
push @event, "3:energy" . $channel . ":" . hex substr($data, 4, 8);
} elsif ($unit == 3) {
$unit = "W";
push @event, "3:powerUnit" . $channel . ":" . $unit;
push @event, "3:power" . $channel . ":" . hex substr($data, 4, 8);
} elsif ($unit == 4) {
$unit = "KW";
push @event, "3:powerUnit" . $channel . ":" . $unit;
push @event, "3:power" . $channel . ":" . hex substr($data, 4, 8);
} else {
$unit = "Ws";
push @event, "3:engergyUnit" . $channel . ":" . $unit;
push @event, "3:energy" . $channel . ":" . hex substr($data, 4, 8);
}
} else {
# unknown response
}
} elsif ($st eq "raw") {
# raw
push @event, "3:state:RORG: $rorg DATA: $data STATUS: $status ODATA: $odata";
# display data bytes $db[0] ... $db[x]
for (my $dbCntr = 0; $dbCntr <= $#db; $dbCntr++) {
push @event, "3:DB_" . $dbCntr . ":" . $db[$dbCntr];
}
} else {
# unknown devices
push @event, "3:state:$data";
}
} elsif ($rorg eq "D4" && $teach) {
# UTE - Universal Uni- and Bidirectional Teach-In / Teach Out
#
if (($db[6] & 1) == 0) {
# Teach-In Query telegram received
my $rorg = sprintf "%02X", $db[0];
my $func = sprintf "%02X", $db[1];
my $type = sprintf "%02X", $db[2];
my $mid = sprintf "%03X", ((($db[3] & 7) << 8) | $db[4]);
my $comMode = $db[6] & 0x80 ? "biDir" : "uniDir";
my $devChannel = sprintf "%02X", $db[5];
my $subType = "$rorg.$func.$type";
my $teachInReq = ($db[6] & 0x30) >> 4;
if ($teachInReq == 0) {
# Teach-In Request
if($EnO_subType{$subType}) {
# EEP Teach-In
$subType = $EnO_subType{$subType};
$attr{$name}{subType} = $subType;
$attr{$name}{manufID} = $mid;
$attr{$name}{devChannel} = $devChannel;
$attr{$name}{comMode} = $comMode;
$mid = $EnO_manuf{$mid} if($EnO_manuf{$mid});
push @event, "3:teach-in:EEP $rorg-$func-$type Manufacturer: $mid";
if (!($db[6] & 0x40)) {
# EEP Teach-In-Response expected
# send EEP Teach-In-Response message
$data = (sprintf "%02X", $db[6] & 0x80 | 0x11) . substr($data, 2, 12);
my $subDef = "00000000";
if ($comMode eq "biDir") {
# select a free SenderID
$subDef = EnOcean_CheckSenderID("getNextID", $defs{$name}{IODev}{NAME}, $subDef);
}
$attr{$name}{subDef} = $subDef;
# command will be sent with a delay
select(undef, undef, undef, 0.1);
EnOcean_SndRadio(undef, $hash, "D4", $data, $subDef, "00", $id);
Log3 $name, 1, "EnOcean $name UTE teach-in-response send to $id";
}
Log3 $name, 1, "EnOcean $name UTE teach-in EEP $rorg-$func-$type Manufacturer: $mid";
# store attr subType, manufID ...
CommandSave(undef, undef);
} else {
# EEP type not supported
$attr{$name}{subType} = "raw";
$attr{$name}{manufID} = $mid;
$attr{$name}{devChannel} = $devChannel;
$attr{$name}{comMode} = $comMode;
$mid = $EnO_manuf{$mid} if($EnO_manuf{$mid});
push @event, "3:teach-in:EEP $rorg-$func-$type Manufacturer: $mid not supported";
# send EEP Teach-In Response message
$data = (sprintf "%02X", $db[6] & 0x80 | 0x31) . substr($data, 2, 12);
# command will be sent with a delay
select(undef, undef, undef, 0.1);
EnOcean_SndRadio(undef, $hash, "D4", $data, $defs{$name}{IODev}{BaseID}, "00", $id);
Log3 $name, 1, "EnOcean $name EEP $rorg-$func-$type not supported";
# store attr subType, manufID ...
CommandSave(undef, undef);
}
} elsif ($teachInReq == 1) {
# Teach-In Deletion Request
# send EEP Teach-In Deletion Response message
$teachOut =1;
$data = (sprintf "%02X", $db[6] & 0x80 | 0x21) . substr($data, 2, 12);
# command will be sent with a delay
select(undef, undef, undef, 0.1);
EnOcean_SndRadio(undef, $hash, "D4", $data, AttrVal($name, "subDef", $defs{$name}{IODev}{BaseID}), "00", $id);
Log3 $name, 1, "EnOcean $name delete request executed";
} elsif ($teachInReq == 2) {
# Deletion of Teach-In or Teach-In Request, not specified
}
} else {
# Teach-In Respose telegram received
# no action
Log3 $name, 1, "EnOcean $name $data UTE Teach-In Respose telegram received";
}
}
readingsBeginUpdate($hash);
for(my $i = 0; $i < int(@event); $i++) {
# Flag & 1: reading, Flag & 2: changed. Currently ignored.
my ($flag, $vn, $vv) = split(":", $event[$i], 3);
readingsBulkUpdate($hash, $vn, $vv);
}
readingsEndUpdate($hash, 1);
if ($teachOut) {
# delete device and save config
CommandDelete(undef, $name);
CommandDelete(undef, "FileLog_" . $name);
CommandSave(undef, undef);
return "";
}
return $name;
}
sub EnOcean_Attr(@) {
my ($cmd, $name, $attrName, $attrVal) = @_;
my $hash = $defs{$name};
if ($attrName eq "pollInterval") {
if (!defined $attrVal) {
} elsif ($attrVal =~ m/^\d+(\.\d+)?$/) {
} else {
#RemoveInternalTimer($hash);
Log3 $name, 3, "EnOcean $name attribute-value [$attrName] = $attrVal is not a number with positive sign";
CommandDeleteAttr(undef, "$name pollInterval");
}
} elsif ($attrName eq "devUpdate") {
if (!defined $attrVal){
} elsif ($attrVal !~ m/^(off|auto|demand|polling|interrupt)$/) {
Log3 $name, 3, "EnOcean $name attribute-value [$attrName] = $attrVal wrong";
CommandDeleteAttr(undef, "$name devUpdate");
}
}
return undef;
}
sub EnOcean_Notify(@) {
my ($hash, $dev) = @_;
my $name = $hash->{NAME};
if ($dev->{NAME} eq "global" && grep (m/^INITIALIZED$/,@{$dev->{CHANGED}})){
Log3($name, 3, "EnOcean $name initialized");
}
return undef;
}
# Message from Fhem to the actuator (EEP A5-20-01)
sub
EnOcean_hvac_01Cmd($$$)
{
my ($hash, $name, $db_1) = @_;
my $cmd = ReadingsVal($name, "CMD", undef);
if($cmd) {
my $msg; # Unattended
my $arg1 = ReadingsVal($name, $cmd, 0); # Command-Argument
# primarily temperature from the reference device, secondly the attribute actualTemp
# and thirdly from the MD15 measured temperature device is read
my $temperatureRefDev = AttrVal($name, "temperatureRefDev", undef);
my $actualTemp = AttrVal($name, "actualTemp", $db_1 * 40 / 255);
$actualTemp = ReadingsVal($temperatureRefDev, "temperature", 20) if (defined $temperatureRefDev);
$actualTemp = 20 if ($actualTemp !~ m/^[+-]?\d+(\.\d+)?$/);
$actualTemp = 0 if ($actualTemp < 0);
$actualTemp = 40 if ($actualTemp > 40);
readingsSingleUpdate($hash, "temperature", (sprintf "%0.1f", $actualTemp), 1);
if($cmd eq "actuator") {
$msg = sprintf "%02X000008", $arg1;
} elsif($cmd eq "desired-temp") {
$msg = sprintf "%02X%02X0408", $arg1 * 255 / 40, (40 - $actualTemp) * 255 / 40;
} elsif($cmd eq "initialize") {
$msg = "00006408";
# Maintenance commands
} elsif($cmd eq "runInit") {
$msg = "00008108";
} elsif($cmd eq "liftSet") {
$msg = "00004108";
} elsif($cmd eq "valveOpen") {
$msg = "00002108";
} elsif($cmd eq "valveClosed") {
$msg = "00001108";
}
if($msg) {
select(undef, undef, undef, 0.2);
EnOcean_SndRadio(undef, $hash, "A5", $msg, "00000000", "00", $hash->{DEF});
if($cmd eq "initialize") {
delete($defs{$name}{READINGS}{CMD});
delete($defs{$name}{READINGS}{$cmd});
}
}
}
}
# Check SenderIDs
sub
EnOcean_CheckSenderID($$$)
{
my ($ctrl, $IODev, $senderID) = @_;
if (!defined $IODev) {
my (@listIODev, %listIODev);
foreach my $dev (keys %defs) {
next if ($defs{$dev}{TYPE} ne "EnOcean");
push(@listIODev, $defs{$dev}{IODev}{NAME});
}
@listIODev = sort grep(!$listIODev{$_}++, @listIODev);
if (@listIODev == 1) {
$IODev = $listIODev[0];
}
}
my $unusedID = 0;
$unusedID = hex($defs{$IODev}{BaseID}) if ($defs{$IODev}{BaseID});
my $IDCntr1;
my $IDCntr2;
if ($unusedID == 0) {
$IDCntr1 = 0;
$IDCntr2 = 0;
} else {
$IDCntr1 = $unusedID + 1;
$IDCntr2 = $unusedID + 127;
}
if ($ctrl eq "getBaseID") {
# get TCM BaseID of the EnOcean device
if ($defs{$IODev}{BaseID}) {
$senderID = $defs{$IODev}{BaseID}
} else {
$senderID = "0" x 8;
}
} elsif ($ctrl eq "getUsedID") {
# find and sort used SenderIDs
my @listID;
my %listID;
foreach my $dev (keys %defs) {
next if ($defs{$dev}{TYPE} ne "EnOcean");
push(@listID, grep(hex($_) >= $IDCntr1 && hex($_) <= $IDCntr2, $defs{$dev}{DEF}));
push(@listID, $attr{$dev}{subDef}) if ($attr{$dev}{subDef});
push(@listID, $attr{$dev}{subDefI}) if ($attr{$dev}{subDefI});
push(@listID, $attr{$dev}{subDef0}) if ($attr{$dev}{subDef0});
}
$senderID = join(",", sort grep(!$listID{$_}++, @listID));
} elsif ($ctrl eq "getFreeID") {
# find and sort free SenderIDs
my (@freeID, @listID, %listID, @intersection, @difference, %count, $element);
for (my $IDCntr = $IDCntr1; $IDCntr <= $IDCntr2; $IDCntr++) {
push(@freeID, sprintf "%08X", $IDCntr);
}
foreach my $dev (keys %defs) {
next if ($defs{$dev}{TYPE} ne "EnOcean");
push(@listID, grep(hex($_) >= $IDCntr1 && hex($_) <= $IDCntr2, $defs{$dev}{DEF}));
push(@listID, $attr{$dev}{subDef}) if ($attr{$dev}{subDef});
push(@listID, $attr{$dev}{subDefI}) if ($attr{$dev}{subDefI});
push(@listID, $attr{$dev}{subDef0}) if ($attr{$dev}{subDef0});
}
@listID = sort grep(!$listID{$_}++, @listID);
foreach $element (@listID, @freeID) {
$count{$element}++
}
foreach $element (keys %count) {
push @{$count{$element} > 1 ? \@intersection : \@difference }, $element;
}
$senderID = ":" . join(",", sort @difference);
} elsif ($ctrl eq "getNextID") {
# get next free SenderID
my (@freeID, @listID, %listID, @intersection, @difference, %count, $element);
for (my $IDCntr = $IDCntr1; $IDCntr <= $IDCntr2; $IDCntr++) {
push(@freeID, sprintf "%08X", $IDCntr);
}
foreach my $dev (keys %defs) {
next if ($defs{$dev}{TYPE} ne "EnOcean");
push(@listID, grep(hex($_) >= $IDCntr1 && hex($_) <= $IDCntr2, $defs{$dev}{DEF}));
push(@listID, $attr{$dev}{subDef}) if ($attr{$dev}{subDef});
push(@listID, $attr{$dev}{subDefI}) if ($attr{$dev}{subDefI});
push(@listID, $attr{$dev}{subDef0}) if ($attr{$dev}{subDef0});
}
@listID = sort grep(!$listID{$_}++, @listID);
foreach $element (@listID, @freeID) {
$count{$element}++
}
foreach $element (keys %count) {
push @{$count{$element} > 1 ? \@intersection : \@difference }, $element;
}
@difference = sort @difference;
$senderID = $difference[0];
} else {
}
return $senderID;
}
# send EnOcean ESP3 Packet Type Radio
sub
EnOcean_SndRadio($$$$$$$)
{
my ($ctrl, $hash, $rorg, $data, $senderID, $status, $destinationID) = @_;
my $odata = "";
my $odataLength = 0;
if (AttrVal($hash->{NAME}, "repeatingAllowed", "yes") eq "no") {
$status = substr($status, 0, 1) . "F";
}
my $securityLevel = AttrVal($hash->{NAME}, "securityLevel", 0);
if ($securityLevel eq "unencrypted") {$securityLevel = 0;}
if ($destinationID ne "FFFFFFFF" || $securityLevel) {
# SubTelNum = 03, DestinationID:8, RSSI = FF, SecurityLevel:2
$odata = sprintf "03%sFF%02X", $destinationID, $securityLevel;
$odataLength = 7;
}
# Data Length:4 Optional Length:2 Packet Type = 01 (radio)
my $header = sprintf "%04X%02X01", (length($data)/2 + 6), $odataLength;
$data = $rorg . $data . $senderID . $status . $odata;
IOWrite($hash, $header, $data);
Log3 $hash->{NAME}, 4, "EnOcean IOWrite $hash->{NAME} Header: $header Data: $data";
}
# Scale Readings
sub
EnOcean_ReadingScaled($$$$)
{
my ($hash, $readingVal, $readingMin, $readingMax) = @_;
my $name = $hash->{NAME};
my $valScaled;
my $scaleDecimals = AttrVal($name, "scaleDecimals", undef);
my $scaleMin = AttrVal($name, "scaleMin", undef);
my $scaleMax = AttrVal($name, "scaleMax", undef);
if (defined $scaleMax && defined $scaleMin &&
$scaleMax =~ m/^[+-]?\d+(\.\d+)?$/ && $scaleMin =~ m/^[+-]?\d+(\.\d+)?$/) {
$valScaled = ($readingMin*$scaleMax-$scaleMin*$readingMax)/
($readingMin-$readingMax)+
($scaleMin-$scaleMax)/($readingMin-$readingMax)*$readingVal;
}
if (defined $scaleDecimals && $scaleDecimals =~ m/^[0-9]?$/) {
$scaleDecimals = "%0." . $scaleDecimals . "f";
$valScaled = sprintf "$scaleDecimals", $valScaled;
}
return $valScaled;
}
# EnOcean_Set called from sub InternalTimer()
sub
EnOcean_TimerSet($)
{
my ($par)=@_;
EnOcean_Set($par->{hash}, @{$par->{timerCmd}});
}
# Undef
sub
EnOcean_Undef($$)
{
my ($hash, $arg) = @_;
delete $modules{EnOcean}{defptr}{uc($hash->{DEF})};
return undef;
}
1;
=pod
=begin html
<a name="EnOcean"></a>
<h3>EnOcean</h3>
<ul>
EnOcean devices are sold by numerous hardware vendors (e.g. Eltako, Peha, etc),
using the RF Protocol provided by the EnOcean Alliance. Depending on the
function of the device an specific device profile is used, called EnOcean
Equipment Profile (EEP). Basically three profiles will be differed, e. g.
switches, contacts, sensors. Some manufacturers use additional proprietary
extensions. Further technical information can be found at the
<a href="http://www.enocean-alliance.org/de/enocean_standard/">EnOcean Alliance</a>,
see in particular the
<a href="http://www.enocean-alliance.org/eep/">EnOcean Equipment Profiles (EEP)</a>
<br><br>
Fhem recognizes a number of devices automatically. In order to teach-in, for
some devices the sending of confirmation telegrams has to be turned on.
Some equipment types and/or device models must be manually specified.
Do so using the <a href="#EnOceanattr">attributes</a>
<a href="#subType">subType</a> and <a href="#model">model</a>, see chapter
<a href="#EnOceanset">Set</a> and
<a href="#EnOceanevents">Generated events</a>. With the help of additional
<a href="#EnOceanattr">attributes</a>, the behavior of the devices can be
changed separately.
<br><br>
The teach-in procedure depends on the type of the devices. Switches (EEP RPS)
and contacts (EEP 1BS) are recognized when receiving the first message.
Contacts can also send a teach-in telegram. Fhem not need this telegram.
Sensors (EEP 4BS) has to send a teach-in telegram. The profile-less
4BS teach-in procedure transfers no EEP profile identifier and no manufacturer
ID. In this case Fhem does not recognize the device automatically. The proper
device type must be set manually, use the <a href="#EnOceanattr">attributes</a>
<a href="#subType">subType</a>, <a href="#manufID">manufID</a> and/or
<a href="#model">model</a>. If the EEP profile identifier and the manufacturer
ID are sent the device is clearly identifiable. Fhem automatically assigns
these devices to the correct profile. Some 4BS, VLD or MSC devices must be paired
bidirectional, see <a href="#EnOcean_teach-in">Bidirectional Teach-In / Teach-Out</a>.<br><br>
Fhem supports many of most common EnOcean profiles and manufacturer-specific
devices. Additional profiles and devices can be added if required.
<br><br>
In order to enable communication with EnOcean remote stations a
<a href="#TCM">TCM</a> module is necessary.
<br><br>
Please note that EnOcean repeaters also send Fhem data telegrams again.
Use the TCM <code>attr &lt;name&gt; <a href="#blockSenderID">blockSenderID</a> own</code>
to block receiving telegrams with a TCM SenderIDs.
<br><br>
<a name="EnOceandefine"></a>
<b>Define</b>
<ul>
<code>define &lt;name&gt; EnOcean &lt;def&gt;</code>
<br><br>
Define an EnOcean device, connected via a <a href="#TCM">TCM</a> modul. The
&lt;def&gt; is the SenderID/DestinationID of the device (8 digit hex number).
The <a href="#autocreate">autocreate</a> module may help you.<br>
Example:
<ul>
<code>define switch1 EnOcean ffc54500</code><br>
</ul><br>
In order to control devices, you cannot reuse the SenderIDs/
DestinationID of other devices (like remotes), instead you have to create
your own, which must be in the allowed SenderID range of the underlying Fhem
IO device, see <a href="#TCM">TCM</a> BaseID, LastID. For this first query the
<a href="#TCM">TCM</a> with the <code>get &lt;tcm&gt; baseID</code> command
for the BaseID. You can use up to 127 IDs starting with the BaseID + 1 shown there.
The BaseID is used for 4BS devices with a bidectional teach-in only. If you
are using an Fhem SenderID outside of the allowed range, you will see an
ERR_ID_RANGE message in the Fhem log.<br>
Fhem communicates unicast with the ChipID or BaseID, if the 4BS devices are teached-in with the
<a href="#EnOcean_teach-in"> Bidirectional Teach-In / Teach-Out</a> procedure. In this case
Fhem send telegrams with its SenderID (ChipID or BaseID) and the DestinationID of the
device.<br>
Newer devices send acknowledge telegrams. In order to control this devices (switches, actors) with
additional SenderIDs you can use the attributes <a href="#subDef">subDef</a>,
<a href="#subDef0">subDef0</a> and <a href="#subDefI">subDefI</a>.<br><br>
</ul>
<a name="EnOceanset"></a>
<b>Set</b>
<ul>
<li><a name="EnOcean_teach-in">Bidirectional Teach-In / Teach-Out</a>
<ul>
<code>set &lt;name&gt; teach &lt;t/s&gt;</code>
<br><br>
Set the EnOcean Transceiver module (TCM Modul) in the pairing mode.
A device, which is then also put in this state is to paired with
Fhem. Pearing is used for some 4BS, VLD and MSC devices,
e. g. EEP 4BS, RORG A5-20-01 (Battery Powered Actuator).<br>
Bidirectional 4BS Teach-In and UTE - Universal Uni- and Bidirectional
Teach-In are supported.
<br>
<code>name</code> is the name of the TCM Module . <code>t/s</code> is the
time for the teach-in period.
<br><br>
Example:
<ul><code>set TCM_0 teach 600</code>
<br><br>
</ul>
</ul>
</li>
<li>Switch, Pushbutton Switch, Bidirectional Actor (EEP F6-02-01 ... F6-03-02)<br>
[Default subType]
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is one of A0, AI, B0, BI, C0, CI, D0, DI,
combinations of these and released. First and second action can be sent
simultaneously. Separate first and second action with a comma.<br>
In fact we are trying to emulate a PT200 type remote.<br>
If you define an <a href="#eventMap">eventMap</a> attribute with on/off,
then you will be able to easily set the device from the <a
href="#FHEMWEB">WEB</a> frontend.<br>
<a href="#setExtensions">set extensions</a> are supported, if the corresponding
<a href="#eventMap">eventMap</a> specifies the <code>on</code> and <code>off</code>
mappings.<br>
With the help of additional <a href="#EnOceanattr">attributes</a>, the
behavior of the devices can be adapt.
<br><br>
Example:
<ul><code>
set switch1 BI<br>
set switch1 B0,CI<br>
attr eventMap BI:on B0:off<br>
set switch1 on<br>
</code></ul><br>
</ul>
</li>
<li>Staircase off-delay timer (EEP F6-02-01 ... F6-02-02)<br>
[Eltako FTN14, tested with Eltako FTN14 only]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>on<br>
issue switch on command</li>
<li>released<br>
start timer</li>
</ul><br>
Set attr eventMap to B0:on BI:off, attr subType to switch, attr
webCmd to on:released and if needed attr switchMode to pushbutton manually.<br>
Use the sensor type "Schalter" for Eltako devices. The Staircase
off-delay timer is switched on when pressing "on" and the time will be started
when pressing "released". "released" immediately after "on" is sent if
the attr switchMode is set to "pushbutton".
</li>
<br><br>
<li>Single Input Contact, Door/Window Contact<br>
1BS Telegram (EEP D5-00-01)<br>
[tested with Eltako FSR14]
<ul>
<li>closed<br>
issue closed command</li>
<li>open<br>
issue open command</li>
<li>teach<br>
initiate teach-in mode</li>
</ul></li>
The attr subType must be contact. The attribute must be set manually.
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-02)<br>
[Thermokon SR04 PTS]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in</li>
<li>setpoint [0 ... 255]<br>
Set the actuator to the specifed setpoint.</li>
<li>setpointScaled [&lt;floating-point number&gt;]<br>
Set the actuator to the scaled setpoint.</li>
<li>fanStage [auto|0|1|2|3]<br>
Set fan stage</li>
<li>switch [on|off]<br>
Set switch</li>
</ul><br>
The actual temperature will be taken from the temperature reported by
a temperature reference device <a href="#temperatureRefDev">temperatureRefDev</a>
primarily or from the attribute <a href="#actualTemp">actualTemp</a> if it is set.<br>
The scaling of the setpoint adjustment is device- and vendor-specific. Set the
attributes <a href="#scaleMax">scaleMax</a>, <a href="#scaleMin">scaleMin</a> and
<a href="#scaleDecimals">scaleDecimals</a> for the additional scaled setting
setpointScaled.<br>
The attr subType must be roomSensorControl.05. The attribute must be set manually.
</li>
<br><br>
<li>Room Sensor and Control Unit (A5-10-06 plus night reduction)<br>
[Eltako FVS]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in</li>
<li>desired-temp [t/&#176C [lock|unlock]]<br>
Set the desired temperature.</li>
<li>nightReduction [t/K [lock|unlock]]<br>
Set night reduction</li>
<li>setpointTemp [t/&#176C [lock|unlock]]<br>
Set the desired temperature</li>
</ul><br>
The actual temperature will be taken from the temperature reported by
a temperature reference device <a href="#temperatureRefDev">temperatureRefDev</a>
primarily or from the attribute <a href="#actualTemp">actualTemp</a> if it is set.<br>
This profil can be used with a further Room Sensor and Control Unit Eltako FTR55*
to control a heating/cooling relay FHK12, FHK14 or FHK61. If Fhem and FTR55*
is teached in, the temperature control of the FTR55* can be either blocked
or to a setpoint deviation of +/- 3 K be limited. For this use the optional parameter
[block] = lock|unlock, unlock is default.<br>
The attr subType must be roomSensorControl.05 and attr manufID must be 00D.
The attributes must be set manually.
</li>
<br><br>
<li>Battery Powered Actuator (EEP A5-20-01)<br>
[Kieback&Peter MD15-FTL-xx]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>actuator setpoint/%<br>
Set the actuator to the specifed setpoint (0-100)</li>
<li>desired-temp &lt;value&gt;<br>
Use the builtin PI regulator, and set the desired temperature to the
specified degree. The actual value will be taken from the temperature
reported by the MD15 or from the attribute actualTemp if it is set.</li>
<li>runInit<br>
Maintenance Mode (service on): Run init sequence.</li>
<li>liftSet<br>
Maintenance Mode (service on): Lift set</li>
<li>valveOpen<br>
Maintenance Mode (service on): Valve open</li>
<li>valveClosed<br>
Maintenance Mode (service on): Valve closed</li>
<li>unattended<br>
Do not regulate the actuator.</li>
</ul><br>
The attr subType must be MD15. This is done if the device was
created by autocreate. To control the device, it must be bidirectional paired,
see <a href="#EnOcean_teach-in">Bidirectional Teach-In / Teach-Out</a>.<br>
The command is not sent until the device wakes up and sends a mesage, usually
every 10 minutes.
</li>
<br><br>
<li><a name="Gateway">Gateway</a> (EEP A5-38-08)<br>
The Gateway profile include 7 different commands (Switching, Dimming,
Setpoint Shift, Basic Setpoint, Control variable, Fan stage, Blind Central Command).
The commands can be selected by the attribute gwCmd or command line. The attribute
entry has priority.<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>&lt;gwCmd&gt; &lt;cmd&gt; [subCmd]<br>
initiate Gateway commands by command line</li>
<li>&lt;cmd&gt; [subCmd]<br>
initiate Gateway commands if attribute gwCmd is set.</li>
</ul><br>
The attr subType must be gateway. Attribute gwCmd can also be set to
switching|dimming|setpointShift|setpointBasic|controlVar|fanStage|blindCmd.<br>
This is done if the device was created by autocreate.<br>
For Eltako devices attributes must be set manually.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Switching<br>
[Eltako FLC61, FSA12, FSR14]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>on [lock|unlock]<br>
issue switch on command</li>
<li>off [lock|unlock]<br>
issue switch off command</li>
<li><a href="#setExtensions">set extensions</a> are supported.</li>
</ul><br>
The attr subType must be gateway and gwCmd must be switching. This is done if the device was
created by autocreate.<br>
For Eltako devices attributes must be set manually. For Eltako FSA12 attribute model must be set
to FSA12.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Dimming<br>
[Eltako FUD12, FUD14, FUD61, FUD70, FSG14, ...]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>on [lock|unlock]<br>
issue switch on command</li>
<li>off [lock|unlock]<br>
issue switch off command</li>
<li>dim dim/% [rampTime/s [lock|unlock]]<br>
issue dim command</li>
<li>dimup dim/% [rampTime/s [lock|unlock]]<br>
issue dim command</li>
<li>dimdown dim/% [rampTime/s [lock|unlock]]<br>
issue dim command</li>
<li><a href="#setExtensions">set extensions</a> are supported.</li>
</ul><br>
rampTime Range: t = 1 s ... 255 s or 0 if no time specified,
for Eltako: t = 1 = fast dimming ... 255 = slow dimming or 0 = dimming speed on the dimmer used<br>
The attr subType must be gateway and gwCmd must be dimming. This is done if the device was
created by autocreate.<br>
For Eltako devices attributes must be set manually. Use the sensor type "PC/FVS" for Eltako devices.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Dimming of fluorescent lamps<br>
[Eltako FSG70, tested with Eltako FSG70 only]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>on<br>
issue switch on command</li>
<li>off<br>
issue switch off command</li>
<li><a href="#setExtensions">set extensions</a> are supported.</li>
</ul><br>
The attr subType must be gateway and gwCmd must be dimming. Set attr eventMap to B0:on BI:off,
attr subTypeSet to switch and attr switchMode to pushbutton manually.<br>
Use the sensor type "Richtungstaster" for Eltako devices.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Setpoint shift<br>
[untested]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>shift 1/K <br>
issue Setpoint shift</li>
</ul><br>
Shift Range: T = -12.7 K ... 12.8 K<br>
The attr subType must be gateway and gwCmd must be setpointShift.
This is done if the device was created by autocreate.<br>
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Basic Setpoint<br>
[untested]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>basic t/&#176C<br>
issue Basic Setpoint</li>
</ul><br>
Setpoint Range: t = 0 &#176C ... 51.2 &#176C<br>
The attr subType must be gateway and gwCmd must be setpointBasic.
This is done if the device was created by autocreate.<br>
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Control variable<br>
[untested]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>presence present|absent|standby<br>
issue Room occupancy</li>
<li>energyHoldOff normal|holdoff<br>
issue Energy hold off</li>
<li>controllerMode auto|heating|cooling|off<br>
issue Controller mode</li>
<li>controllerState auto|override <0 ... 100> <br>
issue Control variable override</li>
</ul><br>
Override Range: cvov = 0 % ... 100 %<br>
The attr subType must be gateway and gwCmd must be controlVar.
This is done if the device was created by autocreate.<br>
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Fan stage<br>
[untested]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>stage 0 ... 3|auto<br>
issue Fan Stage override</li>
</ul><br>
The attr subType must be gateway and gwCmd must be fanStage.
This is done if the device was created by autocreate.<br>
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
<a name="Blind Command Central">Blind Command Central</a><br>
[untested, experimental status]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>status<br>
Status request</li>
<li>opens<br>
issue blinds opens command</li>
<li>up tu/s ta/s<br>
issue roll up command</li>
<li>closes<br>
issue blinds closes command</li>
<li>down td/s ta/s<br>
issue roll down command</li>
<li>position position/% &alpha;/&#176<br>
drive blinds to position with angle value</li>
<li>stop<br>
issue blinds stops command</li>
<li>runtimeSet tu/s td/s<br>
set runtime parameter</li>
<li>angleSet ta/s<br>
set angle configuration</li>
<li>positionMinMax positionMin/% positionMax/%<br>
set min, max values for position</li>
<li>angleMinMax &alpha;o/&#176 &alpha;s/&#176<br>
set slat angle for open and shut position</li>
<li>positionLogic normal|inverse<br>
set position logic</li>
</ul><br>
Runtime Range: tu|td = 0 s ... 255 s<br>
Select a runtime up and a runtime down that is at least as long as the
shading element or roller shutter needs to move from its end position to
the other position.<br>
Position Range: position = 0 % ... 100 %<br>
Angle Time Range: ta = 0 s ... 25.5 s<br>
Runtime value for the sunblind reversion time. Select the time to revolve
the sunblind from one slat angle end position to the other end position.<br>
Slat Angle: &alpha;|&alpha;o|&alpha;s = -180 &#176 ... 180 &#176<br>
Position Logic, normal: Blinds fully opens corresponds to Position = 0 %<br>
Position Logic, inverse: Blinds fully opens corresponds to Position = 100 %<br>
The attr subType must be gateway and gwCmd must be blindCmd. The profile
is linked with controller profile, see <a href="#Blind Status">Blind Status</a>.<br>
</li>
<br><br>
<li><a name="Manufacturer Specific Applications">Manufacturer Specific Applications</a> (EEP A5-3F-7F)<br>
Shutter<br>
[Eltako FSB12, FSB14, FSB61, FSB70, tested with Eltako devices only]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>teach<br>
initiate teach-in mode</li>
<li>opens<br>
issue blinds opens command</li>
<li>up tu/s<br>
issue roll up command</li>
<li>closes<br>
issue blinds closes command</li>
<li>down td/s<br>
issue roll down command</li>
<li>position position/% [&alpha;/&#176]<br>
drive blinds to position with angle value</li>
<li>stop<br>
issue stop command</li>
</ul><br>
Runtime Range: tu|td = 1 s ... 255 s<br>
Position Range: position = 0 % ... 100 %<br>
Slat Angle Range: &alpha; = -180 &#176 ... 180 &#176<br>
Angle Time Range: ta = 0 s ... 6 s<br>
The devive can only fully controlled if the attributes <a href="#angleMax">angleMax</a>,
<a href="#angleMin">angleMin</a>, <a href="#angleTime">angleTime</a>,
<a href="#shutTime">shutTime</a> and <a href="#shutTimeCloses">shutTimeCloses</a>,
are set correctly.
Set attr subType to manufProfile, manufID to 00D and attr model to
FSB14|FSB61|FSB70 manually.<br>
Use the sensor type "Szenentaster/PC" for Eltako devices.
</li>
<br><br>
<li>Electronic switches and dimmers with Energy Measurement and Local Control (D2-01-00 - D2-01-11)<br>
[Telefunken Funktionsstecker]<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>on [&lt;channel&gt;]<br>
issue switch on command</li>
<li>off [&lt;channel&gt;]<br>
issue switch off command</li>
<li>dim dim/% [&lt;channel&gt; [&lt;rampTime&gt;]]<br>
issue dimming command</li>
<li>local dayNight day|night, day is default<br>
set the user interface indication</li>
<li>local defaultState on|off|last, off is default<br>
set the default setting of the output channels when switch on</li>
<li>local localControl enabled|disabled, disabled is default<br>
enable the local control of the device</li>
<li>local overCurrentShutdown off|restart, off is default<br>
set the behavior after a shutdown due to an overcurrent</li>
<li>local overCurrentShutdownReset not_active|trigger, not_active is default<br>
trigger a reset after an overcurrent</li>
<li>local rampTime&lt;1...3&gt; 0/s, 0.5/s ... 7/s, 7.5/s, 0 is default<br>
set the dimming time of timer 1 ... 3</li>
<li>local teachInDev enabled|disabled, disabled is default<br>
enable the taught-in devices with different EEP</li>
<li>measurement delta 0/s ... 4095/s, 0 is deflaut<br>
define the difference between two displayed measurements </li>
<li>measurement mode energy|power, energy is default<br>
define the measurand</li>
<li>measurement report query|auto, query is default<br>
specify the measurement method</li>
<li>measurement reset not_active|trigger, not_active is default<br>
resetting the measured values</li>
<li>measurement responseTimeMax 10/s ... 2550/s, 10 is default<br>
set the maximum time between two outputs of measured values</li>
<li>measurement responseTimeMin 0/s ... 255/s, 0 is default<br>
set the minimum time between two outputs of measured values</li>
<li>measurement unit Ws|Wh|KWh|W|KW, Ws is default<br>
specify the measurement unit</li>
</ul><br>
[channel] = 0...29|all|input, all is default<br>
[rampTime] = 1..3|switch|stop, switch is default<br>
The attr subType must be actuator.01. This is done if the device was
created by autocreate. To control the device, it must be bidirectional paired,
see <a href="#EnOcean_teach-in">Bidirectional Teach-In / Teach-Out</a>.
</li>
<br><br>
<li><a name="RAW Command">RAW Command</a><br>
<br>
<ul>
<code>set &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>1BS|4BS|MSC|RPS|UTE|VLD data [status]<br>
sent data telegram</li>
</ul><br>
[data] = &lt;1-byte hex ... 28-byte hex&gt;<br>
[status] = 0x00 ... 0xFF<br>
With the help of this command data messages in hexadecimal format can be sent.
Telegram types (RORG) 1BS, 4BS, RPS, MSC, UTE and VLD are supported. For further information,
see <a href="http://www.enocean-alliance.org/eep/">EnOcean Equipment Profiles (EEP)</a>.
</li>
<br><br>
</ul></ul>
<a name="EnOceanget"></a>
<b>Get</b>
<ul>
<li>Electronic switches and dimmers with Energy Measurement and Local Control (D2-01-00 - D2-01-11)<br>
[Telefunken Funktionsstecker]<br>
<ul>
<code>get &lt;name&gt; &lt;value&gt;</code>
<br><br>
where <code>value</code> is
<li>state [&lt;channel&gt;]<br>
</li>
<li>measurement &lt;channel&gt; energy|power<br>
</li>
</ul><br>
<br>
The attr subType must be actuator.01. This is done if the device was
created by autocreate. To control the device, it must be bidirectional paired,
see <a href="#EnOcean_teach-in">Bidirectional Teach-In / Teach-Out</a>.
</li>
<br><br>
</ul><br>
<a name="EnOceanattr"></a>
<b>Attributes</b>
<ul>
<ul>
<li><a name="actualTemp">actualTemp</a> t/&#176C<br>
The value of the actual temperature, used by a Room Sensor and Control Unit
or when controlling HVAC components e. g. Battery Powered Actuators (MD15 devices). Should by
filled via a notify from a distinct temperature sensor.<br>
If absent, the reported temperature from the HVAC components is used.
</li>
<li><a name="angleMax">angleMax</a> &alpha;s/&#176, [&alpha;s] = -180 ... 180, 90 is default.<br>
Slat angle end position maximum.<br>
angleMax is supported for shutter.
</li>
<li><a name="angleMin">angleMin</a> &alpha;o/&#176, [&alpha;o] = -180 ... 180, -90 is default.<br>
Slat angle end position minimum.<br>
angleMin is supported for shutter.
</li>
<li><a name="angleTime">angleTime</a> t/s, [angleTime] = 0 ... 6, 0 is default.<br>
Runtime value for the sunblind reversion time. Select the time to revolve
the sunblind from one slat angle end position to the other end position.<br>
angleTime is supported for shutter.
</li>
<li><a name="comMode">comMode</a> biDir|uniDir, [comMode] = uniDir is default.<br>
Communication Mode between an enabled EnOcean device and Fhem.<br>
Unidirectional communication means a point-to-multipoint communication
relationship. The EnOcean device e. g. sensors does not know the unique
Fhem SenderID.<br>
Bidirectional communication means a point-to-point communication
relationship between an enabled EnOcean device and Fhem. It requires all parties
involved to know the unique Sender ID of their partners. Bidirectional communication
needs a teach-in / teach-out process, see <a href="#EnOcean_teach-in">Bidirectional Teach-In / Teach-Out</a>.
</li>
<li><a name="devChannel">devChannel</a> 00 ... FF, [devChannel] = FF is default<br>
Number of the individual device channel, FF = all channels supported by the device
</li>
<li><a name="destinationID">destinationID</a> multicast|unicast|00000001 ... FFFFFFFF,
[destinationID] = multicast is default<br>
Destination ID, special values: multicast = FFFFFFFF, unicast = [DEF]
</li>
<li><a href="#devStateIcon">devStateIcon</a></li>
<li><a name="dimValueOn">dimValueOn</a> dim/%|last|stored,
[dimValueOn] = 100 is default.<br>
Dim value for the command "on".<br>
The dimmer switched on with the value 1 % ... 100 % if [dimValueOn] =
1 ... 100.<br>
The dimmer switched to the last dim value received from the
bidirectional dimmer if [dimValueOn] = last.<br>
The dimmer switched to the last Fhem dim value if [dimValueOn] =
stored.<br>
dimValueOn is supported for dimmer.
</li>
<li><a href="#do_not_notify">do_not_notify</a></li>
<li><a href="#eventMap">eventMap</a></li>
<li><a name="gwCmd">gwCmd</a> switching|dimming|setpointShift|setpointBasic|controlVar|fanStage|blindCmd<br>
Gateway Command Type, see <a href="#Gateway">Gateway</a> profile
</li>
<li><a name="humidityRefDev">humidityRefDev</a> <name><br>
Name of the device whose reference value is read. The reference values is
the reading humidity.
</li>
<li><a href="#ignore">ignore</a></li>
<li><a href="#IODev">IODev</a></li>
<li><a href="#model">model</a></li>
<li><a name="rampTime">rampTime</a> t/s or relative, [rampTime] = 1 is default.<br>
No ramping or for Eltako dimming speed set on the dimmer if [rampTime] = 0.<br>
Ramping time 1 s to 255 s or relative fast to low dimming speed if [rampTime] = 1 ... 255.<br>
rampTime is supported for gateway, command dimming.
</li>
<li><a href="#readingFnAttributes">readingFnAttributes</a></li>
<li><a name="repeatingAllowed">repeatingAllowed</a> yes|no,
[repeatingAllowed] = yes is default.<br>
EnOcean Repeater in the transmission range of Fhem may forward data messages
of the device, if the attribute is set to yes.
</li>
<li><a name="scaleDecimals">scaleDecimals</a> 0 ... 9<br>
Decimal rounding with x digits of the scaled reading setpoint
</li>
<li><a name="scaleMax">scaleMax</a> &lt;floating-point number&gt;<br>
Scaled maximum value of the reading setpoint
</li>
<li><a name="scaleMin">scaleMin</a> &lt;floating-point number&gt;<br>
Scaled minimum value of the reading setpoint
</li>
<li><a name="securityLevel">securityLevel</a> unencrypted, [securityLevel] = unencrypted is default<br>
Type of Encryption
</li>
<li><a name="sensorMode">switchMode</a> switch|pushbutton,
[sensorMode] = switch is default.<br>
The status "released" will be shown in the reading state if the
attribute is set to "pushbutton".
</li>
<li><a href="#showtime">showtime</a></li>
<li><a name="shutTime">shutTime</a> t/s, [shutTime] = 1 ... 255, 255 is default.<br>
Use the attr shutTime to set the time delay to the position "Halt" in
seconds. Select a delay time that is at least as long as the shading element
or roller shutter needs to move from its end position to the other position.<br>
shutTime is supported for shutter.
</li>
<li><a name="shutTimeCloses">shutTimeCloses</a> t/s, [shutTimeCloses] = 1 ... 255,
[shutTimeCloses] = [shutTime] is default.<br>
Set the attr shutTimeCloses to define the runtime used by the commands opens and closes.
Select a runtime that is at least as long as the value set by the delay switch of the actuator.
<br>
shutTimeCloses is supported for shutter.
</li>
<li><a name="subDef">subDef</a> &lt;EnOcean SenderID&gt;,
[subDef] = [def] is default.<br>
SenderID (<a href="#TCM">TCM</a> BaseID + offset) to control a bidirectional switch or actor.<br>
In order to control devices that send acknowledge telegrams, you cannot reuse the ID of this
devices, instead you have to create your own, which must be in the
allowed ID-Range of the underlying IO device. For this first query the
<a href="#TCM">TCM</a> with the "<code>get &lt;tcm&gt; idbase</code>" command. You can use
up to 128 IDs starting with the base shown there.
</li>
<li><a name="subDef0">subDef0</a> &lt;EnOcean SenderID&gt;,
[subDef0] = [def] is default.<br>
SenderID (<a href="#TCM">TCM</a> BaseID + offset) for [value] = A0|B0|C0|D0|released<br>
Used with switch type "central". Set attr switchType to central.<br>
Use the sensor type "zentral aus/ein" for Eltako devices.<br>
subDef0 is supported for switches.<br>
Second action is not sent.
</li>
<li><a name="subDefI">subDefI</a> &lt;EnOcean SenderID&gt;,
[subDefI] = [def] is default.<br>
SenderID (<a href="#TCM">TCM</a> BaseID + offset) for [value] = AI|BI|CI|DI<br>
Used with switch type "central". Set attr switchType to central.<br>
Use the sensor type "zentral aus/ein" for Eltako devices.<br>
subDefI is supported for switches.<br>
Second action is not sent.
</li>
<li><a href="#subType">subType</a></li>
<li><a name="subTypeSet">subTypeSet</a> &lt;type of device&gt;, [subTypeSet] = [subType] is default.<br>
Type of device (EEP Profile) used for sending commands. Set the Attribute manually.
The profile has to fit their basic profile. More information can be found in the basic profiles.
</li>
<li><a name="switchMode">switchMode</a> switch|pushbutton,
[SwitchMode] = switch is default.<br>
The set command "released" immediately after &lt;value&gt; is sent if the
attribute is set to "pushbutton".
</li>
<li><a name="switchType">switchType</a> direction|universal|central,
[SwitchType] = direction is default.<br>
EnOcean Devices support different types of sensors, e. g. direction
switch, universal switch or pushbutton, central on/off.<br>
For Eltako devices these are the sensor types "Richtungstaster",
"Universalschalter" or "Universaltaster", "Zentral aus/ein".<br>
With the sensor type <code>direction</code> switch on/off commands are
accepted, e. g. B0, BI, released. Fhem can control an device with this
sensor type unique. This is the default function and should be
preferred.<br>
Some devices only support the sensor type <code>universal switch
</code> or <code>pushbutton</code>. With a Fhem command, for example,
B0 or BI is switched between two states. In this case Fhem cannot
control this device unique. But if the Attribute <code>switchType
</code> is set to <code>universal</code> Fhem synchronized with
a bidirectional device and normal on/off commands can be used.
If the bidirectional device response with the channel B
confirmation telegrams also B0 and BI commands are to be sent,
e g. channel A with A0 and AI. Also note that confirmation telegrams
needs to be sent.<br>
Partly for the sensor type <code>central</code> two different SenderID
are required. In this case set the Attribute <code>switchType</code> to
<code>central</code> and define the Attributes
<a href="#subDef0">subDef0</a> and <a href="#subDefI">subDefI</a>.
</li>
<li><a name="temperatureRefDev">temperatureRefDev</a> <name><br>
Name of the device whose reference value is read. The reference values is
the reading temperature.
</li>
<li><a href="#webCmd">webCmd</a></li>
</ul>
</ul>
<br>
<a name="EnOceanevents"></a>
<b>Generated events</b>
<ul>
<ul>
<li>Switch / Bidirectional Actor (EEP F6-02-01 ... F6-03-02)<br>
<ul>
<li>A0</li>
<li>AI</li>
<li>B0</li>
<li>BI</li>
<li>C0</li>
<li>CI</li>
<li>D0</li>
<li>DI</li>
<li>&lt;BtnX,BtnY&gt; First and second action where BtnX and BtnY is
one of the above, e.g. A0,BI or D0,CI</li>
<li>buttons: pressed|released</li>
<li>state: &lt;BtnX&gt; released</li>
</ul><br>
Switches (remote controls) or actors with more than one
(pair) keys may have multiple channels e. g. B0/BI, A0/AI with one
SenderID or with separate addresses.
</li>
<br><br>
<li>Pushbutton Switch, Pushbutton Input Module (EEP F6-02-01 ... F6-02-02)<br>
[Eltako FT55, FSM12, FSM61, FTS12]<br>
<ul>
<li>A0</li>
<li>AI</li>
<li>B0</li>
<li>BI</li>
<li>released</li>
<li>buttons: pressed|released</li>
<li>state: A0|AI|B0|BI|released</li>
</ul><br>
The status of the device may become "released", this
is not the case for a normal switch.<br>
Set attr model to FT55|FSM12|FSM61|FTS12 manually.
</li>
<br><br>
<li>Smoke Detector (EEP F6-02-01 ... F6-02-02)<br>
[Eltako FRW]<br>
<ul>
<li>smoke-alarm</li>
<li>off</li>
<li>alarm: smoke-alarm|off</li>
<li>battery: low|ok</li>
<li>buttons: pressed|released</li>
<li>state: smoke-alarm|off</li>
</ul><br>
Set attr subType to FRW manually.
</li>
<br><br>
<li>Heating/Cooling Relay (EEP F6-02-01 ... F6-02-02)<br>
[Eltako FAE14, FHK14, untested]<br>
<ul>
<li>controllerMode: auto|off</li>
<li>energyHoldOff: normal|holdoff</li>
<li>buttons: pressed|released</li>
</ul><br>
Set attr subType to switch and model to FAE14|FHK14 manually. In addition
every telegram received from a teached-in temperature sensor (e.g. FTR55H)
is repeated as a confirmation telegram from the Heating/Cooling Relay
FAE14, FHK14. In this case set attr subType to e. g. roomSensorControl.05
and attr manufID to 00D.
</li>
<br><br>
<li>Key Card Activated Switch (EEP F6-04-01)<br>
[Eltako FKC, FKF, FZS, untested]<br>
<ul>
<li>keycard inserted</li>
<li>keycard removed</li>
<li>buttons: pressed|released</li>
<li>state: keycard inserted|keycard removed</li>
</ul><br>
Set attr subType to keycard manually.
</li>
<br><br>
<li>Window Handle (EEP F6-10-00)<br>
[HOPPE SecuSignal, Eltako FHF, Eltako FTKE]<br>
<ul>
<li>closed</li>
<li>open</li>
<li>tilted</li>
<li>open from tilted</li>
<li>buttons: pressed|released</li>
<li>state: closed|open|tilted|open from tilted</li>
</ul><br>
The device windowHandle should be created by autocreate.
</li>
<br><br>
<li>Single Input Contact, Door/Window Contact<br>
1BS Telegram (EEP D5-00-01)<br>
[EnOcean STM 320, STM 329, STM 250, Eltako FTK, Peha D 450 FU, STM-250, BSC ?]
<ul>
<li>closed</li>
<li>open</li>
<li>learnBtn: on</li>
<li>state: open|closed</li>
</ul></li>
The device should be created by autocreate.
<br><br>
<li>Temperature Sensors with with different ranges (EEP A5-02-01 ... A5-02-30)<br>
[EnOcean STM 330, Eltako FTF55, Thermokon SR65 ...]<br>
<ul>
<li>t/&#176C</li>
<li>temperature: t/&#176C (Sensor Range: t = &lt;t min&gt; &#176C ... &lt;t max&gt; &#176C)</li>
<li>state: t/&#176C</li>
</ul><br>
The attr subType must be tempSensor.01 ... tempSensor.30. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Temperatur and Humidity Sensor (EEP A5-04-02)<br>
[Eltako FAFT60, FIFT63AP]<br>
<ul>
<li>T: t/&#176C H: rH/% B: unknown|low|ok</li>
<li>battery: unknown|low|ok</li>
<li>energyStorage: unknown|empty|charged|full</li>
<li>humidity: rH/% (Sensor Range: rH = 0 % ... 100 %)</li>
<li>temperature: t/&#176C (Sensor Range: t = -20 &#176C ... 60 &#176C)</li>
<li>voltage: U/V</li> (Sensor Range: U = 0 V ... 6.6 V)
<li>state: T: t/&#176C H: rH/% B: unknown|low|ok</li>
</ul><br>
The attr subType must be tempHumiSensor.02 and attr
manufID must be 00D for Eltako Devices. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Light Sensor (EEP A5-06-01)<br>
[Eltako FAH60, FAH63, FIH63, Thermokon SR65 LI]<br>
<ul>
<li>E/lx</li>
<li>brightness: E/lx (Sensor Range: 300 lx ... 30 klx, 600 lx ... 60 klx
, Sensor Range for Eltako: E = 0 lx ... 100 lx, 300 lx ... 30 klx)</li>
<li>voltage: U/V</li> (Sensor Range: U = 0 V ... 5.1 V)
<li>state: E/lx</li>
</ul><br>
Eltako devices only support Brightness.<br>
The attr subType must be lightSensor.01 and attr manufID must be 00D
for Eltako Devices. This is done if the device was created by
autocreate.
</li>
<br><br>
<li>Light Sensor (EEP A5-06-02)<br>
[untested]<br>
<ul>
<li>E/lx</li>
<li>brightness: E/lx (Sensor Range: 0 lx ... 1020 lx</li>
<li>voltage: U/V (Sensor Range: U = 0 V ... 5.1 V)</li>
<li>state: E/lx</li>
</ul><br>
The attr subType must be lightSensor.02. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Light Sensor (EEP A5-06-03)<br>
[untested]<br>
<ul>
<li>E/lx</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 1000 lx, over range)</li>
<li>errorCode: 251 ... 255</li>
<li>state: E/lx</li>
</ul><br>
The attr subType must be lightSensor.03. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Occupancy Sensor (EEP A5-07-01, A5-07-02)<br>
[EnOcean EOSW, untested]<br>
<ul>
<li>on|off</li>
<li>errorCode: 251 ... 255</li>
<li>motion: on|off</li>
<li>voltage: U/V (Sensor Range: U = 0 V ... 5.0 V)</li>
<li>state: on|off</li>
</ul><br>
The attr subType must be occupSensor.<01|02>. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Occupancy Sensor (EEP A5-07-03)<br>
[untested]<br>
<ul>
<li>M: on|off E: E/lx U: U/V</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 1000 lx, over range)</li>
<li>errorCode: 251 ... 255</li>
<li>motion: on|off</li>
<li>voltage: U/V (Sensor Range: U = 0 V ... 5.0 V)</li>
<li>state: M: on|off E: E/lx U: U/V</li>
</ul><br>
The attr subType must be occupSensor.03. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Light, Temperatur and Occupancy Sensor (EEP A5-08-01 ... A5-08-03)<br>
[Eltako FABH63, FBH55, FBH63, FIBH63, Thermokon SR-MDS, PEHA 482 FU-BM DE]<br>
<ul>
<li>M: on|off E: E/lx P: absent|present T: t/&#176C U: U/V</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 510, 1020, 1530 or 2048 lx)</li>
<li>motion: on|off</li>
<li>presence: absent|present</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 51 &#176C or -30 &#176C ... 50 &#176C)</li>
<li>voltage: U/V</li> (Sensor Range: U = 0 V ... 5.1 V)
<li>state: M: on|off E: E/lx P: absent|present T: t/&#176C U: U/V</li>
</ul><br>
Eltako and PEHA devices only support Brightness and Motion.<br>
The attr subType must be lightTempOccupSensor.<01|02|03> and attr
manufID must be 00D for Eltako Devices. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Gas Sensor, CO Sensor (EEP A5-09-01)<br>
[untested]<br>
<ul>
<li>CO: c/ppm (Sensor Range: c = 0 ppm ... 255 ppm)</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 255 &#176C)</li>
<li>state: c/ppm</li>
</ul><br>
The attr subType must be COSensor.01. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Gas Sensor, CO Sensor (EEP A5-09-02)<br>
[untested]<br>
<ul>
<li>CO: c/ppm (Sensor Range: c = 0 ppm ... 1020 ppm)</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 51.0 &#176C)</li>
<li>voltage: U/V</li> (Sensor Range: U = 0 V ... 5.1 V)
<li>state: c/ppm</li>
</ul><br>
The attr subType must be COSensor.02. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Gas Sensor, CO2 Sensor (EEP A5-09-04)<br>
[Thermokon SR04 CO2 *, Eltako FCOTF63, untested]<br>
<ul>
<li>airQuality: high|mean|moderate|low (Air Quality Classes DIN EN 13779)</li>
<li>CO2: c/ppm (Sensor Range: c = 0 ppm ... 2550 ppm)</li>
<li>humidity: rH/% (Sensor Range: rH = 0 % ... 100 %)</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 51 &#176C)</li>
<li>state: CO2: c/ppm AQ: high|mean|moderate|low T: t/&#176C H: rH/%</li>
</ul><br>
The attr subType must be tempHumiCO2Sensor.01. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Gas Sensor, Volatile organic compounds (VOC) Sensor (EEP A5-09-05)<br>
[untested]<br>
<ul>
<li>concentration: c/ppb (Sensor Range: c = 0 ppb ... 655350 ppb)</li>
<li>vocName: Name of last measured VOC</li>
<li>state: c/ppb</li>
</ul><br>
The attr subType must be vocSensor.01. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Gas Sensor, Radon Sensor (EEP A5-09-06)<br>
[untested]<br>
<ul>
<li>Rn: A m3/Bq (Sensor Range: A = 0 Bq/m3 ... 1023 Bq/m3)</li>
<li>state: A m3/Bq</li>
</ul><br>
The attr subType must be radonSensor.01. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Gas Sensor, Particles Sensor (EEP A5-09-07)<br>
[untested]<br>
Three channels with particle sizes of up to 10 &mu;m, 2.5 &mu;m and 1 &mu;m are supported<br>.
<ul>
<li>particles_10: p m3/&mu;g | inactive (Sensor Range: p = 0 &mu;g/m3 ... 511 &mu;g/m3)</li>
<li>particles_2_5: p m3/&mu;g | inactive (Sensor Range: p = 0 &mu;g/m3 ... 511 &mu;g/m3)</li>
<li>particles_1: p m3/&mu;g | inactive (Sensor Range: p = 0 &mu;g/m3 ... 511 &mu;g/m3)</li>
<li>state: PM10: p m3/&mu;g PM2_5: p m3/&mu;g PM1: p m3/&mu;g</li>
</ul><br>
The attr subType must be particlesSensor.01. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-01 ... A5-10-0D)<br>
[Eltako FTR55*, Thermokon SR04 *, Thanos SR *]<br>
<ul>
<li>T: t/&#176C SP: 0 ... 255 F: 0|1|2|3|auto SW: 0|1</li>
<li>fanStage: 0|1|2|3|auto</li>
<li>switch: 0|1</li>
<li>setpoint: 0 ... 255</li>
<li>setpointScaled: &lt;floating-point number&gt;</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>state: T: t/&#176C SP: 0 ... 255 F: 0|1|2|3|auto SW: 0|1</li><br>
Alternatively for Eltako devices
<li>T: t/&#176C SPT: t/&#176C NR: t/&#176C</li>
<li>block: lock|unlock</li>
<li>nightReduction: t/K</li>
<li>setpointTemp: t/&#176C</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>state: T: t/&#176C SPT: t/&#176C NR: t/K</li><br>
</ul><br>
The scaling of the setpoint adjustment is device- and vendor-specific. Set the
attributes <a href="#scaleMax">scaleMax</a>, <a href="#scaleMin">scaleMin</a> and
<a href="#scaleDecimals">scaleDecimals</a> for the additional scaled reading
setpointScaled. Use attribut <a href="#userReadings">userReadings</a> to
adjust the scaling alternatively.<br>
The attr subType must be roomSensorControl.05 and attr
manufID must be 00D for Eltako Devices. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-04-01, A5-10-10 ... A5-10-14)<br>
[Thermokon SR04 * rH, Thanos SR *, untested]<br>
<ul>
<li>T: t/&#176C H: rH/% SP: 0 ... 255 SW: 0|1</li>
<li>humidity: rH/% (Sensor Range: rH = 0 % ... 100 %)</li>
<li>switch: 0|1</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>setpoint: 0 ... 255</li>
<li>setpointScaled: &lt;floating-point number&gt;</li>
<li>state: T: t/&#176C H: rH/% SP: 0 ... 255 SW: 0|1</li>
</ul><br>
The scaling of the setpoint adjustment is device- and vendor-specific. Set the
attributes <a href="#scaleMax">scaleMax</a>, <a href="#scaleMin">scaleMin</a> and
<a href="#scaleDecimals">scaleDecimals</a> for the additional scaled reading
setpointScaled. Use attribut <a href="#userReadings">userReadings</a> to
adjust the scaling alternatively.<br>
The attr subType must be roomSensorControl.01. This is
done if the device was created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-15 ... A5-10-17)<br>
[untested]<br>
<ul>
<li>T: t/&#176C SP: 0 ... 63 P: absent|present</li>
<li>presence: absent|present</li>
<li>temperature: t/&#176C (Sensor Range: t = -10 &#176C ... 41.2 &#176C)</li>
<li>setpoint: 0 ... 63</li>
<li>setpointScaled: &lt;floating-point number&gt;</li>
<li>state: T: t/&#176C SP: 0 ... 63 P: absent|present</li>
</ul><br>
The scaling of the setpoint adjustment is device- and vendor-specific. Set the
attributes <a href="#scaleMax">scaleMax</a>, <a href="#scaleMin">scaleMin</a> and
<a href="#scaleDecimals">scaleDecimals</a> for the additional scaled reading
setpointScaled. Use attribut <a href="#userReadings">userReadings</a> to
adjust the scaling alternatively.<br>
The attr subType must be roomSensorControl.02. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-18)<br>
[untested]<br>
<ul>
<li>T: t/&#176C B: E/lx F: 0|1|2|3|4|5|auto|off SP: t/&#176C P: absent|present|disabled</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 1000 lx, over range)</li>
<li>fan: 0|1|2|3|4|5|auto|off</li>
<li>presence: absent|present|disabled</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>setpoint: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>state: T: t/&#176C B: E/lx F: 0|1|2|3|4|5|auto|off SP: t/&#176C P: absent|present|disabled</li>
</ul><br>
The attr subType must be roomSensorControl.18. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-19)<br>
[untested]<br>
<ul>
<li>T: t/&#176C H: rH/% F: 0|1|2|3|4|5|auto|off SP: t/&#176C P: absent|present|disabled</li>
<li>fan: 0|1|2|3|4|5|auto|off</li>
<li>humidity: rH/% (Sensor Range: rH = 0 % ... 100 %)</li>
<li>presence: absent|present|disabled</li>
<li>setpoint: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>state: T: t/&#176C H: rH/% F: 0|1|2|3|4|5|auto|off SP: t/&#176C P: absent|present|disabled</li>
</ul><br>
The attr subType must be roomSensorControl.19. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-1A)<br>
[untested]<br>
<ul>
<li>T: t/&#176C F: 0|1|2|3|4|5|auto|off SP: t/&#176C P: absent|present|disabled U: U/V</li>
<li>errorCode: 251 ... 255</li>
<li>fan: 0|1|2|3|4|5|auto|off</li>
<li>presence: absent|present|disabled</li>
<li>setpoint: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>voltage: U/V (Sensor Range: U = 0 V ... 5.0 V)</li>
<li>state: T: t/&#176C F: 0|1|2|3|4|5|auto|off SP: t/&#176C P: absent|present|disabled U: U/V</li>
</ul><br>
The attr subType must be roomSensorControl.1A. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-1B, A5-10-1D)<br>
[untested]<br>
<ul>
<li>T: t/&#176C B: E/lx F: 0|1|2|3|4|5|auto|off P: absent|present|disabled U: U/V</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 1000 lx, over range)</li>
<li>errorCode: 251 ... 255</li>
<li>fan: 0|1|2|3|4|5|auto|off</li>
<li>presence: absent|present|disabled</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>voltage: U/V (Sensor Range: U = 0 V ... 5.0 V)</li>
<li>state: T: t/&#176C B: E/lx F: 0|1|2|3|4|5|auto|off P: absent|present|disabled U: U/V</li>
</ul><br>
The attr subType must be roomSensorControl.1B. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-1C)<br>
[untested]<br>
<ul>
<li>T: t/&#176C B: E/lx F: 0|1|2|3|4|5|auto|off SP: E/lx P: absent|present|disabled</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 1000 lx, over range)</li>
<li>fan: 0|1|2|3|4|5|auto|off</li>
<li>presence: absent|present|disabled</li>
<li>setpoint: E/lx (Sensor Range: E = 0 lx ... 1000 lx, over range)</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>state: T: t/&#176C B: E/lx F: 0|1|2|3|4|5|auto|off SP: E/lx P: absent|present|disabled</li>
</ul><br>
The attr subType must be roomSensorControl.1C. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-1D)<br>
[untested]<br>
<ul>
<li>T: t/&#176C H: rH/% F: 0|1|2|3|4|5|auto|off SP: rH/% P: absent|present|disabled</li>
<li>humidity: rH/% (Sensor Range: rH = 0 % ... 100 %)</li>
<li>fan: 0|1|2|3|4|5|auto|off</li>
<li>presence: absent|present|disabled</li>
<li>setpoint: rH/% (Sensor Range: rH = 0 % ... 100 %)</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>state: T: t/&#176C H: rH/% F: 0|1|2|3|4|5|auto|off SP: rH/% P: absent|present|disabled</li>
</ul><br>
The attr subType must be roomSensorControl.1D. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Room Sensor and Control Unit (EEP A5-10-1F)<br>
[untested]<br>
<ul>
<li>T: t/&#176C F: 0|1|2|3|auto SP: 0 ... 255 P: absent|present|disabled</li>
<li>fan: 0|1|2|3|auto</li>
<li>presence: absent|present|disabled</li>
<li>setpoint: 0 ... 255</li>
<li>setpointScaled: &lt;floating-point number&gt;</li>
<li>temperature: t/&#176C (Sensor Range: t = 0 &#176C ... 40 &#176C)</li>
<li>state: T: t/&#176C F: 0|1|2|3|auto SP: 0 ... 255 P: absent|present|disabled</li>
</ul><br>
The scaling of the setpoint adjustment is device- and vendor-specific. Set the
attributes <a href="#scaleMax">scaleMax</a>, <a href="#scaleMin">scaleMin</a> and
<a href="#scaleDecimals">scaleDecimals</a> for the additional scaled reading
setpointScaled. Use attribut <a href="#userReadings">userReadings</a> to
adjust the scaling alternatively.<br>
The attr subType must be roomSensorControl.1F. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Lighting Controller State (EEP A5-11-01)<br>
[untested]<br>
<ul>
<li>on|off</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 510 lx)</li>
<li>contact: open|closed</li>
<li>daylightHarvesting: enabled|disabled</li>
<li>dim: 0 ... 255</li>
<li>presence: absent|present</li>
<li>illum: 0 ... 255</li>
<li>mode: switching|dimming</li>
<li>powerRelayTimer: enabled|disabled</li>
<li>powerSwitch: on|off</li>
<li>repeater: enabled|disabled</li>
<li>state: on|off</li>
</ul><br>
The attr subType must be lightCtrlState.01 This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Temperature Controller Output (EEP A5-11-02)<br>
[untested]<br>
<ul>
<li>t/&#176C</li>
<li>alarm: on|off</li>
<li>controlVar: cvar (Sensor Range: cvar = 0 % ... 100 %)</li>
<li>controllerMode: auto|heating|cooling|off</li>
<li>controllerState: auto|override</li>
<li>energyHoldOff: normal|holdoff</li>
<li>fan: 0 ... 3|auto</li>
<li>presence: present|absent|standby|frost</li>
<li>setpointTemp: t/&#176C (Sensor Range: t = 0 &#176C ... 51.2 &#176C)</li>
<li>state: t/&#176C</li>
</ul><br>
The attr subType must be tempCtrlState.01 This is done if the device was
created by autocreate.
</li>
<br><br>
<li><a name="Blind Status">Blind Status</a> (EEP A5-11-03)<br>
[untested, experimental status]<br>
<ul>
<li>open|closed|not_reached|not_available</li>
<li>alarm: on|off|no endpoints defined|not used</li>
<li>anglePos: &alpha;/&#176 (Sensor Range: &alpha; = -360 &#176 ... 360 &#176)</li>
<li>endPosition: open|closed|not_reached|not_available</li>
<li>position: pos/% (Sensor Range: pos = 0 % ... 100 %)</li>
<li>positionMode: normal|inverse</li>
<li>serviceOn: yes|no</li>
<li>shutterState: opens|closes|stopped|not_available</li>
<li>state: open|closed|not_reached|not_available</li>
</ul><br>
The attr subType must be shutterCtrlState.01 This is done if the device was
created by autocreate.<br>
The profile is linked with <a href="#Blind Command Central">Blind Command Central</a>.
The profile <a href="#Blind Command Central">Blind Command Central</a>
controls the devices centrally. For that the attributes subDef, subTypeSet
and gwCmd have to be set manually.
</li>
<br><br>
<li>Extended Lighting Status (EEP A5-11-04)<br>
[untested, experimental status]<br>
<ul>
<li>on|off</li>
<li>alarm: off|lamp failure|internal failure|external periphery failure</li>
<li>dim: 0 ... 255</li>
<li>measuredValue: &lt;formula symbol&gt;/&lt;unit&gt; (Sensor range: &lt;formula symbol&gt; = 0 ... 65535 &lt;unit&gt;</li>
<li>measureUnit: mW|W|kW|MW|Wh|kWh|MWh|GWh|mA|1/10 A|mV|1/10 V</li>
<li>lampOpHours: t/h |unknown (Sensor range: t = 0 h ... 65535 h)</li>
<li>powerSwitch: on|off</li>
<li>RGB: R G B (RGB color component values: 0 ... 255)</li>
<li>serviceOn: yes|no</li>
<li>state: on|off</li>
</ul><br>
The attr subType must be lightCtrlState.02 This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Automated meter reading (AMR), Counter (EEP A5-12-00)<br>
[Thermokon SR-MI-HS, untested]<br>
<ul>
<li>1/s</li>
<li>currentValue: 1/s</li>
<li>counter<0 ... 15>: 0 ... 16777215</li>
<li>channel: 0 ... 15</li>
<li>state: 1/s</li>
</ul><br>
The attr subType must be autoMeterReading.00. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Automated meter reading (AMR), Electricity (EEP A5-12-01)<br>
[Eltako FSS12, DSZ14DRS, DSZ14WDRS, Thermokon SR-MI-HS, untested]<br>
[Eltako FWZ12-16A tested]<br>
<ul>
<li>P/W</li>
<li>power: P/W</li>
<li>energy<0 ... 15>: E/kWh</li>
<li>currentTariff: 0 ... 15</li>
<li>serialNumber: S-&lt;nnnnnn&gt;</li>
<li>state: P/W</li>
</ul><br>
The attr subType must be autoMeterReading.01 and attr
manufID must be 00D for Eltako Devices. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Automated meter reading (AMR), Gas, Water (EEP A5-12-02, A5-12-03)<br>
[untested]<br>
<ul>
<li>Vs/l</li>
<li>flowrate: Vs/l</li>
<li>consumption<0 ... 15>: V/m3</li>
<li>currentTariff: 0 ... 15</li>
<li>state: Vs/l</li>
</ul><br>
The attr subType must be autoMeterReading.02|autoMeterReading.02.
This is done if the device was created by autocreate.
</li>
<br><br>
<li>Environmental Applications<br>
Weather Station (EEP A5-13-01)<br>
Sun Intensity (EEP A5-13-02)<br>
[Eltako FWS61, untested]<br>
<ul>
<li>T: t/&#176C B: E/lx W: Vs/m IR: yes|no</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 999 lx)</li>
<li>dayNight: day|night</li>
<li>hemisphere: north|south</li>
<li>isRaining: yes|no</li>
<li>sunEast: E/lx (Sensor Range: E = 1 lx ... 150 klx)</li>
<li>sunSouth: E/lx (Sensor Range: E = 1 lx ... 150 klx)</li>
<li>sunWest: E/lx (Sensor Range: E = 1 lx ... 150 klx)</li>
<li>temperature: t/&#176C (Sensor Range: t = -40 &#176C ... 80 &#176C)</li>
<li>windSpeed: Vs/m (Sensor Range: V = 0 m/s ... 70 m/s)</li>
<li>state:T: t/&#176C B: E/lx W: Vs/m IR: yes|no</li>
</ul><br>
Brightness is the strength of the dawn light. SunEast,
sunSouth and sunWest are the solar radiation from the respective
compass direction. IsRaining is the rain indicator.<br>
The attr subType must be environmentApp and attr manufID must be 00D
for Eltako Devices. This is done if the device was created by
autocreate.<br>
The Eltako Weather Station FWS61 supports not the day/night indicator
(dayNight).<br>
</li>
<br><br>
<li>Environmental Applications<br>
EEP A5-13-03 ... EEP A5-13-06 are not implemented.
</li>
<br><br>
<li>Environmental Applications<br>
Sun Position and Radiation (EEP A5-13-10)<br>
[untested]<br>
<ul>
<li>SRA: E m2/W SNA: &alpha;/&deg; SNE: &beta;/&deg;</li>
<li>dayNight: day|night</li>
<li>solarRadiation: E m2/W (Sensor Range: E = 0 W/m2 ... 2000 W/m2)</li>
<li>sunAzimuth: &alpha;/&deg; (Sensor Range: &alpha; = -90 &deg; ... 90 &deg;)</li>
<li>sunElevation: &beta;/&deg; (Sensor Range: &beta; = 0 &deg; ... 90 &deg;)</li>
<li>state:SRA: E m2/W SNA: &alpha;/&deg; SNE: &beta;/&deg;</li>
</ul><br>
The attr subType must be environmentApp. This is done if the device was created by
autocreate.
</li>
<br><br>
<li>Multi-Func Sensor (EEP A5-14-01 ... A5-14-06)<br>
[untested]<br>
<ul>
<li>C: open|closed V: on|off E: E/lx U: U/V</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 1000 lx, over range)</li>
<li>contact: open|closed</li>
<li>errorCode: 251 ... 255</li>
<li>vibration: on|off</li>
<li>voltage: U/V (Sensor Range: U = 0 V ... 5.0 V)</li>
<li>state: C: open|closed V: on|off E: E/lx U: U/V</li>
</ul><br>
The attr subType must be multiFuncSensor. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Battery Powered Actuator (EEP A5-20-01)<br>
[Kieback&Peter MD15-FTL-xx]<br>
<ul>
<li>Actuator/%</li>
<li>actuator: ok|obstructed</li>
<li>battery: ok|low</li>
<li>currentValue: Actuator/%</li>
<li>cover: open|closed</li>
<li>energyInput: enabled|disabled</li>
<li>energyStorage: charged|empty</li>
<li>selfCtl: on|off</li>
<li>serviceOn: yes|no</li>
<li>temperature: t/&#176C</li>
<li>tempSensor: failed|ok</li>
<li>window: open|closed</li>
<li>state: Actuator/%</li>
</ul><br>
The attr subType must be MD15. This is done if the device was created by
autocreate.
</li>
<br><br>
<li>Digital Input (EEP A5-30-01, A5-30-02)<br>
[Thermokon SR65 DI, untested]<br>
<ul>
<li>open|closed</li>
<li>battery: ok|low (only EEP A5-30-01)</li>
<li>contact: open|closed</li>
<li>state: open|closed</li>
</ul><br>
The attr subType must be digitalInput.01 or digitalInput.02. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Switching<br>
[Eltako FLC61, FSA12, FSR14]<br>
<ul>
<li>on</li>
<li>off</li>
<li>executeTime: t/s (Sensor Range: t = 0.1 s ... 6553.5 s or 0 if no time specified)</li>
<li>executeType: duration|delay</li>
<li>block: lock|unlock</li>
<li>state: on|off</li>
</ul><br>
The attr subType must be gateway and gwCmd must be switching. This is done if the device was
created by autocreate.<br>
For Eltako devices attributes must be set manually. Eltako devices only send on/off.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Dimming<br>
[Eltako FUD14, FUD61, FUD70, FSG14, ...]<br>
<ul>
<li>on</li>
<li>off</li>
<li>block: lock|unlock</li>
<li>dim: dim/% (Sensor Range: dim = 0 % ... 100 %)</li>
<li>dimValueLast: dim/%<br>
Last value received from the bidirectional dimmer.</li>
<li>dimValueStored: dim/%<br>
Last value saved by <code>set &lt;name&gt; dim &lt;value&gt;</code>.</li>
<li>rampTime: t/s (Sensor Range: t = 1 s ... 255 s or 0 if no time specified,
for Eltako: t = 1 = fast dimming ... 255 = slow dimming or 0 = dimming speed on the dimmer used)</li>
<li>state: on|off</li>
</ul><br>
The attr subType must be gateway, gwCmd must be dimming and attr manufID must be 00D
for Eltako Devices. This is done if the device was created by autocreate.<br>
For Eltako devices attributes must be set manually. Eltako devices only send on/off and dim.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Setpoint shift<br>
[untested]<br>
<ul>
<li>1/K</li>
<li>setpointShift: 1/K (Sensor Range: T = -12.7 K ... 12.8 K)</li>
<li>state: 1/K</li>
</ul><br>
The attr subType must be gateway, gwCmd must be setpointShift.
This is done if the device was created by autocreate.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Basic Setpoint<br>
[untested]<br>
<ul>
<li>t/&#176C</li>
<li>setpoint: t/&#176C (Sensor Range: t = 0 &#176C ... 51.2 &#176C)</li>
<li>state: t/&#176C</li>
</ul><br>
The attr subType must be gateway, gwCmd must be setpointBasic.
This is done if the device was created by autocreate.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Control variable<br>
[untested]<br>
<ul>
<li>auto|heating|cooling|off</li>
<li>controlVar: cvov (Sensor Range: cvov = 0 % ... 100 %)</li>
<li>controllerMode: auto|heating|cooling|off</li>
<li>controllerState: auto|override</li>
<li>energyHoldOff: normal|holdoff</li>
<li>presence: present|absent|standby</li>
<li>state: auto|heating|cooling|off</li>
</ul><br>
The attr subType must be gateway, gwCmd must be controlVar.
This is done if the device was created by autocreate.
</li>
<br><br>
<li>Gateway (EEP A5-38-08)<br>
Fan stage<br>
[untested]<br>
<ul>
<li>0 ... 3|auto</li>
<li>state: 0 ... 3|auto</li>
</ul><br>
The attr subType must be gateway, gwCmd must be fanStage.
This is done if the device was created by autocreate.
</li>
<br><br>
<li>Manufacturer Specific Applications (EEP A5-3F-7F)<br><br>
Wireless Analog Input Module<br>
[Thermokon SR65 3AI, untested]<br>
<ul>
<li>I1: U/V I2: U/V I3: U/V</li>
<li>input1: U/V (Sensor Range: U = 0 V ... 10 V)</li>
<li>input2: U/V (Sensor Range: U = 0 V ... 10 V)</li>
<li>input3: U/V (Sensor Range: U = 0 V ... 10 V)</li>
<li>state: I1: U/V I2: U/V I3: U/V</li>
</ul><br>
The attr subType must be manufProfile and attr manufID must be 002
for Thermokon Devices. This is done if the device was
created by autocreate.
</li>
<br><br>
<li>Manufacturer Specific Applications (EEP A5-3F-7F)<br><br>
Shutter (EEP F6-02-01 ... F6-02-02)<br>
[Eltako FSB12, FSB14, FSB61, FSB70]<br>
<ul>
<li>teach<br>
Teach-In is sent</li>
<li>open|open_ack<br>
The status of the device will become "open" after the TOP endpoint is
reached, or it has finished an "opens" or "position 0" command.</li>
<li>closed<br>
The status of the device will become "closed" if the BOTTOM endpoint is
reached</li>
<li>stop<br>
The status of the device become "stop" if stop command is sent.</li>
<li>not_reached<br>
The status of the device become "not_reached" between one of the endpoints.</li>
<li>anglePos: &alpha;/&#176 (Sensor Range: &alpha; = -180 &#176 ... 180 &#176)</li>
<li>buttons: pressed|released</li>
<li>endPosition: open|open_ack|closed|not_reached|not_available</li>
<li>position: pos/% (Sensor Range: pos = 0 % ... 100 %)</li>
<li>state: open|open_ack|closed|not_reached|stop|teach</li>
</ul><br>
The values of the reading position and anglePos are updated automatically,
if the command position is sent or the reading state was changed
manually to open or closed.<br>
Set attr subType to manufProfile, attr manufID to 00D and attr model to
FSB14|FSB61|FSB70 manually.
</li>
<br><br>
<li>Electronic switches and dimmers with Energy Measurement and Local Control (D2-01-00 - D2-01-11)<br>
[Telefunken Funktionsstecker]<br>
<ul>
<li>on</li>
<li>off</li>
<li>channel&lt;0...29|All|Input&gt;: on|off</li>
<li>dayNight: day|night</li>
<li>defaultState: on|off|last</li>
<li>dim&lt;0...29|Input&gt;: dim/% (Sensor Range: dim = 0 % ... 100 %)</li>
<li>energy&lt;channel&gt;: 1/[Ws|Wh|KWh]</li>
<li>energyUnit&lt;channel&gt;: Ws|Wh|KWh</li>
<li>error&lt;channel&gt;: ok|warning|failure</li>
<li>localControl&lt;channel&gt;: enabled|disabled</li>
<li>measurementMode: energy|power</li>
<li>measurementReport: auto|query</li>
<li>measurementReset: not_active|trigger</li>
<li>measurementDelta: 1/[Ws|Wh|KWh|W|KW]</li>
<li>measurementUnit: Ws|Wh|KWh|W|KW</li>
<li>overCurrentOff&lt;channel&gt;: executed|ready</li>
<li>overCurrentShutdown&lt;channel&gt;: off|restart</li>
<li>overCurrentShutdownReset&lt;channel&gt;: not_active|trigger</li>
<li>power&lt;channel&gt;: 1/[W|KW]</li>
<li>powerUnit&lt;channel&gt;: W|KW</li>
<li>rampTime&lt;1...3l&gt;: 1/s</li>
<li>responseTimeMax: 1/s</li>
<li>responseTimeMin: 1/s</li>
<li>teachInDev: enabled|disabled</li>
<li>state: on|off</li>
</ul><br>
<br>
The attr subType must be actuator.01. This is done if the device was
created by autocreate. To control the device, it must be bidirectional paired,
see <a href="#EnOcean_teach-in">Bidirectional Teach-In / Teach-Out</a>.
</li>
<br><br>
<li><a name="RAW Command">RAW Command</a><br>
<br>
<ul>
<li>RORG: 1BS|4BS|MCS|RPS|UTE|VLD</li>
<li>dataSent: data (Range: 1-byte hex ... 28-byte hex)</li>
<li>statusSent: status (Range: 0x00 ... 0xFF)</li>
<li>state: RORG: rorg DATA: data STATUS: status ODATA: odata</li>
</ul><br>
With the help of this command data messages in hexadecimal format can be sent and received.
The telegram types (RORG) 1BS and RPS are always received protocol-specific.
For further information, see
<a href="http://www.enocean-alliance.org/eep/">EnOcean Equipment Profiles (EEP)</a>.
<br>
Set attr subType to raw manually.
</li>
<br><br>
<li>Light and Presence Sensor<br>
[Omnio Ratio eagle-PM101]<br>
<ul>
<li>yes</li>
<li>no</li>
<li>brightness: E/lx (Sensor Range: E = 0 lx ... 1000 lx)</li>
<li>channel1: yes|no<br>
Motion message in depending on the brightness threshold</li>
<li>channel2: yes|no<br>
Motion message</li>
<li>motion: yes|no<br>
Channel 2</li>
<li>state: yes|no<br>
Channel 2</li>
</ul><br>
The sensor also sends switching commands (RORG F6) with the SenderID-1.<br>
Set attr subType to PM101 manually. Automatic teach-in is not possible,
since no EEP and manufacturer ID are sent.
</li>
</ul>
</ul>
=end html
=cut
Reference in New Issue View Git Blame Copy Permalink