FHEMWiki - Benutzerbeiträge [de]

Z-Wave Command Classes

2017-08-07T06:49:16Z

Zephyr: DOOR_LOCK_LOGGING ist inzwischen unterstützt durch Beitrag durch Nutzer Zephyr

{{Randnotiz|RNTyp=Info|RNText=Dieser Artikel wurde vor Veröffentlichung der [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification] am 31.08.2016 erstellt. Die Informationen zu den Command Classes waren bis zu diesem Zeitpunkt nicht offengelegt, die Versionen/Namen der Klassen wurden anhand der nun verfügbaren Dokumentation angepasst (03-09.2016)}}
[[Z-Wave Command Classes]] sind Klassen von Befehlen oder Protokollen, die zur Kommunikation und Steuerung der Z-Wave-Geräte dienen.

Auf dieser Seite werden einige Grundlagen zu diesen Command Classes von Z-Wave, sowie deren Implementierung in FHEM beschrieben. Allgemeine Grundlagen zu Z-Wave finden sich im [[Z-Wave|Z-Wave Hauptartikel]].

== Command Classes ==
=== Einleitung ===
Entstanden ist dieser Artikel da die Dokumentation der Z-Wave Command Classes zum damaligen Zeitpunkt leider (noch) nicht offengelegt waren, wodurch die verfügbaren Informationen teilweise veraltet, unvollständig oder auch falsch waren. Am 31.08.2016 hat Sigma Designs die Dokumentationen der ZWave Command Classes freigegeben (siehe: [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification]). Die Informationen auf dieser Seite wurden nach Erscheinen dieser offiziellen Dokumente angepasst, dieser Artikel erhebt dennoch keinen Anspruch auf Vollständigkeit, Aktualität oder Richtigkeit. Er soll vielmehr dazu dienen, die bekannten Command Classes aufzulisten, sowie einen Hinweis auf deren Unterstützung in FHEM zu geben.

=== Allgemeines ===
Die Kommunikation zwischen den Z-Wave Nodes erfolgt über festgelegte Protokolle, welche jeweils in den Command Classes festgelegt sind. Für jede Gerätefunktion gibt es eine Command Class, ein Gerät hat jedoch im Allgemeinen mehrere Funktionen und damit auch mehrere Command Classes.

Wie im Z-Wave Basisartikel beschrieben, ist die minimale Anforderung an ein Geräte die Unterstützung der Command Class "CLASS_BASIC". Diese "BASIC" Klasse wird von den Geräten nicht explizit in der Liste Ihrer unterstützten Klassen aufgeführt, laut Spezifikation soll jedes Gerät diese Klasse unterstützen bzw. mit Nachrichten dieser Klasse umgehen können.

Eine schaltbare Zwischensteckdose unterstützt z.B. die folgenden Command Classes:
SWITCH_BINARY VERSION METER MANUFACTURER_SPECIFIC CONFIGURATION ASSOCIATION PROTECTION POWERLEVEL SENSOR_MULTILEVEL SWITCH_ALL

Dies ist jedoch von Hersteller zu Hersteller verschieden, in diesem Beispiel ist die Klasse "METER" z.B. für das Auslesen der Leistung zuständig, d.h. dieser Zwischenstecker kann z.B. auch die Leistung messen. Andere Steckdosenschalter ohne diese Funktion würden diese Klasse dementsprechend auch nicht unterstützen.

Aktuell sind weit mehr als 100 solcher Klassen definiert, hinzu kommt, dass diese Klassen in verschiedenen Versionen existieren. Die ständige Weiterentwicklung der Gerätefunktionen erfordert teilweise eine Erweiterung der jeweils betroffenen Command Classes, was sich in einer geänderten Definition der verwendeten Protokolle auswirkt. Im allgemeinen wird hier eine Abwärtskompatibilität eingehalten, sodass die Funktionen bis zu der unterstützten Version auch von Geräten mit höheren Versionen genutzt werden können.

Den Command Classes ist jeweils eine eindeutige ID zugeordnet. Diese ID wird in der Kommunikation dazu genutzt die jeweilige Geräteklasse anzusprechen.

Der COMMAND_CLASS_METER ist beispielsweise die ID 0x32 (hexadezimal) bzw. 50 (dezimal) zugeordnet. Um die unterstützte Version einer Klasse abzufragen wird die COMMAND_CLASS_VERSION genutzt. In FHEM wird die Version der Klasse des Gerätes durch den Befehl:

get <devicename> versionClass <ID>

abgefragt, die <ID> ist hier dezimal anzugeben. Als Ausgabe wird von FHEM dann z.B.:

versionClass_50:2

erzeugt und es wird ein gleichnamiges Reading für das Gerät angelegt. In diesem Fall also die Version 2, meist nur als V2 angegeben.

Um herauszufinden, ob ein Gerät prinzipiell von FHEM unterstützt wird, werden daher die Informationen zu den Command Classes bzw. deren Versionen benötigt:
* Liste der vom Gerät unterstützten Command Classes
** Informationen zu den Versionen der Command Class
* Liste der von FHEM unterstützten Command Classes
** Informationen zu den von FHEM unterstützten Versionen der Command Class

(Grundlegende) Informationen zu den ersten beiden Punkten finden sich relativ häufig bereits in der Anleitung der Geräte, evtl. hilft auch eine Suche im Internet mit der Gerätebezeichnung und dem Stichwort "COMMAND CLASS".

Für die letzten beiden Punkte soll dieser Artikel die nötigen Informationen bereitstellen, bzw. eine Abschätzung liefern ob das Gerät unterstützt wird.

Sollte zumindest die Liste der Command Classes des Gerätes in FHEM als unterstützt gekennzeichnet sein, so wird das Gerät höchstwahrscheinlich unterstützt werden, eine Garantie ist es jedoch noch nicht. Falls die Versionen der Command Classes unterschiedlich ist, so wird eventuell nur ein begrenzter Funktionsumfang dieser Klasse nutzbar sein. Es ist jedoch auch möglich das ein Gerät zwar eine höhere Version einer Command Class unterstützt, trotzdem aber selbst keine dieser neuen Funktion nutzt. Genausogut können in der höheren Version Funktionen definiert sein, die für den Betrieb des Gerätes nicht zwingend nötig sind.

Fehlt die Unterstützung für eine Klasse jedoch ganz, kann dies für die Funktion des Geräte von entscheidender Bedeutung sein und die Nutzung unter FHEM dadurch aktuell nicht möglich sein.

In FHEM sind die für die Hausautomatisierung wichtigsten Klassen bereits soweit implementiert, wie es für den Betrieb der meisten Geräte nötig ist. Sollten Geräte mit neuen Funktionen "auftauchen", so kann entweder anhand vorhandener Informationen zu den jeweiligen Command Classes oder aber durch "Trial and Error" versucht werden diese Funktion zu implementieren.

Als Beispiel sei hier die Implementation der Command Class USER_CODE (0x63) genannt, die für den Betrieb eines RFID Keypads nötig war, da über diese Klasse die Verwaltung der RFID-Tags und Eingabecodes stattfinden. Das Gerät ist [[Z-Wave-ZIP WT-RFID Keypad|hier]] beschrieben, die Diskussion im Forum mit der Implementierung kann ({{Link2Forum
|Topic=36856
|Message=291216
|LinkText=hier
}}) nachgelesen werden.

Im Zweifel sollte man im Vorfeld versuchen, so viele Informationen wie möglich zusammenzutragen und sich dann mit einer entsprechenden Frage im Forum von FHEM zu melden.

=== Liste von bekannten Command Classes und deren Unterstützung in FHEM ===

{| class="wikitable sortable"
! Commande Class Name !! ID (hex) !! ID (dezimal) !! class="unsortable" | höchste Version !! class="unsortable" | unterstützte Version(en) !! class="unsortable" | Kommentar
|-

| NO_OPERATION
| 0x00
| 0
| V1
| nein - für Gerätefunktion nicht relevant
|
|-
| ZWAVE_CMD_CLASS
| 0x01
| 1
| ?
| ?
| LowLevel-Funktionen, die von http://fhem.de/commandref.html#ZWCUL teilweise unterstützt werden
|-
| BASIC
| 0x20
| 32
| V2
| V2
|
|-
| CONTROLLER_REPLICATION
| 0x21
| 33
| V1
| nein
|
|-
| APPLICATION_STATUS
| 0x22
| 34
| V1
| V1
|
|-
| ZIP_SERVICES
| 0x23
| 35
| V2
| nein
| Z-Wave for IP
|-
| ZIP_SERVER
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANEL_MODE ?)
|-
| SECURITY_PANEL_MODE
| 0x24
| 36
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_SERVER ?)
|-
| SWITCH_BINARY
| 0x25
| 37
| V2
| V1
|
|-
| SWITCH_MULTILEVEL
| 0x26
| 38
| V4
| V1
| set-Befehl für StartLevelChange (0x04) nicht implementiert
|-
| SWITCH_ALL
| 0x27
| 39
| V1
| V1
|
|-
| SWITCH_TOGGLE_BINARY
| 0x28
| 40
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_BINARY [DEPRECATED]
|-
| SWITCH_TOGGLE_MULTILEVEL
| 0x29
| 41
| V1
| nein
| COMMAND_CLASS_SWITCH_TOGGLE_MULTILEVEL [DEPRECATED]
|-
| CHIMNEY_FAN
| 0x2A
| 42
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SCENE_ACTIVATION
| 0x2B
| 43
| V1
| V1
|
|-
| SCENE_ACTUATOR_CONF
| 0x2C
| 44
| V1
| V1
|
|-
| SCENE_CONTROLLER_CONF
| 0x2D
| 45
| V1
| V1
|
|-
| ZIP_CLIENT
| 0x2E
| 46
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (SECURITY_PANELZONE ?)
|-
| ZIP_ADV_SERVICES
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (Z/IP Tunneling Services) (SECURITY_PANELZONE_SENSOR ?)
|-
| SECURITY_PANELZONE_SENSOR
| 0x2F
| 47
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten (ZIP_ADV_SERVICES ?)
|-
| SENSOR_BINARY
| 0x30
| 48
| V2
| V1, V2
| SENSOR_BINARY [DEPRECATED]
|-
| SENSOR_MULTILEVEL
| 0x31
| 49
| V10
| unterstützt, Version noch nicht geklärt
|
|-
| METER
| 0x32
| 50
| V4
| V1, V2, (V3)
| V3 evtl. nicht vollständig
|-
| ZIP_ADV_SERVER
| 0x33
| 51
| V1
| nein
| Class wurde durch Class COLOR_CONTROL ersetzt
|-
| SWITCH_COLOR (COLOR_CONTROL)
| 0x33
| 51
| V3
| V1
|
|-
| NETWORK_MANAGEMENT_INCLUSION
| 0x34
| 52
| V1
| nein
|
|-
| METER_PULSE
| 0x35
| 53
| V1
| nein
| METER_PULSE [DEPRECATED]
|-
| BASIC_TARIFF_INFO
| 0x36
| 54
| V1
| nein
|
|-
| HRV_STATUS
| 0x37
| 55
| V1
| V1
|
|-
| THERMOSTAT_HEATING
| 0x38
| 56
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| HRV_CONTROL
| 0x39
| 57
| V1
| V1
|
|-
| DCP_CONFIG
| 0x3a
| 58
| V1
| nein
|
|-
| DCP_MONITOR
| 0x3b
| 59
| V1
| nein
|
|-
| METER_TBL_CONFIG
| 0x3C
| 60
| V1
| nein
|
|-
| METER_TBL_MONITOR
| 0x3D
| 61
| V2
| nein
|
|-
| METER_TBL_PUSH
| 0x3E
| 62
| V1
| nein
|
|-
| PREPAYMENT
| 0x3F
| 63
| V1
| nein
|
|-
| THERMOSTAT_MODE
| 0x40
| 64
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| PREPAYMENT_ENCAPSULATION
| 0x41
| 67
| V1
| nein
|
|-
| THERMOSTAT_OPERATING_STATE
| 0x42
| 66
| V2
| V2
| V2 ohne Logging-Commands
|-
| THERMOSTAT_SETPOINT
| 0x43
| 67
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| THERMOSTAT_FAN_MODE
| 0x44
| 68
| V4
| V1, V2
|
|-
| THERMOSTAT_FAN_STATE
| 0x45
| 69
| V2
| V1, V2
|
|-
| CLIMATE_CONTROL_SCHEDULE
| 0x46
| 70
| V1
| V1
| CLIMATE_CONTROL_SCHEDULE [DEPRECATED]
|-
| THERMOSTAT_SETBACK
| 0x47
| 71
| V1
| nein
|
|-
| RATE_TBL_CONFIG
| 0x48
| 72
| V1
| nein
|
|-
| RATE_TBL_MONITOR
| 0x49
| 73
| V1
| nein
|
|-
| TARIFF_CONFIG
| 0x4a
| 74
| V1
| nein
|
|-
| TARIFF_TBL_MONITOR
| 0x4b
| 75
| V1
| nein
|
|-
| DOOR_LOCK_LOGGING
| 0x4C
| 76
| V1
| ja
| DOOR_LOCK_LOGGING [DEPRECATED]
|-
| NETWORK_MANAGEMENT_BASIC
| 0x4d
| 77
| V1
| nein
|
|-
| SCHEDULE_ENTRY_LOCK
| 0x4E
| 78
| V3
| V1, V2, V3
| SCHEDULE_ENTRY_LOCK [DEPRECATED]
|-
| ZI_6LOWPAN
| 0x4F
| 79
| V8
| nein
| ZIP_6LOWPAN (ITU-T G.9959 / IETF RFC 7428)
|-
| BASIC_WINDOW_COVERING
| 0x50
| 80
| V1
| V1
| BASIC_WINDOW_COVERING [OBSOLETED]
|-
| MTP_WINDOW_COVERING
| 0x51
| 81
| V1
| nein
| MTP_WINDOW_COVERING [OBSOLETED] (MTP=Move to position)
|-
| NETWORK_MANAGEMENT_PROXY
| 0x52
| 82
| V1
| nein
|
|-
| SCHEDULE (NETWORK_SCHEDULE)
| 0x53
| 83
| V3
| V1
| (Details für einige Paramenter unbekannt)
|-
| NETWORK_MANAGEMENT_PRIMARY
| 0x54
| 84
| V1
| nein
|
|-
| TRANSPORT_SERVICE
| 0x55
| 85
| V2
| nein
|
|-
| CRC_16_ENCAP
| 0x56
| 86
| V1
| V1
|
|-
| APPLICATION_CAPABILITY
| 0x57
| 87
| V1
| nein
|
|-
| ZIP_ND
| 0x58
| 88
| V1
| nein
|
|-
| ASSOCIATION_GRP_INFO
| 0x59
| 89
| V3
| V1
| get-Abfrage "associationGroupInfo => "03"" mit dem zugehörigen Report "..5904(.*)" fehlen, da Sinn unklar
|-
| DEVICE_RESET_LOCALLY
| 0x5a
| 90
| V1
| V1
|
|-
| CENTRAL_SCENE
| 0x5b
| 91
| V3
| ?
| nur "parse" für set grundlegend implementiert
|-
| IP_ASSOCIATION
| 0x5c
| 92
| V1
| nein
|
|-
| ANTITHEFT
| 0x5d
| 93
| V2
| nein
|
|-
| ZWAVEPLUS_INFO
| 0x5e
| 94
| V2
| V1
| Neuerungen durch V2 unbekannt
|-
| ZIP_GATEWAY
| 0x5f
| 95
| V1
| nein
|
|-
| MULTI_CHANNEL
| 0x60
| 96
| V4
| V2
|
|-
| MULTI_INSTANCE
| 0x60
| 96
| V1
| V1
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| ZIP_PORTAL
| 0x61
| 97
| V1
| nein
|
|-
| DOOR_LOCK
| 0x62
| 98
| V3
| V2
| (Details für einige Paramenter unbekannt)
|-
| USER_CODE
| 0x63
| 99
| V1
| V1
|
|-
| HUMIDITY_CONTROL_SETPOINT (APPLIANCE)
| 0x64
| 100
| V1
| nein
|
|-
| DMX
| 0x65
| 101
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| BARRIER_OPERATOR
| 0x66
| 102
| V1
| V1
| "unwichige" Commands über 0x03 fehlen derzeit noch
|-
| NETWORK_MANAGEMENT_INSTALLATION_MAINTENANCE
| 0x67
| 103
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| ZIP_NAMING
| 0x68
| 104
| V1
| nein
|
|-
| MAILBOX
| 0x69
| 105
| V1
| nein
|
|-
| WINDOW_COVERING
| 0x6A
| 106
| V1
| nein
|
|-
| IRRIGATION
| 0x6B
| 107
| V1
| nein
|
|-
| SUPERVISION
| 0x6C
| 108
| V1
| nein
|
|-
| HUMIDITY_CONTROL_MODE
| 0x6D
| 109
| V1
| nein
|
|-
| HUMIDITY_CONTROL_OPERATING_STATE
| 0x6E
| 110
| V1
| nein
|
|-
| ENTRY_CONTROL
| 0x6F
| 111
| V1
| nein
|
|-
| CONFIGURATION
| 0x70
| 112
| V4
| V1
|
|-
| ALARM
| 0x71
| 113
| V8
| V1, V2, V3, V4
| ab V3 umbenannt in NOTIFICATION, wird weiterhin als ALARM angezeigt, siehe Bemerkungen.
|-
| MANUFACTURER_SPECIFIC
| 0x72
| 114
| V2
| V1
|
|-
| POWERLEVEL
| 0x73
| 115
| V1
| V1
|
|-
| unbekannt
| 0x74
| 116
|
|
|
|-
| PROTECTION
| 0x75
| 117
| V2
| V1, V2
|
|-
| LOCK
| 0x76
| 118
| V1
| nein
|
|-
| NODE_NAMING
| 0x77
| 119
| V1
| V1
|
|-
| unbekannt
| 0x78
| 120
|
|
|
|-
| unbekannt
| 0x79
| 121
|
|
|
|-
| FIRMWARE_UPDATE_MD
| 0x7A
| 122
| V5
| nein
|
|-
| GROUPING_NAME
| 0x7B
| 123
| V1
| nein
| GROUPING_NAME [DEPRECATED]
|-
| REMOTE_ASSOCIATION_ACTIVATE
| 0x7C
| 124
| V1
| nein
| REMOTE_ASSOCIATION_ACTIVATE [OBSOLETED]
|-
| REMOTE_ASSOCIATION
| 0x7D
| 125
| V1
| nein
| REMOTE_ASSOCIATION [OBSOLETED]
|-
| unbekannt
| 0x7E
| 126
|
|
|
|-
| unbekannt
| 0x7F
| 127
|
|
|
|-
| BATTERY
| 0x80
| 128
| V1
| V1
|
|-
| CLOCK
| 0x81
| 129
| V1
| V1
|
|-
| HAIL
| 0x82
| 130
| V1
| V1
| HAIL [DEPRECATED]
|-
| unbekannt
| 0x83
| 131
|
|
|
|-
| WAKE_UP
| 0x84
| 132
| V2
| V1, V2
|
|-
| ASSOCIATION
| 0x85
| 133
| V2
| V1, V2 bei ASSOCIATION_REMOVE
|
|-
| VERSION
| 0x86
| 134
| V2
| V1, V2
|
|-
| INDICATOR
| 0x87
| 135
| V2
| V1
|
|-
| PROPRIETARY
| 0x88
| 136
| V1
| nein
| PROPRIETARY [DEPRECATED]
|-
| LANGUAGE
| 0x89
| 137
| V1
| nein
|
|-
| TIME
| 0x8A
| 138
| V2
| V2
|
|-
| TIME_PARAMETERS
| 0x8B
| 139
| V1
| V1
|
|-
| GEOGRAPHIC_LOCATION
| 0x8C
| 140
| V1
| nein
|
|-
| COMPOSITE
| 0x8D
| 141
| V?
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| MULTI_CHANNEL_ASSOCIATION
| 0x8E
| 142
| V3
| unterstützt, Version noch nicht geklärt
|
|-
| MULTI_INSTANCE_ASSOCIATION
| 0x8E
| 142
| V1
| unterstützt, Version noch nicht geklärt
| MULTI_INSTANCE wurde durch MULTI_CHANNEL ersetzt
|-
| MULTI_COMMAND (MULTI_CMD)
| 0x8F
| 143
| V1
| V1
|
|-
| ENERGY_PRODUCTION
| 0x90
| 144
| V1
| nein
|
|-
| MANUFACTURER_PROPRIETARY
| 0x91
| 145
| V1
| für FIB_FGRM222 implementiert
| hersteller- und geräteabhängige Class
|-
| SCREEN_MD
| 0x92
| 146
| V2
| nein
|
|-
| SCREEN_ATTRIBUTES
| 0x93
| 147
| V2
| nein
|
|-
| SIMPLE_AV_CONTROL
| 0x94
| 148
| V4
| nein
|
|-
| AV_CONTENT_DIRECTORY_MD
| 0x95
| 149
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_RENDERER_STATUS
| 0x96
| 150
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| AV_CONTENT_SEARCH_MD
| 0x97
| 151
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| SECURITY
| 0x98
| 152
| V1
| V1
| weitere Tests erforderlich
|-
| AV_TAGGING_MD
| 0x99
| 153
| V1
| nein
| Nicht in der offiziellen Liste von Sigma Designs enthalten
|-
| IP_CONFIGURATION
| 0x9A
| 154
| V1
| nein
| IP_CONFIGURATION [OBSOLETED]
|-
| ASSOCIATION_COMMAND_CONFIGURATION
| 0x9B
| 155
| V1
| nein
|
|-
| SENSOR_ALARM
| 0x9C
| 156
| V1
| V1
| SENSOR_ALARM [DEPRECATED]
|-
| SILENCE_ALARM
| 0x9D
| 157
| V1
| nein
|
|-
| SENSOR_CONFIGURATION
| 0x9E
| 158
| V1
| nein
| SENSOR_CONFIGURATION [OBSOLETED]
|-
| SECURITY S2
| 0x9F
| 159
| V1
| nein
|
|-
| unbekannt
| 0xA0 - 0xEE
| 160 - 238
|
|
|
|-
| MARK
| 0xEF
| 239
| N/A
|
| Trenner im NIF
|-
| NON_INTEROPERABLE
| 0xF0
| 240
| N/A
|
|
|-
| SECURITY_SCHEME0_MARK
| 0xF100
| 61696
| N/A
|
|
|-
|}

Bemerkungen:
* Die Klasse MULTI_INSTANCE wurde in der Version V2 durch MULTI_CHANNEL ersetzt. MULTI_INSTANCE wird von Z-Wave nicht mehr unterstützt.
* Die Klasse ALARM wurde in der Version V3 in NOTIFICATION umbenannt. Aus Kompatibilitätsgründen wird diese Klasse (0x71) in FHEM jedoch weiterhin immer als ALARM angezeigt, unabhängig von der Version. Das bedeutet, dass neuere Geräte, die laut der Produktbeschreibung NOTIFICATION unterstützen, dies in FHEM NICHT darstellen, die Funktionalitäten sind jedoch uneingeschränkt implementiert, nur eben unter dem alten Klassennamen ALARM.
* Einige IDs sind für das Z-Wave Protokoll reserviert oder haben eine besondere Bedeutung:
** 0x00 No Operation wird vom Z-Wave Protokoll und optional auch von den Geräten.
** 0x01 - 0x1F ist reserviert für das Z-Wave Protokoll
** 0x20 - 0xEE Dies ist der Bereich für die Command Classes
** 0xEF Support/Control Mark, ist eine kommandolose Pseudoklasse und dient als Trenner im NIF (Node Information Frame)
** 0xF0 Non interoperable
** 0xF1 - 0xFF sind für (zukünftige) Erweiterungen vorgesehen (Extended Application Command Classes). Bei diesen Befehlen wird quasi auf jeweils eine andere Liste von Befehlen verwiesen, so daß hier für die Zukunft noch einige Erweiterungen möglich sind. Als eine Besonderheit ist hier bereits 0xF100 für "SECURITY_SCHEME0_MARK" vergeben.
* Einige IDs sind in den unterschiedlichen Quellen unterschiedliche Klassennamen zugeordnet bzw. nicht in der offiziellen Liste von Sigma Designs enthalten:
** 0x24 ZIP_SERVER / SECURITY_PANEL_MODE
** 0x2E ZIP_CLIENT / SECURITY_PANELZONE
** 0x2F ZIP_ADV_SERVICES / SECURITY_PANELZONE_SENSOR
** 0x33 ZIP_ADV_SERVER / COLOR_CONTROL
** 0x34 ZIP_ADV_CLIENT / NETWORK_MANAGEMENT_INCLUSION
* Es gibt auch einige "Lücken" in den IDs die momentan unbekannt bzw. noch nicht durch Z-Wave vergeben sind, z.B.:
** 0x74 116
** 0x78 120
** 0x79 121
** 0x7E 126
** 0x7F 127
** 0x83 131

=== Beispiel für eine Command Class und deren Implementierung in FHEM ===
Implementierungshinweise im Forum:
* {{Link2Forum|Topic=12576|Message=76322}}
* {{Link2Forum|Topic=26613|Message=195944}}

Debugging-Hinweis im Forum:
* {{Link2Forum|Topic=39270|Message=314126}}
* {{Link2Forum|Topic=67296|Message=589810}}

=== Quellen und Links ===
* [[Z-Wave#Links]]

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Homebridge User Configs

2016-10-09T13:37:20Z

Zephyr: getestet mit für ZM1701 hinzugefügt

Dieser Eintrag dient zur Sammlung funktionsfähiger Homebridge Configs.

Bitte immer die FHEM Version und Homebridge Version angegeben.

Sehr gute Hinweise gibt es hier: http://www.meintechblog.de/2015/10/mit-siri-und-fhem-das-gesamte-smart-home-per-stimme-steuern/

== EnOcean STM 250 Tür-/Fensterkontakt ==
Der STM 250 liefert als Status in FHEM <code>open</code>, wenn das Fenster offen und damit der Kontakt "offen" ist. Analog liefert er <code>closed</code> wenn das Fenster geschlossen und damit auch der Kontakt geschlossen ist. Diese Statusangaben sind sehr intuitiv zu verstehen und zu interpretieren.

Die characteristic <code>ContactSensorState</code> von HomeKit liefert entweder den Wert <code>CONTACT_DETECTED=0</code> oder <code>CONTACT_NOT_DETECTED=1</code> zurück. Wobei <code>CONTACT_DETECTED</code> bedeutet, dass der Kontakt geschlossen ist. Je nach Darstellung in der HomeKit-fähigen App muss dieses Verhalten bei der Interpretation berücksichtigt werden. Die App Eve von Elgato zum Beispiel liefert für Kontaktsensoren "JA" oder "NEIN" mit der Bedeutung <code>CONTACT_DETECTED=0=JA</code> bzw. <code>CONTACT_NOT_DETECTED=1=NEIN</code> zurück.

Noch ein wichtiger Punkt: Um einen Sensorkontakt sinnvoll einzurichten sollte als zusätzlicher Wert für das Attribut <code>genericdeviceType</code> der Wert <code>ContactSensor</code> hinzugefügt werden. Wie das geht ist im Eintrag [[Homebridge_einrichten#FHEM_konfigurieren | Homebridge einrichten]] ausführlicher beschrieben.

Folgende Attribute dann hinzufügen:
attr STM250 genericDeviceType ContactSensor
attr STM250 homebridgeMapping ContactSensorState=state,values=closed:CONTACT_DETECTED;open:CONTACT_NOT_DETECTED

Getestet mit
FHEM 5.7 Rev. 9893
Homebridge 0.2.16
homebridge-fhem Vorschauversion aus [http://forum.fhem.de/index.php/topic,48558.msg402024.html#msg402024 homebridge/homekit]

== Modul RESIDENTS für Anwesenheitserkennung und Steuerung der Anwesenheit benutzen ==
[[Datei:Homebridge_bewohner_zu_szene.jpeg|mini|Schaltzustand eines Bewohners zu einer Szene hinzufügen]]
Aus den einzelnen Komponenten des Moduls RESIDENTS, homebridge sowie der characteristic <code>On</code> und der Szenensteuerung lässt sich eine gleichzeitige Steuerung der Anwesenheit und Anwesenheitserkennung basteln.

Dazu müssen folgende Schritte unternommen werden:
* einem Bewohner aus dem Modul ROOMMATE die Steuerung über homebridgeMapping hinzufügen
* Szene für "Ich bin zu Hause" und "Ich gehe jetzt" in einer HomeKit-fähigen App wie z.B. Eve einrichten

Man kann einen beliebigen Bewohner aus dem Modul ROOMMATE nehmen und ihn über die characteristic <code>On</code> in Form eines Schalters sozusagen schaltbar machen. Nur wird das Ein- und Ausschalten des Bewohners über HomeKit in FHEM auf den Status home bzw. absent gemappt. Seit dem 06.02.2016 werden RESIDENTS automatisch als Occupancy Sensor für HomeKit annonciert. Nun noch die Attribute des ROOMMATE wie folgt setzen:
attr <ROOMMATE> genericDeviceType switch
attr <ROOMMATE> homebridgeMapping On=state,valueOn=/home|awoken|asleep|gotosleep/,valueOff=/gone|absent/,cmdOn=home,cmdOff=absent

Natürlich muss der Bewohner noch dem Filter von homebridge hinzugefügt und homebridge neu gestartet werden.

Anschließend geht es in der HomeKit-fähigen App Deiner Wahl weiter. In Eve von Elgato ist von vornherein zum Beispiel vorgesehen, dass man zwei Szenen "Ich bin zuhause" und "Ich verlasse das Haus" hat. Zu diesen Szenen wird eine Aktion hinzugefügt indem der Bewohner, den das ROOMMATE-Modul meldet zur Szene hinzugefügt wird und beim Nachhausekommen "eingeschaltet" wird. Genauso wird mit der Szene "Ich verlasse das Haus" verfahren: Bewohner zur Szene hinzufügen und den Schaltvorgang auf "ausschalten" setzen.

Mit den Sprachbefehlen "Ich bin zuhause" oder "Ich verlasse das Haus" wird die entsprechende Szene eingeschaltet, homebridge schaltet über das <code>homebridgeMapping</code> Attribut dann den Bewohner auf "home" oder "absent".

Getestet mit
FHEM 5.7 Rev. 9893
Homebridge 0.2.16
homebridge-fhem Vorschauversion aus [http://forum.fhem.de/index.php/topic,48558.msg402024.html#msg402024 homebridge/homekit]

== ZWave Türschloss Vision ZM1701 einbinden ==
Das ZWave Türschloss ZM1701 von der Firma Vision sendet seinen aktuellen Schließstatus in ein einzelnes Reading wie "lock", sondern schickt eine ganze Reihe von Informationen über den Zustand in das Reading <code>doorLockOperation</code>. Das Schließen und Öffnen der Türschlosses wird auch nicht mit einem Setzen des <code>state</code> erreicht, sondern mit dem Setzen von <code>doorLockOperation</code>. Das macht das Einbinden in homebridge nicht trivial, funktioniert aber über folgendes Homebridge-Mapping:
attr <ZM1701> genericDeviceType lock
attr <ZM1701> homebridgeMapping LockCurrentState=doorLockOperation,values=/\ssecured/:SECURED;/unsecured/:UNSECURED LockTargetState=doorLockOperation,values=/\ssecured/:SECURED;/unsecured/:UNSECURED,cmds=SECURED:doorLockOperation+close;UNSECURED:doorLockOperation+open

Kurz zur Erklärung: Um ein Schloss über HomeKit steuern zu können braucht es zwei characteristics. LockCurrentState zeigt an, ob das Schloss geöffnet oder geschlossen ist. Und mit LockTargetState wird das Schloss geöffnet oder geschlossen. Damit der aktuelle Status des Schlosses ausgelesen werden kann, muss aus dem FHEM-Reading <code>doorLockOperation</code> die Zeichenfolge <code> secured</code> oder <code>unsecured</code> extrahiert werden, daher die beiden regulären Ausdrücke <code>/\ssecured/</code> und <code>/unsecured/</code>. In der characteristic <code>LockTargetState</code> muss sowohl der aktuelle Status des Schlosses als auch das Kommando angegeben werden, schließlich möchte man ein geschlossenes Schloss nicht nochmal schließen. Daher wird erst aus dem Reading <code>doorLockOperation</code> der aktuelle Status des Schlosses ausgelesen und die damit korrespondierenden Befehle über <code>cmds=SECURED:doorLockOperation+close;UNSECURED:doorLockOperation+open</code> generiert.

Wer es in FHEM über ein webCmd einfacher zu bedienen haben möchte, fügt bitte noch die dafür notwendigen Attribute und die leicht geänderten homebridgeMappings wie folgt ein:
attr <ZM1701> genericDeviceType lock
attr <ZM1701> homebridgeMapping LockCurrentState=doorLockOperation,values=/\ssecured/:SECURED;/unsecured/:UNSECURED LockTargetState=doorLockOperation,values=/\ssecured/:SECURED;/unsecured/:UNSECURED,cmds=SECURED:close;UNSECURED:open
attr <ZM1701> /doorLockOperation open:open/doorLockOperation close:close
attr <ZM1701> webCmd open:close

Getestet mit
FHEM 5.7 Rev. 12191
homebridge 0.4.6
homebridge-fhem 0.2.48

[[Kategorie:HOWTOS]]
[[Kategorie:Code Snippets]]

Homebridge User Configs

2016-10-09T13:09:34Z

Zephyr: Mappings für das ZWave Türschloss ZM1701 hinzugefügt.

Homebridge User Configs

2016-04-11T19:26:51Z

Zephyr: Korrektur der Angaben im HomebridgeMapping, damit die Zuordnung der Statusangaben auch korrekt funktioniert.

Homebridge User Configs

2016-02-09T09:29:26Z

Zephyr: /* Bild verkleinert, Beschreibung angepasst, weil RESIDENTS automatisch als Occupancy Detector annonciert wird. */

Diskussion:Homebridge User Configs

2016-02-08T14:51:46Z

Zephyr:

== Bild rendert nicht korrekt ==
Das Bild rendert leider nicht korrekt... Was kann ich denn da machen?
--[[Benutzer:Zephyr|Zephyr]] ([[Benutzer Diskussion:Zephyr|Diskussion]]) 10:31, 6. Feb. 2016 (CET)
<hr>
:Formatierungsbeispiele/-möglichkeiten findest Du u.a. hier: https://de.wikipedia.org/wiki/Hilfe:Bilder. Vielleicht hilft das schon. Gruß, --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 10:46, 6. Feb. 2016 (CET)
<hr>
:Also, ein Problem mit dem Rendern kann ich da nicht erkennen. Meiner Ansicht nach ist das Bild einfach unnötig groß - skaliere es auf 600x800 oder so runter; damit lässt sich trotdem wohl alles noch erkennen. Wenn es generell um die Einbindung von Bildern geht, würde ich derzeit auf die Wikipedia-Hilfe verweisen, fhemwiki-spezifisch gibt es da bisher keine Vorgaben. --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 10:52, 6. Feb. 2016 (CET)
<hr>
:Es rendert korrekt, stimmt. Das war unpräzise von mir ausgedrückt. Was ich meine ist, dass ich zwar das Bild mittels \[\[Datei:Homebridge_bewohner_zu_szene.jpeg|180px|frame|right]] einbinde, aber mitnichten die angegebene Breite für das Bild verwendet wird. Das ist doch soweit ich weiß die übliche Syntax für Wikipedia zum Anzeigen von Bildern, oder?! --[[Benutzer:Zephyr|Zephyr]] ([[Benutzer Diskussion:Zephyr|Diskussion]]) 15:51, 8. Feb. 2016 (CET)

Diskussion:Homebridge User Configs

2016-02-06T09:31:03Z

Zephyr: Die Seite wurde neu angelegt: „Das Bild rendert leider nicht korrekt... Was kann ich denn da machen? --~~~~“

Das Bild rendert leider nicht korrekt... Was kann ich denn da machen?
--[[Benutzer:Zephyr|Zephyr]] ([[Benutzer Diskussion:Zephyr|Diskussion]]) 10:31, 6. Feb. 2016 (CET)

Homebridge User Configs

2016-02-06T09:30:34Z

Zephyr: Kategorie hinzugefügt, Links benannt

Homebridge User Configs

2016-02-06T09:24:58Z

Zephyr: Konfiguration der Anwesenheitssteuerung hinzugefügt.

Datei:Homebridge bewohner zu szene.jpeg

2016-02-06T09:13:18Z

Zephyr: Im Bild ist als Beispiel zu sehen, wie der Bewohner "KARSTEN" zu einer Szene hinzugefügt wird und welche Einstellungen dann vorgenommen werden müssen.

Im Bild ist als Beispiel zu sehen, wie der Bewohner "KARSTEN" zu einer Szene hinzugefügt wird und welche Einstellungen dann vorgenommen werden müssen.

Homebridge User Configs

2016-02-06T08:29:48Z

Zephyr: /* Schreibfehler korrigiert */

EnOcean-STM-250-Fenster-Türkontakt

2016-02-06T08:19:20Z

Zephyr: /* Einsatzbeispiel zur Verwendung in Homebridge/HomeKit eingefügt */

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=EnOcean
|HWType=Sender, Sensor
|HWCategory=EnOcean
|HWComm=EnOcean Funk, 868Mhz
|HWChannels=
|HWVoltage=solarbetrieben
|HWPowerConsumption=
|HWPoweredBy=solarbetrieben
|HWSize=Kontakt: 110x19x15mm Magnet: 37x10x5mm / evtl. abweichend
|HWDeviceFHEM=[http://fhem.de/commandref.html#EnOcean EnOcean]
|HWManufacturer=EnOcean, diverse
}}

'''EnOcean-STM-250-Fenster-Türkontakt''' ist ein solarbetriebener Sensor
* für
** Zustandsüberwachung von Fenstern und Türen

== Features ==
Solarbetriebener Sensor sendet bei jeder Zustandsänderung sofort und alle 15 min eine Zustandsmeldung.
Der Sensor wird von verschiedenen Herstellern mit unterschiedlicher Bezeichnung angeboten (Achtung: teilweise abweichende Gehäusegrößen).

== Hinweise zum Betrieb mit Fhem ==
=== Definition/Anlernvorgang ===
Der Sensor wird beim Empfang des ersten normalen Funktelegramms im <code>learningMode</code> vollständig von Fhem erkannt und das Fhem-Device für den Kontakt nebst Filelog und Plot durch autocreate angelegt. Der Versand des Anlerntelegramms ist für Fhem nicht zwingend notwendig; er führt zum gleichen Ergebnis wie der Empfang des ersten normalen Funktelegramms.

Anlernvorgang:
# Fhem in Lernmodus schalten: <code><nowiki>set <IODev> teach <time/s></nowiki></code>
# Normales Funktelegramm oder alternativ Anlerntelegramm auslösen. Das Anlegen von Fhem-Devices für den Kontakt, Fileog und Plot in der Konfiguration erfolgt dann automatisch per autocreate.

=== Fhem Config-Auszug ===
Ein exemplarischer Auszug für das Fhem-Device eines Kontaktes aus der [[Konfiguration]]:
define EnO_contact_00017500 EnOcean 00017505
attr EnO_contact_00017500 IODev TCM310_3
attr EnO_contact_00017500 eep D5-00-01
attr EnO_contact_00017500 manufID 7FF
attr EnO_contact_00017500 room EnOcean
attr EnO_contact_00017500 subType contact

=== Logbeispiel ===
2014-07-16_19:29:50 EnO_contact_00017500 closed
2014-07-16_19:30:00 EnO_contact_00017500 open
2014-07-16_19:31:10 EnO_contact_00017500 closed
2014-07-16_19:31:20 EnO_contact_00017500 open
2014-07-16_19:33:10 EnO_contact_00017500 closed

== Einsatzbeispiel ==
=== Anzeige Türstatus im WebFrontend ===
[[Datei:EnOcean-STM-250-Anzeige-Fensterstatus.JPG|500px|frame|right]]
Durch folgendes Attribut wird der Türstatus im WebFrontend bildlich dargestellt:
attr EnO_contact_00017500 devStateIcon closed:fts_door open:fts_door_open

Mit dieser alternativen Variante des Attributs wird das Icon bei offener Tür rot und bei geschlossener Tür schwarz dargestellt:
attr EnO_contact_00017500 devStateIcon open:fts_door_open@red closed:fts_door@black

=== Türstatus in einem Plot darstellen ===
In aktuellen Fhem-Versionen wird ein Plot nebst Filelog für den EnOcean-Fensterkontakt automatisch beim Anlernen angelegt. Eine manuelle Anlage ist nicht mehr notwendig. Das dargestellte Vorgehen und die Erläuterungen sind aber für manuelle Anlage und Bearbeitung von Plots weiterhin noch aktuell.

[[Datei:EnOcean-STM-250-Fenster-Türkontakt-Garden_door_gplot.jpg]]

Mit Hilfe des [[Plots_erzeugen|.gplot-Editors]] kann ein Plot zur Darstellung des Türstatus im Zeitablauf erzeugt werden.
Voraussetzung ist die Existenz eines Logfiles für den Fenster-Türkontakt, das beim Teach-In standardmäßig von <code>autocreate</code> erzeugt wird:
define FileLog_EnO_contact_00017500 FileLog ./log/EnO_contact_0000FA27-%Y.log EnO_contact_0000FA27:.*
attr FileLog_EnO_contact_00017500 logtype text
attr FileLog_EnO_contact_00017500 room EnOcean

Die Detailansicht des Filelogs FileLog_EnO_contact_00017500 aufrufen.

Den Link "Create SVG Plot" anklicken.

Die Felder im erscheinenden Plot-Editor folgendermaßen füllen:
{{Randnotiz|RNText=''Allgemeiner Hinweis zum Function-Feld im Plot-Editor''
Die Function dient zum Umsetzen von nicht-numerischen Werten in plotbare numerische Werte. Es ist ein Perl-Ausdruck für [http://fhem.de/commandref.html#FileLogget FileLog get] (siehe auch [[Creating_Plots#Data_Extraction|Creating Plots]]) 
x in $fld[x] bezeichnet die zu analysierende Spalte im FileLog. Die Spaltenzählung beginnt mit der 0. Spalte (Zeitstempel). 
}}
# Plot title: <TL>
# Y-Axis label, left: Feld komplett löschen
# Y-Axis label, rigth: Status
# Range as [min:max],left: [-0.1:1.1]
# Range as [min:max],right: [-0.1:1.1]
# Tics as ("Txt" val, ...),left: ("open" 1, "closed" 0)
# Tics as ("Txt" val, ...),right: ("open" 1, "closed" 0)
# Diagramm label: notitle
# Source: FileLog_EnO_contact_00017500
# Column: 3
# Regexp: EnO_contact_00017500.*
# DefaultValue: 0
# Function: $fld[2]=~"open"?1:0
# Y-Axis: rigth
# Plot-Type: steps
# Style: I0
# Width: 1

Dann {{Taste|Write .gplot-File}} anklicken. Der Plot sollte nun richtig angezeigt werden. Durch Anklicken von {{Taste|Show preprocessed input}} werden für einen kleineren Zeitraum die zugrundeliegenden Werte für den Plot angezeigt. Dies erleichtert die Kontrolle insbesondere bei der Nutzung von "Function".

Durch Setzen des folgendes Attribut wird die Titelzeile des Plots erzeugt:
attr SVG_FileLog_EnO_contact_00017500_1 title sprintf("Garden Door %s at %s",$data{currval1}=~"1"?'open':'closed',$data{currdate1} =~ m/_(\d\d:\d\d)/?$1:"")

Automatisch durch den .gplot-Editor erzeugte .glot-Datei (SVG_FileLog_EnO_contact_00017500.gplot_1):
# Created by FHEM/98_SVG.pm, 2015-04-08 19:52:56
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<TL>'
set ytics ("open" 1, "closed" 0)
set y2tics ("open" 1, "closed" 0)
set grid
set ylabel ""
set y2label "Status"
set yrange [-0.1:1.1]
set y2range [-0.1:1.1]

#FileLog_EnO_contact_00017500 3:EnO_contact_00017500.*:0:$fld[2]=~"open"?1:0

plot "<IN>" using 1:2 axes x1y2 notitle ls l0 lw 1 with steps

aus [http://forum.fhem.de/index.php/topic,25990.msg191090.html#msg191090 Forenbeitrag]

=== STM 250 in Homebridge / HomeKit verwenden ===
Der STM 250 kann mit einem homebridgeMapping ganz einfach verwendet werden:
attr STM250 homebridgeMapping ContactSensorState=state,values=closed:CONTACT_DETECTED;open:CONTACT_NOT_DETECTED

Details dazu im Artikel [[Hombridge_User_Configs | Homebridge User Configs]]

== Links ==
* Datenblatt: [http://www.enocean.com/de/enocean_module/stm-250-oem-data-sheet-pdf/ PDF]

[[Kategorie:EnOcean Components]]
[[Kategorie:Kontaktsensor (magnetisch)]]

Homebridge User Configs

2016-02-06T08:09:03Z

Zephyr: Konfigurationsbeispiel für den STM 250 eingefügt

Homebridge einrichten

2016-02-06T07:55:06Z

Zephyr: Leerzeichen zu viel: behoben

Dieses HOWTO zeigt die Installation und Erstinbetriebnahme von Homebridge.

Damit kann Siri benutzt werden, um FHEM-Devices zu steuern. So können Devices angesprochen werden, die offiziell HomeKit nicht unterstützen (die Vorgehensweise wurde auf einem Intel NUC mit Ubuntu Server 14.04 LTS und auf einem Raspberry Pi mit Raspian getestet). Der WIKI-Eintrag bezieht sich hauptsächlich auf eine {{Link2Forum|Topic=32652|LinkText=Diskussion im FHEM-Forum}}. Ein Riesendank gilt vor allem {{Link2FU|430|Andre (justme1968)}}.

Eine Sammlung funktionsfähiger Homebridge FHEM Konfiguration kann hier gefunden werden: [[Hombridge User Configs]]. Die Sammlung befindet sich noch im Aufbau.

= Vorbereitung der Umgebung =

== NodeJS installieren ==
''Die nachfolgenden Befehle sind alle mit "sudo" prefixed. Wenn du unter "root" arbeitest oder deine Distribution einen anderen Mechanismus verwendet, so kannst du dies natürlich weglassen.''

Zunächst wird das Betriebssystem (in diesem Falle Debian oder Ubuntu) auf den aktuellen Stand gebracht:
<source lang="bash" style="width:50%;">
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install build-essential libssl-dev</source>

Nun muss NodeJS installiert werden. Leider ist die Version im Debian Repository deutlich zu alt, daher wird mit den folgenden Befehlen das Node Repository hinzugefügt und NodeJS (in der LTS Version) entsprechend installiert:

'''NodeJS V4'''
<source lang="bash" style="width:50%;">
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs
</source>

'''NodeJS V5'''
<source lang="bash" style="width:50%">
curl -sL https://deb.nodesource.com/setup_5.x | sudo -E bash -
sudo apt-get install -y nodejs
</source>

Damit ist NodeJS installiert.

== Python, g++, MDNS installieren ==
<source lang="bash" style="width:50%;">
sudo apt-get install python g++ libavahi-compat-libdnssd-dev
</source>

Nun sind alle Voraussetzungen geschaffen.

= Installation von Homebridge & notwendiger Shims =
Im Nachfolgenden Absatz wird die Installation von Homebridge sowie des notwendigen Plugins (Shim) für FHEM erläutert.

== Homebridge installieren ==
Die aktuelle Homebridge version wird mit
<source lang="bash" style="width:50%;">
npm install -g homebridge
</source>
installiert, was eine Weile dauert. Anschließend wird der FHEM platform shim mit:
<source lang="bash" style="width:60%;">
npm install -g homebridge-fhem
</source>
installiert.

== Homebridge aktualisieren ==
Die aktuelle Homebridge version wird mit
<source lang="bash" style="width:50%;">
npm update -g homebridge
</source>
installiert, was eine Weile dauert. Anschließend wird der FHEM platform shim mit:
<source lang="bash" style="width:60%;">
npm update -g homebridge-fhem
</source>
installiert.

=== Fehler während der Installation ===
Bei folgendem Fehler ist das abrufen von Github nicht möglich.
<pre>npm ERR! git clone --template=/home/hs-server-admin/.npm/_git-remotes/_templates --mirror
git://github.com/KhaosT/ed25519.git /home/hs-server-admin/.npm/_git-remotes/git-github-com-KhaosT-ed25519-git-d8bdee1d:
github.com[0: 192.30.252.128]: errno=Die Wartezeit für die Verbindung ist abgelaufen</pre>
Fehlerursache konnte hier durch eine aktive Firewall verursacht werden.

Kommt eine DNS Fehlermeldung fehlt meistens der AVAHI-DAEMON, zu installieren via
<source lang="bash" style="width=50%">
sudo apt-get install avahi-daemon
</source>

= Homebridge konfigurieren =
''Wichtig: Für die weiteren Schritte sollte man nicht root verwenden, sondern beispielsweise einen dedizieren Nutzer für homebridge oder der Einfachheit halber den Nutzer unter dem auch FHEM läuft (meist "fhem").''

== Einstellungen für homebridge ==

Zunächst wird das Verzeichnis für die Konfigurationsdatei erstellt und in dieses gewechselt:
<source lang="bash" style="width:50%;">
mkdir -p ~/.homebridge
cd ~/.homebridge/
</source>

Nun muss darin noch die config.json erstellt bzw. angepasst werden:
<source lang="bash" style="width:50%;">
nano ~/.homebridge/config.json
</source>

Hinweise zur Konfiguration:
* "''bridge''":
** "''username''": Sollte so belassen werden. Sollte später auf dem iOS Device keine Homebridge gefunden werden, so kann man hier beispielsweise den String auf 31 statt 30 enden lassen um so eine neue Homebridge vorzutäuschen.
** "''port''": Sollte so belassen werden
** "''pin''": Der PIN kann beliebig in dem Format xxx-xx-xxx angepasst werden. Dieser muss nur einmal bei der Einrichtung in iOS eingegeben werden.
* "''platforms''":
** "''platform''": Hier muss "homebridge-fhem.fhem" beibehalten werden.
** "''server''": Hier muss die IP des FHEM-Servers eingetragen werden. Dabei muss Homebridge nicht auf dem selben Server laufen wie FHEM, kann aber. Wenn es auf dem gleichen Rechner läuft, dann bietet es sich an, die IP 127.0.0.1 zu verwenden.
** "''port''": Hier muss der Port des gewählten FHEMWEBS eingetragen werden (muss nicht das "normale" sein, kann eine extra Instanz sein)
** "''auth''": Ist FHEM nicht mit Nutzername/Password abgesichert, so kann man diese Zeile einfach entfernen.
** "''filter''": Damit nicht alle Devices von Homebridge berücksichtigt werden, bietet es sich an, die Devices zu filtern. In diesem Beispiel wurden alle Devices, die über Siri steuerbar sein sollen, zusätzlich in den Raum Homekit konfiguriert.
<source lang="javascript" style="width:50%;">
{
"bridge": {
"name": "Homebridge",
"username": "CC:22:3D:E3:CE:30",
"port": 51826,
"pin": "031-45-154"
},

"platforms": [
{
"platform": "homebridge-fhem.FHEM",
"name": "FHEM",
"server": "127.0.0.1",
"port": "8083",
"auth": {"user": "FhemUser", "pass": "XXX"},
"filter": "room=Homekit"
}
],

"accessories": []
}
</source>

Wird FHEM mit SSL abgesichert, so muss zusätzlich in der Sektion "platforms" noch diese Zeile (nach "port") eingefügt werden:
<source lang="javascript" style="width:50%;">
"ssl": true,
</source>

= FHEM konfigurieren =
Um die Devices richtig mit FHEM und Homebridge vertraut zu machen, müssen wir noch unter dem ''global''-Device das folgende zum userattr Attribut hinzufügen:
<source lang="perl">
genericDeviceType:ignore,switch,outlet,light,blind,speaker,thermostat,ContactSensor,lock,window,contact
</source>

Das geht am einfachsten via Eingabefeld (nicht in der fhem.cfg):
<source lang="perl">
{ addToAttrList("genericDeviceType:ignore,switch,outlet,light,blind,speaker,thermostat,ContactSensor,lock,window,contact") }
</source>

Das subType attribut 'gehört' dem jeweiligen Modul und sollte normalerweise nicht von Hand geändert werden.

= Start von Homebridge =

== Hinweis ==
Nach allen Änderungen die in FHEM gemacht werden, welche Homebridge betreffen, muss Homebridge neu gestartet werden. Wie der Neustart erfolgen muss, ist abhängig davon, wie man Homebridge gestartet hat. Bitte den entsprechenden Methoden entnehmen.

== Einmaliger Manueller Start ==
<source lang="bash" style="width:50%;">
homebridge
</source>

Homebridge sollte nun laufen. Hier kann man die Kommunikation nachverfolgen. Abbrechen kann das ganze mit CTRL+c (es dann auch keine Befehle mehr mit Siri möglich). Damit Siri auch Befehle ohne ständig offenes Terminal bearbeiten kann, bitten nächsten Punkt beachten.

== Homebridge automatisch starten ==
Es gibt verschiedene Methoden, Homebridge automatisch zu starten.

=== Steuerung via FHEM ===
Auf Basis der unten stehenden ''Alternativen Methode'' wurde eine Version entwickelt, mit der man auch den Status einsehen und den Restart des Dienstes aus FHEM heraus erledigen kann. Diese Version ist auf der Seite [[Homebridge Start und Status in FHEM]] im Detail beschrieben.

=== Alternative Methode ===
Dies startet homebridge als einen Service.

==== Service anlegen ====
<code>
sudo nano /etc/init.d/homebridge
</code>

Code einfügen (startet den Homebridge Server als Benutzer "pi" und nimmt an, dass sich .homebridge/config.json in seinem Homeverzeichnis unter /home/pi/ befindet):

<source lang=bash>
#!/bin/sh
### BEGIN INIT INFO
# Provides: homebridge
# Required-Start: $network $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start daemon at boot time for homebridge
# Description: Enable service provided by daemon.
### END INIT INFO
export PATH=$PATH:/usr/local/bin
export NODE_PATH=$NODE_PATH:/usr/local/lib/node_modules
PID=`pidof homebridge`
case "$1" in
start)
if ps -p $PID > /dev/null 2>&1; then
echo "Homebridge is already running"
else
su - pi -c "homebridge > /dev/null 2>&1 &"
echo "Homebridge starting"
$0 status
fi
;;
stop)
if ! ps -p $PID > /dev/null 2>&1; then
echo "Homebridge is not running"
else
kill $PID
echo "Homebridge closed"
fi
;;
restart)
if ! ps -p $PID > /dev/null 2>&1; then
$0 start
else
$0 stop
$0 start
fi
;;
status)
if ps -p $PID > /dev/null 2>&1; then
echo "Homebridge is running PID $PID"
else
echo "Homebridge is not running"
fi
;;
*)
echo "Usage: $0 {start|stop|status|restart}"
exit 1
;;
esac
exit 0
</source>

==== Autostart aktivieren ====

<code>
sudo chmod 755 /etc/init.d/homebridge

sudo update-rc.d homebridge defaults
</code>

Nun kann man mit

<code>
sudo service homebridge start
</code>

bzw.

<code>
sudo /etc/init.d/homebridge start
</code>

den Dienst starten

== FHEM Device Einstellungen ==
Damit die zu schaltenden Geräte überhaupt in der Homebridge aufgenommen werden muss man sie im Raum Homekit hinzufügen.

Um HM-CC-RT-DN Thermostate steuern zu können, muss wie oben beschrieben folgendes attribute gesetzt werden (hier als Beispiel das Device "Heizung"):
# attr Heizung subtype thermostat
Für einen Dummy muss man den genericDeviceType setzen, also beispielsweise:
# attr Dummy genericDeviceType switch
# attr Dummy setList on off

Wie bereits vorher angemerkt: Fügt man ein Device hinzu oder führt eine Änderung an einem Device durch, so sollte homebridge neu gestartet werden.

= HomeKit in iOS =

== Einrichtung ==
Um FHEM über Homebridge in iOS nutzen zu können, muss HomeKit eingerichtet werden.

Es gibt verschiedene Apps. Im folgenden wird die App EVE von Elgato empfohlen, die aus dem App-Store geladen werden muss.
In der App auf:
<pre style="width:50%;">
Gerät hinzufügen
</pre>
Es sollte ein Gerät mit der Bezeichnung "Homebridge" zur Auswahl erscheinen. Zur Ersteinrichtung auf PIN manuell eingeben gehen und (falls in der config.json nicht geändert):
<pre style="width:50%;">
031-45-154
</pre>
eingeben.

Im Anschluss können die Devices nach Belieben in verschiedene Räume zugeteilt werden, sowie Szenen und Bereiche erstellt werden.

== Schalten mit Siri ==
'''HolyMoly''' aus dem FHEM-Forum hat ein paar Beispiele gegeben, wie man Siri dazu bringt Devices zu schalten:
<pre style="width:50%;">
"Schalte alle Lampen im Obergeschoss ein."
"Schalte Chloes Licht aus."
"Dimme das Licht in der Küche."
"Dimme das Licht im Esszimmer auf 50 %."
"Stelle das Licht in der Küche am hellsten ein."
"Stelle die Temperatur im Tahoe-Haus auf 22 °C ein."
"Stelle das Thermostat im Erdgeschoss auf 21 °C ein.
"Schalte den Drucker im Büro ein."
"Siri, bereite alles für eine Party vor."
"Bereite das Ambiente fürs Abendessen vor."
"Aktiviere den Nachtruhemodus."
</pre>

Mittlerweile kann Siri auch noch die Lichtfarbe von LEDs ändern.

= Hinweise =

== Unterstützte Geräte ==
Das Fhem Plugin von {{Link2FU|430|Andre (justme1968)}} unterstützt folgende Geräte

switches (devices with set on and set off commands)
lights (devices with set on and set off commands)
homematc and FS20 dimmers (devices with set on, set off and set dim or set pct commands)
HUE, WifiLight, SWAP_0000002200000003 (hue, sat, bri, rgb)
homematic, max and pid20 thermostats
homematic, DUOFERN and FS20/IT(?) blinds
homematic, MAX and FHTTK contact sensors (door, window)
HM-SEC-WIN, HM-SEC-KEY
presence, ROOMMATE
SONOS (power, volume)
harmony scenes
temperaturecw and humidity sensors
CO20 air quality sensor
probably some more ...

== Steuerung von MiLight Allgemein ==
Wie hier im {{Link2Forum|Topic=32652|Message=351706|LinkText=Forum}} erwähnt, ist es möglich auch MiLight Geräte per Siri anzusprechen. Hierzu muss die config.json angepasst werden.

1. Es muss die Bridge hinterlegt werden. Beispiel
<source lang="javascript" style="width:50%;">
{
"platform": "MiLight",
"name": "MiLight",
"ip_address": "192.168.001.033",
"port": 8899,
"type": "rgbw",
"delay": 30,
"repeat": 3,
"zones":["Wohnzimmer Lampen","Badezimmer Lampen","Büro Lampen","Keller Lampen"]
},
</source>

2. Es muss für jedes zu Steuernde Gerät ein Dummy angelegt werden. Beispiel:

<source lang="javascript" style="width:50%;">
{
"accessory": "Http",
"name": "Kitchen Lamp",
"on_url": "https://192.168.1.22:3030/devices/23222/on",
"off_url": "https://192.168.1.22:3030/devices/23222/off",
"brightness_url": "https://192.168.1.22:3030/devices/23222/brightness/%b",
"http_method": "POST"
},
</source>

== Hinweis für alte homebridge Versionen ==
UPDATE: Homebridge funktioniert mit einer kleinen Einschränkung nun auch mit node 4.0.0. Laut
[https://github.com/cflurin/homebridge-shims/wiki/Minimalist-Homebridge-on-a-Raspberry-Pi Homebridge on a Raspberry Pi] müssen die folgenden Abhängigkeiten (Dependencies) aus der '''package.json''' entfernt werden:
<pre>
"harmonyhubjs-client": "^1.1.4",
"harmonyhubjs-discover": "git+https://github.com/swissmanu/harmonyhubjs-discover.git"
</pre>

== Hinweis zur Geschwindigkeitsoptimierung auf einem Raspberry PI ==

Damit es auf einem Raspberry schneller läuft, wird darüber hinaus empfohlen auch diverse Abhängigkeiten aus der '''package.json''' zu entfernen:
<pre>
"ad2usb": "git+https://github.com/alistairg/node-ad2usb.git#local",
"carwingsjs": "0.0.x",
"chokidar": "^1.0.5",
"eibd": "^0.3.1",
"elkington": "kevinohara80/elkington",
"harmonyhubjs-client": "^1.1.4",
"harmonyhubjs-discover": "git+https://github.com/swissmanu/harmonyhubjs-discover.git",
"lifx-api": "^1.0.1",
"lifx": "git+https://github.com/magicmonkey/lifxjs.git",
"node-hue-api": "^1.0.5",
"node-icontrol": "^0.1.4",
"node-milight-promise": "0.0.x",
"tough-cookie": "^2.0.0",
"sonos": "0.8.x",
"telldus-live": "0.2.x",
"teslams": "1.0.1",
"unofficial-nest-api": "git+https://github.com/hachidorii/unofficial_nodejs_nest.git#d8d48edc952b049ff6320ef99afa7b2f04cdee98",
"wemo": "0.2.x",
"wink-js": "0.0.5",
"komponist" : "0.1.0",
"yamaha-nodejs": "0.4.x",
</pre>

Daher zunächst ein ein Backup der Datei anlegen
<pre>sudo cp package.json package.json.bkp </pre>
Am einfachsten geht das entfernen der Zeilen einem Editor, beispielsweise nano oder vi.
<pre>sudo nano package.json</pre>

Das config file sollte dann wie folgt aussehen: Achtung vor den letzten zwei "}" am Ende darf kein Komma sein.
<source lang="javascript">
{
"name": "homebridge",
"description": "HomeKit support for the impatient",
"version": "0.1.1",
"scripts": {
"start": "DEBUG=* node app.js || true"
},
"repository": {
"type": "git",
"url": "git://github.com/nfarina/homebridge.git"
},
"license": "ISC",
"dependencies": {
"async": "^1.4.2",
"color": "0.10.x",
"debug": "^2.2.0",
"hap-nodejs": "^0.0.2",
"isy-js": "",
"mdns": "^2.2.4",
"netatmo": "1.3.0",
"node-cache": "3.0.0",
"node-persist": "0.0.x",
"node-xmpp-client": "1.0.0-alpha23",
"q": "1.4.x",
"queue": "^3.1.0",
"request": "2.49.x",
"xml2js": "0.4.x",
"xmldoc": "0.1.x"
}
}
</source>

[[Kategorie:HOWTOS]]

Homebridge einrichten

2016-02-06T07:42:18Z

Zephyr: doppeltes ignore in den userAttributes korrigiert, ContactSensor als Service hinzugefügt

Dieses HOWTO zeigt die Installation und Erstinbetriebnahme von Homebridge.

Damit kann Siri benutzt werden, um FHEM-Devices zu steuern. So können Devices angesprochen werden, die offiziell HomeKit nicht unterstützen (die Vorgehensweise wurde auf einem Intel NUC mit Ubuntu Server 14.04 LTS und auf einem Raspberry Pi mit Raspian getestet). Der WIKI-Eintrag bezieht sich hauptsächlich auf eine {{Link2Forum|Topic=32652|LinkText=Diskussion im FHEM-Forum}}. Ein Riesendank gilt vor allem {{Link2FU|430|Andre (justme1968)}}.

Eine Sammlung funktionsfähiger Homebridge FHEM Konfiguration kann hier gefunden werden: [[Hombridge User Configs]]. Die Sammlung befindet sich noch im Aufbau.

= Vorbereitung der Umgebung =

== NodeJS installieren ==
''Die nachfolgenden Befehle sind alle mit "sudo" prefixed. Wenn du unter "root" arbeitest oder deine Distribution einen anderen Mechanismus verwendet, so kannst du dies natürlich weglassen.''

Zunächst wird das Betriebssystem (in diesem Falle Debian oder Ubuntu) auf den aktuellen Stand gebracht:
<source lang="bash" style="width:50%;">
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install build-essential libssl-dev</source>

Nun muss NodeJS installiert werden. Leider ist die Version im Debian Repository deutlich zu alt, daher wird mit den folgenden Befehlen das Node Repository hinzugefügt und NodeJS (in der LTS Version) entsprechend installiert:

'''NodeJS V4'''
<source lang="bash" style="width:50%;">
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs
</source>

'''NodeJS V5'''
<source lang="bash" style="width:50%">
curl -sL https://deb.nodesource.com/setup_5.x | sudo -E bash -
sudo apt-get install -y nodejs
</source>

Damit ist NodeJS installiert.

== Python, g++, MDNS installieren ==
<source lang="bash" style="width:50%;">
sudo apt-get install python g++ libavahi-compat-libdnssd-dev
</source>

Nun sind alle Voraussetzungen geschaffen.

= Installation von Homebridge & notwendiger Shims =
Im Nachfolgenden Absatz wird die Installation von Homebridge sowie des notwendigen Plugins (Shim) für FHEM erläutert.

== Homebridge installieren ==
Die aktuelle Homebridge version wird mit
<source lang="bash" style="width:50%;">
npm install -g homebridge
</source>
installiert, was eine Weile dauert. Anschließend wird der FHEM platform shim mit:
<source lang="bash" style="width:60%;">
npm install -g homebridge-fhem
</source>
installiert.

== Homebridge aktualisieren ==
Die aktuelle Homebridge version wird mit
<source lang="bash" style="width:50%;">
npm update -g homebridge
</source>
installiert, was eine Weile dauert. Anschließend wird der FHEM platform shim mit:
<source lang="bash" style="width:60%;">
npm update -g homebridge-fhem
</source>
installiert.

=== Fehler während der Installation ===
Bei folgendem Fehler ist das abrufen von Github nicht möglich.
<pre>npm ERR! git clone --template=/home/hs-server-admin/.npm/_git-remotes/_templates --mirror
git://github.com/KhaosT/ed25519.git /home/hs-server-admin/.npm/_git-remotes/git-github-com-KhaosT-ed25519-git-d8bdee1d:
github.com[0: 192.30.252.128]: errno=Die Wartezeit für die Verbindung ist abgelaufen</pre>
Fehlerursache konnte hier durch eine aktive Firewall verursacht werden.

Kommt eine DNS Fehlermeldung fehlt meistens der AVAHI-DAEMON, zu installieren via
<source lang="bash" style="width=50%">
sudo apt-get install avahi-daemon
</source>

= Homebridge konfigurieren =
''Wichtig: Für die weiteren Schritte sollte man nicht root verwenden, sondern beispielsweise einen dedizieren Nutzer für homebridge oder der Einfachheit halber den Nutzer unter dem auch FHEM läuft (meist "fhem").''

== Einstellungen für homebridge ==

Zunächst wird das Verzeichnis für die Konfigurationsdatei erstellt und in dieses gewechselt:
<source lang="bash" style="width:50%;">
mkdir -p ~/.homebridge
cd ~/.homebridge/
</source>

Nun muss darin noch die config.json erstellt bzw. angepasst werden:
<source lang="bash" style="width:50%;">
nano ~/.homebridge/config.json
</source>

Hinweise zur Konfiguration:
* "''bridge''":
** "''username''": Sollte so belassen werden. Sollte später auf dem iOS Device keine Homebridge gefunden werden, so kann man hier beispielsweise den String auf 31 statt 30 enden lassen um so eine neue Homebridge vorzutäuschen.
** "''port''": Sollte so belassen werden
** "''pin''": Der PIN kann beliebig in dem Format xxx-xx-xxx angepasst werden. Dieser muss nur einmal bei der Einrichtung in iOS eingegeben werden.
* "''platforms''":
** "''platform''": Hier muss "homebridge-fhem.fhem" beibehalten werden.
** "''server''": Hier muss die IP des FHEM-Servers eingetragen werden. Dabei muss Homebridge nicht auf dem selben Server laufen wie FHEM, kann aber. Wenn es auf dem gleichen Rechner läuft, dann bietet es sich an, die IP 127.0.0.1 zu verwenden.
** "''port''": Hier muss der Port des gewählten FHEMWEBS eingetragen werden (muss nicht das "normale" sein, kann eine extra Instanz sein)
** "''auth''": Ist FHEM nicht mit Nutzername/Password abgesichert, so kann man diese Zeile einfach entfernen.
** "''filter''": Damit nicht alle Devices von Homebridge berücksichtigt werden, bietet es sich an, die Devices zu filtern. In diesem Beispiel wurden alle Devices, die über Siri steuerbar sein sollen, zusätzlich in den Raum Homekit konfiguriert.
<source lang="javascript" style="width:50%;">
{
"bridge": {
"name": "Homebridge",
"username": "CC:22:3D:E3:CE:30",
"port": 51826,
"pin": "031-45-154"
},

"platforms": [
{
"platform": "homebridge-fhem.FHEM",
"name": "FHEM",
"server": "127.0.0.1",
"port": "8083",
"auth": {"user": "FhemUser", "pass": "XXX"},
"filter": "room=Homekit"
}
],

"accessories": []
}
</source>

Wird FHEM mit SSL abgesichert, so muss zusätzlich in der Sektion "platforms" noch diese Zeile (nach "port") eingefügt werden:
<source lang="javascript" style="width:50%;">
"ssl": true,
</source>

= FHEM konfigurieren =
Um die Devices richtig mit FHEM und Homebridge vertraut zu machen, müssen wir noch unter dem ''global''-Device das folgende zum userattr Attribut hinzufügen:
<source lang="perl">
genericDeviceType:ignore,switch,outlet,light,blind,speaker,thermostat, ContactSensor,lock,window,contact
</source>

Das geht am einfachsten via Eingabefeld (nicht in der fhem.cfg):
<source lang="perl">
{ addToAttrList("genericDeviceType:ignore,switch,outlet,light,blind,speaker,thermostat,ContactSensor,lock,window,contact") }
</source>

Das subType attribut 'gehört' dem jeweiligen Modul und sollte normalerweise nicht von Hand geändert werden.

= Start von Homebridge =

== Hinweis ==
Nach allen Änderungen die in FHEM gemacht werden, welche Homebridge betreffen, muss Homebridge neu gestartet werden. Wie der Neustart erfolgen muss, ist abhängig davon, wie man Homebridge gestartet hat. Bitte den entsprechenden Methoden entnehmen.

== Einmaliger Manueller Start ==
<source lang="bash" style="width:50%;">
homebridge
</source>

Homebridge sollte nun laufen. Hier kann man die Kommunikation nachverfolgen. Abbrechen kann das ganze mit CTRL+c (es dann auch keine Befehle mehr mit Siri möglich). Damit Siri auch Befehle ohne ständig offenes Terminal bearbeiten kann, bitten nächsten Punkt beachten.

== Homebridge automatisch starten ==
Es gibt verschiedene Methoden, Homebridge automatisch zu starten.

=== Steuerung via FHEM ===
Auf Basis der unten stehenden ''Alternativen Methode'' wurde eine Version entwickelt, mit der man auch den Status einsehen und den Restart des Dienstes aus FHEM heraus erledigen kann. Diese Version ist auf der Seite [[Homebridge Start und Status in FHEM]] im Detail beschrieben.

=== Alternative Methode ===
Dies startet homebridge als einen Service.

==== Service anlegen ====
<code>
sudo nano /etc/init.d/homebridge
</code>

Code einfügen (startet den Homebridge Server als Benutzer "pi" und nimmt an, dass sich .homebridge/config.json in seinem Homeverzeichnis unter /home/pi/ befindet):

<source lang=bash>
#!/bin/sh
### BEGIN INIT INFO
# Provides: homebridge
# Required-Start: $network $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start daemon at boot time for homebridge
# Description: Enable service provided by daemon.
### END INIT INFO
export PATH=$PATH:/usr/local/bin
export NODE_PATH=$NODE_PATH:/usr/local/lib/node_modules
PID=`pidof homebridge`
case "$1" in
start)
if ps -p $PID > /dev/null 2>&1; then
echo "Homebridge is already running"
else
su - pi -c "homebridge > /dev/null 2>&1 &"
echo "Homebridge starting"
$0 status
fi
;;
stop)
if ! ps -p $PID > /dev/null 2>&1; then
echo "Homebridge is not running"
else
kill $PID
echo "Homebridge closed"
fi
;;
restart)
if ! ps -p $PID > /dev/null 2>&1; then
$0 start
else
$0 stop
$0 start
fi
;;
status)
if ps -p $PID > /dev/null 2>&1; then
echo "Homebridge is running PID $PID"
else
echo "Homebridge is not running"
fi
;;
*)
echo "Usage: $0 {start|stop|status|restart}"
exit 1
;;
esac
exit 0
</source>

==== Autostart aktivieren ====

<code>
sudo chmod 755 /etc/init.d/homebridge

sudo update-rc.d homebridge defaults
</code>

Nun kann man mit

<code>
sudo service homebridge start
</code>

bzw.

<code>
sudo /etc/init.d/homebridge start
</code>

den Dienst starten

== FHEM Device Einstellungen ==
Damit die zu schaltenden Geräte überhaupt in der Homebridge aufgenommen werden muss man sie im Raum Homekit hinzufügen.

Um HM-CC-RT-DN Thermostate steuern zu können, muss wie oben beschrieben folgendes attribute gesetzt werden (hier als Beispiel das Device "Heizung"):
# attr Heizung subtype thermostat
Für einen Dummy muss man den genericDeviceType setzen, also beispielsweise:
# attr Dummy genericDeviceType switch
# attr Dummy setList on off

Wie bereits vorher angemerkt: Fügt man ein Device hinzu oder führt eine Änderung an einem Device durch, so sollte homebridge neu gestartet werden.

= HomeKit in iOS =

== Einrichtung ==
Um FHEM über Homebridge in iOS nutzen zu können, muss HomeKit eingerichtet werden.

Es gibt verschiedene Apps. Im folgenden wird die App EVE von Elgato empfohlen, die aus dem App-Store geladen werden muss.
In der App auf:
<pre style="width:50%;">
Gerät hinzufügen
</pre>
Es sollte ein Gerät mit der Bezeichnung "Homebridge" zur Auswahl erscheinen. Zur Ersteinrichtung auf PIN manuell eingeben gehen und (falls in der config.json nicht geändert):
<pre style="width:50%;">
031-45-154
</pre>
eingeben.

Im Anschluss können die Devices nach Belieben in verschiedene Räume zugeteilt werden, sowie Szenen und Bereiche erstellt werden.

== Schalten mit Siri ==
'''HolyMoly''' aus dem FHEM-Forum hat ein paar Beispiele gegeben, wie man Siri dazu bringt Devices zu schalten:
<pre style="width:50%;">
"Schalte alle Lampen im Obergeschoss ein."
"Schalte Chloes Licht aus."
"Dimme das Licht in der Küche."
"Dimme das Licht im Esszimmer auf 50 %."
"Stelle das Licht in der Küche am hellsten ein."
"Stelle die Temperatur im Tahoe-Haus auf 22 °C ein."
"Stelle das Thermostat im Erdgeschoss auf 21 °C ein.
"Schalte den Drucker im Büro ein."
"Siri, bereite alles für eine Party vor."
"Bereite das Ambiente fürs Abendessen vor."
"Aktiviere den Nachtruhemodus."
</pre>

Mittlerweile kann Siri auch noch die Lichtfarbe von LEDs ändern.

= Hinweise =

== Unterstützte Geräte ==
Das Fhem Plugin von {{Link2FU|430|Andre (justme1968)}} unterstützt folgende Geräte

switches (devices with set on and set off commands)
lights (devices with set on and set off commands)
homematc and FS20 dimmers (devices with set on, set off and set dim or set pct commands)
HUE, WifiLight, SWAP_0000002200000003 (hue, sat, bri, rgb)
homematic, max and pid20 thermostats
homematic, DUOFERN and FS20/IT(?) blinds
homematic, MAX and FHTTK contact sensors (door, window)
HM-SEC-WIN, HM-SEC-KEY
presence, ROOMMATE
SONOS (power, volume)
harmony scenes
temperaturecw and humidity sensors
CO20 air quality sensor
probably some more ...

== Steuerung von MiLight Allgemein ==
Wie hier im {{Link2Forum|Topic=32652|Message=351706|LinkText=Forum}} erwähnt, ist es möglich auch MiLight Geräte per Siri anzusprechen. Hierzu muss die config.json angepasst werden.

1. Es muss die Bridge hinterlegt werden. Beispiel
<source lang="javascript" style="width:50%;">
{
"platform": "MiLight",
"name": "MiLight",
"ip_address": "192.168.001.033",
"port": 8899,
"type": "rgbw",
"delay": 30,
"repeat": 3,
"zones":["Wohnzimmer Lampen","Badezimmer Lampen","Büro Lampen","Keller Lampen"]
},
</source>

2. Es muss für jedes zu Steuernde Gerät ein Dummy angelegt werden. Beispiel:

<source lang="javascript" style="width:50%;">
{
"accessory": "Http",
"name": "Kitchen Lamp",
"on_url": "https://192.168.1.22:3030/devices/23222/on",
"off_url": "https://192.168.1.22:3030/devices/23222/off",
"brightness_url": "https://192.168.1.22:3030/devices/23222/brightness/%b",
"http_method": "POST"
},
</source>

== Hinweis für alte homebridge Versionen ==
UPDATE: Homebridge funktioniert mit einer kleinen Einschränkung nun auch mit node 4.0.0. Laut
[https://github.com/cflurin/homebridge-shims/wiki/Minimalist-Homebridge-on-a-Raspberry-Pi Homebridge on a Raspberry Pi] müssen die folgenden Abhängigkeiten (Dependencies) aus der '''package.json''' entfernt werden:
<pre>
"harmonyhubjs-client": "^1.1.4",
"harmonyhubjs-discover": "git+https://github.com/swissmanu/harmonyhubjs-discover.git"
</pre>

== Hinweis zur Geschwindigkeitsoptimierung auf einem Raspberry PI ==

Damit es auf einem Raspberry schneller läuft, wird darüber hinaus empfohlen auch diverse Abhängigkeiten aus der '''package.json''' zu entfernen:
<pre>
"ad2usb": "git+https://github.com/alistairg/node-ad2usb.git#local",
"carwingsjs": "0.0.x",
"chokidar": "^1.0.5",
"eibd": "^0.3.1",
"elkington": "kevinohara80/elkington",
"harmonyhubjs-client": "^1.1.4",
"harmonyhubjs-discover": "git+https://github.com/swissmanu/harmonyhubjs-discover.git",
"lifx-api": "^1.0.1",
"lifx": "git+https://github.com/magicmonkey/lifxjs.git",
"node-hue-api": "^1.0.5",
"node-icontrol": "^0.1.4",
"node-milight-promise": "0.0.x",
"tough-cookie": "^2.0.0",
"sonos": "0.8.x",
"telldus-live": "0.2.x",
"teslams": "1.0.1",
"unofficial-nest-api": "git+https://github.com/hachidorii/unofficial_nodejs_nest.git#d8d48edc952b049ff6320ef99afa7b2f04cdee98",
"wemo": "0.2.x",
"wink-js": "0.0.5",
"komponist" : "0.1.0",
"yamaha-nodejs": "0.4.x",
</pre>

Daher zunächst ein ein Backup der Datei anlegen
<pre>sudo cp package.json package.json.bkp </pre>
Am einfachsten geht das entfernen der Zeilen einem Editor, beispielsweise nano oder vi.
<pre>sudo nano package.json</pre>

Das config file sollte dann wie folgt aussehen: Achtung vor den letzten zwei "}" am Ende darf kein Komma sein.
<source lang="javascript">
{
"name": "homebridge",
"description": "HomeKit support for the impatient",
"version": "0.1.1",
"scripts": {
"start": "DEBUG=* node app.js || true"
},
"repository": {
"type": "git",
"url": "git://github.com/nfarina/homebridge.git"
},
"license": "ISC",
"dependencies": {
"async": "^1.4.2",
"color": "0.10.x",
"debug": "^2.2.0",
"hap-nodejs": "^0.0.2",
"isy-js": "",
"mdns": "^2.2.4",
"netatmo": "1.3.0",
"node-cache": "3.0.0",
"node-persist": "0.0.x",
"node-xmpp-client": "1.0.0-alpha23",
"q": "1.4.x",
"queue": "^3.1.0",
"request": "2.49.x",
"xml2js": "0.4.x",
"xmldoc": "0.1.x"
}
}
</source>

[[Kategorie:HOWTOS]]

Callmonitor mit Anruferliste und Zusatzfunktionen

2014-07-12T10:30:50Z

Zephyr: Beschreibung des Callmonitors weitergeführt

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert hauptsächlich auf der Diskussion "Callmonitor für Anfänger" im FHEM-Forum [http://forum.fhem.de/index.php/topic,19238.0.html]. 

Der hier gezeigte Beispielcode ist einem Post [[http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260]] in oben genannter Diskussion entnommen. Er umfasst alle Bestandteile zum Anzeigen einer rollierenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS) sind auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==
Wie die Anruferliste erstellt wird und wie die Voraussetzungen für auszulösende Aktionen eingebunden werden wird im Abschnitt "Lösung" schrittweise erklärt. Die Anforderungen an die Anruferliste und auszulösende Aktionen werden folgend kurz dargestellt.

=== Anforderungen an die Anruferliste ===
* Liste mit der Möglichkeit die letzten fünf über die Fritz!Box angenommenen und getätigten Anrufe darzustellen
* die Liste soll den letzen Anruf in der ersten Zeile anzeigen
* der Status des Anrufes ist über ein Symbol ersichtlich
* Name und Nummer des Angerufenen / Anrufenden sind ersichtlich

=== Anforderungen an die Möglichkeit Aktionen auszulösen ===
* Aktionen können in Abhängigkeit von Status des Anrufes ausgeführt werden
* Aktionen können auch gekapselt werden

=== durchzuführende Schritte ===
Die Reihenfolge ist hier unerheblich. Die Liste soll lediglich einen groben Überblick über die folgenden einzelnen Schritte zur Orientierung geboten werden
* 99_myUtilsTelefon.pm erstellen (bitte zuerst durchführen)
* UserReadings im Callmonitor in FHEM einrichten
* Readingsgroup erstellen, die die UserReadings anzeigt
* Notify erstellen, das die Telefonaktionen aufruft
* in Abhängigkeit vom Anrufstatus auszulösende Aktionen einbinden

== Anwendungsbeispiele ==

== Voraussetzungen ==
=== Aktivierter Callmonitor in der Fritz!Box ===
Damit das Modul Callmonitor in FHEM überhaupt arbeitet, muss zuerst in der Fritz!Box der Callmonitor eingeschalten werden. Das geht am einfachsten, indem man von einem direkt an die Fritz!Box angeschlossenen Telefon die Nummer #96*5* wählt.

=== Funktionierendes Modul Callmonitor in FHEM ===
Ist bereits das Modul Callmonitor in FHEM aktiv, muss es natürlich nicht extra eingerichtet werden. Wie das funktioniert erklärt sehr gut der Artikel [[FB CALLMONITOR]].

=== Anlegen einer Datei 99_myUtilsTelefon.pm ===
Die Datei 99_myUtilsTelefon.pm wird den Perlcode aufnehmen, der die Anruferliste sowie die damit verknüpften Aktionen ausführt. Das Prinzip, um die 99_myUtilsTelefon.pm zu erstellen die exakt das gleich wie wenn man eine [[99 myUtils anlegen]] möchte. In unserem konkreten Fall soll die Datei allerdings den Namen 99_myUtilsTelefon.pm erhalten.

Bitte diesen Schritt nun ausführen, damit später das Script nur noch in die 99_myUtilsTelefon.pm kopiert werden muss.

Natürlich muss auch die 99_myUtilsTelefon.pm nach jeder Anpassung an eigene Bedürfnisse neu geladen werden.

== Lösung ==
In die [[Konfiguration|fhem.cfg]:
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
#attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-07-06T20:01:34Z

Zephyr: Aufgabenstellung als groben Überblick und Anforderungen beschrieben

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert hauptsächlich auf der Diskussion "Callmonitor für Anfänger" im FHEM-Forum [http://forum.fhem.de/index.php/topic,19238.0.html]. 

Der hier gezeigte Beispielcode ist einem Post [[http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260]] in oben genannter Diskussion entnommen. Er umfasst alle Bestandteile zum Anzeigen einer rollierenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS) sind auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==
Wie die Anruferliste erstellt wird und wie die Voraussetzungen für auszulösende Aktionen eingebunden werden wird im Abschnitt "Lösung" schrittweise erklärt. Die Anforderungen an die Anruferliste und auszulösende Aktionen werden folgend kurz dargestellt.

=== Anforderungen an die Anruferliste ===
* Liste mit der Möglichkeit die letzten fünf über die Fritz!Box angenommenen und getätigten Anrufe darzustellen
* die Liste soll den letzen Anruf in der ersten Zeile anzeigen
* der Status des Anrufes ist über ein Symbol ersichtlich
* Name und Nummer des Angerufenen / Anrufenden sind ersichtlich

=== Anforderungen an die Möglichkeit Aktionen auszulösen ===
* Aktionen können in Abhängigkeit von Status des Anrufes ausgeführt werden
* Aktionen können auch gekapselt werden

=== durchzuführende Schritte ===
Die Reihenfolge ist hier unerheblich. Die Liste soll lediglich einen groben Überblick über die folgenden einzelnen Schritte zur Orientierung geboten werden
* 99_myUtilsTelefon.pm erstellen (bitte zuerst durchführen)
* UserReadings im Callmonitor in FHEM einrichten
* Readingsgroup erstellen, die die UserReadings anzeigt
* Notify erstellen, das die Telefonaktionen aufruft
* in Abhängigkeit vom Anrufstatus auszulösende Aktionen einbinden

== Anwendungsbeispiele ==

== Voraussetzungen ==
=== Aktivierter Callmonitor in der Fritz!Box ===
Damit das Modul Callmonitor in FHEM überhaupt arbeitet, muss zuerst in der Fritz!Box der Callmonitor eingeschalten werden. Das geht am einfachsten, indem man von einem direkt an die Fritz!Box angeschlossenen Telefon die Nummer #96*5* wählt.

=== Funktionierendes Modul Callmonitor in FHEM ===
Ist bereits das Modul Callmonitor in FHEM aktiv, muss es natürlich nicht extra eingerichtet werden. Wie das funktioniert erklärt sehr gut der Artikel [[FB CALLMONITOR]].

=== Anlegen einer Datei 99_myUtilsTelefon.pm ===
Die Datei 99_myUtilsTelefon.pm wird den Perlcode aufnehmen, der die Anruferliste sowie die damit verknüpften Aktionen ausführt. Das Prinzip, um die 99_myUtilsTelefon.pm zu erstellen die exakt das gleich wie wenn man eine [[99 myUtils anlegen]] möchte. In unserem konkreten Fall soll die Datei allerdings den Namen 99_myUtilsTelefon.pm erhalten.

Bitte diesen Schritt nun ausführen, damit später das Script nur noch in die 99_myUtilsTelefon.pm kopiert werden muss.

Natürlich muss auch die 99_myUtilsTelefon.pm nach jeder Anpassung an eigene Bedürfnisse neu geladen werden.

== Lösung ==

In die fhem.cfg :
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-07-06T19:39:43Z

Zephyr: Kurzer Hinweis, dass dieser Schritt zuerst durchgeführt werden muss

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert hauptsächlich auf der Diskussion "Callmonitor für Anfänger" im FHEM-Forum [http://forum.fhem.de/index.php/topic,19238.0.html]. 

Der hier gezeigte Beispielcode ist einem Post [[http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260]] in oben genannter Diskussion entnommen. Er umfasst alle Bestandteile zum Anzeigen einer rollierenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS) sind auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==

== Anwendungsbeispiele ==

== Voraussetzungen ==
=== Aktivierter Callmonitor in der Fritz!Box ===
Damit das Modul Callmonitor in FHEM überhaupt arbeitet, muss zuerst in der Fritz!Box der Callmonitor eingeschalten werden. Das geht am einfachsten, indem man von einem direkt an die Fritz!Box angeschlossenen Telefon die Nummer #96*5* wählt.

=== Funktionierendes Modul Callmonitor in FHEM ===
Ist bereits das Modul Callmonitor in FHEM aktiv, muss es natürlich nicht extra eingerichtet werden. Wie das funktioniert erklärt sehr gut der Artikel [[FB CALLMONITOR]].

=== Anlegen einer Datei 99_myUtilsTelefon.pm ===
Die Datei 99_myUtilsTelefon.pm wird den Perlcode aufnehmen, der die Anruferliste sowie die damit verknüpften Aktionen ausführt. Das Prinzip, um die 99_myUtilsTelefon.pm zu erstellen die exakt das gleich wie wenn man eine [[99 myUtils anlegen]] möchte. In unserem konkreten Fall soll die Datei allerdings den Namen 99_myUtilsTelefon.pm erhalten.

Bitte diesen Schritt nun ausführen, damit später das Script nur noch in die 99_myUtilsTelefon.pm kopiert werden muss.

Natürlich muss auch die 99_myUtilsTelefon.pm nach jeder Anpassung an eigene Bedürfnisse neu geladen werden.

== Lösung ==

In die fhem.cfg :
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-07-06T19:30:51Z

Zephyr: /* Funktionierendes Modul Callmonitor in FHEM */

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert hauptsächlich auf der Diskussion "Callmonitor für Anfänger" im FHEM-Forum [http://forum.fhem.de/index.php/topic,19238.0.html]. 

Der hier gezeigte Beispielcode ist einem Post [[http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260]] in oben genannter Diskussion entnommen. Er umfasst alle Bestandteile zum Anzeigen einer rollierenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS) sind auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==

== Anwendungsbeispiele ==

== Voraussetzungen ==
=== Aktivierter Callmonitor in der Fritz!Box ===
Damit das Modul Callmonitor in FHEM überhaupt arbeitet, muss zuerst in der Fritz!Box der Callmonitor eingeschalten werden. Das geht am einfachsten, indem man von einem direkt an die Fritz!Box angeschlossenen Telefon die Nummer #96*5* wählt.

=== Funktionierendes Modul Callmonitor in FHEM ===
Ist bereits das Modul Callmonitor in FHEM aktiv, muss es natürlich nicht extra eingerichtet werden. Wie das funktioniert erklärt sehr gut der Artikel [[FB CALLMONITOR]].

=== Anlegen einer Datei 99_myUtilsTelefon.pm ===
Die Datei 99_myUtilsTelefon.pm wird den Perlcode aufnehmen, der die Anruferliste sowie die damit verknüpften Aktionen ausführt. Das Prinzip, um die 99_myUtilsTelefon.pm zu erstellen die exakt das gleich wie wenn man eine [[99 myUtils anlegen]] möchte. In unserem konkreten Fall soll die Datei allerdings den Namen 99_myUtilsTelefon.pm erhalten.

Natürlich muss auch die 99_myUtilsTelefon.pm nach jeder Anpassung an eigene Bedürfnisse neu geladen werden.

== Lösung ==

In die fhem.cfg :
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-07-06T19:29:26Z

Zephyr:

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert hauptsächlich auf der Diskussion "Callmonitor für Anfänger" im FHEM-Forum [http://forum.fhem.de/index.php/topic,19238.0.html]. 

Der hier gezeigte Beispielcode ist einem Post [[http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260]] in oben genannter Diskussion entnommen. Er umfasst alle Bestandteile zum Anzeigen einer rollierenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS) sind auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==

== Anwendungsbeispiele ==

== Voraussetzungen ==
=== Aktivierter Callmonitor in der Fritz!Box ===
Damit das Modul Callmonitor in FHEM überhaupt arbeitet, muss zuerst in der Fritz!Box der Callmonitor eingeschalten werden. Das geht am einfachsten, indem man von einem direkt an die Fritz!Box angeschlossenen Telefon die Nummer #96*5* wählt.

=== Funktionierendes Modul Callmonitor in FHEM ===
Ist bereits das Modul Callmonitor in FHEM aktiv, muss es natürlich nicht extra eingerichtet werden. Wie das funktioniert erklärt sehr gut der Artikel

=== Anlegen einer Datei 99_myUtilsTelefon.pm ===
Die Datei 99_myUtilsTelefon.pm wird den Perlcode aufnehmen, der die Anruferliste sowie die damit verknüpften Aktionen ausführt. Das Prinzip, um die 99_myUtilsTelefon.pm zu erstellen die exakt das gleich wie wenn man eine [[99 myUtils anlegen]] möchte. In unserem konkreten Fall soll die Datei allerdings den Namen 99_myUtilsTelefon.pm erhalten.

Natürlich muss auch die 99_myUtilsTelefon.pm nach jeder Anpassung an eigene Bedürfnisse neu geladen werden.

== Lösung ==

In die fhem.cfg :
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-07-06T19:18:26Z

Zephyr:

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert hauptsächlich auf der Diskussion "Callmonitor für Anfänger" im FHEM-Forum [http://forum.fhem.de/index.php/topic,19238.0.html]. 

Der hier gezeigte Beispielcode ist einem Post [[http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260]] in oben genannter Diskussion entnommen. Er umfasst alle Bestandteile zum Anzeigen einer rollierenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS) sind auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==

== Anwendungsbeispiele ==

== Voraussetzungen ==
=== Aktivierter Callmonitor in der Fritz!Box ===
Damit das Modul Callmonitor in FHEM überhaupt arbeitet, muss zuerst in der Fritz!Box der Callmonitor eingeschalten werden. Das geht am einfachsten, indem man von einem direkt an die Fritz!Box angeschlossenen Telefon die Nummer #96*5* wählt.

=== Anlegen einer Datei 99_myUtilsTelefon.pm ===
Wie

== Lösung ==

In die fhem.cfg :
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-07-06T18:56:15Z

Zephyr:

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert hauptsächlich auf der Diskussion "Callmonitor für Anfänger" im FHEM-Forum [http://forum.fhem.de/index.php/topic,19238.0.html]. 

Der hier gezeigte Beispielcode ist einem Post [[http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260]] in oben genannter Diskussion entnommen.

Der Code umfasst alle Bestandteile zum Anzeigen einer autom. scrollenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS, habe ich auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==

== Anwendungsbeispiele ==

== Voraussetzungen ==

== Lösung ==

In die fhem.cfg :
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-07-06T18:47:20Z

Zephyr:

'''Callmonitor mit Anruferliste und Zusatzfunktionen '''

Dieser Eintrag basiert haupsächlich auf diesem Post: [http://forum.fhem.de/index.php/topic,19238.msg163260.html#msg163260] 

Der hier gezeigte Beispielcode ist die von mir derzeit (Juni 2014) genutze Variante des Callmonitor mit Zusatzfunktionen, auf der Basis des o.g. Posts und des übrigen Threads "Callmonitor für Anfänger".

Der Code umfasst alle Bestandteile zum Anzeigen einer autom. scrollenden Anruferliste.

Die Zusatzfunktionen (z.B. Floorplan- Seitenwechsel mit Anzeige des Anrufers und dessen gleichzeitiger Ansage über TTS, habe ich auskommentiert. Sie können als Anregung verstanden werden.

Achtung: Größtes Problem bei der Implementierung scheint zu sein, dass die Bezeichnung des Callmonitors nicht einheitlich durchgehalten wird.
In diesem Beispiel heißt er: "my_callmonitor"

== Aufgabenstellung ==

== Anwendungsbeispiele ==

== Voraussetzungen ==

== Lösung ==

In die fhem.cfg :
<nowiki>
# Logfile der Anrufe (Fritzbox)
define FileLog_my_callmonitor FileLog /opt/fhem/log/my_callmonitor-%Y.log my_callmonitor
attr FileLog_my_callmonitor logtype text
attr FileLog_my_callmonitor room 4_Logdaten

# Callmonitor mit rollierender Anruferliste:
define my_callmonitor FB_CALLMONITOR 192.168.1.1:1012
attr my_callmonitor group Connections
attr my_callmonitor icon phone_call
attr my_callmonitor local-area-code 030
attr my_callmonitor reverse-search all
attr my_callmonitor reverse-search-cache-file /opt/fhem/callmoncache.txt
attr my_callmonitor reverse-search-phonebook-file /opt/fhem/fb_phonebook.xml
attr my_callmonitor room 5_System
attr my_callmonitor userReadings eing0 eing1 eing2 eing3 eing4 A0 A1 A2 A3 A4 B0 B1 B2 B3 B4 C0 C1 C2 C3 C4 D0 D1 D2 D3 D4 E0 E1 E2 E3 E4
attr my_callmonitor verbose 0
#attr my_callmonitor reverse-search-cache 1
#attr my_callmonitor reverse-search internal|klicktel.de|dasoertliche.de

# Anrufer Anzeigen:
#########################

# Dummy zur Anzeige des Namen:
define Dum_TelMon_ShowNa_D dummy
#attr Dum_TelMon_ShowNa_D fp_9_Telefon 23,209,0,Eingehender Anruf von:
attr Dum_TelMon_ShowNa_D group Programm
attr Dum_TelMon_ShowNa_D room 5_System

# Dummy zur Anzeige der Nummer:
define Dum_TelMon_ShowNu_D dummy
#attr Dum_TelMon_ShowNu_D fp_9_Telefon 165,278,0,Telefonnummer:
attr Dum_TelMon_ShowNu_D group Programm
attr Dum_TelMon_ShowNu_D room 5_System

# Wenn Telefon klingelt, wechsle zum FP "Telefon",zeige und sage Anrufer an:
#define Func_TelMon_Show_N notify my_callmonitor:event:.ring { \
#my $intum = ReadingsVal("my_callmonitor", "internal_number", undef);;\
#my $extnum = ReadingsVal("my_callmonitor", "external_number", undef);;\
#my $extname = ReadingsVal("my_callmonitor", "external_name", undef);;\
#\
#fhem "set Dum_TelMon_ShowNa_D $extname";;\
#fhem "set Dum_TelMon_ShowNu_D $extnum";;\
#fhem("set Dum_pageswap_D /fhem/floorplan/9_Telefon");;\
#\
# if ($extname eq "unknown"){\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts Rufnummer unterdrückt");;\
# }\
# else {\
# fhem("define Melde_Anrufer_A at +00:00:01 set TTS tts $extname.");;\
# }\
#}
#attr Func_TelMon_Show_N group Programm
#attr Func_TelMon_Show_N room 5_System

# Wenn Telefon aufgelegt, wechsle zum Haupt-FP:
#define Func_TelMon_Back_N notify my_callmonitor:event:.disconnect { \
#fhem("set Dum_pageswap_D /fhem/floorplan/0_Hauptbildschirm");;\
#}
#attr Func_TelMon_Back_N group Programm
#attr Func_TelMon_Back_N room 5_System

# Anrufliste genereieren:
#########################

# Telefonevents für Anrufliste abfangen:
define Func_TelMon_N notify my_callmonitor:.* { \
TelefonMonitor ($EVENT);; \
}
attr Func_TelMon_N group Programm
attr Func_TelMon_N room 5_System

# Anzeige der Anrufliste generieren:
define Anrufliste readingsGroup my_callmonitor:A0,B0,C0,D0,E0 my_callmonitor:A1,B1,C1,D1,E1 my_callmonitor:A2,B2,C2,D2,E2 my_callmonitor:A3,B3,C3,D3,E3 my_callmonitor:A4,B4,C4,D4,E4
attr Anrufliste fp_9_Telefon 370,206,0,Anrufliste
attr Anrufliste mapping &nbsp
attr Anrufliste nameStyle style="font-weight:bold"
attr Anrufliste noheading 0
attr Anrufliste nolinks 1
attr Anrufliste nostate 1
attr Anrufliste notime 1
attr Anrufliste room 0_Überblick
attr Anrufliste style style="font-size:20px"
attr Anrufliste valueIcon {'A0.out_connected' => 'phone_call_out@lightgreen', 'A0.out_notconnected' => 'phone_call_out@red','A0.in_connected' => 'phone_call_in@lightgreen','A0.in_notconnected' => 'phone_call_in@red', 'A0.AB' => 'audio_volume_mid@lightgreen', 'A1.out_connected' => 'phone_call_out@lightgreen', 'A1.out_notconnected' => 'phone_call_out@red','A1.in_connected' => 'phone_call_in@lightgreen','A1.in_notconnected' => 'phone_call_in@red', 'A1.AB' => 'audio_volume_mid@lightgreen','A2.out_connected' => 'phone_call_out@lightgreen', 'A2.out_notconnected' => 'phone_call_out@red','A2.in_connected' => 'phone_call_in@lightgreen','A2.in_notconnected' => 'phone_call_in@red', 'A2.AB' => 'audio_volume_mid@lightgreen','A3.out_connected' => 'phone_call_out@lightgreen', 'A3.out_notconnected' => 'phone_call_out@red','A3.in_connected' => 'phone_call_in@lightgreen','A3.in_notconnected' => 'phone_call_in@red', 'A3.AB' => 'audio_volume_mid@lightgreen','A4.out_connected' => 'phone_call_out@lightgreen', 'A4.out_notconnected' => 'phone_call_out@red','A4.in_connected' => 'phone_call_in@lightgreen','A4.in_notconnected' => 'phone_call_in@red', 'A4.AB' => 'audio_volume_mid@lightgreen'}

</nowiki>

In die 99_myUtilsTelefon.pm :
<nowiki>
#################################################
# $Id: 99_myUtilsTelefon.pm 1932 2012-10-06 20:15:33Z ulimaass $
package main;

use strict;
use warnings;
use POSIX;
use FritzBoxUtils;

# fuer Telefonanrufe
our @A;
our @B;
our @C;
our @D;
our @E;
our %TelefonAktionsListe;

sub myUtilsTelefon_Initialize($$) {
my ($hash) = @_;

#...

}
################################################################

sub SendSMS ($$) {
my $adress = $_[0] . '@sms.kundenserver.de';
my $body = $_[1];
Log( 3, "SendSMS: $adress - $body" );
FB_mail( $adress, "", $body );

# end sub SendSMS
}
#####################################
# Anruffunktionen ueber Fritzbox

sub FBCall ($$) {

my $callnr = $_[0];
my $duration = $_[1];

Log( 3, "FBCall: $callnr mit Dauer $duration" );

$callnr = "ATDT" . $callnr . "#";
my $ret = "ATD: " . `echo $callnr | nc 127.0.0.1 1011`;
InternalTimer( gettimeofday() + $duration, "FBHangOn", "", 0 );
return;
}

sub FBHangOn () {
Log( 3, "FBCallHangOn aufgerufen" );

my $ret = " ATH: " . `echo "ATH" | nc 127.0.0.1 1011`;
$ret =~ s,[\r\n]*,,g;
return;
}

######################################

sub TelefonAktion($$) {

# es wird der Name und die interne angerufene Nummer uebergeben

my ($caller) = split( '\(', $_[0] );
$caller = ltrim( rtrim($caller) );

my $intern = $_[1];

# Log(3,"TelefonAktion: $caller $intern");
# Sound ausgeben

my $com = $main::TelefonAktionsListe{$caller};

if ($com) {
Log( 3, "TelefonAktion: commando: $com" );
sig2_repeat( $com, 5, 4 );
} # falls commando vorhanden

} # end sub TelefonAktion

######################################

sub TelefonMonitor($) {
our $extnum;
our $intnum;
our $extname;
our $callID;
our $callDuration;
# Anrufdauer als Integervariable speichern
our $intCallDuration;
our $stat;
our @lastPhoneEvent;
my $i;
my $j;
our $ab;
my $my_callmonitor = $defs{"my_callmonitor"};

my ( $event, $arg ) = split( ':', $_[0] );
$arg = ltrim($arg);

# Log(3,"TM: event: $event arg: $arg");
if ( $event eq "event" ) {
$stat = $arg;
return;
} # end if event

if ( $stat eq "ring" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "internal_number" ) {
$intnum = $arg;
return;
} # end if intnum

if ( $event eq "call_id" ) {
$callID = $arg;

$lastPhoneEvent[$callID] = $stat;

# hier koennen wir eine anrufgesteuerte Aktion starten
TelefonAktion( $extname, $intnum );

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;
return;
} # end if callid
return;
} # end if ring loop

if ( $stat eq "connect" ) {
if ( ( $event eq "internal_connection" ) && ( $arg =~ m/Answering_Machine_.*/ ) )
{
$ab = "AB";
} # end if internal_connection
} # end if connect

if ( $stat eq "call" ) {
if ( $event eq "external_number" ) {
$extnum = $arg;
return;
} # if external number

if ( $event eq "external_name" ) {
$extname = $arg;
return;
}
if ( $event eq "call_id" ) {
$callID = $arg;

$B[$callID] = EventZeit();
$C[$callID] = $extname;
$D[$callID] = $extnum;

$lastPhoneEvent[$callID] = $stat;
return;
} # end if callid
return;
} # end if callloop

if ( $stat eq "disconnect" ) {

if ( $event eq "call_duration" ) {
$intCallDuration = $arg;
$callDuration = sprintf( "%2d:%02d", ( $arg / 60 ), $arg % 60 );
return;
} # if call_duration

if ( $lastPhoneEvent[$callID] eq "call" ) {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "out_notconnected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der nicht angenommen wurde
} elsif ( $intCallDuration gt 0 ) {
$A[$callID] = "out_connected";
# hier notieren was passieren soll, wenn es ein eingehender Anruf war, der angenommen wurde
}
} elsif ( $lastPhoneEvent[$callID] eq "ring") {
if ( $intCallDuration eq 0 ) {
$A[$callID] = "in_notconnected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der nicht angenommen wurde

$intCallDuration = undef;
} elsif ( $ab eq "AB" ) {
$A[$callID] = "AB";
$ab = undef;
# hier notieren was passieren soll, wenn der AB dranging

$intCallDuration = undef;
} elsif ($intCallDuration gt 0 ){
$A[$callID] = "in_connected";
# hier notieren was passieren soll, wenn es ein ausgehender Anruf war, der angenommen wurde

$intCallDuration = undef;
}
}

#hier notieren was generell passieren soll, sobald ein Anruf beendet wurde (egal ob angenommen, nicht angenommen, aus- oder eingehend oder der AB dranging)

if ( $event eq "call_id" ) {
$callID = $arg;

# shiften der alten Inhalte
my $tt;
readingsBeginUpdate($my_callmonitor);

for ( $i = 4 ; $i > 0 ; $i-- ) {
foreach $j ( 'A' .. 'E' ) {

# $defs{"my_callmonitor"}{READINGS}{$j.($i-1)}{VAL};

$tt = ReadingsVal( "my_callmonitor", $j . ( $i - 1 ), "-" );
readingsBulkUpdate( $my_callmonitor, $j . $i, $tt );
} # end j
} # end i
$E[$callID] = $callDuration;
readingsBulkUpdate( $my_callmonitor, "A0", $A[$callID] );
readingsBulkUpdate( $my_callmonitor, "B0", $B[$callID] );
readingsBulkUpdate( $my_callmonitor, "C0", $C[$callID] );
readingsBulkUpdate( $my_callmonitor, "D0", $D[$callID] );
readingsBulkUpdate( $my_callmonitor, "E0", $E[$callID] );

readingsEndUpdate( $my_callmonitor, 1 );
$stat = "";

return;
} # end if callid

} # end if disconnect

##############################
} #end sub TelefonMonitor

sub EventZeit() {
my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) =
localtime( time() );
return sprintf(
"%2d:%02d:%02d %2d.%02d.%4d",
$hour, $min, $sec, $mday,
( $mon + 1 ),
( $year + 1900 )
);
} # end sub EventZeit
###################

1;

</nowiki>

== Verwendung ==

== Beschreibung der Funktion ==

[[Kategorie:HOWTOS]]

Benutzer:Zephyr/Telefonat als Auslöser für Aktionen

2014-05-09T19:53:01Z

Zephyr: Die Seite wurde neu angelegt: „Im FHEM-Forum wurde im Diskussionsfaden [http://forum.fhem.de/index.php/topic,19238.135.html] über mehrere Schritte eine Anrufliste mit Hilfe des Moduls FB Ca…“

Im FHEM-Forum wurde im Diskussionsfaden [http://forum.fhem.de/index.php/topic,19238.135.html] über mehrere Schritte eine Anrufliste mit Hilfe des Moduls FB Callmonitor programmiert.