diff --git a/fhem/FHEM/72_FB_CALLMONITOR.pm b/fhem/FHEM/72_FB_CALLMONITOR.pm
index 576e4eb7b..927662e18 100755
--- a/fhem/FHEM/72_FB_CALLMONITOR.pm
+++ b/fhem/FHEM/72_FB_CALLMONITOR.pm
@@ -750,7 +750,7 @@ sub FB_CALLMONITOR_loadCacheFile($)
The FB_CALLMONITOR module connects to a AVM FritzBox Fon and listens for telephone
events (Receiving incoming call, Making a call)
- In order to use this module with fhem you must enable the CallMonitor feature via
+ In order to use this module with fhem you must enable the Callmonitor feature via
telephone shortcode.
#96*5* - for activating
#96*4* - for deactivating
@@ -758,8 +758,8 @@ sub FB_CALLMONITOR_loadCacheFile($)
Just dial the shortcode for activating on one of your phones, after 3 seconds just hang up. The feature is now activated.
-
- After activating the CallMonitor-Support in your FritzBox, this module is able to
+
+ After activating the Callmonitor-Support in your FritzBox, this module is able to
generate an event for each external call. Internal calls were not be detected by the Callmonitor.
This module work with any FritzBox Fon model.
@@ -805,7 +805,7 @@ sub FB_CALLMONITOR_loadCacheFile($)
If is set to "none", then no reverse searching will be used.
Default value is "none".
- reverse-search-cache
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.
+ and will be used instead of reverse searching every time the same number.
Possible values: 0 => off , 1 => on
Default Value is 0 (off)
- reverse-search-cache-file <file>
@@ -816,7 +816,7 @@ sub FB_CALLMONITOR_loadCacheFile($)
The phonebook file can be obtained by an export via FritzBox web UI
Default value is /var/flash/phonebook (phonebook filepath on FritzBox)
- remove-leading-zero
- If this attribute is activated, a leading zero will be removed from the external_number (e.g. in telefon systems).
+ 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)
- unique-call-ids
@@ -836,12 +836,12 @@ sub FB_CALLMONITOR_loadCacheFile($)
- external_number - The participants number which is calling (event: ring) or beeing called (event: call)
- external_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 - The internal number (fixed line, VoIP number, ...) on which the participant is calling (event: ring) or is used for calling (event: call)
- - internal_connection - The internal connection (FON1, FON2, ISDN, DECT, ...) which is used to take the call
- - external_connection - The external connection (fixed line, VoIP account) which is used to take the call
+ - internal_connection - The internal connection (FON1, FON2, ISDN, DECT, ...) which is used to take or perform the call
+ - external_connection - The external connection (fixed line, VoIP account) which is used to take or perform the call
- call_duration - The call duration in seconds. Is only generated at a disconnect event. The value 0 means, the call was not taken by anybody.
- call_id - The call identification number to separate events of two or more different calls at the same time. This id number is equal for all events relating to one specific call.
- missed_call - This event will be raised in case of a missing incoming call. If available, also the name of the calling number will be displayed.
- - missed_call_line - Will be raised together with "missed_call". It shows the number of the line which received the missed call.
+ - missed_call_line - Will be raised together with "missed_call". It shows the number of the internal line which received the missed call.
@@ -856,16 +856,16 @@ sub FB_CALLMONITOR_loadCacheFile($)
Das Modul FB_CALLMONITOR verbindet sich zu einer AVM FritzBox Fon und verarbeitet
Telefonie-Ereignisse.(eingehende & ausgehende Telefonate)
- Um dieses Modul nutzen zu können, muss der CallMonitor via Kurzwahl mit einem Telefon aktiviert werden.
+ Um dieses Modul nutzen zu können, muss der Callmonitor via Kurzwahl mit einem Telefon aktiviert werden.
.
- #96*5* - CallMonitor aktivieren
#96*4* - CallMonitor deaktivieren
+ #96*5* - Callmonitor aktivieren
#96*4* - Callmonitor deaktivieren
Einfach die entsprechende Kurzwahl auf irgend einem Telefon eingeben, welches an die Fritz!Box angeschlossen ist.
- Nach ca. 3 Sekunden kann man einfach wieder auflegen. Nun ist der CallMonitor aktiviert.
-
- Sobald der CallMonitor auf der Fritz!Box aktiviert wurde erzeugt das Modul entsprechende Events (s.u.) für alle externen Anrufe. Interne Anrufe werden nicht durch den Callmonitor erfasst.
+ Nach ca. 3 Sekunden kann man einfach wieder auflegen. Nun ist der Callmonitor aktiviert.
+
+ Sobald der Callmonitor auf der Fritz!Box aktiviert wurde erzeugt das Modul entsprechende Events (s.u.) für alle externen Anrufe. Interne Anrufe werden nicht durch den Callmonitor erfasst.
Dieses Modul funktioniert mit allen Fritz!Box Modellen, welche Telefonie unterstützen (Namenszusatz: Fon).
@@ -912,45 +912,45 @@ sub FB_CALLMONITOR_loadCacheFile($)
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.
+ Wenn dieses Attribut gesetzt ist, werden alle Ergebisse der Rückwärtssuche in einem modul-internen Cache gespeichert
+ und alle existierenden Ergebnisse 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 <Dateipfad>
- 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.
+ Da der Cache nur im Arbeitsspeicher existiert, ist er nicht persistent 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 wieder in den Cache geladen und genutzt.
reverse-search-phonebook-file <Dateipfad>
Mit diesem Attribut kann man optional den Pfad zu einer Datei angeben, welche ein Telefonbuch im FritzBox-Format (XML-Struktur) enthält.
Dadurch ist es möglich ein FritzBox-Telefonbuch zu verwenden, ohne das FHEM auf einer FritzBox laufen muss.
Sofern FHEM auf einer FritzBox läuft (und nichts abweichendes angegeben wurde), wird das interne File /var/flash/phonebook verwendet. Alternativ kann man das Telefonbuch in der FritzBox-Weboberfläche exportieren und dieses verwenden
- Standartwert ist /var/flash/phonebook (entspricht dem Pfad auf einer FritzBox)
+ Standardwert ist /var/flash/phonebook (entspricht dem Pfad auf einer FritzBox)
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)
unique-call-ids
- Wenn dieses Attribut aktiviert ist, wird für jedes Gespräch eine eineindeutige Identifizierungsnummer verwendet. Dadurch lassen sich auch bereits beendete Gespräche voneinander unterscheiden. Dies ist zum Beispiel notwendig bei der Verarbeitung der Events durch eine Datenbank.
+ Wenn dieses Attribut aktiviert ist, wird für jedes Gespräch eine eineindeutige Identifizierungsnummer verwendet. Dadurch lassen sich auch bereits beendete Gespräche voneinander unterscheiden. Dies ist z.B. notwendig bei der Verarbeitung der Events durch eine Datenbank.
Mögliche Werte: 0 => deaktiviert , 1 => aktiviert
Standardwert ist 0 (deaktiviert)
local-area-code
- Verwendet die gesetze Vorwahlnummer bei Rückwärtssuchen bei Ortsgesprächen (z.B. 0228 für Bonn)
+ Verwendet die gesetze Vorwahlnummer bei Rückwärtssuchen von Ortsgesprächen (z.B. 0228 für Bonn)
Generierte Events:
- - event (call|ring|connect|disconnect) - Welches Event wurde genau ausgelöst.
+ - event (call|ring|connect|disconnect) - Welches Event wurde genau ausgelöst. ("call" => ausgehender Rufversuch, "ring" => eingehender Rufversuch, "connect" => Gespräch ist zustande gekommen, "disconnect" => es wurde aufgelegt)
- direction (incoming|outgoing) - Die Anruf-Richtung ("incoming" => eingehender Anruf, "outgoing" => ausgehender Anruf)
- external_number - Die Rufnummer des Gegenübers, welcher anruft (event: ring) oder angerufen wird (event: call)
- - external_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.
+ - external_name - Das Ergebniss der Rückwärtssuche (sofern aktiviert). Im Fehlerfall kann diese Reading auch den Inhalt "unknown" (keinen Eintrag gefunden) oder "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 - 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 - Der interne Anschluss an der Fritz!Box welcher genutzt wird um das Gespräch durchzuführen (FON1, FON2, ISDN, DECT, ...)
- external_connection - Der externe Anschluss welcher genutzt wird um das Gespräch durchzuführen (Festnetz, VoIP Nummer, ...)
- call_duration - Die Gesprächsdauer in Sekunden. Dieser Wert wird nur bei einem disconnect-Event erzeugt. Ist der Wert 0, so wurde das Gespräch von niemandem angenommen.
- - call_id - Die Identifizierungsnummer eines einzelnen Gesprächs. Dient der Zuordnung bei 2 oder mehr parallelen Gesprächen, damit alle Events eindeutig einem Gespräch zugeordnet werden können
+ - call_id - Die Identifizierungsnummer eines einzelnen Gesprächs. Dient der Zuordnung bei zwei oder mehr parallelen Gesprächen, damit alle Events eindeutig einem Gespräch zugeordnet werden können
- missed_call - Dieses Event wird nur generiert, wenn ein eingehender Anruf nicht beantwortet wird. Sofern der Name dazu bekannt ist, wird dieser ebenfalls mit angezeigt.
- missed_call_line - Analog zu "missed_call" wird dieses Event nur generiert, wenn ein eingehender Anruf nicht beantwortet wird. Es zeigt die Rufnummer an über, den dieser unbeantwortete Anruf eingegangen ist.