From 680746213fec989a8fc4904bc1d884728ef0761b Mon Sep 17 00:00:00 2001
From: markusbloch <>
Date: Wed, 5 Dec 2012 20:54:51 +0000
Subject: [PATCH] added remove-leading-zero feature, updated english/german
commandref
git-svn-id: https://svn.fhem.de/fhem/trunk@2268 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
fhem/FHEM/72_FB_CALLMONITOR.pm | 50 ++++++++++++++++++++++++++--------
1 file changed, 38 insertions(+), 12 deletions(-)
diff --git a/fhem/FHEM/72_FB_CALLMONITOR.pm b/fhem/FHEM/72_FB_CALLMONITOR.pm
index 967cb6b6d..973708ecf 100755
--- a/fhem/FHEM/72_FB_CALLMONITOR.pm
+++ b/fhem/FHEM/72_FB_CALLMONITOR.pm
@@ -87,7 +87,7 @@ FB_CALLMONITOR_Initialize($)
$hash->{ReadyFn} = "FB_CALLMONITOR_Ready";
$hash->{DefFn} = "FB_CALLMONITOR_Define";
$hash->{UndefFn} = "FB_CALLMONITOR_Undef";
- $hash->{AttrList}= "do_not_notify:0,1 reverse-search-cache-file reverse-search:all,klicktel.de,dasoertliche.de,none reverse-search-cache:0,1 event-on-update-reading event-on-change-reading";
+ $hash->{AttrList}= "do_not_notify:0,1 remove-leading-zero:0,1 reverse-search-cache-file reverse-search:all,klicktel.de,dasoertliche.de,none reverse-search-cache:0,1 event-on-update-reading event-on-change-reading";
}
@@ -160,22 +160,24 @@ FB_CALLMONITOR_Read($)
my @array;
my $reverse_search = undef;
my $data = $buf;
+ my $external_number = undef;
+
+
@array = split(";", $data);
- $reverse_search = FB_CALLMONITOR_reverseSearch($hash, $array[3]) if(not $array[3] eq "0" and $array[1] eq "RING" and AttrVal($name, "reverse-search", "none") ne "none");
- $reverse_search = FB_CALLMONITOR_reverseSearch($hash, $array[5]) if($array[1] eq "CALL" and AttrVal($name, "reverse-search", "none") ne "none");
+ $external_number = $array[3] if(not $array[3] eq "0" and $array[1] eq "RING");
+ $external_number = $array[5] if($array[1] eq "CALL");
-
+ $external_number =~ s/^0// if(AttrVal($name, "remove-leading-zero", "0") eq "1");
+ $reverse_search = FB_CALLMONITOR_reverseSearch($hash, $external_number) if(AttrVal($name, "reverse-search", "none") ne "none");
+
readingsBeginUpdate($hash);
readingsBulkUpdate($hash, "event", lc($array[1]));
- readingsBulkUpdate($hash, "external_number", $array[3]) if(not $array[3] eq "0" and $array[1] eq "RING");
+ readingsBulkUpdate($hash, "external_number", $external_number) if(defined($external_number));
readingsBulkUpdate($hash, "external_name", $reverse_search) if(defined($reverse_search));
- readingsBulkUpdate($hash, "internal_number", $array[4]) if($array[1] eq "RING");
- readingsBulkUpdate($hash, "external_number" , $array[5]) if($array[1] eq "CALL");
-
- readingsBulkUpdate($hash, "internal_number", $array[4]) if($array[1] eq "CALL");
+ readingsBulkUpdate($hash, "internal_number", $array[4]) if($array[1] eq "RING" or $array[1] eq "CALL");
readingsBulkUpdate($hash, "external_connection", $array[5]) if($array[1] eq "RING");
readingsBulkUpdate($hash, "external_connection", $array[6]) if($array[1] eq "CALL");
readingsBulkUpdate($hash, "internal_connection", $connection_type{$array[3]}) if($array[1] eq "CALL" or $array[1] eq "CONNECT" and defined($connection_type{$array[3]}));
@@ -440,10 +442,14 @@ sub FB_CALLMONITOR_loadCacheFile($)
If this attribute is activated each reverse-search result is saved in an internal cache
and will be used instead of reverse searching again the same number.
Possible values: 0 => off , 1 => on
- Default Value is 0 (off)
+ Default Value is 0 (off)
reverse-search-cache-file <file>
Write the internal reverse-search-cache to the given file and use it next time FHEM starts.
- So all reverse search results are persistent written to disk and will be used instantly after FHEM starts.
+ So all reverse search results are persistent written to disk and will be used instantly after FHEM starts.
+ remove-leading-zero
+ If this attribute is activated, a leading zero will be removed from the external_number (e.g. in telefon systems).
+ Possible values: 0 => off , 1 => on
+ Default Value is 0 (off)
@@ -452,7 +458,7 @@ sub FB_CALLMONITOR_loadCacheFile($)
- event: (call|ring|connect|disconnect) - which event in detail was triggerd
- external_number: $number - The participants number which is calling (event: ring) or beeing called (event: call)
- - external_name: $name - The result of the reverse lookup of the external_number via internet. Is only available if reverse-search is activated.
+ - external_name: $name - The result of the reverse lookup of the external_number via internet. Is only available if reverse-search is activated. Special values are "unknown" (no search results found) and "timeout" (got timeout while search request). In case of an timeout and activated caching, the number will be searched again next time a call occurs with the same number
- internal_number: $number - The internal number (fixed line, VoIP number, ...) on which the participant is calling (event: ring) or is used for calling (event: call)
- internal_connection: $connection - The internal connection (FON1, FON2, ISDN, DECT, ...) which is used to take the call
- external_connection: $connection - The external connection (fixed line, VoIP account) which is used to take the call
@@ -515,6 +521,25 @@ sub FB_CALLMONITOR_loadCacheFile($)
- do_not_notify
- event-on-update-reading
- event-on-change-reading
+ - reverse-search (all|klicktel.de|dasoertliche.de|none)
+ Aktiviert die Rückwärtssuche der externen Rufnummer der Gegenstelle (bei eingehenden/abgehenden Anrufen).
+ Es ist möglich einen bestimmten Suchanbieter zu verwenden, welcher für die Rückwärtssuche verwendet werden soll.
+ Wenn dieses Attribut auf dem Wert "all" steht, werden alle verfügbaren Suchanbieter für die Rückwärtssuche herangezogen, solange bis irgend ein Anbieter ein valides Ergebniss liefert.
+ Wenn der Wert "none" ist, wird keine Rückwärtssuche durchgeführt.
Standardwert ist "none" (keine Rückwärtssuche).
+ - reverse-search-cache
+ Wenn dieses Attribut gesetzt ist, werden alle Ergebisse der Rückwärtssuche in einem modul-internen gespeichert
+ und von da an nur noch aus dem Cache genutzt anstatt eine erneute Rückwärtssuche durchzuführen.
+ Mögliche Werte: 0 => deaktiviert , 1 => aktiviert
+ Standardwert ist 0 (deaktiviert)
+ - reverse-search-cache-file <file>
+ Da der Cache nur im Arbeitsspeicher existiert, ist er nicht persisten und geht beim stoppen von FHEM verloren.
+ Mit diesem Parameter werden alle Cache-Ergebnisse in eine Textdatei geschrieben (z.B. /usr/share/fhem/telefonbuch.txt)
+ und beim nächsten Start von FHEM direkt wieder in den Cache geladen und genutzt.
+
+ - remove-leading-zero
+ Wenn dieses Attribut aktiviert ist, wird die führende Null aus der externen Rufnummer (bei eingehenden & abgehenden Anrufen) entfernt. Dies ist z.B. notwendig bei Telefonanlagen.
+ Mögliche Werte: 0 => deaktiviert , 1 => aktiviert
+ Standardwert ist 0 (deaktiviert)
@@ -523,6 +548,7 @@ sub FB_CALLMONITOR_loadCacheFile($)
- event: (call|ring|connect|disconnect) - Welches Event wurde genau ausgelöst.
- external_number: $number - Die Rufnummer des Gegenübers, welcher anruft (event: ring) oder angerufen wird (event: call)
+ - external_name: $name - Das Ergebniss der Rückwärtssuche (sofern aktiviert). Im Fehlerfall kann diese Reading auch den Inhalt "unknown" (keinen Eintrag gefunden) und "timeout" (Zeitüberschreitung bei der Abfrage) enthalten. Im Falle einer Zeitüberschreitung und aktiviertem Caching, wird die Rufnummer beim nächsten Mal erneut gesucht.
- internal_number: $number - Die interne Rufnummer (Festnetz, VoIP-Nummer, ...) auf welcher man angerufen wird (event: ring) oder die man gerade nutzt um jemanden anzurufen (event: call)
- internal_connection: $connection - Der interne Anschluss an der Fritz!Box welcher genutzt wird um das Gespräch durchzuführen (FON1, FON2, ISDN, DECT, ...)
- external_connection: $connection - Der externe Anschluss welcher genutzt wird um das Gespräch durchzuführen (Festnetz, VoIP Nummer, ...)