Auf dieser Seite wird die EInbindung des E-Autos [https://www.ora-motor.de/ Ora Funky Cat] von GWM (Great Wall Motors aus China) in FHEM über die ODB2-Serviceschnittestelle erläutert.

Benötigte Hardware: [https://www.meatpi.com/products/wican MeatPi WiCAN-OBD-C3 Dongle]

Der WiCAN kann sich über WLAN mit eine MQTT-Server verbinden. Näheres in obigem Link. Er wird in die ODB2-Serviceschnittestelle (neben Sicherungsfach unterhalb Lenkrad) gesteckt. Am besten über ein Verlängerungskabel oder indem man den Stecker aus der Halterung drückt und den WiCAN ins SIcherungsfach legt.

Die Integration eines MQTT-Servers in FHEM wird [[MQTT|hier]] erklärt.

Ist das Auto eingeschalten und der Dongle gesteckt, dann können über FHEM Fahrzeugwerte abgefragt werden. Weiter unten eine beispielhafte EInrichtung eine MQTT-Devices.

=== Readings ===
Die folgenden Werte werden mit unterer Beispielkonfiguration ausgelesen:

* '''Mileage:''' km-Stand - Abfrage über "set wican read_Mileage"
* '''SoC''': Ladezustand Hochvolt-Antriebsbatterie in % - Abfrage über "set wican read_SoC"
* '''TrueSoC''': ein zweiter Wert. Hintergrund ist unbekannt - Abfrage über "set wican read_TrueSoC"
* '''SoE''': Ladezustand Hochvolt-Antriebsbatterie in kW - Abfrage über "set wican read_SoE"
* '''SoH''': Gesundheitszustand der Hochvolt-Antriebsbatterie in % - Abfrage über "set wican read_SoH"
* '''OperatingVoltage''': Spannung Niedervolt-Fahrzeugbatterie in V - Abfrage über "set wican read_OperatingVoltage"
* '''BatteryVoltage''': Spannung Hochvolt-Antriebsbatterie in V - Abfrage über "set wican read_BatteryVoltage"
* '''TotalCharge''': Durch die Batterie aufgenommene Stromleistung in Ah (inklusive Rekuperation während des Fahrens) - Abfrage über "set wican read_Total Charge" Die Multiplikation mit 5 kV scheint die hinzugefügte elektrische Leistung zu ergeben.
* '''TotalDischarge''': Von der Hochvolt-Batterie abgezogene Stromleistung in Ah - Abfrage über "set wican read_TotalDischarge" Die Multiplikation mit 5 kV scheint die abgerufene elektrische Leistung zu ergeben

=== Beispielhafte Einrichtung des WiCAN im Ora Funky Cat als MQTT2-Device ===
Der Ausdruck "XXXXXXXX" muss durch die Identnummer des WiCAN ersetzt werden. <syntaxhighlight lang="cfg">
define wican MQTT2_DEVICE
attr wican alias Ora
attr wican stateFormat B: SoC% M: Mileage km (status)
attr wican event-on-change-reading status
attr wican event-on-update-reading frame_1_data_6,SoC
attr wican DbLogExclude .*
attr wican DbLogInclude SoC:3600
attr wican readingList wican/XXXXXXXX/status:.* {json2nameValue($EVENT)}\
wican/XXXXXXXX/can/rx:.* {json2nameValue($EVENT)}
attr wican setList read_SoC:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":49539,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,32,80,170,170,170,170]}]}\
read_TrueSoC:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":27825,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,3,8,170,170,170,170]}]}\
read_SoH:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":12016,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,32,81,170,170,170,170]}]}\
read_SoE:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":17777,"frame":[{"id":1930,"dlc":8,"rtr":false,"extd":false,"data":[3,34,208,98,170,170,170,170]}]}\
read_OpVoltage:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":17645,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,208,3,170,170,170,170]}]}\
read_Mileage:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":35674,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,208,4,170,170,170,170]}]}\
read_TotalCharge:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":28695,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,33,113,170,170,170,170]}]}\
read_TotalDischarge:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":28695,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,33,114,170,170,170,170]}]}\
read_BatteryVoltage:noArg wican/XXXXXXXX/can/tx {"bus":"0","type":"tx","ts":58591,"frame":[{"id":1931,"dlc":8,"rtr":false,"extd":false,"data":[3,34,32,3,170,170,170,170]}]}
attr wican userReadings SoC:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 5 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 98\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 32 and ReadingsNum($NAME, 'frame_1_data_4', 0) == 80 ) {\
return (ReadingsNum($NAME, 'frame_1_data_5', 0) * 256+ReadingsNum($NAME, 'frame_1_data_6', 0))/10.0\
} else {\
return ReadingsNum($NAME, 'SoC', 0)\
}\
},\
SoH:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 5 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 98\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 32 and ReadingsNum($NAME, 'frame_1_data_4', 0) == 81 ) {\
return (ReadingsNum($NAME, 'frame_1_data_5', 0) * 256 + ReadingsNum($NAME, 'frame_1_data_6', 0))/10.0\
} else {\
return ReadingsNum($NAME, 'SoH', 0)\
}\
},\
TrueSoC:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_3', 0) == 3) {\
return (ReadingsNum($NAME, 'frame_1_data_5', 0) * 256 + ReadingsNum($NAME, 'frame_1_data_6', 0))/10.0\
} else {\
return ReadingsNum($NAME, 'TrueSoC', 0)\
}\
},\
Mileage:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 6 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 98\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 208 ) {\
return ReadingsNum($NAME, 'frame_1_data_6', 0) * 256 + ReadingsNum($NAME, 'frame_1_data_7', 0)\
} else {\
return ReadingsNum($NAME, 'Mileage', 0)\
}\
},\
OperatingVoltage:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 4 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 98\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 208 ) {\
return ReadingsNum($NAME, 'frame_1_data_5', 0) /10.0\
} else {\
return ReadingsNum($NAME, 'OperatingVoltage', 0)\
}\
},\
TotalCharge:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 7 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 98\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 33 and ReadingsNum($NAME, 'frame_1_data_4', 0) == 113 ) {\
return round( 2 * ReadingsNum($NAME, 'frame_1_data_7', 0) + ReadingsNum($NAME, 'frame_1_data_8', 0) / 128 , 0)\
} else {\
return ReadingsNum($NAME, 'TotalCharge', 0)\
}\
},\
TotalDischarge:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 7 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 98\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 33 and ReadingsNum($NAME, 'frame_1_data_4', 0) == 114 ) {\
return round( 2 * ReadingsNum($NAME, 'frame_1_data_7', 0) + ReadingsNum($NAME, 'frame_1_data_8', 0) / 128 , 0)\
} else {\
return ReadingsNum($NAME, 'TotalDischarge', 0)\
}\
},\
BatteryVoltage:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1995 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 16 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 9\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 98 and ReadingsNum($NAME, 'frame_1_data_4', 0) == 32 ) {\
return ( 256 * ReadingsNum($NAME, 'frame_1_data_6', 0) + ReadingsNum($NAME, 'frame_1_data_7', 0)) / 10.0 \
} else {\
return ReadingsNum($NAME, 'BatteryVoltage', 0)\
}\
},\
SoE:frame_1_data_6:.* {\
if (ReadingsNum($NAME, 'frame_1_id', 0) == 1994 and ReadingsNum($NAME, 'frame_1_data_1', 0) == 7 and ReadingsNum($NAME, 'frame_1_data_2', 0) == 98\
and ReadingsNum($NAME, 'frame_1_data_3', 0) == 208 and ReadingsNum($NAME, 'frame_1_data_4', 0) == 98 ) {\
return (256*ReadingsNum($NAME, 'frame_1_data_7', 0)+ReadingsNum($NAME, 'frame_1_data_8', 0)) / 10.0 \
} else {\
return ReadingsNum($NAME, 'SoE', 0)\
}\
}

</syntaxhighlight>

[[Kategorie:Elektromobilität]]

2024-04-14T17:45:19Z

Topos: Code hinzugefügt

Webasto Next

2024-04-14T17:35:59Z

Topos: Anlegen

Die Wallbox Webasto Next kann per LAN oder WLAN über das Modebus-Protokoll ausgelesen und gesteuert und gesteuert werden.

Hier eine mögliche Konfiguration

Luxtronik 2.0

2019-04-19T16:30:42Z

Topos: /* Nützliche Links */

{{Infobox Modul
|Name=LUXTRONIK2
|ModPurpose=Anbindung der Heizungssteuerung Luxtronik 2.0
|ModType=d

|ModCmdRef=LUXTRONIK2
|ModForumArea=Sonstiges
|ModTechName=23_LUXTRONIK2.pm
|ModOwner=[http://forum.fhem.de/index.php?action=pm;sa=send;u=5432 tupol]
}}
Die Luxtronik 2.0 ist eine Heizungssteuerung der Firma Alpha InnoTec AIT, die in Wärmepumpen von Alpha InnoTec, Buderus (Logamatic HMC20, HMC20 Z), CTA All-In-One (Aeroplus), Elco, Nibe (AP-AW10), Roth (ThermoAura®, ThermoTerra), Novelan (WPR NET) und Wolf Heiztechnik (BWL/BWS) verbaut ist.
Sie besitzt einen Ethernet (RJ45) Anschluss, so dass sie direkt in lokale Netzwerke (LAN) integriert werden kann. 

Ein detailierte Anleitung zum energiesparenden Betrieb einer Luft-Wasser-Wärmepumpe mit Fußbodenheizung findet man auf [[Effizienter Betrieb einer Fußbodenheizung mit Luft-Wasser-Wärmepumpe (Fallbeispiel)|'''dieser''' Wiki-Seite]]

== Hinweise zum Betrieb mit FHEM ==
Definition in fhem.cfg:

define <name> '''LUXTRONIK2''' <IP-Adresse[:Port]> [Abfrageinterval]

Die Angabe der Portnummer ist optional. Bei einigen Firmware-Versionen sollte der Port 8889 angegeben werden.

Weiter in der {{Link2CmdRef|Lang=de|Anker=LUXTRONIK2}}.

=== Zusätzliche Perl-Module ===
Das FHEM-Modul benutzt das CPAN-Modul "net::Telnet". Dieses ist standardmäßig installiert. Wenn nicht muss es nachinstalliert werden. Unter Debian z.B. mit
sudo apt-get install libnet-telnet-perl

=== Hard- und Firmwareversionen ===
Die Luxtronik 2.1 ähnelt der Version 2.0 stark, besitzt aber eine andere Hardware und Firmware-Versionsnummer.

Bei Steuerungen mit den Firmware-Versionen 2.xx, 3.xx und 4.xx existiert kein Telnet-Zugang. Eine automatische Korrektur der Systemzeit ist dadurch nicht möglich.

Das Modul nutzt die nicht öffentlich dokumentierte Schnittstelle des über einen Internetbrowser aufrufbaren Java-Programmes der Steuerung (Port 8888 oder 8889). Aufgrund der Java-Einschränkungen neuerer Internet-Browser hat die Steuerung seit der Firmware-Version x.81 auch eine Schnittstelle für ein Java-Script (Port 8214). Dies ermöglicht die Bedienung mit neueren Browsern hat aber geringere Auslese- und Einstell-Möglichkeiten. Das Modul nutzt diese Schnittstelle (derzeit) nicht.

Neue Firmware-Versionen sind gewöhnlich abwärtskompatibel und sollten nicht zu Einschränkungen bei dem Modul führen. Bei Firmware-Versionen >x.81 wurde jedoch berichtet, dass über die Java-Schnittstelle nicht mehr alle Informationen übertragen werden.

== Erläuterung der Readings ==
===Allgemeine Wärmepumpenwerte===
* '''ambientTemperature''' - Temperatur des Außensensors in °C
* '''averageAmbientTemperature''' - Gemittelte Außentemperatur in °C (für Heizgrenze im Sommer, siehe [[#Frostschutz_und_Heizgrenze|Frostschutz und Heizgrenze]])
* '''bivalentLevel''' - Bivalenzstufe, siehe [[#Bivalenter_Betrieb|Bivalenter Betrieb]]
* '''COP''' - Coefficient Of Performance, Wirkungsgrad der Wärmepumpe (Leistungszahl ε). Eine Leistungszahl von z.B. 4,2 bedeutet, dass von der eingesetzten elektrischen Leistung des Kompressors das 4,2- fache an Wärmeleistung bereitgestellt wird. Anders formuliert, kann mit dieser Wärmepumpe aus einem Kilowatt elektrischer Leistung 4,2 kW Wärmeleistung zur Verfügung gestellt werden. ''Bei der Berechnung des COPs wird die elektrische Leistung aus dem Attribut "heatPumpElectricalPowerWatt" benutzt.''
* '''delayDeviceTimeCalc''' - Abweichung Gerätesystemzeit zur FHEM-Zeit. Dieser kann bis zu 2 s in der Vergangenheit liegen. Höhere Werte weisen auf eine ungenaue Systemzeit in der Steuerung hin.
* '''deviceTimeCalc''' - Beim Abrufen der Gerätewerte wird von der Luxtronik-Steuerung auch der Zeitpunkt der internen Ermittlung übergeben.
* '''durationFetchReadings''' - Dauer (in s) des Abrufes der Gerätewerte von der Steuerung
* '''flowRate''' - Durchfluss in l/h
* '''flowTemperature''' - Vorlauftemperatur in °C, normalerweise direkt hinter der Heizungsumwälzpumpe gemessen und '''vor''' einer eventuell installierten Heizpatrone
* '''heatSourceIN''' - Wärmequelle Eingangstemperatur in °C
* '''heatSourceOUT''' - Wärmequelle Ausgangstemperatur in °C (sitzt bei Luft-Wasser-WPs aber im Verdampfer)
* '''hotGasTemperature''' - Heißgastemperatur in °C, Temperatur, die hinter dem Kompressor der Wärmepumpe anfällt
* opStateHeatPump1...3
* '''returnTemperature''' - Rücklauftemperatur in °C, normalerweise vor dem Eingang zum Wärmetauscher des Verdichterkreislaufes gemessen
* '''thermalPower''' - aktuelle Heizleistung der WP in kW, berechnet aus Durchfluss und Differenz von Vor- und Rücklauftemperatur, also ohne Heizpatrone etc.

=== Luft-Wasser-Wärmepumpen ===
* '''heatSourceDefrostAirEnd''' - Luft-Ausgangstemperatur in °C bei der die Luftabtauung des Verdampfers beendet wird
* '''heatSourceDefrostAirThreshold''' - Luft-Eingangstemperatur in °C oberhalb der der Verdampfer (energiesparend) mit Luft abgetaut wird
* '''heatSourceDefrostLast''' - Dauer sowie Umgebungs- und Luft-Eingangs-Temperaturen zum Beginn und am Ende der letzten Abtauung
* '''heatSourceDefrostLastTimeout''' - Umgebungs- und Wärmequellen-Temperaturen bei denen die Luftabtauung die maximale Dauer überschritten hat.
* '''heatSourceDefrostTimer''' - Ablaufzeit in Sekunden bis zur nächsten Abtauung des Verdampfers

=== Heizung ===
* '''heatingCurveEndPoint''' - Endpunkt der Heizkurve in °C bei -20°C Außentemperatur
* '''heatingCurveOffset''' - Parallelversatz der Heizkurve
* '''heatingSystemCircPumpDeaerate''' - Entlüftungsmodus der Heizkreisumwälzpumpe (wird zum gezielten Einschalten der Pumpe durch FHEM genutzt)
* '''heatingLimit''' - Heizgrenze wird ausgewertet (on, off)
* '''mixer1FlowTemperature''' - Vorlauftemperatur am Mischkreis 1 in °C
* '''mixer1TargetTemperature''' - Sollwert Vorlauftemperatur am Mischkreis 1 in °C
* '''mixer2FlowTemperature''' - Vorlauftemperatur am Mischkreis 2 in °C
* '''mixer2TargetTemperature''' - Sollwert Vorlauftemperatur am Mischkreis 2 in °C
* '''mixer3FlowTemperature''' - Vorlauftemperatur am Mischkreis 3 in °C
* '''mixer3TargetTemperature''' - Sollwert Vorlauftemperatur am Mischkreis 3 in °C
* '''opModeHeating''' - Betriebsmodus der Heizung (Aus, Automatik, Zusatzheizung, Party, Ferien)
* '''opStateHeating''' - Status der Heizung (Aus, Normal, Abgesenkt, Heizgrenze, Frostschutz)
* '''returnTemperatureHeating''' - aktuelle oder letzte valide Rücklauftemperatur des Heizungskreislaufes in °C. Durch die Speicherung kann auch bei stehender Zirkulationspumpe oder während der Warmwasserbereitung auf die letzte valide Rücklauf-Temperatur des Heizkreislaufes zurückgegriffen werden.
* '''returnTemperatureHyst''' - Regel-Hysterese in K der Rücklauf-Solltemperatur
* '''returnTemperatureSetBack''' - Schnellverstellung in K der Rücklauf-Solltemperatur
* '''returnTemperatureTarget''' - Sollwert Rücklauftemperatur in °C (wird durch Heizkurve und Außensensor bestimmt, kann über in der Steuerung eingegebene Zeiten und auch manuell gezielt abgesenkt)
* '''thresholdHeatingLimit''' - Heizgrenze in °C, '''über'''schreitet die gemittelte Außentemperatur diesen Wert, wird nicht mehr geheizt
* '''thresholdTemperatureSetBack''' - '''unter'''schreitet die Außentemperatur diesen Wert (°C), wird die Rücklauf-Solltemperatur nicht mehr (zeitgesteuert) abgesenkt

=== Warmwasserbereitung ===
* '''hotWaterCircPumpDeaerate''' - Entlüftungsmodus der Zirkulationspumpe (zum gezielten Einschalten der Zirkulationspumpe durch FHEM)
* '''hotWaterTemperature''' - aktuelle Warmwasser-Boiler-Temperatur in °C (Achtung, die Temperatur im Boiler ist sehr unterschiedliche, es wird also nur die Temperatur am Sensor angezeigt. Typischerweise sackt die Temperaturkurve beim Aufheizen des Boilers etwas ab, weil es durch den Wärmeeintrag zu Strömungen kommt.)
* '''hotWaterTemperatureTarget''' - obere Solltemperatur des Boilers in °C
* '''opModeHotWater''' - Betriebsmodus der Warmwasserbereitung (Aus, Automatik, Zusatzheizung, Party, Ferien)
* '''opStateHotWater''' - Status der Warmwasserbereitung (Aus, Aufheizen, Temp. OK, Sperrzeit)

=== Solarthermie ===
* solarBufferTemperature - in °C
* solarCollectorTemperature - in °C

=== Lüftung ===
* '''opModeVentilation''' - Betriebsmodus der Lüftung (Aus, Automatik, Party, Feuchteschutz)
* '''ventSupplyAirTemperature''' - Zulufttemperatur in °C
* '''ventExhaustAirTemperature''' - Ablufttemperatur in °C

=== Zähler ===
* '''counterHeatQHeating''' - von der Wärmepumpe produzierte Wärmemenge (kWh) zur Heizung (nur bei vorhandenem Wärmemengenzähler und ohne Wärmeeintrag durch zweite Wärmequelle wie z.B. Heizstäbe)
* '''counterHeatQHotWater''' - von der Wärmepumpe produzierte Wärmemenge (kWh) zur Warmwasserbereitung (nur bei vorhandenem Wärmemengenzähler und ohne Wärmeeintrag durch zweite Wärmequelle wie z.B. Heizstäbe)
* '''counterHeatQTotal''' - von der Wärmepumpe produzierte Wärmemenge (kWh) insgesam (nur bei vorhandenem Wärmemengenzähler und ohne Wärmeeintrag durch zweite Wärmequelle wie z.B. Heizstäbe)

* '''counterHours2ndHeatSource1''' - Betriebsstunden der zweite Wärmequelle (normalerweise elektrische Heizstäbe)
* '''counterHoursHeatPump''' - Betriebsstunden des Wärmepumpenkompressors
* '''counterHoursHeating''' - Betriebsstunden des Wärmepumpenkompressors die zur Heizung benutzt wurden
* '''counterHoursHotWater''' - Betriebsstunden des Wärmepumpenkompressors die zur Warmwasserbereitung benutzt wurden

=== Ein- und Ausgänge ===
* compressor1...2
* '''heatingSystemCircPump''' - Heizungs-Umlaufpumpe in der Wärmepumpe (normaler Weise für das Heizungssystem) (HUP)
* '''heatingSystemCircPumpVoltage''' - Regelspannung an der Heizungs-Umlaufpumpe in der Wärmepumpe (zur Steuerung der Pumpen-Drehzahl)
* '''heatSourceMotor''' - Motor des Ventilators, der Brunnen- oder der Solepumpe (je nach WP-Typ) (Ventil-BOSUP)
* '''hotWaterCircPumpExtern''' - Zirkulationspumpe im Warmwasserstrang des Hauses (wenn genutzt) (ZIP)
* '''hotWaterSwitchingValve''' - Ventil zur Umschaltung auf die Heizspirale im Boiler (BUP)
* 2ndHeatSource1...3
* '''solarPump''' - Pumpe der Solarthermie (SLP)

=== Sonstiges ===
* Firmware
* '''typeSerial''' - Baujahr/Monat-Lfd.Hexadezimalnummer
* '''typeHeatpump''' - Modell der Wärmepumpe
**ERC
**HMD 2
**KLW
**KSW
**L1A
**L1A407
**L1AREV
**L1H
**L1I
**L1I407
**L1S
**L2A
**L2A407
**L2AREV
**L2G
**L2G404
**L2G407
**L2H
**L2I
**L2I407
**LD2AG
**LD5
**LD5 (230V)
**LD5 REV
**LD5 REV 230V
**LD7
**LD7 (230 V)
**LD7 REV
**LD7 REV 230V
**LD9
**LD9 REV 230V
**LW SEC
**LWC
**'''LWC407''' - Kompakte Luft/Wasser-Wärmepumpe zur Innenaufstellung
**LWD90V - ?? Duale Luft/Wasser-Wärmepumpe invertergeführt zur Außenaufstellung
**MSW 10
**MSW 10S
**MSW 12
**MSW 13S
**MSW 14
**MSW 16S
**MSW 17
**MSW 19
**MSW 23
**MSW 26
**MSW 30
**MSW 4
**MSW 4S
**MSW 6 - Sole/Wasser-Wärmepumpe
**MSW 6S
**MSW 8
**MSW 8S
**MSW2-6S
**MSW3-12
**MSW3-12S
**MSW4-1676
**SW 291
**SW 29_56
**SW 37_45
**SW 58_69
**SW1 - ?? Sole/Wasser-Wärmepumpe
**SW2
**SWC - ?? kompakte Sole/Wasser-Wärmepumpe
**WW1 - ?? Wasser/Wasser-Wärmepumpe
**WW2
**WWB_20 - ?? Wasser/Wasser-Booster zur dezentralen Trinkwassererwärmung
**WWC1 - ?? kompakte Wasser/Wasser-Wärmepumpe
**WWC2
**WZS - ??? Sole/Wasser Wärmezentrale
**WZW
**WZWD

== Tipps zum ökonomischen Betrieb ==
Grundlage eines ökonomischen Betriebs einer Wärmepumpe ist in erster Linie ein guter hydraulischer Abgleich der Heizwasserverteilung und eine genaue Einstellung der Heizkurve. Beides ist sowohl von den Bedürfnissen und dem Nutzungsverhalten der Bewohner als auch von der Dämmung des Hauses abhängig.

Insbesondere für Wärmepumpen, die '''nicht''' über einen leistungsgeregelten Verdichter verfügen, gibt es den interessanten Ansatz, die Einzelraumregler (ERR) und das Überströmventil der Wärmepumpe komplett ausser Betrieb zu nehmen und damit alle Heizkreise als ein "Heizkörper" zu betrachten. Diverse Foreneinträge (z.B. [http://www.haustechnikdialog.de/Forum/t/142011/Einstellungen-Alpha-Innotec-LWC80]) erzählen von bedeutenden Einsparungen durch Absenken der Solltemperatur und Wärmepumpen-freundlichen Betriebszyklen (lange Taktzeiten) und gehen auch detailiert auf durch die Luxtronik2 betriebene Wärmepumpen ein.

Ein detailierte Anleitung zum energiesparenden Betrieb einer Wärmepumpe findet man auf der folgenden Wiki-Seite: 
[[Effizienter Betrieb einer Fußbodenheizung mit Luft-Wasser-Wärmepumpe (Fallbeispiel)]]

=== Sperrzeiten ===
Die Luxtronik 2.0 erlaubt es, sich mit Hilfe von Sperrzeiten an zeitabhängige Strompreise anzupassen. Die Uhr der Steuerung geht jedoch sehr ungenau. Durch Setzen des Attributes "autoSynchClock" wird die Uhr der Steuerung regelmäßig mit der FHEM-Zeit abgeglichen. Die Funktion muss über das Attribut "allowSetParameter" freigegeben werden.
attr <device> allowSetParameter 1
attr <device> autoSynchClock 10

''Dies funktioniert nicht bei der Steuerungen Luxtronik 2.1 und bei der Firmware 2.xx, 3.xx oder 4.xx.''

==Abschätzung des elektrischen Verbrauches==
Über die Attribute "heatPumpElectricalPowerWatt", "heatPumpElectricalPowerFactor" und "heatRodElectricalPowerWatt" wird der elektrische Verbrauch während der Wärmeerzeugungen (Kompressormotor, Motor(en) der Wärmequelle) und der Heizstäbe festgelegt. Ist zudem das Attribute "doStatistics" auf 1 und der Werte "activeTariff" auf einen Wert zwischen 1 und 9 gesetzt, so berechnet das Modul anhand der Betriebsstunden automatisch den elektrischen Verbrauch innerhalb des angegebenen Stromtarifes.

Normalerweise wird eine Wärmepumpe mit einem zeitabhängigen Stromtarif betrieben (Doppeltarifzähler). Hierbei muss der Werte "activeTariff" zum jeweiligen Zeitpunkt über ein FHEM-Script gesetzt werden.
Beispiel:
define Strom_HT_W at *06:00 { if ( $wday != 0 ) {fhem( "set Heizung activeTariff 1" );;} }
define Strom_NT_W at *22:00 set Heizung activeTariff 2
define Strom_NT_Sa at *13:00 { if ( $wday == 6 ) {fhem( "set Heizung activeTariff 2" );;} }

==Verhalten der Steuerung Luxtronik 2.0==
Leider ist die Beschreibung des Steuerungsverhaltens in den Bedienungsanleitungen meist sehr oberflächlich gehalten. Die folgenden Erläuterungen benutzen die Abkürzungen (fett) der Webapplikation der Steuerung. 
Das notwendige Verständnis der Prozesstechnik einer Wärmepumpe erhält man z.B. auf den folgenden Seiten: [http://www.energie-experten.org/heizung/waermepumpe/technik/ www.energie-experten.org/heizung/waermepumpe/technik/]

===Abtauung des Verdampfers (Luftwärmetauschers) bei Luft-Wasser-Wärmepumpen===
Wird die Luft im Verdampfer unter den Taupunkt abgekühlt, so kommt es zur Ansammlung von Feuchtigkeit an den Bauteilen des Verdampfer. Liegt dabei die Temperatur an den Lamellen unter 0 °C (bzw. die Ausströmtemperatur der Luft knapp darüber) so vereist der Verdampfer. Diese Eisschicht wächst kontinuierlich und verschlechtert extrem die Wärmeübertragung aus der Luft in den Verdichterkreislauf.

Aus diesem Grund wird bei einer Außentemperatur unter 15°C der Verdampfer zyklisch abgetaut. Das Abtauen startet nach dem Ende der '''Ablaufzeit Abtauen''' (''heatSourceDefrostTimer'') des Verdichters.
Der Startwert der ''Ablaufzeit Abtauen'' liegt im Bereich '''Abtzyk min''' und '''Abtzyk max''' und wird bei Kreisumkehr (s.u.) nach jedem Abtauvorgang anhand der dafür benötigten Zeit neu bestimmt.

Bei Außentemperaturen zwischen 10°C und 15°C muss der Verdichter außerdem kontinuierlich 40 Minuten gelaufen sein. Während des Stillstandes des Verdichters wird bei ''Wärmequelle-Ein'' (''heatSourceIN'') oberhalb ''T-Luftabt.'' (''heatSourceDefrostAirThreshold'') die ''Ablaufzeit Abtauen'' (''heatSourceDefrostTimer'') wieder kontinuierlich (1s pro min) bis zum Wert '''Abtzyk min''' erhöht.

[[Datei:Luxtronik2-Luftabtauung.png|miniatur|Temperaturverlauf bei Luftabtauung (roter Pfeil)]]
Es gibt zwei Möglichkeiten des Abtauens:
# '''Luftabtauung: ''' nur oberhalb des Gefrierpunktes, etwas langsamer aber energiesparend
#: Die Luftabtauung wird nur gestartet, wenn zu Beginn des Abtauens die Temperatur '''Wärmequelle-Ein''' (''heatSourceIN'') oberhalb der Temperatur '''T-Luftabt.''' (''heatSourceDefrostAirThreshold'') liegt. Dann wird der Verdichter abgeschaltet und nur noch der Ventilator (''heatSourceMotor'') betrieben, um die Eisschicht mit der durchströmenden Luft abzutauen. Dabei steigt die Austrittstemperatur '''Wärmequelle-Aus''' (''heatSourceOUT'') bis auf ca. 0°C und das geschmolzene Eis beginnt abzulaufen. Ist der größte Teil des Eises geschmolzen, so steigt die Austrittstemperatur wieder. Die Luftabtauung wird beendet, wenn die ''Schaltspielsperre nach Verdichterstop'' (5 min) abgelaufen ist und die Temperatur '''Wärmequelle-Aus''' (''heatSourceOUT'') den Wert '''T-LABT-Ende''' (''heatSourceDefrostAirEnd'') erreicht hat oder wenn die Zeitbegrenzung '''Luft-Abt. max''' überschritten wird. Bei Überschreitung der Zeitbegrenzung wird per ''Kreisumkehr'' weiter abgetaut. Nach dem Ende der Luftabtauung wird die '''Ablaufzeit Abtauen''' (''heatSourceDefrostTimer'') auf den Wert '''Abtzyk min''' gesetzt.

# '''Kreisumkehr:''' schnell und energieintensiv
#: Bei der Kreisumkehr wird der Ventilator (''heatSourceMotor'') abgeschaltet und der Verdichter weiter betrieben. Über ein Vierwegeventil (Ausgang '''AV-Abtauventil''') wird der Verdichterkreislauf so umgekehrt, dass dem Heizwasserkreislauf Wärme entzogen und der Verdampfer aufgeheizt wird. Nach 10 Minuten oder beim Ansprechen des Abtauendepressostaten (Eingang '''ASD''') wird der Abtauvorgang beendet.
#: Vor dem Start des Abtauens erfolgt eine s. g. Durchflussüberwachung. Dabei wird geheizt und die Steuerung prüft, ob der Heizkreislauf genügend Durchfluss hat, um die nötige Wärmemenge für den Abtauvorgang zu Verfügung zu stellen. Die Durchflussüberwachung dauert 8 Minuten. In dieser Zeitspanne ist das erwärmte Wasser zumeist auch durch den Heizungskreislauf gewandert, steht wieder am Vorlauf an und wird dann durch den Abtauvergang wieder abgekühlt. Bei einer Außentemperatur über 5 °C oder einer Rücklauftemperatur über 40 °C wird die Durchflussüberwachung auf zwei Minuten gekürzt.

Kommt die Wärmepumpe vor dem Start der Luftabtauung zum Stehen, so taut der Verdampfer durch die Plusgrade der Umgebung auch von ganz allein ab, diese ist an der Temperatur ''Wärmequelle-Aus'' zu erkennen, wird von der Luxtronik aber leider nicht berücksichtigt.

Der Sensor ''Wärmequelle-Ein'' sitzt im Zuluftkanal in der Nähe des Verdampfers. Der Sensor ''Wärmequelle-Aus'' sitzt direkt '''im''' Verdampfer, misst also nicht die tatsächliche Lufttemperatur.

===Bivalenter Betrieb===
* '''Bivalenz Stufe'''
*: Damit wird über die HRM- und HRW-Zeit das Zuschalten weiterer Wärmequellen gesteuert:
*:: Stufe 1 = ein Verdichter darf laufen (Bei zwei Verdichtern werden diese in Abhängigkeit der '''Impulse Verdichter 1/2''' abwechselnd verwendet.)
*:: Stufe 2 = zwei Verdichter dürfen laufen, sofern die Außentemperatur den Wert '''Freig. 2.VD''' unterschritten hat. Statt dem 2. Verdichter kann auch eine parallel betriebene Wärmepumpe freigegeben werden.
*:: Stufe 3 = zusätzlicher Wärmeerzeuger 1 ('''ZWE 1''', z.B. Heizstäbe oder Kessel) darf mitlaufen, sofern die Außentemperatur den Wert '''Freig. ZWE''' unterschritten hat
*:: Stufe 4 = zusätzlicher Wärmeerzeuger 2 ('''ZWE 2''', z.B. Heizstäbe) darf mitlaufen, sofern die Außentemperatur den Wert '''Freig. ZWE''' unterschritten hat
*: Wenn die Rücklauftemperatur die Rücklauf-Solltemperatur und die maximale Rücklauferhöhung '''TR Erh max''' überschreitet, werden sofort alle Wärmeerzeuger abgeschaltet und die Bivalenzstufe 1 gesetzt.
*: Wenn in der Heizung die maximale Vorlauftemperatur '''Vorlauf max.''' überschritten wird, dann wird sofort ein Kompressor ausgeschalten und die Bivalenzstufe um den Wert 1 reduziert.
*: Bei der Warmwassererzeugung wird der zusätzliche Wärmeerzeuger erst nach der Zeit '''WW+WP max''' freigegeben.

* '''HRM-Zeit''' - Heizungsregler Mehr-Zeit
*: Die Zeit beginnt zu zählen, wenn die Wärmepumpe heizt und sich die Rücklauftemperatur '''unterhalb''' des Einschaltkriteriums ('''Rückl.Soll''' - '''Hyterese HR''') befindet.
*: Überschreitet diese Zeit einen bestimmten Wert, so wird in die nächst höhere ''Bivalenzstufe'' geschaltet, um zusätzliche Wärmeerzeuger zu aktiviert.
*: Die Bivalenzstufe 2 (zwei Verdichter) wird nach der '''HR Zeit''' (Standard 25 min) erreicht.
*: Die Bivalenzstufe 3 (ZWE 1) wird nach der Zeit '''Freig. ZWE''' (Standard 60 min) erreicht.
*: Die Bivalenzstufe 4 (ZWE 2) wird nach 120 min erreicht.

* '''HRW-Zeit''' - Heizungsregler Weniger-Zeit
*: Die Zeit beginnt zu zählen, wenn die Wärmepumpe heizt und sich die Rücklauftemperatur '''oberhalb''' des Ausschaltkriteriums ('''Rückl.Soll''' + '''Hyterese HR''') befindet.
*: Überschreitet diese Zeit einen bestimmten Wert (jeweils 15 min), so wird in die nächst niedrigere ''Bivalenzstufe'' geschaltet, um zusätzliche Wärmeerzeuger wieder zu deaktivieren.

===Automatische Sperren===
* '''SSP-Zeit''' - Ablaufzeit der Schaltspielsperre (SSP)
*: Es gibt zwei SSP-Ablaufzeit. Sie verzögern das erneute Starten des Verdichters für:
*:: 20 min ab letztem '''Ein'''schaltzeitpunkt des Verdichters, um die Belastung des Stromnetzes durch den erhöhten Anlaufstrom zu reduzieren.
*:: 5 min ab letztem '''Aus'''schaltzeitpunkt des Verdichters, um den Verdichterkreislauf zu schonen.
*: Das heisst, der Verdichter startet frühestens 20 min nach dem letzten Start, resp. 5 min nach dem letzten Stop. Es gibt also maximal 3 Anläufe pro Stunde.

===Heizkurve===
Die Heizkurve lässt sich über zwei Parameter einstellen
* Eine Veränderung des Heizkurven-Endpunktes (HKE) verändert die Steigung der Kurve indem es die Rücklauf-Solltemperatur ''rlSoll'' bei tiefen Temperaturen festlegt.
* Die Parallelverschiebung (PVS) des Heizkurven-Fusspunktes hebt oder senkt die komplette Kurve und verändert dabei auch die Steigung geringfügig.
* Bei einer "neutralen" Parallelverschiebung von 20°C wird bei -20°C Außentemperatur der Heizkurvenendpunkt als ''rlSoll'' eingestellt.
: Bei 20°C Außentemperatur liegt ''rlSoll'' auf dem Heizkurven-Fusspunkt von 20°C.
: Eine Erhöhung des Fusspunktes um 1°C erhöht auch ''rlSoll'' bei -20°C um 1°C.

Die Rücklauf-Solltemperatur ''rlSoll'' wird von der Steuerung in Abhängigkeit von der Außentemperatur wie folgt berechnet:
: rlSoll (Aussentemp) = PVS + (HKE - 20) * (PVS - Aussentemp) / (20 - (Aussentemp - PVS) / 2)

'''Beispiel''' 
Bei einer "neutralen" Parallelverschiebung von 20°C und einem Heizkurvenendpunkt von 30°C lautet der vereinfacht Term:
: rlSoll (Aussentemp) = 20 + 20 * (Aussentemp - 20) / (Aussentemp - 60)
D.h. rlSoll (20°C) = 20°C und rlSoll (-20°C) = 30°C

===Frostschutz und Heizgrenze===
Ist die '''Heizgrenze''' eingeschaltet, so schaltet die Steuerung in den Frostschutz-Modus (=Sommermodus), sobald die '''Mitteltemperatur''' (''averageAmbientTemperature'') die Heizgrenze (''thresholdHeatingLimit'') um 0,2 K überschreitet. Dabei wird die Rücklaufsolltemperatur (''returnTemperatureTarget'') auf die '''Min.Rückl.Solltemp.''' (z.B. 15 °C) absenkt.
Bei Luft-Wasser-Wärmepumpen wird die Rücklaufsolltemperatur auf 20 °C angehoben, sobald die '''Außentemperatur''' (''ambientTemperature'') 10 °C unterschreitet. 
Die ''Mitteltemperatur'' ist laut Handbuch der Durchschnitt der Außentemperatur der letzten 24 Stunden. Tatsächlich wird sie aber einmal pro Stunde aus einem reduzierten Mittelwert der letzten 11 Stunden gebildet.

Beim Unterschreiten der Solltemperatur startet der Heizvorgang (Frostschutz).

Empfehlung für die Heizgrenze:
* Altbau: 15°C
* Neubau: 12°C
* Passivhaus: 10°C

===Pumpenoptimierung===
Der Stromverbrauch einer durchgängig laufenden normalen Heizungsumwälzpumpe beträgt mehrere kWh pro Tag. Damit kann er in der Übergangszeit sogar im Bereich des Stromverbrauches des Verdichters liegen (z.B. 5 kWh/Tag). Durch den Einsatz engergiesparender Pumpen kann man ihn reduzieren. Die Funktion '''Pumpenoptimierung''' ist eine zusätzliche Möglichkeit, um durch bedarfsgesteuertes Abschalten der Heizungsumwälzpumpe Strom zu sparen.

Es gibt verschiedene Stufen:
# Liegt die Rücklauftemperatur 30 Minuten nach Ende des Heizvorganges noch über dem Sollwert (ohne Hysterese), so wird die Heizungspumpe für 30 min abgeschaltet.
# Liegt die Rücklauftemperatur nach Ende des Heizvorganges für die Dauer der '''Pumpenoptim.Zeit''' oberhalb des Sollwertes, so wird die Heizungspumpe abgeschaltet. Danach wird alle 30 Minuten wieder für 5 Minuten eingeschaltet, um die aktuelle Rücklauftemperatur des Heizungskreislaufes zu ermitteln. Liegt die Rücklauftemperatur nach den 5 Minuten unterhalb des Sollwertes so läuft die Heizungspumpe wieder dauerhaft.
# Sobald die Außentemperatur über der Rücklauf-Solltemperatur liegt, wird die Heizungspumpe dauerhaft abgeschaltet. Um ein Festsitzen der Pumpe zu vermeiden, wird sie alle 150 Stunden für eine Minute wieder eingeschaltet.

Die Pumpenoptimierung läuft nicht bei Außentemperaturen unter +1,0°C, um das Einfrieren von außen-aufgestellten Anlagen zu verhindern. Während der EVU-Sperre steht auch die Heizungsumwälzpumpe. Nach deren Ende läuft die Heizungsumwälzpumpe erst 5 Minuten ehe die Rücklauftemperatur ausgewertet wird.

Die Pumpenoptimierungszeit sollte möglichst klein gewählt werden, wenn eine Fussbodenheizung ohne Einzelraumregler betrieben wird und Räume unterschiedliche Temperaturen haben sollen, da sonst nach Abschalten der Wärmepumpe die wärmeren Räume schneller abkühlen und dabei die kälteren aufheizen.

==Firmware==
=== Firmware Bugs und Eigentümlichkeiten===
- bitte mit eigenen Beobachtungen ergänzen -

Lfd-Nr. 1 
Die Warmwassererwärmung führt zu einer starken Erhöhung der Temperatur im Heizkreislauf-Wärmetauscher der Wärmepumpe. Nach dem Zurückschalten auf den Heizungsbetrieb, speist der Puffer bis zur Abkühlung erstmal mit einer sehr hohen Temperatur in den Heizungskreislauf ein und verfälscht dadurch die Rücklauftemperatur stark. Die Heizungspumpe läuft zwar 2 Minuten nach aber in dieser Zeit wird die überhöhte Wärmetauschertemperatur nicht abgebaut. Bei eingeschalteter Pumpenoptimierung führt dies zu zu einer Zwangspause von entweder 30 Minuten oder bis der Temperaturfühler an der Rücklaufleitung durch den normalen Wärmeverlust unterhalb der Solltemperatur abgekühlt ist.

Lfd-Nr. 2 
Über das Webinterface kann man teilweise keine Ferienzeit von wenigen Tagen auswählen. Wurde in den aktuelleren Firmwareversionen behoben.

Lfd-Nr. 3 
Mittlere Außentemperatur wird nicht über die letzten 24 h bestimmt.

Lfd-Nr. 4 (Luft-Wasser-Wärmepumpen) 
Die Berücksichtigung der Natur-Luftabtauung (ohne Ventilator) von 1s/1min ist viel zu gering. Das müßte höher sein.

Lfd-Nr. 5 (Luft-Wasser-Wärmepumpen) 
Nach dem Heizungstakt könnte problemlos ein Luftabtauen erfolgen, damit für den nächsten Heizungstakt wieder an abgetauter Verdampfer zu Verfügung steht.

Lfd-Nr. 6 (Luft-Wasser-Wärmepumpen) 
Nach einer Luftabtauung wird der Heiztakt nicht zu Ende geführt, sondern erst wieder beim Unterschreiten der unteren Hysterese gestartet. Dadurch bleibt die Rücklauftemperatur eventuell dauerhaft unterhalb der Solltemperatur und die Raumtemperatur sinkt mit der Zeit ab.

Lfd-Nr. 7 (Luft-Wasser-Wärmepumpen) 
Fällt das Kreisumlaufabtauen auf das Ende des Heizzykluses so startet die Wärmepumpe nicht erneut. Der auf über 30°C erhitzte Wärmetauscher erwärmt nun die Luft in der Wärmepumpe. Bei Erreichen wird der Luftabtaugrenze wird der Ablauftimer auf den Mindestwert gesetzt und verliert die beim Kreisumkehr-Abtauen automatisch bestimmte höhere Ablaufzeit (meist in der Nähe der Maximalzeit).

Lfd-Nr. 8 (Luft-Wasser-Wärmepumpen) 
Fällt das Kreisumlaufabtauen auf das Ende des Heizzykluses so startet die Wärmepumpe erstmal nicht erneut. Durch die Kreisumkehr wurde jedoch ein Schub kalten Wassers im Heizungskreislauf gefangen. Dieser führt dann sehr schnell zu einem Absinken der Rücklauftemperatur und zu einem Neustart der Wärmepumpe.

Lfd-Nr. 9 (Luft-Wasser-Wärmepumpen) 
Das "natürliche" Abtauen wird nicht erkannt. Kommte die Wärmepumpe vor dem Ende der Abtauablaufzeit zum Stehen, so taut der Verdampfer bei positiven Umgebungstemperaturen von ganz alleine ab. Dies kann man Problemlos an der Temperatur ''Wärmequelle Aus'' erkennen, da diese durch die Schmelzenthalphie solange bei 0°C bleibt bis der Verdamper abtaut ist. Dann steigt sie auf die Höhe der Außentemperatur.

Lfd-Nr. 10 (Luft-Wasser-Wärmepumpen) 
Während des Abtauens durch Kreisumlauf wird dem Heizungskreislauf Wärme entzogen. Der Wärmemengen-Zähler zählt jedoch nicht rückwärts. Deshalb ist die von der Wärmepumpe ins Heizsystem eingebrachte Wärmemenge nicht korrekt. Tatsächlich wird ca. 5 % weniger Energie eingebracht und die Arbeitszahl ist ebenfalls ca. 5 % niedriger.

=== Nützliche Links ===
Die aktuelle Firmware gibt es [https://www.heatpump24.com/DownloadArea.php?layout=1 hier]

Eine Beschreibung der Java-Schnittstelle gibt es [http://www.loxwiki.eu/pages/viewpage.action?pageId=18219334 '''hier''']. Die Seite enthält auch eine Liste der Betriebsdaten (sog. berechnete Werte) die man mit ''get <device> rawdate'' anzeigen und mit dem Attribut ''userHeatpumpValues'' zum Gerät hinzufügen kann.

[[Kategorie:Other Components]]
[[Kategorie:Heizungssteuerung]]

FRITZBOX

2018-10-27T13:11:39Z

Topos: /* Fehler nach Firmware Update */

{{Infobox Modul
|ModPurpose=Steuerung einer Fritz!Box über FHEM
|ModType=d
|ModForumArea=FRITZ!Box
|ModTechName=72_FRITZBOX.pm
|ModOwner=tupol/Topos ({{Link2FU|5432|Forum}} / [[Benutzer Diskussion:Topos|Wiki]])}}

Das Modul [[FRITZBOX]] ermöglicht die Steuerung einer [[AVM Fritz!Box]] und von AVM FRITZ!WLAN Repeatern durch FHEM . An Fritzboxen können sowohl Geräte abgefragt werden, auf denen FHEM selbst läuft (lokaler Modus), als auch entfernte (externe) Geräte.

== Voraussetzungen ==
=== Remote-Zugang ===
Für den Remote-Zugang müssen die Module JSON:XS, LWP und SOAP::Lite installiert sein; auf einem [[Raspberry Pi]] oder unter Ubuntu z. B. mit dem Befehl
:<code>sudo apt-get install libjson-perl libwww-perl libsoap-lite-perl libjson-xs-perl</code>

Teilweise ist derzeit zusätzlich die Installation der telnet Libraries erforderlich, auch wenn der Telnet-Zugang nicht genutzt werden soll. Siehe dazu den nachfolgenden Abschnitt.

=== Telnet ===
Das Modul basierte ursprünglich auf dem Zugriff auf die Fritzbox per Telnet. Ab FRITZ!OS 6.2x baut AVM den abgekündigten Telnet-Zugang sowie die webcm-Schnittstelle sukzessive zurück bzw. hat dies, je nach Firmware, schon ganz abgestellt (siehe {{Link2Forum|Topic=38586|LinkText=dieses Forenthema}}). Der zukunftssichere Zugriff auf die Fritzbox sollte also per TR-064 erfolgen. Der Vollständigkeit halber und für ältere Firmwareversionen:

# Wer den Zugang per Telnet (noch) nutzen (kann und) möchte, muss dies zuerst freischalten. Üblicherweise durch Eingabe von #96*7* an einem direkt an der entsprechenden FritzBox angeschlosssenen Telefon
# Auf dem System, auf dem FHEM läuft ([[Systemübersicht#Server|Server]]) muss Telnet installiert sein; auf einem [[Raspberry Pi]] und unter Ubuntu z. B. mit dem Befehl
::<code>sudo apt-get install libnet-telnet-perl</code>

== Installation ==
=== Erste Schritte ===
Zur Erstinstallation reicht ein einfaches <code>define FritzBox FRITZBOX</code>, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff (FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).

==== TR-064: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
Für den Fernzugriff über TR-064 auf eine oder mehrere Fritzboxen und/oder einen FRITZ!WLAN Repeater sind die folgenden Schritte nötig (für jedes Gerät):

Fritzbox definieren:
:<code>define FritzBox FRITZBOX</code>

Wenn die Fritzbox nicht unter <nowiki>http://fritz.box</nowiki> erreichbar ist, IP im define setzen:
:<code>define FritzBox FRITZBOX 192.168.168.168</code>
192.168.168.168 dabei natürlich durch die passende IP ersetzen... Alternativ kann statt der IP auch der Hostname eingegeben werden.

Wenn ('''und nur wenn''') das Login auf der Benutzeroberfläche der FritzBox mit User und Passwort (und nicht nur per Passwort) geschieht, den User konfigurieren:
:<code>attr FritzBox boxUser ''Benutzername'' </code>
In der Fritzbox muss dann auch "Anmeldung mit FRITZ!Box-Benutzernamen und Kennwort" ausgewählt sein.

Passwort konfigurieren:
:<code>set FritzBox password ''Passwort''</code> - legt das zugehörige Passwort fest (nur einmal --> gehört nicht in die cfg-Datei)

Manuelle TR-064 Kommandos erlauben (Das Auslesen der Readings per TR-064 funktioniert auch ohne dieses Attribut.):
:<code>attr FritzBox allowTR064Command 1</code>

==== Telnet: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
[[Datei:Screenshot_FritzBox_TelnetUser.png|mini|300px|rechts|Anlegen des Attributs telnetUser]]
Bei Fernzugriff über Telnet sind weitere Schritte nötig:
# Telnet auf der Fritzbox freischalten (Tastenkombination #96*7* am angeschlossenen Telefon (auch FritzFon)
# TelnetUser definieren (wie im Screenshot gezeigt)
# Passwort zum Benutzer auf der Fritzbox definieren

[[Datei:Screenshot_FritzBox_Passwort.png|mini|300px|rechts|Passwort definieren]]

(bitte die Buttons {{Taste|set}} und {{Taste|attr}} bei der Definition der jeweiligen Einträge nicht vergessen)

Wer stattdessen lieber das [[Konfiguration|Befehl-Eingabefeld]] verwendet:

:<code>define FritzBox FRITZBOX</code>
:<code>attr FritzBox telnetUser ''Benutzername'' </code> - legt den Benutzer fest
:<code>set FritzBox password ''Passwort'' </code> - legt das zugehörige Passwort fest

Wer keinen User konfiguriert hat, kann das Feld "telnetUser" leer lassen.

Wer sicher gehen möchte, dass auch tatsächlich Telnet und nicht andere Zugriffe benutzt werden, sollte außerdem noch setzen:

:<code>attr FritzBox forceTelnetConnection 1</code>

=== mögliche Fehlermeldungen ===
Sollte schon bei <code>define FritzBox FRITZBOX</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte prüfen, ob FHEM auf dem aktuellen Stand ist und ggf. [[Update|aktualisieren]].

Kommt jetzt bei der erneuten Definition die Fehlermeldung <code>Error: Perl modul Net::Telnet is missing on this system</code> bitte wie oben schon erwähnt den Befehl
:<code>sudo apt-get install libnet-telnet-perl</code>
direkt per Telnet/SSH auf dem FHEM-Server ausführen und neu starten.
Sollte alles geklappt haben, seht ihr nun eure Fritzbox und könnt diverse Einstellungen manuell vornehmen und/oder automatisch vornehmen lassen.

== Anwendung ==
=== Define ===
Siehe {{Link2CmdRef|Lang=de|Anker=FRITZBOXdefine}}

=== Attribute ===
Siehe {{Link2CmdRef|Lang=de|Anker=FRITZBOXattr}}

=== TR-064 ===
Die offizielle Programmier-Schnittstelle der Fritz!Box läuft über das Protokoll TR-064.

mit dem Attribute 
<code>attr <device> allowTR064Command 1</code> 
kann man den Befehl 
<code>get <device> tr064Command <service> <control> <action> [[parameterName1 parameterValue1] ...]</code> 
freischalten und damit auf diese Schnittstelle zugreifen.

AVM hat die Schnittstellenbeschreibung unter [http://avm.de/service/schnittstellen/] veröffentlicht. Diese wird jedoch nur sehr sporadisch gepflegt. 
Ein besserer Einstiegspunkt befindet sich auf der Box unter http://fritz.box:49000/tr64desc.xml. 
Die möglichen TR-064-Aktionen kann man auch über den Befehl <code>get <device> tr064ServiceList</code> auslesen.

Folgende Service und Controls existieren (für den get-Befehl ''tr064Command'' werden nur die fett formatierten Wörter benötigt)

{| class="wikitable"
|-
!serviceType!!controlURL!!XML!!Dokument bei AVM
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceInfo:1'''||/upnp/control/'''deviceinfo'''||[http://fritz.box:49000/deviceinfoSCPD.xml deviceinfoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceinfoSCPD.pdf deviceinfoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceConfig:1'''||/upnp/control/'''deviceconfig'''||[http://fritz.box:49000/deviceconfigSCPD.xml deviceconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceconfigSCPD.pdf deviceconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Layer3Forwarding:1'''||/upnp/control/'''layer3forwarding'''||[http://fritz.box:49000//layer3forwardingSCPD.xml layer3forwardingSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/layer3forwardingSCPD.pdf layer3forwardingSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANConfigSecurity:1'''||/upnp/control/'''lanconfigsecurity'''||[http://fritz.box:49000//lanconfigsecuritySCPD.xml lanconfigsecuritySCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanconfigsecuritySCPD.pdf lanconfigsecuritySCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''ManagementServer:1'''||/upnp/control/'''mgmsrv'''||[http://fritz.box:49000//mgmsrvSCPD.xml mgmsrvSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/mgmsrvSCPD.pdf mgmsrvSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Time:1'''||/upnp/control/'''time'''||[http://fritz.box:49000//timeSCPD.xml timeSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/timeSCPD.pdf timeSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''UserInterface:1'''||/upnp/control/'''userif'''||[http://fritz.box:49000//userifSCPD.xml userifSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/userifSCPD.pdf userifSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_VoIP:1'''||/upnp/control/'''x_voip'''||[http://fritz.box:49000//x_voipSCPD.xml x_voipSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_voipSCPD.pdf x_voipSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Storage:1'''||/upnp/control/'''x_storage'''||[http://fritz.box:49000//x_storageSCPD.xml x_storageSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_storageSCPD.pdf x_storageSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_OnTel:1'''||/upnp/control/'''x_contact'''||[http://fritz.box:49000//x_contactSCPD.xml x_contactSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_contactSCPD.pdf x_contactSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_WebDAVClient:1'''||/upnp/control/'''x_webdav'''||[http://fritz.box:49000//x_webdavSCPD.xml x_webdavSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_webdavSCPD.pdf x_webdavSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_UPnP:1'''||/upnp/control/'''x_upnp'''||[http://fritz.box:49000//x_upnpSCPD.xml x_upnpSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_upnp.pdf x_upnp.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_RemoteAccess:1'''||/upnp/control/'''x_remote'''||[http://fritz.box:49000/x_remoteSCPD.xml x_remoteSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_remoteSCPD.pdf x_remoteSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_MyFritz:1'''||/upnp/control/'''x_myfritz'''||[http://fritz.box:49000/x_myfritzSCPD.xml x_myfritzSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_myfritzSCPD.pdf x_myfritzSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_TAM:1'''||/upnp/control/'''x_tam'''||[http://fritz.box:49000/x_tamSCPD.xml x_tamSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_tam.pdf x_tam.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_AppSetup:1'''||/upnp/control/'''x_appsetup'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_appsetupSCPD.pdf x_appsetupSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Homeauto:1'''||/upnp/control/'''x_homeauto'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_homeautoSCPD.pdf x_homeautoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:1'''||/upnp/control/'''wlanconfig1'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:2'''||/upnp/control/'''wlanconfig2'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:3'''||/upnp/control/'''wlanconfig3'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Hosts:1'''||/upnp/control/'''hosts'''||[http://fritz.box:49000/hostsSCPD.xml hostsSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/hostsSCPD.pdf hostsSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANEthernetInterfaceConfig:1'''||/upnp/control/'''lanethernetifcfg'''||[http://fritz.box:49000/lanifconfigSCPD.xml lanifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanifconfigSCPD.pdf lanifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANHostConfigManagement:1'''||/upnp/control/'''lanhostconfigmgm'''||[http://fritz.box:49000/lanhostconfigmgmSCPD.xml lanhostconfigmgmSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanhostconfigmgmSCPD.pdf lanhostconfigmgmSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANCommonInterfaceConfig:1'''||/upnp/control/'''wancommonifconfig1'''||[http://fritz.box:49000/wancommonifconfigSCPD.xml wancommonifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wancommonifconfigSCPD.pdf wancommonifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLInterfaceConfig:1'''||/upnp/control/'''wandslifconfig1'''||[http://fritz.box:49000/wandslifconfigSCPD.xml wandslifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandslifconfigSCPD.pdf wandslifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLLinkConfig:1'''||/upnp/control/'''wandsllinkconfig1'''||[http://fritz.box:49000/wandsllinkconfigSCPD.xml wandsllinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandsllinkconfigSCPD.pdf wandsllinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANEthernetLinkConfig:1'''||/upnp/control/'''wanethlinkconfig1'''||[http://fritz.box:49000/wanethlinkconfigSCPD.xml wanethlinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanethlinkconfigSCPD.pdf wanethlinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANPPPConnection:1'''||/upnp/control/'''wanpppconn1'''||[http://fritz.box:49000/wanpppconnSCPD.xml wanpppconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanpppconnSCPD.pdf wanpppconnSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANIPConnection:1'''||/upnp/control/'''wanipconnection1'''||[http://fritz.box:49000/wanipconnSCPD.xml wanipconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanipconnSCPD.pdf wanipconnSCPD.pdf]
|-
|}

=== Status-Symbol ===
<code>attr <device> devStateIcon .*on.*off:WLAN_on_gWLAN_off .*on.*on.*:WLAN_on_gWLAN_on WLAN..off.*:WLAN_off</code>

Im Verzeichnis www/images/default müssen die passenden Dateien "WLAN_on_gWLAN_off.png", "WLAN_on_gWLAN_on.png" und "WLAN_off.png" liegen. Wenn die PNGs fehlen, können sie {{Link2Forum|Topic=29725|Message=318113|LinkText=hier}} heruntergeladen werden.

== Anwendungsbeispiele ==
[[Datei:Screenshot_FritzBox1.png|mini|300px|rechts|FRITZBOX Gerät auf der FHEM Oberfläche]]
Sollte alles geklappt haben, seht ihr nun unter "Unsortiert" den im nebenstehenden Screenshot gezeigten Eintrag für das "Gerät" (hier mit dem Icon "it_router").

=== TR-064 Beispiele ===
*Box Reboot: <code>get <device> tr064Command DeviceConfig:1 deviceconfig Reboot</code>
*Internet Reconnect: <code>get <device> tr064Command WANIPConnection:1 wanipconnection1 ForceTermination</code>
*Daten eines Smart-Home-Gerätes auslesen: <code>get <device> tr064Command X_AVM-DE_Homeauto:1 x_homeauto GetGenericDeviceInfos NewIndex 0</code>

=== Klingel- und Sprachausgabe per TR-064 ===
Das geht derzeit nicht, da entsprechende Kommandos per TR-064 nicht verfügbar sind. Da Telnet sukzessive abgestellt wird, sollten sich Interessenten per Feature-Request an AVM wenden, wie {{Link2Forum|Topic=38586|LinkText=hier}} beschrieben.

Eine Alternative um Telefone klingeln zu lassen, ist die Nutzung des [[SIP-Client]]s.

=== Anwesenheitserkennung per regelmäßiger Abfrage über das PRESENCE Modul ===
Fritzboxen und die FRITZ!WLAN Repeater speichern den Status angemeldeter Geräte. Dieser Status lässt sich mittels des FRITZBOX Moduls über Readings abfragen, die das Format mac_AA_AA_AA_AA_AA_AA haben und die MAC-Adressen der jeweils angemeldeten Geräte (AA:AA:AA:AA:AA:AA) enthalten. Das Reading existiert, wenn das Gerät angemeldet ist. Wenn das Gerät abgemeldet ist, existiert es nicht mehr. Es gibt auch noch den Zwischenstatus "inactive", der anscheinend gesetzt wird, bevor das Reading gelöscht wird.

Mit Hilfe des [[PRESENCE]] Moduls (vgl. [[Anwesenheitserkennung]]) kann man auf diese Weise den Anwesenheitsstatus abfragen. Anregungen dazu gibt es im zugehörigen {{Link2Forum|Topic=39433|LinkText=Forenthread}} zur Anwesenheitserkennung und in [http://heinz-otto.blogspot.de/2015/07/die-zeiten-andern-sich.html diesem Blogpost]. Auf dieser Basis könnte eine einfache Implementierung zum Beispiel so aussehen:

Funktion in [[99_myUtils anlegen|99_myUtils]]:

<syntaxhighlight lang='perl'>sub checkFritzMACpresent($$) {
# Benötigt: Name der zu testenden Fritzbox ($Device),
# zu suchende MAC ($MAC),
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($Device, $MAC) = @_;
my $Status = 0;
$MAC =~ tr/:/_/;
$MAC = "mac_".uc($MAC);
my $StatusFritz = ReadingsVal($Device, $MAC, "weg");
if ($StatusFritz eq "weg") {
Log 1, ("checkFritzMACpresent ($Device): $MAC nicht gefunden, abwesend.");
$Status = 0;
} elsif ($StatusFritz eq "inactive") {
Log 1, ("checkFritzMACpresent ($Device): $MAC ist >inactive<, also abwesend.");
$Status = 0;
} else {
# Reading existiert, Rückgabewert ist nicht "inactive", also ist das Gerät per WLAN angemeldet.
Log 4, ("checkFritzMACpresent ($Device): $MAC gefunden, Gerät heißt >$StatusFritz<.");
$Status = 1;
}
return $Status
}
</syntaxhighlight>

Nutzung dieser Funktion mit dem PRESENCE Modul definieren:
:<code>define <Name> PRESENCE function {checkFritzMACpresent("Fritzbox","AA:BB:CC:DD:EE:FF")} 60 60</code>
wobei
*<Name> ein beliebig zu wählender Name für die PRESENCE-Funktion ist,
*Fritzbox der Name ist, mit dem ihr die abzufragende Fritzbox als FRITZBOX definiert habt,
*AA:BB:CC:DD:EE:FF die MAC-Adresse des gesuchten Geräts ist.
* "60 60" sagt, dass der Anwesenheitsstatus im 60-Sekunden-Takt abgefragt wird. Das macht natürlich nur Sinn, wenn ihr mit <code>attr Fritzbox INTERVAL 60</code> den Abfrageinterval bei der Fritzbox auch entsprechend hochgesetzt habt. Der Standard ist 300.
* "Log 1" führt immer zum Loggen. Das ist zum Einrichten praktisch, ohne dass man gleich für das ganze Modul oder ganz FHEM <code>attr <device> verbose 5</code> setzen muss. Wenn es läuft, können die "Log 1"-Zeilen gelöscht, auskommentiert (# an den Zeilenanfang) oder in "Log 5" geändert werden.

=== Anwesenheitserkennung über mehrere Fritzboxen oder AVM Repeater und Fritzbox ===
Existiert ein AVM Repeater im Netzwerk, kann der als eigenständiges Gerät mit FRITZBOX definiert werden. WLAN Geräte an der Fritzbox werden in der Instanz der Fritzbox gelistet und WLAN Geräte am Repeater in der Repeater Instanz. Um trotzdem die Anwesenheit im Netzwerk einfach zu erkennen, muss die Subroutine in 99_myUtils.pm abgewandelt werden.

Existiert eine zweite Fritzbox im Accesspointmodus, werden die WLAN Geräte im Netzwerk alle in der Hauptfritzbox an einem LAN Anschluss gelistet. D.h. man sieht an der Hauptfritzbox nicht, dass sie im WLAN sind. Eine zweite Instanz mit dem FRITZBOX Modul muss wegen der Anwesenheitserkennung nicht gemacht werden. Die folgende Routine kann aber universell eingesetzt werden, unabhängig von der Anzahl der FRITZBOX Instanzen. Wer mitloggen will, kann das analog zur obigen Routine einbauen

<syntaxhighlight lang='perl'>sub checkAllFritzMACpresent($) {
# Benötigt: nur die zu suchende MAC ($MAC),
# Es werden alle Instanzen vom Type FRITZBOX abgefragt
#
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($MAC) = @_;
# Wird in keiner Instanz die MAC Adresse gefunden bleibt der Status 0
my $Status = 0;
$MAC =~ tr/:/_/;
$MAC = "mac_".uc($MAC);
my @FBS = devspec2array("TYPE=FRITZBOX");
foreach( @FBS ) {
my $StatusFritz = ReadingsVal($_, $MAC, "weg");
if ($StatusFritz eq "weg") {
} elsif ($StatusFritz eq "inactive") {
} else {
# Reading existiert, Rückgabewert ist nicht "inactive", also ist das Gerät am Netzwerk angemeldet.
$Status = 1;
}
}
return $Status
}
</syntaxhighlight>

Da hiermit nach allen Instanzen mit dem TYPE=FRITZBOX durchsucht wird, braucht der Name der Fritzbox nicht angegeben werden.

:<code>define <Name> PRESENCE function {checkAllFritzMACpresent("AA:BB:CC:DD:EE:FF")} 60 60</code>

Die Abfrage auf einen bestimmten Status kann einfach erweitert werden, ist aber immer vom Entwicklunsgstand der Fritzbox Firmware und des FRITZBOX Moduls abhängig. Eventuell erreicht man bessere Reaktionszeiten auf Abwesenheit durch diesen Zusatz:
<syntaxhighlight lang='perl'>my $StatusFritz = ReadingsVal($_, $MAC, "weg");
if ($StatusFritz eq "weg") {
} elsif ($StatusFritz eq "inactive") {
} elsif ($StatusFritz =~ /(.*)s, 0/) {
# Dieser Zweig testet auf "<geraetename> (WLAN, 0 / 0 Mbit/s, 0)"
} else {
$Status = 1;
}
</syntaxhighlight>

Weitere Hinweise zu komplexeren Abfragen mehrere Boxen auf einmal etc. findet ihr auch im diesem {{Link2Forum|Topic=39433|LinkText=Forenthread}}.

=== Anwesenheitserkennung per Notify ===
Der von Fritzboxen und Fritz!WLAN Repeatern gespeicherte Status zum Status angemeldeter Geräte lässt sich (statt per PRESENCE, s.o.) auch per [[notify]] anfragen:

<syntaxhighlight lang="perl">define <Name> notify Fritzbox:mac_AA_BB_CC_DD_EE_FF:.* {
if (ReadingsVal("Fritzbox", "mac_AA_BB_CC_DD_EE_FF", "inactive") eq "inactive")
{
fhem("set anwesend_smartphone absent");
}
else
{
fhem("set anwesend_smartphone present");
}
}</syntaxhighlight>

Hinweise:
* <code>fhem("set anwesend_smartphone absent");</code> ist nur ein Beispiel, das einen Dummy auf den Status "absent" bzw. "present" setzt. Man kann hier natürlich auch gleich entsprechende Aktionen durchführen. Wer das Beispiel übernehmen möchte, sollte den Dummy vorher definieren (<code>define anwesend_smartphone dummy</code>).
* mac_AA_BB_CC_DD_EE_FF ist die MAC-Adresse des gesuchten Geräts.
* "Fritzbox" ist der Name, unter dem die Fritzbox als FRITZBOX-Modul definiert wurde.
* Das Notify funktioniert, weil Geräte, wenn sie sich abgemeldet haben, erst den Status "inactive" erhalten. Ist das Gerät ganz abgemeldet, verschwindet das mac_.*-Reading. Dabei löst das Notify nicht mehr aus. Da das mac-.*-Reading aber vorher auf "inactive" stand, wurde die Abwesend-Aktion schon ausgeführt.
* Damit der Notify nicht andauernd losgeht, sollte man mittels <code>attr Fritzbox [[event-on-change-reading]] mac_AA_BB_CC_DD_EE_FF</code> Events nur auslösen, wenn sich der Status des Gerätes ändert. Will man mehrere Geräte abfragen, sollte man <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF,mac_GG_HH_II_JJ_KK_LL</code> setzen, damit bei der Änderung jedes Readings ein Event ausgelöst wird.

=== Vergleich Anwesenheitserkennung PRESENCE/Notify ===
Die Anwesenheitserkennung per regelmäßiger PRESENCE-Abfrage hat den Vorteil, dass sie im Turnus der regelmäßigen Abfragen immer einen aktuellen Status produziert. Sie hat dafür den Nachteil, dass die PRESENCE-Funktionen regelmäßig abgearbeitet werden müssen, auch wenn sich gar nichts ändert. Außerdem aktualisiert sich der Status nicht sofort, sondern erst bei der nächsten regelmäßigen Abfrage. Durch häufiges Abfragen kann dieser Nachteil verringert werden (bei entsprechend höherer Systemlast).

Die Anwesenheitserkennung per Notify hat den Vorteil, dass ein sich ändernder Status sofort abgebildet wird. Ändert sich kein Status, werden keine Routinen ausgeführt, was die Systemlast gering hält. Der Nachteil ist, dass - z.B. nach einem Systemstart - die entsprechende Aktion erst bei einer Änderung des Status ausgeführt wird. D.h. ist das zu testende Gerät anwesend, wird dann FHEM beendet, das Gerät entfernt und FHEM wieder gestartet, ist der Status in FHEM immer noch "anwesend". Da das Reading für das Gerät nicht existiert, wird darauf auch erst wieder ein Notify ausgeführt, wenn sich der Status des Geräts wieder ändert, d.h. es wieder ankommt. Bis dahin ist der Status im System falsch.
Der Nachteil des Notify kann verringert werden, wenn man statt <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF</code> ein <code>attr Fritzbox [[event-on-update-reading]] mac_AA_BB_CC_DD_EE_FF</code> setzt. Das erhöht allerdings die Systemlast und funktioniert auch nur für den Status "anwesend". Bei "abwesend" ist kein Reading vorhanden, so dass auch event-on-update-reading nicht ausgeführt wird.
Eine weitere Möglichkeit, den Nachteil der Notify-Methode auszugleichen, ist, die Statusabfrage beim Systemstart einmal manuell auszuführen, durch ein notify auf "GLOBAL:initialized":
<syntaxhighlight lang="perl">
global:INITIALIZED {
Reset_Variables;
if (ReadingsVal("Fritzbox", "mac_AA_BB_CC_DD_EE_FF", "inactive") eq "inactive") {
fhem("set anwesend_smartphone absent");
} else {
fhem("set anwesend_smartphone present");
}
}
</syntaxhighlight>
Das hilft allerdings nur beim Systemstart. Nicht, wenn FHEM aufgrund irgendwelcher Hänger eine Aktualisierung des Status verpasst hat.

=== userReadings per ''get tr064Command'' oder ''get luaQuery'' ===
Um dem Gerätewert <userReadingName> den Wert von <VariabelName> aus der Rückgabe des get-Befehls ''tr064Command'' oder ''luaQuery'' zuzuordnen
<pre>
attr <device> userReadings <userReadingName> {my $resp=fhem("get <device> tr064Command <service> <control> <action> [[<argName1> <argValue1>] ...]",1);;$resp =~/\'<VariabelName>\' => '(.*)'/;;return $1;;}
</pre>
Beispielsweise
<pre>attr Fritzbox userReadings urMobilteil_1 {my $resp=fhem("get Fritzbox tr064Command X_AVM-DE_OnTel:1 x_contact GetDECTHandsetInfo NewDectID 1",1);;$resp =~/'NewHandsetName' => '(.*)'/;;return $1;;},
urDownstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewDownstreamCurrRate' => '(.*)'/;;return $1;;},
urUpstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewUpstreamCurrRate' => '(.*)'/;;return $1;;}</pre>
oder bei einzelnen Werte über ''get luaQuery''<pre>attr Fritzbox userReadings sip1_connect {my $resp=fhem("get Fritzbox luaQuery sip:settings/sip1/connect",1);;$resp =~/([0-9])$/;;return $1;;}</pre>

=== Klingelton-Einstellung und Abspielen von Sprachnachrichten bei Fritz!OS-Versionen >6.24 ===
Wenn die Fritzbox weder die Telnet- noch die webcmd-Schnittstelle hat, kann der Klingelton der Fritz!Fons nicht mehr verstellt und auch keine Sprachnachricht über ein Fritz!Fon ausgegeben werden.

Es gibt eine Behelfslösung über das Attribut ''useGuiHack''. Dadurch wird eine Eingabe in die WebGUI der Fritzbox simuliert.

'''ACHTUNG''': Vor allem nach einem Update der FritzBox kann es durch dieses Attribut zu ungewolltem Verstellen von Werten in der Fritzbox kommen.

Bei Verwendung der ring-Parameter "play:" und "say:" wird die abzuspielende URL in die M3U-Datei, die unter dem Internal ''M3U_LOCAL'' steht, eingetragen. 
Standardmäßig wird versucht, diese Datei im image-Verzeichnis von FHEM abzulegen. Diese kann dann vom Fritz!Fon über [[FHEMWEB]] abgespielt werden (IP-Freigaben beachten). Direkt nach dem ersten Anlegen der m3u-Datei kennt [[FHEMWEB]] diese noch nicht, daher bitte entweder ''set <webdevice> rereadicons'' ausführen oder FHEM neu starten. 

Aufgrund der Beschränkungen von [[FHEMWEB]] oder auch bei Authentifizierungsanforderungen ist es empfehlenswert, die Datei über das Attribute ''m3uFileLocal'' selber vorzugeben. Am besten auf einem Webserver, der auf dem FHEM-Server läuft und dessen Seiten-Verzeichnis durch FHEM beschreibbar ist. 
Beispiel: <code>attr Fritzbox m3uFileLocal /var/www/mp3/Fritzbox.m3u</code>

In dem Radioeintrag ''FHEM'' muss dann '''auf der FritzBox''', die '''Web'''-Adresse der entsprechenden Datei eingetragen werden. Dieser Sender sollte zu Testzwecken dann auch einmal am Fritz!Fon von Hand gestartet werden. 
Das Modul versucht, beim Start die einzutragende Radio-URL im image-Verzeichnis selber zu ermitteln (IP-Freigabe beachten). Gelingt dies, so steht diese im Internal ''M3U_URL''.

=== Ring auf mehreren Telefonen gleichzeitig ===

Damit mehrere Telefone per ring gleichzeitig Klingel, muss in der Fritzbox eine Rufgruppe definiert werden.
Sollte eine Türsprechanlage schon in Benutzung sein, kann die eventuell hierfür bereits eingerichtete Gruppe verwendet werden.
Das anlegen der Gruppe erfolgt wie in folgender AVM Anleitung erledigt werden. [http://http://avm.de/service/fritzbox/fritzbox-7390/wissensdatenbank/publication/show/1148_Interne-Rufgruppe-in-FRITZ-Box-einrichten-Gruppenruf/ AVM Interne Rufgruppe anlegen]

Es muss eine Kurzwahl bei der Gruppe zwingend hinterlegt sein.
Danach kann mit folgendem Beispiel Code gearbeitet werden:

<code>set FritzBox ring 791 15 show:Türklingel</code>

Name des Devices, Rufgruppen Nummer, Länge und gezeigter Text auf das gewünschte anpassen.

== Bekannte Probleme / Fehlersuche ==
=== Fehler nach Firmware Update ===
Typischer Fehler ist hier "Error: 403 Forbidden".
Nach einem Firmwareupdate der Fritzbox am besten auch FHEM neu starten.

=== Modul bleibt im Status "Check APIs" hängen===
Im Log steht die Meldung: "Error: Timeout when reading Fritz!Box data.".

Mögliche Ursache: Nutzung des FHEM-Befehls [[FHEM_Command_Beispiele#rereadcfg|rereadcfg]]. Dieser verträgt sich nicht mit dem Modul "blocking.pm", das für parallel laufende FHEM-Prozesse genutzt wird.

Abhilfe schafft ein Neustart <code>shutdown restart</code> oder das Einfügen eines zusätzlichen, lokalen Telnet-Ports z.B. durch <code>define tPortLocal telnet 7073</code>

=== Nachtschaltung Doppel-WLAN ===
Beim Abschalten des WLAN über das Modul wird (über TR064) zuerst das 2.4 GHz und dann das 5 GHz WLAN ausgeschaltet. Bei der gleichzeitigen Nutzung der WLAN-Nachtschaltung (Anschalten über das Fritz!OS) wird dann jedoch nur noch das 5 GHz WLAN wieder angeschaltet. Die Box interpretiert den TR064-Befehl anscheinend als ein komplettes Abwählen des 2.4 GHz WLAN.

Abhilfe schafft hier nur ein notify auf das 5 GHz WLAN mit einem nachträglichem Anschalten des 2.4 GHz WLAN.

Alternativ kann das Ausschalten des WLANs nicht direkt über TR064-Kommandos, sondern über einen indirekten Weg erfolgen: über TR064 ein set call abzusetzen und hier den Tastencode zum Ausschalten des WLANs einzugeben, bei einer FritzBox 7490 wäre dies z. B. #96*0*.
Schaltet man über diese Methode das WLAN aus, kann es über die Nachtschaltung wieder automatisch auf beiden Frequenzen angeschaltet werden.

=== Kabelboxen ===
Bei Fritz!Boxen für den Kabelanschluss (z.B. Kabel Deutschland) scheint neben Telnet auch die TR064-API nicht zu funktionieren. Vermutlich wurde die API von AVM auf Betreiberwunsch deaktiviert, da man sonst Dinge ändern kann, die das gesamte Kabelnetz stören können.

Zumindest für Unitymedia und einer FRITZ!Box 6490 Cable (lgi) mit FRITZ!OS:06.50 funktioniert TR064.

Eine Rufumleitung bei Abwesenheit (Modul PRESENCE) funktioniert mit einer vorher eingerichten Telefonnummer wie folgt:
<code>define Rufumleitung DOIF ([Anwesenheit.dum:state] eq "off") (set FritzBox6490 diversity 1 on) DOELSEIF ([Anwesenheit.dum:state] eq "on") (set FritzBox6490 diversity 1 off)</code>

=== Wenn's nicht klingelt ===
Das Klingeln erfolgt über die Wählhilfe. Eventuell muss über die Weboberfläche der Fritz!Box ein anderer Port eingestellt werden. Der aktuelle steht in "box_stdDialPort".

=== TR064-Transport-Error: 500 Can't connect to ...:49443 (certificate verify failed) ===
Eventuell hilft es, die Perl Module Net::HTTPS, Net::SSL und IO::Socket::SSL zu aktualisieren.

=== "Error: Old SID not valid anymore." nach Erlauben von IPv6 auf der Fritzbox ===
Ohne hier den genauen Grund zu kennen - es hilft die Angabe der IPv4-Adresse: also statt <code>define FritzBox FRITZBOX</code> dann <code>define FritzBox FRITZBOX <IP></code> (z.B. <code>define FritzBox FRITZBOX 192.168.10.1</code>), so dass das Modul nicht über IPv6 geht.

=== "Didn't get a session ID" ===
Bei gleichzeitiger Nutzung anderer Modul für die Fritzbox (z.B. {{Link2CmdRef|Anker=FBAHAHTTP|Lang=en|Label=FBAHAHTTP}}) muss der Zugang über Benutzername und Password erfolgen. 
:<code>attr <DEVICE> boxUser <USER></code>
Da das FRITZBOX-Modul eine inoffizielle Schnittstelle benutzt, muss dann auch der normale Zugang zur Box auf "Benutzername und Password" eingestellt sein. 
In der Firmware 6.92 wird der Zugang über die Menüs "System"->"Fritz!Box-Benutzer"->"Anmeldung im Heimnetz" eingestellt.

Oft wird aber auch ein falsches oder gar kein Passwort gesetzt.

:<code>set <DEVICE> password <PASSWORD></code>

=== TR064-Error 401:invalid action ===
Eventuell ist auf der Fritzbox ein Benutzer gesetzt und im Modul nicht korrekt angegeben bzw. mit falschen Rechten versehen (attribut boxUser).

== Links ==
* {{Link2Forum|Topic=29725|LinkText=Forenthread}} zu diesem Modul

[[Kategorie:FritzBox]]

TelegramBot

2018-10-21T15:39:31Z

Topos: /* Hinweise zum Betrieb mit FHEM */ Versenden einer ersten Nachricht an den Bot erklärt.

{{Infobox Modul
|ModPurpose=Senden und Empfangen von Nachrichten (Text und Fotos) mit dem freien Messagingdienst Telegram
|ModType=d
|ModForumArea=Unterstützende Dienste
|ModFTopic=38328
|ModTechName=[https://github.com/viegener/Telegram-fhem/blob/master/50_TelegramBot.pm 50_TelegramBot.pm]
|ModOwner=[[Benutzer:Viegener|Viegener]] ({{Link2FU|12772|Forum}} / [[Benutzer Diskussion:Viegener|Wiki]])}}

Das [[TelegramBot]]-Modul ermöglicht das Senden und Empfangen von Nachrichten über den Telegram-instant messaging Dienst (https://telegram.org/).
Es entsteht eine Möglichkeit Benachrichtungen aus FHEM zu versenden, zum Beispiel Alarmmeldungen.
Ausserdem können auch Kommandos über Telegram an FHEM gesendet werden um Steuerungsbefehle in FHEM auszulösen.

Das TelegramBot-Modul benötigt keine Zusatzsoftware auf dem FHEM-Server (anders als die Variante [[Telegram]]), sondern verwendet das [https://core.telegram.org/bots/api TelegramBot-API] über https-Aufrufe. Es muss jedoch das [http://www.fhemwiki.de/wiki/Raspberry_Pi#N.C3.BCtzliche_Zusatzpakete perl JSON modul] installiert sein.

== Über Telegram Instant Messaging ==
Telegram-IDs und Versand/Empfang von Nachrichten sind kostenfrei.
Clients sind für gängige Smartphonesysteme erhältlich (iOS iPhone und Tablet, Android, Windows Phone) und
können auch aus dem WebBrowser verwendet werden.
Es gibt auch einen Kommandozeilen-Client für Linux, der die Grundlage dieses Moduls darstellt.
Mehrfachanmeldungen, auch parallel mit verschiedenen Geräten (z.B. Tablet und Smartphone), sind möglich.
Gruppenchats und Chats mit End-2-End-Verschlüsselung werden ebenfalls unterstützt.

Für die Unterstützung von ''WhatsApp'' siehe Modul [[yowsup]].

== Features ==
Unterstützt werden:

* Versand von Textnachrichten
* Versand und Empfang von Bildern/Audio/etc
* Empfang von Textnachrichten von beliebigen Kontakten
* Kommandos in FHEM über Telegram-Nachrichten von aussen auslösen
* Ergebnisse der Kommandos zusenden lassen

Eine detaillierte Beschreibung des Moduls ist im FHEM Forum und in der (englischen) Dokumentation zum Modul in der {{Link2CmdRef|Anker=TelegramBot}} und in diesem {{Link2Forum|Topic=38328|LinkText=Diskussionsthread}} zu finden. Seit Oktober 2015 wird das Modul offiziell über FHEM-Update verteilt.

Die jeweils aktuellste Entwicklungs-Version des Moduls ist in Github [https://github.com/viegener/Telegram-fhem/blob/master/50_TelegramBot.pm 50_TelegramBot.pm] verfügbar.

== Hinweise zum Betrieb mit FHEM ==
{{Randnotiz|RNTyp=Info|RNText=Achtung: Dieses Authtoken ist die einzige Authentifizierung für den Bot und sollte deshalb nicht aus der Hand gegeben werden. Die verwendeten Urls sind deshalb auch in den Log-Files nicht enthalten, da diese das Authtoken in Klartext enthalten. Auch im Forum sollte dieses Token nicht aufgenommen werden.
}}

Für die Anlage eines TelegramBot Devices in FHEM ist ein Authtoken erforderlich. Dieses Token wird über Anlegen eines neuen Bots im [https://core.telegram.org/bots#botfather BotFather] erzeugt. Dafür muss der BotFather mit einem Telegram-Client kontaktiert werden. Dort mit dem Telegram-Befehl <code>/newbot</code> einen neuen Bot anlegen und mit einem Namen versehen. Hinweis: Die Namen für Bots müssen auf "Bot" enden. 

Das Anlegen eines TelegramBot devices erfolgt durch die Angabe dieses Tokens:

<code>define <name> TelegramBot <token> </code>

Beispiel: <code>define teleBot TelegramBot 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw</code>

'''Das Empfangen von Nachrichten (polling) erfordert die Einstellung des Attributes'''
<code>pollingTimeout</code> '''auf einen Wert der grösser als Null ist. Beim Wert 0 oder ohne Setzen des Attributes findet kein Polling und damit auch kein Empfang statt.'''

Beispiel: <code>attr teleBot pollingTimeout 120</code>

'''Der TelegramBot kann erst dann Nachrichten an einen telegram user schicken, wenn dieser zuerst an den telegram bot eine Nachricht gesendet hat.'''
Dafür muss man in seinem Telegram-Client den Kontakt @botName suchen und dann eine Nachricht darn versenden.

{{Randnotiz|RNTyp=Info|RNText=TelegramBot setzt eine aktuelle Version von FHEM voraus, insbesondere Versionen weit vor der Umstellung auf 5.7 (also vor Herbst 2015) können mit einem TelegramBot-Modul nicht funktionieren, da insbesondere das HTTPSRV-Modul dann veraltet ist. Am besten auch den TelegramBot über den offiziellen Update mit dem Rest von FHEM installieren/aktualisieren.
}}

== Registrierung eines neuen Bot ==
Zur Registrierung wird ein funktionierender Telegram-Client (egal ob Web, App oder Programm)benötigt. Hier wird ein Chat zum BotFather gestartet und der Befehl /newbot gesendet. Nun fragt der BotFather die benötigten Angaben ab und liefert am Ende des Dialogs die Informationen für den neuen Bot.
Hier ein Beispiel, wie so ein Chat aussehen könnte:
<pre>Client:
/newbot
----------------
BotFather:
Alright, a new bot. How are we going to call it? Please choose a name for your bot.
----------------
Client:
Mein Name
----------------
BotFather:
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
----------------
Client:
fhem_bot
----------------
BotFather:
Sorry, this username is already taken. Think of something different.
----------------
Client:
fhem1234_bot
----------------
BotFather:
Done! Congratulations on your new bot.
You will find it at telegram.me/fhem1234_bot.
You can now add a description, about section and profile picture for your bot, see /help for a list of commands.
----------------
Use this token to access the HTTP API:
1234567890:AbCdefgHIJklmnOPQRst-uvwxyz

For a description of the Bot API, see this page: https://core.telegram.org/bots/api
</pre>
Um einen Chat an einen "Contact" versenden zu können, muss zuerst in Contacts (bei Readings) ein Kontakt auftauchen. Wenn man sich zum allerersten Mal bei Telegram angemeldet hat, gibt es noch keinen Chat mit irgendjemanden. Man muss sich zuerstmal selbst eine Nachricht im Smartphone zusenden, dann taucht unter Readings der Eintrag Contacts auf. Erst dann kann man eine Nachricht mit @msgPeerId (das ist Ziffernfolge des Contacts ) oder mit @msgPeer (das ist der Name nach dem Doppelpunkt) vom TelegramBot auf sein Smartphone senden.

== Tipps ==

=== Privacyeinstellungen ===

Damit der TelegramBot auch Meldungen in Gruppen sieht, müssen über den BotFather die Privacy-Einstellungen geändert werden. Beispielchat:<pre>Client:
/setprivacy
----------------
BotFather:
Choose a bot to change group messages settings.
----------------
Client:
@fhem1234_bot
----------------
BotFather:
'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username.
'Disable' - your bot will receive all messages that people send to groups.
Current status is: ENABLED
----------------
Client:
Disable
----------------
BotFather:
Success! The new status is: DISABLED. /help</pre>

=== Kontakte ===

Der Bot merkt sich die bereits bekannten Kontakte im Reading <code>Contacts</code>. Dabei werden die einzelnen Kontakte jeweils als 3-teilige Einträge bestehend aus UserID, Vor- und Nachname des Benutzers (mit _ verbunden) und dem Username (mit vorangestelltem @).

Beispiel: <code>123456:Ralf_Mustermann:@ralf</code>

Verschiedene Einträge werden durch Leerzeichen getrennt.

Man kann die Kontakte auch manuell überschreiben (z.B. wenn das Reading fehlerhaft oder verloren sein sollte). Dazu gibt es den Set-Befehl <code>replaceContacts</code>. Dieser nimmt die Kontakte ebenfalls in der gleichen Form wie oben beschrieben entgegen.

Die Kontaktliste wird ansonsten nur durch den Empfang von Nachrichten erweitert, da es im TelegramBot-API keine Möglichkeit gibt Kontaktdaten von Telegram abzufragen (siehe auch pollingTimeout)

=== Reset ===

Es ist möglich den Bot im laufenden Betrieb zurückzusetzen (Set-Befehl <code>reset</code>). Dabei werden noch nicht abgeschlossene Übetragungen entfernt und die internen Zustände des Devices zurückgesetzt.

=== Gruppen ===

Um eine Nachricht von FHEM an eine Gruppe zu senden, muss der BOT in die Gruppe aufgenommen werden. Nach dem Senden einer Nachricht an die Gruppe kann im Modul die Gruppen-ID ermittelt werden und zum Senden von Nachrichten verwendet werden. Wenn die Privacy-Einstellungen nicht auf 'Disabled' gesetzt wurden, muss die Nachricht mit einem Slash (/) beginnen.

==== Supergroups / Supergruppen ====

Auch die neuen Supergruppen werden mit dem Bot unterstützt, es ist allerdings zu beachten, dass bei der Umwandlung einer Gruppe in eine Supergruppe eine neue ID in den Kontakten von Telegram vergeben wird. Wenn man also wie empfohlen IDs zur Identifikation von Benutzern einsetzt, muss entsprechend angepasst werden.

== Beispielszenarien ==

=== Benachrichtigungen über Ereignisse ===

Das einfachste Szenario für die Integration von Messaging-Diensten mit FHEM ist zur Benachrichtigung über Ereignisse. Diese Funktion kann zum Beispiel verwendet werden, um über einen erfolgten Neustart von FHEM zu informieren:

<code>define notify_fhem_reload notify global:INITIALIZED set telebotdevice message fhem newly started - just now !</code>

In diesem Beispiel wird der Nachrichtentext "fhem newly started - just now !" an den als default eingestellten Kontakt (Attribut: defaultPeer) gesendet, sobald FHEM neu gestartet wurde. Natürlich kann man auch beliebige andere Benachrichtigungen einführen.

=== Versand von Bildern ===

Es ist auch möglich Bilder auf dem FHEM-Server, die zum Beispiel von einer Kamera oder einem Wettermodul stammen über Telegram zu versenden. So wäre es z.B. möglich jeweils morgens die aktuelle Wetterkarte zu erhalten.

ACHTUNG: TelegramBot verwendet das HTTPUtils-Modul zur Kommunikation mit dem TelegramBot-API. Erst mit der Version, die seit 22.10.2015
([r9576] HttpUtils.pm: Async write for POST Requests {{Link2Forum|Topic=41583|LinkText=FHEM-Forum}}) verteilt wird, erlaubt auch den Transfer grösserer Bilder. Die Grenze liegt ansonsten bei ca. 14kb auf Raspberries (Plattformspezifische Grenze).

<code>define notify_fhem_reload notify wetter:report set telebotdevice sendImage /opt/fhem/wetter.jpg</code>

Bei Erreichen des entsprechenden Status am Wetter-Modul wird ein Image über Telegram versendet. Hier sind lokale Pfade (relativ zu fhem) oder absolute Pfade wie oben möglich.

=== Versand von SVG-Plots ===

SVG-Plots können mit dem Befehl
<code>cmdSend [ @<peer1> ... @<peerN> ] <fhem command></code>
verschickt werden.

Das angegebene FHEM-Kommando wird ausgeführt und das Ergebnis an die angegebenen Peers bzw. den Standard-Peer verschickt.

Mit dem folgenden Befehl wird der SVG-Plot SVG_FileLog_Aussen an den Standard-Peer geschickt:
<code>set mein_telegramBot cmdSend { plotAsPng('SVG_FileLog_Aussen') }</code>

Nach <code>define cmd_sendTelegramSVG cmdalias TGSVG .* AS set mein_telegramBot cmdSend { plotAsPng("$EVENT") }</code>
kann man mit einem kurzen
<code>TGSVG SVG_Garten</code>
ein beliebiges SVG über die Kommandozeile per Telegram versenden.

Um das SVG nun noch mit einem Text zu versehen, muss eine Textnachricht dazu gesendet werden, was sich am einfachsten durch das Ausführen eines FHEM-Befehls auf Perl-Ebene realisieren lässt:

<code>{fhem "set mein_telegramBot message Bildbeschreibung;; set mein_telegramBot cmdSend { plotAsPng('mein_SVG') }" }</code>

'''Hinweis:''' früher wurde zum Verschicken von Plots auch die interne Funktion TelegramBot_ExecuteCommand verwendet; mit dem Update Ende Februar 2017 hat diese Funktion einen zusätzlichen Parameter erhalten und lautet nun
<code>TelegramBot_ExecuteCommand($defs{"mein_telegramBot"}, meine_ZielID, undef, '{plotAsPng("mein_SVG")}');</code>

==== Voraussetzungen für den Versand von SVG-Plots ====
Es muss das Modul libimage-librsvg-perl installiert sein:

<code>sudo apt-get install libimage-librsvg-perl</code>

Evtl. sind weitere Module erforderlich:

<code>sudo apt-get install libgd-graph-perl

sudo apt-get install libgd-text-perl</code>

=== Empfang von Bildern oder ähnlichem ===

Beim Empfang von Bildern wird zuerst nur eine ID vom Telegram-Server empfangen, diese befindet sich im Reading <code>msgFileId</code> angelegt (<code>123456:xxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxx</code>) und im Reading <code>msgText</code> steht dann so etwas wie
<code>received photo # Size: 107701</code>

Über das Get-Kommando <code>urlForFile</code> mit der ID aus dem msgFileId Reading lässt sich dann daraus ein URL ableiten, der dann zur eigentlichen Datei führt:

<code>https://api.telegram.org/file/bot123456:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/photo/file_25.jpg</code>

=== Versand von Emojis (Smileys) ===

Es ist auch möglich Emojis mit den (Text-)Nachrichten zu versenden. Die entsprechenden (Unicode-)Zeichen werden einfach direkt mit in den Text der Nachricht aufgenommen. Um das zu vereinfachen kann man das einfach per Copy und Paste von dieser Seite

http://apps.timwhitlock.info/emoji/tables/unicode (Spalte "Native")

übernehmen und mit der Nachricht verschicken.

Die Emojis können auch empfangen werden und werden so auch in FHEM / FHEMWeb angezeigt. Plattformspezifische (z.B. von iOS oder Android) Emojis werden dabei nicht unterstützt (gerade mit iOS sind viele neue farbige Emojis hinzugekommen, die wohl leider nur auf Apple-devices funktionieren).

=== Kommandos auslösen ===

Ein wichtiges Szenario ist die Möglichkeit Kommandos in FHEM ausführen zu können, ohne einen Zugang durch die Firewall einrichten zu müssen. Dazu ist die Definition eines Schlüsselwortes (Attribut: "cmdKeyword")erforderlich, mit dem man die Nachrichten beginnen muss, damit der TelegramBot die Kommandos erkennt.

<code>attr telebotdevice cmdKeyword doit</code>

Somit kann man dann durch Nachrichten die mit "doit" beginnen Kommandos an FHEM senden, die ähnlich wie im Kommandoeingabefeld von FHEMweb dann von FHEM ausgeführt werden. Das Ergebnis der Ausführung wird zurück an den Sender (und an den definierten defaultPeer) geschickt.

Somit können nicht nur Aktionen angestossen werden, sondern auch Infos abgefragt werden.

Beispiele

<code>doit set schalter on</code>

<code>doit list telegrambot</code>

{{Randnotiz|RNTyp=Warn|RNText=Achtung: Bei den Kommandos sollten man unbedingt das Attribut "cmdRestrictedPeer" setzen, damit nicht jeder Kommandos auf dem FHEM-Server ausführen kann. Dazu sollten die BenutzerIDs der erlaubten Benutzer (durch Leerzeichen getrennt angeben). Da Benutzernamen selber vergeben werden und nicht unbedingt eindeutig sind, sollten hier auch NUR BenutzerIDs verwendet werden.
}}

==== Favoriten für Kommandos anlegen ====

Grundidee bei den Favoriten ist, dass man lange Befehle, die man häufig braucht auf "Kurzwahl" legt.

Beispiel-Kommandos wie z.B. <code>set TYPE=ROLLADEN pos 100</code> und <code>set TYPE=ROLLADEN pos 0</code>, die man immer wieder braucht. Um nicht jedes mal dieses Kommando eintippen zu müssen auf dem Smartphone, kann man auch dafür Favoriten anlegen.

Dazu gibt man erst mal die beiden Kommandos getrennt durch Semikolon im Attribut favorites an:

<code>attr telegrambotdevice favorites set TYPE=ROLLADEN pos 100;set TYPE=ROLLADEN pos 0</code>

Um die Favorites jetzt ausführen zu können braucht man noch ein Schlüsselwort dafür.
Nehmen wir mal an man möchte die Favoriten mit <code>/short</code> ausführen können. Dazu muss dann das Attribut "cmdFavorites" setzen

<code>attr telegrambotdevice cmdFavorites /short</code>

Wenn man nun im Telegram Client
<code>/short 1</code> an den Bot schickt führt der Bot den ersten Favoriten aus und das Ergebnis der Ausführung wird zurückgeschickt.

Ausserdem kann man im Telegram Client
<code>/short</code> an den Bot schicken, dann antwortet der Bot mit

<pre>
Favorites

/short1 = set TYPE=ROLLADEN pos 100

/short2 = set TYPE=ROLLADEN pos 0

</pre>

Die Antworten werden als Schaltflächen dargestellt (Telegram inline Keyboard) und können am Mobile-Client direkt angeklickt werden um sie auszuführen.
Um die Beschriftung der Schaltflächen zu optimieren, können die Befehle im Attribut favorites mit Beschreibungen versehen werden:

<code>/[Rollaeden zu ]=set TYPE=ROLLADEN pos 100;/[Rollaeden auf]=set TYPE=ROLLADEN pos 0</code>

Nun antwortet der Bot auf das Schlüsselwort für die Favoriten mit:

<pre>
Favorites

/short1 = Rollaeden zu

/short2 = Rollaeden auf

</pre>

== Links ==
* Github Repository für die Telegram-FHEM Entwicklung: https://github.com/viegener/Telegram-fhem
* Infos zum Telegram BotFather: https://core.telegram.org/bots#botfather

* Source code für das 50_TelegramBot.pm-Modul: https://github.com/viegener/Telegram-fhem/blob/master/50_TelegramBot.pm

* Forum-Thread in dem das Modul vorgestellt wurde {{Link2Forum|Topic=38328|LinkText=FHEM-Forum}}
* Telegram messaging system https://telegram.org/
* TelegramBot API https://core.telegram.org/bots/api

TelegramBot

2018-10-21T15:25:56Z

Topos: /* Hinweise zum Betrieb mit FHEM */

{{Infobox Modul
|ModPurpose=Senden und Empfangen von Nachrichten (Text und Fotos) mit dem freien Messagingdienst Telegram
|ModType=d
|ModForumArea=Unterstützende Dienste
|ModFTopic=38328
|ModTechName=[https://github.com/viegener/Telegram-fhem/blob/master/50_TelegramBot.pm 50_TelegramBot.pm]
|ModOwner=[[Benutzer:Viegener|Viegener]] ({{Link2FU|12772|Forum}} / [[Benutzer Diskussion:Viegener|Wiki]])}}

Das [[TelegramBot]]-Modul ermöglicht das Senden und Empfangen von Nachrichten über den Telegram-instant messaging Dienst (https://telegram.org/).
Es entsteht eine Möglichkeit Benachrichtungen aus FHEM zu versenden, zum Beispiel Alarmmeldungen.
Ausserdem können auch Kommandos über Telegram an FHEM gesendet werden um Steuerungsbefehle in FHEM auszulösen.

Das TelegramBot-Modul benötigt keine Zusatzsoftware auf dem FHEM-Server (anders als die Variante [[Telegram]]), sondern verwendet das [https://core.telegram.org/bots/api TelegramBot-API] über https-Aufrufe. Es muss jedoch das [http://www.fhemwiki.de/wiki/Raspberry_Pi#N.C3.BCtzliche_Zusatzpakete perl JSON modul] installiert sein.

== Über Telegram Instant Messaging ==
Telegram-IDs und Versand/Empfang von Nachrichten sind kostenfrei.
Clients sind für gängige Smartphonesysteme erhältlich (iOS iPhone und Tablet, Android, Windows Phone) und
können auch aus dem WebBrowser verwendet werden.
Es gibt auch einen Kommandozeilen-Client für Linux, der die Grundlage dieses Moduls darstellt.
Mehrfachanmeldungen, auch parallel mit verschiedenen Geräten (z.B. Tablet und Smartphone), sind möglich.
Gruppenchats und Chats mit End-2-End-Verschlüsselung werden ebenfalls unterstützt.

Für die Unterstützung von ''WhatsApp'' siehe Modul [[yowsup]].

== Features ==
Unterstützt werden:

* Versand von Textnachrichten
* Versand und Empfang von Bildern/Audio/etc
* Empfang von Textnachrichten von beliebigen Kontakten
* Kommandos in FHEM über Telegram-Nachrichten von aussen auslösen
* Ergebnisse der Kommandos zusenden lassen

Eine detaillierte Beschreibung des Moduls ist im FHEM Forum und in der (englischen) Dokumentation zum Modul in der {{Link2CmdRef|Anker=TelegramBot}} und in diesem {{Link2Forum|Topic=38328|LinkText=Diskussionsthread}} zu finden. Seit Oktober 2015 wird das Modul offiziell über FHEM-Update verteilt.

Die jeweils aktuellste Entwicklungs-Version des Moduls ist in Github [https://github.com/viegener/Telegram-fhem/blob/master/50_TelegramBot.pm 50_TelegramBot.pm] verfügbar.

== Hinweise zum Betrieb mit FHEM ==
{{Randnotiz|RNTyp=Info|RNText=Achtung: Dieses Authtoken ist die einzige Authentifizierung für den Bot und sollte deshalb nicht aus der Hand gegeben werden. Die verwendeten Urls sind deshalb auch in den Log-Files nicht enthalten, da diese das Authtoken in Klartext enthalten. Auch im Forum sollte dieses Token nicht aufgenommen werden.
}}

Für die Anlage eines TelegramBot Devices in FHEM ist ein Authtoken erforderlich. Dieses Token wird über Anlegen eines neuen Bots im [https://core.telegram.org/bots#botfather BotFather] erzeugt. Dafür muss der BotFather mit einem Telegram-Client kontaktiert werden. Dort mit dem Telegram-Befehl <code>/newbot</code> einen neuen Bot anlegen und mit einem Namen versehen. Hinweis: Die Namen für Bots müssen auf "Bot" enden. 

Das Anlegen eines TelegramBot devices erfolgt durch die Angabe dieses Tokens:

<code>define <name> TelegramBot <token> </code>

Beispiel: <code>define teleBot TelegramBot 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw</code>

'''Das Empfangen von Nachrichten (polling) erfordert die Einstellung des Attributes'''
<code>pollingTimeout</code> '''auf einen Wert der grösser als Null ist. Beim Wert 0 oder ohne Setzen des Attributes findet kein Polling und damit auch kein Empfang statt.'''

Beispiel: <code>attr teleBot pollingTimeout 120</code>

'''Der TelegramBot kann erst dann Nachrichten an einen telegram user schicken, wenn dieser zuerst an den telegram bot eine Nachricht gesendet hat.'''

{{Randnotiz|RNTyp=Info|RNText=TelegramBot setzt eine aktuelle Version von FHEM voraus, insbesondere Versionen weit vor der Umstellung auf 5.7 (also vor Herbst 2015) können mit einem TelegramBot-Modul nicht funktionieren, da insbesondere das HTTPSRV-Modul dann veraltet ist. Am besten auch den TelegramBot über den offiziellen Update mit dem Rest von FHEM installieren/aktualisieren.
}}

== Registrierung eines neuen Bot ==
Zur Registrierung wird ein funktionierender Telegram-Client (egal ob Web, App oder Programm)benötigt. Hier wird ein Chat zum BotFather gestartet und der Befehl /newbot gesendet. Nun fragt der BotFather die benötigten Angaben ab und liefert am Ende des Dialogs die Informationen für den neuen Bot.
Hier ein Beispiel, wie so ein Chat aussehen könnte:
<pre>Client:
/newbot
----------------
BotFather:
Alright, a new bot. How are we going to call it? Please choose a name for your bot.
----------------
Client:
Mein Name
----------------
BotFather:
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
----------------
Client:
fhem_bot
----------------
BotFather:
Sorry, this username is already taken. Think of something different.
----------------
Client:
fhem1234_bot
----------------
BotFather:
Done! Congratulations on your new bot.
You will find it at telegram.me/fhem1234_bot.
You can now add a description, about section and profile picture for your bot, see /help for a list of commands.
----------------
Use this token to access the HTTP API:
1234567890:AbCdefgHIJklmnOPQRst-uvwxyz

For a description of the Bot API, see this page: https://core.telegram.org/bots/api
</pre>
Um einen Chat an einen "Contact" versenden zu können, muss zuerst in Contacts (bei Readings) ein Kontakt auftauchen. Wenn man sich zum allerersten Mal bei Telegram angemeldet hat, gibt es noch keinen Chat mit irgendjemanden. Man muss sich zuerstmal selbst eine Nachricht im Smartphone zusenden, dann taucht unter Readings der Eintrag Contacts auf. Erst dann kann man eine Nachricht mit @msgPeerId (das ist Ziffernfolge des Contacts ) oder mit @msgPeer (das ist der Name nach dem Doppelpunkt) vom TelegramBot auf sein Smartphone senden.

== Tipps ==

=== Privacyeinstellungen ===

Damit der TelegramBot auch Meldungen in Gruppen sieht, müssen über den BotFather die Privacy-Einstellungen geändert werden. Beispielchat:<pre>Client:
/setprivacy
----------------
BotFather:
Choose a bot to change group messages settings.
----------------
Client:
@fhem1234_bot
----------------
BotFather:
'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username.
'Disable' - your bot will receive all messages that people send to groups.
Current status is: ENABLED
----------------
Client:
Disable
----------------
BotFather:
Success! The new status is: DISABLED. /help</pre>

=== Kontakte ===

Der Bot merkt sich die bereits bekannten Kontakte im Reading <code>Contacts</code>. Dabei werden die einzelnen Kontakte jeweils als 3-teilige Einträge bestehend aus UserID, Vor- und Nachname des Benutzers (mit _ verbunden) und dem Username (mit vorangestelltem @).

Beispiel: <code>123456:Ralf_Mustermann:@ralf</code>

Verschiedene Einträge werden durch Leerzeichen getrennt.

Man kann die Kontakte auch manuell überschreiben (z.B. wenn das Reading fehlerhaft oder verloren sein sollte). Dazu gibt es den Set-Befehl <code>replaceContacts</code>. Dieser nimmt die Kontakte ebenfalls in der gleichen Form wie oben beschrieben entgegen.

Die Kontaktliste wird ansonsten nur durch den Empfang von Nachrichten erweitert, da es im TelegramBot-API keine Möglichkeit gibt Kontaktdaten von Telegram abzufragen (siehe auch pollingTimeout)

=== Reset ===

Es ist möglich den Bot im laufenden Betrieb zurückzusetzen (Set-Befehl <code>reset</code>). Dabei werden noch nicht abgeschlossene Übetragungen entfernt und die internen Zustände des Devices zurückgesetzt.

=== Gruppen ===

Um eine Nachricht von FHEM an eine Gruppe zu senden, muss der BOT in die Gruppe aufgenommen werden. Nach dem Senden einer Nachricht an die Gruppe kann im Modul die Gruppen-ID ermittelt werden und zum Senden von Nachrichten verwendet werden. Wenn die Privacy-Einstellungen nicht auf 'Disabled' gesetzt wurden, muss die Nachricht mit einem Slash (/) beginnen.

==== Supergroups / Supergruppen ====

Auch die neuen Supergruppen werden mit dem Bot unterstützt, es ist allerdings zu beachten, dass bei der Umwandlung einer Gruppe in eine Supergruppe eine neue ID in den Kontakten von Telegram vergeben wird. Wenn man also wie empfohlen IDs zur Identifikation von Benutzern einsetzt, muss entsprechend angepasst werden.

== Beispielszenarien ==

=== Benachrichtigungen über Ereignisse ===

Das einfachste Szenario für die Integration von Messaging-Diensten mit FHEM ist zur Benachrichtigung über Ereignisse. Diese Funktion kann zum Beispiel verwendet werden, um über einen erfolgten Neustart von FHEM zu informieren:

<code>define notify_fhem_reload notify global:INITIALIZED set telebotdevice message fhem newly started - just now !</code>

In diesem Beispiel wird der Nachrichtentext "fhem newly started - just now !" an den als default eingestellten Kontakt (Attribut: defaultPeer) gesendet, sobald FHEM neu gestartet wurde. Natürlich kann man auch beliebige andere Benachrichtigungen einführen.

=== Versand von Bildern ===

Es ist auch möglich Bilder auf dem FHEM-Server, die zum Beispiel von einer Kamera oder einem Wettermodul stammen über Telegram zu versenden. So wäre es z.B. möglich jeweils morgens die aktuelle Wetterkarte zu erhalten.

ACHTUNG: TelegramBot verwendet das HTTPUtils-Modul zur Kommunikation mit dem TelegramBot-API. Erst mit der Version, die seit 22.10.2015
([r9576] HttpUtils.pm: Async write for POST Requests {{Link2Forum|Topic=41583|LinkText=FHEM-Forum}}) verteilt wird, erlaubt auch den Transfer grösserer Bilder. Die Grenze liegt ansonsten bei ca. 14kb auf Raspberries (Plattformspezifische Grenze).

<code>define notify_fhem_reload notify wetter:report set telebotdevice sendImage /opt/fhem/wetter.jpg</code>

Bei Erreichen des entsprechenden Status am Wetter-Modul wird ein Image über Telegram versendet. Hier sind lokale Pfade (relativ zu fhem) oder absolute Pfade wie oben möglich.

=== Versand von SVG-Plots ===

SVG-Plots können mit dem Befehl
<code>cmdSend [ @<peer1> ... @<peerN> ] <fhem command></code>
verschickt werden.

Das angegebene FHEM-Kommando wird ausgeführt und das Ergebnis an die angegebenen Peers bzw. den Standard-Peer verschickt.

Mit dem folgenden Befehl wird der SVG-Plot SVG_FileLog_Aussen an den Standard-Peer geschickt:
<code>set mein_telegramBot cmdSend { plotAsPng('SVG_FileLog_Aussen') }</code>

Nach <code>define cmd_sendTelegramSVG cmdalias TGSVG .* AS set mein_telegramBot cmdSend { plotAsPng("$EVENT") }</code>
kann man mit einem kurzen
<code>TGSVG SVG_Garten</code>
ein beliebiges SVG über die Kommandozeile per Telegram versenden.

Um das SVG nun noch mit einem Text zu versehen, muss eine Textnachricht dazu gesendet werden, was sich am einfachsten durch das Ausführen eines FHEM-Befehls auf Perl-Ebene realisieren lässt:

<code>{fhem "set mein_telegramBot message Bildbeschreibung;; set mein_telegramBot cmdSend { plotAsPng('mein_SVG') }" }</code>

'''Hinweis:''' früher wurde zum Verschicken von Plots auch die interne Funktion TelegramBot_ExecuteCommand verwendet; mit dem Update Ende Februar 2017 hat diese Funktion einen zusätzlichen Parameter erhalten und lautet nun
<code>TelegramBot_ExecuteCommand($defs{"mein_telegramBot"}, meine_ZielID, undef, '{plotAsPng("mein_SVG")}');</code>

==== Voraussetzungen für den Versand von SVG-Plots ====
Es muss das Modul libimage-librsvg-perl installiert sein:

<code>sudo apt-get install libimage-librsvg-perl</code>

Evtl. sind weitere Module erforderlich:

<code>sudo apt-get install libgd-graph-perl

sudo apt-get install libgd-text-perl</code>

=== Empfang von Bildern oder ähnlichem ===

Beim Empfang von Bildern wird zuerst nur eine ID vom Telegram-Server empfangen, diese befindet sich im Reading <code>msgFileId</code> angelegt (<code>123456:xxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxx</code>) und im Reading <code>msgText</code> steht dann so etwas wie
<code>received photo # Size: 107701</code>

Über das Get-Kommando <code>urlForFile</code> mit der ID aus dem msgFileId Reading lässt sich dann daraus ein URL ableiten, der dann zur eigentlichen Datei führt:

<code>https://api.telegram.org/file/bot123456:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/photo/file_25.jpg</code>

=== Versand von Emojis (Smileys) ===

Es ist auch möglich Emojis mit den (Text-)Nachrichten zu versenden. Die entsprechenden (Unicode-)Zeichen werden einfach direkt mit in den Text der Nachricht aufgenommen. Um das zu vereinfachen kann man das einfach per Copy und Paste von dieser Seite

http://apps.timwhitlock.info/emoji/tables/unicode (Spalte "Native")

übernehmen und mit der Nachricht verschicken.

Die Emojis können auch empfangen werden und werden so auch in FHEM / FHEMWeb angezeigt. Plattformspezifische (z.B. von iOS oder Android) Emojis werden dabei nicht unterstützt (gerade mit iOS sind viele neue farbige Emojis hinzugekommen, die wohl leider nur auf Apple-devices funktionieren).

=== Kommandos auslösen ===

Ein wichtiges Szenario ist die Möglichkeit Kommandos in FHEM ausführen zu können, ohne einen Zugang durch die Firewall einrichten zu müssen. Dazu ist die Definition eines Schlüsselwortes (Attribut: "cmdKeyword")erforderlich, mit dem man die Nachrichten beginnen muss, damit der TelegramBot die Kommandos erkennt.

<code>attr telebotdevice cmdKeyword doit</code>

Somit kann man dann durch Nachrichten die mit "doit" beginnen Kommandos an FHEM senden, die ähnlich wie im Kommandoeingabefeld von FHEMweb dann von FHEM ausgeführt werden. Das Ergebnis der Ausführung wird zurück an den Sender (und an den definierten defaultPeer) geschickt.

Somit können nicht nur Aktionen angestossen werden, sondern auch Infos abgefragt werden.

Beispiele

<code>doit set schalter on</code>

<code>doit list telegrambot</code>

{{Randnotiz|RNTyp=Warn|RNText=Achtung: Bei den Kommandos sollten man unbedingt das Attribut "cmdRestrictedPeer" setzen, damit nicht jeder Kommandos auf dem FHEM-Server ausführen kann. Dazu sollten die BenutzerIDs der erlaubten Benutzer (durch Leerzeichen getrennt angeben). Da Benutzernamen selber vergeben werden und nicht unbedingt eindeutig sind, sollten hier auch NUR BenutzerIDs verwendet werden.
}}

==== Favoriten für Kommandos anlegen ====

Grundidee bei den Favoriten ist, dass man lange Befehle, die man häufig braucht auf "Kurzwahl" legt.

Beispiel-Kommandos wie z.B. <code>set TYPE=ROLLADEN pos 100</code> und <code>set TYPE=ROLLADEN pos 0</code>, die man immer wieder braucht. Um nicht jedes mal dieses Kommando eintippen zu müssen auf dem Smartphone, kann man auch dafür Favoriten anlegen.

Dazu gibt man erst mal die beiden Kommandos getrennt durch Semikolon im Attribut favorites an:

<code>attr telegrambotdevice favorites set TYPE=ROLLADEN pos 100;set TYPE=ROLLADEN pos 0</code>

Um die Favorites jetzt ausführen zu können braucht man noch ein Schlüsselwort dafür.
Nehmen wir mal an man möchte die Favoriten mit <code>/short</code> ausführen können. Dazu muss dann das Attribut "cmdFavorites" setzen

<code>attr telegrambotdevice cmdFavorites /short</code>

Wenn man nun im Telegram Client
<code>/short 1</code> an den Bot schickt führt der Bot den ersten Favoriten aus und das Ergebnis der Ausführung wird zurückgeschickt.

Ausserdem kann man im Telegram Client
<code>/short</code> an den Bot schicken, dann antwortet der Bot mit

<pre>
Favorites

/short1 = set TYPE=ROLLADEN pos 100

/short2 = set TYPE=ROLLADEN pos 0

</pre>

Die Antworten werden als Schaltflächen dargestellt (Telegram inline Keyboard) und können am Mobile-Client direkt angeklickt werden um sie auszuführen.
Um die Beschriftung der Schaltflächen zu optimieren, können die Befehle im Attribut favorites mit Beschreibungen versehen werden:

<code>/[Rollaeden zu ]=set TYPE=ROLLADEN pos 100;/[Rollaeden auf]=set TYPE=ROLLADEN pos 0</code>

Nun antwortet der Bot auf das Schlüsselwort für die Favoriten mit:

<pre>
Favorites

/short1 = Rollaeden zu

/short2 = Rollaeden auf

</pre>

== Links ==
* Github Repository für die Telegram-FHEM Entwicklung: https://github.com/viegener/Telegram-fhem
* Infos zum Telegram BotFather: https://core.telegram.org/bots#botfather

* Source code für das 50_TelegramBot.pm-Modul: https://github.com/viegener/Telegram-fhem/blob/master/50_TelegramBot.pm

* Forum-Thread in dem das Modul vorgestellt wurde {{Link2Forum|Topic=38328|LinkText=FHEM-Forum}}
* Telegram messaging system https://telegram.org/
* TelegramBot API https://core.telegram.org/bots/api

Effizienter Betrieb einer Fußbodenheizung mit Luft-Wasser-Wärmepumpe (Fallbeispiel)

2018-08-26T12:29:51Z

Topos:

Dieses Fallbeispiel nutzt das FHEM-Modul LUXTRONIK2 für eine Novelan LIC8E Wärmepumpe (kompakte Luft-Wasser-Wärmepumpe, 8kW (A2/W35), Monobloc, Innenaufstellung, '''nicht modulierend'''). Das FHEM-Modul und die zugehörige Steuerung Luxtronik 2.0 wird auf [[Luxtronik_2.0 | '''dieser''' WIKI Seite]] beschrieben. Es ist ratsam, diese zuvor zu lesen.

== Einleitung ==
Die folgenden Punkte sind für den ökonomischen Betrieb einer Luft-Wasser-Wärmepumpe ausschlaggebend:
# Niedrige (Soll-)Temperaturen im Heizsystem. Je geringer die Differenz zur Außentemperatur, um so weniger muss die Wärmepumpe das Kältemittel komprimieren und um so niedriger ist der prozessbedingte Energieverlust (Prozessarbeit).
# Für die Warmwasserbereitung: Ausnutzung der Tageszeiten mit warmen Außentemperaturen und Vermeidung des Kältetiefs zum Sonnenaufgang.
# Nutzung der Luftabtauung, anstatt Abtauung durch Kreisumkehr.
# Vermeidung von ständigen Kompressorstarts und kurzen Laufzeiten.

Grundlage jeder Optimierung ist dabei ein guter hydraulischer und thermischer Abgleich der Heizwasserverteilung und eine genaue Einstellung der Heizkurve, welche die Solltemperatur anhand der Außentemperatur ermittelt. Beides ist sowohl von den Bedürfnissen und dem Nutzungsverhalten der Bewohner als auch von der Dämmung des Hauses abhängig.

Bei Wärmepumpen, die '''nicht''' über einen leistungsgeregelten Verdichter verfügen, kann man zusätzlich die Einzelraumregler (ERR) und das Überströmventil der Wärmepumpe außer Betrieb nehmen und damit alle Heizkreise als ein „Heizkörper“ betreiben. Die Temperaturregelung erfolgt in diesem Fall allein durch die Solltemperatur und teilweise auch durch das „Selbstregelverhalten“ einer Fußbodenheizung. Diverse Foreneinträge (z.B. [http://www.haustechnikdialog.de/Forum/t/142011/Einstellungen-Alpha-Innotec-LWC80]) erzählen von bedeutenden Einsparungen durch Absenken der Solltemperatur und Wärmepumpen-freundlichen Betriebszyklen (lange Taktzeiten).

== Grundeinstellung des Heizungssystems ==
=== Hydraulischer Abgleich einer Fußbodenheizung ===
Sowohl der hydraulische als auch der thermische Abgleich erfolgen durch die Einstellung der Drosselventile an den Heizungsverteilern. In einem ersten Schritte, dem hydraulischen Abgleich, stellt man die Drosselventile so ein, dass das Wasser in allen Heizkreisen die gleiche Durchlaufzeit hat. Der längste Kreislauf wird am wenigsten gedrosselt. Die Durchflüsse der anderen Heizkreise werden mit Hilfe der Drosseln im gleichen Verhältnis wie die Längen eingestellt. D.h. 90% Länge = 90% Durchfluss, halbe Länge = halber Durchfluss, etc. Üblicherweise entspricht diese Einstellung der Vorgabe durch den Heizungsplaner. Man kann sich jedoch auch empirisch an die richtige Einstellung herantasten.

Für den Abgleich werden alle Stellantriebe von den Ventilen entfernt, so dass sie komplett offen sind. Die Heizungspumpe muss natürlich laufen. Wenn Heizkreise den erforderlichen Durchfluss nicht erreichen, z.B. weil sie weiter entfernt, in einem höheren Stockwerk liegen, dann wird der Durchlauf der anderen Heizkreise gedrosselt. Eventuell muss auch die Heizungspumpe schneller laufen. Die meisten Wärmepumpen haben einen minimalen, optimalen und maximal Durchfluss. Der optimale Durchfluss ist der energiesparenste für die Wärmepumpe selbst. Die Spreizung zwischen Rück- und Vorlauf in der Wärmepumpe liegt dann meist zwischen 5-9 K.

Fehlen an den Drosseln entsprechende Durchflussanzeigen kann man auch die Umdrehungen der Drossel zählen. Hierbei ist eine zusätzliche Überprüfen der Durchlaufzeiten mit einem Infrarot-Thermometer am Heizungsverteiler sinnvoll. Man erzeugt durch den Start der Wärmepumpe oder der Heizungspumpe einen „Heißwasserfront“ und misst für jeden Heizkreis die Zeit, die es braucht, bis diese Front den Heizkreis durchwandert hat und es zu einer merklichen Temperaturerhöhung am Ende des Heizkreises kommt. Diese Durchlauf-Zeit sollte für alle Heizkreise gleich sein.

=== Thermischer Abgleich ===
Der hydraulische Abgleich ist nur der erste Schritt. Abgesehen davon, das nicht alles so gebaut wie geplant wird, gibt es Zimmer, in denen dauerhaft eine höhere oder niedrigere Temperatur gewünscht ist (Bad, Schlafzimmer). Zudem ist der Wärmeverlust jedes Zimmers unterschiedlich und von vielen Einflussfaktoren abhängig - insbesondere der Lage im Gebäude und im Gelände. Dies kann nur sehr begrenzt während der Heizungsplanung berücksichtigt werden.

Für den Abgleich sollten in jedem Zimmer Thermometer installiert und über längere Zeit (am besten elektronisch) der Temperaturverlauf aufgezeichnet werden. Ziel ist es, durch eine schrittweise Öffnung oder Schließung einzelner Drosseln in allen Zimmer möglichst gleiche (oder gleich höhere oder niedrigere) Temperaturen zu erreichen. Je nach Ausgangslage dauert das mehrere Wochen. Die Stellantriebe dürfen weiterhin nicht in Betrieb sein.

Wichtig!!! Beim hydraulischem und thermischem Abgleich des Heizungssytems werden die Temperaturunterschiede zwischen den Zimmern vermindert oder auch korrekt eingestellt. Die Einstellung der tatsächlichen Zimmertemperaturen erfolgt über die Heizkurve.

=== Einstellung der Heizkurve ===
Parallel zum thermischen Abgleich erfolgt die Einstellung der [[Luxtronik 2.0#Heizkurve|Heizkurve]]. Bei Wärmepumpen erfolgt die Heizungsregelung gewöhnlich über die Rücklauftemperatur. Deren Solltemperatur wird von der Steuerung über die Außentemperatur mit Hilfe einer Formel mit zwei einstellbaren Konstanten, der Heizkurve bzw. Heizkennlinie, ermittelt. Das LUXTRONIK2-Modul in FHEM kann bei der exakten Berechnung der Konstanten unterstützten.

Dafür muss bei einer tiefen und bei einer höheren Außentemperatur (z. B. -7°C und +7°C) die korrekte Solltemperatur ermittelt werden, die zu der gewünschten Innentemperatur führt. Ideal sind bewölkte, windarme Tage an denen nur die Außentemperatur auf das Gebäude wirkt. Wenn es zudem nur geringe Temperaturänderungen zwischen Tag und Nacht gibt, zusätzliche Wärmequellen (Kochen, Fönen, Besucher, etc.) im Gebäude vermieden werden und dies auch über mehrere Tage anhält, dann hat man gute Chancen genau die richtige Solltemperatur zu ermitteln, die '''gerade noch''' zur Beheizung des Hauses '''ausreicht'''.

Auch hier fängt man mit der bereits existierenden Einstellung der Heizkurve an. Es darf keine Nachtabsenkung eingestellt sein. Am besten macht man sich eine Tabelle, in der man die jeweilige Außentemperatur, die sich einstellende Solltemperatur und die Innentemperatur der Räume aufnimmt. Je nach Innentemperatur hat man entweder die optimale Solltemperatur gefunden oder man kann ihre tatsächliche Höhe zumindest etwas besser abschätzen.

Kurzfristig Heben und Senken lässt sich die Solltemperatur durch die Direktabsenkung oder -erhöhung am Gerät oder in FHEM durch den Befehl
set <device> '''returnTemperatureSetBack''' ''Temperatur''

Das LUXTRONIK2-Modul berechnet die korrekten Parameter (Konstanten) der Heizkurve über den Befehl
get <device> '''heatingCurveParameter''' ''Aussentemp1 Solltemp1 Aussentemp2 Solltemp2''

Die beiden Außentemperaturen müssen möglichst weit auseinander liegen. Der Befehl ermittelt die neuen Heizkurvenparameter ''heatingCurveEndPoint'' und ''heatingCurveOffset'' und zeigt auch an, welche Solltemperaturen derzeit bei den beiden Außentemperaturen eingestellt werden. Die neuen Heizkurvenparameter setzt man dann am besten auch durch FHEM, da das Modul eine Genauigkeit von 0.1 zuläßt. Direkt an der Steuerung können die Parameter nur in 0.5er Schritten einstellt werden.

== Dauerhaftes Entfernen der Einzelraumregler (ERR) bei nicht leistungsgeregelten Wärmepumpen==

Ein Betrieb von nicht leistungsgeregelten, taktenden Wärmepumpen zusammen mit ERR ist vom Regelverhalten her sehr problematisch.

Taktende Wärmepumpen können im Gegensatz zu [https://www.energie-experten.org/heizung/waermepumpe/betrieb/modulation.html drehzahlgeregelten Wärmepumpen] nur ihre volle Heizleistung abgeben und keine Zwischenwerte. Sie erfordern einen hohen Mindestdurchfluss im Wärmetauscher (Verflüssiger), ansonsten wird der Kältemittelkreislauf zu heiß und die Wärmepumpe schaltet mit einem Hochdruckfehler ab. Die Wärmepumpe verfügt deshalb im Heizkreislauf über einen Pufferspeicher und ein druckgeregeltes Überströmventil, welches das Heizwasserverteilsystem umgehen und den Vorlauf direkt mit dem Rücklauf verbinden kann. Dadurch ist der Mindestdurchfluss im Wärmetauscher immer sichergestellt.

Dieser Aufbau ist jedoch alles andere als optimal. Haben im Normalbetrieb der Heizung mehrere ERR ihren Heizkreis abgesperrt (gewünschte Zimmertemperatur erreicht) so unterschreitet der Durchfluss über das Heizungssystem relativ schnell den Mindestwert. In diesem Fall öffnet das Überströmventil. Ein Teil des (warmen) Heizwassers strömt direkt vom Vorlauf zum Rücklauf und vermischt sich dort mit dem (kalten) Rücklauf aus den noch offenen Heizkreisen. Dadurch kommt es aber ungewollt zu einer schnellen Erhöhung der Rücklauftemperatur. Die Wärmepumpe arbeitet in einem thermischen Kurzschluss und erwärmt hauptsächlich ihren Pufferspeicher. Die gemischte Rücklauftemperatur erreicht schnell den Sollwert und die Wärmepumpe schaltet ab, obwohl aus den offenen Heizkreisen noch kaltes Wasser zurückströmt und die entsprechenden Zimmer noch kalt sind. Sobald die Wärmepumpe steht, fällt die Rücklauftemperatur schnell ab, da die offenen Heizkreise und der durchströmte Estrich noch nicht die Solltemperatur erreicht haben sondern nur der Pufferspeicher im Gerät.

Als Folge kommt es zu '''wiederholtem kurzen Anspringen der Wärmepumpe und darauffolgenden systembedingten Pausen''' (das EVU erlaubt max. 3 Starts pro Stunde) ohne das einige Räume je ihre gewünschte Temperatur erreichen. Klagt man sein Leid dem Heizungsmonteur, so erhöht der meist einfach den Sollwert der Rücklauftemperatur mit dem Ergebnis, dass sich nichts ändert, die Wärmepumpe durch die vielen Starts schneller verschleißt und die Stromrechnung durch den ineffizienten Betrieb schnell doppelt so hoch ist, wie ursprünglich geplant.

Während der Phase der Grundeinstellung wird die Heizung ohne die Stellantriebe bzw. ohne ERR betrieben und es sind immer die gesamten Heizkreisläufe in Betrieb. Bei einem korrekt abgeglichenen und ausgelegten Heizsytem sind die Heizzyklen der Wärmepumpe sehr lang, meist mehrere Stunden. Die Rücklauftemperatur in der Wärmepumpe steigt nur langsam an und fällt nach Ende des Heizzyklus auch nur langsam wieder ab, da immer der gesamte Estrich im Haus aufgeheizt wird und diese Wärme lange speichert. Dies ist die optimale Betriebsform einer Wärmepumpe.

Bei nicht leistungsgeregelten, taktenden Wärmepumpen ist es deshalb empfehlenswert, die ERR von mindestens 2/3 aller Heizkreise dauerhaft außer Betrieb zu nehmen. Wenn dadurch der Mindestdurchfluss sichergestellt werden kann, kann man das Überströmventil auch komplett schließen. Es ist zumeist etwas undicht und verschlechtert damit die Effektivität des Heizsystems. Normalerweise kann man dadurch nichts beschädigen, da die Wärmepumpe im Fehlerfall einen Hochdruckfehler auslöst und stehen bleibt. Auch der Pufferspeicher ist nun eigentlich überflüssig, da die Heizung nicht mehr im thermischen Kurzschluss betrieben wird.

=== Geändertes Regelverhalten bei Betrieb ohne ERR ===
Durch den Wegfall der ERR kann die Regelung nicht mehr gezielt auf die Aufheizung einzelner Zimmer, z.B. durch Sonneneinstrahlung, reagieren.

Eine Fußbodenheizung dämpft diese Temperaturunterschiede jedoch bereits durch ihr physikalisches Wirkprinzip. Die Wärmeabgabe eines Heizkörpers wird durch den Temperaturunterschied zwischen Heizkörper (hier der Fußboden) und Raumluft bestimmt. Aufgrund der geringen Vorlauftemperaturen wird bei einer Fußbodenheizung dieser Temperaturunterschied auch maßgeblich durch die Raumtemperatur beeinflußt. Die Fußbodenheizung in wärmeren Räumen gibt merklich weniger Wärme ab als in kalten Räumen. Das System reguliert sich also teilweise selbst. Dieser Effekt ist um so größer, je niedriger die Vorlauftemperaturen sind.

Prinzipiell können in '''wenigen''' einzelnen Räumen aber durchaus die ERR in Betrieb bleiben.

AIT bietet auch die Raumbedieneinheit RBE und den Raumfernsteller RFV an, welche direkt an die Luxtronik-Steuerung angeschlossen werden. Diese messen den Abstand der Zimmertemperatur zur gewünschten Solltemperatur und heben oder senken dann über einen Faktor den Sollwert der Rücklauftemperatur in der Wärmepumpe.

In FHEM kann man dies natürlich auch ohne teure Hardware tun. Zudem können die Zimmertemperaturen mehrerer Räume berücksichtigt werden. Man ermittelt dafür jeweils den Abstand (Delta) der aktuellen zur gewünschten Zimmertemperatur, multipliziert diesen mit einem Faktor (üblicherweise zwischen 1 und 5) und verändert die Rücklaufsolltemperatur um diesen Wert mit Hilfe des Befehls:
set <device> '''returnTemperatureSetBack''' ''Temperaturunterschied''
Der Befehl läßt Werte von -5 K bis +5 K zu. Die Berechnung des Stellwertes muss nicht linear über einen Faktor erfolgen, auch eine quadratische Formel ist möglich. Der Stellwert von -5 K kann dann z.B. bereits bei einer Abweichung von +1 K erreicht werden.
$setBack = -int( 10 * ( ($deltaTemp*1.45+1)**2 - 1 ) + 0.5 ) / 10;
{| class="wikitable"
|-
| Temperaturabweichung
| +0.1
| +0.2
| +0.3
| +0.4
| +0.5
| +0.6
| +0.7
| +0.8
| +0.9
| +1.0
|-
| Stellwert
| -0.3
| -0.7
| -1.1
| -1.5
| -2.0
| -2.5
| -3.1
| -3.7
| -4.3
| -5.0
|-
|}

Wenn eine Fussbodenheizung ohne ERR betrieben wird und Räume unterschiedliche Temperaturen haben sollen, dann sollte zudem die [[Luxtronik_2.0#Pumpenoptimierung|Pumpenoptimierungszeit]] möglichst klein gewählt werden, da sonst nach Abschalten der Wärmepumpe die wärmeren Räume schneller abkühlen und dabei die kälteren aufheizen.

== Optimierung der Luftabtauung ==
Der Verdampfer einer Luft-Wasser-Wärmepumpe muss bei niedrigen Außentemperaturen regelmäßig abgetaut werden. [[Luxtronik 2.0#Abtauung des Verdampfers (Luftwärmetauschers) bei Luft-Wasser-Wärmepumpen|(näheres hier)]] Dies erfolgt entweder energiesparend durch die Umgebungsluft oder die Abtau-Energie wird über eine Kreislaufumkehr dem Heizungssystem entnommen und vermindert damit die Energieeffizienz des Systems um ca. 5%.

[[Datei:Luxtronik2-Luftabtauung.png|miniatur|Temperaturverlauf bei einer Luftabtauung (roter Pfeil)]] ‎
=== Wahl des Temperaturbereiches ===
Die Luftabtauung wird über zwei Kennwerte gesteuert. Der Wert ''heatSourceDefrostAirThreshold'' definiert den Wert der Luft-Eingangstemperatur oberhalb der mit Luft abgetaut wird. Der Wert ''heatSourceDefrostAirEnd'' definiert die Luft-Ausgangstemperatur bei der der Verdampfer als abgetaut gilt und die Luftabtauung beendet wird. Diese Werte schwanken bei jedem Wärmepumpentyp, sind werksseitig meist aber auf 7°C und 6°C eingestellt. Dies nutzt nicht den tatsächlich verfügbaren Bereich für die Luftabtauung. Zudem liegen die Werte zu nah beieinander. Sinnvolle Wert sind jedoch stark von der Einbausituation abhängig und müssen empirisch bestimmt werden.

Um sicher zu gehen, dass die Steuerung die korrekten Temperaturen mißt, sollte zuerst kontrolliert werden, dass der Sensor zur Bestimmung der Luft-Eingangstemperatur auch tatsächlich im Luftstrom sitzt und nicht bei der Montage hinter eine Verkleidung oder Isolierung gerutscht ist.

Aufgrund der Ungenauigkeit der Sensoren sollte der Wert ''heatSourceDefrostAirEnd'' immer deutlich unter dem Wert ''heatSourceDefrostAirThreshold'' und im ausreichenden Abstand zum Gefrierpunkt 0°C liegen. Der Abstand 1 K braucht nur geringfügig verändert zu werden. Der Abtand zum Gefrierpunkt kann dagegen auch knapp über +1°C liegen. Als praktikabel haben sich zum Beispiel die Werte
* ''heatSourceDefrostAirThreshold = 2.7°C'' und
* ''heatSourceDefrostAirEnd = 1.3°C''
und, an der Steuerung, eine Erhöhung der Zeitbegrenzung ''Luft-Abt. max'' auf 25 min erwiesen.

Wichtig!!! Diese Werte müssen empirisch ermittelt werden. Der Abtauvorgang ist erst beendet, wenn aus dem Entwässerungsschlauch am Verdampfer kein Wasser mehr fließt und die Luft-Ausgangstemperatur steil ansteigt. Liegt der ''heatSourceDefrostAirThreshold'' zu niedrig, dann erreicht die Wärmepumpe nicht mehr die Temperatur ''heatSourceDefrostAirEnd''. Die Luftabtauung wird dann nach einem Timeout abgebrochen und eine Abtauung durch Kreislaufumkehr durchgeführt. Der Start der Luftabtauung war für diesen Fall ineffizient und sollte vermieden werden.

Der letzte Abtauvorgang wird im Wert ''heatSourceDefrostLast'' festgehalten. Die letzte abgebrochene Luftabtauung im Wert ''heatSourceDefrostLastTimeout''. Beide Werte sollten genutzt werden, um die korrekte Funktion der Luftabtauung bei den eingestellten Werten zu überprüfen.

=== Heizzyklen im Bereich der Luftabtauung ===
Die Firmware der Luxtronik 2.0 hat eine unerfreuliche Eigenheit. Nach einer Luftabtauung wird der Heiztakt nicht zu Ende geführt, sondern erst wieder beim Unterschreiten der unteren Hysterese gestartet. Dadurch bleibt die Rücklauftemperatur eventuell dauerhaft unterhalb der Solltemperatur der Heizkurve, anstatt um sie im Hystereseband zu schwanken. Bei leichten Plusgraden im Außenbereich ist dadurch die Raumtemperatur immer etwas zu kühl.

Optimal für die Wärmepumpe wäre es, wenn ein Heizzyklus bei höheren Außentemperaturen der Länge eines Abtauzyklus (45 min) entspricht. Dies kann man durch eine exakte Einstellung der Hysterese ''returnTemperatureHyst'' erreichen. Sie sollte so gewählt sein, dass sie am unteren Ende der Luftabtauung (z. B. 5°C) möglichst komplett durchfahren wird, bevor der Heizzyklus durch die Luftabtauung unterbrochen wird.

Bei höheren Außentemperaturen erreicht die Rücklauftemperatur dann aber zu schnell den oberen Grenzwert. Zwischen 10°C und 15°C läuft die Heizung deshalb mindestens 40 min. Wenn unterhalb 10°C aber auf dem Abtautimer ''heatSourceDefrostTimer'' ein kleiner Restwert bleibt, dann führt dies beim nächsten Heizzyklus zum vorzeitigen Abbruch. Im zweiten Heizzyklus erreicht die Rücklauftemperatur dadurch nie den oberen Grenzwert. Eventuell sinkt sogar die Raumtemperatur.

[[Datei:Luxtronik2-Verlängerung_des_Heizzykluses.png|miniatur|Verlängerung des Heizzykluses durch Anheben der Solltemperatur bis zum Start der Luftabtauung 
Grün = Vorlauftemperatur, Blau = Rücklauftemperatur, Gelb = Solltemperatur mit Hystereseband]]
Dieser Eigenheit läßt sich mit FHEM ausgleichen. Dafür hebt man im ersten Heizzyklus rechtzeitig vor dem Erreichen des oberen Grenzwertes die Solltemperatur um 0,5 K an (''returnTemperatureSetBack'') und wartet, bis der Abtautimer ''heatSourceDefrostTimer'' abgelaufen ist und die Luftabtauung beginnt. Die Wärmepumpe startet dadurch immer mit einen vollen Abtautimer. Die Anzahl der Starts wird minimiert. Die Temperatur wird auch im Bereich der Luftabtauung komplett durch die Heizkurve bestimmt.

== Warmwasserbereitung bei Luft-Wasser-Wärmepumpen ==
Die Kosten der Warmwasserbereitung durch Luft-Wasser-Wärmepumpen hängen von zwei Faktoren ab:
# den Energiekosten: Bei Zweitarifzählern ist der Strom im Nebentarif (z.B. Mo-Fr von 22:00 - 06:00, Sa ab 13:00 und den ganzen So) billiger als im Haupttarif.
# der Lufttemperatur: Die Heizleistung der Wärmepumpe steigt bei höherer Lufttemperatur trotz konstantem Stromverbrauchs. Die Außentemperatur erreicht ihr Maximum an einem sonnigen '''Durchschnittstag''' gegen 15:00 Uhr. Ihr Minimum hat sie kurz vor Sonnenaufgang.
Das FHEM Modul erlaubt es, durch zeitweises Anheben der Solltemperatur ein Aufheizen des Boilers auszulösen.
set <device> '''hotWaterTemperaturTarget''' 50
Es gilt nun, den kostengünstigsten Zeitpunkt für diesen Vorgang zu bestimmen. Die nachfolgenden Ausführungen setzen voraus, dass Aufgrund der Boilerisolierung und der Boilergrösse nur ein- oder zweimal pro Tag aufgeheizt werden muss. Zur Vereinfachung wird die Abhängigkeit der Wärmeverluste von der Boilertemperatur vernachlässigt.

Bei den aktuellen Wärmepumpentarifen ist der Strom des Haupttarifes etwa 17 % teurer als der des Nebentarifes. Es liegt also nahe, den Boiler in der Woche zu Beginn des Nebentarifes gleich für die nächsten 24 h aufzuheizen, weil dann die Außentemperatur höher ist und man dann am billigsten und effizientesten die entsprechende Wärme produziert.
# Sollwert 5 K über Standardwert setzen
define Boilertemperatur_hoch at *22:05:00 {\
if ($we != 1) { fhem ("set WP hotWaterTemperaturTarget 47");; }\
}
# Sollwert auf Standwert zurücksetzen
define Boilertemperatur_normal at *23:00:00 set WP hotWaterTemperaturTarget 42

=== Detailliertere Berücksichtigung der Temperaturabhängigkeit===

Damit die Warmwasserbereitung vor 6 Uhr nicht startet, muss die Warmwassertemperatur um 22 Uhr eigentlich nur ausreichend hoch über der Auslöseschwelle liegen. Bei einer Auslöseschwelle von 40 °C und einem Wärmeverlust (''statBoilerGradientCoolDownMin'') von 0,25 K/h sind dies z.B. 42 °C. Beträgt die Solltemperatur-Hysterese 2 K, so muss um 22 Uhr die Solltemperatur kurzzeitig auf 44 °C angehoben werden bzw. eigentlich nur 2 K oberhalb der aktueller Warmwassertemperatur.

Die obigen 47 °C machen zudem nur Sinn, wenn tagsüber die Effektivitätsverbesserung durch die höheren Außentemperaturen den höheren Strompreis nicht wieder ausgleicht. Zudem muss berücksichtigt werden, dass sich bei höherer Vorlauftemperatur auch die Leistungsaufnahme der Wärmepumpe und damit ihre Arbeitszahl ändert. Diese Veränderung beträgt üblicherweise 2 %/K. 
Geht man von einer durchschnittlichen Erhöhung der Vorlauftemperatur von 4 K aus, so erhält man dadurch eine Verschlechterung der Arbeitszahl um 8 %. Das heißt, die 17 % Preisunterschied müssen um den Effektivitätsverlust von 8 % korrigiert werden (1,17/1,08=1,08). In unserem Fall reicht also die Temperaturdifferenz aus, die zu einer 8 % höheren Heizleistung führt.

Die ungefähre, theoretische Temperaturabhängigkeit der Heizleistung erhält man am schnellsten aus den Grafiken der Betriebsanleitung der Wärmepumpe. Empirisch und genauer lassen sich die Wert durch Loggen der Werte ''thermalPower'' oder besser ''statThermalPowerBoiler'' bestimmen. Liest man die Log-Datei in ein Tabellenkalkulationsprogramm (MS Excel, OO Calc), kann man mit diesem auch gleich eine Regressionsgrade berechnen. Auf diesem Wege erhält man für jede Temperaturdifferenz die prozentuale Änderung der Heizleistung. Nehmen wir an, sie beträgt für 8 % 4 K.

Über das {{Link2CmdRef|Lang=de|Anker=Weather|Label=Wettermodul}} von FHEM kann man nun Mo-Fr um 22:00 die aktuelle Außentemperatur ''ambientTemperature'' mit der maximalen Außentemperatur des nächsten Tages vergleichen. Rechnen wir noch eine Sicherheit von 2 K hinzu, dann kann man z.B. festlegen, dass ab 5 K Temperaturunterschied und jeden Samstag der Boiler nur noch so weit aufgeheizt wird, dass er bis 06:00 nicht mehr auslöst.
define Boilertemperatur_hoch at *22:05:00 {\
my $delta = ReadingsVal("Wetter","fc2_high_c",0) - ReadingsVal("Heizung","ambientTemperature",0);;\
if ($delta >=5.0 || $wday == 6) {\
my $newTemp = int(ReadingsVal("Heizung","hotWaterTemperature",42)*2+5)/2;;\
if ($newTemp<42.0) {$newTemp = 42;;}\
if ($newTemp>44.0) {$newTemp = 44;;}\
fhem( "set Heizung hotWaterTemperatureTarget $newTemp" );;\
}\
else { fhem( "set Heizung hotWaterTemperatureTarget 47" );; }\
}

Mit Hilfe der Sperrzeitensteuerung der Luxtronik 2.0 kann man die nächste, zweite Aufheizung dann erst wieder um 15:00 erlauben, da dann Aufgrund der hohen Außentemperaturen der Strompreisunterschied mehr als ausgeglichen wird. Natürlich kann das Aufheizen auch hier durch ein gezieltes Anheben der Solltemperatur erreicht werden (z.B. am Wochenende).
define Boilertemperatur_WE_Hoch at *15:00:00 {\
if ($we == 1) {fhem( "set Heizung hotWaterTemperatureTarget 47" );; }\
}
define Boilertemperatur_WE_Normal at *16:00:00 {\
if ( ReadingsVal("Heizung","hotWaterTemperatureTarget", 42 ) != 42.0 ) {fhem ("set Heizung hotWaterTemperatureTarget 42");;}\
}

== Nachtabsenkung und Heizstäbe (ZWE) ==
Ein Absenken der Solltemperatur macht bei Fußbodenheizungen nur sehr begrenzt Sinn, da der Estrich in der Regel mehrere Stunden braucht, um abzukühlen oder um wieder auf Solltemperatur zu kommen. Bei einer Absenkung über Nacht startet die Wiederaufheizung zudem zum kältesten Zeitpunkt des Tages (Sonnenaufgang) und, bei zeitabhängigen Stromtarifen, in der teuren HT-Zeit. In Summe führt dies zumeist zu Mehrausgaben.

Insbesonders in Kälteperioden kann eine Absenkung bei [[Luxtronik_2.0#Bivalenter Betrieb|bivalent betriebenen]] Wärmepumpen auch zum unnötigen Ansprechen der Heizstäbe führen, da der Aufheizvorgang meist unterhalb des Hysteresebandes der Solltemperatur startet und die Wärmepumpe es nicht schaft, die untere Grenztemperatur innerhalb von 60 min zu erreichen. Deshalb sollten in FHEM zu schnelle und starke Änderungen der Solltemperatur bei tiefen Außentemperaturen vermieden werden. Nutzt man die Absenkungsfunktion der Luxtronik-Steuerung, so sollte der Grenzwert '''"Absenk. bis"''' nicht zu tief eingestellt werden.

Vermeidet man Absenkungen oder zu starke Sollwertänderungen, dann benötigt man die Heizstäbe nur bei wirklich tiefen Außentemperaturen, wenn der Wärmeverlust des Gebäudes nahe an der verbleibenden Heizleistung der Wärmepumpe liegt (Abtauung und EVU-Sperren berücksichtigen). Diese Temperatur läßt sich empirisch bestimmen und stellt dann auch das Minimum des Steuerungskennwertes '''"Freig. ZWE"''' dar. Während der Bestimmung des Wertes sollte es nicht zu einem zusätzlichen Wärmeeintrag ins Gebäude kommen (Sonneneinstrahlung, Kochen, etc.).

== Links ==
* [https://www.energie-experten.org/heizung/waermepumpe.html www.energie-experten.org/Wärmepumpe] - Gute Erläuterung der technischen Hintergründe einer Wärmepumpe
* [[Luxtronik_2.0 | FHEM Modul der Steuerung Luxtronik 2.0]]

[[Kategorie:HOWTOS]]
[[Kategorie:Heizungssteuerung]]

Luxtronik 2.0

2018-04-10T20:31:38Z

Topos:

{{Infobox Modul
|Name=LUXTRONIK2
|ModPurpose=Anbindung der Heizungssteuerung Luxtronik 2.0
|ModType=d

|ModCmdRef=LUXTRONIK2
|ModForumArea=Sonstiges
|ModTechName=23_LUXTRONIK2.pm
|ModOwner=[http://forum.fhem.de/index.php?action=pm;sa=send;u=5432 tupol]
}}
Die Luxtronik 2.0 ist eine Heizungssteuerung der Firma Alpha InnoTec AIT, die in Wärmepumpen von Alpha InnoTec, Buderus (Logamatic HMC20, HMC20 Z), CTA All-In-One (Aeroplus), Elco, Nibe (AP-AW10), Roth (ThermoAura®, ThermoTerra), Novelan (WPR NET) und Wolf Heiztechnik (BWL/BWS) verbaut ist.
Sie besitzt einen Ethernet (RJ45) Anschluss, so dass sie direkt in lokale Netzwerke (LAN) integriert werden kann. 

Ein detailierte Anleitung zum energiesparenden Betrieb einer Luft-Wasser-Wärmepumpe mit Fußbodenheizung findet man auf [[Effizienter Betrieb einer Fußbodenheizung mit Luft-Wasser-Wärmepumpe (Fallbeispiel)|'''dieser''' Wiki-Seite]]

== Hinweise zum Betrieb mit FHEM ==
Definition in fhem.cfg:

define <name> '''LUXTRONIK2''' <IP-Adresse[:Port]> [Abfrageinterval]

Die Angabe der Portnummer ist optional. Bei einigen Firmware-Versionen sollte der Port 8889 angegeben werden.

Weiter in der {{Link2CmdRef|Lang=de|Anker=LUXTRONIK2}}.

=== Zusätzliche Perl-Module ===
Das FHEM-Modul benutzt das CPAN-Modul "net::Telnet". Dieses ist standardmäßig installiert. Wenn nicht muss es nachinstalliert werden. Unter Debian z.B. mit
sudo apt-get install libnet-telnet-perl

=== Hard- und Firmwareversionen ===
Die Luxtronik 2.1 ähnelt der Version 2.0 stark, besitzt aber eine andere Hardware und Firmware-Versionsnummer.

Bei Steuerungen mit den Firmware-Versionen 2.xx, 3.xx und 4.xx existiert kein Telnet-Zugang. Eine automatische Korrektur der Systemzeit ist dadurch nicht möglich.

Das Modul nutzt die nicht öffentlich dokumentierte Schnittstelle des über einen Internetbrowser aufrufbaren Java-Programmes der Steuerung (Port 8888 oder 8889). Aufgrund der Java-Einschränkungen neuerer Internet-Browser hat die Steuerung seit der Firmware-Version x.81 auch eine Schnittstelle für ein Java-Script (Port 8214). Dies ermöglicht die Bedienung mit neueren Browsern hat aber geringere Auslese- und Einstell-Möglichkeiten. Das Modul nutzt diese Schnittstelle (derzeit) nicht.

Neue Firmware-Versionen sind gewöhnlich abwärtskompatibel und sollten nicht zu Einschränkungen bei dem Modul führen. Bei Firmware-Versionen >x.81 wurde jedoch berichtet, dass über die Java-Schnittstelle nicht mehr alle Informationen übertragen werden.

== Erläuterung der Readings ==
===Allgemeine Wärmepumpenwerte===
* '''ambientTemperature''' - Temperatur des Außensensors in °C
* '''averageAmbientTemperature''' - Gemittelte Außentemperatur in °C (für Heizgrenze im Sommer, siehe [[#Frostschutz_und_Heizgrenze|Frostschutz und Heizgrenze]])
* '''bivalentLevel''' - Bivalenzstufe, siehe [[#Bivalenter_Betrieb|Bivalenter Betrieb]]
* '''COP''' - Coefficient Of Performance, Wirkungsgrad der Wärmepumpe (Leistungszahl ε). Eine Leistungszahl von z.B. 4,2 bedeutet, dass von der eingesetzten elektrischen Leistung des Kompressors das 4,2- fache an Wärmeleistung bereitgestellt wird. Anders formuliert, kann mit dieser Wärmepumpe aus einem Kilowatt elektrischer Leistung 4,2 kW Wärmeleistung zur Verfügung gestellt werden. ''Bei der Berechnung des COPs wird die elektrische Leistung aus dem Attribut "heatPumpElectricalPowerWatt" benutzt.''
* '''delayDeviceTimeCalc''' - Abweichung Gerätesystemzeit zur FHEM-Zeit. Dieser kann bis zu 2 s in der Vergangenheit liegen. Höhere Werte weisen auf eine ungenaue Systemzeit in der Steuerung hin.
* '''deviceTimeCalc''' - Beim Abrufen der Gerätewerte wird von der Luxtronik-Steuerung auch der Zeitpunkt der internen Ermittlung übergeben.
* '''durationFetchReadings''' - Dauer (in s) des Abrufes der Gerätewerte von der Steuerung
* '''flowRate''' - Durchfluss in l/h
* '''flowTemperature''' - Vorlauftemperatur in °C, normalerweise direkt hinter der Heizungsumwälzpumpe gemessen und '''vor''' einer eventuell installierten Heizpatrone
* '''heatSourceIN''' - Wärmequelle Eingangstemperatur in °C
* '''heatSourceOUT''' - Wärmequelle Ausgangstemperatur in °C (sitzt bei Luft-Wasser-WPs aber im Verdampfer)
* '''hotGasTemperature''' - Heißgastemperatur in °C, Temperatur, die hinter dem Kompressor der Wärmepumpe anfällt
* opStateHeatPump1...3
* '''returnTemperature''' - Rücklauftemperatur in °C, normalerweise vor dem Eingang zum Wärmetauscher des Verdichterkreislaufes gemessen
* '''thermalPower''' - aktuelle Heizleistung der WP in kW, berechnet aus Durchfluss und Differenz von Vor- und Rücklauftemperatur, also ohne Heizpatrone etc.

=== Luft-Wasser-Wärmepumpen ===
* '''heatSourceDefrostAirEnd''' - Luft-Ausgangstemperatur in °C bei der die Luftabtauung des Verdampfers beendet wird
* '''heatSourceDefrostAirThreshold''' - Luft-Eingangstemperatur in °C oberhalb der der Verdampfer (energiesparend) mit Luft abgetaut wird
* '''heatSourceDefrostLast''' - Dauer sowie Umgebungs- und Luft-Eingangs-Temperaturen zum Beginn und am Ende der letzten Abtauung
* '''heatSourceDefrostLastTimeout''' - Umgebungs- und Wärmequellen-Temperaturen bei denen die Luftabtauung die maximale Dauer überschritten hat.
* '''heatSourceDefrostTimer''' - Ablaufzeit in Sekunden bis zur nächsten Abtauung des Verdampfers

=== Heizung ===
* '''heatingCurveEndPoint''' - Endpunkt der Heizkurve in °C bei -20°C Außentemperatur
* '''heatingCurveOffset''' - Parallelversatz der Heizkurve
* '''heatingSystemCircPumpDeaerate''' - Entlüftungsmodus der Heizkreisumwälzpumpe (wird zum gezielten Einschalten der Pumpe durch FHEM genutzt)
* '''heatingLimit''' - Heizgrenze wird ausgewertet (on, off)
* '''mixer1FlowTemperature''' - Vorlauftemperatur am Mischkreis 1 in °C
* '''mixer1TargetTemperature''' - Sollwert Vorlauftemperatur am Mischkreis 1 in °C
* '''mixer2FlowTemperature''' - Vorlauftemperatur am Mischkreis 2 in °C
* '''mixer2TargetTemperature''' - Sollwert Vorlauftemperatur am Mischkreis 2 in °C
* '''mixer3FlowTemperature''' - Vorlauftemperatur am Mischkreis 3 in °C
* '''mixer3TargetTemperature''' - Sollwert Vorlauftemperatur am Mischkreis 3 in °C
* '''opModeHeating''' - Betriebsmodus der Heizung (Aus, Automatik, Zusatzheizung, Party, Ferien)
* '''opStateHeating''' - Status der Heizung (Aus, Normal, Abgesenkt, Heizgrenze, Frostschutz)
* '''returnTemperatureHeating''' - aktuelle oder letzte valide Rücklauftemperatur des Heizungskreislaufes in °C. Durch die Speicherung kann auch bei stehender Zirkulationspumpe oder während der Warmwasserbereitung auf die letzte valide Rücklauf-Temperatur des Heizkreislaufes zurückgegriffen werden.
* '''returnTemperatureHyst''' - Regel-Hysterese in K der Rücklauf-Solltemperatur
* '''returnTemperatureSetBack''' - Schnellverstellung in K der Rücklauf-Solltemperatur
* '''returnTemperatureTarget''' - Sollwert Rücklauftemperatur in °C (wird durch Heizkurve und Außensensor bestimmt, kann über in der Steuerung eingegebene Zeiten und auch manuell gezielt abgesenkt)
* '''thresholdHeatingLimit''' - Heizgrenze in °C, '''über'''schreitet die gemittelte Außentemperatur diesen Wert, wird nicht mehr geheizt
* '''thresholdTemperatureSetBack''' - '''unter'''schreitet die Außentemperatur diesen Wert (°C), wird die Rücklauf-Solltemperatur nicht mehr (zeitgesteuert) abgesenkt

=== Warmwasserbereitung ===
* '''hotWaterCircPumpDeaerate''' - Entlüftungsmodus der Zirkulationspumpe (zum gezielten Einschalten der Zirkulationspumpe durch FHEM)
* '''hotWaterTemperature''' - aktuelle Warmwasser-Boiler-Temperatur in °C (Achtung, die Temperatur im Boiler ist sehr unterschiedliche, es wird also nur die Temperatur am Sensor angezeigt. Typischerweise sackt die Temperaturkurve beim Aufheizen des Boilers etwas ab, weil es durch den Wärmeeintrag zu Strömungen kommt.)
* '''hotWaterTemperatureTarget''' - obere Solltemperatur des Boilers in °C
* '''opModeHotWater''' - Betriebsmodus der Warmwasserbereitung (Aus, Automatik, Zusatzheizung, Party, Ferien)
* '''opStateHotWater''' - Status der Warmwasserbereitung (Aus, Aufheizen, Temp. OK, Sperrzeit)

=== Solarthermie ===
* solarBufferTemperature - in °C
* solarCollectorTemperature - in °C

=== Lüftung ===
* '''opModeVentilation''' - Betriebsmodus der Lüftung (Aus, Automatik, Party, Feuchteschutz)
* '''ventSupplyAirTemperature''' - Zulufttemperatur in °C
* '''ventExhaustAirTemperature''' - Ablufttemperatur in °C

=== Zähler ===
* '''counterHeatQHeating''' - von der Wärmepumpe produzierte Wärmemenge (kWh) zur Heizung (nur bei vorhandenem Wärmemengenzähler und ohne Wärmeeintrag durch zweite Wärmequelle wie z.B. Heizstäbe)
* '''counterHeatQHotWater''' - von der Wärmepumpe produzierte Wärmemenge (kWh) zur Warmwasserbereitung (nur bei vorhandenem Wärmemengenzähler und ohne Wärmeeintrag durch zweite Wärmequelle wie z.B. Heizstäbe)
* '''counterHeatQTotal''' - von der Wärmepumpe produzierte Wärmemenge (kWh) insgesam (nur bei vorhandenem Wärmemengenzähler und ohne Wärmeeintrag durch zweite Wärmequelle wie z.B. Heizstäbe)

* '''counterHours2ndHeatSource1''' - Betriebsstunden der zweite Wärmequelle (normalerweise elektrische Heizstäbe)
* '''counterHoursHeatPump''' - Betriebsstunden des Wärmepumpenkompressors
* '''counterHoursHeating''' - Betriebsstunden des Wärmepumpenkompressors die zur Heizung benutzt wurden
* '''counterHoursHotWater''' - Betriebsstunden des Wärmepumpenkompressors die zur Warmwasserbereitung benutzt wurden

=== Ein- und Ausgänge ===
* compressor1...2
* '''heatingSystemCircPump''' - Heizungs-Umlaufpumpe in der Wärmepumpe (normaler Weise für das Heizungssystem) (HUP)
* '''heatingSystemCircPumpVoltage''' - Regelspannung an der Heizungs-Umlaufpumpe in der Wärmepumpe (zur Steuerung der Pumpen-Drehzahl)
* '''heatSourceMotor''' - Motor des Ventilators, der Brunnen- oder der Solepumpe (je nach WP-Typ) (Ventil-BOSUP)
* '''hotWaterCircPumpExtern''' - Zirkulationspumpe im Warmwasserstrang des Hauses (wenn genutzt) (ZIP)
* '''hotWaterSwitchingValve''' - Ventil zur Umschaltung auf die Heizspirale im Boiler (BUP)
* 2ndHeatSource1...3
* '''solarPump''' - Pumpe der Solarthermie (SLP)

=== Sonstiges ===
* Firmware
* '''typeSerial''' - Baujahr/Monat-Lfd.Hexadezimalnummer
* '''typeHeatpump''' - Modell der Wärmepumpe
**ERC
**HMD 2
**KLW
**KSW
**L1A
**L1A407
**L1AREV
**L1H
**L1I
**L1I407
**L1S
**L2A
**L2A407
**L2AREV
**L2G
**L2G404
**L2G407
**L2H
**L2I
**L2I407
**LD2AG
**LD5
**LD5 (230V)
**LD5 REV
**LD5 REV 230V
**LD7
**LD7 (230 V)
**LD7 REV
**LD7 REV 230V
**LD9
**LD9 REV 230V
**LW SEC
**LWC
**'''LWC407''' - Kompakte Luft/Wasser-Wärmepumpe zur Innenaufstellung
**LWD90V - ?? Duale Luft/Wasser-Wärmepumpe invertergeführt zur Außenaufstellung
**MSW 10
**MSW 10S
**MSW 12
**MSW 13S
**MSW 14
**MSW 16S
**MSW 17
**MSW 19
**MSW 23
**MSW 26
**MSW 30
**MSW 4
**MSW 4S
**MSW 6 - Sole/Wasser-Wärmepumpe
**MSW 6S
**MSW 8
**MSW 8S
**MSW2-6S
**MSW3-12
**MSW3-12S
**MSW4-1676
**SW 291
**SW 29_56
**SW 37_45
**SW 58_69
**SW1 - ?? Sole/Wasser-Wärmepumpe
**SW2
**SWC - ?? kompakte Sole/Wasser-Wärmepumpe
**WW1 - ?? Wasser/Wasser-Wärmepumpe
**WW2
**WWB_20 - ?? Wasser/Wasser-Booster zur dezentralen Trinkwassererwärmung
**WWC1 - ?? kompakte Wasser/Wasser-Wärmepumpe
**WWC2
**WZS - ??? Sole/Wasser Wärmezentrale
**WZW
**WZWD

== Tipps zum ökonomischen Betrieb ==
Grundlage eines ökonomischen Betriebs einer Wärmepumpe ist in erster Linie ein guter hydraulischer Abgleich der Heizwasserverteilung und eine genaue Einstellung der Heizkurve. Beides ist sowohl von den Bedürfnissen und dem Nutzungsverhalten der Bewohner als auch von der Dämmung des Hauses abhängig.

Insbesondere für Wärmepumpen, die '''nicht''' über einen leistungsgeregelten Verdichter verfügen, gibt es den interessanten Ansatz, die Einzelraumregler (ERR) und das Überströmventil der Wärmepumpe komplett ausser Betrieb zu nehmen und damit alle Heizkreise als ein "Heizkörper" zu betrachten. Diverse Foreneinträge (z.B. [http://www.haustechnikdialog.de/Forum/t/142011/Einstellungen-Alpha-Innotec-LWC80]) erzählen von bedeutenden Einsparungen durch Absenken der Solltemperatur und Wärmepumpen-freundlichen Betriebszyklen (lange Taktzeiten) und gehen auch detailiert auf durch die Luxtronik2 betriebene Wärmepumpen ein.

Ein detailierte Anleitung zum energiesparenden Betrieb einer Wärmepumpe findet man auf der folgenden Wiki-Seite: 
[[Effizienter Betrieb einer Fußbodenheizung mit Luft-Wasser-Wärmepumpe (Fallbeispiel)]]

=== Sperrzeiten ===
Die Luxtronik 2.0 erlaubt es, sich mit Hilfe von Sperrzeiten an zeitabhängige Strompreise anzupassen. Die Uhr der Steuerung geht jedoch sehr ungenau. Durch Setzen des Attributes "autoSynchClock" wird die Uhr der Steuerung regelmäßig mit der FHEM-Zeit abgeglichen. Die Funktion muss über das Attribut "allowSetParameter" freigegeben werden.
attr <device> allowSetParameter 1
attr <device> autoSynchClock 10

''Dies funktioniert nicht bei der Steuerungen Luxtronik 2.1 und bei der Firmware 2.xx, 3.xx oder 4.xx.''

==Abschätzung des elektrischen Verbrauches==
Über die Attribute "heatPumpElectricalPowerWatt", "heatPumpElectricalPowerFactor" und "heatRodElectricalPowerWatt" wird der elektrische Verbrauch während der Wärmeerzeugungen (Kompressormotor, Motor(en) der Wärmequelle) und der Heizstäbe festgelegt. Ist zudem das Attribute "doStatistics" auf 1 und der Werte "activeTariff" auf einen Wert zwischen 1 und 9 gesetzt, so berechnet das Modul anhand der Betriebsstunden automatisch den elektrischen Verbrauch innerhalb des angegebenen Stromtarifes.

Normalerweise wird eine Wärmepumpe mit einem zeitabhängigen Stromtarif betrieben (Doppeltarifzähler). Hierbei muss der Werte "activeTariff" zum jeweiligen Zeitpunkt über ein FHEM-Script gesetzt werden.
Beispiel:
define Strom_HT_W at *06:00 { if ( $wday != 0 ) {fhem( "set Heizung activeTariff 1" );;} }
define Strom_NT_W at *22:00 set Heizung activeTariff 2
define Strom_NT_Sa at *13:00 { if ( $wday == 6 ) {fhem( "set Heizung activeTariff 2" );;} }

==Verhalten der Steuerung Luxtronik 2.0==
Leider ist die Beschreibung des Steuerungsverhaltens in den Bedienungsanleitungen meist sehr oberflächlich gehalten. Die folgenden Erläuterungen benutzen die Abkürzungen (fett) der Webapplikation der Steuerung. 
Das notwendige Verständnis der Prozesstechnik einer Wärmepumpe erhält man z.B. auf den folgenden Seiten: [http://www.energie-experten.org/heizung/waermepumpe/technik/ www.energie-experten.org/heizung/waermepumpe/technik/]

===Abtauung des Verdampfers (Luftwärmetauschers) bei Luft-Wasser-Wärmepumpen===
Wird die Luft im Verdampfer unter den Taupunkt abgekühlt, so kommt es zur Ansammlung von Feuchtigkeit an den Bauteilen des Verdampfer. Liegt dabei die Temperatur an den Lamellen unter 0 °C (bzw. die Ausströmtemperatur der Luft knapp darüber) so vereist der Verdampfer. Diese Eisschicht wächst kontinuierlich und verschlechtert extrem die Wärmeübertragung aus der Luft in den Verdichterkreislauf.

Aus diesem Grund wird bei einer Außentemperatur unter 15°C der Verdampfer zyklisch abgetaut. Das Abtauen startet nach dem Ende der '''Ablaufzeit Abtauen''' (''heatSourceDefrostTimer'') des Verdichters.
Der Startwert der ''Ablaufzeit Abtauen'' liegt im Bereich '''Abtzyk min''' und '''Abtzyk max''' und wird bei Kreisumkehr (s.u.) nach jedem Abtauvorgang anhand der dafür benötigten Zeit neu bestimmt.

Bei Außentemperaturen zwischen 10°C und 15°C muss der Verdichter außerdem kontinuierlich 40 Minuten gelaufen sein. Während des Stillstandes des Verdichters wird bei ''Wärmequelle-Ein'' (''heatSourceIN'') oberhalb ''T-Luftabt.'' (''heatSourceDefrostAirThreshold'') die ''Ablaufzeit Abtauen'' (''heatSourceDefrostTimer'') wieder kontinuierlich (1s pro min) bis zum Wert '''Abtzyk min''' erhöht.

[[Datei:Luxtronik2-Luftabtauung.png|miniatur|Temperaturverlauf bei Luftabtauung (roter Pfeil)]]
Es gibt zwei Möglichkeiten des Abtauens:
# '''Luftabtauung: ''' nur oberhalb des Gefrierpunktes, etwas langsamer aber energiesparend
#: Die Luftabtauung wird nur gestartet, wenn zu Beginn des Abtauens die Temperatur '''Wärmequelle-Ein''' (''heatSourceIN'') oberhalb der Temperatur '''T-Luftabt.''' (''heatSourceDefrostAirThreshold'') liegt. Dann wird der Verdichter abgeschaltet und nur noch der Ventilator (''heatSourceMotor'') betrieben, um die Eisschicht mit der durchströmenden Luft abzutauen. Dabei steigt die Austrittstemperatur '''Wärmequelle-Aus''' (''heatSourceOUT'') bis auf ca. 0°C und das geschmolzene Eis beginnt abzulaufen. Ist der größte Teil des Eises geschmolzen, so steigt die Austrittstemperatur wieder. Die Luftabtauung wird beendet, wenn die ''Schaltspielsperre nach Verdichterstop'' (5 min) abgelaufen ist und die Temperatur '''Wärmequelle-Aus''' (''heatSourceOUT'') den Wert '''T-LABT-Ende''' (''heatSourceDefrostAirEnd'') erreicht hat oder wenn die Zeitbegrenzung '''Luft-Abt. max''' überschritten wird. Bei Überschreitung der Zeitbegrenzung wird per ''Kreisumkehr'' weiter abgetaut. Nach dem Ende der Luftabtauung wird die '''Ablaufzeit Abtauen''' (''heatSourceDefrostTimer'') auf den Wert '''Abtzyk min''' gesetzt.

# '''Kreisumkehr:''' schnell und energieintensiv
#: Bei der Kreisumkehr wird der Ventilator (''heatSourceMotor'') abgeschaltet und der Verdichter weiter betrieben. Über ein Vierwegeventil (Ausgang '''AV-Abtauventil''') wird der Verdichterkreislauf so umgekehrt, dass dem Heizwasserkreislauf Wärme entzogen und der Verdampfer aufgeheizt wird. Nach 10 Minuten oder beim Ansprechen des Abtauendepressostaten (Eingang '''ASD''') wird der Abtauvorgang beendet.
#: Vor dem Start des Abtauens erfolgt eine s. g. Durchflussüberwachung. Dabei wird geheizt und die Steuerung prüft, ob der Heizkreislauf genügend Durchfluss hat, um die nötige Wärmemenge für den Abtauvorgang zu Verfügung zu stellen. Die Durchflussüberwachung dauert 8 Minuten. In dieser Zeitspanne ist das erwärmte Wasser zumeist auch durch den Heizungskreislauf gewandert, steht wieder am Vorlauf an und wird dann durch den Abtauvergang wieder abgekühlt. Bei einer Außentemperatur über 5 °C oder einer Rücklauftemperatur über 40 °C wird die Durchflussüberwachung auf zwei Minuten gekürzt.

Kommt die Wärmepumpe vor dem Start der Luftabtauung zum Stehen, so taut der Verdampfer durch die Plusgrade der Umgebung auch von ganz allein ab, diese ist an der Temperatur ''Wärmequelle-Aus'' zu erkennen, wird von der Luxtronik aber leider nicht berücksichtigt.

Der Sensor ''Wärmequelle-Ein'' sitzt im Zuluftkanal in der Nähe des Verdampfers. Der Sensor ''Wärmequelle-Aus'' sitzt direkt '''im''' Verdampfer, misst also nicht die tatsächliche Lufttemperatur.

===Bivalenter Betrieb===
* '''Bivalenz Stufe'''
*: Damit wird über die HRM- und HRW-Zeit das Zuschalten weiterer Wärmequellen gesteuert:
*:: Stufe 1 = ein Verdichter darf laufen (Bei zwei Verdichtern werden diese in Abhängigkeit der '''Impulse Verdichter 1/2''' abwechselnd verwendet.)
*:: Stufe 2 = zwei Verdichter dürfen laufen, sofern die Außentemperatur den Wert '''Freig. 2.VD''' unterschritten hat. Statt dem 2. Verdichter kann auch eine parallel betriebene Wärmepumpe freigegeben werden.
*:: Stufe 3 = zusätzlicher Wärmeerzeuger 1 ('''ZWE 1''', z.B. Heizstäbe oder Kessel) darf mitlaufen, sofern die Außentemperatur den Wert '''Freig. ZWE''' unterschritten hat
*:: Stufe 4 = zusätzlicher Wärmeerzeuger 2 ('''ZWE 2''', z.B. Heizstäbe) darf mitlaufen, sofern die Außentemperatur den Wert '''Freig. ZWE''' unterschritten hat
*: Wenn die Rücklauftemperatur die Rücklauf-Solltemperatur und die maximale Rücklauferhöhung '''TR Erh max''' überschreitet, werden sofort alle Wärmeerzeuger abgeschaltet und die Bivalenzstufe 1 gesetzt.
*: Wenn in der Heizung die maximale Vorlauftemperatur '''Vorlauf max.''' überschritten wird, dann wird sofort ein Kompressor ausgeschalten und die Bivalenzstufe um den Wert 1 reduziert.
*: Bei der Warmwassererzeugung wird der zusätzliche Wärmeerzeuger erst nach der Zeit '''WW+WP max''' freigegeben.

* '''HRM-Zeit''' - Heizungsregler Mehr-Zeit
*: Die Zeit beginnt zu zählen, wenn die Wärmepumpe heizt und sich die Rücklauftemperatur '''unterhalb''' des Einschaltkriteriums ('''Rückl.Soll''' - '''Hyterese HR''') befindet.
*: Überschreitet diese Zeit einen bestimmten Wert, so wird in die nächst höhere ''Bivalenzstufe'' geschaltet, um zusätzliche Wärmeerzeuger zu aktiviert.
*: Die Bivalenzstufe 2 (zwei Verdichter) wird nach der '''HR Zeit''' (Standard 25 min) erreicht.
*: Die Bivalenzstufe 3 (ZWE 1) wird nach der Zeit '''Freig. ZWE''' (Standard 60 min) erreicht.
*: Die Bivalenzstufe 4 (ZWE 2) wird nach 120 min erreicht.

* '''HRW-Zeit''' - Heizungsregler Weniger-Zeit
*: Die Zeit beginnt zu zählen, wenn die Wärmepumpe heizt und sich die Rücklauftemperatur '''oberhalb''' des Ausschaltkriteriums ('''Rückl.Soll''' + '''Hyterese HR''') befindet.
*: Überschreitet diese Zeit einen bestimmten Wert (jeweils 15 min), so wird in die nächst niedrigere ''Bivalenzstufe'' geschaltet, um zusätzliche Wärmeerzeuger wieder zu deaktivieren.

===Automatische Sperren===
* '''SSP-Zeit''' - Ablaufzeit der Schaltspielsperre (SSP)
*: Es gibt zwei SSP-Ablaufzeit. Sie verzögern das erneute Starten des Verdichters für:
*:: 20 min ab letztem '''Ein'''schaltzeitpunkt des Verdichters, um die Belastung des Stromnetzes durch den erhöhten Anlaufstrom zu reduzieren.
*:: 5 min ab letztem '''Aus'''schaltzeitpunkt des Verdichters, um den Verdichterkreislauf zu schonen.
*: Das heisst, der Verdichter startet frühestens 20 min nach dem letzten Start, resp. 5 min nach dem letzten Stop. Es gibt also maximal 3 Anläufe pro Stunde.

===Heizkurve===
Die Heizkurve lässt sich über zwei Parameter einstellen
* Eine Veränderung des Heizkurven-Endpunktes (HKE) verändert die Steigung der Kurve indem es die Rücklauf-Solltemperatur ''rlSoll'' bei tiefen Temperaturen festlegt.
* Die Parallelverschiebung (PVS) des Heizkurven-Fusspunktes hebt oder senkt die komplette Kurve und verändert dabei auch die Steigung geringfügig.
* Bei einer "neutralen" Parallelverschiebung von 20°C wird bei -20°C Außentemperatur der Heizkurvenendpunkt als ''rlSoll'' eingestellt.
: Bei 20°C Außentemperatur liegt ''rlSoll'' auf dem Heizkurven-Fusspunkt von 20°C.
: Eine Erhöhung des Fusspunktes um 1°C erhöht auch ''rlSoll'' bei -20°C um 1°C.

Die Rücklauf-Solltemperatur ''rlSoll'' wird von der Steuerung in Abhängigkeit von der Außentemperatur wie folgt berechnet:
: rlSoll (Aussentemp) = PVS + (HKE - 20) * (PVS - Aussentemp) / (20 - (Aussentemp - PVS) / 2)

'''Beispiel''' 
Bei einer "neutralen" Parallelverschiebung von 20°C und einem Heizkurvenendpunkt von 30°C lautet der vereinfacht Term:
: rlSoll (Aussentemp) = 20 + 20 * (Aussentemp - 20) / (Aussentemp - 60)
D.h. rlSoll (20°C) = 20°C und rlSoll (-20°C) = 30°C

===Frostschutz und Heizgrenze===
Ist die '''Heizgrenze''' eingeschaltet, so schaltet die Steuerung in den Frostschutz-Modus (=Sommermodus), sobald die '''Mitteltemperatur''' (''averageAmbientTemperature'') die Heizgrenze (''thresholdHeatingLimit'') um 0,2 K überschreitet. Dabei wird die Rücklaufsolltemperatur (''returnTemperatureTarget'') auf die '''Min.Rückl.Solltemp.''' (z.B. 15 °C) absenkt.
Bei Luft-Wasser-Wärmepumpen wird die Rücklaufsolltemperatur auf 20 °C angehoben, sobald die '''Außentemperatur''' (''ambientTemperature'') 10 °C unterschreitet. 
Die ''Mitteltemperatur'' ist laut Handbuch der Durchschnitt der Außentemperatur der letzten 24 Stunden. Tatsächlich wird sie aber einmal pro Stunde aus einem reduzierten Mittelwert der letzten 11 Stunden gebildet.

Beim Unterschreiten der Solltemperatur startet der Heizvorgang (Frostschutz).

Empfehlung für die Heizgrenze:
* Altbau: 15°C
* Neubau: 12°C
* Passivhaus: 10°C

===Pumpenoptimierung===
Der Stromverbrauch einer durchgängig laufenden normalen Heizungsumwälzpumpe beträgt mehrere kWh pro Tag. Damit kann er in der Übergangszeit sogar im Bereich des Stromverbrauches des Verdichters liegen (z.B. 5 kWh/Tag). Durch den Einsatz engergiesparender Pumpen kann man ihn reduzieren. Die Funktion '''Pumpenoptimierung''' ist eine zusätzliche Möglichkeit, um durch bedarfsgesteuertes Abschalten der Heizungsumwälzpumpe Strom zu sparen.

Es gibt verschiedene Stufen:
# Liegt die Rücklauftemperatur 30 Minuten nach Ende des Heizvorganges noch über dem Sollwert (ohne Hysterese), so wird die Heizungspumpe für 30 min abgeschaltet.
# Liegt die Rücklauftemperatur nach Ende des Heizvorganges für die Dauer der '''Pumpenoptim.Zeit''' oberhalb des Sollwertes, so wird die Heizungspumpe abgeschaltet. Danach wird alle 30 Minuten wieder für 5 Minuten eingeschaltet, um die aktuelle Rücklauftemperatur des Heizungskreislaufes zu ermitteln. Liegt die Rücklauftemperatur nach den 5 Minuten unterhalb des Sollwertes so läuft die Heizungspumpe wieder dauerhaft.
# Sobald die Außentemperatur über der Rücklauf-Solltemperatur liegt, wird die Heizungspumpe dauerhaft abgeschaltet. Um ein Festsitzen der Pumpe zu vermeiden, wird sie alle 150 Stunden für eine Minute wieder eingeschaltet.

Die Pumpenoptimierung läuft nicht bei Außentemperaturen unter +1,0°C, um das Einfrieren von außen-aufgestellten Anlagen zu verhindern. Während der EVU-Sperre steht auch die Heizungsumwälzpumpe. Nach deren Ende läuft die Heizungsumwälzpumpe erst 5 Minuten ehe die Rücklauftemperatur ausgewertet wird.

Die Pumpenoptimierungszeit sollte möglichst klein gewählt werden, wenn eine Fussbodenheizung ohne Einzelraumregler betrieben wird und Räume unterschiedliche Temperaturen haben sollen, da sonst nach Abschalten der Wärmepumpe die wärmeren Räume schneller abkühlen und dabei die kälteren aufheizen.

==Firmware==
=== Firmware Bugs und Eigentümlichkeiten===
- bitte mit eigenen Beobachtungen ergänzen -

Lfd-Nr. 1 
Die Warmwassererwärmung führt zu einer starken Erhöhung der Temperatur im Heizkreislauf-Wärmetauscher der Wärmepumpe. Nach dem Zurückschalten auf den Heizungsbetrieb, speist der Puffer bis zur Abkühlung erstmal mit einer sehr hohen Temperatur in den Heizungskreislauf ein und verfälscht dadurch die Rücklauftemperatur stark. Die Heizungspumpe läuft zwar 2 Minuten nach aber in dieser Zeit wird die überhöhte Wärmetauschertemperatur nicht abgebaut. Bei eingeschalteter Pumpenoptimierung führt dies zu zu einer Zwangspause von entweder 30 Minuten oder bis der Temperaturfühler an der Rücklaufleitung durch den normalen Wärmeverlust unterhalb der Solltemperatur abgekühlt ist.

Lfd-Nr. 2 
Über das Webinterface kann man teilweise keine Ferienzeit von wenigen Tagen auswählen. Wurde in den aktuelleren Firmwareversionen behoben.

Lfd-Nr. 3 
Mittlere Außentemperatur wird nicht über die letzten 24 h bestimmt.

Lfd-Nr. 4 (Luft-Wasser-Wärmepumpen) 
Die Berücksichtigung der Natur-Luftabtauung (ohne Ventilator) von 1s/1min ist viel zu gering. Das müßte höher sein.

Lfd-Nr. 5 (Luft-Wasser-Wärmepumpen) 
Nach dem Heizungstakt könnte problemlos ein Luftabtauen erfolgen, damit für den nächsten Heizungstakt wieder an abgetauter Verdampfer zu Verfügung steht.

Lfd-Nr. 6 (Luft-Wasser-Wärmepumpen) 
Nach einer Luftabtauung wird der Heiztakt nicht zu Ende geführt, sondern erst wieder beim Unterschreiten der unteren Hysterese gestartet. Dadurch bleibt die Rücklauftemperatur eventuell dauerhaft unterhalb der Solltemperatur und die Raumtemperatur sinkt mit der Zeit ab.

Lfd-Nr. 7 (Luft-Wasser-Wärmepumpen) 
Fällt das Kreisumlaufabtauen auf das Ende des Heizzykluses so startet die Wärmepumpe nicht erneut. Der auf über 30°C erhitzte Wärmetauscher erwärmt nun die Luft in der Wärmepumpe. Bei Erreichen wird der Luftabtaugrenze wird der Ablauftimer auf den Mindestwert gesetzt und verliert die beim Kreisumkehr-Abtauen automatisch bestimmte höhere Ablaufzeit (meist in der Nähe der Maximalzeit).

Lfd-Nr. 8 (Luft-Wasser-Wärmepumpen) 
Fällt das Kreisumlaufabtauen auf das Ende des Heizzykluses so startet die Wärmepumpe erstmal nicht erneut. Durch die Kreisumkehr wurde jedoch ein Schub kalten Wassers im Heizungskreislauf gefangen. Dieser führt dann sehr schnell zu einem Absinken der Rücklauftemperatur und zu einem Neustart der Wärmepumpe.

Lfd-Nr. 9 (Luft-Wasser-Wärmepumpen) 
Das "natürliche" Abtauen wird nicht erkannt. Kommte die Wärmepumpe vor dem Ende der Abtauablaufzeit zum Stehen, so taut der Verdampfer bei positiven Umgebungstemperaturen von ganz alleine ab. Dies kann man Problemlos an der Temperatur ''Wärmequelle Aus'' erkennen, da diese durch die Schmelzenthalphie solange bei 0°C bleibt bis der Verdamper abtaut ist. Dann steigt sie auf die Höhe der Außentemperatur.

Lfd-Nr. 10 (Luft-Wasser-Wärmepumpen) 
Während des Abtauens durch Kreisumlauf wird dem Heizungskreislauf Wärme entzogen. Der Wärmemengen-Zähler zählt jedoch nicht rückwärts. Deshalb ist die von der Wärmepumpe ins Heizsystem eingebrachte Wärmemenge nicht korrekt. Tatsächlich wird ca. 5 % weniger Energie eingebracht und die Arbeitszahl ist ebenfalls ca. 5 % niedriger.

=== Nützliche Links ===
Die aktuelle Firmware gibt es [http://www.heatpump24.de/kontoeinst_104.php?layout=1 hier]

Eine Beschreibung der Java-Schnittstelle gibt es [http://www.loxwiki.eu/pages/viewpage.action?pageId=18219334 '''hier''']. Die Seite enthält auch eine Liste der Betriebsdaten (sog. berechnete Werte) die man mit ''get <device> rawdate'' anzeigen und mit dem Attribut ''userHeatpumpValues'' zum Gerät hinzufügen kann.

[[Kategorie:Other Components]]
[[Kategorie:Heizungssteuerung]]