FHEMWiki - Benutzerbeiträge [de]

Structure

2017-04-18T20:10:58Z

Jorge3711: /* Define */ Typos gefixt

{{SEITENTITEL:structure}} 
{{Infobox Modul
|ModPurpose=Zusammenfassung von Geräten (gemeinsam schalten, Status zusammenfassen)
|ModType=h
|ModCmdRef=structure
|ModForumArea=Automatisierung
|ModTechName=98_structure.pm
|ModOwner=rudolfkoenig
}}

[[structure]] ist ein Erweiterungsmodul zur Zusammenfassung von Geräten, ursprünglich nur, um diese gemeinsam schalten zu können. Die Funktionalität wurde später erweitert um die Darstellung von Zuständen der in der Struktur zusammengefassten Geräte.

Es ist die Bildung von mehrstufigen Strukturen möglich.

== Voraussetzungen ==
Keine.

== Anwendung ==
=== Define ===
<pre>define structure_name structure <struct_type> <dev1> <dev2></pre>

Wobei <code><struct_type></code> ein beliebiger Bezeichner ist, welcher frei vergeben werden kann und in alle Mitglieder des Structure Devices als Attribut propagiert wird; <code><dev1> <dev2></code> bezeichnen die Mitglieder des angelegten Structure Gerätes.

=== Attribute ===
Gesamtaufstellung: siehe Befehlsreferenz.

==== clientstate_behavior ====
Mögliche Werte:
* absolute
* relative
* relativeKnown
* last - der Status der Struktur entspricht dem Status des Gerätes, das zuletzt eine Statusänderung erfahren hat

==== clientstate_priority ====
Definiert das Verhalten der structure in Abhängigkeit der enthaltenen Geräte. Das Beispiel
:<code>attr myStructure clientstate_priority present absent</code>
bedeutet: wenn mindestens eines des Geräte der Struktur den Status ''present'' hat, bekommt die Struktur den Status ''present'' (unabhängig vom Status der anderen Geräte der Struktur). Nur, wenn '''alle''' Geräte den Status ''absent'' haben, bekommt auch die Struktur den Status ''absent''.

Das Verhalten dieses Attributs ist zusätzlich beeinflusst durch den Wert des Attributs [[structure#clientstate_behavior|clientstate_behavior]].

== Anwendungsbeispiele ==
{{Todo|Bis zur Verfügbarkeit komplexerer Beispielbeschreibungen bitte unbedingt auf die commandref zurückgreifen.}}

=== EnOcean - Physischer EnOcean- und virtueller Fhem-Schalter zu einem Device zusammenfassen ===
* [[EnOcean_Starter_Guide#Physischer_EnOcean-_und_virtueller_Fhem-Schalter_zu_einem_Device_zusammenfassen|Anwendungsbeispiel zur Visualisierung unidirektionaler EnOcean-Aktoren]]

== Links ==
* {{Link2Forum|Topic=63255|LinkText=Erklärung}} des <code>struct_type</code> im define String.
* {{Link2Forum|Topic=8354|LinkText=Diskussion}} über die Erweiterung des Moduls um Funktionen für die Status-Anzeige

Structure

2017-04-18T19:39:22Z

Jorge3711: /* Define */

{{SEITENTITEL:structure}} 
{{Infobox Modul
|ModPurpose=Zusammenfassung von Geräten (gemeinsam schalten, Status zusammenfassen)
|ModType=h
|ModCmdRef=structure
|ModForumArea=Automatisierung
|ModTechName=98_structure.pm
|ModOwner=rudolfkoenig
}}

[[structure]] ist ein Erweiterungsmodul zur Zusammenfassung von Geräten, ursprünglich nur, um diese gemeinsam schalten zu können. Die Funktionalität wurde später erweitert um die Darstellung von Zuständen der in der Struktur zusammengefassten Geräte.

Es ist die Bildung von mehrstufigen Strukturen möglich.

== Voraussetzungen ==
Keine.

== Anwendung ==
=== Define ===
<pre>define structure_name structure <struct_type> <dev1> <dev2></pre>

Wobei <code><struct_type></code> ein beliebiger Bezeichner ist, welcher frei vergeben werden kann und in alle Mitglieder des Structre Devices als Attribut propagiert wird; <code><dev1> <dev2></code> bezeichnen die Mitglieder des angelegten Structre Gerätes.

=== Attribute ===
Gesamtaufstellung: siehe Befehlsreferenz.

==== clientstate_behavior ====
Mögliche Werte:
* absolute
* relative
* relativeKnown
* last - der Status der Struktur entspricht dem Status des Gerätes, das zuletzt eine Statusänderung erfahren hat

==== clientstate_priority ====
Definiert das Verhalten der structure in Abhängigkeit der enthaltenen Geräte. Das Beispiel
:<code>attr myStructure clientstate_priority present absent</code>
bedeutet: wenn mindestens eines des Geräte der Struktur den Status ''present'' hat, bekommt die Struktur den Status ''present'' (unabhängig vom Status der anderen Geräte der Struktur). Nur, wenn '''alle''' Geräte den Status ''absent'' haben, bekommt auch die Struktur den Status ''absent''.

Das Verhalten dieses Attributs ist zusätzlich beeinflusst durch den Wert des Attributs [[structure#clientstate_behavior|clientstate_behavior]].

== Anwendungsbeispiele ==
{{Todo|Bis zur Verfügbarkeit komplexerer Beispielbeschreibungen bitte unbedingt auf die commandref zurückgreifen.}}

=== EnOcean - Physischer EnOcean- und virtueller Fhem-Schalter zu einem Device zusammenfassen ===
* [[EnOcean_Starter_Guide#Physischer_EnOcean-_und_virtueller_Fhem-Schalter_zu_einem_Device_zusammenfassen|Anwendungsbeispiel zur Visualisierung unidirektionaler EnOcean-Aktoren]]

== Links ==
* {{Link2Forum|Topic=63255|LinkText=Erklärung}} des <code>struct_type</code> im define String.
* {{Link2Forum|Topic=8354|LinkText=Diskussion}} über die Erweiterung des Moduls um Funktionen für die Status-Anzeige

Structure

2017-04-18T19:38:56Z

Jorge3711: /* Define */

{{SEITENTITEL:structure}} 
{{Infobox Modul
|ModPurpose=Zusammenfassung von Geräten (gemeinsam schalten, Status zusammenfassen)
|ModType=h
|ModCmdRef=structure
|ModForumArea=Automatisierung
|ModTechName=98_structure.pm
|ModOwner=rudolfkoenig
}}

[[structure]] ist ein Erweiterungsmodul zur Zusammenfassung von Geräten, ursprünglich nur, um diese gemeinsam schalten zu können. Die Funktionalität wurde später erweitert um die Darstellung von Zuständen der in der Struktur zusammengefassten Geräte.

Es ist die Bildung von mehrstufigen Strukturen möglich.

== Voraussetzungen ==
Keine.

== Anwendung ==
=== Define ===
<pre>define structure_name structure <struct_type> <dev1> <dev2></pre>

Wobei <code><struct_type></code> ein beliebiger Bezeichner ist, welcher frei vergeben werden kann und in alle Mitglieder des Structre Devices als Attribut propagiert wird; "<code><dev1> <dev2></code>" bezeichnen die Mitglieder des angelegten Structre Gerätes.

=== Attribute ===
Gesamtaufstellung: siehe Befehlsreferenz.

==== clientstate_behavior ====
Mögliche Werte:
* absolute
* relative
* relativeKnown
* last - der Status der Struktur entspricht dem Status des Gerätes, das zuletzt eine Statusänderung erfahren hat

==== clientstate_priority ====
Definiert das Verhalten der structure in Abhängigkeit der enthaltenen Geräte. Das Beispiel
:<code>attr myStructure clientstate_priority present absent</code>
bedeutet: wenn mindestens eines des Geräte der Struktur den Status ''present'' hat, bekommt die Struktur den Status ''present'' (unabhängig vom Status der anderen Geräte der Struktur). Nur, wenn '''alle''' Geräte den Status ''absent'' haben, bekommt auch die Struktur den Status ''absent''.

Das Verhalten dieses Attributs ist zusätzlich beeinflusst durch den Wert des Attributs [[structure#clientstate_behavior|clientstate_behavior]].

== Anwendungsbeispiele ==
{{Todo|Bis zur Verfügbarkeit komplexerer Beispielbeschreibungen bitte unbedingt auf die commandref zurückgreifen.}}

=== EnOcean - Physischer EnOcean- und virtueller Fhem-Schalter zu einem Device zusammenfassen ===
* [[EnOcean_Starter_Guide#Physischer_EnOcean-_und_virtueller_Fhem-Schalter_zu_einem_Device_zusammenfassen|Anwendungsbeispiel zur Visualisierung unidirektionaler EnOcean-Aktoren]]

== Links ==
* {{Link2Forum|Topic=63255|LinkText=Erklärung}} des <code>struct_type</code> im define String.
* {{Link2Forum|Topic=8354|LinkText=Diskussion}} über die Erweiterung des Moduls um Funktionen für die Status-Anzeige

Structure

2017-04-18T19:35:51Z

Jorge3711: Define Abschnitt ausformuliert und vor allem struct_type erklärt mit Belegen ins Forum

{{SEITENTITEL:structure}} 
{{Infobox Modul
|ModPurpose=Zusammenfassung von Geräten (gemeinsam schalten, Status zusammenfassen)
|ModType=h
|ModCmdRef=structure
|ModForumArea=Automatisierung
|ModTechName=98_structure.pm
|ModOwner=rudolfkoenig
}}

[[structure]] ist ein Erweiterungsmodul zur Zusammenfassung von Geräten, ursprünglich nur, um diese gemeinsam schalten zu können. Die Funktionalität wurde später erweitert um die Darstellung von Zuständen der in der Struktur zusammengefassten Geräte.

Es ist die Bildung von mehrstufigen Strukturen möglich.

== Voraussetzungen ==
Keine.

== Anwendung ==
=== Define ===
<pre>define structure_name structure <struct_type> <dev1> <dev2></pre>

Wobei <code><struct_type></code> ein beliebiger Bezeichner ist, welcher frei vergeben werden kann und in alle Devices als Attribut propagiert wird; "<code><dev1> <dev2></code>" bezeichnen die Mitglieder des angelegten Structre Gerätes.

=== Attribute ===
Gesamtaufstellung: siehe Befehlsreferenz.

==== clientstate_behavior ====
Mögliche Werte:
* absolute
* relative
* relativeKnown
* last - der Status der Struktur entspricht dem Status des Gerätes, das zuletzt eine Statusänderung erfahren hat

==== clientstate_priority ====
Definiert das Verhalten der structure in Abhängigkeit der enthaltenen Geräte. Das Beispiel
:<code>attr myStructure clientstate_priority present absent</code>
bedeutet: wenn mindestens eines des Geräte der Struktur den Status ''present'' hat, bekommt die Struktur den Status ''present'' (unabhängig vom Status der anderen Geräte der Struktur). Nur, wenn '''alle''' Geräte den Status ''absent'' haben, bekommt auch die Struktur den Status ''absent''.

Das Verhalten dieses Attributs ist zusätzlich beeinflusst durch den Wert des Attributs [[structure#clientstate_behavior|clientstate_behavior]].

== Anwendungsbeispiele ==
{{Todo|Bis zur Verfügbarkeit komplexerer Beispielbeschreibungen bitte unbedingt auf die commandref zurückgreifen.}}

=== EnOcean - Physischer EnOcean- und virtueller Fhem-Schalter zu einem Device zusammenfassen ===
* [[EnOcean_Starter_Guide#Physischer_EnOcean-_und_virtueller_Fhem-Schalter_zu_einem_Device_zusammenfassen|Anwendungsbeispiel zur Visualisierung unidirektionaler EnOcean-Aktoren]]

== Links ==
* {{Link2Forum|Topic=63255|LinkText=Erklärung}} des <code>struct_type</code> im define String.
* {{Link2Forum|Topic=8354|LinkText=Diskussion}} über die Erweiterung des Moduls um Funktionen für die Status-Anzeige

Kategorie:HomeMatic Components

2017-04-09T07:57:34Z

Jorge3711: Homematic-Geräteübersicht oben in der Kategoriebeschreibung verlinkt

{{Randnotiz|RNText=Neue Artikel für diese Kategorie bitte nach folgendem Namensschema anlegen:
# '''Systemname''', wie von ELV verwendet (siehe auch [[HomeMatic Namen verstehen|Namensschema]])
# "sprechende" ''Bezeichnung'' des Gerätes
also beispielsweise '''HM-PBI-4-FM''' ''Funk-Tasterschnittstelle 4fach''
}}
DE: Diese Kategorie listet die [[Bekannte HomeMatic Geräte|verschiedenen Geräte]] des HomeMatic-Systems auf.

EN: This category lists [[Bekannte HomeMatic Geräte|hardware components]] of the HomeMatic system.

Basisinformationen zum Themenbereich [[HomeMatic]]:
* [[HomeMatic|Allgemeine Informationen]].
* Im Anhang "Das Hardwaresystem HomeMatic" des [http://fhem.de/Heimautomatisierung-mit-fhem.pdf Einsteigerdokuments "Heimautomatisierung-mit-fhem"]
* Geräteübergreifende Informationen zum [[HomeMatic Devices pairen|Pairen]], dem Einbinden von Geräten in ein System.
* Ein tabellarische Geräteübersicht gibt im Artikel [[Homematic-Geräteübersicht]]

[[Kategorie:Hardware]]

Homematic-Geräteübersicht

2017-04-09T07:54:50Z

Jorge3711: HM-LC-Sw1-Pl-DN-R1hinzugefügt

Diese Seite strukturiert die vorhandenen Wiki-Seiten zu Homematic-Geräten in Gruppen zur leichteren Orientierung. Derzeit sind nicht alle Homematic-Geräte aufgeführt, da die zugehörigen Wiki-Seiten noch nicht erstellt wurden.

Für alle Geräte mit AA/AAA-Batterien werden empfohlen: [http://www.ikea.com/de/de/catalog/products/80240505/ IKEA Akalisk AAA] und [http://www.ikea.com/de/de/catalog/products/50240502/ IKEA Akalisk AA], die sehr temperaturbeständig und dauerhaft sind. Die [http://www.elv.de/installationsadapter-homematic-smart-home.html Übersicht von ELV] zeigt die vorhandenen Installationsadapter (55mm Maßeinheit) zur Integration in vorhandene Schalterserien.

== Homematic Managen ==
{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Zentrale CCU2
|HM-Cen-O-TW-X-X-2
|[http://www.elv.de/homematic-zentrale-ccu-2.html Produkt] [https://files.elv.com/Assets/Produkte/10/1035/103584/Downloads/HM-Cen-O-TW-x-x-2_UM_GE_eQ-3_web.pdf Anleitung]
|
|Einzige Möglichkeit, '''Homematic IP'''-Geräte anzusteuern
|-
|LAN Konfigurationsadapter
|[[HM-CFG-LAN_LAN_Konfigurations-Adapter|HM-CFG-LAN]]
|
|[[HM-LGW-O-TW-W-EU_Funk-LAN_Gateway|HM-LGW-O-TW-W-EU]]
|End-of-Sale, 230V Steckernetzteil
|-
|LAN Konfigurationsadapter
|[[HM-LGW-O-TW-W-EU_Funk-LAN_Gateway|HM-LGW-O-TW-W-EU]]
|[http://www.elv.de/homematic-funk-lan-gateway.html Produkt] [https://files.elv.com/Assets/Produkte/10/1040/104029/Downloads/104029_lan_gateway_um.pdf Anleitung]
|
|5VDC 1A, LAN-Firmwareversionen < 1.1.5 haben Stabilitätsprobleme
|-
|USB Konfigurationsadapter
|[[HM-CFG-USB_USB_Konfigurations-Adapter|HM-CFG-USB]]
|
|
|End-of-Sale, USB
|-
|Raspberry Pi Homematic-Modul
|[[HM-MOD-RPI-PCB_HomeMatic_Funkmodul_für_Raspberry_Pi|HM-MOD-RPI-PCB]]
|[http://www.elv.de/homematic-funkmodul-fuer-raspberry-pi-bausatz.html Produkt]
|
|1,8-3,6VDC, Aufsteckplatine für Raspberry Pi, empfohlene Lösung
|-
|Repeater
|[[HM-Sys-sRP-Pl_Funk-Zwischenstecker_Repeater|HM-SYS-SRP-P1]]
|
|
|End-of-Sale
|}

== Homematic DIY ==
{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Sendemodul 8-Kanal
|[[HM-MOD-EM-8_8-Kanal-Sendemodul|HM-MOD-EM-8]]
|[http://www.elv.de/homematic-8-kanal-sendemodul.html Produkt] [https://files.elv.com/Assets/Produkte/13/1329/132939/Downloads/132939_sendemodul_um.pdf Anleitung]
|
||2,3-3V/3,5-12V DC, für eigene Entwicklungen - Bastlermodul
|-
|Empfängermodul 8-Kanal
|[[HM-MOD-Re-8_8-Kanal-Empfangsmodul|HM-MOD-Re-8]]
|[http://www.elv.de/homematic-8-kanal-empfangsmodul.html Produkt] [https://files.elv.com/Assets/Produkte/13/1321/132143/Downloads/132143_Empfangsmodul_UM.pdf Anleitung]
|
|2,3-3V/3,5-12V DC, für eigene Entwicklungen - Bastlermodul
|-
|NC/NO-Zustands-Sendemodul
|[[HM-SCI-3-FM_3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]]
|[http://www.elv.de/homematic-schliesserkontakt-interface-fuer-oeffner-und-schliesserkontakte.html Produkt] [https://files.elv.com/Assets/Produkte/9/914/91461/Downloads/91461_HM_SCI_3FMD1_GB_um.pdf Anleitung]
|
|CR2032 Batterie, für eigene Entwicklungen - Bastlermodul
|-
|Klingelsignalsensor
|[[HM-Sen-DB-PCB_Klingelsignalsensor|HM-SEN-DB-PCB]]
|[http://www.elv.de/homematic-funk-klingelsignalsensor-bausatz.html Produkt] [https://files.elv.com/Assets/Produkte/13/1328/132846/Downloads/132846_HM-Sen-DB-PCB_UM_G_eQ-3_150608_um.pdf Anleitung]
|
|2 AAA Batterien, sendet keine zyklischen Statusmeldungen, erkennt Signale 5-12V AC/DC
|-
|Relais-Schaltmodul
|RSM1
|[https://www.elv.de/elv-relais-schaltmodul-rsm1-bausatz.html Produkt]
|
|Unterstützt verschiedene Relaistypen, als Erweiterung für OpenCollector-Ausgänge
|-
|Funk-Schaltaktor Kleinspannung
|HM-LC-Sw1-PCB
|[https://www.elv.de/elv-homematic-funk-schaltaktor1fach-fuer-kleinspannunghm-lc-sw1-pcb-bausatz.html Produkt]
|
|
|-
|Funk-Sendemodul, 8-Bit
|HM-MOD-EM-8Bit
|[https://www.elv.de/elv-homematic-funk-sendemodul-8-bit-bausatz.html Produkt]
|
|Taster und Dateneingänge
|}

== Homematic Remote ==
{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Taster Unterputz, 2fach
|[[HM-PB-2-FM_2fach-Funk-Wandtaster_für_Markenschalter|HM-PB-2-FM]]
|[http://www.elv.de/homematic-funk-wandsender-fuer-markenschalter-2fach-unterputzmontage-komplettbausatz.html Produkt] [https://files.elv.com/Assets/Produkte/13/1324/132438/Downloads/132438_HM-PB-2-FM_UM_G_eQ-3_150317_um.pdf Anleitung]
|
|2 AAA Batterien, passend zu 55mm-Installationsrahmen verschiedener Hersteller
|-
|Taster Unterputz, 2fach
|[[HM-RC-2-PBU-FM_Unterputz-Wandsender|HM-RC-2-PBU-FM]]
|[http://www.elv.de/homematic-funk-wandsender-2-fach-fuer-markenschalter-230-v-unterputzmontage.html Produkt] [https://files.elv.com/Assets/Produkte/14/1422/142237/Downloads/142237_funkwandsender_um.pdf Anleitung]
|
|230V, passend zu verschiedenen Installationsrahmen
|-
|Taster, 2fach
|[[HM-PB-2-WM55_2fach-Funk-Wandtaster|HM-PB-2-WM55]]
|[http://www.elv.de/homematic-funk-wandsender-2fach.html Produkt] [https://files.elv.com/Assets/Produkte/9/992/99240/Downloads/99240_HM_PB_2_WM55_UM.pdf Anleitung]
|
|2 AAA Batterien, passend zu Installationsrahmen verschiedener Hersteller
|-
|Taster, 3 x 2fach
|[[HM-PB-6-WM55 6fach-Funk-Wandtaster|HM-PB-6-WM55]]
|[http://www.elv.de/homematic-funk-wandtaster-6fach.html Produkt] [https://files.elv.com/Assets/Produkte/13/1301/130113/Downloads/130113_6fach_Wandtaster_um.pdf Anleitung]
|
|2 AAA Batterien, passend zu Installationsrahmen verschiedener Hersteller
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Wandtaster mit OLED Display
|[[HM-PB-4DIS-WM_Funk-Wandtaster_mit_Display|HM-PB-4Dis-WM]]
|[http://www.elv.de/homematic-funk-wandtaster-mit-display.html Produkt] [https://files.elv.com/Assets/Produkte/8/859/85975/Downloads/85975_Display_Wandtaster_v1.2_UM.pdf Anleitung]
|
|3 AAA Batterien, kleines Display, nur altweiß (nicht reinweiß)
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Tasterschnittstelle, 4fach
|[[HM-PBI-4-FM_Funk-Tasterschnittstelle_4fach|HM-PBI-4-FM]]
|[http://www.elv.de/homematic-hm-pbi-4-fm-funk-tasterschnittstelle-4fach-unterputzmontage.html Produkt] [https://files.elv.com/service/manuals/76120_HM_PBI_4_FM_UM_GE_eQ_3_um.pdf Anleitung]
|
||CR2032 Batterie, für die Kombination mit Installationstastern verschiedener Hersteller
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Fernbedienung, 12 Tasten
|[[HM-RC-12_Funkfernbedienung_12_Tasten|HM-RC-12]]
|[http://www.elv.de/homematic-funk-fernbedienung-12-tasten-weiss-1.html Produkt] [https://files.elv.com/service/manuals/Homematic/73968_um.pdf Anleitung]
|
|3 AAA Batterien, In Schwarz als HM-RC-12-B
|-
|Fernbedienung, 4 Tasten
|[[HM-RC-4-2_Funkfernbedienung_4_Tasten|HM-RC-4-2]]
|[http://www.elv.de/homematic-funk-handsender-4-tasten.html Produkt] [https://files.elv.com/Assets/Produkte/10/1053/105397/Downloads/105397_4tasten_sender_um.pdf Anleitung]
|
|AAA Batterie, Schlüsselanhänger, verschiedene Varianten HM-RC-Key4-2, HM-RC-Sec4-2
|-
|Fernbedienung, 19 Tasten
|HM-RC-19
|ADDME
|
|
|-
|Fernbedienung, 8 Tasten
|HM-RC-8
|ADDME
|
|
|}

== Homematic Schalten ==
{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck: Aussen
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Schalter Aufputz 4fach
|[[HM-LC-Sw4-SM_4fach_Schaltaktor_Aufputz|HM-LC-Sw4-SM]]
|[http://www.elv.de/homematic-funk-schaltaktor-4fach-aufputzmontage.html Produkt] [https://files.elv.com/Assets/Produkte/7/767/76796/Downloads/76796_hm_lc_sw4_sm_um.pdf Anleitung]
|
|230V, IP65, enge Bauweise
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck: Hutschiene
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Schalter
|[[HM-LC-Sw1-DR_1fach_Schaltaktor_Hutschiene|HM-LC-Sw1-DR]]
|[http://www.elv.de/homematic-1-kanal-schaltaktor-im-hutschienengehaeuse-1.html Produkt] [https://files.elv.com/Assets/Produkte/14/1413/141379/Downloads/141379_schaltaktor_um.pdf Anleitung]
|
||230V, mit Tastereingang, auch als Bausatz verfügbar
|-
|Schalter 4fach
|[[HM-LC-Sw4-DR_4fach_Schaltaktor_Hutschiene|HM-LC-Sw4-DR]]
|[http://www.elv.de/homematic-funk-schaltaktor-4fach-hutschiene.html Produkt] [https://files.elv.com/Assets/Produkte/9/918/91836/Downloads/91836_Funk_Schaltaktor_UM.pdf Anleitung]
|
|230V, 4 TE, kein Tastereingang, auch als Bausatz
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck: Unterputz
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Schalter
|[[HM-LC-SW1-FM_Schaltaktor_1-fach_UP|HM-LC-Sw1-FM]]
|[http://www.elv.de/homematic-hm-lc-sw1-fm-unterputzschalter-1fach.html Produkt] [https://files.elv.com/Assets/Produkte/7/767/76793/Downloads/76793_HM_LC_Sw1_FM_um.pdf Anleitung]
|
|230V, mit Tastereingang, 16A
|-
|Schalter 2fach
|[[HM-LC-SW2-FM_Schaltaktor_2-fach_UP|HM-LC-Sw2-FM]]
|[http://www.elv.de/homematic-funk-schaltaktor-2fach-unterputzmontage-1.html Produkt] [https://files.elv.com/service/manuals/76793_HM_Unterputzschalter_UM.pdf Anleitung]
|
|230V, mit Tastereingang, 5A zusammen. 2 x HM-LC-Sw1-FM empfohlen.
|-
|Schalter
|[[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]]
|[http://www.elv.de/homematic-funk-schaltaktor-fuer-markenschalter-1fach-unterputzmontage.html Produkt] [https://files.elv.com/Assets/Produkte/10/1030/103029/Downloads/103029_FunkSchaltaktor_um.pdf Anleitung]
|
|230V, passend zu 55mm-Installationsrahmen verschiedener Hersteller
|-
|Schalter PEHA
|[[HM-LC-Sw1PB-FM_Schaltaktor_mit_Tasteraufsatz_1fach|HM-LC-Sw1PB-FM]]
|
|
|230V, End-of-Sale
|-
|Schalter 2fach PEHA
|[[HM-LC-Sw2PB-FM_Schaltaktor_mit_Tasteraufsatz_2fach|HM-LC-Sw2PB-FM]]
|
|
|230V, End-of-Sale
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck: Zwischenstecker
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Schalter Zwischenstecker
|[[HM-LC-Sw1-Pl2_Funk-Zwischenstecker-Schaltaktor_1fach|HM-LC-Sw1-Pl2]]
|
|[[HM-LC-Sw1-Pl-DN-R1|HM-LC-Sw1-Pl-DN-R1]]
|End-of-Sale
|-
|Schalter Zwischenstecker
|[[HM-LC-Sw1-Pl-DN-R1|HM-LC-Sw1-Pl-DN-R1]]
|[https://www.elv.de/homematic-132989-funk-schaltaktor-zwischenstecker-fuer-smart-home-hausautomation.html Produkt] [https://files.elv.com/Assets/Produkte/13/1329/132989/Downloads/HM-LC-Sw1-Pl-DN-R1_UM_GEFN_eQ-3_150407.pdf Anleitung]
|
|Nachfolger des HM-LC-Sw1-Pl2
|-
|Schalter Frankreich, Polen, Belgien
|ADDME
|ADDME
|
|Artikelnummer 141127
|-
|Schalter England, Irland
|ADDME
|ADDME
|
|Artikelnummer 131132
|-
|Schalter Italien
|ADDME
|ADDME
|
|Artikelnummer 141129
|-
|Schalter Schweiz
|ADDME
|ADDME
|
|Artikelnummer 141130
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck: Batterie
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Schalter 1fach
|[[HM-LC-Sw1-Ba-PCB_1-Kanal-Funk-Schaltaktor_für_Batteriebetrieb|HM-LC-Sw1_Ba-PCB]]
|[http://www.elv.de/elv-homematic-schaltaktor-fuer-batteriebetrieb-fertiggeraet.html Produkt] [https://files.elv.com/Assets/Produkte/10/1048/104895/Downloads/104895_Funk_Schaltaktor_um.pdf Anleitung]
|
|4-15VDC oder 2-3VDC, Bausatz
|-
|Schalter 4fach
|[[HM-LC-Sw4-Ba-PCB_4-Kanal-Funk-Schaltaktor_für_Batteriebetrieb|HM-LC-Sw4-Ba-PCB]]
|[http://www.elv.de/homematic-4-kanal-funk-schaltaktor-fuer-batteriebetrieb-bausatz.html Produkt] [https://files.elv.com/Assets/Produkte/13/1305/130557/Downloads/130557_hm_schaltaktor_um.pdf Anleitung]
|
|7-15VDC, 160mA, schaltet 4 x 42VDC/30VAC, 1A auch als Bausatz
|}

== Homematic Steuern ==
Für die Konfiguration der Jalousieaktoren ist [[HomeMatic_Type_Blind]] hilfreich.

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Jalousieaktor Unterputz
|[[HM-LC-BL1-FM_Funk-Jalousieaktor|HM-LC-BL1-FM]]
|[http://www.elv.de/homematic-funk-rollladenaktor-1fach-unterputzmontage.html Produkt] [https://files.elv.com/Assets/Produkte/7/767/76799/Downloads/76799_HM_LC_Sw1_FM_um.pdf Anleitung]
|
|230V, 250W Motorlast
|-
|Jalousieaktor Unterputz PEHA
|[[HM-LC-BL1-PB-FM_Unterputz_Jalousieaktor_PEHA|HM-LC-BL1-PB-FM]]
|
|
|230V, End-of-Sale
|-
|Jalousieaktor Aufputz
|[[HM-LC-Bl1-SM_Funk-Jalousieaktor|HM-LC-Bl1-SM]]
|[http://www.elv.de/homematic-funk-rollladenaktor-1fach-aufputzmontage.html Produkt] [https://files.elv.com/Assets/Produkte/7/768/76800/Downloads/76800_hm_lc_bl1_sm_um.pdf Anleitung]
|
|230V, 800W Motorlast
|-
|Jalousieaktor Unterputz
|[[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor|HM-LC-Bl1PBU-FM]]
|[http://www.elv.de/homematic-funk-rollladenaktor-fuer-markenschalter-1fach-unterputzmontage.html Produkt] [https://files.elv.com/Assets/Produkte/10/1030/103038/Downloads/103038_FunkRollladenaktor_um.pdf Anleitung]
|
|230V Motorlast, passend zu 55mm-Installationsrahmen verschiedener Hersteller
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Dimmer Zwischenstecker Anschnitt
|[[HM-LC-Dim1L-Pl-2_Funk-Zwischenstecker-Dimmaktor_1fach_Phasenanschnitt|HM-LC-Dim1L-Pl-2]]
|
|HM-LC-Dim1L-Pl-3
|End-of-Sales
|-
|Dimmer Zwischenstecker Anschnitt
|[[HM-LC-Dim1L-Pl-2_Funk-Zwischenstecker-Dimmaktor_1fach_Phasenanschnitt|HM-LC-Dim1L-Pl-3]]
|[http://www.elv.de/homematic-funk-dimmaktor-zwischenstecker-phasenanschnitt.html Produkt] [https://files.elv.com/Assets/Produkte/7/767/76797/Downloads/76797_HM-LC-Sw1-Pl-2_UM_GE_eQ-3_120723_um.pdf Anleitung]
|
|Phasen'''an'''schnitt, identische Konfiguration
|-
|Dimmer Zwischenstecker Anschnitt
|HM-LC-Dim1T-Pl-3
|ADDME
|
|230V, Phasen'''ab'''schnitt
|-
|Dimmer Unterputz PWM/LED
|[[HM-LC-Dim1PWM-CV_Dimmaktor_PWM_DC-LED|HM-LC-Dim1PWM-CV]]
|[http://www.elv.de/homematic-funk-dimmer-1-fach-12v-pwm-fertiggeraet.html Produkt] [https://files.elv.com/Assets/Produkte/9/994/99444/Downloads/99444_Funk_Dimmaktor_um.pdf Anleitung]
|
|12-24VDC, 60VA Anschlußleistung
|-
|Dimmer PWM/LED
|[[HM-LC-RGBW-WM_Funk-RGBW-Controller|HM-LC-RGBW-WM]]
|[http://www.elv.de/homematic-funk-rgbw-controller.html Produkt] [https://files.elv.com/Assets/Produkte/14/1419/141952/Downloads/141952_rgbw_controller_um.pdf Anleitung]
|
|12-24VDC, 34W je Kanal, auch als Bausatz erhältlich
|-
|Dimmer Unterputz
|[[HM-LC-DIM1T-FM_1-Kanal-Dimmer_UP|HM-LC-Dim1T-FM]]
|[http://www.elv.de/elv-1-kanal-unterputzdimmer-phasenabschnitt.html Produkt] [https://files.elv.com/Assets/Produkte/9/918/91816/Downloads/91816_HM_LC_Dim1T_FM_um.pdf Anleitung]
|
|230V, 180W Anschlußleistung, Phasen'''ab'''schnitt
|-
|Dimmer Zwischendecke
|HM-LC-Dim1T-CV
|ADDME
|
|230V, Phasen'''ab'''schnitt
|-
|Dimmer Zwischendecke
|HM-LC-Dim1L-CV
|ADDME
|
|230V, Phasen'''an'''schnitt
|-
|Dimmer Unterputz
|[[HM-LC-Dim1TPBU-FM_1-Kanal-Dimmer_UP|HM-LC-Dim1TPBU-FM]]
|[http://www.elv.de/homematic-funk-dimmaktor-1fach-fuer-markenschalter-phasenabschnitt-unterputzmontage.html Produkt] [https://files.elv.com/Assets/Produkte/10/1030/103020/Downloads/103020_FunkDimmaktor_um.pdf Anleitung]
|
|230V, 180VA Anschlußleistung, passend zu 55mm-Installationsrahmen verschiedener Hersteller
|-
|Dimmer Aufputz, 2fach Abschnitt
|HM-LC-Dim2T-SM
|ADDME
|
|230V, Phasen'''ab'''schnitt
|-
|Dimmer Aufputz, 2fach Anschnitt
|HM-LC-Dim2L-SM
|ADDME
|
|230V, Phasen'''an'''schnitt
|}

== Homematic Messen ==
{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Zählermodul Gas, Strom
|[[HM-ES-TX-WM_Zählersensor_für_Strom-_und_Gaszähler|HM-ES-TX-WM]]
|[http://www.elv.de/homematic-komplettbausatz-zaehlersensor-sendeeinheit-strom-gas.html Produkt] [https://files.elv.com/Assets/Produkte/14/1401/140143/Downloads/140143_sensor_um.pdf Anleitung]
|
|Nur als Bausatz verfügbar, 4 AA Batterien, Gaszähler-Reedrelais leicht tauschbar
|-
|Schalter Hutschiene mit Leistungsmessung
|[[HM-ES-PMSw1-DR_Hutschienen-Schaltaktor_mit_Leistungsmessung|HM-ES-PMSw1-DR]]
|[http://www.elv.de/output/controller.aspx?cid=74&detail=10&detail2=51780 Produkt] [https://files.elv.com/Assets/Produkte/14/1411/141107/Downloads/HM-ES-PMSw1-DR_UM_G_150506.pdf Anleitung]
|
|230V, nur als Bausatz verfügbar, hohe Funklast durch Messung
|-
|Schalter Zwischenstecker mit Leistungsmessung
|[[HM-ES-PMSw1-Pl_Funk-Schaltaktor_1-fach_mit_Leistungsmessung|HM-ES-PMSw1-Pl]]
|[http://www.elv.de/homematic-funk-schaltaktor-1fach-mit-leistungsmessung-zwischenstecker.html Produkt] [https://files.elv.com/Assets/Produkte/13/1302/130248/Downloads/130248_schaltaktor_messen_um.pdf Anleitung]
|
|230V Zwischenstecker, hohe Funklast durch Messung
|-
|Füllstandsmesser
|[[HM-Sen-Wa-Od_kapazitiver_Funk-Füllstandsmesser|HM-SEN-WA-OD]]
|[http://www.elv.de/kapazitiver-fuellstandsmesser-hm-sen-wa-od-komplettbausatz.html Produkt] [https://files.elv.com/Assets/Produkte/10/1049/104945/Downloads/104945_HMSenWaOd_um.pdf Anleitung]
|
|3 AA Batterien, kapazitive Messung, z.B. für Zisternen
|-
|Temperatur/Luftfeuchte aussen
|[[HM-WDS10-TH-O_Funk-Temperatur-/Feuchtesensor_außen_(OTH)|HM-WDS10-TH-O]]
|[http://www.elv.de/homematic-hm-wds10-th-o-funk-temperatur-luftfeuchtesensor-oth.html Produkt] [https://files.elv.com/Assets/Produkte/7/769/76923/Downloads/76923_HM_WDS10_TH_O_UM_GE_eQ3_120921_um.pdf Anleitung]
|
|2 AA Batterien, Falsche Werte bei schwachen Batterien, nur bis -19,9°C
|-
|Temperatur/Luftfeuchte aussen
|HM-WDS30-TO
|[http://www.elv.de/homematic-hm-wds30-t-o-funk-temperatursensor-aussen.html Produkt] [https://files.elv.com/service/manuals/76857_HM-WDS30_T_O_GE.pdf Anleitung]
|
|Abgesetzter Sensor, nur bis -19,9°C
|-
|Temperatur/Luftfeuchte innen
|[[HM-WDS40-TH-I_Funk-Temperatur-/Feuchtesensor_innen_(IT)|HM-WDS40-TH-I]]
|[http://www.elv.de/homematic-funk-innensensor-ith.html Produkt] [https://files.elv.com/service/manuals/76998_HM_GE_WDS40_TH_I_GE_V1_1.pdf Anleitung]
|
|
|-
|Kombi-Sensor Wetter Aussen
|[[HM-WDS100-C6-O_Funk-Kombi-Sensor_OC3|HM-WDS100-C6-O]]
|[http://www.elv.de/homematic-funk-kombisensor.html Produkt] [https://files.elv.com/Assets/Produkte/13/1321/132192/Downloads/132192_kombisensor_um.pdf Anleitung]
|
|Im Vergleich zu Vantage Pro schlechte Messungen, schlechtere Böen-Erkennung
|-
|Differenz-Temperatur
|[[HM-WDS30-OT2-SM_Differenz-Temperatur-Sensor|HM-WDS30-OT2-SM]]
|[http://www.elv.de/homematic-differenz-temperatur-sensor-fuer-smart-home-hausautomation-1.html Produkt] [https://files.elv.com/Assets/Produkte/14/1434/143420/Downloads/143420_temperatur_sensor_um.pdf Anleitung]
|
|Fühler nicht dauerhaft wasserdicht
|}

== Homematic Sicherheit ==
{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Bewegungsmelder Innen
|[[HM-Sec-MDIR_Funk-Bewegungsmelder_innen|HM-SEC-MDIR]]
|
|HM-Sec-MDIR-2
|End-of-Sale, Nachfolgemodell identisch zu konfigurieren
|-
|Bewegungsmelder Innen
|[[HM-Sec-MDIR_Funk-Bewegungsmelder_innen|HM-SEC-MDIR-2]]
|[http://www.elv.de/homematic-bewegungsmelder-1.html Produkt] [https://files.elv.com/Assets/Produkte/13/1317/131776/Downloads/131776_hm_sec_mdir_2_um.pdf Anleitung]
|
|3 AA Batterien
|-
|Bewegungsmelder Außen
|[[HM-Sen-MDIR-O_Funk-IR-Bewegungsmelder_außen|HM-SEN-MDIR-O]]
|
|HM-SEN-MDIR-O-2
|End-of-Sale, Nachfolgemodell identisch zu konfigurieren
|-
|Bewegungsmelder außen
|[[HM-Sen-MDIR-O_Funk-IR-Bewegungsmelder_außen|HM-SEN-MDIR-O-2]]
|[http://www.elv.de/homematic-funk-ir-bewegungsmelder-aussen-2.html Produkt] [https://files.elv.com/Assets/Produkte/10/1041/104109/Downloads/104109_Funk_IR_um.pdf Anleitung]
|
|Es wird von Problemen mit Ameisen im Sensor und Ausfällen nach zwei Jahren berichtet
|-
|Bewegungsmelder außen
|[[HM-Sen-MDIR-SM_Außen-Bewegungsmelder|HM-SEN-MDIR-SM]]
|[http://www.elv.de/homematic-hm-sen-mdir-aussen-bewegungsmelder-komplettbausatz.html Produkt] [https://files.elv.com/service/manuals/84579_HM_Sen_MDIR_SM_um.pdf Anleitung]
|
|IP65 für Außeneinsatz, Bausatz
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Fenster Drehgriffkontakt
|[[HM-Sec-RHS_Funk-Fenster-Drehgriffkontakt|HM-SEC-RHS]]
|[http://www.elv.de/homematic-funk-fenster-drehgriffkontakt-1.html Produkt] [https://files.elv.com/service/manuals/75643_HM_Sec_RHS_GE_V1_0.pdf Anleitung]
|
|LR44 Batterien, [http://www.techwriter.de/beispiel/funkeig1.htm Sendeeigenschaften verbessern]
|-
|Tür/Fenster-Kontakt
|[[HM-SEC-SC_Tür-Fensterkontakt|HM-SEC-SC]]
|[http://www.elv.de/homematic-hm-sec-sc-funk-tuer-fensterkontakt-1.html Produkt] [https://files.elv.com/service/manuals/76788_HM_Sec_SC_GE_V1_0_UM.pdf Anleitung]
|
|LR44 Batterien, [[HomeMatic_Type_threeStateSensor|Notwendige Konfiguration]]
|-
|Tür/Fenster-Kontakt (optisch)
|[[HM-Sec-SCo_Tür-Fensterkontakt,_optisch|HM-SEC-SCo]]
|[http://www.elv.de/homematic-ir-tuer-fensterkontakt.html Produkt] [https://files.elv.com/Assets/Produkte/13/1302/130297/Downloads/130297_fensterkontakt_optisch_um.pdf Anleitung]
|
|AAA Batterie, [[HomeMatic_Type_threeStateSensor|Notwendige Konfiguration]]
|-
|Zylinderschloss steuern
|[[HM-SEC-KEY_KeyMatic|HM-SEC-KEY]]
|[http://www.elv.de/homematic-funk-tuerschlossantrieb-keymatic-weiss-inkl-funk-handsender.html Produkt] [https://files.elv.com/Assets/Produkte/13/1317/131761/Downloads/131761_keymatic_um.pdf Anleitung]
|
|3 AA Batterien, eigener AES-Key ''dringend'' empfohlen, auch in Silber
|}

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Rauchmelder
|[[HM-SEC-SD_Rauchmelder|HM-SEC-SD]]
|
|HM-Sec-SD-2
|End-of-Sale
|-
|Rauchmelder
|[[HM-SEC-SD_Rauchmelder|HM-SEC-SD-2]]
|[http://www.elv.de/homematic-funk-rauchmelder-hm-sec-sd-2.html Produkt] [https://files.elv.com/Assets/Produkte/13/1314/131408/Downloads/131408_rauchmelder_um.pdf Anleitung]
|
|Lithium, 10 Jahresbatterie
|-
|Sirenensteuerung
|[[HM-Sec-SFA-SM_Funk-Sirenensteuerung|HM-SEC-SFA-SM]]
|[http://www.elv.de/homematic-funk-sirenenansteuerung-bidcos.html Produkt] [https://files.elv.com/Assets/Produkte/8/843/84392/Downloads/84392_HM_Sec_SFA_GE_V1_1_UM.pdf Anleitung]
|
|230V, stellt 2x12V 1A für Sirene und Blitzer zur Verfügung, Notakku 1.2Ah
|-
|Neigungssensor
|[[HM-SEC-TIS_Funk-Neigungssensor|HM-SEC-TIS]]
|[http://www.elv.de/homematic-funk-neigungssensor-hm-sec-tis.html Produkt] [https://files.elv.com/Assets/Produkte/8/831/83146/Downloads/83146_neu_HM_Sec_TIS_GE_UM.pdf Anleitung]
|
|CR2032, erkennt nur offen/zu, keine Winkel
|-
|Wassermelder
|[[HM-Sec-WDS_Funk-Wassermelder|HM-SEC-WDS]]
|
|HM-SEC-WDS-2
|End-of-Sale
|-
|Wassermelder
|[[HM-Sec-WDS_Funk-Wassermelder|HM-SEC-WDS-2]]
|[http://www.elv.de/homematic-funk-wassermelder.html Produkt] [https://files.elv.com/service/manuals/Homematic/83459_HM_Sec_WDS_D_v1_0_UM.pdf Anleitung]
|
|2 AA Batterien, unterstützt nicht die Alarmzentrale HM-SEC-Cen
|-
|Regensensor
|[[HM-Sen-RD-O_Funk-Regensensor|HM-SEN-RD-O]]
|[http://www.elv.de/homematic-funk-regensensor-1.html Produkt] [https://files.elv.com/Assets/Produkte/13/1302/130220/Downloads/130220_hm_regensensor_um.pdf Anleitung]
|
|7,5-30VDC 1W max, auch als Bausatz verfügbar
|}

== Homematic Anzeigen ==
{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Retro-Anzeige
|[[HM-Dis-TD-T_Retro_Anzeige|HM-Dis-TD-T]]
|[http://www.elv.de/homematic-statusanzeige-mit-batteriebetrieb-und-klappanzeige-komplettbausatz.html Produkt] [https://files.elv.com/Assets/Produkte/10/1037/103721/Downloads/103721_HM-Dis-TD-T_UM_G_150226_um.pdf Anleitung]
|
|Nur als Bausatz (enge Bestückung) verfügbar, Temperaturbereich 0°-50°C
|-
|Farbige Statusanzeige OLED
|[[HM-Dis-WM55_Funk_Statusanzeige|HM-Dis-WM55]]
|[http://www.elv.de/homematic-funk-statusanzeige-aufputzmontage-bausatz.html Produkt] [https://files.elv.com/Assets/Produkte/13/1326/132656/Downloads/132656_statusanzeige.pdf Anleitung]
|
|Passend zu 55mm-Installationsrahmen verschiedener Hersteller
|-
|B&W Statusanzeige ePaper
|HM-Dis-EP-WM55
|[http://www.elv.de/homematic-komplettbausatz-funk-statusanzeige-mit-e-paper-display.html Produkt] [https://files.elv.com/Assets/Produkte/14/1424/142414/Downloads/HM-Dis-EP-WM55_UM_GE_142413_160519.pdf Anleitung]
|
|Passend zu 55mm-Installationsrahmen verschiedener Hersteller
|-
|LED Statusanzeige 16fach
|[[HM-OU-LED16_Funk-Statusanzeige_LED16|HM-OU-LED16]]
|[http://www.elv.de/elv-homematic-statusanzeige-fertiggeraet.html Produkt] [https://files.elv.com/Assets/Produkte/10/1047/104798/Downloads/104798_HM_OU_LED16_um.pdf Anleitung]
|
|7,5VDC Netzteil
|-
|Funkgong mit Signalleuchte
|[[HM-OU-CFM-Pl_MP3_Funk-Gong_mit_Signalleuchte|HM-OU-CFM-Pl]]
|[http://www.elv.de/homematic-mp3-funk-tuergong-mit-signal-led.html Produkt] [https://files.elv.com/Assets/Produkte/9/990/99060/Downloads/99060_tuergong_um.pdf Anleitung]
|
|230V Steckdose, unterstützt abspielen von MP3s von Speicherkarte
|}

== Homematic Heizen ==
Die Heizungsgeräte sind für den Inneneinsatz gedacht und werden mit AA/AAA-Batterien betrieben. Die Wiki-Seiten [[HomeMatic_Type_Thermostat|Homematic-Thermostaten]] und [[HomeMatic_HMInfo_TempList/Weekplan|Homematic-Temperaturlisten]] geben einen Überblick, wie Temperaturlisten zu lesen und zu speichern sind. Für den HM-CC-RT-DN gibt es bei ELV im Zubehör-Bereich eine große Anzahl von Ventiladaptern aus Plastik und Messing, manchmal helfen auch Cent-Münzen als Unterlegscheibe, erhöhen jedoch die Lautstärke.

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|Heizkörperthermostat
|[[HM-CC-RT-DN_Funk-Heizk%C3%B6rperthermostat|HM-CC-RT-DN]]
|[http://www.elv.de/homematic-heizkoerperthermostat-1.html Produkt] [https://files.elv.com/Assets/Produkte/10/1051/105155/Downloads/105155_thermostat_um.pdf Anleitung]
|
|
|-
|Heizkörperthermostat
|[[HM-CC-VD_Funk-Stellantrieb|HM-CC-VD]]
|
|HM-CC-RT-DN
|End-of-Sale
|-
|Wandthermostat
|[[HM-CC-TC_Funk-Wandthermostat|HM-CC-TC]]
|
|HM-TC-IT-WM-W-EU
|End-of-Sale
|-
|Wandthermostat
|[[HM-TC-IT-WM-W-EU_Funk-Wandthermostat_AP|HM-TC-IT-WM-W-EU]]
|[http://www.elv.de/homematic-funk-wandthermostat-1.html Produkt] [https://files.elv.com/Assets/Produkte/13/1320/132030/Downloads/132030_thermostat_um.pdf Anleitung]
|
|Passend zu Installationsrahmen verschiedener Hersteller
|}

== Homematic Wired ==
Alle Homematic-Wired Geräte sind zur Hutschienen-Montage (DIN Rail) innerhalb eines Schaltschrankes gedacht. Die Geräte benötigen zum Betrieb ein Netzteil 24V DC innerhalb des Schaltschrankes. Der [https://de.wikipedia.org/wiki/EIA-485 RS485]-Bus wird von dem LAN-Gateway bereitgestellt und unterstützt maximal 127 Module. Zur Verkabelung eignet sich JSTY 4x2x0.6-Kabel.

{| class="wikitable mw-datatable"
!style="width:350px"|Einsatzzweck
!style="width:150px"|fhem Wiki
!style="width:200px"|ELV
!style="width:150px"|Nachfolger
!style="width:650px"|Zu beachten
|-
|LAN-Gateway
|HMW-Sys-OP-DR
|[http://www.elv.de/homematic-rs485-gateway-1.html Produkt] [https://files.elv.com/Assets/Produkte/10/1037/103755/Downloads/103755_rs485_gateway_um.pdf Anleitung]
|
|-
|IO-Modul, 12xIN
|HMW-Sen-SC-12-DR
|[http://www.elv.de/homematic-wired-rs485-schliesserkontakt-12-eingaenge-hutschienenmontage.html Produkt] [https://files.elv.com/Assets/Produkte/8/858/85840/Downloads/85840_HMW_Sen_SC_12_DR_UM.pdf Anleitung]
|
|
|-
|IO-Modul 12xIN, 14xOUT
|[[HMW-IO-12-Sw14-DR_Wired_RS485_I/O-Modul_12_Eingänge_14_Ausgänge|HMW-IO-12-SW14-DR]]
|[http://www.elv.de/homematic-wired-rs485-i-o-modul-12-eingaenge-14-ausgaenge.html Produkt] [https://files.elv.com/Assets/Produkte/9/920/92011/Downloads/wired_rs485_um.pdf Anleitung]
|
|
|-
|IO-Modul 12xIN, 7xOUT
|[[HMW-IO-12-Sw7-DR_Wired_RS485_I/O-Modul_12_Eingänge_7_Ausgänge|HMW-IO-12-SW7-DR]]
|[http://www.elv.de/homematic-wired-rs485-i-o-modul-12-eingaenge-7-schaltausgaenge-1.html Produkt] [https://files.elv.com/Assets/Produkte/7/768/76805/Downloads/76805_HMWIO12DRV1_02_UM.pdf Anleitung]
|
|
|-
|Dimmer, Phasenanschnitt
|HMW-LC-Dim1L-DR
|[http://www.elv.de/homematic-wired-rs485-dimmaktor-1fach-phasenanschnitt-1.html Produkt] [https://files.elv.com/Assets/Produkte/7/768/76803/Downloads/76803_hmw_lc_dim1l_dr_um.pdf Anleitung]
|
|
|-
|Jalousieaktor
|HMW-LC-Bl1-DR
|[http://www.elv.de/homematic-wired-hmw-lc-bl1-dr-wired-rs485-rollladenaktor-1fach.html Produkt] [https://files.elv.com/Assets/Produkte/7/768/76802/Downloads/76802_hmw_lc_bl1_dr_um.pdf Anleitung]
|
|
|-
|Schalter, 2fach
|HMW-LC-Sw2-DR
|[http://www.elv.de/homematic-wired-hmw-lc-sw2-dr-rs485-schaltaktor-2fach.html Produkt] [https://files.elv.com/Assets/Produkte/7/768/76801/Downloads/76801_hmw_lc_sw2_dr_um.pdf Anleitung]
|
|
|-
|Überspannungsschutz
|HMW-Sys-OP-DR
|[http://www.elv.de/homematic-wired-rs485-ueberspannungsschutz.html Produkt] [https://files.elv.com/Assets/Produkte/8/859/85978/Downloads/85978_HMW_Sys_OP_DR_UM.pdf Anleitung]
|
|
|-
|Busabschluss-Widerstand
|HMW-Sys-Tm-DR
|[http://www.elv.de/homematic-wired-rs485-busabschluss-widerstand-hutschienenmontage-1.html Produkt] [https://files.elv.com/Assets/Produkte/7/768/76807/Downloads/75168_HMW_Sys_TM_UM.pdf Anleitung]
|
|
|}

[[Kategorie:HomeMatic Components]]

HM-LC-Sw1-Pl2 Funk-Zwischenstecker-Schaltaktor 1fach

2017-04-09T07:45:02Z

Jorge3711: Bild des Zwischensteckers eingefügt

{{Infobox Hardware
|Bild=HM-LC-Sw1-Pl-DN-R1.png
|Bildbeschreibung=HM-LC-Sw1-Pl-2 Funk-Zwischenstecker-Schaltaktor 1fach
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=0,5W (Standby)
|HWPoweredBy=Netz
|HWSize=125x63x40mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
|FWVersion=1.12
|FWDownload={{Link2Forum|Topic=25527}}
|FWChangelog=
}}

__TOC__
In der Zwischenzeit wird der Aktor mit der Modellbezeichnung HM-LC-Sw1-Pl-DN-R1 vertrieben. Der Zwischenstecker ist auch als Bausatz bei ELV erhältlich.

== Features ==
Schalten eines angeschlossenen Verbrauchers mittels CUL/CUN/HMLAN Konfigurator.

'''Technische Daten:'''
* Schaltvermögen: 16A bei 230V/50Hz (ohmsche Last)
* Relais: 1x Schließer
* Schutzart: IP20
* Farbe: Reinweiß mit silberner Blende

* Aktuelle Firmware: 1.12 (via get DEVICE param firmware)

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der fhem.cfg:

<pre>
define internet CUL_HM 1BEXXX
attr internet .devInfo 010100
attr internet .stc 10
attr internet autoReadReg 4_reqStatus
attr internet devStateIcon on:black_Steckdose.on off:black_Steckdose.off
attr internet expert 2_full
attr internet firmware 1.9
attr internet model HM-LC-SW1-PL2
attr internet peerIDs 00000000,
attr internet room CUL_HM
attr internet serialNr JEQ0461XXX
attr internet subType switch
attr internet webCmd toggle:on:off:statusRequest
define FileLog_internet FileLog /var/log/fhem/internet-%Y.log internet
attr FileLog_internet logtype text
attr FileLog_internet room CUL_HM</pre>

=== Mögliche Schaltoperationen ===
Der Aktor versteht folgende Aktionen:

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Schaltet den Aktor um
set <name> on-for-timer <time>-> Schaltet den Aktor für <time> an
set <name> on-till <time> -> schaltet den Aktor biz zur Uhrzeit <time> an
</pre>

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-Sw1-Pl-2 folgendes Log zu sehen:
<pre>
2013-11-10_16:26:28 internet level: 100 %
2013-11-10_16:26:28 internet pct: 100
2013-11-10_16:26:28 internet deviceMsg: on (to HMLAN0)
2013-11-10_16:26:28 internet on
2013-11-10_16:26:28 internet timedOn: off
2013-11-10_16:26:28 internet RSSI: -55
2013-11-10_16:26:28 internet RAWMSG: E1BEE7E,0000,004EC156,FF,FFC9,05A4101BEE7EF112120601C80038
</pre>

== Bekannte Probleme ==
Ein Schaltaktor hatte nach einigen Wochen des ungestörten Funktionierens nur noch "MISSING ACK"s im Geräte-Log (zu den Schaltzeiten). Er schaltete auch nicht mehr zuverlässig (2 An- und 2 Ausschaltvorgänge je Tag per "at")

Log-Auszug dazu:
<pre>
2013-01-24_17:00:00 UG.AR.Luefter deviceMsg: on (to HMLAN1)
2013-01-24_17:00:00 UG.AR.Luefter on
2013-01-24_23:30:00 UG.AR.Luefter deviceMsg: off (to HMLAN1)
2013-01-24_23:30:00 UG.AR.Luefter off
2013-01-25_06:00:04 UG.AR.Luefter MISSING ACK
2013-01-25_08:00:04 UG.AR.Luefter MISSING ACK
2013-01-25_17:00:04 UG.AR.Luefter MISSING ACK
2013-01-25_23:30:04 UG.AR.Luefter MISSING ACK
2013-01-26_07:30:04 UG.AR.Luefter MISSING ACK
2013-01-26_18:57:42 UG.AR.Luefter MISSING ACK
2013-01-26_18:58:01 UG.AR.Luefter MISSING ACK
</pre>

Ein Reset des Schaltaktors mit anschließendem pairen brachte Abhilfe.
<pre>
2013-01-26_19:31:38 UG.AR.Luefter deviceMsg: on (to HMLAN1)
2013-01-26_19:31:38 UG.AR.Luefter on
</pre>

== Links ==
* Anleitung (ELV, PDF{{DocLink|elv|/service/manuals/Homematic/74799_HM_Zwischenstecker_G_V1_0_WEB_um.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Empfänger)]]

Datei:HM-LC-Sw1-Pl-DN-R1.png

2017-04-09T07:43:47Z

Jorge3711: Homematic HM-LC-Sw1-Pl-DN-R1 Lizenz: CC-BY-SA

Homematic HM-LC-Sw1-Pl-DN-R1

Lizenz: CC-BY-SA

HM-LC-Sw1-Pl2 Funk-Zwischenstecker-Schaltaktor 1fach

2017-04-09T06:56:19Z

Jorge3711: Hinweis auf neue Modellbezeichnung unter TOC hinzugefügt und doppelten Überschrift über TOC entfernt.

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=HM-LC-Sw1-Pl-2 Funk-Zwischenstecker-Schaltaktor 1fach
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=0,5W (Standby)
|HWPoweredBy=Netz
|HWSize=125x63x40mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
|FWVersion=1.12
|FWDownload={{Link2Forum|Topic=25527}}
|FWChangelog=
}}

__TOC__
In der Zwischenzeit wird der Aktor mit der Modellbezeichnung HM-LC-Sw1-Pl-DN-R1 vertrieben. Der Zwischenstecker ist auch als Bausatz bei ELV erhältlich.

== Features ==
Schalten eines angeschlossenen Verbrauchers mittels CUL/CUN/HMLAN Konfigurator.

'''Technische Daten:'''
* Schaltvermögen: 16A bei 230V/50Hz (ohmsche Last)
* Relais: 1x Schließer
* Schutzart: IP20
* Farbe: Reinweiß mit silberner Blende

* Aktuelle Firmware: 1.12 (via get DEVICE param firmware)

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der fhem.cfg:

<pre>
define internet CUL_HM 1BEXXX
attr internet .devInfo 010100
attr internet .stc 10
attr internet autoReadReg 4_reqStatus
attr internet devStateIcon on:black_Steckdose.on off:black_Steckdose.off
attr internet expert 2_full
attr internet firmware 1.9
attr internet model HM-LC-SW1-PL2
attr internet peerIDs 00000000,
attr internet room CUL_HM
attr internet serialNr JEQ0461XXX
attr internet subType switch
attr internet webCmd toggle:on:off:statusRequest
define FileLog_internet FileLog /var/log/fhem/internet-%Y.log internet
attr FileLog_internet logtype text
attr FileLog_internet room CUL_HM</pre>

=== Mögliche Schaltoperationen ===
Der Aktor versteht folgende Aktionen:

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Schaltet den Aktor um
set <name> on-for-timer <time>-> Schaltet den Aktor für <time> an
set <name> on-till <time> -> schaltet den Aktor biz zur Uhrzeit <time> an
</pre>

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-Sw1-Pl-2 folgendes Log zu sehen:
<pre>
2013-11-10_16:26:28 internet level: 100 %
2013-11-10_16:26:28 internet pct: 100
2013-11-10_16:26:28 internet deviceMsg: on (to HMLAN0)
2013-11-10_16:26:28 internet on
2013-11-10_16:26:28 internet timedOn: off
2013-11-10_16:26:28 internet RSSI: -55
2013-11-10_16:26:28 internet RAWMSG: E1BEE7E,0000,004EC156,FF,FFC9,05A4101BEE7EF112120601C80038
</pre>

== Bekannte Probleme ==
Ein Schaltaktor hatte nach einigen Wochen des ungestörten Funktionierens nur noch "MISSING ACK"s im Geräte-Log (zu den Schaltzeiten). Er schaltete auch nicht mehr zuverlässig (2 An- und 2 Ausschaltvorgänge je Tag per "at")

Log-Auszug dazu:
<pre>
2013-01-24_17:00:00 UG.AR.Luefter deviceMsg: on (to HMLAN1)
2013-01-24_17:00:00 UG.AR.Luefter on
2013-01-24_23:30:00 UG.AR.Luefter deviceMsg: off (to HMLAN1)
2013-01-24_23:30:00 UG.AR.Luefter off
2013-01-25_06:00:04 UG.AR.Luefter MISSING ACK
2013-01-25_08:00:04 UG.AR.Luefter MISSING ACK
2013-01-25_17:00:04 UG.AR.Luefter MISSING ACK
2013-01-25_23:30:04 UG.AR.Luefter MISSING ACK
2013-01-26_07:30:04 UG.AR.Luefter MISSING ACK
2013-01-26_18:57:42 UG.AR.Luefter MISSING ACK
2013-01-26_18:58:01 UG.AR.Luefter MISSING ACK
</pre>

Ein Reset des Schaltaktors mit anschließendem pairen brachte Abhilfe.
<pre>
2013-01-26_19:31:38 UG.AR.Luefter deviceMsg: on (to HMLAN1)
2013-01-26_19:31:38 UG.AR.Luefter on
</pre>

== Links ==
* Anleitung (ELV, PDF{{DocLink|elv|/service/manuals/Homematic/74799_HM_Zwischenstecker_G_V1_0_WEB_um.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Empfänger)]]

HM-LC-Sw1-Pl-DN-R1

2017-04-09T06:49:23Z

Jorge3711: Neue Modellbezeichnung für Zwischenschalter, Weiterleitung auf bestehenden Artikel

#WEITERLEITUNG [[HM-LC-Sw1-Pl2_Funk-Zwischenstecker-Schaltaktor_1fach]]

DbLog

2017-04-06T19:36:23Z

Jorge3711: /* Datenbank */ Primary Key Infos hinzugefügt und Abschnitt etwas umgestellt.

{{Infobox Modul
|ModPurpose=Protokolliert Ereignisse in einer Datenbank
|ModType=h
|ModForumArea=Automatisierung
|ModTechName=93_DbLog.pm
|ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])
}}

== Einleitung ==
Mit der Zeit entstehen im fhem recht umfangreiche Log-Daten für die verschiedensten konfigurierten Devices. Die übliche Einstiegs-[[Konfiguration]] sieht vor, dass die Logs als [http://fhem.de/commandref_DE.html#FileLog FileLog] gespeichert werden - je nach Einstellung in wenigen sehr großen oder vielen kleineren Dateien. Der Datei-basierte Zugriff ist allerdings nicht wirklick performant und kann schnell zum Flaschenhals werden (z.B. bei der Darstellung von Graphen über einen längeren Zeitraum).

Alternativ kann Fhem die Log-Daten mittels [http://fhem.de/commandref_DE.html#DbLog DbLog] in einer Datenbank speichern. Diese kann lokal als einfache SQLite- oder als zentrale Server-Datenbank (s.u.) gestaltet sein. Schon eine lokale einfache SQLite-Datenbank ist in der Regel deutlich performanter als File-basierte Logs.

Damit eine Datenbank-Nutzung möglich ist, müssen folgende Anpassungen gemacht werden:
# [[#Datenbank|Erstellen einer entsprechenden Datenbank]]
# [[#Datenbank-Anbindung mittels db.conf|Konfiguration der Datenbank-Anbindung in FHEM]]
# [[#Konfiguration als Device in fhem.cfg|Anpassen aller (oder einzelner) Konfigurationen von FileLog nach DbLog]]
# [[#Anpassen der gplot-Konfigurationen|Ggf. Anpassen der gplot-Konfigurationen]]

== Konfiguration ==
=== Datenbank-Anbindung mittels db.conf ===
DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MySQL-Datenbank sieht die db.conf folgendermaßen aus:

%dbconfig= (
connection => "mysql:database=fhem;host=db;port=3306",
user => "fhemuser",
password => "fhempassword",
);

Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp.
Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!
chown fhem:dialout /opt/fhem/db.conf

=== Konfiguration als Device ===
Das DbLog Device wird dann definiert mit
:<code>define <name> DbLog <configfilename> <regexp> </code>
wobei ''<configfilename>'' dem Pfad zur zuvor angelegten db.conf entspricht.
Ein Beispiel hierfür wäre:
:<code>define logdb DbLog ./db.conf .*:.* </code>
Die Angabe von <code>.*:.*</code> bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit vielen teils irrelevanten Werten gefüllt wird. Man kann daher die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Dies ist in [[#Finetuning des Loggings]] beschrieben.

=== Finetuning des Loggings ===
Bei der Konfiguration des Log-Devices werden die zu loggenden Daten definiert - in der einfachsten Form sieht das so aus: <code>define logdb DbLog ./db.conf .*:.* </code>. Die Angabe von <code>.*:.*</code> bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit sehr vielen und teils nicht benötigten Werten gefüllt wird und schnell wächst. Die Datenbank ist zwar deutlich leistungsfähiger, was große Datenmengen angeht, Datensparsamkeit kann aber schnell sinnvoll werden...

Um das Log-Aufkommen einzugrenzen gibt es 2 Ansätze:
* Einschränkung über den <code>define</code>-Eintrag
* Einschränkung über DbLogExclude-Einträge der jeweiligen Devices
* Einschränkung über DbLogInclude-Einträge des jeweiligen Devices

==== Einschränkung über den zentralen <code>define</code>-Eintrag ====
Man kann die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Die erste Wildcard, also das erste <code>.*</code>, entspricht dem in FHEM verwendeten Device-Namen. Die zweite Wildcard entspricht dem vom Device ausgegebenen zu loggenden Wert. Separiert werden beiden Angaben durch einen Doppelpunkt.

Ein Beispiel, um zwar alle definierten Devices zu erfassen, aber nur die Werte Temperatur, Ventilposition und Luftfeuchte in die Datenbank zu schreiben wäre:
:<code>define myDbLog DbLog ./db.conf .*:(temperature|valveposition|humidity).* </code>

==== Einschränkung über die jeweiligen Devices ====
Man kann die zu loggenden Werte für einzelne Devices separat einschränken, ohne dies im zentralen define-Eintrag machen zu müssen. Dies kann interessant sein, wenn beispielsweise ein Device Fehlerwerte meldet, die uninteressant sind, oder es meldet unnötig häufig Werte - beides ist z.B. bei 1-wire-Temperatursensoren gerne der Fall.

Um das einzuschränken gibt es 2 Stellparameter, die als Attribute direkt zum jeweiligen Device konfiguriert werden:
* DbLogExclude - definiert Werte, die nicht geloggt werden sollen
* DbLogInclude - definiert Werte, die geloggt werden sollen ( siehe attr DbLogSelectionMode )
* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. [http://fhem.de/commandref_DE.html#event-on-update-reading commandref])

Eine konkrete Konfiguration für einen sehr gesprächigen 1-wire-Temperatursensor könnte wie folgt aussehen:
<pre>
define EG_Balkon GPIO4 BUSMASTER
attr EG_Balkon DbLogExclude failures,T,85 # logge keine "failures", "T"-Werte und "85"-Werte (default-Werte, wenn keine Temperatur gelesen werden kann)
attr EG_Balkon event-on-change-reading state # logge nur, wenn sich ein Wert ändert (wenn sich die Temperatur nicht ändert, logge das nicht)
attr EG_Balkon event-min-interval state:900 # logge spätestens alle 900sec = 15min
attr EG_Balkon event-on-update-reading .* # logge alle Werte, die aktualisiert werden

attr <1-Wire-Device vom Typ OWTHERM oder OWSWITCH> DbLogExclude data.* # verhindert das Logging der state-Eintragungen
</pre>

Eine in diesem {{Link2Forum|Topic=33697|Message=264127}} vorgestellte Strategie zur Vermeidung unnötigen Loggings ist, dass bei der Definition von Devices durch das nachfolgende <code>notify</code> automatisch ein DbLogExclude für alle Werte (.*) des Devices zugewiesen wird und dies nur bei Interesse an geloggten Werten gelöscht bzw. angepasst wird:
<code>define nDbLogExclude notify global:DEFINED.* attr $EVTPART1 DbLogExclude .*</code>

Ebenso ist es mittlerweile möglich, lediglich erwünschte Werte (Positiv-Liste) zu loggen und alle anderen zu verwerfen. Hierfür wird im LogDevice das attribut DbLogSelectionMode Include verwendet. Nun kann für jedes Device mit DbLogInclude <Reading1>,<Reading2>,... angegeben werden, welche Readings geloggt werden sollen.
Integriert ist ebenfalls ein "min-interval", siehe commandref.

== Datenbank ==
Unterstützte Datenbanksysteme (Auswahl):
* Sqlite
* MySQL
* PostGreSql

=== Tabellen ===
Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:
* current
* history

DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:
{| class="wikitable"
|-
! Spalte
! Beschreibung (en)
! Beschreibung (de)
! Beispiel
|-
| '''TIMESTAMP'''
| timestamp of event
| Zeitstempel
| 2007-12-30 21:45:22
|-
| '''DEVICE'''
| device name
| Device-Name
| Wetterstation
|-
| '''TYPE'''
| device type
| Device-Typ
| KS300
|-
| '''EVENT'''
| event specification as full string
| Eventspezifikation als Text
| humidity: 71 (%)
|-
| '''READING'''
| name of reading extracted from event
| Bezeichnung des Readings
| humidity
|-
| '''VALUE'''
| actual reading extracted from event
| Wert des Readings
| 71
|-
| '''UNIT'''
| unit extracted from event
| Einheit des Readings
| %
|-
|}

Die Vorlagen zur Anlage von Tabellen und Indizes sind für jeden unterstützten Datenbanktyp im Verzeichnis '''contrib/dblog''' der FHEM-Installation, oder hier zu finden: [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/dblog/ Link]. Das MySQL-Skript (db_create_mysql.sql) legt eine neue Datenbank, das PostGres-Skript (db_create_postgresql.sql) ein neues Schema mit Namen "fhem" an.

==== current ====
Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer.
Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.
Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.

Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte <code>READING</code> u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus <code>DEVICE</code> und <code>READING</code> bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:

<syntaxhighlight lang="sql">
ALTER TABLE `fhem`.`current`
CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,
CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,
ADD PRIMARY KEY (`DEVICE`, `READING`);
</syntaxhighlight>

==== history ====
Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )
Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen.

== Anpassen der gplot-Konfigurationen ==
Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.

Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):
<pre>
# Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<L1>'
set ytics nomirror
set y2tics
set grid y2tics
set ylabel "Actuator/Window (%)"
set y2label "Temperature in C"
set yrange 0:100
set y2range 5:25

#FileLog 4:.measured-temp\x3a:0:
#FileLog 4:.actuator\x3a:0:int
#FileLog 4:.desired-temp::
#FileLog 4:.window\x3a::

#DbLog <SPEC1>:.measured-temp:0:
#DbLog <SPEC1>:.actuator:0:int
#DbLog <SPEC1>:.desired-temp::
#DbLog <SPEC1>:.window::

plot "<IN>" using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\
"<IN>" using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\
"<IN>" using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps
</pre>

Des weiteren ist zu beachten:

On-Off-Plots

EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq"on"?1:0/eg

unter Berücksichtigung von dim-Werten:

EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq"on"?1:($1eq"dim"?$2*0.01:0)/eg

== Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==
Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])
<ol>
<li>
''Installation von SQLite:''
<pre>sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl</pre>
</li>
<li>
''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):
<pre>sudo sqlite3 /opt/fhem/fhem.db</pre>
In der geöffneten SQL-Kommandozeile eingeben:
<pre>
CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));
CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));
</pre>
Die Kommandozeile verlässt man mit <code>.exit</code>.
</li>
<li>
''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''
<pre>
sudo chown fhem /opt/fhem/fhem.db
sudo chmod 666 /opt/fhem/fhem.db
</pre>
</li>
<li>
''Datenbank-Anbindung des FHEM konfigurieren:''
<pre>sudo nano /opt/fhem/db.conf</pre>
Inhalt:
<pre>
%dbconfig= (
connection => "SQLite:dbname=/opt/fhem/fhem.db",
user => "",
password => ""
);
</pre>
</li>
<li>
''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)
<pre>sudo nano /opt/fhem/fhem.cfg</pre>
<pre>
...
attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen
...
define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen
...
</pre>
Da durch diese <code>define</code>-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).
</li>
<li>
''FHEM neu starten:''
<pre>
sudo service fhem stop
sudo service fhem start
</pre>
</li>
<li>
''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''
<pre>sudo sqlite3 /opt/fhem/fhem.db</pre>
In der geöffneten SQL-Kommandozeile eingeben:
<pre>
select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)
</pre>
Die Kommandozeile verlässt man mit <code>.exit</code>.
</li>
<li>
''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]
</li>
</ol>

== Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==
Anstatt nano kann jeder andere kompatible Editor verwendet werden.

Unter Ubuntu/debian:
apt-get update && apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl

Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.

Hinweis: im Folgenden ist "#" der normale Prompt und "mysql>" der prompt innerhalb mysql, dieser kann mit exit verlassen werden.

Zum Test mal mit mysql verbinden:
# mysql -p -u root
Enter password:
mysql> exit

Jetzt die Tabellenstruktur anlegen.
Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden.
cp /opt/fhem/contrib/dblog/db_create_mysql.sql
nano db_create_mysql.sql
Dann wird die Datei eingelesen (root Passwort wird abgefragt):

# mysql -u root -p < db_create_mysql.sql

Jetzt kann man den Zugang testen:

# mysql -p -u <fhemuser>
Enter password: <fhempassword>
mysql> show databases;

Nun müsste eine Datenbank "fhem" angezeigt werden, die die Tabellen current und history enthält.

Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.
nano /opt/fhem/db.conf

Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt:
define logdb DbLog ./db.conf .*:.*
Als State muss ein "connected" angezeigt werden.

Ein rereadcfg in Fhem stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich

Nun kann die Funktion noch einmal überprüft werden:
<source lang="sql">
# mysql -u <fhemuser> -p
Enter password: <fhempassword>
mysql> use fhem;
Database changed
mysql> show tables;
+----------------+
| Tables_in_fhem |
+----------------+
| current |
| history |
+----------------+
2 rows in set (0,00 sec)
mysql> select * from history; # Achtung, kann sehr groß werden .... #
</source>

== Integration von DBLog in eigene Module ==
=== Bereitstellung der UNITS ===
Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.

Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine <code>DbLog_splitFn</code> bereitstellen:

<source lang="perl">
sub X_Initialize($)
{
my ($hash) = @_;
...
$hash->{DbLog_splitFn} = "X_DbLog_splitFn";
}
</source>

Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].

== Bekannte Probleme ==
Beim Anlegen der Datenbank per script wird die Value-Spalte nur als Varchar(32) definiert. Dieses kann dazu führen, dass besonders lange Readings (z.b. vom Modul sysmon) abgeschnitten werden und nicht in der Datenbank landen. Dieses lässt sich leicht beheben, indem man die Spalte auf Varchar(64) ändert (siehe auch {{Link2Forum|Topic=25648|Message=252433|LinkText=diesen Forenbeitrag}}).

mysql> ALTER TABLE current MODIFY VALUE VARCHAR(64);
mysql> ALTER TABLE history MODIFY VALUE VARCHAR(64);

== Werte auslesen ==
Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.

Grundsätzlich beschrieben ist dies in der [http://fhem.de/commandref_DE.html#DbLog commandref#DbLog] und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].

Hier ein paar Beispiele, was man damit anstellen kann:

* <code>get meineDB - - 2016-10-01 2016-10-03 meinSensor</code> alle Einträge des meinSensor vom 01.10.-03.10.2016
* <code>get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor</code> alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016
* <code>get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature</code> nur die temperature Werte
* <code>{ ReadingsTimestamp("meinSensor","state","0") }</code> Timestamp des aktuellen state des meinSensor
* <code>{ OldTimestamp("meinSensor") }</code> Timestamp des letzten state des FHT_3a32
* <code>{ time_str2num(OldTimestamp("meinSensor")) }</code> Timestamp in Sekunden des letzten state des meinSensor
* ...

== Bearbeitung von Datenbank-Einträgen ==
{{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}
Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor den fhem ausmacht um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden ohne den fhem abschalten zu müssen.

Datenbanken kann man ohne weiter Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.

=== SQLite-Datenbanken ===
'''Öffnen der DB unter Linux:'''

(Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)
sudo sqlite3 fhem.db
Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.

'''Schliessen der DB:'''

sqlite> .exit

'''Hilfe anzeigen:'''

sqlite> .help

'''Alle Tabellen anzeigen:'''

sqlite> .tables

'''Das Schema der DB anzeigen:'''

(vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])

sqlite> .schema

'''Alle Eintäge anzeigen:'''

Die Einträge liegen alle in der Tabelle "History".

'''Ganz wichtig''' ist immer das ";" am Ende Zeile (bei allen Kommandos, die nicht mit einem "." anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein ";" eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.

sqlite> select * from HISTORY;

Dies kann sehr lange dauern und kann ggf. mit <code>STRG-C</code> abgebrochen werden.

'''Alle Einträge eines Geräts anzeigen:'''

In <code>where</code>-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.

sqlite> select * from HISTORY where DEVICE='Pollenflug';

'''Alle Einträge eines Readings eines Geräts anzeigen:'''

sqlite> select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';

'''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''

sqlite> select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE>1;

'''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''

'''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das <code>select *</code> durch <code>delete</code> ersetzen.

sqlite> delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE>1;

== Datenbank reparieren ==
Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung <code>Error: database disk image is malformed</code> erhält, sollte man ein Reparatur vornehmen.

=== SQLite-Datenbanken ===
Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):

<ol>
<li>
DB öffnen:
<pre>sudo sqlite3 fhem.db</pre>
</li>
<li>
Integritäts-Check durchführen:
<pre>sqlite> pragma integrity_check;</pre>
Kommt hier ein "ok" ist die DB gesund. Ansonsten erscheint etwas wie
<pre>
*** in database main ***
On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)
On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)
Corruption detected in cell 0 on page 118786
Multiple uses for byte 132 of page 118786
...
</pre>
</li>
<li>
Datenbank-Dump erstellen (Export gesamten DB in die Datei "dump_all_20160516_1043.sql") und DB verlassen:
<pre>
sqlite> .mode insert
sqlite> .output dump_all_20160516_1043.sql
sqlite> .dump
sqlite> .exit
</pre>
</li>
<li>
Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:
<pre>sudo sqlite3 fhem-neu.db</pre>
<pre>
sqlite> .read dump_all_20160516_1043.sql
sqlite> pragma integrity_check;
ok
sqlite> .exit
</pre>
</li>
<li>
Spätestens jetzt fhem stoppen:
<pre>sudo service fhem stop</pre>
</li>
<li>
Alte DB sichern und neue aktivieren:
<pre>
sudo mv fhem.db fhem.db.sv_20160516
sudo mv fhem-neu.db fhem.db
</pre>
</li>
<li>
Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):
<pre>
~/fhem$ ls -lha
insgesamt 6,3G
drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .
drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..
...
-rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db
-rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516
...

~/fhem$ sudo chown fhem:root fhem.db

~/fhem$ ls -lha
insgesamt 6,3G
drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .
drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..
...
-rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db
-rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516
...
</pre>
</li>
<li>
fhem wieder starten (und natürlich kontrollieren):
<pre>sudo service fhem start</pre>
</li>
</ol>

== Nützliche Codeschnipsel ==
Anbei ein paar nützliche Codeschnipsel rund um DbLog

=== Dateigrösse mitloggen ===
Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:

<pre>attr myDbLog userReadings DbFileSize:lastReduceLogResult.* { (split(' ',`du -m fhem.db`))[0] }</pre>

Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading "DbFileSize" in ganzzahligen MByte abgelegt.

Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.

== Links ==
* [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]
* [[SVG-Plots von FileLog auf DbLog umstellen]]

MQTT Einführung Teil 3

2017-04-06T17:41:18Z

Jorge3711: /* Links */ Links zu Teil 1 und 2 in interne Links verwandelt

= MQTT Einführung Teil 3 =
Zeit sich die Hände schmutzig zu machen

'''NOCH NICHT GANZ FERTIG'''

== Übersicht ==
Im folgenden basteln wir einen einfachen Temperatursensor.

Das ist nicht aufregend. Jedoch ist der Code im Originalzustand sehr gut überschaubar. Man kann daher gut die Änderungen sehen.

== Originales Projekt ==
[http://fluuux.de/2012/10/arduino-temperatur-und-luftfeuchtigkeit-mit-dem-dht22-prufen/ hier bitte nachlesen]

Mit freundlicher Genehmigung des Autors hier der originale Quellcode:

<syntaxhighlight lang="arduino">
#include "DHT.h"

#define DHTPIN 9
#define DHTTYPE DHT22 //DHT11, DHT21, DHT22

DHT dht(DHTPIN, DHTTYPE);

void setup()
{
Serial.begin(9600);
Serial.println("DHT22 - Test!");

dht.begin();
}

void loop()
{
float h = dht.readHumidity(); //Luftfeuchte auslesen
float t = dht.readTemperature(); //Temperatur auslesen

// Prüfen ob eine gültige Zahl zurückgegeben wird. Wenn NaN (not a number) zurückgegeben wird, dann Fehler ausgeben.
if (isnan(t) || isnan(h))
{
Serial.println("DHT22 konnte nicht ausgelesen werden");
}
else
{
Serial.print("Luftfeuchte: ");
Serial.print(h);
Serial.print(" %\t");
Serial.print("Temperatur: ");
Serial.print(t);
Serial.println(" C");
}
}
</syntaxhighlight>

=== Benötigte Hardware ===
* Arduino
* DHT-22 Sensor (nicht der Beste, aber seine Verwendung hält den Code einfach)
* 10 kOhm Widerstand
* Steckbrett
* Drähte

Zusätzlich
* Ethernetshield mit W5100 Chip
* MQTT Broker (Testweise: 37.187.106.16 => IP von test.mosquitto.org)

== Kurze Beschreibung was der originale Code tut ==
* Zeilen 1-6: Library einbinden, PIN festlegen, initialisieren.
* Zeilen 8-14: Serielle Schnittstelle konfigurieren, netten Text schreiben...
* Zeilen 18-19: Sensorwerte auslesen
* Zeilen 21-25: Fehlerbehandlung
* Zeilen 26-34: Sensorwerte mit Beschreibung an die serielle Schnittstelle senden

=== Bibliotheken die zu installieren sind ===
Anmerkung:

Die Arduino IDE bietet viele Möglichkeiten Bibliotheken einzubinden. Bevorzugt verwendet man den eingebauten Library-Manager. Wer das nicht will, kann auch die Bibliotheken als ZIP Datei herunterladen, und dann mit "Bibliothek aus ZIP Datei hinzufügen" einbinden.

Im folgenden die Links zu den ZIP Dateien
Für den originalen Sketch
* [https://github.com/adafruit/DHT-sensor-library Adafruit DHT Library]
* [https://github.com/adafruit/Adafruit_Sensor Adafruit Sensor Library]
In der Adruino IDE gibt es eine Warnung, ''WARNUNG: Unberechtigter Ordner .github in der Bibliothek 'DHT sensor library'''; diese kann ignoriert werden. Da die Meldung aber immer kommt, löschen wir einfach besagten Ordner ".github" im Ordner der DHT Sensor Library.

Für MQTT brauchen wir drei weitere Libraries:
* [https://github.com/knolleary/pubsubclient PubSubClient Library, MQTT]
* Ethernet, ist in der Arduino IDE schon mit dabei
* SPI, für das Netzwerkshield, ist auch schon dabei

== Notwendige Änderungen ==

Im folgenden bauen wir den Sketch um. Zunächst prüfen wir, was am Sketch an sich geändert werden muss, anschließend fügen wir den MQTT Code hinzu. Zuletzt nutzen wir noch einige MQTT Features für weitere Optimierungen.

=== Änderungen am Skript selbst ===
Die einfachste Möglichkeit ein Skript auf MQTT umzustellen, ist das Ändern der Ausgabe von Serial.print in ein mqtt.publish. Hier ergibt sich im Sketch ein Problem: Pubsubclient kann keine Werte vom Typ "float" als Payload versenden. Daher müssen wir zwei Konvertierungen hinzufügen:
* dtostrf(h,6, 1, humidity);
* dtostrf(t,6, 1, temperature);
machen den Trick: Nehme float h, benutze insgesamt 6 Stellen, 1 Nachkommastelle und schreibe das Ergebnis in humidity.

Weiterhin ist es angenehmer, Variablen etc. am Anfang eines Sketches zu definieren, das machen wir auch noch.

=== Änderungen für MQTT ===
Am einfachsten ist, wir nehmen uns einen der mitgelieferten MQTT Beispielsketche: mqtt_reconnect_nonblocking. Das müssen wir eigentlich nur an den jeweiligen Stellen in den originalen Sketch kopieren.
Dabei sind die IP Adressen anzupassen und eine MAC Adresse zu vergeben.

Statt oder zusätzlich zu unserer Ausgabe über die serielle Schnittstelle fügen wir noch einen client.publish ein, so dass die Werte auf dem Broker landen.

Der Vollständigkeit halber, hier der Sketch für das nicht - blockierende MQTT reconnect:
<syntaxhighlight lang="arduino">
/*
Reconnecting MQTT example - non-blocking

This sketch demonstrates how to keep the client connected
using a non-blocking reconnect function. If the client loses
its connection, it attempts to reconnect every 5 seconds
without blocking the main loop.

*/

#include <SPI.h>
#include <Ethernet.h>
#include <PubSubClient.h>

// Update these with values suitable for your hardware/network.
byte mac[] = { 0xDE, 0xED, 0xBA, 0xFE, 0xFE, 0xED };
IPAddress ip(172, 16, 0, 100);
IPAddress server(172, 16, 0, 2);

void callback(char* topic, byte* payload, unsigned int length) {
// handle message arrived
}

EthernetClient ethClient;
PubSubClient client(ethClient);

long lastReconnectAttempt = 0;

boolean reconnect() {
if (client.connect("arduinoClient")) {
// Once connected, publish an announcement...
client.publish("outTopic","hello world");
// ... and resubscribe
client.subscribe("inTopic");
}
return client.connected();
}

void setup()
{
client.setServer(server, 1883);
client.setCallback(callback);

Ethernet.begin(mac, ip);
delay(1500);
lastReconnectAttempt = 0;
}

void loop()
{
if (!client.connected()) {
long now = millis();
if (now - lastReconnectAttempt > 5000) {
lastReconnectAttempt = now;
// Attempt to reconnect
if (reconnect()) {
lastReconnectAttempt = 0;
}
}
} else {
// Client connected

client.loop();
}

}
</syntaxhighlight>
=== Optimierungsmöglichkeiten ===

==== Unfreiwilliger Netzwerktest ====
Jedesmal wenn die Schleife durchgelaufen wird, bekämen wir eine Nachricht mit der Temperatur und eine mit der Luftfeuchtigkeit. Das ist nicht so wirklich schlau. Hier bieten sich 3 Alternativen an:
* Delay => dumme Idee, blockiert den Arduino, nicht benutzen
* eine nicht-blockierende Methode für den Arduino nehmen => kann man machen
* Senden nur bei Werteänderung => vermutlich das Ressourcenschonendste

Ich verwende Variante 3.

Wir benötigen dazu noch zwei weitere Variablen (h_alt und t_alt); jedesmal wenn die Sendeschleife durchlaufen wird, speichern wir h und t in diese Variablen. Zusätzlich benötigt unsere Schleife nach der Fehlerbehandlung noch einen if Zweig, der dafür sorgt, dass nichts getan wird wenn beide Werte sich nicht geändert haben.

Jetzt können wir MQTT anweisen, die letzten Messwerte retained zu senden. Sonst würden wir erst dann Werte bekommen, wenn sich entweder die Temperatur oder die Luftfeuchte verändert haben.
* client.publish("zuHause/Arduino_1/Kueche/Kuehlschrank/Luftfeuchte",humidity);
wird zu
* client.publish("zuHause/Arduino_1/Kueche/Kuehlschrank/Luftfeuchte",humidity, true);
* das true dahinter ist das Flag für retained Messages

==== Nachtrag zum Thema Pausen ====
Mit den Codeänderungen oben haben wir schon mal ein dauerhaftes publishen der gleichen Daten verhindert. Jedoch gibt es natürlich noch einige technische Besonderheiten, die wir ebenfalls berücksichtigen sollten:

Bis jetzt führt unser Sketch bei jedem Durchlauf durch void.loop() eine Messung durch. Das hat zwei Folgen:
* der Sensor ist im Dauerbetrieb
* kleine Schwankungen führen natürlich zu einem erneuten publishen.
Wenn wir den Code, sagen wir, nur alle 2 Minuten ausführen würden, würderd der Sensor weniger belastet. Beim dem Verwendeten spielt es nicht wirklich eine große Rolle, aber es gibt Sensoren die auf einen derart häufigen Zugriff durchaus empfindlich reagieren können.

Gleichzeitig bekommen wir viele kleine Schwankungen (ich nenne sie mal Messungenauigkeiten) übermittelt, die uns eigentlich nicht interessieren.

Die einfache Variante wäre wieder ein Delay. Dieses würde recht schnell zu einem Fehler führen: Ein Delay blockiert. Für MQTT bedeutet es, dass keine Keep-alive Pakete mehr gesendet werden. Hätten wir eingehende Nachrichten, dann würden wir diese auch verpassen.
Wir merken uns: nutze niemals Delays.

Die oben schon angesprochene Lösung, eine nicht blockierende Methode verwenden, ist sehr gut geeignet.

Wie geht das?

Zunächst zählt der Arduino seine Laufzeit in Millisekunden. Wir schreiben unseren Temperaturausleseteil in eine kleine Schleife.
* zwei weitere Variablen
** unsigned long previousMillis = 0; //Zählervariable, zählt Millisekunden seit dem letzten Funktionsaufruf nach oben
** const long interval = 120000; //120000 Millisekunden aka 120 Sekunden, das Interval wie oft der Sensor überhaupt benutzt wird
* Drei Zeilen Programmcode mehr:

<syntaxhighlight lang="arduino">
unsigned long currentMillis = millis();

if (currentMillis - previousMillis >= interval) {
previousMillis = currentMillis;

h = dht.readHumidity(); //Luftfeuchte auslesen
t = dht.readTemperature(); //Temperatur auslesen
}
</syntaxhighlight>

==== Last Will & Testament ====
Retten wir auch die Statusmeldungen des Skripts nach MQTT. Dazu ergänzen wir den client.connect Aufruf:
* if (client.connect("Arduino_1")) {

um folgendes:
* if (client.connect("Arduino_1", "zuHause/Arduino_1", 0, true, "offline")) {
** Arduino_1 nennt sich unser Sensor
** "zuHause/Arduino_1" ist das Topic für dessen Statusmeldungen
** 0 ist die QoS
** true bedeutet, Nachricht retained senden
** "offline" ist das, was auf dem Topic geschrieben werden soll, wenn die Verbindung abbricht
** Anmerkung:
** Unsauberes disconnect wird verursacht durch:
** Abbruch der Netzwerkverbindung
** Protokollfehler (z.B. ungültige Topics, fehlerhafte Payload)

Warum machen wir das?
* beim Start des Sensors steht nun "online" im Status
* bei einem Sensorfehler werden wir auf den Sensorfehler aufmerksam gemacht "Sensorfehler"
* bricht die Netzwerkverbindung ab, steht automatisch "offline" in dem Topic
* bei einer erfolgreichen Messung mit Datenübertragung steht wieder "online" im Topic
Auf diese Art und Weise haben wir eine aussagekräftige Zustandsmeldung in unserem Topic. Diese können wir bequem mit FHEM überwachen, um bei einem Fehler weitere Maßnahmen einzuleiten. Ein Vergleich des Alters der Sensorwerte wird überflüssig.

=== MQTT an sich ===
Wer keinen eigenen Broker hat und (für diesen einen Test) keinen aufsetzen will, kann testweise auch einen öffentlichen Broker benutzen: test.mosquitto.org stellt so einen bereit. Bitte beachten, dass dieser Broker wirklich öffentlich ist. Mit ''ping test.mosquitto.org'' bekommt man die IP Adresse, die man, ich möchte es nochmal betonen, zu Testzwecken, in seinen Sketch schreiben kann.

Wir benötigen für MQTT entsprechende Topics.
* "zuHause/Arduino_1/Kueche/Kuehlschrank/Luftfeuchte"
* "zuHause/Arduino_1/Kueche/Kuehlschrank/Temperatur"

== Daus ergibt sich letztlich folgender Sketch ==
<syntaxhighlight lang="arduino">
#include <DHT.h>
#include <SPI.h>
#include <Ethernet.h>
#include <PubSubClient.h>

#define DHTPIN 9
#define DHTTYPE DHT22 //DHT11, DHT21, DHT22

DHT dht(DHTPIN, DHTTYPE);

byte mac[] = { 0xDE, 0xED, 0xBA, 0xFE, 0xFE, 0xED }; //eine MAC Adresse wählen, darf im eigenen Netz nur 1x vorkommen
IPAddress ip(192, 168, 5, 220); //eine gültige IP Adresse für das eigene Netz
IPAddress server(192, 168, 5, 2); //die Adresse wo der eigene MQTT Broker drauf läuft

void callback(char* topic, byte* payload, unsigned int length) {
// handle message arrived
}

EthernetClient ethClient;
PubSubClient client(ethClient);

long lastReconnectAttempt = 0;

boolean reconnect() {
if (client.connect("Arduino_1", "zuHause/Arduino_1", 0, true, "offline")) {
// Once connected, publish an announcement...
client.publish("zuHause/Arduino_1","online", true);
// ... and resubscribe
client.subscribe("inTopic");
}
return client.connected();
}
static char humidity[15]; //Speicherbereich reservieren um die Fechtigkeit zu speichern
static char temperature[15];
float h = 0.0;
float h_alt = 0.0;
float t = 0.0;
float t_alt = 0.0;
unsigned long previousMillis = 0; //Zählervariable, zählt Millisekunden seit dem letzten Funktionsaufruf nach oben
const long interval = 120000; //120000 Millisekunden aka 120 Sekunden, das Interval wie oft der Sensor überhaupt benutzt wird

void setup()
{
client.setServer(server, 1883);
client.setCallback(callback);

Ethernet.begin(mac, ip);
delay(1500);
lastReconnectAttempt = 0;

Serial.begin(9600);
Serial.println("DHT22 - Test!");

dht.begin();
}

void loop()
{
if (!client.connected()) {
long now = millis();
if (now - lastReconnectAttempt > 5000) {
lastReconnectAttempt = now;
// Attempt to reconnect
if (reconnect()) {
lastReconnectAttempt = 0;
}
}
} else {
// Client connected

client.loop();
}

unsigned long currentMillis = millis();

if (currentMillis - previousMillis >= interval) {
previousMillis = currentMillis;

h = dht.readHumidity(); //Luftfeuchte auslesen
t = dht.readTemperature(); //Temperatur auslesen
}

// Prüfen ob eine gültige Zahl zurückgegeben wird. Wenn NaN (not a number) zurückgegeben wird, dann Fehler ausgeben.
if (isnan(t) || isnan(h))
{
Serial.println("DHT22 konnte nicht ausgelesen werden");
client.publish("zuHause/Arduino_1","Sensorfehler",true); //true sendet die Nachricht retained, d.h. die Nachricht bleibt solange auf dem Broker, bis etwas neues kommt
}
else if (h == h_alt && t == t_alt)
{
//nix machen
}
else
{
client.publish("zuHause/Arduino_1","online", true);
dtostrf(h,6, 1, humidity);
dtostrf(t,6, 1, temperature);
client.publish("zuHause/Arduino_1/Kueche/Kuehlschrank/Luftfeuchte",humidity, true);
client.publish("zuHause/Arduino_1/Kueche/Kuehlschrank/Temperatur",temperature, true);
h_alt = h; //den alten Messwert aufheben
t_alt = t; //um nur bei Veränderung zu reagieren
Serial.print("Luftfeuchte: ");
Serial.print(h);
Serial.print(" %\t");
Serial.print("Temperatur: ");
Serial.print(t);
Serial.println(" C");

}
}
</syntaxhighlight>

== Zusammenfassung ==
Um aus einem "normalen" Sketch einen MQTT Sketch zu machen muss man also:
* Netzwerk konfigurieren
* MQTT einrichten
Im wesentlichen kann man einfach den MQTT Beispielsketch "mqtt reconnect nonblocking" in seinen Sketch einbauen.

Geringe Änderungen im vorhandenen Code sind nötig, um diversen Typen von Variablen als MQTT Payload verwenden zu können

Als Bonus bekommen wir "vernünftige" Statuswerte für unseren Sensor, die sich einfach in FHEM abfangen und auswerten lassen. Als weiteren Bonus betrachte ich, dass die Netzwerklast sinkt. Zum Vergleich möchte ich hier die Jeelink Sensoren anführen, aber auch viele 433 MHz Sensoren, die einfach im "wenige Sekunden Takt" ihre Werte in der Gegend rumfunken. Von da her kann durch den Einsatz von MQTT-Techniken die Funkbelastung der Umgebung reduziert werden. Einerseits trägt man also weniger zur "Sensorischen Luftverschmutzung" bei, andererseits entlastet man auch sein FHEM vor der Aufgabe, unnötige Werte erst mal zu verwerfen.

== Danke ==
Hier möchte ich mal Danke sagen. An Beta-User, der seit Teil 1 das Geschreibsel vorab durchliest und immer wertvolle Tipps und Änderungsvorschläge parat hat.

== Links ==
[http://fluuux.de/2012/10/arduino-temperatur-und-luftfeuchtigkeit-mit-dem-dht22-prufen/ Originales Projekt]

[[MQTT_Einführung|Teil 1 der MQTT Einführung]]

[[MQTT_Einführung_Teil_2|Teil 2 der MQTT Einführung]]

[https://forum.fhem.de/index.php/topic,69954.0.html Diskussionsthread im Forum]

MQTT Einführung Teil 2

2017-04-06T17:38:05Z

Jorge3711: /* Vorwort */ Link zu Teil 1 in einen internen Link verwandelt

= MQTT Teil 2 =
Konzepte und best practices

== Vorwort ==
Wer den Teil 1 noch nicht gelesen hat, ist herzlich eingeladen das vorher noch schnell zu machen :)

[[MQTT_Einführung|Hier ist Teil 1]]

Dieser Artikel beschreibt, etwas trocken, weiterführend Konzepte und Denkweisen des Übertragungsprotokolls MQTT. Es wird etwas technischer als die Einführung und der ein oder andere Vergleich zu anderen Protokollen wird auch gezogen. Vieles davon kann man auch so nachlesen, wenngleich nicht immer auf deutsch. Ich gehe davon aus, dass der Leser MQTT vornehmlich mit FHEM einsetzen will.

Ein Beispielkurs ist in Planung. Dort werden wir die Konzepte praktisch kennen lernen.

== Retained Messages ==
=== Szenario ===
Stellen wir uns vor, wir starten FHEM neu. Wer Homematic Devices kennt weiß, spätestens nach einem Blick ins Logfile, dass nun zunächst ein Statusrequest aller Geräte erfolgt. Schließlich konnte sich zwischen Beenden und Neustart von FHEM etwas geändert haben.
* Homematic
* Es wird jedes Gerät angesprochen und abgefragt:
* "Lieber Lichtschalter, was tust du grade?"
* "Ich lasse das Licht über dir leuchten mein User."
MQTT hat hier ein anderes Konzept. Wenn in ein Topic gepostet wird, kann ein "retained Flag" gesetzt werden.

=== Das bedeutet ===
Die zuletzt gepostete Nachricht wird vom Broker nicht gelöscht. Publishen wir also den Status unseres Lichts:
* zuHause/1OG/Kueche/Licht/state "on" oder "off" + retained flag
Sobald wir dieses Topic auf einem Gerät subscriben, bekommen wir den Status angezeigt. Ein neu startendes FHEM ist so ein Fall.

Was bei Homematic erst über einen (zugegeben automatisierten Request) abläuft, kann MQTT mit den retained Messages auch so.

Trifft am Broker eine neue retained Message ein, so wird die alte Nachricht gelöscht. Zum absichtlichen Löschen einer retained Message, etwa weil man weiß, dass dieses Topic zukünftig nicht mehr benötigt wird, kann man eine leere Message posten.

=== Fazit ===
Retained Messages sind gut, um jeweils die letzte aktuelle Statusmeldung zu erhalten. Was damit nicht geht, ist z.B. die letzten 30 Messungen eines Temperatursensors zu speichern und auszuliefern! Sobald eine retained Message überschrieben wird, ist der alte Wert futsch.

== Last Will and Testament (LWT) ==
=== Szenario ===
Letzter Wille und Testament. <hr>
Unser batteriebetriebener Sensor hat keinen Strom mehr, das billige 5V Netzteil stellt seinen Dienst ein, ein netter Nachbar eröffnet ein neues WLAN Netz welches unser Bestehendes gnadenlos stört, unsere süßen kleinen Miezekatzen finden Patchkabel so spannend, dass sie es für erfolgreiche Beißübungen verwenden…
Gründe für einen Sensorausfall gibt es durchaus.
Was passiert in FHEM?
Der letzte Sensorwert bleibt im Reading stehen. Blöd wenn man erst abends feststellt, dass der Kühlschrank offen stand oder der Schaltbefehl zum Heizung einschalten nicht angekommen ist. Ersteres sorgt für aufgetautes Essen, letzteres für kalte Füße.
Wie fängt man das ab?
FHEM-seitig könnte man einen Watchdog oder ein DOIF einrichten. Es muss geprüft werden, ob sich das entsprechende Reading in einer bestimmten Zeit verändert hat. <hr>
Möglich.

=== MQTT Lösung ===
Der Letzte Wille, das Testament (LWT)

Beim Anmelden an einen Broker kann ein Last Will - Topic angegeben werden. Ebenso eine Payload. Wenn das Gerät verschwindet ohne sich sauber abgemeldet zu haben, wird der Broker die gewünschte Nachricht auf dem hinterlegten Topic publishen. Das retained Flag kann auch gesetzt werden.
Was bedeutet das für uns?

Zusätzlich zu:
*zuHause/1_OG/Kueche/Licht/state
*zuHause/1_OG/Kueche/Licht/set

könnten wir zusätzlich
* zuHause/1_OG/Kueche/Licht/status
definieren.

Beim Anmelden an den Broker schicken wir (mit retained flag) ein "online"
Als LWT geben wir das gleiche Topic an, aber mit "offline" und retained flag. Meldet sich unser Device sauber ab (disconnect), wird das LWT nicht verwendet. Es dient nur dazu, einen Fehler deutlich zu machen.

==== Vorsicht ====
LWT bezieht sich auf die Client ID. Was das schon wieder?
Jedes angemeldete Gerät hat eine einzige Client ID, unabhängig davon wie viele Topics es published und subscribed hat.
LWT auf ein Topic zu beziehen macht wenig Sinn, wenn es mehrere Topics auf dem Gerät gibt. Obiges Beispiel ist also gut, wenn an dem MC genau dieses eine Licht hängt!
* zuHause/1OG/Arduino_1
Ist der bessere Weg! Jetzt können wir in FHEM auf online / offline reagieren und den davon abhängigen Geräten eine Fehlerbehandlung spendieren. Da ist unser DOIF wieder :)

==== Noch eine Falle ====
Wer denkt, er wirft alle Geräte in ein einziges retained last will Topic, sieht immer nur die letzte Meldung!

Böse:

zuHause/MQTT/Status (<= nicht nachmachen)

=== Fazit ===
MQTT kann einen eleganten Weg bieten, über das Ende eines Gerätes zu informieren. Genau wie bei Homematic aber auch, muss man diese Meldungen auswerten um was sinnvolles damit anzufangen!
Im Fall eines einfachen Sensors ist es recht easy, bei einem Arduino Mega mit 30 Sensoren wird es dann aufwendig (außer man liest weiter bei den Filtern)

== Organisation der Topics ==
=== Basics, erlaubte Zeichen ===
MQTT erlaubt prinzipiell den kompletten UTF8 Zeichensatz.

Außer:
* U+0001..U+001F control characters
* U+007F..U+009F control characters

Theoretisch gehen also Umlaute, Leerzeichen etc. Praktisch kann es passieren, dass ein Endgerät mit Umlauten einfach nix anfangen kann. Leerzeichen sind auch ein Problem, weil UTF 8 davon doch recht viele Möglichkeiten bietet. Ich würde daher empfehlen, Topicbezeichnungen eher wie Gerätenamen in FHEM zu betrachten: Unterstriche statt Leerzeichen, Umlaute ausschreiben (=> ü => ue...)

Groß- und Kleinschreibung muss beachtet werden. Ein Topic muss mindestens ein Zeichen haben, um gültig zu sein. Oh, und $ gehen auch gar nicht. Die verwendet der Broker nämlich für Interna...

Schlechtes Beispiel:
* /zuHause/
* nicht ganz falsch, aber der / am Anfang ist nur zusätzlicher Overhead, daher weglassen

Wirklich falsch:
* zuHause//1_OG
* Hier wird ein leeres Topic definiert. Das ist ungültig.

=== Basics, Strukturierung ===
MQTT kennt publishen und subscriben.

FHEM kennt für jedes Gerät einen "state" und ein "set" Kommando. Das ist bei MQTT nicht nötig, aber durchaus sehr sinnvoll.

Nehmen wir wieder unseren Lichtschalter: Ein Taster an einem Arduino mit einem Relais nebst Lampe daran.

Unglücklich:
* zuHause/1_OG/Kueche/Lichtschalter
Wenn da ein "on" steht, woher will man wissen ob es sich um einen Befehl oder um eine Statusmeldung handelt? Daher bauen wir die FHEM übliche Logik einfach nach:

Etwas glücklicher (kann man machen, man kann es aber schwer filtern)
* zuHause/1_OG/Kueche/Lichtschalter/set
* zuHause/1_OG/Kueche/Lichtschalter/state

Richtig schlau (warum, kommt bei den Filtern)
* set/zuHause/1_OG/Kueche/Lichtschalter
* state/zuHause/1_OG/Kueche/Lichtschalter/state

Jetzt wird es einfach:

auf dem set-Topic publishen wir immer Schaltbefehle. Mit oder ohne retained flag, darüber kann man streiten. Unser Arduino muss also dieses Topic abhören und auswerten.

Das state-Topic nehmen wir um darauf zu publishen (hier ist retained einfeutig praktisch), wie der Zustand unserer Lampe gerade ist. Unser Arduino muss dieses Topic nur schreiben, niemals selber lesen.

Damit haben wir eine saubere Trennung von Befehl und Status erreicht.

=== Aufbau eines Topics ===
Wie bereits geschrieben, kann man die Topics recht frei einfach selbst erfinden. Sinnvoll ist es jedoch, jedem gewünschten Wert ein eigenes Topic zu spendieren.

Ungünstig:
* zuHause/state/1_OG/Kueche
* => In diesem Topic Licht, Temperatur, Luftfeuchte, Bewegungsmelder etc zu publishen ist eine nicht schlaue Idee; das Problem beginnt damit, dass man erst mal selber rausfinden muss, welchen Wert man gerade hat. Viel Programmcode für quasi umsonst; "on 20.3 66 motion" ist nun nicht wirklich toll.

Besser:
* zuHause/state/1_OG/Kueche/Licht
* zuHause/state/1_OG/Kueche/Raumtemperatur
* zuHause/state/1_OG/Kueche/Luftfeuchte
* zuHause/state/1_OG/Kueche/Bewegungsmelder
=> Auf diese Weise weiß man vorher, welche (Zahlen)werte in einem Topic stehen und was sie bedeuten. Das hat man automatisch durch die geschickte Topic Wahl festgelegt.

=== Filter ===
Eine witzige Sache von MQTT sind Filter. Das ist in etwa wie in FHEM eine readingsGroup für Arme. Wir möchten schnell einen Überblick haben, welchen Status bestimmte Devices haben.

Es gibt zwei Arten von Filtern:
* Single Level Filter: +
* Multi Level Filter: #

Beispiele:
* zuHause/state/1_OG/Kueche/Temperatur
* zuHause/state/1_OG/Kueche/Kuehlschrank/Temperatur
* zuHause/state/1_OG/Kueche/Licht
* zuHause/state/1_OG/Wohnzimmer/Licht
* zuHause/state/1_OG/Schlafzimmer/Licht

Jetzt filtern wir:

"#" => muss immer der letzte Filter sein (es gibt Broker, die die # auch als Platzhalter innerhalb eines Topics erlauben, aber Standard ist das nicht)

* zuHause/state/# => gibt uns alle oben genannten Beispiel-Topics zurück
* zuHause/state/1_OG/+/Licht => gibt uns das Licht der Küche, des Wohn- und des Schlafzimmers
* zuHause/state/1_OG/+/Temperatur => gibt nur die Küchentemperatur (+ steht für genau 1 Topic, der Kühlschrank fällt also nicht in das Muster)

=== Diskussionspunkt, Devicenamen ===
Manchmal liest man auch den Tip, eine eindeutige Gerätebezeichnung in das Topic mit aufzunehmen.
* Arduino_1/state/Zimmer_1/Licht
* Arduino_1/state/Zimmer_1/Temperatur
* Arduino_1/state/Zimmer_2/Licht
* Arduino_2/state/Zimmer_3/Licht

Hat im wesentlichen folgenden Vorteil:

Wenn ich mir nur ansehen will, was ein bestimmter Mikrocontroller published, kann ich ihn sehr einfach filtern.
* Arduino_1/# => perfekt um alle Werte des Arduino_1 zu lesen und sonst nichts

Nachteilig:

Tauscht man später den Controller aus, muss man ihn wieder so nennen. Fasst man später Arduino_1 und Arduino_2 auf einem Arduino Mega zusammen, stimmen die Topics schlicht nicht mehr und man muss seine ganzen Devicenamen anpassen.

== Der Artikel hast "Best Practices" versprochen - wo sind sie? ==
Schwierig. Was die Benennung der Topics betrifft, so vom Zeichensatz her, gibt es Regeln und best practices, die stehen oben.

Ob man jetzt eindeutige Gerätenamen vorne weg schreibt, oder ob man state und set weiter vorne im Topic Tree unterbringt oder hinten, ich fürchte da gibt es keine allgemein gültigen Regeln. MQTT lässt einem hier alle Freiheiten.

Das eine sieht eher nach FHEM aus (set und state am Ende), das andere lässt sich besser filtern.
Hardcoreuser könnten auch auf die Idee kommen, einfach beide Varianten gleichzeitig zu nutzen. Für FHEM alleine ist das sicherlich nicht hilfreich (aber auch nicht störend).

== Schlusswort ==
Hier endet vorübergehend unser kleiner Exkurs zu MQTT.

Wer Fragen der Anregungen hat, bitte im [https://forum.fhem.de/index.php/topic,69701.0.html Diskussionsthread dieses Artikels] stellen.

Weiterhin haben wir ganz neu [https://forum.fhem.de/index.php/board,94.0.html einen eigenen Forumsbereich für MQTT].

Je nachdem wie gut die Artikelserie ankommt, werde ich einen Teil 3 auflegen. Dieser ist dann zum "get your hands dirty", zum Hände dreckig machen. Darin könnte ein kleiner Programmierkurs in der Arduino IDE kommen. Mir schwebt vor, einen kleinen Sketch zu nehmen, diesen mit MQTT auszurüsten und nach und nach die Dinge wie LWT, retained messages etc. einzubauen. Das ist im wesentlichen mit wenigen Änderungen möglich. Also durchaus anfängertauglich.

Ich werde einen Arduino Uno oder Mega nehmen, sowie ein Ethernetshield mit W5100 Chip benutzen. Die Dinger kosten keine 6 € auf eBay. Die ENC28J60 (oder ähnliche) Chips werden explizit NICHT unterstützt werden! Wer lieber einen ESP8266 nimmt, der sei an dieser Stelle auf das Template von Pf@nne verwiesen [https://forum.fhem.de/index.php/topic,50238.0.html hier zu finden].

[[Kategorie:Glossary]]