{{Baustelle}}{{Infobox Modul
|ModPurpose=Steuern und auslesen von Vallox Belüftungsanlagen
|ModType=d
|ModCmdRef=Vallox
|ModForumArea=Sonstige Systeme
|ModFTopic=71325
|ModTechName=36_Vallox.pm
|ModOwner=Skjall ({{Link2FU|18464|Forum}}) }}
Das Modul [[Vallox]] dient als virtuelles Kontrollterminal am RS485-Bus der Belüftungsanlage des gleichnamigen Herstellers.
Kompatibel sind Geräte der Reihe "Digit SE".

== Voraussetzungen ==
Ein RS485-Adapter ist erforderlich.

Getestete Geräte:
* USB RS485 Adapter mit Gehäuse von In-Circuit

== Anwendung ==
=== Define ===
Die Syntax für das manuelle Anlegen eines Sensors ist der {{Link2CmdRef|Lang=de|Anker=Valloxdefine}} zu entnehmen.

=== Attribute ===
* ValloxIDDomain
:* Dieses Attribut ändert den Wert mit dem das Modul die Domain anspricht und auswertet.
:* Die Domain ist die Adresse des gesamten Systems. So könnte man z.B. ein Mehrfamilienhaus mit vielen Belüftungsanlagen mit einem Bus vernetzen. Die einzelnen Wohnungen bilden dann die Domains.
:* Der Wert ist als 2-stellige Hex-Zahl anzugeben.
:* Default: 01

Innerhalb einer Domain haben die einzelnen Geräte Adressen mit denen sie Angesprochen werden können.
Geräte dürfen keine bereits verwendete Adresse verwenden.

* ValloxIDCentral
:* Dieses Attribut ändert den Wert mit dem das Modul die Belüftung anspricht.
:* Die Belüftungsanlagen liegen in der Range von 11 - 1F wobei 10 die Broadcast-Adresse ist. Die Primäre Belüftungseinheit ist immer die 11.
:* Der Wert ist als 2-stellige Hex-Zahl anzugeben.
:* Default: 11

* ValloxIDFHEM
:* Dieses Attribut ändert den Wert mit dem sich das Modul als virtuelles Bedienterminal identifiziert.
:* Die Bedienterminals liegen in der Range von 21 - 2F wobei 20 die Broadcast-Adresse ist. Die verbaute physikalisch vorhandene Steuereinheit ist in der Regel mit 21 adressiert.
:* Der Wert ist als 2-stellige Hex-Zahl anzugeben.
:* Default: 2F

== Readings ==
Hierbei handelt es sich um alle im Bus verfügbaren und identifizierten Readings. Die Hochgestellten Buchstaben in der letzten Spalte kennzeichnen die [[#Umrechnung|Umrechnungsmethode]] zwischen Buswert und Menschenlesbarem Wert.

{| border="0" class="wikitable mw-collapsed"
!Reading
!Beschreibung
!Bedienterminal
! style="width:150px"|Set Values

|-
|AutomaticHumidityBasicLevelSeekerState
|
|<code>x</code>
|
|-
|BasicHumidityLevel
|Wenn die Luftfeuchtigkeitsregelung (''???'') auf manuell gestellt ist, wird dieser Grenzwert verwendet.
|<code>Grenzwert %RH</code>
| 0 - 100 PCTM
|-
|BoostSwitchMode
|Festlegung ob ein angeschlossener Kontaktschalter die Stoßlüftung oder die Kaminschaltung auslöst. Teil des Multi-Readings: Program
|<code>Tastertyp</code>
|0 = Stoßlüftung 1 = Kaminschalter MB
|-
|CO2AdjustState
|
|<code>x</code>
|
|-
|CO2Alarm
|
|<code>x</code>
|
|-
|CO2High
|
|<code>x</code>
|
|-
|CO2HigherSpeedRequest
|
|<code>x</code>
|
|-
|CO2Low
|
|<code>x</code>
|
|-
|CO2LowerRatePublicInvitation
|
|<code>x</code>
|
|-
|CO2Sensor[1-5]
|
|<code>x</code>
|
|-
|CO2SetPointLower
|Der Zusammenhang zwischen der Veränderung im Terminal und im Bus ist noch ungeklärt.
|<code>CO2-Grenzwert</code>
|
|-
|CO2SetPointUpper
|Der Zusammenhang zwischen der Veränderung im Terminal und im Bus ist noch ungeklärt.
|<code>CO2-Grenzwert</code>
|
|-
|CascadeAdjust
|
|<code>x</code>
|
|-
|CellDefrostingSetpointTemperature
|Der Aufschlagswert (WE: 3 °C) auf den Frostschutz-Wert (''InputFanStopTemperatureThreshold''), bis der Zuluftventilator nach dem Frost-Stop wieder anläuft.
(InputFanStopTemperatureThreshold + CellDefrostingSetpointTemperature = Wiederanlauf)
|<code>Hysterese</code>
|0 - 10 CDSTF
|-
|CurrentVoltageIncomingOnMachine
|
|<code>x</code>
|
|-
|DCFanInputAdjustment
|Bei Verwendung eines Gleichstrom-Zuluftventlilators wird die Leistung auf diesen Prozentsatz skaliert.
|<code>DC-Ventil.Abluft</code>
|0-100 DC
|-
|DCFanOutputAdjustment
|Bei Verwendung eines Gleichstrom-Abluftventlilators wird die Leistung auf diesen Prozentsatz skaliert.
|<code>DC-Ventil.Zuluft</code>
|0-100 DC
|-
|DamperMotorPosition
|Öffnungszustand der Bypass-Klappe (0=Geschlossen/Winter,1=Offen/Sommer) - Teil des Multi-Readings: MultiPurpose2
|colspan="2" style="text-align:center"|''read-only''
|-
|EfficiencyAverage
|
|<code>x</code>
|
|-
|EfficiencyIn
|
|<code>x</code>
|
|-
|EfficiencyOut
|
|<code>x</code>
|
|-
|ExhaustFan
|
|<code>x</code>
|
|-
|FanSpeed
|Aktuelle Lüftungsstufe
|
|1-8 LSM
|-
|FanSpeedMax
|Höchste Stufe auf die die Anlage gestellt werden kann.
|<code>Max Lüftungst.</code>
|1-8 LSM
|-
|FanSpeedMin
|Niedrigste Stufe auf die die Anlage gestellt werden kann.
|<code>Grundluftung</code>
|1-8 LSM
|-
|FaultIndicator
|
|<code>x</code>
|
|-
|FaultSignalRelay
|
|<code>x</code>
|
|-
|FilterGuardIndicator
|
|<code>x</code>
|
|-
|FireplaceBooster
|
|
|
|-
|FireplaceBoosterCountdownMinutes
|
|<code>x</code>
|
|-
|FireplaceBoosterStatus
|
|<code>x</code>
|
|-
|FireplaceSwitchActivation
|
|<code>x</code>
|
|-
|Flags1
|
|<code>x</code>
|
|-
|Flags3
|
|<code>x</code>
|
|-
|FrostAlarmSensor
|
|<code>x</code>
|
|-
|FrostAlarmWaterRadiator
|
|<code>x</code>
|
|-
|HeatRecoveryCellBypassSetpointTemperature
|Wird dieser Wert am Außentemperaturfühler (''Temp_Outside'') erreicht, öffnet sich die Bypass-Klappe und das Gerät schaltet in den Sommer-Betrieb. Wird die Temperatur unterschritten wird die Klappe wieder geschlossen um den Luftstrom durch den Wärmetauscher zu führen.
|<code>WRG Bypass</code>
|0-20 TM
|-
|HeatingIndicator
|
|<code>x</code>
|
|-
|HeatingSetPoint
|
|<code>x</code>
|
|-
|HeatingState
|
|<code>x</code>
|
|-
|HeatingState
|
|<code>x</code>
|
|-
|HumidityLowerRatePublicInvitation
|
|<code>x</code>
|
|-
|HumiditySensor[1-2]
|Luftfeuchtigkeit in %RH der optionalen Sensoren.
|colspan="2" style="text-align:center"|''read-only''
|-
|Initial1
|
|<code>x</code>
|
|-
|Initial2
|
|<code>x</code>
|
|-
|Initial3
|
|<code>x</code>
|
|-
|Initial4
|
|<code>x</code>
|
|-
|Initial5
|
|<code>x</code>
|
|-
|InputFanStopTemperatureThreshold
|Sinkt der Wert des Fortluft-Temperaturfühlers (''TempExhaust'') unter diesen Wert (WE: 3°C) schaltet der Zuluftventilator ab, um ein Einfrieren des Wärmetauschers zu verhindern.
|<code>Frostschutz WRG</code>
|−6 - 15 LSM
|-
|LastSystemFault
|Letzter im Gerät gespeicherter Fehler
|colspan="2" style="text-align:center"|''read-only''
|-
|MasterSlaveSelection
|
|<code>x</code>
|
|-
|MaxSpeedLimitFunction
|
|<code>x</code>
|
|-
|PostHeating
|Gibt an, ob das Nachheizregister läuft. (0=Aus; 1=An) - Teil des Multi-Readings: MultiPurpose1
|colspan="2" style="text-align:center"|''read-only''
|-
|PostHeatingOffTime
|
|<code>x</code>
|
|-
|PostHeatingOnCounter
|
|<code>x</code>
|
|-
|PostHeatingTargetValue
|
|<code>x</code>
|
|-
|PowerState
|Gibt an, ob die Anlage An- oder Ausgeschaltet ist. Das setzen auf 0 kann nicht rückgängig gemacht werden. Die Anlage ist aus, muss vom Strom getrennt und nach ein paar Sekunden wieder verbunden werden. Teil des Multi-Readings: Select
|
|0 = Aus 1 = An MB
|-
|PreHeating
|
|<code>x</code>
|
|-
|PreHeatingStatus
|
|<code>x</code>
|
|-
|PreheatingSetPoint
|
|<code>Vorheizregister</code>
|−6 - 15 TM
|-
|RHAdjustState
|
|<code>x</code>
|
|-
|RadiatorType
|
|<code>x</code>
|
|-
|RemoteMonitoringControl
|
|<code>x</code>
|
|-
|ResumeBus
|
|<code>x</code>
|
|-
|ServiceReminderIndicator
|Zeigt an, dass der Wartungszyklus (<code>ServiceReminderMonths</code>) abgelaufen ist und das die Vorfilter (Vließ und Pappfilter) der Belüftungsanlage gereinigt werden müssen. Teil des Multi-Readings: Select
|
|0 = keine Wartung 1 = Wartung MB
|-
|ServiceReminderMonths
|Zeitintervall zwischen Wartungsmeldungen
|<code>Wartungsintervall</code>
|1 - 15 DF
|-
|Speed[1-8]
|Gibt für die einzelnen werte 0=Off oder 1=On an. (Bedeutung?) Teil des Multi-Readings: FanSpeedRelays
|colspan="2" style="text-align:center"|''read-only''
|-
|SupplyFan
|
|<code>x</code>
|
|-
|SuspendBusForCO2Communication
|
|<code>x</code>
|
|-
|SwitchLowerSpeedRequest
|
|<code>x</code>
|
|-
|TempExhaust
|Temperatur der ausströmenden Luft an der nach außen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|-
|TempIncoming
|Temperatur der einströmenden Luft an der nach innen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|-
|TempInside
|Temperatur der ausströmenden Luft an der nach innen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|-
|TempOutside
|Temperatur der einströmenden Luft an der nach außen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|}

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:Other Components]]

Vallox

2018-04-30T15:23:42Z

Skjall: /* Readings */

{{Baustelle}}{{Infobox Modul
|ModPurpose=Steuern und auslesen von Vallox Belüftungsanlagen
|ModType=d
|ModCmdRef=Vallox
|ModForumArea=Sonstige Systeme
|ModFTopic=71325
|ModTechName=36_Vallox.pm
|ModOwner=Skjall ({{Link2FU|18464|Forum}}) }}
Das Modul [[Vallox]] dient als virtuelles Kontrollterminal am RS485-Bus der Belüftungsanlage des gleichnamigen Herstellers.
Kompatibel sind Geräte der Reihe "Digit SE".

== Voraussetzungen ==
Ein RS485-Adapter ist erforderlich.

Getestete Geräte:
* USB RS485 Adapter mit Gehäuse von In-Circuit

== Anwendung ==
=== Define ===
Die Syntax für das manuelle Anlegen eines Sensors ist der {{Link2CmdRef|Lang=de|Anker=Valloxdefine}} zu entnehmen.

=== Attribute ===
* ValloxIDDomain
:* Dieses Attribut ändert den Wert mit dem das Modul die Domain anspricht und auswertet.
:* Die Domain ist die Adresse des gesamten Systems. So könnte man z.B. ein Mehrfamilienhaus mit vielen Belüftungsanlagen mit einem Bus vernetzen. Die einzelnen Wohnungen bilden dann die Domains.
:* Der Wert ist als 2-stellige Hex-Zahl anzugeben.
:* Default: 01

Innerhalb einer Domain haben die einzelnen Geräte Adressen mit denen sie Angesprochen werden können.
Geräte dürfen keine bereits verwendete Adresse verwenden.

* ValloxIDCentral
:* Dieses Attribut ändert den Wert mit dem das Modul die Belüftung anspricht.
:* Die Belüftungsanlagen liegen in der Range von 11 - 1F wobei 10 die Broadcast-Adresse ist. Die Primäre Belüftungseinheit ist immer die 11.
:* Der Wert ist als 2-stellige Hex-Zahl anzugeben.
:* Default: 11

* ValloxIDFHEM
:* Dieses Attribut ändert den Wert mit dem sich das Modul als virtuelles Bedienterminal identifiziert.
:* Die Bedienterminals liegen in der Range von 21 - 2F wobei 20 die Broadcast-Adresse ist. Die verbaute physikalisch vorhandene Steuereinheit ist in der Regel mit 21 adressiert.
:* Der Wert ist als 2-stellige Hex-Zahl anzugeben.
:* Default: 2F

== Readings ==
Hierbei handelt es sich um alle im Bus verfügbaren und identifizierten Readings:
{| border="0" class="wikitable mw-collapsed"
!Reading
!Beschreibung
!Bedienterminal
! style="width:150px"|Set Values

|-
|AutomaticHumidityBasicLevelSeekerState
|
|<code>x</code>
|
|-
|BasicHumidityLevel
|Wenn die Luftfeuchtigkeitsregelung (''???'') auf manuell gestellt ist, wird dieser Grenzwert verwendet.
|<code>Grenzwert %RH</code>
| 0 - 100 PCTM
|-
|BoostSwitchMode
|Festlegung ob ein angeschlossener Kontaktschalter die Stoßlüftung oder die Kaminschaltung auslöst. Teil des Multi-Readings: Program
|<code>Tastertyp</code>
|0 = Stoßlüftung 1 = Kaminschalter MB
|-
|CO2AdjustState
|
|<code>x</code>
|
|-
|CO2Alarm
|
|<code>x</code>
|
|-
|CO2High
|
|<code>x</code>
|
|-
|CO2HigherSpeedRequest
|
|<code>x</code>
|
|-
|CO2Low
|
|<code>x</code>
|
|-
|CO2LowerRatePublicInvitation
|
|<code>x</code>
|
|-
|CO2Sensor[1-5]
|
|<code>x</code>
|
|-
|CO2SetPointLower
|Der Zusammenhang zwischen der Veränderung im Terminal und im Bus ist noch ungeklärt.
|<code>CO2-Grenzwert</code>
|
|-
|CO2SetPointUpper
|Der Zusammenhang zwischen der Veränderung im Terminal und im Bus ist noch ungeklärt.
|<code>CO2-Grenzwert</code>
|
|-
|CascadeAdjust
|
|<code>x</code>
|
|-
|CellDefrostingSetpointTemperature
|Der Aufschlagswert (WE: 3 °C) auf den Frostschutz-Wert (''InputFanStopTemperatureThreshold''), bis der Zuluftventilator nach dem Frost-Stop wieder anläuft.
(InputFanStopTemperatureThreshold + CellDefrostingSetpointTemperature = Wiederanlauf)
|<code>Hysterese</code>
|0 - 10 CDSTF
|-
|CurrentVoltageIncomingOnMachine
|
|<code>x</code>
|
|-
|DCFanInputAdjustment
|Bei Verwendung eines Gleichstrom-Zuluftventlilators wird die Leistung auf diesen Prozentsatz skaliert.
|<code>DC-Ventil.Abluft</code>
|0-100 DC
|-
|DCFanOutputAdjustment
|Bei Verwendung eines Gleichstrom-Abluftventlilators wird die Leistung auf diesen Prozentsatz skaliert.
|<code>DC-Ventil.Zuluft</code>
|0-100 DC
|-
|DamperMotorPosition
|Öffnungszustand der Bypass-Klappe (0=Geschlossen/Winter,1=Offen/Sommer) - Teil des Multi-Readings: MultiPurpose2
|colspan="2" style="text-align:center"|''read-only''
|-
|EfficiencyAverage
|
|<code>x</code>
|
|-
|EfficiencyIn
|
|<code>x</code>
|
|-
|EfficiencyOut
|
|<code>x</code>
|
|-
|ExhaustFan
|
|<code>x</code>
|
|-
|FanSpeed
|Aktuelle Lüftungsstufe
|
|1-8 LSM
|-
|FanSpeedMax
|Höchste Stufe auf die die Anlage gestellt werden kann.
|<code>Max Lüftungst.</code>
|1-8 LSM
|-
|FanSpeedMin
|Niedrigste Stufe auf die die Anlage gestellt werden kann.
|<code>Grundluftung</code>
|1-8 LSM
|-
|FaultIndicator
|
|<code>x</code>
|
|-
|FaultSignalRelay
|
|<code>x</code>
|
|-
|FilterGuardIndicator
|
|<code>x</code>
|
|-
|FireplaceBooster
|
|
|
|-
|FireplaceBoosterCountdownMinutes
|
|<code>x</code>
|
|-
|FireplaceBoosterStatus
|
|<code>x</code>
|
|-
|FireplaceSwitchActivation
|
|<code>x</code>
|
|-
|Flags1
|
|<code>x</code>
|
|-
|Flags3
|
|<code>x</code>
|
|-
|FrostAlarmSensor
|
|<code>x</code>
|
|-
|FrostAlarmWaterRadiator
|
|<code>x</code>
|
|-
|HeatRecoveryCellBypassSetpointTemperature
|Wird dieser Wert am Außentemperaturfühler (''Temp_Outside'') erreicht, öffnet sich die Bypass-Klappe und das Gerät schaltet in den Sommer-Betrieb. Wird die Temperatur unterschritten wird die Klappe wieder geschlossen um den Luftstrom durch den Wärmetauscher zu führen.
|<code>WRG Bypass</code>
|0-20 TM
|-
|HeatingIndicator
|
|<code>x</code>
|
|-
|HeatingSetPoint
|
|<code>x</code>
|
|-
|HeatingState
|
|<code>x</code>
|
|-
|HeatingState
|
|<code>x</code>
|
|-
|HumidityLowerRatePublicInvitation
|
|<code>x</code>
|
|-
|HumiditySensor[1-2]
|Luftfeuchtigkeit in %RH der optionalen Sensoren.
|colspan="2" style="text-align:center"|''read-only''
|-
|Initial1
|
|<code>x</code>
|
|-
|Initial2
|
|<code>x</code>
|
|-
|Initial3
|
|<code>x</code>
|
|-
|Initial4
|
|<code>x</code>
|
|-
|Initial5
|
|<code>x</code>
|
|-
|InputFanStopTemperatureThreshold
|Sinkt der Wert des Fortluft-Temperaturfühlers (''TempExhaust'') unter diesen Wert (WE: 3°C) schaltet der Zuluftventilator ab, um ein Einfrieren des Wärmetauschers zu verhindern.
|<code>Frostschutz WRG</code>
|−6 - 15 LSM
|-
|LastSystemFault
|Letzter im Gerät gespeicherter Fehler
|colspan="2" style="text-align:center"|''read-only''
|-
|MasterSlaveSelection
|
|<code>x</code>
|
|-
|MaxSpeedLimitFunction
|
|<code>x</code>
|
|-
|PostHeating
|Gibt an, ob das Nachheizregister läuft. (0=Aus; 1=An) - Teil des Multi-Readings: MultiPurpose1
|colspan="2" style="text-align:center"|''read-only''
|-
|PostHeatingOffTime
|
|<code>x</code>
|
|-
|PostHeatingOnCounter
|
|<code>x</code>
|
|-
|PostHeatingTargetValue
|
|<code>x</code>
|
|-
|PowerState
|Gibt an, ob die Anlage An- oder Ausgeschaltet ist. Das setzen auf 0 kann nicht rückgängig gemacht werden. Die Anlage ist aus, muss vom Strom getrennt und nach ein paar Sekunden wieder verbunden werden. Teil des Multi-Readings: Select
|
|0 = Aus 1 = An MB
|-
|PreHeating
|
|<code>x</code>
|
|-
|PreHeatingStatus
|
|<code>x</code>
|
|-
|PreheatingSetPoint
|
|<code>Vorheizregister</code>
|−6 - 15 TM
|-
|RHAdjustState
|
|<code>x</code>
|
|-
|RadiatorType
|
|<code>x</code>
|
|-
|RemoteMonitoringControl
|
|<code>x</code>
|
|-
|ResumeBus
|
|<code>x</code>
|
|-
|ServiceReminderIndicator
|Zeigt an, dass der Wartungszyklus (<code>ServiceReminderMonths</code>) abgelaufen ist und das die Vorfilter (Vließ und Pappfilter) der Belüftungsanlage gereinigt werden müssen. Teil des Multi-Readings: Select
|
|0 = keine Wartung 1 = Wartung MB
|-
|ServiceReminderMonths
|Zeitintervall zwischen Wartungsmeldungen
|<code>Wartungsintervall</code>
|1 - 15 DF
|-
|Speed[1-8]
|Gibt für die einzelnen werte 0=Off oder 1=On an. (Bedeutung?) Teil des Multi-Readings: FanSpeedRelays
|colspan="2" style="text-align:center"|''read-only''
|-
|SupplyFan
|
|<code>x</code>
|
|-
|SuspendBusForCO2Communication
|
|<code>x</code>
|
|-
|SwitchLowerSpeedRequest
|
|<code>x</code>
|
|-
|TempExhaust
|Temperatur der ausströmenden Luft an der nach außen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|-
|TempIncoming
|Temperatur der einströmenden Luft an der nach innen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|-
|TempInside
|Temperatur der ausströmenden Luft an der nach innen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|-
|TempOutside
|Temperatur der einströmenden Luft an der nach außen zeigenden Seite des Wärmetauschers
|colspan="2" style="text-align:center"|''read-only''
|}

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:Other Components]]

Vallox

2017-06-27T07:46:06Z

Skjall:

Vallox

2017-06-19T08:41:57Z

Skjall: /* Attribute */ Neue Adresse

HomeConnect

2017-05-07T12:17:12Z

Skjall: /* Problembehandlung */ csrfToken Problem ergänzt

{{Infobox Modul
|ModPurpose=Anbindung von Hausgeräten mit Home Connect Schnittstelle
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=48_HomeConnectConnection.pm 48_HomeConnect.pm
|ModOwner=swhome
}}
==Übersicht==
Mit den beiden Modulen HomeConnectConnection und HomeConnect können in FHEM Devices für [http://www.home-connect.com/de/de/|Home Connect Hausgeräte] angelegt werden, die an einem Home Connect Account angemeldet sind. Mögliche Hausgeräte sind aktuell Backöfen, Spülmaschinen, Kühlschränke, Waschmaschinen, Wäschetrockner und Kaffeemaschinen der Marken Bosch, Siemens und Neff.

Wann verwendet man HomeConnectConnection, wann HomeConnect?

Das Modul HomeConnectConnection verwaltet die Verbindung zwischen FHEM und einem Home Connect Account. Es legt die HomeConnect Devices für die einzelnen Hausgeräte an.

==Aktueller Status des Moduls==
Die beiden Module befinden sich aktuell im Betatest. Jeder Tester muss sich bei Home Connect als Entwickler anmelden und freigeschaltet werden. Aktuell werden keine weiteren Tester freigeschaltet.

Die Testphase wird bis Mitte Februar abgeschlossen sein, danach erwarten wir eine allgemeine Freischaltung.

Was jeder schon heute probieren kann ist der Hausgeräte-Simulator. Allerdings kann man damit in der Praxis nicht viel anfangen...

==Definition von FHEM Devices==
===Modul-Installation===
Zur Installation (oder zum Update) einfach diesen Befehl in der FHEM Kommandozeile eingeben:

<pre>
update all https://raw.githubusercontent.com/sw-home/FHEM-HomeConnect/master/controls_homeconnect.txt
</pre>

Danach FHEM neu starten.

Fehlermeldungen? Eventuell muss die Perl-Bibliothek libswitch-perl installiert werden.

===Basisdefinition===
Um mit dem Simulator zu testen, braucht Ihr einen Entwickleraccount bei [https://developer.home-connect.com/]

Man braucht zwingend einen Advanced Account um Geräte fernstarten zu dürfen. Das kostet nichts, es wird jedoch eine Namensverifikation durchgeführt.

Im Entwickleraccount muss eine Applikation generiert werden, das wichtigste dabei ist die Redirect URL. Diese URL muss den Host enthalten, den Ihr in Eurer Umgebung für den Zugriff auf FHEM verwendet, also localhost oder 192.168.x.y, und sie muss ein Kommando in dem definierten HomeConnectConnection Modul aufrufen. Die URL sieht dann z.B. so aus:

<pre>
http://localhost:8083/fhem?cmd.Test=set%20hcconn%20auth%20
</pre>

Die identische URL muss sowohl auf der Home Connect Seite in der Applikation angegeben werden, als auch bei der Definition in FHEM. Dazu kommt noch der generierte API Key:

<pre>
define hcconn HomeConnectConnection API-KEY REDIRECT-URL simulator
</pre>

Also zum Beispiel

<pre>
define hcconn HomeConnectConnection D239EBCABC99994D239EBCABC999B3D2393204
http://localhost:8083/fhem?cmd.Test=set%20hcconn%20auth%20 simulator
</pre>

Danach findet Ihr in dem neuen Device hcconn einen Link namens Home Connect Login. Diesen klicken und die Anmeldung wird durchgeführt. Danach im hcconn-Device noch scanDevices ausführen und Ihr solltet eine stattliche Anzahl Hausgeräte finden.

==Problembehandlung==
Frage: Wenn ich Zuhause bin, erreiche ich meinen FHEM-Server unter: https:// 192.168.x.x:8083/fhem.
Aus dem Internet erreiche ich FHEM über eine statische IP und Port-forwarding. Funktioniert das dann auch?

Antwort: Es muss kein Zugriff aus dem Internet auf den lokalen Server freigeschaltet werden, der Redirect passiert im eigenen Browser.
Aktuell ist nur eine redirect URL möglich, daher müsstest Du dich beim Home Connect Login für eine Variante entscheiden. Man muss sich ja nicht ständig neu einloggen. Ich habe aber gehört dass zukünftig mal eine Liste von URL's hinterlegt werden kann.

Frage: Ich bekomme '''vor''' dem Home Connect Login eine Fehlermeldung, sofort nach dem Klick auf "Home Connect Login"

Antwort: Entweder ist der API Key falsch oder die Redirect URL. Letztere muss den korrekten Hostnamen und Port enthalten, und auch den Namen des HomeConnectConnection device in der FHEM Installation. Diese URL muss identisch in der Home Connect App Definition und in der FHEM Definition eingetragen werden.

Frage: Ich bekomme '''nach''' dem Home Connect Login "Error" als Meldung in FHEM

Antwort: Dann hat Deine Redirect URL gestimmt und es ist was faul mit dem Api Key.

- Inspiziere mal genau die URL der Seite wo "Error" steht, vielleicht findest Du dort noch eine Fehlermeldung.

- Hast Du das Wort simulator in der Definition mit angegeben? Nur freigeschaltete Betatester können echte Hausgeräte steuern.

- Hast Du einen Advanced Account? Wenn nicht, können die Rechte von FHEM so eingeschränkt werden:
<pre>
attr hcconn accessScope IdentifyAppliance Monitor
</pre>

Frage: Die Geräte werden angelegt, aber das einzige, was ich angeboten bekomme ist: StartProgram RemoteProgramNotEnabled

Antwort: Du musst den Fernstart der Spülmaschine aktivieren, erst danach darf FHEM sie starten.

Frage: Nach dem Erlauben des Zugriffs bei HomeConnect erscheint nur ein weißer Bildschirm.

Antwort: Du musst das Attribut csrfToken deines FHEMWEB auf none setzen.
<pre>
attr WEB csrfToken none
</pre>

==Unterstützte Geräte==
Grundsätzlich funktionieren alle Home Connect Geräte, d.h. sie werden zumindest in FHEM angelegt und ihr Status wird sichtbar. Steuern kann man sie aktuell jedoch noch nicht alle.
===Backofen===
Steuerung aktuell nicht möglich, aber der Status wird angezeigt
===Geschirrspüler===
Steuerung möglich, Status wird angezeigt. Die Programmoption BSH.Common.Option.StartInRelative kann vor dem Programmstart auf eine Anzahl Sekunden gesetzt werden, um die der Start verzögert werden soll.

[[Kategorie:Other Components]]

SIP-Client

2017-05-06T08:11:21Z

Skjall: /* Attribute */

{{Infobox Modul
|ModPurpose=SIP-Client für FHEM
|ModType=h
|ModCmdRef=SIP
|ModForumArea=Sonstiges
|ModTechName=96_SIP.pm
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}

Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden, Textansage) von Anrufen.

== Voraussetzungen ==
=== FHEM-Server ===
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z. B. mit dem Befehl
:<code>sudo cpan install Net::SIP</code>

oder auch

:<code>sudo apt-get install libnet-sip-perl</code>

'''Falls Ihr Text2Speech verwenden wollt'''

Vorbereitung
* SoX installieren
:<code>sudo apt-get install sox </code>
* mp3 Unterstützung für SoX installieren
:<code>sudo apt-get install libsox-fmt-mp3</code>
* Text2Speech als Server Device anlegen
:<code>define <name z.B myT2S> text2speech none</code>
* beim SIP Device dieses Server Device im Attribut T2S_Device eintragen

=== SIP-Server ===
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider).
Auf dem SIP-Server, mit dem sich der Client verbinden soll, muss ein User-Account vorhanden sein bzw. angelegt werden.
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort (mind. 8 Stellen und Stufe 'gut') vergeben werden. Das erzeugt ein neues internes Device im internen Rufnummernbereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.

=== Hardware ===
Die verwendete Library Net::SIP fordert mehr Ressourcen als RaspberryPi, BananaPi & Co hergeben. Bitte testet, ob Eure Hardware Audofiles sauber abspielen sowie sicher DTMF-Töne empfangen kann und für Euren Einsatzzweck geeignet ist. Erste Tests mit einem Raspi3 lagen im akzeptablen Bereich.

== Installation ==
=== Erste Schritte ===
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.

Nun ist der SIP-Client als Device in FHEM anzulegen:

:<code>define <name> SIP</code>

Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden. Ebenso ist das Passwort mittels set-Command zu speichern.

Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]

=== Mögliche Fehlermeldungen ===
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.

== Anwendung ==
=== Attribute ===

''Basics & Allgemeines''
* '''sip_from'''
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki> für ältere Fritz!OS-Versionen. Ab 6.8 ist das Format <nowiki>sip:Benutzername@fritz.box</nowiki>.
* '''sip_ip'''
: Die IP-Addresse meines FHEM-Servers.
* '''sip_port'''
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.
* '''sip_registrar'''
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.
* '''sip_user'''
: User Name des SIP-Clients. Default ist 620. Anmerkung: Passwort wird über "set <device> password ''mypassword''" gesetzt.
* '''sip_listen'''
: Das Attribut bietet folgende Optionen
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer (listen_dtmf). Alternativ kann der Prozess manuell via 'listen' gestartet werden.
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play (listen_wfp). Alternativ kann der Prozess manuell via 'listen' gestartet werden.
: - '''echo''': Spielt dem Anrufer nur sein eigenes Echo wider. Sonst nix (siehe auch Anwendungsfälle).
* '''sip_waittime'''
: Maximale Wartezeit bei listen_wfp bis das Gespräch automatisch angenommen wird.
* '''sip_ringtime'''
: listen: legt fest wie lange das Modul warten soll bis es den Anruf annimmt. Defaultwert ist 2, das entspricht ca. 1x klingeln.
* '''sip_force'''
: Pause in Sekunden für nicht erfolgreiche "force"-Anrufe, bis der nächste Versuch gestartet wird.

* '''sip_filter'''
: ist eine Komma getrennte Liste von Rufnummern oder Rufnummernteilen die festlegen, ob der Client bei listen überhaupt abheben soll.
: Bsp.: attr mySIP sip_filter **61,123
: **61 = alle DECT Telefone der Fritzbox (610 -619 )
: 123 = alle Rufnummern in denen die Folge 123 enthalten ist.
: Wenn das Attribut sip_filter gelöscht ist werden alle Anrufe angenommen. Das Atrribut entspricht einer Whitelist der Rufnummern die akzepziert/angenommen werden. Anrufe von nicht gelisteten Rufnummern werden einfach ignoriert.

* Anmerkung zum '''Audioformat'''
: Audiofiles müssen im alaw- oder ulaw-Format vorliegen und können mit folgendem Command erzeugt werden
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''
: da nur diese raw audio format unterstützt wird. Unterstützte/erkannte Endungen sind .alaw und .ulaw. Bitte darauf achten, dass das audiofile und der komplette Pfad die passenden Permissions hat, damit der FHEM User das File auch lesen darf.

''DTMF empfangen''
* '''sip_dtmf_loop'''
: legt für den listen_dtmf-Modus fest wie oft ein DTMF Code eingeben werden soll ( once oder loop, default ist once ).
: Bei 'once' erwartet der SIP-Cleint die Eingabe eines Codes in der angegebenen Länge und beendet den Anruf.
: Bei 'loop' startet eine Endlosschleife aus Ansage->Code-Erfassung->Quittung->Loop bis der Anrufer irgendwann auflegt.
* '''sip_dtmf_size'''
: Die Anzahl der erwarteten DTMF-Töne im listen_dtmf-Modus (1 bis 4)
* '''sip_audiofile_dtmf'''
: Audiofile das dem Anrufer im listen_dtmf-Modus vorgespielt wird und ihn auffordert einen Code einzugeben. Ist kein File angegeben hört man ein Geräusch.
* '''sip_audiofile_ok'''
: Audiofile das dem Anrufer im listen_dtmf-Modus als Quittungston vorgespielt wird.
* '''sip_blocking'''
: Hier kann so etwas wie eine Blacklist von Rufnummern angegeben werden, die explizit weggedrückt werden. Jede Rufnummer die so behandelt werden soll muss zuerst erfolgreich durch den sip_filter durch und kann danach erst aktiv geblockt werden. Die Syntax ist die gleiche wie bei sip_filter, allerdings gibt es hier den Joker '''.*''' . Ist dieser gesetzt wird jede ankommende Rufnummer geblockt. Damit lassen sich begrenzt Aktionen auslösen (das Event 'ringing_*' wird nach wie vor ausgelöst und die Rufnummer wird als Reading gesetzt) ohne dass Verbindungskosten anfallen.

''Auf anruf warten und annehmen''
* '''sip_audiofile_wfp'''
: Audiofile das nach dem Command '''fetch''' abgespielt wird.
* '''sip_elbc'''
: erlaubte Werte: no | yes. elbc steht für 'End Listen Befor Call'. Bei Option 'yes' wird ein laufender Listen Prozess beendet falls parallel ein Call rausgehen soll. Danach wird der listen wieder neu gestartet.

''Anrufen und DTMF senden''
* '''sip_dtmf_send'''
: Bestimmt die Übertragungsart der angegebenen DTMF-Töne und bietet folgende Möglichkeiten:
: 'audio': Es werden Audiotöne übermittelt
: 'rfc2833': Es erfolgt eine Übertragung nach RFC2833 (für das menschliche Ohr weniger ansprechend)

''Anrufen und etwas senden''
* '''sip_audiofile_call'''
: Audiofile das dem angerufenen bei '''call''' vorgespielt wird.
* '''sip_call_audio_delay'''
: Damit wird festgelegt wie lange bei einem Call mit dem abspielen des Audiofiles gewartet werden soll nachdem man den Anruf angenommen hat. Gültige Werte sind 0 - 3 in 0.25 (1/4) Sekunden Schritten.

''Anrufen und etwas sagen''
* '''T2S_Device'''
: Name Eures in FHEM eingerichteten Text2Speech-Devices
* '''T2S_Timeout'''
: Timeout für die Text2Speech-Konvertierung (könnte ja sein, dass der TTS-Service im Internet überlastet ist)
* '''audio_converter'''
: Der für die Konvertierung zu verwendende (und vorab installierte) Audiokonverter. Auswahl: sox oder ffmpeg

Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]

=== Set ===

Das Modul kennt derzeit folgende Commands

* set <name> '''password'''
: Passwort für den User sip_user hinterlegen.

* set <name> '''reset'''

: Stoppt laufende listen-Prozess und initalisiert das Device.

* set <name> '''call <nummer> [<maxtime>] [<nachricht>] [*nn] [&][nn]'''
: Startet einen Anruf an die angegebene Nummer.
: Optional kann die maxtime angegeben werden. Wird keine angegeben wird der Defaultwert von 30 verwendet.
: Optional kann eine Nachricht
: - in Form eines '''Audiofiles''' angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf. Die maxtime ist in dem Fall nicht optional sondern zwingend.
: - als '''DTMF'''-Sequenz angegeben werden. Diese mit einem Prefix '-' versehen werden, also z.B. '''-'''#47.
: - als '''Text''' angegeben werden. Dieser mit einem Prefix '!' versehen werden, also z.B. '''!'''Hier spricht dein FHEM.
: Bitte hierfür unter 'Voraussetzungen' den Hinweis auf TTS beachten.
: Wir ein Wiederholunsfaktor in der Form '''*nn''' angegeben, wird der Anruf einmal ausgeführt und dann nn mal wiederholt.
: Wird als Wiederholungsfaktor ein negativer Wert angegeben (z.B. '''*-2'''), passiert folgendes: Die Nachricht wird zwar genau wie bei *2 dreimal abgespielt, allerdings erlaubt das - vor der 2 das die Nachricht nur einmal vollständig übertragen werden muß. Der call_state nach dem Call hätte dann z.B. den Wert "ok peer hangup".
: Wird der Call mit '''&''' (force) beendet signalisiert dies, dass er wichtig ist und unbedingt zugestellt werden muss. Der SIP-Client versucht es dann so lange, bis der Anrufer erreicht wird. WICHTIG: wählt die maxtime groß genug damit das Audiofile auch wirklich komplett abgespielt werden kann, bzw. hört's euch auch bis zum Ende an! Wenn ein priorisierter Anruf vorzeitig endet (quasi NOK) wird er nach 1 Minute wiederholt, und zwar so lange bis er erfolgreich war. Wollt Ihr den Ablauf stoppen bitte das von der Wiederholungsschleife gesetzte '''at''' löschen, es befindet sich im gleichen Raum wie euer SIP Device. Dabei gibt es folgende Möglichkeiten:
: set call **611 30 !Das ist ein Test & <-- wird im Fehlerfall nach 60 Sekunden wiederholt oder nach sip_force_interval wenn vorhanden.
: set call **611 30 !Das ist ein Test &300 <-- wiederholt im Fehlerfall nach 5 Minuten egal welchen Wert sip_force_interval hat.
: Werden mehrere Set Call unmittelbar hintereinander abgesetzt, werden diese intern gestackt und nacheinander abgearbeitet.

* set <name> '''listen'''
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt. Bei einem Anruf wird im Reading 'caller' die Nummer bzw. Id des Anrufers angezeigt. Dem Anrufer wird der eigene Ton als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl an das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt ein Anruf an den Client, wechselt das Reading 'caller_state' zu 'ringing_*', im Reading 'caller' wird die Nummer bzw. Id des Anrufers angezeigt. Nun kann das Gespräch via set-Command 'fetch' angenommen oder der Anruf via 'reject' explizit abgelehnt werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listen_wfp.

* set <name> '''fetch'''
: Anruf im listen_wfp-Modus annehmen.

* set <name> '''reject'''
: Anruf im listen_wfp-Modus ablehnen.

=== Readings ===

* '''call''': Die Rufnummer des ausgehenden Anrufs.
* '''call_state''': Status für ausgehende Anrufe.
* '''call_time''': Dauer des durchgeführten Anrufs in Sekunden
* '''call_success''': mögliche Werte 0 oder 1
: 0 = call_state ist ungleich ok , 1 = call_state ist gleich ok
: Auf Call mit Repeat übertragen bedeutet das:
: eine 0 wenn die Wiederholungszahl positiv ist und die tatsächliche Anzahl nicht erreicht wurde, aber
: eine 1 bei call_state "ok peer hangup"
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers.
* '''caller_state''': Status für eingehende Anrufe.
* '''caller_time''': Dauer des angenommenen Anrufs in Sekunden
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.
* '''state''': Der Status des Devices.

== Anwendungsbeispiele ==

=== Anruf tätigen und Sound abspielen ===
* Den Anruf initiieren
<code>set <device> call <nummer> [<dauer>] [<audiofile oder Textnachricht>]</code>
<code>set mySip call 081547111 30 ./tada.alaw</code>
<code>set mySip call 081547111 30 !Hier ist dein FHEM Server</code>
* Die Default-Dauer beträgt 30 Sekunden.
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.
* Der Angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.

=== Anruf tätigen und DTMF-Töne senden ===
* Den Anruf initiieren
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code>
* Die Tastenkombination muss mit einem Minus (-) nach der Zielnummer folgen, also z.B. **1 -#23
* Der Angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt.

=== Auf Anruf warten und DTMF-Töne empfangen ===
* Der SIP-Client wird in den Listen-Modus versetzt.
: Das Attribut sip_listen auf '''dtmf''' setzen und
: <code>set <device> listen</code>
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.
* Wenn der SIP-Client das Gespräch angenommen hat, betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf. Wichtig: Es müssen immer genau 3 Tasten betätigt werden (# und nm), damit das Reading dtmf gefüllt wird. n und m müssen zwei verschiedene Zahlen sein (0-9) oder ein Stern.
* Im Reading '''dtmf''' ist diese zweistellige Zahl zu sehen und kann ggf. mit einem notify ausgewertet werden.

=== Auf Anruf warten und kontrolliert annehmen ===
* Der SIP-Client wird in den Listen-Modus versetzt.
: Das Attribut sip_listen auf '''wfp''' setzen und
: <code>set <device> listen</code>
* Die Nebenstelle des SIP-Clients wird angerufen.
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':
: <code>set <device> fetch</code>
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.
* Der SIP-Client legt auf und geht wieder in den Status '''listen_wfp'''.

=== Auf Anruf warten und Aktion auslösen ===
* Der SIP-Client wird in den Listen-Modus versetzt.
: Das Attribut sip_listen auf '''wfp''' setzen und
: <code>set <device> listen</code>
* Die Nebenstelle des SIP-Clients wird angerufen.
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.
* FHEM kann auf Grund dieser Events eine Aktion durchführen.
* Der Anruf wird dann von FHEM abgebrochen. Dafür wird der Befehl '''reject''' genutzt:
: <code>set <device> reject</code>
* Der Anrufer weiß auf Grund der Ablehnung, dass FHEM aktiv war.
* Der SIP-Client legt auf und geht wieder in den Status '''listen_wfp'''.

=== Fritzbox + Doorline - Telefonklingeln beenden ===
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.
* Das Attribut 'sip_listen' wird auf 'wfp' gesetzt.
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).
: <code>set <device> listen</code>
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.
* Über ein DOIF greift man die Kombination SIP-Client caller_state 'ringing' und Haustürkontakt closed->open ab und
* setzt den Status des Devices mittels set auf fetch:
: <code>set <device> fetch</code>
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.
* Die Telefone verstummen.

In FHEM sieht das dann z.B. so aus:

Es gibt ein Device '''HaustuerStatus''' das den Status des Türkontaktes abbildet: "closed" oder "open".

Es wird ein Dummy-Device '''HaustuerStatusVar''' für die Status des Automaten angelegt:

<code>define HaustuerStatusVar dummy</code>

Und ein DOIF '''TuerklingelAus''':

<pre>
define TuerklingelAus DOIF
(([HaustuerStatus:state] eq "closed") and ([FhemSipClient:caller_state] eq "ringing.*") and ([FhemSipClient:caller] eq "Klingel sip:**12\@fritz.box"))
(set HaustuerStatusVar ringing;; set HM_4A4047_Mp3 playTone 001 1 10)
DOELSEIF
(([HaustuerStatus:state] eq "open") and ([HaustuerStatusVar:state] eq "ringing"))
(set FhemSipClient fetch;; set HaustuerStatusVar on)
DOELSEIF
(([HaustuerStatus:state] eq "closed") and ([HaustuerStatusVar:state] ne "off"))
(set HaustuerStatusVar off)
</pre>

Der Caller "Klingel sip:**12\@fritz.box" setzt sich aus dem in der Fritzbox vergebenen Namen, der Nebenstelle (**12 ist eine Doorline mit einem Taster, bei zweien gilt es **11 und **12 zu beachten) sowie dem syntaktischen Drumherum sip:''nebenstelle''\@fritz.box zusammen. Achtet bitte auf den "\" vor dem "@", damit regex nicht mosert.

HM_4A4047_Mp3 ist übrigens mein mobiler MP3-Tür-/Funkgong der zur Unterstützung einen Gong abspielt.

=== Nervende Werbeanrufe ===
Ihr kennt das sicher: Unbekannte Rufnummer, man nimmt das Gespräch an und hat entweder irgendwas gewonnen, einen Werber oder ein "Umfrage" dran. Unterm Strich - man will Dir was verkaufen.

Phase 1: Fritzbox, Rufbehandlung, neue Rufnummernsperre, Nummer eintragen.

Phase 2: Derselbe Werber taucht unter einem ganzen Kontingent von Rufnummern auf. Blocken alleine reicht dir nicht mehr, du willst Rache.

Phase 3:
: Du definierst in FHEM den SIP-Client und startest ihn im listen-Modus '''echo'''.
: In der Fritzbox leitest du alle eingehenden Anrufe auch an den SIP-Client weiter.
: Dem SIP-Client gibst du über sip_filter die Werber-Rufnummer als Filterarguiment mit.
: Der SIP-Cleint ist schneller als die Familienmitglieder und nimmt den Anruf an.

Phase 4: Jetzt bin ich (der Autor dieses Anwendungsfalles) neugierig. Postet Eure Erfahrung mit diesem Modus gerne im Forums-Thread.

== Bekannte Probleme / Fehlersuche ==
=== Fehler bei der Registrierung an der Fritzbox ===
'''Fritzbox'''
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet?
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?
* Wurde in der Fritzbox ein Passwort von mind. 8 Stellen und Sicherheitsstufe 'gut' vergeben? Andernfalls kann es zu einem Registrierungsfehler 404 kommen.

'''FHEM'''

Wurde das Passwort mittels set <mydevice> password <meinpasswort> gesetzt?

Attribute des Devices prüfen:
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> die von der Fritzbox vergebene Durchwahl angegeben? Ab Fritz!OS 6.8 gilt: Ist das Format <nowiki>sip:Benutzername@fritz.box</nowiki> eingehalten?
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?
* Ist unter sip_registrar die IP-Adresse der Fritzbox eingetragen ('fritz.box' wird manchmal nicht korrekt aufgelöst)?
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?
* Probleme mit dem Standard-Port 5060? Auf 5070 erhöhen.

=== Erzeugung eines passenden Audiofiles ===

Eine Alternative zu sox ist ffmpeg. Damit kann direkt von mp3 ins Zielformat konvertiert werden:

ffmpeg -i meinfile.mp3 -f alaw -ar 8000 meinfile.alaw

=== Keine korrekte DTMF-Erkennung auf einem Pi ===

Raspi, Raspi2 und BanaPi sind nicht leistungsstark genug für die Erkennung von DTMF-Tönen. Ab Raspi3 scheint's zu funktionieren.

Wer trotzdem auf einem "kleinen" Pi die DTMF-Erkennung gemäß RFC2833 nutzen möchte, kann in der DTMF.pm die Zeile 75

<code>###$sub{$type} = _dtmf_xtc_audio(%pargs);</code>

für die Audio-Erkennung auskommentieren. Zu finden ist DTMF.pm z.B. unter /usr/lib/perl5/site_perl/5.18.2/Net/SIP. Konsequenz: Moderne, RFC2833-unterstützende Geräte können genutzt werden, ältere Telefone mit Tonwahl nicht.

== Links ==
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP

[[Kategorie:Hilfsmodul]]

Vallox

2017-05-02T13:43:53Z

Skjall:

2017-04-30T13:36:41Z

Skjall: Die Seite wurde neu angelegt: „{{Baustelle}}{{Infobox Modul |ModPurpose=Steuern und auslesen von Vallox Belüftungsanlagen |ModType=d |ModCmdRef=Vallox |ModForumArea=Sonstige Systeme |ModTec…“

HM-CFG-LAN LAN Konfigurations-Adapter

2016-09-06T11:53:28Z

Skjall: /* Links */ Links kontrolliert und angepasst

{{Infobox Hardware
|Bild=HM-CFG-LAN.jpg
|Bildbeschreibung=HM-CFG-LAN, Draufsicht und Seitenansicht
|HWProtocol=HomeMatic
|HWType=[[Interface]]
|HWCategory=
|HWComm=868,3 MHz
|HWChannels=n/a
|HWVoltage=7,5 VDC
|HWPowerConsumption=ca. 100 mA
|HWPoweredBy=Steckernetzteil
|HWSize=100x30mm (ø x H)
|HWDeviceFHEM=[http://fhem.de/commandref.html#HMLAN 00_HMLAN.pm]
|ModOwner={{Link2FU|251|Martin / martinp876}}
|HWManufacturer=ELV / eQ-3
}}

Der [[HM-CFG-LAN LAN Konfigurations-Adapter]] ([http://www.eq-3.de/produkt-detail-zentralen-und-gateways/items/hm-cfg-lan.html HM-CFG-LAN]), kurz HMLAN Konfigurator, ist ein [[Interface|Schnittstellengerät]] (IO) ohne wesentliche Intelligenz. Die Aufgabe ist, ein Interface von der Zentrale zu den Geräten bereitzustellen. Ein HMLAN Konfigurator selbst steuert keine Geräte, er überträgt nur Nachrichten in beide Richtungen.

== Alternativen ==
Alternativen zu einem HMLAN Konfigurator sind [[HM-CFG-USB USB Konfigurations-Adapter]], [[CUN]], [[CUNO]] und [[CUL]].

;HMUSB
:Ein HMUSB hat nahezu identische Eigenschaften wie ein HMLAN Konfigurator. Der wesentliche Unterschied ist die Anbindung über USB anstatt Ethernet. Es hat sich erwiesen, dass USB eine bessere Latenz hat als LAN - also eine kürzere Verzögerung. Damit hat ein HMUSB leichte Vorteile zu HMLAN Konfigurator, was aber in den bei Weitem meisten Fällen durch die interne Timing Kalkulation abgefangen wird. Zudem können über den HMUSB (ab Version 2) auch Firmware-Updates OTA (over-the-air, also per Funkverbindung) auf entsprechende HM-Geräte (z.B. den HM-CC-RT-DN) durchgeführt werden.
:Dafür bietet der HMLAN Konfigurator mit seinem Netzwerkanschluss Vorteile bei der Platzierung und bei der Ansteuerung (teilweise Timing-Probleme beim Anschluss von USB-Geräten an langsamere Raspberries und beim Durchschleifen von USB an fhem in einer virtuellen Maschine).

; CUL/CUN(O)
* Die Devices liefern keine eigenen Zeitstempel, wodurch eine Timingkorrektur durch FHEM nicht möglich ist. Je nach Systemgeschwindigkeit kann dies zu Problemen, Nachrichtenwiederholung und ggf. auch Nachrichtenverlust führen
* Da USB kurze Reaktionszeiten und geringe Timingschwankungen hat ist der Einsatz von [[CUL]] und [[CUNO]] mit HM möglich. Die Timingschwankungen der Ethernet-schnittstelle hingegen können in FHEM nicht ausgeglichen werden. Daher kann der Einsatz der [[CUNO]] über Ethernet '''nicht empfohlen''' werden.
* Der Übertragungsmodus ''lazyConfig'' wird nicht unterstützt

== Funktionen ==
=== AES ===
siehe [[AES Encryption]].

=== Übertragungsmodus ===
Es werden alle HM-Modi unterstützt. Diese sind Always, Burst, Wakeup und Config. Weiter gibt es lazyConfig und conditionalBurst. Siehe [[HomeMatic]] für Details.

=== KeepAlive ===
Der HMLAN Konfigurator baut eine Verbindung zur Zentrale über das LAN Interface auf. Der HMLAN Konfigurator erwartet alle 30 Sekunden eine keep-alive Nachricht von der Zentrale. Sollte diese ausbleiben, baut der HMLAN Konfigurator die LAN-Verbindung ab. Das führt zu einem Disconnect, der in State gemeldet wird. Die Verbindung wird automatisch wieder aufgebaut.
FHEM sendet den keep-alive alle 25 Sekunden, was einen 5 Sekunden Puffer einräumt. In Internals '''msgKeepAlive''' kann man sehen, wie hoch die maximale Verzögerung der Zentrale beim Senden war und wie viel Puffer (in Sekunden) noch verfügbar war.
Die Wiederholrate von 25 Sekunden des keep-alive kann mit dem Attribut '''wdTimer''' reduziert werden, was den Puffer erhöhen. Es wird jedoch dringend geraten, im Problemfall die Ursache der Verzögerung zu suchen und zu eliminieren.

=== Nachrichtenübertragung - Performance ===
* Mit Internal ''msgParseDly'' kann man ablesen, welche Verzögerung eine Nachricht vom Empfang im HMLAN Konfigurator bis zur Verarbeitung in der Zentrale hat.
* Der HMLAN Konfigurator hält sich an den Funkstandard, der einem Sender maximal 36 Sekunden Sendezeit je Stunde erlaubt. Wird dieser Wert überschritten, stellt der HMLAN Konfigurator das Senden ein. Empfangen wird weiter. Ist eine Nutzung des Zeitslots zu 90% erreicht, wird im Reading ''cond'' ''Warning-HighLoad'' gemeldet. Bei cond ''ERROR-Overload'' wird das Senden eingestellt.

=== Loggen/Mitschneiden ===
Es stehen die üblichen Funktionen des Attribute [[verbose]] zu Verfügung. Darüber hinaus gibt es die Attribute ''hmProtocolEvents'' und ''logIDs''. Siehe auch [[Homematic Nachrichten sniffen]].

== Vorbereitung ==
{{Randnotiz|RNText='''"Usersoftware"/Firmware'''
* V1.512 / 19.12.2013 / [http://files.elv.de/Assets/Produkte/8/851/85128/Downloads/hm_cfg_lan_software_v1_512.zip Download]
* V1.515 / 12.08.2014 / [http://files.elv.de/Assets/Produkte/8/851/85128/Downloads/hm_cfg_lan_software_v1_515.zip Download]
* V1.520 / 10.12.2015 / [http://www.eq-3.de/Downloads/Software/Konfigurationsadapter/Konfigurationsadapter_LAN/HM-CFG-LAN_Usersoftware_V1_520_eQ-3_151207.zip Download]
'''Firmware Update Tool / Firmware / Datum'''
* V1.2 / 0.965 / 11.02.2016 / [http://www.eq-3.de/Downloads/Software/Firmware%20Update%20Tool/HM-Firmware-Update-Tool_V1_2_eQ-3_160211.zip Download]

}}
[[Datei:HMLAN_CONFIG_IP_AES.png|300px|thumb|right|HomeMatic Lan-Interface Configurator]][[Datei:HMLAN_CONFIG_AES.png|300px|thumb|right|HomeMatic Konfigurator]]
Bevor man den HMLAN mit Fhem nutzen kann, müssen noch Einstellungen vorgenommen werden. Dazu braucht man Software die bei [http://www.eq-3.de/software.html HomeMatic] in der Version 1.512 (Stand 19. Dezember 2013) herunter zu laden ist und nach der Installation mit der Verknüpfung "HomeMatic-Lan-Interface konfigurieren" oder "HomeMatic-Komponenten konfigurieren" gestartet wird und unter Windows läuft. Für andere Betriebssystem (siehe Anhang im Beitrag {{Link2Forum|Topic=11506|Message=67417|LinkText=Anleitung für OS X}}) braucht man eine Windows-Emulation. Dem HMLAN liegen zwei Konfigurationsprogramme bei, bitte darauf achten, das richtige zu verwenden. Wenn das Konfigurationsprogramm den HMLAN-Konfigurator nicht findet, sollten alle nicht benutzten Netzwerkinterfaces vorübergehend deaktiviert werden, siehe {{Link2Forum|Topic=10933|Message=62960|LinkText=Beitrag im Fhem Forum}} und [[HM-CFG-LAN_LAN_Konfigurations-Adapter#Bekannte_Probleme|bekannte Probleme]].

=== Firmware ===
Die aktuelle Firmware Version des HMLAN Konfigurators ist 0.965 (Stand Februar 2016). Ein Update ist mit dem ''"Firmware Update Tool"'' möglich, die Firmware ist Bestandteil des Tools.

Um einen mit Fhem benutzten HM-LAN zu aktualisieren, reicht es,
# im HMLAN-Device mit <code>attr <myHMLAN> dummy 1</code> den Adapter vorübergehend zu deaktivieren,
# mit dem (Windows) Firmware Update Tool die Firmware auf den HM-LAN aufzuspielen
# nach dem Stoppen des Update Tools mit <code>deleteattr <myHMLAN> dummy</code> das Device in Fhem wieder zu aktivieren.
Version 1.2 des Firmware Update Tools läuft auch unter Windows 10.

=== IP Adresse ===
Der HMLAN Konfigurator ist ähnlich wie der CUN(O) ein Netzwerkgerät. Er beherrscht DHCP und bezieht bei einem im Netzwerk erreichbaren DHCP Servers von diesem eine IP-Adresse. Da Fhem zwecks Kommunikation die IP-Adresse wissen muss, ist es sinnvoll, dem HMLAN Konfigurator eine statische Adresse zuzuweisen.
* mit der auf der CD mitgelieferten ''"HomeMatic Lan-Interface Configurator"'' Software unter ''"Change IP Settings"'' oder
* im DHCP-Server eine feste IP-Adresse zuzuweisen (sofern dies vom gegeben DHCP Server als Konfigurationsoption unterstützt wird).

=== AES Encryptet LAN Communication ===
Wichtig ist, dass vor Verwendung die "AES Encryptet LAN Communication" abgeschaltet wird, da diese von FHEM nicht unterstützt wird. Dies ist unter ''"Change IP Settings"'' der ''"HomeMatic Lan-Interface Configurator"'' Software möglich. AES auf dem LAN ist zu unterscheiden von HMLAN auf der Funktschnittstelle. siehe [[AES Encryption]].

== Einbindung in FHEM ==
Der HMLAN-Konfigurator muss in FHEM [[Konfiguration|konfiguriert]] werden. Das erfolgt mit diesen Befehlen:
:<code>define HMLAN1 HMLAN <IP Adresse>:1000</code>
:<code>attr HMLAN1 hmId 123ABC</code>
Der Name (im obigen Beispiel ''HMLAN1'') kann frei vergeben werden. Standard IP-Port des HMLAN-Konfigurators ist 1000.

HMLAN kennt mehrere Attribute ([http://fhem.de/commandref.html#HMLAN commandref]).
Wichtig ist es, die '''hmId''' zu vergeben. Diese ist ein 3-Byte hexadezimal-Wert, somit eine 6-stellige Zeichenfolge in '''Großbuchstaben'''. 000000 und FFFFFF sind ungültig.
Wenn HM-Geräte mit der Zentrale [[Pairing (HomeMatic)|gepairt]] werden, wird ihnen diese hmId eingetragen. Wechselt man die hmId müssen '''alle''' damit gepairten Geräte neu gepairt werden.

Die Adresse wird in Grossbuchstaben eingegeben, siehe [[HMLAN_Konfigurator#Bekannte_Probleme|"Bekannte Probleme"]].

Ein '''gleichzeitiger''' Zugriff von Fhem und der HomeMatic-Software auf den HMLAN-Konfigurator ist nicht möglich, da letzterer nur eine Verbindung zulässt. Wollen Sie temporär z.B. mit der Windows-Software von HomeMatic zugreifen, ist Fhem zu deaktivieren.
Sinnvoll ist es, die hmId mit der der PC-Software gleichzusetzen. Dann kann man von beiden Zentralen alternativ zugreifen ohne pairen zu müssen.

=== Nutzung mehrere IOs ===
==== Empfangen ====
Man kann an einem FHEM mehrere IOs (HMLAN/USB, CUL/CUNO) betreiben. Generell empfangen alle IOs von allen Geräten in ihrem Empfangsbereich - unabhängig von der hmId.

==== Senden ====
An ein Gerät wird nur über das IO gesendet, das in Internals->IODev angezeigt wird. Nutzt man mehrere IOs sollte im HM Device das Attribut IODev auf das gewünschte IO setzen. Ansonsten sucht FHEM zufällig ein IO aus.

==== hmId bei mehreren IOs ====
Man kann allen IOs die gleiche HMId setzen. Das erlaubt die wahlfreie Umschaltung des Sende-IOs für das Device. Sollte man unterschiedliche hmIds wählen simuliert dies mehrere Zentralen. Das Device, an das man sendet, muss über ein IO angesprochen werden, mit einer hmId auf die das Device gepairt ist.

=== Virtueller Controller VCCU ===
Speziell wenn mehrere IOs verwendet werden sollen, empfiehlt sich die Verwendung einer [[Virtueller Controller VCCU|VCCU]], da ein redundante Nutzung mehrerer Schnittstellen dann wesentlich einfacher einzurichten ist. Das Einrichten einer VCCU lohnt sich aber schon bei der Benutzung nur eines HomeMatic I/O, also wenn man z.b. nur einen HMLAN Konfigurator einsetzen will. Zum Einen ist es wesentlich einfacher ggf. später weitere Schnittstellen dazu zu konfigurieren, zum Anderen adressiert die VCCU die auch bereits bei einer Schnittstelle auftauchende Probleme wie die "<code>Unknown code</code>" Meldungen im Log.

Die Einrichtung einer VCCU ist nicht sehr aufwändig und wird dringend empfohlen.

=== Attribute ===
* '''hmId''': Adresse, die das IO auf der Funkstrecke nutzt. Es ist ein 3-byte hexwert (6 Zeichen) in Großbuchstaben.
* '''hmkey, hmkey2..5''': bis zu 5 AES keys, die auf der Funkstrecke genutzt werden. Siehe [[AES Encryption]]
* '''hmLanQlen''' legt fest, wie viele Nachrichten parallel gesendet werden dürfen, also auf wie viele Antworten die Zentrale parallel warten darf. Ein Wert von 1 ist max defensiv, erzeugt aber eine höhere Verzögerung. Wählt man einen höheren Wert kann es zu Nachrichten-Wiederholunge kommen.
* '''hmProtocolEvents''': alle Nachrichten werden dekodiert ausgegeben. Diese Einstellung benötigt einige Performance insbesondere bei höheren Level. Man sollte es vorsichtig nutzen.
* '''logIDs''': zeichnet Rohmessages auf und bietet die genaueste Methode bei der Fehlersuche. Da Nachrichten undekodiert ausgegeben werden ist es im Wesentlichen für Spezialisten von Bedeutung. Man gibt eine Komma getrennte Liste von IDs an, die geloggt werden sollen. Mit '''all''' werden alle IDs aufgezeichnet. '''sys''' zeichnet zusätzlich Systemmessages auf. '''sys,all''' somit alles.
* '''respTime''': Antwortzeit des HMLAN auf ein keep-alive kann hier eingestellt werden. Normalerweise sollte das HMLAN in einer Sekunde der Zentrale antworten. Sollte dies nicht passieren, wird die Message wiederholt. Der Wert sollte nur in Ausnahmefällen verändert werden.

=== Readings ===
* '''Xmit-Events''': Anzahl der Ereignisse
* '''cond''': aktueller Zustand des IO.
** ok
** Warning-HighLoad: 90% der 1h sendekapazität sind erreicht
** ERROR-Overload: 100% der sendekapazität sind erreicht, '''das IO sendet nicht mehr'''
** timeout
** disconnected: die Verbindung FHEM /IO ist unterbrochen
** Overload-released: das IO ist aus ERROR-Overload zurück im Sendebetrieb
** init: Das IO wurde neu initialisiert.
* '''prot_ERROR-Overload''': Anzahl des Events, Zeitstempel des letzten Auftretens
* '''prot_Warning-HighLoad''': Anzahl des Events, Zeitstempel des letzten Auftretens
* '''prot_disconnected''': Anzahl des Events, Zeitstempel des letzten Auftretens
* '''prot_init''': Anzahl des Events, Zeitstempel des letzten Auftretens
* '''prot_ok''': Anzahl des Events, Zeitstempel des letzten Auftretens
* '''prot_timeout''': Anzahl des Events, Zeitstempel des letzten Auftretens

=== Internals ===
* '''XmitOpen''': 1 = HMLAN ist sende bereit
* '''assignedIDs''': HMIDs der HM Devices, die über dieses IO bedient werden
* '''assignedIDsCnt''': Anzahl der zugewiesenen HMIds von FHEM
* '''assignedIDsReport''': Anzahl der HMIds, die das HMLAN angibt zu bedienen. Die Zahl sollte identisch sein mit assignedIDsCnt
* '''msgKeepAlive''': dlyMax: maximale Verzögerung, die ein keep-alive hatte. bufferMin: der minimale Zeitpuffer, der übrig blieb, bis das keep-alive zu spät gekommen wäre. Der Puffer sollte 2 oder größer sein, sonst könnte man gelegentlich disconnects bekommen.
* '''msgLoadEst''': Funkbelastung des HMLAN. Der Wert wird über 1 Stunde akkumuliert. Sollten 100% erreicht sein, wird das HMLAN den Sendebetrieb einstellen. Der Wert ist eine Hochrechnung in FHEM. Es ist möglich, dass das HMLAN mehr belastet ist. Die 10 min werte zeigen die Belastung in den letzten 10min Perioden an.
* '''msgParseDly''': Verzögerung der Message Verarbeitung vom Empfang im IO bis zur Verarbeitung in FHEM. Eine Verzögerung kann durch Prozesse an LAN, durch FHEM Prozesse oder sonstige Prozesse/Applikationen der CPU hervorgerufen werden.

== Pairen von Geräten ==
Jedes HM Gerät muss vor Verwendung mit der HM-Zentrale [[Pairing (HomeMatic)|gepairt]] werden. Dabei wird die hmId des gewählten IOs in das Device programmiert. Ändert man die hmId des IO, mit man das Device anspricht, muss man das Device neu pairen.
Alle Geräte haben eine eigene Seriennummer, die nicht änderbar ist. Details zum Pairen auf der Seite [[HomeMatic Devices pairen]].

== Bekannte Probleme ==
=== Verbindung wird abgelehnt ===
Selten lehnt der HMLAN-Konfigurator ohne erkennbaren Grund nach monatelangem störungsfreiem Betrieb die Verbindung ab:
<pre style="width:400px;">
Opening HMLAN1 device 192.168.168.60:1000
192.168.168.60:1000 connection refused
</pre>
Der HMLAN-Konfigurator kann aber über die mitgelieferte Konfigurationssoftware problemlos erreicht werden. Der Zustand lässt sich auch durch einen Reboot des HMLAN-Konfigurators (oder Fhem) nicht beheben, wohl aber durch eine Aktualisierung der Firmware des HMLAN-Konfigurators, selbst wenn die installierte Version aktuell ist.

Wenn das Konfigurationsprogramm Probleme hat, den HM-CFG-LAN LAN Konfigurations-Adapter zu finden, sollten alle nicht benutzten Netzwerkinterfaces vorübergehend deaktiviert werden. Vereinzelt gibt es Hinweise darauf, dass es unter Windows 7 eventuell nicht reicht, die Netzwerkverbindungen im "Netzwerk- und Freigabecenter" zu deaktivieren, sondern ein Deaktivierung der Netzwerkadapter im Gerätemanager erforderlich ist.

=== Häufiger automatischer Neustart ("Reboot") ===
Der HMLAN Adapter startet ohne erkennbaren äußeren Anlass häufig neu. Das Problem ist auch im Forum unter der Überschrift {{Link2Forum|Topic=20776|LinkText=HMLAN Adapter wechselt permanent zwischen disconnected / connected}} beschrieben. Im FHEM Log erscheinen in diesem Fall folgende Meldungen:
<pre style="width:600px;">
... HMLAN_Parse: myHMLAN new condition timeout (je nach Timing, manchmal)
... HMLanHostname:1000 disconnected, waiting to reappear (myHMLAN)
... HMLAN_Parse: myHMLAN new condition disconnected
... HMLanHostname:1000 reappeared (myHMLAN)
... HMLAN_Parse: myHMLAN new condition init
... HMLAN_Parse: myHMLAN new condition ok
</pre>
Dieses Problem ist bei ELV [http://www.elv.de/topic/hm-lan-reboots.html bekannt] und soll mit der [http://www.eq-3.de/Downloads/Software/Konfigurationsadapter/Konfigurationsadapter_LAN/HM-CFG-LAN_Usersoftware_V1_520_eQ-3_151207.zip Konfigurationsadapter LAN Usersoftware V1.520 (10.12.2015)], bzw. der darin enthaltenen Firmware Version, behoben sein. Stand 05.08.2016 12:32 Auch mit der aktuellen Firmware (v0.965 - Link siehe oben) und der aktuellen Version von HMLAN (Rev 11645 vom 2016-06-11) tritt der Fehler noch auf.

== Verbesserung der Antennenleistung ==
Die Sende- und Empfangsleistung kann man verbessern. Details [[Trick_der_Woche#HM_LAN_Konfig-Adapter_Antenne_verbessern|hier]].

== Wechsel von CUL zu HMLAN ==
{{Randnotiz|RNTyp=y|RNText=Der hier beschriebene Wechsel sollte mittlerweile einfacher über die [[Virtueller Controller VCCU|VCCU]] realisierbar sein, indem erst ein weiteres IO-Device hinzugefügt und anschließend das zu ersetzende entfernt wird.}}
Sollten ein [[CUL]] als IO für Homematic-Geräte dienen und ein Wechsel auf den HMLAN Konfigurator geplant sein, kann die folgende Vorgehensweise gewählt werden:

* deaktivieren Sie das CUL in der ''fhem.cfg''.
* konfigurieren Sie den HMLAN Konfigurator '''von Hand'''
* Ändern sie das Attribut IODev aller HM-Devices vom Namen der CUL auf den Namen des HMLAN
* sollte sie das Attribut IODev nicht nutzen (nicht empfohlen) achten sie darauf, dass im fhem.cfg das IO vor allen HM-devices definiert wird. Eine automatischen Zuweisung des IO zu den Devices ist sonst nicht möglich.
** der HMLAN '''muss''' die gleiche ''hmId'' wie das bisherige CUL erhalten. Ansonsten müssen alle Geräte neu gepairt / angelernt werden.
** AES muss im HMLAN abgeschaltet werden.
* verbinden Sie den HMLAN Konfigurator mit ihrem Netzwerk und ziehen das CUL aus der USB-Buchse.
* geben Sie in der FHEM-Befehlszeile ''shutdown restart'' gefolgt von <Enter> (nicht "save") ein (evtl. reicht auch ein ''rereadcfg'').
* kontrollieren Sie im Event-Monitor und in den HM-Device-Logs von Fhem die Kommunikation.

Bitte beachten: Falls dem CUL keine explizite hmId per Attribut zugewiesen wurde, wird diese ID aus "F1<FHT-ID>" zusammengebaut. Die hmId muss auf dem HMLAN explizit gesetzt werden.

== Links ==

* [http://www.eq-3.de/service/downloads.html Software] für den Konfigurationsadapter von der eQ-3 Site
* [[Trick_der_Woche#HM_LAN_Konfig-Adapter_Antenne_verbessern|HM LAN Konfig-Adapter Antenne verbessern]]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Interfaces]]

Speedtest

2016-01-30T10:21:34Z

Skjall: /* Bekannte Probleme */

{{SEITENTITEL:speedtest}}
{{Infobox Modul
|ModPurpose=Testet die Internetgeschwindigkeit
|ModType=d
|ModCmdRef=speedtest
|ModForumArea=Sonstiges
|ModTechName=32_speedtest.pm
|ModOwner=Andre / justme1968 ({{Link2FU|430|Forum}} / [[Benutzer_Diskussion:Justme|Wiki]])}}

__TOC__
{{Todo|Fehlerkontrolle, Formatierung, Ergänzung, ggf. Detaillieren des Troubleshooting}}

[[Speedtest]] ist ein Modul um mit Hilfe des externen Python-Scripts speedtest-cli die Internetgeschwindigkeit zu testen.

== Features / Funktionen ==
Mit Hilfe des Moduls kann in regelmäßigen Abständen die Internetgeschwindigkeit (download, upload, ping) bestimmt werden. Dabei wird auf das Pythonscript speedtest-cli (siehe [[speedtest#Weblinks|Weblinks]]) zurückgegriffen. Es lässt sich das Intervall, der genaue Server, gegen den getestet werden soll, sowie eine bestimmte Anzahl an Testläufen festlegen.

== Definition ==

Das Modul wird folgendermaßen definiert:
<pre>
define <name> speedtest [<interval> [<server>]]
</pre>

=== Optionen ===

Die Angabe des Intervals ist optional. Der Defaultwert ohne Angabe des Intervalls ist 3600 Sekunden. Die Daten werden alle <interval> Sekunden aktualisiert. Das Minimum ist 1800 Sekunden.

Die Angabe des Servers ist ebenfalls optional. Der Defaultwert ohne Angabe ist der per ping "nächstgelegene" Server. Über die Option <server> kann ein dedizierter speedtest Server festgelegt werden, gegen den die Geschwindigkeit ermittelt wird.

Eine Liste lässt sich auf der Kommandozeile über den folgenden Aufruf auslesen:
<pre>
speedtest-cli --list
</pre>

; Readings
Als readings werden Werte für ping in ms, download-/upload-Geschwindigkeiten in Mbit/s zur Verfügung gestellt.

; Manuelle Abfrage
Ein Test lässt sich über ein <code>set speedtest statusRequest</code> manuell anstoßen.

=== Attribute ===
Bei der Definition des Moduls können folgende Attribute gesetzt werden

; path
Hier kann der Pfad zum Script angegeben werden. Im unten gegebenen Fall wäre das /usr/local/bin.

; checks-till-disable
Über dieses Attribut lässt sich festlegen, wie häufig speedtest ausgeführt werden soll, bevor der automatische Aufruf deaktiviert wird. Nach Ablauf des Zählers wird das Modul automatisch auf disable gesetzt. Bei jedem Durchlauf wird der Zähler um 1 reduziert.

; disable
Ist dieses Attribut auf 1 gesetzt, ist die automatische Ausführung deaktiviert. Das manuelle Ausführen über set ist trotzdem möglich.

== Voraussetzungen ==

Für diese Anleitung ist notwendig
* Wissen, wie man mit der Kommandozeile umgeht und Linuxgrundkenntnisse
* Paket- und Quellenverwaltung apt-get

Alle in diesen Kapitel genannten Befehle müssen auf der Kommandozeile abgesetzt werden.

=== Python ===

Entsprechend Quelle des Scripts ist eine Python-Version zwischen 2.4 - 3.4 erforderlich.
Um herauszufinden, welche Python-Version installiert ist, reicht ein Aufruf auf der Kommandozeile von
<pre>
python -V
</pre>

Ist eine Version kleiner als 2.4 installiert, sollte ein Update über z.B. folgende Befehle Abhilfe schaffen (liest die aktuelle Paketliste ein):
<pre>
sudo apt-get update
</pre>

Der folgende Aufruf aktualisiert alle installierten Pakete auf die derzeit aktuellste Version:
<pre>
sudo apt-get upgrade
</pre>

Bekommt man eine Fehlermeldung mit dem Hinweis, dass Python nicht installiert sei, muss dieses entsprechend Platform installiert werden, z.B. über folgenden Befehl:
<pre>
sudo apt-get install python
</pre>

=== speedtest-cli ===

Der Download lässt sich über wget ODER github oder diverse andere Möglichkeiten bewerkstelligen. Entsprechende Pakete müssen auf dem System installiert sein. Falls nicht, muss man diese über einen der beiden Befehle installieren:
<pre>
sudo apt-get install wget
</pre>
<pre>
sudo apt-get install git
</pre>

Damit man den Download nicht irgendwo auf seinem System herunterlädt, ist empfehlenswert, zunächst in sein eigenes Homeverzeichnis zu wechseln:
<pre>
cd ~
</pre>

Um keine Dateileichen zu hinterlassen, empfiehlt es sich darüber hinaus, NACH erfolgreicher Installation aufzuräumen und alles was man hierher heruntergeladen hat, gleich zu löschen.

==== Wget ====

Im eigenen Homeverzeichnis führt man den folgenden Befehl aus, um speedtest-cli herunterzuladen. Dieser läd das Script herunter und speichert es am Ort des Ausführens unter speedtest-cli:
<pre>
wget -O speedtest-cli https://raw.githubusercontent.com/sivel/speedtest-cli/master/speedtest_cli.py
</pre>

Damit das Script ausführbar ist, müssen die Berechtigungen entsprechend gesetzt werden:
<pre>
chmod +x speedtest-cli
</pre>

Anschließend wird es an eine passende Stelle im System verschoben, z.B. in den Ordner /usr/local/bin:
<pre>
sudo mv speedtest-cli /usr/local/bin
</pre>

==== Github ====

Mit folgendem Aufruf lässt sich das Paket herunterladen. Dabei wird ein passendes neues Unterverzeichnis angelegt und das Heruntergeladene darin entpackt.
<pre>
git clone https://github.com/sivel/speedtest-cli.git
</pre>

Das Script liegt hier bereits ausführbar als speedtest_cli.py im Unterordner und muss an einen passenden Ort kopiert werden. Dabei ist wichtig, dass das Modul den Namen <code>speedtest-cli</code> erwartet.
<pre>
sudo cp ./speedtest-cli/speedtest_cli.py /usr/local/bin/speedtest-cli
</pre>

=== Test des Scripts ===

Ob das Script funktioniert, lässt sich über folgenden Aufruf testen:
<pre>
/usr/local/bin/speedtest-cli
</pre>

Detaillierte Informationen zu den Optionen beim Aufruf sind auf der Quell-Seite dokumentiert [[Speedtest#Weblinks|Weblinks]].

== Beispiel ==
(Bearbeitung über die Weboberfläche von FHEM und "edit files" oder direkte Eingabe in die FHEM-Befehlszeile)

=== Definition des Moduls ===
<pre>
define speedtest speedtest 1800 5255
attr speedtest path /usr/local/bin
</pre>

=== Logging in eine Datei ===

Das loggen der Daten in eine Datei sähe z.B. so aus.
<pre>
define FileLog_speedtest FileLog ./log/speedtest-%Y.log speedtest:.*
attr FileLog_speedtest logtype text
</pre>

Definition der Datei speedtest3.gplots:
<pre>
############################
# Display speedtest results

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 '<L1>'

set yrange [0:1]
set y2range [0:12]
set y3range [0:120]

set ylabel "Mbit/s"
set y2label "Mbit/s"
set y3label "ms"

#FileLog 4:speedtest.download\x3a::
#FileLog 4:speedtest.upload\x3a::
#FileLog 4:speedtest.ping\x3a::

plot
using 1:2 ls l0 axes x1y2 title 'download (Mbit/s)' with lines,
using 1:2 ls l1 axes x1y1 title 'upload (Mbit/s)' with lines,
using 1:2 ls l2 axes x1y3 title 'ping (ms)' with lines
</pre>

Der Weblink wird wie folgt definiert:
<pre>
define wl_speedtest SVG FileLog_speedtest:speedtest3:CURRENT
</pre>

=== Logging mit Hilfe von DbLog ===

Das loggen in die Datenbank erfolgt, wenn die Readings explizit oder generell alle Readings bei der Definition von DbLog angegeben worden sind und bei der Definition des Moduls speedtest die Readings nicht über DbLogExclude ausgeschlossen wurden.

Definition des Plots bei Verwendung von DbLog
<pre>
define wl_speedtest SVG myDbLog:speedtest:HISTORY
attr wl_speedtest label "DL $data{currval1} / UL $data{currval2} / ping $data{currval3}"
attr wl_speedtest plotfunction speedtest
</pre>

Definition der Datei speedtest.gplots:
<pre>
############################
# Display speedtest results

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 '<L1>'

set yrange [0:1]
set y2range [0:12]
set y3range [0:120]

set ylabel "Mbit/s"
set y2label "Mbit/s"
set y3label "ms"

#myDbLog <SPEC1>:download:::$val=~s/([\d.]*).*/$1/eg
#myDbLog <SPEC1>:upload:::$val=~s/([\d.]*).*/$1/eg
#myDbLog <SPEC1>:ping:::$val=~s/([\d.]*).*/$1/eg

plot
using 1:2 ls l0 axes x1y2 title 'download (Mbit/s)' with lines,
using 1:2 ls l1 axes x1y1 title 'upload (Mbit/s)' with lines,
using 1:2 ls l2 axes x1y3 title 'ping (ms)' with lines
</pre>

== Bekannte Probleme ==
* Für den Betrieb ist Python notwendig. Daher läuft das Script nicht ohne Weiteres auf einer Fritzbox.
* Vor ein paar Tagen (28.02.2015) gab es ein paar Fehlermeldungen, die sich nach der Aktualisierung des Scripts aber bislang wieder erübrigt haben.
* Zwischenzeitlich wurde das Script umbenannt. Das Modul erwartet nach wie vor den ursprünglichen Namen. Daher ist wie oben beschrieben darauf zu achten, dass das abgelegte Script <code>speedtest-cli</code> heißt und zur Not dahingehend umbenannt wird.
* Das Modul bricht ggf. mit einer Perl-Fehlermeldung im Fhem-Log ab, obwohl das Script <code>speedtest-cli</code> von der Konsole aus einwandfrei läuft. Dies tritt z.B. bei Verwendung von Rasbian mit installierten Perl2.7 und Perl3 auf. Zur Behebung muss im Script <code>speedtest-cli</code> die erste Zeile auf <code>#!/usr/bin/env python'''3'''</code> geändert werden.

== Troubleshooting ==
Im Folgenden sind ein paar Ansatzpunkte genannt, um beim Troubleshooting zu unterstützen.

; Läuft das Script beim Aufruf auf der Kommandozeile?
* Es könnte am fehlenden oder einer falschen Version von Python liegen.
* Ist das Script ausführbar?
* Hat man selbst bzw. die FHEM-Instanz ausreichend Berechtigungen, das Script auszuführen?

; Ist das Log frei von Fehlermeldungen?

; Werden im Modul Readings angezeigt?

; Kommen die Readings im Log (Filelog oder DbLog) an?

; Ist die Definition von SVG korrekt?
* Richtiger Verweis auf Filelog oder DbLog
* Angabe des richtigen gplot-Files
* Übergabe der Plotfunktion (bei DbLog)
* Die der Syntax korrekt (case sensitive)

; Ist der Inhalt des gplot-Files korrekt
* Ist die Definition der Quelle korrekt (Filelog, DbLog oder LogProxy)?
* Ist die Regexpr korrekt?

; Fehlermeldung "isn't numeric in sprintf at ./FHEM/98_SVG.pm"
* Dieses kommt grundsätzlich immer dann vor, wenn SVG versucht einen Wert einzulesen, der neben der Zahl auch die Einheit enthält. Dieses kann bei der Verwendung von DbLog (DbLog ist nicht bekannt, wo es bei dem geloggten Modul die Einheit abtrennen soll) oder addlog vorkommen. Abhilfe liefert eine entsprechende Regexpr, die nur den Zahlenwert verwendet.

== Weblinks ==
* Beschreibung des Scripts [http://binarynature.blogspot.de/2013/03/measure-internet-connection-speed-from-linux-command-line.html binarynature.blogspot.de]
* Quelle des Scripts [https://pypi.python.org/pypi/speedtest-cli pypi.python.org]
* Quelle des Scripts [https://github.com/sivel/speedtest-cli github.com]
* Forumseintrag über die Entwicklung des Moduls [http://forum.fhem.de/index.php/topic,13419.msg83189.html#msg83189 Thema: Internetgeschwindigkeit überwachen]
* Forumseintrag darüber, dass das Binary nicht auf der Fritzbox läuft [http://forum.fhem.de/index.php/topic,27242.msg201516.html#msg201516 Thema: Internetgeschwindigkeit - speedtest]
* Forumseintrag über aus der Idee wird ein Modul [http://forum.fhem.de/index.php/topic,13483.msg83538.html#msg83538 Thema: Internetgeschwindigkeit überwachen]

== sonstiges ==
Besten Dank an wkarl, Puschel74, justme1968 für Idee, Modulerstellung/Pflege und Installationsanleitung.