FHEMWiki - Benutzerbeiträge [de]

Vitotronic 200 (Viessmann Heizungssteuerung)

2018-12-22T10:16:42Z

MarcelK: Links auf das neue openv-GitHub wiki geändert

{{Randnotiz|RNTyp=r|RNText=Die Verwendung des VCONTROL zur ''Ansteuerung'' eines Heizungssystems kann dieses bei unsachgemäßer Anwendung beschädigen. Für unmittelbare oder mittelbare Folgen, die sich aus dem Nachbau des Interfaces oder der Verwendung der hier zur Verfügung gestellten Information ergeben, übernimmt der Autor keine Haftung.}}
Eine angebundene [[Vitotronic 200 (Viessmann Heizungssteuerung)]] wird von FHEM über das Modul 89_VCONTROL.pm sowie das Modul 89_VCONTROL300.pm unterstützt. Beide Module senden direkt an die Viessmann-Anlage. Es gibt ein drittes Modul 89_VCLIENT.pm (hier der [https://forum.fhem.de/index.php/topic,78101.0.html Forenthread]), das auf dem Daemon vcontrold (siehe [https://github.com/openv/vcontrold diesen Link]) aufbaut und mit dem sich, wenn vcontrold läuft, ebenfalls die Anlage auslesen und steuern lässt. 89_VCONTROL.pm und 89_VCONTROL300.pm benötigen den Daemon nicht.

== Einleitung ==
 
{{Infobox Modul
|ModPurpose=Anbindung einer Viessmann Heizung
|ModType=d
|ModCmdRef=VCONTROL und VCONTROL300
|ModFTopic=20280
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=89_VCONTROL.pm
|ModOwner=adamwit ({{Link2FU|448|Forum}}/[[Benutzer Diskussion:Adam|Wiki]])
}}
Mit Hilfe verschiedener Zusatzgeräte ist es möglich, bei einer Viessmann-Heizung die Temperaturen, Timern, Verbrauch usw. auszulesen und verschiedene Heizungszustände (Heizen, Warm Wasser, Spar Modus, Party Modus) zu steuern.

== Hardware ==
Bevor die Heizung an FHEM angebunden werden kann, muss eine entsprechende Hardware vorliegen. Die Vitotronic weist zwei LEDs sowie ein eingefrästes Viessmann-V auf, das Bestandteil der Steuerung ist. Eine der beiden Diode dient der Steuerung als Empfangsgerät, während die andere Diode Signale sendet. Durch das eingefräste V kann ein entsprechend konstruiertes Gerät passgenau an die Heizung angeschlossen werden. Derzeit sind folgende Geräte bekannt, die mit der Vitotronic kommunzieren können:
* Optolink-Kabel (Originalbauteil Nr. 7856059, relativ teuer: um 100 €<ref>[https://github.com/openv/openv/wiki/Adapter-Eigenbau openv-Selbstbau-Anleitung]</ref> bzw. ca. 60 €<ref>[https://www.wolf-online-shop.de/Viessmann-Aschlussleitung-USB-Optolink-7856059::59899.html?gclid=EAIaIQobChMIzt-etMH31gIVncmyCh1Q1wSQEAQYASABEgLdrvD_BwE Wolf Online Shop]</ref>)
* selbstgebaute Geräte (zum Teil kommerziell angeboten, Eigenbau ist sehr preiswert - erfordert aber Lötmaterialien)

Der Eigenbau wird auf der eigens dazu errichteten Webseite [https://github.com/openv/openv/wiki/ openv] genauer beschrieben.
Man muss sich beim Eigenbau insbesondere mit der Frage befassen, über welche Schnittstelle die Hardware dann mit FHEM kommuniziert. Derzeit sind folgende Schnittstellen realisiert, deren Einbindung nach Aussage verschiedener Forenteilnehmer auch geglückt ist:
* USB
* seriell (Anschluss an RPi, dort RxTx)
* WLAN
* LAN
Die serielle Schnittstelle kann mit Hilfe des Programms [http://ser2net.sourceforge.net/ ser2net] auch auf eine LAN-Schnittstelle gemappt werden. Derzeit (Herbst 2017) entwickelt der Forumsteilnehmer PeMue ein allgemeines Modul, das sowohl per WLAN, USB als auch seriell an die Heizung angeschlossen werden kann: {{Link2Forum|Topic=51431|LinkText=Optolink Adapterplatine}}.

Bevor die Software angeschlossen wird, sollte man sich Informationen bezüglich der verwendeten Heizung sowie der entsprechenden Steuerung besorgen. Diese Angaben müssen bei der Definition des Gerätes sowie in der Konfigurationsdatei in FHEM angegeben werden.

== Software: Einbindung in FHEM ==
Es existieren momentan (2017) drei verschiedene Module, die eine Einbindung der Heizung in FHEM sicherstellen:
# 89_VCONTROL.pm,
# 89_VCONTROL300.pm
# 89_VCLIENT.pm
Das zweite Modul scheint eine schnellere Kommunikation zu ermöglichen und wird derzeit (Herbst 2017) aktiv weiterentwickelt.

Das dritte Modul setzt einen laufenden vcontrold-Daemon voraus, der die Kommunikation mit Viessmann übernimmt und wird hier nicht weiter beschrieben (siehe dazu diesen [https://forum.fhem.de/index.php/topic,78101.0.html Foreneintrag]).

Die Definition des Gerätes erfolgt bei den beiden ersten Modulen typischerweise wie folgt.
{{Randnotiz|RNText='''Weiterentwicklung'''
In {{Link2Forum|Topic=51167|LinkText=diesem Forenthread}} wird über Korrekturen und Bereinigungen im Modul berichtet. }}
defmod <name> VCONTROL300 <IP-Adresse>:3002 /opt/fhem/FHEM/VScotHO1_300.cfg 300 kw
In dem hier vorliegenden Fall wird das Modul 89_VCONTROL300.pm verwendet. Dieses kommuniziert mit einer LAN-Schnittstelle auf Port 3002 an der angegebenen IP-Adresse mit der Hardware. Im Fall eines USB-Anschluss muss der entsprechende Pfad auf die USB-Schnittstelle angegeben werden. Es wird alle 300 Sekunden abgefragt, das verwendete Protokoll lautet kw (eine andere Option besteht darin, das neuere Protokoll 300 zu verwenden).

Zur Konfiguration wird die Datei /opt/fhem/FHEM/VScotHO1_300.cfg verwendet. Details zu dieser Datei und ihrer Funktion werden im nächsten Abschnitt erläutert.

== Konfiguration ==

Um die Heizung mit FHEM zu verbinden, müssen die Daten zwischen der Heizungssteuerung und dem Perl-Server ausgetauscht werden. Die Werte in der Heizungssteuerung werden an speziellen Speicheradressen (die durch vierstellige Hexadezimalzahlen beschrieben werden) gesichert, im Viessmann-device befinden sich die entsprechenden Werte dagegen in Readings. Beide Werte müssen nun eindeutig einander zugeordnet werden. Diese Zuordnung gelingt durch die im define genannte Konfigurationsdatei *.cfg, die sowohl die Speicheradressen als auch die Readingsnamen enthält. Die Datei ist zeilenweise aufgebaut (je Zeile eine Zuordnung). Dabei wird noch zwischen Lesezugriff und Schreibzugriff unterschieden, da möglicherweise verschiedene Speicheradressen involviert sind.

Informationen zu den Speicheradressen findet man ebenfalls im Forum https://github.com/openv/openv/issues, in diesem Forum sind die Adressen teilweise als XML-Datei hinterlegt und müssen entsprechend übertragen werden. In der im Forum geposteten Datei [http://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=17498 Viessmann-Software-Config.zip] sind XML Dateien der original Viessmann-Software enthalten. Diese können nützlich sein, um Adressen für den eigenen Heizungstyp zu finden.

=== Daten lesen ===
Die Konfiguration geschieht mit Hilfe einer cfg-Datei, die von FHEM eingelesen wird. Die Einträge in dieser Datei sind von folgendem Format (wir beschränken uns hier auf das Modul VCONTROL300, für das Modul VCONTROL sind die Einträge analog aufgebaut - dort ist allerdings ein etwas erweitertes Adressformat zu verwenden):
POLL, <adresse>, <parse-methode>, <divisor>, <reading>, <kumulationsmethode>
Dies ist wie folgt zu verstehen. POLL zeigt an, dass Daten geholt werden. <adresse> ist die interne Viessmann-Adresse, die die zu holende Variable beherbergt. Dies ist typischerweise eine Hexadezimalzahl mit vier Stellen; beispielsweise findet man unter der Adresse 00F8 die Gerätekennung. Zum Teil können diese Adressen aus Dokumentation bezogen werden, ein Teil der Adressen ist auf der Webseite [https://github.com/openv/openv/wiki/Adressen von openv] dokumentiert. Nicht alle Adressen sind dabei korrekt, hier muss viel probiert werden.

<divisor> beschreibt, ob die Größe durch eben diesen Divisor dividiert werden soll (Temperaturangaben sind etwa in Zehntelgrad), <reading> nennt den Namen des FHEM-Readings. <kumulationsmethode> kennt die Einträge - (nicht kumulieren) und "day" (über den Tag hinweg addieren). Im letzten Fall werden dann jeweils nach Mitternacht die Werte des letzten Tages ebenfalls als Readings in das Device eingetragen; bei den Readingnamen wird dann jeweils DayStart,Today und LastDay angehangen. Diese Bezeichnungen können mit Readings des Devices angepasst werden.

<parse-methode> hat die folgenden Auswahlmöglichkeiten
* "1ByteS": Größe 1 Byte mit Vorzeichen,
* "2ByteS": Größe 2 Byte mit Vorzeichen
* "2ByteU": Größe 2 Byte ohne Vorzeichen
* "2ByteU_1stByte": Größe 2 Byte ohne Vorzeichen, 1.tes Byte (allerdings im Thread nicht angegeben)
* "2ByteU_2ndByte": Größe 2 Byte ohne Vorzeichen, 1.tes Byte
* "1ByteH": Größe 1 Byte, vermutlich (im Thread nicht angegeben) hexadezimalkodiert
* "2ByteH": Größe 2 Byte, vermutlich (im Thread nicht angegeben) hexadezimalkodiert
* "2BytePercent": nicht implementiert
* "4Byte": Größe 4 Byte
* "mode": einer der beiden Werte on, off
* "date": 8 Byte Datumswert (Beispiel: Do,28.09.2017 17:01:12)
* "timer": 8 Byte Timer Wert

Alle Größen, die mit timer kodiert sind, müssen mit einem expliziten Get-Befehl geholt werden und werden nicht automatisch gepollt. Ein User berichtet, dass diese Timerzeiten nur geholt werden konnten, nachdem das automatische Ausfüllen ("Mo-Fr automatic") in der Steuerung ausgeschaltet und jedem Tag ein individueller Wert zugewiesen wurde.

Ein Beispiel soll einen Eintrag in der cfg-Datei beschreiben:
POLL, 2306, 1ByteU, 1, Temperatur_Haus , -
Die Viessmann-Steuerung enthält an der Speicheradresse 0x2306 den Wert für die Solltemperatur des Hauptheizkreises (oft als M1 bezeichnet). Dieser Wert hat die Größe eines unsignierten Bytes (deshalb 1ByteU). Der Wert soll in FHEM im Reading Temperatur_Haus gespeichert werden. Es soll nur der aktuelle Wert gespeichert werden, die Werte werden über den Tag hinweg nicht addiert/kumuliert (deshalb der Strich am Ende).

=== Daten schreiben ===
Will man Daten senden, so ist folgendes Kommando zu verwenden
SET, <adresse>, <adresstyp>, <multiplikator>, <setname>, <nextset oder day>
Dies ist wie folgt zu verstehen. SET zeigt an, dass Daten gesendet werden. <adresse> ist die interne Viessmann-Adresse (oft, aber nicht immer, sind die Adressen der SET-Kommandos read/write; hier muss man in den Dokumentationen nachschauen). Wieder ist dies eine Hexadezimalzahl mit vier Stellen. Adresstyp entspricht der <parse-methode> oben und gibt an, ob es sich um eine 2Byte-, eine 1Byte- oder was auch immer -Adresse handelt. Als <multiplikator> wird oft 1 verwendet; setzt man hier eine Zahl ein, so wird der zu sendende Wert mit eben diesem Multiplikator multipliziert. Beim Kennwort "mode" und "state" für <multiplikator> können auch Zustände gesendet werden (unklar, wie genau). <setname> ist der Name, mit dem in FHEMWEB auf den Wert zugegriffen wird.

Dazu ein Beispiel. Im Reading "Temperatur_Haus" wird die Soll-Temperatur des Hauses gespeichert, die dazugehörige Kodierung sei 2306. Der entsprechende POLL-Eintrag in der *.cfg würde dann lauten
POLL, 2306, 1ByteU, 1, Temperatur_Haus , -
(sowohl die Adresse als auch die Übergabeform der Daten, hier 1ByteU, muss natürlich korrekt sein). Nun soll innerhalb von FHEM durch ein Befehl der Form
set <Viessmanndevice> Temperatur_Haus 25
versucht werden, die Temperatur auf 25 Grad einzustellen. Damit dies möglich ist, muss in der *.cfg folgende Zeile stehen (auch hier gilt: die Adresse muss korrekt sein und es muss möglich sein, in die Steuerung zu schreiben)
SET, 2306, 1ByteU, 1, Temperatur_Haus, <nextset oder day>
Nextset bedeutet, dass nach diesem SET-Befehl unmittelbar ein weiterer Setbefehl ausgelöst wird (und zwar genau der, der an dieser Stelle zu finden ist). Day wird nur dann verwendet, wenn der Adresstyp "time" war. In diesem Fall gibt day an, um welchen Wochentag, der einzustellen ist, es sich handelt. Hier sind nur Einträge der Form MO, DI bis SO möglich. Beispielsweise bedeutet
SET, 2028 , timer, 1, TIMER_Haus_SA , SA
dass das Reading TIMER_Haus_SA die Zeiten für die Heizung Samstags enthält, es sich um den Adresstyp timer handelt, die Daten in der Adresse 2028 kodiert sind und die von FHEM gesendeten Daten für Samstag festgeschrieben werden. Der FHEM-Befehl sähe dann so aus
set Heizung TIMER_Haus_SA 08:00,23:00,--,--,--,--,--,--,
Auslesen kann man die Daten dann mit
POLL, 2028, timer, 1 , TIMER_Haus_SA , -

Etwas umständlicher wird es, wenn eine Auswahlmöglichkeit mit vordefinierten Werten angegeben werden soll. Der Betriebszustand einer Vitotronic 100 HO1A beispielsweise kann nur die Werte 0 (nur_Warmwasser), 3 (Normalbetrieb) und 5 (Frostschutz) annehmen. Die entsprechende Adresse sei 3301. Ziel ist eine Dropdown-Liste in FHEM. Dies muss dann wie folgt in der cfg beschrieben werden
SET, 3301, mode, Betriebsart_Fussb , -
SET, 330100, 1ByteU, 1, nur_Warmwasser , -
SET, 330103, 1ByteU, 1, Normalbetrieb , -
SET, 330105, 1ByteU, 1, Frostschutz , -

Einige User haben bereits Ihre Heizungen mit der Hilfe diese Moduls angebunden:
* [http://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=20811 V200KW1.cfg]
* [http://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=21727 VPlusHO1.cfg]
* [http://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=21728 VScotHO1.cfg]
* [http://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=22863 V200WO1B.cfg]
* [http://forum.fhem.de/index.php?action=dlattach;topic=20280.0;attach=23767 V300KW3_V0002.cfg]
* [https://forum.fhem.de/index.php/topic,67744.msg692581.html#msg692581 Vitotronic 100 HO1A]
* besonders umfangreiche Materialien befinden sich [https://forum.fhem.de/index.php/topic,20280.msg611057.html#msg611057 in diesem Thread]

== Links ==
* Forenthema zur {{Link2Forum|Topic=51167|LinkText=Weiterentwicklung}} des Moduls
* neueste Version: [https://forum.fhem.de/index.php?action=profile;area=showposts;sa=attach;u=16142 hier]
* Forenthema/-umfrage {{Link2Forum|Topic=51431|LinkText=Optolink Adapterplatine}}
* [http://www.haustechnikdialog.de/SHKwissen/341/Heizkurve Heizkennlinie erläutert]

== Quellen ==
<references />

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

HomeMatic Firmware Update

2016-05-23T08:06:51Z

MarcelK: Typo

Seit 2014 ist es möglich, bei einigen [[HomeMatic]] Komponenten selbst Firmware Updates durchzuführen. Vorher ging das nur per CCU oder durch Einsenden des Gerätes an ELV.
Dabei gibt es verschiedene Möglichkeiten das Firmware Update durchzuführen. Um in Fhem die aktuelle Firmware nach dem Update angezeigt zu bekommen, ist ein erneutes Pairen mit Fhem notwendig. Es muss aber nicht gelöscht oder zurückgesetzt werden.

== Varianten für Firmwareupdates ==
=== Firmware Update mit CUL/HM-CFG-USB unter FHEM ===
FW Updates sind in FHEM möglich. Benötigt wird dafür ein [[CUL]] oder ein [[HM-CFG-USB USB Konfigurations-Adapter|HM-CFG-USB]]. Mit einem [[HMLAN]] ist ein Update nicht möglich.

Vor dem Update ist sicherzustellen, dass das korrekte IO für das Device genutzt wird (falls mehrere IOs im System zu Verfügung stehen). Siehe Attribut IODev und IOgrp bei der Verwendung einer vCCU.

Um das Update durchführen zu können, wird die in dem entsprechenden Zip-File vorhandene .eq3-Datei benötigt. Bitte genau darauf achten, dass nicht versehentlich eine falsches Firmware-Datei verwendet wird. Der Vorgang selbst erfolgt mittels folgendem Befehl:
:<code>set <device> fwUpdate <filename> <nowiki>[<time>]</nowiki></code>
<filename> ist der Name der .eq3 Datei inklusive absolutem oder relativem Pfad zu fhem-Root.
Die Angabe von [<time>] ist optional. Es ist die Zeit, die FHEM wartet, bis das Device in den Bootloader-Modus versetzt wird. Bei den meisten Devices ist die Zeit nicht notwendig, da FHEM das Gerät selbst in den Bootloader-Mode versetzen kann.

Bei einigen älteren FW-Versionen wie z.B. bei den [[HM-CC-RT-DN]] v1.0 geht das allerdings nicht automatisch. Um den Flashvorgang zu starten, müssen hier noch die Batterien entfernt werden und beim wiedereinlegen die beiden äußeren Knöpfe gedrückt werden. Jene Zeit, die man für eben diese Aktion benötigt, wird hier eingegeben.

Wichtig: während des Updates können keine weiteren Nachrichten in FHEM von Homematic verarbeitet werden.

Da nach dem Update immer noch die alte FW-Version in FHEM steht, kann man entweder bei einigen Geräten die Version mit
:<code> set <device> getVersion </code>
auslesen oder wenn das Kommando wie z.B. bei den oben genannten Heizkörperventilen nicht zur Verfügung steht, genügt es, am Gerät selbst die Anlerntaste zu drücken (was am Beispiel der RTs bedeutet, dass die Boost-Taste für mindestens drei Sekunden gedrückt werden muss). Nach der Aktualisierung der Firmware-Information in Fhem, muss die [[Konfiguration]] noch gespeichert werden.

=== Firmware Update mit CUL/HM-CFG-USB unter Linux ===
Für Linux hat mgernoth ein Updatetool erstellt.

Zunächst muss sichergestellt werden, dass alle benötigten Pakete installiert sind. Um das Tool zu installieren und auszuführen, müssen die folgenden Pakete mit den gezeigten Befehlen installiert werden. Unter Debian:
<source lang="bash">
sudo apt-get install libusb-1.0-0-dev git build-essential
</source>
Unter OpenSuse 13.2 64 Bit:
<source lang="bash">
sudo zypper install libusb-1.0-0-dev git
sudo zypper install --type pattern devel_basis
</source>

Als nächstes wird der Sourcecode für das Tool heruntergeladen (vorher z.B. in den Pfad <code>/usr/src</code> wechseln):
<source lang="bash">
git clone git://git.zerfleddert.de/hmcfgusb
</source>
Und mit den Anweisungen
<source lang="bash">
cd hmcfgusb
make
</source>
wird daraus eine ausführbare Datei erstellt.

Weiterhin muss die nötige Firmware heruntergeladen und entpackt werden. Die offiziellen Updates gibt es unter [http://www.eq-3.de/downloads.html eq-3 Downloads]. Die Befehle, um beispielsweise die benötigte Datei für die Firmware Version 1.4 des HM-CC-RT-DN zu erhalten lauten:
<source lang="bash">
wget http://www.eq-3.de/Downloads/Software/Firmware/hm_cc_rt_dn_update_V1_4_001_141020.tgz
tar xvzf hm_cc_rt_dn_update_V1_4_001_141020.tgz
</source>
Zu guter Letzt muss noch das Tool mit einigen Parametern und der Seriennummer des HomeMatic Devices aufgerufen werden. Für ein Update mit einem CUL (<code>/dev/ttyACM0</code> ist in diesem Beispiel die Adresse des CULs) muss folgendes eingegeben werden:
<source lang="bash">
sudo ./flash-ota -c /dev/ttyACM0 -f <FirmwareImageName>.eq3 -s <DeviceSerialNo>
</source>
Für ein Update mit einem COC muss folgendes eingegeben werden (/dev/ttyAMA0):
<source lang="bash">
sudo ./flash-ota -c /dev/ttyAMA0 -f <FirmwareImageName>.eq3 -s <DeviceSerialNo>
</source>
Für ein Update mit HM-CFG-USB
<source lang="bash">
sudo ./flash-ota -f <FirmwareImageName>.eq3 -s <DeviceSerialNo>
</source>
Nun muss nur noch das HomeMatic Gerät in den Update-Modus versetzt werden. Wie das geht, steht in der jeweils mit der Firmwaredatei gelieferten "readme".

=== Firmware Update mit HM-CFG-USB unter Windows ===
Für ein Firmwareupdate unter Windows wird das "HomeMatic Firmware Update Tool" von eq-3 benötigt: [http://www.eq-3.de/downloads.html eQ-3 Downloads]. Zur Zeit ist das Update damit nur mit dem HM-CFG-USB-2 möglich, nicht aber mit dem HM-CFG-LAN oder dem HM-CFG-USB der ersten Generation.

Nach dem Start muss die Seriennummer des HomeMatic-Device eingegeben und die Firmware-Datei ausgewählt werden. Dann wird das Update-Tool durch einen Klick auf den entsprechenden Button in "Bereitschaft" gesetzt und anschließend muss das HomeMatic-Gerät in den Update-Modus versetzt werden. Bei Unterputz-Geräten ist das eventuell gar nicht so einfach, man kann in diesem Fall aber von FHEM aus dem Gerät ein Kommando schicken um es in den Bootloader Modus zu bringen. Dies geht mit dem Befehl
:<code>set <device> fwUpdate onlyEnterBootLoader</code>
Direkt danach sollte das Update Tool mit seiner Arbeit beginnen.

Falls das Update-Tool beim Auswählen der Firmware-Datei abstürzt ("Home Matic Firmware Update Tool funktioniert nicht mehr"), dann stimmt wahrscheinlich etwas mit der Firmware-Datei nicht. Die Datei darf nicht ausgepackt, sondern muss als ".tar.gz"-Datei, so wie sie heruntergeladen wurde, benutzt werden. Es kann Probleme geben, wenn die Datei mit dem Internet Explorer heruntergeladen wurde. Am einfachsten ist es, die Datei mit einem anderen Browser herunterzuladen.

== Mögliche Probleme ==
Lässt sich die Firmware nicht OTA auf das HomeMatic-Device flashen, kann dies folgende Ursachen haben:
* Die Fhem-Software ist nicht auf dem neuesten Stand. Bitte vorher ein ''update'' durchführen.
* '''Entfernung''' zwischen Sender und Empfänger '''zu klein'''. 1,5 bis 2 m Abstand sollten beide Geräte zueinander mindestens haben.
* '''Entfernung''' zwischen Sender und Empfänger '''zu groß'''. Überprüfen Sie die RSSI-Werte des zu flashenden Device. Schlechter als - 70 sollten sie nicht sein (also keine - 75 oder noch kleiner). Ansonsten muss der Abstand für die Dauer des Flashens verringert werden.

== Tool zur Firmware Versionsprüfung ==
[[Datei:HM-FWUpdate-eQ3.png|mini|400px|right|Beispiel einer Liste der relevanten Firmware Updates '''Legende:''' 1 - Link auf die eQ-3 Download-Seite 2 - Link auf die Details des HTTPMOD Device 3 - Link auf die Details des HomeMatic Device 4 - (Download) Link auf die Firmware Datei 5 - "reread": Aktualisierung dieser Liste auslösen]]
Im Fhem-Forum wurden unter dem Titel {{Link2Forum|Topic=47729|LinkText=...Firmware Versionsprüfung}} die erforderlichen Definitionen für ein [[HTTPMOD]]-Device vorgestellt, das
* für alle HomeMatic Devices der aktuellen Fhem-Umgebung
* die derzeit benutzte Firmware Version mit
* einem evtl. auf der eQ-3 Seite verfügbaren Update vergleicht und
* alle für die aktuelle Installation relevanten Updates in einer Übersicht (siehe Screenshot) darstellt und
* einmal täglich (alle 86400 Sekunden) automatisch ausgeführt wird; dieses Intervall sollte nicht verkürzt, sondern eher verlängert werden. Im Bedarfsfall kann durch anklicken von '''''reread''''' eine sofortige Aktualisierung ausgelöst werden.
 
{{Randnotiz|RNTyp=y|RNText=Sollte eine alte (vor dem 15.3.2016) Version dieser Definitionen bereits in Benutzung sein (zu erkennen am Vorhandensein von ''<nowiki>reading0[2|3|4|5]*</nowiki>''-Attributen), dann wird empfohlen, das Device mit <code>delete eq3</code> zunächst komplett zu löschen und anschließend neu anzulegen.}}
Die unten aufgeführten erforderlichen Anweisungen zur Erstellung dieser Übersicht sind
* im wesentlichen über das Webinterface eingebbar (können aber auch "en bloc" in die fhem.cfg eingetragen werden - auch wenn das eigentlich nicht empfohlen ist)
* der umfangreiche Perl-Code für das Attribut ''userReadings'' ist dargestellt für die Eingabe über das [[FHEMWEB|Webinterface]]
* für das Attribut ''stateFormat'' ist die mehrzeilige Eingabe (zumindest derzeit, März 2016) nicht unterstützt, daher wurde der Code in eine Subroutine ausgelagert
 {{Randnotiz|RNTyp=r|RNText='''Wichtige Änderungen:'''
22.05.2016 - ''reading01Regex'' und ''reading01Format'' angepasst (eQ-3)
}} 

=== Basis-Definitionen für Device eq3 ===
<source lang="text">
define eq3 HTTPMOD http://www.eq-3.de/ajax/downloads.php 86400
attr eq3 userattr enableControlSet event-on-change-reading event-on-update-reading reading01AutoNumLen reading01Format reading01Name reading01RegOpt reading01RegOpt:s,i,g reading01Regex readingMaxAge readingMaxAgeReplacementMode readingMaxAgeReplacementMode:text,expression,delete requestData.* showError showMatched stateFormat userReadings webCmd
attr eq3 enableControlSet 1
attr eq3 event-on-change-reading .*
attr eq3 event-on-update-reading LAST_ERROR,MATCHED_READINGS
attr eq3 reading01AutoNumLen 2
attr eq3 reading01Format http://www.eq-3.de/%s
attr eq3 reading01Name fw_link
attr eq3 reading01RegOpt g
attr eq3 reading01Regex <a.href="(Downloads\/Software\/Firmware\/[^"]+)
attr eq3 readingMaxAge 10
attr eq3 readingMaxAgeReplacementMode delete
attr eq3 requestData.* suchtext=&suche_in=2&downloadart=11
attr eq3 room eq3
attr eq3 showError 1
attr eq3 showMatched 1
attr eq3 stateFormat {eq3StateFormat}
attr eq3 webCmd reread
</source>

=== Definition/Code für Attribut userReadings ===
Der "Zugang" zur Eingabe des Attributs ''stateFormat'' erfolgt über die Details des Device '''eq3''' (URL: ...8083/fhem?detail=eq3).
[[Datei:HM-FWUpdate-eQ3-userReadings.png|mini|640px|left|"Der Weg" zur Eingabe von ''userReadings''; durch Klick in das Eingabefeld öffnet sich ein separates Fenster.]]
 Der Perl-Code, der für das Attribut ''userReadings'' eingegeben werden muss:
<source lang="perl">
newFwForDevices:MATCHED_READINGS:.* {
my $ret = "";
my @data;
my @eq3FwList = map{@data = ReadingsVal("eq3","fw_link-".$_,"?") =~ m/Firmware\/(.*?)_update_V([\d_]+)_(\d\d)(\d\d)(\d\d)/;
$data[0] =~ s/_/-/g;
sprintf("%s:%s:%s.%s.%s:%s",$data[0],$data[1],$data[4],$data[3],"20".$data[2],$_);
} ReadingsVal("eq3","MATCHED_READINGS","?") =~ m/fw_link-(\d\d)/g;

foreach my $dev (devspec2array("TYPE=CUL_HM:FILTER=DEF=......:FILTER=subType!=(virtual|)")) {
my $md = AttrVal($dev,"model","?");
my $v = AttrVal($dev,"firmware","0.0");
my ($h,$l) = split('\.',$v);
foreach my $newFw (grep m/^${md}:/i,@eq3FwList) {
my ($nh,$nl,$no,$date,$idx) = $newFw =~ m/^[^:]+:(\d+)_(\d+)_?(\d*):([^:]+):(\d\d)$/;
if(($nh > $h) || (($nh == $h) && ($nl > $l))) {
$ret .= "," if($ret ne "");
$ret .= $dev." (".$md." | fw_".$v." => fw".$idx."_".$nh.".".$nl.($no?sprintf(".%d",$no):"")." | ".$date.")";
}
}
}
return ($ret eq "")?"no fw-updates needed!":$ret;
}
</source>

=== Definition/Code für Attribut stateFormat ===
Da der Code für ''stateFormat'' recht umfangreich ist, wäre er als Einzeiler kaum sinnvoll zu verwalten, würde also ohnehin meistens über einen externen Editor bearbeitet werden. Daher wurde er als eigene (Sub-)Routine mit dem Namen ''eq3StateFormat'' in (z.B.) [[99_myUtils anlegen|99_myUtils]] ausgelagert:
<source lang="perl">
sub eq3StateFormat() {
my $name = "eq3";

my $ret ="";
my $lastCheck = ReadingsTimestamp($name,"MATCHED_READINGS","???");
$ret .= '<div style="text-align:left">';
$ret .= 'last <a title="eq3-downloads" href="http://www.eq-3.de/downloads.html">homematic</a>-fw-check => '.$lastCheck;
$ret .= ' ';
$ret .= '<pre>';
$ret .= "| device | model | old_fw | new_fw | release |\n";
$ret .= "------------------------------------------------------------------------------------\n";
my $check = ReadingsVal($name,"newFwForDevices","???");
if($check eq "no fw-updates needed!") {
$ret .= '| '.$check.' |';
} else {
my @devices = split(',',$check);
foreach my $devStr (@devices) {
my ($dev,$md,$ofw,$idx,$nfw,$date) = $devStr =~ m/^([^\s]+)\s$([^\s]+)\s\|\sfw_(\d+\.\d+)\s=>\sfw(\d\d)_([\d\.]+)\s\|\s([^$]+)\)$/;
my $link = ReadingsVal($name,"fw_link-".$idx,"???");
$ret .= '| ';
$ret .= '<a href="/fhem?detail='.$dev.'">';
$ret .= sprintf("%-23s",$dev);
$ret .= '</a>';
$ret .= " | ";
$ret .= '<b'.(($md eq "?")?' title="missing attribute model => set device in teach mode to receive missing data" style="color:yellow"':' style="color:lightgray"').'>';
$ret .= sprintf("%-23s",$md);
$ret .= '';
$ret .= " | ";
$ret .= '<b'.(($ofw eq "0.0")?' title="missing attribute firmware => set device in teach mode to receive missing data" style="color:yellow"':' style="color:lightgray"').'>';
$ret .= sprintf("%6s",$ofw);
$ret .= '';
$ret .= " | ";
$ret .= '<a title="eq3-firmware.tgz" href="'.$link.'">';
$ret .= '';
$ret .= sprintf("%6s",$nfw);
$ret .= '';
$ret .= '</a>';
$ret .= " | ";
$ret .= sprintf("%-10s",$date);
$ret .= " |\n";
}
}
$ret .= '</pre>';
$ret .= '</div>';
return $ret;
}
</source>

=== Sondersituationen ===
[[Datei:HM-FWUpdate-eQ3-check.png|mini|455px|right|Fehlerbedingung: Attribut ''firmware'' nicht gesetzt]]
Das Tool überprüft gleichzeitig auch bestimmte Rahmenbedingungen, so z.B., ob bei allen HomeMatic Devices die Attribute ''model'' und ''firmware'' gesetzt sind. Sollte das nicht der Fall sein, wird das Device in der Liste
* mit einem gelben "old_fw" Wert von 0.0 geführt; befindet sich der Mauszeiger über dem "0.0", wird der Hinweistext ''missing attribute firmware => set device in teach mode to receive missing data'' angezeigt (siehe Beispiel im Screenshot)
* mit einem gelben {{Taste|?}} in der Spalte "model" angezeigt; befindet sich der Mauszeiger über dem "?", wird der Hinweistext ''missing attribute model => set device in teach mode to receive missing data'' angezeigt
In diesem Fall sollte bei dem betreffenden Gerät versucht werden, mit ''getConfig'' die Daten zu aktualisieren bzw. vervollständigen.

Darüber hinaus ist zu beachten, dass die Firmware-Version in den HomeMatic Geräten zwei"teilig" (Version.Release) abgelegt ist, die Firmware Update-Dateien jedoch drei"teilige" Versionskennungen (Version_Release_???) haben. Für den Vergleich, ob neue Firmware verfügbar ist, kann natürlich nur die zweiteilige Kennung verwendet werden, eine Änderung im dritten Teil der Versionskennung kann daher nicht automatisch erkannt werden.

== Links ==
* [http://www.eq-3.de/downloads.html Firmware Download] Seite von eq-3
* Forenthread zur {{Link2Forum|Topic=47729|LinkText="Firmware Versionsprüfung"}}
* [http://git.zerfleddert.de/hmcfgusb/ Firmware Update Tool] von mgernoth

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HM-ES-TX-WM Zählersensor für Strom- und Gaszähler

2016-05-16T21:23:38Z

MarcelK: Details zu neuen Kanälen hinzugefügt

{{Infobox Hardware
|Bild=HM-EM-TX-WM.jpg
|Bildbeschreibung=HomeMatic Zählersensor
|HWProtocol=HomeMatic
|HWType=Powersensor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=6 V
|HWPowerConsumption=30 mA
|HWPoweredBy=4 Batterien LR6/AA/Mignon
|HWSize=68x105x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

'''Dieses Device ist seit Anfang Feb. 2015 als Bausatz auf dem Markt - dieser Artikel ist im Aufbau - bitte Verständnis für Unvollständigkeiten und fehlende Bereiche '''

== Features ==
Der Zählersensor ist ein Datenerfassungssystem, das den Energieverbräuche (Strom, Gas) direkt am Zähler erfasst und in FHEM als laufender Saldo und als Momentanwerte verfügbar macht.

'''Technische Daten:'''

Gewicht: 195 g (inkl. 4 LR6/Mignon/AA-Batterien)

== Anwendungsszenarien ==
Mit den erfassten und gesammelten Daten lassen sich Aktionen beim Erreichen bestimmter Schwellwerte auslösen, Verbrauchs- und Kostenstatistiken erstellen sowie beliebige weitere Abhängigkeiten bilden. Durch die Funkdatenübertragung sowie den Batteriebetrieb (1 bis 2 Jahre Betriebsdauer verspricht der Hersteller mit einem Satz) ist die Installation denkbar einfach und erfordert lediglich beim Anbringen der Leseeinheit Genauigkeit.

Im Februar 2015 hat die Auslieferung der Geräte als (einfacher) Bausatz begonnen, zu dem es
* einen Ferraris-Sensor (für Stromzähler mit den markanten Laufscheiben),
* LED-Sensor (für neue Zähler mit S0-Schnittstelle) sowie
* BK-G4-Gaszähler von Elster-Kromschröder (die an einer Ziffernrolle einen kleinen Magneten haben, der über einen Sensor mit Reedkontakt erfasst wird)
gibt. Es ist laut Hersteller [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html ELV] nur der Bausatz verfügbar. Ein Fertiggerät ist aktuell nicht geplant.

Die Zähler werden mit rückstandslos entfernbaren Klebepads angebracht.

== Parameter ==
'''list: register | range | peer | description'''
0: pairCentral | 0 to 16777215 | | pairing to central
1: mtrConstGas | 0 to 655.36 | | constant gas
1: mtrConstIr | 0 to 65536 | | constant IR
1: mtrConstLed | 0 to 65536 | | constant led
1: mtrSensIr | -99 to 99 | | sensiblity IR
1: mtrType | literal | | type of measurement options:LED,gas,unknown,IR

== Probleme ==
Der HM-ES-TX-WM sendet zyklisch im 3-Minuten Takt die aktuellen Verbrauchsdaten. Dabei ist für das Reading "power" (aktuelle Stromleistung in Watt) zu beachten, dass alle drei Minuten der ''zuletzt bekannte Wert'' gesendet wird. Das heißt im Besonderen:

* Sollten innerhalb der drei Minuten mehrfach Impulse auftreten mit unterschiedlichen Leistungswerten, wird nur der zuletzt bekannte Wert genommen. Es findet keine Aggregation der Impulse (Mittelwert, Summe, …) statt.
* Sollten innerhalb der drei Minuten keinerlei Impulse auftreten, wird dennoch der zuletzt bekannte Leistungswert gesendet, auch wenn er mehrere Minuten/Stunden/Tage alt ist.

Der state des Devices zeigt den letzten Übertragungsstatus an das Device, das Geräte unterstützt keinen Burst. D.h. einen an das Gerät abgesetzten Befehl z.B. getConfig oder einstellen von Zählerkonstanten sollte man möglichst am Geräte bestätigen, sonst könnte es sein, dass ein ACK zu spät zurück kommt und man sich anschließend im state über ein NACK wundert.

Scheinbar gibt es für das reading energy bei 838860.7 einen Zählerüberlauf. [http://forum.fhem.de/index.php/topic,32827.msg270012.html#msg270012]

== Betrieb mit FHEM ==
Der Sensor wird mit einem FHEM im Update-Stand vom (mindestens) 7.2.2015 funktionsfähig eingebunden (getestet in der Variante mit Ferraris-Fühler). Es werden der Fühlertyp und die Fühlerkonstante richtig ausgelesen und im Reading ''energy'' die errechnete Energiemenge ausgegeben (bei Strom: Wattstunden, Wh).

Für die perfekte Konfiguration wird auf die Seite "[[Heizleistung und Gasverbrauch]]" verwiesen, wo eine vollständige Lösung für die Umrechnung von Gasverbrauch in kW/h, Graphen und Hilfsprogramme vorgestellt wird.

=== Readings ===
'''Reading: |Beispiel'''
D-firmware |1.0
D-serialNr |MEQ0025452
battery |ok
boot |off
current |0
eState |E: 6199.9 P: 1713 I: 0 U: 0 f: 50
energy |6199.9
energyOffset |84413.2
frequency |50
power |1713
powerOn |2015-03-26 14:57:48
voltage |0

=== Events Auszug ===
'''Event |Beispielswert'''
battery* |ok
energy |10186.6
power |283
current |0
voltage |0
frequency |50
eState |E: 10186.6 P: 283 I: 0 U: 0 f: 50
boot |off

Ein battery-Event wird nicht zyklisch getriggert. Erst wenn die Batterie tatsächlich leer ist, wird eine entsprechende Meldung vom Gerät selber gesendet und ein battery-Event getriggert (battery: low).

Mit einem Userreading lässt sich die Angabe aus ''energy'' (zum Beispiel für einen Stromzähler (Wh)) in die auf dem Zähler übliche Angabe kWh umrechnen und zugleich mit dem Aufaddieren des Unterschieds beim Start (das Zählermodul beginnt ja mit 0 Wh, während der Zähler meist schon einige Jahre auf der "Rolle" hat) die Angaben gleichziehen:
:<code><nowiki>attr <DeviceName> userReadings kWh {sprintf("%.1f",ReadingsVal("<DeviceName>","energy","???")/1000+72031.5639)}</nowiki></code>

=== Konfiguration ===
Nach dem Erkennen durch [[autocreate]] wird der Zählersensor mit diesen Angaben eingebunden:

define CUL_HM_HM_ES_TX_WM_353594 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594 IODev CUL_0
attr CUL_HM_HM_ES_TX_WM_353594 actCycle 000:10
attr CUL_HM_HM_ES_TX_WM_353594 actStatus alive
attr CUL_HM_HM_ES_TX_WM_353594 expert 2_full
attr CUL_HM_HM_ES_TX_WM_353594 firmware 1.0
attr CUL_HM_HM_ES_TX_WM_353594 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594 subType powerSensor

Für den Betrieb mit den verschiedenen Zählern muß eines der Readings '''R-mtrConst'''XXX auf den jeweiligen verwendeten Zähler konfiguriert werden. Z.B. kann ein Ferraris-Stromzähler 100, 150 oder 200 Umdrehungen je kWh benötigen. Dies geschieht z.B. für 150 Meldungen je Einheit für einen Ferraris-Zähler mit dem Befehl
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstIr 150</code>

oder für einen Gaszähler auf der 1. Rolle (d.h. 1 Impuls je 0.1 m^3)
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstGas 0.1</code>

In Fhem bis zum Anfang November 2015 war hier ein kleiner Bug enthalten, der diesen Wert nicht akzeptierte. In diesem Fall läßt sich die Anzahl der Impulse direkt am Gerät über das Display einstellen.

== Logging/Graph. Darstellung ==
[[Datei:PlotStromverbrauchProStunde.png|mini|400px|rechts|Beispiel der graph. Darstellung]]
Der Zähler wird fortlaufend aufaddiert. Mit der delta-Funktion von SVG-Plot können die Verbräuche sehr gut visualisiert werden.
Beispiel Stromzähler:

set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'Stündlicher Stromverbrauch | aktuell: $data{currval1} ($data{min1} / $data{avg1} / $data{max1}) kWh'
set ytics
set y2tics
set grid ytics
set ylabel "kWh/h"
set y2label "kWh/h"
#FileLog 4:CUL_HM_HM_ES_TX_WM_353594.kWh\x3a:0:delta-h
plot "<IN>" using 1:2 axes x1y2 title 'Line 1' ls l0 lw 2 with bars

== Wiki ToDo ==
Seit dem FHEM Update vom 06.03.2016 werden bei Neueinrichtung mit Autocreate 2 Kanäle angelegt. Dies entspricht der Firmware Revision 1.1:
* _IEC_01
Im Gas-Modus werden hier die Werte geliefert.

* _IEC_02
Im IR-Modus kommen hier die Werte an.
state enthält dabei den Wert des readings energy. Möchte man hier z.B. die im letzten Zeitfenster gemessene Leistung anzeigen lassen, reading power, so hilft das Attribut stateformat
<code>{sprintf("P: %.1f W", ReadingsVal($name,"power",0))}</code>

== Firmwareupdate ==
Das Gerät lässt sich in den Updatemodus versetzen, im dem die Batterien zunächst entfernt, dann beim Einsetzen die Anlerntaste gedrückt bleibt. die Leuchtdiode blinkt dann rot im schnellen Takt. Das FHEM-Kommando zum Senden der Firmware per <code>set <devicename> fwUpdate <Firmwaredatei.eq3></code> muss vor dem Einlegen der Batterie (+ ">" Taste) aufgegeben werden. Erfolgt zum Zeitpunkt des Anstartens im Updatemodus keine Sendung der Firmware wird der Zählersensor normal gebootet. Die Meldung <code> <devicename> fwUpdate: fail:notInBootLoader</code> im Filelog erscheint, wenn das FHEM fwUpdate Kommando ''zu spät'' gesendet wurde.

Der Update dauert etwa eine Minute. Während des Updates blinkt die Diode rot in kurzen Intervallen.
Nach erfolgreichen Update muss der Sensor auf die Werkseinstellungen zurückgesetzt (">" Taste 4 Sekunden drücken (Display zeigt reS), kurz warten, ">" noch mal 4 Sekunden drücken - Zählersensor rebootet), aus der FHEM Konfiguration entfernt und neu angelernt werden.

Wenn der Reset nicht durchgeführt wird, kommt vom Sensor immer die Fehlermeldung: einmal langes und drei mal kurzes rotes Blinken (Sitz des Auslesekopfes prüfen). Diese Meldung ist in diesem Zusammenhang ziemlich irreführend.

Dieser Vorgang ist im changelog.txt file der Firmware unvollständig beschrieben, da hier ein Update an der CCU vorausgesetzt wird und die CCU die Firmware wohl automatisch sendet.

== Links ==
* Handbuch [http://files.elv.de/Assets/Produkte/14/1401/140143/Downloads/140143_sensor_um.pdf]
* Produktseite ELV: [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html]
* Forum [http://forum.fhem.de/index.php/topic,32827.msg252161.html#msg252161]
* Forum [http://forum.fhem.de/index.php/topic,30936.msg234877.html#msg234877]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:Energieerzeugungsmessung]]

HomeMatic Firmware Update

2016-05-15T23:00:31Z

MarcelK: Erklärung zur onlyEnterBootLoader Option bei Update mittels Windows hinzugefügt

Seit 2014 ist es möglich, bei einigen [[HomeMatic]] Komponenten selbst Firmware Updates durchzuführen. Vorher ging das nur per CCU oder durch Einsenden des Gerätes an ELV.
Dabei gibt es verschiedene Möglichkeiten das Firmware Update durchzuführen. Um in Fhem die aktuelle Firmware nach dem Update angezeigt zu bekommen, ist ein erneutes Pairen mit Fhem notwendig. Es muss aber nicht gelöscht oder zurückgesetzt werden.

== Varianten für Firmwareupdates ==
=== Firmware Update mit CUL/HM-CFG-USB unter FHEM ===
FW Updates sind in FHEM möglich. Benötigt wird dafür ein [[CUL]] oder ein [[HM-CFG-USB USB Konfigurations-Adapter|HM-CFG-USB]]. Mit einem [[HMLAN]] ist ein Update nicht möglich.

Vor dem Update ist sicherzustellen, dass das korrekte IO für das Device genutzt wird (falls mehrere IOs im System zu Verfügung stehen). Siehe Attribut IODev und IOgrp bei der Verwendung einer vCCU.

Um das Update durchführen zu können, wird die in dem entsprechenden Zip-File vorhandene .eq3-Datei benötigt. Bitte genau darauf achten, dass nicht versehentlich eine falsches Firmware-Datei verwendet wird. Der Vorgang selbst erfolgt mittels folgendem Befehl:
:<code>set <device> fwUpdate <filename> <nowiki>[<time>]</nowiki></code>
<filename> ist der Name der .eq3 Datei inklusive absolutem oder relativem Pfad zu fhem-Root.
Die Angabe von [<time>] ist optional. Es ist die Zeit, die FHEM wartet, bis das Device in den Bootloader-Modus versetzt wird. Bei den meisten Devices ist die Zeit nicht notwendig, da FHEM das Gerät selbst in den Bootloader-Mode versetzen kann.

Bei einigen älteren FW-Versionen wie z.B. bei den [[HM-CC-RT-DN]] v1.0 geht das allerdings nicht automatisch. Um den Flashvorgang zu starten, müssen hier noch die Batterien entfernt werden und beim wiedereinlegen die beiden äußeren Knöpfe gedrückt werden. Jene Zeit, die man für eben diese Aktion benötigt, wird hier eingegeben.

Wichtig: während des Updates können keine weiteren Nachrichten in FHEM von Homematic verarbeitet werden.

Da nach dem Update immer noch die alte FW-Version in FHEM steht, kann man entweder bei einigen Geräten die Version mit
:<code> set <device> getVersion </code>
auslesen oder wenn das Kommando wie z.B. bei den oben genannten Heizkörperventilen nicht zur Verfügung steht, genügt es, am Gerät selbst die Anlerntaste zu drücken (was am Beispiel der RTs bedeutet, dass die Boost-Taste für mindestens drei Sekunden gedrückt werden muss). Nach der Aktualisierung der Firmware-Information in Fhem, muss die [[Konfiguration]] noch gespeichert werden.

=== Firmware Update mit CUL/HM-CFG-USB unter Linux ===
Für Linux hat mgernoth ein Updatetool erstellt.

Zunächst muss sichergestellt werden, dass alle benötigten Pakete installiert sind. Um das Tool zu installieren und auszuführen, müssen die folgenden Pakete mit den gezeigten Befehlen installiert werden. Unter Debian:
<source lang="bash">
sudo apt-get install libusb-1.0-0-dev git build-essential
</source>
Unter OpenSuse 13.2 64 Bit:
<source lang="bash">
sudo zypper install libusb-1.0-0-dev git
sudo zypper install --type pattern devel_basis
</source>

Als nächstes wird der Sourcecode für das Tool heruntergeladen (vorher z.B. in den Pfad <code>/usr/src</code> wechseln):
<source lang="bash">
git clone git://git.zerfleddert.de/hmcfgusb
</source>
Und mit den Anweisungen
<source lang="bash">
cd hmcfgusb
make
</source>
wird daraus eine ausführbare Datei erstellt.

Weiterhin muss die nötige Firmware heruntergeladen und entpackt werden. Die offiziellen Updates gibt es unter [http://www.eq-3.de/downloads.html eq-3 Downloads]. Die Befehle, um beispielsweise die benötigte Datei für die Firmware Version 1.4 des HM-CC-RT-DN zu erhalten lauten:
<source lang="bash">
wget http://www.eq-3.de/Downloads/Software/Firmware/hm_cc_rt_dn_update_V1_4_001_141020.tgz
tar xvzf hm_cc_rt_dn_update_V1_4_001_141020.tgz
</source>
Zu guter Letzt muss noch das Tool mit einigen Parametern und der Seriennummer des HomeMatic Devices aufgerufen werden. Für ein Update mit einem CUL (<code>/dev/ttyACM0</code> ist in diesem Beispiel die Adresse des CULs) muss folgendes eingegeben werden:
<source lang="bash">
sudo ./flash-ota -c /dev/ttyACM0 -f <FirmwareImageName>.eq3 -s <DeviceSerialNo>
</source>
Für ein Update mit einem COC muss folgendes eingegeben werden (/dev/ttyAMA0):
<source lang="bash">
sudo ./flash-ota -c /dev/ttyAMA0 -f <FirmwareImageName>.eq3 -s <DeviceSerialNo>
</source>
Für ein Update mit HM-CFG-USB
<source lang="bash">
sudo ./flash-ota -f <FirmwareImageName>.eq3 -s <DeviceSerialNo>
</source>
Nun muss nur noch das HomeMatic Gerät in den Update-Modus versetzt werden. Wie das geht, steht in der jeweils mit der Firmwaredatei gelieferten "readme".

=== Firmware Update mit HM-CFG-USB unter Windows ===
Für ein Firmwareupdate unter Windows wird das "HomeMatic Firmware Update Tool" von eq-3 benötigt: [http://www.eq-3.de/downloads.html eQ-3 Downloads]. Zur Zeit ist das Update damit nur mit dem HM-CFG-USB-2 möglich, nicht aber mit dem HM-CFG-LAN oder dem HM-CFG-USB der ersten Generation.

Nach dem Start muss die Seriennummer des HomeMatic-Device eingegeben und die Firmware-Datei ausgewählt werden. Dann wird das Update-Tool durch einen Klick auf den entsprechenden Button in "Bereitschaft" gesetzt und anschließend muss das HomeMatic-Gerät in den Update-Modus versetzt werden. Bei Unterputz-Geräten ist das eventuell gar nicht so einfach, man kann in diesem Fall aber von FHEM aus dem Gerät ein Kommando schicken um es in den Bootloader Modus zu bringen. Dies geht mit dem Befehl
:<code>set <device> fwUpdate onlyEnterBootloader</code>
Direkt danach sollte das Update Tool mit seiner Arbeit beginnen.

Falls das Update-Tool beim Auswählen der Firmware-Datei abstürzt ("Home Matic Firmware Update Tool funktioniert nicht mehr"), dann stimmt wahrscheinlich etwas mit der Firmware-Datei nicht. Die Datei darf nicht ausgepackt, sondern muss als ".tar.gz"-Datei, so wie sie heruntergeladen wurde, benutzt werden. Es kann Probleme geben, wenn die Datei mit dem Internet Explorer heruntergeladen wurde. Am einfachsten ist es, die Datei mit einem anderen Browser herunterzuladen.

== Mögliche Probleme ==
Lässt sich die Firmware nicht OTA auf das HomeMatic-Device flashen, kann dies folgende Ursachen haben:
* Die Fhem-Software ist nicht auf dem neuesten Stand. Bitte vorher ein ''update'' durchführen.
* '''Entfernung''' zwischen Sender und Empfänger '''zu klein'''. 1,5 bis 2 m Abstand sollten beide Geräte zueinander mindestens haben.
* '''Entfernung''' zwischen Sender und Empfänger '''zu groß'''. Überprüfen Sie die RSSI-Werte des zu flashenden Device. Schlechter als - 70 sollten sie nicht sein (also keine - 75 oder noch kleiner). Ansonsten muss der Abstand für die Dauer des Flashens verringert werden.

== Tool zur Firmware Versionsprüfung ==
[[Datei:HM-FWUpdate-eQ3.png|mini|400px|right|Beispiel einer Liste der relevanten Firmware Updates '''Legende:''' 1 - Link auf die eQ-3 Download-Seite 2 - Link auf die Details des HTTPMOD Device 3 - Link auf die Details des HomeMatic Device 4 - (Download) Link auf die Firmware Datei 5 - "reread": Aktualisierung dieser Liste auslösen]]
Im Fhem-Forum wurden unter dem Titel {{Link2Forum|Topic=47729|LinkText=...Firmware Versionsprüfung}} die erforderlichen Definitionen für ein [[HTTPMOD]]-Device vorgestellt, das
* für alle HomeMatic Devices der aktuellen Fhem-Umgebung
* die derzeit benutzte Firmware Version mit
* einem evtl. auf der eQ-3 Seite verfügbaren Update vergleicht und
* alle für die aktuelle Installation relevanten Updates in einer Übersicht (siehe Screenshot) darstellt und
* einmal täglich (alle 86400 Sekunden) automatisch ausgeführt wird; dieses Intervall sollte nicht verkürzt, sondern eher verlängert werden. Im Bedarfsfall kann durch anklicken von '''''reread''''' eine sofortige Aktualisierung ausgelöst werden.
 
{{Randnotiz|RNTyp=y|RNText=Sollte eine alte (vor dem 15.3.2016) Version dieser Definitionen bereits in Benutzung sein (zu erkennen am Vorhandensein von ''<nowiki>reading0[2|3|4|5]*</nowiki>''-Attributen), dann wird empfohlen, das Device mit <code>delete eq3</code> zunächst komplett zu löschen und anschließend neu anzulegen.}}
Die unten aufgeführten erforderlichen Anweisungen zur Erstellung dieser Übersicht sind
* im wesentlichen über das Webinterface eingebbar (können aber auch "en bloc" in die fhem.cfg eingetragen werden - auch wenn das eigentlich nicht empfohlen ist)
* der umfangreiche Perl-Code für das Attribut ''userReadings'' ist dargestellt für die Eingabe über das [[FHEMWEB|Webinterface]]
* für das Attribut ''stateFormat'' ist die mehrzeilige Eingabe (zumindest derzeit, März 2016) nicht unterstützt, daher wurde der Code in eine Subroutine ausgelagert

=== Basis-Definitionen für Device eq3 ===
<source lang="text">
define eq3 HTTPMOD http://www.eq-3.de/ajax/downloads.php 86400
attr eq3 userattr enableControlSet event-on-change-reading event-on-update-reading reading01AutoNumLen reading01Format reading01Name reading01RegOpt reading01RegOpt:s,i,g reading01Regex readingMaxAge readingMaxAgeReplacementMode readingMaxAgeReplacementMode:text,expression,delete requestData.* showError showMatched stateFormat userReadings webCmd
attr eq3 enableControlSet 1
attr eq3 event-on-change-reading .*
attr eq3 event-on-update-reading LAST_ERROR,MATCHED_READINGS
attr eq3 reading01AutoNumLen 2
attr eq3 reading01Format http://www.eq-3.de%s
attr eq3 reading01Name fw_link
attr eq3 reading01RegOpt g
attr eq3 reading01Regex <a.href=\"(\/Downloads\/Software\/Firmware\/[^"]+)\"
attr eq3 readingMaxAge 10
attr eq3 readingMaxAgeReplacementMode delete
attr eq3 requestData.* suchtext=&suche_in=2&downloadart=11
attr eq3 room eq3
attr eq3 showError 1
attr eq3 showMatched 1
attr eq3 stateFormat {eq3StateFormat}
attr eq3 webCmd reread
</source>

=== Definition/Code für Attribut userReadings ===
Der "Zugang" zur Eingabe des Attributs ''stateFormat'' erfolgt über die Details des Device '''eq3''' (URL: ...8083/fhem?detail=eq3).
[[Datei:HM-FWUpdate-eQ3-userReadings.png|mini|640px|left|"Der Weg" zur Eingabe von ''userReadings''; durch Klick in das Eingabefeld öffnet sich ein separates Fenster.]]
 Der Perl-Code, der für das Attribut ''userReadings'' eingegeben werden muss:
<source lang="perl">
newFwForDevices:MATCHED_READINGS:.* {
my $ret = "";
my @data;
my @eq3FwList = map{@data = ReadingsVal("eq3","fw_link-".$_,"?") =~ m/Firmware\/(.*?)_update_V([\d_]+)_(\d\d)(\d\d)(\d\d)/;
$data[0] =~ s/_/-/g;
sprintf("%s:%s:%s.%s.%s:%s",$data[0],$data[1],$data[4],$data[3],"20".$data[2],$_);
} ReadingsVal("eq3","MATCHED_READINGS","?") =~ m/fw_link-(\d\d)/g;

foreach my $dev (devspec2array("TYPE=CUL_HM:FILTER=DEF=......:FILTER=subType!=(virtual|)")) {
my $md = AttrVal($dev,"model","?");
my $v = AttrVal($dev,"firmware","0.0");
my ($h,$l) = split('\.',$v);
foreach my $newFw (grep m/^${md}:/i,@eq3FwList) {
my ($nh,$nl,$no,$date,$idx) = $newFw =~ m/^[^:]+:(\d+)_(\d+)_?(\d*):([^:]+):(\d\d)$/;
if(($nh > $h) || (($nh == $h) && ($nl > $l))) {
$ret .= "," if($ret ne "");
$ret .= $dev." (".$md." | fw_".$v." => fw".$idx."_".$nh.".".$nl.($no?sprintf(".%d",$no):"")." | ".$date.")";
}
}
}
return ($ret eq "")?"no fw-updates needed!":$ret;
}
</source>

=== Definition/Code für Attribut stateFormat ===
Da der Code für ''stateFormat'' recht umfangreich ist, wäre er als Einzeiler kaum sinnvoll zu verwalten, würde also ohnehin meistens über einen externen Editor bearbeitet werden. Daher wurde er als eigene (Sub-)Routine mit dem Namen ''eq3StateFormat'' in (z.B.) [[99_myUtils anlegen|99_myUtils]] ausgelagert:
<source lang="perl">
sub eq3StateFormat() {
my $name = "eq3";

my $ret ="";
my $lastCheck = ReadingsTimestamp($name,"MATCHED_READINGS","???");
$ret .= '<div style="text-align:left">';
$ret .= 'last <a title="eq3-downloads" href="http://www.eq-3.de/downloads.html">homematic</a>-fw-check => '.$lastCheck;
$ret .= ' ';
$ret .= '<pre>';
$ret .= "| device | model | old_fw | new_fw | release |\n";
$ret .= "------------------------------------------------------------------------------------\n";
my $check = ReadingsVal($name,"newFwForDevices","???");
if($check eq "no fw-updates needed!") {
$ret .= '| '.$check.' |';
} else {
my @devices = split(',',$check);
foreach my $devStr (@devices) {
my ($dev,$md,$ofw,$idx,$nfw,$date) = $devStr =~ m/^([^\s]+)\s$([^\s]+)\s\|\sfw_(\d+\.\d+)\s=>\sfw(\d\d)_([\d\.]+)\s\|\s([^$]+)\)$/;
my $link = ReadingsVal($name,"fw_link-".$idx,"???");
$ret .= '| ';
$ret .= '<a href="/fhem?detail='.$dev.'">';
$ret .= sprintf("%-23s",$dev);
$ret .= '</a>';
$ret .= " | ";
$ret .= '<b'.(($md eq "?")?' title="missing attribute model => set device in teach mode to receive missing data" style="color:yellow"':' style="color:lightgray"').'>';
$ret .= sprintf("%-23s",$md);
$ret .= '';
$ret .= " | ";
$ret .= '<b'.(($ofw eq "0.0")?' title="missing attribute firmware => set device in teach mode to receive missing data" style="color:yellow"':' style="color:lightgray"').'>';
$ret .= sprintf("%6s",$ofw);
$ret .= '';
$ret .= " | ";
$ret .= '<a title="eq3-firmware.tgz" href="'.$link.'">';
$ret .= '';
$ret .= sprintf("%6s",$nfw);
$ret .= '';
$ret .= '</a>';
$ret .= " | ";
$ret .= sprintf("%-10s",$date);
$ret .= " |\n";
}
}
$ret .= '</pre>';
$ret .= '</div>';
return $ret;
}
</source>

=== Sondersituationen ===
[[Datei:HM-FWUpdate-eQ3-check.png|mini|455px|right|Fehlerbedingung: Attribut ''firmware'' nicht gesetzt]]
Das Tool überprüft gleichzeitig auch bestimmte Rahmenbedingungen, so z.B., ob bei allen HomeMatic Devices die Attribute ''model'' und ''firmware'' gesetzt sind. Sollte das nicht der Fall sein, wird das Device in der Liste
* mit einem gelben "old_fw" Wert von 0.0 geführt; befindet sich der Mauszeiger über dem "0.0", wird der Hinweistext ''missing attribute firmware => set device in teach mode to receive missing data'' angezeigt (siehe Beispiel im Screenshot)
* mit einem gelben {{Taste|?}} in der Spalte "model" angezeigt; befindet sich der Mauszeiger über dem "?", wird der Hinweistext ''missing attribute model => set device in teach mode to receive missing data'' angezeigt
In diesem Fall sollte bei dem betreffenden Gerät versucht werden, mit ''getConfig'' die Daten zu aktualisieren bzw. vervollständigen.

Darüber hinaus ist zu beachten, dass die Firmware-Version in den HomeMatic Geräten zwei"teilig" (Version.Release) abgelegt ist, die Firmware Update-Dateien jedoch drei"teilige" Versionskennungen (Version_Release_???) haben. Für den Vergleich, ob neue Firmware verfügbar ist, kann natürlich nur die zweiteilige Kennung verwendet werden, eine Änderung im dritten Teil der Versionskennung kann daher nicht automatisch erkannt werden.

== Links ==
* [http://www.eq-3.de/downloads.html Firmware Download] Seite von eq-3
* Forenthread zur {{Link2Forum|Topic=47729|LinkText="Firmware Versionsprüfung"}}
* [http://git.zerfleddert.de/hmcfgusb/ Firmware Update Tool] von mgernoth

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

FHEMWEB

2016-02-03T19:40:19Z

MarcelK: Kurzer Eintrag zum neuen Attribut "title"

{{Infobox Modul
|ModPurpose=Standard Fhem-Webfrontend
|ModType=h
|ModForumArea=Frontends
|ModTechName=01_FHEMWEB.pm
|ModOwner=Rudolf König/rudolfkoenig ({{Link2FU|8|Forum}}/[[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}

[[FHEMWEB]] ist das Standard Webfrontend von Fhem, es implementiert auch einen einfachen Webserver (optional mit Basic-Auth und HTTPS). Aus historischen Gründen wird es auch als [[PGM2]] bezeichnet.

== Voraussetzungen ==
keine.

== Anwendung ==
=== Define ===
siehe commandref.
=== Attribute ===
siehe commandref.

== Anwendungsbeispiele ==
=== devStateIcon ===
* Beispiel für FS20 {{Link2Forum|Topic=26521|Message=197326}}

=== sortby ===
* Beispiele zur Sortierung mit sortby: {{Link2Forum|Topic=11940|Message=70664}}, {{Link2Forum|Topic=26733|Message=197127}}

=== title ===
* Titel der Seite. Überschreibt das globale Attribut "title", das ansonsten für alle FHEMWEB Instanzen gilt
* Beispiel für einen dynamischen Seiten-Titel: {{Link2Forum|Topic=48668|Message=403260}}

=== webCmd ===
* ...

=== widgetOverride ===
Mit dem Attribut <code>widgetOverride</code> kann ein anderes als das vom Modulautor vorgegebene Bedienelement für einen Parameter (set/get/Attribut) festgelegt werden. Beispiele:
* [[WifiLight#Color-Picker_aktivieren|Color-Picker]]
* [[EnOcean-FUD61NPN-Funk-Universal-Dimmaktor#Anzeige_eines_alternativen_Bedienelementes|knob]]
* usuzu (= universelle Zeitschaltuhr): {{Link2Forum|Topic=32660}}

== Links ==
* Begriffserklärung zur Unterscheidung von [[eventMap]], [[devStateIcon]], [[webCmd]] und [[setList]] mit Beispielen in diesem {{Link2Forum|Topic=12080|LinkText=Forenthread}}
* [[Icons]]

[[Kategorie:FHEM Frontends]]

Systemübersicht

2016-01-29T22:41:43Z

MarcelK:

Ein Fhem '''System''' besteht im Prinzip aus den in der nachfolgenden '''Übersicht''' aufgeführten Bestandteilen.
[[Datei:Systemübersicht.png]]

<div style="float: right;">__TOC__</div>

== Server ==
Bei der Komponente '''Server''' muss unterschieden werden zwischen dem eigentlichen '''Fhem''' Hausautomations-Server (implementiert in der Perl-Datei fhem.pl) und der Hardware, auf der dieser Server ausgeführt wird.

Als Server '''Hardware''' sind (z. B.) möglich:
* Windows Rechner
* Linux Rechner
* OS X Rechner
* Router (z. B. [[AVM Fritz!Box|FritzBox]])
* Einplatinencomputer, wie [[:Kategorie:Raspberry Pi|Raspberry Pi]], BeagleBone
* DockStar, PogoPlug, etc.
* diverse NAS Systeme wie Buffalo Linkstation, Synology Diskstation
(Diese Aufstellung ist nur eine unvollständige Auswahl; Details zu unterstützten Server Systemen finden sich in der Kategorie [[:Kategorie:Server Hardware|Server Hardware]]).

== Konfiguration ==
Das Hausautomations-System wird definiert über die [[Konfiguration]], die im Regelfall besteht aus der
* reinen Textdatei <code>fhem.cfg</code> (Standard nach der Erstinstallation) oder alternativ einer
* [[configdb|SQL-Datenbank]]

Die Konfiguration enthält Definitionen für die Bestandteile (Geräte) und Funktionen des jeweiligen Hausautomations-Systems. Die verfügbaren Befehle und deren Syntax sind in der Befehlsreferenz ([http://fhem.de/commandref.html commandref]) aufgeführt und beschrieben. Zu einigen Hilfsmodulen gibt es [[:Kategorie:Hilfsmodul|detaillierte Beschreibungen]] mit Beispielen.

== Benutzeroberfläche ==
Der Zugriff auf FHEM erfolgt mittels Webbrowser oder App über die verfügbaren '''[[:Kategorie:FHEM Frontends|Fhem Benutzeroberflächen]]'''.

In den Fhem Server integriert ist ein Webserver ([[PGM2]]), der im Prinzip immer zur Verfügung steht. Abhängig vom benutzten Klienten ist PGM2 über
* <code>serverhostnameoderIP:8083/fhem</code> (Desktop-Darstellung = Port 8083),
* <code>serverhostnameoderIP:8084/fhem</code> (Smartphone-Darstellung = Port 8084) oder
* <code>serverhostnameoderIP:8085/fhem</code> (Tablet-Darstellung = Port 8085)
erreichbar.

Eine Auswahl der Benutzeroberflächen:
* PGM2 - das Standardinterface
* [[FLOORPLAN]]
* [[FHEM Tablet UI]]
* [[SmartVisu]]
* diverse Apps für iOS und Android (Auswahl unter: [[:Kategorie:FHEM Frontends|Fhem Benutzeroberflächen]])

Beispielhafte Screenshots diverser Benutzeroberflächen: http://fhem.de/fhem.html#Screenshots

== Module ==
Die Funktionalität von Fhem kann über '''Module''' erweitert werden. Module können die unterschiedlichsten Aufgaben übernehmen vom Anbinden eines Hardwaresystems
über die Bereitstellung eines Frontends bis zur Automatisierung von Aufgaben. Beispiele für Module:
* 00_CUL.pm - Implementierung der Unterstützung für den [[CUL]]
* 11_FHT.pm - Unterstützung der [[:Kategorie:FHT Components|FHT]] Heizungssteuerung
* 95_FLOORPLAN.pm - Grundriss (oder Ähnliches) als Benutzeroberfläche
* ...

Module können unterteilt werden in
* [[:Kategorie:FhemBefehl|Befehlsmodule]] (FhemBefehle sind teilweise eigenständige Module)
* [[:Kategorie:Hilfsmodul|Hilfsmodule]]
* [[:Kategorie:Gerätemodul|Gerätemodule]]
Die offiziell in Fhem enthaltenen Module sind in der [http://fhem.de/commandref Commandref] beschrieben. Sie werden über den [[Update]]-Befehl von Fhem verteilt und aktualisiert. Voraussetzung für die Aufnahme als offizielles Modul sind Supportwille durch den Entwickler und Dokumentation des Moduls.

Zusätzlich existiert eine Vielzahl von [[:Kategorie:Modul (Inoffiziell)|inoffiziellen Modulen]], die manuell in Fhem installiert werden müssen. Auch die Aktualisierung erfolgt nicht über den Update-Befehl, sondern muss durch den Nutzer selbst erfolgen. Inoffizielle Module sind an den verschiedensten Stellen zu finden:
* [[:Kategorie:Modul (Contrib)|Contrib]]-Verzeichnis im offiziellen Fhem-Sourcecode-SVN [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/]
* Beiträge im Fhem-Forum
* private Homepages

== Interfaces ==
Die Verbindung zu den angeschlossenen '''Geräten''' der Hausautomation wird im Allgemeinen - geräteabhängig - über [[Interface|Interfaces]] (manchmal auch als '''Gateway''' bezeichnet) hergestellt. Das kann z. B. im Falle von [[HomeMatic]] ein [[HMLAN Konfigurator]] sein, ein mittels LAN mit dem Fhem Server verbundenes Gerät, das die Fhem Steuerbefehle in das HomeMatic Funkprotokoll umsetzt - und auch die Funktelegramme der HomeMatic Komponenten an Fhem zurückgibt. Entsprechende Interfaces gibt es auch für andere Funkprotokolle und für die drahtgebundenen Systeme.

Eine (unvollständige) Liste solcher Interfaces (siehe auch [[:Kategorie:Interfaces|Kategorie Interfaces]]):
* [[CUL]] - je nach Einstellung für die Kommunikation mit [[:Kategorie:FS20 Components|FS20]], [[:Kategorie:FHT Components|FHT]] und andere [[SlowRF]] Protokolle, [[MAX|MAX!]] Heizungssteuerung oder [[:Kategorie:HomeMatic Components|HomeMatic]] und, mit Einschränkungen, InterTechno (nur senden)
* [[CUNO]], ähnlich CUL, jedoch nicht per USB sondern per IP angebunden (z.Zt. -Stand Januar 2014 - nicht für HomeMatic empfohlen)
* [[HMLAN Konfigurator|HomeMatic LAN Konfigurations-Adapter]] - HomeMatic
* [[MAX#MAXLAN|MAX! Cube LAN-Gateway]]
* Schnittstellen(karten) für [[:Kategorie:1-Wire|1-Wire]]
* TCM(120/310) zur Anbindung von [[:Kategorie:EnOcean Components|EnOcean]]
* [[Arduino]] mit Firmata über USB oder Netzwerk
* [[panStamp]] als Möglichkeit Arduinos mit diversen Sensor- und I/O- Boards per 868MHz Funk über das SWAP protokoll anzubinden
* [[JeeLink]], ein weiteres USB-Stick Interface (ebenfalls arduino basiert) für diverse 433MHz und 868MHz Komponenten
* [[RFXtrx]] für InterTechno, RSL, ELRO etc., Wetter-Sensoren (Oregon-Scientific, Cresta, La Crosse, TFA, UPM) und andere 433 Mhz Geräte.
* manche Komponenten ([[:Kategorie:IP Components|IP Komponenten]]) können über TCP/IP (LAN) direkt vom Fhem Server aus angesprochen werden; hier ist dann kein weiteres Interface im eigentlichen Sinne erforderlich. Dies gilt auch für diverse Module die Geräte über WEB Dienste des Herstellers anbinden (z. B. Withings, [[netatmo]]).

== Protokolle ==
Der Kommunikation zwischen Interfaces und Geräten liegt jeweils ein bestimmtes Protokoll zugrunde. Unterstützte Protokolle mit ihren Eigenschaften sind in der folgenden Tabelle aufgelistet.


{| class="wikitable sortable"
|+ Übersicht über unterstützte Funkprotokolle
|-
! Name !! rfMode !! Frequenz !! Modulation !! Datenrate !! class="unsortable" | Interfaces !! class="unsortable" | Modul !! class="unsortable" | Geräte (Beispiel) !! class="unsortable" | Bemerkungen
|-
| [[FS20_Allgemein|FS20]] || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#FS20 FS20] || - || -
|-
| FHT || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#CUL_FHTTK FHTTK], [http://fhem.de/commandref.html#FHT FHT] || Heizungsregelung || -
|-
| S300 || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#CUL_WS CUL_WS] || Temperatur-/Feuchtesensoren || -
|-
| HMS || SlowRF || 868,35MHz || AM || 1kHz || CU*O, FHZ || - || ?? || -
|-
| EM || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || [http://fhem.de/commandref.html#CUL_EM CUL_EM] || Energiemonitore (Strom, Gas) || -
|-
| [[HomeMatic ]]|| HomeMatic || 868,3MHz || FM || 10kHz || CU*, [[HM-CFG-LAN_LAN_Konfigurations-Adapter|HMLan]], [[HM-CFG-USB_USB_Konfigurations-Adapter|HMUsb]] || [http://fhem.de/commandref.html#CUL_HM CUL_HM] || [[:Kategorie:HomeMatic_Components|diverse]] || -
|-
| [[MAX|MAX!]] || MAX || 868,3MHz || FM || 20kHz || CU*, [[MAX#MAXLAN|MAXLAN]] || [http://fhem.de/commandref_DE.html#MAX MAX] || [[:Kategorie:MAX|Wandthermostat, Heizkörperthermostate, Fensterkontakt, Zwischenstecker]] || -
|-
| IT || - || 433MHz || AM? || 1kHz || CU*433, || - || - || -
|-
| FRM || - || ?? || ?? || ?? || ?? || - || ?? || -
|-
| SWAP || - || 868 (433/915) MHz || GFSK || 38.3835 Kbps || panStamp (+panStick) || [http://fhem.de/commandref.html#SWAP SWAP] || RGB LED Driver, diverse Sensoren und Aktoren || -
|-
| [[:Kategorie:EnOcean Components|EnOcean]] || - || 315 / 868 / 902 / 928MHz || ASK || 125 kbit/s || [http://fhem.de/commandref.html#TCM TCM] || [http://fhem.de/commandref.html#EnOcean EnOcean] || Batterielose Funksensoren, diverse Aktoren || -
|-
| PCA || - || 868,35MHz || ?? || ?? || [[JeeLink]] || [http://fhem.de/commandref.html#PCA301 PCA301] || [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]] || -
|-
| LaCrosse || - || 868,35MHz || ?? || ?? || [[JeeLink]] || [http://fhem.de/commandref.html#LaCrosse LaCrosse] || LaCrosse IT+ (Technoline) Sensoren || -
|-
| ZigBee Light Link || - || 2,4 GHz || || || HUE Bridge (RaspBee) || [http://fhem.de/commandref.html#HUEBridge HUEBridge] || Philips HUE und LightLink Lampen (auch Osram LIGHTIFY an der HUE-Bridge)|| [http://www.developers.meethue.com/documentation/how-hue-works]
|-
| [[:Kategorie:Z-Wave Components|Z-Wave]] || - || 868MHz || 2-FSK || 9.600 bit/s oder 40 Kbit/s || [http://fhem.de/commandref.html#ZWDongle ZWDongle] || [http://fhem.de/commandref.html#ZWave ZWave] || - || -
|-
| [[WMBUS]] || WMBus_T, WMBus_S || 868MHz || ?? || 100 kbit/s / 32.768 kbit/s || CU* || [http://fhem.de/commandref.html#WMBUS WMBUS] || Wasseruhren, Wärmezähler, Elektrozähler || -
|-
| colspan="9" | ''Tabelle muss noch vervollständigt werden''
|-
| colspan="2" | '''Legende:'''
| colspan="7" | CU* = CUL, CUN, CUNO /
|}

{| class="wikitable sortable"
|+ Übersicht über drahtgebundene Systeme
|-
! Name !! class="unsortable" | Interfaces (Hardware) !! class="unsortable" | Modul !! class="unsortable" | Geräte (Beispiel) !! class="unsortable" | Bemerkungen
|-
| [[1-Wire]] || [[Interfaces für 1-Wire|diverse]] || [http://fhem.de/commandref.html#OWX OWX] || [[:Kategorie:1-Wire|1-Wire]] || -
|-
| [[EIB_/_KNX|EIB/KNX]] || [http://fhem.de/commandref.html#TUL TUL] || [http://fhem.de/commandref.html#EIB EIB] || [[:Kategorie:EIB/KNX|EIB/KNX]] || -
|-
| [[HomeMatic Wired]] || [[HomeMatic Wired RS485 LAN Gateway|HM485 LAN Gateway]] || [http://fhem.de/commandref.html#HM485_LAN HM485_LAN] || [[:Kategorie:HomeMatic Components|Präfix HMW]] || -
|-
| colspan="5" | ''Tabelle muss noch vervollständigt werden''
|-
| colspan="2" | '''Legende:'''
| colspan="3" | ...
|}

== Komponenten ==
Der eigentliche Zweck eines Hausautomatisierungs-Projekts sind dann letztendlich die '''Geräte''' (Komponenten / Aktoren / [[:Kategorie:Schalter (Empfänger)|Empfänger]]), die automatisch gesteuert werden sollen, bzw. auch Auslöser für Aktionen ([[:Kategorie:Schalter (Sender)|Sender]]) und Lieferant von Datenmaterial ([[:Kategorie:Hardware Typen|Sensoren]]) sind.

Diese Geräte sind, sofern es eine detaillierte Beschreibung dazu gibt, in den jeweiligen Unterseiten der [[:Kategorie:Hardware|Hardwareliste]] aufgeführt.

== Weblinks ==
* [http://www.enocean.com/de/home/ EnOcean] Homepage
* [http://www.elv.de ELV], (Haupt-)Lieferant von FS20, FHT, HomeMatic, MAX!
* [http://www.panstamp.com panStamp], panStamp Hersteller
* [http://jeelabs.com/products/jeelink Jeelabs], JeeLink Hersteller
* [http://www.zigbee.org/ Zigbee] Homepage

[[Kategorie:FHEM]]