FHEMWiki - Benutzerbeiträge [de]

Hauptseite

2026-01-07T19:56:00Z

Krikan: Einsteiger-PDF aus 2014 nicht mehr Pflichtlektüre

<div style="font-family:sans-serif; font-size: 1.8em; border: none; text-align: center;">'''FHEM Wiki - Informationsportal zum FHEM SmartHome-Server'''</div>
<div align="left">'''[[:Kategorie:FHEM|Hauptkategorien dieses Wikis]]'''</div>

<div class="flexbox"> 
<div class="mainpagebox" style="order: 1; flex: 1 1 80%; background-color:#cce5ff;">
<div class="mw-collapsible mw-collapsed">
'''Was ist FHEM?'''
<div class="mw-collapsible-content">
'''FHEM''' ([https://register.dpma.de/DPMAregister/marke/register/3020152110040/DE R]) ist ein in Perl geschriebener, GPL v2 lizensierter Server für die Heimautomatisierung. Man kann mit FHEM häufig auftretende Aufgaben automatisieren, wie z.B. Lampen / Rollladen / Heizung / usw. schalten, oder Ereignisse wie Temperatur / Feuchtigkeit / Stromverbrauch protokollieren und visualisieren.

Das Programm läuft als Server, man kann es über WEB, dedizierte Smartphone Apps oder telnet bedienen, TCP Schnittstellen für JSON und XML existieren ebenfalls.

Um es zu verwenden, benötigt man einen 24/7 Rechner (NAS, RPi, PC, MacMini, etc) mit einem Perl Interpreter und angeschlossene Interfaces wie CUL-, EnOcean-, Z-Wave-USB-Stick etc. für einen Zugang zu den Aktoren und Sensoren.
</div></div></div>

<div class="mainpagebox" style="order: 4; background-color:#efefef;">
'''Wie fange ich an?'''
* [[Quick-Start]], english version: [[Quick-Start/en|Quick-Start]]
* kleiner FHEM-Kurs, benötigt keine Hardware: [[Erste Schritte in FHEM]] / [[First steps in FHEM]]
* [https://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM]<br />Einsteiger-PDF (Feb. 2014)<br />
* [[Systemübersicht]]
* Phasen eines FHEM-Projekts:
** [[Planung]]
** [[Umsetzung]] (Implementierung)
** [[Betrieb]] ("Produktion")
* [[:Kategorie:Glossary|Glossar]] (Erklärung für bestimmte Begriffe)<br />
* [[:Kategorie:HOWTOS|Verschiedene HowTos]]<br />
* [[:Kategorie:FAQ|Frequently asked Questions - Häufig gestellte Fragen mit Antworten]]<br />

</div>

<div class="mainpagebox" style="order: 6; background-color:#fff0e0;">
'''Unterstützte Hardware (Auszug)'''

* [[:Kategorie:Hardware Typen|Hardware Typen]] - Funktionsbezogene Übersicht (z.B. [[:Kategorie:Unterhaltungselektronik|Unterhaltungselektronik / Multimedia]], [[:Kategorie:Heizungssteuerung|Heizungssteuerung]], [[:Kategorie:Energieverbrauchsmessung|Energieverbrauchsmessung]], etc.)
* [[:Kategorie:Server Hardware|Server Hardware]] - Hardware, auf der FHEM installiert werden kann
* [[:Kategorie:EMS Components|EMS]], [[:Kategorie:FHT Components|FHT]], [[:Kategorie:HMS Components|HMS]] Komponenten
* [[:Kategorie:1-Wire|1-Wire System]]
* [[:Kategorie:EIB/KNX|EIB/KNX Komponenten]]
* [[:Kategorie:FS20 Components|FS20 Komponenten]]
* [[:Kategorie:EnOcean Components|EnOcean Komponenten]]
* [[:Kategorie:HomeMatic Components|HomeMatic Komponenten]]
* [[:Kategorie:MAX|MAX! Komponenten]]
* [[:Kategorie:panStamp|panStamp Komponenten]]
* [[:Kategorie:Z-Wave Components|Z-Wave Komponenten]]
* [[:Kategorie:ZigBee|Zigbee Komponenten]]
* [[:Kategorie:IP Components|Geräte mit Webinterface ("IP")]]
* [[:Kategorie:Other Components|Andere Komponenten / Sonstige Systeme]]

<div align="right"><small>'''[[:Kategorie:Hardware|Alle Hardware-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 5; background-color:#F8F8FF;">
'''Ideen und Lösungen'''

* [[:Kategorie:Code_Snippets|Verschiedene kommentierte Lösungen und Code-Schnippsel]]
* [[:Kategorie:Examples|Beispielanwendungen - Hardwarelösungen - Fremdsystemanbindungen]]
* [[Anwendungsszenarien]]
* [[Trick der Woche|Tipp der Woche]]
* [[Wie kann ich...]]?

<div align="right"><small>'''[[:Kategorie:FHEM|Hauptkategorien dieses Wikis]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 7; background-color:#FFFFE7;">
'''Developers Corner'''

* Informationen zur Modul-Entwicklung:
** [[DevelopmentModuleIntro|Development Module Introduction]]
** [[Meta|Development Module and Package Meta Data]]
** [[DevelopmentModuleAPI|Development Module API]]
** [[DevelopmentFHEMWEB-API|Development FHEMWEB API]]
** [[Blocking Call]]
** [[CoProcess]]
** [[HttpUtils]]
** [[DevIo]]
** [[Guidelines zur Dokumentation]]
** [[DevelopmentGuidelinesAV|Development Guidelines AV-Module]]

* Organisatorisches:
** [[How to write a patch]]
** [[SVN Nutzungsregeln]]

<div align="right"><small>'''[[:Kategorie:Development|Alle Artikel zu Development]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 3; background-color:#d7ffff;">
'''FHEM Wiki News'''
<div style="height:20em;overflow:scroll;overflow-x:hidden;">{{FHEMWiki_News}}</div>
<div align="right"><small>'''Mehr [[FHEMWiki:News|News]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 2; background-color:#e7f8ff;">
'''Was ist FHEM Wiki?'''

Das '''FHEM Wiki''' ergänzt die stets tagesaktuelle, von den zuständigen Entwicklern gepflegte {{Link2CmdRef}} (Befehls-Referenz) um weitergehende Informationen rund um FHEM. Im Wiki arbeiten Nutzer und Entwickler gemeinsam an zusätzlicher Dokumentation von FHEM und damit zusammenhängenden Themen.

Das FHEMWiki stellt neben der {{Link2CmdRef}}, dem [http://forum.fhem.de/ Forum] und der [http://www.fhem.de FHEM] Seite die zentrale Informationsquelle rund um FHEM dar. Bedeutung und Zusammenspiel dieser Elemente [[Dokumentationsstruktur|ist hier]] erläutert.


Bitte [[FHEMWiki:Support | unterstütze uns]] und hilf, [[:Kategorie:NeedsEditing| das Wiki zu erweitern]]. Vielen Dank!

<div align="right"><small>'''Mehr [[FHEMWiki:Über_FHEMWiki|über FHEMWiki]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 8; background-color:#F8F8FF;">
'''Letzte Änderungen'''
<div style="font-size:small;color:black;"><small>{{Special:Recentchanges/8}}</small></div>
<div align="right"><small>'''Mehr [[Special:Recentchanges|Änderungen]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 9; flex: 1 1 80%; background-color:#FFFFAA;">
'''Die letzten fünf neuen Seiten'''
<small>{{Special:NewPages/5}}</small>
<div align="right"><small>'''Mehr [[Special:NewPages|Neue Seiten]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 10; background-color:#DDD68F;">
'''Administratives zum Wiki'''

''Allgemeine Aktivitäten:''
* Registrierung zur Mitarbeit: wende Dich bitte an einen [[FHEMWiki:Administratoren|Administrator]]
* Basiswissen über die Mitarbeit an einem Wiki erarbeiten ([http://de.wikipedia.org/wiki/Wikipedia:Beteiligen z.B. Wikipedia])
* Erweiterung und Korrektur von Artikeln, wo immer nötig
* Ein(ig)e der [[Spezial:Gewünschte Seiten|gewünschten Seiten]] erstellen
* Ideen aus dem [http://forum.fhem.de Forum] in bestehende oder neue Artikel einarbeiten
* [[Spezial:Verwaiste Seiten|verwaiste Seiten]] in sinnvoller Weise verlinken
* [[Spezial:Sackgassenseiten|Sackgassenseiten]] wikifizieren (Links auf andere Seiten einfügen)
* [[Datei:Info_red.png|20px]] '''Tips / Regeln / Hinweise auf "[[FHEMWiki:Über FHEMWiki|Über FHEMWiki]]" beachten!''' [[Datei:Info_red.png|20px]]

''Sonstiges:''
* Zum Ausprobieren bitte die [[FHEMWiki:Sandbox]] benutzen
* [//meta.wikimedia.org/wiki/Help:Contents Wiki Benutzerhandbuch].
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Liste der Wiki-Konfigurationsvariablen]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [[FHEMWiki:Interna|Internes zu diesem Wiki]]
</div>

</div>
[[Kategorie:FHEM]]

MediaWiki:Mobile.css

2026-01-06T08:01:57Z

Krikan: wordmark - grün ist zurück

/* Das folgende CSS wird für alle Nutzer der mobilen Ansicht geladen. */
/* @body-background-color: #ffffe7;*/

body {
background-color: #ffffe7;
}

.mw-body {
background-color: #ffffff;
}

#mw-page-base {
/*background-image: none; */
}

.mw-logo-wordmark {
color: #52865D ;
}

h2 {
margin-top: 1.5em !important;
}

body.page-Hauptseite.action-view h1.firstHeading, body.page-Hauptseite.action-submit h1.firstHeading { display: none; }

.mainpagebox {
border: .125em solid #dfdfdf;
border-radius: .4em;
padding: .4em;
flex: 1 1 40%;
margin: .4em;
}

.flexbox {
display: flex;
flex-flow: row wrap;
justify-content: space-around;
align-items: stretch;
}

MediaWiki:Common.css

2026-01-06T07:59:54Z

Krikan: wordmark - grün ist zurück

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/* @body-background-color: #ffffe7;*/

/* general FHEM styling */
body,#mw-panel,#mw-page-base {
background-color: #ffffe7;
}

.mw-body {
background-color: #ffffff;
}

#mw-page-base {
vertical-gradient: !important unset;
background-image: unset;
}

.mw-logo-wordmark {
color: #52865D ;
}

h2 {
margin-top: 1.5em !important;
}

/* mainpage box styling */
.mainpagebox {
border: .125em solid #dfdfdf;
border-radius: .4em;
padding: .4em;
flex: 1 1 40%;
margin: .4em;
}

/* flexbox styling for image popups */
.flexbox {
display: flex;
flex-flow: row wrap;
justify-content: space-around;
align-items: stretch;
}

MediaWiki:Mobile.css

2026-01-05T19:25:52Z

Krikan: Annäherung an mediawiki-Standard

/* Das folgende CSS wird für alle Nutzer der mobilen Ansicht geladen. */
/* @body-background-color: #ffffe7;*/

body {
background-color: #ffffe7;
}

.mw-body {
background-color: #ffffff;
}
#mw-page-base {
/*background-image: none; */
}

h2 {
margin-top: 1.5em !important;
}

body.page-Hauptseite.action-view h1.firstHeading, body.page-Hauptseite.action-submit h1.firstHeading { display: none; }

.mainpagebox {
border: .125em solid #dfdfdf;
border-radius: .4em;
padding: .4em;
flex: 1 1 40%;
margin: .4em;
}

.flexbox {
display: flex;
flex-flow: row wrap;
justify-content: space-around;
align-items: stretch;
}

MediaWiki:Common.css

2026-01-05T19:24:20Z

Krikan: Annäherung an mediawiki-Standard

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/* @body-background-color: #ffffe7;*/

/* general FHEM styling */
body,#mw-panel,#mw-page-base {
background-color: #ffffe7;
}

.mw-body {
background-color: #ffffff;
}

#mw-page-base {
vertical-gradient: !important unset;
background-image: unset;
}

h2 {
margin-top: 1.5em !important;
}

/* mainpage box styling */
.mainpagebox {
border: .125em solid #dfdfdf;
border-radius: .4em;
padding: .4em;
flex: 1 1 40%;
margin: .4em;
}

/* flexbox styling for image popups */
.flexbox {
display: flex;
flex-flow: row wrap;
justify-content: space-around;
align-items: stretch;
}

MediaWiki:Mobile.css

2026-01-02T12:59:04Z

Krikan: CSS-Eigenschaften für alte Browser entfernt

/* Das folgende CSS wird für alle Nutzer der mobilen Ansicht geladen. */
/* @body-background-color: #ffffe7;*/

body {
background-color: #ffffe7;
}

a, a:visited, a:active, a.external, a.external:active, a.external:visited {
color: #175717;
}

a:hover {
color: #672727;
text-decoration:none;
}

.mw-body {
background-color: #ffffff;
}
#mw-page-base {
/*background-image: none; */
}

h2 {
margin-top: 1.5em !important;
}

body.page-Hauptseite.action-view h1.firstHeading, body.page-Hauptseite.action-submit h1.firstHeading { display: none; }

.mainpagebox {
border: .125em solid #dfdfdf;
border-radius: .4em;
padding: .4em;
flex: 1 1 40%;
margin: .4em;
}

.flexbox {
display: flex;
flex-flow: row wrap;
justify-content: space-around;
align-items: stretch;
}

MediaWiki:Common.css

2026-01-02T12:58:00Z

Krikan: CSS-Eigenschaften für alte Browser entfernt

/* Das folgende CSS wird für alle Benutzeroberflächen geladen. */
/* @body-background-color: #ffffe7;*/

/* general FHEM styling */
body,#mw-panel,#mw-page-base {
background-color: #ffffe7;
}

.mw-body {
background-color: #ffffff;
}

#mw-page-base {
vertical-gradient: !important unset;
background-image: unset;
}

a, a:visited, a:active, a.external, a.external:active, a.external:visited {
color: #175717;
}

a:hover {
color: #672727;
text-decoration:none;
}

h2 {
margin-top: 1.5em !important;
}

/* mainpage box styling */
.mainpagebox {
border: .125em solid #dfdfdf;
border-radius: .4em;
padding: .4em;
flex: 1 1 40%;
margin: .4em;
}

/* flexbox styling for image popups */
.flexbox {
display: flex;
flex-flow: row wrap;
justify-content: space-around;
align-items: stretch;
}

MediaWiki:Sidebar

2026-01-01T14:07:01Z

Krikan: Vorbereitung mediawiki-Update -> Anzeigeprobleme durch Verschiebung TOOLBOX verhindern

Hauptseite

2026-01-01T14:03:25Z

Krikan: Vorbereitung mediawiki-Update -> kein Inhaltsverzeichnis auf Hauptseite

<div style="font-family:sans-serif; font-size: 1.8em; border: none; text-align: center;">'''FHEM Wiki - Informationsportal zum FHEM SmartHome-Server'''</div>
<div align="left">'''[[:Kategorie:FHEM|Hauptkategorien dieses Wikis]]'''</div>

<div class="flexbox"> 
<div class="mainpagebox" style="order: 1; flex: 1 1 80%; background-color:#cce5ff;">
<div class="mw-collapsible mw-collapsed">
'''Was ist FHEM?'''
<div class="mw-collapsible-content">
'''FHEM''' ([https://register.dpma.de/DPMAregister/marke/register/3020152110040/DE R]) ist ein in Perl geschriebener, GPL v2 lizensierter Server für die Heimautomatisierung. Man kann mit FHEM häufig auftretende Aufgaben automatisieren, wie z.B. Lampen / Rollladen / Heizung / usw. schalten, oder Ereignisse wie Temperatur / Feuchtigkeit / Stromverbrauch protokollieren und visualisieren.

Das Programm läuft als Server, man kann es über WEB, dedizierte Smartphone Apps oder telnet bedienen, TCP Schnittstellen für JSON und XML existieren ebenfalls.

Um es zu verwenden, benötigt man einen 24/7 Rechner (NAS, RPi, PC, MacMini, etc) mit einem Perl Interpreter und angeschlossene Interfaces wie CUL-, EnOcean-, Z-Wave-USB-Stick etc. für einen Zugang zu den Aktoren und Sensoren.
</div></div></div>

<div class="mainpagebox" style="order: 4; background-color:#efefef;">
'''Wie fange ich an?'''
* [[Datei:Info_green.png|20px]][https://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM][[Datei:Info_green.png|20px]]<br />DAS Einsteiger-PDF. '''Pflichtlektüre!'''<br />
* [[Quick-Start]], english version: [[Quick-Start/en|Quick-Start]]
* kleiner FHEM-Kurs, benötigt keine Hardware: [[Erste Schritte in FHEM]] / [[First steps in FHEM]]
* [[Systemübersicht]]
* Phasen eines FHEM-Projekts:
** [[Planung]]
** [[Umsetzung]] (Implementierung)
** [[Betrieb]] ("Produktion")
* [[:Kategorie:Glossary|Glossar]] (Erklärung für bestimmte Begriffe)<br />
* [[:Kategorie:HOWTOS|Verschiedene HowTos]]<br />
* [[:Kategorie:FAQ|Frequently asked Questions - Häufig gestellte Fragen mit Antworten]]<br />

</div>

<div class="mainpagebox" style="order: 6; background-color:#fff0e0;">
'''Unterstützte Hardware (Auszug)'''

* [[:Kategorie:Hardware Typen|Hardware Typen]] - Funktionsbezogene Übersicht (z.B. [[:Kategorie:Unterhaltungselektronik|Unterhaltungselektronik / Multimedia]], [[:Kategorie:Heizungssteuerung|Heizungssteuerung]], [[:Kategorie:Energieverbrauchsmessung|Energieverbrauchsmessung]], etc.)
* [[:Kategorie:Server Hardware|Server Hardware]] - Hardware, auf der FHEM installiert werden kann
* [[:Kategorie:EMS Components|EMS]], [[:Kategorie:FHT Components|FHT]], [[:Kategorie:HMS Components|HMS]] Komponenten
* [[:Kategorie:1-Wire|1-Wire System]]
* [[:Kategorie:EIB/KNX|EIB/KNX Komponenten]]
* [[:Kategorie:FS20 Components|FS20 Komponenten]]
* [[:Kategorie:EnOcean Components|EnOcean Komponenten]]
* [[:Kategorie:HomeMatic Components|HomeMatic Komponenten]]
* [[:Kategorie:MAX|MAX! Komponenten]]
* [[:Kategorie:panStamp|panStamp Komponenten]]
* [[:Kategorie:Z-Wave Components|Z-Wave Komponenten]]
* [[:Kategorie:ZigBee|Zigbee Komponenten]]
* [[:Kategorie:IP Components|Geräte mit Webinterface ("IP")]]
* [[:Kategorie:Other Components|Andere Komponenten / Sonstige Systeme]]

<div align="right"><small>'''[[:Kategorie:Hardware|Alle Hardware-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 5; background-color:#F8F8FF;">
'''Ideen und Lösungen'''

* [[:Kategorie:Code_Snippets|Verschiedene kommentierte Lösungen und Code-Schnippsel]]
* [[:Kategorie:Examples|Beispielanwendungen - Hardwarelösungen - Fremdsystemanbindungen]]
* [[Anwendungsszenarien]]
* [[Trick der Woche|Tipp der Woche]]
* [[Wie kann ich...]]?

<div align="right"><small>'''[[:Kategorie:FHEM|Hauptkategorien dieses Wikis]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 7; background-color:#FFFFE7;">
'''Developers Corner'''

* Informationen zur Modul-Entwicklung:
** [[DevelopmentModuleIntro|Development Module Introduction]]
** [[Meta|Development Module and Package Meta Data]]
** [[DevelopmentModuleAPI|Development Module API]]
** [[DevelopmentFHEMWEB-API|Development FHEMWEB API]]
** [[Blocking Call]]
** [[CoProcess]]
** [[HttpUtils]]
** [[DevIo]]
** [[Guidelines zur Dokumentation]]
** [[DevelopmentGuidelinesAV|Development Guidelines AV-Module]]

* Organisatorisches:
** [[How to write a patch]]
** [[SVN Nutzungsregeln]]

<div align="right"><small>'''[[:Kategorie:Development|Alle Artikel zu Development]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 3; background-color:#d7ffff;">
'''FHEM Wiki News'''
<div style="height:20em;overflow:scroll;overflow-x:hidden;">{{FHEMWiki_News}}</div>
<div align="right"><small>'''Mehr [[FHEMWiki:News|News]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 2; background-color:#e7f8ff;">
'''Was ist FHEM Wiki?'''

Das '''FHEM Wiki''' ergänzt die stets tagesaktuelle, von den zuständigen Entwicklern gepflegte {{Link2CmdRef}} (Befehls-Referenz) um weitergehende Informationen rund um FHEM. Im Wiki arbeiten Nutzer und Entwickler gemeinsam an zusätzlicher Dokumentation von FHEM und damit zusammenhängenden Themen.

Das FHEMWiki stellt neben der {{Link2CmdRef}}, dem [http://forum.fhem.de/ Forum] und der [http://www.fhem.de FHEM] Seite die zentrale Informationsquelle rund um FHEM dar. Bedeutung und Zusammenspiel dieser Elemente [[Dokumentationsstruktur|ist hier]] erläutert.


Bitte [[FHEMWiki:Support | unterstütze uns]] und hilf, [[:Kategorie:NeedsEditing| das Wiki zu erweitern]]. Vielen Dank!

<div align="right"><small>'''Mehr [[FHEMWiki:Über_FHEMWiki|über FHEMWiki]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 8; background-color:#F8F8FF;">
'''Letzte Änderungen'''
<div style="font-size:small;color:black;"><small>{{Special:Recentchanges/8}}</small></div>
<div align="right"><small>'''Mehr [[Special:Recentchanges|Änderungen]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 9; flex: 1 1 80%; background-color:#FFFFAA;">
'''Die letzten fünf neuen Seiten'''
<small>{{Special:NewPages/5}}</small>
<div align="right"><small>'''Mehr [[Special:NewPages|Neue Seiten]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 10; background-color:#DDD68F;">
'''Administratives zum Wiki'''

''Allgemeine Aktivitäten:''
* Registrierung zur Mitarbeit: wende Dich bitte an einen [[FHEMWiki:Administratoren|Administrator]]
* Basiswissen über die Mitarbeit an einem Wiki erarbeiten ([http://de.wikipedia.org/wiki/Wikipedia:Beteiligen z.B. Wikipedia])
* Erweiterung und Korrektur von Artikeln, wo immer nötig
* Ein(ig)e der [[Spezial:Gewünschte Seiten|gewünschten Seiten]] erstellen
* Ideen aus dem [http://forum.fhem.de Forum] in bestehende oder neue Artikel einarbeiten
* [[Spezial:Verwaiste Seiten|verwaiste Seiten]] in sinnvoller Weise verlinken
* [[Spezial:Sackgassenseiten|Sackgassenseiten]] wikifizieren (Links auf andere Seiten einfügen)
* [[Datei:Info_red.png|20px]] '''Tips / Regeln / Hinweise auf "[[FHEMWiki:Über FHEMWiki|Über FHEMWiki]]" beachten!''' [[Datei:Info_red.png|20px]]

''Sonstiges:''
* Zum Ausprobieren bitte die [[FHEMWiki:Sandbox]] benutzen
* [//meta.wikimedia.org/wiki/Help:Contents Wiki Benutzerhandbuch].
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Liste der Wiki-Konfigurationsvariablen]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [[FHEMWiki:Interna|Internes zu diesem Wiki]]
</div>

</div>
[[Kategorie:FHEM]]

FHEM Installation Windows

2025-12-29T09:36:24Z

Krikan: /* Installation per Skript */ powershell "-ExecutionPolicy Bypass" ergänzt

{{Baustelle}}
'''{{PAGENAME}}''' beschreibt die Installation von FHEM als portable Software für Windows (keine Eingriffe in die Registrierungsdatenbank). Die Anleitung ist sowohl für die Installation auf einem Wechseldatenträger, zum Beispiel einem USB-Stick, als auch auf einem internen Laufwerk anwendbar. Nach der Grundinstallation ist FHEM zum Ausprobieren, Experimentieren und/oder den portablen Einsatz eingerichtet. Bei Installation auf einem internen Laufwerk ist die abschließend dargestellte Einrichtung von FHEM als Dienst und damit der dauerhafte Betrieb als Hausautomations-Server unter Windows möglich.
==Manuelle Installation==
===Grundinstallation===
====Installation FHEM====
Das aktuelle [https://fhem.de/#Download fhem-X.Y.zip Paket] (momentan fhem-6.4.zip) herunterladen.

Einen neuen Ordner für FHEM anlegen. Für diesen Artikel wurde der Ordner <code>f:\my-fhem</code> angelegt.

Den gesamten Inhalt des Ordners <code>fhem-6.4\fhem-6.4</code> aus dem .zip-Paket nach <code>f:\my-fhem</code> entpacken.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> befindet sich anschließend unter anderem die Datei <code>fhem.pl</code>.

====Installation Perl====
Eine aktuelle [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] herunterladen und im Ordner von FHEM entpacken.

Hier wurde der Inhalt des Pakets "strawberry-perl-5.42.0.1-64bit-portable.zip" nach <code>f:\my-fhem</code> entpackt.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> existiert anschließend unter anderem ein zusätzlicher Ordner <code>perl</code>.

====Start von FHEM====
Eine Eingabeaufforderung (cmd) in Windows öffnen, in den zuvor angelegten Ordner wechseln, portableshell.bat aufrufen und anschließend FHEM starten:

<syntaxhighlight lang="doscon">
C:\> cd f:\my-fhem
F:\my-fhem> portableshell.bat
F:\my-fhem> perl fhem.pl fhem.cfg
</syntaxhighlight>

Jetzt erscheint ein Windows-Sicherheitshinweis, dass die Windows-Firewall den Perl Interpreter blockiert. Für den Zugriff auf FHEM muss eine Firewall-Ausnahme eingerichtet werden. Hierzu ist der Sicherheitshinweis mit dem Button {{Taste|Zugriff zulassen}} zu beenden.

''Hinweis:'' In der Eingabeaufforderung erscheint keine Rückmeldung und das Programm beendet sich nicht. Die Eingabeaufforderung darf nicht geschlossen werden, so lange FHEM läuft.

====Aufruf des FHEM-Webinterfaces (FHEMWEB)====
Einen Browser öffnen (Firefox, Chrome und Safari werden empfohlen) und FHEM unter folgender Adresse aufrufen:

<code>http://localhost:8083/fhem</code>

Es öffnet sich die FHEM-Hauptseite:

[[Datei:ErsteSchritteInFhem01.png]]

====Update von FHEM====
FHEM wird kontinuierlich weiterentwickelt. Daher sollte direkt ein Update auf den aktuellen Entwicklungsstand durchgeführt werden.

Im Befehls-Eingabefeld von FHEM, das ist das weiße, rechteckige Texteingabefeld rechts neben dem FHEM-Logo, den Befehl

<code>update</code>

eingeben und mit {{Taste|Enter}} abschließen.

Es beginnt der Update-Prozeß, der eine Weile dauern kann. Den Fortschritt zeigt FHEM an. Am Ende des Update-Prozesses fordert FHEM zu einem "shutdown restart" auf. Dies bitte ignorieren und im Befehls-Eingabefeld nur

<code>shutdown</code>

gefolgt von {{Taste|Enter}} zum Beenden von FHEM eingeben.

Nun wieder zum Fenster der Eingabeaufforderung wechseln. Das aktualisierte FHEM erneut starten; beispielsweise durch {{Taste|Pfeil hoch}} gefolgt von {{Taste|Enter}} oder erneute Eingabe von

<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg</syntaxhighlight>

Hiermit ist die Installation von FHEM bereits grundlegend abgeschlossen und [[Erste Schritte in FHEM]] lädt zum Ausprobieren ein.

===Installations-Optionen===
====Installation von FHEM als Dienst====
''Hinweis:'' Die Einrichtung von FHEM als Dienst erfordert einen automatisch im folgenden Installationsprozeß erstellten Eintrag in der Registrierungsdatenbank.

FHEM durch Eingabe von <code>shutdown</code> im Befehls-Eingabefeld beenden.

Eine Eingabeaufforderung als Administrator öffnen und die PATH Umgebungsvariable für Perl erweitern, FHEM als Dienst installieren sowie den Dienst starten:
<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> powershell -NoProfile -Command ^
"$new = 'F:\my-fhem\perl\site\bin;F:\my-fhem\perl\bin;F:\my-fhem\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"
F:\my-fhem> perl fhem.pl fhem.cfg -i
F:\my-fhem> net start fhem
</syntaxhighlight>

Im Windows-Verwaltungswerkzeug "Dienste" wird der FHEM-Dienst nach erfolgreicher Einrichtung mit dem Namen "fhem server" aufgeführt. FHEM startet nach Installation als Dienst beim Windows-Start unsichtbar (ohne offene Eingabeaufforderung) im Hintergrund.

Anders als beim Start von FHEM über die Eingabeaufforderung kann bei FHEM als Dienst nach einem <code>update</code> der Befehl <code>shutdown restart</code> erfolgreich ausgeführt werden.

==Installation per Skript==
Folgendes Skript "fhem_install.bat" installiert FHEM mit allen Installationsoptionen (PATH-Erweiterung, Dienstinstallation) auf dem internen Laufwerk C. Das Skript muss mit Administratorrechten ausgeführt werden.

<syntaxhighlight lang="bat">
rem fhem_install.bat

setlocal

rem -- Installationsverzeichnis (sollte keine Leer- oder Sonderzeichen enthalten und nicht zu lang sein) und Download-URLs festlegen
set "INSTALLDIR=C:\my-fhem"
set "FHEMURL=https://fhem.de/fhem-6.4.zip"
set "STRAWBERRYPERLURL=https://github.com/StrawberryPerl/Perl-Dist-Strawberry/releases/download/SP_54201_64bit/strawberry-perl-5.42.0.1-64bit-portable.zip"

rem -- Installationsverzeichnis anlegen
if exist "%INSTALLDIR%" (
echo Fehler: Installationsverzeichnis "%INSTALLDIR%" existiert bereits. Abbruch.
exit /b 1
)
md %INSTALLDIR%
cd %INSTALLDIR%

rem -- FHEM download and install
curl -o "fhem.zip" %FHEMURL%
tar -xf fhem.zip --strip-components=1
del fhem.zip

rem -- strawberryperl download and install
curl -L -o "perl.zip" %STRAWBERRYPERLURL%
tar -xf perl.zip
del perl.zip

rem -- Alle folgenden Abschnitte benötigen zwingend Admin-Rechte!

rem -- Firewall-Regeln anlegen
netsh advfirewall firewall add rule name="FHEM Perl interpreter TCP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=TCP
netsh advfirewall firewall add rule name="FHEM Perl interpreter UDP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=UDP

rem -- PATH Umgebungsvariable für strawberryperl (dauerhaft) erweitern statt portableshell.bat zu starten
powershell -NoProfile -ExecutionPolicy Bypass -Command ^
"$new = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"

rem -- FHEM-Dienst installieren und starten
set PATH=%PATH%;%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin
perl fhem.pl fhem.cfg -i
net start fhem

endlocal
</syntaxhighlight>

Nach erfolgreicher Ausführung des Skriptes kann FHEM direkt genutzt werden.

Das nachfolgende als Administrator auszuführende Skript "fhem_uninstall.bat" entfernt die Installation von FHEM und alle geänderten Einstellungen in Windows wieder. ACHTUNG: Datensicherung vorab nicht vergessen. Das Skript entfernt alles ohne Sicherheitsabfragen.

<syntaxhighlight lang="bat">
rem fhem_uninstall.bat

setlocal

rem -- Installationsverzeichnis
set "INSTALLDIR=C:\my-fhem"

rem -- FHEM Dienst stoppen und entfernen
perl fhem.pl -u
net stop fhem
sc delete fhem

rem -- Firewall-Regeln entfernen
netsh advfirewall firewall delete rule name="FHEM Perl interpreter TCP"
netsh advfirewall firewall delete rule name="FHEM Perl interpreter UDP"

rem -- PowerShell: PATH für aktuelle Session und machine-Umgebungsvariable zurücksetzen
powershell -NoProfile -ExecutionPolicy Bypass -Command ^
"$oldPaths = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = $machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' };" ^
"$filtered = $parts | Where-Object { $_ -notin $oldPaths.Split(';') };" ^
"$final = $filtered -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Process');" ^
"Write-Output 'PATH updated';"

rem -- FHEM/Perl-Verzeichnisse und Dateien löschen
rmdir /s /q %INSTALLDIR%

endlocal
</syntaxhighlight>

==Wie geht es weiter?==
[[Erste Schritte in FHEM]]

[[Kategorie:HOWTOS]]

Vorlage:FHEMWiki News

2025-12-28T12:18:03Z

Krikan: Hinweis auf neue Widgets-(Wiki-Seiten)

{|
{{News|28.12.2025|Neue [[FHEMWEB/Widgets|Widgets]]: [[FHEMWEB/ControlMiniDash]], [[FHEMWEB/iconAnimated]] und [[FHEMWEB/MiniChart]] }}
{{News|29.03.2025|FHEM Version 6.4 wurde freigegeben. {{Link2Forum|Topic=141252|LinkText=Ankündigung}}.}}
{{News|04.04.2024|Umstellung des FHEMWiki-Standardskin ("Style") von 'Vector alt (2010)' auf 'Vector (2022)' um eine bessere Benutzbarkeit auf mobilen Geräten bei nicht registrierten Benutzern zu erreichen. Registrierte Benutzer können unter Einstellungen/Aussehen den Skin selbst ändern. {{Link2Forum|Topic=137399}}}}
{{News|28.01.2024|FHEM Version 6.3 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=136851|LinkText=diesem Forenbeitrag}}.}}
{{News|14.08.2023|[[AutomowerConnect#Tablet-UI%3FFTUI_Version_3|FTUI3 AutomowerConnect]] Karte des Mähbereiches einbinden. }}
{{News|28.06.2023|[[AutomowerConnect#Tablet-UI%2FFTUI_Version_2|FTUI2 Widget 'automowerconnect']] für das Modul 74_AutomowerConnect.pm. }}
{{News|06.04.2023|FHEM Wiki ist auf einen neuen Server umgezogen und läuft jetzt auf aktueller Software. Es gibt neue Skins für Mobilgeräte Unterstützung. }}
{{News|25.01.2023|Neues Modul - [[AutomowerConnect|74_AutomowerConnect.pm]] zur Bedienung von Husqvarnas Mähroboter über Husqvarnas Open API {{Link2Forum|Topic=131661|LinkText=Forenbeitrag}}.}}
{{News|14.01.2023|FHEM Version 6.2 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=131618|LinkText=diesem Forenbeitrag}}.}}
{{News|08.11.2021|FHEM Version 6.1 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=123972|LinkText=diesem Forenbeitrag}}.}}
{{News|25.05.2021|Ein weiteres Modul zur Integration von Diensten der Synology Diskstation wird per Update verteilt: [[SSFile - Integration der Synology File Station|SSFile]].}}
{{News|28.02.2020|Das neue Modul [[SSCal - Integration des Synology Calendar Servers| SSCal]] ermöglicht die Integration des Synology Calendar Servers.}}
{{News|28.01.2020|Neues Modul für die IP-Türsprechanlage [[DoorBird]] per Update verteilt.}}}}
{{News|26.01.2020|FHEM Version 6.0 wurde freigegeben. Updatehinweise: {{Link2Forum|Topic=107782}}}}
{{News|17.12.2019|Mit dem Modul [[SSChatBot - Integration des Synology Chat Servers|SSChatBot]] kann der Synology Chat Server in FHEM integriert werden. Es können Mitteilungen zwischen FHEM und Chat ausgetauscht sowie Befehle in FHEM ausgeführt werden. }}
{{News|23.09.2019|Das Modul [[CanOverEthernet]] ermöglicht das Empfangen von Can-Over-Ethernet Paketen von Steuerungen der Firma Technische Alternative}}
{{News|05.04.2019|Das [[SamsungAV]] Modul ermöglicht die Steuerung von Samsung Fernsehern und Bluray-Playern.}}
{{News|06.03.2019|Mit dem Modul [[Arlo]] ist die Einbindung von Arlo Kameras über die Arlo Cloud möglich}}
{{News|26.01.2019|Das [[TRÅDFRI|tradfri]] Modul erweitert die Palette der [[ZigBee]] Module.}}
{{News|14.01.2019|Der [[FHEM Connector für Amazon Alexa|FHEM Connector]] Skill für Amazon Alexa ist verfügbar.}}
{{News|02.11.2018|Das Modul [[TA_CMI_UVR16x2_UVR1611|TA_CMI_JSON]] kann Werte des C.M.I. der Firma Technische Alternative auslesen und eignet sich so optimal zum Loggen von Daten zB der UVR16x2 oder UVR1611.}}
{{News|11.09.2018|Mit dem Modul [[AutoShuttersControl|AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters. }}
{{News|12.02.2018|Die Module [[Modul Babble|Babble]] und [[Talk2Fhem|Talk2Fhem]] erweitern die Sprachsteuerungsmöglichkeiten von FHEM}}
{{News|02.10.2017|[[FTUI eigene Widgets|Eigene Widgets für FHEM Tablet UI erstellen]]}}
{{News|30.08.2017|[[WINCONNECT]] - Windows PC steuern und Informationen abfragen/anzeigen. }}
{{News|24.08.2017|[[FHEMWEB/Widgets]] - Widgets (Frontendelemente) von FHEMWEB }}
{{News|24.08.2017|Neues Modul [[Modul_YAAHM|YAAHM]] wird per update verteilt. Es stellt eine Oberfläche bereit, um per Webinterface die zyklische Ausführung von Kommandos - mit Tages- und Wochenprofil - zu konfigurieren}}
{{News|24.07.2017|[[Telnet|Verbindung mit dem FHEM-Server per Telnet]]}}
{{News|20.07.2017|[[FHEM startet nicht - Tipps zur Fehlersuche]]}}
{{News|06.06.2017|[[‎Relaisplatine-Homebrew-MySensors|MySensors-Relaisplatine im Selbstbau]]}}
{{News|31.05.2017|[[Datenbankgestützte_Erstellung_der_Energiebilanz_einer_SMA_PV-Anlage_mit_Überschußeinspeisung|Datenbankgestützte Erstellung der Energiebilanz einer PV-Anlage mit Überschußeinspeisung]]}}
{{News|30.04.2017|[[DoorPiBoard]]: Eine Platine zur Umsetzung des [[DoorPi_und FHEM|DoorPi-Projektes]]}}
{{News|21.03.2017|Artikel zum alternativen Frontend [[:Kategorie:FHEM_Tablet_UI|Tablet UI]] aktualisiert und deutlich erweitert}}
{{News|02.03.2017|Neues Modul zur Ansteuerung von [[LGTV_WebOS|LG-TVs mit dem Betriebssystem WebOS]] wird per update verteilt}}
{{News|20.02.2017|Neues Modul [[SIP-Client|SIP]], ein SIP-Client für FHEM, wird per update verteilt}}
{{News|19.02.2017|FHEM Version 5.8 wurde freigegeben. Updatehinweise beachten: {{Link2Forum|Topic=67419}}}}
{{News|18.01.2017|Neues Modul [[DOIFtools]] mit Funktionen zur Unterstützung des Benutzers im Umgang mit [[DOIF]] wird per update verteilt}}
{{News|12.01.2017|Neues Modul zur Ansteuerung des Bluetooth 4.1 BLE Pflanzensensors [[XiaomiFlowerSens|Xiaomi Flower Care Smart Monitor]] wird per update ausgeliefert}}
{{News|01.01.2017|Diverse neue Wiki-Artikel mit Informationen und Hilfen zu [[DOIF#Links|DOIF]] }}
{{News|10.12.2016|FHEM Wiki ist auf einen neuen Server umgezogen und hat eine neue Standard-Internetadresse: https://wiki.fhem.de}}
{{News|21.11.2016|Neues Modul [[Modul_PostMe|PostMe]] stellt eine komfortable Oberfläche zur Listenverwaltung bereit}}
{{News|11.10.2016|Neue Module [[NUKI|NUKIbridge und NUKIDevice]] zur Ansteuerung des Nuki Smartlock werden per update verteilt}}
{{News|07.10.2016|Neues Modul [[TRAFFIC]] zur Erfassung der Fahrzeiten bei aktueller Verkehrslage mittels Google Maps Directions API wird per update verteilt}}
{{News|19.07.2016|Neues Modul zur Unterstützung der HomeMatic-Interfaces [[HM-MOD-RPI-PCB_HomeMatic_Funkmodul_für_Raspberry_Pi|Funkmodul für Raspberry Pi]] und [[HM-LGW-O-TW-W-EU_Funk-LAN_Gateway|Funk-LAN Gateway]] wird per update verteilt }}
{{News|12.07.2016|Neues Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten]] wird per update verteilt }}
{{News|08.02.2016|Neues Modul [[Mediaportal|MEDIAPORTAL]] (Steuerung einer Mediaportal-Installation über Wifiremote) wird per update verteilt}}
{{News|16.11.2015|Neues Modul [[HP1000]] (Einbindung einer HP1000 Wetterstation) wird per update verteilt}}
{{News|16.11.2015|Neuer FHEM Befehl [[msg]] (Intelligentes Versenden/Routing von Nachrichten der Typen Audio,Text,Mail,Push,Light,Screen) wird per update verteilt}}
{{News|15.11.2015|FHEM Version 5.7 wurde veröffentlicht. Unbedingt Updatehinweise beachten: {{Link2Forum|Topic=44094}}}}
{{News|30.10.2015|FHEM Wiki unterstützt nun [[Syntax Highlighting]]}}
{{News|18.10.2015|Neues Modul [[TechemHKV]] (Empfang von Daten eines Techem Heizkostenverteilers) wird per update verteilt}}
{{News|02.10.2015|Kleiner FHEM-Einsteiger-Kurs als Wiki Artikel unter [[Erste_Schritte_in_fhem|Erste Schritte in FHEM]]}}
{{News|24.09.2015|Umfangreiche Überarbeitung der Wiki Artikel über [[:Kategorie:panStamp|panStamp Hardware und Software]]}}
{{News|11.09.2015|Neues Modul [[AMAD]] (Steuern und Informationsanzeige von Android-Geräten) wird per update verteilt}}
{{News|15.06.2015|Neues Modul [[yowsup]] (WhatsApp Unterstützung) wird per update verteilt}}
{{News|03.04.2015|Neues Geräte-Modul [[JawboneUp]] wird per update verteilt}}
{{News|23.03.2015|Neue Geräte-Module [[Modbus]], [[ModbusAttr]] und [[Modbus#Writing_modules_for_devices_using_this_module_as_a_library|ModbusSET]] werden per update verteilt}}
{{News|10.02.2015|FHEM Wiki ist auf einen neuen Server umgezogen und [[FHEMWiki:Interna#Offene_Probleme|Aktualisierung der MediaWiki-Software]]}}
{{News|31.01.2015|Neues Geräte-Modul [[Pushbullet]] wird per update verteilt}}
{{News|14.01.2015|Neues Hilfs-Modul [[CALVIEW]] wird per update verteilt}}
{{News|08.01.2015|Neues Geräte-Modul [[Buderus_Web_Gateway|km200]] zur Anbindung eines Buderus Web-Gateways wird per update verteilt}}
{{News|18.12.2014|Neues Geräte-Modul [[SONOS]] wird per update verteilt}}
{{News|15.12.2014|Überarbeitetes und erweitertes Geräte-Modul [[HTTPMOD]] wird per update verteilt}}
{{News|10.12.2014|Neues Geräte-Modul [[Vitotronic_200_(Viessmann_Heizungssteuerung)|VCONTROL]] zur Anbindung einer Viessmann Heizung wird per update verteilt}}
{{News|17.11.2014|Neues Hilfs-Modul [[logProxy]] wird per update verteilt}}
{{News|09.11.2014|FHEM Version 5.6 wurde veröffentlicht}}
{{News|27.10.2014|Neues Geräte-Modul [[harmony]] zur FHEM-Anbindung Logitech Harmony Hub basierter Fernbedienungen wird per update verteilt}}
{{News|25.10.2014|Neues Geräte-Modul [[KostalPiko|KOSTALPIKO]] wird per update verteilt}}
{{News|24.10.2014|Neues Hilfs-Modul [[HourCounter]] wird per update verteilt}}
{{News|06.09.2014|Neues Hilfs-Modul [[CustomReadings]] per update verteilt}}
{{News|19.08.2014|Neues Hilfs-Modul [[DOIF]] wird per update verteilt}}
{{News|19.08.2014|Der Befehl [[update]] wurde überarbeitet: {{Link2Forum|Topic=26311}} }}
{{News|13.08.2014|Zusätzliche Domäne fhem.org aktiviert: {{Link2Forum|Topic=26113}} }}
{{News|29.09.2013|FHEM Version 5.5 wurde veröffentlicht}}
{{News|11.05.2013|Die meisten Daten aus dem FhemWiki sind wieder hergestellt.}}
{{News|04.05.2013|FHEM Wiki wird neu aufgebaut.}}
{{News|04.05.2013|FHEM Wiki Update zu [[Special:Version|MediaWiki 1.20.5]].}}
|}
<noinclude>[[Kategorie:Vorlage]]</noinclude>

Vorlage:FHEMWiki News

2025-12-28T12:06:58Z

Krikan: FHEM 6.4 Ankündigung

{|
{{News|29.03.2025|FHEM Version 6.4 wurde freigegeben. {{Link2Forum|Topic=141252|LinkText=Ankündigung}}.}}
{{News|04.04.2024|Umstellung des FHEMWiki-Standardskin ("Style") von 'Vector alt (2010)' auf 'Vector (2022)' um eine bessere Benutzbarkeit auf mobilen Geräten bei nicht registrierten Benutzern zu erreichen. Registrierte Benutzer können unter Einstellungen/Aussehen den Skin selbst ändern. {{Link2Forum|Topic=137399}}}}
{{News|28.01.2024|FHEM Version 6.3 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=136851|LinkText=diesem Forenbeitrag}}.}}
{{News|14.08.2023|[[AutomowerConnect#Tablet-UI%3FFTUI_Version_3|FTUI3 AutomowerConnect]] Karte des Mähbereiches einbinden. }}
{{News|28.06.2023|[[AutomowerConnect#Tablet-UI%2FFTUI_Version_2|FTUI2 Widget 'automowerconnect']] für das Modul 74_AutomowerConnect.pm. }}
{{News|06.04.2023|FHEM Wiki ist auf einen neuen Server umgezogen und läuft jetzt auf aktueller Software. Es gibt neue Skins für Mobilgeräte Unterstützung. }}
{{News|25.01.2023|Neues Modul - [[AutomowerConnect|74_AutomowerConnect.pm]] zur Bedienung von Husqvarnas Mähroboter über Husqvarnas Open API {{Link2Forum|Topic=131661|LinkText=Forenbeitrag}}.}}
{{News|14.01.2023|FHEM Version 6.2 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=131618|LinkText=diesem Forenbeitrag}}.}}
{{News|08.11.2021|FHEM Version 6.1 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=123972|LinkText=diesem Forenbeitrag}}.}}
{{News|25.05.2021|Ein weiteres Modul zur Integration von Diensten der Synology Diskstation wird per Update verteilt: [[SSFile - Integration der Synology File Station|SSFile]].}}
{{News|28.02.2020|Das neue Modul [[SSCal - Integration des Synology Calendar Servers| SSCal]] ermöglicht die Integration des Synology Calendar Servers.}}
{{News|28.01.2020|Neues Modul für die IP-Türsprechanlage [[DoorBird]] per Update verteilt.}}}}
{{News|26.01.2020|FHEM Version 6.0 wurde freigegeben. Updatehinweise: {{Link2Forum|Topic=107782}}}}
{{News|17.12.2019|Mit dem Modul [[SSChatBot - Integration des Synology Chat Servers|SSChatBot]] kann der Synology Chat Server in FHEM integriert werden. Es können Mitteilungen zwischen FHEM und Chat ausgetauscht sowie Befehle in FHEM ausgeführt werden. }}
{{News|23.09.2019|Das Modul [[CanOverEthernet]] ermöglicht das Empfangen von Can-Over-Ethernet Paketen von Steuerungen der Firma Technische Alternative}}
{{News|05.04.2019|Das [[SamsungAV]] Modul ermöglicht die Steuerung von Samsung Fernsehern und Bluray-Playern.}}
{{News|06.03.2019|Mit dem Modul [[Arlo]] ist die Einbindung von Arlo Kameras über die Arlo Cloud möglich}}
{{News|26.01.2019|Das [[TRÅDFRI|tradfri]] Modul erweitert die Palette der [[ZigBee]] Module.}}
{{News|14.01.2019|Der [[FHEM Connector für Amazon Alexa|FHEM Connector]] Skill für Amazon Alexa ist verfügbar.}}
{{News|02.11.2018|Das Modul [[TA_CMI_UVR16x2_UVR1611|TA_CMI_JSON]] kann Werte des C.M.I. der Firma Technische Alternative auslesen und eignet sich so optimal zum Loggen von Daten zB der UVR16x2 oder UVR1611.}}
{{News|11.09.2018|Mit dem Modul [[AutoShuttersControl|AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters. }}
{{News|12.02.2018|Die Module [[Modul Babble|Babble]] und [[Talk2Fhem|Talk2Fhem]] erweitern die Sprachsteuerungsmöglichkeiten von FHEM}}
{{News|02.10.2017|[[FTUI eigene Widgets|Eigene Widgets für FHEM Tablet UI erstellen]]}}
{{News|30.08.2017|[[WINCONNECT]] - Windows PC steuern und Informationen abfragen/anzeigen. }}
{{News|24.08.2017|[[FHEMWEB/Widgets]] - Widgets (Frontendelemente) von FHEMWEB }}
{{News|24.08.2017|Neues Modul [[Modul_YAAHM|YAAHM]] wird per update verteilt. Es stellt eine Oberfläche bereit, um per Webinterface die zyklische Ausführung von Kommandos - mit Tages- und Wochenprofil - zu konfigurieren}}
{{News|24.07.2017|[[Telnet|Verbindung mit dem FHEM-Server per Telnet]]}}
{{News|20.07.2017|[[FHEM startet nicht - Tipps zur Fehlersuche]]}}
{{News|06.06.2017|[[‎Relaisplatine-Homebrew-MySensors|MySensors-Relaisplatine im Selbstbau]]}}
{{News|31.05.2017|[[Datenbankgestützte_Erstellung_der_Energiebilanz_einer_SMA_PV-Anlage_mit_Überschußeinspeisung|Datenbankgestützte Erstellung der Energiebilanz einer PV-Anlage mit Überschußeinspeisung]]}}
{{News|30.04.2017|[[DoorPiBoard]]: Eine Platine zur Umsetzung des [[DoorPi_und FHEM|DoorPi-Projektes]]}}
{{News|21.03.2017|Artikel zum alternativen Frontend [[:Kategorie:FHEM_Tablet_UI|Tablet UI]] aktualisiert und deutlich erweitert}}
{{News|02.03.2017|Neues Modul zur Ansteuerung von [[LGTV_WebOS|LG-TVs mit dem Betriebssystem WebOS]] wird per update verteilt}}
{{News|20.02.2017|Neues Modul [[SIP-Client|SIP]], ein SIP-Client für FHEM, wird per update verteilt}}
{{News|19.02.2017|FHEM Version 5.8 wurde freigegeben. Updatehinweise beachten: {{Link2Forum|Topic=67419}}}}
{{News|18.01.2017|Neues Modul [[DOIFtools]] mit Funktionen zur Unterstützung des Benutzers im Umgang mit [[DOIF]] wird per update verteilt}}
{{News|12.01.2017|Neues Modul zur Ansteuerung des Bluetooth 4.1 BLE Pflanzensensors [[XiaomiFlowerSens|Xiaomi Flower Care Smart Monitor]] wird per update ausgeliefert}}
{{News|01.01.2017|Diverse neue Wiki-Artikel mit Informationen und Hilfen zu [[DOIF#Links|DOIF]] }}
{{News|10.12.2016|FHEM Wiki ist auf einen neuen Server umgezogen und hat eine neue Standard-Internetadresse: https://wiki.fhem.de}}
{{News|21.11.2016|Neues Modul [[Modul_PostMe|PostMe]] stellt eine komfortable Oberfläche zur Listenverwaltung bereit}}
{{News|11.10.2016|Neue Module [[NUKI|NUKIbridge und NUKIDevice]] zur Ansteuerung des Nuki Smartlock werden per update verteilt}}
{{News|07.10.2016|Neues Modul [[TRAFFIC]] zur Erfassung der Fahrzeiten bei aktueller Verkehrslage mittels Google Maps Directions API wird per update verteilt}}
{{News|19.07.2016|Neues Modul zur Unterstützung der HomeMatic-Interfaces [[HM-MOD-RPI-PCB_HomeMatic_Funkmodul_für_Raspberry_Pi|Funkmodul für Raspberry Pi]] und [[HM-LGW-O-TW-W-EU_Funk-LAN_Gateway|Funk-LAN Gateway]] wird per update verteilt }}
{{News|12.07.2016|Neues Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten]] wird per update verteilt }}
{{News|08.02.2016|Neues Modul [[Mediaportal|MEDIAPORTAL]] (Steuerung einer Mediaportal-Installation über Wifiremote) wird per update verteilt}}
{{News|16.11.2015|Neues Modul [[HP1000]] (Einbindung einer HP1000 Wetterstation) wird per update verteilt}}
{{News|16.11.2015|Neuer FHEM Befehl [[msg]] (Intelligentes Versenden/Routing von Nachrichten der Typen Audio,Text,Mail,Push,Light,Screen) wird per update verteilt}}
{{News|15.11.2015|FHEM Version 5.7 wurde veröffentlicht. Unbedingt Updatehinweise beachten: {{Link2Forum|Topic=44094}}}}
{{News|30.10.2015|FHEM Wiki unterstützt nun [[Syntax Highlighting]]}}
{{News|18.10.2015|Neues Modul [[TechemHKV]] (Empfang von Daten eines Techem Heizkostenverteilers) wird per update verteilt}}
{{News|02.10.2015|Kleiner FHEM-Einsteiger-Kurs als Wiki Artikel unter [[Erste_Schritte_in_fhem|Erste Schritte in FHEM]]}}
{{News|24.09.2015|Umfangreiche Überarbeitung der Wiki Artikel über [[:Kategorie:panStamp|panStamp Hardware und Software]]}}
{{News|11.09.2015|Neues Modul [[AMAD]] (Steuern und Informationsanzeige von Android-Geräten) wird per update verteilt}}
{{News|15.06.2015|Neues Modul [[yowsup]] (WhatsApp Unterstützung) wird per update verteilt}}
{{News|03.04.2015|Neues Geräte-Modul [[JawboneUp]] wird per update verteilt}}
{{News|23.03.2015|Neue Geräte-Module [[Modbus]], [[ModbusAttr]] und [[Modbus#Writing_modules_for_devices_using_this_module_as_a_library|ModbusSET]] werden per update verteilt}}
{{News|10.02.2015|FHEM Wiki ist auf einen neuen Server umgezogen und [[FHEMWiki:Interna#Offene_Probleme|Aktualisierung der MediaWiki-Software]]}}
{{News|31.01.2015|Neues Geräte-Modul [[Pushbullet]] wird per update verteilt}}
{{News|14.01.2015|Neues Hilfs-Modul [[CALVIEW]] wird per update verteilt}}
{{News|08.01.2015|Neues Geräte-Modul [[Buderus_Web_Gateway|km200]] zur Anbindung eines Buderus Web-Gateways wird per update verteilt}}
{{News|18.12.2014|Neues Geräte-Modul [[SONOS]] wird per update verteilt}}
{{News|15.12.2014|Überarbeitetes und erweitertes Geräte-Modul [[HTTPMOD]] wird per update verteilt}}
{{News|10.12.2014|Neues Geräte-Modul [[Vitotronic_200_(Viessmann_Heizungssteuerung)|VCONTROL]] zur Anbindung einer Viessmann Heizung wird per update verteilt}}
{{News|17.11.2014|Neues Hilfs-Modul [[logProxy]] wird per update verteilt}}
{{News|09.11.2014|FHEM Version 5.6 wurde veröffentlicht}}
{{News|27.10.2014|Neues Geräte-Modul [[harmony]] zur FHEM-Anbindung Logitech Harmony Hub basierter Fernbedienungen wird per update verteilt}}
{{News|25.10.2014|Neues Geräte-Modul [[KostalPiko|KOSTALPIKO]] wird per update verteilt}}
{{News|24.10.2014|Neues Hilfs-Modul [[HourCounter]] wird per update verteilt}}
{{News|06.09.2014|Neues Hilfs-Modul [[CustomReadings]] per update verteilt}}
{{News|19.08.2014|Neues Hilfs-Modul [[DOIF]] wird per update verteilt}}
{{News|19.08.2014|Der Befehl [[update]] wurde überarbeitet: {{Link2Forum|Topic=26311}} }}
{{News|13.08.2014|Zusätzliche Domäne fhem.org aktiviert: {{Link2Forum|Topic=26113}} }}
{{News|29.09.2013|FHEM Version 5.5 wurde veröffentlicht}}
{{News|11.05.2013|Die meisten Daten aus dem FhemWiki sind wieder hergestellt.}}
{{News|04.05.2013|FHEM Wiki wird neu aufgebaut.}}
{{News|04.05.2013|FHEM Wiki Update zu [[Special:Version|MediaWiki 1.20.5]].}}
|}
<noinclude>[[Kategorie:Vorlage]]</noinclude>

FHEM Installation Windows

2025-12-28T11:48:04Z

Krikan: /* Installation per Skript */

{{Baustelle}}
'''{{PAGENAME}}''' beschreibt die Installation von FHEM als portable Software für Windows (keine Eingriffe in die Registrierungsdatenbank). Die Anleitung ist sowohl für die Installation auf einem Wechseldatenträger, zum Beispiel einem USB-Stick, als auch auf einem internen Laufwerk anwendbar. Nach der Grundinstallation ist FHEM zum Ausprobieren, Experimentieren und/oder den portablen Einsatz eingerichtet. Bei Installation auf einem internen Laufwerk ist die abschließend dargestellte Einrichtung von FHEM als Dienst und damit der dauerhafte Betrieb als Hausautomations-Server unter Windows möglich.
==Manuelle Installation==
===Grundinstallation===
====Installation FHEM====
Das aktuelle [https://fhem.de/#Download fhem-X.Y.zip Paket] (momentan fhem-6.4.zip) herunterladen.

Einen neuen Ordner für FHEM anlegen. Für diesen Artikel wurde der Ordner <code>f:\my-fhem</code> angelegt.

Den gesamten Inhalt des Ordners <code>fhem-6.4\fhem-6.4</code> aus dem .zip-Paket nach <code>f:\my-fhem</code> entpacken.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> befindet sich anschließend unter anderem die Datei <code>fhem.pl</code>.

====Installation Perl====
Eine aktuelle [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] herunterladen und im Ordner von FHEM entpacken.

Hier wurde der Inhalt des Pakets "strawberry-perl-5.42.0.1-64bit-portable.zip" nach <code>f:\my-fhem</code> entpackt.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> existiert anschließend unter anderem ein zusätzlicher Ordner <code>perl</code>.

====Start von FHEM====
Eine Eingabeaufforderung (cmd) in Windows öffnen, in den zuvor angelegten Ordner wechseln, portableshell.bat aufrufen und anschließend FHEM starten:

<syntaxhighlight lang="doscon">
C:\> cd f:\my-fhem
F:\my-fhem> portableshell.bat
F:\my-fhem> perl fhem.pl fhem.cfg
</syntaxhighlight>

Jetzt erscheint ein Windows-Sicherheitshinweis, dass die Windows-Firewall den Perl Interpreter blockiert. Für den Zugriff auf FHEM muss eine Firewall-Ausnahme eingerichtet werden. Hierzu ist der Sicherheitshinweis mit dem Button {{Taste|Zugriff zulassen}} zu beenden.

''Hinweis:'' In der Eingabeaufforderung erscheint keine Rückmeldung und das Programm beendet sich nicht. Die Eingabeaufforderung darf nicht geschlossen werden, so lange FHEM läuft.

====Aufruf des FHEM-Webinterfaces (FHEMWEB)====
Einen Browser öffnen (Firefox, Chrome und Safari werden empfohlen) und FHEM unter folgender Adresse aufrufen:

<code>http://localhost:8083/fhem</code>

Es öffnet sich die FHEM-Hauptseite:

[[Datei:ErsteSchritteInFhem01.png]]

====Update von FHEM====
FHEM wird kontinuierlich weiterentwickelt. Daher sollte direkt ein Update auf den aktuellen Entwicklungsstand durchgeführt werden.

Im Befehls-Eingabefeld von FHEM, das ist das weiße, rechteckige Texteingabefeld rechts neben dem FHEM-Logo, den Befehl

<code>update</code>

eingeben und mit {{Taste|Enter}} abschließen.

Es beginnt der Update-Prozeß, der eine Weile dauern kann. Den Fortschritt zeigt FHEM an. Am Ende des Update-Prozesses fordert FHEM zu einem "shutdown restart" auf. Dies bitte ignorieren und im Befehls-Eingabefeld nur

<code>shutdown</code>

gefolgt von {{Taste|Enter}} zum Beenden von FHEM eingeben.

Nun wieder zum Fenster der Eingabeaufforderung wechseln. Das aktualisierte FHEM erneut starten; beispielsweise durch {{Taste|Pfeil hoch}} gefolgt von {{Taste|Enter}} oder erneute Eingabe von

<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg</syntaxhighlight>

Hiermit ist die Installation von FHEM bereits grundlegend abgeschlossen und [[Erste Schritte in FHEM]] lädt zum Ausprobieren ein.

===Installations-Optionen===
====Installation von FHEM als Dienst====
''Hinweis:'' Die Einrichtung von FHEM als Dienst erfordert einen automatisch im folgenden Installationsprozeß erstellten Eintrag in der Registrierungsdatenbank.

FHEM durch Eingabe von <code>shutdown</code> im Befehls-Eingabefeld beenden.

Eine Eingabeaufforderung als Administrator öffnen und die PATH Umgebungsvariable für Perl erweitern, FHEM als Dienst installieren sowie den Dienst starten:
<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> powershell -NoProfile -Command ^
"$new = 'F:\my-fhem\perl\site\bin;F:\my-fhem\perl\bin;F:\my-fhem\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"
F:\my-fhem> perl fhem.pl fhem.cfg -i
F:\my-fhem> net start fhem
</syntaxhighlight>

Im Windows-Verwaltungswerkzeug "Dienste" wird der FHEM-Dienst nach erfolgreicher Einrichtung mit dem Namen "fhem server" aufgeführt. FHEM startet nach Installation als Dienst beim Windows-Start unsichtbar (ohne offene Eingabeaufforderung) im Hintergrund.

Anders als beim Start von FHEM über die Eingabeaufforderung kann bei FHEM als Dienst nach einem <code>update</code> der Befehl <code>shutdown restart</code> erfolgreich ausgeführt werden.

==Installation per Skript==
Folgendes Skript "fhem_install.bat" installiert FHEM mit allen Installationsoptionen (PATH-Erweiterung, Dienstinstallation) auf dem internen Laufwerk C. Das Skript muss mit Administratorrechten ausgeführt werden.

<syntaxhighlight lang="bat">
rem fhem_install.bat

setlocal

rem -- Installationsverzeichnis (sollte keine Leer- oder Sonderzeichen enthalten und nicht zu lang sein) und Download-URLs festlegen
set "INSTALLDIR=C:\my-fhem"
set "FHEMURL=https://fhem.de/fhem-6.4.zip"
set "STRAWBERRYPERLURL=https://github.com/StrawberryPerl/Perl-Dist-Strawberry/releases/download/SP_54201_64bit/strawberry-perl-5.42.0.1-64bit-portable.zip"

rem -- Installationsverzeichnis anlegen
if exist "%INSTALLDIR%" (
echo Fehler: Installationsverzeichnis "%INSTALLDIR%" existiert bereits. Abbruch.
exit /b 1
)
md %INSTALLDIR%
cd %INSTALLDIR%

rem -- FHEM download and install
curl -o "fhem.zip" %FHEMURL%
tar -xf fhem.zip --strip-components=1
del fhem.zip

rem -- strawberryperl download and install
curl -L -o "perl.zip" %STRAWBERRYPERLURL%
tar -xf perl.zip
del perl.zip

rem -- Alle folgenden Abschnitte benötigen zwingend Admin-Rechte!

rem -- Firewall-Regeln anlegen
netsh advfirewall firewall add rule name="FHEM Perl interpreter TCP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=TCP
netsh advfirewall firewall add rule name="FHEM Perl interpreter UDP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=UDP

rem -- PATH Umgebungsvariable für strawberryperl (dauerhaft) erweitern statt portableshell.bat zu starten
powershell -NoProfile -Command ^
"$new = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"

rem -- FHEM-Dienst installieren und starten
set PATH=%PATH%;%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin
perl fhem.pl fhem.cfg -i
net start fhem

endlocal
</syntaxhighlight>

Nach erfolgreicher Ausführung des Skriptes kann FHEM direkt genutzt werden.

Das nachfolgende als Administrator auszuführende Skript "fhem_uninstall.bat" entfernt die Installation von FHEM und alle geänderten Einstellungen in Windows wieder. ACHTUNG: Datensicherung vorab nicht vergessen. Das Skript entfernt alles ohne Sicherheitsabfragen.

<syntaxhighlight lang="bat">
rem fhem_uninstall.bat

setlocal

rem -- Installationsverzeichnis
set "INSTALLDIR=C:\my-fhem"

rem -- FHEM Dienst stoppen und entfernen
perl fhem.pl -u
net stop fhem
sc delete fhem

rem -- Firewall-Regeln entfernen
netsh advfirewall firewall delete rule name="FHEM Perl interpreter TCP"
netsh advfirewall firewall delete rule name="FHEM Perl interpreter UDP"

rem -- PowerShell: PATH für aktuelle Session und machine-Umgebungsvariable zurücksetzen
powershell -NoProfile -Command ^
"$oldPaths = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = $machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' };" ^
"$filtered = $parts | Where-Object { $_ -notin $oldPaths.Split(';') };" ^
"$final = $filtered -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Process');" ^
"Write-Output 'PATH updated';"

rem -- FHEM/Perl-Verzeichnisse und Dateien löschen
rmdir /s /q %INSTALLDIR%

endlocal
</syntaxhighlight>

==Wie geht es weiter?==
[[Erste Schritte in FHEM]]

[[Kategorie:HOWTOS]]

FHEM Installation Windows

2025-12-28T11:47:31Z

Krikan: /* Installation per Skript */

{{Baustelle}}
'''{{PAGENAME}}''' beschreibt die Installation von FHEM als portable Software für Windows (keine Eingriffe in die Registrierungsdatenbank). Die Anleitung ist sowohl für die Installation auf einem Wechseldatenträger, zum Beispiel einem USB-Stick, als auch auf einem internen Laufwerk anwendbar. Nach der Grundinstallation ist FHEM zum Ausprobieren, Experimentieren und/oder den portablen Einsatz eingerichtet. Bei Installation auf einem internen Laufwerk ist die abschließend dargestellte Einrichtung von FHEM als Dienst und damit der dauerhafte Betrieb als Hausautomations-Server unter Windows möglich.
==Manuelle Installation==
===Grundinstallation===
====Installation FHEM====
Das aktuelle [https://fhem.de/#Download fhem-X.Y.zip Paket] (momentan fhem-6.4.zip) herunterladen.

Einen neuen Ordner für FHEM anlegen. Für diesen Artikel wurde der Ordner <code>f:\my-fhem</code> angelegt.

Den gesamten Inhalt des Ordners <code>fhem-6.4\fhem-6.4</code> aus dem .zip-Paket nach <code>f:\my-fhem</code> entpacken.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> befindet sich anschließend unter anderem die Datei <code>fhem.pl</code>.

====Installation Perl====
Eine aktuelle [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] herunterladen und im Ordner von FHEM entpacken.

Hier wurde der Inhalt des Pakets "strawberry-perl-5.42.0.1-64bit-portable.zip" nach <code>f:\my-fhem</code> entpackt.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> existiert anschließend unter anderem ein zusätzlicher Ordner <code>perl</code>.

====Start von FHEM====
Eine Eingabeaufforderung (cmd) in Windows öffnen, in den zuvor angelegten Ordner wechseln, portableshell.bat aufrufen und anschließend FHEM starten:

<syntaxhighlight lang="doscon">
C:\> cd f:\my-fhem
F:\my-fhem> portableshell.bat
F:\my-fhem> perl fhem.pl fhem.cfg
</syntaxhighlight>

Jetzt erscheint ein Windows-Sicherheitshinweis, dass die Windows-Firewall den Perl Interpreter blockiert. Für den Zugriff auf FHEM muss eine Firewall-Ausnahme eingerichtet werden. Hierzu ist der Sicherheitshinweis mit dem Button {{Taste|Zugriff zulassen}} zu beenden.

''Hinweis:'' In der Eingabeaufforderung erscheint keine Rückmeldung und das Programm beendet sich nicht. Die Eingabeaufforderung darf nicht geschlossen werden, so lange FHEM läuft.

====Aufruf des FHEM-Webinterfaces (FHEMWEB)====
Einen Browser öffnen (Firefox, Chrome und Safari werden empfohlen) und FHEM unter folgender Adresse aufrufen:

<code>http://localhost:8083/fhem</code>

Es öffnet sich die FHEM-Hauptseite:

[[Datei:ErsteSchritteInFhem01.png]]

====Update von FHEM====
FHEM wird kontinuierlich weiterentwickelt. Daher sollte direkt ein Update auf den aktuellen Entwicklungsstand durchgeführt werden.

Im Befehls-Eingabefeld von FHEM, das ist das weiße, rechteckige Texteingabefeld rechts neben dem FHEM-Logo, den Befehl

<code>update</code>

eingeben und mit {{Taste|Enter}} abschließen.

Es beginnt der Update-Prozeß, der eine Weile dauern kann. Den Fortschritt zeigt FHEM an. Am Ende des Update-Prozesses fordert FHEM zu einem "shutdown restart" auf. Dies bitte ignorieren und im Befehls-Eingabefeld nur

<code>shutdown</code>

gefolgt von {{Taste|Enter}} zum Beenden von FHEM eingeben.

Nun wieder zum Fenster der Eingabeaufforderung wechseln. Das aktualisierte FHEM erneut starten; beispielsweise durch {{Taste|Pfeil hoch}} gefolgt von {{Taste|Enter}} oder erneute Eingabe von

<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg</syntaxhighlight>

Hiermit ist die Installation von FHEM bereits grundlegend abgeschlossen und [[Erste Schritte in FHEM]] lädt zum Ausprobieren ein.

===Installations-Optionen===
====Installation von FHEM als Dienst====
''Hinweis:'' Die Einrichtung von FHEM als Dienst erfordert einen automatisch im folgenden Installationsprozeß erstellten Eintrag in der Registrierungsdatenbank.

FHEM durch Eingabe von <code>shutdown</code> im Befehls-Eingabefeld beenden.

Eine Eingabeaufforderung als Administrator öffnen und die PATH Umgebungsvariable für Perl erweitern, FHEM als Dienst installieren sowie den Dienst starten:
<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> powershell -NoProfile -Command ^
"$new = 'F:\my-fhem\perl\site\bin;F:\my-fhem\perl\bin;F:\my-fhem\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"
F:\my-fhem> perl fhem.pl fhem.cfg -i
F:\my-fhem> net start fhem
</syntaxhighlight>

Im Windows-Verwaltungswerkzeug "Dienste" wird der FHEM-Dienst nach erfolgreicher Einrichtung mit dem Namen "fhem server" aufgeführt. FHEM startet nach Installation als Dienst beim Windows-Start unsichtbar (ohne offene Eingabeaufforderung) im Hintergrund.

Anders als beim Start von FHEM über die Eingabeaufforderung kann bei FHEM als Dienst nach einem <code>update</code> der Befehl <code>shutdown restart</code> erfolgreich ausgeführt werden.

==Installation per Skript==
Folgendes Skript "fhem_install.bat" installiert FHEM mit allen Installationsoptionen (PATH-Erweiterung, Dienstinstallation) auf dem internen Laufwerk C. Das Skript muss mit Administratorrechten ausgeführt werden.

<syntaxhighlight lang="bat">
rem fhem_install.bat
setlocal

rem -- Installationsverzeichnis (sollte keine Leer- oder Sonderzeichen enthalten und nicht zu lang sein) und Download-URLs festlegen
set "INSTALLDIR=C:\my-fhem"
set "FHEMURL=https://fhem.de/fhem-6.4.zip"
set "STRAWBERRYPERLURL=https://github.com/StrawberryPerl/Perl-Dist-Strawberry/releases/download/SP_54201_64bit/strawberry-perl-5.42.0.1-64bit-portable.zip"

rem -- Installationsverzeichnis anlegen
if exist "%INSTALLDIR%" (
echo Fehler: Installationsverzeichnis "%INSTALLDIR%" existiert bereits. Abbruch.
exit /b 1
)
md %INSTALLDIR%
cd %INSTALLDIR%

rem -- FHEM download and install
curl -o "fhem.zip" %FHEMURL%
tar -xf fhem.zip --strip-components=1
del fhem.zip

rem -- strawberryperl download and install
curl -L -o "perl.zip" %STRAWBERRYPERLURL%
tar -xf perl.zip
del perl.zip

rem -- Alle folgenden Abschnitte benötigen zwingend Admin-Rechte!

rem -- Firewall-Regeln anlegen
netsh advfirewall firewall add rule name="FHEM Perl interpreter TCP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=TCP
netsh advfirewall firewall add rule name="FHEM Perl interpreter UDP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=UDP

rem -- PATH Umgebungsvariable für strawberryperl (dauerhaft) erweitern statt portableshell.bat zu starten
powershell -NoProfile -Command ^
"$new = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"

rem -- FHEM-Dienst installieren und starten
set PATH=%PATH%;%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin
perl fhem.pl fhem.cfg -i
net start fhem

endlocal
</syntaxhighlight>

Nach erfolgreicher Ausführung des Skriptes kann FHEM direkt genutzt werden.

Das nachfolgende als Administrator auszuführende Skript "fhem_uninstall.bat" entfernt die Installation von FHEM und alle geänderten Einstellungen in Windows wieder. ACHTUNG: Datensicherung vorab nicht vergessen. Das Skript entfernt alles ohne Sicherheitsabfragen.

<syntaxhighlight lang="bat">
rem fhem_uninstall.bat

setlocal

rem -- Installationsverzeichnis
set "INSTALLDIR=C:\my-fhem"

rem -- FHEM Dienst stoppen und entfernen
perl fhem.pl -u
net stop fhem
sc delete fhem

rem -- Firewall-Regeln entfernen
netsh advfirewall firewall delete rule name="FHEM Perl interpreter TCP"
netsh advfirewall firewall delete rule name="FHEM Perl interpreter UDP"

rem -- PowerShell: PATH für aktuelle Session und machine-Umgebungsvariable zurücksetzen
powershell -NoProfile -Command ^
"$oldPaths = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = $machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' };" ^
"$filtered = $parts | Where-Object { $_ -notin $oldPaths.Split(';') };" ^
"$final = $filtered -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Process');" ^
"Write-Output 'PATH updated';"

rem -- FHEM/Perl-Verzeichnisse und Dateien löschen
rmdir /s /q %INSTALLDIR%

endlocal
</syntaxhighlight>

==Wie geht es weiter?==
[[Erste Schritte in FHEM]]

[[Kategorie:HOWTOS]]

FHEM Installation Windows/en

2025-12-28T11:34:57Z

Krikan: /* Installation FHEM */

'''{{PAGENAME}}''' describes the installation of FHEM as a portable software for Windows (no intervention in the registration database). The instructions are applicable for installation on a removable disk, for example a USB stick, and on an internal drive. When installed on an internal drive, you can register FHEM as a service.

==basic Installation==
===Installation FHEM===
Download the current [https://fhem.de/#Download fhem-X.Y.zip package] (currently fhem-6.4.zip).

Create a new folder for FHEM. For this article the folder <code>f:\my-fhem</code> was created.

Extract the entire content of the folder <code>fhem-6.4\fhem-6.4</code> from the .zip-package to <code>f:\my-fhem</code>.

''For control:'' In <code>f:\my-fhem</code> there is the file <code>fhem.pl</code>.

===Installation Perl===
Download a current [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] and extract it in the FHEM folder.

In this case, the content of the package "strawberry-perl-5.42.0.1-64bit-portable.zip" was extracted to <code>f:\my-fhem</code>.

''For control:'' In <code>f:\my-fhem</code> there is now an additional folder <code>perl</code>.

===Start of FHEM===
Open a command prompt (cmd), change to the previously created folder, and start FHEM:

<syntaxhighlight lang="doscon">
C:\> cd f:\my-fhem
F:\my-fhem> portableshell.bat
F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg
</syntaxhighlight>

Now a Windows security alert appears that Windows Firewall is blocking the Perl interpreter. To access FHEM, you must set up a firewall exception. For this purpose, the security note must be terminated with the button {{Taste|Allow Access}}.

''Note:'' There is no visible output and the command won't terminate. The command prompt cannot be closed as long as FHEM is running.

===Calling the FHEM Web Interface (FHEMWEB)===
Start a browser (Firefox, Chrome and Safari are recommended) and open:

<code>http://localhost:8083/fhem</code>

The FHEM main page appears:

[[Datei:ErsteSchritteInFhem01.png]]

===Update of FHEM===
FHEM is continuously being developed. Therefore, an update should be made to get the most recent version.

In the command input field of FHEM, this is the white, rectangular text input field to the right of the FHEM logo. Type

<code>update</code>

and then press {{Taste|Enter}}.

It starts the update process, which can take a while. FHEM is showing progress. At the end of the update process, FHEM prompts for a "shutdown restart". Please ignore this and type in the command input field only

<code>shutdown</code>

followed by {{Taste|Enter}} to exit FHEM.

Now return to the command prompt window. Restart the updated FHEM; For example by the {{Taste|arrow up}} followed by {{Taste|Enter}} or re-entering

<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg</syntaxhighlight>

This completes the installation of FHEM and [[First steps in FHEM]] invites you to try it out.

==Installations Options==
===Installation of FHEM as a service===
''Note:'' Setting up FHEM as a service requires an entry in the registration database created automatically in the following installation process.

Exit FHEM by entering <code>shutdown</code> in the command input field.

Run an command prompt as administrator and install FHEM as a service:

<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> powershell -NoProfile -Command ^
"$new = 'F:\my-fhem\perl\site\bin;F:\my-fhem\perl\bin;F:\my-fhem\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"
F:\my-fhem> perl fhem.pl fhem.cfg -i
F:\my-fhem> net start fhem
</syntaxhighlight>

In the Windows Administration Tool "services", the FHEM service is listed with the name "fhem server" after it has been successfully set up. After installation as a service FHEM starts invisible (without opened command prompt) during Windows startup.

Unlike the start of FHEM via the command line, the <code>shutdown restart</code> command can be successfully executes with FHEM as a service.

==What's next?==
[[First steps in FHEM]]

[[Kategorie:HOWTOS]]

FHEM Installation Windows/en

2025-12-28T10:08:42Z

Krikan: Aktualisierung

'''{{PAGENAME}}''' describes the installation of FHEM as a portable software for Windows (no intervention in the registration database). The instructions are applicable for installation on a removable disk, for example a USB stick, and on an internal drive. When installed on an internal drive, you can register FHEM as a service.

==basic Installation==
===Installation FHEM===
Download the current [https://fhem.de/#Download fhem-X.Y.zip package] (currently fhem-6.4.zip).

Create a new folder for FHEM. For this article the folder <code>f:\my-fhem</code> was created.

Extract the entire content of the folder <code>fhem-6.0\fhem-6.0</code> from the .zip-package to <code>f:\my-fhem</code>.

''For control:'' In <code>f:\my-fhem</code> there is the file <code>fhem.pl</code>.

===Installation Perl===
Download a current [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] and extract it in the FHEM folder.

In this case, the content of the package "strawberry-perl-5.42.0.1-64bit-portable.zip" was extracted to <code>f:\my-fhem</code>.

''For control:'' In <code>f:\my-fhem</code> there is now an additional folder <code>perl</code>.

===Start of FHEM===
Open a command prompt (cmd), change to the previously created folder, and start FHEM:

<syntaxhighlight lang="doscon">
C:\> cd f:\my-fhem
F:\my-fhem> portableshell.bat
F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg
</syntaxhighlight>

Now a Windows security alert appears that Windows Firewall is blocking the Perl interpreter. To access FHEM, you must set up a firewall exception. For this purpose, the security note must be terminated with the button {{Taste|Allow Access}}.

''Note:'' There is no visible output and the command won't terminate. The command prompt cannot be closed as long as FHEM is running.

===Calling the FHEM Web Interface (FHEMWEB)===
Start a browser (Firefox, Chrome and Safari are recommended) and open:

<code>http://localhost:8083/fhem</code>

The FHEM main page appears:

[[Datei:ErsteSchritteInFhem01.png]]

===Update of FHEM===
FHEM is continuously being developed. Therefore, an update should be made to get the most recent version.

In the command input field of FHEM, this is the white, rectangular text input field to the right of the FHEM logo. Type

<code>update</code>

and then press {{Taste|Enter}}.

It starts the update process, which can take a while. FHEM is showing progress. At the end of the update process, FHEM prompts for a "shutdown restart". Please ignore this and type in the command input field only

<code>shutdown</code>

followed by {{Taste|Enter}} to exit FHEM.

Now return to the command prompt window. Restart the updated FHEM; For example by the {{Taste|arrow up}} followed by {{Taste|Enter}} or re-entering

<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg</syntaxhighlight>

This completes the installation of FHEM and [[First steps in FHEM]] invites you to try it out.

==Installations Options==
===Installation of FHEM as a service===
''Note:'' Setting up FHEM as a service requires an entry in the registration database created automatically in the following installation process.

Exit FHEM by entering <code>shutdown</code> in the command input field.

Run an command prompt as administrator and install FHEM as a service:

<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> powershell -NoProfile -Command ^
"$new = 'F:\my-fhem\perl\site\bin;F:\my-fhem\perl\bin;F:\my-fhem\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"
F:\my-fhem> perl fhem.pl fhem.cfg -i
F:\my-fhem> net start fhem
</syntaxhighlight>

In the Windows Administration Tool "services", the FHEM service is listed with the name "fhem server" after it has been successfully set up. After installation as a service FHEM starts invisible (without opened command prompt) during Windows startup.

Unlike the start of FHEM via the command line, the <code>shutdown restart</code> command can be successfully executes with FHEM as a service.

==What's next?==
[[First steps in FHEM]]

[[Kategorie:HOWTOS]]

FHEM Installation Windows

2025-12-28T09:45:25Z

Krikan: Überarbeitung

{{Baustelle}}
'''{{PAGENAME}}''' beschreibt die Installation von FHEM als portable Software für Windows (keine Eingriffe in die Registrierungsdatenbank). Die Anleitung ist sowohl für die Installation auf einem Wechseldatenträger, zum Beispiel einem USB-Stick, als auch auf einem internen Laufwerk anwendbar. Nach der Grundinstallation ist FHEM zum Ausprobieren, Experimentieren und/oder den portablen Einsatz eingerichtet. Bei Installation auf einem internen Laufwerk ist die abschließend dargestellte Einrichtung von FHEM als Dienst und damit der dauerhafte Betrieb als Hausautomations-Server unter Windows möglich.
==Manuelle Installation==
===Grundinstallation===
====Installation FHEM====
Das aktuelle [https://fhem.de/#Download fhem-X.Y.zip Paket] (momentan fhem-6.4.zip) herunterladen.

Einen neuen Ordner für FHEM anlegen. Für diesen Artikel wurde der Ordner <code>f:\my-fhem</code> angelegt.

Den gesamten Inhalt des Ordners <code>fhem-6.4\fhem-6.4</code> aus dem .zip-Paket nach <code>f:\my-fhem</code> entpacken.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> befindet sich anschließend unter anderem die Datei <code>fhem.pl</code>.

====Installation Perl====
Eine aktuelle [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] herunterladen und im Ordner von FHEM entpacken.

Hier wurde der Inhalt des Pakets "strawberry-perl-5.42.0.1-64bit-portable.zip" nach <code>f:\my-fhem</code> entpackt.

''Zur Kontrolle:'' In <code>f:\my-fhem</code> existiert anschließend unter anderem ein zusätzlicher Ordner <code>perl</code>.

====Start von FHEM====
Eine Eingabeaufforderung (cmd) in Windows öffnen, in den zuvor angelegten Ordner wechseln, portableshell.bat aufrufen und anschließend FHEM starten:

<syntaxhighlight lang="doscon">
C:\> cd f:\my-fhem
F:\my-fhem> portableshell.bat
F:\my-fhem> perl fhem.pl fhem.cfg
</syntaxhighlight>

Jetzt erscheint ein Windows-Sicherheitshinweis, dass die Windows-Firewall den Perl Interpreter blockiert. Für den Zugriff auf FHEM muss eine Firewall-Ausnahme eingerichtet werden. Hierzu ist der Sicherheitshinweis mit dem Button {{Taste|Zugriff zulassen}} zu beenden.

''Hinweis:'' In der Eingabeaufforderung erscheint keine Rückmeldung und das Programm beendet sich nicht. Die Eingabeaufforderung darf nicht geschlossen werden, so lange FHEM läuft.

====Aufruf des FHEM-Webinterfaces (FHEMWEB)====
Einen Browser öffnen (Firefox, Chrome und Safari werden empfohlen) und FHEM unter folgender Adresse aufrufen:

<code>http://localhost:8083/fhem</code>

Es öffnet sich die FHEM-Hauptseite:

[[Datei:ErsteSchritteInFhem01.png]]

====Update von FHEM====
FHEM wird kontinuierlich weiterentwickelt. Daher sollte direkt ein Update auf den aktuellen Entwicklungsstand durchgeführt werden.

Im Befehls-Eingabefeld von FHEM, das ist das weiße, rechteckige Texteingabefeld rechts neben dem FHEM-Logo, den Befehl

<code>update</code>

eingeben und mit {{Taste|Enter}} abschließen.

Es beginnt der Update-Prozeß, der eine Weile dauern kann. Den Fortschritt zeigt FHEM an. Am Ende des Update-Prozesses fordert FHEM zu einem "shutdown restart" auf. Dies bitte ignorieren und im Befehls-Eingabefeld nur

<code>shutdown</code>

gefolgt von {{Taste|Enter}} zum Beenden von FHEM eingeben.

Nun wieder zum Fenster der Eingabeaufforderung wechseln. Das aktualisierte FHEM erneut starten; beispielsweise durch {{Taste|Pfeil hoch}} gefolgt von {{Taste|Enter}} oder erneute Eingabe von

<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg</syntaxhighlight>

Hiermit ist die Installation von FHEM bereits grundlegend abgeschlossen und [[Erste Schritte in FHEM]] lädt zum Ausprobieren ein.

===Installations-Optionen===
====Installation von FHEM als Dienst====
''Hinweis:'' Die Einrichtung von FHEM als Dienst erfordert einen automatisch im folgenden Installationsprozeß erstellten Eintrag in der Registrierungsdatenbank.

FHEM durch Eingabe von <code>shutdown</code> im Befehls-Eingabefeld beenden.

Eine Eingabeaufforderung als Administrator öffnen und die PATH Umgebungsvariable für Perl erweitern, FHEM als Dienst installieren sowie den Dienst starten:
<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> powershell -NoProfile -Command ^
"$new = 'F:\my-fhem\perl\site\bin;F:\my-fhem\perl\bin;F:\my-fhem\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"
F:\my-fhem> perl fhem.pl fhem.cfg -i
F:\my-fhem> net start fhem
</syntaxhighlight>

Im Windows-Verwaltungswerkzeug "Dienste" wird der FHEM-Dienst nach erfolgreicher Einrichtung mit dem Namen "fhem server" aufgeführt. FHEM startet nach Installation als Dienst beim Windows-Start unsichtbar (ohne offene Eingabeaufforderung) im Hintergrund.

Anders als beim Start von FHEM über die Eingabeaufforderung kann bei FHEM als Dienst nach einem <code>update</code> der Befehl <code>shutdown restart</code> erfolgreich ausgeführt werden.

==Installation per Skript==
Folgendes Skript "fhem_install.bat" installiert FHEM mit allen Installationsoptionen (PATH-Erweiterung, Dienstinstallation) auf dem internen Laufwerk C. Das Skript muss mit Administratorrechten ausgeführt werden.

<syntaxhighlight lang="bat">
setlocal

rem -- Installationsverzeichnis (sollte keine Leer- oder Sonderzeichen enthalten und nicht zu lang sein) und Download-URLs festlegen
set "INSTALLDIR=C:\my-fhem"
set "FHEMURL=https://fhem.de/fhem-6.4.zip"
set "STRAWBERRYPERLURL=https://github.com/StrawberryPerl/Perl-Dist-Strawberry/releases/download/SP_54201_64bit/strawberry-perl-5.42.0.1-64bit-portable.zip"

rem -- Installationsverzeichnis anlegen
if exist "%INSTALLDIR%" (
echo Fehler: Installationsverzeichnis "%INSTALLDIR%" existiert bereits. Abbruch.
exit /b 1
)
md %INSTALLDIR%
cd %INSTALLDIR%

rem -- FHEM download and install
curl -o "fhem.zip" %FHEMURL%
tar -xf fhem.zip --strip-components=1
del fhem.zip

rem -- strawberryperl download and install
curl -L -o "perl.zip" %STRAWBERRYPERLURL%
tar -xf perl.zip
del perl.zip

rem -- Alle folgenden Abschnitte benötigen zwingend Admin-Rechte!

rem -- Firewall-Regeln anlegen
netsh advfirewall firewall add rule name="FHEM Perl interpreter TCP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=TCP
netsh advfirewall firewall add rule name="FHEM Perl interpreter UDP" dir=in action=allow program="%INSTALLDIR%\perl\bin\perl.exe" profile=private protocol=UDP

rem -- PATH Umgebungsvariable für strawberryperl (dauerhaft) erweitern statt portableshell.bat zu starten
powershell -NoProfile -Command ^
"$new = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = ($machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' }) + ($new.Split(';') | ForEach-Object { $_.Trim() });" ^
"$uniq = $parts | Where-Object { $_ } | Select-Object -Unique;" ^
"$final = $uniq -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"Write-Output 'PATH updated';"

rem -- FHEM-Dienst installieren und starten
set PATH=%PATH%;%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin
perl fhem.pl fhem.cfg -i
net start fhem

endlocal
</syntaxhighlight>

Nach erfolgreicher Ausführung des Skriptes kann FHEM direkt genutzt werden.

Das nachfolgende als Administrator auszuführende Skript "fhem_uninstall.bat" entfernt die Installation von FHEM und alle geänderten Einstellungen in Windows wieder. ACHTUNG: Datensicherung vorab nicht vergessen. Das Skript entfernt alles ohne Sicherheitsabfragen.

<syntaxhighlight lang="bat">
setlocal

rem -- Installationsverzeichnis
set "INSTALLDIR=C:\my-fhem"

rem -- FHEM Dienst stoppen und entfernen
perl fhem.pl -u
net stop fhem
sc delete fhem

rem -- Firewall-Regeln entfernen
netsh advfirewall firewall delete rule name="FHEM Perl interpreter TCP"
netsh advfirewall firewall delete rule name="FHEM Perl interpreter UDP"

rem -- PowerShell: PATH für aktuelle Session und machine-Umgebungsvariable zurücksetzen
powershell -NoProfile -Command ^
"$oldPaths = '%INSTALLDIR%\perl\site\bin;%INSTALLDIR%\perl\bin;%INSTALLDIR%\c\bin';" ^
"$machine = [Environment]::GetEnvironmentVariable('Path','Machine');" ^
"if(-not $machine){ $machine = '' };" ^
"$parts = $machine.Split(';') | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' };" ^
"$filtered = $parts | Where-Object { $_ -notin $oldPaths.Split(';') };" ^
"$final = $filtered -join ';';" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Machine');" ^
"[Environment]::SetEnvironmentVariable('Path',$final,'Process');" ^
"Write-Output 'PATH updated';"

rem -- FHEM/Perl-Verzeichnisse und Dateien löschen
rmdir /s /q %INSTALLDIR%

endlocal
</syntaxhighlight>

==Wie geht es weiter?==
[[Erste Schritte in FHEM]]

[[Kategorie:HOWTOS]]

FHEM Installation Windows

2025-12-20T17:22:36Z

Krikan: Akualisierung

FHEM Installation Windows

2025-12-20T17:09:05Z

Krikan: Aktualisierung

FHEMWiki:Impressum

2024-07-31T09:46:02Z

Krikan: /* Impressum */

{{Randnotiz|RNTyp=Info|RNText=Bei Fragen technischer oder administrativer Art zum Wiki wendet Euch bitte nach Möglichkeit direkt an
* einen der [[FHEMWiki:Administratoren|Administratoren]] oder
* einen [https://verein.fhem.de/?action=*Zustaendigkeiten Zuständigen des FHEM e.V.]
per Diskussionseite, Forum oder Mail. Vielen Dank.}}
== Impressum ==
<BR>
FHEM e.V.<BR>
Neuwiesenstraße 10<BR>
60528 Frankfurt am Main

'''vertreten durch den einzelvertretungsberechtigten Vorstand:'''<BR>
Rudolf König<BR>
Neuwiesenstraße 10<BR>
60528 Frankfurt am Main<BR>

'''Kontakt:'''<BR>
Mail: [[Datei:VorstandMail.png]]<BR>

'''Registereintrag:'''<BR>
Registergericht: Frankfurt am Main<BR>
Registernummer: VR 15827<BR>

== Haftungsausschluss: ==

=== Haftung für Inhalte ===
Die Inhalte unserer Seiten wurden mit größter Sorgfalt erstellt. Für die Richtigkeit, Vollständigkeit und Aktualität der Inhalte können wir jedoch keine Gewähr übernehmen. Als Diensteanbieter sind wir gemäß § 7 Abs.1 TMG für eigene Inhalte auf diesen Seiten nach den allgemeinen Gesetzen verantwortlich. Nach §§ 8 bis 10 TMG sind wir als Diensteanbieter jedoch nicht verpflichtet, übermittelte oder gespeicherte fremde Informationen zu überwachen oder nach Umständen zu forschen, die auf eine rechtswidrige Tätigkeit hinweisen. Verpflichtungen zur Entfernung oder Sperrung der Nutzung von Informationen nach den allgemeinen Gesetzen bleiben hiervon unberührt. Eine diesbezügliche Haftung ist jedoch erst ab dem Zeitpunkt der Kenntnis einer konkreten Rechtsverletzung möglich. Bei Bekanntwerden von entsprechenden Rechtsverletzungen werden wir diese Inhalte umgehend entfernen.
Haftung für Links
Unser Angebot enthält Links zu externen Webseiten Dritter, auf deren Inhalte wir keinen Einfluss haben. Deshalb können wir für diese fremden Inhalte auch keine Gewähr übernehmen. Für die Inhalte der verlinkten Seiten ist stets der jeweilige Anbieter oder Betreiber der Seiten verantwortlich. Die verlinkten Seiten wurden zum Zeitpunkt der Verlinkung auf mögliche Rechtsverstöße überprüft. Rechtswidrige Inhalte waren zum Zeitpunkt der Verlinkung nicht erkennbar. Eine permanente inhaltliche Kontrolle der verlinkten Seiten ist jedoch ohne konkrete Anhaltspunkte einer Rechtsverletzung nicht zumutbar. Bei Bekanntwerden von Rechtsverletzungen werden wir derartige Links umgehend entfernen.
Urheberrecht
Die durch die Seitenbetreiber erstellten Inhalte und Werke auf diesen Seiten unterliegen dem deutschen Urheberrecht. Die Vervielfältigung, Bearbeitung, Verbreitung und jede Art der Verwertung außerhalb der Grenzen des Urheberrechtes bedürfen der schriftlichen Zustimmung des jeweiligen Autors bzw. Erstellers. Downloads und Kopien dieser Seite sind nur für den privaten, nicht kommerziellen Gebrauch gestattet. Soweit die Inhalte auf dieser Seite nicht vom Betreiber erstellt wurden, werden die Urheberrechte Dritter beachtet. Insbesondere werden Inhalte Dritter als solche gekennzeichnet. Sollten Sie trotzdem auf eine Urheberrechtsverletzung aufmerksam werden, bitten wir um einen entsprechenden Hinweis. Bei Bekanntwerden von Rechtsverletzungen werden wir derartige Inhalte umgehend entfernen.

=== Datenschutz ===
Die Nutzung unserer Webseite ist in der Regel ohne Angabe personenbezogener Daten möglich. Soweit auf unseren Seiten personenbezogene Daten (beispielsweise Name, Anschrift oder eMail-Adressen) erhoben werden, erfolgt dies, soweit möglich, stets auf freiwilliger Basis. Diese Daten werden ohne Ihre ausdrückliche Zustimmung nicht an Dritte weitergegeben.
Wir weisen darauf hin, dass die Datenübertragung im Internet (z.B. bei der Kommunikation per E-Mail) Sicherheitslücken aufweisen kann. Ein lückenloser Schutz der Daten vor dem Zugriff durch Dritte ist nicht möglich.
Der Nutzung von im Rahmen der Impressumspflicht veröffentlichten Kontaktdaten durch Dritte zur Übersendung von nicht ausdrücklich angeforderter Werbung und Informationsmaterialien wird hiermit ausdrücklich widersprochen. Die Betreiber der Seiten behalten sich ausdrücklich rechtliche Schritte im Falle der unverlangten Zusendung von Werbeinformationen, etwa durch Spam-Mails, vor.

Z-Wave

2024-04-24T09:15:50Z

Krikan: /* Vorbereitung */ -> Aktualisierung nach https://forum.fhem.de/index.php?topic=138013.0

<div style="float:right">{{Infobox Modul
|Name=ZWDongle
|ModPurpose=Einbindung Z-Wave-Gateways
|ModType=d
|ModCmdRef=ZWDongle
|ModForumArea=ZWave
|ModTechName=00_ZWDongle.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
{{Infobox Modul
|Name=ZWave
|ModPurpose=Ansteuerung Z-Wave-Geräte über ZWDongle
|ModType=d
|ModCmdRef=ZWave
|ModForumArea=ZWave
|ModTechName=10_ZWave.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
</div>

[[Z-Wave]] ist ein drahtloser Kommunikations-Standard im 868 Mhz-Band (Europa), der von der Firma Sigma Designs und der Z-Wave Alliance, einen Zusammenschluss von mehreren Hundert Herstellern, für die Heimautomatisierung entwickelt wurde. Es existieren mehr als [http://products.z-wavealliance.org 1400 zertifizierte Produkte] verschiedenster Hersteller, die innerhalb eines gemeinsamen Z-Wave-Netzes einsetzbar sind. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia])

Auf dieser Seite werden Grundlagen eines '''Z-Wave''' Systems und dessen Einrichtung in FHEM beschrieben.
== Z-Wave ==
=== Nodes - Controller und Slaves ===
Ein Z-Wave-Netz besteht aus mindestens 2 Geräten, den sogenannten '''Nodes''' (Knoten). Es setzt sich zusammen aus dem steuernden '''Controller''' (Zentrale) und min. 1 bis max. 231 gesteuerten '''Slaves''' (Geräten).

=== Home-Id und Node-ID ===
Innerhalb eines Z-Wave-Netzes gibt es zu 2 Identifikationsnummern zur Kennzeichnung der Netzstruktur:
# '''Home-ID:''' Gemeinsame Identifikationsnummer aller Nodes in einem Netz zur Abgrenzung gegenüber anderen Netzen. Nur Nodes mit der gleichen Home-ID können miteinander kommunizieren.
# '''Node-ID:''' Identifikationsnummer zur eindeutigen Kennzeichnung von jedem Node im Netz.

Die Home-ID ist im Controller (fest) hinterlegt und seine Node-ID ist typischerweise 1. Die Slaves haben zunächst keine Home-ID und Node-ID. Bei der '''Inklusion''' (Aufnahme) der Slaves in das Z-Wave-Netz überträgt der Controller seine Home-ID auf die Slaves und weist den Slaves eine eindeutige Node-ID im Netz zu, mit der Sie direkt angesprochen werden.

Besondere Node-ID ist die 255. Eine Nachricht an die Node-ID 255 kann von allen Z-Wave-Nodes ausgewertet werden (Broadcast).

=== Primär- und Sekundärcontroller ===
Der Controller, der durch Zuteilung seiner Home-ID auf die Slaves, das Netz aufbaut, ist der '''Primärcontroller'''. Grundsätzlich können in einem Netz mehrere Controller existieren, aber immer nur ein Primärcontroller. Weitere in das Netz eingebundene Controller werden zum '''Sekundärcontroller'''. Ohne besondere Maßnahmen kann nur der Primärcontroller die Inklusion (Einbindung) der Nodes in das Netz durchführen. Hingegen können sowohl Primär- als auch Sekundärcontroller die '''Exklusion''' (Ausschluss) eines Nodes aus dem Netz vornehmen.

Der Controller speichert intern diverse Informationen (Home-ID, Node-IDs,..) über das ZWave-Netz. Hierdurch kann unter anderem die Haussteuerungssoftware bei einem PC-Controller relativ unkompliziert gewechselt werden, da die wesentlichen ZWave-Netzinformationen vom Controller selbst verwaltet und gespeichert werden. Andererseits muß bei einem Controllerdefekt das gesamte Netz grundsätzlich neu aufgebaut werden, wenn kein Backup der internen Controllerdaten vorhanden ist.

=== Acknowledge ===
Im Z-Wave-Netz werden Nachrichten vom Empänger-Node an den Sender-Node rückbestätigt (Acknowledge). Bei ausbleibendem Acknowledge wiederholt der Sender-Node die Nachricht automatisch auf Protokollebene bis zu 2 mal. Hierdurch wird eine höhere Betriebssicherheit des Z-Wave-Netzes erreicht. Bei Broadcast-Nachrichten an die Node-ID 255 findet keine Rückbestätigung statt.

=== Vermaschtes Netzwerk mit Routing ===
Z-Wave nutzt als Netzwerktopologie ein '''mesh network''' (vermaschtes Netzwerk), d. h. jeder Node ist mit einem oder mehreren anderen Nodes verbunden. Das hat den Vorteil, dass eine Nachricht zwischen zwei Nodes übermittelt werden kann, selbst wenn diese nicht direkt miteinander kommunizieren können, z. B. weil sie zu weit voneinander entfernt sind. In diesem Fall wird die Funk-Nachricht über einen oder mehrere „Zwischen-Nodes“ übertragen; dieser Vorgang wird '''Routing''' genannt. Nur netzgespeiste Z-Wave-Geräte sind Router. Batteriebetriebe Z-Wave-Geräte sind grundsätzlich keine Router und dienen somit auch nicht zur Reichweitenerhöhung. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia]) Einzelne Geräte, die alternativ per Batterie oder USB-Anschluss betrieben werden können, werden bei USB-Anschluss automatisch ({{Link2Forum|Topic=40393|Message=328080}}) oder durch Konfigurationsänderungen ({{Link2Forum|Topic=40393|Message=327331}}) zu Routern.

Informationen über das optimale Routing werden bei der Inklusion der Nodes in einer Routing-Tabelle des Primärcontrollers gespeichert. Dies geschieht durch Abfrage des Nodes, welche weiteren Nodes er erreichen kann. Durch örtliche Änderung oder Defekte von Nodes können die in der Routing-Tabelle gespeicherten Informationen fehlerhaft bzw. suboptimal werden. Dies kann sich in Funkkommunikationsproblemen im Netzwerk äußern. Hier kann ein per Software manuell angeforderter Neuaufbau der Routing-Tabelle gegebenenfalls Abhilfe schaffen. Bei Geräten und Controllern mit aktuellen Firmware-Versionen (SDK 4.5x und SDK 6.xx oder größer, aber ''nicht'' SDK 5.x) und Unterstützung von Explorer Frames kann sich die Routing-Tabelle unter bestimmten Bedingungen auch automatisch aktualisieren ("Selbstheilung")[https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames].

=== Command Classes ===
Die Steuerung und Kommunikation der Nodes erfolgt über Befehle die funktionsbezogen in verschiedene '''Command Classes''' (Kommandoklassen) zusammengefasst sind.

Alle Z-Wave-Geräte haben als gemeinsame kleinste Übereinstimmung die '''Class Basic'''.

Z-Wave-Geräte haben im Originalzustand eine bestimmte arbeitsfähige Grund-Konfiguration. Anpassbar an individuelle Bedürfnisse ist die Konfiguration über die '''Class Configuration'''.

Durch eine Assoziation wird definiert, welche Geräte miteinander direkt -ohne Umweg über den Controller- kommunizieren können. Auch bei Ausfall des Controllers können diese Geräte ihre gemeinsame Funkton ausüben. Zudem dienen Assoziationen der Geschwindigkeitssteigerung und Funklastreduzierung innerhalb des Netzes. Angelegt werden Assoziationen über die '''Class Association'''.

Dies sind nur die allerwichtigsten Command Classes. Weitere Command Classes sind den Handbüchern zu entnehmen. Zudem enthält die Wiki-Seite [[Z-Wave Command Classes]] weitergehende Informationen.

=== Hinweise zur Z-Wave-Geräteauswahl ===
Aufgrund der vielen Z-Wave-Gerätehersteller mit jeweils eigenem Z-Wave-Gerätesortiment existiert eine große Produktauswahl. Jedoch gibt es auch große Unterschiede hinsichtlich Produkteigenschaften, Pflege der Produkte, Häufigkeit der Aktualisierung der Produktpalette und so weiter. Schwierigkeiten bereitet insbesondere, dass neben den aktuellesten Chipsätzen und SDKs auch die älteren Chipsätze und SDKs weiterhin in Produkten im Handel verfügbar sind. Neuere Chipsätze und aktuelle SDKs bieten gerade bei der Netzwerkstabilität (Explorer Frames, Reichweite usw.) Vorteile zu älteren Chipsätzen und SDKs. Beispielsweise beherrschen nur Geräte mit SDK 4.5x und 6.x oder neuer die für automatische Routenkorrekturen wichtigen Explorer Frames. Das ältere SDK 5.0, das verwirrenderweise auch noch eine höhere Versionsnummer als das neuere SDK 4.5 besitzt, beherrscht unter anderem keine Explorer Frames. Details hierzu enthält das [https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames wiki.zwaveeurope.com]. Aktuellstes SDK ist Stand 10/2017 das SDK 6.7x, das in ZWave Plus - zertifizierten Produkten zum Einsatz kommt.

Gerade Einsteiger beachten die Unterschiede bei den Chipsätze/SDKs aus Unkenntnis manchmal nicht und ärgern sich im Nachhinein über Probleme bei der Netzwerkstabilität und Reichweite. Darum nachfolgend allgemeine, aber sehr einfache Empfehlungen zur Geräteauswahl. Selbstverständlich wird hier nicht von anderen Produkten abgeraten, wenn man die Unterschiede kennt und Vorteile bei deren Produkteigenschaften sieht. Zudem kann man (leider) schlechtere Produkteigenschaften bei Geräten mit aktuelleren Chipsätzen/SDKs nie ausschließen.

Gateway
# [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus-Zertifizierung]. Diese ist mittlerweile bei nahezu allen erhältlichen Gateways gegebenen.

Endgeräte
# Z-Wave Plus-Zertifizierung (aktuellste Technik, höhere theoretische Reichweite, SDK 6.5x oder höher) oder
# zumindest Explorer Frames-Unterstützung (SDK 4.5x und 6.0x) oder
# zuletzt -bei Kenntnis der Besonderheiten und Auswirkungen- Produkte ohne Explorer Frames (SDK 5.0x)

'''Kurz''': Produkte mit Z-Wave Plus-Zertifizierung einsetzen.

Bitte unbedingt beachten, dass Z-Wave Plus-Vorteile bei einem Mischbetrieb mit älteren (ohne Plus) Geräten teilweise verloren gehen. Zum negativen Effekt des Einsatzes eines älteren, aber weiterhin erhältlichen Z-Wave-Repeaters mit aktuellen Z-Wave Plus-Geräten siehe beispielsweise den Hinweis in diesem {{Link2Forum|Topic=42591|Message=350066}}.

Bei Fragen zu bestimmten Geräten bitte -nach Durchsicht der Hinweise hier im Wiki- im Forum suchen oder anschließend nachfragen.

== Z-Wave in FHEM ==
=== Allgemein ===
FHEM wird fortwährend weiterentwickelt und verbessert. Daher ist es zwingend notwendig, dass FHEM auf dem aktuellsten Stand ist. Dazu nach der FHEM-Installation den Befehl <code>update</code> ausführen und anschließend <code>shutdown restart</code> durchführen. Genauso auch vor [[#Welche_Infos_sollten_Anfragen_im_ZWave-Forum_enthalten.3F|Anfragen im Forum]] die Aktualität von FHEM überprüfen.

Die Einbindung von Z-Wave in FHEM ist (nicht nur für den Anfänger) ausschließlich mit der standardmäßig eingeschalteten [[autocreate|autocreate-Funktion]] einfach möglich. Die Kenntnis der FHEM-Grundlagen und Durcharbeitung der Anfänger-Lektüren wird im Folgenden vorausgesetzt. Insbesondere sind [[Erste_Schritte_in_FHEM|Erste Schritte in FHEM]] und [http://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM] Pflicht, auch wenn sie nicht speziell Z-Wave behandeln, so werden doch wesentliche Punkte für ein Verständnis von FHEM vermittelt.

Nachfolgend und auf den [[:Kategorie:Z-Wave Components|Wiki-Seiten der Einzelgeräte]] werden immer wieder Auszüge aus der [[Konfiguration]] dargestellt. Diese dienen zur Erläuterung und Veranschaulichung. Die Bearbeitung der Konfiguration sollte -zur Verhinderung von Fehlern- nach Möglichkeit immer über das "[[Konfiguration#Befehl-Eingabefeld|Befehl-Eingabefeld]]" und die "[[Konfiguration#Objektdetails|Objektdetails]]" erfolgen.

=== Vorbereitung ===
Die Bedienungsanleitungen (Handbücher) sind zwingende Voraussetzung zur korrekten Einbindung und Konfiguration von Z-Wave-Geräten in FHEM. Sie müssen daher vorliegen. Den ZWave-Geräten liegen teilweise nur gekürzte, gedruckte Fassungen der Handbücher bei. Man sollte bei allen Produkten auf folgenden Seiten nach eventuellen ausführlicheren Informationen suchen:
* Herstellerseite des ZWave-Gerätes
* https://products.z-wavealliance.org (englisch)
* https://devices.zwave-js.io/ oder https://github.com/zwave-js/node-zwave-js/tree/master/packages/config/config/devices (werden wohl im Wesentlichen aus den Daten von products.z-wavealliance.org erzeugt)
* https://opensmarthouse.org/zwavedatabase/
Insbesondere auf https://products.z-wavealliance.org, der Datenbank der ZWave-zertifizierten Produkte, sind regelmäßig ausführliche Informationen zu den Geräten zu finden.

== Definition des Gateways / Controllers ==
{{Randnotiz|RNText='''Tester für ZWave@culfw gesucht!'''
Z-Wave-Controllerfunktionen werden derzeit in die Firmware [http://www.culfw.de culfw] für den [[CUL]] implementiert. Weitere Informationen im [[ZWCUL]] - Artikel.}}
=== Autocreate des Gateways ===
FHEM kann mit einem Funkgateway Z-Wave-Funk empfangen und senden. Z-Wave-Gateways (Controller) existieren von verschiedenen Herstellern.

Folgende Gateways wurden unter anderem bereits erfolgreich mit FHEM eingesetzt:
* AEON Labs Z-Stick S2 (SDK 5.x; [https://aeotec.freshdesk.com/support/solutions/articles/6000091809-z-stick-s2-v3-08-firmware-update Firmwareupdate auf 3.08 aus 2016])
* Aeotec Z-Stick Gen5 (Z-Wave Plus; SDK 6.5; [https://aeotec.freshdesk.com/support/solutions/articles/6000108806-z-stick-gen5-backup-software Backup-Software)] ({{Link2Forum|Topic=47000}})
* Goodway WD6001 (SDK 5.03 {{Link2Forum|Topic=40594|Message=332235}})
* Vision Z-Wave USB Stick ZU 1401 EU (SDK 6.0x)
* Vision Z-Wave USB Stick ZU 1401-5 EU (Z-Wave Plus; SDK 6.5x)
* Z-Wave.Me Z-StickC ({{Link2Forum|Topic=29930|Message=226530}})
* Z-Wave.Me USB Stick ZME_UZB1 (SDK 6.5x; Z-Wave Plus; [http://razberry.z-wave.me/z-way-server/ Firmwareupdate und Backup über z-way])
* Z-Wave.Me Razberry in Verbindung mit Raspberry Pi (1. Generation: Z-Wave, 2. Generation: Gen5-Razberry mit Z-Wave Plus[http://forum.z-wave.me/viewtopic.php?f=3419&t=21327#p55404])
** Die seriellen Schnittstelle /dev/ttyAMA0 muss am Raspberry Pi freigeschaltet werden, damit das Razberry-Modul funktionsfähig ist: {{Link2Forum|Topic=78248|Message=702044}})
** Beim Raspberry Pi 3 muss der GPIO-Port auf den Hardware-UART0 umgestellt werden: [[Raspberry Pi 3: GPIO-Port Module und Bluetooth]]

Folgende Gateways sind '''nicht''' mit FHEM einsetzbar:
* Merten Funk-USB-Datenschnittstelle CONNECT

Sollte das eigene Gateway hier nicht aufgeführt sein, ist aufgrund der Standardisierung dennoch die Chance für eine erfolgreiche Einbindung des Gateways in FHEM vorhanden. Bitte dies hier oder im Forum entsprechend vermerken.

Das Z-Wave-Gateway wird unter Linux nach Anschluss an den FHEM-Rechner beim nächsten FHEM-Start oder ohne FHEM-Neustart durch Aufruf des Befehls <code>usb scan</code> zumeist automatisch erkannt und das zugehörige FHEM-Device nach dem Namensschema <code>ZWDongle_<[https://forum.fhem.de/index.php/topic,92885.msg854533.html#msg854533 Anhang]></code> angelegt. Ein manuelles Anlegen des ZWDongle-Moduls oder Eingriffe in die Konfiguration sind unter Linux normalerweise nicht notwendig.

Unter Windows ist ein manuelles Anlegen der Definition des ZWave-Gateways wegen fehlender Unterstützung des Befehls <code>usb scan</code> erforderlich (Beispiel für Z-Wave.Me USB Stick ZME_UZB1 unter Windows: <code>define ZWDongle_1 ZWDongle COM1@115200</code>).

Das FHEM-Gateway-Device ist nach der Definition in FHEM im Raum "Everything" zu finden.

Beispiele der automatisch erzeugten define-Zeile in der Konfiguration:

Aeon Labs Z-Stick an der Fritzbox:
define ZWDongle_1 ZWDongle /dev/ttyUSB1@115200

Vision Z-Wave USB Stick ZU 1401 EU am Raspberry Pi (Raspbian):
define ZWDongle_1 ZWDongle /dev/ttyACM1@115200

Insbesondere wenn am FHEM-Server unter Linux mehrere USB-Gateways eingesetzt werden, empfiehlt es sich zur Erhöhung der Betriebsstabilität das Z-Wave-Gateway über [[Trick_der_Woche#CUL_.26_CO_.C3.BCber_Serial_ID-einbinden|Serial-by-Id]] oder [[LinuxDeviceNaming|uDev-Regeln]] anzusprechen.

Bei einem statischen Controller wird die Einrichtung als SUC -sofern der Controller als solcher nicht bei Auslieferung eingerichtet ist- vor der ersten Inklusion von Geräten empfohlen.

=== homeId und nodeList des Gateways ===
Zur manuellen Definition von Z-Wave Aktoren und Sensoren ist die <code>homeId</code> notwendig. Bei der hier bevorzugten Definition der Geräte durch autocreate ist die Kenntnis der <code>homeId</code> nicht zwingend. Jedoch sollte durch Abfrage der <code>homeId</code> direkt nach Einbindung des Zwave-Gateways dessen Funktionsfähigkeit getestet werden.

Die <code>homeId</code> und <code>CtrlNodeId</code> des Gateways wird mit folgendem Befehl ausgelesen (<ZWDongle> ist im folgenden durch den Namen des FHEM-Devices des eigenen Gateways zu ersetzen):
get <ZWDongle> homeId
ergibt beispielsweise bei einem Gateway mit dem FHEM-Devicenamen ZWDongle_1:
ZWDongle_1 homeId => HomeId:e345c456 CtrlNodeId:01
In diesem Beispiel ist die Home-Id des Gateways ZWDongle_1 e345c456 und das Gateway hat die Node-Id 1.

Die aktuelle Liste der Z-Wave Nodes, die bereits am Gateway registriert/inkludiert sind, wird mit dem folgendem Befehl ausgelesen:
get <ZWDongle> nodeList
ergibt beispielsweise:
ZWDongle_1 nodeList => ZWDongle_1 UNKNOWN_2

== Definition von Geräten / Slaves ==
=== Hinzufügen eines neuen Z-Wave Geräts / Inklusion ===
Zur Verfolgung von Inklusionsablauf und Meldungen des Controllers während der Inklusion sollte der [[Event monitor]] in einem 2. Browserfenster vor Aktivierung des Inklusionsmodus geöffnet werden.

Das Z-Wave Gateway wird in den Standard-Modus zur Inklusion (zum Aufnehmen) neuer Geräte gesetzt:
set <ZWDongle> addNode on
Bei der Standard-Inklusion muss direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen.

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt des obigen Befehls besser der Network-Wide-Modus für die Inklusion genutzt werden:
set <ZWDongle> addNode onNw
Bei der Network-Wide-Inklusion muss kein direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen. Es reicht, wenn das zu inkludierende Gerät über andere bereits inkludierte, netzgespeiste Geräte mit Explorer Frames-Unterstützung erreicht werden kann. Die Network-Wide-Inklusion ist zu bevorzugen, da die Z-Wave-Geräte regelmäßig an Ihren örtlichen Endpositionen inkludiert werden können. Dadurch werden bei der Inklusion direkt die korrekten Routen gespeichert.

Nachdem das Gateway in den Inklusionmodus geschaltet wurde, muss das Gerät in den Inklusionsmodus (Aufnahmemodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen. Typisch sind ein- oder dreimaliges Drücken einer Taste am Gerät oder beim Anlegen der Versorgungsspannung. Durch die Inklusion werden Home-ID und Node-ID im Gerät gespeichert. Zudem teilt das Gerät über ein spezielle Funknachricht (NIF=Node Information Frame) dem Controller seinen Gerätetyp und seine Geräteeigenschaften mit. Hierbei werden dem Controller auch die vom Gerät unterstützten Command Classes mitgeteilt. Aus diesen Informationen erzeugt FHEM automatisch durch autocreate das FHEM-Geräte-Device nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> (an eigene Wünsche anpassbar mit {{Link2CmdRef|Anker=rename|Label=rename}}). Die vom Geräte unterstützen Command Classes, die die in FHEM verfügbaren Befehle bestimmen, werden automatisch im Attribut <code>classes</code> des FHEM-Geräte-Device gespeichert. Das Gerät ist damit grundlegend in FHEM definiert und im Raum "ZWave" zu finden.

Nach der Inklusion schaltet FHEM den Inklusionsmodus des Z-Wave Gateway automatisch durch Absetzen des Befehls <code>set <ZWDongle> addNode off</code> aus und zeigt eine Dialogbox mit dem Ergebnis der Inklusion:
* <code><nowiki>created ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> = Inklusion war erfolgreich und es wurde das bezeichnete FHEM-Device durch autocreate angelegt.
* <code><nowiki>addNode failed</nowiki></code> = Inklusion ist fehlgeschlagen

Eine erfolgreiche Inklusion ist zudem am Event "ZW_ADD_NODE_TO_NETWORK protocolDone" im Event monitor und natürlich der Anlage des entsprechenden FHEM-Devices durch autocreate zu erkennen. Das Scheitern einer Inklusion führt typischerweise zur Ausgabe des Events "ZW_ADD_NODE_TO_NETWORK failed". Häufigste Ursache sind Controllerprobleme, die sich oftmals durch kurzes Ein- und Ausstecken des Controllers, Neustart des Systems oder Ein- und Ausschalten des FHEM-Server-Computers beheben lassen.

HINWEISE:<br />
* Die Network-Wide-Inklusion kann nach derzeitiger Kenntnis auch bei Gateways und Geräten ohne Explorer Frames Unterstützung genutzt werden, da bei diesen Geräten grundsätzlich automatisch auf die Standard-Inklusion umgestellt wird.
* Bei der Standard-Inklusion ist unter Umständen nur ein geringer Abstand zwischen Gateway und Gerät möglich. Sollte die Inklusion daher nicht durchführbar sein, wenn Gateway und Gerät an ihren örtlichen Endpositionen sind (bevorzugte Variante), dann ist der Abstand zwischen diesen versuchsweise zu verringern. Anschließend bei örtlicher Veränderung die Routen mit <code><nowiki>set <ZWave-Devicename> neighborUpdate</nowiki></code> bzw. <code><nowiki>set TYPE=ZWave:FILTER=ZWaveSubDevice=no neighborUpdate</nowiki></code> neu ermitteln lassen. Unter Umständen kann der Abstand nur schrittweise erhöht werden. Dann ist bei jeder Abstandsänderung eine Neuermittlung der Routen notwendig.
* Der NIF enthält bei manchen Geräten fälschlicherweise nicht alle unterstützten Command Classes. FHEM identifiziert während der Inklusion das Gerät und ergänzt die fehlenden Command Classes aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Weiterhin fehlende Command Classes können im Attribut <code>classes</code> manuell am Anfang der Liste entsprechend ergänzt werden. Informationen liefern die unter [[#Links|Links]] aufgeführten Datenbanken. Häufig fehlt die Pflicht-Class BASIC.
* Bei der hier beschriebenen Inklusion findet die Kommunikation zwischen Controller und Gerät anschließend dauerhaft unverschlüsselt statt. Manche Geräte bieten mit der Command Class SECURITY eine AES-verschlüsselte Kommunikation an. Da die Verschlüsselung zu einer höheren Funklast und Latenzen führt, sollte eine verschlüsselte Kommunikation nur mit Bedacht eingesetzt werden (bspw. bei Schlössern). Als Sonderfall ist das Vorgehen zur secure-Inklusion in der [[#Wie_kann_eine_verschl.C3.BCsselte_Kommunikation_unter_Nutzung_der_Command_Class_SECURITY_eingerichtet_werden.3F|FAQ]] beschrieben.

Nächster Schritt ist die [[#Assoziation|Assoziation]] des Gerätes mit dem Gateway.

=== Assoziation ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Z-Wave-Geräte können über Assoziationen direkt mit anderen Z-Wave-Geräten kommunizieren. Dies können zum einen Meldungen über den Status und Zustand der Geräte, als auch direkte Befehle sein. Zum Beispiel kann damit ein Bewegungsmelder eine entdeckte Bewegung an den Controller senden und/oder bei entdeckter Bewegung direkt eine Lampe ein- oder ausschalten.

Die Assoziation zwischen zwei Geräten wird durch Aufnahme des zu steuernden Gerätes in eine oder mehrere Assoziationsgruppe(n) des steuernden Gerätes angelegt. Durch die Wahl der Assoziationsgruppe wird festgelegt, bei welchen Ereignissen welche Nachricht an das assoziierte Gerät verschickt wird. Angaben zu den Ereignissen und versandten Nachrichten an die Geräte in einer bestimmten Assoziationsgruppe stehen in der Bedienungsanleitung des jeweiligen Gerätes.

Damit FHEM Statusmeldungen von Sensoren/Aktoren anzeigen und auch darauf reagieren kann, '''muss''' der Controller (<ZWDongle>-Device, <code>CtrlNodeId</code> = typischerweise 1) immer in der/den passenden Assoziationsgruppe(n) des jeweiligen Gerätes <code><name></code> aufgenommen werden:

set <name> associationAdd <associationGroup> <CtrlNodeId>

Typischerweise ist die Assoziationsgruppe 1 der Geräte für die Statusmeldungen an den Controller vorgesehen (Ausnahme: [[#Fibaro|Fibaro-Geräte ohne ZWave Plus - Zertifizierung]]). Daher nimmt FHEM die Assoziation von Controller mit der Assoziationsgruppe 1 des Gerätes bei der Inklusion immer automatisch vor. Zudem identifiziert FHEM während der Inklusion das Gerät und setzt weitere Assoziationen mit dem Controller für von 1 abweichende Assoziationsgruppen aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Ist keine XML-Config-Datei für das Gerät vorhanden, sind Assoziationen des Controllers mit von 1 abweichenden Assoziationsgruppen oder weiteren Assoziationsgruppen mit dem zuvor genannten Befehl grundsätzlich manuell anzulegen.

Die richtige Anlage der Assoziation(en) des Controllers mit dem Gerät immer prüfen, da dies eine Hauptfehlerquelle bei Funktionsproblemen mit FHEM ist.

Abruf der assoziierten Geräte in einer bestimmten Assoziationsgruppe <associationGroup>:
get <name> association <associationGroup>

Abruf der assozierten Geräte für alle Assoziationsgruppen eines Gerätes:
get <name> associationAll

Nahezu alle in Europa erhältlichen aktuellen Geräte unterstützen die Rückmeldung des Status via Association. Ausnahmen gibt es in Nordamerika, wo aufgrund von Patentansprüchen einige Hersteller auf die Statusrückmeldungen verzichten. Diese Geräte unterstützen in der Regel die Command Class ASSOCIATION nicht.

Nächster Schritt ist die [[#Konfiguration|Konfiguration]] des Gerätes.

=== Konfiguration ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Die Standard-Konfiguration eines Gerätes entspricht oftmals nicht den eigenen Wünschen und Anforderungen (Einheiten usw.). Mit den Befehlen der Class CONFIGURATION lässt sich die Konfiguration anpassen. Die zur Konfiguration eines Gerätes notwendigen Angaben zu den Parameternummern, -größen und -werten sind im jeweiligen Geräte-Handbuch bzw. entsprechenden Datenbanken (bspw. [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] oder [http://products.zwavealliance.com/ products.zwavealliance.com]) enthalten.

Die Konfiguration beispielsweise bei Parametergröße 1 lässt sich mit diesem Befehl anpassen:
set <name> configByte <Parameternummer> <Parameterwert>
Für weitere Parametergrößen gibt es die Befehle <code>configWord</code> und <code>configLong</code>

Die im Gerät hinterlegten Konfiguration kann pro Parameternummer mit folgendem Befehl abgerufen werden:
get <name> config <Parameternummer>

Zudem bietet FHEM basierend auf den manuell gepflegten XML-Config-Dateien die Möglichkeit, die speziellen Parameternummern des Gerätes mit ihren Parametergrößen und -werte als eigenständige config-Befehle mit Hilfsinformationen einzubinden. Ein manuelles Suchen im Geräte-Handbuch und Nutzung der configByte-, configWord- und configLong-Befehle ist dadurch in vielen Fällen unnötig. Für diese Funktion muss das Gerät von FHEM einmalig durch folgenden Befehl, der bei der Inklusion automatisch ausgeführt wird, identifiziert werden:
get <name> model
Die Readings <code>model</code>, <code>modelID</code> und <code>modelConfig</code> werden dadurch erzeugt. In <code>model</code> sollte der Klartextname des Gerätes stehen. Zudem sind dann -soweit eine XML-Config Datei für das Gerät existiert- die speziellen set/get-Kommandos configXYZ für das Geräte im Auswahldialog der Detailansicht mit Hilfsinformationen verfügbar:
[[Datei:Z-Wave_confighelp.PNG|900px|thumb|center|config-Befehl mit Hilfstext]]

Bei vorhandener XML-Config-Datei kann die komplette Konfiguration eines Gerätes abgerufen werden:
get <name> configAll

Außerdem wird durch den <code>get <name> model</code> -Befehl geprüft, ob das Gerät in der [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] und/oder [http://products.zwavealliance.com/ products.zwavealliance.com] enthalten ist. Im Erfolgsfall wird ein Link "Details in pepper DB" und/oder "Details in alliance DB" zum entsprechenden Geräteeintrag in der jeweiligen Datenbank unten in der Detailansicht des FHEM-Geräte-Devices angelegt und ein Bild des Gerätes in die Detailansicht eingebunden.

Der Aufruf von <code>get <name> model</code> ist auch für die Nutzung der Class MANUFACTURER_PROPRIETARY zwingende Einsatzvoraussetzung.

=== Entfernen eines Z-Wave-Geräts / Exklusion ===
Durch die Exklusion wird die Home-ID und Node-ID aus dem Gerät und das Gerät selbst aus der Node-List des Controllers gelöscht. Erst nach einer Exklusion kann das Gerät in ein anderes Z-Wave-Netz aufgenommen werden.

Zuerst wird der Z-Wave Gateway in den Standard-Modus zur Exklusion (Ausschluss) von Geräten gesetzt:
set <ZWDongle> removeNode on

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt dem obigen Befehl besser der Network-Wide-Modus für die Exklusion genutzt werden (siehe auch Erläuterungen zu Standard- versus Network-Wide-Inklusion unter [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]]):
set <ZWDongle> removeNode onNw

Danach muss das Gerät in den Exklusionsmodus (Ausschlussmodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen.

Abschließend wird der Exklusionsmodus am Z-Wave Gateway wieder ausgeschaltet:
set <ZWDongle> removeNode off

Das FHEM-Device muss nach der Exklusion manuell durch <code>delete <name></code> gelöscht werden.

Die durch die Exklusion frei gewordene NodeID wird nicht bei der nächsten Inklusion wiederverwendet, sondern es wird die höchste noch nicht verwendete NodeID genutzt.

=== Erneutes Hinzufügen eines bereits registrierten Z-Wave Geräts ===
Die an einem Z-Wave-Gateway bereits registrierten/inkludierten Geräte sind im Gateway selbst abgespeichert und können durch FHEM jederzeit wieder abgerufen werden. Dies kann man in folgenden Fällen sinnvoll nutzen:
* Inklusion mit einem batteriegespeisten ZWave-Gateway (bspw. Aeon Labs Z-Stick) ohne FHEM-Server-Anschluss während der Inklusion
* Umstieg eines ZWave-Netzwerkes von Fremdsoftware auf FHEM
* Vollständiger oder teilweiser Verlust der FHEM-Konfiguration

Eine Node-Liste aller inkludierten Geräte des Gateways wird abgerufen durch:
get <ZWDongle> nodeList
Es wird eine Liste aller im Gateway inkludierten Gerät inklusive Gateway selbst zurückgeliefert. Sofern ein Gerät bereits als FHEM-Device angelegt wurde, wird der FHEM-Device-Name in der nodeList angezeigt. Dies ist für das Gateway selbst immer der Fall. Alle noch nicht in FHEM angelegten Geräte, werden als "UNKNOWN_x" ausgegeben, wobei x die ID des betreffenden Gerätes ist.

Mit dem folgenden Befehl wird beispielsweise das bereits im Gateway inkludierte Gerät mit der ID 2 (in der nodeList angezeigt als "UNKNOWN_2") in FHEM durch autocreate definiert:
set <ZWDongle> createNode 2

Batteriebetriebene Geräte müssen bei Absetzen des <code>createNode</code>-Befehls wach sein, damit der Befehl verarbeitet werden kann. Dies erreicht man, indem man das Gerät auf "permanent wach" stellt. Falls das Gerät diese Funktion nicht anbietet, muss man es manuell aufwecken und max. 2 Sekunden später den <code>createNode</code>-Befehl absetzen. Alternativ kann das batteriebetriebene Gerät durch Versand des NIF vom Gerät aus automatisch in FHEM erzeugt werden: Hierzu am Gerät die Taste zum Versand des NIF drücken und <code>autocreate</code> legt das FHEM-Device an; der Aufruf von <code>createNode</code> entfällt dann.

== Geräte-Besonderheiten ==
=== batteriebetriebene Geräte ===
Batteriebetriebenen Geräten können hinsichtlich ihrer Empfangsbereitschaft unterschieden werden in

* Wakeup-Geräte
* FLIRS-Geräte

==== Wakeup-Geräte ====
Wakeup-Geräte sind momentan die häufigste Art von batteriebetriebenen Z-Wave Geräten. Sie sind erkennbar an der Unterstützung der Command Class WAKE_UP.
Zur Verlängerung der Batterielaufzeit legen sich batteriebetriebene Wakeup-Geräte „schlafen“ und wachen (Wakeup) nur in konfigurierbaren Intervallen auf, um Befehle zu verarbeiten. Das Aufwachen signalisieren die Geräte durch den Versand einer Nachricht "wakeup notification". Daraufhin senden FHEM und andere Geräte ihre bis dahin gesammelten Befehle, die dann verarbeitet bzw. beantwortet werden. Anschließend gehen die batteriebetriebenen Geräte wieder in den Schlafmodus.

FHEM teilt bei set/get-Befehlen an batteriebetriebene Geräte über einen Hinweis der Form
:<code>Scheduled for sending after WAKEUP</code>
::oder
:<code>Scheduled get requests for sending after WAKEUP</code>
mit, dass der Befehl im Sendstack des FHEM-Geräte-Devices abgespeichert wurde und bei der nächsten "wakeup notification" an das Gerät versendet wird. Ein Versand der Befehle im Sendstack findet grundsätzlich ausschließlich nach Erhalt der "wakeup notification"-Nachricht statt, selbst wenn das Gerät zwischendurch andere Telegramme (bspw. Bewegungsmeldung, Temperatur) an den Controller verschickt. Nur nach Versand der "wakeup notification" ist das batteriebetriebene Gerät grundsätzlich in der Lage ("wach genug"), Telegramme korrekt zu empfangen und zu verarbeiten.

Wie viele Nachrichten im Sendstack auf einen Versand an das Gerät warten, ist im Internal <code>cmdsPending</code> des zugehörigen FHEM-Devices ersichtlich. Welche Nachrichten (Befehle) im Sendstack warten, ist in der Ausgabe des Befehls <code>[[list]] <device></code> erkennbar: Unter der Überschrift Sendstack sind alle wartenden Nachrichten als Rohnachrichten aufgeführt. Der Sendstack wird beim Beenden von FHEM nicht gespeichert. Durch Beenden von FHEM (beispielsweise durch <code>shutdown restart</code>) geht der Sendstack der Geräte daher verloren.

Das Wakeup-Interval und der Empfänger der "wakeup notification" wird wie folgt konfiguriert:
<nowiki>set <name> wakeupInterval <time> <NodeId></nowiki>
<nowiki><time></nowiki> ist die Zeit in Sekunden zwischen den Intervallen und <nodeID> der gewünschte Empfänger der "wakeup notification"; in der Regel ist dies '''immer''' der Controller <CtrlNodeId>. Viele Geräte kommen im Auslieferungszustand mit der NodeID 255. Die "wakeup notification" wird dann als Broadcast ohne Nutzung von Routing an alle erreichbaren Geräte gesendet. Hier sollte die Konfiguration auf die NodeID des Controllers geändert werden, da dadurch die "wakeup notification" geroutet wird und größere Entfernungen zwischen Gerät und Controller möglich sind. Zudem ist dies robuster und spart zusätzlich noch Batterielaufzeit. Darum setzt FHEM bei der Inklusion von WakeUp-Geräten '''automatisch''' den Befehl <code><nowiki>set <name> wakeupInterval 86400 <ControllerNodeId></nowiki></code> ab. Bei abweichenden eigenen Vorstellungen ist dies gegebenenfalls anzupassen. Bei Geräten mit V2 der Command Class WAKE_UP kann das vom Hersteller vorgesehene Standard-wakeupInterval mit <code><nowiki>get <name> wakeupIntervalCapabilities</nowiki></code> vom Gerät abgerufen werden. Die Einstellungen von wakeupInterval nach Inklusion und nach jeder Änderung immer mit der Abfrage <code><nowiki>get <name> wakeupInterval</nowiki></code> überprüfen.

Ein Aufwachen und Versand der "wakeup notification" von batteriebetriebenen Geräten kann für die [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] manuell erzwungen werden. Hierzu bringt man das Gerät normalerweise in den Inklusionsmodus oder findet in der Bedienungsanleitung gegebenenfalls andere Informationen. Bitte beachten, dass dann je nach Gerät nur eine geringe Entfernung von Gateway und Gerät vorhanden sein darf (direkte Erreichbarkeit). Alternativ kann für die Dauer der Assoziation und Konfiguration das Wakeup-Interval verkürzt werden (beispielsweise auf 60 Sekunden), wodurch das Routing genutzt werden kann und größere Entfernungen zwischen Gateway und Gerät überbrückt werden können. Anschließend das Wakeup-Interval wieder auf eine batterieschonenende Dauer einzustellen.

Einzelne batteriebetriebene Gerät lassen sich für längere Zeit auf "wach" bzw. permanent "wach" stellen. Dann aus dem Attribut <code>classes</code> <code>WAKE_UP</code> entfernen, damit Befehle in diesem Gerätemodus von FHEM direkt verschickt werden. Nach Ausschalten des "wach"-Modus <code>WAKE_UP</code> wieder im Attribut <code>classes</code> aufnehmen.

Bei Konfigurationsänderungen an batteriebetriebenen Geräten mit <code>set <name> config...</code> sollte die korrekte Verarbeitung der Befehle immer mit dem entsprechenden <code>get <name> config...</code> oder -falls vorhanden- mit <code>get <name> configAll</code> überprüft werden, um eventuelle Funk-Telegrammverluste sofort festzustellen.

==== FLIRS-Geräte ====
Ein batteriebetriebene FLIRS (frequently listening routing slave) Gerät wacht in sehr kurzen Zeitabständen (250ms oder 1000ms) auf und prüft, ob ein Funksignal vorliegt. Liegt kein Funksignal vor geht das Gerät wieder in Tiefschlaf. Zum Aufwecken eines FLIRS-Gerätes ist ein dauerhaftes Funksignal -der Wakeup-Beam-, notwendig, das etwas länger als die Aufweckzeitabstände sein muss. Näher beschrieben unter anderem [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF hier].

FLIRS-Geräte haben nicht die Command Class WAKE_UP und arbeiten deshalb nicht mit "wakeup notification". Aus Sicht des FHEM-Nutzers sind die bekannten FLIRS-Geräte (Sirenen von Vision und Popp) nicht anders zu bedienen/einzurichten als netzgespeiste Geräte. Wakeup-Beam und andere Besonderheiten werden unsichtbar für den Nutzer automatisch abgewickelt.

=== Aeon Labs / Aeotec ===
Ausführliche Handbücher und technische Informationen auf https://aeotec.freshdesk.com/support/home

==== Multi Sensor 5 ====
* aktuellste Firmware installieren
* Attribut <code>classes</code> um <code>BASIC</code> ergänzen (ab [[version|Modulversion]] 8824/25.6.2015 wird das automatisch bei der Inklusion durchgeführt)
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* Parameter 101 auf 225 (oder 224 bei USB-Anschluss) setzen mit <code>set <name> configGroup1Reports 225</code> oder <code>set <name> configLong 101 225</code>, um Batteriezustand (nicht bei 224), Temperatur, Feuchte und Helligkeit regelmäßig zu erhalten. Das Sende-Intervall wird duch <code><nowiki>set <name> configGroup1Interval <time/s></nowiki></code> festgelegt (Standard 720 Sek).
* [http://devel.pepper1.net/zwavedb/device/407 Paramterübersicht pepper-Datenbank]
siehe {{Link2Forum|Topic=34505|Message=268913}}

==== Multisensor 6 ====
siehe {{Link2Forum|Topic=40393}}
* arbeitet bei USB-Anschluß als Router
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* die <code>configGroupxInterval</code> und <code>configxxxReportingThreshold</code> Einstellungen wirken nur bei USB-Anschluss, im reinen Batteriebetrieb werden die Sensordaten nur bei einem <code>wakeup</code> übertragen

==== Aeotec LED Bulb ZW098-C55 ====
siehe {{Link2Forum|Topic=40504}}

=== Danfoss ===
==== DAN_LC-13 Heizungsthermostat LC-13 (014G0013) ====
Das Danfoss Heizungsthermostat LC-13 muss derzeit zur korrekten Funktion mit FHEM regelmäßig mit folgendem <code>at</code> abgefragt werden ({{Link2Forum|Topic=32145|Message=260795}}):
define Atdanfoss at +*00:30 get <name> battery
Auf dem Markt sind mehrere Varianten des Thermostates LC-13 erhältlich. Darum beim Kauf unbedingt auf die genaue Bezeichnung LC-13 (014G0013) achten ({{Link2Forum|Topic=38041|Message=303146}}).

=== devolo ===
Ausführliche Handbücher auf http://products.z-wavealliance.org

==== MT02648 Tür-/Fenster Kontakt 3in1 ====
siehe {{Link2Forum|Topic=41337}}

=== DüWI ===
Geräte von DÜWI liefern bei örtlicher Betätigung kein automatisches Funk-Signal über die Statusänderung. Das liese sich nur durch eine regelmäßige Statusabfrage durch FHEM (beispielsweise <code>define Status_Abfrage at +*00:03:00 get <name> swmStatus</code>) beheben.
Einige Produkte von [http://zwave.me Z-Wave.Me] basieren auf DÜWI-Geräten. Diese Z-Wave.Me Produkte haben jedoch eine erweiterte Firmware, welche die genannte und weitere Firmware-Schwächen der Original-Produkte von DÜWI behebt.

=== Everspring ===
==== AN145 Sockelmodul E27 ====
Statusabfrage ohne permanente Abfrage: {{Link2Forum|Topic=48864|Message=405545|Beitrag}}

=== Fibaro ===
Association Group für Übermittlung von Statusinformationen an den Controller:
* "alte" ZWave-Geräte (kein ZWave-Plus): häufig Association Group 3
: <code><nowiki>set <name> associationAdd 3 <CtrlNodeId></nowiki></code>
: Bei diesen Geräten empfiehlt es sich zur Funklastreduzierung und Problemminimierung zu prüfen, ob die von FHEM automatisch vorgenommene Assoziation des Controllers mit der Association Group 1 gelöscht werden kann (<code><nowiki>set <name> associationDel 1 <CtrlNodeId></nowiki></code>). Nahezu immer werden in Association Group 1 die gleichen Infos, nur mit einer anderen Command Class, wie in der Association Group 3 an den Controller übermittelt.
* ZWave Plus-Geräte: Association Group 1 ("lifeline")

==== FGSS-001 / FGSD-002 Rauchmelder ====
* nicht untereinander vernetzbar
* keine Alarmauslösung/Sirenenfunktion durch ZWave-Zentralen

==== FGS-222 Relais Unterputzeinsatz ====
Bei der Inklusion werden von FHEM 3 Devices angelegt:
* Hauptdevice (Steuerung und automatischer Status für Kanal 1 und kanalübergreifende Funktionen)
* Device für Endpoint 1 (Steuerung Kanal 1)
* Device für Endpoint 2 (Steuerung und automatischer Status von Kanal 2)
Die Firmware des FGS-222 übermittelt den Status für Kanal 1 automatisch immer ausschließlich an das Hauptdevice. Die Steuerung von Kanal 1 kann hingegen sowohl über das Hauptdevice als auch über das Device für Endpoint 1 erfolgen. Das Device für Endpoint 1 ist somit nicht zwingend erforderlich und kann grundsätzlich gelöscht oder in den room hidden verschoben werden.

Details: {{Link2Forum|Topic=50176}}

Hinweis zum Reset: {{Link2Forum|Topic=55190|Message=469393}}

==== FGK-101 Tür/Fensterkontakt ====
* Besonderheiten bei Anschluss eines Temperatursensors: {{Link2Forum|Topic=38012}}

=== GE ===
==== GE (Model t.b.d) ====
Dieser Schalter unterstützt keine Statusrückmeldungen.

=== Merten ===
Laut {{Link2Forum|Topic=38133}} müssen bei einigen Merten-Geräten, die mit Fremdsoftware inkludiert wurden, gegebenenfalls die Geräte wieder exkludiert und dann erneut mit FHEM inkludiert werden, damit Assoziationen mit FHEM gesetzt werden können.

=== Philio ===
==== PHI_PAN04 Relais Unterputzeinsatz 2 Schalter a 1.5kW mit Messfunktion ====
siehe {{Link2Forum|Topic=28046}}

=== Popp ===
==== POPE004001 Z-Wave Rauchmelder mit Innensirene ====
siehe {{Link2Forum|Topic=39856}}
==== POPE005107 Z-Wave Außensirene ====
siehe {{Link2Forum|Topic=42736}}<br>
Alte Firmwareversionen haben einen Bug bei der Übermittlung von negativen Temperaturen. Eine Lösungsvariante über ein <code>userReadings</code> findet sich auch im verlinkten Thema.
==== POPE009006 Z-Wave Wall Plug Switch ====
siehe {{Link2Forum|Topic=40771}}
==== POPE009402 10Year Smoke Detector ====
Die erste Firmwareversion hat eine fehlerhafte modelID. Diese Rauchmelder wird dadurch fälschlich als [[Z-Wave#POPE005107_Z-Wave_Au.C3.9Fensirene|Popp Aussensirene]] in FHEM angezeigt. Neuere Geräte werden laut Popp mit der korrekten modelID ausgeliefert.

=== Z-Wave.Me ===
==== ZME_RC2 Fernbedienung ====
siehe {{Link2Forum|Topic=35513}}<BR>
Das Forenthema enthält eine detaillierte Beschreibung der Nutzung der Class MULTI_CHANNEL_ASSOCIATION.

== Geräte-Vergleich ==
=== Doppel-Relais ===
{| class="wikitable"
|-
! Eigenschaft !! FIBARO Double Switch 2-FGS-223 !! Qubino Flush 2 relays !! Philio-PAN04 1
|-
| Funktion || Doppel-Relais || Doppel-Relais || Doppel-Relais
|-
| Standby-Leistung || ca. 0.4W || ca. 0.4W || ca. 0.5W
|-
| Reaktion beim Schalten am Tastereingang || schnell, kaum merkliche Verzögerung || schnell, kaum merkliche Verzögerung || langsam, unangenehm langes drücken des Tasters nötig >1 Sekunde
|-
| Geräte in FHEM || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 4 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 <br> x.03 Summengerät (ähnlich Hauptgerät, überflüssig)
|-
| Zustand Hauptgerät || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais
|-
| Statuswechsel Report vom Gerät zum FHEM || ca. 1 Sekunde || ca. 3 Sekunden || ca. 3-4 Sekunden
|-
| Empfänger des Status Reports || Hauptgerät und Untergeräte || Hauptgerät und Untergeräte || Nur Hauptgerät <br>Aktualisierung der Untergeräte nur bei aktiver Abfrage
|-
| Leistungsmessung || Separat für Untergeräte || Separat für Untergeräte || Nur Summe
|-
| Sicherung nötig / Strom || ja, 2x 6.5A, Summe max 10A || ja, max 2x 4A || nein, 2x 6.5A
|}
Beim Qubino Flush 2 relays muss eine MULTI_CHANNEL_ASSOCIATION mit dem Controller (Endpoint root) statt einer "normalen" Assoziation gesetzt werden, damit die Status der Untergeräte einzeln signalisert werden:

set associationDel 1 <controllerNodeId>
set <device> mcaAdd 1 0 <controllerNodeId> 0

Bei einem FHEM-Updatestand ab 20.09.2019 erfolgt diese Einstellung automatisch.

== Links ==
=== Allgemein ===
* Grundlageninformation "Z-Wave-Haupt-Anleitung": [http://www.zwave.de/z-wave-funknetz-einrichten-und-betreiben/ Wie errichte und betreibe ich ein Z-Wave basiertes Funknetz]{{Randnotiz|Links teilweise nicht mehr aktuell|RNText=zwave.de existiert nicht mehr. Es erfolgt ein Forward auf zwave.eu/de. Die hier angegebenen Links darauf werden aber nicht abgebildet und liefern einen 404. Ich ([[Benutzer Diskussion:AlanBlack]]) suche noch nach den korrekten Seiten.|RNTyp=Fehl}}
* [http://www.zwave.de/buch-z-wave-grundlagen/ Buch] "Z-Wave: Die Funktechnologie für das Smart Home" von Dr. Christian Paetz (Paetz "is the primary European representative for the Z-Wave Alliance" [http://z-wavealliance.org/global-contacts/])
* Z-Wave-Produktdatenbank mit Angabe zur Zertifizierung, Handbüchern und weiteren Detailinfos (Z-Wave oder [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus]): http://products.z-wavealliance.org (englisch)
* herstellerübergreifende Datenbank mit Bedienungsanleitungen zu Z-Wave-Geräten: http://www.zwave.de/handbuecher/ oder http://manuals.zwaveeurope.com (mehrsprachig)
* herstellerübergreifende Datenbank mit technischen Informationen zu Z-Wave-Geräten (Z-Wave Device Library): http://devel.pepper1.net/zwavedb/ (englisch; wird derzeit nicht mehr aktualisiert)
* informative Webseiten zu Z-Wave:
** http://www.z-wavealliance.org/ (englisch)
** http://www.zwaveeurope.com/ (englisch)
** http://www.zwave.de/ (deutsch)
** [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF Introductory Guide to Z-Wave-Technology von Honeywell] (englisch; nicht auf aktuellem Stand)

=== Informationsquellen zur Einbindung von Command Classes ===
Offizielle und ausführliche Informationen von Sigma Designs (veröffentlicht am 31.08.2016):
* [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification]

Weitere Informationen (seit Veröffentlichung der Z-Wave Spezifikationen am 31.08.2016 geringe Relevanz)
* [https://github.com/yepher/RaZBerry Infos zu Command Classes (ausführlich; insbesondere im Verzeichnis "docs"), RaZBerry und Z-Wave allgemein], englisch
* [http://220.135.186.178/zwave/example/ Übersicht von Command Classes und deren Rückgabewerten mit Unterscheidung der Class-Versionen], englisch
* Code von http://www.openzwave.org (https://github.com/OpenZWave/open-zwave) und http://www.openhab.org (Z-Wave binding: https://github.com/cdjackson/openhab)
* eine Java-API-Beschreibung mit Hinweisen zu Unterschieden von Class-Versionen: http://dz.prosyst.com/pdoc/mBS_SH_SDK_8.1/modules/zwave/api/driver/index.html

== FAQ ==
=== Welche Infos sollten Anfragen im ZWave-Forum enthalten? ===
* Anfragen bitte nur zur aktuellsten FHEM-Version: Befehl <code>update</code> ergibt Ausgabe "nothing to do..."
* detaillierte Beschreibung des Problems
* beteiligte Komponenten (genaue Bezeichnung und evtl. Link auf Hersteller-Dokumentation)
* list des jeweiligen FHEM-Devices (Ausgabe von <code>list <device></code>)
::Bitte vor Aufruf des list-Befehls -wenn vorhanden/möglich- folgende Befehle ausführen und Ergebnis abwarten:
::*<code>get <device> associationAll</code>
::*<code>get <device> configAll</code>
::*<code>get <device> versionClassAll</code>
::*<code>get <device> mcaAll</code>
::*<code>get <device> wakeupInterval</code> (nur bei batteriebetriebenen Geräten)
* passender Ausschnitt aus dem Logfile (siehe Link im FHEM-Menü links) generiert mit den gesetzten Attributen
::*<code>attr <ZWDongle> verbose 5</code> und
::*<code>attr global mseclog 1</code>

=== Welche Schritte sind für die Einbindung von ZWave-Geräten in FHEM mindestens durchzuführen? ===
Voraussetzung: ZWave-Gateway ist erfolgreich eingebunden!
# [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes
# [[#Assoziation|Assoziation]] der Assoziationsgruppe(n) des Gerätes mit dem Gateway
# [[#Konfiguration|Konfiguration]] des Gerätes

=== Warum bleibt der Status (STATE) des neu inkludierten Gerätes dauerhaft auf "associationAdd <associationGroup> <CtrlNodeId>" stehen? ===
FHEM setzt das Reading "state", das den STATE bestimmt, nicht bei allen ZWave-Devices mit vordefinierten Standardwerten. Daher bleibt der bei der Inklusion automatisch abgesetzte "associationAdd"-Befehl unter Umständen im STATE stehen, bis der Anwender den STATE über die Vergabe des Attributes <code>{{Link2CmdRef|Anker=stateFormat|Label=stateFormat}}</code> manuell an seine Bedürfnisse angepasst hat.
(weitergehende Info zum state/STATE/stateFormat: [[DevelopmentState]])

=== Wie können bei mehrkanaligen Aktoren die zusätzlichen Kanäle (>1) angesprochen werden? ===
* Bei der [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes wird das Hauptdevice mit dem Namen <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> und die Devices für alle Kanäle (Endpoints) nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID>.<EndpointNr></nowiki></code> automatisch angelegt. Jedes dieser FHEM-Devices spricht regelmäßig einen bestimmten Kanal des Gerätes an; einige Geräte sprechen mit dem Hauptdevice jedoch das gesamte Gerät mit allen Kanälen an (Bedienungsanleitung beachten).
* Manuell werden Devices für zusätzliche Kanäle mit Hilfe der Befehle <code>get <device> mcEndpoints</code> und <code>get <device> mcCapability <chid></code> aus der Class MULTI_CHANNEL ermittelt bzw. einzeln über autocreate angelegt (Details und Beispiel siehe {{Link2CmdRef|Anker=ZWaveget}}). Mit dem Befehl <code>set <device> mcCreateAll</code> werden automatisch alle Kanäle des Gerätes durch autocreate als eigene Devices in FHEM angelegt.

=== Wie kann man die SDK-Version eines Gerätes herausfinden? ===
Mit FHEM alleine kann eine [[#Grobermittlung|Grobermittlung]] der SDK-Version vorgenommen werden, die aber für einige Zwecke bereits ausreichend ist. Soll eine [[#Detailermittlung|Detailermittlung]] der genauen SDK-Version erfolgen, dann müssen die mit FHEM ermittelten Werte anhand externer Quellen übersetzt werden.
==== Grobermittlung ====
Der Befehl <code><nowiki>get <ZWDongle> nodeInfo <dezimale nodeId></nowiki></code> liefert das Reading <code><nowiki>nodeInfo_<dezimale nodeId></nowiki></code> zurück.
Die Angabe im Reading hinter <code>ProtocolVers:</code> lässt grobe Rückschlüsse zu. Mögliche (bekannte) Werte:
* <code>2</code> -> bspw. keine Explorer Frames, keine SUC-Unterstützung (veraltet, keine bekannten Geräte mehr im Handel)
* <code>SDK5.0x+4.2x</code> -> bspw. keine Explorer Frames, teilweise SUC-Unterstützung
* <code>SDK4.5x+6.0x</code> -> bspw. Explorer Frames- und SUC-Unterstützung (Reading-Wert wird auch bei SDK 6.5x = Z-Wave Plus angezeigt)
==== Detailermittlung ====
Durch den Befehl <code><nowiki>get <name> version</nowiki></code> kann man die ZWave-Protokoll-Version von Geräten und Controller abfragen. Mit Unterstützung von Übersetzungstabellen
* http://wiki.micasaverde.com/index.php/ZWave_Protocol_Version
* Suche nach sdkids.xml in einer Suchmaschine
kann aus der Protokoll-Version das genutzte SDK festgestellt werden.

Beispielsweis entspricht das Reading eines Gerätes "Lib 6 '''Prot 2.64''' App 1.6" dem SDK 5.02 Patch 2 oder eines Controller "Z-Wave '''3.41''' STATIC_CONTROLLER" dem SDK 6.02.00.

HINWEIS: Bei der Vergabe der Protokoll-Version und zugehörigem SDK gibt es keine erkennbare Logik: Eine höhere Protokoll-Version steht nicht notwendig für eine höheres SDK.

=== Wie kann eine verschlüsselte Kommunikation unter Nutzung der Command Class SECURITY eingerichtet werden? ===
{{Randnotiz|RNText=FHEM unterstützt derzeit ausschließlich SECURITY 1 und nicht das mit dem SDK 6.7 neu eingeführte SECURITY 2 (S2). Soweit bekannt, sind S2-Geräte rückwärtskompatibel zu SECURITY 1.}}
Die verschlüsselte Kommunikation zwischen Controller und Endgerät setzt eine secure-Inklusion voraus. Bereits mit der Inklusion wird entschieden, ob die Kommunikation von Controller und Endgerät dauerhaft verschlüsselt oder unverschlüsselt erfolgt. Ist ein Gerät bereits normal inkludiert und entscheidet man sich nachträglich für eine verschlüsselte Kommunikation, so ist das nur möglich, indem das Gerät exkludiert und dann wieder secure inkludiert wird.

Ob die Verschlüsselung bei einem Gerät mit Unterstützung der Command Class SECURITY genutzt werden soll, sollte genau überlegt werden. Die Verschlüsselung führt zu einem deutlich größeren Funkverkehr zur Ausführung eines Befehls und teilweise auch zu spürbaren Latenzen.

Vorarbeiten:
* Das Perl-Modul Crypt-Rijndael muss installiert sein.
* Das Attribut <code>networkKey</code> muss mit einem 32-Zeichen langen Hexzahl beim ZWDongle angelegt werden. Dieser Schlüssel sollte nicht veröffentlicht werden und auch zusätzlich separat (bspw. auf Papier) festgehalten werden. Bei Verlust des Attributes und Schlüssels ist eine Kommunikation nur nach erneuter Inklusion möglich.

Ablauf der secure-Inklusion:
* Controller in den Modus zur secure-Inklusion schalten:
: <code>set <ZWDongle> addNode onSec</code> für die Standard-secure-Inklusion
: oder alternativ
: <code>set <ZWDongle> addNode onNwSec</code> für die Nework-Wide-secure-Inklusion
* Gerät gemäß Handbuch in den Modus zur secure-Inklusion bringen (teilweise ist jeweils für secure- und normale Inklusion ein anderes Vorgehen notwendig!)
* Das Gerät sollte jetzt automatisch erkannt und das FHEM-Device durch <code>autocreate</code> angelegt werden. Die secure-inkludierten Geräte haben ein zusätzliches Attribut <code>secure_classes</code> in dem die Command Classes deren Kommunikation verschlüsselt abläuft aufgelistet sind. Nicht in diesem Attribut, aber in <code>classes</code> aufgeführte Command Classes wickeln die Kommunikation weiterhin unverschlüsslt ab.
* Inklusionsmodus des Controllers ausschalten:
: <code>set <ZWDongle> addnode off</code>
* Das Vorgehen in FHEM unterscheidet sich von nun an nicht von normal (unverschlüsselt) inkludierten Geräten. Die Verschlüsselung läuft für den Anwender transparent ab. Darum anschließend [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] vornehmen.

=== Wie kann man ohne Exklusion Nodes des Controllers löschen? ===
HINWEIS: Geräte sollten grundsätzlich immer über eine Exklusion aus der Nodelist des Controllers gelöscht werden. Das nachfolgend geschilderte Vorgehen ist nur in Sonderfällen (bspw. Gerätedefekt, gebraucht gekauftes Gateway) anzuwenden.

Nicht mehr zu erreichende/reagierende Nodes (Geräte) können manuell mit dem Befehl <code>removeFailedNode</code> gelöscht werden. Dazu muss sich der betroffene Node auf der FailedNodeList des Controllers befinden. Auf die FailedNodeList kommen netzbetriebene Geräte automatisch, wenn sie vom Controller nicht mehr per Funk erreicht werden. Batteriebetriebene Geräte müssen manuell auf die FailedNodelist gesetzt werden, da der Controller nicht feststellen kann, ob sie nur langfristig "schlafen".

Der Befehl <code>removeFailedNode</code> löscht nur Nodes auf der FailedNodeList, die erst vor Kurzem nicht erreicht werden konnten. Darum muss sowohl das manuelle Verschieben von batteriebetriebenen als auch das Nicht-Erreichen der netzbetriebenen Geräte erst Kurz vor Aufruf des <code>removeFailedNode</code>-Befehls erfolgt sein.

Vorgehensweise für den Node <NodeId>:
# An den betroffenen Node eine Telegramm mit <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> verschicken, um ihn auf FailedNodeList zu verschieben bzw. Zeitstempel zu aktualisieren.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und kann mit <code>removeFailedNode</code> gelöscht werden.
# Befehl zum Löschen des Nodes absetzen: <code><nowiki>set <ZWDongle> removeFailedNode <NodeId></nowiki></code>. Der Befehl testet vor dem Löschen noch einmal, dass der Node nicht erreicht werden kann und entfernt erst dann den Node.
# Prüfen, der Ergebnisse des <code>removeFailedNode</code>-Befehls im Log oder [[Event monitor]]. Die verschiedenen Ergebnisse werden durch die in der {{Link2CmdRef}} dokumentierten Events signalisiert. Tritt das Ergebnis "failedNodeRemoveProcessBusy" mehrfach hintereinander auf, muss das ZWDongle kurz stromlos gemacht werden.
# Prüfen, ob der Node nicht mehr auf der Nodelist des Controllers ist: <code><nowiki>get <ZWDongle> nodeList</nowiki></code>

siehe auch {{Link2Forum|Topic=32823|Message=292626}}

=== Wie ist der einfachste Weg ein (defektes) Gerät durch ein gleiches Ersatzgerät auszutauschen? ===
Tauscht man ein defektes Gerät durch ein gleiches Ersatzgerät und inkludiert das Ersatzgerät per <code>addNode</code>, so erhält das Ersatzgerät eine neue NodeId. Soll das Ersatzgerät die gleiche NodeId wie das alte Gerät erhalten, so muss statt <code>addNode</code> der Befehl <code>replaceFailedNode</code> zur Inklusion des Ersatzgerätes (=gleiches Modell) verwendet werden.

Vorgehensweise für den Node <NodeId>:
# sofern das alte Gerät noch ansprechbar ist, die Konfiguration und Assoziationen abfragen, damit man die Werte im Ersatzgerät einfach wieder setzen kann:
## <code><nowiki>get <device> configAll</nowiki></code>
## <code><nowiki>get <device> associationAll</nowiki></code>
# defektes Gerät aus- und neues einbauen
# Befehl <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> absetzen, damit das Dongle die NodeId auf die FailedNodeList setzt.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und das Ersatzgerät kann mit <code>replaceFailedNode</code> inkludiert werden.
# <code><nowiki>set <zwdongle> replaceFailedNode <NodeId></nowiki></code> für die NodeId des defekten Gerätes aufrufen und das Ersatzgerät in den Inklusionsmodus bringen
# Korrekte Inklusion prüfen und beim alten Aktor ausgelesene Werte beim neuen Aktor wieder setzen.

=== Bei einer Inklusion wird eine durch Exklusion/removeFailedNode frei gewordenen NodeId nicht mehr vergeben. Ist das korrekt? ===
Ja, das ist richtig.

Bei der Inklusion über addNode vergibt der Controller die höchste bisher noch nie verwendete NodeID. Durch Exklusion oder removeFailedNode frei gewordene NodeIDs werden hierbei zunächst nicht erneut vergeben. Diese frei gewordenen NodeIds werden bei Inklusionen in aufsteigender Reihenfolge erst wieder vergeben, nachdem die höchste verfügbare NodeId (232?) inkludiert wurde. Sie sind somit grundsätzlich nicht verloren.

=== Welche Funktion haben die XML-Config-Dateien in FHEM? ===
In den XML-Config-Dateien sind Informationen zu einzelnen ZWave-Geräten enthalten, die der Erleichterung der Gerätenutzung und -einbindung in FHEM dienen. Dies sind unter anderem Erläuterungen zu den Parameternummer/-werten, Assoziationsgruppen und Besonderheiten eines Gerätes. Ob eine zum Zwave-Gerät passende XML-Config Datei existiert, wird im Rahmen der Inklusion oder durch manuellen Aufruf des Befehls <code>get <name> model</code> ermittelt. Wird eine passende XML-Config-Datei gefunden, wird sie automatisch in FHEM eingebunden. Das Reading <code>modelConfig</code> enthält dann den zugehörigen XML-Config-Dateinamen. Stehen keine XML-Config-Informationen bereit, enthält das Reading <code>modelConfig</code> den Wert "unknown". Die Funktionsfähigkeit von FHEM mit ZWave-Geräten ist auch bei fehlender XML-Config-Datei gegeben. Es gibt dadurch keine funktionalen Einschränkungen in FHEM; es entfallen "nur" Erleichterungen und es sind unter Umständen mehr manuelle Schritte bei der Gerätenutzung/-einbindung notwendig.

Erleichterungen bei vorhandener XML-Config für ein ZWave-Gerät:
* Bei der Inklusion:
** Assoziationen mit dem Controller bei von Gruppe 1 abweichenender Assoziationsgruppe werden automatisch gesetzt
** vom NIF nicht gemeldete, aber vom Gerät unterstützte Classes, werden im Attribut <code>classes</code> ergänzt
* Bei der Konfiguration:
** die Parameternummern stehen als configXY-Befehle zur Verfügung und werden mit Hilfetexten -auch zu den Parameterwerten- in der Detailansicht des FHEM-Device erläutert.

HINWEIS: Bitte auch bei vorhandener XML-Config-Datei nach der Inklusion und bei der Konfiguration die Assoziationen und Parameter prüfen. Von den eigenen Vorstellungen abweichende Vorgaben oder gar Fehler in der Config-Datei können nie ausgeschlossen werden. Fehler bitte im Forum ({{Link2Forum|Area=ZWave}}) melden.

=== Wie können fehlende XML-Config-Informationen für mein ZWave-Gerät in FHEM eingebunden werden? ===
Die XML-Config-Informationen von FHEM sind in folgenden Dateien im Ordner fhem/FHEM/lib gespeichert:
* openzwave_manufacturer_specific.xml
* openzwave_deviceconfig.xml.gz
* fhem_zwave_deviceconfig.xml.gz
Die in den Dateien enthaltenen Informationen beruhen in großen Teilen auf Daten von openzwave und übernehmen daher das openzwave-Datenformat, das unter https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices näher beschrieben wird.

Die Datei "openzwave_manufacturer_specific.xml" enthält die eindeutige Kennung des ZWave-Gerätes, die in FHEM nach Aufruf des Befehls <code>get <name> model</code> im Reading <code>modelId</code> des FHEM-ZWave-Devices steht. Weiterhin wird der Klartextname dieses Gerätes, der im Reading <code>model</code> angezeigt werden soll, festgelegt. Zudem wird der Dateiname der eigentlichen XML-Config-Datei für das ZWave-Gerät angegeben, der später informativ im Reading <code>modelConfig</code> steht.

Die Dateien "openzwave_deviceconfig.xml.gz" und "fhem_zwave_deviceconfig.xml.gz" enthalten in komprimierter Form die eigentlichen XML-Config-Dateien für die ZWave-Geräte. FHEM durchsucht beide Dateien nach der passenden XML-Config-Datei. Ist in beiden Dateien eine XML-Config für ein Gerät vorhanden, so werden die XML-Daten aus der "fhem_zwave_deviceconfig.xml.gz" bevorzugt.

Falls ein ZWave-Gerät von FHEM nicht erkannt wird, bitte auf folgenden Seiten nachschauen, ob es schon XML-Config-Dateien gibt, die nur nicht in FHEM eingebunden sind:
# https://github.com/OpenZWave/open-zwave/tree/master/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# https://github.com/jeedom/plugin-openzwave/tree/beta/resources/openzwaved/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# http://www.cd-jackson.com/index.php/zwave/zwave-device-database
Sofern auf den genannten Seiten Daten vorhanden sind, postet eine Aktualisierungsbitte mit genauem Link zur entsprechenden Seite im Forum ({{Link2Forum|Area=ZWave}}).

Gibt es auf keiner der Seiten Infos zu dem Gerät, dann entsprechend https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices die XML-Config-Datei für das Gerät erstellen und unkomprimiert zusammen mit der zu ergänzenden Info für die Datei "openzwave_manufacturer_specific.xml" im Forum ({{Link2Forum|Area=ZWave}}) zur Verfügung stellen.

=== Wie führt man eine Komplett-Sicherung der ZWave-Installation durch? ===
Zu einer Komplett-Sicherung der ZWave-Konfiguration gehören:

1. [[Backup]] der FHEM-Installation
::'''und'''
2. Backup des NVRAM des Controllers

Es genügt nicht nur die FHEM-Installation/Konfiguration zu sichern, da der Controller im NVRAM Daten über HomeID, NodeIDs usw. speichert, die in der FHEM-Installation nicht enthalten sind und auch nicht durch FHEM rekonstruierbar sind.

zu 2.) Backup des NVRAM des Controllers

Einige Controllerhersteller bieten eine eigenständige Software zum Backup/Restore an (siehe Hinweise zu den Controllern unter [[#Autocreate_des_Gateways]]).

FHEM kann mit den ZWDongle-Befehlen <code>backupCreate</code> das NVRAM der Controller sichern und mit <code>backupRestore</code> zurückschreiben. Da das Speicherlayout des NVRAM unter anderem von Controller-Hersteller, SDK und Firmwareversion abhängig sein kann, sollte man die Sicherung und Wiederherstellung des eigenen Controllers (auf eigenes Risiko) testen und sinnvollerweise einen gleichen Ersatzcontroller wie den Controller des Produktivsystem besitzen. Erfolgreiche Sicherung/Wiederherstellung wurde im Forum von den ZWavePlus-Controllern UZB1 (256k), Razberry (256k), Vision ZU 1401-5 EU (128k)und AEOTEC Z-Stick Gen5 (256k) berichtet.
(Weitergehende Infos - neben der {{Link2CmdRef}} - im Forum: {{Link2Forum|Topic=52364}}, {{Link2Forum|Topic=52914}}, {{Link2Forum|Topic=53023}})

=== Wie kann ich zur Fortentwicklung der ZWave-Module beitragen? ===
* Erfolgreichen Einsatz von neuen/bisher nicht gemeldeten ZWave-Geräten im Forum mitteilen
* Codeschnipsel und Ideen im Forum posten
* Fehler und Probleme im Forum melden
* [[How_to_write_a_patch|Patches]] für 00_ZWDongle.pm und 10_ZWave.pm erstellen
* Wiki: Ergänzungen und Korrekturen vornehmen; neue Geräte ins Wiki aufnehmen; Codeschnipsel und Beispiele einpflegen

=== Wie wird ein fehlendes Kernelmodul (Fritzbox) eingebunden? ===
Auf der Fritzbox (und evtl. auch anderen Systemen) muss sichergestellt werden, dass das Kernelmodul für das Gateway geladen wird. Ansonsten scheitert die Einbindung des Gateways in FHEM.

Für den Aeon Labs Z-Stick muss beispielsweise auf der Fritzbox das Kernelmodul <code>cp2101.ko</code> geladen werden.
Diese Datei ist bei einer [[FHEM und FritzBox 7390]] Installation über das Image von [http://www.fhem.de fhem.de] bereits enthalten.
Um den Aeon Labs Z-Stick zu verwenden, muss dieses Kernelmodul vor oder beim Starten des FHEM-Servers geladen sein. Dies erreicht man durch einen Eintrag in der Datei <code>startfhem</code>.

Die entsprechende Zeile kann direkt unterhalb der modprobe Anweisungen eingefügt werden.
insmod $home/lib/cp2101.ko

Nach einem FHEM-Neustart sollte das Gateway (der USB Stick) nun erkannt werden.

=== Wie ist der Aufbau der Z-Wave Messages bzw. wie finde ich bei einem Sendefehler die NodeId des Empfängers heraus? ===

Es könnte natürlich hin und wieder vorkommen, dass man im FHEM-Log folgende Fehler vorfindet:

<code><nowiki>ZWDongle_ProcessSendStack: no ACK, resending message 010a00130603320110259277</nowiki></code>

In diesem Fall gab es aus irgendeinem Grund einmalig das Problem, dass der Empfang einer Nachricht vom Empfänger nicht bestätigt wurde.
Will man dem auf die Spur kommen, so wäre es natürlich von Vorteil, die NodeId des Empfängers herauszufinden. Also muss man sich die Message näher anschauen:

<code><nowiki>010a00130603320110259277</nowiki></code>
* 01: data to controller
* 0a: length of msg
* 00: ?
* 13: ZW_SEND_DATA
* 06: NodeId

* 03: length of msg
* 32: Command Class 32 (METER, siehe %zwave_class in 10_ZWave.pm)
* 01: METER get scale command
* 10: scale parameter

* 25: send flags, explorer frames on
* 92: callbackId (um ACK zu identifizieren)
* 77: checkSum

In diesem Fall hat der Z-Wave-Controller 01 eine Nachricht an die NodeId 06 geschickt, welche vom Node nicht bestätigt wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components|!]]
[[Kategorie:868MHz]]

Hauptseite

2024-04-24T09:08:01Z

Krikan:

<div><h1 style="font-family:sans-serif; font-size: 1.8em; border: none; text-align: center;">'''FHEM Wiki - Informationsportal zum FHEM SmartHome-Server'''</h1></div>

<div class="flexbox"> 
<div class="mainpagebox" style="order: 1; flex: 1 1 80%; background-color:#cce5ff;">
<div class="mw-collapsible mw-collapsed">
'''Was ist FHEM?'''
<div class="mw-collapsible-content">
'''FHEM''' ([https://register.dpma.de/DPMAregister/marke/register/3020152110040/DE R]) ist ein in Perl geschriebener, GPL v2 lizensierter Server für die Heimautomatisierung. Man kann mit FHEM häufig auftretende Aufgaben automatisieren, wie z.B. Lampen / Rollladen / Heizung / usw. schalten, oder Ereignisse wie Temperatur / Feuchtigkeit / Stromverbrauch protokollieren und visualisieren.

Das Programm läuft als Server, man kann es über WEB, dedizierte Smartphone Apps oder telnet bedienen, TCP Schnittstellen für JSON und XML existieren ebenfalls.

Um es zu verwenden, benötigt man einen 24/7 Rechner (NAS, RPi, PC, MacMini, etc) mit einem Perl Interpreter und angeschlossene Interfaces wie CUL-, EnOcean-, Z-Wave-USB-Stick etc. für einen Zugang zu den Aktoren und Sensoren.
</div></div></div>

<div class="mainpagebox" style="order: 4; background-color:#efefef;">
'''Wie fange ich an?'''
* [[Datei:Info_green.png|20px]][https://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM][[Datei:Info_green.png|20px]]<br />DAS Einsteiger-PDF. '''Pflichtlektüre!'''<br />
* [[Quick-Start]], english version: [[Quick-Start/en|Quick-Start]]
* kleiner FHEM-Kurs, benötigt keine Hardware: [[Erste Schritte in FHEM]] / [[First steps in FHEM]]
* [[Systemübersicht]]
* Phasen eines FHEM-Projekts:
** [[Planung]]
** [[Umsetzung]] (Implementierung)
** [[Betrieb]] ("Produktion")
* [[:Kategorie:Glossary|Glossar]] (Erklärung für bestimmte Begriffe)<br />
* [[:Kategorie:HOWTOS|Verschiedene HowTos]]<br />
* [[:Kategorie:FAQ|Frequently asked Questions - Häufig gestellte Fragen mit Antworten]]<br />

</div>

<div class="mainpagebox" style="order: 6; background-color:#fff0e0;">
'''Unterstützte Hardware (Auszug)'''

* [[:Kategorie:Hardware Typen|Hardware Typen]] - Funktionsbezogene Übersicht (z.B. [[:Kategorie:Unterhaltungselektronik|Unterhaltungselektronik / Multimedia]], [[:Kategorie:Heizungssteuerung|Heizungssteuerung]], [[:Kategorie:Energieverbrauchsmessung|Energieverbrauchsmessung]], etc.)
* [[:Kategorie:Server Hardware|Server Hardware]] - Hardware, auf der FHEM installiert werden kann
* [[:Kategorie:EMS Components|EMS]], [[:Kategorie:FHT Components|FHT]], [[:Kategorie:HMS Components|HMS]] Komponenten
* [[:Kategorie:1-Wire|1-Wire System]]
* [[:Kategorie:EIB/KNX|EIB/KNX Komponenten]]
* [[:Kategorie:FS20 Components|FS20 Komponenten]]
* [[:Kategorie:EnOcean Components|EnOcean Komponenten]]
* [[:Kategorie:HomeMatic Components|HomeMatic Komponenten]]
* [[:Kategorie:MAX|MAX! Komponenten]]
* [[:Kategorie:panStamp|panStamp Komponenten]]
* [[:Kategorie:Z-Wave Components|Z-Wave Komponenten]]
* [[:Kategorie:ZigBee|Zigbee Komponenten]]
* [[:Kategorie:IP Components|Geräte mit Webinterface ("IP")]]
* [[:Kategorie:Other Components|Andere Komponenten / Sonstige Systeme]]

<div align="right"><small>'''[[:Kategorie:Hardware|Alle Hardware-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 5; background-color:#F8F8FF;">
'''Ideen und Lösungen'''

* [[:Kategorie:Code_Snippets|Verschiedene kommentierte Lösungen und Code-Schnippsel]]
* [[:Kategorie:Examples|Beispielanwendungen - Hardwarelösungen - Fremdsystemanbindungen]]
* [[Anwendungsszenarien]]
* [[Trick der Woche|Tipp der Woche]]
* [[Wie kann ich...]]?

<div align="right"><small>'''[[:Kategorie:FHEM|FHEM-Haupt-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 7; background-color:#FFFFE7;">
'''Developers Corner'''

* Informationen zur Modul-Entwicklung:
** [[DevelopmentModuleIntro|Development Module Introduction]]
** [[Meta|Development Module and Package Meta Data]]
** [[DevelopmentModuleAPI|Development Module API]]
** [[DevelopmentFHEMWEB-API|Development FHEMWEB API]]
** [[Blocking Call]]
** [[CoProcess]]
** [[HttpUtils]]
** [[DevIo]]
** [[Guidelines zur Dokumentation]]
** [[DevelopmentGuidelinesAV|Development Guidelines AV-Module]]

* Organisatorisches:
** [[How to write a patch]]
** [[SVN Nutzungsregeln]]

<div align="right"><small>'''[[:Kategorie:Development|Alle Artikel zu Development]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 3; background-color:#d7ffff;">
'''FHEM Wiki News'''
<div style="height:20em;overflow:scroll;overflow-x:hidden;">{{FHEMWiki_News}}</div>
<div align="right"><small>'''Mehr [[FHEMWiki:News|News]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 2; background-color:#e7f8ff;">
'''Was ist FHEM Wiki?'''

Das '''FHEM Wiki''' ergänzt die stets tagesaktuelle, von den zuständigen Entwicklern gepflegte {{Link2CmdRef}} (Befehls-Referenz) um weitergehende Informationen rund um FHEM. Im Wiki arbeiten Nutzer und Entwickler gemeinsam an zusätzlicher Dokumentation von FHEM und damit zusammenhängenden Themen.

Das FHEMWiki stellt neben der {{Link2CmdRef}}, dem [http://forum.fhem.de/ Forum] und der [http://www.fhem.de FHEM] Seite die zentrale Informationsquelle rund um FHEM dar. Bedeutung und Zusammenspiel dieser Elemente [[Dokumentationsstruktur|ist hier]] erläutert.


Bitte [[FHEMWiki:Support | unterstütze uns]] und hilf, [[:Kategorie:NeedsEditing| das Wiki zu erweitern]]. Vielen Dank!

<div align="right"><small>'''Mehr [[FHEMWiki:Über_FHEMWiki|über FHEMWiki]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 8; background-color:#F8F8FF;">
'''Letzte Änderungen'''
<div style="font-size:small;color:black;"><small>{{Special:Recentchanges/8}}</small></div>
<div align="right"><small>'''Mehr [[Special:Recentchanges|Änderungen]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 9; flex: 1 1 80%; background-color:#FFFFAA;">
'''Die letzten fünf neuen Seiten'''
<small>{{Special:NewPages/5}}</small>
<div align="right"><small>'''Mehr [[Special:NewPages|Neue Seiten]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 10; background-color:#DDD68F;">
'''Administratives zum Wiki'''

''Allgemeine Aktivitäten:''
* Registrierung zur Mitarbeit: wende Dich bitte an einen [[FHEMWiki:Administratoren|Administrator]]
* Basiswissen über die Mitarbeit an einem Wiki erarbeiten ([http://de.wikipedia.org/wiki/Wikipedia:Beteiligen z.B. Wikipedia])
* Erweiterung und Korrektur von Artikeln, wo immer nötig
* Ein(ig)e der [[Spezial:Gewünschte Seiten|gewünschten Seiten]] erstellen
* Ideen aus dem [http://forum.fhem.de Forum] in bestehende oder neue Artikel einarbeiten
* [[Spezial:Verwaiste Seiten|verwaiste Seiten]] in sinnvoller Weise verlinken
* [[Spezial:Sackgassenseiten|Sackgassenseiten]] wikifizieren (Links auf andere Seiten einfügen)
* [[Datei:Info_red.png|20px]] '''Tips / Regeln / Hinweise auf "[[FHEMWiki:Über FHEMWiki|Über FHEMWiki]]" beachten!''' [[Datei:Info_red.png|20px]]

''Sonstiges:''
* Zum Ausprobieren bitte die [[FHEMWiki:Sandbox]] benutzen
* [//meta.wikimedia.org/wiki/Help:Contents Wiki Benutzerhandbuch].
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Liste der Wiki-Konfigurationsvariablen]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [[FHEMWiki:Interna|Internes zu diesem Wiki]]
</div>

</div>
[[Kategorie:FHEM]]

Hauptseite

2024-04-24T09:05:52Z

Krikan: Änderungen von Krikan (Diskussion) wurden auf die letzte Version von Ph1959de zurückgesetzt

<div style="background-color: grey; border: 1px solid maroon; border-radius: 8px; padding: 0 1em 1em 1em; font-size: bigger; text-align: center; color: white;">
[[Datei:StyleVector2022.png|links|mini|100px|Vector2022]]
[[Datei:StyleMinervaNeue.png|rechts|mini|100px|MinervaNeue]]
'''Wiki Benutzeroberfläche''': um eine bessere Benutzbarkeit auf mobilen Geräten zu erreichen, wird die Standard Einstellung für die Benutzeroberfläche ("Style") in den nächsten Tagen auf "Vector 2022" oder "MinervaNeue" (siehe Darstellungsbeispiele links und rechts) umgestellt. Kommentare, Kritik, Anregungen dazu bitte im Forenbereich "Wiki" in den Thread '''{{Link2Forum|Topic=137399|LinkText="Wiki Style"}}''' stellen.</div>



<div><h1 style="font-family:sans-serif; font-size: 1.8em; border: none; text-align: center;">'''FHEM Wiki - Informationsportal zum FHEM SmartHome-Server'''</h1></div>

<div class="flexbox"> 
<div class="mainpagebox" style="order: 1; flex: 1 1 80%; background-color:#cce5ff;">
<div class="mw-collapsible mw-collapsed">
'''Was ist FHEM?'''
<div class="mw-collapsible-content">
'''FHEM''' ([https://register.dpma.de/DPMAregister/marke/register/3020152110040/DE R]) ist ein in Perl geschriebener, GPL v2 lizensierter Server für die Heimautomatisierung. Man kann mit FHEM häufig auftretende Aufgaben automatisieren, wie z.B. Lampen / Rollladen / Heizung / usw. schalten, oder Ereignisse wie Temperatur / Feuchtigkeit / Stromverbrauch protokollieren und visualisieren.

Das Programm läuft als Server, man kann es über WEB, dedizierte Smartphone Apps oder telnet bedienen, TCP Schnittstellen für JSON und XML existieren ebenfalls.

Um es zu verwenden, benötigt man einen 24/7 Rechner (NAS, RPi, PC, MacMini, etc) mit einem Perl Interpreter und angeschlossene Interfaces wie CUL-, EnOcean-, Z-Wave-USB-Stick etc. für einen Zugang zu den Aktoren und Sensoren.
</div></div></div>

<div class="mainpagebox" style="order: 4; background-color:#efefef;">
'''Wie fange ich an?'''
* [[Datei:Info_green.png|20px]][https://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM][[Datei:Info_green.png|20px]]<br />DAS Einsteiger-PDF. '''Pflichtlektüre!'''<br />
* [[Quick-Start]], english version: [[Quick-Start/en|Quick-Start]]
* kleiner FHEM-Kurs, benötigt keine Hardware: [[Erste Schritte in FHEM]] / [[First steps in FHEM]]
* [[Systemübersicht]]
* Phasen eines FHEM-Projekts:
** [[Planung]]
** [[Umsetzung]] (Implementierung)
** [[Betrieb]] ("Produktion")
* [[:Kategorie:Glossary|Glossar]] (Erklärung für bestimmte Begriffe)<br />
* [[:Kategorie:HOWTOS|Verschiedene HowTos]]<br />
* [[:Kategorie:FAQ|Frequently asked Questions - Häufig gestellte Fragen mit Antworten]]<br />

</div>

<div class="mainpagebox" style="order: 6; background-color:#fff0e0;">
'''Unterstützte Hardware (Auszug)'''

* [[:Kategorie:Hardware Typen|Hardware Typen]] - Funktionsbezogene Übersicht (z.B. [[:Kategorie:Unterhaltungselektronik|Unterhaltungselektronik / Multimedia]], [[:Kategorie:Heizungssteuerung|Heizungssteuerung]], [[:Kategorie:Energieverbrauchsmessung|Energieverbrauchsmessung]], etc.)
* [[:Kategorie:Server Hardware|Server Hardware]] - Hardware, auf der FHEM installiert werden kann
* [[:Kategorie:EMS Components|EMS]], [[:Kategorie:FHT Components|FHT]], [[:Kategorie:HMS Components|HMS]] Komponenten
* [[:Kategorie:1-Wire|1-Wire System]]
* [[:Kategorie:EIB/KNX|EIB/KNX Komponenten]]
* [[:Kategorie:FS20 Components|FS20 Komponenten]]
* [[:Kategorie:EnOcean Components|EnOcean Komponenten]]
* [[:Kategorie:HomeMatic Components|HomeMatic Komponenten]]
* [[:Kategorie:MAX|MAX! Komponenten]]
* [[:Kategorie:panStamp|panStamp Komponenten]]
* [[:Kategorie:Z-Wave Components|Z-Wave Komponenten]]
* [[:Kategorie:ZigBee|Zigbee Komponenten]]
* [[:Kategorie:IP Components|Geräte mit Webinterface ("IP")]]
* [[:Kategorie:Other Components|Andere Komponenten / Sonstige Systeme]]

<div align="right"><small>'''[[:Kategorie:Hardware|Alle Hardware-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 5; background-color:#F8F8FF;">
'''Ideen und Lösungen'''

* [[:Kategorie:Code_Snippets|Verschiedene kommentierte Lösungen und Code-Schnippsel]]
* [[:Kategorie:Examples|Beispielanwendungen - Hardwarelösungen - Fremdsystemanbindungen]]
* [[Anwendungsszenarien]]
* [[Trick der Woche|Tipp der Woche]]
* [[Wie kann ich...]]?

<div align="right"><small>'''[[:Kategorie:FHEM|FHEM-Haupt-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 7; background-color:#FFFFE7;">
'''Developers Corner'''

* Informationen zur Modul-Entwicklung:
** [[DevelopmentModuleIntro|Development Module Introduction]]
** [[Meta|Development Module and Package Meta Data]]
** [[DevelopmentModuleAPI|Development Module API]]
** [[DevelopmentFHEMWEB-API|Development FHEMWEB API]]
** [[Blocking Call]]
** [[CoProcess]]
** [[HttpUtils]]
** [[DevIo]]
** [[Guidelines zur Dokumentation]]
** [[DevelopmentGuidelinesAV|Development Guidelines AV-Module]]

* Organisatorisches:
** [[How to write a patch]]
** [[SVN Nutzungsregeln]]

<div align="right"><small>'''[[:Kategorie:Development|Alle Artikel zu Development]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 3; background-color:#d7ffff;">
'''FHEM Wiki News'''
<div style="height:20em;overflow:scroll;overflow-x:hidden;">{{FHEMWiki_News}}</div>
<div align="right"><small>'''Mehr [[FHEMWiki:News|News]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 2; background-color:#e7f8ff;">
'''Was ist FHEM Wiki?'''

Das '''FHEM Wiki''' ergänzt die stets tagesaktuelle, von den zuständigen Entwicklern gepflegte {{Link2CmdRef}} (Befehls-Referenz) um weitergehende Informationen rund um FHEM. Im Wiki arbeiten Nutzer und Entwickler gemeinsam an zusätzlicher Dokumentation von FHEM und damit zusammenhängenden Themen.

Das FHEMWiki stellt neben der {{Link2CmdRef}}, dem [http://forum.fhem.de/ Forum] und der [http://www.fhem.de FHEM] Seite die zentrale Informationsquelle rund um FHEM dar. Bedeutung und Zusammenspiel dieser Elemente [[Dokumentationsstruktur|ist hier]] erläutert.


Bitte [[FHEMWiki:Support | unterstütze uns]] und hilf, [[:Kategorie:NeedsEditing| das Wiki zu erweitern]]. Vielen Dank!

<div align="right"><small>'''Mehr [[FHEMWiki:Über_FHEMWiki|über FHEMWiki]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 8; background-color:#F8F8FF;">
'''Letzte Änderungen'''
<div style="font-size:small;color:black;"><small>{{Special:Recentchanges/8}}</small></div>
<div align="right"><small>'''Mehr [[Special:Recentchanges|Änderungen]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 9; flex: 1 1 80%; background-color:#FFFFAA;">
'''Die letzten fünf neuen Seiten'''
<small>{{Special:NewPages/5}}</small>
<div align="right"><small>'''Mehr [[Special:NewPages|Neue Seiten]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 10; background-color:#DDD68F;">
'''Administratives zum Wiki'''

''Allgemeine Aktivitäten:''
* Registrierung zur Mitarbeit: wende Dich bitte an einen [[FHEMWiki:Administratoren|Administrator]]
* Basiswissen über die Mitarbeit an einem Wiki erarbeiten ([http://de.wikipedia.org/wiki/Wikipedia:Beteiligen z.B. Wikipedia])
* Erweiterung und Korrektur von Artikeln, wo immer nötig
* Ein(ig)e der [[Spezial:Gewünschte Seiten|gewünschten Seiten]] erstellen
* Ideen aus dem [http://forum.fhem.de Forum] in bestehende oder neue Artikel einarbeiten
* [[Spezial:Verwaiste Seiten|verwaiste Seiten]] in sinnvoller Weise verlinken
* [[Spezial:Sackgassenseiten|Sackgassenseiten]] wikifizieren (Links auf andere Seiten einfügen)
* [[Datei:Info_red.png|20px]] '''Tips / Regeln / Hinweise auf "[[FHEMWiki:Über FHEMWiki|Über FHEMWiki]]" beachten!''' [[Datei:Info_red.png|20px]]

''Sonstiges:''
* Zum Ausprobieren bitte die [[FHEMWiki:Sandbox]] benutzen
* [//meta.wikimedia.org/wiki/Help:Contents Wiki Benutzerhandbuch].
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Liste der Wiki-Konfigurationsvariablen]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [[FHEMWiki:Interna|Internes zu diesem Wiki]]
</div>

</div>
[[Kategorie:FHEM]]

Hauptseite

2024-04-24T05:44:33Z

Krikan: Wartungsmeldung

<div style="background-color: red; border: 1px solid maroon; border-radius: 8px; padding: 0 1em 1em 1em; font-size: bigger; text-align: center; color: white;">
'''Es finden aktuell Wartungsarbeiten an der FHEM-Infrastruktur statt. Es kann daher zu kurzzeitigen Ausfällen und Beeinträchtigungen beim Zugriff auf die FHEM-Dienste Wiki und fhem.de bis ca. 12 Uhr kommen.'''

'''Wir bitten um etwas Geduld. Sämtliche FHEM-Dienste werden im Laufe des Tages wieder wie gewohnt zur Verfügung stehen.'''
</div>

<div><h1 style="font-family:sans-serif; font-size: 1.8em; border: none; text-align: center;">'''FHEM Wiki - Informationsportal zum FHEM SmartHome-Server'''</h1></div>

<div class="flexbox"> 
<div class="mainpagebox" style="order: 1; flex: 1 1 80%; background-color:#cce5ff;">
<div class="mw-collapsible mw-collapsed">
'''Was ist FHEM?'''
<div class="mw-collapsible-content">
'''FHEM''' ([https://register.dpma.de/DPMAregister/marke/register/3020152110040/DE R]) ist ein in Perl geschriebener, GPL v2 lizensierter Server für die Heimautomatisierung. Man kann mit FHEM häufig auftretende Aufgaben automatisieren, wie z.B. Lampen / Rollladen / Heizung / usw. schalten, oder Ereignisse wie Temperatur / Feuchtigkeit / Stromverbrauch protokollieren und visualisieren.

Das Programm läuft als Server, man kann es über WEB, dedizierte Smartphone Apps oder telnet bedienen, TCP Schnittstellen für JSON und XML existieren ebenfalls.

Um es zu verwenden, benötigt man einen 24/7 Rechner (NAS, RPi, PC, MacMini, etc) mit einem Perl Interpreter und angeschlossene Interfaces wie CUL-, EnOcean-, Z-Wave-USB-Stick etc. für einen Zugang zu den Aktoren und Sensoren.
</div></div></div>

<div class="mainpagebox" style="order: 4; background-color:#efefef;">
'''Wie fange ich an?'''
* [[Datei:Info_green.png|20px]][https://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM][[Datei:Info_green.png|20px]]<br />DAS Einsteiger-PDF. '''Pflichtlektüre!'''<br />
* [[Quick-Start]], english version: [[Quick-Start/en|Quick-Start]]
* kleiner FHEM-Kurs, benötigt keine Hardware: [[Erste Schritte in FHEM]] / [[First steps in FHEM]]
* [[Systemübersicht]]
* Phasen eines FHEM-Projekts:
** [[Planung]]
** [[Umsetzung]] (Implementierung)
** [[Betrieb]] ("Produktion")
* [[:Kategorie:Glossary|Glossar]] (Erklärung für bestimmte Begriffe)<br />
* [[:Kategorie:HOWTOS|Verschiedene HowTos]]<br />
* [[:Kategorie:FAQ|Frequently asked Questions - Häufig gestellte Fragen mit Antworten]]<br />

</div>

<div class="mainpagebox" style="order: 6; background-color:#fff0e0;">
'''Unterstützte Hardware (Auszug)'''

* [[:Kategorie:Hardware Typen|Hardware Typen]] - Funktionsbezogene Übersicht (z.B. [[:Kategorie:Unterhaltungselektronik|Unterhaltungselektronik / Multimedia]], [[:Kategorie:Heizungssteuerung|Heizungssteuerung]], [[:Kategorie:Energieverbrauchsmessung|Energieverbrauchsmessung]], etc.)
* [[:Kategorie:Server Hardware|Server Hardware]] - Hardware, auf der FHEM installiert werden kann
* [[:Kategorie:EMS Components|EMS]], [[:Kategorie:FHT Components|FHT]], [[:Kategorie:HMS Components|HMS]] Komponenten
* [[:Kategorie:1-Wire|1-Wire System]]
* [[:Kategorie:EIB/KNX|EIB/KNX Komponenten]]
* [[:Kategorie:FS20 Components|FS20 Komponenten]]
* [[:Kategorie:EnOcean Components|EnOcean Komponenten]]
* [[:Kategorie:HomeMatic Components|HomeMatic Komponenten]]
* [[:Kategorie:MAX|MAX! Komponenten]]
* [[:Kategorie:panStamp|panStamp Komponenten]]
* [[:Kategorie:Z-Wave Components|Z-Wave Komponenten]]
* [[:Kategorie:ZigBee|Zigbee Komponenten]]
* [[:Kategorie:IP Components|Geräte mit Webinterface ("IP")]]
* [[:Kategorie:Other Components|Andere Komponenten / Sonstige Systeme]]

<div align="right"><small>'''[[:Kategorie:Hardware|Alle Hardware-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 5; background-color:#F8F8FF;">
'''Ideen und Lösungen'''

* [[:Kategorie:Code_Snippets|Verschiedene kommentierte Lösungen und Code-Schnippsel]]
* [[:Kategorie:Examples|Beispielanwendungen - Hardwarelösungen - Fremdsystemanbindungen]]
* [[Anwendungsszenarien]]
* [[Trick der Woche|Tipp der Woche]]
* [[Wie kann ich...]]?

<div align="right"><small>'''[[:Kategorie:FHEM|FHEM-Haupt-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 7; background-color:#FFFFE7;">
'''Developers Corner'''

* Informationen zur Modul-Entwicklung:
** [[DevelopmentModuleIntro|Development Module Introduction]]
** [[Meta|Development Module and Package Meta Data]]
** [[DevelopmentModuleAPI|Development Module API]]
** [[DevelopmentFHEMWEB-API|Development FHEMWEB API]]
** [[Blocking Call]]
** [[CoProcess]]
** [[HttpUtils]]
** [[DevIo]]
** [[Guidelines zur Dokumentation]]
** [[DevelopmentGuidelinesAV|Development Guidelines AV-Module]]

* Organisatorisches:
** [[How to write a patch]]
** [[SVN Nutzungsregeln]]

<div align="right"><small>'''[[:Kategorie:Development|Alle Artikel zu Development]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 3; background-color:#d7ffff;">
'''FHEM Wiki News'''
<div style="height:20em;overflow:scroll;overflow-x:hidden;">{{FHEMWiki_News}}</div>
<div align="right"><small>'''Mehr [[FHEMWiki:News|News]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 2; background-color:#e7f8ff;">
'''Was ist FHEM Wiki?'''

Das '''FHEM Wiki''' ergänzt die stets tagesaktuelle, von den zuständigen Entwicklern gepflegte {{Link2CmdRef}} (Befehls-Referenz) um weitergehende Informationen rund um FHEM. Im Wiki arbeiten Nutzer und Entwickler gemeinsam an zusätzlicher Dokumentation von FHEM und damit zusammenhängenden Themen.

Das FHEMWiki stellt neben der {{Link2CmdRef}}, dem [http://forum.fhem.de/ Forum] und der [http://www.fhem.de FHEM] Seite die zentrale Informationsquelle rund um FHEM dar. Bedeutung und Zusammenspiel dieser Elemente [[Dokumentationsstruktur|ist hier]] erläutert.


Bitte [[FHEMWiki:Support | unterstütze uns]] und hilf, [[:Kategorie:NeedsEditing| das Wiki zu erweitern]]. Vielen Dank!

<div align="right"><small>'''Mehr [[FHEMWiki:Über_FHEMWiki|über FHEMWiki]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 8; background-color:#F8F8FF;">
'''Letzte Änderungen'''
<div style="font-size:small;color:black;"><small>{{Special:Recentchanges/8}}</small></div>
<div align="right"><small>'''Mehr [[Special:Recentchanges|Änderungen]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 9; flex: 1 1 80%; background-color:#FFFFAA;">
'''Die letzten fünf neuen Seiten'''
<small>{{Special:NewPages/5}}</small>
<div align="right"><small>'''Mehr [[Special:NewPages|Neue Seiten]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 10; background-color:#DDD68F;">
'''Administratives zum Wiki'''

''Allgemeine Aktivitäten:''
* Registrierung zur Mitarbeit: wende Dich bitte an einen [[FHEMWiki:Administratoren|Administrator]]
* Basiswissen über die Mitarbeit an einem Wiki erarbeiten ([http://de.wikipedia.org/wiki/Wikipedia:Beteiligen z.B. Wikipedia])
* Erweiterung und Korrektur von Artikeln, wo immer nötig
* Ein(ig)e der [[Spezial:Gewünschte Seiten|gewünschten Seiten]] erstellen
* Ideen aus dem [http://forum.fhem.de Forum] in bestehende oder neue Artikel einarbeiten
* [[Spezial:Verwaiste Seiten|verwaiste Seiten]] in sinnvoller Weise verlinken
* [[Spezial:Sackgassenseiten|Sackgassenseiten]] wikifizieren (Links auf andere Seiten einfügen)
* [[Datei:Info_red.png|20px]] '''Tips / Regeln / Hinweise auf "[[FHEMWiki:Über FHEMWiki|Über FHEMWiki]]" beachten!''' [[Datei:Info_red.png|20px]]

''Sonstiges:''
* Zum Ausprobieren bitte die [[FHEMWiki:Sandbox]] benutzen
* [//meta.wikimedia.org/wiki/Help:Contents Wiki Benutzerhandbuch].
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Liste der Wiki-Konfigurationsvariablen]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [[FHEMWiki:Interna|Internes zu diesem Wiki]]
</div>

</div>
[[Kategorie:FHEM]]

Vorlage:FHEMWiki News

2024-04-04T16:27:19Z

Krikan: Umstellung auf aktuellen Standardskin Vector (2022)

{|
{{News|04.04.2024|Umstellung des FHEMWiki-Standardskin ("Style") von 'Vector alt (2010)' auf 'Vector (2022)' um eine bessere Benutzbarkeit auf mobilen Geräten bei nicht registrierten Benutzern zu erreichen. Registrierte Benutzer können unter Einstellungen/Aussehen den Skins selbst ändern. {{Link2Forum|Topic=137399}}}}
{{News|28.01.2024|FHEM Version 6.3 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=136851|LinkText=diesem Forenbeitrag}}.}}
{{News|14.08.2023|[[AutomowerConnect#Tablet-UI%3FFTUI_Version_3|FTUI3 AutomowerConnect]] Karte des Mähbereiches einbinden. }}
{{News|28.06.2023|[[AutomowerConnect#Tablet-UI%2FFTUI_Version_2|FTUI2 Widget 'automowerconnect']] für das Modul 74_AutomowerConnect.pm. }}
{{News|06.04.2023|FHEM Wiki ist auf einen neuen Server umgezogen und läuft jetzt auf aktueller Software. Es gibt neue Skins für Mobilgeräte Unterstützung. }}
{{News|25.01.2023|Neues Modul - [[AutomowerConnect|74_AutomowerConnect.pm]] zur Bedienung von Husqvarnas Mähroboter über Husqvarnas Open API {{Link2Forum|Topic=131661|LinkText=Forenbeitrag}}.}}
{{News|14.01.2023|FHEM Version 6.2 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=131618|LinkText=diesem Forenbeitrag}}.}}
{{News|08.11.2021|FHEM Version 6.1 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=123972|LinkText=diesem Forenbeitrag}}.}}
{{News|25.05.2021|Ein weiteres Modul zur Integration von Diensten der Synology Diskstation wird per Update verteilt: [[SSFile - Integration der Synology File Station|SSFile]].}}
{{News|28.02.2020|Das neue Modul [[SSCal - Integration des Synology Calendar Servers| SSCal]] ermöglicht die Integration des Synology Calendar Servers.}}
{{News|28.01.2020|Neues Modul für die IP-Türsprechanlage [[DoorBird]] per Update verteilt.}}}}
{{News|26.01.2020|FHEM Version 6.0 wurde freigegeben. Updatehinweise: {{Link2Forum|Topic=107782}}}}
{{News|17.12.2019|Mit dem Modul [[SSChatBot - Integration des Synology Chat Servers|SSChatBot]] kann der Synology Chat Server in FHEM integriert werden. Es können Mitteilungen zwischen FHEM und Chat ausgetauscht sowie Befehle in FHEM ausgeführt werden. }}
{{News|23.09.2019|Das Modul [[CanOverEthernet]] ermöglicht das Empfangen von Can-Over-Ethernet Paketen von Steuerungen der Firma Technische Alternative}}
{{News|05.04.2019|Das [[SamsungAV]] Modul ermöglicht die Steuerung von Samsung Fernsehern und Bluray-Playern.}}
{{News|06.03.2019|Mit dem Modul [[Arlo]] ist die Einbindung von Arlo Kameras über die Arlo Cloud möglich}}
{{News|26.01.2019|Das [[TRÅDFRI|tradfri]] Modul erweitert die Palette der [[ZigBee]] Module.}}
{{News|14.01.2019|Der [[FHEM Connector für Amazon Alexa|FHEM Connector]] Skill für Amazon Alexa ist verfügbar.}}
{{News|02.11.2018|Das Modul [[TA_CMI_UVR16x2_UVR1611|TA_CMI_JSON]] kann Werte des C.M.I. der Firma Technische Alternative auslesen und eignet sich so optimal zum Loggen von Daten zB der UVR16x2 oder UVR1611.}}
{{News|11.09.2018|Mit dem Modul [[AutoShuttersControl|AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters. }}
{{News|12.02.2018|Die Module [[Modul Babble|Babble]] und [[Talk2Fhem|Talk2Fhem]] erweitern die Sprachsteuerungsmöglichkeiten von FHEM}}
{{News|02.10.2017|[[FTUI eigene Widgets|Eigene Widgets für FHEM Tablet UI erstellen]]}}
{{News|30.08.2017|[[WINCONNECT]] - Windows PC steuern und Informationen abfragen/anzeigen. }}
{{News|24.08.2017|[[FHEMWEB/Widgets]] - Widgets (Frontendelemente) von FHEMWEB }}
{{News|24.08.2017|Neues Modul [[Modul_YAAHM|YAAHM]] wird per update verteilt. Es stellt eine Oberfläche bereit, um per Webinterface die zyklische Ausführung von Kommandos - mit Tages- und Wochenprofil - zu konfigurieren}}
{{News|24.07.2017|[[Telnet|Verbindung mit dem FHEM-Server per Telnet]]}}
{{News|20.07.2017|[[FHEM startet nicht - Tipps zur Fehlersuche]]}}
{{News|06.06.2017|[[‎Relaisplatine-Homebrew-MySensors|MySensors-Relaisplatine im Selbstbau]]}}
{{News|31.05.2017|[[Datenbankgestützte_Erstellung_der_Energiebilanz_einer_SMA_PV-Anlage_mit_Überschußeinspeisung|Datenbankgestützte Erstellung der Energiebilanz einer PV-Anlage mit Überschußeinspeisung]]}}
{{News|30.04.2017|[[DoorPiBoard]]: Eine Platine zur Umsetzung des [[DoorPi_und FHEM|DoorPi-Projektes]]}}
{{News|21.03.2017|Artikel zum alternativen Frontend [[:Kategorie:FHEM_Tablet_UI|Tablet UI]] aktualisiert und deutlich erweitert}}
{{News|02.03.2017|Neues Modul zur Ansteuerung von [[LGTV_WebOS|LG-TVs mit dem Betriebssystem WebOS]] wird per update verteilt}}
{{News|20.02.2017|Neues Modul [[SIP-Client|SIP]], ein SIP-Client für FHEM, wird per update verteilt}}
{{News|19.02.2017|FHEM Version 5.8 wurde freigegeben. Updatehinweise beachten: {{Link2Forum|Topic=67419}}}}
{{News|18.01.2017|Neues Modul [[DOIFtools]] mit Funktionen zur Unterstützung des Benutzers im Umgang mit [[DOIF]] wird per update verteilt}}
{{News|12.01.2017|Neues Modul zur Ansteuerung des Bluetooth 4.1 BLE Pflanzensensors [[XiaomiFlowerSens|Xiaomi Flower Care Smart Monitor]] wird per update ausgeliefert}}
{{News|01.01.2017|Diverse neue Wiki-Artikel mit Informationen und Hilfen zu [[DOIF#Links|DOIF]] }}
{{News|10.12.2016|FHEM Wiki ist auf einen neuen Server umgezogen und hat eine neue Standard-Internetadresse: https://wiki.fhem.de}}
{{News|21.11.2016|Neues Modul [[Modul_PostMe|PostMe]] stellt eine komfortable Oberfläche zur Listenverwaltung bereit}}
{{News|11.10.2016|Neue Module [[NUKI|NUKIbridge und NUKIDevice]] zur Ansteuerung des Nuki Smartlock werden per update verteilt}}
{{News|07.10.2016|Neues Modul [[TRAFFIC]] zur Erfassung der Fahrzeiten bei aktueller Verkehrslage mittels Google Maps Directions API wird per update verteilt}}
{{News|19.07.2016|Neues Modul zur Unterstützung der HomeMatic-Interfaces [[HM-MOD-RPI-PCB_HomeMatic_Funkmodul_für_Raspberry_Pi|Funkmodul für Raspberry Pi]] und [[HM-LGW-O-TW-W-EU_Funk-LAN_Gateway|Funk-LAN Gateway]] wird per update verteilt }}
{{News|12.07.2016|Neues Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten]] wird per update verteilt }}
{{News|08.02.2016|Neues Modul [[Mediaportal|MEDIAPORTAL]] (Steuerung einer Mediaportal-Installation über Wifiremote) wird per update verteilt}}
{{News|16.11.2015|Neues Modul [[HP1000]] (Einbindung einer HP1000 Wetterstation) wird per update verteilt}}
{{News|16.11.2015|Neuer FHEM Befehl [[msg]] (Intelligentes Versenden/Routing von Nachrichten der Typen Audio,Text,Mail,Push,Light,Screen) wird per update verteilt}}
{{News|15.11.2015|FHEM Version 5.7 wurde veröffentlicht. Unbedingt Updatehinweise beachten: {{Link2Forum|Topic=44094}}}}
{{News|30.10.2015|FHEM Wiki unterstützt nun [[Syntax Highlighting]]}}
{{News|18.10.2015|Neues Modul [[TechemHKV]] (Empfang von Daten eines Techem Heizkostenverteilers) wird per update verteilt}}
{{News|02.10.2015|Kleiner FHEM-Einsteiger-Kurs als Wiki Artikel unter [[Erste_Schritte_in_fhem|Erste Schritte in FHEM]]}}
{{News|24.09.2015|Umfangreiche Überarbeitung der Wiki Artikel über [[:Kategorie:panStamp|panStamp Hardware und Software]]}}
{{News|11.09.2015|Neues Modul [[AMAD]] (Steuern und Informationsanzeige von Android-Geräten) wird per update verteilt}}
{{News|15.06.2015|Neues Modul [[yowsup]] (WhatsApp Unterstützung) wird per update verteilt}}
{{News|03.04.2015|Neues Geräte-Modul [[JawboneUp]] wird per update verteilt}}
{{News|23.03.2015|Neue Geräte-Module [[Modbus]], [[ModbusAttr]] und [[Modbus#Writing_modules_for_devices_using_this_module_as_a_library|ModbusSET]] werden per update verteilt}}
{{News|10.02.2015|FHEM Wiki ist auf einen neuen Server umgezogen und [[FHEMWiki:Interna#Offene_Probleme|Aktualisierung der MediaWiki-Software]]}}
{{News|31.01.2015|Neues Geräte-Modul [[Pushbullet]] wird per update verteilt}}
{{News|14.01.2015|Neues Hilfs-Modul [[CALVIEW]] wird per update verteilt}}
{{News|08.01.2015|Neues Geräte-Modul [[Buderus_Web_Gateway|km200]] zur Anbindung eines Buderus Web-Gateways wird per update verteilt}}
{{News|18.12.2014|Neues Geräte-Modul [[SONOS]] wird per update verteilt}}
{{News|15.12.2014|Überarbeitetes und erweitertes Geräte-Modul [[HTTPMOD]] wird per update verteilt}}
{{News|10.12.2014|Neues Geräte-Modul [[Vitotronic_200_(Viessmann_Heizungssteuerung)|VCONTROL]] zur Anbindung einer Viessmann Heizung wird per update verteilt}}
{{News|17.11.2014|Neues Hilfs-Modul [[logProxy]] wird per update verteilt}}
{{News|09.11.2014|FHEM Version 5.6 wurde veröffentlicht}}
{{News|27.10.2014|Neues Geräte-Modul [[harmony]] zur FHEM-Anbindung Logitech Harmony Hub basierter Fernbedienungen wird per update verteilt}}
{{News|25.10.2014|Neues Geräte-Modul [[KostalPiko|KOSTALPIKO]] wird per update verteilt}}
{{News|24.10.2014|Neues Hilfs-Modul [[HourCounter]] wird per update verteilt}}
{{News|06.09.2014|Neues Hilfs-Modul [[CustomReadings]] per update verteilt}}
{{News|19.08.2014|Neues Hilfs-Modul [[DOIF]] wird per update verteilt}}
{{News|19.08.2014|Der Befehl [[update]] wurde überarbeitet: {{Link2Forum|Topic=26311}} }}
{{News|13.08.2014|Zusätzliche Domäne fhem.org aktiviert: {{Link2Forum|Topic=26113}} }}
{{News|29.09.2013|FHEM Version 5.5 wurde veröffentlicht}}
{{News|11.05.2013|Die meisten Daten aus dem FhemWiki sind wieder hergestellt.}}
{{News|04.05.2013|FHEM Wiki wird neu aufgebaut.}}
{{News|04.05.2013|FHEM Wiki Update zu [[Special:Version|MediaWiki 1.20.5]].}}
|}
<noinclude>[[Kategorie:Vorlage]]</noinclude>

Hauptseite

2024-04-04T16:14:33Z

Krikan: Ankündigung Umstellung Wiki-Default-Skin entfernt

<div><h1 style="font-family:sans-serif; font-size: 1.8em; border: none; text-align: center;">'''FHEM Wiki - Informationsportal zum FHEM SmartHome-Server'''</h1></div>

<div class="flexbox"> 
<div class="mainpagebox" style="order: 1; flex: 1 1 80%; background-color:#cce5ff;">
<div class="mw-collapsible mw-collapsed">
'''Was ist FHEM?'''
<div class="mw-collapsible-content">
'''FHEM''' ([https://register.dpma.de/DPMAregister/marke/register/3020152110040/DE R]) ist ein in Perl geschriebener, GPL v2 lizensierter Server für die Heimautomatisierung. Man kann mit FHEM häufig auftretende Aufgaben automatisieren, wie z.B. Lampen / Rollladen / Heizung / usw. schalten, oder Ereignisse wie Temperatur / Feuchtigkeit / Stromverbrauch protokollieren und visualisieren.

Das Programm läuft als Server, man kann es über WEB, dedizierte Smartphone Apps oder telnet bedienen, TCP Schnittstellen für JSON und XML existieren ebenfalls.

Um es zu verwenden, benötigt man einen 24/7 Rechner (NAS, RPi, PC, MacMini, etc) mit einem Perl Interpreter und angeschlossene Interfaces wie CUL-, EnOcean-, Z-Wave-USB-Stick etc. für einen Zugang zu den Aktoren und Sensoren.
</div></div></div>

<div class="mainpagebox" style="order: 4; background-color:#efefef;">
'''Wie fange ich an?'''
* [[Datei:Info_green.png|20px]][https://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM][[Datei:Info_green.png|20px]]<br />DAS Einsteiger-PDF. '''Pflichtlektüre!'''<br />
* [[Quick-Start]], english version: [[Quick-Start/en|Quick-Start]]
* kleiner FHEM-Kurs, benötigt keine Hardware: [[Erste Schritte in FHEM]] / [[First steps in FHEM]]
* [[Systemübersicht]]
* Phasen eines FHEM-Projekts:
** [[Planung]]
** [[Umsetzung]] (Implementierung)
** [[Betrieb]] ("Produktion")
* [[:Kategorie:Glossary|Glossar]] (Erklärung für bestimmte Begriffe)<br />
* [[:Kategorie:HOWTOS|Verschiedene HowTos]]<br />
* [[:Kategorie:FAQ|Frequently asked Questions - Häufig gestellte Fragen mit Antworten]]<br />

</div>

<div class="mainpagebox" style="order: 6; background-color:#fff0e0;">
'''Unterstützte Hardware (Auszug)'''

* [[:Kategorie:Hardware Typen|Hardware Typen]] - Funktionsbezogene Übersicht (z.B. [[:Kategorie:Unterhaltungselektronik|Unterhaltungselektronik / Multimedia]], [[:Kategorie:Heizungssteuerung|Heizungssteuerung]], [[:Kategorie:Energieverbrauchsmessung|Energieverbrauchsmessung]], etc.)
* [[:Kategorie:Server Hardware|Server Hardware]] - Hardware, auf der FHEM installiert werden kann
* [[:Kategorie:EMS Components|EMS]], [[:Kategorie:FHT Components|FHT]], [[:Kategorie:HMS Components|HMS]] Komponenten
* [[:Kategorie:1-Wire|1-Wire System]]
* [[:Kategorie:EIB/KNX|EIB/KNX Komponenten]]
* [[:Kategorie:FS20 Components|FS20 Komponenten]]
* [[:Kategorie:EnOcean Components|EnOcean Komponenten]]
* [[:Kategorie:HomeMatic Components|HomeMatic Komponenten]]
* [[:Kategorie:MAX|MAX! Komponenten]]
* [[:Kategorie:panStamp|panStamp Komponenten]]
* [[:Kategorie:Z-Wave Components|Z-Wave Komponenten]]
* [[:Kategorie:ZigBee|Zigbee Komponenten]]
* [[:Kategorie:IP Components|Geräte mit Webinterface ("IP")]]
* [[:Kategorie:Other Components|Andere Komponenten / Sonstige Systeme]]

<div align="right"><small>'''[[:Kategorie:Hardware|Alle Hardware-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 5; background-color:#F8F8FF;">
'''Ideen und Lösungen'''

* [[:Kategorie:Code_Snippets|Verschiedene kommentierte Lösungen und Code-Schnippsel]]
* [[:Kategorie:Examples|Beispielanwendungen - Hardwarelösungen - Fremdsystemanbindungen]]
* [[Anwendungsszenarien]]
* [[Trick der Woche|Tipp der Woche]]
* [[Wie kann ich...]]?

<div align="right"><small>'''[[:Kategorie:FHEM|FHEM-Haupt-Kategorien]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 7; background-color:#FFFFE7;">
'''Developers Corner'''

* Informationen zur Modul-Entwicklung:
** [[DevelopmentModuleIntro|Development Module Introduction]]
** [[Meta|Development Module and Package Meta Data]]
** [[DevelopmentModuleAPI|Development Module API]]
** [[DevelopmentFHEMWEB-API|Development FHEMWEB API]]
** [[Blocking Call]]
** [[CoProcess]]
** [[HttpUtils]]
** [[DevIo]]
** [[Guidelines zur Dokumentation]]
** [[DevelopmentGuidelinesAV|Development Guidelines AV-Module]]

* Organisatorisches:
** [[How to write a patch]]
** [[SVN Nutzungsregeln]]

<div align="right"><small>'''[[:Kategorie:Development|Alle Artikel zu Development]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 3; background-color:#d7ffff;">
'''FHEM Wiki News'''
<div style="height:20em;overflow:scroll;overflow-x:hidden;">{{FHEMWiki_News}}</div>
<div align="right"><small>'''Mehr [[FHEMWiki:News|News]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 2; background-color:#e7f8ff;">
'''Was ist FHEM Wiki?'''

Das '''FHEM Wiki''' ergänzt die stets tagesaktuelle, von den zuständigen Entwicklern gepflegte {{Link2CmdRef}} (Befehls-Referenz) um weitergehende Informationen rund um FHEM. Im Wiki arbeiten Nutzer und Entwickler gemeinsam an zusätzlicher Dokumentation von FHEM und damit zusammenhängenden Themen.

Das FHEMWiki stellt neben der {{Link2CmdRef}}, dem [http://forum.fhem.de/ Forum] und der [http://www.fhem.de FHEM] Seite die zentrale Informationsquelle rund um FHEM dar. Bedeutung und Zusammenspiel dieser Elemente [[Dokumentationsstruktur|ist hier]] erläutert.


Bitte [[FHEMWiki:Support | unterstütze uns]] und hilf, [[:Kategorie:NeedsEditing| das Wiki zu erweitern]]. Vielen Dank!

<div align="right"><small>'''Mehr [[FHEMWiki:Über_FHEMWiki|über FHEMWiki]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 8; background-color:#F8F8FF;">
'''Letzte Änderungen'''
<div style="font-size:small;color:black;"><small>{{Special:Recentchanges/8}}</small></div>
<div align="right"><small>'''Mehr [[Special:Recentchanges|Änderungen]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 9; flex: 1 1 80%; background-color:#FFFFAA;">
'''Die letzten fünf neuen Seiten'''
<small>{{Special:NewPages/5}}</small>
<div align="right"><small>'''Mehr [[Special:NewPages|Neue Seiten]]'''</small></div>
</div>

<div class="mainpagebox" style="order: 10; background-color:#DDD68F;">
'''Administratives zum Wiki'''

''Allgemeine Aktivitäten:''
* Registrierung zur Mitarbeit: wende Dich bitte an einen [[FHEMWiki:Administratoren|Administrator]]
* Basiswissen über die Mitarbeit an einem Wiki erarbeiten ([http://de.wikipedia.org/wiki/Wikipedia:Beteiligen z.B. Wikipedia])
* Erweiterung und Korrektur von Artikeln, wo immer nötig
* Ein(ig)e der [[Spezial:Gewünschte Seiten|gewünschten Seiten]] erstellen
* Ideen aus dem [http://forum.fhem.de Forum] in bestehende oder neue Artikel einarbeiten
* [[Spezial:Verwaiste Seiten|verwaiste Seiten]] in sinnvoller Weise verlinken
* [[Spezial:Sackgassenseiten|Sackgassenseiten]] wikifizieren (Links auf andere Seiten einfügen)
* [[Datei:Info_red.png|20px]] '''Tips / Regeln / Hinweise auf "[[FHEMWiki:Über FHEMWiki|Über FHEMWiki]]" beachten!''' [[Datei:Info_red.png|20px]]

''Sonstiges:''
* Zum Ausprobieren bitte die [[FHEMWiki:Sandbox]] benutzen
* [//meta.wikimedia.org/wiki/Help:Contents Wiki Benutzerhandbuch].
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Liste der Wiki-Konfigurationsvariablen]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [[FHEMWiki:Interna|Internes zu diesem Wiki]]
</div>

</div>
[[Kategorie:FHEM]]

EnOcean-FUD61NPN-Funk-Universal-Dimmaktor

2023-05-16T07:26:00Z

Krikan: Todo ergänzt: Fehlerhinweis aus Forum prüfen und ggfs. einarbeiten

{{Todo|Fehlerhinweis : Hinweis aus {{Link2Forum|Topic=133487}} auf nicht funktionierenden Anlernvorgang prüfen und gegenbenenfalls Wiki-Seite anpassen. }}

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=
|HWProtocol=EnOcean
|HWType=Aktor, Empfänger; Sender, Sensor
|HWCategory=EnOcean
|HWComm=EnOcean Funk, 868Mhz
|HWChannels=1 bidirektional
|HWVoltage=230V~
|HWPowerConsumption=Eigenverbrauch ca. 0,7W
|HWPoweredBy=230V
|HWSize=45x55x33mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#EnOcean EnOcean]
|HWManufacturer=Eltako
}}

{{Randnotiz|RNText=Seite gilt nur für die '''bidirektionale''' Variante des Aktors (am Beispiel Variante ab KW 11/14)}}

'''[[EnOcean-FUD61NPN-Funk-Universal-Dimmaktor]]''' ist ein Aktor
* für
** Unterputzmontage
* zum
** Dimmen

== Features ==
Dimm-Aktor für Lampen bis 300 W, dimmbare Energiesparlampen ESL und dimmbare 230 V-LED-Lampen (Details siehe Anleitung)

== Hinweise zum Betrieb mit FHEM ==
Funktionsfähigkeit erfordert, dass die Bestätigungstelegramme am Aktor eingeschaltet sind

=== Definition/Anlernvorgang ===
Der Aktor kann nicht vollautomatisch per autocreate in FHEM angelegt werden.
Die Einbindung in FHEM kann entweder über die Nutzung der inoffiziellen, gerätespezifischen EEP (empfohlen) '''oder''' über die manuelle Vorgehensweise erfolgen.

===== Nutzung der inoffziellen EEP =====
* FHEM-Device <name> (hier: EnO_FUD61) mit dem passenden inoffiziellen EEP und der Sender-ID des FUD61 (siehe Rückseite des Aktors; hier: 01036620) durch Eingabe in das [[Konfiguration#Befehl-Eingabefeld|Befehls-Eingabefeld]] und anschließendem Auslösen von {{Taste|Enter}} definieren.
: Aktoren mit Produktionswoche bis ca. Mitte 2016:
: <code>define EnO_FUD61 EnOcean 01036620 G5-38-08</code>
: Aktoren mit Produktionswoche ab ca. Mitte 2016 ({{Link2Forum|Topic=57591|Message=490825}}):
: <code>define EnO_FUD61 EnOcean 01036620 H5-38-08</code>
: Hierdurch wird ein FHEM-Device mit allen notwendigen Attributen für den FUD61 angelegt, das nur noch am Aktor angelernt werden muss.
* Am Aktor
** Oberer Funktions-Drehschalter: auf LRN
** Unterer Funktions-Drehschalter: auf AUTO (zum Einlernen PC)
* FHEM Eingabefeld: <code>set EnO_FUD61 teach</code>
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position

===== Alternative: manuelle Vorgehensweise =====
* FHEM-Device <name> (hier: EnO_FUD61) mit der Sender-ID des FUD61 (siehe Rückseite des Aktors; hier: 01036620) definieren:
: <code>define EnO_FUD61 EnOcean 01036620</code>
* Das Attribut subDef mit einer freien SenderId des TCMs anlegen ODER falls keine freie Sender-ID bekannt ist, das Attribut komplett weglassen, damit die Vergabe automatisch durch FHEM erfolgt:
: <code>attr EnO_FUD61 subDef AABBCC05</code> <--- nur Anlegen, wenn eine freie SenderID des Gateways bekannt ist
* Die Attribute subType, gwCmd und manufID wie nachfolgend anlegen:
: <code> attr EnO_FUD61 subType gateway</code>
: <code> attr EnO_FUD61 gwCmd dimming</code>
: <code> attr EnO_FUD61 manufID 00D</code>
* Bei Aktoren mit Produktionswoche ab ca. Mitte 2016 zusätzlich folgendes Attribut anlegen ({{Link2Forum|Topic=57591|Message=490825}}):
: <code> attr EnO_FUD61 model Eltako_TF</code>
* Am Aktor
** Oberer Funktions-Drehschalter: auf LRN
** Unterer Funktions-Drehschalter: auf AUTO (zum Einlernen PC)
* FHEM Eingabefeld: <code>set EnO_FUD61 teach</code>
* Am Aktor nach dem Einlernen beide Drehschalter in die ursprüngliche Position

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:
<pre>
define EnO_FUD61 EnOcean 01036620 <--- SenderID des FUD61NPN (Aktors)
attr EnO_FUD61 subDef AABBCC05 <--- AABBCC05 ist eine der SenderID's des TCM
attr EnO_FUD61 eep A5-38-08
attr EnO_FUD61 subType gateway
attr EnO_FUD61 gwCmd dimming
attr EnO_FUD61 manufID 00D
attr EnO_FUD61 webCmd on:off:dim
</pre>

=== Logbeispiel ===
2015-03-29_18:32:13 EnO_FUD61 dim: 63
2015-03-29_18:32:13 EnO_FUD61 dimValueLast: 63
2015-03-29_18:32:13 EnO_FUD61 dimValueStored: 87
2015-03-29_18:32:14 EnO_FUD61 block: unlock
2015-03-29_18:32:16 EnO_FUD61 rampTime: 0
2015-03-29_18:32:16 EnO_FUD61 on
2015-03-29_18:32:16 EnO_FUD61 dim: 87
2015-03-29_18:32:16 EnO_FUD61 dimValueLast: 87
2015-03-29_18:32:19 EnO_FUD61 dimValueStored: 1
2015-03-29_18:32:19 EnO_FUD61 block: unlock
2015-03-29_18:32:20 EnO_FUD61 block: unlock
2015-03-29_18:32:21 EnO_FUD61 off
2015-03-29_18:32:22 EnO_FUD61 rampTime: 0
2015-03-29_18:32:22 EnO_FUD61 off
2015-03-29_18:32:22 EnO_FUD61 dim: 0
2015-03-29_18:35:06 EnO_FUD61 block: unlock
2015-03-29_18:35:08 EnO_FUD61 rampTime: 0
2015-03-29_18:35:08 EnO_FUD61 off
2015-03-29_18:35:08 EnO_FUD61 dim: 0

== Einsatzbeispiel ==
=== Fahrzeit mit höherer Auflösung senden ===
FHEM sendet die Fahrzeit im Standard mit einer Auflösung von 1 s. Bei neueren Eltako Jalousieaktoren (FSB61 mit verschlüsseltem Funk) kann die Fahrzeit mit einer Auflösung von 1/10 s gesendet werden. Um die Fahrzeit mit höherer Genauigkeit innerhalb von FHEM zu berechnen und zu senden, ist das Attribut <code>settingAccuracy</code> auf <code>high</code> zu setzen. Die Eingabe der Fahrzeit oder der Position erfolgt weiterhin ohne Dezimalstellen!

=== Anzeige eines alternativen Bedienelementes ===
[[Datei:knobwidget.JPG|thumb|right]]
Anstelle des standardmäßigen Sliders zur Einstellung der Dimmstufe durch den set-Befehl "dim" kann mittels des Attributs <code>widgetOverride</code> ein anderes Bedienelement vorbelegt werden. Hier ein Beispiel für ein knob-Bedienelement:

attr FUD_61 widgetOverride dim:knob,min:0,max:100,step:1,linecap:round,angleOffset:-125,angleArc:250
attr FUD_61 webCmd dim <------- Bedienelement wird auch in der Raumansicht angezeigt

Ideen und Beispiele für knob-Bedienelemente mit den notwendigen Parametern finden sich beispielsweise [http://anthonyterrien.com/knob/ hier].

=== Ansteuerung eines ausschließlich indirekt angelernten Dimmers ===
Ein Dimmer bei dem keine physischen Taster direkt angelernt sind, sondern die Steuerung ausschließlich indirekt über FHEM (Taster->FHEM->Dimmer) erfolgt, kann folgendermaßen eingebunden werden:
* [[Enocean_Dimmer_mit_kurzem_und_langem_Tastendruck_ansteuern|Enocean Dimmer mit kurzem und langem Tastendruck ansteuern]]
Bitte auch die [[Diskussion:Enocean_Dimmer_mit_kurzem_und_langem_Tastendruck_ansteuern|Diskussionsseite]] zu den Beweggründen dieses Vorgehens beachten. Dies ist keinesfalls zwingend. Bei Ausfall des FHEM-Server ist keine Steuerung des Dimmers mehr möglich.

== Links ==
* Datenblatt: [http://www.eltako.com/fileadmin/downloads/de/Datenblatt/FUNK_datenblatt_FUD61NPN.pdf PDF]
* Anleitung: [http://www.eltako.com/fileadmin/downloads/de/_bedienung/FUD61NPN_30100835-8_dt.pdf PDF]

[[Kategorie:EnOcean Components]]
[[Kategorie:Dimmer]]

Vorlage:FHEMWiki News

2023-03-08T14:54:55Z

Krikan: Freigabe FHEM 6.2

{|
{{News|25.01.2023|Neue Module - [[AutomowerConnect|74_AutomowerConnect.pm]] und [[AutomowerConnectDevice|75_AutomowerConnectDevice.pm]] zur Bedienung von Husqvarnas Mähroboter über Husqvarnas Open API {{Link2Forum|Topic=131661|LinkText=Forenbeitrag}}.}}
{{News|14.01.2023|FHEM Version 6.2 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=131618|LinkText=diesem Forenbeitrag}}.}}
{{News|08.11.2021|FHEM Version 6.1 wurde freigegeben. Updatehinweise in {{Link2Forum|Topic=123972|LinkText=diesem Forenbeitrag}}.}}
{{News|25.05.2021|Ein weiteres Modul zur Integration von Diensten der Synology Diskstation wird per Update verteilt: [[SSFile - Integration der Synology File Station|SSFile]].}}
{{News|28.02.2020|Das neue Modul [[SSCal - Integration des Synology Calendar Servers| SSCal]] ermöglicht die Integration des Synology Calendar Servers.}}
{{News|28.01.2020|Neues Modul für die IP-Türsprechanlage [[DoorBird]] per Update verteilt.}}}}
{{News|26.01.2020|FHEM Version 6.0 wurde freigegeben. Updatehinweise: {{Link2Forum|Topic=107782}}}}
{{News|17.12.2019|Mit dem Modul [[SSChatBot - Integration des Synology Chat Servers|SSChatBot]] kann der Synology Chat Server in FHEM integriert werden. Es können Mitteilungen zwischen FHEM und Chat ausgetauscht sowie Befehle in FHEM ausgeführt werden. }}
{{News|23.09.2019|Das Modul [[CanOverEthernet]] ermöglicht das Empfangen von Can-Over-Ethernet Paketen von Steuerungen der Firma Technische Alternative}}
{{News|05.04.2019|Das [[SamsungAV]] Modul ermöglicht die Steuerung von Samsung Fernsehern und Bluray-Playern.}}
{{News|06.03.2019|Mit dem Modul [[Arlo]] ist die Einbindung von Arlo Kameras über die Arlo Cloud möglich}}
{{News|26.01.2019|Das [[TRÅDFRI|tradfri]] Modul erweitert die Palette der [[ZigBee]] Module.}}
{{News|14.01.2019|Der [[FHEM Connector für Amazon Alexa|FHEM Connector]] Skill für Amazon Alexa ist verfügbar.}}
{{News|02.11.2018|Das Modul [[TA_CMI_UVR16x2_UVR1611|TA_CMI_JSON]] kann Werte des C.M.I. der Firma Technische Alternative auslesen und eignet sich so optimal zum Loggen von Daten zB der UVR16x2 oder UVR1611.}}
{{News|11.09.2018|Mit dem Modul [[AutoShuttersControl|AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters. }}
{{News|12.02.2018|Die Module [[Modul Babble|Babble]] und [[Talk2Fhem|Talk2Fhem]] erweitern die Sprachsteuerungsmöglichkeiten von FHEM}}
{{News|02.10.2017|[[FTUI eigene Widgets|Eigene Widgets für FHEM Tablet UI erstellen]]}}
{{News|30.08.2017|[[WINCONNECT]] - Windows PC steuern und Informationen abfragen/anzeigen. }}
{{News|24.08.2017|[[FHEMWEB/Widgets]] - Widgets (Frontendelemente) von FHEMWEB }}
{{News|24.08.2017|Neues Modul [[Modul_YAAHM|YAAHM]] wird per update verteilt. Es stellt eine Oberfläche bereit, um per Webinterface die zyklische Ausführung von Kommandos - mit Tages- und Wochenprofil - zu konfigurieren}}
{{News|24.07.2017|[[Telnet|Verbindung mit dem FHEM-Server per Telnet]]}}
{{News|20.07.2017|[[FHEM startet nicht - Tipps zur Fehlersuche]]}}
{{News|06.06.2017|[[‎Relaisplatine-Homebrew-MySensors|MySensors-Relaisplatine im Selbstbau]]}}
{{News|31.05.2017|[[Datenbankgestützte_Erstellung_der_Energiebilanz_einer_SMA_PV-Anlage_mit_Überschußeinspeisung|Datenbankgestützte Erstellung der Energiebilanz einer PV-Anlage mit Überschußeinspeisung]]}}
{{News|30.04.2017|[[DoorPiBoard]]: Eine Platine zur Umsetzung des [[DoorPi_und FHEM|DoorPi-Projektes]]}}
{{News|21.03.2017|Artikel zum alternativen Frontend [[:Kategorie:FHEM_Tablet_UI|Tablet UI]] aktualisiert und deutlich erweitert}}
{{News|02.03.2017|Neues Modul zur Ansteuerung von [[LGTV_WebOS|LG-TVs mit dem Betriebssystem WebOS]] wird per update verteilt}}
{{News|20.02.2017|Neues Modul [[SIP-Client|SIP]], ein SIP-Client für FHEM, wird per update verteilt}}
{{News|19.02.2017|FHEM Version 5.8 wurde freigegeben. Updatehinweise beachten: {{Link2Forum|Topic=67419}}}}
{{News|18.01.2017|Neues Modul [[DOIFtools]] mit Funktionen zur Unterstützung des Benutzers im Umgang mit [[DOIF]] wird per update verteilt}}
{{News|12.01.2017|Neues Modul zur Ansteuerung des Bluetooth 4.1 BLE Pflanzensensors [[XiaomiFlowerSens|Xiaomi Flower Care Smart Monitor]] wird per update ausgeliefert}}
{{News|01.01.2017|Diverse neue Wiki-Artikel mit Informationen und Hilfen zu [[DOIF#Links|DOIF]] }}
{{News|10.12.2016|FHEM Wiki ist auf einen neuen Server umgezogen und hat eine neue Standard-Internetadresse: https://wiki.fhem.de}}
{{News|21.11.2016|Neues Modul [[Modul_PostMe|PostMe]] stellt eine komfortable Oberfläche zur Listenverwaltung bereit}}
{{News|11.10.2016|Neue Module [[NUKI|NUKIbridge und NUKIDevice]] zur Ansteuerung des Nuki Smartlock werden per update verteilt}}
{{News|07.10.2016|Neues Modul [[TRAFFIC]] zur Erfassung der Fahrzeiten bei aktueller Verkehrslage mittels Google Maps Directions API wird per update verteilt}}
{{News|19.07.2016|Neues Modul zur Unterstützung der HomeMatic-Interfaces [[HM-MOD-RPI-PCB_HomeMatic_Funkmodul_für_Raspberry_Pi|Funkmodul für Raspberry Pi]] und [[HM-LGW-O-TW-W-EU_Funk-LAN_Gateway|Funk-LAN Gateway]] wird per update verteilt }}
{{News|12.07.2016|Neues Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten]] wird per update verteilt }}
{{News|08.02.2016|Neues Modul [[Mediaportal|MEDIAPORTAL]] (Steuerung einer Mediaportal-Installation über Wifiremote) wird per update verteilt}}
{{News|16.11.2015|Neues Modul [[HP1000]] (Einbindung einer HP1000 Wetterstation) wird per update verteilt}}
{{News|16.11.2015|Neuer FHEM Befehl [[msg]] (Intelligentes Versenden/Routing von Nachrichten der Typen Audio,Text,Mail,Push,Light,Screen) wird per update verteilt}}
{{News|15.11.2015|FHEM Version 5.7 wurde veröffentlicht. Unbedingt Updatehinweise beachten: {{Link2Forum|Topic=44094}}}}
{{News|30.10.2015|FHEM Wiki unterstützt nun [[Syntax Highlighting]]}}
{{News|18.10.2015|Neues Modul [[TechemHKV]] (Empfang von Daten eines Techem Heizkostenverteilers) wird per update verteilt}}
{{News|02.10.2015|Kleiner FHEM-Einsteiger-Kurs als Wiki Artikel unter [[Erste_Schritte_in_fhem|Erste Schritte in FHEM]]}}
{{News|24.09.2015|Umfangreiche Überarbeitung der Wiki Artikel über [[:Kategorie:panStamp|panStamp Hardware und Software]]}}
{{News|11.09.2015|Neues Modul [[AMAD]] (Steuern und Informationsanzeige von Android-Geräten) wird per update verteilt}}
{{News|15.06.2015|Neues Modul [[yowsup]] (WhatsApp Unterstützung) wird per update verteilt}}
{{News|03.04.2015|Neues Geräte-Modul [[JawboneUp]] wird per update verteilt}}
{{News|23.03.2015|Neue Geräte-Module [[Modbus]], [[ModbusAttr]] und [[Modbus#Writing_modules_for_devices_using_this_module_as_a_library|ModbusSET]] werden per update verteilt}}
{{News|10.02.2015|FHEM Wiki ist auf einen neuen Server umgezogen und [[FHEMWiki:Interna#Offene_Probleme|Aktualisierung der MediaWiki-Software]]}}
{{News|31.01.2015|Neues Geräte-Modul [[Pushbullet]] wird per update verteilt}}
{{News|14.01.2015|Neues Hilfs-Modul [[CALVIEW]] wird per update verteilt}}
{{News|08.01.2015|Neues Geräte-Modul [[Buderus_Web_Gateway|km200]] zur Anbindung eines Buderus Web-Gateways wird per update verteilt}}
{{News|18.12.2014|Neues Geräte-Modul [[SONOS]] wird per update verteilt}}
{{News|15.12.2014|Überarbeitetes und erweitertes Geräte-Modul [[HTTPMOD]] wird per update verteilt}}
{{News|10.12.2014|Neues Geräte-Modul [[Vitotronic_200_(Viessmann_Heizungssteuerung)|VCONTROL]] zur Anbindung einer Viessmann Heizung wird per update verteilt}}
{{News|17.11.2014|Neues Hilfs-Modul [[logProxy]] wird per update verteilt}}
{{News|09.11.2014|FHEM Version 5.6 wurde veröffentlicht}}
{{News|27.10.2014|Neues Geräte-Modul [[harmony]] zur FHEM-Anbindung Logitech Harmony Hub basierter Fernbedienungen wird per update verteilt}}
{{News|25.10.2014|Neues Geräte-Modul [[KostalPiko|KOSTALPIKO]] wird per update verteilt}}
{{News|24.10.2014|Neues Hilfs-Modul [[HourCounter]] wird per update verteilt}}
{{News|06.09.2014|Neues Hilfs-Modul [[CustomReadings]] per update verteilt}}
{{News|19.08.2014|Neues Hilfs-Modul [[DOIF]] wird per update verteilt}}
{{News|19.08.2014|Der Befehl [[update]] wurde überarbeitet: {{Link2Forum|Topic=26311}} }}
{{News|13.08.2014|Zusätzliche Domäne fhem.org aktiviert: {{Link2Forum|Topic=26113}} }}
{{News|29.09.2013|FHEM Version 5.5 wurde veröffentlicht}}
{{News|11.05.2013|Die meisten Daten aus dem FhemWiki sind wieder hergestellt.}}
{{News|04.05.2013|FHEM Wiki wird neu aufgebaut.}}
{{News|04.05.2013|FHEM Wiki Update zu [[Special:Version|MediaWiki 1.20.5]].}}
|}
<noinclude>[[Kategorie:Vorlage]]</noinclude>

Version

2023-03-08T14:49:34Z

Krikan: Modulowner angwpasst

{{SEITENTITEL:version}}
{{Infobox Modul
|ModPurpose=Befehl zur Bestimmung der Version von FHEM-Modulen
|ModType=cmd
|ModCmdRef=version
|ModForumArea=Sonstiges
|ModTechName=98_version.pm
|ModOwner={{Link2FU|14770|betateilchen}}
}}
[[version]] ist ein Befehl zur Bestimmung der Versionsnummer und des Aktualisierungsdatums einzelner oder aller benutzen Module. Dieser Befehl war vor Revision 10462 direkt in fhem.pl integriert. Seit dieser Revision ist version nun ein eigenständiges Modul, welches in einer eigenen Moduldatei realisiert wird.

Der Befehl kann direkt über das [[FHEMWEB|Webfrontend]] eingegeben werden.

Ohne Angabe von Parametern wird eine komplette Liste aller benutzten Module mit den entsprechenden Detailinformation, sowie den Revisionsstand seit dem letzten Update ausgegeben. Aktuell wird in FHEM bei der Eingabe des Befehls <code>version</code> folgender beispielhafte Output erzeugt:

<pre style="width:600px;">
Latest Revision: 11163

File Rev Last Change

fhem.pl 11144 2016-03-29 09:10:53Z rudolfkoenig
90_at.pm 11151 2016-03-30 07:56:17Z rudolfkoenig
98_autocreate.pm 11094 2016-03-20 09:41:03Z rudolfkoenig
00_CUL.pm 10855 2016-02-15 11:30:02Z rudolfkoenig
10_CUL_HM.pm 11160 2016-03-30 18:39:12Z martinp876
...
</pre>

Wird mit dem Aufruf ein Modulname (Schreibweise beachten! Auf das obige Beispiel bezogen z.B. ''weblink'') mitgegeben, wird nur eine Zeile für das entsprechende Modul ausgegeben. Auch hier sind allerdings komplexere Filter möglich, so kann man mit
:<code>version CUL.*</code>
beispielsweise die folgende Ausgabe erzeugen:
<pre style="width:600px;">
File Rev Last Change

00_CUL.pm 9002 2015-07-29 05:46:10Z rudolfkoenig
09_CUL_FHTTK.pm 7529 2015-01-11 18:52:43Z matscher
10_CUL_HM.pm 9474 2015-10-17 09:27:25Z martinp876
14_CUL_WS.pm 8497 2015-04-30 09:23:21Z rudolfkoenig
</pre>
oder mit
:<code>version fhem</code>
folgende Ausgabe:
<pre style="width:600px;">
File Rev Last Change

fhem.pl 11144 2016-03-29 09:10:53Z rudolfkoenig
</pre>

PRESENCE

2023-03-08T14:47:38Z

Krikan: Modulowner angepasst

{{Infobox Modul
|ModPurpose=Anwesenheitserkennung
|ModType=h
|ModForumArea=Unterstützende Dienste
|ModTechName=73_PRESENCE.pm
|ModOwner=Jörg/JoWiemann ({{Link2FU|94|Forum}} / [[Benutzer Diskussion:JoWiemann|Wiki]])
}}

Das [[PRESENCE]] Modul bietet für die Anwesenheitserkennung mehrere Varianten an:

* '''lan-ping''' - Das Überwachen via PING Checks, die durch den FHEM Server versandt werden.
* '''fritzbox''' - Das Überwachen von Geräten auf einer FritzBox via ctlmgr_ctl (Nur auf einer FritzBox möglich)
* ''' Bluetooth'''
:- '''local-bluetooth''' - Das Überwachen via Bluetooth Checks, die vom FHEM Server direkt durchgeführt werden (angeschlossener Bluetooth-Stick und die Software bluez voraussgesetzt)
:- '''lan-bluetooth''' - Das Überwachen von Bluetoothgeräten, über Netzwerk. Auf einer oder mehreren Maschinen im Netzwerk (z.B. [[:Kategorie:Raspberry Pi|Raspberry Pi]]) läuft ein Presence-Daemon, der nach Bluetooth-Geräten sucht. Um mehrere Presence-Daemon mit FHEM zu verbinden, gibt es den Collector-Daemon, der sich zu allen Presence-Damons im Netzwerk verbindet und das Ergebnis von allen zusammenfasst.
* '''function''' - Das Überwachen mithilfe einer selbst geschrieben Perl-Funktion, die den Anwesenheitsstatus zurückgibt (0 oder 1)
* '''shell-script''' - Das Überwachen mithilfe eines selbst geschriebenen Shell-Programms/Skript, das eine 0 oder 1 ausgibt, um den Anwesenheitsstatus mitzuteilen.

= Überwachen mittels Ping im WLAN/LAN =
{{Randnotiz|RNText=Um diese Methode auf einer FritzBox nutzen zu können, muss FHEM mit root-Rechten laufen. Dies ist standardmäßig nicht der Fall. Bitte dazu den Wiki Artikel [[FritzBox: fhem unter root starten]] beachten.}}
Um ein Gerät via Ping zu überwachen, muss folgende Definition durchgeführt werden:
:<code>define Handy PRESENCE lan-ping 192.168.0.30</code>

Dadurch wird die IP-Addresse 192.168.0.30 alle 30 Sekunden geprüft, ob sie erreichbar ist. Wenn sie erreichbar ist, ist der Status "present" (anwesend), ansonsten "absent" (abwesend).

Der Timeout kann verändert werden, indem ein Wert (in Sekunden) an das Define anhängt wird:
:<code>define Handy PRESENCE lan-ping 192.168.0.30 '''60'''</code>

Nun würde das Handy alle 60 Sekunden geprüft werden.

Nur wenn bei einem iPhone/iPad die Funktion "über WLAN synchronisieren" aktiviert ist, ist es auch im Standby zuverlässig pingbar. Standardmäßig deaktivieren Apple-Geräte ihr WLAN im Standby-Betrieb um die Akkulaufzeit zu verlängern.

Sollte die Fehlermeldung
:<code> PRESENCE (Handy) - ping command returned with output: ping: icmp open socket: Operation not permitted </code>
im Log auftauchen und lan-ping dadurch nicht funktionieren, liegt ein Berechtigungsproblem vor. Kein Grund den User fhem zu root zu machen!
Prüfe zu erst als User root ob die Capabilities gesetzt sind.
:<code>getcap /bin/ping</code>
Sollte folgendes Ergeben zu Tage fördern.
:<code>/bin/ping = cap_net_raw+ep</code>
Ist dem nicht so, setzen wir die benötigten Capabilities
:<code>setcap cap_net_raw+ep /bin/ping</code>
Mehr Informationen zum Thema Capabilities [https://manpages.debian.org/jessie/manpages-de/capabilities.7.de.html].

= FritzBox: direktes Abfragen der Aktivität via ctlmgr_ctl =
{{Randnotiz|RNText=Um diese Methode auf einer FritzBox nutzen zu können, muss FHEM mit root-Rechten laufen. Dies ist standardmäßig nicht der Fall. Bitte dazu den Wiki Artikel [[FritzBox: fhem unter root starten]] beachten.}}
Eine sehr häufige und auch zuverlässige Methode ist auf einer FritzBox die Abfrage mittels ctlmgr_ctl Befehl. Über diesen lassen sich alle Geräte abfragen ob sie aktiv sind. Ist ein Gerät aktiv, so gilt es als anwesend.

Dieser Modus kann allerdings nur in FHEM Installationen direkt auf einer FritzBox verwendet werden. Des weiteren muss FHEM unter dem User root laufen. Um ein Gerät zu überwachen, wird lediglich der Gerätename benötigt, so wie er unter dem Menüpunkt "Heimnetz" auftaucht.

Die erforderliche Definition:
:<code>define Handy PRESENCE fritzbox iPhone-4S</code>

= Überwachung mittels Perl-Code =
Es ist möglich zum Überwachen von Geräten eine eigene Perl-Funktion zu verwenden die dann vom PRESENCE Modul im Hintergrund aufgerufen wird.

define <name> PRESENCE function {...} [ <check-interval> [ <present-check-interval> ] ]

Sobald die Funktion den Rückgabewert 1 hat, ist das Gerät anwesend, bei 0 abwesend.

== Beispiel DHCP Überwachung auf Airport Basestation ==
Die hier vorgestellte Überwachung der DHCP Lease auf Airport Basestations per SNMP ist absolut robust gegenüber dem Ruhezustand von iOS und setzt keine weitere Konfiguration auf dem iPhone voraus. Das Abmelden beim Verlassen des Empfangsbereiches der Basestation geschieht mit etwa 5-10 Minuten Verzögerung und ist somit auch vor kurzzeitigen Empfangsproblemen sicher. Das nebenstehende Bild (???) verdeutlicht noch mal die Unterschiede zwischen einer IP-Basierten Ping-Überwachung und der Überwachung auf Ebene der Basestation oder FritzBox.

Bevor der folgende Code verwendet werden kann ist das Perl Modul Net:SNMP zu installieren (z. B. mit: <code>cpan install use Net::SNMP</code>).

Zuerst ist folgender Code in 99_myUtils.pm einzufügen, sollte diese noch nicht vorhanden sein muss diese aus dem Template welches unter Edit Files zu finden ist erzeugt werden.
'''Achtung, das ist nicht der komplette Inhalt der 99_myUtils!''' Das ist nur die einzelne Routine

<pre>
use Net::SNMP;
sub
snmpCheck($$)
{
my ($airport,$client)= @_;

my $community = "public";
my $host = $airport;
my $oid = ".1.3.6.1.2.1.3.1.1.2";
#my $oid = ".1.3.6.1.2.1.3.1.1.2.25.1.10.0.1";

my ( $session, $error ) = Net::SNMP->session(
-hostname => $host,
-community => $community,
-port => 161,
-version => 1
);

if( !defined($session) ) {
return 0;
return "Can't connect to host $host.";
}

my @snmpoids = ();

my $response = $session->get_next_request($oid);
my @nextid = keys %$response;
while ( @nextid && $nextid[0] && $nextid[0] =~ m/^$oid/ ) {
push( @snmpoids, $nextid[0] );

$response = $session->get_next_request( $nextid[0] );
@nextid = keys %$response;
}

if( !defined($response = $session->get_request( @snmpoids ) ) ) {
return 0;
}

foreach my $value (values %$response) {
return 1 if( $value eq $client )
}

return 0;
}
</pre>

Danach lässt sich das Mobilgerät so überwachen:
:<code>define iPhone PRESENCE function {snmpCheck("10.0.1.1","0x44d77429f35c")} 30 30</code>

wobei 10.0.1.1 durch die IP-Adresse der Basestation und 0x44d77429f35c durch die MAC Adresse des Geräts als HEX-Zahl ersetzt werden muss.

== Beispiel Anwesenheitserkennung mittels UniFi Controller ==

Die Anwesenheitserkennung bei Geräten in Verbindung mit UniFi-Produkten funktioniert selbst dann, wenn sich die Geräte im PowerSave-Modus befinden.

Beachte: Die Geräte werden erst ungefähr nach 5 Minuten, nachdem das Gerät das WLAN verlassen hat als disconnected angezeigt.

<code>define <NAME> PRESENCE function {ReadingsVal("<UniFi>","<NamedDevice>","") eq "connected" ? 1:0}</code>

= Überwachen mittels Events =
Der Vorteil gegenüber der Function-Variante ist, dass diese Variante ohne Blocking.pm-Overhead direkt ausgeführt werden kann und in "Echtzeit" abläuft (siehe {{Link2Forum|Topic=40287|Message=562823}}).

<code>define <NAME> PRESENCE event UniFi:NamedDevice:.disconnected UniFi:NamedDevice:.connected</code>

Dabei wird <UniFi> mit dem Namen des Unifi-Devices in FHEM ersetzt, <NamedDevice> mit dem Namen des zu überwachenden Devices im Unifi-Controller ersetzt.

= Überwachen mittels Bluetooth =
== Vorbereitung und Informationen ==
=== Getestete Hardware/Software ===
* '''Raspbian System''' - wheezy, Jessie (interner BT-Controller)
* '''BT-Dongle''' - CSL NET BT USB2.0 Stick, Bluetooth V4.0, Nano <br />'''Achtung''': Es muss ein BT V4.0 oder höher verwendet werden. Nur dieser unterstützt ''LowEnergy''
* '''BT-TAG''' - Gtag von Gigaset, TrackR, UDOO Neo, PebbleBee, iTag von Unitec, X4-LIFE Multifunkti BL-Anhänger, iTag Wireless Anti, Trackr bravo, GhostyuBeacon iBc41

=== BT-Dongle am RaspberryPI installieren ===
Um den BT-Dongle ''(hier: CSL NET BT USB2.0)'' am RaspberryPI verwenden zu können, müssen die notwendigen Pakete über die Paketverwaltung von debian nachinstalliert werden.
Wer bereits ein BT-Dongle installiert hat, kann diesen Schritt überspringen.
<pre>
apt-get install bluetooth
</pre>
Nach erfolgreicher Installation der Pakete sollte der RaspberryPI neu gestartet werden.
<pre>
sudo reboot
</pre>

Nach dem erfolgten Reboot bitte das Log des RaspberryPI auf folgende Einträge prüfen:
<pre>
Feb 12 19:52:55 fhem kernel: [ 4.773600] Bluetooth: Core ver 2.20
Feb 12 19:52:55 fhem kernel: [ 4.773748] NET: Registered protocol family 31
Feb 12 19:52:55 fhem kernel: [ 4.773765] Bluetooth: HCI device and connection manager initialized
Feb 12 19:52:55 fhem kernel: [ 4.773797] Bluetooth: HCI socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.773821] Bluetooth: L2CAP socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.773890] Bluetooth: SCO socket layer initialized
Feb 12 19:52:55 fhem kernel: [ 4.797531] usbcore: registered new interface driver btusb
</pre>
Sobald der BT-Dongle erkannt wurde ''leuchtet'' (wenn vorhanden) auch die ''blaue/gelbe'' LED am Dongle auf.

=== BT-Tags aktivieren ===
Jetzt kann der BT-Tag aktiviert werden. Bei einigen BT-Tags muss dafür die '''Batteriesicherung''' gezogen werden.

Ein BT-Tag wird mit folgendem Befehl auf der Konsole gesucht:
<syntaxhighlight lang="bash">
sudo hcitool lescan

Ausgabe z.B.:
LE Scan ...
7C:2F:80:A1:XA:XD (unknown)
7C:2F:80:A1:XA:XD Gigaset G-tag
7C:2F:80:A1:X4:X1 (unknown)</syntaxhighlight>
Eine Übersicht über die möglichen Befehle von hcitool gibt es mit der Eingabe von:
<pre>
sudo hcitool

Ausgabe z.B.:
hcitool - HCI Tool ver 5.23
Usage:
hcitool [options] <command> [command parameters]
Options:
--help Display help
-i dev HCI device
Commands:
dev Display local devices
inq Inquire remote devices
scan Scan for remote devices
name Get name from remote device
info Get information from remote device
spinq Start periodic inquiry
epinq Exit periodic inquiry
cmd Submit arbitrary HCI commands
con Display active connections
cc Create connection to remote device
dc Disconnect from remote device
sr Switch master/slave role
cpt Change connection packet type
rssi Display connection RSSI
lq Display link quality
tpl Display transmit power level
afh Display AFH channel map
lp Set/display link policy settings
lst Set/display link supervision timeout
auth Request authentication
enc Set connection encryption
key Change connection link key
clkoff Read clock offset
clock Read local or remote clock
lescan Start LE scan
lewladd Add device to LE White List
lewlrm Remove device from LE White List
lewlsz Read size of LE White List
lewlclr Clear LE White list
lecc Create a LE Connection
ledc Disconnect a LE Connection
lecup LE Connection Update
</pre>

Falls beim SCAN kein BT-Tag gefunden wird, sollte das BT Interface neu gestartet werden. Dazu ist kein Reboot des RaspBerryPI notwendig.
<syntaxhighlight lang="bash">
sudo hciconfig hci0 down
sudo hciconfig hci0 up
sudo hcitool dev
</syntaxhighlight>

== Überwachung durch den FHEM Server direkt ==
[[Datei:Bluetooth-Adresse-iPhone.png|thumb|Bluetooth-Adresse eines iPhones]]
Jenach Aufstellungsort des FHEM Servers kann es sinnvoll sein, eine Bluetooth-Überwachung direkt durch den FHEM Server durchzuführen. Hierbei gilt allerdings zu beachten, dass Bluetooth nicht für große Reichweiten gedacht ist und in den meisten Fällen keine Wände überwinden kann. Das heisst, dass in den meisten Fällen damit nur ein Raum überwacht werden kann.

Je nach Einsatzzweck kann das auch so gewollt sein. Bluetooth USB Sticks, die bereits Bluetooth 4.0 unterstützen, können höhere Reichweiten über Zimmerwände hinaus erreichen. Vorausgesetzt, das Mobilgerät unterstützt Bluetooth 4.0.

Um eine Überwachung per Bluetooth durchführen zu können, benötigt man die Bluetooth-Adresse eines Gerätes. Diese ähnelt vom Aufbau einer MAC-Adresse. Generell wird die Adresse in den Telefon-Informationen bei Smartphones angezeigt.

Um eine Anwesenheitserkennung via Bluetooth durchzuführen, wird folgende Definition in der [[Konfiguration]] benötigt:
:<code>define Handy PRESENCE local-bluetooth XX:XX:XX:XX:XX:XX</code>

== Überwachung durch verteilte Agenten in der Wohnung (presenced/lepresenced/collectord) ==
[[Datei:Raspberry-Pi-mit-WLAN-und-Bluetooth-Stick.jpg|thumb|left|Raspberry Pi mit Bluetooth- und WLAN-USB-Stick]]
Um eine zuverlässige und flächendeckende Bluetooth-Anwesenheitserkennung durchzuführen, ist es unerlässlich, mehrere Bluetooth-Empfänger zu verwenden, die auf mehrere oder alle Räume verteilt sind.

Hierfür bietet sich zum Beispiel ein [[Raspberry Pi]] mit einem Mini-Bluetooth-USB-Stick und evtl. einem WLAN-USB-Stick an. Jeder Raum wird mit solch einem Raspberry ausgestattet und ist im WLAN Netz verfügbar.

Dieses Netz aus Raspberrys wird mit dem presenced / lepresenced Programm ausgestattet. Beide Programme sind Perl-Skripte, die als Daemon im Hintergrund laufen und auf Anfragen via Netzwerk warten. Es wird lediglich eine vollständige Perl-Grundinstallation mit Standardmodulen benötigt.

=== Unterschied presenced / lepresenced / collectord ===
presenced und lepresenced sind Programme, welche in regelmäßigen Abständen nach Bluetooth-Geräten suchen. Sobald ein Gerät, welches vorab definiert wurde, gefunden wird, wechselt der Status des Geräts in FHEM auf Anwesend. Der Unterschied zwischen presenced und lepresenced ist, dass lepresenced insbesondere für [https://de.wikipedia.org/wiki/Bluetooth_Low_Energy Bluetooth-LE-Devices] ist und presenced für "normale" Bluetooth-Geräte.

collectord wiederum ist ein Programm, welches mehrere Pis verbindet und auf allen den aktuellen Status von presenced/lepresenced abfragt. Ist das gesuchte Bluetooth-Gerät auf einem der Pi anwesend, so wird es auch in der definierten Hauptinstanz auf anwesend gesetzt. Zusätzlich wird der Pi auf dem das Gerät gefunden wurde als Reading angegeben. Sofern alle Räume einen Empfangspegel (RSSI) ermitteln können, wird bei mehreren anwesenden Räumen der Raum mit dem besten Empfangspegel selektiert (siehe {{Link2Forum|Topic=54482}}).

=== Installation von (le)presenced ===
Diese Anleitung ist sowohl für presenced, als auch für lepresenced gültig. Einfachheitshalber wird nur lepresenced erwähnt, sämtliche Schritte gehen jedoch auch mit presenced, wobei einfach die genannten Daten durch presenced ersetzt werden müssen.

Die Software lepresenced kann aktuell über drei Varianten installiert werden. Dabei ist die bevorzugte Variante (Variante 1) die Installation über das bereitgestellte .deb-Paket.
Die Variante 2 setzt voraus, dass im FHEM contrib Verzeichnis (/opt/fhem/contrib) die aktuelle Version des .deb-Pakets liegt. Die Variante 3 ist dafür gedacht, wenn man keine .deb-Pakete installieren kann/will oder es aus anderen Gründen nicht funktioniert. Es wird davon abgeraten die Variante 3 zu verwenden. Vollständigkeitshalber wird sie aber aufgeführt.

===== Installation per .deb-Paket =====

Die bevorzugte Variante ist die Installation von lepresenced durch die passenden .deb Pakete.
{{Randnotiz|RNText=Bei einem Upgrade einer älteren Version reicht es, das neue .deb Paket mit
:<code>sudo dpkg -i lepresenced-X.XX-X.deb</code>
zu aktualisieren}}

'''1.Variante:'''
Herunterladen der aktuellen lepresenced-0.83-3.deb (Stand August 2017) Datei über den Webbrowser
[https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/ SVN-Repository]. Im SVN die passende Datei auswählen und in der folgende Webseite den Link unter:
<pre>
Download in other formats:
Original Format
</pre>
anklicken und die Datei herunterladen.
Die Datei kann jetzt auf den RPi kopiert und mit folgenden Befehlen ausgeführt werden (ggf. Berechtigungen anpassen).

Alternativ per wget Befehl direkt auf den RPi (aktuelle Versionsnummer beachten)
https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/lepresenced-0.83-3.deb

'''2.Variante:''' (zu Verwenden, wenn es Probleme bei Variante 1 gibt)
Herunterladen aus dem fhem contrib Verzeichnis:
Hierzu muss das contrib auf dem aktuellen Stand sein. Dazu wird die Installation von subversion (normal bereits vorhanden) benötigt.

sudo apt-get install subversion

Danach kann per
sudo svn checkout https://svn.fhem.de/fhem/trunk/fhem/contrib svnrepo

Das aktuelle Repository auf den Pi heruntergeladen werden. Danach sollte im gewählten Verzeichnis die eingecheckten Dateien verfügbar sein.
/opt/fhem/svnrepo/PRESENCE/deb

''' Installation der Variante 1 oder 2 '''

Egal welche Variante gewählt wurde, nun kann mit folgenden Befehlen das Paket installiert werden. Bitte Pfade ggf. anpassen.

'''Wichtig''': Das '''Paket''' hat eine ca. Größe von '''6,5Kb'''. Ab und an gibt es wohl Probleme mit der Installation, wodurch die Datei 11,5kb groß wird.
Diese Datei lässt sich nicht Installieren. In diesem Fall das Paket bitte mit der Variante 1 und dem Bereich "Download in other formats" herunterladen.

sudo dpkg -i lepresenced-0.83-3.deb

sudo apt-get -f install

Die Ausgabe der Installation sollte am Ende ein [ ok ] Starting lepresenced (via systemctl): lepresenced.service. ausgeben.

<pre>
Paketlisten werden gelesen... Fertig
Abhängigkeitsbaum wird aufgebaut.
Statusinformationen werden eingelesen.... Fertig
Abhängigkeiten werden korrigiert ... Fertig
Die folgenden zusätzlichen Pakete werden installiert:
bluez-hcidump
Die folgenden NEUEN Pakete werden installiert:
bluez-hcidump
0 aktualisiert, 1 neu installiert, 0 zu entfernen und 0 nicht aktualisiert.
1 nicht vollständig installiert oder entfernt.
Es müssen 157 kB an Archiven heruntergeladen werden.
Nach dieser Operation werden 490 kB Plattenplatz zusätzlich benutzt.
Möchten Sie fortfahren? [J/n]
Holen: 1 http://archive.raspberrypi.org/debian/ jessie/main bluez-hcidump armhf 5.23-2+rpi2 [157 kB]
Es wurden 157 kB in 0 s geholt (921 kB/s).
Vormals nicht ausgewähltes Paket bluez-hcidump wird gewählt.
(Lese Datenbank ... 42033 Dateien und Verzeichnisse sind derzeit installiert.)
Vorbereitung zum Entpacken von .../bluez-hcidump_5.23-2+rpi2_armhf.deb ...
Entpacken von bluez-hcidump (5.23-2+rpi2) ...
Trigger für man-db (2.7.0.2-5) werden verarbeitet ...
bluez-hcidump (5.23-2+rpi2) wird eingerichtet ...
lepresenced (0.82-1) wird eingerichtet ...
[ ok ] Starting lepresenced (via systemctl): lepresenced.service.
</pre>

'''3.Variante:'''

Bei dieser Variante wird das aktuellste lepresenced Skript aus github heruntergeladen. Das bedeutet, dass jegliche Konfiguration wie automatischer Start, Berechtigungen etc.
manuell konfiguriert werden muss. Diese Variante eignet sich nur für diejenigen, die keine .deb-Pakete installieren wollen/können oder die genau Wissen, was sie tun!
<pre>
https://github.com/mhop/fhem-mirror/blob/master/fhem/contrib/PRESENCE/lepresenced
</pre>

Zur "Installation" des Skripts folgendermaßen vorgehen:
Unter /fhem manuell den Ordner „script“ anlegen:
<pre>
mkdir script
</pre>
Datei lepresenced reinkopieren und ausführbar machen:
<pre>
sudo chmod +x /opt/fhem/script/lepresenced
sudo chgrp -cR dialout lepresenced
</pre>
Skript erstmalig starten:
<pre>
sudo ./lepresenced --loglevel LOG_EMERG -d
</pre>
Kommt beim Starten des Skript eine Fehlermeldung, müssen die Abhängigkeiten aufgelöst werden.
<pre>
Can't locate Net/Server/Daemonize.pm in @INC (@INC contains: /etc/perl /usr/local/lib/perl/5.14.2 /usr/local/share/perl/5.14.2 /usr/lib/perl5 /usr/share/perl5 / usr/lib/perl/5.14 /usr/share/perl/5.14 /usr/local/lib/site_perl .) at /opt/fhem/lepresenced line 17.
BEGIN failed--compilation aborted at /opt/fhem/lepresenced line 17.
</pre>
Um die Abhängigkeiten aufzulösen muss folgendes nachinstalliert werden und anschließend ein Reboot durchgeführt werden.
<pre>
sudo apt-get install libnet-server-*
</pre>

===== Einrichtung eines Bluetooth-Geräts über FHEM =====

Nach dem letzten Schritt sind alle Bedingungen für eine abschließende Konfiguration eines BT-Geräts in FHEM abgeschlossen worden.
Jetzt kann der zum Beispiel ein G-Tag dem FHEM-Server bekannt gemacht werden:
<pre>
-- Name Modul Modus MAC vom Gtag IP vom PI Port Abfragezeit in Sekunden
define MeinGtAG PRESENCE lan-bluetooth xx:xx:xx:xx:xx:xx 127.0.0.1:5333 120
</pre>

'''Wichtig ist den angegeben Port zu unterscheiden. Für presenced muss der Port 5111 genommen werden, für lepresenced der Port 5333.'''
Den absent und present Mode kann man einfach testen, in dem man den Gtag mit Alufolie einwickelt.

Diese Variante sollte eingesetzt werden, wenn nur ein Pi nach Bluetooth-Geräten sucht. Möchte man mehr als ein Gerät nutzen um zum Beispiel eine größere Fläche abzudecken so muss mit collectored gearbeitet werden.

=== Alle Räume gemeinsam ansprechen mittels collectord ===
Um zwei presenced- oder lepresenced Installationen zu verbinden wird der collectord Daemon von Markus Bloch benötigt. Dieser kennt alle presenced-Installationen im Netzwerk und führt eine koordinierte Suche nach den gewünschten Geräten durch. Sobald ein Gerät in einem Raum erkannt wurde, meldet der collectord den Status einschließlich der Angabe des Raumes, in dem das Gerät erkannt wurde.

[[Datei:Presence_Collectord_Uebersicht.jpg|200px|thumb|left|Schematische Darstellung Presence und Collectord, Danke an dtavb]]
Auf Basis folgender Skizze wird die Einrichtung und der Betrieb der Anwesenheitserkennung und Überwachung <p></p>
mit dem PRESENCE-Modul sowie dem Skript (.deb-Paket) lepresenced beschrieben. Zusätzlich wird für die Verbindung <p></p>
mehrere lepresenced Instanzen der collectord verwendet.<p></p>
Diese Skizze dient als Basis für alle genannten Konfigurationen innerhalb dieses Artikels.
{{NeuerTextBlock}}

==== Aufbau ====
; RPi1 (Hauptinstanz):
: FHEM Installation
: presence/lepresenced Installation
: collectord installation
: Sämtliche Bluetooth-Geräte in FHEM definiert
; RPi2 (Zweitsystem):
: FHEM installation
: presence/lepresenced Installation
: Sämtliche Bluetooth-Geräte in FHEM definiert

==== Installation per .deb-Paket ====
collectord wird heruntergeladen und installiert:
https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/PRESENCE/deb/collectord-1.8.deb (Stand Januar 2018)
<pre>
sudo dpkg -i collectord-1.8.deb
</pre>

Nach der Installation befindet sich im Verzeichnis: /etc/collectord.conf die Konfigurationsdatei für das collectord. Weitere Einstellungen können unter /etc/default/collectord vorgenommen werden.

==== Konfiguration auf Shellebene ====
<pre>
sudo vi /etc/collectord.conf
</pre>

Diese Datei muss jetzt nach folgender Vorlage angepasst werden.
<pre>
# room definition
#[room-name] # name of the room
#address=192.168.0.10 # ip-address or hostname
#port=5111 # tcp port which should be used (5111 is default)
#presence_timeout=120 # timeout in seconds for each check when devices are present
#absence_timeout=20 # timeout in seconds for each check when devices are absent

[RPi1] # Name (wird als Reading room bei den BT-Tags angezeigt) der presence Instanze
address=127.0.0.1 # Lokale Adresse RPi1 , da hier das Collectord später laufen soll!
port=5333 # Port der Presence Installation
presence_timeout=60 # Selbstgewaehlte Pruefintervalle
absence_timeout=60 # Selbstgewaehlte Pruefintervalle

[RPi2] # Name (wird als Reading room bei den BT-Tags angezeigt) der presence Instanze
address=192.168.178.127 # IP-Adresse der Instanz, wo nur das Presence laueft, also RPi2
port=5333 # Port der Presence Installation
presence_timeout=60 # Selbstgewaehlte Pruefintervalle
absence_timeout=60 # Selbstgewaehlte Pruefintervalle
</pre>

Hinweis:
* Es dürfen keine [Namen] mit Leerzeichen verwendet werden
* Der angegebene Port richtet sich danach, ob auf dem Pi presenced (Port 5111) oder lepresenced (Port 5333) nach dem Bluetooth-Gerät sucht

==== Konfiguration in FHEM ====
;RPi1
define Gtag PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222 60 ''Hinweis: (Der Port ist der, des collectord!! Standard 5222)''
;RPi2
define Gtag PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 192.168.178.127:5222 60 ''Hinweis: (Der Port ist der, des collectord!! Standard 5222 - die IP-Adresse von die von RPi1)''

Nach der Konfiguration kann der Daemon gestartet werden.
Sobald das Bluetoothgerät irgendwo in der Wohnung erkannt wurde, meldet der Collectord dies sofort
an FHEM und teilt den Raum mit in dem es erkannt worden ist. Diese Information wird im Reading "rooms" des jeweiligen BT-Gerätes dargestellt.

Zum testen sollte collectord einmalig manuell gestartet werden. Dies hat den Vorteil, dass man nochmal den Port des collectord prüfen kann, dieser steht in der Zeile <pre>created socket on 0.0.0.0 with port 5222</pre> und man sehen kann, ob der collectord richtig startet, oder Fehler auswirft. Gestartet wird mit folgendem Kommando:
<pre>
sudo collectord -vv -c /etc/collectord.conf
</pre>
Die Ausgabe sieht wie folgt aus:
<pre>
2017-04-02 17:52:55 - =================================================
2017-04-02 17:52:55 - started with PID 15554
2017-04-02 17:52:55 - reading configuration file
2017-04-02 17:52:55 - no config errors found
2017-04-02 17:52:56 - created socket on 0.0.0.0 with port 5222
2017-04-02 17:53:20 - new connection from 127.0.0.1:48656
2017-04-02 17:53:20 - created thread 1 for processing device 7C:2F:80:E1:14:31 in room RPi2 for peer 127.0.0.1 (UUID: d0beb79dd4771532eb5e207c7bf31788)
2017-04-02 17:53:20 - created thread 2 for processing device 7C:2F:80:E1:14:31 in room RPi1 for peer 127.0.0.1 (UUID: d0beb79dd4771532eb5e207c7bf31788)
2017-04-02 17:53:20 - new connection from 127.0.0.1:48662
2017-04-02 17:53:20 - new connection from 127.0.0.1:48664
2017-04-02 17:53:20 - created thread 3 for processing device 7C:2F:80:ED:BC:F7 in room RPi2 for peer 127.0.0.1 (UUID: 7495a112063d5db45e6335d3fe305e36)
2017-04-02 17:53:20 - created thread 4 for processing device 7C:2F:80:ED:BC:F7 in room RPi1 for peer 127.0.0.1 (UUID: 7495a112063d5db45e6335d3fe305e36)
2017-04-02 17:53:20 - created thread 5 for processing device 7C:2F:80:E1:2A:4D in room RPi2 for peer 127.0.0.1 (UUID: c228f8d4d33b06787f995c7903c02760)
2017-04-02 17:53:20 - created thread 6 for processing device 7C:2F:80:E1:2A:4D in room RPi1 for peer 127.0.0.1 (UUID: c228f8d4d33b06787f995c7903c02760)
2017-04-02 17:53:22 - new connection from 192.168.xxx.xxx:51638
2017-04-02 17:53:22 - created thread 7 for processing device 7C:2F:80:E1:14:31 in room RPi2 for peer 192.168.xxx.xxx (UUID: 5db7012e709d6dc2fcd8159fc0344e40)
2017-04-02 17:53:22 - created thread 8 for processing device 7C:2F:80:E1:14:31 in room RPi1 for peer 192.168.xxx.xxx (UUID: 5db7012e709d6dc2fcd8159fc0344e40)
2017-04-02 17:53:22 - new connection from 192.168.xxx.xxx:51640
2017-04-02 17:53:22 - created thread 9 for processing device 7C:2F:80:ED:BC:F7 in room RPi2 for peer 192.168.xxx.xxx (UUID: c4b4d7c654132cf88e8c1fec3a956d3d)
2017-04-02 17:53:23 - created thread 10 for processing device 7C:2F:80:ED:BC:F7 in room RPi1 for peer 192.168.xxx.xxx (UUID: c4b4d7c654132cf88e8c1fec3a956d3d)
2017-04-02 17:53:29 - new connection from 192.168.xxx.xxx:51642
2017-04-02 17:53:29 - created thread 11 for processing device 7C:2F:80:E1:2A:4D in room RPi2 for peer 192.168.xxx.xxx (UUID: ecd7081e5ae3a0d8e735c8750cb116a1)
2017-04-02 17:53:29 - created thread 12 for processing device 7C:2F:80:E1:2A:4D in room RPi1 for peer 192.168.xxx.xxx (UUID: ecd7081e5ae3a0d8e735c8750cb116a1)
</pre>

Wenn das Log wie oben abgebildet aussieht wurde alles richtig gemacht und unter dem Device in FHEM erscheint ein neues Reading "rooms" mit dem Wert der erkannten PRESENCE-Installation.

'''Verhalten presence timeout im zusammenhang mit dem Attribut "absenceThreshold" der PRESENCE Konfiguration in FHEM'''
<br>
In der collectord.conf sind <code>presence_timeout</code> und <code>absence_timeout</code> für den jeweiligen Raum konfiguriert.
Das bedeutet, sobald irgendein Gerät in diesem jeweiligen Raum anwesend/abwesend ist, wird das jeweilige Timeout an den verbundenen presenced/lepresenced geschickt um damit das Check-Interval entsprechend zu ändern.

In der PRESENCE-Definition kann man ebenfalls ein <code>absence_timeout</code>/<code>presence_timeout</code> setzen. Sobald sich der Zustand ändert, wird auch das jeweilige Timeout an den collectord gesandt. Dies hat aber auf die Checks in den jeweiligen Räumen und damit der collectord.conf keinen Einfluss. Der collectord schickt ein Statusupdate an PRESENCE nur, wenn das vorgegebene Timeout (von PRESENCE) erreicht ist und keine Statusänderung stattfand. Sobald eine Änderung des Status erfolgt wird natürlich sofort der Status an PRESENCE geschickt.

Das Attribut absenceThreshold/presenceThreshold funktioniert nachwievor. Hier ist nur wichtig wie man die Timeouts sowohl in PRESENCE als auch collectord.conf setzt.

'''Das Reading "room" bei einer PRESENCE Definition und der Zusammenhang zu collectord'''
<br>
Wenn ein BT LE Empfänger in mehr als einem Raum detektiert wird, führt der collectord (ab Version 1.8) eine RSSI-Erkennung durch. Sofern alle Räume den Empfangspegel (RSSI) ermitteln können, wird der Raum mit dem besten Empfangspegel als Raum für das "room"-Reading ausgewählt. Der lepresenced in aktueller Version von PatrickR gibt immer den Empfangspegel aus.

==== Automatischer Start ====
Wenn der collectord per .deb Paket installiert wurde, startet er automatisch bei einem Reboot mit (via systemd/init-Skript).
<br>

Der Collectord wird standardmäßig mit dem Port 5222 gestartet. Um diese anzupassen sind zwei Schritte notwendig:<br>
'''1.)''' Anpassen der /usr/bin/collectord
Hier bitte den Parameter my $opt_p von 5222 auf 5XXX abändern.

Da der collectord mittlerweile per systemd beim reboot des RPi gestarte wird muss auch diese Konfiguration auf den neuen Port angepasst werden.<br>
'''2.)''' Anpassen der /etc/default/collectord
<pre>
# collectord startup defaults:
# The TCP port collectord will listen for incoming connections (default: 5222)
PORT=5111
# The location of the configuration file (default: /etc/collectord.conf
CFGFILE=/etc/collectord.conf
</pre>

Manuell starten als Daemon (Parameter <code>-d</code>) mit:
<pre>
sudo collectord -c /etc/collectord.conf -d -v -l /var/log/collectord.log
</pre>

== Batterieüberwachung ==

=== Batterieüberwachung mit dem Modul BleTagBattery ===
{{Infobox Modul
|ModPurpose=Anwesenheitserkennung
|ModType=h

|ModTechName=74_BleTagBattery
|ModOwner=mumpitzstuff
}}
Mit dem Modul BleTagBattery - kann der Batteriestatus aller BT-LE Devices gelesen werden.
Es werden die Readings batteryLevel und battery angelegt für diejenigen BT-LE Tags, die an einer PRESENCE-Installation registriert wurden.

Vorraussetzung und Installation:

Bluez und Gattool
sudo apt-get install bluez

Das Gattool ist in den Installationen von Bluez inbegriffen.

Hinzufügen des githup für das Modul
update add http://raw.githubusercontent.com/mumpitzstuff/fhem-BleTagBattery/master/controls_bletagbattery.txt
update all
restart fhem: shutdown restart
BT-LE tags muss an einer PRESENCE-Installation des type "lan-bluetooth" registriert sein.

Nach dem Neustart von FHEM kann das Modul definiert werden:
define a new device: define <name of device> BleTagBattery

Das Modul versucht in der Standardkonfiguration alle 6 Stunden die BT-LE Devices zu erreichen und das Reading batteryLevel und battery zu aktualisieren.
Das Update kann auch manuell mit dem folgenden Befehl erzwungen werden

set <name of device> statusRequest.

Weiter Informationen und Disskussionen können dem eigentlichen [https://forum.fhem.de/index.php?topic=68104.0 Forumsbeitrag] entnommen werden,

=== Batterieüberwachung (aktuell nur G-Tags) ===

Leider überträgt der G-Tag nach der Einrichtung als Device in FHEM kein Reading mit seinem aktuellen Batteriestatus.
Dem wurde mit Hilfe des Forum Abhilfe geschaffen.
Im Folgenden wird erläutert wie die Batterieüberwachung eingerichtet werden kann.

'''Voraussetzung:'''

bc - Basiscalculator [https://packages.debian.org/de/sid/bc Bc-Paket]
<pre> sudo apt-get install bc </pre>

Anlegen eines Shellskript auf dem Raspberry System.
Die Parameter <<MAC-Adresse>> und <<TagName>> müssen durch die Werte des auszulesenden G-Tags ersetzt werden.
<pre>
#!/bin/bash
stringZ=$(sudo gatttool -b 5C:2B:80:C1:14:41 --char-read --handle=0x001b)
stringZ=${stringZ:33:2}
stringZ=$(echo "$stringZ" | tr a-f A-F)
decimal=$(echo "ibase=16; $stringZ" | bc)
perl /opt/fhem/fhem.pl 7072 "setreading MeinGtag Batterie $decimal"
</pre>

Dem Device in FHEM (hier MeinGtag) ein userReading mit dem Namen '''Batterie''' hinzufügen.
Das Shellskript mit folgendem Befehl starten:
<pre>
./GtagBatterie.sh
</pre>
'''Wichtig ist hierbei,''' dass Skript mit "./" und nicht mit "sh" aufzurufen. Beim Aufruf mit "sh GtagBatterie.sh" produziert es einen Fehler
<pre>GtagBatterie.sh: 3: GtagBatterie.sh: Bad substitution </pre>

Das Reading wird auf den ausgelesenen Wert der Batterie gesetzt.

Hinweis: Es sollte für jeden G-Tag ein eigenes Skript abgelegt werden. Das Skript kann per crontab oder fhem Kommando (system) regelmäßig aufgerufen werden.

=== Batterieüberwachung (alle Devices vom Typ "MODE=lan-bluetooth") ===

Es gibt eine weitere Möglichkeit um den Batteriestatus von LE Devices abzurufen und in FHEM als Reading darzustellen.
Dabei wird der Batteriezustand für alle LE Devices, die bereits in FHEM konfiguriert sind und per lepresenced überwacht werden, automatisch in einem shell-Script ermittelt.
Näheres dazu im Forumartikel {{Link2Forum|Topic=56960|LinkText=Erweiterung: Anwesenheitserkennung/Batterieüberwachung}}.

Vorteile:
* Automatische Ermittlung aller in FHEM konfigurierten LE Devices
* Möglichkeit, diese Devices alternativ manuell im Script einzutragen
* Es werden nur Devices abgefragt, die im Status "present" sind, also mit ziemlicher Sicherheit auch verfügbar sind
* Ein eventuell auf dem FHEM telnet-Port gesetztes Passwort kann im Script hinterlegt werden

'''Voraussetzung:'''

'''Funktionierendes lepresenced''' - siehe [[Anwesenheitserkennung#Anleitung_f.C3.BCr_ein_LE_Device_.28z.B._Gtags.2CPebbles_etc..29|Anleitung für ein LE Device (z.B. Gtags,Pebbles etc.)]]

'''socat''' - TCP port forwarder
<pre>
sudo apt-get update && sudo apt-get install socat
</pre>

'''gawk''' - Zum extrahieren der Daten
<pre>
sudo apt-get update && sudo apt-get install gawk
</pre>

'''gatttool''' - Bestandteil von bluez

gatttool ist auf den meisten Distributionen im bluez-Paket, allerdings nicht bei Opensuse. Dort muss man das Sourcepaket von bluez installieren und selbst kompilieren.
gatttool sollte dann nach /usr/bin oder /usr/local/bin kopiert werden,

Zusätzlich zu den notwendigen Erweiterungen werden für die Ausführung von gatttool '''Root-Rechte benötigt'''!

Das Script selbst gibt es hier: [https://raw.githubusercontent.com/micky0867/lebattery/master/lebattery lebattery]

Am Besten unter /opt/fhem/script/lebattery speichern und ausführbar machen:
<syntaxhighlight lang="bash">
sudo su -
mkdir /opt/fhem/script
cd /opt/fhem/script
wget https://raw.githubusercontent.com/micky0867/lebattery/master/lebattery
chmod 755 lebattery
</syntaxhighlight>

Je nach Bedarf können im Script noch die folgenden 3 Parameter angepasst werden:
<syntaxhighlight lang="bash">
# If allowed_telnetPort is protected by a password, add the password here
TELNETPASSWORD=""
# Attribute for batterylevel in FHEM
ATTRIBUT="batterylevel"
# Use this, if you dont want the script to determine the tags on its own
LETAGS=""
</syntaxhighlight>

Das Skript wird dann unter root folgendermaßen gestartet:
<pre>
/opt/fhem/script/lebattery -v
</pre>

Ausgabe des Skripts, wenn es mit dem Verbose Parameter -v gestartet wird.

Beide Devices sind vom Typ NUT mini, das Device mit dem FHEM-Namen '''nut_Micky''' ist im Status '''absent'''. Das zweite Device ist im Status '''present'''.
<pre>
Determining address for nut_Micky ...
nut_Micky is in state absent, no further action required

Determining address for nut_Test ...
Fetching batterylevel for nut_Test (F3:44:04:81:54:89) ...
Setting batterylevel for nut_Test to 100%
</pre>

Mein crontab-Eintrag (User root) sieht so aus:
<pre>
3 3 * * * /opt/fhem/script/lebattery -v >/opt/fhem/script/lebattery.log 2>&1
</pre>
Damit wird jeden Morgen um 3 Minuten nach 3 Uhr der Zustand der Batterien aller Devices ermittelt und in FHEM abgespeichert.<br>
Bevor man das mit crontab macht, sollte man allerdings zunächst sicher stellen, dass es auch ohne crontab funktioniert....

Bei Problemen kann man auch erstmal schauen, ob das mit dem gattool überhaupt funktioniert:
<pre>
gatttool -t <Typ> -b <MAC-Adresse> --char-read --uuid 0x2a19

handle: 0x0017 value: 64
</pre>
In diesem Fall hat die Batterie noch 100% (hex 64).<br>
Der Typ ist abhängig vom Hersteller und kann public (G-Tags) bzw. random (Nut) sein. Im Zweifelsfall beides ausprobieren.

= Beispiele =
== Anwesenheitserkennung / Anwesenheitsbenachrichtigung mit G-Tags ==
Ein Skript zur Nutzung der Gigaset G-TAGs zur Alarmierung bei öffnen und schließen von Türen und zur Anwesenheitserkennung, um die Alarmierung zu aktivieren bzw. deaktivieren.
Es kann verwendet werden um die Anwesenheit von mehrern Personen im Haushalt zu erkennen. Dabei wird eingeschränkt, dass nur bestimmte Personen die Alarmierung aktivieren können ( Eltern/Kind -Beziehung ).
Des Weiteren werden im Beispiel die Eltern benachrichtigt wenn eins der Kinder das Haus verlässt und die Eltern nicht anwesend sind.

{{Randnotiz|RNText=Namen der G-Tags in den Skripten bitte anpassen!}}

Für die ''Notify'' und die ''RESIDENTS-Erweiterung'' wird ein Dummy benötigt.
<pre>
define Alarm dummy
attr Alarm devStateIcon aktiv:secur_locked@red inaktiv:secur_open@lightgreen
attr Alarm eventMap on:aktiv off:inaktiv
attr Alarm setList on off
attr Alarm webCmd aktiv:inaktiv
attr Alarm room Alarm
</pre>

=== Mit Notify ===
<pre>
gtag.*.presence:.* {Anwesenheit_check("$EVTPART1", "$NAME")}
</pre>

Code für die 99_myUtils.pm
<pre>
### GTAG ANWESENHEITS CHECK
sub Anwesenheit_check($$) {
my ($EVENT, $NAME) = @_;

# gtag_rot - Alias Marco
# gtag_schwarz - Alias Ulli
# gtag_gruen - Alias Frida
# gtag_orange - Alias Hannah

my $RESIDENT = "rr_"; # Alle GTAGs sind Standardmäßig Residents Roommate
# $RESIDENT = "rg_" if (($NAME eq "gtag_orange") xor ($NAME eq "gtag_weis")); # Hier nur Gäste (Roomguest) Auskommentiert, da ich es so nicht brauche
my $ROOMMATE = ("$RESIDENT" . "$NAME"); # Residentsname zusammenbauen
my $ALIASNAME = AttrVal($ROOMMATE,'alias',$ROOMMATE); # ALIAS des Roommates auslesen

my $GTAG1 = Value('gtag_rot'); # ELTERN
my $GTAG2 = Value('gtag_schwarz'); # ELTERN

my $STATUS = "wahrscheinlich gerade los";
$STATUS = "anwesend" if ($EVENT eq "present"); # Status: anwesend
$STATUS = "unterwegs" if ($EVENT eq "absent"); # Status: unterwegs

Log 1, "$ALIASNAME ist $STATUS."; # LOG Eintrag erzeugen

if (($EVENT eq "present" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_gruen" xor $NAME eq "gtag_orange")) {
fhem("set teleBot send ALARMIERUNG BLEIBT AKTIV: $ALIASNAME ist da..."); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG BLEIBT AKTIV' '$ALIASNAME ist da...'"); # Pushover
}
elsif (($EVENT eq "present" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_rot" xor $NAME eq "gtag_schwarz")) {
fhem("set teleBot send ALARMIERUNG INAKTIV: $ALIASNAME ist da...; set Alarm inaktiv"); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG INAKTIV' '$ALIASNAME ist da...'; set Alarm inaktiv"); # Pushover
}
elsif (($EVENT eq "absent" && Value("Alarm") eq "aktiv") && ($NAME eq "gtag_gruen" xor $NAME eq "gtag_orange")) {
fhem("set teleBot send ALARMIERUNG BLEIBT AKTIV: $ALIASNAME hat das Haus verlassen."); # Telegram
# fhem("set Infopush msg 'ALARMIERUNG BLEIBT AKTIV' '$ALIASNAME hat das Haus verlassen.'"); # Pushover
}
elsif (($EVENT eq "absent" && Value("Alarm") eq "inaktiv") && ($GTAG1 eq "absent" && $GTAG2 eq "absent")) {
fhem("set Alarm aktiv; set teleBot send ALARMIERUNG AKTIV: $ALIASNAME hat das Haus verlassen."); # Telegram
# fhem("set Alarm aktiv; set Infopush msg 'ALARMIERUNG AKTIV' '$ALIASNAME hat das Haus verlassen.' '' 0 ''"); # Pushover
}
}
</pre>

<br>

=== Mit Notify und Integration des RESIDENTS-MODUL ===

Der hier beschriebene Code erweitert die Funktionen unter dem Punkt 5.93.
Das Notify muss daher mit der folgenden Zeile erweitert werden.

<pre>
define Alarm_AnwesenheitCheck notify gtag.*.presence:.* { Anwesenheit_check("$EVTPART1", "$NAME"), Anwesenheit_check_resi("$NAME") }
</pre>

Zusätzlicher Code für die 99_myUtils.pm um die RESIDENTS Funktion nutzen zu können:
<pre>
### RESIDENTS
sub Anwesenheit_check_resi($) {
my ($NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME); # ALIASNAME des GTAGs auslesen

my $RESIDENT = "rr_"; # Als Standard sind alle GTAGs Roommates
$RESIDENT = "rg_" if (($NAME eq "gtag_orange") xor ($NAME eq "gtag_weis")); # Hier nur GTAG Namen der Gäste (Roomguest)
my $ROOMMATE = ("$RESIDENT" . "$ALIASNAME"); # Residentsname zusammenbauen

if (ReadingsVal($NAME,'presence',$NAME) eq "absent") {
fhem("set $ROOMMATE absent"); # Resisents Status von Roommates setzen
}
elsif(ReadingsVal($NAME,'presence',$NAME) eq "present") {
fhem("set $ROOMMATE home"); # Resisents Status von Roommates setzen
}
}
</pre>
<br>

=== Mit Notify und Fenster/Tür. -Kontakt Überwachung ===

Erweiterung für die Überwachung von Fenster/Tür. -Kontakten. Dazu sind zwei weitere Notifys notwendig die auf die Trigger der Kontakte regagieren
und so eine weitere Funktion in der 99_myUtils.pm ansprechen. Die Notifys triggern auf Kontakte die mit dem Namen Kontakt* beginnen.
Sollten die eigenen Fenster/Tür. -Kontakt anderen Namen besitzen, müssen die Skripte dementsprechend angepasst werden.
<pre>
define Alarm_Kontaktmeldung notify Kontakt.*:contact:.* {Kontakt_Meldung("$EVTPART1", "$NAME")}
</pre>
<pre>
define Alarm_Sabotagealarm notify Kontakt.*.sabotageError:.on {Kontakt_Sabotage("$EVTPART1", "$NAME")}
</pre>

Zusätzlicher Code für die 99_myUtils.pm um die TÜRKONTAKTE-Meldung nutzen zu können:
<pre>
### TÜRKONTAKTE-Meldung/Zustand
sub Kontakt_Meldung($$) {
my ($EVENT, $NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME);
Log 1, "$ALIASNAME wurde $EVENT";
if (ReadingsVal("Alarm", "state", "on") eq "on") {
fhem("set teleBot send $ALIASNAME wurde $EVENT"); # Nachricht über Telegram
# fhem("set Infopush msg '$ALIASNAME' '$ALIASNAME wurde $EVENT'"); # Nachricht über Pushover
}
}

### TÜRKONTAKTE-Sabotagealarm

sub Kontakt_Sabotage($$) {
my ($EVENT, $NAME) = @_;
my $ALIASNAME = AttrVal($NAME,'alias',$NAME);
Log 1, "$ALIASNAME meldet Sabotagealarm";
fhem("set teleBot send Alarm: $ALIASNAME meldet Sabotagealarm"); # Nachricht über Telegram
# fhem("set Infopush msg 'Alarmanlage' '$ALIASNAME meldet Sabotagealarm' '' 2 ' ' 60 600 "); # Nachricht über Pushover
}
</pre>
<br>

=== Hinweis zur Benutzung / Fehlerhandling ===

Der Alarm dummy hat den Zustand on:off. Die Bezeichnungen und Namen müssen 1:1 übernommen werden damit das Script funktioniert.
Andernfalls müssen die Bezeichnungen für z.B. absent:unterwegs und present:anwesend - angepasst werden.
Die Benachrichtigung kann aktuell per ''[[TelegramBot|Telegram]]'' sowie ''Pushover'' ('''Achtung mit zweiterem sind Abokosten verbunden!''') realisiert werden.
Diskussion zum Thema im Forum unter: {{Link2Forum|Topic=64080}}
<br>

= Problemlösungen =

'''Absent - Grundlos / Zufällig''' 2022

Zufällige oder Grundlose absent-Meldungen einzelner G-Tags können mit einem FIX behoben werden. Dazu ist es notwendig die BT-Firmware downzugraden.

Auf GIT das .deb Paket herunterladen und auf das jeweiligen System kopieren

wget <nowiki>https://github.com/winterheart/broadcom-bt-firmware/releases/download/v12.0.1.1105_p3/broadcom-bt-firmware-10.1.0.1115.deb</nowiki>

Anschliessend installieren und das System neu starten.

sudo dpkg -i broadcom-bt-firmware-10.1.0.1115.deb
{{Randnotiz|RNText= Dieser FIX scheint nicht bei jedem zu funktionieren! Es gibt auch System die Problemlos ohne FIX arbeiten. Bei einem Update/Upgrade des RPI muss der FIX - wenn notwendig - wieder erneut installiert werden.}}

Danach sollten die Tags wieder Problemlos erkannt werden und nicht nach wenigen Tagen wieder auf "absent" stehen.

Falls es '''Probleme beim Starten des Skripts''' gibt bzw. man das Skript ohne Reboot des Systems neustarten möchte, kann man dies per kill Befehl erledigen.

Das Thema wurde u.a in [https://forum.fhem.de/index.php?topic=75559.new;topicseen#new diesem] Beitrag beschrieben.
<syntaxhighlight lang="bash">
ps -ef | grep lepresenced
sudo kill <pid>
</syntaxhighlight>

Debuglevel lepresenced setzen:
{{Randnotiz|RNText=Um Debug-Meldungen zu bekommen (Vorsicht bei SD-Karten-Systemen wie dem RPi) - Hierbei werden die Schreibzyklen auf die SD-Karte erhöht.}}

Der Log Level muss im lepresenced-Skript selbst verändert werden. Um den Log-Level auf INFO/WARNING/DEBUG zu setzen, das Skript lepresenced mit einem Editor öffnen und die Stellen, wo LOG_WARNING zu finden ist, durch den nötigen LOG-Eintrag ersetzen.

<pre>
lepresenced --loglevel LOG_DEBUG
</pre>
Nur das wichtigste Loggen:
<pre>
lepresenced --loglevel LOG_WARNING
</pre>
Keinerlei LOG-Einträge
<pre>
lepresenced --loglevel LOG_EMERG
</pre>

Bei '''Problemen mit der Batterieüberwachung''' der Tags kann die Pi Firmware mit folgenden Befehl auf eine ältere Version zurückgesetzt werden.
Fehlermeldung beim Aufruf des lebattery oder anderen Batterietestskripten:
<pre>connect: Connection refused (111)</pre>

Lösung (vorübergehend)
<pre>
sudo rpi-update 8521fd34c8f66b6d109acce943f6e25ec93ec005
</pre>

Mehr dazu unter: {{Link2Forum|Topic=56960|Message=589165}}

'''Das BT-Device ist ständig "absent"'''<br>
Eine Mögliche Lösung kann sein, das Paket bluez-hcidump zu installieren. Das Werkzeug hcidump erlaubt die Beobachtung von Bluetooth-Aktivitäten.
Dies ist nicht notwendig, wenn bereits bluez installiert ist, da dies Teil des bluez Paketes ist
<pre>
sudo apt-get install bluez-hcidump
</pre>

'''Fehler in Logdateien /var/log/syslog und /var/log/kernel'''
Jul 29 15:08:11 raspberrypi kernel: [ 4905.634211] bt_err_ratelimited: 1 callbacks suppressed
Jul 29 15:08:11 raspberrypi kernel: [ 4905.634231] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:12 raspberrypi kernel: [ 4906.647350] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:13 raspberrypi kernel: [ 4907.532081] Bluetooth: hci0 advertising data length corrected
Jul 29 15:08:13 raspberrypi kernel: [ 4907.655564] Bluetooth: hci0 advertising data length corrected

Die Ursache des Problems ist noch nicht ergründet, allerdings betrifft dies aktuell nur den RPi3. Die Fehlermeldungen werden in verschiedene Logs geschrieben. Darunter maßgeblich "syslog" und "kern.log".

Lösung (vorübergehend):
Unterbinden der Einträge durch Anlage eines blocklist Eintrag:

1. Unter "/etc/rsyslog.d" eine Datei erzeugen mit dem Namen "01-blocklist.conf"
2. Inhalt: (Die Ausdrücke in den "" sind diejenigen, die aus dem log verschwinden sollen. - bei mir waren es die untenstehenden")
:msg,contains,"Bluetooth: hci0 advertising data length corrected" stop
:msg,contains,"bt_err_ratelimited:" stop
3. Dienst neu starten "sudo service rsyslog restart"

Weiter Infos werden im offiziellen Thema {{Link2Forum|Topic=28753|Message=499184|LinkText=hier}} diskutiert.

Seit Version 0.82 kann es beim Start zu folgenden Meldungen im Log kommen.
Sep 06 16:13:45 raspberrypi systemd[1]: Started lepresenced.
Sep 06 16:13:45 raspberrypi lepresenced[16010]: [tid:1] main::bluetooth_scan_thread: Received 'Set scan parameters failed: Input/output error', ...tting...
Sep 06 16:13:46 raspberrypi lepresenced[16010]: [tid:1] main::bluetooth_scan_thread: hcitool exited, retrying...

Diese Meldungen können ignoriert werden. Abhilfe schafft sich lepresenced selbst, indem es sich resettet.

'''Moderne iPhones und Android Geräte wechseln in den Schlaf-Modus''', um Energie zu sparen. Somit sind die Geräte zur Anwesenheitserkennung nicht per Ping zu erreichen.
Durch das Programm hping3, lassen sich zyklisch Pakete an die Geräte senden, um sie wieder "aufzuwecken".

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

= Versionsänderungen lepresenced =
<pre>
--Version 0.81 (BasisVersion)
--Version 0.82 (stable 08/2017)
-Neue Kommandozeilenoption "--debug": Startet lepresenced im Vordergrund und gibt ausführliche Debug-Informationen auf STDOUT aus.
-Sanity Check: lepresenced prüft beim Starten die Verfügbarkeit von hciconfig, hcitool und hcidump.
-Model: lepresenced übermittelt das Reading model nun als lan-lepresenced. Das erlaubt die Erkennung von lepresenced in der FHEM-Statistik (sofern aktiviert).
--Version 0.83 (stable 09/2017)
- Behebung von Systemstart Fehlern
- Weitere Debug-Möglichkeiten. U. a. wird nun mitgezählt, ob hcitool lescan ("legacy") und hcidump eine identische Zahl an Beacons empfangen
</pre>

= Ansprechpartner =
# {{Link2FU|117|markusbloch }} (Markus) für das PRESENCE-Modul und collectord
# {{Link2FU|5068|PatrikR}} (Patrick) für lepresenced
# [[Benutzer Diskussion:Devender|Devender]] ({{Link2FU|20043|Dirk}}) für Wiki und Doku

[[Kategorie:Anwesenheitserkennung]]

FB CALLLIST

2023-03-08T14:46:39Z

Krikan: Modulowner angepasst

{{Infobox Modul
|ModPurpose=Erstellung einer rollierenden Anrufliste aus einer [[FB_CALLMONITOR]] Definition
|ModType=h
|ModForumArea=Frontends
|ModCmdRef=FB_CALLLIST
|ModTechName=72_FB_CALLLIST.pm
|ModOwner=Jörg/JoWiemann ({{Link2FU|94|Forum}} / [[Benutzer Diskussion:JoWiemann|Wiki]])
}}

[[FB_CALLLIST]] erstellt aus einer [[FB_CALLMONITOR]]-Definition eine rollierende Anrufliste, welche durch Attribute an die eigenen Bedürfnisse angepasst werden kann.

== Voraussetzungen ==
Es wird eine [[FB_CALLMONITOR]] Definition benötigt, von der ''FB_CALLLIST'' die Events entsprechend verarbeiten kann.

Die [[FB_CALLMONITOR]]-Definition muss dabei für jedes Gespräch mind. das Reading "event" triggern. Bei evtl. gesetztem Attribut <code>event-on-change-readings</code> muss sichergestellt sein, dass das Readings "event" zusätzlich in dem Attribut <code>event-on-update-reading</code> eingetragen ist, da sonst parallel laufende Gespräche nicht sauber verarbeitet werden können.

== Anwendung ==
[[Datei:FB_CALLLIST Anrufliste.png|400px|thumb|right|Beispielhafte Anrufliste mit FB_CALLLIST]]
FB_CALLLIST kann sehr flexibel eingesetzt werden um Anrufe in Form einer Liste in FHEM darzustellen. Die Anrufliste wird dabei in allen geöffnetet Browser-Fenstern per Longpoll-Mechanismus aktuell gehalten. Das bedeutet, dass bei neuen Anrufevents Änderungen an der Liste sofort an alle geöffneten Browser weitergegeben werden. Dies ist besonders nützlich bei der Verwendung auf Status-Displays.

=== Define ===

Man definiert eine FB_CALLLIST-Instanz wie folgt:

define <Name> FB_CALLLIST <FB_CALLMONITOR-Definition>

Man benötigt als Übergabeparameter lediglich den Namen einer FB_CALLMONITOR-Definition. Aus den Events dieser Definition wird FB_CALLLIST eine Anrufliste erzeugen.

Es ist auch möglich als Übergabeparameter einen Definitionsnamen zu wählen, der nicht vom Typ FB_CALLMONITOR stammt. In dem Fall wird eine Warnmeldung im Log erzeugt.

=== Attribute ===
Die Liste kann durch eine Vielzahl an Attributen an die eigenen Bedürfnisse angepasst werden. Dies betrifft insbesondere folgende Funktionalitäten:

* Begrenzung der Anzahl anzuzeigender Anrufe (Attribute <code>number-of-calls</code>, <code>expire-calls-after</code>)
* Zuordnung von eigenen Bezeichnern für Rufnummern und Telefonie-Geräte (Attribute: <code>connection-mapping</code>, <code>internal-number-filter</code>, <code>external-mapping</code>)
* Anzeige nur bestimmter Anrufe (Attribut: <code>answMachine-is-missed-call</code>, <code>list-type</code>)
* Optische Anpassungen (Attribute: <code>icon-mapping</code>, <code>language</code>, <code>list-order</code>, <code>no-heading</code>, <code>no-table-header</code>, <code>show-icons</code>, <code>time-format-string</code>, <code>visible-columns</code>)

Eine genaue Beschreibung der einzelnen Attribute und ihrer Funktion findet man in der {{Link2CmdRef|Anker=FB_CALLLIST_attr}}.

== Anwendungsbeispiele ==
=== Tablet-UI Integration ===
[[Datei:FB CALLLIST Anzeigebeispiel Tablet-UI.png|200px|thumb|right|Anzeigebeispiel Tablet-UI]]
Man kann die Anrufliste einfach in Tablet-UI integrieren. Dazu ist es jedoch notwendig das Attribut {{Link2CmdRef|Anker=FB_CALLLIST_create-readings|Label= create-readings}} zu aktivieren. Damit die Anrufliste als Readings zur Verfügung stehen, welche dann in Tablet-UI eingebunden werden können.

Beispielhaft kann man dann mit folgendem HTML-Code eine Anzeige der Anrufliste realisieren. In diesem Fall werden die ersten zwei Zeilen der Anrufliste im Tablet-UI abgebildet. Die Bezeichnung <code>FritzBoxCallList</code> ist dabei der Name der FB_CALLLIST-Definition in FHEM.

<syntaxhighlight lang="html5">
<li data-row="8" data-col="2" data-sizex="4" data-sizey="1">
<header class="headerTransparent">ANRUFE</header>
<table width="100%" class="">
<tr>
<td>

<div class="narrow" data-type="symbol" data-device="FritzBoxCallList"
data-get="1-state" data-states='["=>","=> X","=> ((o))","=> [=]","=> O_O"]'
data-icons='["oa-phone_call_end_in","oa-phone_missed_in","oa-phone_ring fa-blink","oa-phone_ring_in fa-blink","oa-phone_answersing"]'
data-colors='["green","firebrick","firebrick","green","#aa6900"]'></div>
</td>
<td>
<div data-type="label" data-device="FritzBoxCallList" data-get="1-timestamp" data-part="5" class=""></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="1-timestamp" data-part="1" class="inline"></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="1-timestamp" data-part="2" class="inline"></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="1-timestamp" data-part="3" class="inline"></div>
</td>
<td>
<div data-type="label" data-device="FritzBoxCallList" data-get="1-name"></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="1-number"></div>
</td>
<td>
<div data-type="label" data-device="FritzBoxCallList" data-get="1-duration"></div>
</td>
</tr>
<tr>
<td>
<div class="narrow" data-type="symbol" data-device="FritzBoxCallList"
data-get="2-state" data-states='["=>","=> X","=> ((o))","=> [=]","=> O_O"]'
data-icons='["oa-phone_call_end_in","oa-phone_missed_in","oa-phone_ring fa-blink","oa-phone_ring_in fa-blink","oa-phone_answersing"]'
data-colors='["green","firebrick","firebrick","green","#aa6900"]'></div>
</td>
<td>
<div data-type="label" data-device="FritzBoxCallList" data-get="2-timestamp" data-part="5" class=""></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="2-timestamp" data-part="1" class="inline"></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="2-timestamp" data-part="2" class="inline"></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="2-timestamp" data-part="3" class="inline"></div>
</td>
<td>
<div data-type="label" data-device="FritzBoxCallList" data-get="2-name"></div>
<div data-type="label" data-device="FritzBoxCallList" data-get="2-number"></div>
</td>
<td>
<div data-type="label" data-device="FritzBoxCallList" data-get="2-duration"></div>
</td>
</tr>
</table>
</li>

</syntaxhighlight>

== Links ==

* {{Link2CmdRef|Anker=FB_CALLLIST}} (EN)
* {{Link2CmdRef|Lang=de|Anker=FB_CALLLIST}} (DE)

[[Kategorie:FritzBox]]

Yamaha AV-Receiver

2023-03-08T14:45:16Z

Krikan: Modulowner angepasst

{{Todo|Anwendungsbeispiele ergänzen; Informationen, die in der Infobox stehen, entfernen}}
{{Infobox Modul
|ModPurpose=Steuerung netzwerkfähiger AV-Receiver von Yamaha
|ModType=d
|ModCmdRef=YAMAHA_AVR
|ModForumArea=Multimedia
|ModTechName=71_YAMAHA_AVR.pm
|ModOwner=Beta-User ({{Link2FU|9229|Forum}}/[[Benutzer Diskussion:Beta-User|Wiki]])
}}
Für AV-Receiver des Herstellers Yamaha gibt es in FHEM bereits ein entsprechendes Modul mit dem alle netzwerkfähigen Modelle gesteuert werden können.

Für die genaue Benutzung in FHEM siehe dazu die {{Link2CmdRef|Lang=de|Anker=YAMAHA_AVR}} zu dem Modul YAMAHA_AVR.

== Links ==

* {{Link2CmdRef|Lang=de|Anker=YAMAHA_AVR}}-Eintrag zu YAMAHA_AVR
* [http://www.yamaha.com Herstellerseite von Yamaha]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:IP_Components]]

FB CALLMONITOR

2023-03-08T14:44:13Z

Krikan:

{{Infobox Modul
|ModPurpose=Protokollieren von (Telefonie-)Ereignissen auf einer [[AVM Fritz!Box|Fritz!Box]]
|ModType=h


|ModCmdRef=FB_CALLMONITOR
|ModTechName=72_FB_CALLMONITOR.pm
|ModOwner=Jörg/JoWiemann ({{Link2FU|94|Forum}} / [[Benutzer Diskussion:JoWiemann|Wiki]])
}}

[[FB_CALLMONITOR]] ist ein Hilfsmodul, das Telefonie-Ereignisse auf einer (über Netzwerk erreichbaren) [[AVM Fritz!Box|Fritz!Box]] protokolliert.

== Voraussetzungen ==
Die CallMonitor-Funktion auf der Fritz!Box muss aktiviert sein (z.B. durch Eingabe von <code>#96*5*</code> auf einem direkt an der Fritz!Box angeschlossenen Telefon).

Es ist zu beachten, dass der FB_CALLMONITOR keine internen Anrufe erfasst, da diese Anrufe nicht durch die FritzBox gemeldet werden. Es können daher nur externe Anrufe kommen und gehend in FHEM verarbeitet werden.

== Anwendung ==
=== Define ===
Siehe {{Link2CmdRef|Anker=FB_CALLMONITOR}}

=== Attribute ===
Siehe {{Link2CmdRef|Anker=FB_CALLMONITOR}}

=== Funktionen ===
* Protokollierung von Anrufen
* Nachschlagen von Telefonnummern in einer konfigurierbaren Auswahl von Telefonbüchern (online oder lokal)

== Anwendungsbeispiel(e) ==
* {{Link2Forum|Topic=19238|LinkText=Callmonitor für Anfänger}} im FHEM -Forum (Beispiel und Diskussion). <br />Daraus entstandene Wiki-Seite: [[Callmonitor mit Anruferliste und Zusatzfunktionen]].
* {{Link2Forum|Topic=19238|Message=138430|LinkText=Anzeigebeispiel}} im [[Dashboard]]

== Links ==
* [http://www.wehavemorefun.de/fritzbox/Callmonitor Schnittstellenbeschreibung]

[[Kategorie:FritzBox]]

FB CALLMONITOR

2023-03-08T14:43:18Z

Krikan: Modulowner aktualisiert

{{Infobox Modul
|ModPurpose=Protokollieren von (Telefonie-)Ereignissen auf einer [[AVM Fritz!Box|Fritz!Box]]
|ModType=h


|ModCmdRef=FB_CALLMONITOR
|ModTechName=72_FB_CALLMONITOR.pm
|ModOwner=Jörg/JoWiemann ({{Link2FU|94|Forum}} / [[Benutzer Diskussion:JoWiemann|Wiki]])}}
}}

[[FB_CALLMONITOR]] ist ein Hilfsmodul, das Telefonie-Ereignisse auf einer (über Netzwerk erreichbaren) [[AVM Fritz!Box|Fritz!Box]] protokolliert.

== Voraussetzungen ==
Die CallMonitor-Funktion auf der Fritz!Box muss aktiviert sein (z.B. durch Eingabe von <code>#96*5*</code> auf einem direkt an der Fritz!Box angeschlossenen Telefon).

Es ist zu beachten, dass der FB_CALLMONITOR keine internen Anrufe erfasst, da diese Anrufe nicht durch die FritzBox gemeldet werden. Es können daher nur externe Anrufe kommen und gehend in FHEM verarbeitet werden.

== Anwendung ==
=== Define ===
Siehe {{Link2CmdRef|Anker=FB_CALLMONITOR}}

=== Attribute ===
Siehe {{Link2CmdRef|Anker=FB_CALLMONITOR}}

=== Funktionen ===
* Protokollierung von Anrufen
* Nachschlagen von Telefonnummern in einer konfigurierbaren Auswahl von Telefonbüchern (online oder lokal)

== Anwendungsbeispiel(e) ==
* {{Link2Forum|Topic=19238|LinkText=Callmonitor für Anfänger}} im FHEM -Forum (Beispiel und Diskussion). <br />Daraus entstandene Wiki-Seite: [[Callmonitor mit Anruferliste und Zusatzfunktionen]].
* {{Link2Forum|Topic=19238|Message=138430|LinkText=Anzeigebeispiel}} im [[Dashboard]]

== Links ==
* [http://www.wehavemorefun.de/fritzbox/Callmonitor Schnittstellenbeschreibung]

[[Kategorie:FritzBox]]

FHEMWiki:Administratoren

2023-03-08T14:39:05Z

Krikan: Markus bei Benutzerkontenantrag entfernt

{| class="wikitable" style="background-color: #FFFFF0; border: 1px solid maroon;"
|-
| style="width:50%" | 
=== Benutzerkonto beantragen ===
Neue Benutzerkonten im FHEM-Wiki können nur von den Administratoren angelegt werden. Dazu muss der Antragsteller eine
* E-Mail an '''einen''' der Administratoren schicken mit
* dem gewünschten Benutzernamen (wenn die erste Stelle ein Buchstabe ist, wird das immer ein Großbuchstabe - das macht die Wiki-Software so und lässt sich auch nicht ändern)

* und seiner E-Mail-Adresse

Nur mit '''vollständigen''' Angaben wird ein Benutzerkonto angelegt. Nochmal zum Abschreiben:
<pre>
Benutzername:
E-Mail Adresse:
</pre>
Bitte schreibt die Administratoren (einen nach dem anderen!) in der untenstehenden Reihenfolge an. Erst wenn der Antrag am dritten Tag noch nicht bearbeitet wurde, den nächsten in der Liste anschreiben. Ignorieren dieser Empfehlung führt '''nicht''' zu einer Beschleunigung des Antrags ... eher im Gegenteil!
<hr />
Administratoren:<br>
1. [[Benutzer: Ph1959de|Ph1959de]] (Peter) - [[Datei:Ph1959deMail.png]]
: ... keine Antwort? Drei Tage warten ...
2. [[Benutzer: Krikan|Krikan]] (Christian) - [[Datei:CgfhemwikiMail.png]]
: ... keine Antwort? Drei Tage warten ...


| style="width:50%" | 
=== Request user account ===
New user accounts on FHEM-Wiki need to be created by one of the administrators. To get an account, the requestor needs to
* send an email to '''one''' of the administrators with
* the desired user name (if the first position is a letter, it will always be uppercase - this is forced by the Wiki-Software and can not be circumvented)

* and his email address

'''All''' of the above items are mandatory. You need a template?
<pre>
Username:
E-Mail Address:
</pre>

Please contact the administrators (one after the other!) in the sequence given below. Only if your request has not been fulfilled after three days you may contact the next person on the list. Ignoring these instructions will '''not''' speed up processing of your request ... it will rather delay it even more!
<hr />
Administrators:<br>
1. [[Benutzer: Ph1959de|Ph1959de]] (Peter) - [[Datei:Ph1959deMail.png]]
: ... No answer? Wait for three days ...
2. [[Benutzer: Krikan|Krikan]] (Christian) - [[Datei:CgfhemwikiMail.png]]
: ... No answer? Wait for three days ...


|}
=== Administratoren ===
Neben den für Anträge auf Benutzerkonten zuständigen Administratoren gibt es noch weitere Benutzer mit Administratorrechten. Nachfolgend eine Liste aller derzeitigen Administratoren des FHEM Wiki:
{{Special:ListUsers/sysop}}

[[Kategorie:FHEM Wiki]]

Benutzer Diskussion:Siggi

2022-09-08T03:00:33Z

Krikan: /*Willkommen*/

Z-Wave Firmware Update

2020-11-10T17:35:13Z

Krikan: /* Über ZWDongle oder ZWCUL unter FHEM */ -> Popp-Firmwaredateien

Grundsätzlich bietet sowohl [[Z-Wave#Definition des Gateways /Controllers|ZWDongle]] wie [[ZWCUL]] die Möglichkeit an, die Firmware von [[Z-Wave]]-Geräten zu aktualisieren.

Leider bieten die wenigsten Hersteller entsprechende Firmware-files offen zum Download an. Sofern überhaupt Files zum freien Download verfügbar sind, sind diese in der Regel nur über die herstellereigenen Tools verwendbar, meist wird das jeweilige Hersteller-Interface (also z.B. ein Fibaro Home Center) benötigt, das dann die Daten direkt herunterlädt und auf die Geräte OTA aufspielt.

Auf dieser Seite werden die verschiedenen Möglichkeiten dargestellt, wie Firmware-updates - möglichst ohne größere Eingriffe in das Z-Wave-Netz - durchgeführt werden können, auf welchem Weg ggf. updates erhältlich sind und ob solche überhaupt verfügbar sind.

== Varianten für Firmwareupdates ==
=== Über ZWDongle oder ZWCUL unter FHEM ===
Firmware-Updatedateien sind für diverse POPP-Geräte verfügbar: https://zwave.de/zwave-ota/
=== Mittels Hersteller-Bridge ===
[[Datei:Fibaro_HCL_fw-update-page.png|300px|thumb|right|Seite für das Vorbereiten der Firmware-updates]]In einigen Fällen ist es möglich, die Hersteller-Bridge (Fibaro Home Center oder Z-Way) als "secondary controller" in das Z-Wave-Netz zu includieren. Ein Beispiel mit einem
{{Link2Forum|Topic=115218|LinkText=Fibaro Home Center lite}} ist im Forum zu finden, eventuell sind dafür zusätzliche Einstellungen am ZWDongle erforderlich (insbes. die sucNodeId auf dessen ZWave-ID zu stellen).

=== Externe Tools ===
Manche Hersteller (insbes. AEOTEC) liefern Firmware-Dateien als unter Windows ausführbare Dateien an.

== Quellen für Firmwareupdates ==
=== Aktuell vorhandene Version abfragen ===
Welche Firmware-Version derzeit auf einem Device läuft, erfährt man in FHEM mit
get <device> version
Die letzte Zahl gibt dabei die Firmware-Version an.

Nachfolgend sind die Informationen zu den verfügbaren updates zusammengetragen, es besteht kein Anspruch auf Vollständigkeit oder Aktualität - es wird um Mithilfe bei der Verbesserung gebeten!

=== AEOTEC ===
Dieser Hersteller bietet über die [https://aeotec.freshdesk.com/support/solutions/6000084017 Einstiegsseite] für einige Geräte ausführbare Dateien für Windows an. Diese benötigen das .NET-framework, es kann z.B. unmittelbar das für FHEM verwendete USB-Dongle eingesetzt werden (getestet mit einem [[Z-Wave-ZME UZB1 USB Dongle]]), eine vorherige Exklusion ist nicht erforderlich.

{| class="wikitable sortable"
|+ Übersicht über verfügbare Updates (EU-Version, soweit nicht anders vermerkt)
|-
! Kürzel !! class="unsortable" | Name !! class="unsortable" | aktuellste bekannte Version !! class="unsortable" | Stand !! class="unsortable" | Bemerkungen/Quelle
|-
| ZW096 || Smart Switch 6 || 1.02 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| ZW100 || MultiSensor 6 || 1.13 || 30.10.2020 || [https://aeotec.freshdesk.com/support/solutions/articles/6000036562-how-to-update-multisensor-6-z-wave-firmware- aeotec]
|-
| ZW111 || Nano Dimmer || 2.02 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| ZW116 || Nano Switch with energy reading || 3.00 || vor 30.10.2020 || [https://aeotec.freshdesk.com/support/solutions/articles/6000197021--zw116-v3-00-how-to-update-nano-switch-with-energy-reading-z-wave-firmware- aeotec]
|-
| ZW132 || Dual Nano Switch with energy reading || 2.02 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| ZW139 || Nano Switch without energy reading || 2.00 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| ZW140 || Dual Nano Switch without energy reading || 2.00 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| ZWA005 || TriSensor || 2.21 || 30.10.2020 || [https://aeotec.freshdesk.com/support/solutions/articles/6000236093-how-to-update-trisensor-z-wave-firmware- aeotec]
|-

|-
| colspan="5" | ''Tabelle muss noch vervollständigt werden''
|-
|}

=== Fibar Group ===
[[Datei:Fibaro_HCL_fw-update-page-leichte-neukonfig.png|300px|thumb|right|Seite für das Vorbereiten der Firmware-updates]]Fibar bietet derzeit updates nur über die herstellereigenen ''Home Center'' an. Diese können als ''secondary controller'' in das Z-Wave-Netz inkludiert werden. Nach der Inklusion (bzw. nach einem Suchlauf (=> tbd: erforderlich? Details?) sollten alle vorhandenen Geräte auch im Home Center zu sehen sein, dabei ist darauf zu achten, dass man das Zurücksetzen der Geräte durch das Home Center nicht zuläßt. Dazu verwendet man den Button ''Leichte Geräteneukonfiguration'' im Menüpunkt ''Module - Erweitert''.

Das update eines FGR-223 war völlig unproblematisch, der FGS-223 ist als Problemfall bekannt, verschiedene Lösungsansätze sind in diesem [https://forum.fibaro.com/topic/51291-impossible-to-update-34-on-fgs223/ Thread auf dem Fibaro-Forum] zu finden. Beim Autor führte letztlich vor allem der Versuch zum Erfolg, das update nicht über den Hauptkanal durchzuführen, sondern über ein "Teilgerät", das eine sehr viel höhere ID aufwies wie das Hauptgerät (ID 79 statt 12), siehe nebenstehende Abbildung FGS-223.[[Datei:HCL-FGS-223-update.png|300px|thumb|right|FGS-223]] Eine vorherige Exklusion war jedoch nicht erforderlich.

{| class="wikitable sortable"
|+ Übersicht über verfügbare Updates (EU-Version, soweit nicht anders vermerkt)
|-
! Kürzel !! class="unsortable" | Name !! class="unsortable" | aktuellste bekannte Version !! class="unsortable" | Stand !! class="unsortable" | Bemerkungen/Quelle
|-
| FGS 222 || FIBARO System FGS222 Double Relay Switch 2x1.5kW || Lib 3 Prot 3.52 App 2.2 || 08.11.2020 || Home Center lite
|-
| FGRM 222 || FIBARO System FGRM222 Roller Shutter Controller 2 || Lib 3 Prot 3.52 App 22.22 || 08.11.2020 || Home Center lite
|-
| FGS 223 || FIBARO System FGS223 Double Relay || Lib 3 Prot 4.24 App 3.4 HW 3 FWCounter 0 || 08.11.2020 || Home Center lite - Improved response to controlling device via buttons connected to S1/S2. Optimized number of status reports being send by the module.
|-
| FGR 223 || FIBARO System FGRM223 Roller Shutter Controller 3 || Lib 3 Prot 6.02 App 5.1 HW 3 FWCounter 1 FW 5.1 || 08.11.2020 || Home Center lite
|-
|-
| colspan="5" | ''Tabelle muss noch vervollständigt werden''
|-
|}

=== GoControl ===
{| class="wikitable sortable"
|+ Übersicht über verfügbare Updates (EU-Version, soweit nicht anders vermerkt)
|-
! Kürzel !! class="unsortable" | Name !! class="unsortable" | aktuellste bekannte Version !! class="unsortable" | Stand !! class="unsortable" | Bemerkungen/Quelle
|-
| LB60-Z || Smart Bulb || 5.12 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| colspan="5" | ''Tabelle muss noch vervollständigt werden''
|-
|}

=== HomeSeer ===
{| class="wikitable sortable"
|+ Übersicht über verfügbare Updates (EU-Version, soweit nicht anders vermerkt)
|-
! Kürzel !! class="unsortable" | Name !! class="unsortable" | aktuellste bekannte Version !! class="unsortable" | Stand !! class="unsortable" | Bemerkungen/Quelle
|-
| HS-WD100+ || Wall Dimmer || 5.19 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| HS-WS100+ || Wall Switch|| 5.17 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| HSM200 || Multisensor|| 1.10 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| colspan="5" | ''Tabelle muss noch vervollständigt werden''
|-
|}

=== Leviton ===
{| class="wikitable sortable"
|+ Übersicht über verfügbare Updates (EU-Version, soweit nicht anders vermerkt)
|-
! Kürzel !! class="unsortable" | Name !! class="unsortable" | aktuellste bekannte Version !! class="unsortable" | Stand !! class="unsortable" | Bemerkungen/Quelle
|-
| DZ15S-1BZ || Wall Switch || 1.2 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| DZ1KD-1BZ || Wall Dimmer || 1.2 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| DZ6HD-1BZ || Wall Dimmer || 1.2 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| DZPA1-2BW || Plug-in Switch || 1.2 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| DZPD3-2BW || Plug-in Dimmer || 1.2 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| colspan="5" | ''Tabelle muss noch vervollständigt werden''
|-
|}

=== Qubino ===
{| class="wikitable sortable"
|+ Übersicht über verfügbare Updates (EU-Version, soweit nicht anders vermerkt)
|-
! Kürzel !! class="unsortable" | Name !! class="unsortable" | aktuellste bekannte Version !! class="unsortable" | Stand !! class="unsortable" | Bemerkungen/Quelle
|-
| - || SmartMeter || 7.6 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-
| - || Weather Station || 1.3 || vor 30.10.2020 || [http://help.homeseer.com/help/Z-Flash/static/#.firmware_included_with_z_flash homeseer]
|-

| colspan="5" | ''Tabelle muss noch vervollständigt werden''
|-
|}
[[Kategorie:Z-Wave Components]]

Z-Wave

2020-10-13T18:24:09Z

Krikan: jeedom-Link aktualisiert

<div style="float:right">{{Infobox Modul
|Name=ZWDongle
|ModPurpose=Einbindung Z-Wave-Gateways
|ModType=d
|ModCmdRef=ZWDongle
|ModForumArea=ZWave
|ModTechName=00_ZWDongle.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
{{Infobox Modul
|Name=ZWave
|ModPurpose=Ansteuerung Z-Wave-Geräte über ZWDongle
|ModType=d
|ModCmdRef=ZWave
|ModForumArea=ZWave
|ModTechName=10_ZWave.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
</div>

[[Z-Wave]] ist ein drahtloser Kommunikations-Standard im 868 Mhz-Band (Europa), der von der Firma Sigma Designs und der Z-Wave Alliance, einen Zusammenschluss von mehreren Hundert Herstellern, für die Heimautomatisierung entwickelt wurde. Es existieren mehr als [http://products.z-wavealliance.org 1400 zertifizierte Produkte] verschiedenster Hersteller, die innerhalb eines gemeinsamen Z-Wave-Netzes einsetzbar sind. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia])

Auf dieser Seite werden Grundlagen eines '''Z-Wave''' Systems und dessen Einrichtung in FHEM beschrieben.
== Z-Wave ==
=== Nodes - Controller und Slaves ===
Ein Z-Wave-Netz besteht aus mindestens 2 Geräten, den sogenannten '''Nodes''' (Knoten). Es setzt sich zusammen aus dem steuernden '''Controller''' (Zentrale) und min. 1 bis max. 231 gesteuerten '''Slaves''' (Geräten).

=== Home-Id und Node-ID ===
Innerhalb eines Z-Wave-Netzes gibt es zu 2 Identifikationsnummern zur Kennzeichnung der Netzstruktur:
# '''Home-ID:''' Gemeinsame Identifikationsnummer aller Nodes in einem Netz zur Abgrenzung gegenüber anderen Netzen. Nur Nodes mit der gleichen Home-ID können miteinander kommunizieren.
# '''Node-ID:''' Identifikationsnummer zur eindeutigen Kennzeichnung von jedem Node im Netz.

Die Home-ID ist im Controller (fest) hinterlegt und seine Node-ID ist typischerweise 1. Die Slaves haben zunächst keine Home-ID und Node-ID. Bei der '''Inklusion''' (Aufnahme) der Slaves in das Z-Wave-Netz überträgt der Controller seine Home-ID auf die Slaves und weist den Slaves eine eindeutige Node-ID im Netz zu, mit der Sie direkt angesprochen werden.

Besondere Node-ID ist die 255. Eine Nachricht an die Node-ID 255 kann von allen Z-Wave-Nodes ausgewertet werden (Broadcast).

=== Primär- und Sekundärcontroller ===
Der Controller, der durch Zuteilung seiner Home-ID auf die Slaves, das Netz aufbaut, ist der '''Primärcontroller'''. Grundsätzlich können in einem Netz mehrere Controller existieren, aber immer nur ein Primärcontroller. Weitere in das Netz eingebundene Controller werden zum '''Sekundärcontroller'''. Ohne besondere Maßnahmen kann nur der Primärcontroller die Inklusion (Einbindung) der Nodes in das Netz durchführen. Hingegen können sowohl Primär- als auch Sekundärcontroller die '''Exklusion''' (Ausschluss) eines Nodes aus dem Netz vornehmen.

Der Controller speichert intern diverse Informationen (Home-ID, Node-IDs,..) über das ZWave-Netz. Hierdurch kann unter anderem die Haussteuerungssoftware bei einem PC-Controller relativ unkompliziert gewechselt werden, da die wesentlichen ZWave-Netzinformationen vom Controller selbst verwaltet und gespeichert werden. Andererseits muß bei einem Controllerdefekt das gesamte Netz grundsätzlich neu aufgebaut werden, wenn kein Backup der internen Controllerdaten vorhanden ist.

=== Acknowledge ===
Im Z-Wave-Netz werden Nachrichten vom Empänger-Node an den Sender-Node rückbestätigt (Acknowledge). Bei ausbleibendem Acknowledge wiederholt der Sender-Node die Nachricht automatisch auf Protokollebene bis zu 2 mal. Hierdurch wird eine höhere Betriebssicherheit des Z-Wave-Netzes erreicht. Bei Broadcast-Nachrichten an die Node-ID 255 findet keine Rückbestätigung statt.

=== Vermaschtes Netzwerk mit Routing ===
Z-Wave nutzt als Netzwerktopologie ein '''mesh network''' (vermaschtes Netzwerk), d. h. jeder Node ist mit einem oder mehreren anderen Nodes verbunden. Das hat den Vorteil, dass eine Nachricht zwischen zwei Nodes übermittelt werden kann, selbst wenn diese nicht direkt miteinander kommunizieren können, z. B. weil sie zu weit voneinander entfernt sind. In diesem Fall wird die Funk-Nachricht über einen oder mehrere „Zwischen-Nodes“ übertragen; dieser Vorgang wird '''Routing''' genannt. Nur netzgespeiste Z-Wave-Geräte sind Router. Batteriebetriebe Z-Wave-Geräte sind grundsätzlich keine Router und dienen somit auch nicht zur Reichweitenerhöhung. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia]) Einzelne Geräte, die alternativ per Batterie oder USB-Anschluss betrieben werden können, werden bei USB-Anschluss automatisch ({{Link2Forum|Topic=40393|Message=328080}}) oder durch Konfigurationsänderungen ({{Link2Forum|Topic=40393|Message=327331}}) zu Routern.

Informationen über das optimale Routing werden bei der Inklusion der Nodes in einer Routing-Tabelle des Primärcontrollers gespeichert. Dies geschieht durch Abfrage des Nodes, welche weiteren Nodes er erreichen kann. Durch örtliche Änderung oder Defekte von Nodes können die in der Routing-Tabelle gespeicherten Informationen fehlerhaft bzw. suboptimal werden. Dies kann sich in Funkkommunikationsproblemen im Netzwerk äußern. Hier kann ein per Software manuell angeforderter Neuaufbau der Routing-Tabelle gegebenenfalls Abhilfe schaffen. Bei Geräten und Controllern mit aktuellen Firmware-Versionen (SDK 4.5x und SDK 6.xx oder größer, aber ''nicht'' SDK 5.x) und Unterstützung von Explorer Frames kann sich die Routing-Tabelle unter bestimmten Bedingungen auch automatisch aktualisieren ("Selbstheilung")[https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames].

=== Command Classes ===
Die Steuerung und Kommunikation der Nodes erfolgt über Befehle die funktionsbezogen in verschiedene '''Command Classes''' (Kommandoklassen) zusammengefasst sind.

Alle Z-Wave-Geräte haben als gemeinsame kleinste Übereinstimmung die '''Class Basic'''.

Z-Wave-Geräte haben im Originalzustand eine bestimmte arbeitsfähige Grund-Konfiguration. Anpassbar an individuelle Bedürfnisse ist die Konfiguration über die '''Class Configuration'''.

Durch eine Assoziation wird definiert, welche Geräte miteinander direkt -ohne Umweg über den Controller- kommunizieren können. Auch bei Ausfall des Controllers können diese Geräte ihre gemeinsame Funkton ausüben. Zudem dienen Assoziationen der Geschwindigkeitssteigerung und Funklastreduzierung innerhalb des Netzes. Angelegt werden Assoziationen über die '''Class Association'''.

Dies sind nur die allerwichtigsten Command Classes. Weitere Command Classes sind den Handbüchern zu entnehmen. Zudem enthält die Wiki-Seite [[Z-Wave Command Classes]] weitergehende Informationen.

=== Hinweise zur Z-Wave-Geräteauswahl ===
Aufgrund der vielen Z-Wave-Gerätehersteller mit jeweils eigenem Z-Wave-Gerätesortiment existiert eine große Produktauswahl. Jedoch gibt es auch große Unterschiede hinsichtlich Produkteigenschaften, Pflege der Produkte, Häufigkeit der Aktualisierung der Produktpalette und so weiter. Schwierigkeiten bereitet insbesondere, dass neben den aktuellesten Chipsätzen und SDKs auch die älteren Chipsätze und SDKs weiterhin in Produkten im Handel verfügbar sind. Neuere Chipsätze und aktuelle SDKs bieten gerade bei der Netzwerkstabilität (Explorer Frames, Reichweite usw.) Vorteile zu älteren Chipsätzen und SDKs. Beispielsweise beherrschen nur Geräte mit SDK 4.5x und 6.x oder neuer die für automatische Routenkorrekturen wichtigen Explorer Frames. Das ältere SDK 5.0, das verwirrenderweise auch noch eine höhere Versionsnummer als das neuere SDK 4.5 besitzt, beherrscht unter anderem keine Explorer Frames. Details hierzu enthält das [https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames wiki.zwaveeurope.com]. Aktuellstes SDK ist Stand 10/2017 das SDK 6.7x, das in ZWave Plus - zertifizierten Produkten zum Einsatz kommt.

Gerade Einsteiger beachten die Unterschiede bei den Chipsätze/SDKs aus Unkenntnis manchmal nicht und ärgern sich im Nachhinein über Probleme bei der Netzwerkstabilität und Reichweite. Darum nachfolgend allgemeine, aber sehr einfache Empfehlungen zur Geräteauswahl. Selbstverständlich wird hier nicht von anderen Produkten abgeraten, wenn man die Unterschiede kennt und Vorteile bei deren Produkteigenschaften sieht. Zudem kann man (leider) schlechtere Produkteigenschaften bei Geräten mit aktuelleren Chipsätzen/SDKs nie ausschließen.

Gateway
# [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus-Zertifizierung]. Diese ist mittlerweile bei nahezu allen erhältlichen Gateways gegebenen.

Endgeräte
# Z-Wave Plus-Zertifizierung (aktuellste Technik, höhere theoretische Reichweite, SDK 6.5x oder höher) oder
# zumindest Explorer Frames-Unterstützung (SDK 4.5x und 6.0x) oder
# zuletzt -bei Kenntnis der Besonderheiten und Auswirkungen- Produkte ohne Explorer Frames (SDK 5.0x)

'''Kurz''': Produkte mit Z-Wave Plus-Zertifizierung einsetzen.

Bitte unbedingt beachten, dass Z-Wave Plus-Vorteile bei einem Mischbetrieb mit älteren (ohne Plus) Geräten teilweise verloren gehen. Zum negativen Effekt des Einsatzes eines älteren, aber weiterhin erhältlichen Z-Wave-Repeaters mit aktuellen Z-Wave Plus-Geräten siehe beispielsweise den Hinweis in diesem {{Link2Forum|Topic=42591|Message=350066}}.

Bei Fragen zu bestimmten Geräten bitte -nach Durchsicht der Hinweise hier im Wiki- im Forum suchen oder anschließend nachfragen.

== Z-Wave in FHEM ==
=== Allgemein ===
FHEM wird fortwährend weiterentwickelt und verbessert. Daher ist es zwingend notwendig, dass FHEM auf dem aktuellsten Stand ist. Dazu nach der FHEM-Installation den Befehl <code>update</code> ausführen und anschließend <code>shutdown restart</code> durchführen. Genauso auch vor [[#Welche_Infos_sollten_Anfragen_im_ZWave-Forum_enthalten.3F|Anfragen im Forum]] die Aktualität von FHEM überprüfen.

Die Einbindung von Z-Wave in FHEM ist (nicht nur für den Anfänger) ausschließlich mit der standardmäßig eingeschalteten [[autocreate|autocreate-Funktion]] einfach möglich. Die Kenntnis der FHEM-Grundlagen und Durcharbeitung der Anfänger-Lektüren wird im Folgenden vorausgesetzt. Insbesondere sind [[Erste_Schritte_in_FHEM|Erste Schritte in FHEM]] und [http://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM] Pflicht, auch wenn sie nicht speziell Z-Wave behandeln, so werden doch wesentliche Punkte für ein Verständnis von FHEM vermittelt.

Nachfolgend und auf den [[:Kategorie:Z-Wave Components|Wiki-Seiten der Einzelgeräte]] werden immer wieder Auszüge aus der [[Konfiguration]] dargestellt. Diese dienen zur Erläuterung und Veranschaulichung. Die Bearbeitung der Konfiguration sollte -zur Verhinderung von Fehlern- nach Möglichkeit immer über das "[[Konfiguration#Befehl-Eingabefeld|Befehl-Eingabefeld]]" und die "[[Konfiguration#Objektdetails|Objektdetails]]" erfolgen.

=== Vorbereitung ===
Die Bedienungsanleitungen (Handbücher) sind zwingende Voraussetzung zur korrekten Einbindung und Konfiguration von Z-Wave-Geräten in FHEM. Sie müssen daher vorliegen.
Den ZWave-Geräten liegen teilweise nur gekürzte, gedruckte Fassungen der Handbücher bei (beispielsweise Devolo, AEOTEC). Man sollte bei allen Produkten auf folgenden Seiten nach eventuellen ausführlicheren Handbüchern suchen:
* Herstellerseite des ZWave-Gerätes
* http://www.zwave.de/handbuecher/ (deutsch)
* http://products.z-wavealliance.org (englisch)
Insbesondere auf http://products.z-wavealliance.org, der Datenbank der ZWave-zertifizierten Produkte, sind regelmäßig ausführliche Informationen zu den Geräten zu finden.

== Definition des Gateways / Controllers ==
{{Randnotiz|RNText='''Tester für ZWave@culfw gesucht!'''
Z-Wave-Controllerfunktionen werden derzeit in die Firmware [http://www.culfw.de culfw] für den [[CUL]] implementiert. Weitere Informationen im [[ZWCUL]] - Artikel.}}
=== Autocreate des Gateways ===
FHEM kann mit einem Funkgateway Z-Wave-Funk empfangen und senden. Z-Wave-Gateways (Controller) existieren von verschiedenen Herstellern.

Folgende Gateways wurden unter anderem bereits erfolgreich mit FHEM eingesetzt:
* AEON Labs Z-Stick S2 (SDK 5.x; [https://aeotec.freshdesk.com/support/solutions/articles/6000091809-z-stick-s2-v3-08-firmware-update Firmwareupdate auf 3.08 aus 2016])
* Aeotec Z-Stick Gen5 (Z-Wave Plus; SDK 6.5; [https://aeotec.freshdesk.com/support/solutions/articles/6000108806-z-stick-gen5-backup-software Backup-Software)] ({{Link2Forum|Topic=47000}})
* Goodway WD6001 (SDK 5.03 {{Link2Forum|Topic=40594|Message=332235}})
* Vision Z-Wave USB Stick ZU 1401 EU (SDK 6.0x)
* Vision Z-Wave USB Stick ZU 1401-5 EU (Z-Wave Plus; SDK 6.5x)
* Z-Wave.Me Z-StickC ({{Link2Forum|Topic=29930|Message=226530}})
* Z-Wave.Me USB Stick ZME_UZB1 (SDK 6.5x; Z-Wave Plus; [http://razberry.z-wave.me/z-way-server/ Firmwareupdate und Backup über z-way])
* Z-Wave.Me Razberry in Verbindung mit Raspberry Pi (1. Generation: Z-Wave, 2. Generation: Gen5-Razberry mit Z-Wave Plus[http://forum.z-wave.me/viewtopic.php?f=3419&t=21327#p55404])
** Die seriellen Schnittstelle /dev/ttyAMA0 muss am Raspberry Pi freigeschaltet werden, damit das Razberry-Modul funktionsfähig ist: {{Link2Forum|Topic=78248|Message=702044}})
** Beim Raspberry Pi 3 muss der GPIO-Port auf den Hardware-UART0 umgestellt werden: [[Raspberry Pi 3: GPIO-Port Module und Bluetooth]]

Folgende Gateways sind '''nicht''' mit FHEM einsetzbar:
* Merten Funk-USB-Datenschnittstelle CONNECT

Sollte das eigene Gateway hier nicht aufgeführt sein, ist aufgrund der Standardisierung dennoch die Chance für eine erfolgreiche Einbindung des Gateways in FHEM vorhanden. Bitte dies hier oder im Forum entsprechend vermerken.

Das Z-Wave-Gateway wird unter Linux nach Anschluss an den FHEM-Rechner beim nächsten FHEM-Start oder ohne FHEM-Neustart durch Aufruf des Befehls <code>usb scan</code> zumeist automatisch erkannt und das zugehörige FHEM-Device nach dem Namensschema <code>ZWDongle_<[https://forum.fhem.de/index.php/topic,92885.msg854533.html#msg854533 Anhang]></code> angelegt. Ein manuelles Anlegen des ZWDongle-Moduls oder Eingriffe in die Konfiguration sind unter Linux normalerweise nicht notwendig.

Unter Windows ist ein manuelles Anlegen der Definition des ZWave-Gateways wegen fehlender Unterstützung des Befehls <code>usb scan</code> erforderlich (Beispiel für Z-Wave.Me USB Stick ZME_UZB1 unter Windows: <code>define ZWDongle_1 ZWDongle COM1@115200</code>).

Das FHEM-Gateway-Device ist nach der Definition in FHEM im Raum "Everything" zu finden.

Beispiele der automatisch erzeugten define-Zeile in der Konfiguration:

Aeon Labs Z-Stick an der Fritzbox:
define ZWDongle_1 ZWDongle /dev/ttyUSB1@115200

Vision Z-Wave USB Stick ZU 1401 EU am Raspberry Pi (Raspbian):
define ZWDongle_1 ZWDongle /dev/ttyACM1@115200

Insbesondere wenn am FHEM-Server unter Linux mehrere USB-Gateways eingesetzt werden, empfiehlt es sich zur Erhöhung der Betriebsstabilität das Z-Wave-Gateway über [[Trick_der_Woche#CUL_.26_CO_.C3.BCber_Serial_ID-einbinden|Serial-by-Id]] oder [[LinuxDeviceNaming|uDev-Regeln]] anzusprechen.

Bei einem statischen Controller wird die Einrichtung als SUC -sofern der Controller als solcher nicht bei Auslieferung eingerichtet ist- vor der ersten Inklusion von Geräten empfohlen.

=== homeId und nodeList des Gateways ===
Zur manuellen Definition von Z-Wave Aktoren und Sensoren ist die <code>homeId</code> notwendig. Bei der hier bevorzugten Definition der Geräte durch autocreate ist die Kenntnis der <code>homeId</code> nicht zwingend. Jedoch sollte durch Abfrage der <code>homeId</code> direkt nach Einbindung des Zwave-Gateways dessen Funktionsfähigkeit getestet werden.

Die <code>homeId</code> und <code>CtrlNodeId</code> des Gateways wird mit folgendem Befehl ausgelesen (<ZWDongle> ist im folgenden durch den Namen des FHEM-Devices des eigenen Gateways zu ersetzen):
get <ZWDongle> homeId
ergibt beispielsweise bei einem Gateway mit dem FHEM-Devicenamen ZWDongle_1:
ZWDongle_1 homeId => HomeId:e345c456 CtrlNodeId:01
In diesem Beispiel ist die Home-Id des Gateways ZWDongle_1 e345c456 und das Gateway hat die Node-Id 1.

Die aktuelle Liste der Z-Wave Nodes, die bereits am Gateway registriert/inkludiert sind, wird mit dem folgendem Befehl ausgelesen:
get <ZWDongle> nodeList
ergibt beispielsweise:
ZWDongle_1 nodeList => ZWDongle_1 UNKNOWN_2

== Definition von Geräten / Slaves ==
=== Hinzufügen eines neuen Z-Wave Geräts / Inklusion ===
Zur Verfolgung von Inklusionsablauf und Meldungen des Controllers während der Inklusion sollte der [[Event monitor]] in einem 2. Browserfenster vor Aktivierung des Inklusionsmodus geöffnet werden.

Das Z-Wave Gateway wird in den Standard-Modus zur Inklusion (zum Aufnehmen) neuer Geräte gesetzt:
set <ZWDongle> addNode on
Bei der Standard-Inklusion muss direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen.

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt des obigen Befehls besser der Network-Wide-Modus für die Inklusion genutzt werden:
set <ZWDongle> addNode onNw
Bei der Network-Wide-Inklusion muss kein direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen. Es reicht, wenn das zu inkludierende Gerät über andere bereits inkludierte, netzgespeiste Geräte mit Explorer Frames-Unterstützung erreicht werden kann. Die Network-Wide-Inklusion ist zu bevorzugen, da die Z-Wave-Geräte regelmäßig an Ihren örtlichen Endpositionen inkludiert werden können. Dadurch werden bei der Inklusion direkt die korrekten Routen gespeichert.

Nachdem das Gateway in den Inklusionmodus geschaltet wurde, muss das Gerät in den Inklusionsmodus (Aufnahmemodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen. Typisch sind ein- oder dreimaliges Drücken einer Taste am Gerät oder beim Anlegen der Versorgungsspannung. Durch die Inklusion werden Home-ID und Node-ID im Gerät gespeichert. Zudem teilt das Gerät über ein spezielle Funknachricht (NIF=Node Information Frame) dem Controller seinen Gerätetyp und seine Geräteeigenschaften mit. Hierbei werden dem Controller auch die vom Gerät unterstützten Command Classes mitgeteilt. Aus diesen Informationen erzeugt FHEM automatisch durch autocreate das FHEM-Geräte-Device nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> (an eigene Wünsche anpassbar mit {{Link2CmdRef|Anker=rename|Label=rename}}). Die vom Geräte unterstützen Command Classes, die die in FHEM verfügbaren Befehle bestimmen, werden automatisch im Attribut <code>classes</code> des FHEM-Geräte-Device gespeichert. Das Gerät ist damit grundlegend in FHEM definiert und im Raum "ZWave" zu finden.

Nach der Inklusion schaltet FHEM den Inklusionsmodus des Z-Wave Gateway automatisch durch Absetzen des Befehls <code>set <ZWDongle> addNode off</code> aus und zeigt eine Dialogbox mit dem Ergebnis der Inklusion:
* <code><nowiki>created ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> = Inklusion war erfolgreich und es wurde das bezeichnete FHEM-Device durch autocreate angelegt.
* <code><nowiki>addNode failed</nowiki></code> = Inklusion ist fehlgeschlagen

Eine erfolgreiche Inklusion ist zudem am Event "ZW_ADD_NODE_TO_NETWORK protocolDone" im Event monitor und natürlich der Anlage des entsprechenden FHEM-Devices durch autocreate zu erkennen. Das Scheitern einer Inklusion führt typischerweise zur Ausgabe des Events "ZW_ADD_NODE_TO_NETWORK failed". Häufigste Ursache sind Controllerprobleme, die sich oftmals durch kurzes Ein- und Ausstecken des Controllers, Neustart des Systems oder Ein- und Ausschalten des FHEM-Server-Computers beheben lassen.

HINWEISE:<br />
* Die Network-Wide-Inklusion kann nach derzeitiger Kenntnis auch bei Gateways und Geräten ohne Explorer Frames Unterstützung genutzt werden, da bei diesen Geräten grundsätzlich automatisch auf die Standard-Inklusion umgestellt wird.
* Bei der Standard-Inklusion ist unter Umständen nur ein geringer Abstand zwischen Gateway und Gerät möglich. Sollte die Inklusion daher nicht durchführbar sein, wenn Gateway und Gerät an ihren örtlichen Endpositionen sind (bevorzugte Variante), dann ist der Abstand zwischen diesen versuchsweise zu verringern. Anschließend bei örtlicher Veränderung die Routen mit <code><nowiki>set <ZWave-Devicename> neighborUpdate</nowiki></code> bzw. <code><nowiki>set TYPE=ZWave:FILTER=ZWaveSubDevice=no neighborUpdate</nowiki></code> neu ermitteln lassen. Unter Umständen kann der Abstand nur schrittweise erhöht werden. Dann ist bei jeder Abstandsänderung eine Neuermittlung der Routen notwendig.
* Der NIF enthält bei manchen Geräten fälschlicherweise nicht alle unterstützten Command Classes. FHEM identifiziert während der Inklusion das Gerät und ergänzt die fehlenden Command Classes aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Weiterhin fehlende Command Classes können im Attribut <code>classes</code> manuell am Anfang der Liste entsprechend ergänzt werden. Informationen liefern die unter [[#Links|Links]] aufgeführten Datenbanken. Häufig fehlt die Pflicht-Class BASIC.
* Bei der hier beschriebenen Inklusion findet die Kommunikation zwischen Controller und Gerät anschließend dauerhaft unverschlüsselt statt. Manche Geräte bieten mit der Command Class SECURITY eine AES-verschlüsselte Kommunikation an. Da die Verschlüsselung zu einer höheren Funklast und Latenzen führt, sollte eine verschlüsselte Kommunikation nur mit Bedacht eingesetzt werden (bspw. bei Schlössern). Als Sonderfall ist das Vorgehen zur secure-Inklusion in der [[#Wie_kann_eine_verschl.C3.BCsselte_Kommunikation_unter_Nutzung_der_Command_Class_SECURITY_eingerichtet_werden.3F|FAQ]] beschrieben.

Nächster Schritt ist die [[#Assoziation|Assoziation]] des Gerätes mit dem Gateway.

=== Assoziation ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Z-Wave-Geräte können über Assoziationen direkt mit anderen Z-Wave-Geräten kommunizieren. Dies können zum einen Meldungen über den Status und Zustand der Geräte, als auch direkte Befehle sein. Zum Beispiel kann damit ein Bewegungsmelder eine entdeckte Bewegung an den Controller senden und/oder bei entdeckter Bewegung direkt eine Lampe ein- oder ausschalten.

Die Assoziation zwischen zwei Geräten wird durch Aufnahme des zu steuernden Gerätes in eine oder mehrere Assoziationsgruppe(n) des steuernden Gerätes angelegt. Durch die Wahl der Assoziationsgruppe wird festgelegt, bei welchen Ereignissen welche Nachricht an das assoziierte Gerät verschickt wird. Angaben zu den Ereignissen und versandten Nachrichten an die Geräte in einer bestimmten Assoziationsgruppe stehen in der Bedienungsanleitung des jeweiligen Gerätes.

Damit FHEM Statusmeldungen von Sensoren/Aktoren anzeigen und auch darauf reagieren kann, '''muss''' der Controller (<ZWDongle>-Device, <code>CtrlNodeId</code> = typischerweise 1) immer in der/den passenden Assoziationsgruppe(n) des jeweiligen Gerätes <code><name></code> aufgenommen werden:

set <name> associationAdd <associationGroup> <CtrlNodeId>

Typischerweise ist die Assoziationsgruppe 1 der Geräte für die Statusmeldungen an den Controller vorgesehen (Ausnahme: [[#Fibaro|Fibaro-Geräte ohne ZWave Plus - Zertifizierung]]). Daher nimmt FHEM die Assoziation von Controller mit der Assoziationsgruppe 1 des Gerätes bei der Inklusion immer automatisch vor. Zudem identifiziert FHEM während der Inklusion das Gerät und setzt weitere Assoziationen mit dem Controller für von 1 abweichende Assoziationsgruppen aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Ist keine XML-Config-Datei für das Gerät vorhanden, sind Assoziationen des Controllers mit von 1 abweichenden Assoziationsgruppen oder weiteren Assoziationsgruppen mit dem zuvor genannten Befehl grundsätzlich manuell anzulegen.

Die richtige Anlage der Assoziation(en) des Controllers mit dem Gerät immer prüfen, da dies eine Hauptfehlerquelle bei Funktionsproblemen mit FHEM ist.

Abruf der assoziierten Geräte in einer bestimmten Assoziationsgruppe <associationGroup>:
get <name> association <associationGroup>

Abruf der assozierten Geräte für alle Assoziationsgruppen eines Gerätes:
get <name> associationAll

Nahezu alle in Europa erhältlichen aktuellen Geräte unterstützen die Rückmeldung des Status via Association. Ausnahmen gibt es in Nordamerika, wo aufgrund von Patentansprüchen einige Hersteller auf die Statusrückmeldungen verzichten. Diese Geräte unterstützen in der Regel die Command Class ASSOCIATION nicht.

Nächster Schritt ist die [[#Konfiguration|Konfiguration]] des Gerätes.

=== Konfiguration ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Die Standard-Konfiguration eines Gerätes entspricht oftmals nicht den eigenen Wünschen und Anforderungen (Einheiten usw.). Mit den Befehlen der Class CONFIGURATION lässt sich die Konfiguration anpassen. Die zur Konfiguration eines Gerätes notwendigen Angaben zu den Parameternummern, -größen und -werten sind im jeweiligen Geräte-Handbuch bzw. entsprechenden Datenbanken (bspw. [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] oder [http://products.zwavealliance.com/ products.zwavealliance.com]) enthalten.

Die Konfiguration beispielsweise bei Parametergröße 1 lässt sich mit diesem Befehl anpassen:
set <name> configByte <Parameternummer> <Parameterwert>
Für weitere Parametergrößen gibt es die Befehle <code>configWord</code> und <code>configLong</code>

Die im Gerät hinterlegten Konfiguration kann pro Parameternummer mit folgendem Befehl abgerufen werden:
get <name> config <Parameternummer>

Zudem bietet FHEM basierend auf den manuell gepflegten XML-Config-Dateien die Möglichkeit, die speziellen Parameternummern des Gerätes mit ihren Parametergrößen und -werte als eigenständige config-Befehle mit Hilfsinformationen einzubinden. Ein manuelles Suchen im Geräte-Handbuch und Nutzung der configByte-, configWord- und configLong-Befehle ist dadurch in vielen Fällen unnötig. Für diese Funktion muss das Gerät von FHEM einmalig durch folgenden Befehl, der bei der Inklusion automatisch ausgeführt wird, identifiziert werden:
get <name> model
Die Readings <code>model</code>, <code>modelID</code> und <code>modelConfig</code> werden dadurch erzeugt. In <code>model</code> sollte der Klartextname des Gerätes stehen. Zudem sind dann -soweit eine XML-Config Datei für das Gerät existiert- die speziellen set/get-Kommandos configXYZ für das Geräte im Auswahldialog der Detailansicht mit Hilfsinformationen verfügbar:
[[Datei:Z-Wave_confighelp.PNG|900px|thumb|center|config-Befehl mit Hilfstext]]

Bei vorhandener XML-Config-Datei kann die komplette Konfiguration eines Gerätes abgerufen werden:
get <name> configAll

Außerdem wird durch den <code>get <name> model</code> -Befehl geprüft, ob das Gerät in der [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] und/oder [http://products.zwavealliance.com/ products.zwavealliance.com] enthalten ist. Im Erfolgsfall wird ein Link "Details in pepper DB" und/oder "Details in alliance DB" zum entsprechenden Geräteeintrag in der jeweiligen Datenbank unten in der Detailansicht des FHEM-Geräte-Devices angelegt und ein Bild des Gerätes in die Detailansicht eingebunden.

Der Aufruf von <code>get <name> model</code> ist auch für die Nutzung der Class MANUFACTURER_PROPRIETARY zwingende Einsatzvoraussetzung.

=== Entfernen eines Z-Wave-Geräts / Exklusion ===
Durch die Exklusion wird die Home-ID und Node-ID aus dem Gerät und das Gerät selbst aus der Node-List des Controllers gelöscht. Erst nach einer Exklusion kann das Gerät in ein anderes Z-Wave-Netz aufgenommen werden.

Zuerst wird der Z-Wave Gateway in den Standard-Modus zur Exklusion (Ausschluss) von Geräten gesetzt:
set <ZWDongle> removeNode on

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt dem obigen Befehl besser der Network-Wide-Modus für die Exklusion genutzt werden (siehe auch Erläuterungen zu Standard- versus Network-Wide-Inklusion unter [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]]):
set <ZWDongle> removeNode onNw

Danach muss das Gerät in den Exklusionsmodus (Ausschlussmodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen.

Abschließend wird der Exklusionsmodus am Z-Wave Gateway wieder ausgeschaltet:
set <ZWDongle> removeNode off

Das FHEM-Device muss nach der Exklusion manuell durch <code>delete <name></code> gelöscht werden.

Die durch die Exklusion frei gewordene NodeID wird nicht bei der nächsten Inklusion wiederverwendet, sondern es wird die höchste noch nicht verwendete NodeID genutzt.

=== Erneutes Hinzufügen eines bereits registrierten Z-Wave Geräts ===
Die an einem Z-Wave-Gateway bereits registrierten/inkludierten Geräte sind im Gateway selbst abgespeichert und können durch FHEM jederzeit wieder abgerufen werden. Dies kann man in folgenden Fällen sinnvoll nutzen:
* Inklusion mit einem batteriegespeisten ZWave-Gateway (bspw. Aeon Labs Z-Stick) ohne FHEM-Server-Anschluss während der Inklusion
* Umstieg eines ZWave-Netzwerkes von Fremdsoftware auf FHEM
* Vollständiger oder teilweiser Verlust der FHEM-Konfiguration

Eine Node-Liste aller inkludierten Geräte des Gateways wird abgerufen durch:
get <ZWDongle> nodeList
Es wird eine Liste aller im Gateway inkludierten Gerät inklusive Gateway selbst zurückgeliefert. Sofern ein Gerät bereits als FHEM-Device angelegt wurde, wird der FHEM-Device-Name in der nodeList angezeigt. Dies ist für das Gateway selbst immer der Fall. Alle noch nicht in FHEM angelegten Geräte, werden als "UNKNOWN_x" ausgegeben, wobei x die ID des betreffenden Gerätes ist.

Mit dem folgenden Befehl wird beispielsweise das bereits im Gateway inkludierte Gerät mit der ID 2 (in der nodeList angezeigt als "UNKNOWN_2") in FHEM durch autocreate definiert:
set <ZWDongle> createNode 2

Batteriebetriebene Geräte müssen bei Absetzen des <code>createNode</code>-Befehls wach sein, damit der Befehl verarbeitet werden kann. Dies erreicht man, indem man das Gerät auf "permanent wach" stellt. Falls das Gerät diese Funktion nicht anbietet, muss man es manuell aufwecken und max. 2 Sekunden später den <code>createNode</code>-Befehl absetzen. Alternativ kann das batteriebetriebene Gerät durch Versand des NIF vom Gerät aus automatisch in FHEM erzeugt werden: Hierzu am Gerät die Taste zum Versand des NIF drücken und <code>autocreate</code> legt das FHEM-Device an; der Aufruf von <code>createNode</code> entfällt dann.

== Geräte-Besonderheiten ==
=== batteriebetriebene Geräte ===
Batteriebetriebenen Geräten können hinsichtlich ihrer Empfangsbereitschaft unterschieden werden in

* Wakeup-Geräte
* FLIRS-Geräte

==== Wakeup-Geräte ====
Wakeup-Geräte sind momentan die häufigste Art von batteriebetriebenen Z-Wave Geräten. Sie sind erkennbar an der Unterstützung der Command Class WAKE_UP.
Zur Verlängerung der Batterielaufzeit legen sich batteriebetriebene Wakeup-Geräte „schlafen“ und wachen (Wakeup) nur in konfigurierbaren Intervallen auf, um Befehle zu verarbeiten. Das Aufwachen signalisieren die Geräte durch den Versand einer Nachricht "wakeup notification". Daraufhin senden FHEM und andere Geräte ihre bis dahin gesammelten Befehle, die dann verarbeitet bzw. beantwortet werden. Anschließend gehen die batteriebetriebenen Geräte wieder in den Schlafmodus.

FHEM teilt bei set/get-Befehlen an batteriebetriebene Geräte über einen Hinweis der Form
:<code>Scheduled for sending after WAKEUP</code>
::oder
:<code>Scheduled get requests for sending after WAKEUP</code>
mit, dass der Befehl im Sendstack des FHEM-Geräte-Devices abgespeichert wurde und bei der nächsten "wakeup notification" an das Gerät versendet wird. Ein Versand der Befehle im Sendstack findet grundsätzlich ausschließlich nach Erhalt der "wakeup notification"-Nachricht statt, selbst wenn das Gerät zwischendurch andere Telegramme (bspw. Bewegungsmeldung, Temperatur) an den Controller verschickt. Nur nach Versand der "wakeup notification" ist das batteriebetriebene Gerät grundsätzlich in der Lage ("wach genug"), Telegramme korrekt zu empfangen und zu verarbeiten.

Wie viele Nachrichten im Sendstack auf einen Versand an das Gerät warten, ist im Internal <code>cmdsPending</code> des zugehörigen FHEM-Devices ersichtlich. Welche Nachrichten (Befehle) im Sendstack warten, ist in der Ausgabe des Befehls <code>[[list]] <device></code> erkennbar: Unter der Überschrift Sendstack sind alle wartenden Nachrichten als Rohnachrichten aufgeführt. Der Sendstack wird beim Beenden von FHEM nicht gespeichert. Durch Beenden von FHEM (beispielsweise durch <code>shutdown restart</code>) geht der Sendstack der Geräte daher verloren.

Das Wakeup-Interval und der Empfänger der "wakeup notification" wird wie folgt konfiguriert:
<nowiki>set <name> wakeupInterval <time> <NodeId></nowiki>
<nowiki><time></nowiki> ist die Zeit in Sekunden zwischen den Intervallen und <nodeID> der gewünschte Empfänger der "wakeup notification"; in der Regel ist dies '''immer''' der Controller <CtrlNodeId>. Viele Geräte kommen im Auslieferungszustand mit der NodeID 255. Die "wakeup notification" wird dann als Broadcast ohne Nutzung von Routing an alle erreichbaren Geräte gesendet. Hier sollte die Konfiguration auf die NodeID des Controllers geändert werden, da dadurch die "wakeup notification" geroutet wird und größere Entfernungen zwischen Gerät und Controller möglich sind. Zudem ist dies robuster und spart zusätzlich noch Batterielaufzeit. Darum setzt FHEM bei der Inklusion von WakeUp-Geräten '''automatisch''' den Befehl <code><nowiki>set <name> wakeupInterval 86400 <ControllerNodeId></nowiki></code> ab. Bei abweichenden eigenen Vorstellungen ist dies gegebenenfalls anzupassen. Bei Geräten mit V2 der Command Class WAKE_UP kann das vom Hersteller vorgesehene Standard-wakeupInterval mit <code><nowiki>get <name> wakeupIntervalCapabilities</nowiki></code> vom Gerät abgerufen werden. Die Einstellungen von wakeupInterval nach Inklusion und nach jeder Änderung immer mit der Abfrage <code><nowiki>get <name> wakeupInterval</nowiki></code> überprüfen.

Ein Aufwachen und Versand der "wakeup notification" von batteriebetriebenen Geräten kann für die [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] manuell erzwungen werden. Hierzu bringt man das Gerät normalerweise in den Inklusionsmodus oder findet in der Bedienungsanleitung gegebenenfalls andere Informationen. Bitte beachten, dass dann je nach Gerät nur eine geringe Entfernung von Gateway und Gerät vorhanden sein darf (direkte Erreichbarkeit). Alternativ kann für die Dauer der Assoziation und Konfiguration das Wakeup-Interval verkürzt werden (beispielsweise auf 60 Sekunden), wodurch das Routing genutzt werden kann und größere Entfernungen zwischen Gateway und Gerät überbrückt werden können. Anschließend das Wakeup-Interval wieder auf eine batterieschonenende Dauer einzustellen.

Einzelne batteriebetriebene Gerät lassen sich für längere Zeit auf "wach" bzw. permanent "wach" stellen. Dann aus dem Attribut <code>classes</code> <code>WAKE_UP</code> entfernen, damit Befehle in diesem Gerätemodus von FHEM direkt verschickt werden. Nach Ausschalten des "wach"-Modus <code>WAKE_UP</code> wieder im Attribut <code>classes</code> aufnehmen.

Bei Konfigurationsänderungen an batteriebetriebenen Geräten mit <code>set <name> config...</code> sollte die korrekte Verarbeitung der Befehle immer mit dem entsprechenden <code>get <name> config...</code> oder -falls vorhanden- mit <code>get <name> configAll</code> überprüft werden, um eventuelle Funk-Telegrammverluste sofort festzustellen.

==== FLIRS-Geräte ====
Ein batteriebetriebene FLIRS (frequently listening routing slave) Gerät wacht in sehr kurzen Zeitabständen (250ms oder 1000ms) auf und prüft, ob ein Funksignal vorliegt. Liegt kein Funksignal vor geht das Gerät wieder in Tiefschlaf. Zum Aufwecken eines FLIRS-Gerätes ist ein dauerhaftes Funksignal -der Wakeup-Beam-, notwendig, das etwas länger als die Aufweckzeitabstände sein muss. Näher beschrieben unter anderem [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF hier].

FLIRS-Geräte haben nicht die Command Class WAKE_UP und arbeiten deshalb nicht mit "wakeup notification". Aus Sicht des FHEM-Nutzers sind die bekannten FLIRS-Geräte (Sirenen von Vision und Popp) nicht anders zu bedienen/einzurichten als netzgespeiste Geräte. Wakeup-Beam und andere Besonderheiten werden unsichtbar für den Nutzer automatisch abgewickelt.

=== Aeon Labs / Aeotec ===
Ausführliche Handbücher und technische Informationen auf https://aeotec.freshdesk.com/support/home

==== Multi Sensor 5 ====
* aktuellste Firmware installieren
* Attribut <code>classes</code> um <code>BASIC</code> ergänzen (ab [[version|Modulversion]] 8824/25.6.2015 wird das automatisch bei der Inklusion durchgeführt)
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* Parameter 101 auf 225 (oder 224 bei USB-Anschluss) setzen mit <code>set <name> configGroup1Reports 225</code> oder <code>set <name> configLong 101 225</code>, um Batteriezustand (nicht bei 224), Temperatur, Feuchte und Helligkeit regelmäßig zu erhalten. Das Sende-Intervall wird duch <code><nowiki>set <name> configGroup1Interval <time/s></nowiki></code> festgelegt (Standard 720 Sek).
* [http://devel.pepper1.net/zwavedb/device/407 Paramterübersicht pepper-Datenbank]
siehe {{Link2Forum|Topic=34505|Message=268913}}

==== Multisensor 6 ====
siehe {{Link2Forum|Topic=40393}}
* arbeitet bei USB-Anschluß als Router
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* die <code>configGroupxInterval</code> und <code>configxxxReportingThreshold</code> Einstellungen wirken nur bei USB-Anschluss, im reinen Batteriebetrieb werden die Sensordaten nur bei einem <code>wakeup</code> übertragen

==== Aeotec LED Bulb ZW098-C55 ====
siehe {{Link2Forum|Topic=40504}}

=== Danfoss ===
==== DAN_LC-13 Heizungsthermostat LC-13 (014G0013) ====
Das Danfoss Heizungsthermostat LC-13 muss derzeit zur korrekten Funktion mit FHEM regelmäßig mit folgendem <code>at</code> abgefragt werden ({{Link2Forum|Topic=32145|Message=260795}}):
define Atdanfoss at +*00:30 get <name> battery
Auf dem Markt sind mehrere Varianten des Thermostates LC-13 erhältlich. Darum beim Kauf unbedingt auf die genaue Bezeichnung LC-13 (014G0013) achten ({{Link2Forum|Topic=38041|Message=303146}}).

=== devolo ===
Ausführliche Handbücher auf http://products.z-wavealliance.org

==== MT02648 Tür-/Fenster Kontakt 3in1 ====
siehe {{Link2Forum|Topic=41337}}

=== DüWI ===
Geräte von DÜWI liefern bei örtlicher Betätigung kein automatisches Funk-Signal über die Statusänderung. Das liese sich nur durch eine regelmäßige Statusabfrage durch FHEM (beispielsweise <code>define Status_Abfrage at +*00:03:00 get <name> swmStatus</code>) beheben.
Einige Produkte von [http://zwave.me Z-Wave.Me] basieren auf DÜWI-Geräten. Diese Z-Wave.Me Produkte haben jedoch eine erweiterte Firmware, welche die genannte und weitere Firmware-Schwächen der Original-Produkte von DÜWI behebt.

=== Everspring ===
==== AN145 Sockelmodul E27 ====
Statusabfrage ohne permanente Abfrage: {{Link2Forum|Topic=48864|Message=405545|Beitrag}}

=== Fibaro ===
Association Group für Übermittlung von Statusinformationen an den Controller:
* "alte" ZWave-Geräte (kein ZWave-Plus): häufig Association Group 3
: <code><nowiki>set <name> associationAdd 3 <CtrlNodeId></nowiki></code>
: Bei diesen Geräten empfiehlt es sich zur Funklastreduzierung und Problemminimierung zu prüfen, ob die von FHEM automatisch vorgenommene Assoziation des Controllers mit der Association Group 1 gelöscht werden kann (<code><nowiki>set <name> associationDel 1 <CtrlNodeId></nowiki></code>). Nahezu immer werden in Association Group 1 die gleichen Infos, nur mit einer anderen Command Class, wie in der Association Group 3 an den Controller übermittelt.
* ZWave Plus-Geräte: Association Group 1 ("lifeline")

==== FGSS-001 / FGSD-002 Rauchmelder ====
* nicht untereinander vernetzbar
* keine Alarmauslösung/Sirenenfunktion durch ZWave-Zentralen

==== FGS-222 Relais Unterputzeinsatz ====
Bei der Inklusion werden von FHEM 3 Devices angelegt:
* Hauptdevice (Steuerung und automatischer Status für Kanal 1 und kanalübergreifende Funktionen)
* Device für Endpoint 1 (Steuerung Kanal 1)
* Device für Endpoint 2 (Steuerung und automatischer Status von Kanal 2)
Die Firmware des FGS-222 übermittelt den Status für Kanal 1 automatisch immer ausschließlich an das Hauptdevice. Die Steuerung von Kanal 1 kann hingegen sowohl über das Hauptdevice als auch über das Device für Endpoint 1 erfolgen. Das Device für Endpoint 1 ist somit nicht zwingend erforderlich und kann grundsätzlich gelöscht oder in den room hidden verschoben werden.

Details: {{Link2Forum|Topic=50176}}

Hinweis zum Reset: {{Link2Forum|Topic=55190|Message=469393}}

==== FGK-101 Tür/Fensterkontakt ====
* Besonderheiten bei Anschluss eines Temperatursensors: {{Link2Forum|Topic=38012}}

=== GE ===
==== GE (Model t.b.d) ====
Dieser Schalter unterstützt keine Statusrückmeldungen.

=== Merten ===
Laut {{Link2Forum|Topic=38133}} müssen bei einigen Merten-Geräten, die mit Fremdsoftware inkludiert wurden, gegebenenfalls die Geräte wieder exkludiert und dann erneut mit FHEM inkludiert werden, damit Assoziationen mit FHEM gesetzt werden können.

=== Philio ===
==== PHI_PAN04 Relais Unterputzeinsatz 2 Schalter a 1.5kW mit Messfunktion ====
siehe {{Link2Forum|Topic=28046}}

=== Popp ===
==== POPE004001 Z-Wave Rauchmelder mit Innensirene ====
siehe {{Link2Forum|Topic=39856}}
==== POPE005107 Z-Wave Außensirene ====
siehe {{Link2Forum|Topic=42736}}<br>
Alte Firmwareversionen haben einen Bug bei der Übermittlung von negativen Temperaturen. Eine Lösungsvariante über ein <code>userReadings</code> findet sich auch im verlinkten Thema.
==== POPE009006 Z-Wave Wall Plug Switch ====
siehe {{Link2Forum|Topic=40771}}
==== POPE009402 10Year Smoke Detector ====
Die erste Firmwareversion hat eine fehlerhafte modelID. Diese Rauchmelder wird dadurch fälschlich als [[Z-Wave#POPE005107_Z-Wave_Au.C3.9Fensirene|Popp Aussensirene]] in FHEM angezeigt. Neuere Geräte werden laut Popp mit der korrekten modelID ausgeliefert.

=== Z-Wave.Me ===
==== ZME_RC2 Fernbedienung ====
siehe {{Link2Forum|Topic=35513}}<BR>
Das Forenthema enthält eine detaillierte Beschreibung der Nutzung der Class MULTI_CHANNEL_ASSOCIATION.

== Geräte-Vergleich ==
=== Doppel-Relais ===
{| class="wikitable"
|-
! Eigenschaft !! FIBARO Double Switch 2-FGS-223 !! Qubino Flush 2 relays !! Philio-PAN04 1
|-
| Funktion || Doppel-Relais || Doppel-Relais || Doppel-Relais
|-
| Standby-Leistung || ca. 0.4W || ca. 0.4W || ca. 0.5W
|-
| Reaktion beim Schalten am Tastereingang || schnell, kaum merkliche Verzögerung || schnell, kaum merkliche Verzögerung || langsam, unangenehm langes drücken des Tasters nötig >1 Sekunde
|-
| Geräte in FHEM || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 4 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 <br> x.03 Summengerät (ähnlich Hauptgerät, überflüssig)
|-
| Zustand Hauptgerät || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais
|-
| Statuswechsel Report vom Gerät zum FHEM || ca. 1 Sekunde || ca. 3 Sekunden || ca. 3-4 Sekunden
|-
| Empfänger des Status Reports || Hauptgerät und Untergeräte || Hauptgerät und Untergeräte || Nur Hauptgerät <br>Aktualisierung der Untergeräte nur bei aktiver Abfrage
|-
| Leistungsmessung || Separat für Untergeräte || Separat für Untergeräte || Nur Summe
|-
| Sicherung nötig / Strom || ja, 2x 6.5A, Summe max 10A || ja, max 2x 4A || nein, 2x 6.5A
|}
Beim Qubino Flush 2 relays muss eine MULTI_CHANNEL_ASSOCIATION mit dem Controller (Endpoint root) statt einer "normalen" Assoziation gesetzt werden, damit die Status der Untergeräte einzeln signalisert werden:

set associationDel 1 <controllerNodeId>
set <device> mcaAdd 1 0 <controllerNodeId> 0

Bei einem FHEM-Updatestand ab 20.09.2019 erfolgt diese Einstellung automatisch.

== Links ==
=== Allgemein ===
* Grundlageninformation "Z-Wave-Haupt-Anleitung": [http://www.zwave.de/z-wave-funknetz-einrichten-und-betreiben/ Wie errichte und betreibe ich ein Z-Wave basiertes Funknetz]
* [http://www.zwave.de/buch-z-wave-grundlagen/ Buch] "Z-Wave: Die Funktechnologie für das Smart Home" von Dr. Christian Paetz (Paetz "is the primary European representative for the Z-Wave Alliance" [http://z-wavealliance.org/global-contacts/])
* Z-Wave-Produktdatenbank mit Angabe zur Zertifizierung, Handbüchern und weiteren Detailinfos (Z-Wave oder [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus]): http://products.z-wavealliance.org (englisch)
* herstellerübergreifende Datenbank mit Bedienungsanleitungen zu Z-Wave-Geräten: http://www.zwave.de/handbuecher/ oder http://manuals.zwaveeurope.com (mehrsprachig)
* herstellerübergreifende Datenbank mit technischen Informationen zu Z-Wave-Geräten (Z-Wave Device Library): http://devel.pepper1.net/zwavedb/ (englisch; wird derzeit nicht mehr aktualisiert)
* informative Webseiten zu Z-Wave:
** [http://www.z-wavealliance.org/ http://www.z-wavealliance.org/] (englisch)
** [http://www.zwaveeurope.com/ http://www.zwaveeurope.com/] (englisch)
** [http://www.zwave.de/ http://www.zwave.de/] (deutsch)
** [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF Introductory Guide to Z-Wave-Technology von Honeywell] (englisch; nicht auf aktuellem Stand)

=== Informationsquellen zur Einbindung von Command Classes ===
Offizielle und ausführliche Informationen von Sigma Designs (veröffentlicht am 31.08.2016):
* [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification]

Weitere Informationen (seit Veröffentlichung der Z-Wave Spezifikationen am 31.08.2016 geringe Relevanz)
* [https://github.com/yepher/RaZBerry Infos zu Command Classes (ausführlich; insbesondere im Verzeichnis "docs"), RaZBerry und Z-Wave allgemein], englisch
* [http://220.135.186.178/zwave/example/ Übersicht von Command Classes und deren Rückgabewerten mit Unterscheidung der Class-Versionen], englisch
* Code von http://www.openzwave.org (https://github.com/OpenZWave/open-zwave) und http://www.openhab.org (Z-Wave binding: https://github.com/cdjackson/openhab)
* eine Java-API-Beschreibung mit Hinweisen zu Unterschieden von Class-Versionen: http://dz.prosyst.com/pdoc/mBS_SH_SDK_8.1/modules/zwave/api/driver/index.html

== FAQ ==
=== Welche Infos sollten Anfragen im ZWave-Forum enthalten? ===
* Anfragen bitte nur zur aktuellsten FHEM-Version: Befehl <code>update</code> ergibt Ausgabe "nothing to do..."
* detaillierte Beschreibung des Problems
* beteiligte Komponenten (genaue Bezeichnung und evtl. Link auf Hersteller-Dokumentation)
* list des jeweiligen FHEM-Devices (Ausgabe von <code>list <device></code>)
::Bitte vor Aufruf des list-Befehls -wenn vorhanden/möglich- folgende Befehle ausführen und Ergebnis abwarten:
::*<code>get <device> associationAll</code>
::*<code>get <device> configAll</code>
::*<code>get <device> versionClassAll</code>
::*<code>get <device> mcaAll</code>
::*<code>get <device> wakeupInterval</code> (nur bei batteriebetriebenen Geräten)
* passender Ausschnitt aus dem Logfile (siehe Link im FHEM-Menü links) generiert mit den gesetzten Attributen
::*<code>attr <ZWDongle> verbose 5</code> und
::*<code>attr global mseclog 1</code>

=== Welche Schritte sind für die Einbindung von ZWave-Geräten in FHEM mindestens durchzuführen? ===
Voraussetzung: ZWave-Gateway ist erfolgreich eingebunden!
# [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes
# [[#Assoziation|Assoziation]] der Assoziationsgruppe(n) des Gerätes mit dem Gateway
# [[#Konfiguration|Konfiguration]] des Gerätes

=== Warum bleibt der Status (STATE) des neu inkludierten Gerätes dauerhaft auf "associationAdd <associationGroup> <CtrlNodeId>" stehen? ===
FHEM setzt das Reading "state", das den STATE bestimmt, nicht bei allen ZWave-Devices mit vordefinierten Standardwerten. Daher bleibt der bei der Inklusion automatisch abgesetzte "associationAdd"-Befehl unter Umständen im STATE stehen, bis der Anwender den STATE über die Vergabe des Attributes <code>{{Link2CmdRef|Anker=stateFormat|Label=stateFormat}}</code> manuell an seine Bedürfnisse angepasst hat.
(weitergehende Info zum state/STATE/stateFormat: [[DevelopmentState]])

=== Wie können bei mehrkanaligen Aktoren die zusätzlichen Kanäle (>1) angesprochen werden? ===
* Bei der [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes wird das Hauptdevice mit dem Namen <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> und die Devices für alle Kanäle (Endpoints) nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID>.<EndpointNr></nowiki></code> automatisch angelegt. Jedes dieser FHEM-Devices spricht regelmäßig einen bestimmten Kanal des Gerätes an; einige Geräte sprechen mit dem Hauptdevice jedoch das gesamte Gerät mit allen Kanälen an (Bedienungsanleitung beachten).
* Manuell werden Devices für zusätzliche Kanäle mit Hilfe der Befehle <code>get <device> mcEndpoints</code> und <code>get <device> mcCapability <chid></code> aus der Class MULTI_CHANNEL ermittelt bzw. einzeln über autocreate angelegt (Details und Beispiel siehe {{Link2CmdRef|Anker=ZWaveget}}). Mit dem Befehl <code>set <device> mcCreateAll</code> werden automatisch alle Kanäle des Gerätes durch autocreate als eigene Devices in FHEM angelegt.

=== Wie kann man die SDK-Version eines Gerätes herausfinden? ===
Mit FHEM alleine kann eine [[#Grobermittlung|Grobermittlung]] der SDK-Version vorgenommen werden, die aber für einige Zwecke bereits ausreichend ist. Soll eine [[#Detailermittlung|Detailermittlung]] der genauen SDK-Version erfolgen, dann müssen die mit FHEM ermittelten Werte anhand externer Quellen übersetzt werden.
==== Grobermittlung ====
Der Befehl <code><nowiki>get <ZWDongle> nodeInfo <dezimale nodeId></nowiki></code> liefert das Reading <code><nowiki>nodeInfo_<dezimale nodeId></nowiki></code> zurück.
Die Angabe im Reading hinter <code>ProtocolVers:</code> lässt grobe Rückschlüsse zu. Mögliche (bekannte) Werte:
* <code>2</code> -> bspw. keine Explorer Frames, keine SUC-Unterstützung (veraltet, keine bekannten Geräte mehr im Handel)
* <code>SDK5.0x+4.2x</code> -> bspw. keine Explorer Frames, teilweise SUC-Unterstützung
* <code>SDK4.5x+6.0x</code> -> bspw. Explorer Frames- und SUC-Unterstützung (Reading-Wert wird auch bei SDK 6.5x = Z-Wave Plus angezeigt)
==== Detailermittlung ====
Durch den Befehl <code><nowiki>get <name> version</nowiki></code> kann man die ZWave-Protokoll-Version von Geräten und Controller abfragen. Mit Unterstützung von Übersetzungstabellen
* http://wiki.micasaverde.com/index.php/ZWave_Protocol_Version
* Suche nach sdkids.xml in einer Suchmaschine
kann aus der Protokoll-Version das genutzte SDK festgestellt werden.

Beispielsweis entspricht das Reading eines Gerätes "Lib 6 '''Prot 2.64''' App 1.6" dem SDK 5.02 Patch 2 oder eines Controller "Z-Wave '''3.41''' STATIC_CONTROLLER" dem SDK 6.02.00.

HINWEIS: Bei der Vergabe der Protokoll-Version und zugehörigem SDK gibt es keine erkennbare Logik: Eine höhere Protokoll-Version steht nicht notwendig für eine höheres SDK.

=== Wie kann eine verschlüsselte Kommunikation unter Nutzung der Command Class SECURITY eingerichtet werden? ===
{{Randnotiz|RNText=FHEM unterstützt derzeit ausschließlich SECURITY 1 und nicht das mit dem SDK 6.7 neu eingeführte SECURITY 2 (S2). Soweit bekannt, sind S2-Geräte rückwärtskompatibel zu SECURITY 1.}}
Die verschlüsselte Kommunikation zwischen Controller und Endgerät setzt eine secure-Inklusion voraus. Bereits mit der Inklusion wird entschieden, ob die Kommunikation von Controller und Endgerät dauerhaft verschlüsselt oder unverschlüsselt erfolgt. Ist ein Gerät bereits normal inkludiert und entscheidet man sich nachträglich für eine verschlüsselte Kommunikation, so ist das nur möglich, indem das Gerät exkludiert und dann wieder secure inkludiert wird.

Ob die Verschlüsselung bei einem Gerät mit Unterstützung der Command Class SECURITY genutzt werden soll, sollte genau überlegt werden. Die Verschlüsselung führt zu einem deutlich größeren Funkverkehr zur Ausführung eines Befehls und teilweise auch zu spürbaren Latenzen.

Vorarbeiten:
* Das Perl-Modul Crypt-Rijndael muss installiert sein.
* Das Attribut <code>networkKey</code> muss mit einem 32-Zeichen langen Hexzahl beim ZWDongle angelegt werden. Dieser Schlüssel sollte nicht veröffentlicht werden und auch zusätzlich separat (bspw. auf Papier) festgehalten werden. Bei Verlust des Attributes und Schlüssels ist eine Kommunikation nur nach erneuter Inklusion möglich.

Ablauf der secure-Inklusion:
* Controller in den Modus zur secure-Inklusion schalten:
: <code>set <ZWDongle> addNode onSec</code> für die Standard-secure-Inklusion
: oder alternativ
: <code>set <ZWDongle> addNode onNwSec</code> für die Nework-Wide-secure-Inklusion
* Gerät gemäß Handbuch in den Modus zur secure-Inklusion bringen (teilweise ist jeweils für secure- und normale Inklusion ein anderes Vorgehen notwendig!)
* Das Gerät sollte jetzt automatisch erkannt und das FHEM-Device durch <code>autocreate</code> angelegt werden. Die secure-inkludierten Geräte haben ein zusätzliches Attribut <code>secure_classes</code> in dem die Command Classes deren Kommunikation verschlüsselt abläuft aufgelistet sind. Nicht in diesem Attribut, aber in <code>classes</code> aufgeführte Command Classes wickeln die Kommunikation weiterhin unverschlüsslt ab.
* Inklusionsmodus des Controllers ausschalten:
: <code>set <ZWDongle> addnode off</code>
* Das Vorgehen in FHEM unterscheidet sich von nun an nicht von normal (unverschlüsselt) inkludierten Geräten. Die Verschlüsselung läuft für den Anwender transparent ab. Darum anschließend [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] vornehmen.

=== Wie kann man ohne Exklusion Nodes des Controllers löschen? ===
HINWEIS: Geräte sollten grundsätzlich immer über eine Exklusion aus der Nodelist des Controllers gelöscht werden. Das nachfolgend geschilderte Vorgehen ist nur in Sonderfällen (bspw. Gerätedefekt, gebraucht gekauftes Gateway) anzuwenden.

Nicht mehr zu erreichende/reagierende Nodes (Geräte) können manuell mit dem Befehl <code>removeFailedNode</code> gelöscht werden. Dazu muss sich der betroffene Node auf der FailedNodeList des Controllers befinden. Auf die FailedNodeList kommen netzbetriebene Geräte automatisch, wenn sie vom Controller nicht mehr per Funk erreicht werden. Batteriebetriebene Geräte müssen manuell auf die FailedNodelist gesetzt werden, da der Controller nicht feststellen kann, ob sie nur langfristig "schlafen".

Der Befehl <code>removeFailedNode</code> löscht nur Nodes auf der FailedNodeList, die erst vor Kurzem nicht erreicht werden konnten. Darum muss sowohl das manuelle Verschieben von batteriebetriebenen als auch das Nicht-Erreichen der netzbetriebenen Geräte erst Kurz vor Aufruf des <code>removeFailedNode</code>-Befehls erfolgt sein.

Vorgehensweise für den Node <NodeId>:
# An den betroffenen Node eine Telegramm mit <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> verschicken, um ihn auf FailedNodeList zu verschieben bzw. Zeitstempel zu aktualisieren.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und kann mit <code>removeFailedNode</code> gelöscht werden.
# Befehl zum Löschen des Nodes absetzen: <code><nowiki>set <ZWDongle> removeFailedNode <NodeId></nowiki></code>. Der Befehl testet vor dem Löschen noch einmal, dass der Node nicht erreicht werden kann und entfernt erst dann den Node.
# Prüfen, der Ergebnisse des <code>removeFailedNode</code>-Befehls im Log oder [[Event monitor]]. Die verschiedenen Ergebnisse werden durch die in der {{Link2CmdRef}} dokumentierten Events signalisiert. Tritt das Ergebnis "failedNodeRemoveProcessBusy" mehrfach hintereinander auf, muss das ZWDongle kurz stromlos gemacht werden.
# Prüfen, ob der Node nicht mehr auf der Nodelist des Controllers ist: <code><nowiki>get <ZWDongle> nodeList</nowiki></code>

siehe auch {{Link2Forum|Topic=32823|Message=292626}}

=== Wie ist der einfachste Weg ein (defektes) Gerät durch ein gleiches Ersatzgerät auszutauschen? ===
Tauscht man ein defektes Gerät durch ein gleiches Ersatzgerät und inkludiert das Ersatzgerät per <code>addNode</code>, so erhält das Ersatzgerät eine neue NodeId. Soll das Ersatzgerät die gleiche NodeId wie das alte Gerät erhalten, so muss statt <code>addNode</code> der Befehl <code>replaceFailedNode</code> zur Inklusion des Ersatzgerätes (=gleiches Modell) verwendet werden.

Vorgehensweise für den Node <NodeId>:
# sofern das alte Gerät noch ansprechbar ist, die Konfiguration und Assoziationen abfragen, damit man die Werte im Ersatzgerät einfach wieder setzen kann:
## <code><nowiki>get <device> configAll</nowiki></code>
## <code><nowiki>get <device> associationAll</nowiki></code>
# defektes Gerät aus- und neues einbauen
# Befehl <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> absetzen, damit das Dongle die NodeId auf die FailedNodeList setzt.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und das Ersatzgerät kann mit <code>replaceFailedNode</code> inkludiert werden.
# <code><nowiki>set <zwdongle> replaceFailedNode <NodeId></nowiki></code> für die NodeId des defekten Gerätes aufrufen und das Ersatzgerät in den Inklusionsmodus bringen
# Korrekte Inklusion prüfen und beim alten Aktor ausgelesene Werte beim neuen Aktor wieder setzen.

=== Bei einer Inklusion wird eine durch Exklusion/removeFailedNode frei gewordenen NodeId nicht mehr vergeben. Ist das korrekt? ===
Ja, das ist richtig.

Bei der Inklusion über addNode vergibt der Controller die höchste bisher noch nie verwendete NodeID. Durch Exklusion oder removeFailedNode frei gewordene NodeIDs werden hierbei zunächst nicht erneut vergeben. Diese frei gewordenen NodeIds werden bei Inklusionen in aufsteigender Reihenfolge erst wieder vergeben, nachdem die höchste verfügbare NodeId (232?) inkludiert wurde. Sie sind somit grundsätzlich nicht verloren.

=== Welche Funktion haben die XML-Config-Dateien in FHEM? ===
In den XML-Config-Dateien sind Informationen zu einzelnen ZWave-Geräten enthalten, die der Erleichterung der Gerätenutzung und -einbindung in FHEM dienen. Dies sind unter anderem Erläuterungen zu den Parameternummer/-werten, Assoziationsgruppen und Besonderheiten eines Gerätes. Ob eine zum Zwave-Gerät passende XML-Config Datei existiert, wird im Rahmen der Inklusion oder durch manuellen Aufruf des Befehls <code>get <name> model</code> ermittelt. Wird eine passende XML-Config-Datei gefunden, wird sie automatisch in FHEM eingebunden. Das Reading <code>modelConfig</code> enthält dann den zugehörigen XML-Config-Dateinamen. Stehen keine XML-Config-Informationen bereit, enthält das Reading <code>modelConfig</code> den Wert "unknown". Die Funktionsfähigkeit von FHEM mit ZWave-Geräten ist auch bei fehlender XML-Config-Datei gegeben. Es gibt dadurch keine funktionalen Einschränkungen in FHEM; es entfallen "nur" Erleichterungen und es sind unter Umständen mehr manuelle Schritte bei der Gerätenutzung/-einbindung notwendig.

Erleichterungen bei vorhandener XML-Config für ein ZWave-Gerät:
* Bei der Inklusion:
** Assoziationen mit dem Controller bei von Gruppe 1 abweichenender Assoziationsgruppe werden automatisch gesetzt
** vom NIF nicht gemeldete, aber vom Gerät unterstützte Classes, werden im Attribut <code>classes</code> ergänzt
* Bei der Konfiguration:
** die Parameternummern stehen als configXY-Befehle zur Verfügung und werden mit Hilfetexten -auch zu den Parameterwerten- in der Detailansicht des FHEM-Device erläutert.

HINWEIS: Bitte auch bei vorhandener XML-Config-Datei nach der Inklusion und bei der Konfiguration die Assoziationen und Parameter prüfen. Von den eigenen Vorstellungen abweichende Vorgaben oder gar Fehler in der Config-Datei können nie ausgeschlossen werden. Fehler bitte im Forum ({{Link2Forum|Area=ZWave}}) melden.

=== Wie können fehlende XML-Config-Informationen für mein ZWave-Gerät in FHEM eingebunden werden? ===
Die XML-Config-Informationen von FHEM sind in folgenden Dateien im Ordner fhem/FHEM/lib gespeichert:
* openzwave_manufacturer_specific.xml
* openzwave_deviceconfig.xml.gz
* fhem_zwave_deviceconfig.xml.gz
Die in den Dateien enthaltenen Informationen beruhen in großen Teilen auf Daten von openzwave und übernehmen daher das openzwave-Datenformat, das unter https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices näher beschrieben wird.

Die Datei "openzwave_manufacturer_specific.xml" enthält die eindeutige Kennung des ZWave-Gerätes, die in FHEM nach Aufruf des Befehls <code>get <name> model</code> im Reading <code>modelId</code> des FHEM-ZWave-Devices steht. Weiterhin wird der Klartextname dieses Gerätes, der im Reading <code>model</code> angezeigt werden soll, festgelegt. Zudem wird der Dateiname der eigentlichen XML-Config-Datei für das ZWave-Gerät angegeben, der später informativ im Reading <code>modelConfig</code> steht.

Die Dateien "openzwave_deviceconfig.xml.gz" und "fhem_zwave_deviceconfig.xml.gz" enthalten in komprimierter Form die eigentlichen XML-Config-Dateien für die ZWave-Geräte. FHEM durchsucht beide Dateien nach der passenden XML-Config-Datei. Ist in beiden Dateien eine XML-Config für ein Gerät vorhanden, so werden die XML-Daten aus der "fhem_zwave_deviceconfig.xml.gz" bevorzugt.

Falls ein ZWave-Gerät von FHEM nicht erkannt wird, bitte auf folgenden Seiten nachschauen, ob es schon XML-Config-Dateien gibt, die nur nicht in FHEM eingebunden sind:
# https://github.com/OpenZWave/open-zwave/tree/master/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# https://github.com/jeedom/plugin-openzwave/tree/beta/resources/openzwaved/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# http://www.cd-jackson.com/index.php/zwave/zwave-device-database
Sofern auf den genannten Seiten Daten vorhanden sind, postet eine Aktualisierungsbitte mit genauem Link zur entsprechenden Seite im Forum ({{Link2Forum|Area=ZWave}}).

Gibt es auf keiner der Seiten Infos zu dem Gerät, dann entsprechend https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices die XML-Config-Datei für das Gerät erstellen und unkomprimiert zusammen mit der zu ergänzenden Info für die Datei "openzwave_manufacturer_specific.xml" im Forum ({{Link2Forum|Area=ZWave}}) zur Verfügung stellen.

=== Wie führt man eine Komplett-Sicherung der ZWave-Installation durch? ===
Zu einer Komplett-Sicherung der ZWave-Konfiguration gehören:

1. [[Backup]] der FHEM-Installation
::'''und'''
2. Backup des NVRAM des Controllers

Es genügt nicht nur die FHEM-Installation/Konfiguration zu sichern, da der Controller im NVRAM Daten über HomeID, NodeIDs usw. speichert, die in der FHEM-Installation nicht enthalten sind und auch nicht durch FHEM rekonstruierbar sind.

zu 2.) Backup des NVRAM des Controllers

Einige Controllerhersteller bieten eine eigenständige Software zum Backup/Restore an (siehe Hinweise zu den Controllern unter [[#Autocreate_des_Gateways]]).

FHEM kann mit den ZWDongle-Befehlen <code>backupCreate</code> das NVRAM der Controller sichern und mit <code>backupRestore</code> zurückschreiben. Da das Speicherlayout des NVRAM unter anderem von Controller-Hersteller, SDK und Firmwareversion abhängig sein kann, sollte man die Sicherung und Wiederherstellung des eigenen Controllers (auf eigenes Risiko) testen und sinnvollerweise einen gleichen Ersatzcontroller wie den Controller des Produktivsystem besitzen. Erfolgreiche Sicherung/Wiederherstellung wurde im Forum von den ZWavePlus-Controllern UZB1 (256k), Razberry (256k), Vision ZU 1401-5 EU (128k)und AEOTEC Z-Stick Gen5 (256k) berichtet.
(Weitergehende Infos - neben der {{Link2CmdRef}} - im Forum: {{Link2Forum|Topic=52364}}, {{Link2Forum|Topic=52914}}, {{Link2Forum|Topic=53023}})

=== Wie kann ich zur Fortentwicklung der ZWave-Module beitragen? ===
* Erfolgreichen Einsatz von neuen/bisher nicht gemeldeten ZWave-Geräten im Forum mitteilen
* Codeschnipsel und Ideen im Forum posten
* Fehler und Probleme im Forum melden
* [[How_to_write_a_patch|Patches]] für 00_ZWDongle.pm und 10_ZWave.pm erstellen
* Wiki: Ergänzungen und Korrekturen vornehmen; neue Geräte ins Wiki aufnehmen; Codeschnipsel und Beispiele einpflegen

=== Wie wird ein fehlendes Kernelmodul (Fritzbox) eingebunden? ===
Auf der Fritzbox (und evtl. auch anderen Systemen) muss sichergestellt werden, dass das Kernelmodul für das Gateway geladen wird. Ansonsten scheitert die Einbindung des Gateways in FHEM.

Für den Aeon Labs Z-Stick muss beispielsweise auf der Fritzbox das Kernelmodul <code>cp2101.ko</code> geladen werden.
Diese Datei ist bei einer [[FHEM und FritzBox 7390]] Installation über das Image von [http://www.fhem.de fhem.de] bereits enthalten.
Um den Aeon Labs Z-Stick zu verwenden, muss dieses Kernelmodul vor oder beim Starten des FHEM-Servers geladen sein. Dies erreicht man durch einen Eintrag in der Datei <code>startfhem</code>.

Die entsprechende Zeile kann direkt unterhalb der modprobe Anweisungen eingefügt werden.
insmod $home/lib/cp2101.ko

Nach einem FHEM-Neustart sollte das Gateway (der USB Stick) nun erkannt werden.

=== Wie ist der Aufbau der Z-Wave Messages bzw. wie finde ich bei einem Sendefehler die NodeId des Empfängers heraus? ===

Es könnte natürlich hin und wieder vorkommen, dass man im FHEM-Log folgende Fehler vorfindet:

<code><nowiki>ZWDongle_ProcessSendStack: no ACK, resending message 010a00130603320110259277</nowiki></code>

In diesem Fall gab es aus irgendeinem Grund einmalig das Problem, dass der Empfang einer Nachricht vom Empfänger nicht bestätigt wurde.
Will man dem auf die Spur kommen, so wäre es natürlich von Vorteil, die NodeId des Empfängers herauszufinden. Also muss man sich die Message näher anschauen:

<code><nowiki>010a00130603320110259277</nowiki></code>
* 01: data to controller
* 0a: length of msg
* 00: ?
* 13: ZW_SEND_DATA
* 06: NodeId

* 03: length of msg
* 32: Command Class 32 (METER, siehe %zwave_class in 10_ZWave.pm)
* 01: METER get scale command
* 10: scale parameter

* 25: send flags, explorer frames on
* 92: callbackId (um ACK zu identifizieren)
* 77: checkSum

In diesem Fall hat der Z-Wave-Controller 01 eine Nachricht an die NodeId 06 geschickt, welche vom Node nicht bestätigt wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components|!]]
[[Kategorie:868MHz]]

Z-Wave-Eurotronic Spirit Thermostat

2020-09-16T14:20:55Z

Krikan: /* Inklusion */ -> autocreate verlinkt + unspezifischen Hinweis auf Attribut ignoreTypes entfernt (nicht Inklusion scheitert, sondern autocreate wird bei entsprechendem ignoreTypes Device-Anlage verboten)

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=todo
|HWProtocol=Z-Wave Plus
|HWType=Aktor, Empfänger und Sender, Sensor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=
|HWVoltage=3V
|HWPowerConsumption=
|HWPoweredBy=2xBatterie AA Mignon
|HWSize=
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[https://eurotronic.org/ EUROTRONIC Technology GmbH]
}}

[[Z-Wave-Eurotronic Spirit Thermostat]] ist ein Heizungsthermostat mit Z-Wave 500er-Serie-Chip und Z-Wave Plus-Zertifizierung

== Features ==
* [[Z-Wave#FLIRS-Ger.C3.A4te|FLiRS-Gerät]]
* siehe Handbuch

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem [[Autocreate|autocreate]] vollautomatisch erkannt und definiert.

Eine beispielhafte durch autocreate erzeugte Definition mit Hinweisen zu manuellen Ergänzungen findet sich unter [[#Definition|Definition]].

=== Assoziation ===
Der Controller muss zur korrekten Funktion in die Assoziationsgruppe 1 des Thermostats aufgenommen werden. Dies geschieht während der Inklusion durch FHEM automatisch durch Absetzen des folgenden Befehls:
:<code>set <device> associationAdd 1 <Controller-NodeID></code>

Die erfolgreiche Ausführung des Befehls während der Inklusion durch Abfrage überprüfen:
:<code>get <device> associationAll</code>

=== Konfiguration ===
Konfigurationsanpassungen des Thermostates an eigene Wunschvorstellungen können anschließend vorgenommen werden.

Abschließend ist es sinnvoll die Konfiguration zu Sicherungs- und Kontrollzwecken komplett abzurufen:
:<code>get <device> configAll</code>

=== Befehle zur Steuerung ===
{{Hinweis|Das Thermostat antwortet bei Einstellungen per Funk mit einem set-Befehl nicht mit einem Telegramm über die vorgenommene Änderung. Um die entsprechenden Readings aktuell zu halten und die erfolgreiche Ausführung des set-Befehls zu kontrollieren kann der zugehörige get-Befehl, der im Folgenden jeweils aufgeführt wird, verwendet werden. Bei Änderungen über die Bedienung am Gerät wird FHEM hingegen per Telegramm über die vorgenommene Änderung informiert.}}

==== Betriebsmodi ====
Die nachfolgende Tabelle enthält die Aktivierungsbefehle für alle Betriebsmodi des Thermostats. Weitere Modi (tmCooling, tmAuto, tmFan) werden vom Gerät -obwohl von FHEM angeboten- nicht unterstützt.

{| class="wikitable"
|-
!Befehl!!Beschreibung
|-
|<code>set <device> tmOff</code>||Aus-Modus: Aus mit Regelung auf 6°C als Frostschutz
|-
|<code>set <device> tmHeating</code>||Komfortmodus: Regelung entsprechend [[#Komfortmodus|Solltemperatur Komfortmodus]]
|-
|<code>set <device> tmEnergySaveHeating</code>||Absenkmodus: Regelung entsprechend [[#Absenkmodus|Solltemperatur Absenkmodus]]
|-
|<code>set <device> tmFullPower</code>||Boostmodus: schnellstmögliche Raumaufheizung für maximal 5 Minuten
|-
|<code>set <device> tmManual</code>||Stellwertmodus (Manufacturer Specific): Ventilöffnung über Command Class SWITCH_MUTILEVEL einstellen
|}

Abfrage des eingestellten Betriebsmodus mit: <code>get <device> thermostatMode</code>

Steuerungsbefehle der Command Class SWITCH_MUTILEVEL ausschließlich für den Stellwertmodus (tmManual):

{| class="wikitable"
|-
!Befehl im Stellwertmodus!!Beschreibung
|-
|<code>set <device> dim %</code>|| Ventilöffnung von 0% bis 100%, wobei 99 = 100%
|-
|<code>set <device> on</code>||letzten Ventilöffnungsgrad einstellen; sinnvoll beispielsweise nach Aus-Modus (tmOff)
|-
|<code>set <device> off</code>||kleinstmögliche Ventilöffnung; entspricht 0%
|-
|}

Im Stellwertmodus erfolgt keine automatische Temperaturregelung durch das Spirit, sondern diese muss durch separate Logik (beispielsweise mit Hilfe von [[PID20 - Der PID-Regler|PID20]]) überwacht und geregelt werden.

Der Öffnungsstand wird mit <code>get <device> swmStatus</code> abgefragt. Zudem kann mit der Parameternummer 6 der Command Class CONFIGURATION der automatische Versand des Ventilöffnungsgrades bei bestimmten Veränderungen eingeschaltet werden (configValveOpeningPercentageReport).

==== Solltemperaturen ====
Die Solltemperaturen in den Modi Komfortmodus (tmHeating) und Absenkmodus (tmEnergySaveHeating) lassen sich im Temperaturbereich 8°C bis 28 °C anpassen. Die Solltemperatur für den Absenkmodus lässt sich ausschließlich per Funk anpassen. Im Aus-Modus (tmOff) und Boostmodus (tmFullPower) ist keine Anpassung möglich.

Die Einstellung der Solltemperaturen erfolgt mit dem set-Befehl <code>thermostatSetpointSet</code> oder dem funktionsgleichen set-Befehl <code>desired-temp</code>. Der letzte Befehl wurde zur Angleichung an andere Module eingeführt und im folgenden genutzt.

===== Komfortmodus =====
Die Solltemperatur auf NN.N °C wird mit folgendem Kurzbefehl eingestellt:

<code>set <device> desired-temp NN.N</code>

Dies entspricht dem ausführlichen Befehl:

<code>set <device> desired-temp NN.N C 1</code>

Die eingestellte Solltemperatur abrufen:

<code>get <device> setpoint 1</code>

oder mit dem Kurzbefehl

<code>get <device> setpoint</code>

===== Absenkmodus =====
Die Solltemperatur auf NN.N °C wird mit folgendem Befehl eingestellt:

<code>set <device> desired-temp NN.N C 11</code>

Die eingestellte Solltemperatur abrufen:

<code>get <device> setpoint 11</code>

==== Kindersicherung ====
{| class="wikitable"
|-
!Befehl!!Beschreibung
|-
|<code>set <device> protectionOff</code>||Ungeschützt - Bedienung am Gerät uneingeschränkt möglich
|-
|<code>set <device> protectionSeq</code>||Eingeschränkt - Bedienung am Gerät erst nach Entsperrung am Gerät (gleichzeitiges Drücken von {{Taste|+}} und {{Taste|-}} für 3 Sekunden)
|-
|<code>set <device> protectionOn</code>||Deaktiviert - Bedienung am Gerät deaktiviert und Steuerung ausschließlich per Funk
|}

Abfrage der eingestellten Kindersicherung mit: <code>get <device> protection</code>

=== Definition ===
Ein Beispiel für ein Spirit FHEM-Device enthält der nachfolgende exemplarische Auszug aus der [[Konfiguration]]:
define ZWave_THERMOSTAT_53 ZWave e345c452 53
attr ZWave_THERMOSTAT_53 IODev ZWDongle
attr ZWave_THERMOSTAT_53 classes ZWAVEPLUS_INFO ASSOCIATION ASSOCIATION_GRP_INFO VERSION MANUFACTURER_SPECIFIC DEVICE_RESET_LOCALLY PROTECTION SENSOR_MULTILEVEL SWITCH_MULTILEVEL THERMOSTAT_MODE THERMOSTAT_SETPOINT BATTERY
CONFIGURATION ALARM POWERLEVEL SECURITY SECURITY_S2 TRANSPORT_SERVICE SUPERVISION FIRMWARE_UPDATE_MD
attr ZWave_THERMOSTAT_53 extendedAlarmReadings 1
attr ZWave_THERMOSTAT_53 room ZWave
attr ZWave_THERMOSTAT_53 stateFormat temperature
attr ZWave_THERMOSTAT_53 vclasses ALARM:8 ASSOCIATION:2 ASSOCIATION_GRP_INFO:1 BATTERY:1 CONFIGURATION:1 DEVICE_RESET_LOCALLY:1 FIRMWARE_UPDATE_MD:3 MANUFACTURER_SPECIFIC:1 POWERLEVEL:1 PROTECTION:1 SECURITY:1 SECURITY_S2:1
SENSOR_MULTILEVEL:5 SUPERVISION:1 SWITCH_MULTILEVEL:1 THERMOSTAT_MODE:3 THERMOSTAT_SETPOINT:3 TRANSPORT_SERVICE:2 VERSION:2 ZWAVEPLUS_INFO:2
Im vorstehenden Beispiel wurde manuell das Attribut <code>extendedAlarmReadings</code> auf <code>1</code> gesetzt, damit für die diversen Alarmarten einfacher unterscheidbare Events erzeugt und separate Readings angelegt werden. Zudem wurde manuell das Attribut <code>stateFormat</code> angelegt. Sämliche anderen Angaben der Defintion nebst Attributen wurden von FHEM bei der Inklusion automatisch durch autocreate angelegt.

=== Logbeispiel ===
2018-10-19_18:04:14 ZWave_THERMOSTAT_53 setpointTemp: 18.0 C energySaveHeating
2018-10-19_18:04:34 ZWave_THERMOSTAT_53 setpointTemp: 22.0 C heating
2018-10-19_18:04:54 ZWave_THERMOSTAT_53 thermostatMode: heating
2018-10-19_18:05:03 ZWave_THERMOSTAT_53 thermostatSetpointSupported: heating energySaveHeating
2018-10-19_18:05:13 ZWave_THERMOSTAT_53 version: Lib 3 Prot 4.61 App 0.16 HW 49 FWCounter 1 FW 0.10
2018-10-19_18:05:24 ZWave_THERMOSTAT_53 zwavePlusInfo: version:01 role:SleepingListeningSlave node:Z-Wave+Node installerIcon:1200 userIcon:1200
2018-10-19_18:06:32 ZWave_THERMOSTAT_53 alarm_System: Event cleared: unknown event 0, notificationIsOn
2018-10-19_18:08:02 ZWave_THERMOSTAT_53 battery: 100 %
2018-10-19_18:08:02 ZWave_THERMOSTAT_53 batteryState: ok
2018-10-19_18:08:02 ZWave_THERMOSTAT_53 batteryPercent: 100
2018-10-19_18:10:10 ZWave_THERMOSTAT_53 temperature: 23.27 C
2018-10-19_18:18:10 ZWave_THERMOSTAT_53 temperature: 22.73 C
2018-10-19_18:30:10 ZWave_THERMOSTAT_53 temperature: 22.29 C
2018-10-19_19:00:17 ZWave_THERMOSTAT_53 thermostatMode: energySaveHeating
2018-10-19_19:00:55 ZWave_THERMOSTAT_53 thermostatMode: off
2018-10-19_19:06:10 ZWave_THERMOSTAT_53 temperature: 21.75 C
2018-10-19_23:22:18 ZWave_THERMOSTAT_53 thermostatMode: energySaveHeating
2018-10-19_23:27:31 ZWave_THERMOSTAT_53 set_tmHeating
2018-10-19_23:27:32 ZWave_THERMOSTAT_53 tmHeating

== Links ==
* [https://products.z-wavealliance.org/products/2543 Eintrag in http://products.z-wavealliance.org mit Handbuch und mehr]
* [https://eurotronic.org/wp-content/uploads/2018/08/Spirit_Z-Wave_BAL_web_DE_view_V5.pdf deutsches Handbuch auf Hersteller-Webseite]
* Nutzung eines direkt assozierten Fenstersensors zur Fenster-Offen-Erkennung: {{Link2Forum|Topic=92206}}
* {{Link2Forum|Topic=77598|Message=701397|LinkText=Temperaturwerte eines Nicht-ZWave-Gerätes an das Spirit zur Regelung übermitteln}}
* {{Link2Forum|Topic=77598|Message=854445|LinkText=Nutzung des Modul PID20 zur Temperaturregelung im Stellwertmodus (tmManual)}}

[[Kategorie:Z-Wave Components|Sensor]]
[[Kategorie:Heizungsventile]]

Fremdgeräte ignorieren

2020-09-14T15:41:13Z

Krikan: ignoreTypes - Attribut-Erläuterung -> Namen und nicht Type

'''Frage:''' Seit kurzem sehe ich in der FHEM-Weboberfläche Geräte bzw. Devices (Sensoren / Aktoren), die nicht mir gehören und die ich auch nicht ansprechen kann. Lösche ich die Devices aus meiner [[Konfiguration]], dann tauchen Sie nach kurzer Zeit wieder auf. '''Wie''' kann ich dafür sorgen, dass diese Geräte '''dauerhaft''' aus meiner FHEM-Konfiguration verschwinden?

'''Antwort:''' Es gibt 3 Möglichkeiten ...

# Sie setzen bei diesen Devices das Attribut <code>ignore</code> auf den Wert 1 (Befehls-Eingabefeld: <code><nowiki>attr <Device-Name> ignore 1</nowiki></code>). Wahlweise kann man alle anderen Attribute des Devices löschen; dies ist aber nicht zwingend. '''Hinweis:''' Das verhindert natürlich nicht, dass, wenn ihr Nachbar "aufrüstet", nicht andere Geräte neu in ihrem FHEM auftauchen.
# Sie schalten [[Autocreate|autocreate]] in ihrer Konfiguration ab und löschen die fremden Devices. Das wollen aber wohl die Meisten nicht, denn ''autocreate'' bietet viele Vorteile und sollte nur mit genauer Kenntnis der Auswirkungen abgeschaltet werden.
# Sie fügen der Definition von [[Autocreate|autocreate]] das Attribut <code><nowiki>ignoreTypes</nowiki></code> mit dem entsprechenden Regex für den Device-Namen hinzu. Dann werden alle neu erkannten Geräte deren Device-Name dem Regex entspricht nicht automatisch angelegt.

[[Kategorie:FAQ]]

Autocreate

2020-09-14T15:35:53Z

Krikan: /* Attribute */ -> ignoreTypes benötigt umschließende (..) bei mehreren per | verknüpften Ausdrücken, damit bei allen allen Ausdrücken (und nicht nur 1.) ab Beginn geprüft wird

{{SEITENTITEL:autocreate}}

{{Infobox Modul
|ModPurpose=Aktivierung des automatischen Anlegens von neuen Geräten
|ModType=h
|ModCmdRef=autocreate
|ModForumArea=Automatisierung
|ModTechName=98_autocreate.pm
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}

Bei aktiviertem [[autocreate]] werden neue Geräte von Fhem automatisch angelegt, sobald eine entsprechende Nachricht (Funktelegramm) empfangen wird. Geräte, die ''abgefragt'' werden (Polling), wie z.B. EMEM/EMWZ, werden nicht automatisch angelegt.

== Attribute ==
Die vollständige Liste der unterstützten Attribute ist in der Dokumentation (siehe Infobox) enthalten. Detailliertere Informationen für ausgewählte Attribute sind in den folgenden Abschnitten verfügbar.

;autosave
:Sofern dieses Attribut auf den Wert "1" gesetzt ist
::<code>attr ''autocreate'' autosave 1</code>
:(das ist auch der Standardwert, wenn das Attribut nicht gesetzt ist), wird nach dem automatischen Anlegen eines Gerätes die [[Konfiguration]] automatisch abgespeichert (also implizit ein ''save'' Befehl ausgeführt).
:Das neu (08/2015, siehe dazu auch diesen {{Link2Forum|Topic=39985|Message=325097|LinkText=Forenbeitrag}}) eingeführte ''global'' Attribut ''autosave'' erfüllt den gleichen Zweck. Derzeit kann das globale Attribut noch durch das ''autocreate'' Attribut überschrieben werden, das lokale Attribut sollte aber nicht mehr benutzt werden und könnte in einer späteren Version entfallen.

;ignoreTypes
{{Randnotiz|RNTyp=y|RNText=In {{Link2Forum|Topic=46872|LinkText=diesem Forenthread}} wird etwas genauer dargestellt, auf was sich die spezifizierten ''ignoreTypes'' beziehen. Eigentlich ist der Name dieses Attributs irreführend, da es um den Präfix des generierten Gerätenamens geht und nicht um den TYPE/Modulnamen.}}
:Spezifikation von Geräten, die von der automatischen Generierung ausgenommen werden sollen:
::<code>attr ''autocreate'' ignoreTypes ''(NamePrefix.*''[|''NamePrefix2.*''|...])</code>
:Reguläre Ausdrücke sind in der Spezifikation erlaubt, mit der Spezifikation von <code>(CUL_WS.*|FS20.*)</code> würden keine neuen Geräte mehr angelegt, deren generierter Name mit ''CUL_WS'' oder mit ''FS20'' beginnt. Viele Module generieren Gerätenamen, die mit dem Modulnamen (also z.B. ''FS20'') beginnen, im Einzelfall kann aber eine andere Vorgehensweise implementiert sein. Dann muss das Muster der erzeugten Namen identifiziert und der reguläre Ausdruck entsprechend angepasst werden.

MSwitch

2020-07-20T17:23:39Z

Krikan: Hinweis auf Entfernung des Moduls aus FHEM-SVN -> inoffizielles Modul

{{Hinweis|Das Modul wurde vom Modulautor aus dem FHEM-SVN entfernt. Download des Moduls unter https://github.com/Byte009/Fhem-MSwitch. Support erfolgt laut github-Seite derzeit über Whatsapp.}}

Achtung: Das Wiki entspricht nicht mehr der aktuellen Modulversion ( V3.1 )

Hilfe zu allen Befehlen , Einstellungen etc. ist direkt über das Frontend eines MSwitch-Devices verfügbar.

Eine Aktualisierung des Wikis erfolgt in den kommenden Tagen.

[[MSwitch]] ist ein Hilfsmodul, welches das Event- und/oder zeitgesteuerte Schalten von mehreren Devices oder das Ausführen von benutzerdefinierten Befehlssequenzen erlaubt. Hauptmerkmale sind die fast vollständige und die sehr umfangreiche Konfigurierbarkeit über das Webinterface.

{{Infobox Modul
|ModPurpose=MSwitch
|ModType=x
|ModForumArea=Automatisierung
|ModTechName=98_MSwitch.pm
|ModOwner=Byte09 (aus dem Forum abgemeldet)}}

{{Randnotiz | RNTyp=y | RNText=Byte09: ''Die Grundidee zu MSwitch kam mir, weil ich bei der Arbeit mit FHEM für meinen Geschmack zu viele Module für die verschiedenen Aufgaben brauchte - zu allem Überfluss alle mit unterschiedlicher Syntax. Zwar ist DOIF hiervon ausgenommen (da hiermit wohl auch fast jede Aufgabe lösbar ist), aber ich konnte mich leider nicht daran gewöhnen und somit wurde jedes DOIF für mich zu einem echten Projekt. Was ich wollte war ein Modul, mit dem ich alles erledigen kann. Daher entschloss ich mich schon nach fast einem knappen Jahr FHEM-Nutzung mein eigenes Modul zu schreiben, welches diese Anforderung erfüllt. MSwitch beinhaltet die Funktionalität aller bisherigen Hilfsmodule wie z.B. Notify, Doif, Watchdog, Dummy,( ab Modulversion 2.2 auch Sequenz ) es lassen sich all deren Funktionen umsetzen.''

''MSwitch wird permanent - vorrangig nach meinen Bedürfnissen - weiterentwickelt, gerne nehme ich aber auch Anregungen von anderen Nutzern auf.''

[[Datei:1-2-3-4.png|rahmenlos]]
}}

== Grundsätzliche Überlegungen ==
{{Randnotiz | RNTyp=y | RNText=Will man mehrere Geräte als gleichzeitige Auslöser betreiben, so muss das Device GLOBAL gewählt und die entsprechenden Geräte angegeben werden (dies erzeugt höhere Systemlast und ist nur im Expert-Modus verfügbar).}}

1. Welches Gerät soll auslösen oder zu welcher Zeit soll eine Auslösung erfolgen?
[[Datei:MSwitch basic.svg|mini|240px|Stark vereinfachtes Struktogramm]]
Im Rahmen 1 des Webinterfaces lässt sich der Trigger (Auslöser) bzw. eine Zeitabhängigkeit konfigurieren:

** jedes Event aus dem Eventmonitor,
** triggerunabhängige Zeiten,
** triggerunabhängige Zufallszeiten,
** triggerunabhängige Intervalle,
** Kombinationen aus Triggern und Zeiten.

2. Welche Bedingungen sollen bei Auslösung erfüllt sein?
: Ersten Rahmen: Wenn diese Bedingungen erfüllt sind, werden Kommandos ausgelöst. Die Bedingungen werden im zweiten Teil des Webinterfaces eingegeben. Dabei unterscheidet das Modul zwischen zwei Kommando-Kanälen (cmd1 und cmd2) und den dazugehörigen Geräten.

3. Welche Kommandos sollen ausgelöst werden?
: Im vierten Rahmen des Webinterfaces werden dann die konkreten Kommandos eingegeben. Man wählt dabei aus einer Liste wie auf der Geräteseite Kommandos aus. FreeCmd erlaubt geräteunabhängige Kommandos, beispielsweise reinen Perl-Code.

4. Welche weiteren Bedingungen sollen noch gelten?
: Zusätzlich pro Gerät eine oder mehrere Instanzen des vierten Rahmens:
** ereignisgesteuerte Bedingungen,
** zeitgesteuerte Bedingungen,
** Verzögerungen,
** Wiederholungen etc.

==Definition und Einrichtung =={{Randnotiz | RNTyp=y | RNText=Alle relevante Einstellungen werden in Readings und/oder Hashes gespeichert. Daher stehen relevanten Daten ''nicht'' in der fhem.cfg! Vielmehr finden sich diese Daten in der Datei fhem.save. Die Speicherung erfolgt durch den Befehl Fhemsave.
}}
Das MSwitch-Modul ist ohne weitere Voraussetzungen nutzbar und wird in der aktuellen Version über FHEM Update verteilt. MSwitch kann mehrere Devices gleichzeitig schalten. Diese Schaltungen befinden sich in den zwei möglichen Zweigen entsprechend der Kommandos cmd1 und cmd2. Die einzelnen Devices jedes Zweiges können mit weiteren Schaltbedingungen versehen werden (zeit- oder ereignisgesteuert). Das define eines MSwitch Devices generiert lediglich eine 'leere Hülle':
:<code>define <name> MSwitch</code>
Es wird ein leeres Device angelegt, das dann komplett über das Webinterface konfigurierbar ist.

== Webinterface ==
MSwitch wird über das Webinterface eingerichtet. Es besteht aus vier Teilen. Änderungen in einem Abschnitt müssen auch dort gespeichert werden, bevor ein weiterer Teil bearbeitet wird, sonst gehen Änderungen verloren.{{Randnotiz | RNTyp=y | RNText=<code>attr <name> MSwitch_Help 1</code> führt dazu, dass im Modul selber eine sehr umfangreiche kontextsensitive Hilfe in Form von Fragezeichensymbolen angezeigt wird.}}

[[Datei:1-2-3-4.png|rahmenlos|Webinterface]]
=== Rahmen 1: Trigger Device und Trigger Time ===
==== Trigger Device ====
{{Randnotiz | RNTyp=y | RNText=Wenn das Attribut 'MSwitch_Expert' gesetzt ist kann man 'GLOBAL' auswählen. Dann werden '''alle''' von FHEM generierten Events durch das MSwitch Device weiterverarbeitet, eine weitere Begrenzung kann (und sollte) dann in einem folgenden Eingabefeld erfolgen, um die Systemlast zu reduzieren.
==== Trigger Device Global Whitelist ====
Damit kann die Liste eingehender Events weiter eingeschränkt werden. Sobald mindestens ein Eintrag vorhanden sind, werden nur noch Events der hier benannten Devices verarbeitet. Zulässig ind Devicenamen und DeviceTypen (z.B. TYPE=FS20). Mehrere Angaben sind durch Komma zu trennen.

Im unten gezeigten Beispiel wurde GLOBAL gewählt, weil nicht ein einzelnes Device, sondern eine Kombination aus zwei Geräten auslösen soll. Es werden alle Ereignisse betrachtet, wobei die Whitelist dann auf die Devices Schlafzimmer (ein Temperaturmessgerät) und Schlafzimmerfenster (ein [[HM-Sec-SCo Tür-Fensterkontakt, optisch|optischer Kontakt]]) einschränkt.}}In diesem Feld wird das Device per Dropdownfeld gewählt, dessen Events eine Aktion auslösen sollen.

[[Datei:MSwitchWebinterface1.png|400px|thumb|right|Webinterface, oben]]

==== Trigger Time ====
Trigger time bietet die Möglichkeit einer zeitabhängigen Steuerung. Dazu wird in die "at"-Zeile ein Termin in der Form [STUNDEN:MINUTEN|TAGE] eingetragen. Die Tage werden ab Montag von 1-7 gezählt. Mehrere Zeitvorgaben können direkt hintereinander geschrieben werden. Beispiele:
* <code>[17:00|1][18:30|23]</code> löst montags um 17 Uhr und dienstags sowie mittwochs um 18:30 Uhr aus.
* <code>[00:10*20:00-21:00]</code> führt den Schaltbefehl von 20 Uhr bis 21 Uhr alle 10 Minuten aus.
* <code>[?20:00-21:00]</code> schaltet zu einem zufälligen Zeitpunkt zwischen 20 und 21 Uhr einmalig.
* <code>[20:00|$we]</code> nur am Wochenende um 20:00 wird geschaltet.

==== Trigger Conditions ====

Optionale zusätzliche Bedingungen in diesem Feld gelten nur für auslösende Device Trigger. Trigger Times haben keinen Einfluss, es sei denn, das Attribut MSwitch_Condition_Time ist gesetzt. Man kann mit AND / OR verknüpfte Bedingungen für die Auslösung in an DOIF angelehnter Syntax angeben. Leere Felder werden ignoriert. Werden Readings mit Strings wie 'on' oder 'off' abgefragt, ist statt des Gleichheitszeichens "=" der Operator "eq" zu nutzen, der String muss in Anführungszeichen "" gesetzt werden. Beispiele:{{Randnotiz | RNTyp=y | RNText=Überschreitet die Zeitangabe die Tagesgrenze (24:00 Uhr), so gelten die angegebenen Tage noch bis zum Ende der angegebenen Schaltzeit (beispielsweise würde dann am Mittwoch noch der Schaltvorgang erfolgen, obwohl als Tagesvorgabe Dienstag gesetzt wurde).}}
* <code>[19:10-23:00] AND [Devicename:Reading] = 10</code> beide Bedingungen müssen erfüllt sein.
* <code>[19:10-23:00] OR [Devicename:Reading] eq "on"</code> eine der Bedingungen muss erfüllt sein.
* <code>[10:00-11:00|13]</code> schaltet Montag und Mittwoch zwischen 10 Uhr und 11 Uhr.
* <code>[{ sunset() }-23:00]</code> von Sonnenuntergang bis 23:00 Uhr.
* <code>{ !$we }</code> löst den Schaltvorgang nur Werktagen an aus.
* <code>{ $we }</code> löst den Schaltvorgang nur an Wochenenden, Feiertagen aus.
Es ist auf korrekte Eingabe der Leerzeichen zu achten.

=== Rahmen 2: Trigger Details ===
[[Datei:MSwitchWebinterface2.png|600px|thumb|right|Webinterface, Mitte]]
Der Inhalt des zweiten Rahmens wird mit dem gewählten Trigger aus dem ersten Rahmen initialisiert. Events können zugeordnet werden. Im Beispiel wird cmd1 ausgelöst, wenn das Fenster offen ist. Cmd2 wird bei Temperaturunterschreitung ausgelöst.

==== execute ====
Diese vier Zeilen legen fest, welches ankommende Event welchen Befehlszweig auslösen soll. Die Event-Drop-Down-Liste enthält alle empfangenen Events dieses Devices. Fehlende Events können manuell hinzugefügt werden.

* switch <MSwitch> on + execute 'cmd1' - MSwitch Statusänderung auf 'on'; cmd1 soll ausgeführt werden
* switch <MSwitch> off + execute 'cmd2' - MSwitch Statusänderung auf 'off'; cmd2 soll ausgeführt werden;
* execute 'cmd1' only - keine Statusänderung; cmd1 soll ausgeführt werden
* execute 'cmd2' only - keine Statusänderung; cmd2 soll ausgeführt werden

==== Save incomming events ====
Alle ankommenden Events der konfigurierten Geräte werden für die Dropdownlisten gespeichert. Nach erfolgreicher Konfiguration sollte diese Option entfernt werden, um die Datenmenge zu reduzieren. Falls das Device Events während der Konfiguration nicht liefert, können sie manuell als kommagetrennte Liste hinzugefügt werden.

==== add event ====
{{Randnotiz | RNTyp=y | RNText=Falls auf 'GLOBALE' Events getriggert wird, muss das auslösende Device vorangestellt werden:
- * - alle auftretende Events des entsprechenden Device
- device:reading:wert (z.B. device:state:on ) - nur für das Event "device:state:on"
- device:reading:* (z.B. device:state:* ) - Events "device:state:(on,off,etc.)
- device:reading:(wert1/wert2/wert3) (z.b. device:state:(left/right) - Events "device:state:left" oder "devicestate:right" etc.

Das Device kann auch hier gegen "*" ersetzt werden (*:state:on). In diesem Fall erfolgt eine Aktion auf alle Events die z.B. "state:on" enthalten, egal welches Device triggert.
}}
* * - alle auftretende Events des entsprechenden Device
* reading:wert (z.B. state:on ) - nur auf das Event "state:on"
* reading:* (z.B. state:* ) - Events "state:(on,off,etc.)
* reading:(wert1/wert2/wert3) (z.b. state:(left/right) - Events "state:left" oder "state:right" etc.
==== test event ====
Stehen Events zur Auswahl, kann die Konfiguration getestet werden. Durch Klick wird das Event simuliert und die dafür definierte Aktion ausgelöst.

==== apply filter to saved events ====
Beschreibung folgt???

==== clear saved event ====
Es werden die nicht als Trigger wirkenden Events aus der Liste gelöscht.

=== Rahmen 3: Affected devices ===
{{Randnotiz | RNTyp=y | RNText=In dem Auswahlfeld werden alle Devices angeboten, die eines der folgenden Kriterien erfüllen:
# Die Abfrage "set Device ?" liefert einen Befehlssatz
# Das Attribut 'webcmd' des Devices enthält Einträge
# Das Attribut 'MSwitch_Activate_MSwitchcmds' ist aktiviert und das Attribut 'MSwitchcmds' des betreffenden Devices enthält einen Befehlssatz

Einzige Ausnahme ist der erste Listeneintrag 'FreeCMD'. Die Auswahl dieses Eintrages bietet später die Möglichkeit Befehle auszuführen, die nicht an ein Device gebunden sind. Der Code in einem FreeCmd kann entweder reiner FHEM-Code sein ( set device on ) oder reiner Perl-Code. Wenn es sich um reinen Perl-Code handelt, ist dieser in geschweifte Klammen zu setzen { Perl-Code }.

}}
[[Datei:MSwitch_Screen_5.png|mini|rechts|affected devices]]
Auswahl der Devices, die auf die oben konfigurierten Events reagieren sollen. Um unbeabsichtigte Änderungen zu vermeiden ist die direkte Mehrfachauswahl gesperrt.

=== Rahmen 4: Device Actions ===

[[Datei:Webinterface3.png|mini|rechts|device_actions]]
Die auszuführenden Aktionen der im dritten Rahmen gewählten Geräte. Leere Felder werden ignoriert.

==== MSwitch cmd1/cmd2: ====
{{Randnotiz | RNTyp=y | RNText=Im Beispiel befindet sich ein FreeCmd, mit dem beliebige Kommandos eingetragen werden können. Im abgebildeten Beispiel ist dies sogar selbst definierter Perl-Code (die Funktion DebianMail sendet eine Mail).
}}
Man wählt den gewünschten Befehl aus den gespeicherten verfügbaren Möglichkeiten des betreffenden Device aus.

* Im Sonderfall FreeCmd wird der Befehl als String eingegeben.
* Das Attribut MSwitch_Extensions ergänzt die Schaltoption 'MSwitchToggle' in der Liste, um die Toggle-Funktion bei Geräten die sie nicht von Haus aus anbieten nachzurüsten.

{{Randnotiz | RNTyp=y | RNText=Je nach Attribut-Einstellungen werden Einträge aus entsprechenden 'webcmds" oder 'MSwitchcmds' einbezogen. In Abhängigkeit des Befehls stehen unter Umständen weitere Felder oder Widgets zur Verfügung.
).
}}

==== cmd1/cmd2 condition ====

{{Randnotiz | RNTyp=y | RNText=Bei der Abfrage von Readings nach Strings (on, off, etc.) ist statt "=" "eq" zu nutzen und der String muss in "x" gesetzt werden. Es ist auf korrekte Eingabe der Leerzeichen zu achten.
'''Achtung:''' Bei Anwendung der geschweiften Klammern zur Einleitung eines Perl Ausdrucks ist unbedingt auf die Leerzeichen hinter und vor der Klammer zu achten.

Überschreitet die Zeitangabe die Tagesgrenze (24:00 Uhr), so gelten die angegebenen Tage noch bis zum Ende der angegebenen Schaltzeit (zum Beispiel würde auch am Mittwoch noch der Schaltvorgang erfolgen, wenn als Tagesvorgabe Dienstag gesetzt wurde).
}}
Die Ausführung der Befehle kann '''pro gewählten Gerät''' analog Rahmen 1 von weiteren Bedingungen abhängig gemacht werden. Es gelten die gleichen Regeln und Beispiele wie im 'Rahmen 1 Trigger Conditions'. Sie können sinngemäß übernommen werden.

Die Variable <code>$EVENT</code> enthält den auslösenden Trigger. Wenn unter 'Rahmen 1 Trigger Conditions' ein Wildcard verwendet wurde, kann nun feingefiltert werden, indem das konkrete Ereignis angegeben wird.

Beispiel: <code>[$EVENT] eq "state:on"</code> würde den Kommandozweig nur dann ausführen, wenn der auslösende Trigger "state:on" war.

==== cmd1/cmd2 delay ====
Ein Eintrag in diesem Feld führt zur verzögerten Ausführung des Befehls nach Eintreffen des Events. Dabei kann der Befehl ohne weitere Prüfung der Bedingung ausgelöst werden. Es ist aber auch möglich, dass die Bedingung bei Ausführung erneut geprüft wird. Die Zeitangabe muss im Format hh:mm:ss vorliegen. Einzelheiten enthält auch das Funktions-Struktogramm.

Statt einer direkten Zeitangabe kann hier auch auf eine verwiesen werden, indem in der Form [NAME.reading] ein Reading eines Devices wie z.B. [dummy.state] angegeben wird.

==== add action ====
Mit diesem Button kann ein weiterer Rahmen 4 als Rahmen 4.1 für das gleiche Device angelegt werden, um z.B. einen weiteren Befehl gegebenenfalls zeitverzögert auszuführen.

==== delete this action ====
Mit diesem Button wird der gewählte Rahmen 4 für das Device gelöscht.

==== check condition ====
[[Datei:MSwitch_Screen_7.png|mini|rechts|check]]
Die angegebenen 'conditions' werden in Zusammenhang mit ggf. ausgewählten Devices auf Syntax und Ergebnis geprüft. Es erfolgt eine Ausgabe des Prüfungsergebnisses.

==== Repeat und Repeatdelay ====

Die Felder 'Repeats', 'Repeatdelay in s' und 'priority' stehen zur Verfügung, wenn das Attribut MSwitch_Expert gesetzt wurde. Diese bewirken eine n-fache Wiederholung des gesetzten Befehls mit m Sekunden Verzögerung. Das Auswahlfeld 'priority' erscheint bei jedem 'affectes device'. So kann die Reihenfolge der Befehlsabarbeitung beeinflusst werden.

== Erweiterte Konfiguration ==

=== Set-Befehle ===

{| class="wikitable sortable"
|-
! Name !! class="unsortable" | Beschreibung
|-
|set active||Setzt das MSwitch-Device in den Status 'active'.
|-
|set inactive||Setzt das Device in den Status 'inactive'. Es werden keine Befehle mehr ausgeführt. Dieser Status entspricht dem Attribut 'disable', ist aber nicht mit dem roten Fragezeichen (fhem save) verbunden.
|-
|set on<nowiki>|</nowiki>off [<parameter>]||Setzt das Device in den Status 'on' oder 'off'. Alle Befehle der 'on/off-Zweige' werden ausgeführt. Optional kann den Befehlen 'on' und 'off' ein weiterer Parameter mit übergeben werden. Dieser wird im Reading 'Parameter' hinterlegt und es kann sofort in 'Freecmds' oder 'Conditions' darauf zugegriffen werden.
|-
|set reload_timer||Alle gesetzten Timer werden gelöscht und neu berechnet.
|-
|set change_renamed <oldname> <newname>||Sollten sich Devicenammen im ausführenden Teil geändert habe (affected Devices, Conditions, etc.) so kann das MSwitch mit diesem Befehl angepasst werden, ohne alle Einstellungen neu einstellen zu müssen.
|-
|set exec_cmd1 <nowiki>|</nowiki> set exec_cmd1 ID [<ID>]||Bewirkt das sofortige Ausführen des entsprechenden Befehlszweiges. Bei Angabe einer ID werden nur die Befehle mit der entsprechenden ID ausgeführt.
|-
|set MSwitch_backup||Erstellt eine Backup-Datei aller MSwitch Devices unter ./fhem/MSwitch_backup.cfg. Daten dieser Datei können im Bedarfsfall für einzelne oder gleichzeitig alle MSwitch Devices wieder zurückgespielt (hergestellt) werden.
|-
|set del_delays <nowiki>|</nowiki> set exec_cmd1 ID [<ID>]||Löscht alle anstehenden, verzögerten Befehle (delays).
|-
|set reset_cmd_count: 1<nowiki>|</nowiki>2||Löscht das entsprechende EVT_CMD_COUNT - Reading; entspricht damit einer Rückstellung auf '0'.
|-
|set fakeevent [<device>]:<reading>:<arg>||Beispiel: <device> fakeevent state:on<br>
Das MSwitch Device reagiert so, als wäre statt des internen "fakes-Befehls" ohne FHEM-Systembeeinflussung dieses Event tatsächlich vom triggernden Gerät generiert worden.

Der Name (<device>) muss bei GLOBALEN Triggern mit angegeben werden, sonst wird das Device automatisch gesetzt.
Um z.B. einen Watchdog zu realisieren ist es eventuell nötig, dass sich das MSwitch Device mit einem bestimmten Event selber neu triggert - ggf. mit einem entsprechenden Delay Affected Device. Bei dem Einsatz dieser Möglichkeit sollte das Attribut 'MSwitch_Safemode' UNBEDINGT aktiviert sein, da 'Experimente' hier schnell in einer Endlosschleife enden können, die nur durch ein Reboot unterbrochen werden kann. Möglicherweise steht dieser Befehl zukünftig nur noch zur Verfügung, wenn Safemode aktiviert ist.
|}

=== Get-Befehle ===

{| class="wikitable sortable"
|-
! Name !! class="unsortable" | Beschreibung
|-
|get show_timer [<show><delete>]||
;Show
:Zeigt alle anstehenden (gesetzten) Timer des Devices, die aus zeitabhängigen oder verzögerten Schaltbefehlen resultieren.
;Delete
:Löscht alle anstehenden (gesetzten) Timer des Devices, die aus zeitabhängigen oder verzögerten Schaltbefehlen resultieren. Schaltbefehle basierend auf rein zeitabhängigen Angaben werden neu berechnet und gesetzt.
|-
|get restore_MSwitch_data [<this_device><nowiki>|</nowiki><all_devices>]||
;this_device
:Stellt die Daten des Devices aus der Backupdatei wieder her, sofern diese in der Backupdatei gefunden werden (gesucht wird hier nach dem Namen des Devices).
;all_devices
:Stellt die Daten aller MSwitch Devices wieder her, sofern diese in der Backupdatei vorhanden sind. Diese Aktion kann einige Zeit in Anspruch nehmen und wird daher im Hintergrund (nonblocking) ausgeführt. Nach Beendigung erfolgt eine Benachrichtigung.
Die Devices sind nach einem Restore funktionsfähig. Empfohlen wird ein Neustart von FHEM..
|-
|get_config||Zeigt die Konfigurationsdatei des MSwitchdevices an; diese kann in dem Fenster editiert werden. Das sollte nur von erfahrenen Usern getan werden! Im Normalfall sollte das Device nur über die Weboberfläche konfiguriert werden und eine falsche Konfiguration kann hier zu einem FHEM Absturz führen.
|-
|get_support_info||Öffnet ein Fenster mit einer formatierten Ansicht aller Einstellungen des Devices. Bei Supportanfragen sollte dieses immer mit geposted werden.
|-
|get_MSwitch_preconf||Lädt vorkonfigurierte MSwitch-Devices. Diese Option ist nur dann vorhanden, wenn das Aktualisieren dieser vorkonfigurierten Devices im FHEM Update aktiviert ist.
Diese kann durch ein einmaliges Update erfolgen mit:
:<code>update all https://raw.githubusercontent.com/Byte009/MSwitch_Addons/master/controls_mswitchaddons.txt</code>
|}

=== Attribute ===
{| class="wikitable sortable"
|-
! Name !! class="unsortable" | Beschreibung
|-
|MSwitch_Debug <0<nowiki>|</nowiki>1<nowiki>|</nowiki>2<nowiki>|</nowiki>3<nowiki>|</nowiki>4>||
0 - Abgeschaltet<br>
1 - Schaltet Felder zum testen der Conditionstrings an<br>
2 - Alle ausgehenden Befehle werden nur simuliert und nicht ausgeführt. Der Inhalt der Protokolldatei wird direkt im Device angezeigt<br>
3 - Es erfolgt eine Protokollierung in einer separaten Datei. Diese wird direkt im Device angezeigt.<br>
4 - erweitertes Debugfür Entwickler mit wechselnden Funktionen<br>
|-
|MSwitch_Expert <0<nowiki>|</nowiki>1>||
* In der Liste der möglichen Trigger erscheint das Selectfeld 'GLOBAL'. Dieses ermöglicht das Setzen eines Triggers auf alle Events und damit nicht nur auf einzelne Devices. In einem weiteren Feld kann eine weitere Selektion der triggernden Events erfolgen.

* Die Felder 'Repeats' und 'Repeatdelay in s' stehen zur Verfügung. Dies bewirkt eine n-fache Wiederholung des gesetzten Befehls mit m Sekunden Verzögerung.

* Das Auswahlfeld 'priority' erscheint bei jedem 'affectes device'. So kann die Reihenfolge der Befehlsabarbeitung beeinflusst werden.
|-
|MSwitch_Sequenz <Suchmuster> ??? ||
Eine Schaltsequenz kann durch ein oder mehrere durch '/' getrennte Suchmuster angegeben werden. Die Angabe muss folgende Syntax haben:
:<code>Device1:reading1:event1 Device1:reading1:event1-2 Device1:reading1:event1-3/..../....</code>

Beispiel: <code>Dummy:state:on Dummy:state:off Dummy:state:on</code>

Erkennt das Device dieses Suchmuster in den Schaltvorgängen des Devices (Dummy), wird das Reading "SEQUENCE" auf "match" gesetzt, das Reading "SEQUENCE_NUMBER" auf die Nummer der gefundenen Sequenz, wenn es mehrere Suchmuster gibt. Beide Readings können in den "Conditions" eines Schaltbefehles abgefragt werden. Eine Angabe muss in folgendem Format gemacht werden:
:<code>on/off/state/suchmuster1/suchmuster2</code>, wobei die letzten drei Angaben optional sind.

Funktion: Bei Ausführung des Befehls wird das Gerät 'on' oder 'off' geschaltet (on/off), Voraussetzung ist, dass der 'state' dieses Gerätes auch den 'state on' oder 'off' annimmt. Sollte dieses nicht der Fall sein, so kann mit dem Feld 'state' angegeben werden, in welchem Reading der aktuelle Status vorkommt und wie dieser lautet (suchmuster1/suchmuster2). Dieses 'state' kann mehrere Angaben enthalten, das Vorkommen der Suchmuster ist aber Voraussetzung.
|-
|MSwitch_Sequence_time <Zeit in Sekunden>||Maximalzeit in Sekunden, um eine Sequenz vollständig auszuführen. (Was wenn diese Zeit überschritten wird???)
|-
|MSwitch_Extensions <0<nowiki>|</nowiki>1>||Es wird zusätzlich zu 'on' und 'off' die Schaltoption 'MSwitchToggle' in der Liste angeboten, um die Toggle-Funktion bei Geräten die sie nicht von Haus aus anbieten nachzurüsten.
|-
|MSwitch_Delete_Delays <0<nowiki>|</nowiki>1>||Eins bewirkt das Löschen aller anstehende Delays bei dem Auftreten eines erneuten passenden Events. Bei der Option '0' bleiben bereits gesetzte Delays aus einem vorher getriggerten Event erhalten und werden ausgeführt. Empfohlene Einstellung: 1
|-
|MSwitch_Include_Devicecmds <0<nowiki>|</nowiki>1>||Bewirkt die Aufnahme aller Devices die bei Abfrage mit 'set DEVICE ?' einen eigenen Befehlssatz liefern in die Auswahlliste 'Affected Devices'. Bei Option '0' werden diese Devices in der Liste nicht mehr angeboten. Empfohlene Einstellung: 1
|-
|MSwitch_Include_Webcmds <0<nowiki>|</nowiki>1>||Bewirkt die Aufnahme aller Devices in die Auswahlliste 'Affected Devices', die einen eigenen Befehlssatz in dem Attribut Webcmd hinterlegt haben. Die in Webcmd hinterlegten 'Befehle' werden in den Auswahlfeldern angeboten. Bei gesetzter Option '0' werden diese Devices nicht mehr angeboten, es sei denn, sie liefern mit 'set DEVICE ?' einen eigenen Befehlssatz. Empfohlene Einstellung: 0, Einsatz nach Bedarf.
|-
|MSwitch_Activate_MSwitchcmds <0<nowiki>|</nowiki>1>||Fügt jedem vorhandenen Device das Attribut 'MSwitchcmd' hinzu.
|-
|MSwitch_Include_MSwitchcmds <0<nowiki>|</nowiki>1> ||Bewirkt die Aufnahme aller Devices in die Auswahlliste 'Affected Devices', die einen eigenen Befehlssatz in dem Attribut MSwitchcmds hinterlegt haben. Die in MSwitchcmds hinterlegten 'Befehle' werden in den Auswahlfeldern angeboten. Bei gesetzter Option '0' werden diese Devices nicht mehr angeboten, wenn sie nicht zusätzlich einen eigenen Befehlssatz mit 'set DEVICE ?' liefern. Empfohlene Einstellung: 0, Einsatz nach Bedarf.
|-
|MSwitch_Lock_Quickedit <0<nowiki>|</nowiki>1>||Voreinstellung für die Auswahlliste 'Affected Devices'. Bei der Option '1' ist diese voreingestellt gesperrt und kann nur über einen zusätzlichen Button geändert werden, um versehentliche Änderungen zu vermeiden. Die Auswahl einer Option ohne betätigte <Strg>-Taste bewirkt das Löschen aller bereits gesetzten Optionen. Empfohlene Einstellung: 1
|-
|MSwitch_Startdelay <0<nowiki>|</nowiki>10<nowiki>|</nowiki>20<nowiki>|</nowiki>30<nowiki>|</nowiki>60> ||MSwitch ignoriert nach einem FHEM-Neustart für die angegebene Zeit in Sekunden alle eingehenden Events um u.a. Startverzögerungen zu vermeiden. Bei nicht gesetztem Attribut gilt hier eine Zeit von 30 Sekunden. Diese sollte auch nur in Ausnahmefällen geändert werden. Empfohlene Einstellung: 30
|-
|MSwitch_Ignore_Types||Beinhaltet eine durch Leerzeichen getrennte Liste von Device-''Typen'' welche nicht geschaltet werden oder nicht geschaltet werden können. Sie werden dann in den Auswahllisten ''nicht'' dargestellt, um die Auswahllisten übersichtlich zu halten.Voreinstellung: notify allowed at watchdog doif fhem2fhem telnet FileLog readingsGroup FHEMWEB autocreate eventtypes readingsproxy svg cul.

???Wenn statt des Devicetyps ein devspec z.B. "TYPE=watchdog" angegeben wird, ist zu beachten, dass alle Geräte in die Ignoreliste einbezogen werden, die NICHT der devspec entsprechen. Weiterhin muss die devspec in Anführungszeichen gesetzt werden!???

|-
|MSwitch_Trigger_Filter ||Beinhaltet eine kommagetrennte Liste von Events, die im Falle ihres Eingangs unberücksichtigt und ungespeichert bleiben. Wildcards wie '*' können angegeben werden. Empfohlene Einstellung: -
|-
|MSwitch_Wait <n in Sekunden>||Bei gesetztem Attribut nimmt das MSwitch Device für den eingestellten Zeitraum keine Befehle mehr entgegen und ignoriert eingehende Events.

|-
|MSwitch_Event_Id_Distributor|| ??? Voraussetzung ist, dass das Attribut 'MSwitchExpert' auf '1' gesetzt ist. Es können auslösende Events ID-Aktionen umgeleitet werden. Sollte bei den 'trigger details :' in einem Zweig ( cmd1 ) z.B. mehrere getriggert werden (regex state:(on |off)) so werden für beide Events jeweils der Zweig 'cmd1' - alle Aktionen ohne ID - ausgeführt. Durch entsprechende Einträge kann für entsprechende Events auf eine Aktion umgeleitet werden, für die eine ID definiert ist. Die Syntax lautet: <code>state:on=>cmd1 ID 1,2</code> Entsprechend werden bei auslösendem Event 'state:on' nur die Aktionen aus cmd1 mit den IDs 1 und 2 ausgeführt. Mehrere Angaben sind durch new Line zu trennen. ???

|-
|MSwitch_Selftrigger_always <0<nowiki>|</nowiki>1> ||(dieses Attribut steht ab Modulversion 2.5 zur Verfügung)

Die Aktivierung dieses Attributes '1' bewirkt, dass alle SET Aktionen des Devices einen internen Event ohne Auswirkungen auf das FHEM-System auslösen, auf die das Device selber reagiert. Diese Option kann zusätzlich zu einem vorhandenen Trigger aktiviert werden. Auftretende auswertbare interne Events haben immer folgendes Format:
MSwitch_Self:aktion:wert
MSwitch_Self:pct:100
Es werden nur interne Events für set-Aktionen ausgelöst, die im Attribut setlist hinterlegt sind. Der 'wait' Befehl/Attribut hat keine wirkung.
|-
|MSwitch_Mode <Notify<nowiki>|</nowiki>Full<nowiki>|</nowiki>Toggle<nowiki>|</nowiki>Dummy> ||Schaltet das Modul zwischen angepassten Weboberflächen-Modi um.

Notify
Das Device kann nicht manuell umgeschaltet werden. Es gibt nur die zwei ausführbaren Zweige "execute 'cmd1' commands" und "execute 'cmd2' commands". Der Status des Devices wird nicht als 'on' oder 'off' angezeigt, sondern lediglich als 'active' Dieser Mode ist ähnlich zu einem FHEM-Notify.

Full
Es stehen alle Funktionen zur Verfügung.
Toggle
Sehr vereinfachter Mode. Es stehen keine verschiedenen Zweige zur Verfügung. Hier ist das Device manuell schaltbar und wird bei jedem definierten Event 'umgeschaltet', ??? entsprechend definierte Befehle für 'cmd1' oder 'cmd2' werden ausgeführt. ???
Dummy
ACHTUNG: Funktionsänderung mit V2.61 Der Mode 'Dummy' ist ein eingeschränkter Modus. Dieser bietet die Funktionalität eines Dummys kombiniert mit der Funktionalität eines Notifys und kann somit die gerne genutzte Kombination Dummy-Notify gegen ein Device ersetzen. Der Dummy-Mode kann nur in einem neu angelegten leeren MSwitch aktiviert und auch nicht wieder verlassen werden! Sobald ein angelegtes MSwitch einmal verändert wurde (modify trigger etc.) sind Umschalt-Optionen nicht mehr verfügbar.

|-
|MSwitch_Condition_Time <0<nowiki>|</nowiki>1> ||In der Grundeinstellung '0' werden für das zeitgesteuerte Schalten keine definierten Conditionen im Feld 'Trigger condition' überprüft, sondern die Schaltbefehle werden in jedem Fall ausgeführt. Mit der Einstellung '1' wird diese Überprüfung wie für Events zugeschaltet.

|-
|MSwitch_Random_Time <HH:MM:SS-HH:MM:SS> || Bei Aktivierung wird vor jedem Ausführen eines verzögerten Befehls (Delay) eine Zufallszeit generiert, die im Rahmen der hier angegebenen Zeitspanne liegt. Auf diese Zufallszahl kann in den Delays zugegriffen werden, durch die Angabe '[random]' statt einer direkten Zeitangabe. Bei nicht gesetztem Attribut ergibt die Angabe von '[random]' immer '00:00:00'

|-
|MMSwitch_Random_Number <n> ||Bei Aktivierung dieses Attributes mit einer beliebigen ganzen Zahl, werden vom Device die zwei Readings 'RandomNr' und 'RandomNr1' und mit Werten zwischen null und n angelegt. RandomNr wird vor jedem Ausführen eines Befehls, auch für unterschiedliche Geräte in einem Durchgang, neu generiert. RandomNr1 bleibt nach der Initialisierung konstant. Wenn auf dieses Readings in einer Condition mit z.B. '[$NAME:ReadingNr1] = 1' zugegriffen wird, wird der Befehl nur ausgeführt, wenn ReadingNr1 gerade = 1 ist. Der Befehl wird somit nur mit einer Wahrscheinlichkeit von eins zu n ausgeführt.

|-
|MSwitch_Reset_EVT_CMD1(2)_COUNT ||Bei Aktivierung dieses Attributes steht in den Readings das Reading 'EVT_CMD1_COUNT' bzw. 'EVT_CMD2_COUNT' zur Verfügung. Dieses kann in den Conditions genutzt werden, um z.B. nur bei jedem x-ten Eintreffen eines auslösenden Events einen Befehl auszuführen. Bei jedem Eintreffen eines gültigen Events werden die Zähler um 1 erhöht (für den jeweiligen Zweig). Ist hier der Wert '0' eingetragen, wird der Zähler fortlaufend (endlos) erhöht. Wird ein Wert größer 0 eingetragen, wird der Zähler mit Erreichen dieses Wertes automatisch wieder auf Null gesetzt. Mit Löschen dieses Attributes werden die entsprechenden Readings ebenfalls gelöscht.

|-
|MSwitch_Safemode <0<nowiki>|</nowiki>1> ||Bietet einen gewissen Schutz vor falschen Konfigurationen und dadurch entstehenden Endlosschleifen. Bei aktiviertem Attribut '1' beendet das Modul Endlosschleifen eines Devices. In diesem Fall erfolgt ein Logeintrag und das Device wird per Attribut auf 'Disabled' gesetzt. Es wird ein letztes Event generiert, auf das reagiert werden kann <code>2018-05-31 09:39:21 MSwitch <NAME> Safemode: on</code> Im Webinterface erfolgt bei betroffenem Device ein entsprechender Hinweis. In der Grundkonfiguration ist dieses Attribut nicht gesetzt. Es empfiehlt sich aber, bei neuen bzw. komplizierten Devices, dieses zumindest anfänglich zu aktivieren.
|-
|MSwitch_Read_Log<0<nowiki>|</nowiki>1> ||Ermöglicht den Zugriff auf das Logfile als Trigger.

* Bei aktiviertem Attribut enthält die Auswahl des Triggerdevices die Option 'LOGFILE'. Bei dieser Auswahl werde alle Logeinträge erkannt und in ein internes Event umgewandelt, auf das regiert werden kann.
* bei aktiviertem Attribut und der Auswahl 'GLOBAL' im 'Trigger_Device' wird auf ALLE Events und alle Logeinträge reagiert.
* bei aktiviertem Attribut und der Auswahl eines bestimmten Devices im 'Trigger_Device' wird auf alle Events und auf alle Logeinträge des gewählten Devices reagiert. Der im Logeintrag vorhandene Devicename ist Bedingung für die Funktion.
|-
|MSwitch_Help<0<nowiki>|</nowiki>1> ||Schaltet Hilfebuttons zu den einzelnen Eingabefeldern an oder aus.

|-
|MSwitch_Comments<0<nowiki>|</nowiki>1> ||Schaltet Kommentarfelder zu den einzelnen 'affected_devices an.

|-
|MSwitch_generate_Events<0<nowiki>|</nowiki>1> ||Reduziert bei Einstellung '1' die vom MSwitch-Devices erzeugten Events auf ein Minimum. Insbesondere bei Verwendung von 'MSwitch_Read_Log' zu empfehlen.

|-
|MSwitch_Startdelay||???Bestimmt die Verzögerungszeit des MSwitches nach FHEM-Start in Sekunden. In diesem Zeitraum reagiert das Device nicht auf Events. Die Vorgabe ist hier zehn Sekunden. Diese wird auch dann angenommen, wenn das Attribut nicht gesetzt ist.??? (Hatten wir das nicht schon?)

|-
|MSwitch_Inforoom ||Mit diesem Attribut wird die Raumansicht eines mit dem Attribut bestimmten Raumes verändert. Dadurch sollen die wichtigsten Informationen aller MSwitch-Devices auf eine Seite dargestellt werden. Zur Nutzung sollten alle MSwitch-Devices (zusätzlich) in einen Raum sortiert werden und dieser Raum im Attribut eingestellt werden.

Wichtig: Eine Änderung dieses Attributes bewirkt immer eine Änderung dieses Attributes in ''allen'' MSwitch devices: Es muss nur in einem Device gesetzt oder gelöscht werden um alle Devices zu erfassen.

<gallery>
MSwitch_Screen_1.png|Raumansicht des Raumes MSwitch mit gesetztem Attribut 'MSwitch'
MSwitch_Screen_2.png|Raumansicht des Raumes MSwitch ohne gesetztes Attribut
</gallery>

Es werden folgende Informationen bereitgestellt:
* Infobutton zeigt den im Device gespeicherten Textes des Attributes 'comment'
* Device und Events, die das Device triggern
* Zeiten, zu denen verschiedene Zweige des Devices ausgeführt werden
* Devices, die durch das MSwitch Device geschaltet werden
* State des Devices

|}

== Integrierte Funktionen ==

{| class="wikitable sortable"
|-
! Name !! class="unsortable" | Beschreibung
|-
|Average||???
|-

|Difference||
* Syntax: [DIFF<wert>:<reading>] > <differenz>
* Beispiel: [DIFF2:countdown] > 0
* Reading: entspricht dem getriggerten Reading.
* Wert: gespeicherter Wert (in diesem Fall der vorletzte).
* Differenz: geforderte Differenz zwischen aktuellem und vorletztem Wert.
* Schaltung erfolg wenn diese Bedingung 'wahr' ist.
Folgende Readings werden zur Verfügung gestellt:
* DIFFERENCE (true/false) - Schaltbedingung erkannt ja/nein
* DIFFDIRECTION (up/down) - Richtung der erkannten Bedingung (steigend/fallend)
|-
|Increase||???
|-
|Tendency||
*Syntax: [TEND<wert>:<reading>] > <Mindestwert>
*Beispiel: [TEND2:countdown] > 2
*Reading: entspricht dem getriggerten Reading.
*Wert: Es wird jeweils der Durchschnitt von 2 Wertepaaren gebildet. In diesem Fall werden die letzten 4 Werte herangezogen. Paar 1 = Aktueller und letzter Wert, Paar 2 = Die 2 vorherigen Werte. Bei TEND3 werden die letzten 6 Werte zur Paarbildung genutzt.
*Mindestwert: Der Wertunterschied zwischen den Wertepaaren, der minimal erreicht sein muss, um eine Tendenz zu erkennen.

Rechenzeichen (><):
Dieses ist hier nicht als Rechenzeichen zu werten, sonder als Tendenz-Anzeige. ( < es wird nach fallender Tendenz gesucht / > sucht nach steigender Tendenz).

Schaltung erfolgt einmalig bei Erkennung der gesuchten Tendenz.
Danach erfolgt keine Schaltung mehr, solange bis eine Tendenz-Umkehr erfolgt ist.
Erst dann erfolgt wieder eine Schaltung bei erneuter Tendenz-Umkehr in gesuchte Richtung.
|}

== Funktions-Struktogramm ==
[[Datei:MSwitch full.svg|Struktogramm des Funktionsprinzips]]

== Anwendungs-Beispiele ==

=== [[Blinken - Rechteckgenerator]] ===
=== [[Blinken - Impulsgenerator mit variablem Tastgrad]] ===
=== [[Schmitt-Trigger - Temperaturabhängiges Schalten]] ===
=== [[Linearschalter]] ===

== Links ==
* Thread über das Modul im {{Link2Forum|Topic=86199|LinkText=FHEM Forum}}
* {{Link2Forum|Topic=100119|Message=936495|LinkText=Gäste-WLAN der Fritzbox auswerten und Login per Telegram senden}}
* {{Link2Forum|Topic=86199|Message=930133|LinkText=Schalten von vier Kanälen mit einem MSwitch-Device}}
* {{Link2Forum|Topic=99219|Message=926652|LinkText=Batterie-Überwachung. 1xTäglich per Telegram senden}}
* {{Link2Forum|Topic=101091|Message=945389|LinkText=Licht (Alarm) in einem bestimmten Zeitraum schalten}}
* {{Link2Forum|Topic=100949|Message=944284|LinkText=Über Dummy-Schalter ein Timer (EIN/AUS) aktivieren}}
* {{Link2Forum|Topic=103083|Message=967710|LinkText=Ladezeit von Akku ermitteln u. Steckdose entsprechend schalten}}
* {{Link2Forum|Topic=86199|Message=990265|LinkText=Bewegungsmelder}}
* {{Link2Forum|Topic=86199|Message=974592|LinkText=Rauch und Hitzemelder steuern}}

Z-Wave

2020-07-20T17:00:15Z

Krikan: Änderung 33372 von Krikan (Diskussion) rückgängig gemacht. / Befehl funktioniert nach 00_ZWDongle.pm-Update bis Routenupdatedauer von 80 Sekunden

<div style="float:right">{{Infobox Modul
|Name=ZWDongle
|ModPurpose=Einbindung Z-Wave-Gateways
|ModType=d
|ModCmdRef=ZWDongle
|ModForumArea=ZWave
|ModTechName=00_ZWDongle.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
{{Infobox Modul
|Name=ZWave
|ModPurpose=Ansteuerung Z-Wave-Geräte über ZWDongle
|ModType=d
|ModCmdRef=ZWave
|ModForumArea=ZWave
|ModTechName=10_ZWave.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
</div>

[[Z-Wave]] ist ein drahtloser Kommunikations-Standard im 868 Mhz-Band (Europa), der von der Firma Sigma Designs und der Z-Wave Alliance, einen Zusammenschluss von mehreren Hundert Herstellern, für die Heimautomatisierung entwickelt wurde. Es existieren mehr als [http://products.z-wavealliance.org 1400 zertifizierte Produkte] verschiedenster Hersteller, die innerhalb eines gemeinsamen Z-Wave-Netzes einsetzbar sind. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia])

Auf dieser Seite werden Grundlagen eines '''Z-Wave''' Systems und dessen Einrichtung in FHEM beschrieben.
== Z-Wave ==
=== Nodes - Controller und Slaves ===
Ein Z-Wave-Netz besteht aus mindestens 2 Geräten, den sogenannten '''Nodes''' (Knoten). Es setzt sich zusammen aus dem steuernden '''Controller''' (Zentrale) und min. 1 bis max. 231 gesteuerten '''Slaves''' (Geräten).

=== Home-Id und Node-ID ===
Innerhalb eines Z-Wave-Netzes gibt es zu 2 Identifikationsnummern zur Kennzeichnung der Netzstruktur:
# '''Home-ID:''' Gemeinsame Identifikationsnummer aller Nodes in einem Netz zur Abgrenzung gegenüber anderen Netzen. Nur Nodes mit der gleichen Home-ID können miteinander kommunizieren.
# '''Node-ID:''' Identifikationsnummer zur eindeutigen Kennzeichnung von jedem Node im Netz.

Die Home-ID ist im Controller (fest) hinterlegt und seine Node-ID ist typischerweise 1. Die Slaves haben zunächst keine Home-ID und Node-ID. Bei der '''Inklusion''' (Aufnahme) der Slaves in das Z-Wave-Netz überträgt der Controller seine Home-ID auf die Slaves und weist den Slaves eine eindeutige Node-ID im Netz zu, mit der Sie direkt angesprochen werden.

Besondere Node-ID ist die 255. Eine Nachricht an die Node-ID 255 kann von allen Z-Wave-Nodes ausgewertet werden (Broadcast).

=== Primär- und Sekundärcontroller ===
Der Controller, der durch Zuteilung seiner Home-ID auf die Slaves, das Netz aufbaut, ist der '''Primärcontroller'''. Grundsätzlich können in einem Netz mehrere Controller existieren, aber immer nur ein Primärcontroller. Weitere in das Netz eingebundene Controller werden zum '''Sekundärcontroller'''. Ohne besondere Maßnahmen kann nur der Primärcontroller die Inklusion (Einbindung) der Nodes in das Netz durchführen. Hingegen können sowohl Primär- als auch Sekundärcontroller die '''Exklusion''' (Ausschluss) eines Nodes aus dem Netz vornehmen.

Der Controller speichert intern diverse Informationen (Home-ID, Node-IDs,..) über das ZWave-Netz. Hierdurch kann unter anderem die Haussteuerungssoftware bei einem PC-Controller relativ unkompliziert gewechselt werden, da die wesentlichen ZWave-Netzinformationen vom Controller selbst verwaltet und gespeichert werden. Andererseits muß bei einem Controllerdefekt das gesamte Netz grundsätzlich neu aufgebaut werden, wenn kein Backup der internen Controllerdaten vorhanden ist.

=== Acknowledge ===
Im Z-Wave-Netz werden Nachrichten vom Empänger-Node an den Sender-Node rückbestätigt (Acknowledge). Bei ausbleibendem Acknowledge wiederholt der Sender-Node die Nachricht automatisch auf Protokollebene bis zu 2 mal. Hierdurch wird eine höhere Betriebssicherheit des Z-Wave-Netzes erreicht. Bei Broadcast-Nachrichten an die Node-ID 255 findet keine Rückbestätigung statt.

=== Vermaschtes Netzwerk mit Routing ===
Z-Wave nutzt als Netzwerktopologie ein '''mesh network''' (vermaschtes Netzwerk), d. h. jeder Node ist mit einem oder mehreren anderen Nodes verbunden. Das hat den Vorteil, dass eine Nachricht zwischen zwei Nodes übermittelt werden kann, selbst wenn diese nicht direkt miteinander kommunizieren können, z. B. weil sie zu weit voneinander entfernt sind. In diesem Fall wird die Funk-Nachricht über einen oder mehrere „Zwischen-Nodes“ übertragen; dieser Vorgang wird '''Routing''' genannt. Nur netzgespeiste Z-Wave-Geräte sind Router. Batteriebetriebe Z-Wave-Geräte sind grundsätzlich keine Router und dienen somit auch nicht zur Reichweitenerhöhung. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia]) Einzelne Geräte, die alternativ per Batterie oder USB-Anschluss betrieben werden können, werden bei USB-Anschluss automatisch ({{Link2Forum|Topic=40393|Message=328080}}) oder durch Konfigurationsänderungen ({{Link2Forum|Topic=40393|Message=327331}}) zu Routern.

Informationen über das optimale Routing werden bei der Inklusion der Nodes in einer Routing-Tabelle des Primärcontrollers gespeichert. Dies geschieht durch Abfrage des Nodes, welche weiteren Nodes er erreichen kann. Durch örtliche Änderung oder Defekte von Nodes können die in der Routing-Tabelle gespeicherten Informationen fehlerhaft bzw. suboptimal werden. Dies kann sich in Funkkommunikationsproblemen im Netzwerk äußern. Hier kann ein per Software manuell angeforderter Neuaufbau der Routing-Tabelle gegebenenfalls Abhilfe schaffen. Bei Geräten und Controllern mit aktuellen Firmware-Versionen (SDK 4.5x und SDK 6.xx oder größer, aber ''nicht'' SDK 5.x) und Unterstützung von Explorer Frames kann sich die Routing-Tabelle unter bestimmten Bedingungen auch automatisch aktualisieren ("Selbstheilung")[https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames].

=== Command Classes ===
Die Steuerung und Kommunikation der Nodes erfolgt über Befehle die funktionsbezogen in verschiedene '''Command Classes''' (Kommandoklassen) zusammengefasst sind.

Alle Z-Wave-Geräte haben als gemeinsame kleinste Übereinstimmung die '''Class Basic'''.

Z-Wave-Geräte haben im Originalzustand eine bestimmte arbeitsfähige Grund-Konfiguration. Anpassbar an individuelle Bedürfnisse ist die Konfiguration über die '''Class Configuration'''.

Durch eine Assoziation wird definiert, welche Geräte miteinander direkt -ohne Umweg über den Controller- kommunizieren können. Auch bei Ausfall des Controllers können diese Geräte ihre gemeinsame Funkton ausüben. Zudem dienen Assoziationen der Geschwindigkeitssteigerung und Funklastreduzierung innerhalb des Netzes. Angelegt werden Assoziationen über die '''Class Association'''.

Dies sind nur die allerwichtigsten Command Classes. Weitere Command Classes sind den Handbüchern zu entnehmen. Zudem enthält die Wiki-Seite [[Z-Wave Command Classes]] weitergehende Informationen.

=== Hinweise zur Z-Wave-Geräteauswahl ===
Aufgrund der vielen Z-Wave-Gerätehersteller mit jeweils eigenem Z-Wave-Gerätesortiment existiert eine große Produktauswahl. Jedoch gibt es auch große Unterschiede hinsichtlich Produkteigenschaften, Pflege der Produkte, Häufigkeit der Aktualisierung der Produktpalette und so weiter. Schwierigkeiten bereitet insbesondere, dass neben den aktuellesten Chipsätzen und SDKs auch die älteren Chipsätze und SDKs weiterhin in Produkten im Handel verfügbar sind. Neuere Chipsätze und aktuelle SDKs bieten gerade bei der Netzwerkstabilität (Explorer Frames, Reichweite usw.) Vorteile zu älteren Chipsätzen und SDKs. Beispielsweise beherrschen nur Geräte mit SDK 4.5x und 6.x oder neuer die für automatische Routenkorrekturen wichtigen Explorer Frames. Das ältere SDK 5.0, das verwirrenderweise auch noch eine höhere Versionsnummer als das neuere SDK 4.5 besitzt, beherrscht unter anderem keine Explorer Frames. Details hierzu enthält das [https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames wiki.zwaveeurope.com]. Aktuellstes SDK ist Stand 10/2017 das SDK 6.7x, das in ZWave Plus - zertifizierten Produkten zum Einsatz kommt.

Gerade Einsteiger beachten die Unterschiede bei den Chipsätze/SDKs aus Unkenntnis manchmal nicht und ärgern sich im Nachhinein über Probleme bei der Netzwerkstabilität und Reichweite. Darum nachfolgend allgemeine, aber sehr einfache Empfehlungen zur Geräteauswahl. Selbstverständlich wird hier nicht von anderen Produkten abgeraten, wenn man die Unterschiede kennt und Vorteile bei deren Produkteigenschaften sieht. Zudem kann man (leider) schlechtere Produkteigenschaften bei Geräten mit aktuelleren Chipsätzen/SDKs nie ausschließen.

Gateway
# [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus-Zertifizierung]. Diese ist mittlerweile bei nahezu allen erhältlichen Gateways gegebenen.

Endgeräte
# Z-Wave Plus-Zertifizierung (aktuellste Technik, höhere theoretische Reichweite, SDK 6.5x oder höher) oder
# zumindest Explorer Frames-Unterstützung (SDK 4.5x und 6.0x) oder
# zuletzt -bei Kenntnis der Besonderheiten und Auswirkungen- Produkte ohne Explorer Frames (SDK 5.0x)

'''Kurz''': Produkte mit Z-Wave Plus-Zertifizierung einsetzen.

Bitte unbedingt beachten, dass Z-Wave Plus-Vorteile bei einem Mischbetrieb mit älteren (ohne Plus) Geräten teilweise verloren gehen. Zum negativen Effekt des Einsatzes eines älteren, aber weiterhin erhältlichen Z-Wave-Repeaters mit aktuellen Z-Wave Plus-Geräten siehe beispielsweise den Hinweis in diesem {{Link2Forum|Topic=42591|Message=350066}}.

Bei Fragen zu bestimmten Geräten bitte -nach Durchsicht der Hinweise hier im Wiki- im Forum suchen oder anschließend nachfragen.

== Z-Wave in FHEM ==
=== Allgemein ===
FHEM wird fortwährend weiterentwickelt und verbessert. Daher ist es zwingend notwendig, dass FHEM auf dem aktuellsten Stand ist. Dazu nach der FHEM-Installation den Befehl <code>update</code> ausführen und anschließend <code>shutdown restart</code> durchführen. Genauso auch vor [[#Welche_Infos_sollten_Anfragen_im_ZWave-Forum_enthalten.3F|Anfragen im Forum]] die Aktualität von FHEM überprüfen.

Die Einbindung von Z-Wave in FHEM ist (nicht nur für den Anfänger) ausschließlich mit der standardmäßig eingeschalteten [[autocreate|autocreate-Funktion]] einfach möglich. Die Kenntnis der FHEM-Grundlagen und Durcharbeitung der Anfänger-Lektüren wird im Folgenden vorausgesetzt. Insbesondere sind [[Erste_Schritte_in_FHEM|Erste Schritte in FHEM]] und [http://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM] Pflicht, auch wenn sie nicht speziell Z-Wave behandeln, so werden doch wesentliche Punkte für ein Verständnis von FHEM vermittelt.

Nachfolgend und auf den [[:Kategorie:Z-Wave Components|Wiki-Seiten der Einzelgeräte]] werden immer wieder Auszüge aus der [[Konfiguration]] dargestellt. Diese dienen zur Erläuterung und Veranschaulichung. Die Bearbeitung der Konfiguration sollte -zur Verhinderung von Fehlern- nach Möglichkeit immer über das "[[Konfiguration#Befehl-Eingabefeld|Befehl-Eingabefeld]]" und die "[[Konfiguration#Objektdetails|Objektdetails]]" erfolgen.

=== Vorbereitung ===
Die Bedienungsanleitungen (Handbücher) sind zwingende Voraussetzung zur korrekten Einbindung und Konfiguration von Z-Wave-Geräten in FHEM. Sie müssen daher vorliegen.
Den ZWave-Geräten liegen teilweise nur gekürzte, gedruckte Fassungen der Handbücher bei (beispielsweise Devolo, AEOTEC). Man sollte bei allen Produkten auf folgenden Seiten nach eventuellen ausführlicheren Handbüchern suchen:
* Herstellerseite des ZWave-Gerätes
* http://www.zwave.de/handbuecher/ (deutsch)
* http://products.z-wavealliance.org (englisch)
Insbesondere auf http://products.z-wavealliance.org, der Datenbank der ZWave-zertifizierten Produkte, sind regelmäßig ausführliche Informationen zu den Geräten zu finden.

== Definition des Gateways / Controllers ==
{{Randnotiz|RNText='''Tester für ZWave@culfw gesucht!'''
Z-Wave-Controllerfunktionen werden derzeit in die Firmware [http://www.culfw.de culfw] für den [[CUL]] implementiert. Weitere Informationen im [[ZWCUL]] - Artikel.}}
=== Autocreate des Gateways ===
FHEM kann mit einem Funkgateway Z-Wave-Funk empfangen und senden. Z-Wave-Gateways (Controller) existieren von verschiedenen Herstellern.

Folgende Gateways wurden unter anderem bereits erfolgreich mit FHEM eingesetzt:
* AEON Labs Z-Stick S2 (SDK 5.x; [https://aeotec.freshdesk.com/support/solutions/articles/6000091809-z-stick-s2-v3-08-firmware-update Firmwareupdate auf 3.08 aus 2016])
* Aeotec Z-Stick Gen5 (Z-Wave Plus; SDK 6.5; [https://aeotec.freshdesk.com/support/solutions/articles/6000108806-z-stick-gen5-backup-software Backup-Software)] ({{Link2Forum|Topic=47000}})
* Goodway WD6001 (SDK 5.03 {{Link2Forum|Topic=40594|Message=332235}})
* Vision Z-Wave USB Stick ZU 1401 EU (SDK 6.0x)
* Vision Z-Wave USB Stick ZU 1401-5 EU (Z-Wave Plus; SDK 6.5x)
* Z-Wave.Me Z-StickC ({{Link2Forum|Topic=29930|Message=226530}})
* Z-Wave.Me USB Stick ZME_UZB1 (SDK 6.5x; Z-Wave Plus; [http://razberry.z-wave.me/z-way-server/ Firmwareupdate und Backup über z-way])
* Z-Wave.Me Razberry in Verbindung mit Raspberry Pi (1. Generation: Z-Wave, 2. Generation: Gen5-Razberry mit Z-Wave Plus[http://forum.z-wave.me/viewtopic.php?f=3419&t=21327#p55404])
** Die seriellen Schnittstelle /dev/ttyAMA0 muss am Raspberry Pi freigeschaltet werden, damit das Razberry-Modul funktionsfähig ist: {{Link2Forum|Topic=78248|Message=702044}})
** Beim Raspberry Pi 3 muss der GPIO-Port auf den Hardware-UART0 umgestellt werden: [[Raspberry Pi 3: GPIO-Port Module und Bluetooth]]

Folgende Gateways sind '''nicht''' mit FHEM einsetzbar:
* Merten Funk-USB-Datenschnittstelle CONNECT

Sollte das eigene Gateway hier nicht aufgeführt sein, ist aufgrund der Standardisierung dennoch die Chance für eine erfolgreiche Einbindung des Gateways in FHEM vorhanden. Bitte dies hier oder im Forum entsprechend vermerken.

Das Z-Wave-Gateway wird unter Linux nach Anschluss an den FHEM-Rechner beim nächsten FHEM-Start oder ohne FHEM-Neustart durch Aufruf des Befehls <code>usb scan</code> zumeist automatisch erkannt und das zugehörige FHEM-Device nach dem Namensschema <code>ZWDongle_<[https://forum.fhem.de/index.php/topic,92885.msg854533.html#msg854533 Anhang]></code> angelegt. Ein manuelles Anlegen des ZWDongle-Moduls oder Eingriffe in die Konfiguration sind unter Linux normalerweise nicht notwendig.

Unter Windows ist ein manuelles Anlegen der Definition des ZWave-Gateways wegen fehlender Unterstützung des Befehls <code>usb scan</code> erforderlich (Beispiel für Z-Wave.Me USB Stick ZME_UZB1 unter Windows: <code>define ZWDongle_1 ZWDongle COM1@115200</code>).

Das FHEM-Gateway-Device ist nach der Definition in FHEM im Raum "Everything" zu finden.

Beispiele der automatisch erzeugten define-Zeile in der Konfiguration:

Aeon Labs Z-Stick an der Fritzbox:
define ZWDongle_1 ZWDongle /dev/ttyUSB1@115200

Vision Z-Wave USB Stick ZU 1401 EU am Raspberry Pi (Raspbian):
define ZWDongle_1 ZWDongle /dev/ttyACM1@115200

Insbesondere wenn am FHEM-Server unter Linux mehrere USB-Gateways eingesetzt werden, empfiehlt es sich zur Erhöhung der Betriebsstabilität das Z-Wave-Gateway über [[Trick_der_Woche#CUL_.26_CO_.C3.BCber_Serial_ID-einbinden|Serial-by-Id]] oder [[LinuxDeviceNaming|uDev-Regeln]] anzusprechen.

Bei einem statischen Controller wird die Einrichtung als SUC -sofern der Controller als solcher nicht bei Auslieferung eingerichtet ist- vor der ersten Inklusion von Geräten empfohlen.

=== homeId und nodeList des Gateways ===
Zur manuellen Definition von Z-Wave Aktoren und Sensoren ist die <code>homeId</code> notwendig. Bei der hier bevorzugten Definition der Geräte durch autocreate ist die Kenntnis der <code>homeId</code> nicht zwingend. Jedoch sollte durch Abfrage der <code>homeId</code> direkt nach Einbindung des Zwave-Gateways dessen Funktionsfähigkeit getestet werden.

Die <code>homeId</code> und <code>CtrlNodeId</code> des Gateways wird mit folgendem Befehl ausgelesen (<ZWDongle> ist im folgenden durch den Namen des FHEM-Devices des eigenen Gateways zu ersetzen):
get <ZWDongle> homeId
ergibt beispielsweise bei einem Gateway mit dem FHEM-Devicenamen ZWDongle_1:
ZWDongle_1 homeId => HomeId:e345c456 CtrlNodeId:01
In diesem Beispiel ist die Home-Id des Gateways ZWDongle_1 e345c456 und das Gateway hat die Node-Id 1.

Die aktuelle Liste der Z-Wave Nodes, die bereits am Gateway registriert/inkludiert sind, wird mit dem folgendem Befehl ausgelesen:
get <ZWDongle> nodeList
ergibt beispielsweise:
ZWDongle_1 nodeList => ZWDongle_1 UNKNOWN_2

== Definition von Geräten / Slaves ==
=== Hinzufügen eines neuen Z-Wave Geräts / Inklusion ===
Zur Verfolgung von Inklusionsablauf und Meldungen des Controllers während der Inklusion sollte der [[Event monitor]] in einem 2. Browserfenster vor Aktivierung des Inklusionsmodus geöffnet werden.

Das Z-Wave Gateway wird in den Standard-Modus zur Inklusion (zum Aufnehmen) neuer Geräte gesetzt:
set <ZWDongle> addNode on
Bei der Standard-Inklusion muss direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen.

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt des obigen Befehls besser der Network-Wide-Modus für die Inklusion genutzt werden:
set <ZWDongle> addNode onNw
Bei der Network-Wide-Inklusion muss kein direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen. Es reicht, wenn das zu inkludierende Gerät über andere bereits inkludierte, netzgespeiste Geräte mit Explorer Frames-Unterstützung erreicht werden kann. Die Network-Wide-Inklusion ist zu bevorzugen, da die Z-Wave-Geräte regelmäßig an Ihren örtlichen Endpositionen inkludiert werden können. Dadurch werden bei der Inklusion direkt die korrekten Routen gespeichert.

Nachdem das Gateway in den Inklusionmodus geschaltet wurde, muss das Gerät in den Inklusionsmodus (Aufnahmemodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen. Typisch sind ein- oder dreimaliges Drücken einer Taste am Gerät oder beim Anlegen der Versorgungsspannung. Durch die Inklusion werden Home-ID und Node-ID im Gerät gespeichert. Zudem teilt das Gerät über ein spezielle Funknachricht (NIF=Node Information Frame) dem Controller seinen Gerätetyp und seine Geräteeigenschaften mit. Hierbei werden dem Controller auch die vom Gerät unterstützten Command Classes mitgeteilt. Aus diesen Informationen erzeugt FHEM automatisch durch autocreate das FHEM-Geräte-Device nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> (an eigene Wünsche anpassbar mit {{Link2CmdRef|Anker=rename|Label=rename}}). Die vom Geräte unterstützen Command Classes, die die in FHEM verfügbaren Befehle bestimmen, werden automatisch im Attribut <code>classes</code> des FHEM-Geräte-Device gespeichert. Das Gerät ist damit grundlegend in FHEM definiert und im Raum "ZWave" zu finden.

Nach der Inklusion schaltet FHEM den Inklusionsmodus des Z-Wave Gateway automatisch durch Absetzen des Befehls <code>set <ZWDongle> addNode off</code> aus und zeigt eine Dialogbox mit dem Ergebnis der Inklusion:
* <code><nowiki>created ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> = Inklusion war erfolgreich und es wurde das bezeichnete FHEM-Device durch autocreate angelegt.
* <code><nowiki>addNode failed</nowiki></code> = Inklusion ist fehlgeschlagen

Eine erfolgreiche Inklusion ist zudem am Event "ZW_ADD_NODE_TO_NETWORK protocolDone" im Event monitor und natürlich der Anlage des entsprechenden FHEM-Devices durch autocreate zu erkennen. Das Scheitern einer Inklusion führt typischerweise zur Ausgabe des Events "ZW_ADD_NODE_TO_NETWORK failed". Häufigste Ursache sind Controllerprobleme, die sich oftmals durch kurzes Ein- und Ausstecken des Controllers, Neustart des Systems oder Ein- und Ausschalten des FHEM-Server-Computers beheben lassen.

HINWEISE:<br />
* Die Network-Wide-Inklusion kann nach derzeitiger Kenntnis auch bei Gateways und Geräten ohne Explorer Frames Unterstützung genutzt werden, da bei diesen Geräten grundsätzlich automatisch auf die Standard-Inklusion umgestellt wird.
* Bei der Standard-Inklusion ist unter Umständen nur ein geringer Abstand zwischen Gateway und Gerät möglich. Sollte die Inklusion daher nicht durchführbar sein, wenn Gateway und Gerät an ihren örtlichen Endpositionen sind (bevorzugte Variante), dann ist der Abstand zwischen diesen versuchsweise zu verringern. Anschließend bei örtlicher Veränderung die Routen mit <code><nowiki>set <ZWave-Devicename> neighborUpdate</nowiki></code> bzw. <code><nowiki>set TYPE=ZWave:FILTER=ZWaveSubDevice=no neighborUpdate</nowiki></code> neu ermitteln lassen. Unter Umständen kann der Abstand nur schrittweise erhöht werden. Dann ist bei jeder Abstandsänderung eine Neuermittlung der Routen notwendig.
* Der NIF enthält bei manchen Geräten fälschlicherweise nicht alle unterstützten Command Classes. FHEM identifiziert während der Inklusion das Gerät und ergänzt die fehlenden Command Classes aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Weiterhin fehlende Command Classes können im Attribut <code>classes</code> manuell am Anfang der Liste entsprechend ergänzt werden. Informationen liefern die unter [[#Links|Links]] aufgeführten Datenbanken. Häufig fehlt die Pflicht-Class BASIC.
* Bei der hier beschriebenen Inklusion findet die Kommunikation zwischen Controller und Gerät anschließend dauerhaft unverschlüsselt statt. Manche Geräte bieten mit der Command Class SECURITY eine AES-verschlüsselte Kommunikation an. Da die Verschlüsselung zu einer höheren Funklast und Latenzen führt, sollte eine verschlüsselte Kommunikation nur mit Bedacht eingesetzt werden (bspw. bei Schlössern). Als Sonderfall ist das Vorgehen zur secure-Inklusion in der [[#Wie_kann_eine_verschl.C3.BCsselte_Kommunikation_unter_Nutzung_der_Command_Class_SECURITY_eingerichtet_werden.3F|FAQ]] beschrieben.

Nächster Schritt ist die [[#Assoziation|Assoziation]] des Gerätes mit dem Gateway.

=== Assoziation ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Z-Wave-Geräte können über Assoziationen direkt mit anderen Z-Wave-Geräten kommunizieren. Dies können zum einen Meldungen über den Status und Zustand der Geräte, als auch direkte Befehle sein. Zum Beispiel kann damit ein Bewegungsmelder eine entdeckte Bewegung an den Controller senden und/oder bei entdeckter Bewegung direkt eine Lampe ein- oder ausschalten.

Die Assoziation zwischen zwei Geräten wird durch Aufnahme des zu steuernden Gerätes in eine oder mehrere Assoziationsgruppe(n) des steuernden Gerätes angelegt. Durch die Wahl der Assoziationsgruppe wird festgelegt, bei welchen Ereignissen welche Nachricht an das assoziierte Gerät verschickt wird. Angaben zu den Ereignissen und versandten Nachrichten an die Geräte in einer bestimmten Assoziationsgruppe stehen in der Bedienungsanleitung des jeweiligen Gerätes.

Damit FHEM Statusmeldungen von Sensoren/Aktoren anzeigen und auch darauf reagieren kann, '''muss''' der Controller (<ZWDongle>-Device, <code>CtrlNodeId</code> = typischerweise 1) immer in der/den passenden Assoziationsgruppe(n) des jeweiligen Gerätes <code><name></code> aufgenommen werden:

set <name> associationAdd <associationGroup> <CtrlNodeId>

Typischerweise ist die Assoziationsgruppe 1 der Geräte für die Statusmeldungen an den Controller vorgesehen (Ausnahme: [[#Fibaro|Fibaro-Geräte ohne ZWave Plus - Zertifizierung]]). Daher nimmt FHEM die Assoziation von Controller mit der Assoziationsgruppe 1 des Gerätes bei der Inklusion immer automatisch vor. Zudem identifiziert FHEM während der Inklusion das Gerät und setzt weitere Assoziationen mit dem Controller für von 1 abweichende Assoziationsgruppen aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Ist keine XML-Config-Datei für das Gerät vorhanden, sind Assoziationen des Controllers mit von 1 abweichenden Assoziationsgruppen oder weiteren Assoziationsgruppen mit dem zuvor genannten Befehl grundsätzlich manuell anzulegen.

Die richtige Anlage der Assoziation(en) des Controllers mit dem Gerät immer prüfen, da dies eine Hauptfehlerquelle bei Funktionsproblemen mit FHEM ist.

Abruf der assoziierten Geräte in einer bestimmten Assoziationsgruppe <associationGroup>:
get <name> association <associationGroup>

Abruf der assozierten Geräte für alle Assoziationsgruppen eines Gerätes:
get <name> associationAll

Nahezu alle in Europa erhältlichen aktuellen Geräte unterstützen die Rückmeldung des Status via Association. Ausnahmen gibt es in Nordamerika, wo aufgrund von Patentansprüchen einige Hersteller auf die Statusrückmeldungen verzichten. Diese Geräte unterstützen in der Regel die Command Class ASSOCIATION nicht.

Nächster Schritt ist die [[#Konfiguration|Konfiguration]] des Gerätes.

=== Konfiguration ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Die Standard-Konfiguration eines Gerätes entspricht oftmals nicht den eigenen Wünschen und Anforderungen (Einheiten usw.). Mit den Befehlen der Class CONFIGURATION lässt sich die Konfiguration anpassen. Die zur Konfiguration eines Gerätes notwendigen Angaben zu den Parameternummern, -größen und -werten sind im jeweiligen Geräte-Handbuch bzw. entsprechenden Datenbanken (bspw. [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] oder [http://products.zwavealliance.com/ products.zwavealliance.com]) enthalten.

Die Konfiguration beispielsweise bei Parametergröße 1 lässt sich mit diesem Befehl anpassen:
set <name> configByte <Parameternummer> <Parameterwert>
Für weitere Parametergrößen gibt es die Befehle <code>configWord</code> und <code>configLong</code>

Die im Gerät hinterlegten Konfiguration kann pro Parameternummer mit folgendem Befehl abgerufen werden:
get <name> config <Parameternummer>

Zudem bietet FHEM basierend auf den manuell gepflegten XML-Config-Dateien die Möglichkeit, die speziellen Parameternummern des Gerätes mit ihren Parametergrößen und -werte als eigenständige config-Befehle mit Hilfsinformationen einzubinden. Ein manuelles Suchen im Geräte-Handbuch und Nutzung der configByte-, configWord- und configLong-Befehle ist dadurch in vielen Fällen unnötig. Für diese Funktion muss das Gerät von FHEM einmalig durch folgenden Befehl, der bei der Inklusion automatisch ausgeführt wird, identifiziert werden:
get <name> model
Die Readings <code>model</code>, <code>modelID</code> und <code>modelConfig</code> werden dadurch erzeugt. In <code>model</code> sollte der Klartextname des Gerätes stehen. Zudem sind dann -soweit eine XML-Config Datei für das Gerät existiert- die speziellen set/get-Kommandos configXYZ für das Geräte im Auswahldialog der Detailansicht mit Hilfsinformationen verfügbar:
[[Datei:Z-Wave_confighelp.PNG|900px|thumb|center|config-Befehl mit Hilfstext]]

Bei vorhandener XML-Config-Datei kann die komplette Konfiguration eines Gerätes abgerufen werden:
get <name> configAll

Außerdem wird durch den <code>get <name> model</code> -Befehl geprüft, ob das Gerät in der [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] und/oder [http://products.zwavealliance.com/ products.zwavealliance.com] enthalten ist. Im Erfolgsfall wird ein Link "Details in pepper DB" und/oder "Details in alliance DB" zum entsprechenden Geräteeintrag in der jeweiligen Datenbank unten in der Detailansicht des FHEM-Geräte-Devices angelegt und ein Bild des Gerätes in die Detailansicht eingebunden.

Der Aufruf von <code>get <name> model</code> ist auch für die Nutzung der Class MANUFACTURER_PROPRIETARY zwingende Einsatzvoraussetzung.

=== Entfernen eines Z-Wave-Geräts / Exklusion ===
Durch die Exklusion wird die Home-ID und Node-ID aus dem Gerät und das Gerät selbst aus der Node-List des Controllers gelöscht. Erst nach einer Exklusion kann das Gerät in ein anderes Z-Wave-Netz aufgenommen werden.

Zuerst wird der Z-Wave Gateway in den Standard-Modus zur Exklusion (Ausschluss) von Geräten gesetzt:
set <ZWDongle> removeNode on

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt dem obigen Befehl besser der Network-Wide-Modus für die Exklusion genutzt werden (siehe auch Erläuterungen zu Standard- versus Network-Wide-Inklusion unter [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]]):
set <ZWDongle> removeNode onNw

Danach muss das Gerät in den Exklusionsmodus (Ausschlussmodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen.

Abschließend wird der Exklusionsmodus am Z-Wave Gateway wieder ausgeschaltet:
set <ZWDongle> removeNode off

Das FHEM-Device muss nach der Exklusion manuell durch <code>delete <name></code> gelöscht werden.

Die durch die Exklusion frei gewordene NodeID wird nicht bei der nächsten Inklusion wiederverwendet, sondern es wird die höchste noch nicht verwendete NodeID genutzt.

=== Erneutes Hinzufügen eines bereits registrierten Z-Wave Geräts ===
Die an einem Z-Wave-Gateway bereits registrierten/inkludierten Geräte sind im Gateway selbst abgespeichert und können durch FHEM jederzeit wieder abgerufen werden. Dies kann man in folgenden Fällen sinnvoll nutzen:
* Inklusion mit einem batteriegespeisten ZWave-Gateway (bspw. Aeon Labs Z-Stick) ohne FHEM-Server-Anschluss während der Inklusion
* Umstieg eines ZWave-Netzwerkes von Fremdsoftware auf FHEM
* Vollständiger oder teilweiser Verlust der FHEM-Konfiguration

Eine Node-Liste aller inkludierten Geräte des Gateways wird abgerufen durch:
get <ZWDongle> nodeList
Es wird eine Liste aller im Gateway inkludierten Gerät inklusive Gateway selbst zurückgeliefert. Sofern ein Gerät bereits als FHEM-Device angelegt wurde, wird der FHEM-Device-Name in der nodeList angezeigt. Dies ist für das Gateway selbst immer der Fall. Alle noch nicht in FHEM angelegten Geräte, werden als "UNKNOWN_x" ausgegeben, wobei x die ID des betreffenden Gerätes ist.

Mit dem folgenden Befehl wird beispielsweise das bereits im Gateway inkludierte Gerät mit der ID 2 (in der nodeList angezeigt als "UNKNOWN_2") in FHEM durch autocreate definiert:
set <ZWDongle> createNode 2

Batteriebetriebene Geräte müssen bei Absetzen des <code>createNode</code>-Befehls wach sein, damit der Befehl verarbeitet werden kann. Dies erreicht man, indem man das Gerät auf "permanent wach" stellt. Falls das Gerät diese Funktion nicht anbietet, muss man es manuell aufwecken und max. 2 Sekunden später den <code>createNode</code>-Befehl absetzen. Alternativ kann das batteriebetriebene Gerät durch Versand des NIF vom Gerät aus automatisch in FHEM erzeugt werden: Hierzu am Gerät die Taste zum Versand des NIF drücken und <code>autocreate</code> legt das FHEM-Device an; der Aufruf von <code>createNode</code> entfällt dann.

== Geräte-Besonderheiten ==
=== batteriebetriebene Geräte ===
Batteriebetriebenen Geräten können hinsichtlich ihrer Empfangsbereitschaft unterschieden werden in

* Wakeup-Geräte
* FLIRS-Geräte

==== Wakeup-Geräte ====
Wakeup-Geräte sind momentan die häufigste Art von batteriebetriebenen Z-Wave Geräten. Sie sind erkennbar an der Unterstützung der Command Class WAKE_UP.
Zur Verlängerung der Batterielaufzeit legen sich batteriebetriebene Wakeup-Geräte „schlafen“ und wachen (Wakeup) nur in konfigurierbaren Intervallen auf, um Befehle zu verarbeiten. Das Aufwachen signalisieren die Geräte durch den Versand einer Nachricht "wakeup notification". Daraufhin senden FHEM und andere Geräte ihre bis dahin gesammelten Befehle, die dann verarbeitet bzw. beantwortet werden. Anschließend gehen die batteriebetriebenen Geräte wieder in den Schlafmodus.

FHEM teilt bei set/get-Befehlen an batteriebetriebene Geräte über einen Hinweis der Form
:<code>Scheduled for sending after WAKEUP</code>
::oder
:<code>Scheduled get requests for sending after WAKEUP</code>
mit, dass der Befehl im Sendstack des FHEM-Geräte-Devices abgespeichert wurde und bei der nächsten "wakeup notification" an das Gerät versendet wird. Ein Versand der Befehle im Sendstack findet grundsätzlich ausschließlich nach Erhalt der "wakeup notification"-Nachricht statt, selbst wenn das Gerät zwischendurch andere Telegramme (bspw. Bewegungsmeldung, Temperatur) an den Controller verschickt. Nur nach Versand der "wakeup notification" ist das batteriebetriebene Gerät grundsätzlich in der Lage ("wach genug"), Telegramme korrekt zu empfangen und zu verarbeiten.

Wie viele Nachrichten im Sendstack auf einen Versand an das Gerät warten, ist im Internal <code>cmdsPending</code> des zugehörigen FHEM-Devices ersichtlich. Welche Nachrichten (Befehle) im Sendstack warten, ist in der Ausgabe des Befehls <code>[[list]] <device></code> erkennbar: Unter der Überschrift Sendstack sind alle wartenden Nachrichten als Rohnachrichten aufgeführt. Der Sendstack wird beim Beenden von FHEM nicht gespeichert. Durch Beenden von FHEM (beispielsweise durch <code>shutdown restart</code>) geht der Sendstack der Geräte daher verloren.

Das Wakeup-Interval und der Empfänger der "wakeup notification" wird wie folgt konfiguriert:
<nowiki>set <name> wakeupInterval <time> <NodeId></nowiki>
<nowiki><time></nowiki> ist die Zeit in Sekunden zwischen den Intervallen und <nodeID> der gewünschte Empfänger der "wakeup notification"; in der Regel ist dies '''immer''' der Controller <CtrlNodeId>. Viele Geräte kommen im Auslieferungszustand mit der NodeID 255. Die "wakeup notification" wird dann als Broadcast ohne Nutzung von Routing an alle erreichbaren Geräte gesendet. Hier sollte die Konfiguration auf die NodeID des Controllers geändert werden, da dadurch die "wakeup notification" geroutet wird und größere Entfernungen zwischen Gerät und Controller möglich sind. Zudem ist dies robuster und spart zusätzlich noch Batterielaufzeit. Darum setzt FHEM bei der Inklusion von WakeUp-Geräten '''automatisch''' den Befehl <code><nowiki>set <name> wakeupInterval 86400 <ControllerNodeId></nowiki></code> ab. Bei abweichenden eigenen Vorstellungen ist dies gegebenenfalls anzupassen. Bei Geräten mit V2 der Command Class WAKE_UP kann das vom Hersteller vorgesehene Standard-wakeupInterval mit <code><nowiki>get <name> wakeupIntervalCapabilities</nowiki></code> vom Gerät abgerufen werden. Die Einstellungen von wakeupInterval nach Inklusion und nach jeder Änderung immer mit der Abfrage <code><nowiki>get <name> wakeupInterval</nowiki></code> überprüfen.

Ein Aufwachen und Versand der "wakeup notification" von batteriebetriebenen Geräten kann für die [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] manuell erzwungen werden. Hierzu bringt man das Gerät normalerweise in den Inklusionsmodus oder findet in der Bedienungsanleitung gegebenenfalls andere Informationen. Bitte beachten, dass dann je nach Gerät nur eine geringe Entfernung von Gateway und Gerät vorhanden sein darf (direkte Erreichbarkeit). Alternativ kann für die Dauer der Assoziation und Konfiguration das Wakeup-Interval verkürzt werden (beispielsweise auf 60 Sekunden), wodurch das Routing genutzt werden kann und größere Entfernungen zwischen Gateway und Gerät überbrückt werden können. Anschließend das Wakeup-Interval wieder auf eine batterieschonenende Dauer einzustellen.

Einzelne batteriebetriebene Gerät lassen sich für längere Zeit auf "wach" bzw. permanent "wach" stellen. Dann aus dem Attribut <code>classes</code> <code>WAKE_UP</code> entfernen, damit Befehle in diesem Gerätemodus von FHEM direkt verschickt werden. Nach Ausschalten des "wach"-Modus <code>WAKE_UP</code> wieder im Attribut <code>classes</code> aufnehmen.

Bei Konfigurationsänderungen an batteriebetriebenen Geräten mit <code>set <name> config...</code> sollte die korrekte Verarbeitung der Befehle immer mit dem entsprechenden <code>get <name> config...</code> oder -falls vorhanden- mit <code>get <name> configAll</code> überprüft werden, um eventuelle Funk-Telegrammverluste sofort festzustellen.

==== FLIRS-Geräte ====
Ein batteriebetriebene FLIRS (frequently listening routing slave) Gerät wacht in sehr kurzen Zeitabständen (250ms oder 1000ms) auf und prüft, ob ein Funksignal vorliegt. Liegt kein Funksignal vor geht das Gerät wieder in Tiefschlaf. Zum Aufwecken eines FLIRS-Gerätes ist ein dauerhaftes Funksignal -der Wakeup-Beam-, notwendig, das etwas länger als die Aufweckzeitabstände sein muss. Näher beschrieben unter anderem [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF hier].

FLIRS-Geräte haben nicht die Command Class WAKE_UP und arbeiten deshalb nicht mit "wakeup notification". Aus Sicht des FHEM-Nutzers sind die bekannten FLIRS-Geräte (Sirenen von Vision und Popp) nicht anders zu bedienen/einzurichten als netzgespeiste Geräte. Wakeup-Beam und andere Besonderheiten werden unsichtbar für den Nutzer automatisch abgewickelt.

=== Aeon Labs / Aeotec ===
Ausführliche Handbücher und technische Informationen auf https://aeotec.freshdesk.com/support/home

==== Multi Sensor 5 ====
* aktuellste Firmware installieren
* Attribut <code>classes</code> um <code>BASIC</code> ergänzen (ab [[version|Modulversion]] 8824/25.6.2015 wird das automatisch bei der Inklusion durchgeführt)
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* Parameter 101 auf 225 (oder 224 bei USB-Anschluss) setzen mit <code>set <name> configGroup1Reports 225</code> oder <code>set <name> configLong 101 225</code>, um Batteriezustand (nicht bei 224), Temperatur, Feuchte und Helligkeit regelmäßig zu erhalten. Das Sende-Intervall wird duch <code><nowiki>set <name> configGroup1Interval <time/s></nowiki></code> festgelegt (Standard 720 Sek).
* [http://devel.pepper1.net/zwavedb/device/407 Paramterübersicht pepper-Datenbank]
siehe {{Link2Forum|Topic=34505|Message=268913}}

==== Multisensor 6 ====
siehe {{Link2Forum|Topic=40393}}
* arbeitet bei USB-Anschluß als Router
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* die <code>configGroupxInterval</code> und <code>configxxxReportingThreshold</code> Einstellungen wirken nur bei USB-Anschluss, im reinen Batteriebetrieb werden die Sensordaten nur bei einem <code>wakeup</code> übertragen

==== Aeotec LED Bulb ZW098-C55 ====
siehe {{Link2Forum|Topic=40504}}

=== Danfoss ===
==== DAN_LC-13 Heizungsthermostat LC-13 (014G0013) ====
Das Danfoss Heizungsthermostat LC-13 muss derzeit zur korrekten Funktion mit FHEM regelmäßig mit folgendem <code>at</code> abgefragt werden ({{Link2Forum|Topic=32145|Message=260795}}):
define Atdanfoss at +*00:30 get <name> battery
Auf dem Markt sind mehrere Varianten des Thermostates LC-13 erhältlich. Darum beim Kauf unbedingt auf die genaue Bezeichnung LC-13 (014G0013) achten ({{Link2Forum|Topic=38041|Message=303146}}).

=== devolo ===
Ausführliche Handbücher auf http://products.z-wavealliance.org

==== MT02648 Tür-/Fenster Kontakt 3in1 ====
siehe {{Link2Forum|Topic=41337}}

=== DüWI ===
Geräte von DÜWI liefern bei örtlicher Betätigung kein automatisches Funk-Signal über die Statusänderung. Das liese sich nur durch eine regelmäßige Statusabfrage durch FHEM (beispielsweise <code>define Status_Abfrage at +*00:03:00 get <name> swmStatus</code>) beheben.
Einige Produkte von [http://zwave.me Z-Wave.Me] basieren auf DÜWI-Geräten. Diese Z-Wave.Me Produkte haben jedoch eine erweiterte Firmware, welche die genannte und weitere Firmware-Schwächen der Original-Produkte von DÜWI behebt.

=== Everspring ===
==== AN145 Sockelmodul E27 ====
Statusabfrage ohne permanente Abfrage: {{Link2Forum|Topic=48864|Message=405545|Beitrag}}

=== Fibaro ===
Association Group für Übermittlung von Statusinformationen an den Controller:
* "alte" ZWave-Geräte (kein ZWave-Plus): häufig Association Group 3
: <code><nowiki>set <name> associationAdd 3 <CtrlNodeId></nowiki></code>
: Bei diesen Geräten empfiehlt es sich zur Funklastreduzierung und Problemminimierung zu prüfen, ob die von FHEM automatisch vorgenommene Assoziation des Controllers mit der Association Group 1 gelöscht werden kann (<code><nowiki>set <name> associationDel 1 <CtrlNodeId></nowiki></code>). Nahezu immer werden in Association Group 1 die gleichen Infos, nur mit einer anderen Command Class, wie in der Association Group 3 an den Controller übermittelt.
* ZWave Plus-Geräte: Association Group 1 ("lifeline")

==== FGSS-001 / FGSD-002 Rauchmelder ====
* nicht untereinander vernetzbar
* keine Alarmauslösung/Sirenenfunktion durch ZWave-Zentralen

==== FGS-222 Relais Unterputzeinsatz ====
Bei der Inklusion werden von FHEM 3 Devices angelegt:
* Hauptdevice (Steuerung und automatischer Status für Kanal 1 und kanalübergreifende Funktionen)
* Device für Endpoint 1 (Steuerung Kanal 1)
* Device für Endpoint 2 (Steuerung und automatischer Status von Kanal 2)
Die Firmware des FGS-222 übermittelt den Status für Kanal 1 automatisch immer ausschließlich an das Hauptdevice. Die Steuerung von Kanal 1 kann hingegen sowohl über das Hauptdevice als auch über das Device für Endpoint 1 erfolgen. Das Device für Endpoint 1 ist somit nicht zwingend erforderlich und kann grundsätzlich gelöscht oder in den room hidden verschoben werden.

Details: {{Link2Forum|Topic=50176}}

Hinweis zum Reset: {{Link2Forum|Topic=55190|Message=469393}}

==== FGK-101 Tür/Fensterkontakt ====
* Besonderheiten bei Anschluss eines Temperatursensors: {{Link2Forum|Topic=38012}}

=== GE ===
==== GE (Model t.b.d) ====
Dieser Schalter unterstützt keine Statusrückmeldungen.

=== Merten ===
Laut {{Link2Forum|Topic=38133}} müssen bei einigen Merten-Geräten, die mit Fremdsoftware inkludiert wurden, gegebenenfalls die Geräte wieder exkludiert und dann erneut mit FHEM inkludiert werden, damit Assoziationen mit FHEM gesetzt werden können.

=== Philio ===
==== PHI_PAN04 Relais Unterputzeinsatz 2 Schalter a 1.5kW mit Messfunktion ====
siehe {{Link2Forum|Topic=28046}}

=== Popp ===
==== POPE004001 Z-Wave Rauchmelder mit Innensirene ====
siehe {{Link2Forum|Topic=39856}}
==== POPE005107 Z-Wave Außensirene ====
siehe {{Link2Forum|Topic=42736}}<br>
Alte Firmwareversionen haben einen Bug bei der Übermittlung von negativen Temperaturen. Eine Lösungsvariante über ein <code>userReadings</code> findet sich auch im verlinkten Thema.
==== POPE009006 Z-Wave Wall Plug Switch ====
siehe {{Link2Forum|Topic=40771}}
==== POPE009402 10Year Smoke Detector ====
Die erste Firmwareversion hat eine fehlerhafte modelID. Diese Rauchmelder wird dadurch fälschlich als [[Z-Wave#POPE005107_Z-Wave_Au.C3.9Fensirene|Popp Aussensirene]] in FHEM angezeigt. Neuere Geräte werden laut Popp mit der korrekten modelID ausgeliefert.

=== Z-Wave.Me ===
==== ZME_RC2 Fernbedienung ====
siehe {{Link2Forum|Topic=35513}}<BR>
Das Forenthema enthält eine detaillierte Beschreibung der Nutzung der Class MULTI_CHANNEL_ASSOCIATION.

== Geräte-Vergleich ==
=== Doppel-Relais ===
{| class="wikitable"
|-
! Eigenschaft !! FIBARO Double Switch 2-FGS-223 !! Qubino Flush 2 relays !! Philio-PAN04 1
|-
| Funktion || Doppel-Relais || Doppel-Relais || Doppel-Relais
|-
| Standby-Leistung || ca. 0.4W || ca. 0.4W || ca. 0.5W
|-
| Reaktion beim Schalten am Tastereingang || schnell, kaum merkliche Verzögerung || schnell, kaum merkliche Verzögerung || langsam, unangenehm langes drücken des Tasters nötig >1 Sekunde
|-
| Geräte in FHEM || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 4 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 <br> x.03 Summengerät (ähnlich Hauptgerät, überflüssig)
|-
| Zustand Hauptgerät || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais
|-
| Statuswechsel Report vom Gerät zum FHEM || ca. 1 Sekunde || ca. 3 Sekunden || ca. 3-4 Sekunden
|-
| Empfänger des Status Reports || Hauptgerät und Untergeräte || Hauptgerät und Untergeräte || Nur Hauptgerät <br>Aktualisierung der Untergeräte nur bei aktiver Abfrage
|-
| Leistungsmessung || Separat für Untergeräte || Separat für Untergeräte || Nur Summe
|-
| Sicherung nötig / Strom || ja, 2x 6.5A, Summe max 10A || ja, max 2x 4A || nein, 2x 6.5A
|}
Beim Qubino Flush 2 relays muss eine MULTI_CHANNEL_ASSOCIATION mit dem Controller (Endpoint root) statt einer "normalen" Assoziation gesetzt werden, damit die Status der Untergeräte einzeln signalisert werden:

set associationDel 1 <controllerNodeId>
set <device> mcaAdd 1 0 <controllerNodeId> 0

Bei einem FHEM-Updatestand ab 20.09.2019 erfolgt diese Einstellung automatisch.

== Links ==
=== Allgemein ===
* Grundlageninformation "Z-Wave-Haupt-Anleitung": [http://www.zwave.de/z-wave-funknetz-einrichten-und-betreiben/ Wie errichte und betreibe ich ein Z-Wave basiertes Funknetz]
* [http://www.zwave.de/buch-z-wave-grundlagen/ Buch] "Z-Wave: Die Funktechnologie für das Smart Home" von Dr. Christian Paetz (Paetz "is the primary European representative for the Z-Wave Alliance" [http://z-wavealliance.org/global-contacts/])
* Z-Wave-Produktdatenbank mit Angabe zur Zertifizierung, Handbüchern und weiteren Detailinfos (Z-Wave oder [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus]): http://products.z-wavealliance.org (englisch)
* herstellerübergreifende Datenbank mit Bedienungsanleitungen zu Z-Wave-Geräten: http://www.zwave.de/handbuecher/ oder http://manuals.zwaveeurope.com (mehrsprachig)
* herstellerübergreifende Datenbank mit technischen Informationen zu Z-Wave-Geräten (Z-Wave Device Library): http://devel.pepper1.net/zwavedb/ (englisch; wird derzeit nicht mehr aktualisiert)
* informative Webseiten zu Z-Wave:
** [http://www.z-wavealliance.org/ http://www.z-wavealliance.org/] (englisch)
** [http://www.zwaveeurope.com/ http://www.zwaveeurope.com/] (englisch)
** [http://www.zwave.de/ http://www.zwave.de/] (deutsch)
** [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF Introductory Guide to Z-Wave-Technology von Honeywell] (englisch; nicht auf aktuellem Stand)

=== Informationsquellen zur Einbindung von Command Classes ===
Offizielle und ausführliche Informationen von Sigma Designs (veröffentlicht am 31.08.2016):
* [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification]

Weitere Informationen (seit Veröffentlichung der Z-Wave Spezifikationen am 31.08.2016 geringe Relevanz)
* [https://github.com/yepher/RaZBerry Infos zu Command Classes (ausführlich; insbesondere im Verzeichnis "docs"), RaZBerry und Z-Wave allgemein], englisch
* [http://220.135.186.178/zwave/example/ Übersicht von Command Classes und deren Rückgabewerten mit Unterscheidung der Class-Versionen], englisch
* Code von http://www.openzwave.org (https://github.com/OpenZWave/open-zwave) und http://www.openhab.org (Z-Wave binding: https://github.com/cdjackson/openhab)
* eine Java-API-Beschreibung mit Hinweisen zu Unterschieden von Class-Versionen: http://dz.prosyst.com/pdoc/mBS_SH_SDK_8.1/modules/zwave/api/driver/index.html

== FAQ ==
=== Welche Infos sollten Anfragen im ZWave-Forum enthalten? ===
* Anfragen bitte nur zur aktuellsten FHEM-Version: Befehl <code>update</code> ergibt Ausgabe "nothing to do..."
* detaillierte Beschreibung des Problems
* beteiligte Komponenten (genaue Bezeichnung und evtl. Link auf Hersteller-Dokumentation)
* list des jeweiligen FHEM-Devices (Ausgabe von <code>list <device></code>)
::Bitte vor Aufruf des list-Befehls -wenn vorhanden/möglich- folgende Befehle ausführen und Ergebnis abwarten:
::*<code>get <device> associationAll</code>
::*<code>get <device> configAll</code>
::*<code>get <device> versionClassAll</code>
::*<code>get <device> mcaAll</code>
::*<code>get <device> wakeupInterval</code> (nur bei batteriebetriebenen Geräten)
* passender Ausschnitt aus dem Logfile (siehe Link im FHEM-Menü links) generiert mit den gesetzten Attributen
::*<code>attr <ZWDongle> verbose 5</code> und
::*<code>attr global mseclog 1</code>

=== Welche Schritte sind für die Einbindung von ZWave-Geräten in FHEM mindestens durchzuführen? ===
Voraussetzung: ZWave-Gateway ist erfolgreich eingebunden!
# [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes
# [[#Assoziation|Assoziation]] der Assoziationsgruppe(n) des Gerätes mit dem Gateway
# [[#Konfiguration|Konfiguration]] des Gerätes

=== Warum bleibt der Status (STATE) des neu inkludierten Gerätes dauerhaft auf "associationAdd <associationGroup> <CtrlNodeId>" stehen? ===
FHEM setzt das Reading "state", das den STATE bestimmt, nicht bei allen ZWave-Devices mit vordefinierten Standardwerten. Daher bleibt der bei der Inklusion automatisch abgesetzte "associationAdd"-Befehl unter Umständen im STATE stehen, bis der Anwender den STATE über die Vergabe des Attributes <code>{{Link2CmdRef|Anker=stateFormat|Label=stateFormat}}</code> manuell an seine Bedürfnisse angepasst hat.
(weitergehende Info zum state/STATE/stateFormat: [[DevelopmentState]])

=== Wie können bei mehrkanaligen Aktoren die zusätzlichen Kanäle (>1) angesprochen werden? ===
* Bei der [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes wird das Hauptdevice mit dem Namen <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> und die Devices für alle Kanäle (Endpoints) nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID>.<EndpointNr></nowiki></code> automatisch angelegt. Jedes dieser FHEM-Devices spricht regelmäßig einen bestimmten Kanal des Gerätes an; einige Geräte sprechen mit dem Hauptdevice jedoch das gesamte Gerät mit allen Kanälen an (Bedienungsanleitung beachten).
* Manuell werden Devices für zusätzliche Kanäle mit Hilfe der Befehle <code>get <device> mcEndpoints</code> und <code>get <device> mcCapability <chid></code> aus der Class MULTI_CHANNEL ermittelt bzw. einzeln über autocreate angelegt (Details und Beispiel siehe {{Link2CmdRef|Anker=ZWaveget}}). Mit dem Befehl <code>set <device> mcCreateAll</code> werden automatisch alle Kanäle des Gerätes durch autocreate als eigene Devices in FHEM angelegt.

=== Wie kann man die SDK-Version eines Gerätes herausfinden? ===
Mit FHEM alleine kann eine [[#Grobermittlung|Grobermittlung]] der SDK-Version vorgenommen werden, die aber für einige Zwecke bereits ausreichend ist. Soll eine [[#Detailermittlung|Detailermittlung]] der genauen SDK-Version erfolgen, dann müssen die mit FHEM ermittelten Werte anhand externer Quellen übersetzt werden.
==== Grobermittlung ====
Der Befehl <code><nowiki>get <ZWDongle> nodeInfo <dezimale nodeId></nowiki></code> liefert das Reading <code><nowiki>nodeInfo_<dezimale nodeId></nowiki></code> zurück.
Die Angabe im Reading hinter <code>ProtocolVers:</code> lässt grobe Rückschlüsse zu. Mögliche (bekannte) Werte:
* <code>2</code> -> bspw. keine Explorer Frames, keine SUC-Unterstützung (veraltet, keine bekannten Geräte mehr im Handel)
* <code>SDK5.0x+4.2x</code> -> bspw. keine Explorer Frames, teilweise SUC-Unterstützung
* <code>SDK4.5x+6.0x</code> -> bspw. Explorer Frames- und SUC-Unterstützung (Reading-Wert wird auch bei SDK 6.5x = Z-Wave Plus angezeigt)
==== Detailermittlung ====
Durch den Befehl <code><nowiki>get <name> version</nowiki></code> kann man die ZWave-Protokoll-Version von Geräten und Controller abfragen. Mit Unterstützung von Übersetzungstabellen
* http://wiki.micasaverde.com/index.php/ZWave_Protocol_Version
* Suche nach sdkids.xml in einer Suchmaschine
kann aus der Protokoll-Version das genutzte SDK festgestellt werden.

Beispielsweis entspricht das Reading eines Gerätes "Lib 6 '''Prot 2.64''' App 1.6" dem SDK 5.02 Patch 2 oder eines Controller "Z-Wave '''3.41''' STATIC_CONTROLLER" dem SDK 6.02.00.

HINWEIS: Bei der Vergabe der Protokoll-Version und zugehörigem SDK gibt es keine erkennbare Logik: Eine höhere Protokoll-Version steht nicht notwendig für eine höheres SDK.

=== Wie kann eine verschlüsselte Kommunikation unter Nutzung der Command Class SECURITY eingerichtet werden? ===
{{Randnotiz|RNText=FHEM unterstützt derzeit ausschließlich SECURITY 1 und nicht das mit dem SDK 6.7 neu eingeführte SECURITY 2 (S2). Soweit bekannt, sind S2-Geräte rückwärtskompatibel zu SECURITY 1.}}
Die verschlüsselte Kommunikation zwischen Controller und Endgerät setzt eine secure-Inklusion voraus. Bereits mit der Inklusion wird entschieden, ob die Kommunikation von Controller und Endgerät dauerhaft verschlüsselt oder unverschlüsselt erfolgt. Ist ein Gerät bereits normal inkludiert und entscheidet man sich nachträglich für eine verschlüsselte Kommunikation, so ist das nur möglich, indem das Gerät exkludiert und dann wieder secure inkludiert wird.

Ob die Verschlüsselung bei einem Gerät mit Unterstützung der Command Class SECURITY genutzt werden soll, sollte genau überlegt werden. Die Verschlüsselung führt zu einem deutlich größeren Funkverkehr zur Ausführung eines Befehls und teilweise auch zu spürbaren Latenzen.

Vorarbeiten:
* Das Perl-Modul Crypt-Rijndael muss installiert sein.
* Das Attribut <code>networkKey</code> muss mit einem 32-Zeichen langen Hexzahl beim ZWDongle angelegt werden. Dieser Schlüssel sollte nicht veröffentlicht werden und auch zusätzlich separat (bspw. auf Papier) festgehalten werden. Bei Verlust des Attributes und Schlüssels ist eine Kommunikation nur nach erneuter Inklusion möglich.

Ablauf der secure-Inklusion:
* Controller in den Modus zur secure-Inklusion schalten:
: <code>set <ZWDongle> addNode onSec</code> für die Standard-secure-Inklusion
: oder alternativ
: <code>set <ZWDongle> addNode onNwSec</code> für die Nework-Wide-secure-Inklusion
* Gerät gemäß Handbuch in den Modus zur secure-Inklusion bringen (teilweise ist jeweils für secure- und normale Inklusion ein anderes Vorgehen notwendig!)
* Das Gerät sollte jetzt automatisch erkannt und das FHEM-Device durch <code>autocreate</code> angelegt werden. Die secure-inkludierten Geräte haben ein zusätzliches Attribut <code>secure_classes</code> in dem die Command Classes deren Kommunikation verschlüsselt abläuft aufgelistet sind. Nicht in diesem Attribut, aber in <code>classes</code> aufgeführte Command Classes wickeln die Kommunikation weiterhin unverschlüsslt ab.
* Inklusionsmodus des Controllers ausschalten:
: <code>set <ZWDongle> addnode off</code>
* Das Vorgehen in FHEM unterscheidet sich von nun an nicht von normal (unverschlüsselt) inkludierten Geräten. Die Verschlüsselung läuft für den Anwender transparent ab. Darum anschließend [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] vornehmen.

=== Wie kann man ohne Exklusion Nodes des Controllers löschen? ===
HINWEIS: Geräte sollten grundsätzlich immer über eine Exklusion aus der Nodelist des Controllers gelöscht werden. Das nachfolgend geschilderte Vorgehen ist nur in Sonderfällen (bspw. Gerätedefekt, gebraucht gekauftes Gateway) anzuwenden.

Nicht mehr zu erreichende/reagierende Nodes (Geräte) können manuell mit dem Befehl <code>removeFailedNode</code> gelöscht werden. Dazu muss sich der betroffene Node auf der FailedNodeList des Controllers befinden. Auf die FailedNodeList kommen netzbetriebene Geräte automatisch, wenn sie vom Controller nicht mehr per Funk erreicht werden. Batteriebetriebene Geräte müssen manuell auf die FailedNodelist gesetzt werden, da der Controller nicht feststellen kann, ob sie nur langfristig "schlafen".

Der Befehl <code>removeFailedNode</code> löscht nur Nodes auf der FailedNodeList, die erst vor Kurzem nicht erreicht werden konnten. Darum muss sowohl das manuelle Verschieben von batteriebetriebenen als auch das Nicht-Erreichen der netzbetriebenen Geräte erst Kurz vor Aufruf des <code>removeFailedNode</code>-Befehls erfolgt sein.

Vorgehensweise für den Node <NodeId>:
# An den betroffenen Node eine Telegramm mit <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> verschicken, um ihn auf FailedNodeList zu verschieben bzw. Zeitstempel zu aktualisieren.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und kann mit <code>removeFailedNode</code> gelöscht werden.
# Befehl zum Löschen des Nodes absetzen: <code><nowiki>set <ZWDongle> removeFailedNode <NodeId></nowiki></code>. Der Befehl testet vor dem Löschen noch einmal, dass der Node nicht erreicht werden kann und entfernt erst dann den Node.
# Prüfen, der Ergebnisse des <code>removeFailedNode</code>-Befehls im Log oder [[Event monitor]]. Die verschiedenen Ergebnisse werden durch die in der {{Link2CmdRef}} dokumentierten Events signalisiert. Tritt das Ergebnis "failedNodeRemoveProcessBusy" mehrfach hintereinander auf, muss das ZWDongle kurz stromlos gemacht werden.
# Prüfen, ob der Node nicht mehr auf der Nodelist des Controllers ist: <code><nowiki>get <ZWDongle> nodeList</nowiki></code>

siehe auch {{Link2Forum|Topic=32823|Message=292626}}

=== Wie ist der einfachste Weg ein (defektes) Gerät durch ein gleiches Ersatzgerät auszutauschen? ===
Tauscht man ein defektes Gerät durch ein gleiches Ersatzgerät und inkludiert das Ersatzgerät per <code>addNode</code>, so erhält das Ersatzgerät eine neue NodeId. Soll das Ersatzgerät die gleiche NodeId wie das alte Gerät erhalten, so muss statt <code>addNode</code> der Befehl <code>replaceFailedNode</code> zur Inklusion des Ersatzgerätes (=gleiches Modell) verwendet werden.

Vorgehensweise für den Node <NodeId>:
# sofern das alte Gerät noch ansprechbar ist, die Konfiguration und Assoziationen abfragen, damit man die Werte im Ersatzgerät einfach wieder setzen kann:
## <code><nowiki>get <device> configAll</nowiki></code>
## <code><nowiki>get <device> associationAll</nowiki></code>
# defektes Gerät aus- und neues einbauen
# Befehl <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> absetzen, damit das Dongle die NodeId auf die FailedNodeList setzt.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und das Ersatzgerät kann mit <code>replaceFailedNode</code> inkludiert werden.
# <code><nowiki>set <zwdongle> replaceFailedNode <NodeId></nowiki></code> für die NodeId des defekten Gerätes aufrufen und das Ersatzgerät in den Inklusionsmodus bringen
# Korrekte Inklusion prüfen und beim alten Aktor ausgelesene Werte beim neuen Aktor wieder setzen.

=== Bei einer Inklusion wird eine durch Exklusion/removeFailedNode frei gewordenen NodeId nicht mehr vergeben. Ist das korrekt? ===
Ja, das ist richtig.

Bei der Inklusion über addNode vergibt der Controller die höchste bisher noch nie verwendete NodeID. Durch Exklusion oder removeFailedNode frei gewordene NodeIDs werden hierbei zunächst nicht erneut vergeben. Diese frei gewordenen NodeIds werden bei Inklusionen in aufsteigender Reihenfolge erst wieder vergeben, nachdem die höchste verfügbare NodeId (232?) inkludiert wurde. Sie sind somit grundsätzlich nicht verloren.

=== Welche Funktion haben die XML-Config-Dateien in FHEM? ===
In den XML-Config-Dateien sind Informationen zu einzelnen ZWave-Geräten enthalten, die der Erleichterung der Gerätenutzung und -einbindung in FHEM dienen. Dies sind unter anderem Erläuterungen zu den Parameternummer/-werten, Assoziationsgruppen und Besonderheiten eines Gerätes. Ob eine zum Zwave-Gerät passende XML-Config Datei existiert, wird im Rahmen der Inklusion oder durch manuellen Aufruf des Befehls <code>get <name> model</code> ermittelt. Wird eine passende XML-Config-Datei gefunden, wird sie automatisch in FHEM eingebunden. Das Reading <code>modelConfig</code> enthält dann den zugehörigen XML-Config-Dateinamen. Stehen keine XML-Config-Informationen bereit, enthält das Reading <code>modelConfig</code> den Wert "unknown". Die Funktionsfähigkeit von FHEM mit ZWave-Geräten ist auch bei fehlender XML-Config-Datei gegeben. Es gibt dadurch keine funktionalen Einschränkungen in FHEM; es entfallen "nur" Erleichterungen und es sind unter Umständen mehr manuelle Schritte bei der Gerätenutzung/-einbindung notwendig.

Erleichterungen bei vorhandener XML-Config für ein ZWave-Gerät:
* Bei der Inklusion:
** Assoziationen mit dem Controller bei von Gruppe 1 abweichenender Assoziationsgruppe werden automatisch gesetzt
** vom NIF nicht gemeldete, aber vom Gerät unterstützte Classes, werden im Attribut <code>classes</code> ergänzt
* Bei der Konfiguration:
** die Parameternummern stehen als configXY-Befehle zur Verfügung und werden mit Hilfetexten -auch zu den Parameterwerten- in der Detailansicht des FHEM-Device erläutert.

HINWEIS: Bitte auch bei vorhandener XML-Config-Datei nach der Inklusion und bei der Konfiguration die Assoziationen und Parameter prüfen. Von den eigenen Vorstellungen abweichende Vorgaben oder gar Fehler in der Config-Datei können nie ausgeschlossen werden. Fehler bitte im Forum ({{Link2Forum|Area=ZWave}}) melden.

=== Wie können fehlende XML-Config-Informationen für mein ZWave-Gerät in FHEM eingebunden werden? ===
Die XML-Config-Informationen von FHEM sind in folgenden Dateien im Ordner fhem/FHEM/lib gespeichert:
* openzwave_manufacturer_specific.xml
* openzwave_deviceconfig.xml.gz
* fhem_zwave_deviceconfig.xml.gz
Die in den Dateien enthaltenen Informationen beruhen in großen Teilen auf Daten von openzwave und übernehmen daher das openzwave-Datenformat, das unter https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices näher beschrieben wird.

Die Datei "openzwave_manufacturer_specific.xml" enthält die eindeutige Kennung des ZWave-Gerätes, die in FHEM nach Aufruf des Befehls <code>get <name> model</code> im Reading <code>modelId</code> des FHEM-ZWave-Devices steht. Weiterhin wird der Klartextname dieses Gerätes, der im Reading <code>model</code> angezeigt werden soll, festgelegt. Zudem wird der Dateiname der eigentlichen XML-Config-Datei für das ZWave-Gerät angegeben, der später informativ im Reading <code>modelConfig</code> steht.

Die Dateien "openzwave_deviceconfig.xml.gz" und "fhem_zwave_deviceconfig.xml.gz" enthalten in komprimierter Form die eigentlichen XML-Config-Dateien für die ZWave-Geräte. FHEM durchsucht beide Dateien nach der passenden XML-Config-Datei. Ist in beiden Dateien eine XML-Config für ein Gerät vorhanden, so werden die XML-Daten aus der "fhem_zwave_deviceconfig.xml.gz" bevorzugt.

Falls ein ZWave-Gerät von FHEM nicht erkannt wird, bitte auf folgenden Seiten nachschauen, ob es schon XML-Config-Dateien gibt, die nur nicht in FHEM eingebunden sind:
# https://github.com/OpenZWave/open-zwave/tree/master/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# https://github.com/jeedom/plugin-openzwave/tree/master/ressources/openzwave/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# http://www.cd-jackson.com/index.php/zwave/zwave-device-database
Sofern auf den genannten Seiten Daten vorhanden sind, postet eine Aktualisierungsbitte mit genauem Link zur entsprechenden Seite im Forum ({{Link2Forum|Area=ZWave}}).

Gibt es auf keiner der Seiten Infos zu dem Gerät, dann entsprechend https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices die XML-Config-Datei für das Gerät erstellen und unkomprimiert zusammen mit der zu ergänzenden Info für die Datei "openzwave_manufacturer_specific.xml" im Forum ({{Link2Forum|Area=ZWave}}) zur Verfügung stellen.

=== Wie führt man eine Komplett-Sicherung der ZWave-Installation durch? ===
Zu einer Komplett-Sicherung der ZWave-Konfiguration gehören:

1. [[Backup]] der FHEM-Installation
::'''und'''
2. Backup des NVRAM des Controllers

Es genügt nicht nur die FHEM-Installation/Konfiguration zu sichern, da der Controller im NVRAM Daten über HomeID, NodeIDs usw. speichert, die in der FHEM-Installation nicht enthalten sind und auch nicht durch FHEM rekonstruierbar sind.

zu 2.) Backup des NVRAM des Controllers

Einige Controllerhersteller bieten eine eigenständige Software zum Backup/Restore an (siehe Hinweise zu den Controllern unter [[#Autocreate_des_Gateways]]).

FHEM kann mit den ZWDongle-Befehlen <code>backupCreate</code> das NVRAM der Controller sichern und mit <code>backupRestore</code> zurückschreiben. Da das Speicherlayout des NVRAM unter anderem von Controller-Hersteller, SDK und Firmwareversion abhängig sein kann, sollte man die Sicherung und Wiederherstellung des eigenen Controllers (auf eigenes Risiko) testen und sinnvollerweise einen gleichen Ersatzcontroller wie den Controller des Produktivsystem besitzen. Erfolgreiche Sicherung/Wiederherstellung wurde im Forum von den ZWavePlus-Controllern UZB1 (256k), Razberry (256k), Vision ZU 1401-5 EU (128k)und AEOTEC Z-Stick Gen5 (256k) berichtet.
(Weitergehende Infos - neben der {{Link2CmdRef}} - im Forum: {{Link2Forum|Topic=52364}}, {{Link2Forum|Topic=52914}}, {{Link2Forum|Topic=53023}})

=== Wie kann ich zur Fortentwicklung der ZWave-Module beitragen? ===
* Erfolgreichen Einsatz von neuen/bisher nicht gemeldeten ZWave-Geräten im Forum mitteilen
* Codeschnipsel und Ideen im Forum posten
* Fehler und Probleme im Forum melden
* [[How_to_write_a_patch|Patches]] für 00_ZWDongle.pm und 10_ZWave.pm erstellen
* Wiki: Ergänzungen und Korrekturen vornehmen; neue Geräte ins Wiki aufnehmen; Codeschnipsel und Beispiele einpflegen

=== Wie wird ein fehlendes Kernelmodul (Fritzbox) eingebunden? ===
Auf der Fritzbox (und evtl. auch anderen Systemen) muss sichergestellt werden, dass das Kernelmodul für das Gateway geladen wird. Ansonsten scheitert die Einbindung des Gateways in FHEM.

Für den Aeon Labs Z-Stick muss beispielsweise auf der Fritzbox das Kernelmodul <code>cp2101.ko</code> geladen werden.
Diese Datei ist bei einer [[FHEM und FritzBox 7390]] Installation über das Image von [http://www.fhem.de fhem.de] bereits enthalten.
Um den Aeon Labs Z-Stick zu verwenden, muss dieses Kernelmodul vor oder beim Starten des FHEM-Servers geladen sein. Dies erreicht man durch einen Eintrag in der Datei <code>startfhem</code>.

Die entsprechende Zeile kann direkt unterhalb der modprobe Anweisungen eingefügt werden.
insmod $home/lib/cp2101.ko

Nach einem FHEM-Neustart sollte das Gateway (der USB Stick) nun erkannt werden.

=== Wie ist der Aufbau der Z-Wave Messages bzw. wie finde ich bei einem Sendefehler die NodeId des Empfängers heraus? ===

Es könnte natürlich hin und wieder vorkommen, dass man im FHEM-Log folgende Fehler vorfindet:

<code><nowiki>ZWDongle_ProcessSendStack: no ACK, resending message 010a00130603320110259277</nowiki></code>

In diesem Fall gab es aus irgendeinem Grund einmalig das Problem, dass der Empfang einer Nachricht vom Empfänger nicht bestätigt wurde.
Will man dem auf die Spur kommen, so wäre es natürlich von Vorteil, die NodeId des Empfängers herauszufinden. Also muss man sich die Message näher anschauen:

<code><nowiki>010a00130603320110259277</nowiki></code>
* 01: data to controller
* 0a: length of msg
* 00: ?
* 13: ZW_SEND_DATA
* 06: NodeId

* 03: length of msg
* 32: Command Class 32 (METER, siehe %zwave_class in 10_ZWave.pm)
* 01: METER get scale command
* 10: scale parameter

* 25: send flags, explorer frames on
* 92: callbackId (um ACK zu identifizieren)
* 77: checkSum

In diesem Fall hat der Z-Wave-Controller 01 eine Nachricht an die NodeId 06 geschickt, welche vom Node nicht bestätigt wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components|!]]
[[Kategorie:868MHz]]

DevIo

2020-07-20T16:54:10Z

Krikan:

{{Infobox Modul
|ModPurpose=Dienstfunktionen für die Kommunikation per serieller Schnittstelle (USB/RS232), TCP/IP-Verbindung oder UNIX-Socket
|ModType=u
|ModForumArea=FHEM Development
|ModTechName=DevIo.pm
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}

Das Modul [[DevIo]](.pm) ist für Modulentwickler gedacht, um Daten zwischen einem FHEM-Modul und bspw. einer seriellen Schnittstelle, einer TCP/IP-Verbindung oder einem UNIX-Socket auszutauschen. Es übernimmt dabei die gesamte Verbindungsverwaltung und Aufrechterhaltung innerhalb von FHEM und nimmt dem Modulentwickler daher die gesamte Verbindungsverwaltung (Aufbau, Initialisierung, Neu-Verbindung bei Abbruch, etc.) ab. Es berücksichtigt dabei Besonderheiten zwischen Unix-basierten Betriebssystemen und Windows.

Es dient dabei lediglich dem Zweck einen Kommunikationskanal für eine Definition in FHEM zu etablieren und Daten darüber auszutauschen. Die Interpretation der empfangenen Daten obliegt dem Modul, welches die Verbindung via DevIo geöffnet hat. Die ausgetauschten Daten werden durch DevIo nicht verändert.

= Allgemeine Funktionsweise =
DevIo hat das Ziel eine besonders einfache Möglichkeit für Modulentwickler zu schaffen, um einen dauerhaften Kommunikationskanal mit einem Hardware- oder Netzwerk-Gerät bzw. Service zu etablieren. Um eine Verbindung aufzubauen muss zunächst die Gegenstelle bekannt sein. Dazu muss vor dem Verbindungsaufbau in dem Internal <code>$hash->{DeviceName}</code> der jeweiligen Definition das Ziel hinterlegt werden. Dies kann bspw. eine serielle Schnittstelle sein (z.B. "/dev/ttyUSB0" oder "COM1" unter Windows) oder eine TCP/IP-Gegenstelle (z.B. "192.168.1.100:1012") sein. Eine detaillierte Aufstellung der möglichen Verbindungsarten und deren Angabe in <code>$hash->{DeviceName}</code> gibt es im folgenden Kapitel [[#Unterstützte Verbindungsarten|Unterstützte Verbindungsarten]].

Die Funktion [[#DevIo_OpenDev()|DevIo_OpenDev()]] baut dabei die entsprechende Verbindung für eine einzelne Definition in Form eines Filedeskriptors auf und registriert diesen in dem globalen Hash <code>%selectlist</code><ref name="selectlist">[[DevelopmentModuleIntro#Wichtige_globale_Variablen_aus_fhem.pl|Development Module Introduction]] - Wichtige globale Variablen aus fhem.pl</ref>. Sobald die Verbindung erfolgreich aufgebaut wurde, kann eine, durch den Modulautor mitgelieferte, Initialisierungs-Funktion ausgeführt werden, um die Kommunikation zu initialiseren (bspw. das Senden einer Authentifizierungs-/Loginsequenz oder aktivieren der Hardware, etc.).

FHEM (respektive fhem.pl) prüft nun regelmäßig, ob Daten zum Lesen bereitstehen (also Daten empfangen wurden). Ist dies der Fall, so wird die [[DevelopmentModuleIntro#X_Read|X_Read()]]-Funktion des zugehörigen Moduls für die hinterlegte Definition aufgerufen. Hier können die Daten durch den Aufruf von [[#DevIo_SimpleRead()|DevIo_SimpleRead()]] nun eingelesen und verarbeitet werden. Das Senden von Daten ist durch den Aufruf von [[#DevIo_SimpleWrite()|DevIo_SimpleWrite()]] sehr einfach möglich.

Sollte die Verbindung zusammenbrechen (USB-Gerät abgezogen, Gerät per Netzwerk nicht mehr erreichbar, etc.), so erkennt dies DevIo und registriert die Definition in <code>%readyfnlist</code><ref name="selectlist" />. FHEM führt nun regelmäßig die [[DevelopmentModuleIntro#X_Ready|X_Ready()]]-Funktion des zugehörigen Moduls
aus um zu prüfen, ob die Verbindung wieder aufgebaut werden kann. Hier wird nun durch die Ausführung von [[#DevIo_OpenDev()|DevIo_OpenDev()]] versucht die Verbindung wieder herzustellen.

Sobald die Verbindung nicht mehr benötigt wird, oder FHEM bspw. beendet wird, kann die Verbindung via [[#DevIo_CloseDev()|DevIo_CloseDev()]] sauber geschlossen werden.

= Unterstützte Verbindungsarten =

Die folgenden Verbindungsarten können via DevIo realisiert werden.

{| class="wikitable"
|-
! Verbindungsart !! Beispielangabe in<br><code>$hash->{DeviceName}</code> !! Beschreibung
|-
| style="vertical-align:top" | '''Serielle Schnittstelle'''
| style="vertical-align:top" |
* <code>/dev/ttyUSB0</code>
* <code>/dev/ttyUSB0@9600</code>
* <code>/dev/ttyUSB0@9600,7,E,2</code>
* <code>/dev/ttyUSB0@directio</code>
* <code>COM1@9600</code>
||
Durch Angabe eines Geräts in Form eines Gerätepfad (UNIX-basierte Betriebssysteme) oder der Schnittstellenbezeichnung aus Windows kann eine serielle Verbindung geöffnet werden. Der Gerätename kann zusätzliche Angaben zu Baudrate, Datenbits, Parität und Stoppbits enthalten um die Verbindung entsprechend zu konfiguieren. Diese Angaben sind durch ein "@" getrennt an die Gerätebezeichnung angehangen:

Schematische Syntax: <code>''<font color="grey"><Gerät></font>'''''@'''''<Baudrate>''''','''''<Datenbits>''''','''''<Parität>''''','''''<Stopbits>''</code>

* <code><Baudrate></code> - Eine gültige Taktfrequenz (Symbole pro Sekunde) mit der die Schnittstelle geöffnet werden soll (Beispiel: <code>9600</code>, <code>14400</code>, <code>115200</code>, ...)
* <code><Datenbits></code> - Die Anzahl an Datenbits (7 oder 8 Datenbits). Standardwert sofern nicht angegeben sind 8 Datenbits.
* <code><Parität></code> - Die zu verwendende Parität, sofern benötigt. Dabei bedeutet der Wert <code>N</code> keine Parität, <code>O</code> bedeutet ungleiche Parität (odd) und <code>E</code> bedeutet gleiche Parität (even) Standardwert sofern nicht angegeben ist <code>N</code> (keine Parität).
* <code><Stopbits></code> - Die Anzahl an zu verwendenden Stopbits (0, 1 oder 2 Stopbits). Standardwert sofern nicht angegeben sind 0 Stopbits.

Wenn man unter Unix-basierten Betriebssystemen die Schnittstelle nicht explizit konfiguriert öffnen möchte, sondern das Gerät direkt öffnen möchte (und damit die OS-Einstellungen verwendet), kann man durch Angabe von <code>@directio</code> die Konfiguration der Schnittstelle umgehen und das Gerät direkt öffnen:

Bsp: <code><font color="grey">/dev/ttyUSB0</font>@directio</code>

Unter Windows verwendet man als Gerätename die entsprechende Schnittstellenbezeichung wie bspw. <code>COM1</code>, <code>COM2</code>, usw.
|-
| style="vertical-align:top" | '''TCP/IP-Verbindung'''
| style="vertical-align:top" |
* <code>192.168.1.2:1012</code>
* <code>raspberry:5000</code>
||
Durch Angabe eines Hostnamen oder IP-Adresse und einem Port, kann eine TCP-Verbindung aufgebaut werden. Dazu muss Hostname/IP-Adresse und Port in folgendem Schema angegeben werden:

Schematische Syntax: <code>''<Hostname/IP-Adresse>''''':'''''<Port>''</code>

* <code><Hostname/IP-Adresse></code> - Der Hostname oder die IP-Adresse des zu verbindenden Gerätes/Server.
* <code><Port></code> - Der Zielport zu dem sich verbunden werden soll (0-65535).

Die Verbindung kann optional verschlüsselt via SSL/TLS aufgebaut werden. Dazu muss das Internal <code>$hash->{SSL}</code> auf 1 gesetzt werden.
|-
| style="vertical-align:top" | '''UNIX-Socket'''
| style="vertical-align:top" |
* <code>UNIX:SEQPACKET:/var/tmp/me_avm_home_external.ctl</code>
* <code>UNIX:STREAM:/var/socket/con</code>
||
Durch Angabe eines Pfads zu einem UNIX-Domain-Socket kann eine Kommunikation mit einem anderen Prozess aufgebaut werden (Inter-Prozess-Kommunikation). Man kann den Socket dabei paketorientiert ("SEQPACKET") oder als Stream ("STREAM") öffnen.

Schematische Syntax: <code>UNIX:''<Typ>'':''<Pfad>''</code>

* <code><Typ></code> - Der Typ des Sockets. Für einen paketorientierten Socket ist hier <code>SEQPACKET</code> zu verwenden, für einen streamorientierten Socket <code>STREAM</code>. Der Typ muss immer mit angegeben werden.
* <code><Pfad></code> - Der Pfad im Dateisystem zu dem gewünschten UNIX-Socket
|-
| style="vertical-align:top" | '''FHEM IO-Modul'''
| style="vertical-align:top" |
* <code>FHEM:DEVIO:Firmata_SerielleSchnittstelle@9600</code>
||
Beschreibung siehe {{Link2Forum|Topic=46276}}
|}

= Wichtige Internals zur Konfiguration =

Da DevIo ausschließlich definitionsbezogen arbeitet, erfolgt eine Konfiguration von DevIo über Internals, die im übergebenen <code>$hash</code> gesetzt werden müssen (oder können). Hiermit lässt sich das Verhalten von DevIo entsprechend beeinflussen.

Hier eine Auflistung von allen Internals, die DevIo beeinflussen:

{| class="wikitable"
|-
! style="min-width: 13em;" | Internal !! Beschreibung
|-
| style="vertical-align:top" | <code>$hash->{DeviceName}</code>

''mandatory''
| style="vertical-align:top" | Die Gegenstelle zu der eine Verbindung aufgebaut werden soll. Die möglichen Werte und deren Syntax ist im Kapitel [[#Unterstützte Verbindungsarten|Unterstützte Verbindungsarten]] genauer beschrieben.
|-
| style="vertical-align:top" | <code>$hash->{nextOpenDelay}</code>

''optional''
|| Die Zeit in Sekunden, welche im Falle eines Verbindungsabbruchs gewartet werden soll, bevor ein erneuter Verbindungsversuch stattfindet.

Standardwert: 60 Sekunden
|-
| style="vertical-align:top" | <code>$hash->{TIMEOUT}</code>

''optional''
|| Die maximale Zeit in Sekunden für den Aufbau einer TCP/IP-Verbindung. Sollte diese Zeit überschritten werden, bricht der Verbindungsaufbau mit einer Fehlermeldung ab.

'''WICHTIG:''' Sollte beim Aufruf von [[#DevIo_OpenDev|DevIo_OpenDev()]] keine Callback-Funktion parametrisiert sein und die Gegenstelle antwortet beim Verbindungsaufbau nicht, so wird FHEM für die Dauer von <code>$hash->{TIMEOUT}</code> blockiert.

Standardwert: 3 Sekunden
|-
| style="vertical-align:top" | <code>$hash->{SSL}</code>

''optional''
|| Flag (0 oder 1), ob eine TCP/IP-Verbindung verschlüsselt (via SSL/TLS) aufgebaut werden soll. Wenn dieses Flag auf 1 gesetzt ist, wird nach erfolgtem Verbindungsaufbau eine SSL-Session initiiert.

Standardwert: 0 (keine Verschlüsselung)
|-
| style="vertical-align:top" | <code>$hash->{devioLoglevel}</code>

''optional''
|| Das Loglevel in dem <code>disconnected</code>/<code>reappeared</code> Meldungen geloggt werden sollen. Standardmäßig werden solche Verbindungsabbrüche (<code>disconnected</code>/<code>reappeared</code>) im Loglevel 1 geloggt. Die erfolgreiche Erstverbindung wird standardmäßig im Loglevel 3 geloggt. Durch das Setzen von <code>$hash->{devioLoglevel}</code> werden diese Meldungen allesamt in dem gesetzten Loglevel ausgegeben. Details dazu siehe {{Link2Forum|Topic=61970}}.

Standardwert: ''[leer]''
|}

= Die Funktionen =
== DevIo_OpenDev() ==
:<syntaxhighlight lang="perl">$error = DevIo_OpenDev($hash, $reopen, $initfn);
$error = DevIo_OpenDev($hash, $reopen, $initfn, $callback);</syntaxhighlight>

Die Funktion DevIo_OpenDev() öffnet eine Verbindung zu dem Endpunkt der in <code>$hash->{DeviceName}</code> hinterlegt ist. Sobald die Verbindung erfolgreich hergestellt wurde, wird die Funktion <code>$initfn</code> ausgeführt, sofern gesetzt, um die Verbindung zu initialisieren. Sofern eine TCP/IP-Verbindung hergestellt wird, kann eine optionale Callback-Funktion <code>$callback</code> übergeben werden um den Verbindungsaufbau non-blocking durchzuführen.

Der Rückgabewert enthält im Fehlerfall eine entsprechende Fehlermeldung. Im Erfolgsfall wird <code>undef</code> zurückgegeben. Sofern eine TCP/IP-Verbindung hergestellt wird und eine Callback-Funktion <code>$callback</code> übergeben wurde, wird immer <code>undef</code> zurückgegeben, da ein evtl. Fehler an diese Callback-Funktion nach dem erfolgten Verbindungsversuch mitgeteilt wird.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
| style="vertical-align:top" | Die Hash-Referenz der Definition, für die eine Verbindung geöffnet werden soll
|-
| style="vertical-align:top" | '''<code>$reopen</code>'''

''mandatory<br>can be <code>undef</code>''
| style="vertical-align:top" | Flag (0 oder 1), ob es sich um einen erneuten Verbindungsversuch handelt (im Rahmen der [[DevelopmentModuleIntro#X_Ready|X_Ready()]]-Funktion). Sollte es der erste Verbindungsversuch sein, so muss dieser Parameter den Wert 0 besitzen.
|-
| style="vertical-align:top" | '''<code>$initfn</code>'''

''mandatory<br>can be <code>undef</code>''
|| Der Name (als Zeichenkette) oder die Referenz auf eine Modulfunktion, welche optional nach dem erfolgreichen Aufbau/Wiederaufbau der Verbindung ausgeführt werden soll. Im Rahmen dieser Funktion kann weiterführende Kommunikation über die aufgebaute Verbindung erfolgen um zum Beispiel eine Loginsequenz oder eine Konfiguration der Gegenseite vorzunehmen, bevor die Verbindung allgemein benutzt werden kann.

Die Funktion welche in <code>$initfn</code> angegeben wurde, wird mit folgenden Parametern aufgerufen:

<syntaxhighlight lang="perl">$ret = MYMODULE_InitFn($hash)</syntaxhighlight>

Wenn der Rückgabewert <code>$ret</code> einen Inhalt zurückliefert, wird die Initialisierung als fehlgeschlagen bewertet und die Verbindung wieder geschlossen um einen neuen Verbindungsversuch zu einem späteren Zeitpunkt zu versuchen. Der genaue Inhalt von <code>$ret</code> ist dabei unerheblich, da er nicht weiterverwendet wird. Die Rückgabewerte <code>0</code> oder <code>undef</code> signalisieren dabei eine erfolgreiche Initialisierung.

Beispiel:
* <code>"MYMODULE_InitFn"</code>
* <code>\&MYMODULE_InitFn</code>
|-
| style="vertical-align:top" | '''<code>$callback</code>'''

''optional''
|| Der Name (als Zeichenkette) oder die Referenz auf eine Modulfunktion, welche aufgerufen werden soll um evtl. Fehlermeldungen beim Verbindungsaufbau einer TCP/IP-Verbindung an das Modul zurückzuliefern. Wenn eine Callback-Funktion gesetzt ist, erfolgt der Verbindungsaufbau non-blocking. Andernfalls wartet DevIo_OpenDev() bis die Verbindung steht bzw. ein Fehler auftritt (z.B. Timeout).

Die Funktion welche in <code>$callback</code> angegeben wurde, wird mit folgenden Parametern aufgerufen:

<syntaxhighlight lang="perl">MYMODULE_ConnectCallbackFn($hash, $error)</syntaxhighlight>

Das Argument <code>$error</code> enthält dabei eine Fehlermeldung als Zeichenkette welche die aufgetretene Fehlermeldung enthält. Der Rückgabewert der Callback-Funktion wird nicht ausgewertet und ist daher irrelevant.

Beispiel:
* <code>"MYMODULE_ConnectCallbackFn"</code>
* <code>\&MYMODULE_ConnectCallbackFn</code>
|}

Rückgabewert:
{| class="wikitable"
|-
! Rückgabe!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$error </code>''' || Eine Fehlermeldung als Zeichenkette, sollte der Verbindungsaufbau fehlschlagen. Im Erfolgsfall wird <code>undef</code> zurückgegeben.

Wenn es sich um eine TCP/IP-Verbindung handelt und eine Callback-Funktion als Parameter <code>$callback</code> angegeben wurde, wird immer <code>undef</code> zurückgegeben, andernfalls erfolgt der Verbindungsaufbau blocking und eine evtl. Fehlermeldung wird als Rückgabewert zurückgegeben. Im Erfolgsfall wird <code>undef</code> zurückgegeben.
|}

== DevIo_IsOpen() ==
:<syntaxhighlight lang="perl">$status = DevIo_IsOpen($hash);</syntaxhighlight>

Die Funktion DevIo_IsOpen() prüft, ob eine Verbindung für <code>$hash</code> geöffnet ist. Falls ja, wird das zugehörige IO-Objekt zurückgegeben, andernfalls <code>undef</code>.

Diese Funktion kann dabei direkt in typischen if-Konstrukten verwendet werden um zu prüfen, ob eine Verbindung für die jeweilige Definition geöffnet oder geschlossen ist.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
|| Die Hash-Referenz der Definition, deren Verbindung geprüft werden soll.
|}

Rückgabewerte:
{| class="wikitable"
|-
! Rückgabewert !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$status</code>''' || Der Status der Verbindung. Wenn eine Verbindung besteht, wird das zugehörige IO-Objekt zurückgegeben. Falls keine Verbindung besteht, wird <code>undef</code> zurückgegeben.
|}

== DevIo_SimpleRead() ==
:<syntaxhighlight lang="perl">$buf = DevIo_SimpleRead($hash);</syntaxhighlight>

Die Funktion DevIo_SimpleRead() liest anstehende Daten für die Verbindung von <code>$hash</code> ein und gibt diese zurück.

Sollte beim Versuch Daten zu lesen eine geschlossene Verbindung erkannt werden, so wird <code>undef</code> zurückgegeben und die Verbindung geschlossen. Es erfolgt zu einem späteren Zeitpunkt (siehe Internal <code>$hash->{nextOpenDelay}</code> aus Kapitel [[#Wichtige Internals zur Konfiguration|Wichtige Internals zur Konfiguration]]) ein neuer Verbindungsversuch.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
|| Die Hash-Referenz der Definition, für deren Verbindung aktuell anstehende Daten gelesen werden sollen.
|}

Rückgabewert:
{| class="wikitable"
|-
! Rückgabe!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$buf</code>''' || Die zu lesenden Daten als Zeichenkette. Im Falle eines Verbindungsabruchs wird <code>undef</code> zurückgegeben.
|}

== DevIo_SimpleReadWithTimeout() ==
{{Randnotiz|RNTyp=Warn|RNText=<u>'''ACHTUNG:'''</u>

Bei der Benutzung von DevIo_SimpleReadWithTimeout() wird FHEM für die Dauer von bis zu <code>$timeout</code> Sekunden blockiert, sollten keine Daten bis dahin zum Lesen bereitstehen. -> DevIo_SimpleReadWithTimeout() NICHT NUTZEN!}}
:<syntaxhighlight lang="perl">$buf = DevIo_SimpleReadWithTimeout($hash, $timeout);</syntaxhighlight>

Die Funktion DevIo_SimpleReadWithTimeout() wartet maximal <code>$timeout</code> Sekunden bis die Verbindung von <code>$hash</code> Daten zum einlesen bereitstellt und gibt diese zurück. Sollte nach dem Warten von <code>$timeout</code> noch immer keine Daten zum Lesen bereitstehen, so wird ein Leerstring zurückgegeben.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
|| Die Hash-Referenz der Definition, für deren Verbindung aktuell anstehende Daten gelesen werden sollen.
|-
| style="vertical-align:top" | '''<code>$timeout</code>'''

''mandatory''
|| Die maximale Wartezeit in Sekunden.
|}

Rückgabewert:
{| class="wikitable"
|-
! Rückgabe!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$buf</code>''' || Die zu lesenden Daten als Zeichenkette.
|}

== DevIo_TimeoutRead() ==
{{Randnotiz|RNTyp=Warn|RNText=<u>'''ACHTUNG:'''</u>

Bei der Benutzung von DevIo_TimeoutRead() wird FHEM für die Dauer von <code>$timeout</code> Sekunden blockiert. -> DevIo_TimeoutRead() NICHT NUTZEN!}}
:<syntaxhighlight lang="perl">$buf = DevIo_TimeoutRead($hash, $timeout);</syntaxhighlight>

Die Funktion DevIo_SimpleReadWithTimeout() wartet <code>$timeout</code> Sekunden und liest sämtliche Daten für die Verbindung von <code>$hash</code> ein, die in dieser Zeit eintreffen. Sollten keinerlei Daten während der Wartezeit eintreffen, so wird ein Leerstring zurückgegeben.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
|| Die Hash-Referenz der Definition, für deren Verbindung Daten eingelesen werden sollen.
|-
| style="vertical-align:top" | '''<code>$timeout</code>'''

''mandatory''
|| Die Wartezeit in Sekunden.
|}

Rückgabewert:
{| class="wikitable"
|-
! Rückgabe!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$buf</code>''' || Die eingelesenen Daten als Zeichenkette.
|}

== DevIo_SimpleWrite() ==
:<syntaxhighlight lang="perl">DevIo_SimpleWrite($hash, $msg, $type);
DevIo_SimpleWrite($hash, $msg, $type, $addnl);</syntaxhighlight>

Die Funktion DevIo_SimpleWrite() sendet den Inhalt von <code>$msg</code> über die Verbindung von <code>$hash</code>. Mit den beiden Argumenten <code>$type</code> und <code>$addnl</code> kann die Formatierung von <code>$msg</code> beeinflusst werden bevor die Daten tatsächlich gesendet werden.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
|| Die Hash-Referenz der Definition, über deren Verbindung die Daten gesendet werden sollen.
|-
| style="vertical-align:top" | '''<code>$msg</code>'''

''mandatory''
|| Die zu schreibenden Daten als Zeichenkette. Abhängig von <code>$type</code> kann <code>$msg</code> Byte-Characters, HEX-Darstellungen oder normale ASCII-Zeichen enthalten.
|-
| style="vertical-align:top" | '''<code>$type</code>'''

''mandatory''
|| Die Art des Inhalts von <code>$msg</code>. Abhängig von dem Inhalt von <code>$type</code> wird <code>$msg</code> entsprechend geändert oder nicht. Desweiteren werden die Daten für Logausgaben evtl. leserlich gemacht.

Folgende Werte sind möglich:

* <code>0</code> - <code>$msg</code> enthält Daten in Byteform. Der Inhalt von <code>$msg</code> wird 1:1 gesendet. Zur besseren Lesbarkeit werden die Daten bei Logausgaben in HEX-Darstellung umgewandelt.
* <code>1</code> - <code>$msg</code> enthält Binärdaten in HEX-Darstellung (0-9/A-F). Der Inhalt von <code>$msg</code> wird vorher in Byteform umgewandelt und anschließend gesendet. In Logausgaben wird die HEX-Darstellung wie übergeben verwendet.
* <code>2</code> - <code>$msg</code> enthält normale ASCII-Textzeichen. Der Inhalt von <code>$msg</code> wird 1:1 gesendet. In Logausgaben wird <code>$msg</code> wie übergeben ausgegeben.
|-
| style="vertical-align:top" | '''<code>$addnl</code>'''

''optional''
|| Ein Flag (0/1) welches, sofern aktiviert, einen Zeilenumbruch (<code>\n</code>) an <code>$msg</code> anfügt, bevor es gesendet wird.

Standardwert: 0
|}

== DevIo_Expect() ==
{{Randnotiz|RNTyp=Warn|RNText=<u>'''ACHTUNG:'''</u>

# Bei der Benutzung von DevIo_Expect() wird FHEM für die Dauer von bis zu <code>$timeout</code> Sekunden blockiert.
# Sollte im ersten Versuch keine Antwort auf die zuvor gesendeten Daten innerhalb von <code>$timeout</code> Sekunden eintreffen, wird die Verbindung geschlossen und neu aufgebaut. Es erfolgt dabei '''KEINE INITIALISIERUNG''' durch <code>$initfn</code> aus [[#DevIo_OpenDev()|DevIo_OpenDev()]].
-> DevIo_Expect() NICHT NUTZEN!
}}
:<syntaxhighlight lang="perl">$buf = DevIo_Expect($hash, $msg, $timeout);</syntaxhighlight>

Die Funktion DevIo_Expect() sendet den Inhalt von <code>$msg</code> und wartet bis zu <code>$timeout</code> Sekunden auf eine Antwort. Sollte in dieser Zeit keine Antwort eintreffen, so wird die Verbindung einmalig geschlossen, erneut geöffnet (ohne Aufruf einer Initialisierungs-Funktion) und der Vorgang wiederholt. Die empfangene Antwort wird anschließend als Funktionsergebnis zurückgegeben.

Wenn beim ersten Versuch keine Antwort innerhalb von <code>$timeout</code> Sekunden eintrifft, wird das Event <code>FAILED</code> generiert (siehe [[#Generierte Events|Generierte Events]]). Anschließend wird die Verbindung geschlossen, neu geöffnet (ohne Initialisierung) und <code>$msg</code> erneut gesendet. Sollte nun eine Antwort eintreffen, so wird das Event <code>CONNECTED</code> generiert und die empfangene Antwort zurückgegeben. Sollte dennoch keine Antwort eintreffen, so wird das Event <code>DISCONNECTED</code> getriggert.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
|| Die Hash-Referenz der Definition, für deren Verbindung Daten gesendet und anschließen gelesen werden sollen.
|-
| style="vertical-align:top" | '''<code>$msg</code>'''

''mandatory''
|| Die zu sendenden Daten auf die eine Antwort erwartet wird. Die Daten werden ohne Konvertierung direkt gesendet (entspricht <code>$type</code> gleich <code>0</code> bei [[#DevIo_SimpleWrite()|DevIo_SimpleWrite]]).
|-
| style="vertical-align:top" | '''<code>$timeout</code>'''

''mandatory''
|| Die maximale Wartezeit in Sekunden bis zum Eintreffen einer Antwort.
|}

Rückgabewert:
{| class="wikitable"
|-
! Rückgabe!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$buf</code>''' || Die empfangene Antwort. Sollte es zu einem Fehler gekommen sein (Senden von <code>$msg</code> fehlgeschlagen, keine Antwort innerhalb von <code>$timeout</code> Sekunden erhalten, etc.), so wird <code>undef</code> zurückgegeben.
|}

== DevIo_CloseDev() ==
:<syntaxhighlight lang="perl">DevIo_CloseDev($hash);
DevIo_CloseDev($hash, $isFork);</syntaxhighlight>

Die Funktion DevIo_CloseDev() schließt eine evtl. geöffnete Verbindung für die Definition <code>$hash</code>.

Optional kann man mit dem Flag <code>$isFork</code> angeben, dass man sich aktuell in einem Fork vom Hauptprozess befindet. Dadurch werden beim Schließen einer seriellen Verbindung die Kommunikationsparameter nicht zurückgesetzt. Dies verhindert einen Ausfall der nachwievor bestehenden Verbindung im Elternprozess.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$hash</code>'''

''mandatory''
|| Die Hash-Referenz der Definition, deren Verbindung geschlossen werden soll.
|-
| style="vertical-align:top" | '''<code>$isFork</code>'''

''optional''
|| Ein Flag (0 oder 1), welches angibt, dass DevIo_CloseDev() innerhalb eines geforkten Kindprozess ausgeführt wird. Dadurch werden die Kommunikationsparameter im Falle einer seriellen Verbindung (Baudrate, Datenbits, Parität, etc.) nicht zurückgesetzt. Dieses Flag wird primär von dem Modul [[Blocking_Call|Blocking.pm]] verwendet um Verbindungen in einem geforkten Kindprozess zu schließen, ohne die Verbindung im Hauptprozess zu beeinträchtigen.

Standardwert: 0 (Verbindung wird im Hauptprozess geschlossen)
|}

= Generierte Events =
Die Funktionen von DevIo generieren verschiedene Events für die entsprechende Definition (parametrisiert durch <code>$hash</code>). Diese können bspw. in der [[DevelopmentModuleIntro#X_Notify|Notify]]-Funktion des entsprechenden Moduls verarbeitet werden.

Hier eine Übersicht der generierten Events:

{| class="wikitable"
|-
! Event !! Bedeutung
|-
| '''<code>CONNECTED</code>''' || Die Verbindung wurde nach einem Verbindungsabbruch erfolgreich wieder aufgebaut. Dieses Event wird nur nach einem erfolgreichen Reconnect von einer zuvor verlorenen Verbindung generiert. Es wird '''nicht''' nach der erfolgreichen Initialverbindung generiert.

<u>Hinweis:</u><br>Seit [https://svn.fhem.de/trac/changeset/18985/ SVN-Revision 18985] wird das <code>CONNECTED</code>-Event auch beim erfolgreichen Aufbau der initialen Verbindung getriggert. Dies gilt jedoch nur für TCP-Verbindungen. Bei allen anderen Verbindungsarten bleibt das Verhalten unverändert. (siehe {{Link2Forum|Topic=98809|Message=921911}})
|-
| '''<code>DISCONNECTED</code>''' || Die zuvor erfolgreich aufgebaute Verbindung ist zusammengebrochen. Es wird ein neuer Verbindungsversuch nach <code>$hash->{nextOpenDelay}</code> Sekunden erfolgen (siehe [[#Wichtige Internals zur Konfiguration|Wichtige Internals zur Konfiguration]]).

<u>Hinweis:</u><br>Seit [https://svn.fhem.de/trac/changeset/18985/ SVN-Revision 18985] wird das <code>DISCONNECTED</code>-Event auch nach dem ersten initialem erfolglosen Verbindungsversuch getriggert. Dies gilt jedoch nur für TCP-Verbindungen. Bei allen anderen Verbindungsarten bleibt das Verhalten unverändert. (siehe {{Link2Forum|Topic=98809|Message=921911}})
|-
| '''<code>FAILED</code>''' || Dieses Event wird nur bei der Nutzung der Funktion [[#DevIo_Expect|DevIo_Expect()]] generiert, sofern es keine Antwort auf die zuvor gesendeten Daten gibt. Dies bedeutet konkret, dass Gerät hat nicht auf die eigene Anfrage geantwortet und die Verbindung wird daher neu aufgebaut. Details dazu, siehe [[#DevIo_Expect()|DevIo_Expect()]].
|}

= Hinweis bei der Datenverarbeitung (Buffering) =
DevIo beschränkt sich ausschließlich auf die Verbindungsverwaltung. Sobald die Verbindung etabliert wurde, übernimmt FHEM (fhem.pl) die Verarbeitung von eingehenden Daten und informiert das entsprechende Modul durch Aufruf der [[DevelopmentModuleIntro#X_Read|Read]]-Funktion. Dabei hat weder DevIo, noch FHEM selber Kenntnis von der Struktur der Daten. Sowohl DevIo, als auch FHEM selber können nicht erkennen, ob die empfangenen Daten weder vollständig, noch valide in ihrem Aufbau sind. Dies alles obliegt dem Modul, welches die Verbindung initiiert hat. Man sollte daher immer davon ausgehen, dass beim Lesen von Daten (in [[DevelopmentModuleIntro#X_Read|X_Read()]]) diese unvollständig sein können, oder sogar mehrere Datagramme enthalten sein können.

Dazu stellt DevIo dem Modulentwickler das Internal <code>$hash->{PARTIAL}</code> in der jeweiligen Definition zur Verfügung um dort Daten zwischenzuspeichern, bis ein vollständiges Datagramm daraus verarbeitet werden kann. Alle eingelesenen Daten werden dazu in der [[DevelopmentModuleIntro#X_Read|Read]]-Funktion immer an <code>$hash->{PARTIAL}</code> hinten angehangen. Sobald ein vollständiges Datagramm in <code>$hash->{PARTIAL}</code> erkannt wurde, wird dieses herausgenommen und verarbeitet, solange bis kein vollständiges Datagramm in <code>$hash->{PARTIAL}</code> erkennbar ist. Hierbei ist jedoch entscheidend, woran man ein abgeschlossenes Datagramm erkennen kann. Dies kann je nach Protokoll sehr unterschiedlich sein (bspw. Zeilenumbruch <code>\r\n</code> oder ein Semikolon <code>;</code>, etc.).

DevIo initialisiert <code>$hash->{PARTIAL}</code> nach dem erfolgreichen Verbindungsaufbau mit einem Leerstring (<code>""</code>). Sobald eine Verbindung mit [[#DevIo_CloseDev()|DevIo_CloseDev()]] geschlossen wird, wird <code>$hash->{PARTIAL}</code> gelöscht.

Hier ein Beispiel, wie man ein solches Buffering verwendet für ein Protokoll, welches Datagramme durch einen Zeilenumbruch <code>\n</code> (Newline) abtrennt:

<syntaxhighlight lang="perl">
sub MY_MODULE_Read($)
{
my ($hash) = @_;
my $name = $hash->{NAME};

my $data = DevIo_SimpleRead($hash);
return if(!defined($data)); # connection lost

my $buffer = $hash->{PARTIAL};

Log3 $name, 5, "MY_MODULE ($name) - received $data (buffer contains: $buffer)";

# concat received data to $buffer
$buffer .= $data;

# as long as the buffer contains newlines (complete datagramm)
while($buffer =~ m/\n/)
{
my $msg;

# extract the complete message ($msg), everything else is assigned to $buffer
($msg, $buffer) = split("\n", $buffer, 2);

# remove trailing whitespaces
chomp $msg;

# parse the extracted message
MY_MODULE_ParseMessage($hash, $msg);
}

# update $hash->{PARTIAL} with the current buffer content
$hash->{PARTIAL} = $buffer;
}
</syntaxhighlight>

= Beispielimplementierung in einem Modul =
== serielle Verbindung ==
<syntaxhighlight lang="perl">
package main;

use strict;
use warnings;
use DevIo; # load DevIo.pm if not already loaded

# called upon loading the module MY_MODULE
sub MY_MODULE_Initialize($)
{
my ($hash) = @_;

$hash->{DefFn} = "MY_MODULE_Define";
$hash->{UndefFn} = "MY_MODULE_Undef";
$hash->{SetFn} = "MY_MODULE_Set";
$hash->{ReadFn} = "MY_MODULE_Read";
$hash->{ReadyFn} = "MY_MODULE_Ready";
}

# called when a new definition is created (by hand or from configuration read on FHEM startup)
sub MY_MODULE_Define($$)
{
my ($hash, $def) = @_;
my @a = split("[ \t]+", $def);

my $name = $a[0];

# $a[1] is always equals the module name "MY_MODULE"

# first argument is a serial device (e.g. "/dev/ttyUSB0@9600")
my $dev = $a[2];

return "no device given" unless($dev);

# close connection if maybe open (on definition modify)
DevIo_CloseDev($hash) if(DevIo_IsOpen($hash));

# add a default baud rate (9600), if not given by user
$dev .= '@9600' if(not $dev =~ m/\@\d+$/);

# set the device to open
$hash->{DeviceName} = $dev;

# open connection with custom init function
my $ret = DevIo_OpenDev($hash, 0, "MY_MODULE_Init");

return undef;
}

# called when definition is undefined
# (config reload, shutdown or delete of definition)
sub MY_MODULE_Undef($$)
{
my ($hash, $name) = @_;

# close the connection
DevIo_CloseDev($hash);

return undef;
}

# called repeatedly if device disappeared
sub MY_MODULE_Ready($)
{
my ($hash) = @_;

# try to reopen the connection in case the connection is lost
return DevIo_OpenDev($hash, 1, "MY_MODULE_Init");
}

# called when data was received
sub MY_MODULE_Read($)
{
my ($hash) = @_;
my $name = $hash->{NAME};

# read the available data
my $buf = DevIo_SimpleRead($hash);

# stop processing if no data is available (device disconnected)
return if(!defined($buf));

Log3 $name, 5, "MY_MODULE ($name) - received: $buf";

#
# do something with $buf, e.g. generate readings, send answers via DevIo_SimpleWrite(), ...
#

}

# called if set command is executed
sub MY_MODULE_Set($$@)
{
my ($hash, $name, $cmd) = @_;

my $usage = "unknown argument $cmd, choose one of statusRequest:noArg on:noArg off:noArg";

if($cmd eq "statusRequest")
{
DevIo_SimpleWrite($hash, "get_status\r\n", 2);
}
elsif($cmd eq "on")
{
DevIo_SimpleWrite($hash, "on\r\n", 2);
}
elsif($cmd eq "off")
{
DevIo_SimpleWrite($hash, "off\r\n", 2);
}
else
{
return $usage;
}
}

# will be executed upon successful connection establishment (see DevIo_OpenDev())
sub MY_MODULE_Init($)
{
my ($hash) = @_;

# send a status request to the device
DevIo_SimpleWrite($hash, "get_status\r\n", 2);

return undef;
}

1;
</syntaxhighlight>

== TCP/IP-Verbindung ==
<syntaxhighlight lang="perl">
package main;

use strict;
use warnings;
use DevIo; # load DevIo.pm if not already loaded

# called upon loading the module MY_MODULE
sub MY_MODULE_Initialize($)
{
my ($hash) = @_;

$hash->{DefFn} = "MY_MODULE_Define";
$hash->{UndefFn} = "MY_MODULE_Undef";
$hash->{SetFn} = "MY_MODULE_Set";
$hash->{ReadFn} = "MY_MODULE_Read";
$hash->{ReadyFn} = "MY_MODULE_Ready";
}

# called when a new definition is created (by hand or from configuration read on FHEM startup)
sub MY_MODULE_Define($$)
{
my ($hash, $def) = @_;
my @a = split("[ \t]+", $def);

my $name = $a[0];

# $a[1] is always equals the module name "MY_MODULE"

# first argument is the hostname or IP address of the device (e.g. "192.168.1.120")
my $dev = $a[2];

return "no device given" unless($dev);

# close connection if maybe open (on definition modify)
DevIo_CloseDev($hash) if(DevIo_IsOpen($hash));

# add a default port (1012), if not explicitly given by user
$dev .= ':1012' if(not $dev =~ m/:\d+$/);

# set the IP/Port for DevIo
$hash->{DeviceName} = $dev;

# open connection with custom init and error callback function (non-blocking connection establishment)
DevIo_OpenDev($hash, 0, "MY_MODULE_Init", "MY_MODULE_Callback");

return undef;
}

# called when definition is undefined
# (config reload, shutdown or delete of definition)
sub MY_MODULE_Undef($$)
{
my ($hash, $name) = @_;

# close the connection
DevIo_CloseDev($hash);

return undef;
}

# called repeatedly if device disappeared
sub MY_MODULE_Ready($)
{
my ($hash) = @_;

# try to reopen the connection in case the connection is lost
return DevIo_OpenDev($hash, 1, "MY_MODULE_Init", "MY_MODULE_Callback");
}

# called when data was received
sub MY_MODULE_Read($)
{
my ($hash) = @_;
my $name = $hash->{NAME};

# read the available data
my $buf = DevIo_SimpleRead($hash);

# stop processing if no data is available (device disconnected)
return if(!defined($buf));

Log3 $name, 5, "MY_MODULE ($name) - received: $buf";

#
# do something with $buf, e.g. generate readings, send answers via DevIo_SimpleWrite(), ...
#

}

# called if set command is executed
sub MY_MODULE_Set($$@)
{
my ($hash, $name, $cmd) = @_;

my $usage = "unknown argument $cmd, choose one of statusRequest:noArg on:noArg off:noArg";

if($cmd eq "statusRequest")
{
DevIo_SimpleWrite($hash, "get_status\r\n", 2);
}
elsif($cmd eq "on")
{
DevIo_SimpleWrite($hash, "on\r\n", 2);
}
elsif($cmd eq "off")
{
DevIo_SimpleWrite($hash, "off\r\n", 2);
}
else
{
return $usage;
}
}

# will be executed upon successful connection establishment (see DevIo_OpenDev())
sub MY_MODULE_Init($)
{
my ($hash) = @_;

# send a status request to the device
DevIo_SimpleWrite($hash, "get_status\r\n", 2);

return undef;
}

# will be executed if connection establishment fails (see DevIo_OpenDev())
sub MY_MODULE_Callback($)
{
my ($hash, $error) = @_;
my $name = $hash->{NAME};

# create a log emtry with the error message
Log3 $name, 5, "MY_MODULE ($name) - error while connecting: $error";

return undef;
}

1;
</syntaxhighlight>

= Referenzen =
<references />

[[Kategorie:Development]]

Z-Wave

2020-06-08T14:57:42Z

Krikan: /* Definition von Geräten / Slaves */ -> devspec funktioniert nicht zuverlässig bei neighborUpdate

<div style="float:right">{{Infobox Modul
|Name=ZWDongle
|ModPurpose=Einbindung Z-Wave-Gateways
|ModType=d
|ModCmdRef=ZWDongle
|ModForumArea=ZWave
|ModTechName=00_ZWDongle.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
{{Infobox Modul
|Name=ZWave
|ModPurpose=Ansteuerung Z-Wave-Geräte über ZWDongle
|ModType=d
|ModCmdRef=ZWave
|ModForumArea=ZWave
|ModTechName=10_ZWave.pm
|ModOwner=Rudolf König ([http://forum.fhem.de/index.php?action=profile;u=8 Forum])
}}
</div>

[[Z-Wave]] ist ein drahtloser Kommunikations-Standard im 868 Mhz-Band (Europa), der von der Firma Sigma Designs und der Z-Wave Alliance, einen Zusammenschluss von mehreren Hundert Herstellern, für die Heimautomatisierung entwickelt wurde. Es existieren mehr als [http://products.z-wavealliance.org 1400 zertifizierte Produkte] verschiedenster Hersteller, die innerhalb eines gemeinsamen Z-Wave-Netzes einsetzbar sind. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia])

Auf dieser Seite werden Grundlagen eines '''Z-Wave''' Systems und dessen Einrichtung in FHEM beschrieben.
== Z-Wave ==
=== Nodes - Controller und Slaves ===
Ein Z-Wave-Netz besteht aus mindestens 2 Geräten, den sogenannten '''Nodes''' (Knoten). Es setzt sich zusammen aus dem steuernden '''Controller''' (Zentrale) und min. 1 bis max. 231 gesteuerten '''Slaves''' (Geräten).

=== Home-Id und Node-ID ===
Innerhalb eines Z-Wave-Netzes gibt es zu 2 Identifikationsnummern zur Kennzeichnung der Netzstruktur:
# '''Home-ID:''' Gemeinsame Identifikationsnummer aller Nodes in einem Netz zur Abgrenzung gegenüber anderen Netzen. Nur Nodes mit der gleichen Home-ID können miteinander kommunizieren.
# '''Node-ID:''' Identifikationsnummer zur eindeutigen Kennzeichnung von jedem Node im Netz.

Die Home-ID ist im Controller (fest) hinterlegt und seine Node-ID ist typischerweise 1. Die Slaves haben zunächst keine Home-ID und Node-ID. Bei der '''Inklusion''' (Aufnahme) der Slaves in das Z-Wave-Netz überträgt der Controller seine Home-ID auf die Slaves und weist den Slaves eine eindeutige Node-ID im Netz zu, mit der Sie direkt angesprochen werden.

Besondere Node-ID ist die 255. Eine Nachricht an die Node-ID 255 kann von allen Z-Wave-Nodes ausgewertet werden (Broadcast).

=== Primär- und Sekundärcontroller ===
Der Controller, der durch Zuteilung seiner Home-ID auf die Slaves, das Netz aufbaut, ist der '''Primärcontroller'''. Grundsätzlich können in einem Netz mehrere Controller existieren, aber immer nur ein Primärcontroller. Weitere in das Netz eingebundene Controller werden zum '''Sekundärcontroller'''. Ohne besondere Maßnahmen kann nur der Primärcontroller die Inklusion (Einbindung) der Nodes in das Netz durchführen. Hingegen können sowohl Primär- als auch Sekundärcontroller die '''Exklusion''' (Ausschluss) eines Nodes aus dem Netz vornehmen.

Der Controller speichert intern diverse Informationen (Home-ID, Node-IDs,..) über das ZWave-Netz. Hierdurch kann unter anderem die Haussteuerungssoftware bei einem PC-Controller relativ unkompliziert gewechselt werden, da die wesentlichen ZWave-Netzinformationen vom Controller selbst verwaltet und gespeichert werden. Andererseits muß bei einem Controllerdefekt das gesamte Netz grundsätzlich neu aufgebaut werden, wenn kein Backup der internen Controllerdaten vorhanden ist.

=== Acknowledge ===
Im Z-Wave-Netz werden Nachrichten vom Empänger-Node an den Sender-Node rückbestätigt (Acknowledge). Bei ausbleibendem Acknowledge wiederholt der Sender-Node die Nachricht automatisch auf Protokollebene bis zu 2 mal. Hierdurch wird eine höhere Betriebssicherheit des Z-Wave-Netzes erreicht. Bei Broadcast-Nachrichten an die Node-ID 255 findet keine Rückbestätigung statt.

=== Vermaschtes Netzwerk mit Routing ===
Z-Wave nutzt als Netzwerktopologie ein '''mesh network''' (vermaschtes Netzwerk), d. h. jeder Node ist mit einem oder mehreren anderen Nodes verbunden. Das hat den Vorteil, dass eine Nachricht zwischen zwei Nodes übermittelt werden kann, selbst wenn diese nicht direkt miteinander kommunizieren können, z. B. weil sie zu weit voneinander entfernt sind. In diesem Fall wird die Funk-Nachricht über einen oder mehrere „Zwischen-Nodes“ übertragen; dieser Vorgang wird '''Routing''' genannt. Nur netzgespeiste Z-Wave-Geräte sind Router. Batteriebetriebe Z-Wave-Geräte sind grundsätzlich keine Router und dienen somit auch nicht zur Reichweitenerhöhung. (Quelle: [http://de.wikipedia.org/wiki/Z-Wave Wikipedia]) Einzelne Geräte, die alternativ per Batterie oder USB-Anschluss betrieben werden können, werden bei USB-Anschluss automatisch ({{Link2Forum|Topic=40393|Message=328080}}) oder durch Konfigurationsänderungen ({{Link2Forum|Topic=40393|Message=327331}}) zu Routern.

Informationen über das optimale Routing werden bei der Inklusion der Nodes in einer Routing-Tabelle des Primärcontrollers gespeichert. Dies geschieht durch Abfrage des Nodes, welche weiteren Nodes er erreichen kann. Durch örtliche Änderung oder Defekte von Nodes können die in der Routing-Tabelle gespeicherten Informationen fehlerhaft bzw. suboptimal werden. Dies kann sich in Funkkommunikationsproblemen im Netzwerk äußern. Hier kann ein per Software manuell angeforderter Neuaufbau der Routing-Tabelle gegebenenfalls Abhilfe schaffen. Bei Geräten und Controllern mit aktuellen Firmware-Versionen (SDK 4.5x und SDK 6.xx oder größer, aber ''nicht'' SDK 5.x) und Unterstützung von Explorer Frames kann sich die Routing-Tabelle unter bestimmten Bedingungen auch automatisch aktualisieren ("Selbstheilung")[https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames].

=== Command Classes ===
Die Steuerung und Kommunikation der Nodes erfolgt über Befehle die funktionsbezogen in verschiedene '''Command Classes''' (Kommandoklassen) zusammengefasst sind.

Alle Z-Wave-Geräte haben als gemeinsame kleinste Übereinstimmung die '''Class Basic'''.

Z-Wave-Geräte haben im Originalzustand eine bestimmte arbeitsfähige Grund-Konfiguration. Anpassbar an individuelle Bedürfnisse ist die Konfiguration über die '''Class Configuration'''.

Durch eine Assoziation wird definiert, welche Geräte miteinander direkt -ohne Umweg über den Controller- kommunizieren können. Auch bei Ausfall des Controllers können diese Geräte ihre gemeinsame Funkton ausüben. Zudem dienen Assoziationen der Geschwindigkeitssteigerung und Funklastreduzierung innerhalb des Netzes. Angelegt werden Assoziationen über die '''Class Association'''.

Dies sind nur die allerwichtigsten Command Classes. Weitere Command Classes sind den Handbüchern zu entnehmen. Zudem enthält die Wiki-Seite [[Z-Wave Command Classes]] weitergehende Informationen.

=== Hinweise zur Z-Wave-Geräteauswahl ===
Aufgrund der vielen Z-Wave-Gerätehersteller mit jeweils eigenem Z-Wave-Gerätesortiment existiert eine große Produktauswahl. Jedoch gibt es auch große Unterschiede hinsichtlich Produkteigenschaften, Pflege der Produkte, Häufigkeit der Aktualisierung der Produktpalette und so weiter. Schwierigkeiten bereitet insbesondere, dass neben den aktuellesten Chipsätzen und SDKs auch die älteren Chipsätze und SDKs weiterhin in Produkten im Handel verfügbar sind. Neuere Chipsätze und aktuelle SDKs bieten gerade bei der Netzwerkstabilität (Explorer Frames, Reichweite usw.) Vorteile zu älteren Chipsätzen und SDKs. Beispielsweise beherrschen nur Geräte mit SDK 4.5x und 6.x oder neuer die für automatische Routenkorrekturen wichtigen Explorer Frames. Das ältere SDK 5.0, das verwirrenderweise auch noch eine höhere Versionsnummer als das neuere SDK 4.5 besitzt, beherrscht unter anderem keine Explorer Frames. Details hierzu enthält das [https://web.archive.org/web/20160319202135/http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames wiki.zwaveeurope.com]. Aktuellstes SDK ist Stand 10/2017 das SDK 6.7x, das in ZWave Plus - zertifizierten Produkten zum Einsatz kommt.

Gerade Einsteiger beachten die Unterschiede bei den Chipsätze/SDKs aus Unkenntnis manchmal nicht und ärgern sich im Nachhinein über Probleme bei der Netzwerkstabilität und Reichweite. Darum nachfolgend allgemeine, aber sehr einfache Empfehlungen zur Geräteauswahl. Selbstverständlich wird hier nicht von anderen Produkten abgeraten, wenn man die Unterschiede kennt und Vorteile bei deren Produkteigenschaften sieht. Zudem kann man (leider) schlechtere Produkteigenschaften bei Geräten mit aktuelleren Chipsätzen/SDKs nie ausschließen.

Gateway
# [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus-Zertifizierung]. Diese ist mittlerweile bei nahezu allen erhältlichen Gateways gegebenen.

Endgeräte
# Z-Wave Plus-Zertifizierung (aktuellste Technik, höhere theoretische Reichweite, SDK 6.5x oder höher) oder
# zumindest Explorer Frames-Unterstützung (SDK 4.5x und 6.0x) oder
# zuletzt -bei Kenntnis der Besonderheiten und Auswirkungen- Produkte ohne Explorer Frames (SDK 5.0x)

'''Kurz''': Produkte mit Z-Wave Plus-Zertifizierung einsetzen.

Bitte unbedingt beachten, dass Z-Wave Plus-Vorteile bei einem Mischbetrieb mit älteren (ohne Plus) Geräten teilweise verloren gehen. Zum negativen Effekt des Einsatzes eines älteren, aber weiterhin erhältlichen Z-Wave-Repeaters mit aktuellen Z-Wave Plus-Geräten siehe beispielsweise den Hinweis in diesem {{Link2Forum|Topic=42591|Message=350066}}.

Bei Fragen zu bestimmten Geräten bitte -nach Durchsicht der Hinweise hier im Wiki- im Forum suchen oder anschließend nachfragen.

== Z-Wave in FHEM ==
=== Allgemein ===
FHEM wird fortwährend weiterentwickelt und verbessert. Daher ist es zwingend notwendig, dass FHEM auf dem aktuellsten Stand ist. Dazu nach der FHEM-Installation den Befehl <code>update</code> ausführen und anschließend <code>shutdown restart</code> durchführen. Genauso auch vor [[#Welche_Infos_sollten_Anfragen_im_ZWave-Forum_enthalten.3F|Anfragen im Forum]] die Aktualität von FHEM überprüfen.

Die Einbindung von Z-Wave in FHEM ist (nicht nur für den Anfänger) ausschließlich mit der standardmäßig eingeschalteten [[autocreate|autocreate-Funktion]] einfach möglich. Die Kenntnis der FHEM-Grundlagen und Durcharbeitung der Anfänger-Lektüren wird im Folgenden vorausgesetzt. Insbesondere sind [[Erste_Schritte_in_FHEM|Erste Schritte in FHEM]] und [http://fhem.de/Heimautomatisierung-mit-fhem.pdf Heimautomatisierung mit FHEM] Pflicht, auch wenn sie nicht speziell Z-Wave behandeln, so werden doch wesentliche Punkte für ein Verständnis von FHEM vermittelt.

Nachfolgend und auf den [[:Kategorie:Z-Wave Components|Wiki-Seiten der Einzelgeräte]] werden immer wieder Auszüge aus der [[Konfiguration]] dargestellt. Diese dienen zur Erläuterung und Veranschaulichung. Die Bearbeitung der Konfiguration sollte -zur Verhinderung von Fehlern- nach Möglichkeit immer über das "[[Konfiguration#Befehl-Eingabefeld|Befehl-Eingabefeld]]" und die "[[Konfiguration#Objektdetails|Objektdetails]]" erfolgen.

=== Vorbereitung ===
Die Bedienungsanleitungen (Handbücher) sind zwingende Voraussetzung zur korrekten Einbindung und Konfiguration von Z-Wave-Geräten in FHEM. Sie müssen daher vorliegen.
Den ZWave-Geräten liegen teilweise nur gekürzte, gedruckte Fassungen der Handbücher bei (beispielsweise Devolo, AEOTEC). Man sollte bei allen Produkten auf folgenden Seiten nach eventuellen ausführlicheren Handbüchern suchen:
* Herstellerseite des ZWave-Gerätes
* http://www.zwave.de/handbuecher/ (deutsch)
* http://products.z-wavealliance.org (englisch)
Insbesondere auf http://products.z-wavealliance.org, der Datenbank der ZWave-zertifizierten Produkte, sind regelmäßig ausführliche Informationen zu den Geräten zu finden.

== Definition des Gateways / Controllers ==
{{Randnotiz|RNText='''Tester für ZWave@culfw gesucht!'''
Z-Wave-Controllerfunktionen werden derzeit in die Firmware [http://www.culfw.de culfw] für den [[CUL]] implementiert. Weitere Informationen im [[ZWCUL]] - Artikel.}}
=== Autocreate des Gateways ===
FHEM kann mit einem Funkgateway Z-Wave-Funk empfangen und senden. Z-Wave-Gateways (Controller) existieren von verschiedenen Herstellern.

Folgende Gateways wurden unter anderem bereits erfolgreich mit FHEM eingesetzt:
* AEON Labs Z-Stick S2 (SDK 5.x; [https://aeotec.freshdesk.com/support/solutions/articles/6000091809-z-stick-s2-v3-08-firmware-update Firmwareupdate auf 3.08 aus 2016])
* Aeotec Z-Stick Gen5 (Z-Wave Plus; SDK 6.5; [https://aeotec.freshdesk.com/support/solutions/articles/6000108806-z-stick-gen5-backup-software Backup-Software)] ({{Link2Forum|Topic=47000}})
* Goodway WD6001 (SDK 5.03 {{Link2Forum|Topic=40594|Message=332235}})
* Vision Z-Wave USB Stick ZU 1401 EU (SDK 6.0x)
* Vision Z-Wave USB Stick ZU 1401-5 EU (Z-Wave Plus; SDK 6.5x)
* Z-Wave.Me Z-StickC ({{Link2Forum|Topic=29930|Message=226530}})
* Z-Wave.Me USB Stick ZME_UZB1 (SDK 6.5x; Z-Wave Plus; [http://razberry.z-wave.me/z-way-server/ Firmwareupdate und Backup über z-way])
* Z-Wave.Me Razberry in Verbindung mit Raspberry Pi (1. Generation: Z-Wave, 2. Generation: Gen5-Razberry mit Z-Wave Plus[http://forum.z-wave.me/viewtopic.php?f=3419&t=21327#p55404])
** Die seriellen Schnittstelle /dev/ttyAMA0 muss am Raspberry Pi freigeschaltet werden, damit das Razberry-Modul funktionsfähig ist: {{Link2Forum|Topic=78248|Message=702044}})
** Beim Raspberry Pi 3 muss der GPIO-Port auf den Hardware-UART0 umgestellt werden: [[Raspberry Pi 3: GPIO-Port Module und Bluetooth]]

Folgende Gateways sind '''nicht''' mit FHEM einsetzbar:
* Merten Funk-USB-Datenschnittstelle CONNECT

Sollte das eigene Gateway hier nicht aufgeführt sein, ist aufgrund der Standardisierung dennoch die Chance für eine erfolgreiche Einbindung des Gateways in FHEM vorhanden. Bitte dies hier oder im Forum entsprechend vermerken.

Das Z-Wave-Gateway wird unter Linux nach Anschluss an den FHEM-Rechner beim nächsten FHEM-Start oder ohne FHEM-Neustart durch Aufruf des Befehls <code>usb scan</code> zumeist automatisch erkannt und das zugehörige FHEM-Device nach dem Namensschema <code>ZWDongle_<[https://forum.fhem.de/index.php/topic,92885.msg854533.html#msg854533 Anhang]></code> angelegt. Ein manuelles Anlegen des ZWDongle-Moduls oder Eingriffe in die Konfiguration sind unter Linux normalerweise nicht notwendig.

Unter Windows ist ein manuelles Anlegen der Definition des ZWave-Gateways wegen fehlender Unterstützung des Befehls <code>usb scan</code> erforderlich (Beispiel für Z-Wave.Me USB Stick ZME_UZB1 unter Windows: <code>define ZWDongle_1 ZWDongle COM1@115200</code>).

Das FHEM-Gateway-Device ist nach der Definition in FHEM im Raum "Everything" zu finden.

Beispiele der automatisch erzeugten define-Zeile in der Konfiguration:

Aeon Labs Z-Stick an der Fritzbox:
define ZWDongle_1 ZWDongle /dev/ttyUSB1@115200

Vision Z-Wave USB Stick ZU 1401 EU am Raspberry Pi (Raspbian):
define ZWDongle_1 ZWDongle /dev/ttyACM1@115200

Insbesondere wenn am FHEM-Server unter Linux mehrere USB-Gateways eingesetzt werden, empfiehlt es sich zur Erhöhung der Betriebsstabilität das Z-Wave-Gateway über [[Trick_der_Woche#CUL_.26_CO_.C3.BCber_Serial_ID-einbinden|Serial-by-Id]] oder [[LinuxDeviceNaming|uDev-Regeln]] anzusprechen.

Bei einem statischen Controller wird die Einrichtung als SUC -sofern der Controller als solcher nicht bei Auslieferung eingerichtet ist- vor der ersten Inklusion von Geräten empfohlen.

=== homeId und nodeList des Gateways ===
Zur manuellen Definition von Z-Wave Aktoren und Sensoren ist die <code>homeId</code> notwendig. Bei der hier bevorzugten Definition der Geräte durch autocreate ist die Kenntnis der <code>homeId</code> nicht zwingend. Jedoch sollte durch Abfrage der <code>homeId</code> direkt nach Einbindung des Zwave-Gateways dessen Funktionsfähigkeit getestet werden.

Die <code>homeId</code> und <code>CtrlNodeId</code> des Gateways wird mit folgendem Befehl ausgelesen (<ZWDongle> ist im folgenden durch den Namen des FHEM-Devices des eigenen Gateways zu ersetzen):
get <ZWDongle> homeId
ergibt beispielsweise bei einem Gateway mit dem FHEM-Devicenamen ZWDongle_1:
ZWDongle_1 homeId => HomeId:e345c456 CtrlNodeId:01
In diesem Beispiel ist die Home-Id des Gateways ZWDongle_1 e345c456 und das Gateway hat die Node-Id 1.

Die aktuelle Liste der Z-Wave Nodes, die bereits am Gateway registriert/inkludiert sind, wird mit dem folgendem Befehl ausgelesen:
get <ZWDongle> nodeList
ergibt beispielsweise:
ZWDongle_1 nodeList => ZWDongle_1 UNKNOWN_2

== Definition von Geräten / Slaves ==
=== Hinzufügen eines neuen Z-Wave Geräts / Inklusion ===
Zur Verfolgung von Inklusionsablauf und Meldungen des Controllers während der Inklusion sollte der [[Event monitor]] in einem 2. Browserfenster vor Aktivierung des Inklusionsmodus geöffnet werden.

Das Z-Wave Gateway wird in den Standard-Modus zur Inklusion (zum Aufnehmen) neuer Geräte gesetzt:
set <ZWDongle> addNode on
Bei der Standard-Inklusion muss direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen.

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt des obigen Befehls besser der Network-Wide-Modus für die Inklusion genutzt werden:
set <ZWDongle> addNode onNw
Bei der Network-Wide-Inklusion muss kein direkter Funkkontakt zwischen Gateway und zu inkludierendem Z-Wave Gerät bestehen. Es reicht, wenn das zu inkludierende Gerät über andere bereits inkludierte, netzgespeiste Geräte mit Explorer Frames-Unterstützung erreicht werden kann. Die Network-Wide-Inklusion ist zu bevorzugen, da die Z-Wave-Geräte regelmäßig an Ihren örtlichen Endpositionen inkludiert werden können. Dadurch werden bei der Inklusion direkt die korrekten Routen gespeichert.

Nachdem das Gateway in den Inklusionmodus geschaltet wurde, muss das Gerät in den Inklusionsmodus (Aufnahmemodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen. Typisch sind ein- oder dreimaliges Drücken einer Taste am Gerät oder beim Anlegen der Versorgungsspannung. Durch die Inklusion werden Home-ID und Node-ID im Gerät gespeichert. Zudem teilt das Gerät über ein spezielle Funknachricht (NIF=Node Information Frame) dem Controller seinen Gerätetyp und seine Geräteeigenschaften mit. Hierbei werden dem Controller auch die vom Gerät unterstützten Command Classes mitgeteilt. Aus diesen Informationen erzeugt FHEM automatisch durch autocreate das FHEM-Geräte-Device nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> (an eigene Wünsche anpassbar mit {{Link2CmdRef|Anker=rename|Label=rename}}). Die vom Geräte unterstützen Command Classes, die die in FHEM verfügbaren Befehle bestimmen, werden automatisch im Attribut <code>classes</code> des FHEM-Geräte-Device gespeichert. Das Gerät ist damit grundlegend in FHEM definiert und im Raum "ZWave" zu finden.

Nach der Inklusion schaltet FHEM den Inklusionsmodus des Z-Wave Gateway automatisch durch Absetzen des Befehls <code>set <ZWDongle> addNode off</code> aus und zeigt eine Dialogbox mit dem Ergebnis der Inklusion:
* <code><nowiki>created ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> = Inklusion war erfolgreich und es wurde das bezeichnete FHEM-Device durch autocreate angelegt.
* <code><nowiki>addNode failed</nowiki></code> = Inklusion ist fehlgeschlagen

Eine erfolgreiche Inklusion ist zudem am Event "ZW_ADD_NODE_TO_NETWORK protocolDone" im Event monitor und natürlich der Anlage des entsprechenden FHEM-Devices durch autocreate zu erkennen. Das Scheitern einer Inklusion führt typischerweise zur Ausgabe des Events "ZW_ADD_NODE_TO_NETWORK failed". Häufigste Ursache sind Controllerprobleme, die sich oftmals durch kurzes Ein- und Ausstecken des Controllers, Neustart des Systems oder Ein- und Ausschalten des FHEM-Server-Computers beheben lassen.

HINWEISE:<br />
* Die Network-Wide-Inklusion kann nach derzeitiger Kenntnis auch bei Gateways und Geräten ohne Explorer Frames Unterstützung genutzt werden, da bei diesen Geräten grundsätzlich automatisch auf die Standard-Inklusion umgestellt wird.
* Bei der Standard-Inklusion ist unter Umständen nur ein geringer Abstand zwischen Gateway und Gerät möglich. Sollte die Inklusion daher nicht durchführbar sein, wenn Gateway und Gerät an ihren örtlichen Endpositionen sind (bevorzugte Variante), dann ist der Abstand zwischen diesen versuchsweise zu verringern. Anschließend bei örtlicher Veränderung die Routen mit <code><nowiki>set <ZWave-Devicename> neighborUpdate</nowiki></code> neu ermitteln lassen. Unter Umständen kann der Abstand nur schrittweise erhöht werden. Dann ist bei jeder Abstandsänderung eine Neuermittlung der Routen notwendig.
* Der NIF enthält bei manchen Geräten fälschlicherweise nicht alle unterstützten Command Classes. FHEM identifiziert während der Inklusion das Gerät und ergänzt die fehlenden Command Classes aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Weiterhin fehlende Command Classes können im Attribut <code>classes</code> manuell am Anfang der Liste entsprechend ergänzt werden. Informationen liefern die unter [[#Links|Links]] aufgeführten Datenbanken. Häufig fehlt die Pflicht-Class BASIC.
* Bei der hier beschriebenen Inklusion findet die Kommunikation zwischen Controller und Gerät anschließend dauerhaft unverschlüsselt statt. Manche Geräte bieten mit der Command Class SECURITY eine AES-verschlüsselte Kommunikation an. Da die Verschlüsselung zu einer höheren Funklast und Latenzen führt, sollte eine verschlüsselte Kommunikation nur mit Bedacht eingesetzt werden (bspw. bei Schlössern). Als Sonderfall ist das Vorgehen zur secure-Inklusion in der [[#Wie_kann_eine_verschl.C3.BCsselte_Kommunikation_unter_Nutzung_der_Command_Class_SECURITY_eingerichtet_werden.3F|FAQ]] beschrieben.

Nächster Schritt ist die [[#Assoziation|Assoziation]] des Gerätes mit dem Gateway.

=== Assoziation ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Z-Wave-Geräte können über Assoziationen direkt mit anderen Z-Wave-Geräten kommunizieren. Dies können zum einen Meldungen über den Status und Zustand der Geräte, als auch direkte Befehle sein. Zum Beispiel kann damit ein Bewegungsmelder eine entdeckte Bewegung an den Controller senden und/oder bei entdeckter Bewegung direkt eine Lampe ein- oder ausschalten.

Die Assoziation zwischen zwei Geräten wird durch Aufnahme des zu steuernden Gerätes in eine oder mehrere Assoziationsgruppe(n) des steuernden Gerätes angelegt. Durch die Wahl der Assoziationsgruppe wird festgelegt, bei welchen Ereignissen welche Nachricht an das assoziierte Gerät verschickt wird. Angaben zu den Ereignissen und versandten Nachrichten an die Geräte in einer bestimmten Assoziationsgruppe stehen in der Bedienungsanleitung des jeweiligen Gerätes.

Damit FHEM Statusmeldungen von Sensoren/Aktoren anzeigen und auch darauf reagieren kann, '''muss''' der Controller (<ZWDongle>-Device, <code>CtrlNodeId</code> = typischerweise 1) immer in der/den passenden Assoziationsgruppe(n) des jeweiligen Gerätes <code><name></code> aufgenommen werden:

set <name> associationAdd <associationGroup> <CtrlNodeId>

Typischerweise ist die Assoziationsgruppe 1 der Geräte für die Statusmeldungen an den Controller vorgesehen (Ausnahme: [[#Fibaro|Fibaro-Geräte ohne ZWave Plus - Zertifizierung]]). Daher nimmt FHEM die Assoziation von Controller mit der Assoziationsgruppe 1 des Gerätes bei der Inklusion immer automatisch vor. Zudem identifiziert FHEM während der Inklusion das Gerät und setzt weitere Assoziationen mit dem Controller für von 1 abweichende Assoziationsgruppen aufgrund manuell gepflegter, gerätespezifischer [[#Welche_Funktion_haben_die_XML-Config-Dateien_in_FHEM.3F|XML-Config-Dateien]]. Ist keine XML-Config-Datei für das Gerät vorhanden, sind Assoziationen des Controllers mit von 1 abweichenden Assoziationsgruppen oder weiteren Assoziationsgruppen mit dem zuvor genannten Befehl grundsätzlich manuell anzulegen.

Die richtige Anlage der Assoziation(en) des Controllers mit dem Gerät immer prüfen, da dies eine Hauptfehlerquelle bei Funktionsproblemen mit FHEM ist.

Abruf der assoziierten Geräte in einer bestimmten Assoziationsgruppe <associationGroup>:
get <name> association <associationGroup>

Abruf der assozierten Geräte für alle Assoziationsgruppen eines Gerätes:
get <name> associationAll

Nahezu alle in Europa erhältlichen aktuellen Geräte unterstützen die Rückmeldung des Status via Association. Ausnahmen gibt es in Nordamerika, wo aufgrund von Patentansprüchen einige Hersteller auf die Statusrückmeldungen verzichten. Diese Geräte unterstützen in der Regel die Command Class ASSOCIATION nicht.

Nächster Schritt ist die [[#Konfiguration|Konfiguration]] des Gerätes.

=== Konfiguration ===
{{Randnotiz|RNText=Bitte unbedingt die Besonderheiten bei [[#batteriebetriebene_Ger.C3.A4te|batteriebetriebenen Geräten]] beachten!}}
Die Standard-Konfiguration eines Gerätes entspricht oftmals nicht den eigenen Wünschen und Anforderungen (Einheiten usw.). Mit den Befehlen der Class CONFIGURATION lässt sich die Konfiguration anpassen. Die zur Konfiguration eines Gerätes notwendigen Angaben zu den Parameternummern, -größen und -werten sind im jeweiligen Geräte-Handbuch bzw. entsprechenden Datenbanken (bspw. [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] oder [http://products.zwavealliance.com/ products.zwavealliance.com]) enthalten.

Die Konfiguration beispielsweise bei Parametergröße 1 lässt sich mit diesem Befehl anpassen:
set <name> configByte <Parameternummer> <Parameterwert>
Für weitere Parametergrößen gibt es die Befehle <code>configWord</code> und <code>configLong</code>

Die im Gerät hinterlegten Konfiguration kann pro Parameternummer mit folgendem Befehl abgerufen werden:
get <name> config <Parameternummer>

Zudem bietet FHEM basierend auf den manuell gepflegten XML-Config-Dateien die Möglichkeit, die speziellen Parameternummern des Gerätes mit ihren Parametergrößen und -werte als eigenständige config-Befehle mit Hilfsinformationen einzubinden. Ein manuelles Suchen im Geräte-Handbuch und Nutzung der configByte-, configWord- und configLong-Befehle ist dadurch in vielen Fällen unnötig. Für diese Funktion muss das Gerät von FHEM einmalig durch folgenden Befehl, der bei der Inklusion automatisch ausgeführt wird, identifiziert werden:
get <name> model
Die Readings <code>model</code>, <code>modelID</code> und <code>modelConfig</code> werden dadurch erzeugt. In <code>model</code> sollte der Klartextname des Gerätes stehen. Zudem sind dann -soweit eine XML-Config Datei für das Gerät existiert- die speziellen set/get-Kommandos configXYZ für das Geräte im Auswahldialog der Detailansicht mit Hilfsinformationen verfügbar:
[[Datei:Z-Wave_confighelp.PNG|900px|thumb|center|config-Befehl mit Hilfstext]]

Bei vorhandener XML-Config-Datei kann die komplette Konfiguration eines Gerätes abgerufen werden:
get <name> configAll

Außerdem wird durch den <code>get <name> model</code> -Befehl geprüft, ob das Gerät in der [http://devel.pepper1.net/zwavedb/ pepper1-ZWave-Datenbank] und/oder [http://products.zwavealliance.com/ products.zwavealliance.com] enthalten ist. Im Erfolgsfall wird ein Link "Details in pepper DB" und/oder "Details in alliance DB" zum entsprechenden Geräteeintrag in der jeweiligen Datenbank unten in der Detailansicht des FHEM-Geräte-Devices angelegt und ein Bild des Gerätes in die Detailansicht eingebunden.

Der Aufruf von <code>get <name> model</code> ist auch für die Nutzung der Class MANUFACTURER_PROPRIETARY zwingende Einsatzvoraussetzung.

=== Entfernen eines Z-Wave-Geräts / Exklusion ===
Durch die Exklusion wird die Home-ID und Node-ID aus dem Gerät und das Gerät selbst aus der Node-List des Controllers gelöscht. Erst nach einer Exklusion kann das Gerät in ein anderes Z-Wave-Netz aufgenommen werden.

Zuerst wird der Z-Wave Gateway in den Standard-Modus zur Exklusion (Ausschluss) von Geräten gesetzt:
set <ZWDongle> removeNode on

Sofern Z-Wave Gateway und Z-Wave Geräte Explorer Frames unterstützen, sollte statt dem obigen Befehl besser der Network-Wide-Modus für die Exklusion genutzt werden (siehe auch Erläuterungen zu Standard- versus Network-Wide-Inklusion unter [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]]):
set <ZWDongle> removeNode onNw

Danach muss das Gerät in den Exklusionsmodus (Ausschlussmodus) versetzt werden. Wie dies zu erfolgen hat, ist im Handbuch des Geräte nachzulesen.

Abschließend wird der Exklusionsmodus am Z-Wave Gateway wieder ausgeschaltet:
set <ZWDongle> removeNode off

Das FHEM-Device muss nach der Exklusion manuell durch <code>delete <name></code> gelöscht werden.

Die durch die Exklusion frei gewordene NodeID wird nicht bei der nächsten Inklusion wiederverwendet, sondern es wird die höchste noch nicht verwendete NodeID genutzt.

=== Erneutes Hinzufügen eines bereits registrierten Z-Wave Geräts ===
Die an einem Z-Wave-Gateway bereits registrierten/inkludierten Geräte sind im Gateway selbst abgespeichert und können durch FHEM jederzeit wieder abgerufen werden. Dies kann man in folgenden Fällen sinnvoll nutzen:
* Inklusion mit einem batteriegespeisten ZWave-Gateway (bspw. Aeon Labs Z-Stick) ohne FHEM-Server-Anschluss während der Inklusion
* Umstieg eines ZWave-Netzwerkes von Fremdsoftware auf FHEM
* Vollständiger oder teilweiser Verlust der FHEM-Konfiguration

Eine Node-Liste aller inkludierten Geräte des Gateways wird abgerufen durch:
get <ZWDongle> nodeList
Es wird eine Liste aller im Gateway inkludierten Gerät inklusive Gateway selbst zurückgeliefert. Sofern ein Gerät bereits als FHEM-Device angelegt wurde, wird der FHEM-Device-Name in der nodeList angezeigt. Dies ist für das Gateway selbst immer der Fall. Alle noch nicht in FHEM angelegten Geräte, werden als "UNKNOWN_x" ausgegeben, wobei x die ID des betreffenden Gerätes ist.

Mit dem folgenden Befehl wird beispielsweise das bereits im Gateway inkludierte Gerät mit der ID 2 (in der nodeList angezeigt als "UNKNOWN_2") in FHEM durch autocreate definiert:
set <ZWDongle> createNode 2

Batteriebetriebene Geräte müssen bei Absetzen des <code>createNode</code>-Befehls wach sein, damit der Befehl verarbeitet werden kann. Dies erreicht man, indem man das Gerät auf "permanent wach" stellt. Falls das Gerät diese Funktion nicht anbietet, muss man es manuell aufwecken und max. 2 Sekunden später den <code>createNode</code>-Befehl absetzen. Alternativ kann das batteriebetriebene Gerät durch Versand des NIF vom Gerät aus automatisch in FHEM erzeugt werden: Hierzu am Gerät die Taste zum Versand des NIF drücken und <code>autocreate</code> legt das FHEM-Device an; der Aufruf von <code>createNode</code> entfällt dann.

== Geräte-Besonderheiten ==
=== batteriebetriebene Geräte ===
Batteriebetriebenen Geräten können hinsichtlich ihrer Empfangsbereitschaft unterschieden werden in

* Wakeup-Geräte
* FLIRS-Geräte

==== Wakeup-Geräte ====
Wakeup-Geräte sind momentan die häufigste Art von batteriebetriebenen Z-Wave Geräten. Sie sind erkennbar an der Unterstützung der Command Class WAKE_UP.
Zur Verlängerung der Batterielaufzeit legen sich batteriebetriebene Wakeup-Geräte „schlafen“ und wachen (Wakeup) nur in konfigurierbaren Intervallen auf, um Befehle zu verarbeiten. Das Aufwachen signalisieren die Geräte durch den Versand einer Nachricht "wakeup notification". Daraufhin senden FHEM und andere Geräte ihre bis dahin gesammelten Befehle, die dann verarbeitet bzw. beantwortet werden. Anschließend gehen die batteriebetriebenen Geräte wieder in den Schlafmodus.

FHEM teilt bei set/get-Befehlen an batteriebetriebene Geräte über einen Hinweis der Form
:<code>Scheduled for sending after WAKEUP</code>
::oder
:<code>Scheduled get requests for sending after WAKEUP</code>
mit, dass der Befehl im Sendstack des FHEM-Geräte-Devices abgespeichert wurde und bei der nächsten "wakeup notification" an das Gerät versendet wird. Ein Versand der Befehle im Sendstack findet grundsätzlich ausschließlich nach Erhalt der "wakeup notification"-Nachricht statt, selbst wenn das Gerät zwischendurch andere Telegramme (bspw. Bewegungsmeldung, Temperatur) an den Controller verschickt. Nur nach Versand der "wakeup notification" ist das batteriebetriebene Gerät grundsätzlich in der Lage ("wach genug"), Telegramme korrekt zu empfangen und zu verarbeiten.

Wie viele Nachrichten im Sendstack auf einen Versand an das Gerät warten, ist im Internal <code>cmdsPending</code> des zugehörigen FHEM-Devices ersichtlich. Welche Nachrichten (Befehle) im Sendstack warten, ist in der Ausgabe des Befehls <code>[[list]] <device></code> erkennbar: Unter der Überschrift Sendstack sind alle wartenden Nachrichten als Rohnachrichten aufgeführt. Der Sendstack wird beim Beenden von FHEM nicht gespeichert. Durch Beenden von FHEM (beispielsweise durch <code>shutdown restart</code>) geht der Sendstack der Geräte daher verloren.

Das Wakeup-Interval und der Empfänger der "wakeup notification" wird wie folgt konfiguriert:
<nowiki>set <name> wakeupInterval <time> <NodeId></nowiki>
<nowiki><time></nowiki> ist die Zeit in Sekunden zwischen den Intervallen und <nodeID> der gewünschte Empfänger der "wakeup notification"; in der Regel ist dies '''immer''' der Controller <CtrlNodeId>. Viele Geräte kommen im Auslieferungszustand mit der NodeID 255. Die "wakeup notification" wird dann als Broadcast ohne Nutzung von Routing an alle erreichbaren Geräte gesendet. Hier sollte die Konfiguration auf die NodeID des Controllers geändert werden, da dadurch die "wakeup notification" geroutet wird und größere Entfernungen zwischen Gerät und Controller möglich sind. Zudem ist dies robuster und spart zusätzlich noch Batterielaufzeit. Darum setzt FHEM bei der Inklusion von WakeUp-Geräten '''automatisch''' den Befehl <code><nowiki>set <name> wakeupInterval 86400 <ControllerNodeId></nowiki></code> ab. Bei abweichenden eigenen Vorstellungen ist dies gegebenenfalls anzupassen. Bei Geräten mit V2 der Command Class WAKE_UP kann das vom Hersteller vorgesehene Standard-wakeupInterval mit <code><nowiki>get <name> wakeupIntervalCapabilities</nowiki></code> vom Gerät abgerufen werden. Die Einstellungen von wakeupInterval nach Inklusion und nach jeder Änderung immer mit der Abfrage <code><nowiki>get <name> wakeupInterval</nowiki></code> überprüfen.

Ein Aufwachen und Versand der "wakeup notification" von batteriebetriebenen Geräten kann für die [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] manuell erzwungen werden. Hierzu bringt man das Gerät normalerweise in den Inklusionsmodus oder findet in der Bedienungsanleitung gegebenenfalls andere Informationen. Bitte beachten, dass dann je nach Gerät nur eine geringe Entfernung von Gateway und Gerät vorhanden sein darf (direkte Erreichbarkeit). Alternativ kann für die Dauer der Assoziation und Konfiguration das Wakeup-Interval verkürzt werden (beispielsweise auf 60 Sekunden), wodurch das Routing genutzt werden kann und größere Entfernungen zwischen Gateway und Gerät überbrückt werden können. Anschließend das Wakeup-Interval wieder auf eine batterieschonenende Dauer einzustellen.

Einzelne batteriebetriebene Gerät lassen sich für längere Zeit auf "wach" bzw. permanent "wach" stellen. Dann aus dem Attribut <code>classes</code> <code>WAKE_UP</code> entfernen, damit Befehle in diesem Gerätemodus von FHEM direkt verschickt werden. Nach Ausschalten des "wach"-Modus <code>WAKE_UP</code> wieder im Attribut <code>classes</code> aufnehmen.

Bei Konfigurationsänderungen an batteriebetriebenen Geräten mit <code>set <name> config...</code> sollte die korrekte Verarbeitung der Befehle immer mit dem entsprechenden <code>get <name> config...</code> oder -falls vorhanden- mit <code>get <name> configAll</code> überprüft werden, um eventuelle Funk-Telegrammverluste sofort festzustellen.

==== FLIRS-Geräte ====
Ein batteriebetriebene FLIRS (frequently listening routing slave) Gerät wacht in sehr kurzen Zeitabständen (250ms oder 1000ms) auf und prüft, ob ein Funksignal vorliegt. Liegt kein Funksignal vor geht das Gerät wieder in Tiefschlaf. Zum Aufwecken eines FLIRS-Gerätes ist ein dauerhaftes Funksignal -der Wakeup-Beam-, notwendig, das etwas länger als die Aufweckzeitabstände sein muss. Näher beschrieben unter anderem [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF hier].

FLIRS-Geräte haben nicht die Command Class WAKE_UP und arbeiten deshalb nicht mit "wakeup notification". Aus Sicht des FHEM-Nutzers sind die bekannten FLIRS-Geräte (Sirenen von Vision und Popp) nicht anders zu bedienen/einzurichten als netzgespeiste Geräte. Wakeup-Beam und andere Besonderheiten werden unsichtbar für den Nutzer automatisch abgewickelt.

=== Aeon Labs / Aeotec ===
Ausführliche Handbücher und technische Informationen auf https://aeotec.freshdesk.com/support/home

==== Multi Sensor 5 ====
* aktuellste Firmware installieren
* Attribut <code>classes</code> um <code>BASIC</code> ergänzen (ab [[version|Modulversion]] 8824/25.6.2015 wird das automatisch bei der Inklusion durchgeführt)
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* Parameter 101 auf 225 (oder 224 bei USB-Anschluss) setzen mit <code>set <name> configGroup1Reports 225</code> oder <code>set <name> configLong 101 225</code>, um Batteriezustand (nicht bei 224), Temperatur, Feuchte und Helligkeit regelmäßig zu erhalten. Das Sende-Intervall wird duch <code><nowiki>set <name> configGroup1Interval <time/s></nowiki></code> festgelegt (Standard 720 Sek).
* [http://devel.pepper1.net/zwavedb/device/407 Paramterübersicht pepper-Datenbank]
siehe {{Link2Forum|Topic=34505|Message=268913}}

==== Multisensor 6 ====
siehe {{Link2Forum|Topic=40393}}
* arbeitet bei USB-Anschluß als Router
* bei USB-Anschluss aus Attribut <code>classes</code> <code>WAKE_UP</code> entfernen
* die <code>configGroupxInterval</code> und <code>configxxxReportingThreshold</code> Einstellungen wirken nur bei USB-Anschluss, im reinen Batteriebetrieb werden die Sensordaten nur bei einem <code>wakeup</code> übertragen

==== Aeotec LED Bulb ZW098-C55 ====
siehe {{Link2Forum|Topic=40504}}

=== Danfoss ===
==== DAN_LC-13 Heizungsthermostat LC-13 (014G0013) ====
Das Danfoss Heizungsthermostat LC-13 muss derzeit zur korrekten Funktion mit FHEM regelmäßig mit folgendem <code>at</code> abgefragt werden ({{Link2Forum|Topic=32145|Message=260795}}):
define Atdanfoss at +*00:30 get <name> battery
Auf dem Markt sind mehrere Varianten des Thermostates LC-13 erhältlich. Darum beim Kauf unbedingt auf die genaue Bezeichnung LC-13 (014G0013) achten ({{Link2Forum|Topic=38041|Message=303146}}).

=== devolo ===
Ausführliche Handbücher auf http://products.z-wavealliance.org

==== MT02648 Tür-/Fenster Kontakt 3in1 ====
siehe {{Link2Forum|Topic=41337}}

=== DüWI ===
Geräte von DÜWI liefern bei örtlicher Betätigung kein automatisches Funk-Signal über die Statusänderung. Das liese sich nur durch eine regelmäßige Statusabfrage durch FHEM (beispielsweise <code>define Status_Abfrage at +*00:03:00 get <name> swmStatus</code>) beheben.
Einige Produkte von [http://zwave.me Z-Wave.Me] basieren auf DÜWI-Geräten. Diese Z-Wave.Me Produkte haben jedoch eine erweiterte Firmware, welche die genannte und weitere Firmware-Schwächen der Original-Produkte von DÜWI behebt.

=== Everspring ===
==== AN145 Sockelmodul E27 ====
Statusabfrage ohne permanente Abfrage: {{Link2Forum|Topic=48864|Message=405545|Beitrag}}

=== Fibaro ===
Association Group für Übermittlung von Statusinformationen an den Controller:
* "alte" ZWave-Geräte (kein ZWave-Plus): häufig Association Group 3
: <code><nowiki>set <name> associationAdd 3 <CtrlNodeId></nowiki></code>
: Bei diesen Geräten empfiehlt es sich zur Funklastreduzierung und Problemminimierung zu prüfen, ob die von FHEM automatisch vorgenommene Assoziation des Controllers mit der Association Group 1 gelöscht werden kann (<code><nowiki>set <name> associationDel 1 <CtrlNodeId></nowiki></code>). Nahezu immer werden in Association Group 1 die gleichen Infos, nur mit einer anderen Command Class, wie in der Association Group 3 an den Controller übermittelt.
* ZWave Plus-Geräte: Association Group 1 ("lifeline")

==== FGSS-001 / FGSD-002 Rauchmelder ====
* nicht untereinander vernetzbar
* keine Alarmauslösung/Sirenenfunktion durch ZWave-Zentralen

==== FGS-222 Relais Unterputzeinsatz ====
Bei der Inklusion werden von FHEM 3 Devices angelegt:
* Hauptdevice (Steuerung und automatischer Status für Kanal 1 und kanalübergreifende Funktionen)
* Device für Endpoint 1 (Steuerung Kanal 1)
* Device für Endpoint 2 (Steuerung und automatischer Status von Kanal 2)
Die Firmware des FGS-222 übermittelt den Status für Kanal 1 automatisch immer ausschließlich an das Hauptdevice. Die Steuerung von Kanal 1 kann hingegen sowohl über das Hauptdevice als auch über das Device für Endpoint 1 erfolgen. Das Device für Endpoint 1 ist somit nicht zwingend erforderlich und kann grundsätzlich gelöscht oder in den room hidden verschoben werden.

Details: {{Link2Forum|Topic=50176}}

Hinweis zum Reset: {{Link2Forum|Topic=55190|Message=469393}}

==== FGK-101 Tür/Fensterkontakt ====
* Besonderheiten bei Anschluss eines Temperatursensors: {{Link2Forum|Topic=38012}}

=== GE ===
==== GE (Model t.b.d) ====
Dieser Schalter unterstützt keine Statusrückmeldungen.

=== Merten ===
Laut {{Link2Forum|Topic=38133}} müssen bei einigen Merten-Geräten, die mit Fremdsoftware inkludiert wurden, gegebenenfalls die Geräte wieder exkludiert und dann erneut mit FHEM inkludiert werden, damit Assoziationen mit FHEM gesetzt werden können.

=== Philio ===
==== PHI_PAN04 Relais Unterputzeinsatz 2 Schalter a 1.5kW mit Messfunktion ====
siehe {{Link2Forum|Topic=28046}}

=== Popp ===
==== POPE004001 Z-Wave Rauchmelder mit Innensirene ====
siehe {{Link2Forum|Topic=39856}}
==== POPE005107 Z-Wave Außensirene ====
siehe {{Link2Forum|Topic=42736}}<br>
Alte Firmwareversionen haben einen Bug bei der Übermittlung von negativen Temperaturen. Eine Lösungsvariante über ein <code>userReadings</code> findet sich auch im verlinkten Thema.
==== POPE009006 Z-Wave Wall Plug Switch ====
siehe {{Link2Forum|Topic=40771}}
==== POPE009402 10Year Smoke Detector ====
Die erste Firmwareversion hat eine fehlerhafte modelID. Diese Rauchmelder wird dadurch fälschlich als [[Z-Wave#POPE005107_Z-Wave_Au.C3.9Fensirene|Popp Aussensirene]] in FHEM angezeigt. Neuere Geräte werden laut Popp mit der korrekten modelID ausgeliefert.

=== Z-Wave.Me ===
==== ZME_RC2 Fernbedienung ====
siehe {{Link2Forum|Topic=35513}}<BR>
Das Forenthema enthält eine detaillierte Beschreibung der Nutzung der Class MULTI_CHANNEL_ASSOCIATION.

== Geräte-Vergleich ==
=== Doppel-Relais ===
{| class="wikitable"
|-
! Eigenschaft !! FIBARO Double Switch 2-FGS-223 !! Qubino Flush 2 relays !! Philio-PAN04 1
|-
| Funktion || Doppel-Relais || Doppel-Relais || Doppel-Relais
|-
| Standby-Leistung || ca. 0.4W || ca. 0.4W || ca. 0.5W
|-
| Reaktion beim Schalten am Tastereingang || schnell, kaum merkliche Verzögerung || schnell, kaum merkliche Verzögerung || langsam, unangenehm langes drücken des Tasters nötig >1 Sekunde
|-
| Geräte in FHEM || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 3 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 || 4 <br> x Hauptgerät <br> x.01 Relais 1 <br> x.02 Relais 2 <br> x.03 Summengerät (ähnlich Hauptgerät, überflüssig)
|-
| Zustand Hauptgerät || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais || Oder-Verknüpfung der beiden Relais
|-
| Statuswechsel Report vom Gerät zum FHEM || ca. 1 Sekunde || ca. 3 Sekunden || ca. 3-4 Sekunden
|-
| Empfänger des Status Reports || Hauptgerät und Untergeräte || Hauptgerät und Untergeräte || Nur Hauptgerät <br>Aktualisierung der Untergeräte nur bei aktiver Abfrage
|-
| Leistungsmessung || Separat für Untergeräte || Separat für Untergeräte || Nur Summe
|-
| Sicherung nötig / Strom || ja, 2x 6.5A, Summe max 10A || ja, max 2x 4A || nein, 2x 6.5A
|}
Beim Qubino Flush 2 relays muss eine MULTI_CHANNEL_ASSOCIATION mit dem Controller (Endpoint root) statt einer "normalen" Assoziation gesetzt werden, damit die Status der Untergeräte einzeln signalisert werden:

set associationDel 1 <controllerNodeId>
set <device> mcaAdd 1 0 <controllerNodeId> 0

Bei einem FHEM-Updatestand ab 20.09.2019 erfolgt diese Einstellung automatisch.

== Links ==
=== Allgemein ===
* Grundlageninformation "Z-Wave-Haupt-Anleitung": [http://www.zwave.de/z-wave-funknetz-einrichten-und-betreiben/ Wie errichte und betreibe ich ein Z-Wave basiertes Funknetz]
* [http://www.zwave.de/buch-z-wave-grundlagen/ Buch] "Z-Wave: Die Funktechnologie für das Smart Home" von Dr. Christian Paetz (Paetz "is the primary European representative for the Z-Wave Alliance" [http://z-wavealliance.org/global-contacts/])
* Z-Wave-Produktdatenbank mit Angabe zur Zertifizierung, Handbüchern und weiteren Detailinfos (Z-Wave oder [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus]): http://products.z-wavealliance.org (englisch)
* herstellerübergreifende Datenbank mit Bedienungsanleitungen zu Z-Wave-Geräten: http://www.zwave.de/handbuecher/ oder http://manuals.zwaveeurope.com (mehrsprachig)
* herstellerübergreifende Datenbank mit technischen Informationen zu Z-Wave-Geräten (Z-Wave Device Library): http://devel.pepper1.net/zwavedb/ (englisch; wird derzeit nicht mehr aktualisiert)
* informative Webseiten zu Z-Wave:
** http://www.z-wavealliance.org/ (englisch)
** http://www.zwaveeurope.com/ (englisch)
** http://www.zwave.de/ (deutsch)
** [http://library.ademconet.com/MWT/fs2/VAM/Introductory-Guide-to-Z-Wave-Technology.PDF Introductory Guide to Z-Wave-Technology von Honeywell] (englisch; nicht auf aktuellem Stand)

=== Informationsquellen zur Einbindung von Command Classes ===
Offizielle und ausführliche Informationen von Sigma Designs (veröffentlicht am 31.08.2016):
* [http://z-wave.sigmadesigns.com/design-z-wave/z-wave-public-specification/ Z-Wave Public Specification]

Weitere Informationen (seit Veröffentlichung der Z-Wave Spezifikationen am 31.08.2016 geringe Relevanz)
* [https://github.com/yepher/RaZBerry Infos zu Command Classes (ausführlich; insbesondere im Verzeichnis "docs"), RaZBerry und Z-Wave allgemein], englisch
* [http://220.135.186.178/zwave/example/ Übersicht von Command Classes und deren Rückgabewerten mit Unterscheidung der Class-Versionen], englisch
* Code von http://www.openzwave.org (https://github.com/OpenZWave/open-zwave) und http://www.openhab.org (Z-Wave binding: https://github.com/cdjackson/openhab)
* eine Java-API-Beschreibung mit Hinweisen zu Unterschieden von Class-Versionen: http://dz.prosyst.com/pdoc/mBS_SH_SDK_8.1/modules/zwave/api/driver/index.html

== FAQ ==
=== Welche Infos sollten Anfragen im ZWave-Forum enthalten? ===
* Anfragen bitte nur zur aktuellsten FHEM-Version: Befehl <code>update</code> ergibt Ausgabe "nothing to do..."
* detaillierte Beschreibung des Problems
* beteiligte Komponenten (genaue Bezeichnung und evtl. Link auf Hersteller-Dokumentation)
* list des jeweiligen FHEM-Devices (Ausgabe von <code>list <device></code>)
::Bitte vor Aufruf des list-Befehls -wenn vorhanden/möglich- folgende Befehle ausführen und Ergebnis abwarten:
::*<code>get <device> associationAll</code>
::*<code>get <device> configAll</code>
::*<code>get <device> versionClassAll</code>
::*<code>get <device> mcaAll</code>
::*<code>get <device> wakeupInterval</code> (nur bei batteriebetriebenen Geräten)
* passender Ausschnitt aus dem Logfile (siehe Link im FHEM-Menü links) generiert mit den gesetzten Attributen
::*<code>attr <ZWDongle> verbose 5</code> und
::*<code>attr global mseclog 1</code>

=== Welche Schritte sind für die Einbindung von ZWave-Geräten in FHEM mindestens durchzuführen? ===
Voraussetzung: ZWave-Gateway ist erfolgreich eingebunden!
# [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes
# [[#Assoziation|Assoziation]] der Assoziationsgruppe(n) des Gerätes mit dem Gateway
# [[#Konfiguration|Konfiguration]] des Gerätes

=== Warum bleibt der Status (STATE) des neu inkludierten Gerätes dauerhaft auf "associationAdd <associationGroup> <CtrlNodeId>" stehen? ===
FHEM setzt das Reading "state", das den STATE bestimmt, nicht bei allen ZWave-Devices mit vordefinierten Standardwerten. Daher bleibt der bei der Inklusion automatisch abgesetzte "associationAdd"-Befehl unter Umständen im STATE stehen, bis der Anwender den STATE über die Vergabe des Attributes <code>{{Link2CmdRef|Anker=stateFormat|Label=stateFormat}}</code> manuell an seine Bedürfnisse angepasst hat.
(weitergehende Info zum state/STATE/stateFormat: [[DevelopmentState]])

=== Wie können bei mehrkanaligen Aktoren die zusätzlichen Kanäle (>1) angesprochen werden? ===
* Bei der [[#Hinzufügen eines neuen Z-Wave Geräts / Inklusion|Inklusion]] des Gerätes wird das Hauptdevice mit dem Namen <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID></nowiki></code> und die Devices für alle Kanäle (Endpoints) nach dem Namensschema <code><nowiki>ZWave_<Geräteklasse laut NIF des Gerätes>_<NodeID>.<EndpointNr></nowiki></code> automatisch angelegt. Jedes dieser FHEM-Devices spricht regelmäßig einen bestimmten Kanal des Gerätes an; einige Geräte sprechen mit dem Hauptdevice jedoch das gesamte Gerät mit allen Kanälen an (Bedienungsanleitung beachten).
* Manuell werden Devices für zusätzliche Kanäle mit Hilfe der Befehle <code>get <device> mcEndpoints</code> und <code>get <device> mcCapability <chid></code> aus der Class MULTI_CHANNEL ermittelt bzw. einzeln über autocreate angelegt (Details und Beispiel siehe {{Link2CmdRef|Anker=ZWaveget}}). Mit dem Befehl <code>set <device> mcCreateAll</code> werden automatisch alle Kanäle des Gerätes durch autocreate als eigene Devices in FHEM angelegt.

=== Wie kann man die SDK-Version eines Gerätes herausfinden? ===
Mit FHEM alleine kann eine [[#Grobermittlung|Grobermittlung]] der SDK-Version vorgenommen werden, die aber für einige Zwecke bereits ausreichend ist. Soll eine [[#Detailermittlung|Detailermittlung]] der genauen SDK-Version erfolgen, dann müssen die mit FHEM ermittelten Werte anhand externer Quellen übersetzt werden.
==== Grobermittlung ====
Der Befehl <code><nowiki>get <ZWDongle> nodeInfo <dezimale nodeId></nowiki></code> liefert das Reading <code><nowiki>nodeInfo_<dezimale nodeId></nowiki></code> zurück.
Die Angabe im Reading hinter <code>ProtocolVers:</code> lässt grobe Rückschlüsse zu. Mögliche (bekannte) Werte:
* <code>2</code> -> bspw. keine Explorer Frames, keine SUC-Unterstützung (veraltet, keine bekannten Geräte mehr im Handel)
* <code>SDK5.0x+4.2x</code> -> bspw. keine Explorer Frames, teilweise SUC-Unterstützung
* <code>SDK4.5x+6.0x</code> -> bspw. Explorer Frames- und SUC-Unterstützung (Reading-Wert wird auch bei SDK 6.5x = Z-Wave Plus angezeigt)
==== Detailermittlung ====
Durch den Befehl <code><nowiki>get <name> version</nowiki></code> kann man die ZWave-Protokoll-Version von Geräten und Controller abfragen. Mit Unterstützung von Übersetzungstabellen
* http://wiki.micasaverde.com/index.php/ZWave_Protocol_Version
* Suche nach sdkids.xml in einer Suchmaschine
kann aus der Protokoll-Version das genutzte SDK festgestellt werden.

Beispielsweis entspricht das Reading eines Gerätes "Lib 6 '''Prot 2.64''' App 1.6" dem SDK 5.02 Patch 2 oder eines Controller "Z-Wave '''3.41''' STATIC_CONTROLLER" dem SDK 6.02.00.

HINWEIS: Bei der Vergabe der Protokoll-Version und zugehörigem SDK gibt es keine erkennbare Logik: Eine höhere Protokoll-Version steht nicht notwendig für eine höheres SDK.

=== Wie kann eine verschlüsselte Kommunikation unter Nutzung der Command Class SECURITY eingerichtet werden? ===
{{Randnotiz|RNText=FHEM unterstützt derzeit ausschließlich SECURITY 1 und nicht das mit dem SDK 6.7 neu eingeführte SECURITY 2 (S2). Soweit bekannt, sind S2-Geräte rückwärtskompatibel zu SECURITY 1.}}
Die verschlüsselte Kommunikation zwischen Controller und Endgerät setzt eine secure-Inklusion voraus. Bereits mit der Inklusion wird entschieden, ob die Kommunikation von Controller und Endgerät dauerhaft verschlüsselt oder unverschlüsselt erfolgt. Ist ein Gerät bereits normal inkludiert und entscheidet man sich nachträglich für eine verschlüsselte Kommunikation, so ist das nur möglich, indem das Gerät exkludiert und dann wieder secure inkludiert wird.

Ob die Verschlüsselung bei einem Gerät mit Unterstützung der Command Class SECURITY genutzt werden soll, sollte genau überlegt werden. Die Verschlüsselung führt zu einem deutlich größeren Funkverkehr zur Ausführung eines Befehls und teilweise auch zu spürbaren Latenzen.

Vorarbeiten:
* Das Perl-Modul Crypt-Rijndael muss installiert sein.
* Das Attribut <code>networkKey</code> muss mit einem 32-Zeichen langen Hexzahl beim ZWDongle angelegt werden. Dieser Schlüssel sollte nicht veröffentlicht werden und auch zusätzlich separat (bspw. auf Papier) festgehalten werden. Bei Verlust des Attributes und Schlüssels ist eine Kommunikation nur nach erneuter Inklusion möglich.

Ablauf der secure-Inklusion:
* Controller in den Modus zur secure-Inklusion schalten:
: <code>set <ZWDongle> addNode onSec</code> für die Standard-secure-Inklusion
: oder alternativ
: <code>set <ZWDongle> addNode onNwSec</code> für die Nework-Wide-secure-Inklusion
* Gerät gemäß Handbuch in den Modus zur secure-Inklusion bringen (teilweise ist jeweils für secure- und normale Inklusion ein anderes Vorgehen notwendig!)
* Das Gerät sollte jetzt automatisch erkannt und das FHEM-Device durch <code>autocreate</code> angelegt werden. Die secure-inkludierten Geräte haben ein zusätzliches Attribut <code>secure_classes</code> in dem die Command Classes deren Kommunikation verschlüsselt abläuft aufgelistet sind. Nicht in diesem Attribut, aber in <code>classes</code> aufgeführte Command Classes wickeln die Kommunikation weiterhin unverschlüsslt ab.
* Inklusionsmodus des Controllers ausschalten:
: <code>set <ZWDongle> addnode off</code>
* Das Vorgehen in FHEM unterscheidet sich von nun an nicht von normal (unverschlüsselt) inkludierten Geräten. Die Verschlüsselung läuft für den Anwender transparent ab. Darum anschließend [[#Assoziation|Assoziation]] und [[#Konfiguration|Konfiguration]] vornehmen.

=== Wie kann man ohne Exklusion Nodes des Controllers löschen? ===
HINWEIS: Geräte sollten grundsätzlich immer über eine Exklusion aus der Nodelist des Controllers gelöscht werden. Das nachfolgend geschilderte Vorgehen ist nur in Sonderfällen (bspw. Gerätedefekt, gebraucht gekauftes Gateway) anzuwenden.

Nicht mehr zu erreichende/reagierende Nodes (Geräte) können manuell mit dem Befehl <code>removeFailedNode</code> gelöscht werden. Dazu muss sich der betroffene Node auf der FailedNodeList des Controllers befinden. Auf die FailedNodeList kommen netzbetriebene Geräte automatisch, wenn sie vom Controller nicht mehr per Funk erreicht werden. Batteriebetriebene Geräte müssen manuell auf die FailedNodelist gesetzt werden, da der Controller nicht feststellen kann, ob sie nur langfristig "schlafen".

Der Befehl <code>removeFailedNode</code> löscht nur Nodes auf der FailedNodeList, die erst vor Kurzem nicht erreicht werden konnten. Darum muss sowohl das manuelle Verschieben von batteriebetriebenen als auch das Nicht-Erreichen der netzbetriebenen Geräte erst Kurz vor Aufruf des <code>removeFailedNode</code>-Befehls erfolgt sein.

Vorgehensweise für den Node <NodeId>:
# An den betroffenen Node eine Telegramm mit <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> verschicken, um ihn auf FailedNodeList zu verschieben bzw. Zeitstempel zu aktualisieren.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und kann mit <code>removeFailedNode</code> gelöscht werden.
# Befehl zum Löschen des Nodes absetzen: <code><nowiki>set <ZWDongle> removeFailedNode <NodeId></nowiki></code>. Der Befehl testet vor dem Löschen noch einmal, dass der Node nicht erreicht werden kann und entfernt erst dann den Node.
# Prüfen, der Ergebnisse des <code>removeFailedNode</code>-Befehls im Log oder [[Event monitor]]. Die verschiedenen Ergebnisse werden durch die in der {{Link2CmdRef}} dokumentierten Events signalisiert. Tritt das Ergebnis "failedNodeRemoveProcessBusy" mehrfach hintereinander auf, muss das ZWDongle kurz stromlos gemacht werden.
# Prüfen, ob der Node nicht mehr auf der Nodelist des Controllers ist: <code><nowiki>get <ZWDongle> nodeList</nowiki></code>

siehe auch {{Link2Forum|Topic=32823|Message=292626}}

=== Wie ist der einfachste Weg ein (defektes) Gerät durch ein gleiches Ersatzgerät auszutauschen? ===
Tauscht man ein defektes Gerät durch ein gleiches Ersatzgerät und inkludiert das Ersatzgerät per <code>addNode</code>, so erhält das Ersatzgerät eine neue NodeId. Soll das Ersatzgerät die gleiche NodeId wie das alte Gerät erhalten, so muss statt <code>addNode</code> der Befehl <code>replaceFailedNode</code> zur Inklusion des Ersatzgerätes (=gleiches Modell) verwendet werden.

Vorgehensweise für den Node <NodeId>:
# sofern das alte Gerät noch ansprechbar ist, die Konfiguration und Assoziationen abfragen, damit man die Werte im Ersatzgerät einfach wieder setzen kann:
## <code><nowiki>get <device> configAll</nowiki></code>
## <code><nowiki>get <device> associationAll</nowiki></code>
# defektes Gerät aus- und neues einbauen
# Befehl <code><nowiki>set <ZWDongle> sendNIF <NodeId></nowiki></code> absetzen, damit das Dongle die NodeId auf die FailedNodeList setzt.
# Abfragen, ob der Node auf der FailedNodeList steht: <code><nowiki>get <ZWDongle> isFailedNode <NodeId></nowiki></code>. Wenn der Rückgabewert der Abfrage "yes" ist, steht der Node korrekt auf der FailedNodeList und das Ersatzgerät kann mit <code>replaceFailedNode</code> inkludiert werden.
# <code><nowiki>set <zwdongle> replaceFailedNode <NodeId></nowiki></code> für die NodeId des defekten Gerätes aufrufen und das Ersatzgerät in den Inklusionsmodus bringen
# Korrekte Inklusion prüfen und beim alten Aktor ausgelesene Werte beim neuen Aktor wieder setzen.

=== Bei einer Inklusion wird eine durch Exklusion/removeFailedNode frei gewordenen NodeId nicht mehr vergeben. Ist das korrekt? ===
Ja, das ist richtig.

Bei der Inklusion über addNode vergibt der Controller die höchste bisher noch nie verwendete NodeID. Durch Exklusion oder removeFailedNode frei gewordene NodeIDs werden hierbei zunächst nicht erneut vergeben. Diese frei gewordenen NodeIds werden bei Inklusionen in aufsteigender Reihenfolge erst wieder vergeben, nachdem die höchste verfügbare NodeId (232?) inkludiert wurde. Sie sind somit grundsätzlich nicht verloren.

=== Welche Funktion haben die XML-Config-Dateien in FHEM? ===
In den XML-Config-Dateien sind Informationen zu einzelnen ZWave-Geräten enthalten, die der Erleichterung der Gerätenutzung und -einbindung in FHEM dienen. Dies sind unter anderem Erläuterungen zu den Parameternummer/-werten, Assoziationsgruppen und Besonderheiten eines Gerätes. Ob eine zum Zwave-Gerät passende XML-Config Datei existiert, wird im Rahmen der Inklusion oder durch manuellen Aufruf des Befehls <code>get <name> model</code> ermittelt. Wird eine passende XML-Config-Datei gefunden, wird sie automatisch in FHEM eingebunden. Das Reading <code>modelConfig</code> enthält dann den zugehörigen XML-Config-Dateinamen. Stehen keine XML-Config-Informationen bereit, enthält das Reading <code>modelConfig</code> den Wert "unknown". Die Funktionsfähigkeit von FHEM mit ZWave-Geräten ist auch bei fehlender XML-Config-Datei gegeben. Es gibt dadurch keine funktionalen Einschränkungen in FHEM; es entfallen "nur" Erleichterungen und es sind unter Umständen mehr manuelle Schritte bei der Gerätenutzung/-einbindung notwendig.

Erleichterungen bei vorhandener XML-Config für ein ZWave-Gerät:
* Bei der Inklusion:
** Assoziationen mit dem Controller bei von Gruppe 1 abweichenender Assoziationsgruppe werden automatisch gesetzt
** vom NIF nicht gemeldete, aber vom Gerät unterstützte Classes, werden im Attribut <code>classes</code> ergänzt
* Bei der Konfiguration:
** die Parameternummern stehen als configXY-Befehle zur Verfügung und werden mit Hilfetexten -auch zu den Parameterwerten- in der Detailansicht des FHEM-Device erläutert.

HINWEIS: Bitte auch bei vorhandener XML-Config-Datei nach der Inklusion und bei der Konfiguration die Assoziationen und Parameter prüfen. Von den eigenen Vorstellungen abweichende Vorgaben oder gar Fehler in der Config-Datei können nie ausgeschlossen werden. Fehler bitte im Forum ({{Link2Forum|Area=ZWave}}) melden.

=== Wie können fehlende XML-Config-Informationen für mein ZWave-Gerät in FHEM eingebunden werden? ===
Die XML-Config-Informationen von FHEM sind in folgenden Dateien im Ordner fhem/FHEM/lib gespeichert:
* openzwave_manufacturer_specific.xml
* openzwave_deviceconfig.xml.gz
* fhem_zwave_deviceconfig.xml.gz
Die in den Dateien enthaltenen Informationen beruhen in großen Teilen auf Daten von openzwave und übernehmen daher das openzwave-Datenformat, das unter https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices näher beschrieben wird.

Die Datei "openzwave_manufacturer_specific.xml" enthält die eindeutige Kennung des ZWave-Gerätes, die in FHEM nach Aufruf des Befehls <code>get <name> model</code> im Reading <code>modelId</code> des FHEM-ZWave-Devices steht. Weiterhin wird der Klartextname dieses Gerätes, der im Reading <code>model</code> angezeigt werden soll, festgelegt. Zudem wird der Dateiname der eigentlichen XML-Config-Datei für das ZWave-Gerät angegeben, der später informativ im Reading <code>modelConfig</code> steht.

Die Dateien "openzwave_deviceconfig.xml.gz" und "fhem_zwave_deviceconfig.xml.gz" enthalten in komprimierter Form die eigentlichen XML-Config-Dateien für die ZWave-Geräte. FHEM durchsucht beide Dateien nach der passenden XML-Config-Datei. Ist in beiden Dateien eine XML-Config für ein Gerät vorhanden, so werden die XML-Daten aus der "fhem_zwave_deviceconfig.xml.gz" bevorzugt.

Falls ein ZWave-Gerät von FHEM nicht erkannt wird, bitte auf folgenden Seiten nachschauen, ob es schon XML-Config-Dateien gibt, die nur nicht in FHEM eingebunden sind:
# https://github.com/OpenZWave/open-zwave/tree/master/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# https://github.com/jeedom/plugin-openzwave/tree/master/ressources/openzwave/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner
# http://www.cd-jackson.com/index.php/zwave/zwave-device-database
Sofern auf den genannten Seiten Daten vorhanden sind, postet eine Aktualisierungsbitte mit genauem Link zur entsprechenden Seite im Forum ({{Link2Forum|Area=ZWave}}).

Gibt es auf keiner der Seiten Infos zu dem Gerät, dann entsprechend https://github.com/OpenZWave/open-zwave/wiki/Adding-Devices die XML-Config-Datei für das Gerät erstellen und unkomprimiert zusammen mit der zu ergänzenden Info für die Datei "openzwave_manufacturer_specific.xml" im Forum ({{Link2Forum|Area=ZWave}}) zur Verfügung stellen.

=== Wie führt man eine Komplett-Sicherung der ZWave-Installation durch? ===
Zu einer Komplett-Sicherung der ZWave-Konfiguration gehören:

1. [[Backup]] der FHEM-Installation
::'''und'''
2. Backup des NVRAM des Controllers

Es genügt nicht nur die FHEM-Installation/Konfiguration zu sichern, da der Controller im NVRAM Daten über HomeID, NodeIDs usw. speichert, die in der FHEM-Installation nicht enthalten sind und auch nicht durch FHEM rekonstruierbar sind.

zu 2.) Backup des NVRAM des Controllers

Einige Controllerhersteller bieten eine eigenständige Software zum Backup/Restore an (siehe Hinweise zu den Controllern unter [[#Autocreate_des_Gateways]]).

FHEM kann mit den ZWDongle-Befehlen <code>backupCreate</code> das NVRAM der Controller sichern und mit <code>backupRestore</code> zurückschreiben. Da das Speicherlayout des NVRAM unter anderem von Controller-Hersteller, SDK und Firmwareversion abhängig sein kann, sollte man die Sicherung und Wiederherstellung des eigenen Controllers (auf eigenes Risiko) testen und sinnvollerweise einen gleichen Ersatzcontroller wie den Controller des Produktivsystem besitzen. Erfolgreiche Sicherung/Wiederherstellung wurde im Forum von den ZWavePlus-Controllern UZB1 (256k), Razberry (256k), Vision ZU 1401-5 EU (128k)und AEOTEC Z-Stick Gen5 (256k) berichtet.
(Weitergehende Infos - neben der {{Link2CmdRef}} - im Forum: {{Link2Forum|Topic=52364}}, {{Link2Forum|Topic=52914}}, {{Link2Forum|Topic=53023}})

=== Wie kann ich zur Fortentwicklung der ZWave-Module beitragen? ===
* Erfolgreichen Einsatz von neuen/bisher nicht gemeldeten ZWave-Geräten im Forum mitteilen
* Codeschnipsel und Ideen im Forum posten
* Fehler und Probleme im Forum melden
* [[How_to_write_a_patch|Patches]] für 00_ZWDongle.pm und 10_ZWave.pm erstellen
* Wiki: Ergänzungen und Korrekturen vornehmen; neue Geräte ins Wiki aufnehmen; Codeschnipsel und Beispiele einpflegen

=== Wie wird ein fehlendes Kernelmodul (Fritzbox) eingebunden? ===
Auf der Fritzbox (und evtl. auch anderen Systemen) muss sichergestellt werden, dass das Kernelmodul für das Gateway geladen wird. Ansonsten scheitert die Einbindung des Gateways in FHEM.

Für den Aeon Labs Z-Stick muss beispielsweise auf der Fritzbox das Kernelmodul <code>cp2101.ko</code> geladen werden.
Diese Datei ist bei einer [[FHEM und FritzBox 7390]] Installation über das Image von [http://www.fhem.de fhem.de] bereits enthalten.
Um den Aeon Labs Z-Stick zu verwenden, muss dieses Kernelmodul vor oder beim Starten des FHEM-Servers geladen sein. Dies erreicht man durch einen Eintrag in der Datei <code>startfhem</code>.

Die entsprechende Zeile kann direkt unterhalb der modprobe Anweisungen eingefügt werden.
insmod $home/lib/cp2101.ko

Nach einem FHEM-Neustart sollte das Gateway (der USB Stick) nun erkannt werden.

=== Wie ist der Aufbau der Z-Wave Messages bzw. wie finde ich bei einem Sendefehler die NodeId des Empfängers heraus? ===

Es könnte natürlich hin und wieder vorkommen, dass man im FHEM-Log folgende Fehler vorfindet:

<code><nowiki>ZWDongle_ProcessSendStack: no ACK, resending message 010a00130603320110259277</nowiki></code>

In diesem Fall gab es aus irgendeinem Grund einmalig das Problem, dass der Empfang einer Nachricht vom Empfänger nicht bestätigt wurde.
Will man dem auf die Spur kommen, so wäre es natürlich von Vorteil, die NodeId des Empfängers herauszufinden. Also muss man sich die Message näher anschauen:

<code><nowiki>010a00130603320110259277</nowiki></code>
* 01: data to controller
* 0a: length of msg
* 00: ?
* 13: ZW_SEND_DATA
* 06: NodeId

* 03: length of msg
* 32: Command Class 32 (METER, siehe %zwave_class in 10_ZWave.pm)
* 01: METER get scale command
* 10: scale parameter

* 25: send flags, explorer frames on
* 92: callbackId (um ACK zu identifizieren)
* 77: checkSum

In diesem Fall hat der Z-Wave-Controller 01 eine Nachricht an die NodeId 06 geschickt, welche vom Node nicht bestätigt wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components|!]]
[[Kategorie:868MHz]]

Benutzer Diskussion:Michael Mimo

2020-05-20T09:05:09Z

Krikan: Krikan verschob die Seite Benutzer Diskussion:Michael Mimo nach Benutzer Diskussion:Michael Mino: Seite während der Benutzerkontoumbenennung von „Michael Mimo“ in „Michael Mino“ automatisch v…

#WEITERLEITUNG [[Benutzer Diskussion:Michael Mino]]

Benutzer Diskussion:Michael Mino

2020-05-20T09:05:09Z

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo Michael Mimo,''' willkommen im FHEM Wiki!</span></big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Krikan]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Krikan|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 09:42, 20. Mai 2020 (CEST)
|}

== Questions? ==

If you have any questions, please let me know. --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 09:45, 20. Mai 2020 (CEST)

Benutzer Diskussion:Michael Mino

2020-05-20T07:45:46Z

Krikan: Neuer Abschnitt /* Questions? */

Benutzer Diskussion:Michael Mino

2020-05-20T07:42:27Z

Krikan: Begrüßungsseite

Vorlage:FHEMWiki News

2020-01-26T13:51:48Z

Krikan: FHEM 6.0

{|
{{News|26.01.2020|FHEM Version 6.0 wurde freigegeben. Updatehinweise: {{Link2Forum|Topic=107782}}}}
{{News|17.12.2019|Mit dem Modul [[SSChatBot - Integration des Synology Chat Servers|SSChatBot]] kann der Synology Chat Server in FHEM integriert werden. Es können Mitteilungen zwischen FHEM und Chat ausgetauscht sowie Befehle in FHEM ausgeführt werden. }}
{{News|23.09.2019|Das Modul [[CanOverEthernet]] ermöglicht das Empfangen von Can-Over-Ethernet Paketen von Steuerungen der Firma Technische Alternative}}
{{News|05.04.2019|Das [[SamsungAV]] Modul ermöglicht die Steuerung von Samsung Fernsehern und Bluray-Playern.}}
{{News|06.03.2019|Mit dem Modul [[Arlo]] ist die Einbindung von Arlo Kameras über die Arlo Cloud möglich}}
{{News|26.01.2019|Das [[TRÅDFRI|tradfri]] Modul erweitert die Palette der [[ZigBee]] Module.}}
{{News|14.01.2019|Der [[FHEM Connector für Amazon Alexa|FHEM Connector]] Skill für Amazon Alexa ist verfügbar.}}
{{News|02.11.2018|Das Modul [[TA_CMI_UVR16x2_UVR1611|TA_CMI_JSON]] kann Werte des C.M.I. der Firma Technische Alternative auslesen und eignet sich so optimal zum Loggen von Daten zB der UVR16x2 oder UVR1611.}}
{{News|11.09.2018|Mit dem Modul [[AutoShuttersControl|AutoShuttersControl]] oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters. }}
{{News|12.02.2018|Die Module [[Modul Babble|Babble]] und [[Talk2Fhem|Talk2Fhem]] erweitern die Sprachsteuerungsmöglichkeiten von FHEM}}
{{News|02.10.2017|[[FTUI eigene Widgets|Eigene Widgets für FHEM Tablet UI erstellen]]}}
{{News|30.08.2017|[[WINCONNECT]] - Windows PC steuern und Informationen abfragen/anzeigen. }}
{{News|24.08.2017|[[FHEMWEB/Widgets]] - Widgets (Frontendelemente) von FHEMWEB }}
{{News|24.08.2017|Neues Modul [[Modul_YAAHM|YAAHM]] wird per update verteilt. Es stellt eine Oberfläche bereit, um per Webinterface die zyklische Ausführung von Kommandos - mit Tages- und Wochenprofil - zu konfigurieren}}
{{News|24.07.2017|[[Telnet|Verbindung mit dem FHEM-Server per Telnet]]}}
{{News|20.07.2017|[[FHEM startet nicht - Tipps zur Fehlersuche]]}}
{{News|06.06.2017|[[‎Relaisplatine-Homebrew-MySensors|MySensors-Relaisplatine im Selbstbau]]}}
{{News|31.05.2017|[[Datenbankgestützte_Erstellung_der_Energiebilanz_einer_SMA_PV-Anlage_mit_Überschußeinspeisung|Datenbankgestützte Erstellung der Energiebilanz einer PV-Anlage mit Überschußeinspeisung]]}}
{{News|30.04.2017|[[DoorPiBoard]]: Eine Platine zur Umsetzung des [[DoorPi_und FHEM|DoorPi-Projektes]]}}
{{News|21.03.2017|Artikel zum alternativen Frontend [[:Kategorie:FHEM_Tablet_UI|Tablet UI]] aktualisiert und deutlich erweitert}}
{{News|02.03.2017|Neues Modul zur Ansteuerung von [[LGTV_WebOS|LG-TVs mit dem Betriebssystem WebOS]] wird per update verteilt}}
{{News|20.02.2017|Neues Modul [[SIP-Client|SIP]], ein SIP-Client für FHEM, wird per update verteilt}}
{{News|19.02.2017|FHEM Version 5.8 wurde freigegeben. Updatehinweise beachten: {{Link2Forum|Topic=67419}}}}
{{News|18.01.2017|Neues Modul [[DOIFtools]] mit Funktionen zur Unterstützung des Benutzers im Umgang mit [[DOIF]] wird per update verteilt}}
{{News|12.01.2017|Neues Modul zur Ansteuerung des Bluetooth 4.1 BLE Pflanzensensors [[XiaomiFlowerSens|Xiaomi Flower Care Smart Monitor]] wird per update ausgeliefert}}
{{News|01.01.2017|Diverse neue Wiki-Artikel mit Informationen und Hilfen zu [[DOIF#Links|DOIF]] }}
{{News|10.12.2016|FHEM Wiki ist auf einen neuen Server umgezogen und hat eine neue Standard-Internetadresse: https://wiki.fhem.de}}
{{News|21.11.2016|Neues Modul [[Modul_PostMe|PostMe]] stellt eine komfortable Oberfläche zur Listenverwaltung bereit}}
{{News|11.10.2016|Neue Module [[NUKI|NUKIbridge und NUKIDevice]] zur Ansteuerung des Nuki Smartlock werden per update verteilt}}
{{News|07.10.2016|Neues Modul [[TRAFFIC]] zur Erfassung der Fahrzeiten bei aktueller Verkehrslage mittels Google Maps Directions API wird per update verteilt}}
{{News|19.07.2016|Neues Modul zur Unterstützung der HomeMatic-Interfaces [[HM-MOD-RPI-PCB_HomeMatic_Funkmodul_für_Raspberry_Pi|Funkmodul für Raspberry Pi]] und [[HM-LGW-O-TW-W-EU_Funk-LAN_Gateway|Funk-LAN Gateway]] wird per update verteilt }}
{{News|12.07.2016|Neues Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten]] wird per update verteilt }}
{{News|08.02.2016|Neues Modul [[Mediaportal|MEDIAPORTAL]] (Steuerung einer Mediaportal-Installation über Wifiremote) wird per update verteilt}}
{{News|16.11.2015|Neues Modul [[HP1000]] (Einbindung einer HP1000 Wetterstation) wird per update verteilt}}
{{News|16.11.2015|Neuer FHEM Befehl [[msg]] (Intelligentes Versenden/Routing von Nachrichten der Typen Audio,Text,Mail,Push,Light,Screen) wird per update verteilt}}
{{News|15.11.2015|FHEM Version 5.7 wurde veröffentlicht. Unbedingt Updatehinweise beachten: {{Link2Forum|Topic=44094}}}}
{{News|30.10.2015|FHEM Wiki unterstützt nun [[Syntax Highlighting]]}}
{{News|18.10.2015|Neues Modul [[TechemHKV]] (Empfang von Daten eines Techem Heizkostenverteilers) wird per update verteilt}}
{{News|02.10.2015|Kleiner FHEM-Einsteiger-Kurs als Wiki Artikel unter [[Erste_Schritte_in_fhem|Erste Schritte in FHEM]]}}
{{News|24.09.2015|Umfangreiche Überarbeitung der Wiki Artikel über [[:Kategorie:panStamp|panStamp Hardware und Software]]}}
{{News|11.09.2015|Neues Modul [[AMAD]] (Steuern und Informationsanzeige von Android-Geräten) wird per update verteilt}}
{{News|15.06.2015|Neues Modul [[yowsup]] (WhatsApp Unterstützung) wird per update verteilt}}
{{News|03.04.2015|Neues Geräte-Modul [[JawboneUp]] wird per update verteilt}}
{{News|23.03.2015|Neue Geräte-Module [[Modbus]], [[ModbusAttr]] und [[Modbus#Writing_modules_for_devices_using_this_module_as_a_library|ModbusSET]] werden per update verteilt}}
{{News|10.02.2015|FHEM Wiki ist auf einen neuen Server umgezogen und [[FHEMWiki:Interna#Offene_Probleme|Aktualisierung der MediaWiki-Software]]}}
{{News|31.01.2015|Neues Geräte-Modul [[Pushbullet]] wird per update verteilt}}
{{News|14.01.2015|Neues Hilfs-Modul [[CALVIEW]] wird per update verteilt}}
{{News|08.01.2015|Neues Geräte-Modul [[Buderus_Web_Gateway|km200]] zur Anbindung eines Buderus Web-Gateways wird per update verteilt}}
{{News|18.12.2014|Neues Geräte-Modul [[SONOS]] wird per update verteilt}}
{{News|15.12.2014|Überarbeitetes und erweitertes Geräte-Modul [[HTTPMOD]] wird per update verteilt}}
{{News|10.12.2014|Neues Geräte-Modul [[Vitotronic_200_(Viessmann_Heizungssteuerung)|VCONTROL]] zur Anbindung einer Viessmann Heizung wird per update verteilt}}
{{News|17.11.2014|Neues Hilfs-Modul [[logProxy]] wird per update verteilt}}
{{News|09.11.2014|FHEM Version 5.6 wurde veröffentlicht}}
{{News|27.10.2014|Neues Geräte-Modul [[harmony]] zur FHEM-Anbindung Logitech Harmony Hub basierter Fernbedienungen wird per update verteilt}}
{{News|25.10.2014|Neues Geräte-Modul [[KostalPiko|KOSTALPIKO]] wird per update verteilt}}
{{News|24.10.2014|Neues Hilfs-Modul [[HourCounter]] wird per update verteilt}}
{{News|06.09.2014|Neues Hilfs-Modul [[CustomReadings]] per update verteilt}}
{{News|19.08.2014|Neues Hilfs-Modul [[DOIF]] wird per update verteilt}}
{{News|19.08.2014|Der Befehl [[update]] wurde überarbeitet: {{Link2Forum|Topic=26311}} }}
{{News|13.08.2014|Zusätzliche Domäne fhem.org aktiviert: {{Link2Forum|Topic=26113}} }}
{{News|29.09.2013|FHEM Version 5.5 wurde veröffentlicht}}
{{News|11.05.2013|Die meisten Daten aus dem FhemWiki sind wieder hergestellt.}}
{{News|04.05.2013|FHEM Wiki wird neu aufgebaut.}}
{{News|04.05.2013|FHEM Wiki Update zu [[Special:Version|MediaWiki 1.20.5]].}}
|}