mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-01-31 18:59:33 +00:00
753 lines
20 KiB
Perl
Executable File
753 lines
20 KiB
Perl
Executable File
##############################################
|
|
# $Id$
|
|
package main;
|
|
|
|
# by r.koenig at koeniglich.de
|
|
#
|
|
# This modules handles the communication with a TCM120 or TCM310 EnOcean
|
|
# transceiver chip. As the protocols are radically different, this is actually 2
|
|
# drivers in one.
|
|
# See also:
|
|
# TCM_120_User_Manual_V1.53_02.pdf
|
|
# EnOcean Serial Protocol 3 (ESP3) (for the TCM310)
|
|
|
|
|
|
# TODO:
|
|
# Check BSC Temp
|
|
# Check Stick Temp
|
|
# Check Stick WriteRadio
|
|
# Check Stick RSS
|
|
|
|
use strict;
|
|
use warnings;
|
|
use Time::HiRes qw(gettimeofday);
|
|
|
|
sub TCM_Read($);
|
|
sub TCM_ReadAnswer($$);
|
|
sub TCM_Ready($);
|
|
sub TCM_Write($$$);
|
|
|
|
sub TCM_Parse120($$$);
|
|
sub TCM_CRC8($);
|
|
sub TCM_CSUM($);
|
|
|
|
sub
|
|
TCM_Initialize($)
|
|
{
|
|
my ($hash) = @_;
|
|
|
|
require "$attr{global}{modpath}/FHEM/DevIo.pm";
|
|
|
|
# Provider
|
|
$hash->{ReadFn} = "TCM_Read";
|
|
$hash->{WriteFn} = "TCM_Write";
|
|
$hash->{ReadyFn} = "TCM_Ready";
|
|
$hash->{Clients} = ":EnOcean:";
|
|
my %matchList= (
|
|
"1:EnOcean" => "^EnOcean:",
|
|
);
|
|
$hash->{MatchList} = \%matchList;
|
|
|
|
# Normal devices
|
|
$hash->{DefFn} = "TCM_Define";
|
|
$hash->{UndefFn} = "TCM_Undef";
|
|
$hash->{GetFn} = "TCM_Get";
|
|
$hash->{SetFn} = "TCM_Set";
|
|
$hash->{AttrList}= "do_not_notify:1,0 dummy:1,0 loglevel:0,1,2,3,4,5,6";
|
|
}
|
|
|
|
#####################################
|
|
sub
|
|
TCM_Define($$)
|
|
{
|
|
my ($hash, $def) = @_;
|
|
my @a = split("[ \t][ \t]*", $def);
|
|
my $name = $a[0];
|
|
my $model = $a[2];
|
|
|
|
return "wrong syntax. Correct is: define <name> TCM [120|310] ".
|
|
"{devicename[\@baudrate]|ip:port}"
|
|
if(@a != 4 || $model !~ m/^(120|310)$/);
|
|
|
|
DevIo_CloseDev($hash);
|
|
my $dev = $a[3];
|
|
|
|
if($dev eq "none") {
|
|
Log 1, "$name device is none, commands will be echoed only";
|
|
$attr{$name}{dummy} = 1;
|
|
return undef;
|
|
}
|
|
|
|
$hash->{DeviceName} = $dev;
|
|
$hash->{MODEL} = $model;
|
|
my $ret = DevIo_OpenDev($hash, 0, undef);
|
|
return $ret;
|
|
}
|
|
|
|
|
|
#####################################
|
|
# Input is HEX, without header and CRC
|
|
sub
|
|
TCM_Write($$$)
|
|
{
|
|
my ($hash,$fn,$msg) = @_;
|
|
my $name = $hash->{NAME};
|
|
my $ll5 = GetLogLevel($name,5);
|
|
|
|
return if(!defined($fn));
|
|
|
|
my $bstring;
|
|
if($hash->{MODEL} eq "120") {
|
|
$bstring = "$fn$msg";
|
|
$bstring = "A55A".$bstring.TCM_CSUM($bstring);
|
|
|
|
} else { # 310 / ESP3
|
|
|
|
if(!$fn) { # "Old-Type" Radio Packet
|
|
$msg =~ m/^6B05(..)000000(........)(..)$/;
|
|
$fn = "00070701";
|
|
$msg = "F6$1$2${3}03FFFFFFFFFF00";
|
|
}
|
|
$bstring = sprintf("55%s%s%s%s", # $fn == Header, $msg == DATA
|
|
$fn, TCM_CRC8($fn), $msg, TCM_CRC8($msg));
|
|
|
|
}
|
|
Log $ll5, "$hash->{NAME} sending $bstring";
|
|
|
|
DevIo_SimpleWrite($hash, $bstring, 1);
|
|
}
|
|
|
|
#####################################
|
|
# Used in the TCM120 / ESP2
|
|
sub
|
|
TCM_CSUM($)
|
|
{
|
|
my $msg = shift;
|
|
my $ml = length($msg);
|
|
|
|
my @data;
|
|
for(my $i = 0; $i < $ml; $i += 2) {
|
|
push(@data, ord(pack('H*', substr($msg, $i, 2))));
|
|
}
|
|
my $sum = 0;
|
|
map { $sum += $_; } @data;
|
|
return sprintf("%02X", $sum & 0xFF);
|
|
}
|
|
|
|
#####################################
|
|
# Used in the TCM310 / ESP3
|
|
my @u8CRC8Table = (
|
|
0x00, 0x07, 0x0e, 0x09, 0x1c, 0x1b, 0x12, 0x15, 0x38, 0x3f, 0x36, 0x31, 0x24,
|
|
0x23, 0x2a, 0x2d, 0x70, 0x77, 0x7e, 0x79, 0x6c, 0x6b, 0x62, 0x65, 0x48, 0x4f,
|
|
0x46, 0x41, 0x54, 0x53, 0x5a, 0x5d, 0xe0, 0xe7, 0xee, 0xe9, 0xfc, 0xfb, 0xf2,
|
|
0xf5, 0xd8, 0xdf, 0xd6, 0xd1, 0xc4, 0xc3, 0xca, 0xcd, 0x90, 0x97, 0x9e, 0x99,
|
|
0x8c, 0x8b, 0x82, 0x85, 0xa8, 0xaf, 0xa6, 0xa1, 0xb4, 0xb3, 0xba, 0xbd, 0xc7,
|
|
0xc0, 0xc9, 0xce, 0xdb, 0xdc, 0xd5, 0xd2, 0xff, 0xf8, 0xf1, 0xf6, 0xe3, 0xe4,
|
|
0xed, 0xea, 0xb7, 0xb0, 0xb9, 0xbe, 0xab, 0xac, 0xa5, 0xa2, 0x8f, 0x88, 0x81,
|
|
0x86, 0x93, 0x94, 0x9d, 0x9a, 0x27, 0x20, 0x29, 0x2e, 0x3b, 0x3c, 0x35, 0x32,
|
|
0x1f, 0x18, 0x11, 0x16, 0x03, 0x04, 0x0d, 0x0a, 0x57, 0x50, 0x59, 0x5e, 0x4b,
|
|
0x4c, 0x45, 0x42, 0x6f, 0x68, 0x61, 0x66, 0x73, 0x74, 0x7d, 0x7a, 0x89, 0x8e,
|
|
0x87, 0x80, 0x95, 0x92, 0x9b, 0x9c, 0xb1, 0xb6, 0xbf, 0xb8, 0xad, 0xaa, 0xa3,
|
|
0xa4, 0xf9, 0xfe, 0xf7, 0xf0, 0xe5, 0xe2, 0xeb, 0xec, 0xc1, 0xc6, 0xcf, 0xc8,
|
|
0xdd, 0xda, 0xd3, 0xd4, 0x69, 0x6e, 0x67, 0x60, 0x75, 0x72, 0x7b, 0x7c, 0x51,
|
|
0x56, 0x5f, 0x58, 0x4d, 0x4a, 0x43, 0x44, 0x19, 0x1e, 0x17, 0x10, 0x05, 0x02,
|
|
0x0b, 0x0c, 0x21, 0x26, 0x2f, 0x28, 0x3d, 0x3a, 0x33, 0x34, 0x4e, 0x49, 0x40,
|
|
0x47, 0x52, 0x55, 0x5c, 0x5b, 0x76, 0x71, 0x78, 0x7f, 0x6A, 0x6d, 0x64, 0x63,
|
|
0x3e, 0x39, 0x30, 0x37, 0x22, 0x25, 0x2c, 0x2b, 0x06, 0x01, 0x08, 0x0f, 0x1a,
|
|
0x1d, 0x14, 0x13, 0xae, 0xa9, 0xa0, 0xa7, 0xb2, 0xb5, 0xbc, 0xbb, 0x96, 0x91,
|
|
0x98, 0x9f, 0x8a, 0x8D, 0x84, 0x83, 0xde, 0xd9, 0xd0, 0xd7, 0xc2, 0xc5, 0xcc,
|
|
0xcb, 0xe6, 0xe1, 0xe8, 0xef, 0xfa, 0xfd, 0xf4, 0xf3 );
|
|
|
|
sub
|
|
TCM_CRC8($)
|
|
{
|
|
my $msg = shift;
|
|
my $ml = length($msg);
|
|
|
|
my @data;
|
|
for(my $i = 0; $i < $ml; $i += 2) {
|
|
push(@data, ord(pack('H*', substr($msg, $i, 2))));
|
|
}
|
|
my $crc = 0;
|
|
map { $crc = $u8CRC8Table[$crc ^ $_]; } @data;
|
|
return sprintf("%02X", $crc);
|
|
}
|
|
|
|
#####################################
|
|
# called from the global loop, when the select for hash->{FD} reports data
|
|
sub
|
|
TCM_Read($)
|
|
{
|
|
my ($hash) = @_;
|
|
|
|
my $buf = DevIo_SimpleRead($hash);
|
|
return "" if(!defined($buf));
|
|
|
|
my $name = $hash->{NAME};
|
|
my $ll5 = GetLogLevel($name,5);
|
|
my $ll2 = GetLogLevel($name,2);
|
|
|
|
my $data = $hash->{PARTIAL} . uc(unpack('H*', $buf));
|
|
Log $ll5, "$name/RAW: $data";
|
|
|
|
#############################
|
|
if($hash->{MODEL} == 120) {
|
|
|
|
while($data =~ m/^A55A(.B.{20})(..)/) {
|
|
my ($net, $crc) = ($1, $2);
|
|
my $mycrc = TCM_CSUM($net);
|
|
my $rest = substr($data, 28);
|
|
|
|
if($crc ne $mycrc) {
|
|
Log $ll2, "$name: wrong checksum: got $crc, computed $mycrc" ;
|
|
$data = $rest;
|
|
next;
|
|
}
|
|
|
|
# Receive Radio Telegram (RRT)
|
|
if($net =~ m/^0B(..)(........)(........)(..)/) {
|
|
my ($org, $d1,$id,$status) = ($1, $2, $3, $4);
|
|
|
|
# Re-translate the ORG to RadioORG / TCM310 equivalent
|
|
my %orgmap = ("05"=>"F6", "06"=>"D5", "07"=>"A5", );
|
|
if($orgmap{$org}) {
|
|
$org = $orgmap{$org};
|
|
} else {
|
|
Log 1, "TCM120: unknown ORG mapping for $org";
|
|
}
|
|
Dispatch($hash, "EnOcean:$org:$d1:$id:$status", undef);
|
|
|
|
} else { # Receive Message Telegram (RMT)
|
|
TCM_Parse120($hash, $net, 0);
|
|
|
|
}
|
|
$data = $rest;
|
|
}
|
|
|
|
if(length($data) >= 4) {
|
|
$data =~ s/.*A55A/A55A/ if($data !~ m/^A55A/);
|
|
$data = "" if($data !~ m/^A55A/);
|
|
}
|
|
|
|
#############################
|
|
} else { # TCM310 / ESP3
|
|
|
|
while($data =~ m/^55(....)(..)(..)(..)/) {
|
|
my ($l1, $l2, $t, $crc) = (hex($1), hex($2), $3, $4);
|
|
|
|
my $tlen = 2*(7+$l1+$l2);
|
|
last if(length($data) < $tlen);
|
|
|
|
my $rest = substr($data, $tlen);
|
|
$data = substr($data, 0, $tlen);
|
|
|
|
my $hdr = substr($data, 2, 8);
|
|
my $mdata = substr($data, 12, $l1*2);
|
|
my $odata = substr($data, 12+$l1*2, $l2*2);
|
|
|
|
my $mycrc = TCM_CRC8($hdr);
|
|
if($mycrc ne $crc) {
|
|
Log $ll2, "$name: wrong header checksum: got $crc, computed $mycrc" ;
|
|
$data = $rest;
|
|
next;
|
|
}
|
|
$mycrc = TCM_CRC8($mdata . $odata);
|
|
$crc = substr($data, -2);
|
|
if($mycrc ne $crc) {
|
|
Log $ll2, "$name: wrong data checksum: got $crc, computed $mycrc" ;
|
|
$data = $rest;
|
|
next;
|
|
}
|
|
|
|
if($t eq "01") { # Radio
|
|
$mdata =~ m/^(..)(.*)(........)(..)$/;
|
|
my ($org, $d1, $id, $status) = ($1,$2,$3,$4);
|
|
|
|
$odata =~ m/^(..)(........)(..)(..)$/;
|
|
my %addvals = (SubTelNum => hex($1), DestinationID => $2,
|
|
RSSI => hex($3), SecurityLevel => hex($4),);
|
|
$hash->{RSSI} = hex($3);
|
|
|
|
Dispatch($hash, "EnOcean:$org:$d1:$id:$status:$odata", \%addvals);
|
|
|
|
} elsif($t eq "02") {
|
|
my $rc = substr($mdata, 0, 2);
|
|
my %codes = (
|
|
"00"=>"RET_OK",
|
|
"01"=>"RET_ERROR",
|
|
"02"=>"RET_NOT_SUPPORTED",
|
|
"03"=>"RET_WRONG_PARAM",
|
|
"04"=>"RET_OPERATION_DENIED",
|
|
);
|
|
$rc = $codes{$rc} if($codes{$rc});
|
|
Log (($rc eq "RET_OK") ? $ll5 : $ll2, "$name: RESPONSE: $rc") ;
|
|
|
|
} else {
|
|
Log $ll2, "$name: unknown packet type $t: $data" ;
|
|
|
|
}
|
|
|
|
$data = $rest;
|
|
}
|
|
|
|
if(length($data) >= 4) {
|
|
$data =~ s/.*55/55/ if($data !~ m/^55/);
|
|
$data = "" if($data !~ m/^55/);
|
|
}
|
|
|
|
}
|
|
$hash->{PARTIAL} = $data;
|
|
}
|
|
|
|
#####################################
|
|
my %parsetbl120 = (
|
|
"8B08" => { msg=>"ERR_SYNTAX_H_SEQ" },
|
|
"8B09" => { msg=>"ERR_SYNTAX_LENGTH" },
|
|
"8B0A" => { msg=>"ERR_SYNTAX_CHKSUM" },
|
|
"8B0B" => { msg=>"ERR_SYNTAX_ORG" },
|
|
"8B0C" => { msg=>"ERR_MODEM_DUP_ID" },
|
|
"8B19" => { msg=>"ERR" },
|
|
"8B1A" => { msg=>"ERR_IDRANGE" },
|
|
"8B22" => { msg=>"ERR_TX_IDRANGE" },
|
|
"8B28" => { msg=>"ERR_MODEM_NOTWANTEDACK" },
|
|
"8B29" => { msg=>"ERR_MODEM_NOTACK" },
|
|
"8B58" => { msg=>"OK" },
|
|
"8B8C" => { msg=>"INF_SW_VER", expr=>'"$a[2].$a[3].$a[4].$a[5]"' },
|
|
"8B88" => { msg=>"INF_RX_SENSIVITY", expr=>'$a[2] ? "High (01)":"Low (00)"' },
|
|
"8B89" => { msg=>"INFO", expr=>'substr($rawstr,2,9)' },
|
|
"8B98" => { msg=>"INF_IDBASE",
|
|
expr=>'sprintf("%02x%02x%02x%02x", $a[2], $a[3], $a[4], $a[5])' },
|
|
"8BA8" => { msg=>"INF_MODEM_STATUS",
|
|
expr=>'sprintf("%s, ID:%02x%02x", $a[2]?"on":"off", $a[3], $a[4])' },
|
|
);
|
|
|
|
sub
|
|
TCM_Parse120($$$)
|
|
{
|
|
my ($hash,$rawmsg,$ret) = @_;
|
|
my $name = $hash->{NAME};
|
|
my $ll5 = GetLogLevel($name,5);
|
|
my $ll2 = GetLogLevel($name,2);
|
|
|
|
Log $ll5, "TCMParse: $rawmsg";
|
|
|
|
my $msg = "";
|
|
my $cmd = $parsetbl120{substr($rawmsg, 0, 4)};
|
|
|
|
if(!$cmd) {
|
|
$msg ="Unknown command: $rawmsg";
|
|
|
|
} else {
|
|
if($cmd->{expr}) {
|
|
$msg = $cmd->{msg}." " if(!$ret);
|
|
my $rawstr = pack('H*', $rawmsg);
|
|
$rawstr =~ s/[\r\n]//g;
|
|
my @a = map { ord($_) } split("", $rawstr);
|
|
$msg .= eval $cmd->{expr};
|
|
|
|
} else {
|
|
return "" if($cmd ->{msg} eq "OK" && !$ret); # SKIP Ok
|
|
$msg = $cmd->{msg};
|
|
|
|
}
|
|
|
|
}
|
|
|
|
Log $ll2, "$name $msg" if(!$ret);
|
|
return $msg;
|
|
}
|
|
|
|
my %rc310 = (
|
|
"01" => "ERROR",
|
|
"02" => "NOT_SUPPORTED",
|
|
"03" => "WRONG_PARAM",
|
|
"04" => "OPERATION_DENIED",
|
|
);
|
|
|
|
sub
|
|
TCM_Parse310($$$)
|
|
{
|
|
my ($hash,$rawmsg,$ptr) = @_;
|
|
my $name = $hash->{NAME};
|
|
my $ll5 = GetLogLevel($name,5);
|
|
my $ll2 = GetLogLevel($name,2);
|
|
|
|
Log $ll5, "TCMParse: $rawmsg";
|
|
|
|
my $rc = substr($rawmsg, 0, 2);
|
|
my $msg;
|
|
|
|
if($rc ne "00") {
|
|
my $msg = $rc310{$rc};
|
|
$msg = "Unknown return code $rc" if(!$msg);
|
|
|
|
} else {
|
|
my @ans;
|
|
foreach my $k (sort keys %{$ptr}) {
|
|
next if($k eq "cmd" || $k eq "arg");
|
|
my ($off, $len, $type) = split(",", $ptr->{$k});
|
|
my $data = substr($rawmsg, $off*2, $len*2);
|
|
$data = pack('H*', $data) if($type && $type eq "STR");
|
|
push @ans, "$k=$data";
|
|
}
|
|
$msg = join(",", @ans);
|
|
}
|
|
|
|
Log $ll2, "$name $msg";
|
|
return $msg;
|
|
}
|
|
|
|
|
|
#####################################
|
|
sub
|
|
TCM_Ready($)
|
|
{
|
|
my ($hash) = @_;
|
|
|
|
return DevIo_OpenDev($hash, 1, undef)
|
|
if($hash->{STATE} eq "disconnected");
|
|
|
|
# This is relevant for windows/USB only
|
|
my $po = $hash->{USBDev};
|
|
my ($BlockingFlags, $InBytes, $OutBytes, $ErrorFlags) = $po->status;
|
|
return ($InBytes>0);
|
|
}
|
|
|
|
my %gets120 = (
|
|
"sensitivity" => "AB48",
|
|
"idbase" => "AB58",
|
|
"modem_status" => "AB68",
|
|
"sw_ver" => "AB4B",
|
|
);
|
|
|
|
my %gets310 = (
|
|
"sw_ver" => {cmd=>"03",
|
|
APPVersion => "1,4",
|
|
APIVersion => "5,4",
|
|
ChipID => "9,4",
|
|
ChipVersion => "13,4",
|
|
Desc => "17,16,STR", },
|
|
"idbase" => {cmd=>"08",
|
|
BaseId => "1,4",
|
|
RemainingWriteCycles => "5,1",},
|
|
);
|
|
|
|
|
|
sub
|
|
TCM_Get($@)
|
|
{
|
|
my ($hash, @a) = @_;
|
|
my $name = $hash->{NAME};
|
|
|
|
return "\"get $name\" needs one parameter" if(@a != 2);
|
|
my $cmd = $a[1];
|
|
my ($err, $msg);
|
|
|
|
#################################### TCM120
|
|
if($hash->{MODEL} eq "120") {
|
|
my $rawcmd = $gets120{$cmd};
|
|
return "Unknown argument $cmd, choose one of " .
|
|
join(" ", sort keys %gets120) if(!defined($rawcmd));
|
|
|
|
$rawcmd .= "000000000000000000";
|
|
TCM_Write($hash, "", $rawcmd);
|
|
|
|
($err, $msg) = TCM_ReadAnswer($hash, "get $cmd");
|
|
$msg = TCM_Parse120($hash, $msg, 1)
|
|
if(!$err);
|
|
|
|
#################################### TCM310
|
|
} else {
|
|
my $cmdhash = $gets310{$cmd};
|
|
return "Unknown argument $cmd, choose one of " .
|
|
join(" ", sort keys %gets310) if(!defined($cmdhash));
|
|
|
|
my $cmdHex = $cmdhash->{cmd};
|
|
TCM_Write($hash, sprintf("%04X0005", length($cmdHex)/2), $cmdHex);
|
|
($err, $msg) = TCM_ReadAnswer($hash, "get $cmd");
|
|
$msg = TCM_Parse310($hash, $msg, $cmdhash)
|
|
if(!$err);
|
|
|
|
}
|
|
|
|
if($err) {
|
|
Log 1, $err;
|
|
return $err;
|
|
}
|
|
$hash->{READINGS}{$cmd}{VAL} = $msg;
|
|
$hash->{READINGS}{$cmd}{TIME} = TimeNow();
|
|
return $msg;
|
|
|
|
}
|
|
|
|
########################
|
|
sub
|
|
TCM_RemovePair($)
|
|
{
|
|
my $hash = shift;
|
|
delete($hash->{pair});
|
|
}
|
|
|
|
my %sets120 = ( # Name, Data to send to the CUL, Regexp for the answer
|
|
"pairForSec" => { cmd=>"AB18", arg=>"\\d+" },
|
|
"idbase" => { cmd=>"AB18", arg=>"FF[8-9A-F][0-9A-F]{5}" },
|
|
"sensitivity" => { cmd=>"AB08", arg=>"0[01]" },
|
|
"sleep" => { cmd=>"AB09" },
|
|
"wake" => { cmd=>"" }, # Special
|
|
"reset" => { cmd=>"AB0A" },
|
|
"modem_on" => { cmd=>"AB28", arg=>"[0-9A-F]{4}" },
|
|
"modem_off" => { cmd=>"AB2A" },
|
|
);
|
|
|
|
my %sets310 = (
|
|
"pairForSec" => { cmd=>"AB18", arg=>"\\d+" },
|
|
"idbase" => { cmd=>"07", arg=>"FF[8-9A-F][0-9A-F]{5}" },
|
|
# The following 3 does not seem to work / dont get an answer
|
|
# "sleep" => { cmd=>"01", arg=>"00[0-9A-F]{6}" },
|
|
# "reset" => { cmd=>"02" },
|
|
# "bist" => { cmd=>"06", BIST_Result=>"1,1", },
|
|
);
|
|
|
|
sub
|
|
TCM_Set($@)
|
|
{
|
|
my ($hash, @a) = @_;
|
|
my $name = $hash->{NAME};
|
|
|
|
return "\"set $name\" needs at least one parameter" if(@a < 2);
|
|
my $cmd = $a[1];
|
|
my $arg = $a[2];
|
|
my ($err, $msg);
|
|
|
|
my $chash = ($hash->{MODEL} eq "120" ? \%sets120 : \%sets310);
|
|
my $cmdhash = $chash->{$cmd};
|
|
return "Unknown argument $cmd, choose one of ".join(" ",sort keys %{$chash})
|
|
if(!defined($cmdhash));
|
|
|
|
my $cmdHex = $cmdhash->{cmd};
|
|
my $argre = $cmdhash->{arg};
|
|
if($argre) {
|
|
return "Argument needed for set $name $cmd ($argre)" if(!defined($arg));
|
|
return "Argument does not match the regexp ($argre)"
|
|
if($arg !~ m/$argre/i);
|
|
$cmdHex .= $arg;
|
|
}
|
|
|
|
if($cmd eq "pairForSec") {
|
|
$hash->{pair} = 1;
|
|
InternalTimer(gettimeofday()+$arg, "TCM_RemovePair", $hash, 1);
|
|
return;
|
|
}
|
|
|
|
##############################
|
|
if($hash->{MODEL} eq "120") {
|
|
if($cmdHex eq "") { # wake is very special
|
|
DevIo_SimpleWrite($hash, "AA", 1);
|
|
return "";
|
|
}
|
|
|
|
$cmdHex .= "0"x(22-length($cmdHex)); # Padding with 0
|
|
TCM_Write($hash, "", $cmdHex);
|
|
($err, $msg) = TCM_ReadAnswer($hash, "get $cmd");
|
|
$msg = TCM_Parse120($hash, $msg, 1)
|
|
if(!$err);
|
|
|
|
##############################
|
|
} else { # TCM310
|
|
TCM_Write($hash, sprintf("%04X0005", length($cmdHex)/2), $cmdHex);
|
|
($err, $msg) = TCM_ReadAnswer($hash, "set $cmd");
|
|
$msg = TCM_Parse310($hash, $msg, $cmdhash)
|
|
if(!$err);
|
|
|
|
}
|
|
|
|
if($err) {
|
|
Log 1, $err;
|
|
return $err;
|
|
}
|
|
return $msg;
|
|
}
|
|
|
|
|
|
sub
|
|
TCM_ReadAnswer($$)
|
|
{
|
|
my ($hash, $arg) = @_;
|
|
my $name = $hash->{NAME};
|
|
my $ll5 = GetLogLevel($name,5);
|
|
|
|
return ("No FD", undef)
|
|
if(!$hash || ($^O !~ /Win/ && !defined($hash->{FD})));
|
|
|
|
my ($data, $rin, $buf) = ("", "", "");
|
|
my $to = 3; # 3 seconds timeout
|
|
for(;;) {
|
|
if($^O =~ m/Win/ && $hash->{USBDev}) {
|
|
$hash->{USBDev}->read_const_time($to*1000); # set timeout (ms)
|
|
# Read anstatt input sonst funzt read_const_time nicht.
|
|
$buf = $hash->{USBDev}->read(999);
|
|
return ("$name Timeout reading answer for $arg", undef)
|
|
if(length($buf) == 0);
|
|
|
|
} else {
|
|
return ("Device lost when reading answer for $arg", undef)
|
|
if(!$hash->{FD});
|
|
|
|
vec($rin, $hash->{FD}, 1) = 1;
|
|
my $nfound = select($rin, undef, undef, $to);
|
|
if($nfound < 0) {
|
|
next if ($! == EAGAIN() || $! == EINTR() || $! == 0);
|
|
my $err = $!;
|
|
DevIo_Disconnected($hash);
|
|
return("TCM_ReadAnswer $err", undef);
|
|
}
|
|
return ("Timeout reading answer for $arg", undef)
|
|
if($nfound == 0);
|
|
$buf = DevIo_SimpleRead($hash);
|
|
return ("No data", undef) if(!defined($buf));
|
|
|
|
}
|
|
|
|
if(defined($buf)) {
|
|
$data .= uc(unpack('H*', $buf));
|
|
Log $ll5, "TCM/RAW (ReadAnswer): $data";
|
|
|
|
if($hash->{MODEL} eq "120") {
|
|
if(length($data) >= 28) {
|
|
return ("$arg: Bogus answer received: $data", undef)
|
|
if($data !~ m/^A55A(.B.{20})(..)/);
|
|
my ($net, $crc) = ($1, $2);
|
|
my $mycrc = TCM_CSUM($net);
|
|
$hash->{PARTIAL} = substr($data, 28);
|
|
|
|
return ("wrong checksum: got $crc, computed $mycrc", undef)
|
|
if($crc ne $mycrc);
|
|
return (undef, $net);
|
|
}
|
|
|
|
} else { # 310
|
|
if(length($data) >= 7) {
|
|
return ("$arg: Bogus answer received: $data", undef)
|
|
if($data !~ m/^55(....)(..)(..)(..)(.*)(..)$/);
|
|
my ($dlen, $olen, $ptype, $hcrc, $data, $dcrc) = ($1,$2,$3,$4,$5,$6);
|
|
next if(length($data) < hex($dlen)+hex($olen)+6);
|
|
|
|
my $myhcrc = TCM_CRC8("$dlen$olen$ptype");
|
|
return ("wrong header checksum: got $hcrc, computed $myhcrc", undef)
|
|
if($hcrc ne $myhcrc);
|
|
|
|
my $mydcrc = TCM_CRC8($data);
|
|
return ("wrong data checksum: got $dcrc, computed $mydcrc", undef)
|
|
if($dcrc ne $mydcrc);
|
|
return (undef, $data);
|
|
}
|
|
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
sub
|
|
TCM_Undef($$)
|
|
{
|
|
my ($hash, $arg) = @_;
|
|
my $name = $hash->{NAME};
|
|
|
|
foreach my $d (sort keys %defs) {
|
|
if(defined($defs{$d}) &&
|
|
defined($defs{$d}{IODev}) &&
|
|
$defs{$d}{IODev} == $hash)
|
|
{
|
|
my $lev = ($reread_active ? 4 : 2);
|
|
Log GetLogLevel($name,$lev), "deleting port for $d";
|
|
delete $defs{$d}{IODev};
|
|
}
|
|
}
|
|
DevIo_CloseDev($hash);
|
|
return undef;
|
|
}
|
|
|
|
1;
|
|
|
|
=pod
|
|
=begin html
|
|
|
|
<a name="TCM"></a>
|
|
<h3>TCM</h3>
|
|
<ul>
|
|
The TCM module serves an USB or TCP/IP connected TCM120 or TCM310 EnOcean
|
|
Transceiver module. These are mostly packaged together with a serial to USB
|
|
chip and an antenna, e.g. the BSC BOR contains the TCM120, the EUL from
|
|
busware contains a TCM310. See also the datasheet available from <a
|
|
href="http://www.enocean.com">www.enocean.com</a>.
|
|
<br>
|
|
As the TCM120 and the TCM310 speak completely different protocols, this
|
|
module implements 2 drivers in one. It is the "physical" part for the <a
|
|
href="#EnOcean">EnOcean</a> module.<br><br>
|
|
|
|
<a name="TCMdefine"></a>
|
|
<b>Define</b>
|
|
<ul>
|
|
<code>define <name> TCM [120|310] <device></code> <br>
|
|
<br>
|
|
First you have to specify the type of the EnOcean Transceiver Chip , i.e
|
|
either 120 for the TCM120 or 310 for the TCM310.<br><br>
|
|
<code>device</code> can take the same parameters (@baudrate, @directio,
|
|
TCP/IP, none) like the <a href="#CULdefine">CUL</a>, but you probably have
|
|
to specify the baudrate: the TCM120 should be opened with 9600 Baud, the
|
|
TCM310 with 57600 baud.
|
|
Example:
|
|
<ul><code>
|
|
define BscBor TCM 120 /dev/ttyACM0@9600<br>
|
|
define TCM310 TCM 310 /dev/ttyACM0@57600<br>
|
|
</code></ul>
|
|
|
|
</ul>
|
|
<br>
|
|
|
|
<a name="TCMset"></a>
|
|
<b>Set </b>
|
|
<ul>
|
|
<li>idbase<br>
|
|
Set the ID base. Note: The firmware executes this command only up to
|
|
then times to prevent misuse.
|
|
</li>
|
|
<li>modem_off</li>
|
|
<li>modem_on</li>
|
|
<li>reset</li>
|
|
<li>sensitivity</li>
|
|
<li>sleep</li>
|
|
<li>wake
|
|
For details see the datasheet available from
|
|
www.enocean.com. If you do not understand it, than you probably don't
|
|
need it :)
|
|
</li><br><br>
|
|
</ul>
|
|
|
|
<a name="TCMget"></a>
|
|
<b>Get</b>
|
|
<ul>
|
|
<li>idbase<br>
|
|
Get the ID base. You need this command in order to control EnOcean
|
|
devices, see the <a href="#EnOceandefine">EnOcean</a>
|
|
paragraph.</li>><br>
|
|
<li>modem_status</li><br>
|
|
<li>sensitivity</li><br>
|
|
<li>sw_ver<br>
|
|
for details see the datasheet available from www.enocean.com
|
|
</li><br>
|
|
</ul>
|
|
|
|
<a name="TCMattr"></a>
|
|
<b>Attributes</b>
|
|
<ul>
|
|
<li><a href="#do_not_notify">do_not_notify</a></li>
|
|
<li><a href="#attrdummy">dummy</a></li>
|
|
<li><a href="#loglevel">loglevel</a></li>
|
|
</ul>
|
|
<br>
|
|
</ul>
|
|
|
|
=end html
|
|
=cut
|