FHEMWiki - Benutzerbeiträge [de]

Vitoconnect

2019-03-09T10:25:08Z

Scooty:

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

Mit dem FHEM Modul [[vitoconnect]] können die Daten, die über die Internetschnittstelle an den Herstellerserver gemeldet und von diesem über eine API zur Verfügung gestellt werden, in FHEM in Form von Readings angezeigt werden. Auch eine Steuerung der Heizung ist mit diesem Modul möglich.

Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann API erfolgen, sollte die Nutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

User und Passwort sind das gleiche wie in der ViCare App.

Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>
<code>set vitoconnect password correctPassword 60</code>

== Readings ==
===Readings ===
Die Readings werden so ausgegeben, wie sie von der API geliefert werden! Alle Reading für HK1 sind auch für HK2 und HK3 verfügbar sofern die Heizung solche Readings liefert.

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung
|-
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1
|-
| || ||
|-
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?
|-
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
|Aussentemperatur || 2.4 ||Außentemperatur in °C
|-
| || ||
|-
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden
|-
|Brenner_Fehlercode || 0 || Brenner Fehlercode
|-
|Brenner_Modulation|| 11 || Brenner Modulation in %
|-
|Brenner_Starts|| 2717 || Brenner Starts
|-
|Brenner_Status || ok ||Brenner Status
|-
|Brenner_aktiv || 0,1|| Brenneraktiv
|-
| || ||
|-
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer
|-
|Device_Time_Offset || 61 || ???
|-
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)
|-
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)
|-
| || ||
|-
|Gasverbrauch_Heizung/Jahr || 3293,0,0 ||Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden) '''(bis zum 09.12.2018 lieferte die API Werte, die noch durch 8 geteilt werden mussten, um auf kWh zu kommen!'''
Außerdem liefert Vissmann für manche Heizungstypen (noch) '''keine getrennten Werte für Heizung und WW'''. D.h. in den Reading für WW und Heizung steht der gleiche Wert (vermutlich der Gesamtverbrauch)!
|-
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_Heizung/Tag || 76,104,113,99,76,65,60,70 ||Liste der täglichen Gasverbräuche Heizung in kWH (aktueller und die letzten 7 Tage)
|-
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Woche || 17,0,37,43,51,50,41,53,52,47,41,52,44,49,41,45,52,47,45,49,51,33,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH
|-
| || ||
|-
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb
|-
| || ||
|-
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?
|-
|HK1-External_aktiv || 0 ||Raumsensor aktiv?
|-
| || ||
|-
|HK1-Frostschutz_Status || on, off ||Frostschutz Status
|-
| || ||
|-
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau
|-
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung
|-
| || ||
|-
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus
|-
|HK1-Raum_Status || error ||Raumsensor?
|-
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"
|-
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx
|-
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv
|-
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur
|-
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv
|-
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur
|-
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv
|-
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen
|-
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal
|-
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert
|-
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv
|-
|HK1-Standby_aktiv || 0,1 || Standby aktiv
|-
| || ||
|-
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende
|-
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start
|-
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv
|-
| || ||
|-
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir
|-
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden
|-
| || ||
|-
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv
|-
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv
|-
|HK1-Zeitsteuerung_Heizung ||
wed start:05:00 mode:normal end:08:00 position:0, mode:normal end:23:00 position:1 start:16:00, sat position:0 end:23:00 mode:normal start:06:00,
thu position:0 mode:normal end:08:00 start:05:00, start:16:00 end:23:00 mode:normal position:1, sun start:06:00 position:0 end:23:00 mode:normal,
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00,
|| Zeitplan für Heizung
|-
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv
|-
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?
|-
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert
|-
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)
|-
|HK1-aktiv || 1 ||HK1 aktiv
|-
| || ||
|-
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)
|-
|Kessel_Status || connected ||xxx
|-
|Kesseltemperatur || 53 ||xxx
|-
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)
|-
|Mehrfamilienhaus_aktiv || 0,1 ||xxx
|-
| || ||
|-
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Intervall_Monate || 0 || ???
|-
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???
|-
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???
|-
|Service_fällig || 0,1 || Service fällig?
|-
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
| || ||
|-
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Monat|| 11860,23713,22851,19264,17924,6013,0,0,0,0,0,0,0 || Stromverbrauch im Monat(analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,
4075,4633,4307,3675,3721,4148,4594,1419,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)
|-
| || ||
|-
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)
|-
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)
|-
|WW-Isttemperatur || 56 || WW Ist-Temperatur
|-
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)
|-
|WW-Solltemperatur || 53 || WW Solltemperatur
|-
|WW-Temperatur_aktiv || connected || WW aktiv
|-
|WW-Zeitplan ||
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0,
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,
thu start:06:30 position:0 mode:on end:22:30,
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,
|| WW Zeitplan
|-
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Zeitplan ||
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,
sun start:04:30 position:0 mode:on end:22:30, sat start:04:30 position:0 end:22:30 mode:on, thu start:04:30 end:22:30 mode:on position:0,
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)
|-
|WW-aktiv || 0,1 || WW aktiv
|-
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv
|-
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert
|-
| || ||
|-
|state || ok, Login failure|| Status
|-

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

Das Modul prüft nicht, ob ein Befehl oder die Parameter für die Heizung sinnvoll und möglich sind. Die API scheint dies mit einem Fehler quittieren.

Befehle für HK1 sind auch für HK2 und HK3 verfügbar.

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung
|-
|update|| ||löst ein Update der Reading zwischen manuell aus
|-
|clearReadings|| || clear all readings immeadiatlely
|-
|password <passwd>||String|| store password in key store
|-
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory
|-
| || ||
|-
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve
|-
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve
|-
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart
|-
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature
|-
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur
|-
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature
|-
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time
|-
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time
|-
|HK1-Urlaub_unschedule|| || remove holiday start and end time
|-
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature
|-
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature
|-
| || ||
|-
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water
|-
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented
|-
|WW-Zeitplan <schedule>|| || not implemented
|-
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature
|-
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature
|}

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|disable|| 0,1 || ||disable updates
|-
|verbose|| 0,1,2,3,4,5 || ||Loglevel
|-
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an
|-
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'
|}

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight>
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },

Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

vitoconnect:HK1-Heizkurve-Niveau
vitoconnect:HK1-Heizkurve-Steigung

vitoconnect:HK1-Programmstatus
vitoconnect:HK1-Raum_Status
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen
vitoconnect:HK1-Solltemperatur_aktiv
vitoconnect:HK1-Solltemperatur_erzwungen
vitoconnect:HK1-Solltemperatur_normal
vitoconnect:HK1-Solltemperatur_reduziert
vitoconnect:HK1-Solltemperatur_reduziert_aktiv
vitoconnect:HK1-Standby_aktiv

vitoconnect:HK1-Urlaub_Ende
vitoconnect:HK1-Urlaub_Start
vitoconnect:HK1-Urlaub_aktiv

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

vitoconnect:HK1-Zirkulationspumpe
<Kessel>
vitoconnect:Kesseltemperatur
vitoconnect:Kesseltemperatur_exact
<WW>
vitoconnect:WW-Aufladung
vitoconnect:WW-Haupttemperatur
vitoconnect:WW-Isttemperatur
vitoconnect:WW-Solltemperatur
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv
vitoconnect:WW-Zirkulationspumpe_Status
vitoconnect:WW-Zirkulationspumpe_primaer
vitoconnect:WW-aktiv
vitoconnect:WW-onTimeCharge_aktiv
vitoconnect:WW-zeitgesteuert_aktiv
</syntaxhighlight>

<syntaxhighlight lang="perl" style="width:90%;">
attr vitoconnect_rg alias Heizung
attr vitoconnect_rg cellStyle {
"c:0"=>'style="text-align:left"',
"c:1"=>'style="text-align:right"',
"r:2"=>'style="text-align:right;;;;font-weight:bold"'
}
attr vitoconnect_rg mapping {
"Aussentemperatur" => "Aussentemperatur",

"Brenner_Betriebsstunden" => "Betriebsstunden",
"Brenner_Fehlercode" => "Fehlercode",
"Brenner_Modulation" => "Modulation",
"Brenner_Starts" => "Starts",
"Brenner_Status" => "Status",
"Brenner_aktiv" => "aktiv",

"HK1-aktiv" => "aktiv",
"HK1-Betriebsart" => "Betriebsart",
"HK1-Frostschutz_Status" => "Frostschutz_Status",
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",
"HK1-Programmstatus" => "Programmstatus",
"HK1-Raum_Status" => "Raum Status",
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",
"HK1-Solltemperatur_normal" => "Solltemperatur normal",
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",
"HK1-Standby_aktiv" => "Standby aktiv",
"HK1-Urlaub_Ende" => "Urlaub Ende",
"HK1-Urlaub_Start" => "Urlaub Start",
"HK1-Urlaub_aktiv" => "Urlaub aktiv",
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",
"HK1-WW_aktiv" => "WW aktiv",
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",

"Kesseltemperatur" => "Kesseltemperatur",
"Kesseltemperatur_exact" => "Kesseltemperatur exact",

"WW-Aufladung" => "Aufladung",
"WW-Haupttemperatur" => "Haupttemperatur",
"WW-Isttemperatur" => "Isttemperatur",
"WW-Solltemperatur" => "Solltemperatur",
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",
"WW-aktiv" => "aktiv",
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"
}

attr vitoconnect_rg nostate 1
attr vitoconnect_rg notime 1
attr vitoconnect_rg room Heizung
attr vitoconnect_rg sortby 1
attr vitoconnect_rg valueFormat { "Brenner_Betriebsstunden" => "%2d" }
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer',
'Brenner_aktiv.1' => 'icoHEIZUNG',
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'
}

attr vitoconnect_rg valueSuffix {
Aussentemperatur => "°C",

Brenner_Betriebsstunden => "h",
Brenner_Modulation => "%",

'HK1-Solltemperatur_normal' => "°C",
'HK1-Solltemperatur_reduziert' => "°C",
'HK1-Vorlauftemperatur' => " °C",

Kesseltemperatur => "°C",
Kesseltemperatur_exact => "°C",

'WW-Solltemperatur' => " °C",
'WW-Isttemperatur' => " °C",

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
<br>

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

<syntaxhighlight style="width:50%;">
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\

attr Heizung_Verbrauch cellStyle { \
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {\
Gasverbrauch_heute => "%.0f kWh",\
Gasverbrauch_WW_heute => "%.0f kWh",\
Stromverbrauch_heute => "%.0f kWh",\
Gasverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_WW_gestern => "%.0f kWh",\
Stromverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\
Stromverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\
Stromverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\
Stromverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_letztes_Jahr => "%.0f kWh",\
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\
Stromverbrauch_letztes_Jahr => "%.0f kWh"\
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Vitoconnect

2019-03-09T10:22:55Z

Scooty:

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

Mit dem FHEM Modul [[vitoconnect]] können die Daten, die über die Internetschnittstelle an den Herstellerserver gemeldet und von diesem über eine API zur Verfügung gestellt werden, in FHEM in Form von Readings angezeigt werden. Auch eine Steuerung der Heizung ist mit diesem Modul möglich.

Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann API erfolgen, sollte die Nutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

User und Passwort sind das gleiche wie in der ViCare App.

Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>
<code>set vitoconnect password correctPassword 60</code>

== Readings ==
===Readings ===
Die Readings werden so ausgegeben, wie sie von der API geliefert werden! Alle Reading für HK1 sind auch für HK2 und HK3 verfügbar sofern die Heizung solche Readings liefert.

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung
|-
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1
|-
| || ||
|-
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?
|-
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
|Aussentemperatur || 2.4 ||Außentemperatur in °C
|-
| || ||
|-
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden
|-
|Brenner_Fehlercode || 0 || Brenner Fehlercode
|-
|Brenner_Modulation|| 11 || Brenner Modulation in %
|-
|Brenner_Starts|| 2717 || Brenner Starts
|-
|Brenner_Status || ok ||Brenner Status
|-
|Brenner_aktiv || 0,1|| Brenneraktiv
|-
| || ||
|-
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer
|-
|Device_Time_Offset || 61 || ???
|-
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)
|-
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)
|-
| || ||
|-
|Gasverbrauch_Heizung/Jahr || 3293,0,0 ||Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden) '''(bis zum 09.12.2018 lieferte die API Werte, die noch durch 8 geteilt werden mussten, um auf kWh zu kommen!'''
Außerdem liefert Vissmann für manche Heizungstypen (noch) '''keine getrennten Werte für Heizung und WW'''. D.h. in den Reading für WW und Heizung steht der gleiche Wert (vermutlich der Gesamtverbrauch)!
|-
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_Heizung/Tag || 76,104,113,99,76,65,60,70 ||Liste der täglichen Gasverbräuche Heizung in kWH (aktueller und die letzten 7 Tage)
|-
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Woche || 17,0,37,43,51,50,41,53,52,47,41,52,44,49,41,45,52,47,45,49,51,33,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH
|-
| || ||
|-
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb
|-
| || ||
|-
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?
|-
|HK1-External_aktiv || 0 ||Raumsensor aktiv?
|-
| || ||
|-
|HK1-Frostschutz_Status || on, off ||Frostschutz Status
|-
| || ||
|-
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau
|-
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung
|-
| || ||
|-
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus
|-
|HK1-Raum_Status || error ||Raumsensor?
|-
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"
|-
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx
|-
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv
|-
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur
|-
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv
|-
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur
|-
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv
|-
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen
|-
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal
|-
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert
|-
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv
|-
|HK1-Standby_aktiv || 0,1 || Standby aktiv
|-
| || ||
|-
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende
|-
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start
|-
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv
|-
| || ||
|-
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir
|-
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden
|-
| || ||
|-
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv
|-
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv
|-
|HK1-Zeitsteuerung_Heizung ||
wed start:05:00 mode:normal end:08:00 position:0, mode:normal end:23:00 position:1 start:16:00, sat position:0 end:23:00 mode:normal start:06:00,
thu position:0 mode:normal end:08:00 start:05:00, start:16:00 end:23:00 mode:normal position:1, sun start:06:00 position:0 end:23:00 mode:normal,
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00,
|| Zeitplan für Heizung
|-
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv
|-
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?
|-
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert
|-
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)
|-
|HK1-aktiv || 1 ||HK1 aktiv
|-
| || ||
|-
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)
|-
|Kessel_Status || connected ||xxx
|-
|Kesseltemperatur || 53 ||xxx
|-
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)
|-
|Mehrfamilienhaus_aktiv || 0,1 ||xxx
|-
| || ||
|-
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Intervall_Monate || 0 || ???
|-
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???
|-
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???
|-
|Service_fällig || 0,1 || Service fällig?
|-
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
| || ||
|-
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Monat|| 11860,23713,22851,19264,17924,6013,0,0,0,0,0,0,0 || Stromverbrauch im Monat(analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,
4075,4633,4307,3675,3721,4148,4594,1419,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)
|-
| || ||
|-
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)
|-
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)
|-
|WW-Isttemperatur || 56 || WW Ist-Temperatur
|-
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)
|-
|WW-Solltemperatur || 53 || WW Solltemperatur
|-
|WW-Temperatur_aktiv || connected || WW aktiv
|-
|WW-Zeitplan ||
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0,
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,
thu start:06:30 position:0 mode:on end:22:30,
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,
|| WW Zeitplan
|-
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Zeitplan ||
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,
sun start:04:30 position:0 mode:on end:22:30, sat start:04:30 position:0 end:22:30 mode:on, thu start:04:30 end:22:30 mode:on position:0,
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)
|-
|WW-aktiv || 0,1 || WW aktiv
|-
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv
|-
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert
|-
| || ||
|-
|state || ok, Login failure|| Status
|-

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

Das Modul prüft nicht, ob ein Befehl oder die Parameter für die Heizung sinnvoll und möglich sind. Die API scheint dies mit einem Fehler quittieren.

Befehle für HK1 sind auch für HK2 und HK3 verfügbar.

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung
|-
|update|| ||löst ein Update der Reading zwischen manuell aus
|-
|clearReadings|| || clear all readings immeadiatlely
|-
|password <passwd>||String|| store password in key store
|-
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory
|-
| || ||
|-
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve
|-
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve
|-
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart
|-
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature
|-
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur
|-
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature
|-
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time
|-
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time
|-
|HK1-Urlaub_unschedule|| || remove holiday start and end time
|-
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature
|-
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature
|-
| || ||
|-
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water
|-
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented
|-
|WW-Zeitplan <schedule>|| || not implemented
|-
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature
|-
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature
|}

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|disable|| 0,1 || ||disable updates
|-
|verbose|| 0,1,2,3,4,5 || ||Loglevel
|-
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an
|-
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'
|}

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight>
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },

Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

vitoconnect:HK1-Heizkurve-Niveau
vitoconnect:HK1-Heizkurve-Steigung

vitoconnect:HK1-Programmstatus
vitoconnect:HK1-Raum_Status
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen
vitoconnect:HK1-Solltemperatur_aktiv
vitoconnect:HK1-Solltemperatur_erzwungen
vitoconnect:HK1-Solltemperatur_normal
vitoconnect:HK1-Solltemperatur_reduziert
vitoconnect:HK1-Solltemperatur_reduziert_aktiv
vitoconnect:HK1-Standby_aktiv

vitoconnect:HK1-Urlaub_Ende
vitoconnect:HK1-Urlaub_Start
vitoconnect:HK1-Urlaub_aktiv

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

vitoconnect:HK1-Zirkulationspumpe
<Kessel>
vitoconnect:Kesseltemperatur
vitoconnect:Kesseltemperatur_exact
<WW>
vitoconnect:WW-Aufladung
vitoconnect:WW-Haupttemperatur
vitoconnect:WW-Isttemperatur
vitoconnect:WW-Solltemperatur
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv
vitoconnect:WW-Zirkulationspumpe_Status
vitoconnect:WW-Zirkulationspumpe_primaer
vitoconnect:WW-aktiv
vitoconnect:WW-onTimeCharge_aktiv
vitoconnect:WW-zeitgesteuert_aktiv
</syntaxhighlight>

<syntaxhighlight lang="perl" style="width:90%;">
attr vitoconnect_rg alias Heizung
attr vitoconnect_rg cellStyle {
"c:0"=>'style="text-align:left"',
"c:1"=>'style="text-align:right"',
"r:2"=>'style="text-align:right;;;;font-weight:bold"'
}
attr vitoconnect_rg mapping {
"Aussentemperatur" => "Aussentemperatur",

"Brenner_Beriebsstunden" => "Beriebsstunden",
"Brenner_Fehlercode" => "Fehlercode",
"Brenner_Modulation" => "Modulation",
"Brenner_Starts" => "Starts",
"Brenner_Status" => "Status",
"Brenner_aktiv" => "aktiv",

"HK1-aktiv" => "aktiv",
"HK1-Betriebsart" => "Betriebsart",
"HK1-Frostschutz_Status" => "Frostschutz_Status",
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",
"HK1-Programmstatus" => "Programmstatus",
"HK1-Raum_Status" => "Raum Status",
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",
"HK1-Solltemperatur_normal" => "Solltemperatur normal",
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",
"HK1-Standby_aktiv" => "Standby aktiv",
"HK1-Urlaub_Ende" => "Urlaub Ende",
"HK1-Urlaub_Start" => "Urlaub Start",
"HK1-Urlaub_aktiv" => "Urlaub aktiv",
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",
"HK1-WW_aktiv" => "WW aktiv",
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",

"Kesseltemperatur" => "Kesseltemperatur",
"Kesseltemperatur_exact" => "Kesseltemperatur exact",

"WW-Aufladung" => "Aufladung",
"WW-Haupttemperatur" => "Haupttemperatur",
"WW-Isttemperatur" => "Isttemperatur",
"WW-Solltemperatur" => "Solltemperatur",
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",
"WW-aktiv" => "aktiv",
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"
}

attr vitoconnect_rg nostate 1
attr vitoconnect_rg notime 1
attr vitoconnect_rg room Heizung
attr vitoconnect_rg sortby 1
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer',
'Brenner_aktiv.1' => 'icoHEIZUNG',
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'
}

attr vitoconnect_rg valueSuffix {
Aussentemperatur => "°C",

Brenner_Beriebsstunden => "h",
Brenner_Modulation => "%",

'HK1-Solltemperatur_normal' => "°C",
'HK1-Solltemperatur_reduziert' => "°C",
'HK1-Vorlauftemperatur' => " °C",

Kesseltemperatur => "°C",
Kesseltemperatur_exact => "°C",

'WW-Solltemperatur' => " °C",
'WW-Isttemperatur' => " °C",

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
<br>

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

<syntaxhighlight style="width:50%;">
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\

attr Heizung_Verbrauch cellStyle { \
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {\
Gasverbrauch_heute => "%.0f kWh",\
Gasverbrauch_WW_heute => "%.0f kWh",\
Stromverbrauch_heute => "%.0f kWh",\
Gasverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_WW_gestern => "%.0f kWh",\
Stromverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\
Stromverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\
Stromverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\
Stromverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_letztes_Jahr => "%.0f kWh",\
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\
Stromverbrauch_letztes_Jahr => "%.0f kWh"\
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

Vitoconnect

2019-03-09T10:20:53Z

Scooty: Kleine Korrekturen an der Readingsgroup vitoconnect_rg

{{SEITENTITEL:vitoconnect}}
{{Baustelle}}
{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=andreas13 ({{Link2FU|3360|Forum}}/[[Benutzer Diskussion:Andreas13|Wiki]])}}

[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Heizkessel und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

Mit dem FHEM Modul [[vitoconnect]] können die Daten, die über die Internetschnittstelle an den Herstellerserver gemeldet und von diesem über eine API zur Verfügung gestellt werden, in FHEM in Form von Readings angezeigt werden. Auch eine Steuerung der Heizung ist mit diesem Modul möglich.

Wen stört, dass die Daten in der Herstellercloud liegen oder die Heizung heute schon steuern möchte, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

{{Hinweis|Das Modul befindet sich derzeit noch in der Entwicklung.

Das Modul wurde nach besten Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Vissmann API erfolgen, sollte die Nutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}

== Einrichtung ==
=== Vorbereitung ===
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect 100 (Typ OPTO1)
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Die Perl Library libtypes-path-tiny-perl muss installiert sein. Entweder mit '''sudo apt install libtypes-path-tiny-perl''' oder path::tiny via cpan installieren

=== Define des Devices ===
Dann kann das Gerät angelegt werden: <code>define <name> vitoconnect <user> <password> <interval></code>

Z.B. : <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

User und Passwort sind das gleiche wie in der ViCare App.

Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:

<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>
<code>set vitoconnect password correctPassword 60</code>

== Readings ==
===Readings ===
Die Readings werden so ausgegeben, wie sie von der API geliefert werden! Alle Reading für HK1 sind auch für HK2 und HK3 verfügbar sofern die Heizung solche Readings liefert.

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Bedeutung
|-
|Aktive_Heizkreise ||0,1,2 ||Liste der aktiven Heizkreise. 0 entspricht HK1
|-
| || ||
|-
|Aussen_Status || connected/notConnected ||Ist ein Außensensor angeschlossen?
|-
| ''Aussen_StatusWired'' || connected/notConnected ||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
| ''Aussen_StatusWireless'' || connected/notConnected ||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
|Aussentemperatur || 2.4 ||Außentemperatur in °C
|-
| || ||
|-
|Brenner_Betriebsstunden|| 934.336944444444 || Brenner Betriebsstunden
|-
|Brenner_Fehlercode || 0 || Brenner Fehlercode
|-
|Brenner_Modulation|| 11 || Brenner Modulation in %
|-
|Brenner_Starts|| 2717 || Brenner Starts
|-
|Brenner_Status || ok ||Brenner Status
|-
|Brenner_aktiv || 0,1|| Brenneraktiv
|-
| || ||
|-
|Controller_Seriennummer || 1234567890123456 || Controller Seriennummer
|-
|Device_Time_Offset || 61 || ???
|-
|Fehlereinträge_Historie ||ErrorListChanges||??? (noch nicht implementiert)
|-
|Fehlereinträge_aktive ||ErrorListChanges ||??? (noch nicht implementiert)
|-
| || ||
|-
|Gasverbrauch_Heizung/Jahr || 3293,0,0 ||Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden) '''(bis zum 09.12.2018 lieferte die API Werte, die noch durch 8 geteilt werden mussten, um auf kWh zu kommen!'''
Außerdem liefert Vissmann für manche Heizungstypen (noch) '''keine getrennten Werte für Heizung und WW'''. D.h. in den Reading für WW und Heizung steht der gleiche Wert (vermutlich der Gesamtverbrauch)!
|-
|Gasverbrauch_Heizung/Monat || 1078,1384,590,241,0,0,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_Heizung/Tag || 76,104,113,99,76,65,60,70 ||Liste der täglichen Gasverbräuche Heizung in kWH (aktueller und die letzten 7 Tage)
|-
|Gasverbrauch_Heizung/Woche ||555,409,416,472,289,196,254,209,24,46,
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
|| Liste der wöchentlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_WW/Jahr || 235,705,0 || Liste der jährlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Monat || 27,208,213,193,215,84,0,0,0,0,0,0,0 ||Liste der monatlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Tag || 2,6,0,0,0,2,9,0 ||Liste der täglichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Woche || 17,0,37,43,51,50,41,53,52,47,41,52,44,49,41,45,52,47,45,49,51,33,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 ||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH
|-
| || ||
|-
|HK1-Betriebsart ||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal ||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb
|-
| || ||
|-
|HK1-External_Temperatur || 0 ||Temperatur Raumsensor?
|-
|HK1-External_aktiv || 0 ||Raumsensor aktiv?
|-
| || ||
|-
|HK1-Frostschutz_Status || on, off ||Frostschutz Status
|-
| || ||
|-
|HK1-Heizkurve-Niveau || 0 || Heizkurve-Niveau
|-
|HK1-Heizkurve-Steigung || 1.4 || Heizkurve-Steigung
|-
| || ||
|-
|HK1-Programmstatus || standby, reduced, normal, forcedReduced, forcedNormal ||Programmstatus
|-
|HK1-Raum_Status || error ||Raumsensor?
|-
|HK1-Raum_Temperatur || 20 ||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"
|-
|HK1-Reduzierte_Temperatur_erzwungen || 0,1 ||xxx
|-
|HK1-Solltemperatur_aktiv || 0,1 || Solltemperatur aktiv
|-
|HK1-Solltemperatur_comfort || 22 || Comfort Solltemeratur
|-
|HK1-Solltemperatur_comfort_aktiv || 0,1 || Comfort aktiv
|-
|HK1-Solltemperatur_eco || 24 || Eco Solltemperatur
|-
|HK1-Solltemperatur_eco_aktiv || 0,1 || Eco aktiv
|-
|HK1-Solltemperatur_erzwungen || 0,1 || Solltemperatur erzwungen
|-
|HK1-Solltemperatur_normal || 24 || Solltemperatur normal
|-
|HK1-Solltemperatur_reduziert || 16 || Solltemperatur reduziert
|-
|HK1-Solltemperatur_reduziert_aktiv || 0,1 || Reduziert aktiv
|-
|HK1-Standby_aktiv || 0,1 || Standby aktiv
|-
| || ||
|-
|HK1-Urlaub_Ende || 2019-02-16T00:00:00.000Z ||Urlaubsabsenkung Ende
|-
|HK1-Urlaub_Start || 2019-02-02T23:59:59.000Z ||Urlaubsabsenkung Start
|-
|HK1-Urlaub_aktiv || 0,1 || Urlaubsabsenkung aktiv
|-
| || ||
|-
|HK1-Vorlauftemperatur || 81 || Vorlauftemperatir
|-
|HK1-Vorlauftemperatur_aktiv || connected || Vorlauftemperatursensor verbunden
|-
| || ||
|-
|HK1-WW_aktiv || 0,1 ||Modus WW (dhw) aktiv
|-
|HK1-WW_und_Heizen_aktiv || 0,1 || Modus WW und Heizen (dhwAndHeating) aktiv
|-
|HK1-Zeitsteuerung_Heizung ||
wed start:05:00 mode:normal end:08:00 position:0, mode:normal end:23:00 position:1 start:16:00, sat position:0 end:23:00 mode:normal start:06:00,
thu position:0 mode:normal end:08:00 start:05:00, start:16:00 end:23:00 mode:normal position:1, sun start:06:00 position:0 end:23:00 mode:normal,
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00,
|| Zeitplan für Heizung
|-
|HK1-Zeitsteuerung_Heizung_aktiv || 0,1 || Zeitplan Heizung aktiv
|-
|''HK1-Zeitsteuerung_Zirkulation'' || 0,1 || Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?
|-
|''HK1-Zeitsteuerung_Zirkulation_aktiv'' || 0,1 || Zirkulationspumpe zeitgesteuert
|-
| HK1-Zirkulationspumpe || on,off || Zirkulationspumpe aktiv (neu seit 16.12.18?)
|-
|HK1-aktiv || 1 ||HK1 aktiv
|-
| || ||
|-
|Kessel_Common_Supply || error || ??? (neu seit 16.12.18?)
|-
|Kessel_Status || connected ||xxx
|-
|Kesseltemperatur || 53 ||xxx
|-
|Kesseltemperatur_exact|| 53 ||??? (neu seit 16.12.18?)
|-
|Mehrfamilienhaus_aktiv || 0,1 ||xxx
|-
| || ||
|-
|''Service_Betriebsstunden_seit_letzten'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|''Service_Intervall_Betriebsstunden'' || 0 ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Intervall_Monate || 0 || ???
|-
|Service_Letzter || 1970-01-01T00:00:00.000Z || ???
|-
|''Service_Letzter_brennerbasiert'' || 1970-01-01T00:00:00.000Z ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Monate_aktiv_seit_letzten_Service || 0 || ???
|-
|Service_fällig || 0,1 || Service fällig?
|-
|''Service_fällig_brennerbasiert'' || ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
| || ||
|-
|Stromverbrauch/Jahr|| 35573,66052,0 || Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Monat|| 11860,23713,22851,19264,17924,6013,0,0,0,0,0,0,0 || Stromverbrauch im Monat(analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Tag|| 409,828,720,733,731,727,708,682 || Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Woche|| 4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,
4075,4633,4307,3675,3721,4148,4594,1419,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
|| Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)
|-
| || ||
|-
|WW-Aufladung|| 0,1 || WW Vorrat wird erhitzt (neu seit 16.12.18?)
|-
|WW-Haupttemperatur|| 54 || ?? (neu seit 16.12.18?)
|-
|WW-Isttemperatur || 56 || WW Ist-Temperatur
|-
|WW-Sensoren_Auslauf_Status|| error || ??? (neu seit 16.12.18?)
|-
|WW-Solltemperatur || 53 || WW Solltemperatur
|-
|WW-Temperatur_aktiv || connected || WW aktiv
|-
|WW-Zeitplan ||
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0,
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,
thu start:06:30 position:0 mode:on end:22:30,
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,
|| WW Zeitplan
|-
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv || 0,1 || Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Status|| on || Status Zirkulationspumpe(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Zeitplan ||
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,
sun start:04:30 position:0 mode:on end:22:30, sat start:04:30 position:0 end:22:30 mode:on, thu start:04:30 end:22:30 mode:on position:0,
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,
|| Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_primaer|| off || (neu seit 16.12.18?)
|-
|WW-aktiv || 0,1 || WW aktiv
|-
|WW-onTimeCharge_aktiv || 0,1 || einmaliges WW Aufladen aktiv
|-
|WW-zeitgesteuert_aktiv || 0,1 || WW zeitgesteuert
|-
| || ||
|-
|state || ok, Login failure|| Status
|-

|}

== Settings ==

===Set Befehle ===
'''Benutzung der Set-Befehle auf eigenes Risiko!'''

Das Modul prüft nicht, ob ein Befehl oder die Parameter für die Heizung sinnvoll und möglich sind. Die API scheint dies mit einem Fehler quittieren.

Befehle für HK1 sind auch für HK2 und HK3 verfügbar.

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Beschreibung
|-
|update|| ||löst ein Update der Reading zwischen manuell aus
|-
|clearReadings|| || clear all readings immeadiatlely
|-
|password <passwd>||String|| store password in key store
|-
|logResponseOnce|| || dumps the json response of Vissmann server to entities.json, gw.json, actions.json in FHEM log directory
|-
| || ||
|-
|HK1-Heizkurve-Niveau <shift>||-13 bis 40 || set shift of heating curve
|-
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5 || set slope of heating curve
|-
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal ||set HK1-Betriebsart
|-
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature
|-
|HK1-Solltemperatur_comfort <targetTemperature>|| || set comfort target temperatur
|-
|HK1-Solltemperatur_eco_aktiv activate,deactivate || || activate/deactivate eco temperature
|-
|HK1-Urlaub_Start <start>|| 2019-02-02T23:59:59.000Z|| set holiday start time
|-
|HK1-Urlaub_Ende <end>||2019-02-16T00:00:00.000Z || set holiday end time
|-
|HK1-Urlaub_unschedule|| || remove holiday start and end time
|-
|HK1-Solltemperatur_normal <targetTemperature>|| 3 and 37|| sets the normale target temperature
|-
|HK1-Solltemperatur_reduziert <targetTemperature>|| 3 and 37|| sets the reduced target temperature
|-
| || ||
|-
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water
|-
|WW-Zirkulationspumpe_Zeitplan <schedule>|| || not implemented
|-
|WW-Zeitplan <schedule>|| || not implemented
|-
|WW-Haupttemperatur <targetTemperature>||10 and 60 || sets hot water main temperature to targetTemperature
|-
|WW-Solltemperatur <targetTemperature>|| 10 and 60|| sets hot water temperature to targetTemperature
|}

== Get ==

Derzeit gibt es keine "get"-Kommandos.

{|class="wikitable"
|-
! Name !! Beschreibung
|-
| ||
|}

== Attribute ==

===Attribute ===

{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|disable|| 0,1 || ||disable updates
|-
|verbose|| 0,1,2,3,4,5 || ||Loglevel
|-
|vitoconnect_raw_readings|| 0,1 || ||lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an
|-
|vitoconnect_actions_active|| 0,1 || || erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'
|}

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight>attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight>

=== Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen ===
<syntaxhighlight>
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },

Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }

</syntaxhighlight>

=== ReadingsGroup für eine kompakte Darstellung ===

<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Beriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

vitoconnect:HK1-Heizkurve-Niveau
vitoconnect:HK1-Heizkurve-Steigung

vitoconnect:HK1-Programmstatus
vitoconnect:HK1-Raum_Status
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen
vitoconnect:HK1-Solltemperatur_aktiv
vitoconnect:HK1-Solltemperatur_erzwungen
vitoconnect:HK1-Solltemperatur_normal
vitoconnect:HK1-Solltemperatur_reduziert
vitoconnect:HK1-Solltemperatur_reduziert_aktiv
vitoconnect:HK1-Standby_aktiv

vitoconnect:HK1-Urlaub_Ende
vitoconnect:HK1-Urlaub_Start
vitoconnect:HK1-Urlaub_aktiv

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

vitoconnect:HK1-Zirkulationspumpe
<Kessel>
vitoconnect:Kesseltemperatur
vitoconnect:Kesseltemperatur_exact
<WW>
vitoconnect:WW-Aufladung
vitoconnect:WW-Haupttemperatur
vitoconnect:WW-Isttemperatur
vitoconnect:WW-Solltemperatur
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv
vitoconnect:WW-Zirkulationspumpe_Status
vitoconnect:WW-Zirkulationspumpe_primaer
vitoconnect:WW-aktiv
vitoconnect:WW-onTimeCharge_aktiv
vitoconnect:WW-zeitgesteuert_aktiv
</syntaxhighlight>

<syntaxhighlight lang="perl" style="width:90%;">
attr vitoconnect_rg alias Heizung
attr vitoconnect_rg cellStyle {
"c:0"=>'style="text-align:left"',
"c:1"=>'style="text-align:right"',
"r:2"=>'style="text-align:right;;;;font-weight:bold"'
}
attr vitoconnect_rg mapping {
"Aussentemperatur" => "Aussentemperatur",

"Brenner_Beriebsstunden" => "Beriebsstunden",
"Brenner_Fehlercode" => "Fehlercode",
"Brenner_Modulation" => "Modulation",
"Brenner_Starts" => "Starts",
"Brenner_Status" => "Status",
"Brenner_aktiv" => "aktiv",

"HK1-aktiv" => "aktiv",
"HK1-Betriebsart" => "Betriebsart",
"HK1-Frostschutz_Status" => "Frostschutz_Status",
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",
"HK1-Programmstatus" => "Programmstatus",
"HK1-Raum_Status" => "Raum Status",
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",
"HK1-Solltemperatur_normal" => "Solltemperatur normal",
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",
"HK1-Standby_aktiv" => "Standby aktiv",
"HK1-Urlaub_Ende" => "Urlaub Ende",
"HK1-Urlaub_Start" => "Urlaub Start",
"HK1-Urlaub_aktiv" => "Urlaub aktiv",
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",
"HK1-WW_aktiv" => "WW aktiv",
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",

"Kesseltemperatur" => "Kesseltemperatur",
"Kesseltemperatur_exact" => "Kesseltemperatur exact",

"WW-Aufladung" => "Aufladung",
"WW-Haupttemperatur" => "Haupttemperatur",
"WW-Isttemperatur" => "Isttemperatur",
"WW-Solltemperatur" => "Solltemperatur",
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",
"WW-aktiv" => "aktiv",
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"
}

attr vitoconnect_rg nostate 1
attr vitoconnect_rg notime 1
attr vitoconnect_rg room Heizung
attr vitoconnect_rg sortby 1
attr vitoconnect_rg valueFormat { "Brenner_Beriebsstunden" => "%2d" }
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer',
'Brenner_aktiv.1' => 'icoHEIZUNG',
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'
}

attr vitoconnect_rg valueSuffix {
Aussentemperatur => "°C",

Brenner_Beriebsstunden => "h",
Brenner_Modulation => "%",

'HK1-Solltemperatur_normal' => "°C",
'HK1-Solltemperatur_reduziert' => "°C",
'HK1-Vorlauftemperatur' => " °C",

Kesseltemperatur => "°C",
Kesseltemperatur_exact => "°C",

'WW-Solltemperatur' => " °C",
'WW-Isttemperatur' => " °C",

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
<br>

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]

=== ReadingsGroup für eine kompakte Darstellung der Verbräuche ===

<syntaxhighlight style="width:50%;">
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>\
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute\
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern\
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche\
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche\
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat\
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat\
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr\
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr\

attr Heizung_Verbrauch cellStyle { \
"r:1"=>'style="text-align:left;;;;font-weight:bold"',\
"c:1"=>'style="text-align:right;;;;font-weight:bold"'\
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {\
Gasverbrauch_heute => "%.0f kWh",\
Gasverbrauch_WW_heute => "%.0f kWh",\
Stromverbrauch_heute => "%.0f kWh",\
Gasverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_WW_gestern => "%.0f kWh",\
Stromverbrauch_gestern => "%.0f kWh",\
Gasverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",\
Stromverbrauch_aktuelle_Woche => "%.0f kWh",\
Gasverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",\
Stromverbrauch_letzte_Woche => "%.0f kWh",\
Gasverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",\
Stromverbrauch_aktueller_Monat => "%.0f kWh",\
Gasverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",\
Stromverbrauch_letzter_Monat => "%.0f kWh",\
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",\
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",\
Gasverbrauch_letztes_Jahr => "%.0f kWh",\
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",\
Stromverbrauch_letztes_Jahr => "%.0f kWh"\
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]
[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

==== weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText="Thread zum Modul im Forum"}}

[[Kategorie:Heizungssteuerung]]

FTUI Layout Gridster

2017-09-08T15:53:31Z

Scooty: Werte für meta-Tag gridster_disable korrigiert

<div style="float: right;">__TOC__</div>
Das [[{{PAGENAME}}|Grister Layout]] für [[FHEM Tablet UI]] kann man sich als Schachbrett vorstellen. Es besteht aus Reihen und Spalten, die wiederum einzelne Kacheln enthalten können.
Die gewünschte Anzahl an Spalten und Reihen kann frei festgelegt werden.
Die Kacheln selbst können sich über [[#example2|mehrere Reihen]], [[#example3|mehrere Spalten]] oder [[#example4|beides]] erstrecken.

In der Grundkonfiguration ist es möglich, einzelne Kacheln per Drag&Drop an eine andere Position zu verschieben, sofern in der Kachel ein <header>-Abschnitt vorhanden ist. Dieses Verhalten kann mit dem META-Tag '''gridster_disable''' gesteuert werden. Der Standardwert ist 0, somit ist das Verschieben erlaubt. Der Wert 1 deaktiviert diese Möglichkeit.
<syntaxhighlight lang="html"><meta name="gridster_disable" content="1"></syntaxhighlight>

Ohne spezielle Einstellungen für die Höhe/Breite der Kacheln wird die Kachelgröße dabei automatisch an den verfügbaren Platz auf dem Display (bzw. im Browserfenster) angepasst.

Soll die Größe der Kacheln manuell angepasst werden, gibt es dafür zwei Möglichkeiten:
# Die Anzahl an gewünschten Spalten und Reihen festlegen: Dies geschieht mit den META-Tags '''gridster_cols''' und '''gridster_rows'''. Die Größe der Kacheln wird dabei automatisch berechnet.
# Eine fixe Größe für die Kacheln vorgeben: Dazu werden die META-Tags '''gridster_base_width''' und '''gridster_base_height''' verwendet. Eventuell vorhandene Angaben von ''gridster_cols'' und ''gridster_rows'' werden in diesem Fall ignoriert.
Beide Möglichkeiten in je einem Beispiel:
<syntaxhighlight lang="html">
<meta name="gridster_cols" content="12">
<meta name="gridster_rows" content="9">
</syntaxhighlight>

<syntaxhighlight lang="html">
<meta name="gridster_base_width" content="116">
<meta name="gridster_base_height" content="131">
</syntaxhighlight>

Um ein unschönes "Zusammenschieben" der Kacheln auf kleinen Displays zu vermeiden, können Mindestbreite und -höhe gesetzt werden:
<syntaxhighlight lang="html">
<meta name="gridster_min_width" content="100">
<meta name="gridster_min_height" content="100">
</syntaxhighlight>

Der Abstand zwischen den einzelnen Kacheln kann mit dem META-Tag '''widget_margin''' gesteuert werden. <syntaxhighlight lang="html"><meta name="widget_margin" content="4"></syntaxhighlight>

Eine Kachel selbst wird als HTML-Listenelement (<li>) beschrieben. Dabei muss deren Position ('''data-row''', '''data-col''') angegeben werden, sowie über wie viele Reihen und Spalten sich die Kachel erstreckt ('''data-sizex''', '''data-sizey''').

Eine Kachel in der ersten Reihe (row) und der ersten Spalte (col), die sich über jeweils eine Reihe + Spalte erstreckt, wird somit wie folgt definiert: <syntaxhighlight lang="html"><li data-row="1" data-col="1" data-sizex="1" data-sizey="1"></li></syntaxhighlight>
Eine Kachel, die in der ersten Reihe und in der zweiten Spalte positioniert ist, drei Spalten breit und vier Reihen hoch ist, sieht so aus: <syntaxhighlight lang="html"><li data-row="1" data-col="2" data-sizex="3" data-sizey="4"></li></syntaxhighlight>

==<span id="example1"></span>4x4 Muster==
Hier sind vier Spalten und vier Reihen dargestellt. Eine einzelne Kachel ist dabei eine Spalte breit und eine Zeile hoch. Somit ergibt sich eine Anzahl von 16 Kacheln.

Dieses Beispiel eignet sich sehr gut als Startpunkt für ein Gridster-Design, da man geplante Änderungen an Kachelbreite und -höhe sehr leicht optisch nachvollziehen kann.

[[Datei:FTUI_Layout_Gridster_01.png]]
<syntaxhighlight lang="html">
<body>
<div class="gridster">
<ul>
<li data-row="1" data-col="1" data-sizex="1" data-sizey="1">ROW 1 | COL 1 | X 1 | Y 1</li>
<li data-row="1" data-col="2" data-sizex="1" data-sizey="1">ROW 1 | COL 2 | X 1 | Y 1</li>
<li data-row="1" data-col="3" data-sizex="1" data-sizey="1">ROW 1 | COL 3 | X 1 | Y 1</li>
<li data-row="1" data-col="4" data-sizex="1" data-sizey="1">ROW 1 | COL 4 | X 1 | Y 1</li>

<li data-row="2" data-col="1" data-sizex="1" data-sizey="1">ROW 2 | COL 1 | X 1 | Y 1</li>
<li data-row="2" data-col="2" data-sizex="1" data-sizey="1">ROW 2 | COL 2 | X 1 | Y 1</li>
<li data-row="2" data-col="3" data-sizex="1" data-sizey="1">ROW 2 | COL 3 | X 1 | Y 1</li>
<li data-row="2" data-col="4" data-sizex="1" data-sizey="1">ROW 2 | COL 4 | X 1 | Y 1</li>

<li data-row="3" data-col="1" data-sizex="1" data-sizey="1">ROW 3 | COL 1 | X 1 | Y 1</li>
<li data-row="3" data-col="2" data-sizex="1" data-sizey="1">ROW 3 | COL 2 | X 1 | Y 1</li>
<li data-row="3" data-col="3" data-sizex="1" data-sizey="1">ROW 3 | COL 3 | X 1 | Y 1</li>
<li data-row="3" data-col="4" data-sizex="1" data-sizey="1">ROW 3 | COL 4 | X 1 | Y 1</li>

<li data-row="4" data-col="1" data-sizex="1" data-sizey="1">ROW 4 | COL 1 | X 1 | Y 1</li>
<li data-row="4" data-col="2" data-sizex="1" data-sizey="1">ROW 4 | COL 2 | X 1 | Y 1</li>
<li data-row="4" data-col="3" data-sizex="1" data-sizey="1">ROW 4 | COL 3 | X 1 | Y 1</li>
<li data-row="4" data-col="4" data-sizex="1" data-sizey="1">ROW 4 | COL 4 | X 1 | Y 1</li>
</ul>
</div>
</body>
</syntaxhighlight>

==<span id="example2"></span>Kacheln mit verschiedenen Breiten==
[[Datei:FTUI_Layout_Gridster_02.png]]
<syntaxhighlight lang="html">
<body>
<div class="gridster">
<ul>
<li data-row="1" data-col="1" data-sizex="1" data-sizey="1">ROW 1 | COL 1 | X 1 | Y 1</li>
<li data-row="1" data-col="2" data-sizex="1" data-sizey="1">ROW 1 | COL 2 | X 1 | Y 1</li>
<li data-row="1" data-col="3" data-sizex="1" data-sizey="1">ROW 1 | COL 3 | X 1 | Y 1</li>
<li data-row="1" data-col="4" data-sizex="1" data-sizey="1">ROW 1 | COL 4 | X 1 | Y 1</li>

<li data-row="2" data-col="1" data-sizex="2" data-sizey="1">ROW 2 | COL 1 | X 2 | Y 1</li>
<li data-row="2" data-col="3" data-sizex="2" data-sizey="1">ROW 2 | COL 3 | X 2 | Y 1</li>

<li data-row="3" data-col="1" data-sizex="3" data-sizey="1">ROW 3 | COL 1 | X 3 | Y 1</li>
<li data-row="3" data-col="4" data-sizex="1" data-sizey="1">ROW 3 | COL 4 | X 1 | Y 1</li>

<li data-row="4" data-col="1" data-sizex="4" data-sizey="1">ROW 4 | COL 1 | X 4 | Y 1</li>
</ul>
</div>
</body>
</syntaxhighlight>

==<span id="example3"></span>Kacheln mit verschiedenen Höhen==
[[Datei:FTUI_Layout_Gridster_03.png]]
<syntaxhighlight lang="html">
<body>
<div class="gridster">
<ul>
<li data-row="1" data-col="1" data-sizex="1" data-sizey="1">ROW 1 | COL 1 | X 1 | Y 1</li>
<li data-row="1" data-col="2" data-sizex="1" data-sizey="2">ROW 1 | COL 2 | X 1 | Y 2</li>
<li data-row="1" data-col="3" data-sizex="1" data-sizey="3">ROW 1 | COL 3 | X 1 | Y 3</li>
<li data-row="1" data-col="4" data-sizex="1" data-sizey="4">ROW 1 | COL 4 | X 1 | Y 4</li>

<li data-row="2" data-col="1" data-sizex="1" data-sizey="1">ROW 2 | COL 1 | X 1 | Y 1</li>

<li data-row="3" data-col="1" data-sizex="1" data-sizey="1">ROW 3 | COL 1 | X 1 | Y 1</li>
<li data-row="3" data-col="2" data-sizex="1" data-sizey="1">ROW 3 | COL 2 | X 1 | Y 1</li>

<li data-row="4" data-col="1" data-sizex="1" data-sizey="1">ROW 4 | COL 1 | X 1 | Y 1</li>
<li data-row="4" data-col="2" data-sizex="1" data-sizey="1">ROW 4 | COL 2 | X 1 | Y 1</li>
<li data-row="4" data-col="3" data-sizex="1" data-sizey="1">ROW 4 | COL 3 | X 1 | Y 1</li>
</ul>
</div>
</body>
</syntaxhighlight>

==<span id="example4"></span>Kacheln mit verschiedenen Breiten und Höhen==
[[Datei:FTUI_Layout_Gridster_04.png]]
<syntaxhighlight lang="html">
<body>
<div class="gridster">
<ul>
<li data-row="1" data-col="1" data-sizex="1" data-sizey="1">ROW 1 | COL 1 | X 1 | Y 1</li>
<li data-row="1" data-col="2" data-sizex="1" data-sizey="1">ROW 1 | COL 2 | X 1 | Y 1</li>
<li data-row="1" data-col="3" data-sizex="2" data-sizey="1">ROW 1 | COL 3 | X 2 | Y 1</li>

<li data-row="2" data-col="1" data-sizex="2" data-sizey="2">ROW 2 | COL 1 | X 2 | Y 2</li>
<li data-row="2" data-col="3" data-sizex="1" data-sizey="3">ROW 2 | COL 3 | X 1 | Y 3</li>
<li data-row="2" data-col="4" data-sizex="1" data-sizey="1">ROW 2 | COL 4 | X 1 | Y 1</li>

<li data-row="3" data-col="4" data-sizex="1" data-sizey="2">ROW 3 | COL 4 | X 1 | Y 2</li>

<li data-row="4" data-col="1" data-sizex="1" data-sizey="1">ROW 4 | COL 1 | X 1 | Y 1</li>
<li data-row="4" data-col="2" data-sizex="1" data-sizey="1">ROW 4 | COL 2 | X 1 | Y 1</li>
</ul>
</div>
</body>
</syntaxhighlight>

[[Kategorie:FHEM Tablet UI]]

FHEM Tablet UI

2017-09-08T15:47:01Z

Scooty:

{{Infobox Modul
|ModPurpose=Oberfläche für FHEM
|ModType=x
|ModFTopic=34233
|ModForumArea=Frontends
|ModTechName=n.a.
|ModOwner=setstate ({{Link2FU|7023|Forum}})
}}
[[FHEM Tablet UI]] (FTUI) ist ein leichtgewichtiges aber funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server.

Mit Hilfe zahlreicher Widgets, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen.

Für den Betrieb ist nur eine FHEM-Installation mit [[HTTPSRV|HTTPSRV-Modul]] sowie ein gängiger Webbrowser notwendig.

Mit wenigen Anpassungen ist es auch möglich das UI auf anderen Webservern (Apache, u.a.) zu betreiben. Somit können FHEM und FHEM Tablet UI auch auf getrennten Systemen ausgeführt werden.

[[File:tablet_ui.png|thumb|500px|center|Beispiel für ein mit [[FHEM Tablet UI]] erstelltes User-Interface]]

{{Todo|Design-Möglichkeiten erklären, Navigationsmethoden ausformulieren}}

== Installation ==
Die Installation von FHEM Tablet UI erzeugt keinen großen Aufwand und besteht im Großen und Ganzen aus drei Schritten:
*Dateien aus dem GitHub-Repository herunterladen
*FHEM konfigurieren ([[HTTPSRV]]-Device erstellen, [[FHEMWEB]]-Attribut longpoll einstellen)
*Eine Beispieldatei anlegen

{{Hinweis|Diese Anleitung geht davon aus, dass FHEM unter Debian nach der Anleitung [https://debian.fhem.de Stable build using apt] installiert wurde.
Ist dies nicht der Fall, muss der Pfad '''/opt/fhem''' dementsprechend angepasst werden.}}

'''1.''' Zuerst müssen alle Dateien von FHEM Tablet UI in das FHEM-Verzeichnis '''/opt/fhem/www''' kopiert werden. Das geht mit folgendem '''update'''-Befehl über die FHEM-Befehlszeile.
:<code>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</code>

:[[Datei:FTUI_Installation_01.png|thumb|none|Schritt 1: Dateien kopieren]]

'''2.''' Anschließend ist ein neues [[HTTPSRV]]-Device in FHEM anzulegen, welches auf den Ordner mit den gerade heruntergeladenen Dateien verweist.
:<code>define TABLETUI HTTPSRV ftui/ ./www/tablet/ Tablet-UI</code>

:[[Datei:FTUI_Installation_02.png|thumb|none|Schritt 2: HTTPSRV-Device anlegen]]

'''3.''' Damit FHEM Tablet UI mit FHEM kommunizieren kann, ist noch die '''longpoll'''-Einstellung im [[FHEMWEB]] Device festzulegen.

:<code>attr WEB longpoll websocket</code>
:bzw. bei Problemen mit ''websocket''
:<code>attr WEB longpoll 1</code>

:[[Datei:FTUI_Installation_03.png|thumb|none|Schritt 3: longpoll einstellen]]

'''4.''' Weil FTUI noch nichts anzuzeigen hat, wird die Datei '''/opt/fhem/www/tablet/index-example.html''' nach '''/opt/fhem/www/tablet/index.html''' kopiert.
:<code>sudo cp -a /opt/fhem/www/tablet/index-example.html /opt/fhem/www/tablet/index.html</code>

:[[Datei:FTUI_Installation_04.png|thumb|none|Schritt 4: index.html erstellen]]

'''5.''' Abschließend muss FHEM noch '''neu gestartet''' werden (''shutdown restart'') da das Attribut '''longpoll''' geändert wurde.

Somit ist FHEM Tablet UI bereit zur Verwendung und kann durch Aufruf der URL '''<nowiki>http://<fhem-server>:8083/fhem/ftui</nowiki>''' oder den Link im FHEM-Menü geöffnet werden

== Update ==
Ein Update von FTUI kann ebenfalls über die FHEM-Kommandozeile erfolgen.

'''1.''' Prüfen der Änderungen seit dem letzten Download/Update durch Eingabe von:
:<code><nowiki>update check https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

'''2.''' Update der geänderten Dateien durch Eingabe von:
:<code><nowiki>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

Eine weitere Option ist das Hinzufügen des FTUI-Git-Repositories zum allgemeinem Update-Vorgang von FHEM. Dabei wird dann bei einem FHEM-Update auch gleich FHEM Tablet UI aktualisiert, bzw. die Änderungen angezeigt.
:<code><nowiki>update add https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

== Konfiguration ==
===DOCTYPE===
In allen HTML-Dateien, die im Browser geladen werden und das typische HTML-Gerüst besitzen (also alle Hauptseiten, jedoch keine Template-Dateien), sollte eine DOCTYPE-Deklaration eingefügt werden. Mit ihr wird festgelegt, in welcher Version der nachfolgende HTML-Code vom Browser interpretiert werden soll. Lässt man sie weg, oder definiert sie auf verschiedenen Seiten unterschiedlich, kann ein und der selbe HTML-Code zu unterschiedlichen Darstellungen führen. Die DOCTYPE-Deklaration erfolgt immer auch der ersten Zeile, noch vor dem <code><html></code>-Tag. Nachfolgend wird HTML5 verwendet.

<syntaxhighlight lang="html">
<!DOCTYPE html>
<html>
<head>...</head>
<body>...</body>
</html>
</syntaxhighlight>

===META-Parameter===
Das Tablet UI lässt sich über die META-Parameter konfigurieren. Diese Parameter sind in jeder '''.html''' Datei (z.B. index.html) im Abschnitt '''<head>''' einzutragen. Ausgenommen davon sind Dateien, die als Template, Pagebutton-Zielseiten oder ähnliches eingebunden werden.

Die Parameter sind immer nach diesem Schema aufgebaut:
<meta name="[Parameter-Name]" content="[Parameter-Wert]">

===Verbindung zu FHEM===
{| class="wikitable"
|-
!Parameter-Name!!Standard-Wert!!Mögliche Werte!!Beschreibung
|-
|web_device||WEB||String||FHEM-Device, welches für das Polling verwendet wird
|-
|longpoll||1||0, 1||
'''0''': Longpoll deaktiviert; alle 30s ein Shortpoll (Neuladen der gesamten Statusänderungen)

'''1''': Longpoll aktiv; geänderte Stati werden sofort aktualisiert, zusätzlich werden alle 15min die gesamten Statusänderungen geladen.
|-
|longpoll_type||websocket||websocket, ajax, 0||
'''websocket''': Für die Aktualisierung der Daten wird das Websocket-Protokoll verwendet. Werden vom Browser keine Websockets unterstützt, gibt es einen automatischen Fallback auf Ajax.

'''ajax''': Ajax wird für die Aktualisierung verwendet.

'''0''': Longpoll deaktiviert, Shortpoll wird verwendet.
|-
|longpoll_filter||.*||RegEx||Event-Filter. Kann verwendet werden, wenn z.B. Devices, die in FTUI angezeigt werden, in einem eigenen FHEM-Room sind.
|-
|longpoll_maxage||240||Integer||Kommen in diesem Zeitraum (Sekunden) keine Longpoll-Events bei FTUI an, wird die Verbindung als "disconnected" angesehen und ein neuer Verbindungsversuch wird gestartet.
|-
|shortpoll_interval||900||Integer||Zeitraum in Sekunden, nach dem ein vollständiger Refresh stattfindet
|-
|shortpoll_only_interval||30||Integer||Zeitraum in Sekunden, nach dem ein vollständiger Refresh stattfindet, sollte Longpoll deaktiviert sein
|-
|fhemweb_url||/fhem/||Integer||URL zu FHEM. Wird benötigt wenn FTUI auf einem anderen als dem FHEM Server läuft oder nicht im Standard-Pfad installiert ist.
Hinweis: Wenn FHEM auf einem anderem Server/Domain läuft muss man das "CORS" Attribut im FHEMWEB Modul (s.o.) auf 1 setzen, sonst bekommt man Cross Origin Fehler.
|}

===Funktionalität===
{| class="wikitable"
|-
!Parameter-Name!!Standard-Wert!!Mögliche Werte!!Beschreibung
|-
|debug||0||0 - 5||Log-Level
|-
|toast||5||Integer||Anzahl an gleichzeitig angezeigten Toast-Nachrichten. Um keine anzuzeigen, ist der Wert auf 0 zu setzen.
|-
|toast_position||bottom-left||||Position im Browserfenster, wo die Toast-Nachrichten angezeigt werden.
|-
|lang||de||de||Sprache der Oberfläche (für z.B. Datums-/Zeitfunktionen)
|-
|username||||String||Benutzername für eine Basic-Authentifierung *
|-
|password||||String||Passwort für eine Basic-Authentifizierung *
|}
'''*''' Derzeit wird die Basic-Authentifizierung in Kombination mit WebSockets nicht unterstützt. Die Verwendung von '''longpoll=1''' (ajax) ist daher notwendig.

===Toast-Nachrichten===
[[Datei:Ftui_toast.png|thumb|Toast-Nachrichten]]
Tablet-UI liefert Informationen darüber, was im Moment gerade passiert. Das geschieht über Toast-Nachrichten, die in der Standardeinstellung unten links im Browser auftauchen.

Wird beispielsweise ein Gerät eingeschaltet, so erscheint eine kleine Nachricht mit dem abgesetzten Befehl. Auch Fehlermeldungen und Statusinformationen werden angezeigt. Ob überhaupt und was konkret angezeigt wird, richtet sich nach dem eingestellten Debug-Level (siehe oben). Beim Debug-Level 5 werden alle Nachrichten angezeigt, bei 0 keine.

Die Position der Toast-Nachrichten kann über den Meta-Tag <code>meta name='toast_position'</code> festgelegt werden. Für oben-mittig müsste folgender Code eingefügt werden:
<pre><meta name='toast_position' content='top-center'></pre>

Möglich sind folgende Positionen:
* <code>top-left</code>
* <code>top-right</code>
* <code>bottom-left</code>
* <code>bottom-right</code>
* <code>top-center</code>
* <code>bottom-center</code>
* <code>mid-center</code>

Die maximale Anzahl an Nachrichten, die gleichzeitig angezeigt werden können, lässt sich mit <code>meta name='toast'</code> Sind maximal 2 Nachrichten gewünscht, muss folgender Meta-Tag gesetzt werden:
<pre><meta name='toast' content='2'></pre>

==Navigationsmethoden==
{{Todo|Dieser Abschnitt dient derzeit lediglich als Sammlung von Stichpunkten und muss vollständig überarbeitet werden.}}

'''Unterschied zwischen Pagetab und Pagebutton:

'''Pagetab:''' Ganze Seite austauschen -> Menü muss auf jede Seite
[[FTUI_Widget_Pagetab]]

'''Pagebutton:''' Teil der Seite austauschen -> Menü nur in erster Seite
[[FTUI_Widget_Pagebutton]]

==Gestaltung==
===Layout-Optionen===
* [[FTUI Layout Gridster|Gridster]]
* [[FTUI Layout Flex|Flex]]
* [[FTUI Layout Sheet|Tabelle]]
* [[FTUI Layout Row|Reihen]]

=== Farben ===
Es besteht die Möglichkeit, die Farbwerte in hexadezimaler Form, als RGB-Wert oder mit dem Farbnamen anzugeben. Zum Beispiel:

*HEX: #ADD8E6
*RBG: rgb(173, 216, 230)
*Namen: lightblue

Knallige Farben wie '''<span style="color: #ff0000;">#ff0000</span>''' für Rot oder '''<span style="color: #00ff00;">#00ff00</span>''' für Grün sollten vermieden werden.
Es ist besser unterhalb von #D0 (208) für die Grundfarben zu bleiben.

Empfohlene Farben sind z.B.:

*Orange: <span style="color: #aa6900;">#aa6900</span>
*Rot: <span style="color: #ad3333;">#ad3333</span>
*Grün: <span style="color: #32a054;">#32a054</span>
*Blau: <span style="color: #6699FF;">#6699FF</span>
*Grau: <span style="color: #8C8C8C;">#8C8C8C</span>

Hilfreich bei der Suche nach den Farbwerten ist zum Beispiel der Color-Picker auf dieser Seite: http://www.colorpicker.com. Für die Suche nach Farben, die einen guten Kontrast bilden, diese Webseite: http://vanisoft.pl/~lopuszanski/public/colors/

Im Ordner ''css'' der FTUI Installation finden sich einige vorbereitete Farbschemas. Diese können mit einem zusätzlichen Eintrag im <nowiki><head></nowiki>-Bereich der FTUI-Seite(n) aktiviert werden.

Hier am Beispiel eines blauen Farbschemas:
<syntaxhighlight lang="html">
<html>
<head>
[...]
<link rel="stylesheet" href="/fhem/tablet/css/fhem-blue-ui.css" />
[...]
</head>
</syntaxhighlight>

Diese Schema-Dateien ändern alle Widgets. Einzelne Widgets können durch Hinzufügen der jeweiligen [[#CSS-Klassen|CSS-Klasse]] geändert werden.

===CSS-Styles===
Das Layout und das Aussehen des UI kann durch diverse vorgegebene CSS-Klassen beeinflusst werden. Die verfügbaren Klassen sind im Abschnitt [[#CSS-Klassen|CSS-Klassen]] aufgeführt.

Soll das Aussehen des UI durch eigene CSS-Klassen oder durch Überschreiben der vorhandenen verändert werden, kann eine eigene CSS-Datei erstellt werden, die dann bei einem eventuellen Update von FTUI nicht überschrieben wird. Diese Datei muss den Dateinamen '''fhem-tablet-ui-user.css''' haben und im Ordner '''/fhem/tablet/css''' abgelegt werden. Sie wird dann beim Aufruf von FTUI automatisch mitgeladen.

=== CSS-Klassen ===
Nicht alle Widgets unterstützen alle hier angegebenen Klassen. Welche genau unterstützt werden, kann auf der jeweiligen Widget-Seite nachgelesen werden.

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|sheet/row/cell-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|sheet}}{{FTUI Klasse|row}}{{FTUI Klasse|cell}}{{FTUI Klasse|cell-1-x}}{{FTUI Klasse|cell-x}}{{FTUI Klasse|left-align}}{{FTUI Klasse|right-align}}{{FTUI Klasse|bottom-align}}{{FTUI Klasse|top-align}}{{FTUI Klasse|center-align}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|row/col-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|col}}{{FTUI Klasse|col-1-x}}{{FTUI Klasse|col-x}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|hbox/vbox-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|vbox}}{{FTUI Klasse|hbox}}{{FTUI Klasse|card}}{{FTUI Klasse|phone-width}}{{FTUI Klasse|full-height}}{{FTUI Klasse|full-width}}{{FTUI Klasse|grow-0}}{{FTUI Klasse|grow-1}}{{FTUI Klasse|grow-2}}{{FTUI Klasse|grow-x}}{{FTUI Klasse|items-top}}{{FTUI Klasse|items-center}}{{FTUI Klasse|items-bottom}}{{FTUI Klasse|items-space-between}}{{FTUI Klasse|items-space-around}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Generelle Klassen für die Positionierung
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|inline}}{{FTUI Klasse|newline}}{{FTUI Klasse|top-space}}{{FTUI Klasse|top-space-2x}}{{FTUI Klasse|top-space-3x}}{{FTUI Klasse|left-space}}{{FTUI Klasse|left-space-2x}}{{FTUI Klasse|left-space-3x}}{{FTUI Klasse|right-space}}{{FTUI Klasse|right-space-2x}}{{FTUI Klasse|right-space-3x}}{{FTUI Klasse|top-narrow}}{{FTUI Klasse|top-narrow-2x}}{{FTUI Klasse|top-narrow-10}}{{FTUI Klasse|left-narrow}}{{FTUI Klasse|left-narrow-2x}}{{FTUI Klasse|left-narrow-3x}}{{FTUI Klasse|right-narrow}}{{FTUI Klasse|right-narrow-2x}}{{FTUI Klasse|right-narrow-3x}}{{FTUI Klasse|centered}}{{FTUI Klasse|wider}}{{FTUI Klasse|narrow}}{{FTUI Klasse|fullsize}}{{FTUI Klasse|compressed}}{{FTUI Klasse|height-narrow}}{{FTUI Klasse|w1x}}{{FTUI Klasse|w2x}}{{FTUI Klasse|w3x}}{{FTUI Klasse|maxw40}}{{FTUI Klasse|doublebox-v}}{{FTUI Klasse|doublebox-h}}{{FTUI Klasse|triplebox-v}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Vordergrundfarben
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|red}}{{FTUI Klasse|green}}{{FTUI Klasse|blue}}{{FTUI Klasse|lightblue}}{{FTUI Klasse|orange}}{{FTUI Klasse|gray}}{{FTUI Klasse|lightgray}}{{FTUI Klasse|white}}{{FTUI Klasse|black}}{{FTUI Klasse|mint}}{{FTUI Klasse|yellow}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Hintergrundfarben
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|bg-red}}{{FTUI Klasse|bg-green}}{{FTUI Klasse|bg-blue}}{{FTUI Klasse|bg-lightblue}}{{FTUI Klasse|bg-orange}}{{FTUI Klasse|bg-gray}}{{FTUI Klasse|bg-lightgray}}{{FTUI Klasse|bg-white}}{{FTUI Klasse|bg-black}}{{FTUI Klasse|bg-mint}}{{FTUI Klasse|bg-yellow}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Rahmen
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|verticalLine}}{{FTUI Klasse|border-black}}{{FTUI Klasse|border-white}}{{FTUI Klasse|border-orange}}{{FTUI Klasse|border-red}}{{FTUI Klasse|border-green}}{{FTUI Klasse|border-mint}}{{FTUI Klasse|border-lightblue}}{{FTUI Klasse|border-blue}}{{FTUI Klasse|border-gray}}{{FTUI Klasse|border-yellow}}{{FTUI Klasse|border-lightgray}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Größen
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|mini}}{{FTUI Klasse|tiny}}{{FTUI Klasse|small}}{{FTUI Klasse|normal}}{{FTUI Klasse|large}}{{FTUI Klasse|big}}{{FTUI Klasse|bigger}}{{FTUI Klasse|tall}}{{FTUI Klasse|great}}{{FTUI Klasse|grande}}{{FTUI Klasse|gigantic}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Schriftstil
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|thin}}{{FTUI Klasse|bold}}{{FTUI Klasse|darker}}{{FTUI Klasse|truncate}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Sonstiges
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|blank}}{{FTUI Klasse|transparent}}{{FTUI Klasse|half-transparent}}{{FTUI Klasse|blurry}}{{FTUI Klasse|shake}}{{FTUI Klasse|fail-shake}}{{FTUI Klasse|marquee}}{{FTUI Klasse|icon round}}{{FTUI Klasse|icon square}}{{FTUI Klasse|readonly}}{{FTUI Klasse|blink}}{{FTUI Klasse|rotate-90}}{{FTUI Klasse|horizontal}}{{FTUI Klasse|circleborder}}{{FTUI Klasse|autohide}}{{FTUI Klasse|notransmit}}{{FTUI Klasse|tab}}{{FTUI Klasse|FS20}}{{FTUI Klasse|value}}{{FTUI Klasse|novalue}}{{FTUI Klasse|timestamp}}{{FTUI Klasse|percent}}{{FTUI Klasse|nocache}}{{FTUI Klasse|fade}}{{FTUI Klasse|rotate}}{{FTUI Klasse|nolabels}}{{FTUI Klasse|default}}{{FTUI Klasse|prefetch}}{{FTUI Klasse|circulate}}{{FTUI Klasse|valueonly}}{{FTUI Klasse|positiononly}}{{FTUI Klasse|lineIndicator}}{{FTUI Klasse|barIndicator}}{{FTUI Klasse|roundIndicator}}{{FTUI Klasse|dim-tick}}{{FTUI Klasse|dim-front}}{{FTUI Klasse|dim-back}}{{FTUI Klasse|hue-tick}}{{FTUI Klasse|hue-front}}{{FTUI Klasse|hue-back}}{{FTUI Klasse|warn}}{{FTUI Klasse|activate}}{{FTUI Klasse|labelright}}{{FTUI Klasse|interlock}}{{FTUI Klasse|keepopen}}{{FTUI Klasse|noshade}}
|}

=== Icons ===
FTUI bringt einige Icons-"Schriftarten" mit, die für die Darstellung genützt werden können. Diese werden automatisch beim Start des UI eingebunden, sobald ein entsprechendes Icon-Präfix im Code der Seite vorkommt.

Verfügbare Icon-Schriftarten sind:
* Eingebaute Icons ''ftui-windows'' und ''ftui-door''. Präfix '''ftui-'''. Beispiel: <code>data-icon="ftui-door"</code>
* [http://fontawesome.io/icons/ Font-Awesome]: Mehr als 500 Icons zur Auswahl. Präfix '''fa-'''. Beispiel: <code>data-icon="fa-volume-up"</code>
* [https://material.io/icons/ Material Icons]: Mehr als 900 Icons zur Auswahl. Präfix '''mi-'''. Beispiel: <code>data-icon="mi-local_gas_station"</code>
* FHEM und OpenAutomation Icons: Präfix '''fs-''' und '''oa-'''. Beispiel: <code>data-icon="oa-secur_locked"</code>
* [https://erikflowers.github.io/weather-icons/ Weather-Icons]: Präfix '''wi-'''. Beispiel: <code>data-icon="wi-day-rain-mix"</code>

Alternativ können auch Bilder Icons (bspw. png) über CSS verwendet werden. Bspw:
<syntaxhighlight lang="html5">
<head>
<style type="text/css">
.logo-fhem {
background: url(https://wiki.fhem.de/fhemlogo.png) no-repeat;
width: 120px;
height: 132px;
background-size: contain;
}
</style>
</head>
<body>
<div data-type="symbol" data-icon="logo-fhem"></div>
</body>
</syntaxhighlight>

== Widgets ==
===Allgemeine Attribute===
Jedes Widget kann über verschiedene Attribute konfiguriert werden. Folgende Attribute gelten für alle Widgets:

{| class="wikitable"
|+allgemeine Attribute
|-
!align="right" |data-type
|Widget-Typ
|-
!align="right" |data-device
|FHEM-Name des Gerätes (mit dem Befehl 'list' bekommt man im FHEM die kpl. Liste)
|-
!align="right" |class
|CSS-Klassen für Aussehen und Formatierung des Widgets
|-
|}

{| class="wikitable"
|+Daten Empfangen
|-
!align="right" |data-get
|Reading Name
|-
!align="right" |data-get-on
|Wert für den Status on
|-
!align="right" |data-get-off
|Wert für den Status off
|-
|}

{| class="wikitable"
|+Daten Senden
|-
!align="right" |data-set
|Reading Name
|-
!align="right" |data-set-on
|Wert für den Status on
|-
!align="right" |data-set-off
|Wert für den Status off
|-
|}

Widget-spezifische Attribute können auf der jeweiligen Widget-Seite nachgelesen werden.

=== Integrierte Widgets ===
Folgende Widgets sind direkt in FHEM Tablet UI integriert und können "out of the box" verwendet werden.

* [[FTUI Widget Button|button]]: Variante der push und switch Widgets, die entweder einen URL ansteuern oder einen FHEM-Befehl absetzen kann.
* [[FTUI Widget Checkbox|checkbox]]: Umschalter zwischen zwei definierten Zuständen
* [[FTUI Widget Circlemenu|circlemenu]]: Mehrere Widgets hinter einem Widget verborgen, trotz des 'circle' im Namen kann das Menue jetzt auch horizontal oder vertikal ausgeklappt werden
* [[FTUI Widget Clock|clock]]: Stellt eine einfach Uhr zur Verfügung.
* [[FTUI Widget Colorwheel|colorwheel]]: Farbpalette zur Auswahl von Farben
* [[FTUI Widget Datetimepicker|datetimepicker]]: Erstellt eine Auswahl für Datum/Uhrzeit
* [[FTUI Widget Departure|departure]]: Abfahrtszeiten öffentlicher Verkehrsmittel
* [[FTUI Widget Dimmer|dimmer]]: Ein-/Aus-Button mit integriertem Schieberegler für z.B. einen Dim-Wert
* [[FTUI Widget Eventmonitor|eventmonitor]]:
* [[FTUI Widget Homestatus|homestatus]]: Auswahl für vier oder fünf definierte Stati eines Objects (z.B.: FHEM Residents)
* [[FTUI Widget Html|html]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/iframe iframe]: Widget zum Einbinden externer Inhalte in einem Iframe.
* [[FTUI Widget Image|image]]: Zeigt ein Bild, dessen URL fest vorgegeben oder aus einem Device-Reading gelesen werden kann.
* [[FTUI Widget Input|input]]: Erstellen eines Texteingabefeldes
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/joinedlabel joinedlabel]: verbindet mehrere Readings zu einem Feld
* [[FTUI Widget Klimatrend|klimatrend]]: wandelt Daten aus dem statistics-Modul in einen Pfeil um, der den aktuellen Trend anzeigt.
* [[FTUI Widget Knob|knob]]: Erstellt einen Statusbalken auf einer Kreisbahn
* [[FTUI Widget Label|label]]: Reading als Text anzeigen
* [[FTUI Widget Level|level]]: Vertikale oder horizontale Leiste zur Anzeige von Werten zwischen einem Minimal- und einem Maximalwert
* [[FTUI Widget Link|link]]: Erstellt einen Link oder Button zum Aufrufen von URLs oder Senden von Befehlen an FHEM
* [[FTUI Widget Medialist|medialist]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/multistatebutton multistatebutton]: Variante des push-Widgets das den set-Befehl abhängig vom gelesenen Status ändert.
* [[FTUI Widget Notify|notify]]: Blendet ein Hinweisfenster im Browser ein
* [[FTUI Widget Pagebutton|pagebutton]]: Button, mit dem auf andere Seiten gesprungen werden kann. Eignet sich gut für eine Navigation
* [[FTUI Widget Pagetab|pagetab]]: Tauscht den Inhalt einer Seite durch den einer anderen. Eignet sich gut für ein Navigationsmenü.
* [[FTUI Widget Playstream|playstream]]: Abspielen eines Webradio-Streams per Button
* [[FTUI Widget Popup|popup]]: Öffnet ein Popup nach einem Klick auf ein Widget oder HTML-Element
* [[FTUI Widget Progress|progress]]: Zeigt einen Prozentwert in Form einer runden Fortschrittsleiste
* [[FTUI_Widget_Push|push]]: Button, mir dem ein Befehl an FHEM gesendet werden kann.
* [[FTUI Widget Range|range]]: Erstellt vertikale Balken, die einen Wertebereich in unterschiedlichen Farben darstellen
* [[FTUI Widget Readingsgroup|readingsgroup]]: Zeigt eine Readingsgroup an, wie sie in FHEM definiert wurde
* [[FTUI Widget Rotor|rotor]]: Animiertes Umschalten von zwei oder mehr Widgets an einer Position
* [[FTUI_Widget_Select|select]]: Combobox, die eine Liste an Werten zur Auswahl anzeigt
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/settimer settimer]: Zum Anzeigen und Einstellen einer Uhrzeit.
* [[FTUI Widget Simplechart|simplechart]]: Einfaches XY-Diagramm zur Anzeige eines Wertes, der direkt aus einem FHEM-Logfile gelesen wird
* [[FTUI Widget Slideout|slideout]]:
* [[FTUI Widget Slider|slider]]: Vertikaler Schieberegler um einen Wert einzustellen
* [[FTUI Widget Spinner|spinner]]: Element um Werte durch Drücken auf Plus- und Minus- oder Höher-/Tiefer-Icons zu ändern
* [[FTUI Widget Swiper|swiper]]: Bietet die Möglichkeit, durch Wischen, zwischen verschiedenen Widgets zu wechseln
* [[FTUI Widget Switch|switch]]: Button um zwischen zwei Zuständen zu schalten (z.B. on / off)
* [[FTUI Widget Symbol|symbol]]: Status eines Devices als Symbol darstellen (z.B. Fenster offen)
* [[FTUI Widget Thermostat|thermostat]]: Anzeige für Heizungsthermostate, mit der die gewünschte Temperatur eingestellt werden kann
* [[FTUI Widget Volume|volume]]: Einstellscheibe zur Änderung eines einzelnen Wertes
* [[FTUI Widget Weather|weather]]: Wettersymbol anzeigen
* [[FTUI Widget WindDirection|wind_direction]]: Anzeige der Windrichtung auf einer Windrose

===3rd Party Widgets===
Für diese Widgets kann nicht sichergestellt werden, dass sie mit der jeweils aktuellen Version von FTUI funktionieren.
* [[FTUI Widget Agenda|agenda]]: Zeigt Kalendereinträge in einer Listenform an
* [[FTUI Widget Calview|calview]]: Zeigt Einträge aus einem [[CALVIEW]]-Device an
* [[FTUI Widget Chart|chart]]: Diagramm mit ähnlichen Möglichkeiten wie die FHEM-Plots
* [[FTUI Widget Classchanger|classchanger]]: Ändert seine CSS-Klassen je nach Status eines Devices
* [[FTUI Widget Clicksound|clicksound]]: Mit dem Widget "clicksound" können Sounds an Click-Events von Elementen gebunden werden.
* [[FTUI Widget Filelog|filelog]]:
* [[FTUI Widget Fullcalview|fullcalview]]:
* [[FTUI Widget Gds|gds]]:
* [[FTUI Widget Highchart|highchart]]:
* [[FTUI Widget Highchart3d|highchart3d]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/itunes_artwork itunes_artwork]: itunes_artwork durchsucht die iTunes-Datenbank anhand eines Arrays von beliebigen Suchworten nach einem Cover-Artwork und zeigt dieses an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/javascript javascript]: Ermöglicht die Ausführung beliebigen Javascript-Codes aus einem Reading.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/kodinowplaying kodinowplaying]: zeigt Informationen zu grade in KODI gespielten Medien in Form eines Labels an.
* [[FTUI Widget Loading|loading]]:
* [[FTUI Widget Meteogram|meteogram]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/mpdnowplaying mpdnowplaying]: Zeigt Titelinformationen eines per MPD-Modul angebundenen Music Player Daemon an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/reload reload]: auslösen eine Pagereloads
* [[FTUI Widget Screensaver|screensaver]]:
* [[FTUI Widget Svgplot|svgplot]]:
* [[FTUI Widget Tts|tts]]: Sprachausgabe eines Textes aus einem Reading auf dem Endgerät.
* [[FTUI Widget UWZ|uwz]]: Anzeige der Warnungen der Unwetterzentrale
* [[FTUI Widget Wakeup|wakeup]]:
* [https://github.com/svenson08/ftui-weekdaytimer-widget wdtimer]: Visualisierung des [[WeekdayTimer]] Modul
* [[FTUI Widget Weekprofile|weekprofile]]: Visualisierung des [[weekprofile]] Moduls

==Templates==
Kommt ein bestimmtes "Code-Fragment" auf mehreren Seiten oder öfter pro Seite vor, bietet FTUI die Option, Templates zu erstellen. Diese werden einmal gebaut und können dann mit dem Attribut '''data-template''' nach Belieben in eine Seite eingefügt werden. Dabei besteht auch die Möglichkeit, Parameter zu verwenden.

Im Folgenden ein paar Beispiele, wie Templates verwendet werden können.

===Einzelnes Widget===
Soll ein Widget an mehreren Stellen in exakt der selben Ausführung eingebunden werden, kann diese Widget in einer eigenen Datei erstellt und diese dann auf den Zielseiten automatisch mitgeladen werden.

;Template-Seite
Die Template-Seite soll in diesem Beispiel ''template_symbol.html'' genannt werden. Diese wird daher zuerst im FTUI-Verzeichnis erstellt.
<syntaxhighlight lang="html">
<div data-type="symbol"
data-device="dummy1">
</syntaxhighlight>

;Haupt-Seite
Die oben erstellte Template-Seite kann nun in jeder gewünschten Seite eingebunden werden.
<syntaxhighlight lang="html" highlight="6">
[...]
<body>
<div class="gridster">
<ul>
<li data-row="1" data-col="1" data-sizey="1" data-sizex="1">
<div data-template="template_symbol.html"></div>
</li>
</ul>
</div>
</body>
[...]
</syntaxhighlight>

===Gridster-Element===
Natürlich kann auch ein ganzes Gridster-Element - in diesem Fall ein Menü - als Template eingebunden werden.
<syntaxhighlight lang="html">
<li data-row="1" data-col="1" data-sizex="1" data-sizey="4" data-template="menu.html"></li>
</syntaxhighlight>

=== Widget-Gruppen ===
Die Template-Datei des [[#Einzelnes Widget|ersten Beispiels]] kann natürlich auch mehrere Widgets auf einmal enthalten.

=== Verwendung von Parametern ===
==== Einfaches Beispiel ====
Oft wird ein und dasselbe, liebevoll gestaltete, Widget für verschiedenen Devices verwendet. Um nicht für jedes Device das Widget neu kopieren zu müssen (bzw. bei Änderungen alle Seiten ausbessern zu müssen), kann ein Template verwendet werden, dem einfach per Parameter mitgeteilt wird, von welchem Device es gerade die Daten empfangen soll.

In diesem Beispiel wird ein Template erzeugt, dass nur die Temperatur verschiedenen Thermostate mittels eines [[FTUI Widget Label|Label-Widgets]] anzeigt.

;Template-Seite
Die Template-Seite enthält nur ein einfaches Label-Widget und wird in diesem Beispiel ''template_label.html'' genannt. Um sie für mehrere Devices verwenden zu können, wird im Attribut '''data-device''' der Name des eigentlichen Devices durch den Parameter '''par01''' ersetzt.
<syntaxhighlight lang="html" highlight="2">
<div data-type="label"
data-device="par01"
data-get="measured-temp"></div>
</syntaxhighlight>

;Haupt-Seite
Auf der Haupt-Seite wird die Template-Seite mit dem Attribut '''data-template''' eingebunden und ihr via Attribut '''data-parameter''' das jeweils gewünschte Device übergeben.
<syntaxhighlight lang="html">
[...]
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat1"}'></div>
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat2"}'></div>
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat3"}'></div>
[...]
</syntaxhighlight>

==== Wetter-Slider mit Template ====
In diesem Beispiel wird ein [[FTUI Widget Slider|Slider-Widget]] erstellt, welches die verschiedenen Tage eines Wetterberichtes anzeigt. Dabei wird für den Wetterbericht des jeweiligen Tages immer dasselbe Template verwendet um nicht für jeden Tag ein eigenes Widget schreiben zu müssen.

;Template-Seite
<syntaxhighlight lang="html">
<div class="left">
<div data-type="label" data-device="AgroWeather" data-get="par01" data-unit="°C"></div>
<div class="inline">
<div data-type="label" data-device="AgroWeather" data-get="par02"></div>
<div data-type="weather" data-device="AgroWeather" data-get="par02"></div>
min: <div data-type="label" data-device="AgroWeather" data-get="par03" data-unit="°C"></div>
</div>
</div>
<div class="left">
<div data-type="label" data-device="AgroWeather" data-get="par04" data-substitution="toDate().eeee()+','"></div>
<div data-type="label" data-device="AgroWeather" data-get="par04" data-substitution="toDate().ddmm()"></div>
</div>
</syntaxhighlight>

;Haupt-Seite
In der Haupt-Seite wird das Template dann für jede Slider-Seite eingebunden und das Reading für den jeweiligen Tag via Parameter übergeben.
<syntaxhighlight lang="html">
[...]
<div data-type="swiper">
<ul>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc0_tempMax","par02":"fc0_weatherDay","par03":"fc0_tempMin","par04":"fc0_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc1_tempMax","par02":"fc1_weatherDay","par03":"fc1_tempMin","par04":"fc1_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc2_tempMax","par02":"fc2_weatherDay","par03":"fc2_tempMin","par04":"fc2_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc3_tempMax","par02":"fc3_weatherDay","par03":"fc3_tempMin","par04":"fc3_date"}'></li>
</ul>
</div>
[...]
</syntaxhighlight>

== JavaScript-Funktionen ==
Neben den Widgets können auch einige JavaScript-Funktionen verwendet werden, um Befehle an FHEM zu senden.

Folgende Zeile setzt einen direkten Befehl an FHEM ab (<code>set dummy1 off</code>):
<syntaxhighlight lang="html"><div onclick="ftui.setFhemStatus('set dummy1 off')">Dummy1 aus</div></syntaxhighlight>

Diese Zeile veranlasst FHEM dazu, eine Funktion aus der 99_myUtils.pm auszuführen (<code>myUtils_HeizungUpDown("WZ.Thermostat_Climate","up")</code>):
<syntaxhighlight lang="html"><div onclick="ftui.setFhemStatus('{myUtils_HeizungUpDown("WZ.Thermostat_Climate","up")}')">+</div></syntaxhighlight>

Ein Beispiel, wie ein Kommando an FHEM gesendet wird und gleichzeitig der Wert eines bereits in FTUI angezeigten Readings verwendet werden kann:
<syntaxhighlight lang="html">
<div data-type="label" data-device="dummy1" data-get="temperature"></div>
<div onClick="ftui.setFhemStatus('set dummy2 '+ftui.getDeviceParameter('dummy1','temperature').val);">Senden</div>
</syntaxhighlight>

== FAQ ==
Häufig gestellte Fragen zum FHEM Tablet UI sind in der [[FHEM Tablet UI FAQ]] zusammengestellt.

== Links ==
* [https://github.com/knowthelist/fhem-tablet-ui Projekt auf Github]
* {{Link2Forum|Topic=34233|LinkText=Forums-Beitrag}}
* [[FTUI_Snippets|Snippets]]
* [http://knowthelist.github.io/fhem/tablet/demo_widgets.html Live-Demos]
* {{Link2Forum|Topic=37378|LinkText=User-Demos}}
* [https://github.com/ovibox/fhem-ftui-user-demos Download der User-Demo-Dateien]

[[Kategorie:FHEM Tablet UI]]

FHEM Tablet UI

2017-09-06T15:34:40Z

Scooty:

{{Infobox Modul
|ModPurpose=Oberfläche für FHEM
|ModType=x
|ModFTopic=34233
|ModForumArea=Frontends
|ModTechName=n.a.
|ModOwner=setstate ({{Link2FU|7023|Forum}})
}}
[[FHEM Tablet UI]] (FTUI) ist ein leichtgewichtiges aber funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server.

Mit Hilfe zahlreicher Widgets, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen.

Für den Betrieb ist nur eine FHEM-Installation mit [[HTTPSRV|HTTPSRV-Modul]] sowie ein gängiger Webbrowser notwendig.

Mit wenigen Anpassungen ist es auch möglich das UI auf anderen Webservern (Apache, u.a.) zu betreiben. Somit können FHEM und FHEM Tablet UI auch auf getrennten Systemen ausgeführt werden.

[[File:tablet_ui.png|thumb|500px|center|Beispiel für ein mit [[FHEM Tablet UI]] erstelltes User-Interface]]

{{Todo|Design-Möglichkeiten erklären, Navigationsmethoden ausformulieren}}

== Installation ==
Die Installation von FHEM Tablet UI erzeugt keinen großen Aufwand und besteht im Großen und Ganzen aus drei Schritten:
*Dateien aus dem GitHub-Repository herunterladen
*FHEM konfigurieren ([[HTTPSRV]]-Device erstellen, [[FHEMWEB]]-Attribut longpoll einstellen)
*Eine Beispieldatei anlegen

{{Hinweis|Diese Anleitung geht davon aus, dass FHEM unter Debian nach der Anleitung [https://debian.fhem.de Stable build using apt] installiert wurde.
Ist dies nicht der Fall, muss der Pfad '''/opt/fhem''' dementsprechend angepasst werden.}}

'''1.''' Zuerst müssen alle Dateien von FHEM Tablet UI in das FHEM-Verzeichnis '''/opt/fhem/www''' kopiert werden. Das geht mit folgendem '''update'''-Befehl über die FHEM-Befehlszeile.
:<code>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</code>

:[[Datei:FTUI_Installation_01.png|thumb|none|Schritt 1: Dateien kopieren]]

'''2.''' Anschließend ist ein neues [[HTTPSRV]]-Device in FHEM anzulegen, welches auf den Ordner mit den gerade heruntergeladenen Dateien verweist.
:<code>define TABLETUI HTTPSRV ftui/ ./www/tablet/ Tablet-UI</code>

:[[Datei:FTUI_Installation_02.png|thumb|none|Schritt 2: HTTPSRV-Device anlegen]]

'''3.''' Damit FHEM Tablet UI mit FHEM kommunizieren kann, ist noch die '''longpoll'''-Einstellung im [[FHEMWEB]] Device festzulegen.

:<code>attr WEB longpoll websocket</code>
:bzw. bei Problemen mit ''websocket''
:<code>attr WEB longpoll 1</code>

:[[Datei:FTUI_Installation_03.png|thumb|none|Schritt 3: longpoll einstellen]]

'''4.''' Weil FTUI noch nichts anzuzeigen hat, wird die Datei '''/opt/fhem/www/tablet/index-example.html''' nach '''/opt/fhem/www/tablet/index.html''' kopiert.
:<code>sudo cp -a /opt/fhem/www/tablet/index-example.html /opt/fhem/www/tablet/index.html</code>

:[[Datei:FTUI_Installation_04.png|thumb|none|Schritt 4: index.html erstellen]]

'''5.''' Abschließend muss FHEM noch '''neu gestartet''' werden (''shutdown restart'') da das Attribut '''longpoll''' geändert wurde.

Somit ist FHEM Tablet UI bereit zur Verwendung und kann durch Aufruf der URL '''<nowiki>http://<fhem-server>:8083/fhem/ftui</nowiki>''' oder den Link im FHEM-Menü geöffnet werden

== Update ==
Ein Update von FTUI kann ebenfalls über die FHEM-Kommandozeile erfolgen.

'''1.''' Prüfen der Änderungen seit dem letzten Download/Update durch Eingabe von:
:<code><nowiki>update check https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

'''2.''' Update der geänderten Dateien durch Eingabe von:
:<code><nowiki>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

Eine weitere Option ist das Hinzufügen des FTUI-Git-Repositories zum allgemeinem Update-Vorgang von FHEM. Dabei wird dann bei einem FHEM-Update auch gleich FHEM Tablet UI aktualisiert, bzw. die Änderungen angezeigt.
:<code><nowiki>update add https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

== Konfiguration ==
===DOCTYPE===
In allen HTML-Dateien, die im Browser geladen werden und das typische HTML-Gerüst besitzen (also alle Hauptseiten, jedoch keine Template-Dateien), sollte eine DOCTYPE-Deklaration eingefügt werden. Mit ihr wird festgelegt, in welcher Version der nachfolgende HTML-Code vom Browser interpretiert werden soll. Lässt man sie weg, oder definiert sie auf verschiedenen Seiten unterschiedlich, kann ein und der selbe HTML-Code zu unterschiedlichen Darstellungen führen. Die DOCTYPE-Deklaration erfolgt immer auch der ersten Zeile, noch vor dem <code><html></code>-Tag. Nachfolgend wird HTML5 verwendet.

<syntaxhighlight lang="html">
<!DOCTYPE html>
<html>
<head>...</head>
<body>...</body>
</html>
</syntaxhighlight>

===META-Parameter===
Das Tablet UI lässt sich über die META-Parameter konfigurieren. Diese Parameter sind in jeder '''.html''' Datei (z.B. index.html) im Abschnitt '''<head>''' einzutragen. Ausgenommen davon sind Dateien, die als Template, Pagebutton-Zielseiten oder ähnliches eingebunden werden.

Die Parameter sind immer nach diesem Schema aufgebaut:
<meta name="[Parameter-Name]" content="[Parameter-Wert]">

===Verbindung zu FHEM===
{| class="wikitable"
|-
!Parameter-Name!!Standard-Wert!!Mögliche Werte!!Beschreibung
|-
|web_device||WEB||String||FHEM-Device, welches für das Polling verwendet wird
|-
|longpoll||1||0, 1||
'''0''': Longpoll deaktiviert; alle 30s ein Shortpoll (Neuladen der gesamten Statusänderungen)

'''1''': Longpoll aktiv; geänderte Stati werden sofort aktualisiert, zusätzlich werden alle 15min die gesamten Statusänderungen geladen.
|-
|longpoll_type||websocket||websocket, ajax, 0||
'''websocket''': Für die Aktualisierung der Daten wird das Websocket-Protokoll verwendet. Werden vom Browser keine Websockets unterstützt, gibt es einen automatischen Fallback auf Ajax.

'''ajax''': Ajax wird für die Aktualisierung verwendet.

'''0''': Longpoll deaktiviert, Shortpoll wird verwendet.
|-
|longpoll_filter||.*||RegEx||Event-Filter. Kann verwendet werden, wenn z.B. Devices, die in FTUI angezeigt werden, in einem eigenen FHEM-Room sind.
|-
|longpoll_maxage||240||Integer||Kommen in diesem Zeitraum (Sekunden) keine Longpoll-Events bei FTUI an, wird die Verbindung als "disconnected" angesehen und ein neuer Verbindungsversuch wird gestartet.
|-
|shortpoll_interval||900||Integer||Zeitraum in Sekunden, nach dem ein vollständiger Refresh stattfindet
|-
|shortpoll_only_interval||30||Integer||Zeitraum in Sekunden, nach dem ein vollständiger Refresh stattfindet, sollte Longpoll deaktiviert sein
|-
|fhemweb_url||/fhem/||Integer||URL zu FHEM. Wird benötigt wenn FTUI auf einem anderen als dem FHEM Server läuft oder nicht im Standard-Pfad installiert ist.
Hinweis: Wenn FHEM auf einem anderem Server/Domain läuft muss man das "CORS" Attribut im FHEMWEB Modul (s.o.) auf 1 setzen, sonst bekommt man Cross Origin Fehler.
|}

===Funktionalität===
{| class="wikitable"
|-
!Parameter-Name!!Standard-Wert!!Mögliche Werte!!Beschreibung
|-
|debug||0||0 - 5||Log-Level
|-
|gridster_disable||0||0, 1||Auf 1 setzen, um drag&drop für Gridster-Elemente zu deaktivieren
|-
|toast||5||Integer||Anzahl an gleichzeitig angezeigten Toast-Nachrichten. Um keine anzuzeigen, ist der Wert auf 0 zu setzen.
|-
|toast_position||bottom-left||||Position im Browserfenster, wo die Toast-Nachrichten angezeigt werden.
|-
|lang||de||de||Sprache der Oberfläche (für z.B. Datums-/Zeitfunktionen)
|-
|username||||String||Benutzername für eine Basic-Authentifierung *
|-
|password||||String||Passwort für eine Basic-Authentifizierung *
|}
'''*''' Derzeit wird die Basic-Authentifizierung in Kombination mit WebSockets nicht unterstützt. Die Verwendung von '''longpoll=1''' (ajax) ist daher notwendig.

===Toast-Nachrichten===
[[Datei:Ftui_toast.png|thumb|Toast-Nachrichten]]
Tablet-UI liefert Informationen darüber, was im Moment gerade passiert. Das geschieht über Toast-Nachrichten, die in der Standardeinstellung unten links im Browser auftauchen.

Wird beispielsweise ein Gerät eingeschaltet, so erscheint eine kleine Nachricht mit dem abgesetzten Befehl. Auch Fehlermeldungen und Statusinformationen werden angezeigt. Ob überhaupt und was konkret angezeigt wird, richtet sich nach dem eingestellten Debug-Level (siehe oben). Beim Debug-Level 5 werden alle Nachrichten angezeigt, bei 0 keine.

Die Position der Toast-Nachrichten kann über den Meta-Tag <code>meta name='toast_position'</code> festgelegt werden. Für oben-mittig müsste folgender Code eingefügt werden:
<pre><meta name='toast_position' content='top-center'></pre>

Möglich sind folgende Positionen:
* <code>top-left</code>
* <code>top-right</code>
* <code>bottom-left</code>
* <code>bottom-right</code>
* <code>top-center</code>
* <code>bottom-center</code>
* <code>mid-center</code>

Die maximale Anzahl an Nachrichten, die gleichzeitig angezeigt werden können, lässt sich mit <code>meta name='toast'</code> Sind maximal 2 Nachrichten gewünscht, muss folgender Meta-Tag gesetzt werden:
<pre><meta name='toast' content='2'></pre>

==Navigationsmethoden==
{{Todo|Dieser Abschnitt dient derzeit lediglich als Sammlung von Stichpunkten und muss vollständig überarbeitet werden.}}

'''Unterschied zwischen Pagetab und Pagebutton:

'''Pagetab:''' Ganze Seite austauschen -> Menü muss auf jede Seite
[[FTUI_Widget_Pagetab]]

'''Pagebutton:''' Teil der Seite austauschen -> Menü nur in erster Seite
[[FTUI_Widget_Pagebutton]]

==Gestaltung==
===Layout-Optionen===
* [[FTUI Layout Gridster|Gridster]]
* [[FTUI Layout Flex|Flex]]
* [[FTUI Layout Sheet|Tabelle]]
* [[FTUI Layout Row|Reihen]]

=== Farben ===
Es besteht die Möglichkeit, die Farbwerte in hexadezimaler Form, als RGB-Wert oder mit dem Farbnamen anzugeben. Zum Beispiel:

*HEX: #ADD8E6
*RBG: rgb(173, 216, 230)
*Namen: lightblue

Knallige Farben wie '''<span style="color: #ff0000;">#ff0000</span>''' für Rot oder '''<span style="color: #00ff00;">#00ff00</span>''' für Grün sollten vermieden werden.
Es ist besser unterhalb von #D0 (208) für die Grundfarben zu bleiben.

Empfohlene Farben sind z.B.:

*Orange: <span style="color: #aa6900;">#aa6900</span>
*Rot: <span style="color: #ad3333;">#ad3333</span>
*Grün: <span style="color: #32a054;">#32a054</span>
*Blau: <span style="color: #6699FF;">#6699FF</span>
*Grau: <span style="color: #8C8C8C;">#8C8C8C</span>

Hilfreich bei der Suche nach den Farbwerten ist zum Beispiel der Color-Picker auf dieser Seite: http://www.colorpicker.com. Für die Suche nach Farben, die einen guten Kontrast bilden, diese Webseite: http://vanisoft.pl/~lopuszanski/public/colors/

Im Ordner ''css'' der FTUI Installation finden sich einige vorbereitete Farbschemas. Diese können mit einem zusätzlichen Eintrag im <nowiki><head></nowiki>-Bereich der FTUI-Seite(n) aktiviert werden.

Hier am Beispiel eines blauen Farbschemas:
<syntaxhighlight lang="html">
<html>
<head>
[...]
<link rel="stylesheet" href="/fhem/tablet/css/fhem-blue-ui.css" />
[...]
</head>
</syntaxhighlight>

Diese Schema-Dateien ändern alle Widgets. Einzelne Widgets können durch Hinzufügen der jeweiligen [[#CSS-Klassen|CSS-Klasse]] geändert werden.

===CSS-Styles===
Das Layout und das Aussehen des UI kann durch diverse vorgegebene CSS-Klassen beeinflusst werden. Die verfügbaren Klassen sind im Abschnitt [[#CSS-Klassen|CSS-Klassen]] aufgeführt.

Soll das Aussehen des UI durch eigene CSS-Klassen oder durch Überschreiben der vorhandenen verändert werden, kann eine eigene CSS-Datei erstellt werden, die dann bei einem eventuellen Update von FTUI nicht überschrieben wird. Diese Datei muss den Dateinamen '''fhem-tablet-ui-user.css''' haben und im Ordner '''/fhem/tablet/css''' abgelegt werden. Sie wird dann beim Aufruf von FTUI automatisch mitgeladen.

=== CSS-Klassen ===
Nicht alle Widgets unterstützen alle hier angegebenen Klassen. Welche genau unterstützt werden, kann auf der jeweiligen Widget-Seite nachgelesen werden.

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|sheet/row/cell-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|sheet}}{{FTUI Klasse|row}}{{FTUI Klasse|cell}}{{FTUI Klasse|cell-1-x}}{{FTUI Klasse|cell-x}}{{FTUI Klasse|left-align}}{{FTUI Klasse|right-align}}{{FTUI Klasse|bottom-align}}{{FTUI Klasse|top-align}}{{FTUI Klasse|center-align}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|row/col-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|col}}{{FTUI Klasse|col-1-x}}{{FTUI Klasse|col-x}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|hbox/vbox-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|vbox}}{{FTUI Klasse|hbox}}{{FTUI Klasse|card}}{{FTUI Klasse|phone-width}}{{FTUI Klasse|full-height}}{{FTUI Klasse|full-width}}{{FTUI Klasse|grow-0}}{{FTUI Klasse|grow-1}}{{FTUI Klasse|grow-2}}{{FTUI Klasse|grow-x}}{{FTUI Klasse|items-top}}{{FTUI Klasse|items-center}}{{FTUI Klasse|items-bottom}}{{FTUI Klasse|items-space-between}}{{FTUI Klasse|items-space-around}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Generelle Klassen für die Positionierung
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|inline}}{{FTUI Klasse|newline}}{{FTUI Klasse|top-space}}{{FTUI Klasse|top-space-2x}}{{FTUI Klasse|top-space-3x}}{{FTUI Klasse|left-space}}{{FTUI Klasse|left-space-2x}}{{FTUI Klasse|left-space-3x}}{{FTUI Klasse|right-space}}{{FTUI Klasse|right-space-2x}}{{FTUI Klasse|right-space-3x}}{{FTUI Klasse|top-narrow}}{{FTUI Klasse|top-narrow-2x}}{{FTUI Klasse|top-narrow-10}}{{FTUI Klasse|left-narrow}}{{FTUI Klasse|left-narrow-2x}}{{FTUI Klasse|left-narrow-3x}}{{FTUI Klasse|right-narrow}}{{FTUI Klasse|right-narrow-2x}}{{FTUI Klasse|right-narrow-3x}}{{FTUI Klasse|centered}}{{FTUI Klasse|wider}}{{FTUI Klasse|narrow}}{{FTUI Klasse|fullsize}}{{FTUI Klasse|compressed}}{{FTUI Klasse|height-narrow}}{{FTUI Klasse|w1x}}{{FTUI Klasse|w2x}}{{FTUI Klasse|w3x}}{{FTUI Klasse|maxw40}}{{FTUI Klasse|doublebox-v}}{{FTUI Klasse|doublebox-h}}{{FTUI Klasse|triplebox-v}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Vordergrundfarben
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|red}}{{FTUI Klasse|green}}{{FTUI Klasse|blue}}{{FTUI Klasse|lightblue}}{{FTUI Klasse|orange}}{{FTUI Klasse|gray}}{{FTUI Klasse|lightgray}}{{FTUI Klasse|white}}{{FTUI Klasse|black}}{{FTUI Klasse|mint}}{{FTUI Klasse|yellow}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Hintergrundfarben
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|bg-red}}{{FTUI Klasse|bg-green}}{{FTUI Klasse|bg-blue}}{{FTUI Klasse|bg-lightblue}}{{FTUI Klasse|bg-orange}}{{FTUI Klasse|bg-gray}}{{FTUI Klasse|bg-lightgray}}{{FTUI Klasse|bg-white}}{{FTUI Klasse|bg-black}}{{FTUI Klasse|bg-mint}}{{FTUI Klasse|bg-yellow}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Rahmen
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|verticalLine}}{{FTUI Klasse|border-black}}{{FTUI Klasse|border-white}}{{FTUI Klasse|border-orange}}{{FTUI Klasse|border-red}}{{FTUI Klasse|border-green}}{{FTUI Klasse|border-mint}}{{FTUI Klasse|border-lightblue}}{{FTUI Klasse|border-blue}}{{FTUI Klasse|border-gray}}{{FTUI Klasse|border-yellow}}{{FTUI Klasse|border-lightgray}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Größen
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|mini}}{{FTUI Klasse|tiny}}{{FTUI Klasse|small}}{{FTUI Klasse|normal}}{{FTUI Klasse|large}}{{FTUI Klasse|big}}{{FTUI Klasse|bigger}}{{FTUI Klasse|tall}}{{FTUI Klasse|great}}{{FTUI Klasse|grande}}{{FTUI Klasse|gigantic}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Schriftstil
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|thin}}{{FTUI Klasse|bold}}{{FTUI Klasse|darker}}{{FTUI Klasse|truncate}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Sonstiges
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|blank}}{{FTUI Klasse|transparent}}{{FTUI Klasse|half-transparent}}{{FTUI Klasse|blurry}}{{FTUI Klasse|shake}}{{FTUI Klasse|fail-shake}}{{FTUI Klasse|marquee}}{{FTUI Klasse|icon round}}{{FTUI Klasse|icon square}}{{FTUI Klasse|readonly}}{{FTUI Klasse|blink}}{{FTUI Klasse|rotate-90}}{{FTUI Klasse|horizontal}}{{FTUI Klasse|circleborder}}{{FTUI Klasse|autohide}}{{FTUI Klasse|notransmit}}{{FTUI Klasse|tab}}{{FTUI Klasse|FS20}}{{FTUI Klasse|value}}{{FTUI Klasse|novalue}}{{FTUI Klasse|timestamp}}{{FTUI Klasse|percent}}{{FTUI Klasse|nocache}}{{FTUI Klasse|fade}}{{FTUI Klasse|rotate}}{{FTUI Klasse|nolabels}}{{FTUI Klasse|default}}{{FTUI Klasse|prefetch}}{{FTUI Klasse|circulate}}{{FTUI Klasse|valueonly}}{{FTUI Klasse|positiononly}}{{FTUI Klasse|lineIndicator}}{{FTUI Klasse|barIndicator}}{{FTUI Klasse|roundIndicator}}{{FTUI Klasse|dim-tick}}{{FTUI Klasse|dim-front}}{{FTUI Klasse|dim-back}}{{FTUI Klasse|hue-tick}}{{FTUI Klasse|hue-front}}{{FTUI Klasse|hue-back}}{{FTUI Klasse|warn}}{{FTUI Klasse|activate}}{{FTUI Klasse|labelright}}{{FTUI Klasse|interlock}}{{FTUI Klasse|keepopen}}{{FTUI Klasse|noshade}}
|}

=== Icons ===
FTUI bringt einige Icons-"Schriftarten" mit, die für die Darstellung genützt werden können. Diese werden automatisch beim Start des UI eingebunden, sobald ein entsprechendes Icon-Präfix im Code der Seite vorkommt.

Verfügbare Icon-Schriftarten sind:
* Eingebaute Icons ''ftui-windows'' und ''ftui-door''. Präfix '''ftui-'''. Beispiel: <code>data-icon="ftui-door"</code>
* [http://fontawesome.io/icons/ Font-Awesome]: Mehr als 500 Icons zur Auswahl. Präfix '''fa-'''. Beispiel: <code>data-icon="fa-volume-up"</code>
* [https://material.io/icons/ Material Icons]: Mehr als 900 Icons zur Auswahl. Präfix '''mi-'''. Beispiel: <code>data-icon="mi-local_gas_station"</code>
* FHEM und OpenAutomation Icons: Präfix '''fs-''' und '''oa-'''. Beispiel: <code>data-icon="oa-secur_locked"</code>
* [https://erikflowers.github.io/weather-icons/ Weather-Icons]: Präfix '''wi-'''. Beispiel: <code>data-icon="wi-day-rain-mix"</code>

Alternativ können auch Bilder Icons (bspw. png) über CSS verwendet werden. Bspw:
<syntaxhighlight lang="html5">
<head>
<style type="text/css">
.logo-fhem {
background: url(https://wiki.fhem.de/fhemlogo.png) no-repeat;
width: 120px;
height: 132px;
background-size: contain;
}
</style>
</head>
<body>
<div data-type="symbol" data-icon="logo-fhem"></div>
</body>
</syntaxhighlight>

== Widgets ==
===Allgemeine Attribute===
Jedes Widget kann über verschiedene Attribute konfiguriert werden. Folgende Attribute gelten für alle Widgets:

{| class="wikitable"
|+allgemeine Attribute
|-
!align="right" |data-type
|Widget-Typ
|-
!align="right" |data-device
|FHEM-Name des Gerätes (mit dem Befehl 'list' bekommt man im FHEM die kpl. Liste)
|-
!align="right" |class
|CSS-Klassen für Aussehen und Formatierung des Widgets
|-
|}

{| class="wikitable"
|+Daten Empfangen
|-
!align="right" |data-get
|Reading Name
|-
!align="right" |data-get-on
|Wert für den Status on
|-
!align="right" |data-get-off
|Wert für den Status off
|-
|}

{| class="wikitable"
|+Daten Senden
|-
!align="right" |data-set
|Reading Name
|-
!align="right" |data-set-on
|Wert für den Status on
|-
!align="right" |data-set-off
|Wert für den Status off
|-
|}

Widget-spezifische Attribute können auf der jeweiligen Widget-Seite nachgelesen werden.

=== Integrierte Widgets ===
Folgende Widgets sind direkt in FHEM Tablet UI integriert und können "out of the box" verwendet werden.

* [[FTUI Widget Button|button]]: Variante der push und switch Widgets, die entweder einen URL ansteuern oder einen FHEM-Befehl absetzen kann.
* [[FTUI Widget Checkbox|checkbox]]: Umschalter zwischen zwei definierten Zuständen
* [[FTUI Widget Circlemenu|circlemenu]]: Mehrere Widgets hinter einem Widget verborgen, trotz des 'circle' im Namen kann das Menue jetzt auch horizontal oder vertikal ausgeklappt werden
* [[FTUI Widget Clock|clock]]: Stellt eine einfach Uhr zur Verfügung.
* [[FTUI Widget Colorwheel|colorwheel]]: Farbpalette zur Auswahl von Farben
* [[FTUI Widget Datetimepicker|datetimepicker]]: Erstellt eine Auswahl für Datum/Uhrzeit
* [[FTUI Widget Departure|departure]]: Abfahrtszeiten öffentlicher Verkehrsmittel
* [[FTUI Widget Dimmer|dimmer]]: Ein-/Aus-Button mit integriertem Schieberegler für z.B. einen Dim-Wert
* [[FTUI Widget Eventmonitor|eventmonitor]]:
* [[FTUI Widget Homestatus|homestatus]]: Auswahl für vier oder fünf definierte Stati eines Objects (z.B.: FHEM Residents)
* [[FTUI Widget Html|html]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/iframe iframe]: Widget zum Einbinden externer Inhalte in einem Iframe.
* [[FTUI Widget Image|image]]: Zeigt ein Bild, dessen URL fest vorgegeben oder aus einem Device-Reading gelesen werden kann.
* [[FTUI Widget Input|input]]: Erstellen eines Texteingabefeldes
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/joinedlabel joinedlabel]: verbindet mehrere Readings zu einem Feld
* [[FTUI Widget Klimatrend|klimatrend]]: wandelt Daten aus dem statistics-Modul in einen Pfeil um, der den aktuellen Trend anzeigt.
* [[FTUI Widget Knob|knob]]: Erstellt einen Statusbalken auf einer Kreisbahn
* [[FTUI Widget Label|label]]: Reading als Text anzeigen
* [[FTUI Widget Level|level]]: Vertikale oder horizontale Leiste zur Anzeige von Werten zwischen einem Minimal- und einem Maximalwert
* [[FTUI Widget Link|link]]: Erstellt einen Link oder Button zum Aufrufen von URLs oder Senden von Befehlen an FHEM
* [[FTUI Widget Medialist|medialist]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/multistatebutton multistatebutton]: Variante des push-Widgets das den set-Befehl abhängig vom gelesenen Status ändert.
* [[FTUI Widget Notify|notify]]: Blendet ein Hinweisfenster im Browser ein
* [[FTUI Widget Pagebutton|pagebutton]]: Button, mit dem auf andere Seiten gesprungen werden kann. Eignet sich gut für eine Navigation
* [[FTUI Widget Pagetab|pagetab]]: Tauscht den Inhalt einer Seite durch den einer anderen. Eignet sich gut für ein Navigationsmenü.
* [[FTUI Widget Playstream|playstream]]: Abspielen eines Webradio-Streams per Button
* [[FTUI Widget Popup|popup]]: Öffnet ein Popup nach einem Klick auf ein Widget oder HTML-Element
* [[FTUI Widget Progress|progress]]: Zeigt einen Prozentwert in Form einer runden Fortschrittsleiste
* [[FTUI_Widget_Push|push]]: Button, mir dem ein Befehl an FHEM gesendet werden kann.
* [[FTUI Widget Range|range]]: Erstellt vertikale Balken, die einen Wertebereich in unterschiedlichen Farben darstellen
* [[FTUI Widget Readingsgroup|readingsgroup]]: Zeigt eine Readingsgroup an, wie sie in FHEM definiert wurde
* [[FTUI Widget Rotor|rotor]]: Animiertes Umschalten von zwei oder mehr Widgets an einer Position
* [[FTUI_Widget_Select|select]]: Combobox, die eine Liste an Werten zur Auswahl anzeigt
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/settimer settimer]: Zum Anzeigen und Einstellen einer Uhrzeit.
* [[FTUI Widget Simplechart|simplechart]]: Einfaches XY-Diagramm zur Anzeige eines Wertes, der direkt aus einem FHEM-Logfile gelesen wird
* [[FTUI Widget Slideout|slideout]]:
* [[FTUI Widget Slider|slider]]: Vertikaler Schieberegler um einen Wert einzustellen
* [[FTUI Widget Spinner|spinner]]: Element um Werte durch Drücken auf Plus- und Minus- oder Höher-/Tiefer-Icons zu ändern
* [[FTUI Widget Swiper|swiper]]: Bietet die Möglichkeit, durch Wischen, zwischen verschiedenen Widgets zu wechseln
* [[FTUI Widget Switch|switch]]: Button um zwischen zwei Zuständen zu schalten (z.B. on / off)
* [[FTUI Widget Symbol|symbol]]: Status eines Devices als Symbol darstellen (z.B. Fenster offen)
* [[FTUI Widget Thermostat|thermostat]]: Anzeige für Heizungsthermostate, mit der die gewünschte Temperatur eingestellt werden kann
* [[FTUI Widget Volume|volume]]: Einstellscheibe zur Änderung eines einzelnen Wertes
* [[FTUI Widget Weather|weather]]: Wettersymbol anzeigen
* [[FTUI Widget WindDirection|wind_direction]]: Anzeige der Windrichtung auf einer Windrose

===3rd Party Widgets===
Für diese Widgets kann nicht sichergestellt werden, dass sie mit der jeweils aktuellen Version von FTUI funktionieren.
* [[FTUI Widget Agenda|agenda]]: Zeigt Kalendereinträge in einer Listenform an
* [[FTUI Widget Calview|calview]]: Zeigt Einträge aus einem [[CALVIEW]]-Device an
* [[FTUI Widget Chart|chart]]: Diagramm mit ähnlichen Möglichkeiten wie die FHEM-Plots
* [[FTUI Widget Classchanger|classchanger]]: Ändert seine CSS-Klassen je nach Status eines Devices
* [[FTUI Widget Clicksound|clicksound]]: Mit dem Widget "clicksound" können Sounds an Click-Events von Elementen gebunden werden.
* [[FTUI Widget Filelog|filelog]]:
* [[FTUI Widget Fullcalview|fullcalview]]:
* [[FTUI Widget Gds|gds]]:
* [[FTUI Widget Highchart|highchart]]:
* [[FTUI Widget Highchart3d|highchart3d]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/itunes_artwork itunes_artwork]: itunes_artwork durchsucht die iTunes-Datenbank anhand eines Arrays von beliebigen Suchworten nach einem Cover-Artwork und zeigt dieses an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/javascript javascript]: Ermöglicht die Ausführung beliebigen Javascript-Codes aus einem Reading.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/kodinowplaying kodinowplaying]: zeigt Informationen zu grade in KODI gespielten Medien in Form eines Labels an.
* [[FTUI Widget Loading|loading]]:
* [[FTUI Widget Meteogram|meteogram]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/mpdnowplaying mpdnowplaying]: Zeigt Titelinformationen eines per MPD-Modul angebundenen Music Player Daemon an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/reload reload]: auslösen eine Pagereloads
* [[FTUI Widget Screensaver|screensaver]]:
* [[FTUI Widget Svgplot|svgplot]]:
* [[FTUI Widget Tts|tts]]: Sprachausgabe eines Textes aus einem Reading auf dem Endgerät.
* [[FTUI Widget UWZ|uwz]]: Anzeige der Warnungen der Unwetterzentrale
* [[FTUI Widget Wakeup|wakeup]]:
* [https://github.com/svenson08/ftui-weekdaytimer-widget wdtimer]: Visualisierung des [[WeekdayTimer]] Modul
* [[FTUI Widget Weekprofile|weekprofile]]: Visualisierung des [[weekprofile]] Moduls

==Templates==
Kommt ein bestimmtes "Code-Fragment" auf mehreren Seiten oder öfter pro Seite vor, bietet FTUI die Option, Templates zu erstellen. Diese werden einmal gebaut und können dann mit dem Attribut '''data-template''' nach Belieben in eine Seite eingefügt werden. Dabei besteht auch die Möglichkeit, Parameter zu verwenden.

Im Folgenden ein paar Beispiele, wie Templates verwendet werden können.

===Einzelnes Widget===
Soll ein Widget an mehreren Stellen in exakt der selben Ausführung eingebunden werden, kann diese Widget in einer eigenen Datei erstellt und diese dann auf den Zielseiten automatisch mitgeladen werden.

;Template-Seite
Die Template-Seite soll in diesem Beispiel ''template_symbol.html'' genannt werden. Diese wird daher zuerst im FTUI-Verzeichnis erstellt.
<syntaxhighlight lang="html">
<div data-type="symbol"
data-device="dummy1">
</syntaxhighlight>

;Haupt-Seite
Die oben erstellte Template-Seite kann nun in jeder gewünschten Seite eingebunden werden.
<syntaxhighlight lang="html" highlight="6">
[...]
<body>
<div class="gridster">
<ul>
<li data-row="1" data-col="1" data-sizey="1" data-sizex="1">
<div data-template="template_symbol.html"></div>
</li>
</ul>
</div>
</body>
[...]
</syntaxhighlight>

===Gridster-Element===
Natürlich kann auch ein ganzes Gridster-Element - in diesem Fall ein Menü - als Template eingebunden werden.
<syntaxhighlight lang="html">
<li data-row="1" data-col="1" data-sizex="1" data-sizey="4" data-template="menu.html"></li>
</syntaxhighlight>

=== Widget-Gruppen ===
Die Template-Datei des [[#Einzelnes Widget|ersten Beispiels]] kann natürlich auch mehrere Widgets auf einmal enthalten.

=== Verwendung von Parametern ===
==== Einfaches Beispiel ====
Oft wird ein und dasselbe, liebevoll gestaltete, Widget für verschiedenen Devices verwendet. Um nicht für jedes Device das Widget neu kopieren zu müssen (bzw. bei Änderungen alle Seiten ausbessern zu müssen), kann ein Template verwendet werden, dem einfach per Parameter mitgeteilt wird, von welchem Device es gerade die Daten empfangen soll.

In diesem Beispiel wird ein Template erzeugt, dass nur die Temperatur verschiedenen Thermostate mittels eines [[FTUI Widget Label|Label-Widgets]] anzeigt.

;Template-Seite
Die Template-Seite enthält nur ein einfaches Label-Widget und wird in diesem Beispiel ''template_label.html'' genannt. Um sie für mehrere Devices verwenden zu können, wird im Attribut '''data-device''' der Name des eigentlichen Devices durch den Parameter '''par01''' ersetzt.
<syntaxhighlight lang="html" highlight="2">
<div data-type="label"
data-device="par01"
data-get="measured-temp"></div>
</syntaxhighlight>

;Haupt-Seite
Auf der Haupt-Seite wird die Template-Seite mit dem Attribut '''data-template''' eingebunden und ihr via Attribut '''data-parameter''' das jeweils gewünschte Device übergeben.
<syntaxhighlight lang="html">
[...]
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat1"}'></div>
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat2"}'></div>
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat3"}'></div>
[...]
</syntaxhighlight>

==== Wetter-Slider mit Template ====
In diesem Beispiel wird ein [[FTUI Widget Slider|Slider-Widget]] erstellt, welches die verschiedenen Tage eines Wetterberichtes anzeigt. Dabei wird für den Wetterbericht des jeweiligen Tages immer dasselbe Template verwendet um nicht für jeden Tag ein eigenes Widget schreiben zu müssen.

;Template-Seite
<syntaxhighlight lang="html">
<div class="left">
<div data-type="label" data-device="AgroWeather" data-get="par01" data-unit="°C"></div>
<div class="inline">
<div data-type="label" data-device="AgroWeather" data-get="par02"></div>
<div data-type="weather" data-device="AgroWeather" data-get="par02"></div>
min: <div data-type="label" data-device="AgroWeather" data-get="par03" data-unit="°C"></div>
</div>
</div>
<div class="left">
<div data-type="label" data-device="AgroWeather" data-get="par04" data-substitution="toDate().eeee()+','"></div>
<div data-type="label" data-device="AgroWeather" data-get="par04" data-substitution="toDate().ddmm()"></div>
</div>
</syntaxhighlight>

;Haupt-Seite
In der Haupt-Seite wird das Template dann für jede Slider-Seite eingebunden und das Reading für den jeweiligen Tag via Parameter übergeben.
<syntaxhighlight lang="html">
[...]
<div data-type="swiper">
<ul>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc0_tempMax","par02":"fc0_weatherDay","par03":"fc0_tempMin","par04":"fc0_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc1_tempMax","par02":"fc1_weatherDay","par03":"fc1_tempMin","par04":"fc1_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc2_tempMax","par02":"fc2_weatherDay","par03":"fc2_tempMin","par04":"fc2_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc3_tempMax","par02":"fc3_weatherDay","par03":"fc3_tempMin","par04":"fc3_date"}'></li>
</ul>
</div>
[...]
</syntaxhighlight>

== JavaScript-Funktionen ==
Neben den Widgets können auch einige JavaScript-Funktionen verwendet werden, um Befehle an FHEM zu senden.

Folgende Zeile setzt einen direkten Befehl an FHEM ab (<code>set dummy1 off</code>):
<syntaxhighlight lang="html"><div onclick="ftui.setFhemStatus('set dummy1 off')">Dummy1 aus</div></syntaxhighlight>

Diese Zeile veranlasst FHEM dazu, eine Funktion aus der 99_myUtils.pm auszuführen (<code>myUtils_HeizungUpDown("WZ.Thermostat_Climate","up")</code>):
<syntaxhighlight lang="html"><div onclick="ftui.setFhemStatus('{myUtils_HeizungUpDown("WZ.Thermostat_Climate","up")}')">+</div></syntaxhighlight>

Ein Beispiel, wie ein Kommando an FHEM gesendet wird und gleichzeitig der Wert eines bereits in FTUI angezeigten Readings verwendet werden kann:
<syntaxhighlight lang="html">
<div data-type="label" data-device="dummy1" data-get="temperature"></div>
<div onClick="ftui.setFhemStatus('set dummy2 '+ftui.getDeviceParameter('dummy1','temperature').val);">Senden</div>
</syntaxhighlight>

== FAQ ==
Häufig gestellte Fragen zum FHEM Tablet UI sind in der [[FHEM Tablet UI FAQ]] zusammengestellt.

== Links ==
* [https://github.com/knowthelist/fhem-tablet-ui Projekt auf Github]
* {{Link2Forum|Topic=34233|LinkText=Forums-Beitrag}}
* [[FTUI_Snippets|Snippets]]
* [http://knowthelist.github.io/fhem/tablet/demo_widgets.html Live-Demos]
* {{Link2Forum|Topic=37378|LinkText=User-Demos}}
* [https://github.com/ovibox/fhem-ftui-user-demos Download der User-Demo-Dateien]

[[Kategorie:FHEM Tablet UI]]

FHEM Tablet UI

2017-09-06T11:52:19Z

Scooty: Meta-Parameter gridster_disable hinzugefügt

{{Infobox Modul
|ModPurpose=Oberfläche für FHEM
|ModType=x
|ModFTopic=34233
|ModForumArea=Frontends
|ModTechName=n.a.
|ModOwner=setstate ({{Link2FU|7023|Forum}})
}}
[[FHEM Tablet UI]] (FTUI) ist ein leichtgewichtiges aber funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server.

Mit Hilfe zahlreicher Widgets, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen.

Für den Betrieb ist nur eine FHEM-Installation mit [[HTTPSRV|HTTPSRV-Modul]] sowie ein gängiger Webbrowser notwendig.

Mit wenigen Anpassungen ist es auch möglich das UI auf anderen Webservern (Apache, u.a.) zu betreiben. Somit können FHEM und FHEM Tablet UI auch auf getrennten Systemen ausgeführt werden.

[[File:tablet_ui.png|thumb|500px|center|Beispiel für ein mit [[FHEM Tablet UI]] erstelltes User-Interface]]

{{Todo|Design-Möglichkeiten erklären, Navigationsmethoden ausformulieren}}

== Installation ==
Die Installation von FHEM Tablet UI erzeugt keinen großen Aufwand und besteht im Großen und Ganzen aus drei Schritten:
*Dateien aus dem GitHub-Repository herunterladen
*FHEM konfigurieren ([[HTTPSRV]]-Device erstellen, [[FHEMWEB]]-Attribut longpoll einstellen)
*Eine Beispieldatei anlegen

{{Hinweis|Diese Anleitung geht davon aus, dass FHEM unter Debian nach der Anleitung [https://debian.fhem.de Stable build using apt] installiert wurde.
Ist dies nicht der Fall, muss der Pfad '''/opt/fhem''' dementsprechend angepasst werden.}}

'''1.''' Zuerst müssen alle Dateien von FHEM Tablet UI in das FHEM-Verzeichnis '''/opt/fhem/www''' kopiert werden. Das geht mit folgendem '''update'''-Befehl über die FHEM-Befehlszeile.
:<code>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</code>

:[[Datei:FTUI_Installation_01.png|thumb|none|Schritt 1: Dateien kopieren]]

'''2.''' Anschließend ist ein neues [[HTTPSRV]]-Device in FHEM anzulegen, welches auf den Ordner mit den gerade heruntergeladenen Dateien verweist.
:<code>define TABLETUI HTTPSRV ftui/ ./www/tablet/ Tablet-UI</code>

:[[Datei:FTUI_Installation_02.png|thumb|none|Schritt 2: HTTPSRV-Device anlegen]]

'''3.''' Damit FHEM Tablet UI mit FHEM kommunizieren kann, ist noch die '''longpoll'''-Einstellung im [[FHEMWEB]] Device festzulegen.

:<code>attr WEB longpoll websocket</code>
:bzw. bei Problemen mit ''websocket''
:<code>attr WEB longpoll 1</code>

:[[Datei:FTUI_Installation_03.png|thumb|none|Schritt 3: longpoll einstellen]]

'''4.''' Weil FTUI noch nichts anzuzeigen hat, wird die Datei '''/opt/fhem/www/tablet/index-example.html''' nach '''/opt/fhem/www/tablet/index.html''' kopiert.
:<code>sudo cp -a /opt/fhem/www/tablet/index-example.html /opt/fhem/www/tablet/index.html</code>

:[[Datei:FTUI_Installation_04.png|thumb|none|Schritt 4: index.html erstellen]]

'''5.''' Abschließend muss FHEM noch '''neu gestartet''' werden (''shutdown restart'') da das Attribut '''longpoll''' geändert wurde.

Somit ist FHEM Tablet UI bereit zur Verwendung und kann durch Aufruf der URL '''<nowiki>http://<fhem-server>:8083/fhem/ftui</nowiki>''' oder den Link im FHEM-Menü geöffnet werden

== Update ==
Ein Update von FTUI kann ebenfalls über die FHEM-Kommandozeile erfolgen.

'''1.''' Prüfen der Änderungen seit dem letzten Download/Update durch Eingabe von:
:<code><nowiki>update check https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

'''2.''' Update der geänderten Dateien durch Eingabe von:
:<code><nowiki>update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

Eine weitere Option ist das Hinzufügen des FTUI-Git-Repositories zum allgemeinem Update-Vorgang von FHEM. Dabei wird dann bei einem FHEM-Update auch gleich FHEM Tablet UI aktualisiert, bzw. die Änderungen angezeigt.
:<code><nowiki>update add https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt</nowiki></code>

== Konfiguration ==
===DOCTYPE===
In allen HTML-Dateien, die im Browser geladen werden und das typische HTML-Gerüst besitzen (also alle Hauptseiten, jedoch keine Template-Dateien), sollte eine DOCTYPE-Deklaration eingefügt werden. Mit ihr wird festgelegt, in welcher Version der nachfolgende HTML-Code vom Browser interpretiert werden soll. Lässt man sie weg, oder definiert sie auf verschiedenen Seiten unterschiedlich, kann ein und der selbe HTML-Code zu unterschiedlichen Darstellungen führen. Die DOCTYPE-Deklaration erfolgt immer auch der ersten Zeile, noch vor dem <code><html></code>-Tag. Nachfolgend wird HTML5 verwendet.

<syntaxhighlight lang="html">
<!DOCTYPE html>
<html>
<head>...</head>
<body>...</body>
</html>
</syntaxhighlight>

===META-Parameter===
Das Tablet UI lässt sich über die META-Parameter konfigurieren. Diese Parameter sind in jeder '''.html''' Datei (z.B. index.html) im Abschnitt '''<head>''' einzutragen. Ausgenommen davon sind Dateien, die als Template, Pagebutton-Zielseiten oder ähnliches eingebunden werden.

Die Parameter sind immer nach diesem Schema aufgebaut:
<meta name="[Parameter-Name]" content="[Parameter-Wert]">

===Verbindung zu FHEM===
{| class="wikitable"
|-
!Parameter-Name!!Standard-Wert!!Mögliche Werte!!Beschreibung
|-
|web_device||WEB||String||FHEM-Device, welches für das Polling verwendet wird
|-
|longpoll||1||0, 1||
'''0''': Longpoll deaktiviert; alle 30s ein Shortpoll (Neuladen der gesamten Statusänderungen)

'''1''': Longpoll aktiv; geänderte Stati werden sofort aktualisiert, zusätzlich werden alle 15min die gesamten Statusänderungen geladen.
|-
|longpoll_type||websocket||websocket, ajax, 0||
'''websocket''': Für die Aktualisierung der Daten wird das Websocket-Protokoll verwendet. Werden vom Browser keine Websockets unterstützt, gibt es einen automatischen Fallback auf Ajax.

'''ajax''': Ajax wird für die Aktualisierung verwendet.

'''0''': Longpoll deaktiviert, Shortpoll wird verwendet.
|-
|longpoll_filter||.*||RegEx||Event-Filter. Kann verwendet werden, wenn z.B. Devices, die in FTUI angezeigt werden, in einem eigenen FHEM-Room sind.
|-
|longpoll_maxage||240||Integer||Kommen in diesem Zeitraum (Sekunden) keine Longpoll-Events bei FTUI an, wird die Verbindung als "disconnected" angesehen und ein neuer Verbindungsversuch wird gestartet.
|-
|shortpoll_interval||900||Integer||Zeitraum in Sekunden, nach dem ein vollständiger Refresh stattfindet
|-
|shortpoll_only_interval||30||Integer||Zeitraum in Sekunden, nach dem ein vollständiger Refresh stattfindet, sollte Longpoll deaktiviert sein
|-
|fhemweb_url||/fhem/||Integer||URL zu FHEM. Wird benötigt wenn FTUI auf einem anderen als dem FHEM Server läuft oder nicht im Standard-Pfad installiert ist.
Hinweis: Wenn FHEM auf einem anderem Server/Domain läuft muss man das "CORS" Attribut im FHEMWEB Modul (s.o.) auf 1 setzen, sonst bekommt man Cross Origin Fehler.
|}

===Funktionalität===
{| class="wikitable"
|-
!Parameter-Name!!Standard-Wert!!Mögliche Werte!!Beschreibung
|-
|debug||0||0 - 5||Log-Level
|-
|gridster_disable||0||0, 1||Auf 1 setzen, um drag&drop für GridsterElemente zu deaktivieren
|-
|toast||5||Integer||Anzahl an gleichzeitig angezeigten Toast-Nachrichten. Um keine anzuzeigen, ist der Wert auf 0 zu setzen.
|-
|toast_position||bottom-left||||Position im Browserfenster, wo die Toast-Nachrichten angezeigt werden.
|-
|lang||de||de||Sprache der Oberfläche (für z.B. Datums-/Zeitfunktionen)
|-
|username||||String||Benutzername für eine Basic-Authentifierung *
|-
|password||||String||Passwort für eine Basic-Authentifizierung *
|}
'''*''' Derzeit wird die Basic-Authentifizierung in Kombination mit WebSockets nicht unterstützt. Die Verwendung von '''longpoll=1''' (ajax) ist daher notwendig.

===Toast-Nachrichten===
[[Datei:Ftui_toast.png|thumb|Toast-Nachrichten]]
Tablet-UI liefert Informationen darüber, was im Moment gerade passiert. Das geschieht über Toast-Nachrichten, die in der Standardeinstellung unten links im Browser auftauchen.

Wird beispielsweise ein Gerät eingeschaltet, so erscheint eine kleine Nachricht mit dem abgesetzten Befehl. Auch Fehlermeldungen und Statusinformationen werden angezeigt. Ob überhaupt und was konkret angezeigt wird, richtet sich nach dem eingestellten Debug-Level (siehe oben). Beim Debug-Level 5 werden alle Nachrichten angezeigt, bei 0 keine.

Die Position der Toast-Nachrichten kann über den Meta-Tag <code>meta name='toast_position'</code> festgelegt werden. Für oben-mittig müsste folgender Code eingefügt werden:
<pre><meta name='toast_position' content='top-center'></pre>

Möglich sind folgende Positionen:
* <code>top-left</code>
* <code>top-right</code>
* <code>bottom-left</code>
* <code>bottom-right</code>
* <code>top-center</code>
* <code>bottom-center</code>
* <code>mid-center</code>

Die maximale Anzahl an Nachrichten, die gleichzeitig angezeigt werden können, lässt sich mit <code>meta name='toast'</code> Sind maximal 2 Nachrichten gewünscht, muss folgender Meta-Tag gesetzt werden:
<pre><meta name='toast' content='2'></pre>

==Navigationsmethoden==
{{Todo|Dieser Abschnitt dient derzeit lediglich als Sammlung von Stichpunkten und muss vollständig überarbeitet werden.}}

'''Unterschied zwischen Pagetab und Pagebutton:

'''Pagetab:''' Ganze Seite austauschen -> Menü muss auf jede Seite
[[FTUI_Widget_Pagetab]]

'''Pagebutton:''' Teil der Seite austauschen -> Menü nur in erster Seite
[[FTUI_Widget_Pagebutton]]

==Gestaltung==
===Layout-Optionen===
* [[FTUI Layout Gridster|Gridster]]
* [[FTUI Layout Flex|Flex]]
* [[FTUI Layout Sheet|Tabelle]]
* [[FTUI Layout Row|Reihen]]

=== Farben ===
Es besteht die Möglichkeit, die Farbwerte in hexadezimaler Form, als RGB-Wert oder mit dem Farbnamen anzugeben. Zum Beispiel:

*HEX: #ADD8E6
*RBG: rgb(173, 216, 230)
*Namen: lightblue

Knallige Farben wie '''<span style="color: #ff0000;">#ff0000</span>''' für Rot oder '''<span style="color: #00ff00;">#00ff00</span>''' für Grün sollten vermieden werden.
Es ist besser unterhalb von #D0 (208) für die Grundfarben zu bleiben.

Empfohlene Farben sind z.B.:

*Orange: <span style="color: #aa6900;">#aa6900</span>
*Rot: <span style="color: #ad3333;">#ad3333</span>
*Grün: <span style="color: #32a054;">#32a054</span>
*Blau: <span style="color: #6699FF;">#6699FF</span>
*Grau: <span style="color: #8C8C8C;">#8C8C8C</span>

Hilfreich bei der Suche nach den Farbwerten ist zum Beispiel der Color-Picker auf dieser Seite: http://www.colorpicker.com. Für die Suche nach Farben, die einen guten Kontrast bilden, diese Webseite: http://vanisoft.pl/~lopuszanski/public/colors/

Im Ordner ''css'' der FTUI Installation finden sich einige vorbereitete Farbschemas. Diese können mit einem zusätzlichen Eintrag im <nowiki><head></nowiki>-Bereich der FTUI-Seite(n) aktiviert werden.

Hier am Beispiel eines blauen Farbschemas:
<syntaxhighlight lang="html">
<html>
<head>
[...]
<link rel="stylesheet" href="/fhem/tablet/css/fhem-blue-ui.css" />
[...]
</head>
</syntaxhighlight>

Diese Schema-Dateien ändern alle Widgets. Einzelne Widgets können durch Hinzufügen der jeweiligen [[#CSS-Klassen|CSS-Klasse]] geändert werden.

===CSS-Styles===
Das Layout und das Aussehen des UI kann durch diverse vorgegebene CSS-Klassen beeinflusst werden. Die verfügbaren Klassen sind im Abschnitt [[#CSS-Klassen|CSS-Klassen]] aufgeführt.

Soll das Aussehen des UI durch eigene CSS-Klassen oder durch Überschreiben der vorhandenen verändert werden, kann eine eigene CSS-Datei erstellt werden, die dann bei einem eventuellen Update von FTUI nicht überschrieben wird. Diese Datei muss den Dateinamen '''fhem-tablet-ui-user.css''' haben und im Ordner '''/fhem/tablet/css''' abgelegt werden. Sie wird dann beim Aufruf von FTUI automatisch mitgeladen.

=== CSS-Klassen ===
Nicht alle Widgets unterstützen alle hier angegebenen Klassen. Welche genau unterstützt werden, kann auf der jeweiligen Widget-Seite nachgelesen werden.

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|sheet/row/cell-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|sheet}}{{FTUI Klasse|row}}{{FTUI Klasse|cell}}{{FTUI Klasse|cell-1-x}}{{FTUI Klasse|cell-x}}{{FTUI Klasse|left-align}}{{FTUI Klasse|right-align}}{{FTUI Klasse|bottom-align}}{{FTUI Klasse|top-align}}{{FTUI Klasse|center-align}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|row/col-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|col}}{{FTUI Klasse|col-1-x}}{{FTUI Klasse|col-x}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|hbox/vbox-Layout
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|vbox}}{{FTUI Klasse|hbox}}{{FTUI Klasse|card}}{{FTUI Klasse|phone-width}}{{FTUI Klasse|full-height}}{{FTUI Klasse|full-width}}{{FTUI Klasse|grow-0}}{{FTUI Klasse|grow-1}}{{FTUI Klasse|grow-2}}{{FTUI Klasse|grow-x}}{{FTUI Klasse|items-top}}{{FTUI Klasse|items-center}}{{FTUI Klasse|items-bottom}}{{FTUI Klasse|items-space-between}}{{FTUI Klasse|items-space-around}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Generelle Klassen für die Positionierung
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|inline}}{{FTUI Klasse|newline}}{{FTUI Klasse|top-space}}{{FTUI Klasse|top-space-2x}}{{FTUI Klasse|top-space-3x}}{{FTUI Klasse|left-space}}{{FTUI Klasse|left-space-2x}}{{FTUI Klasse|left-space-3x}}{{FTUI Klasse|right-space}}{{FTUI Klasse|right-space-2x}}{{FTUI Klasse|right-space-3x}}{{FTUI Klasse|top-narrow}}{{FTUI Klasse|top-narrow-2x}}{{FTUI Klasse|top-narrow-10}}{{FTUI Klasse|left-narrow}}{{FTUI Klasse|left-narrow-2x}}{{FTUI Klasse|left-narrow-3x}}{{FTUI Klasse|right-narrow}}{{FTUI Klasse|right-narrow-2x}}{{FTUI Klasse|right-narrow-3x}}{{FTUI Klasse|centered}}{{FTUI Klasse|wider}}{{FTUI Klasse|narrow}}{{FTUI Klasse|fullsize}}{{FTUI Klasse|compressed}}{{FTUI Klasse|height-narrow}}{{FTUI Klasse|w1x}}{{FTUI Klasse|w2x}}{{FTUI Klasse|w3x}}{{FTUI Klasse|maxw40}}{{FTUI Klasse|doublebox-v}}{{FTUI Klasse|doublebox-h}}{{FTUI Klasse|triplebox-v}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Vordergrundfarben
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|red}}{{FTUI Klasse|green}}{{FTUI Klasse|blue}}{{FTUI Klasse|lightblue}}{{FTUI Klasse|orange}}{{FTUI Klasse|gray}}{{FTUI Klasse|lightgray}}{{FTUI Klasse|white}}{{FTUI Klasse|black}}{{FTUI Klasse|mint}}{{FTUI Klasse|yellow}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Hintergrundfarben
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|bg-red}}{{FTUI Klasse|bg-green}}{{FTUI Klasse|bg-blue}}{{FTUI Klasse|bg-lightblue}}{{FTUI Klasse|bg-orange}}{{FTUI Klasse|bg-gray}}{{FTUI Klasse|bg-lightgray}}{{FTUI Klasse|bg-white}}{{FTUI Klasse|bg-black}}{{FTUI Klasse|bg-mint}}{{FTUI Klasse|bg-yellow}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Rahmen
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|verticalLine}}{{FTUI Klasse|border-black}}{{FTUI Klasse|border-white}}{{FTUI Klasse|border-orange}}{{FTUI Klasse|border-red}}{{FTUI Klasse|border-green}}{{FTUI Klasse|border-mint}}{{FTUI Klasse|border-lightblue}}{{FTUI Klasse|border-blue}}{{FTUI Klasse|border-gray}}{{FTUI Klasse|border-yellow}}{{FTUI Klasse|border-lightgray}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Größen
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|mini}}{{FTUI Klasse|tiny}}{{FTUI Klasse|small}}{{FTUI Klasse|normal}}{{FTUI Klasse|large}}{{FTUI Klasse|big}}{{FTUI Klasse|bigger}}{{FTUI Klasse|tall}}{{FTUI Klasse|great}}{{FTUI Klasse|grande}}{{FTUI Klasse|gigantic}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Schriftstil
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|thin}}{{FTUI Klasse|bold}}{{FTUI Klasse|darker}}{{FTUI Klasse|truncate}}
|}

{|class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"
!colspan="2" style="text-align: left;"|Sonstiges
|-
!class="mw-collapsible-content"|Klasse!!Beschreibung
{{FTUI Klasse|blank}}{{FTUI Klasse|transparent}}{{FTUI Klasse|half-transparent}}{{FTUI Klasse|blurry}}{{FTUI Klasse|shake}}{{FTUI Klasse|fail-shake}}{{FTUI Klasse|marquee}}{{FTUI Klasse|icon round}}{{FTUI Klasse|icon square}}{{FTUI Klasse|readonly}}{{FTUI Klasse|blink}}{{FTUI Klasse|rotate-90}}{{FTUI Klasse|horizontal}}{{FTUI Klasse|circleborder}}{{FTUI Klasse|autohide}}{{FTUI Klasse|notransmit}}{{FTUI Klasse|tab}}{{FTUI Klasse|FS20}}{{FTUI Klasse|value}}{{FTUI Klasse|novalue}}{{FTUI Klasse|timestamp}}{{FTUI Klasse|percent}}{{FTUI Klasse|nocache}}{{FTUI Klasse|fade}}{{FTUI Klasse|rotate}}{{FTUI Klasse|nolabels}}{{FTUI Klasse|default}}{{FTUI Klasse|prefetch}}{{FTUI Klasse|circulate}}{{FTUI Klasse|valueonly}}{{FTUI Klasse|positiononly}}{{FTUI Klasse|lineIndicator}}{{FTUI Klasse|barIndicator}}{{FTUI Klasse|roundIndicator}}{{FTUI Klasse|dim-tick}}{{FTUI Klasse|dim-front}}{{FTUI Klasse|dim-back}}{{FTUI Klasse|hue-tick}}{{FTUI Klasse|hue-front}}{{FTUI Klasse|hue-back}}{{FTUI Klasse|warn}}{{FTUI Klasse|activate}}{{FTUI Klasse|labelright}}{{FTUI Klasse|interlock}}{{FTUI Klasse|keepopen}}{{FTUI Klasse|noshade}}
|}

=== Icons ===
FTUI bringt einige Icons-"Schriftarten" mit, die für die Darstellung genützt werden können. Diese werden automatisch beim Start des UI eingebunden, sobald ein entsprechendes Icon-Präfix im Code der Seite vorkommt.

Verfügbare Icon-Schriftarten sind:
* Eingebaute Icons ''ftui-windows'' und ''ftui-door''. Präfix '''ftui-'''. Beispiel: <code>data-icon="ftui-door"</code>
* [http://fontawesome.io/icons/ Font-Awesome]: Mehr als 500 Icons zur Auswahl. Präfix '''fa-'''. Beispiel: <code>data-icon="fa-volume-up"</code>
* [https://material.io/icons/ Material Icons]: Mehr als 900 Icons zur Auswahl. Präfix '''mi-'''. Beispiel: <code>data-icon="mi-local_gas_station"</code>
* FHEM und OpenAutomation Icons: Präfix '''fs-''' und '''oa-'''. Beispiel: <code>data-icon="oa-secur_locked"</code>
* [https://erikflowers.github.io/weather-icons/ Weather-Icons]: Präfix '''wi-'''. Beispiel: <code>data-icon="wi-day-rain-mix"</code>

Alternativ können auch Bilder Icons (bspw. png) über CSS verwendet werden. Bspw:
<syntaxhighlight lang="html5">
<head>
<style type="text/css">
.logo-fhem {
background: url(https://wiki.fhem.de/fhemlogo.png) no-repeat;
width: 120px;
height: 132px;
background-size: contain;
}
</style>
</head>
<body>
<div data-type="symbol" data-icon="logo-fhem"></div>
</body>
</syntaxhighlight>

== Widgets ==
===Allgemeine Attribute===
Jedes Widget kann über verschiedene Attribute konfiguriert werden. Folgende Attribute gelten für alle Widgets:

{| class="wikitable"
|+allgemeine Attribute
|-
!align="right" |data-type
|Widget-Typ
|-
!align="right" |data-device
|FHEM-Name des Gerätes (mit dem Befehl 'list' bekommt man im FHEM die kpl. Liste)
|-
!align="right" |class
|CSS-Klassen für Aussehen und Formatierung des Widgets
|-
|}

{| class="wikitable"
|+Daten Empfangen
|-
!align="right" |data-get
|Reading Name
|-
!align="right" |data-get-on
|Wert für den Status on
|-
!align="right" |data-get-off
|Wert für den Status off
|-
|}

{| class="wikitable"
|+Daten Senden
|-
!align="right" |data-set
|Reading Name
|-
!align="right" |data-set-on
|Wert für den Status on
|-
!align="right" |data-set-off
|Wert für den Status off
|-
|}

Widget-spezifische Attribute können auf der jeweiligen Widget-Seite nachgelesen werden.

=== Integrierte Widgets ===
Folgende Widgets sind direkt in FHEM Tablet UI integriert und können "out of the box" verwendet werden.

* [[FTUI Widget Button|button]]: Variante der push und switch Widgets, die entweder einen URL ansteuern oder einen FHEM-Befehl absetzen kann.
* [[FTUI Widget Checkbox|checkbox]]: Umschalter zwischen zwei definierten Zuständen
* [[FTUI Widget Circlemenu|circlemenu]]: Mehrere Widgets hinter einem Widget verborgen, trotz des 'circle' im Namen kann das Menue jetzt auch horizontal oder vertikal ausgeklappt werden
* [[FTUI Widget Clock|clock]]: Stellt eine einfach Uhr zur Verfügung.
* [[FTUI Widget Colorwheel|colorwheel]]: Farbpalette zur Auswahl von Farben
* [[FTUI Widget Datetimepicker|datetimepicker]]: Erstellt eine Auswahl für Datum/Uhrzeit
* [[FTUI Widget Departure|departure]]: Abfahrtszeiten öffentlicher Verkehrsmittel
* [[FTUI Widget Dimmer|dimmer]]: Ein-/Aus-Button mit integriertem Schieberegler für z.B. einen Dim-Wert
* [[FTUI Widget Eventmonitor|eventmonitor]]:
* [[FTUI Widget Homestatus|homestatus]]: Auswahl für vier oder fünf definierte Stati eines Objects (z.B.: FHEM Residents)
* [[FTUI Widget Html|html]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/iframe iframe]: Widget zum Einbinden externer Inhalte in einem Iframe.
* [[FTUI Widget Image|image]]: Zeigt ein Bild, dessen URL fest vorgegeben oder aus einem Device-Reading gelesen werden kann.
* [[FTUI Widget Input|input]]: Erstellen eines Texteingabefeldes
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/joinedlabel joinedlabel]: verbindet mehrere Readings zu einem Feld
* [[FTUI Widget Klimatrend|klimatrend]]: wandelt Daten aus dem statistics-Modul in einen Pfeil um, der den aktuellen Trend anzeigt.
* [[FTUI Widget Knob|knob]]: Erstellt einen Statusbalken auf einer Kreisbahn
* [[FTUI Widget Label|label]]: Reading als Text anzeigen
* [[FTUI Widget Level|level]]: Vertikale oder horizontale Leiste zur Anzeige von Werten zwischen einem Minimal- und einem Maximalwert
* [[FTUI Widget Link|link]]: Erstellt einen Link oder Button zum Aufrufen von URLs oder Senden von Befehlen an FHEM
* [[FTUI Widget Medialist|medialist]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/multistatebutton multistatebutton]: Variante des push-Widgets das den set-Befehl abhängig vom gelesenen Status ändert.
* [[FTUI Widget Notify|notify]]: Blendet ein Hinweisfenster im Browser ein
* [[FTUI Widget Pagebutton|pagebutton]]: Button, mit dem auf andere Seiten gesprungen werden kann. Eignet sich gut für eine Navigation
* [[FTUI Widget Pagetab|pagetab]]: Tauscht den Inhalt einer Seite durch den einer anderen. Eignet sich gut für ein Navigationsmenü.
* [[FTUI Widget Playstream|playstream]]: Abspielen eines Webradio-Streams per Button
* [[FTUI Widget Popup|popup]]: Öffnet ein Popup nach einem Klick auf ein Widget oder HTML-Element
* [[FTUI Widget Progress|progress]]: Zeigt einen Prozentwert in Form einer runden Fortschrittsleiste
* [[FTUI_Widget_Push|push]]: Button, mir dem ein Befehl an FHEM gesendet werden kann.
* [[FTUI Widget Range|range]]: Erstellt vertikale Balken, die einen Wertebereich in unterschiedlichen Farben darstellen
* [[FTUI Widget Readingsgroup|readingsgroup]]: Zeigt eine Readingsgroup an, wie sie in FHEM definiert wurde
* [[FTUI Widget Rotor|rotor]]: Animiertes Umschalten von zwei oder mehr Widgets an einer Position
* [[FTUI_Widget_Select|select]]: Combobox, die eine Liste an Werten zur Auswahl anzeigt
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/settimer settimer]: Zum Anzeigen und Einstellen einer Uhrzeit.
* [[FTUI Widget Simplechart|simplechart]]: Einfaches XY-Diagramm zur Anzeige eines Wertes, der direkt aus einem FHEM-Logfile gelesen wird
* [[FTUI Widget Slideout|slideout]]:
* [[FTUI Widget Slider|slider]]: Vertikaler Schieberegler um einen Wert einzustellen
* [[FTUI Widget Spinner|spinner]]: Element um Werte durch Drücken auf Plus- und Minus- oder Höher-/Tiefer-Icons zu ändern
* [[FTUI Widget Swiper|swiper]]: Bietet die Möglichkeit, durch Wischen, zwischen verschiedenen Widgets zu wechseln
* [[FTUI Widget Switch|switch]]: Button um zwischen zwei Zuständen zu schalten (z.B. on / off)
* [[FTUI Widget Symbol|symbol]]: Status eines Devices als Symbol darstellen (z.B. Fenster offen)
* [[FTUI Widget Thermostat|thermostat]]: Anzeige für Heizungsthermostate, mit der die gewünschte Temperatur eingestellt werden kann
* [[FTUI Widget Volume|volume]]: Einstellscheibe zur Änderung eines einzelnen Wertes
* [[FTUI Widget Weather|weather]]: Wettersymbol anzeigen
* [[FTUI Widget WindDirection|wind_direction]]: Anzeige der Windrichtung auf einer Windrose

===3rd Party Widgets===
Für diese Widgets kann nicht sichergestellt werden, dass sie mit der jeweils aktuellen Version von FTUI funktionieren.
* [[FTUI Widget Agenda|agenda]]: Zeigt Kalendereinträge in einer Listenform an
* [[FTUI Widget Calview|calview]]: Zeigt Einträge aus einem [[CALVIEW]]-Device an
* [[FTUI Widget Chart|chart]]: Diagramm mit ähnlichen Möglichkeiten wie die FHEM-Plots
* [[FTUI Widget Classchanger|classchanger]]: Ändert seine CSS-Klassen je nach Status eines Devices
* [[FTUI Widget Clicksound|clicksound]]: Mit dem Widget "clicksound" können Sounds an Click-Events von Elementen gebunden werden.
* [[FTUI Widget Filelog|filelog]]:
* [[FTUI Widget Fullcalview|fullcalview]]:
* [[FTUI Widget Gds|gds]]:
* [[FTUI Widget Highchart|highchart]]:
* [[FTUI Widget Highchart3d|highchart3d]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/itunes_artwork itunes_artwork]: itunes_artwork durchsucht die iTunes-Datenbank anhand eines Arrays von beliebigen Suchworten nach einem Cover-Artwork und zeigt dieses an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/javascript javascript]: Ermöglicht die Ausführung beliebigen Javascript-Codes aus einem Reading.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/kodinowplaying kodinowplaying]: zeigt Informationen zu grade in KODI gespielten Medien in Form eines Labels an.
* [[FTUI Widget Loading|loading]]:
* [[FTUI Widget Meteogram|meteogram]]:
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/mpdnowplaying mpdnowplaying]: Zeigt Titelinformationen eines per MPD-Modul angebundenen Music Player Daemon an.
* [https://github.com/nesges/Widgets-for-fhem-tablet-ui/wiki/reload reload]: auslösen eine Pagereloads
* [[FTUI Widget Screensaver|screensaver]]:
* [[FTUI Widget Svgplot|svgplot]]:
* [[FTUI Widget Tts|tts]]: Sprachausgabe eines Textes aus einem Reading auf dem Endgerät.
* [[FTUI Widget UWZ|uwz]]: Anzeige der Warnungen der Unwetterzentrale
* [[FTUI Widget Wakeup|wakeup]]:
* [https://github.com/svenson08/ftui-weekdaytimer-widget wdtimer]: Visualisierung des [[WeekdayTimer]] Modul
* [[FTUI Widget Weekprofile|weekprofile]]: Visualisierung des [[weekprofile]] Moduls

==Templates==
Kommt ein bestimmtes "Code-Fragment" auf mehreren Seiten oder öfter pro Seite vor, bietet FTUI die Option, Templates zu erstellen. Diese werden einmal gebaut und können dann mit dem Attribut '''data-template''' nach Belieben in eine Seite eingefügt werden. Dabei besteht auch die Möglichkeit, Parameter zu verwenden.

Im Folgenden ein paar Beispiele, wie Templates verwendet werden können.

===Einzelnes Widget===
Soll ein Widget an mehreren Stellen in exakt der selben Ausführung eingebunden werden, kann diese Widget in einer eigenen Datei erstellt und diese dann auf den Zielseiten automatisch mitgeladen werden.

;Template-Seite
Die Template-Seite soll in diesem Beispiel ''template_symbol.html'' genannt werden. Diese wird daher zuerst im FTUI-Verzeichnis erstellt.
<syntaxhighlight lang="html">
<div data-type="symbol"
data-device="dummy1">
</syntaxhighlight>

;Haupt-Seite
Die oben erstellte Template-Seite kann nun in jeder gewünschten Seite eingebunden werden.
<syntaxhighlight lang="html" highlight="6">
[...]
<body>
<div class="gridster">
<ul>
<li data-row="1" data-col="1" data-sizey="1" data-sizex="1">
<div data-template="template_symbol.html"></div>
</li>
</ul>
</div>
</body>
[...]
</syntaxhighlight>

===Gridster-Element===
Natürlich kann auch ein ganzes Gridster-Element - in diesem Fall ein Menü - als Template eingebunden werden.
<syntaxhighlight lang="html">
<li data-row="1" data-col="1" data-sizex="1" data-sizey="4" data-template="menu.html"></li>
</syntaxhighlight>

=== Widget-Gruppen ===
Die Template-Datei des [[#Einzelnes Widget|ersten Beispiels]] kann natürlich auch mehrere Widgets auf einmal enthalten.

=== Verwendung von Parametern ===
==== Einfaches Beispiel ====
Oft wird ein und dasselbe, liebevoll gestaltete, Widget für verschiedenen Devices verwendet. Um nicht für jedes Device das Widget neu kopieren zu müssen (bzw. bei Änderungen alle Seiten ausbessern zu müssen), kann ein Template verwendet werden, dem einfach per Parameter mitgeteilt wird, von welchem Device es gerade die Daten empfangen soll.

In diesem Beispiel wird ein Template erzeugt, dass nur die Temperatur verschiedenen Thermostate mittels eines [[FTUI Widget Label|Label-Widgets]] anzeigt.

;Template-Seite
Die Template-Seite enthält nur ein einfaches Label-Widget und wird in diesem Beispiel ''template_label.html'' genannt. Um sie für mehrere Devices verwenden zu können, wird im Attribut '''data-device''' der Name des eigentlichen Devices durch den Parameter '''par01''' ersetzt.
<syntaxhighlight lang="html" highlight="2">
<div data-type="label"
data-device="par01"
data-get="measured-temp"></div>
</syntaxhighlight>

;Haupt-Seite
Auf der Haupt-Seite wird die Template-Seite mit dem Attribut '''data-template''' eingebunden und ihr via Attribut '''data-parameter''' das jeweils gewünschte Device übergeben.
<syntaxhighlight lang="html">
[...]
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat1"}'></div>
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat2"}'></div>
<div data-template="template_label.html" data-parameter='{"par01":"Thermostat3"}'></div>
[...]
</syntaxhighlight>

==== Wetter-Slider mit Template ====
In diesem Beispiel wird ein [[FTUI Widget Slider|Slider-Widget]] erstellt, welches die verschiedenen Tage eines Wetterberichtes anzeigt. Dabei wird für den Wetterbericht des jeweiligen Tages immer dasselbe Template verwendet um nicht für jeden Tag ein eigenes Widget schreiben zu müssen.

;Template-Seite
<syntaxhighlight lang="html">
<div class="left">
<div data-type="label" data-device="AgroWeather" data-get="par01" data-unit="°C"></div>
<div class="inline">
<div data-type="label" data-device="AgroWeather" data-get="par02"></div>
<div data-type="weather" data-device="AgroWeather" data-get="par02"></div>
min: <div data-type="label" data-device="AgroWeather" data-get="par03" data-unit="°C"></div>
</div>
</div>
<div class="left">
<div data-type="label" data-device="AgroWeather" data-get="par04" data-substitution="toDate().eeee()+','"></div>
<div data-type="label" data-device="AgroWeather" data-get="par04" data-substitution="toDate().ddmm()"></div>
</div>
</syntaxhighlight>

;Haupt-Seite
In der Haupt-Seite wird das Template dann für jede Slider-Seite eingebunden und das Reading für den jeweiligen Tag via Parameter übergeben.
<syntaxhighlight lang="html">
[...]
<div data-type="swiper">
<ul>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc0_tempMax","par02":"fc0_weatherDay","par03":"fc0_tempMin","par04":"fc0_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc1_tempMax","par02":"fc1_weatherDay","par03":"fc1_tempMin","par04":"fc1_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc2_tempMax","par02":"fc2_weatherDay","par03":"fc2_tempMin","par04":"fc2_date"}'></li>
<li data-template="templates/wetter.html" data-parameter='{"par01":"fc3_tempMax","par02":"fc3_weatherDay","par03":"fc3_tempMin","par04":"fc3_date"}'></li>
</ul>
</div>
[...]
</syntaxhighlight>

== JavaScript-Funktionen ==
Neben den Widgets können auch einige JavaScript-Funktionen verwendet werden, um Befehle an FHEM zu senden.

Folgende Zeile setzt einen direkten Befehl an FHEM ab (<code>set dummy1 off</code>):
<syntaxhighlight lang="html"><div onclick="ftui.setFhemStatus('set dummy1 off')">Dummy1 aus</div></syntaxhighlight>

Diese Zeile veranlasst FHEM dazu, eine Funktion aus der 99_myUtils.pm auszuführen (<code>myUtils_HeizungUpDown("WZ.Thermostat_Climate","up")</code>):
<syntaxhighlight lang="html"><div onclick="ftui.setFhemStatus('{myUtils_HeizungUpDown("WZ.Thermostat_Climate","up")}')">+</div></syntaxhighlight>

Ein Beispiel, wie ein Kommando an FHEM gesendet wird und gleichzeitig der Wert eines bereits in FTUI angezeigten Readings verwendet werden kann:
<syntaxhighlight lang="html">
<div data-type="label" data-device="dummy1" data-get="temperature"></div>
<div onClick="ftui.setFhemStatus('set dummy2 '+ftui.getDeviceParameter('dummy1','temperature').val);">Senden</div>
</syntaxhighlight>

== FAQ ==
Häufig gestellte Fragen zum FHEM Tablet UI sind in der [[FHEM Tablet UI FAQ]] zusammengestellt.

== Links ==
* [https://github.com/knowthelist/fhem-tablet-ui Projekt auf Github]
* {{Link2Forum|Topic=34233|LinkText=Forums-Beitrag}}
* [[FTUI_Snippets|Snippets]]
* [http://knowthelist.github.io/fhem/tablet/demo_widgets.html Live-Demos]
* {{Link2Forum|Topic=37378|LinkText=User-Demos}}
* [https://github.com/ovibox/fhem-ftui-user-demos Download der User-Demo-Dateien]

[[Kategorie:FHEM Tablet UI]]

Staubsaugerroboter

2017-08-15T09:14:09Z

Scooty: Link zu Xiaomi Thread eingefügt

== Einführung ==
== Produkte und Einbindung in FHEM ==
=== Dyson ===
==== Produkte ====
Siehe [http://www.dyson.de/staubsauger/saugroboter/dyson-360-eye.aspx Dyson 360 Eye]. Baut sehr hoch, hohe Saugleistung. Sehr kritische Amazon-Bewertungen.
==== Einbindung in FHEM ====
==== Erfahrungen ====

=== LG ===
==== Produkte ====
Siehe [http://www.lg.com/de/staubsauger-roboter Produktübersicht]
==== Einbindung in FHEM ====
Siehe [[HOMBOT]] und [https://forum.fhem.de/index.php/topic,44923.msg367178.html#msg367178 Forumsthread].

Zusammenfassung:

# Kompatiblen WiFi-Stick kaufen
# Firmware-Hack einspielen nach Anleitung
# HOMEBOT-Modul installieren
# Im WiFi-Router, dhcp-Optionen den Roboter eine feste IP zuweisen
# Roboter in FHEM integrieren<br><code>define Dobby HOMBOT <IP-Adresse></code>
# Mittels at/DOIF oder notifies die Reinigung anstossen, z.B.<br> <code>define DI_LGHomeBotSchedule DOIF ([07:45|8] or [10:30|7]) (set Dobby cleanStart)</code>

==== Erfahrungen ====

# ('''LG VR64701LVMP''') Nach einem Jahr täglichem Gebrauch auf ca. 160qm, Hartboden Fliesen und Holz: Gerät verliert sein Vorderrad, Ersatz nur bei geöffnetem Gerät möglich. Verbrauchsmaterialien: 2 HEPA-Filter, zwei rotierende Vorderbürsten (gelb). Sehr gefrickelte WiFi-Installation in Abhängigkeit mit der Firmware. Reinigungsleistung in Ordnung, keine Meldung über vollen Sammelbehälter. In vielen Ecken bleibt Staub liegen. Gerät versucht häufig, über Stufen und Kanten zu klettern und bleibt dort hängen (Türschwellen, Türstopper). Ersatzteil-Beschaffung einfach. Mapping mangelhaft, Raumerkennung nicht gelungen und variiert täglich. Einsatz in dunklen Räumen nicht gelungen. Firmware-Hack-Anleitung für WiFi auf [http://www.roboter-forum.com/showthread.php?13718-HomBot-3-0-Guide-Alle-Infos-Alle-Links www.roboter-forum.com]

=== Neato ===
==== Produkte ====
Siehe [https://www.neatorobotics.com/de/robot-vacuum/botvac/ Produktübersicht]. Vorwerk und Neato entwickeln gemeinsam.
==== Einbindung in FHEM ====
Siehe [https://forum.fhem.de/index.php/topic,51713.0.html Forumsthread] und Link zu Github
==== Erfahrungen ====
=== Roomba ===
==== Produkte ====
Siehe [http://www.irobot.de/Haushaltsroboter/staubsaugen Produktübersicht]
==== Einbindung in FHEM ====
Siehe [https://forum.fhem.de/index.php/topic,67632.msg603276.html#msg603276 Forumsthread]
==== Erfahrungen ====
=== Vorwerk ===
==== Produkte ====
Siehe [https://kobold.vorwerk.de/saugroboter/ Produktübersicht]. Vorwerk und Neato entwickeln gemeinsam.
==== Einbindung in FHEM ====
Siehe [https://forum.fhem.de/index.php/topic,51713.0.html Forumsthread] und Link zu Github
==== Erfahrungen ====
=== Xiaomi ===
==== Produkte ====
Offiziell nicht in Europa erhältlich, jedoch bei de.gearbest.com.
Siehe [http://de.gearbest.com/robot-vacuum/pp_440546.html?wid=35 Mi Vaccum]
==== Einbindung in FHEM ====
Siehe [https://forum.fhem.de/index.php/topic,73052.0.html Forumsthread]
==== Erfahrungen ====

[[Kategorie:Other Components]]

FTUI Widget Symbol

2017-04-28T06:53:42Z

Scooty: data-hide Attribute (analog zu widget Switch)

Das [[{{PAGENAME}}|Widget Symbol]] ist ein Widget für [[FHEM Tablet UI]], mit dem - ggf. gesteuert durch ein reading - ein Symbol dargestellt wird. Dieses Widget generiert nur eine Anzeige; es besitzt keine Möglichkeit zur Interaktion.

<gallery widths="600" height="200">
File:FTUI_Widget_Symbol_01.png
</gallery>

==Attribute==
Neben den '''allgemeinen Attributen''' besitzt das SYMBOL-Widget die nachfolgenden Attribute.

{| class="wikitable"
! HTML Attribut !! Beschreibung !! Default Wert
|-
| data-get || Name des Readings, welches ausgelesen wird || STATE
|}

Einstellung bei zwei Werten
{| class="wikitable"
!Attribut !! Beschreibung !! Default-Wert
|-
|'''data-get-on''' ||Wert für on ||<nowiki>true|1|on|open</nowiki>
|-
|'''data-get-off''' ||Wert für off ||<nowiki>false|0|off|closed</nowiki>
|-
|'''data-get-warn''' ||Wert für Warnmeldung (Rote Zahl am Rand) ||-1 (=aus)
|-
|'''data-icon''' ||Name des Symbols||ftui-window
|-
|'''data-background-icon''' ||Hintergrundsymbol ||
|-
|'''data-on-background-color''' ||Hintergrundfarbe für ON-Zustand. ||#aa6900
|-
|'''data-off-background-color''' ||Hintergrundfarbe für OFF-Zustand. ||#505050
|-
|'''data-on-color''' ||Farbe für ON-Zustand. ||#aa6900
|-
|'''data-off-color''' ||Farbe für OFF-Zustand. ||#505050
|-
|}

Einstellung bei mehreren Werten
{| class="wikitable"
!Attribut !! Beschreibung !!Default Wert
|-
|'''data-states''' ||Array für states ||
|-
|'''data-icons''' ||Array mit Icons zu data-states Array ||
|-
|'''data-background-icons''' ||Array mit Icons zu data-states Array ||
|-
|'''data-colors''' ||Array mit Farben zu data-states Array ||
|-
|'''data-background-colors''' ||Array mit Hintergrundfarben zu data-states Array ||
|-
|'''data-hide'''||Reading zum Verstecken des Elementes. Das Element verschwindet, wenn der Wert mit '''data-hide-on''' übereinstimmt.||'STATE'
|-
|'''data-hide-on'''||Zeichenkette, bei der das Element versteckt wird||<nowiki>'true|1|on'</nowiki>
|-
|'''data-hide-off'''||Zeichenkette, bei der das Element angezeigt wird||'!on'
|-
|}

data-get-on, data-get-off and data-states akzeptieren auch reguläre Ausdrücke (RegEx). Möglich sind auch Animationen, z.B. Blinken.

==CSS-Klassen==
{|class="wikitable"
!Klasse!!Beschreibung
{{FTUI Klasse|mini}}{{FTUI Klasse|tiny}}{{FTUI Klasse|small}}{{FTUI Klasse|normal}}{{FTUI Klasse|large}}{{FTUI Klasse|big}}{{FTUI Klasse|bigger}}{{FTUI Klasse|tall}}{{FTUI Klasse|grande}}{{FTUI Klasse|gigantic}}{{FTUI Klasse|compressed}}{{FTUI Klasse|compressed-50}}{{FTUI Klasse|transparent}}{{FTUI Klasse|half-transparent}}{{FTUI Klasse|hide}}{{FTUI Klasse|warn}}
|}

==Beispiele==
===Einfaches Symbol===
[[File:FTUI_Widget_Symbol_02.png]]
<source lang="html">
<div data-type="symbol" data-device="Web-Status" class=""></div>
</source>
(Das device "Web-Status" liefert in diesem Fall den Wert "fa-rss-square")

===Symbol mit vier Zuständen und Animation===
[[File:FTUI_Widget_Symbol_03.png|800px]]
<source lang="html">
<div class=""
data-type="symbol"
data-device="Garage"
data-states='["oben","unten","lauf","angehalten","Fehler"]'
data-icons='["oa-fts_garage_door_10","oa-fts_garage_door_100","fa-cog fa-spin","oa-fts_garage_door_40","fa-bug"]'
data-colors='["GoldenRod","SeaGreen","Crimson","Crimson","Crimson"]'></div>
</source>

==Weitere Beispiele==
===Batterieüberwachung mit Regulärem Ausdruck (0.0 - 3.9)===
<source lang="html">
<div data-type="symbol"
data-device="WohnzimmerHeizung"
data-get="batteryLevel"
data-states='["3.[0-9]","2.[789]","2.[456]","2.[123]","((2.0)|([01].[0-9]))"]'
data-icons='["fa-battery-4","fa-battery-3","fa-battery-2","fa-battery-1","fa-battery-0"]'
data-colors='["#505050","#505050","#505050","#ad3333","#ad3333"]'>
</div>
</source>

===Batterieüberwachung mit Regulärem Ausdruck (0 - 100)===
<source lang="html">
<div data-type="symbol"
data-device="dDummy3"
data-get-on="[\d]+"
data-get-off="!on"
data-states='["100","([7][5-9])|([8-9][0-9])","([5-6][0-9])|([7][0-4])","([2][5-9])|([3-5][0-9])","([0-9])|([1][0-9])|([2][0-4])"]'
data-icons='["fa-battery-4","fa-battery-3","fa-battery-2","fa-battery-1","fa-battery-0"]'></div>
</source>
[[Datei:FTUI_Widget_Symbol_04.png]]

===Batterieüberwachung mit Größenvergleich und gedrehten Symbolen===
<source lang="html">
<div data-type="symbol"
data-device="BadHeizung"
data-get="batteryLevel"
data-states='["0","2","2.4","2.7","3.0"]'
data-icons='["oa-measure_battery_0 fa-rotate-90","oa-measure_battery_25 fa-rotate-90","oa-measure_battery_50 fa-rotate-90","oa-measure_battery_75 fa-rotate-90","oa-measure_battery_0 fa-rotate-90"]'
data-colors='["#ad3333","#ad3333","#505050","#505050","#505050"]'>
</div>
</source>

===Türsymbol mit Warnung bei geöffneter Tür===
<source lang="html">
<div data-type="symbol" data-device="Eingangstuer"
data-states='["open","closed"]'
data-icons='["ftui-door warn","ftui-door"]'
data-colors='["#999","#555"]' >
</div>
</source>

[[Kategorie:FHEM Tablet UI]]

Z-Wave

2016-02-14T09:17:26Z

Scooty: /* Multisensor 6 */

<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 1000 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.

=== 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")[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.

== 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 Nutzung von Z-Wave in Fhem ist für den Anfänger nur mit der standardmäßig eingeschalteten [http://fhem.de/commandref.html#autocreate autocreate-Funktion] einfach umsetzbar. 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. Die Handbücher und technischen Informationen vieler Z-Wave-Geräte sind -trotz verschiedener Hersteller- zentral unter http://www.zwave.de/handbuecher/ in Deutsch abrufbar. Der Aufbau aller dort veröffentlichten Handbücher ist gleichartig, so dass man einen schnellen Einstieg in die Produkte und deren technischen Eigenschaften von verschiedenen Herstellern findet. Manche Hersteller (z.B. Fibaro) bieten zusätzlich auf Ihren Internetseiten noch separate, eigene Handbücher an. Bei ZWave-Plus-zertifizierten Geräten sind detaillierte Handbücher zudem unter http://products.z-wavealliance.org auf der gerätespezifischen Seite zu finden. Diese enthalten teilweise mehr Informationen als die den Produkten beigelegten Handbücher (z.B. AEOTEC).

== Definition des Gateways / Controllers ==
=== Autocreate des Gateways ===
Fhem kann mit einem Funkgateway Z-Wave-Funk empfangen und senden. Z-Wave-Gateways (Controller) existieren von verschiedenen Herstellern.

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 grundlegend durch entsprechende Einträge in der Konfiguration definiert. Ein manuelles Anlegen des ZWDongle-Moduls oder Eingriffe in die Konfiguration sind normalerweise nicht notwendig und auch nicht ratsam. Unter Windows ist ein manuelles Anlegen der Definition des ZWave-Gateways wegen fehlender Unterstützung des Befehls <code>usb scan</code> notwendig. 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/ttyUSB0@115200

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

Folgende Gateways wurden bereits erfolgreich mit Fhem eingesetzt:
* AEON Labs Z-Stick S2 (SDK 5.x; aktuellste Firmware 3.07 ist von 6/2010)
* Aeotec Z-Stick Gen5 (SDK 6.5; Z-Wave Plus) ({{Link2Forum|Topic=47000}})
* Goodway WD6001 (SDK 5.03 {{Link2Forum|Topic=40594|Message=332235}})
* Razberry in Verbindung mit Raspberry Pi (neue Gen5 Razberry: Z-Wave Plus[http://forum.z-wave.me/viewtopic.php?f=3419&t=21327#p55404]) (Notwendige Vorarbeiten: {{Link2Forum|Topic=11716|Message=190402}})
* Vision Z-Wave USB Stick ZU 1401 EU (VIS_ZU1401; SDK 6.x)
* Z-Wave.Me Z-StickC ({{Link2Forum|Topic=29930|Message=226530}})
* Z-Wave USB Stick (ZME_UZB1; Z-Wave Plus) ({{Link2Forum|Topic=30257}})

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.

Bei der Auswahl des Gateways (und auch der Sensoren/Aktoren) empfiehlt es sich, auf das unterstützte SDK zu achten. Gateways mit Unterstützung von SDK 4.5x und 6.x oder neuer bieten mehr Funktionen, insbesondere auch hinsichtlich der Netzwerkstabilität (Explorer Frames), als Gateways mit älteren SDK-Versionen. Aber '''ACHTUNG:''' das SDK 5.x ist älter als SDK 4.5x. Details hierzu enthält das [http://wiki.zwaveeurope.com/index.php?title=SDK_Versions_and_Explorer_Frames wiki.zwaveeurope.com]. Einen Hinweis auf ein derzeit aktuelles SDK bietet auch die [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus-Zertifizierung].

=== 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_1 ist im folgenden durch den eigenen Gatewaynamen zu ersetzen):
get ZWDongle_1 homeId
ergibt beispielsweise:
ZWDongle_1 homeId => HomeId:e345c456 CtrlNodeId:01

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

== Definition von Geräten / Slaves ==
=== Hinzufügen eines neuen Z-Wave Geräts / Inklusion ===
Zuerst wird das Z-Wave Gateway in den Standard-Modus zur Inklusion (zum Aufnehmen) neuer Geräte gesetzt:
set ZWDongle_1 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 dem obigen Befehl besser der Network-Wide-Modus für die Inklusion genutzt werden:
set ZWDongle_1 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 [http://fhem.de/commandref.html#rename 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 ist im Raum "ZWave" zu finden.

Abschließend wird der Inklusionsmodus am Z-Wave Gateway wieder ausgeschaltet:
set ZWDongle_1 addNode off

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>set <name> neigborUpdate</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 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!}}
Geräte können über Assoziationen direkt mit anderen 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.

Geräte können mehrere Assoziationsgruppen (Association Groups) haben, die für vom Hersteller vorgesehene unterschiedliche Aktionen definiert sind. Welche das sind, geht aus der jeweiligen Bedienungsanleitung hervor.

Damit Fhem Statusmeldungen von Sensoren/Aktoren anzeigen und auch darauf reagieren kann, '''muss''' der Controller (ZWDongle_1, <code>CtrlNodeId</code> = typischerweise 1) mit der/den passenden Assoziationsgruppe(n) des jeweiligen Gerätes <code><name></code> assoziiert 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]]). Daher legt Fhem die Assoziation von Controller mit der Assoziationsgruppe 1 des Gerätes bei der Inklusion immer automatisch an. 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 Assozationen 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 gesetzten Assoziationen für eine Assoziationsgruppe:
get <name> association <associationGroup>

Abruf der gesetzten Assoziationen 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://www.pepper1.net/zwavedb/ pepper1-Zwave-Datenbank]) 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.JPG|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 pepper1-Zwave-Datenbank enthalten ist. Im Erfolgsfall wird ein Link "Details in pepper1.net" unten in der Detailansicht des Fhem-Geräte-Devices zum entsprechenden Geräteeintrag 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_1 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_1 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_1 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_1 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. Im obigen Beispiel ist der Eintrag "ZWDongle_1". 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_1 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. 5-10 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>
mit, dass der Befehl im Send-Stack abgespeichert und bei der nächsten "wakeup notification" an das Gerät versendet wird. Ein Versand der Befehle im Send-Stack 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.

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 ===
==== 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://www.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 ===
==== 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 ===
Bei vielen bisher erschienenen Devices wird die Association Group 3 für die Übermittlung von Sensor Werten verwendet.
set <name> associationAdd 3 <CtrlNodeId>

==== FGSS-001 Rauchmelder ====
Dieser Rauchmelder scheint einen falschen Batterie-Level (0%) zu senden, wenn er außerhalb des wakeup intervals abgefragt wird.

Workaround: Den Batterie-Level nicht direkt via <code>get</code> anfordern, sondern per <code>notify</code> auf den wakeup Report reagieren.

(Dieser Workaround sollte in aktuellen Fhem-Versionen durch eine Änderung in der Behandlung von Wakeup-Geräten nicht mehr notwendig sein. Mangels Rückmeldung von Besitzern des FGSS-001 ist dies aber noch nicht bestätigt.)

==== FGK-101 Tür/Fensterkontakt ====
* 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)
* Der Tür/Fensterkontakt sendet Zustandsänderungen als Report der Class BASIC (ff oder 00). Anpassung auf open/closed ist mit dem Attribut <code>stateFormat</code> möglich.
* Der Status (open / closed) über die Class SENSOR_BINARY wird nur nach explizitem <code>get</code> gemeldet.
* 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}}
==== POPE009006 Z-Wave Wall Plug Switch ====
siehe {{Link2Forum|Topic=40771}}

=== 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.

== Links ==
* Grundlageninformation "Z-Wave-Haupt-Anleitung": [http://manuals.zwaveeurope.com/Generic_Z_de.pdf Wie errichte und betreibe ich ein Z-Wave basiertes Funknetz]
* herstellerübergreifende Datenbank mit Bedienungsanleitungen zu Z-Wave-Geräten: http://www.zwave.de/handbuecher/ oder http://manuals.zwaveeurope.com
* herstellerübergreifende Datenbank mit technischen Informationen zu Z-Wave-Geräten (Z-Wave Device Library): http://www.pepper1.net/zwavedb/
* Z-Wave-Produktdatenbank mit Angabe zur Zertifizierung (Z-Wave oder [http://z-wavealliance.org/z-wave_plus_certification Z-Wave Plus]): http://products.z-wavealliance.org
* 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
* Hilfen zur Einbindung von Command Classes in Fhem
** [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)

== 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 (<code>list <device></code>)
::Bitte vor Aufruf des list-Befehls -wenn vorhanden/möglich- folgende Befehle ausführen:
::*<code>get <device> associationAll</code>
::*<code>get <device> configAll</code>
::*<code>get <device> versionClassAll</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

=== 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. über autocreate angelegt (Details und Beispiel siehe [http://fhem.de/commandref.html#ZWaveget commandref]).

=== Wie kann man die SDK-Version eines Gerätes herausfinden? ===
Durch den Befehl <code><nowiki>get <name> version</nowiki></code> kann man die ZWave-Protokoll-Version von Geräten und Controllern 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? ===
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 commandref 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}}

=== 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 nicht erneut vergeben. Nur bei einem Controller-Reset, der mit einem unwiederbringlichen Verlust sämtlicher Informationen des ZWave-Netzes und Neuvergabe der HomeID verbunden ist, beginnt die Zählung wieder von vorne.

=== 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 Parmaeterwerten- 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. Aufbau und Struktur einer einzelnen XML-Config-Datei ist der oben verlinkten Seite bei openzwave zu entnehmen.

Prüfschritte und Vorgehensweise:
* Gerät ist auf https://github.com/OpenZWave/open-zwave/tree/master/config oder https://github.com/jeedom/plugin-openzwave/tree/master/ressources/openzwave/config in manufacturer_specific.xml und dem herstellerspezifischen Unterordner bereits vorhanden, aber steht in Fhem nicht zur Verfügung: Hinweis mit Link im Forum ({{Link2Forum|Area=ZWave}}), dass die XML-Config-Dateien in Fhem aktualisiert werden sollen.
* Andernfalls: 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 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.

[[Kategorie:HOWTOS]]
[[Kategorie:Z-Wave Components]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2016-02-12T16:56:41Z

Scooty: Überarbeitung nach neuestem Stand

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Vorabinfo ===
Alle Aktionen in diesem Artikel (Inklusion, Assoziation,...) wurden mit dem Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) auf Position "schwarz" durchgeführt.

=== Inklusion ===
Der Aktor und seine einzelnen Steckdosen werden bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2016.02.11 18:08:03 2: autocreate: define ZWave_SWITCH_BINARY_56 ZWave d79c8805 56 25326072862071702785877556
2016.02.11 18:08:03 2: autocreate: define FileLog_ZWave_SWITCH_BINARY_56 FileLog /opt/fhem/log/ZWave_SWITCH_BINARY_56-%Y-%m.log ZWave_SWITCH_BINARY_56
2016.02.11 18:08:08 2: ZWave set ZWave_SWITCH_BINARY_56 associationAdd 1 01
2016.02.11 18:08:09 2: ZWave set ZWave_SWITCH_BINARY_56 mcCreateAll
2016.02.11 18:08:09 2: ZWave get ZWave_SWITCH_BINARY_56 mcCapability 1
2016.02.11 18:08:09 2: ZWave get ZWave_SWITCH_BINARY_56 mcCapability 2
2016.02.11 18:08:09 2: ZWave get ZWave_SWITCH_BINARY_56 mcCapability 3
2016.02.11 18:08:09 2: ZWave get ZWave_SWITCH_BINARY_56 mcCapability 4
2016.02.11 18:08:09 2: ZWave get ZWave_SWITCH_BINARY_56 mcCapability 5
2016.02.11 18:08:09 2: ZWave get ZWave_SWITCH_BINARY_56 mcCapability 6
2016.02.11 18:08:09 2: autocreate: define ZWave_BASIC_56.01 ZWave d79c8805 14337 20253275
2016.02.11 18:08:09 2: autocreate: define FileLog_ZWave_BASIC_56.01 FileLog /opt/fhem/log/ZWave_BASIC_56.01-%Y-%m.log ZWave_BASIC_56.01
2016.02.11 18:08:09 2: ZWave get ZWave_SWITCH_BINARY_56 model
2016.02.11 18:08:10 2: ZWDongle_ProcessSendStack: no ACK, resending message 010a001338036009022538ab
2016.02.11 18:08:10 2: autocreate: define ZWave_BASIC_56.02 ZWave d79c8805 14338 20253275
2016.02.11 18:08:10 2: autocreate: define FileLog_ZWave_BASIC_56.02 FileLog /opt/fhem/log/ZWave_BASIC_56.02-%Y-%m.log ZWave_BASIC_56.02
2016.02.11 18:08:12 2: ZWDongle_ProcessSendStack: no ACK, resending message 010a001338036009032538aa
2016.02.11 18:08:12 2: autocreate: define ZWave_BASIC_56.03 ZWave d79c8805 14339 20253275
2016.02.11 18:08:12 2: autocreate: define FileLog_ZWave_BASIC_56.03 FileLog /opt/fhem/log/ZWave_BASIC_56.03-%Y-%m.log ZWave_BASIC_56.03
2016.02.11 18:08:13 2: ZWDongle_ProcessSendStack: no ACK, resending message 010a001338036009042538ad
2016.02.11 18:08:14 2: autocreate: define ZWave_BASIC_56.04 ZWave d79c8805 14340 20253275
2016.02.11 18:08:14 2: autocreate: define FileLog_ZWave_BASIC_56.04 FileLog /opt/fhem/log/ZWave_BASIC_56.04-%Y-%m.log ZWave_BASIC_56.04
2016.02.11 18:08:15 2: ZWDongle_ProcessSendStack: no ACK, resending message 010a001338036009052538ac
2016.02.11 18:08:15 2: autocreate: define ZWave_BASIC_56.05 ZWave d79c8805 14341 20253275
2016.02.11 18:08:15 2: autocreate: define FileLog_ZWave_BASIC_56.05 FileLog /opt/fhem/log/ZWave_BASIC_56.05-%Y-%m.log ZWave_BASIC_56.05
2016.02.11 18:08:17 2: ZWDongle_ProcessSendStack: no ACK, resending message 010a001338036009062538af
2016.02.11 18:08:17 2: autocreate: define ZWave_BASIC_56.06 ZWave d79c8805 14342 20253275
2016.02.11 18:08:17 2: autocreate: define FileLog_ZWave_BASIC_56.06 FileLog /opt/fhem/log/ZWave_BASIC_56.06-%Y-%m.log ZWave_BASIC_56.06

Über das Device <code>ZWave_SWITCH_BINARY_56</code> können alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden und die gesamte Steckdosenleiste ein- oder ausgeschaltet werden.

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Werks-Reset ===
Zum Zurücksetzen auf die Werkseinstellungen
* die Steckdosenleiste vom Stromnetz trennen
* die Ein/Aus-Taste bzw. Statuskontrollleuchte gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Ein/Aus-Taste bzw. Statuskontrollleuchte weiterhin für ca. 5 Sekunden gedrückt halten. Die Statuskontrollleuchte leuchtet dabei für ca. 4 Sekunden
* die Ein/Aus-Taste bzw. Statuskontrollleuchte loslassen, die Konfiguration der Steckdosenleiste befindet sich wieder im Auslieferungszustand

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway (wird bei Nutzung von <code>autocreate</code> automatisch gesetzt)
|-
| 2
| Relais-Zustand: das Gerät sendet eine Alarmnachricht, wenn Leckstrom erkannt wurde
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste
|-
| 4
| Überstromschutz: das Gerät sendet einen Funkalarm, wenn ein Überstrom erkannt und der Verbraucher abgeschaltet wurde
|}
Vielen Dank an [http://forum.fhem.de/index.php/topic,46865.msg387694.html#msg387694 syslog ] zur Vervollständigung der Informationen.

=== Konfiguration ===

==== Manuelle Einbindung der weiteren Steckdosen ====
Sollte das Anlegen der einzelnen Steckdosen per <code>autocreate</code> fehlgeschlagen sein, kann man die einzelnen Steckdosen als einzelne Devices manuell über die MULTICHANNEL-Klasse des Devices <code>ZWave_SWITCH_BINARY_56</code> anlegen.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_56 mcCapability 2
get ZWave_SWITCH_BINARY_56 mcCapability 3
get ZWave_SWITCH_BINARY_56 mcCapability 4
get ZWave_SWITCH_BINARY_56 mcCapability 5
get ZWave_SWITCH_BINARY_56 mcCapability 6
werden die entsprechenden Devices in FHEM angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_56 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_56.02 ZWave d79c8805 14338 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_56 configNoCommunicationLight 255
und/oder (???)
set ZWave_SWITCH_BINARY_56 configLEDSignalsNetworkError Off
kann diese Anzeige deaktiviert werden.

==== Energiemessdaten ====
Energiemessdaten der '''gesamten''' Steckdosenleiste können über
get ZWave_SWITCH_BINARY_56 meter
bzw.
get ZWave_SWITCH_BINARY_56 meter 2
abgefragt werden.

Energiemessdaten jeder '''einzelnen''' Steckdose können z.B. über
get ZWave_BASIC_56.04 meter
bzw.
get ZWave_BASIC_56.04 meter 2
abgefragt werden.

Eine automatische Meldung von Energiemesswerten erfolgt abhängig vom Konfigurationsparameter
configPowerReportThreshold
Minimal change in percent after which the GreenWave device reports its energy status (default 10)
gesammelt im Device <code>ZWave_BASIC_56.01</code> ohne Möglichkeit, diese Werte einer einzelnen Steckdose zuordnen zu können

(s. auch Antwort #10 im Forumsthread {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}).

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> oder obiger Vorgehensweise in FHEM angelegten Devices (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''56'''
| Device für die gesamten Steckdosenleiste mit Konfigurationsmöglichkeiten
|-
| ZWave_BASIC_'''56.01''' bis ZWave_BASIC_'''56.06'''
| Steckdosen 1 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Der Default-Wert des Konfigurationsparameters
configStateAfterPowerLoss
Desired state of the device after a power loss
Possible values: Off (0), On (2), StateBeforePowerLoss (1)
ist '''2''' (= alle Steckdosen sind nach einem Stromausfall eingeschaltet)!
* Die Position LOCK des Einstellrads zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) schaltet alle Steckdosen ein und verhindert jegliche Kommunikation mit dem ZWave-Controller/-Gateway.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_56.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_56.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_56 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_56 on
Device-Log ZWave_Node_56.01:
2015-09-12_13:47:03 ZWave_BASIC_56.01 on
2015-09-12_14:48:22 ZWave_BASIC_56.01 off
2015-09-12_14:48:37 ZWave_BASIC_56.01 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_BASIC_56.01 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_BASIC_56.01 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_BASIC_56.01 power: 1.2 W previous: 1 delta_time: 9 s
2015-09-12_14:50:30 ZWave_BASIC_56.01 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2016-02-05T17:05:45Z

Scooty:

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Vorabinfo ===
Alle Aktionen in diesem Artikel (Inklusion, Assoziation,...) wurden mit dem Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) auf Position "schwarz" durchgeführt.

=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Werks-Reset ===
Zum Zurücksetzen auf die Werkseinstellungen
* die Steckdosenleiste vom Stromnetz trennen
* die Ein/Aus-Taste bzw. Statuskontrollleuchte gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Ein/Aus-Taste bzw. Statuskontrollleuchte weiterhin für ca. 5 Sekunden gedrückt halten. Die Statuskontrollleuchte leuchtet dabei für ca. 4 Sekunden
* die Ein/Aus-Taste bzw. Statuskontrollleuchte loslassen, die Konfiguration der Steckdosenleiste befindet sich wieder im Auslieferungszustand

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| Relais-Zustand: das Gerät sendet eine Alarmnachricht, wenn Leckstrom erkannt wurde
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste
|-
| 4
| Überstromschutz: das Gerät sendet einen Funkalarm, wenn ein Überstrom erkannt und der Verbraucher abgeschaltet wurde
|}
Vielen Dank an [http://forum.fhem.de/index.php/topic,46865.msg387694.html#msg387694 syslog ] zur Vervollständigung der Informationen.

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, das die Energiemessangaben der '''gesamten''' Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und abhängig vom Konfigurationsparameter
configPowerReportThreshold
Minimal change in percent after which the GreenWave device reports its energy status
(Default-Wert: 10) aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
und/oder (???)
set ZWave_SWITCH_BINARY_37 configLEDSignalsNetworkError Off
kann diese Anzeige deaktiviert werden.

==== Energiemessdaten der einzelnen Steckdosen====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder '''einzelnen''' Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten jeder '''einzelnen''' Steckdose an die Zentrale (ohne obige manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Der Default-Wert des Konfigurationsparameters
configStateAfterPowerLoss
Desired state of the device after a power loss
Possible values: Off (0), On (2), StateBeforePowerLoss (1)
ist '''2''' (= alle Steckdosen sind nach einem Stromausfall eingeschaltet)!
* Die Position LOCK des Einstellrads zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) schaltet alle Steckdosen ein und verhindert jegliche Kommunikation mit dem ZWave-Controller/-Gateway.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2016-02-03T16:36:10Z

Scooty: Werks-Reset aufgenommen

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Vorabinfo ===
Alle Aktionen in diesem Artikel (Inklusion, Assoziation,...) wurden mit dem Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) auf Position "schwarz" durchgeführt.

=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Werks-Reset ===
Zum Zurücksetzen auf die Werkseinstellungen
* die Steckdosenleiste vom Stromnetz trennen
* die Ein/Aus-Taste bzw. Statuskontrollleuchte gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Ein/Aus-Taste bzw. Statuskontrollleuchte weiterhin für ca. 5 Sekunden gedrückt halten bis (???)
* die Ein/Aus-Taste bzw. Statuskontrollleuchte loslassen, die Konfiguration der Steckdosenleiste befindet sich wieder im Auslieferungszustand

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| Relais-Zustand: das Gerät sendet eine Alarmnachricht, wenn Leckstrom erkannt wurde
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste
|-
| 4
| Überstromschutz: das Gerät sendet einen Funkalarm, wenn ein Überstrom erkannt und der Verbraucher abgeschaltet wurde
|}
Vielen Dank an [http://forum.fhem.de/index.php/topic,46865.msg387694.html#msg387694 syslog ] zur Vervollständigung der Informationen.

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, das die Energiemessangaben der '''gesamten''' Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und abhängig vom Konfigurationsparameter
configPowerReportThreshold
Minimal change in percent after which the GreenWave device reports its energy status
(Default-Wert: 10) aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
und/oder (???)
set ZWave_SWITCH_BINARY_37 configLEDSignalsNetworkError Off
kann diese Anzeige deaktiviert werden.

==== Energiemessdaten der einzelnen Steckdosen====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder '''einzelnen''' Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten jeder '''einzelnen''' Steckdose an die Zentrale (ohne obige manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Der Default-Wert des Konfigurationsparameters
configStateAfterPowerLoss
Desired state of the device after a power loss
Possible values: Off (0), On (2), StateBeforePowerLoss (1)
ist '''2''' (= alle Steckdosen sind nach einem Stromausfall eingeschaltet)!
* Die Position LOCK des Einstellrads zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) schaltet alle Steckdosen ein und verhindert jegliche Kommunikation mit dem ZWave-Controller/-Gateway.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2016-02-02T13:43:08Z

Scooty: Position Einstellrad aufgenommen

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Vorabinfo ===
Alle Aktionen in diesem Artikel (Inklusion, Assoziation,...) wurden mit dem Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) auf Position "schwarz" durchgeführt.

=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| Relais-Zustand: das Gerät sendet eine Alarmnachricht, wenn Leckstrom erkannt wurde
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste
|-
| 4
| Überstromschutz: das Gerät sendet einen Funkalarm, wenn ein Überstrom erkannt und der Verbraucher abgeschaltet wurde
|}
Vielen Dank an [http://forum.fhem.de/index.php/topic,46865.msg387694.html#msg387694 syslog ] zur Vervollständigung der Informationen.

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, das die Energiemessangaben der '''gesamten''' Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und abhängig vom Konfigurationsparameter
configPowerReportThreshold
Minimal change in percent after which the GreenWave device reports its energy status
(Default-Wert: 10) aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
und/oder (???)
set ZWave_SWITCH_BINARY_37 configLEDSignalsNetworkError Off
kann diese Anzeige deaktiviert werden.

==== Energiemessdaten der einzelnen Steckdosen====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder '''einzelnen''' Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten jeder '''einzelnen''' Steckdose an die Zentrale (ohne obige manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Der Default-Wert des Konfigurationsparameters
configStateAfterPowerLoss
Desired state of the device after a power loss
Possible values: Off (0), On (2), StateBeforePowerLoss (1)
ist '''2''' (= alle Steckdosen sind nach einem Stromausfall eingeschaltet)!
* Die Position LOCK des Einstellrads zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) schaltet alle Steckdosen ein und verhindert jegliche Kommunikation mit dem ZWave-Controller/-Gateway.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-AEO DSA38-ZWEU-Panic Button

2016-01-09T16:29:59Z

Scooty: Bild eingebunden

{{Infobox Hardware
|Bild=AEO_DSA38-ZWEU.jpg
|Bildbeschreibung=Aeotec by Aeon Labs Panic Button
|HWProtocol=Z-Wave
|HWType=Controller
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=1
|HWVoltage=3V
|HWPowerConsumption=???
|HWPoweredBy=Batterie
|HWSize=5.5x3x1cm, 18g
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.http://aeotec.com Aeon Labs]
}}

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] kann als primärer Controller eines eigenständigen Z-Wave-Netzwerks oder in einem bestehendem Z-Wave-Netzwerk als Sekundär-Controller betrieben werden.

Im Folgenden wird nur auf die Funktionalität als Sekundär-Controller in einem bestehenden Z-Wave Netzwerk eingegangen.

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] verfügt nur über eine Taste.
Im Lieferumfang sind die Batterie und ein Metall-Pin zur Betätigung der Anlerntaste (LEARN) oder zum Reset des Geräts enthalten.

== Features ==
* Eine Taste
* Bestätigungs-LED

== Weitere technische Daten ==
* Batterie CR2450 3V Lithium
* Betriebstemperatur: 0° C bis + 55° C

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts beginnt zu blinken.
* Nach ein paar Sekunden des Blinkens sollte die Bestätigungs-LED etwas länger dauerhaft leuchten und damit die erfolgreiche Inklusion bestätigen.
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden.

Beispielhafte Log-Meldungen:
2015.11.22 12:17:41 2: autocreate: define ZWave_GENERIC_CONTROLLER_50 ZWave d79c8805 50 867270808485ef2b26
2015.11.22 12:17:41 2: autocreate: define FileLog_ZWave_GENERIC_CONTROLLER_50 FileLog /opt/fhem/log/ZWave_GENERIC_CONTROLLER_50-%Y-%m.log ZWave_GENERIC_CONTROLLER_50
2015.11.22 12:17:44 2: ZWave set ZWave_GENERIC_CONTROLLER_50 associationAdd 1 01
2015.11.22 12:17:45 2: ZWave get ZWave_GENERIC_CONTROLLER_50 model
2015.11.22 12:17:45 3: ZWave got config for aeotec/panicbtn.xml from /opt/fhem/FHEM/lib/openzwave_deviceconfig.xml.gz
2015.11.22 12:17:45 1: ZWAVE INIT: get ZWave_GENERIC_CONTROLLER_50 model: modelConfig:aeotec/panicbtn.xml
modelId:0086-0001-0026
model:Aeotec Panic Button

=== Exklusion ===
Zur Exklusion
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts blinkt ein paar mal und erlischt.
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden.

=== Assoziation ===
Die Assoziationsgruppe 1 das Geräts wird bei der Inklusion und aktiviertem <code>autocreate</code> automatisch mit dem primären ZWave-Controller/-Gateway assoziiert.

=== WakeUp ===
Ein WakeUp wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin die LEARN-Taste für ca. 3 Sekunden gedrückt hält. Es erfolgt eine Quittierung des WakeUps durch die Benachrichtigungs-LED auf der Vorderseite des Geräts.

=== Konfiguration ===
Je nach gewünschtem Event kann man den [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] über den Konfigurationsbefehl
set ZWave_GENERIC_CONTROLLER_50 configMode Scene
oder
set ZWave_GENERIC_CONTROLLER_50 configMode Group
konfigurieren.

=== Besonderheiten ===
==== Werks-Reset ====
Ein Werks-Reset wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin gleichzeitig die LEARN- und INCLUDE/REMOVE-Tasten für ca. 10 Sekunden gedrückt hält. Die Benachrichtigungs-LED leuchtet währenddessen immer schneller werdend abwechselnd grün und rot und quittiert den Werks-Reset mit ca. 2 Sekunden grünem Dauerleuchten.

=== Logbeispiele ===
./.

== Links ==
* Bedienungshandbuch: [http://aeotec.com/z-wave-one-button-remote/766-panic-button-manual-instructions.html Webseite], englisch
* OpenZWave Technical Document: [http://ozw.my-ho.st/Aeon/Engineering%20Spec%20-%20Aeon%20Labs%20Panic%20Button%20V1.12.pdf PDF], englisch
* ZWave-Alliance Produktseite: [http://products.z-wavealliance.org/products/1284 Webseite], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=44331|LinkText=Aeotec by Aeon Labs Panic Button}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Sender)]]

Datei:AEO DSA38-ZWEU.jpg

2016-01-09T16:27:27Z

Scooty:

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2016-01-09T06:52:46Z

Scooty: Ergänzung Assoziationsgrupen

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| Relais-Zustand: das Gerät sendet eine Alarmnachricht, wenn Leckstrom erkannt wurde
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste
|-
| 4
| Überstromschutz: das Gerät sendet einen Funkalarm, wenn ein Überstrom erkannt und der Verbraucher abgeschaltet wurde
|}
Vielen Dank an [http://forum.fhem.de/index.php/topic,46865.msg387694.html#msg387694 syslog ] zur Vervollständigung der Informationen.

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, das die Energiemessangaben der '''gesamten''' Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und abhängig vom Konfigurationsparameter
configPowerReportThreshold
Minimal change in percent after which the GreenWave device reports its energy status
(Default-Wert: 10) aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
und/oder (???)
set ZWave_SWITCH_BINARY_37 configLEDSignalsNetworkError Off
kann diese Anzeige deaktiviert werden.

==== Energiemessdaten der einzelnen Steckdosen====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder '''einzelnen''' Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten jeder '''einzelnen''' Steckdose an die Zentrale (ohne obige manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Der Default-Wert des Konfigurationsparameters
configStateAfterPowerLoss
Desired state of the device after a power loss
Possible values: Off (0), On (2), StateBeforePowerLoss (1)
ist '''2''' (= alle Steckdosen sind nach einem Stromausfall eingeschaltet)!

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2016-01-08T15:27:02Z

Scooty: Weitere Konfigurationsparameter aufgenommen

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| ???
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste (???)
|-
| 4
| ???
|}

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, das die Energiemessangaben der '''gesamten''' Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und abhängig vom Konfigurationsparameter
configPowerReportThreshold
Minimal change in percent after which the GreenWave device reports its energy status
(Default-Wert: 10) aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
und/oder (???)
set ZWave_SWITCH_BINARY_37 configLEDSignalsNetworkError Off
kann diese Anzeige deaktiviert werden.

==== Energiemessdaten der einzelnen Steckdosen====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder '''einzelnen''' Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten jeder '''einzelnen''' Steckdose an die Zentrale (ohne obige manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Der Default-Wert des Konfigurationsparameters
configStateAfterPowerLoss
Desired state of the device after a power loss
Possible values: Off (0), On (2), StateBeforePowerLoss (1)
ist '''2''' (= alle Steckdosen sind nach einem Stromausfall eingeschaltet)!

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

WS3600

2015-11-30T09:41:02Z

Scooty: s. https://groups.google.com/forum/#!searchin/pywws/winddir_text(x)/pywws/wllkKmOhA4s/gFkCrKPZBgAJ

{{Infobox Modul
|Name=WS3600
|ModPurpose=Anbindung Wetterstationen, die Daten im fetch3600-Format auf der Standardausgabe liefern
|ModType=d

|ModCmdRef=WS3600
|ModForumArea=Sonstiges
|ModTechName=70_WS3600.pm
|ModOwner=Josch
}}
Über das [http://fhem.de/commandref.html#WS3600 WS3600] Device Modul können diverse Wetterstationen an FHEM angeschlossen werden. Das Modul geht davon aus, dass eine WS3600-kompatible Wetterstation per USB angeschlossen ist und über ein Kommando ein standardisiertes Ausgabeformat auf STDOUT ausgibt.

Das Modul WS3600 unterstützt bisher die folgenden Wetterstationen:

* WS3600 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS3600 LaCrosse WS3600]
* WS2300 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS2300 LaCrosse WS2300]
* WS1080 - [http://wiki.wetterstationen.info/index.php?title=WS1080 Fine Offset WS1080/WH1080]

== Direkt angeschlossene Wetterstation ==

Das Modul erwartet, das die Wetterstation am selben System angeschlossen ist, auf dem auch FHEM läuft und über ein lokal ausgeführtes Ausleseprogramm abgefragt werden kann. Das Ausleseprogramm wird regelmäßig aufgerufen und muss die Wetterdaten in einem Datenformat ausgeben, das dem des Programms fetch3600 entspricht.

Mit den folgenden Befehlen wird die Wetterstation WS3600 als Objekt myWS3600 eingebunden und ein FileLog angelegt, in das die Wetterdaten geschrieben werden:

define myWS3600 WS3600 /usr/local/bin/fetch360
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS3600.*

Die Wetterdaten können dann geplottet oder für notifys verwendet werden.

== Über pywws angeschlossene Wetterstation ==

[https://github.com/jim-easterbrook/pywws pywws] ist eine Sammlung von Python Skripten, um die unter vielen verschiedenen Namen vertriebenen Fine Offset Wetterstationen auszulesen. Mit pywws können unter anderem die Wetterstationen Elecsa AstroTouch 6975, Watson W-8681, WH-1080PC, WH1080, WH1081, WH3080 und weitere baugleiche Modelle ausgelesen werden.

pywws bietet von Haus aus keine WS3600-kompatible Ausgabe, diese kann aber über die pywws Ausgabe-Templates sehr einfach erstellt werden. Dazu muss nur ein neues Text-Template ws3600.txt angelegt werden, das ein File im WS3600-Format erzeugt:

#locale "False"#
#timezone local#

Date #idx "%d-%h-%Y"#

Time #idx "%H:%M:%S"#

Ti #temp_in "%.1f"#

To #temp_out "%.1f"#

RHi #hum_in "%d"#

RHo #hum_out "%d"#

DIR #wind_dir "%s"#

DIRtext #wind_dir "%s" "-" "winddir_text(x)"#

WS #wind_ave "%.0f"#

WG #wind_gust "%.0f"#

Rtot #rain "%0.1f"#

RP #rel_pressure "%.0f"#

Tendency #pressure_trend "%s" "" "pressure_trend_text(x)"#

Dieses Template wird dann in der pywws Konfigurationsdatei weather.ini entweder in die Liste der auszuführenden Text-Templates in der <tt>[hourly]</tt> oder der <tt>[logged]</tt> Sektion eingefügt.

In FHEM kann die Wetterstation dann wie folgt definiert werden:

define myWS1080 WS3600 "cat /var/www/weather/data/ws3600.txt"
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS1080.*

Falls pywws auf einem anderen System läuft, kann der <tt>cat</tt>-Befehl per SSH ausgeführt werden:

define myWS1080 WS3600 "ssh pywws@weather.example.com cat /var/www/weather/data/ws3600.txt"

Damit FHEM den <tt>cat</tt>-Befehl per SSH ausführen kann, muss SSH so konfiguriert sein, dass der FHEM-User sich auf dem pywws System per Public Key ohne Passwort einloggen kann.

[[Kategorie:Wetterstationen]]
[[Kategorie:Other Components]]

WS3600

2015-11-29T11:46:24Z

Scooty:

{{Infobox Modul
|Name=WS3600
|ModPurpose=Anbindung Wetterstationen, die Daten im fetch3600-Format auf der Standardausgabe liefern
|ModType=d

|ModCmdRef=WS3600
|ModForumArea=Sonstiges
|ModTechName=70_WS3600.pm
|ModOwner=Josch
}}
Über das [http://fhem.de/commandref.html#WS3600 WS3600] Device Modul können diverse Wetterstationen an FHEM angeschlossen werden. Das Modul geht davon aus, dass eine WS3600-kompatible Wetterstation per USB angeschlossen ist und über ein Kommando ein standardisiertes Ausgabeformat auf STDOUT ausgibt.

Das Modul WS3600 unterstützt bisher die folgenden Wetterstationen:

* WS3600 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS3600 LaCrosse WS3600]
* WS2300 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS2300 LaCrosse WS2300]
* WS1080 - [http://wiki.wetterstationen.info/index.php?title=WS1080 Fine Offset WS1080/WH1080]

== Direkt angeschlossene Wetterstation ==

Das Modul erwartet, das die Wetterstation am selben System angeschlossen ist, auf dem auch FHEM läuft und über ein lokal ausgeführtes Ausleseprogramm abgefragt werden kann. Das Ausleseprogramm wird regelmäßig aufgerufen und muss die Wetterdaten in einem Datenformat ausgeben, das dem des Programms fetch3600 entspricht.

Mit den folgenden Befehlen wird die Wetterstation WS3600 als Objekt myWS3600 eingebunden und ein FileLog angelegt, in das die Wetterdaten geschrieben werden:

define myWS3600 WS3600 /usr/local/bin/fetch360
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS3600.*

Die Wetterdaten können dann geplottet oder für notifys verwendet werden.

== Über pywws angeschlossene Wetterstation ==

[https://github.com/jim-easterbrook/pywws pywws] ist eine Sammlung von Python Skripten, um die unter vielen verschiedenen Namen vertriebenen Fine Offset Wetterstationen auszulesen. Mit pywws können unter anderem die Wetterstationen Elecsa AstroTouch 6975, Watson W-8681, WH-1080PC, WH1080, WH1081, WH3080 und weitere baugleiche Modelle ausgelesen werden.

pywws bietet von Haus aus keine WS3600-kompatible Ausgabe, diese kann aber über die pywws Ausgabe-Templates sehr einfach erstellt werden. Dazu muss nur ein neues Text-Template ws3600.txt angelegt werden, das ein File im WS3600-Format erzeugt:

#locale "False"#
#timezone local#

Date #idx "%d-%h-%Y"#

Time #idx "%H:%M:%S"#

Ti #temp_in "%.1f"#

To #temp_out "%.1f"#

RHi #hum_in "%d"#

RHo #hum_out "%d"#

DIR #wind_dir "%s"#

DIRtext #wind_dir "%s" "-" "wind_dir_text[x]"#

WS #wind_ave "%.0f"#

WG #wind_gust "%.0f"#

Rtot #rain "%0.1f"#

RP #rel_pressure "%.0f"#

Tendency #pressure_trend "%s" "" "pressure_trend_text(x)"#

Dieses Template wird dann in der pywws Konfigurationsdatei weather.ini entweder in die Liste der auszuführenden Text-Templates in der <tt>[hourly]</tt> oder der <tt>[logged]</tt> Sektion eingefügt.

In FHEM kann die Wetterstation dann wie folgt definiert werden:

define myWS1080 WS3600 "cat /var/www/weather/data/ws3600.txt"
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS1080.*

Falls pywws auf einem anderen System läuft, kann der <tt>cat</tt>-Befehl per SSH ausgeführt werden:

define myWS1080 WS3600 "ssh pywws@weather.example.com cat /var/www/weather/data/ws3600.txt"

Damit FHEM den <tt>cat</tt>-Befehl per SSH ausführen kann, muss SSH so konfiguriert sein, dass der FHEM-User sich auf dem pywws System per Public Key ohne Passwort einloggen kann.

[[Kategorie:Wetterstationen]]
[[Kategorie:Other Components]]

WS3600

2015-11-29T11:45:30Z

Scooty: Einträge für locale korrigiert und timezone ergänzt

{{Infobox Modul
|Name=WS3600
|ModPurpose=Anbindung Wetterstationen, die Daten im fetch3600-Format auf der Standardausgabe liefern
|ModType=d

|ModCmdRef=WS3600
|ModForumArea=Sonstiges
|ModTechName=70_WS3600.pm
|ModOwner=Josch
}}
Über das [http://fhem.de/commandref.html#WS3600 WS3600] Device Modul können diverse Wetterstationen an FHEM angeschlossen werden. Das Modul geht davon aus, dass eine WS3600-kompatible Wetterstation per USB angeschlossen ist und über ein Kommando ein standardisiertes Ausgabeformat auf STDOUT ausgibt.

Das Modul WS3600 unterstützt bisher die folgenden Wetterstationen:

* WS3600 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS3600 LaCrosse WS3600]
* WS2300 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS2300 LaCrosse WS2300]
* WS1080 - [http://wiki.wetterstationen.info/index.php?title=WS1080 Fine Offset WS1080/WH1080]

== Direkt angeschlossene Wetterstation ==

Das Modul erwartet, das die Wetterstation am selben System angeschlossen ist, auf dem auch FHEM läuft und über ein lokal ausgeführtes Ausleseprogramm abgefragt werden kann. Das Ausleseprogramm wird regelmäßig aufgerufen und muss die Wetterdaten in einem Datenformat ausgeben, das dem des Programms fetch3600 entspricht.

Mit den folgenden Befehlen wird die Wetterstation WS3600 als Objekt myWS3600 eingebunden und ein FileLog angelegt, in das die Wetterdaten geschrieben werden:

define myWS3600 WS3600 /usr/local/bin/fetch360
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS3600.*

Die Wetterdaten können dann geplottet oder für notifys verwendet werden.

== Über pywws angeschlossene Wetterstation ==

[https://github.com/jim-easterbrook/pywws pywws] ist eine Sammlung von Python Skripten, um die unter vielen verschiedenen Namen vertriebenen Fine Offset Wetterstationen auszulesen. Mit pywws können unter anderem die Wetterstationen Elecsa AstroTouch 6975, Watson W-8681, WH-1080PC, WH1080, WH1081, WH3080 und weitere baugleiche Modelle ausgelesen werden.

pywws bietet von Haus aus keine WS3600-kompatible Ausgabe, diese kann aber über die pywws Ausgabe-Templates sehr einfach erstellt werden. Dazu muss nur ein neues Text-Template ws3600.txt angelegt werden, das ein File im WS3600-Format erzeugt:

#locale "False"#
#timezone local#

Date #idx "%d-%h-%Y"#

Time #idx "%H:%M:%S"#

Ti #temp_in "%.1f"#

To #temp_out "%.1f"#

RHi #hum_in "%d"#

RHo #hum_out "%d"#

DIR #wind_dir "%s"#

DIRtext #wind_dir "%s" "-" "wind_dir_text[x]"#

WS #wind_ave "%.0f"#

WG #wind_gust "%.0f"#

Rtot #rain "%0.1f"#

RP #rel_pressure "%.0f"#

Tendency #pressure_trend "%s" "" "pressure_trend_text(x)"#

Dieses Template wird dann in der pywws Konfigurationsdatei weather.ini entweder in die Liste der auszuführenden Text-Templates in der <tt>[hourly]</tt> oder der <tt>[logged]</tt> Sektion eingefügt.

In FHEM kann die Wetterstation dann wie folgt definiert werden:

define myWS1080 WS3600 "cat /var/www/weather/data/ws3600.txt"
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS1080.*

Falls pywws auf einem anderen System läuft, kann der <tt>cat</tt>-Befehl per SSH ausgeführt werden:

define myWS1080 WS3600 "ssh pywws@weather.example.com cat /var/www/weather/data/ws3600.txt"

Damit FHEM den <tt>cat</tt>-Befehl per SSH ausführen kann, muss SSH so konfiguriert sein, dass der FHEM-User sich auf dem pywws System per Public Key ohne Passwort einloggen kann.

[[Kategorie:Wetterstationen]]
[[Kategorie:Other Components]]

WS3600

2015-11-29T11:27:14Z

Scooty: DIRtext in ws3600.txt Beispiel korrigiert.

{{Infobox Modul
|Name=WS3600
|ModPurpose=Anbindung Wetterstationen, die Daten im fetch3600-Format auf der Standardausgabe liefern
|ModType=d

|ModCmdRef=WS3600
|ModForumArea=Sonstiges
|ModTechName=70_WS3600.pm
|ModOwner=Josch
}}
Über das [http://fhem.de/commandref.html#WS3600 WS3600] Device Modul können diverse Wetterstationen an FHEM angeschlossen werden. Das Modul geht davon aus, dass eine WS3600-kompatible Wetterstation per USB angeschlossen ist und über ein Kommando ein standardisiertes Ausgabeformat auf STDOUT ausgibt.

Das Modul WS3600 unterstützt bisher die folgenden Wetterstationen:

* WS3600 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS3600 LaCrosse WS3600]
* WS2300 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS2300 LaCrosse WS2300]
* WS1080 - [http://wiki.wetterstationen.info/index.php?title=WS1080 Fine Offset WS1080/WH1080]

== Direkt angeschlossene Wetterstation ==

Das Modul erwartet, das die Wetterstation am selben System angeschlossen ist, auf dem auch FHEM läuft und über ein lokal ausgeführtes Ausleseprogramm abgefragt werden kann. Das Ausleseprogramm wird regelmäßig aufgerufen und muss die Wetterdaten in einem Datenformat ausgeben, das dem des Programms fetch3600 entspricht.

Mit den folgenden Befehlen wird die Wetterstation WS3600 als Objekt myWS3600 eingebunden und ein FileLog angelegt, in das die Wetterdaten geschrieben werden:

define myWS3600 WS3600 /usr/local/bin/fetch360
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS3600.*

Die Wetterdaten können dann geplottet oder für notifys verwendet werden.

== Über pywws angeschlossene Wetterstation ==

[https://github.com/jim-easterbrook/pywws pywws] ist eine Sammlung von Python Skripten, um die unter vielen verschiedenen Namen vertriebenen Fine Offset Wetterstationen auszulesen. Mit pywws können unter anderem die Wetterstationen Elecsa AstroTouch 6975, Watson W-8681, WH-1080PC, WH1080, WH1081, WH3080 und weitere baugleiche Modelle ausgelesen werden.

pywws bietet von Haus aus keine WS3600-kompatible Ausgabe, diese kann aber über die pywws Ausgabe-Templates sehr einfach erstellt werden. Dazu muss nur ein neues Text-Template ws3600.txt angelegt werden, das ein File im WS3600-Format erzeugt:

#locale False#
Date #idx "%d-%h-%Y"#

Time #idx "%H:%M:%S"#

Ti #temp_in "%.1f"#

To #temp_out "%.1f"#

RHi #hum_in "%d"#

RHo #hum_out "%d"#

DIR #wind_dir "%s"#

DIRtext #wind_dir "%s" "-" "wind_dir_text[x]"#

WS #wind_ave "%.0f"#

WG #wind_gust "%.0f"#

Rtot #rain "%0.1f"#

RP #rel_pressure "%.0f"#

Tendency #pressure_trend "%s" "" "pressure_trend_text(x)"#

Dieses Template wird dann in der pywws Konfigurationsdatei weather.ini entweder in die Liste der auszuführenden Text-Templates in der <tt>[hourly]</tt> oder der <tt>[logged]</tt> Sektion eingefügt.

In FHEM kann die Wetterstation dann wie folgt definiert werden:

define myWS1080 WS3600 "cat /var/www/weather/data/ws3600.txt"
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS1080.*

Falls pywws auf einem anderen System läuft, kann der <tt>cat</tt>-Befehl per SSH ausgeführt werden:

define myWS1080 WS3600 "ssh pywws@weather.example.com cat /var/www/weather/data/ws3600.txt"

Damit FHEM den <tt>cat</tt>-Befehl per SSH ausführen kann, muss SSH so konfiguriert sein, dass der FHEM-User sich auf dem pywws System per Public Key ohne Passwort einloggen kann.

[[Kategorie:Wetterstationen]]
[[Kategorie:Other Components]]

WS3600

2015-11-27T07:34:57Z

Scooty: github Link zu pywws korrigiert

{{Infobox Modul
|Name=WS3600
|ModPurpose=Anbindung Wetterstationen, die Daten im fetch3600-Format auf der Standardausgabe liefern
|ModType=d

|ModCmdRef=WS3600
|ModForumArea=Sonstiges
|ModTechName=70_WS3600.pm
|ModOwner=Josch
}}
Über das [http://fhem.de/commandref.html#WS3600 WS3600] Device Modul können diverse Wetterstationen an FHEM angeschlossen werden. Das Modul geht davon aus, dass eine WS3600-kompatible Wetterstation per USB angeschlossen ist und über ein Kommando ein standardisiertes Ausgabeformat auf STDOUT ausgibt.

Das Modul WS3600 unterstützt bisher die folgenden Wetterstationen:

* WS3600 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS3600 LaCrosse WS3600]
* WS2300 - [http://wiki.wetterstationen.info/index.php?title=LaCrosse_WS2300 LaCrosse WS2300]
* WS1080 - [http://wiki.wetterstationen.info/index.php?title=WS1080 Fine Offset WS1080/WH1080]

== Direkt angeschlossene Wetterstation ==

Das Modul erwartet, das die Wetterstation am selben System angeschlossen ist, auf dem auch FHEM läuft und über ein lokal ausgeführtes Ausleseprogramm abgefragt werden kann. Das Ausleseprogramm wird regelmäßig aufgerufen und muss die Wetterdaten in einem Datenformat ausgeben, das dem des Programms fetch3600 entspricht.

Mit den folgenden Befehlen wird die Wetterstation WS3600 als Objekt myWS3600 eingebunden und ein FileLog angelegt, in das die Wetterdaten geschrieben werden:

define myWS3600 WS3600 /usr/local/bin/fetch360
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS3600.*

Die Wetterdaten können dann geplottet oder für notifys verwendet werden.

== Über pywws angeschlossene Wetterstation ==

[https://github.com/jim-easterbrook/pywws pywws] ist eine Sammlung von Python Skripten, um die unter vielen verschiedenen Namen vertriebenen Fine Offset Wetterstationen auszulesen. Mit pywws können unter anderem die Wetterstationen Elecsa AstroTouch 6975, Watson W-8681, WH-1080PC, WH1080, WH1081, WH3080 und weitere baugleiche Modelle ausgelesen werden.

pywws bietet von Haus aus keine WS3600-kompatible Ausgabe, diese kann aber über die pywws Ausgabe-Templates sehr einfach erstellt werden. Dazu muss nur ein neues Text-Template ws3600.txt angelegt werden, das ein File im WS3600-Format erzeugt:

#locale False#
Date #idx "%d-%h-%Y"#

Time #idx "%H:%M:%S"#

Ti #temp_in "%.1f"#

To #temp_out "%.1f"#

RHi #hum_in "%d"#

RHo #hum_out "%d"#

DIR #wind_dir "%s"#

DIRtext #wind_dir "%s" "" "wind_dir_text[x]"#

WS #wind_ave "%.0f"#

WG #wind_gust "%.0f"#

Rtot #rain "%0.1f"#

RP #rel_pressure "%.0f"#

Tendency #pressure_trend "%s" "" "pressure_trend_text(x)"#

Dieses Template wird dann in der pywws Konfigurationsdatei weather.ini entweder in die Liste der auszuführenden Text-Templates in der <tt>[hourly]</tt> oder der <tt>[logged]</tt> Sektion eingefügt.

In FHEM kann die Wetterstation dann wie folgt definiert werden:

define myWS1080 WS3600 "cat /var/www/weather/data/ws3600.txt"
define FileLog_WS3600 FileLog ./log/WS3600-%Y.log myWS1080.*

Falls pywws auf einem anderen System läuft, kann der <tt>cat</tt>-Befehl per SSH ausgeführt werden:

define myWS1080 WS3600 "ssh pywws@weather.example.com cat /var/www/weather/data/ws3600.txt"

Damit FHEM den <tt>cat</tt>-Befehl per SSH ausführen kann, muss SSH so konfiguriert sein, dass der FHEM-User sich auf dem pywws System per Public Key ohne Passwort einloggen kann.

[[Kategorie:Wetterstationen]]
[[Kategorie:Other Components]]

Z-Wave-AEO DSA38-ZWEU-Panic Button

2015-11-26T12:53:31Z

Scooty:

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=Aeotec by Aeon Labs Panic Button
|HWProtocol=Z-Wave
|HWType=Controller
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=1
|HWVoltage=3V
|HWPowerConsumption=???
|HWPoweredBy=Batterie
|HWSize=5.5x3x1cm, 18g
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.http://aeotec.com Aeon Labs]
}}

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] kann als primärer Controller eines eigenständigen Z-Wave-Netzwerks oder in einem bestehendem Z-Wave-Netzwerk als Sekundär-Controller betrieben werden.

Im Folgenden wird nur auf die Funktionalität als Sekundär-Controller in einem bestehenden Z-Wave Netzwerk eingegangen.

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] verfügt nur über eine Taste.
Im Lieferumfang sind die Batterie und ein Metall-Pin zur Betätigung der Anlerntaste (LEARN) oder zum Reset des Geräts enthalten.

== Features ==
* Eine Taste
* Bestätigungs-LED

== Weitere technische Daten ==
* Batterie CR2450 3V Lithium
* Betriebstemperatur: 0° C bis + 55° C

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts beginnt zu blinken.
* Nach ein paar Sekunden des Blinkens sollte die Bestätigungs-LED etwas länger dauerhaft leuchten und damit die erfolgreiche Inklusion bestätigen.
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden.

Beispielhafte Log-Meldungen:
2015.11.22 12:17:41 2: autocreate: define ZWave_GENERIC_CONTROLLER_50 ZWave d79c8805 50 867270808485ef2b26
2015.11.22 12:17:41 2: autocreate: define FileLog_ZWave_GENERIC_CONTROLLER_50 FileLog /opt/fhem/log/ZWave_GENERIC_CONTROLLER_50-%Y-%m.log ZWave_GENERIC_CONTROLLER_50
2015.11.22 12:17:44 2: ZWave set ZWave_GENERIC_CONTROLLER_50 associationAdd 1 01
2015.11.22 12:17:45 2: ZWave get ZWave_GENERIC_CONTROLLER_50 model
2015.11.22 12:17:45 3: ZWave got config for aeotec/panicbtn.xml from /opt/fhem/FHEM/lib/openzwave_deviceconfig.xml.gz
2015.11.22 12:17:45 1: ZWAVE INIT: get ZWave_GENERIC_CONTROLLER_50 model: modelConfig:aeotec/panicbtn.xml
modelId:0086-0001-0026
model:Aeotec Panic Button

=== Exklusion ===
Zur Exklusion
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts blinkt ein paar mal und erlischt.
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden.

=== Assoziation ===
Die Assoziationsgruppe 1 das Geräts wird bei der Inklusion und aktiviertem <code>autocreate</code> automatisch mit dem primären ZWave-Controller/-Gateway assoziiert.

=== WakeUp ===
Ein WakeUp wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin die LEARN-Taste für ca. 3 Sekunden gedrückt hält. Es erfolgt eine Quittierung des WakeUps durch die Benachrichtigungs-LED auf der Vorderseite des Geräts.

=== Konfiguration ===
Je nach gewünschtem Event kann man den [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] über den Konfigurationsbefehl
set ZWave_GENERIC_CONTROLLER_50 configMode Scene
oder
set ZWave_GENERIC_CONTROLLER_50 configMode Group
konfigurieren.

=== Besonderheiten ===
==== Werks-Reset ====
Ein Werks-Reset wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin gleichzeitig die LEARN- und INCLUDE/REMOVE-Tasten für ca. 10 Sekunden gedrückt hält. Die Benachrichtigungs-LED leuchtet währenddessen immer schneller werdend abwechselnd grün und rot und quittiert den Werks-Reset mit ca. 2 Sekunden grünem Dauerleuchten.

=== Logbeispiele ===
./.

== Links ==
* Bedienungshandbuch: [http://aeotec.com/z-wave-one-button-remote/766-panic-button-manual-instructions.html Webseite], englisch
* OpenZWave Technical Document: [http://ozw.my-ho.st/Aeon/Engineering%20Spec%20-%20Aeon%20Labs%20Panic%20Button%20V1.12.pdf PDF], englisch
* ZWave-Alliance Produktseite: [http://products.z-wavealliance.org/products/1284 Webseite], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=44331|LinkText=Aeotec by Aeon Labs Panic Button}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Sender)]]

Z-Wave-AEO DSA38-ZWEU-Panic Button

2015-11-23T09:43:40Z

Scooty: Werks-Reset Infos hinzugefügt

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=Aeotec by Aeon Labs Panic Button
|HWProtocol=Z-Wave
|HWType=Controller
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=1
|HWVoltage=3V
|HWPowerConsumption=???
|HWPoweredBy=Batterie
|HWSize=5.5x3x1cm, 18g
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.http://aeotec.com Aeon Labs]
}}

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] kann als primärer Controller eines eigenständigen Z-Wave-Netzwerks oder in einem bestehendem Z-Wave-Netzwerk als Sekundär-Controller betrieben werden.

Im Folgenden wird nur auf die Funktionalität als Sekundär-Controller in einem bestehenden Z-Wave Netzwerk eingegangen.

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] verfügt nur über eine Taste.
Im Lieferumfang sind die Batterie und ein Metall-Pin zur Betätigung der Anlerntaste (LEARN) oder zum Reset des Geräts enthalten.

== Features ==
* Eine Taste
* Bestätigungs-LED

== Weitere technische Daten ==
* Batterie CR2450 3V Lithium
* Betriebstemperatur: 0° C bis + 55° C

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts beginnt zu blinken.
* Nach ein paar Sekunden des Blinkens sollte die Bestätigungs-LED etwas länger dauerhaft leuchten und damit die erfolgreiche Inklusion bestätigen.
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden.

Beispielhafte Log-Meldungen:
2015.11.22 12:17:41 2: autocreate: define ZWave_GENERIC_CONTROLLER_50 ZWave d79c8805 50 867270808485ef2b26
2015.11.22 12:17:41 2: autocreate: define FileLog_ZWave_GENERIC_CONTROLLER_50 FileLog /opt/fhem/log/ZWave_GENERIC_CONTROLLER_50-%Y-%m.log ZWave_GENERIC_CONTROLLER_50
2015.11.22 12:17:44 2: ZWave set ZWave_GENERIC_CONTROLLER_50 associationAdd 1 01
2015.11.22 12:17:45 2: ZWave get ZWave_GENERIC_CONTROLLER_50 model
2015.11.22 12:17:45 3: ZWave got config for aeotec/panicbtn.xml from /opt/fhem/FHEM/lib/openzwave_deviceconfig.xml.gz
2015.11.22 12:17:45 1: ZWAVE INIT: get ZWave_GENERIC_CONTROLLER_50 model: modelConfig:aeotec/panicbtn.xml
modelId:0086-0001-0026
model:Aeotec Panic Button

=== Exklusion ===
Zur Exklusion
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts blinkt ein paar mal und erlischt.
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden.

=== Assoziation ===
Die Assoziationsgruppe 1 das Geräts wird bei der Inklusion und aktiviertem <code>autocreate</code> automatisch mit dem primären ZWave-Controller/-Gateway assoziiert.

=== WakeUp ===
Ein WakeUp wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin die LEARN-Taste für ca. 3 Sekunden gedrückt hält. Es erfolgt eine Quittierung des WakeUps durch die Benachrichtigungs-LED auf der Vorderseite des Geräts.

=== Konfiguration ===
Je nach gewünschtem Event kann man den [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] über den Konfigurationsbefehl
set ZWave_GENERIC_CONTROLLER_50 configMode Scene
oder
set ZWave_GENERIC_CONTROLLER_50 configMode Group
konfigurieren.

=== Besonderheiten ===
==== Werks-Reset ====
Ein Werks-Reset wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin gleichzeitig die LEARN- und INCLUDE/REMOVE-Tasten für ca. 10 Sekunden gedrückt hält. Die Benachrichtigungs-LED leuchtet währenddessen immer schneller werdend abwechselnd grün und und rot und quittiert den Werks-Reset mit ca. 2 Sekunden grünem Dauerleuchten.

=== Logbeispiele ===
./.

== Links ==
* Bedienungshandbuch: [http://aeotec.com/z-wave-one-button-remote/766-panic-button-manual-instructions.html Webseite], englisch
* OpenZWave Technical Document: [http://ozw.my-ho.st/Aeon/Engineering%20Spec%20-%20Aeon%20Labs%20Panic%20Button%20V1.12.pdf PDF], englisch
* ZWave-Alliance Produktseite: [http://products.z-wavealliance.org/products/1284 Webseite], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=44331|LinkText=Aeotec by Aeon Labs Panic Button}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Sender)]]

Z-Wave-AEO DSA38-ZWEU-Panic Button

2015-11-22T14:50:04Z

Scooty:

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=Aeotec by Aeon Labs Panic Button
|HWProtocol=Z-Wave
|HWType=Controller
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=1
|HWVoltage=3V
|HWPowerConsumption=???
|HWPoweredBy=Batterie
|HWSize=5.5x3x1cm, 18g
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.http://aeotec.com Aeon Labs]
}}

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] kann als primärer Controller eines eigenständigen Z-Wave-Netzwerks oder in einem bestehendem Z-Wave-Netzwerk als Sekundär-Controller betrieben werden.

Im Folgenden wird nur auf die Funktionalität als Sekundär-Controller in einem bestehenden Z-Wave Netzwerk eingegangen.

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] verfügt nur über eine Taste.
Im Lieferumfang sind die Batterie und ein Metall-Pin zur Betätigung der Anlerntaste (LEARN) oder zum Reset des Geräts enthalten.

== Features ==
* Eine Taste
* Bestätigungs-LED

== Weitere technische Daten ==
* Batterie CR2450 3V Lithium
* Betriebstemperatur: 0° C bis + 55° C

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts beginnt zu blinken.
* Nach ein paar Sekunden des Blinkens sollte die Bestätigungs-LED etwas länger dauerhaft leuchten und damit die erfolgreiche Inklusion bestätigen.
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden.

Beispielhafte Log-Meldungen:
2015.11.22 12:17:41 2: autocreate: define ZWave_GENERIC_CONTROLLER_50 ZWave d79c8805 50 867270808485ef2b26
2015.11.22 12:17:41 2: autocreate: define FileLog_ZWave_GENERIC_CONTROLLER_50 FileLog /opt/fhem/log/ZWave_GENERIC_CONTROLLER_50-%Y-%m.log ZWave_GENERIC_CONTROLLER_50
2015.11.22 12:17:44 2: ZWave set ZWave_GENERIC_CONTROLLER_50 associationAdd 1 01
2015.11.22 12:17:45 2: ZWave get ZWave_GENERIC_CONTROLLER_50 model
2015.11.22 12:17:45 3: ZWave got config for aeotec/panicbtn.xml from /opt/fhem/FHEM/lib/openzwave_deviceconfig.xml.gz
2015.11.22 12:17:45 1: ZWAVE INIT: get ZWave_GENERIC_CONTROLLER_50 model: modelConfig:aeotec/panicbtn.xml
modelId:0086-0001-0026
model:Aeotec Panic Button

=== Exklusion ===
Zur Exklusion
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts blinkt ein paar mal und erlischt.
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden.

=== Assoziation ===
Die Assoziationsgruppe 1 das Geräts wird bei der Inklusion und aktiviertem <code>autocreate</code> automatisch mit dem primären ZWave-Controller/-Gateway assoziiert.

=== WakeUp ===
Ein WakeUp wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin die LEARN-Taste für ca. 3 Sekunden gedrückt hält. Es erfolgt eine Quittierung des WakeUps durch die Benachrichtigungs-LED auf der Vorderseite des Geräts.

=== Konfiguration ===
Je nach gewünschtem Event kann man den [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] über den Konfigurationsbefehl
set ZWave_GENERIC_CONTROLLER_50 configMode Scene
oder
set ZWave_GENERIC_CONTROLLER_50 configMode Group
konfigurieren.

=== Besonderheiten ===
./.

=== Logbeispiele ===
./.

== Links ==
* Bedienungshandbuch: [http://aeotec.com/z-wave-one-button-remote/766-panic-button-manual-instructions.html Webseite], englisch
* OpenZWave Technical Document: [http://ozw.my-ho.st/Aeon/Engineering%20Spec%20-%20Aeon%20Labs%20Panic%20Button%20V1.12.pdf PDF], englisch
* ZWave-Alliance Produktseite: [http://products.z-wavealliance.org/products/1284 Webseite], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=44331|LinkText=Aeotec by Aeon Labs Panic Button}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Sender)]]

Z-Wave-AEO DSA38-ZWEU-Panic Button

2015-11-22T14:46:41Z

Scooty: Die Seite wurde neu angelegt: „{{Infobox Hardware |Bild=platzHalter.png |Bildbeschreibung=Aeotec by Aeon Labs Panic Button |HWProtocol=Z-Wave |HWType=Controller |HWCategory=Z-Wave |HWComm=F…“

{{Infobox Hardware
|Bild=platzHalter.png
|Bildbeschreibung=Aeotec by Aeon Labs Panic Button
|HWProtocol=Z-Wave
|HWType=Controller
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=1
|HWVoltage=3V
|HWPowerConsumption=???
|HWPoweredBy=Batterie
|HWSize=5.5x3x1cm, 18g
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.http://aeotec.com Aeon Labs]
}}

Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] kann als primärer Controller eines eigenständigen Z-Wave-Netzwerks oder in einem bestehendem Z-Wave-Netzwerk als Sekundär-Conntroller betrieben werden.
Im Folgenden wird nur auf die Funktionalität als Sekundär-Controller in einem bestehenden Z-Wave Netzwerk eingegangen.
Der [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] verfügt nur über eine Taste.
Im Lieferumfang sind die Batterie und ein Metall-Pin zur Betätigung der Anlerntaste (LEARN) oder zum Reset des Geräts enthalten.

== Features ==
* Eine Taste
* Bestätigungs-LED

== Weitere technische Daten ==
* Batterie CR2450 3V Lithium
* Betriebstemperatur: 0° C bis + 55° C

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts begint zu blinken.
* Nach ein paar Sekunden des Blinkens sollte die Bestätigungs-LED etwas länger dauerhaft leuchten und damit die erfolgreiche Inklusion bestätigen.
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden.

Beispielhafte Log-Meldungen:
2015.11.22 12:17:41 2: autocreate: define ZWave_GENERIC_CONTROLLER_50 ZWave d79c8805 50 867270808485ef2b26
2015.11.22 12:17:41 2: autocreate: define FileLog_ZWave_GENERIC_CONTROLLER_50 FileLog /opt/fhem/log/ZWave_GENERIC_CONTROLLER_50-%Y-%m.log ZWave_GENERIC_CONTROLLER_50
2015.11.22 12:17:44 2: ZWave set ZWave_GENERIC_CONTROLLER_50 associationAdd 1 01
2015.11.22 12:17:45 2: ZWave get ZWave_GENERIC_CONTROLLER_50 model
2015.11.22 12:17:45 3: ZWave got config for aeotec/panicbtn.xml from /opt/fhem/FHEM/lib/openzwave_deviceconfig.xml.gz
2015.11.22 12:17:45 1: ZWAVE INIT: get ZWave_GENERIC_CONTROLLER_50 model: modelConfig:aeotec/panicbtn.xml
modelId:0086-0001-0026
model:Aeotec Panic Button

=== Exklusion ===
Zur Exklusion
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion]).
* Den mitgelieferten Metall-Pin in die mit LEARN gekennzeichnete Öffnung auf der Rückseite des Geräts führen und kurz drücken.
* Die Bestätigungs-LED auf der Vorderseite des Geräts blinkt ein paar mal und erlischt.
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden.

=== Assoziation ===
Die Assoziationsgruppe 1 das Geräts wird bei der Inklusion und aktiviertem <code>autocreate</code> automatisch mit dem primären ZWave-Controller/-Gateway assoziiert.

=== WakeUp ===
Ein WakeUp wird an dem Gerät ausgelöst, in dem man mit dem Metall-Pin die LEARN-Taste für ca. 3 Sekunden gedrückt hält. Es erfolgt eine Quittierung des WakeUps durch die Benachrichtigungs-LED auf der Vorderseite des Geräts.

=== Konfiguration ===
Je nach gewünschtem Event kann man den [[Z-Wave-AEO_DSA38-ZWEU-Panic Button]] über den Konfigurationsbefehl
set ZWave_GENERIC_CONTROLLER_50 configMode Scene
oder
set ZWave_GENERIC_CONTROLLER_50 configMode Group
konfigurieren.

=== Besonderheiten ===
./.

=== Logbeispiele ===
./.

== Links ==
* Bedienungshandbuch: [http://aeotec.com/z-wave-one-button-remote/766-panic-button-manual-instructions.html Webseite], englisch
* OpenZWave Technical Document: [http://ozw.my-ho.st/Aeon/Engineering%20Spec%20-%20Aeon%20Labs%20Panic%20Button%20V1.12.pdf PDF], englisch
* ZWave-Alliance Produktseite: [http://products.z-wavealliance.org/products/1284 Webseite], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=44331|LinkText=Aeotec by Aeon Labs Panic Button}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Sender)]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2015-09-23T09:31:14Z

Scooty:

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| ???
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste (???)
|-
| 4
| ???
|}

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, dass die Energiemessangaben der gesamten Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und mindestens beim Ein-/Ausschalten der gesamten Steckdosenleiste oder einzelner Steckdosen aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
kann diese Anzeige deaktiviert werden (?oder gilt es doch nur für 255 Minuten?).

==== Energiemessdaten ====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder einzelnen Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten an die Zentrale (ohne manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Nach einem Stromausfall sind alle Steckdosen automatisch eingeschaltet! Dieses Verhalten ist nach bisherigen Recherchen leider nicht konfigurierbar.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2015-09-13T14:31:14Z

Scooty:

{{Todo| Fehlende Infos sind mit ??? gekennzechnet. Nehme gerne Ergänzungen entgegen.}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| ???
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosenleiste (???)
|-
| 4
| ???
|}

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, dass die Energiemessangaben der gesamten Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und beim Ein-/Ausschalten der gesamten Steckdosenleiste oder einzelner Steckdosen aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
kann diese Anzeige deaktiviert werden (?oder gilt es doch nur für 255 Minuten?).

==== Energiemessdaten ====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder einzelnen Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten an die Zentrale (ohne manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Nach einem Stromausfall sind alle Steckdosen automatisch eingeschaltet! Dieses Verhalten ist nach bisherigen Recherchen leider nicht konfigurierbar.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2015-09-12T14:09:53Z

Scooty: Link zu Thema in Forum aufgenommen

{{Todo| Erste Version des Artikel, wegen fehlender Infos noch unvollständig}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller(?)
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| ???
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosen (???)
|-
| 4
| ???
|}

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, dass die Energiemessangaben der gesamten Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und beim Ein-/Ausschalten der gesamten Steckdosenleiste oder einzelner Steckdosen aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
kann diese Anzeige deaktiviert werden (?oder gilt es doch nur für 255 Minuten?).

==== Energiemessdaten ====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder einzelnen Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten an die Zentrale (ohne manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Nach einem Stromausfall sind alle Steckdosen automatisch eingeschaltet! Dieses Verhalten ist nach bisherigen Recherchen leider nicht konfigurierbar.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch
* Link zum Thema im Forum: {{Link2Forum|Topic=40854|LinkText=Greenwave 6-fach Steckdose}}

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

2015-09-12T14:04:33Z

Scooty: Die Seite wurde neu angelegt: „{{Todo| Erste Version des Artikel, wegen fehlender Infos noch unvollständig}} {{Infobox Hardware |Bild=Greenwave_NP-210F.jpg|200px |Bildbeschreibung=Z-Wave-Gr…“

{{Todo| Erste Version des Artikel, wegen fehlender Infos noch unvollständig}}
{{Infobox Hardware
|Bild=Greenwave_NP-210F.jpg|200px
|Bildbeschreibung=Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste
|HWProtocol=Z-Wave
|HWType=Aktor
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=6
|HWVoltage=250V ~ AC, 50 Hz
|HWPowerConsumption=0,4 W
|HWPoweredBy=Netz
|HWSize=43x6,5x5cm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.greenwavesystems.com GreenWave Reality Inc.]
}}

[[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] verfügt über 6 Steckdosen, die einzeln aber auch gesamt schaltbar sind. Desweiteren können Energiemessfunktionen genutzt werden.

== Features ==
* Funktion einzeln an/aus und gesamt an/aus (konfigurierbar)
* Überwachung des Verbrauchs der angeschlossenen Geräte (einzeln/gesamt)
* Einstellrad zur Unterscheidung verschiedener PowerNode (Nummer/Farbe) oder zum Schaltschutz durch Controller(?)
* Ein/Aus-Taste
* Schutz gegen Überstrom
* Statuskontrollleuchte

== Weitere technische Daten ==
* Maximaler Laststrom: 10 A
* Maximale Last Leistung: 2400W (@ 240V)
* Messgenauigkeit: ± 0,1 W
* 10A Sicherung (Überstromschutz)
* Betriebstemperatur: 0° C bis + 25° C
* Maximale Luftfeuchtigkeit: 5% bis 90%
* IP-Klasse: IP20 (nur für Innenräume)

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktiviertem <code>autocreate</code> vollautomatisch erkannt und definiert.

Zur Inklusion
* die Steckdosenleiste mit dem Stromnetz verbinden
* ZWave-Controller/-Gateway in den Inklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Hinzuf.C3.BCgen_eines_neuen_Z-Wave_Ger.C3.A4ts_.2F_Inklusion Hinzufügen eines neuen Z-Wave Geräts / Inklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) für ca. 1 Sekunde drücken bis die Statuskontrollleuchte "rundläuft"
* Nach ein paar Sekunden sollte die Statuskontrollleuchte den "Rundlauf" stoppen, kurz (mehrfach) blinken und damit die erfolgreiche Inklusion bestätigen
* Den Inklusions-Modus des ZWave-Controllers/-Gateways beenden

Beispielhafte Log-Meldungen:
2015.09.10 20:52:58 2: autocreate: define ZWave_SWITCH_BINARY_37 ZWave d79c8805 37 25326072862071702785877556
2015.09.10 20:53:00 2: ZWave set ZWave_SWITCH_BINARY_37 associationAdd 1 01
2015.09.10 20:53:00 2: ZWave get ZWave_SWITCH_BINARY_37 model
2015.09.10 20:53:01 3: ZWave reading config for greenwave/powernode6.xml
2015.09.10 20:53:02 1: ZWAVE INIT: get ZWave_SWITCH_BINARY_37 model: modelConfig:greenwave/powernode6.xml
modelId:0099-0003-0004
model:GreenWave PowerNode 6 port

Über dieses Device kann die Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) geschaltet werden und auch alle Konfigurationsparameter der gesamten Steckdosenleiste angesprochen werden (z.B. zur [http://www.fhemwiki.de/w/index.php?title=Z-Wave-Greenwave_NP-210F_PowerNode_6_Steckdosenleiste&action=submit#Einbindung_der_weiteren_Steckdosen Einbindung der weiteren 5 Steckdosen]).

=== Exklusion ===
Zur Exklusion
* die Steckdosenleiste vom Stromnetz trennen
* ZWave-Controller/-Gateway in den Exklusions-Modus bringen (s. [http://www.fhemwiki.de/wiki/Z-Wave#Entfernen_eines_Z-Wave-Ger.C3.A4ts_.2F_Exklusion Entfernen eines Z-Wave-Geräts / Exklusion])
* die mit einem Synchronisations-Symbol gekennzeichnete Taste (seitlich am Gehäuse unter der Ein/Aus-Taste bzw. Statuskontrollleuchte) gedrückt halten und die Steckdosenleiste mit dem Stromnetz verbinden
* die Synchronisations-Taste weiterhin für ca. 5 Sekunden gedrückt halten bis die Statuskontrollleuchte schnell blinkt. Dies ist die Bestätigung der erfolgreichen Exklusion
* Den Exklusions-Modus des ZWave-Controllers/-Gateways beenden

=== Assoziation ===
Die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] unterstützt vier Gruppen mit je maximal einem Node zur Kommunikation.
{| class="wikitable"
|-
! Gruppe !! Kommunikation
|-
| 1
| Standardgruppe für Kommunikation mit ZWave-Controller/-Gateway
|-
| 2
| ???
|-
| 3
| Übertragung von Energiemesswerten der gesamten Steckdosen (???)
|-
| 4
| ???
|}

Nach Assoziation der Gruppe 3 mit
set ZWave_SWITCH_BINARY_37 associationAdd 3 1
wird automatisch ein weiteres Device angelegt, dass die Energiemessangaben der gesamten Steckdosenleiste enthält:
2015.09.10 21:31:21 3: UNDEFINED ZWave_Node_37.1 ZWave d79c8805 9473, please define it
2015.09.10 21:31:21 2: autocreate: define ZWave_Node_37.1 ZWave d79c8805 9473
Die Energiemessangaben werden im reading <code>power</code> dargestellt:
1.2 W previous: 1 delta_time: 9 s
und beim Ein-/Ausschalten der gesamten Steckdosenleiste oder einzelner Steckdosen aktualisiert.

=== Konfiguration ===

==== Einbindung der weiteren Steckdosen ====
Dies geschieht über die MULTICHANNEL-Klasse des Devices.

Mit den Einzelbefehlen
get ZWave_SWITCH_BINARY_37 mcCapability 2
get ZWave_SWITCH_BINARY_37 mcCapability 3
get ZWave_SWITCH_BINARY_37 mcCapability 4
get ZWave_SWITCH_BINARY_37 mcCapability 5
get ZWave_SWITCH_BINARY_37 mcCapability 6
werden die entsprechenden Devices in FHEM automatisch angelegt.

Beispielhafte Log-Meldungen:
2015.09.10 21:04:33 2: ZWave get ZWave_SWITCH_BINARY_37 mcCapability 2
2015.09.10 21:04:33 2: autocreate: define ZWave_BASIC_37.02 ZWave d79c8805 9474 20253275

==== Reconnect Controller/-Gateway ====
Es wurde beobachtet, dass die [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] schon nach kurzer Zeit fälschlicherweise über ihre Statuskontrollleuchte anzeigt, kein Kontakt mehr zum ZWave-Controller/-Gateway zu haben. Durch Setzen der Konfiguration
set ZWave_SWITCH_BINARY_37 configNoCommunicationLight 255
kann diese Anzeige deaktiviert werden (?oder gilt es doch nur für 255 Minuten?).

==== Energiemessdaten ====
Neben den Energiemessdaten der gesamten Steckdosenleiste können die Energiemesswerte jeder einzelnen Steckdose durch z.B.
get ZWave_BASIC_37.04 meter
abgefragt werden.

Eine automatische Meldung von Energiemesswerten an die Zentrale (ohne manuelle Abfrage) ist dem Autor nicht bekannt.

==== Gesamtübersicht der Devices ====
Hier eine Übersicht der durch <code>autocreate</code> und obiger Vorgehensweise in FHEM angelegten Devices zur [[Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste]] (ohne FileLogs):
{| class="wikitable"
|-
! Device !! Beschreibung
|-
| ZWave_SWITCH_BINARY_'''37'''
| Steckdose 1 (gezählt von Richtung des Strom-Anschlusskabels) und Konfiguration aller Parameter der Steckdosenleiste
|-
| ZWave_Node_'''37.1'''
| Device zur Darstellung von Energiemesswerten der gesamten Steckdosenleiste
|-
| ZWave_BASIC_'''37.02''' bis ZWave_BASIC_'''37.06'''
| Steckdosen 2 bis 6 (gezählt von Richtung des Strom-Anschlusskabels)
|}

==== Beschreibung der Statuskontrollleuchte ====
{| class="wikitable"
|-
! Status !! Bedeutung
|-
| Aus
| Alle Steckdosen sind ausgeschaltet
|-
| Dauer-Weiß
| Alle Steckdosen sind eingeschaltet
|-
| Dauer-Grün
| Mindestens eine Steckdose ist eingeschaltet (andere sind ausgeschaltet)
|-
| Blinkendes-Grün (MehrfachSegmente)
| Kein Kontakt zum Z-Wave Controller
|-
| Umlaufendes Grün (Doppelsegment)
| Die Steckdosenleiste befindet sich im Inclusion-Modus
|-
| Umlaufendes Grün (Einfachsegment)
| Die Steckdosenleiste befindet sich im Exclusion-Modus
|}

=== Besonderheiten ===
* Nach einem Stromausfall sind alle Steckdosen automatisch eingeschaltet! Dieses Verhalten ist nach bisherigen Recherchen leider nicht konfigurierbar.

=== Logbeispiele ===
FHEM-Log:
2015.09.12 14:48:29 2: ZWave set ZWave_BASIC_37.02 on
2015.09.12 14:48:55 2: ZWave set ZWave_BASIC_37.02 off
2015.09.12 15:21:06 2: ZWave set ZWave_SWITCH_BINARY_37 off
2015.09.12 15:21:08 2: ZWave set ZWave_SWITCH_BINARY_37 on
Device-Log ZWave_Node_37.1:
2015-09-12_14:48:37 ZWave_Node_37.1 power: 1.2 W previous: 0 delta_time: 9 s
2015-09-12_14:48:55 ZWave_Node_37.1 power: 0.7 W previous: 0 delta_time: 9 s
2015-09-12_14:49:04 ZWave_Node_37.1 power: 1 W previous: 0.7 delta_time: 9 s
2015-09-12_14:49:13 ZWave_Node_37.1 power: 1.2 W previous: 1 delta_time: 9 s
Device-Log ZWave_Node_37.02:
2015-09-12_13:47:03 ZWave_BASIC_37.02 on
2015-09-12_14:48:22 ZWave_BASIC_37.02 off
2015-09-12_15:12:23 ZWave_BASIC_37.02 energy: 0.0033 kWh

== Links ==
* Weitere Infos bei "Z-Wave Device Library": [http://pepper1.net/zwavedb/device/280 NP210-F/NP212-F] / [http://pepper1.net/zwavedb/device/278 NP210-KF/NP212-KF], englisch
* (Rudimentäres) Bedienungshandbuch: [https://www.m.nu/pdf/PowerNode_manual_english.pdf PDF], englisch

[[Kategorie:Z-Wave Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Datei:Greenwave NP-210F.jpg

2015-09-12T10:53:35Z

Scooty: Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

Z-Wave-Greenwave NP-210F PowerNode 6 Steckdosenleiste

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2015-08-13T11:05:39Z

Scooty:

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=Bild und Daten müssen noch ergänzt werden
|HWProtocol=
|HWType=
|HWCategory=
|HWComm=
|HWChannels=
|HWVoltage=
|HWPowerConsumption=
|HWPoweredBy=
|HWSize=
|HWDeviceFHEM=
|HWManufacturer=
}}

Der '''Funk-Kombi-Sensor OC3 (HM-WDS100-C6-O)''' ist eine [[HomeMatic]] Funk-Wetterstation für den Außeneinsatz zur Messung von Temperatur, relativer Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.

== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Schwankung der Windrichtung 0°/22,5°/45°/67,5°
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Sturm-Soforterkennung
* Helligkeit gemessen über Photodiode mit einheitenlosen Wert 1-255
* Sonnenschein-Dauer gezählt als Minuten oberhalb der Helligkeitsschwelle von 30 (Default)
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus

== Hinweise zum Betrieb mit Fhem ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

=== Konfiguration (fhem.cfg) ===
<pre>define Wetterstation CUL_HM 338893
attr Wetterstation IODev CUL_HM
attr Wetterstation autoReadReg 5_readMissing
attr Wetterstation expert 2_full
attr Wetterstation firmware 1.4
attr Wetterstation model HM-WDS100-C6-O
attr Wetterstation serialNr LEQ1442799
attr Wetterstation stateFormat Temperatur: temperature °C, Feuchtigkeit: humidity %, Helligkeit: brightness, Regen: rain mm/qm, Wind: windSpeed km/h, Richtung: windDirection
attr Wetterstation subType THSensor</pre>

=== Event-Monitor ===

Wetterstation T: 17.5 H: 82 W: 0 R: 553.715 IR: 0 WD: 10 WDR: 67.5 S: 106 B: 16
Wetterstation temperature: 17.5
Wetterstation humidity: 82
Wetterstation windSpeed: 0
Wetterstation windDirection: 10
Wetterstation windDirRange: 67.5
Wetterstation rain: 553.715
Wetterstation isRaining: 0
Wetterstation sunshine: 106

=== Parameterliste ===
'''list: register | range | peer | description'''
0: intKeyVisib | literal | | visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | pairing to central
1: stormLowThresh | 0 to 255 | | Storm lower threshold
1: stormUpThresh | 0 to 255 | | Storm upper threshold

=== Log-Einträge ===
<pre>2015-08-13_12:47:18 Wetterstation T: 28.6 H: 57 W: 7 R: 145.14 IR: 0 WD: 80 WDR: 67.5 S: 8 B: 140
2015-08-13_12:47:18 Wetterstation brightness: 140
2015-08-13_12:47:18 Wetterstation humidity: 57
2015-08-13_12:47:18 Wetterstation isRaining: 0
2015-08-13_12:47:18 Wetterstation rain: 145.14
2015-08-13_12:47:18 Wetterstation sunshine: 8
2015-08-13_12:47:18 Wetterstation temperature: 28.6
2015-08-13_12:47:18 Wetterstation windDirRange: 67.5
2015-08-13_12:47:18 Wetterstation windDirection: 80
2015-08-13_12:47:18 Wetterstation windSpeed: 70</pre>

=== Anwendungsbeispiele ===
==== Anbindung an OpenWeathermap ====
Das hier verwendete "inoffizielle" 98_openweathermap.pm-Modul muss manuell aus dem [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib]-Verzeichnis des Fhem-SVN heruntergeladen und in das Modulverzeichnis der eigenen Fhem-Installation kopiert werden.

Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_myUtils anlegen (abgeleitet von einer Funktion zur [[Gleitende Mittelwerte berechnen und loggen|Mittelwertberechnung]]):

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
} </nowiki>

Danach in der fhem.cfg folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
} </nowiki>

Dann können die Werte mit dem 98_openweathermap.pm - Modul aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib] übertragen werden:
<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

==== Sturmerkennung ====
Die Sensor-interne Sturmerkennung hat den Vorteil, dass bei Über-/Unterschreiten von konfigurierbaren Schwellwerten sofort ein Event generiert wird bzw. ein gepeerter Aktor sofort getriggert wird und somit eine Sturmerkennung nicht nachgelagert über das Reading "windSpeed" erfolgen muss (der Sensor sendet seine Werte sonst nur ca. alle 2-3 Minuten).

Folgende Schritte zur Nutzung und Anpassung der internen Sturmerkennung sind durchzuführen:

1. Peeren des Kanal 1 des Sensors (WGEG_SENW) mit einem Aktor (VCCU_Chan03, in diesem Beispiel also der virtuelle Kanal 3 einer VCCU):

<nowiki>set WGEG_SENW peerChan 1 VCCU_Chan03 single set</nowiki>

Damit werden neben der Peerkonfiguration auch folgende Readings im Sensor-Device erzeugt

<nowiki>R-VCCU_Chan03-stormLowThresh 5
R-VCCU_Chan03-stormUpThresh 25</nowiki>

2. Diese Schwellwerte können nun mit z.B.

<nowiki>set WGEG_SENW regSet stormUpThresh 15 VCCU_Chan03</nowiki>

angepaßt werden (s. Commandref zu [http://fhem.de/commandref.html#CUL_HMregSet regSet]).

== Bekannte Probleme ==
Der Zähler sunshine läuft nach gut 4 Stunden über, an Sonnentagen läuft dieser Zähler u.U. sogar mehr als einmal über.

Fhem hat bislang (noch) nicht die Möglichkeit implementiert, die Mengenmessung zu justieren. In Einzelfällen sind im Werksauslieferungszustand konstante Messabweichungen von 10% beobachtet worden.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf Montage- und Bedienungsanleitung]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf Produktdatenblatt]
* [http://forum.fhem.de/index.php/topic,6106.msg24524.html#msg24524 Thread] im Forum

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]
[[Kategorie:Wetterstationen]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2015-08-13T11:03:41Z

Scooty: /* Konfiguration (fhem.cfg) */

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=Bild und Daten müssen noch ergänzt werden
|HWProtocol=
|HWType=
|HWCategory=
|HWComm=
|HWChannels=
|HWVoltage=
|HWPowerConsumption=
|HWPoweredBy=
|HWSize=
|HWDeviceFHEM=
|HWManufacturer=
}}

Der '''Funk-Kombi-Sensor OC3 (HM-WDS100-C6-O)''' ist eine [[HomeMatic]] Funk-Wetterstation für den Außeneinsatz zur Messung von Temperatur, relativer Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.

== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Schwankung der Windrichtung 0°/22,5°/45°/67,5°
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Sturm-Soforterkennung
* Helligkeit gemessen über Photodiode mit einheitenlosen Wert 1-255
* Sonnenschein-Dauer gezählt als Minuten oberhalb der Helligkeitsschwelle von 30 (Default)
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus

== Hinweise zum Betrieb mit Fhem ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

=== Konfiguration (fhem.cfg) ===
<nowiki>define Wetterstation CUL_HM 338893
attr Wetterstation IODev CUL_HM
attr Wetterstation autoReadReg 5_readMissing
attr Wetterstation expert 2_full
attr Wetterstation firmware 1.4
attr Wetterstation model HM-WDS100-C6-O
attr Wetterstation serialNr LEQ1442799
attr Wetterstation stateFormat Temperatur: temperature °C, Feuchtigkeit: humidity %, Helligkeit: brightness, Regen: rain mm/qm, Wind: windSpeed km/h, Richtung: windDirection
attr Wetterstation subType THSensor</nowiki>

=== Event-Monitor ===

Wetterstation T: 17.5 H: 82 W: 0 R: 553.715 IR: 0 WD: 10 WDR: 67.5 S: 106 B: 16
Wetterstation temperature: 17.5
Wetterstation humidity: 82
Wetterstation windSpeed: 0
Wetterstation windDirection: 10
Wetterstation windDirRange: 67.5
Wetterstation rain: 553.715
Wetterstation isRaining: 0
Wetterstation sunshine: 106

=== Parameterliste ===
'''list: register | range | peer | description'''
0: intKeyVisib | literal | | visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | pairing to central
1: stormLowThresh | 0 to 255 | | Storm lower threshold
1: stormUpThresh | 0 to 255 | | Storm upper threshold

=== Log-Einträge ===
<pre>2015-08-13_12:47:18 Wetterstation T: 28.6 H: 57 W: 7 R: 145.14 IR: 0 WD: 80 WDR: 67.5 S: 8 B: 140
2015-08-13_12:47:18 Wetterstation brightness: 140
2015-08-13_12:47:18 Wetterstation humidity: 57
2015-08-13_12:47:18 Wetterstation isRaining: 0
2015-08-13_12:47:18 Wetterstation rain: 145.14
2015-08-13_12:47:18 Wetterstation sunshine: 8
2015-08-13_12:47:18 Wetterstation temperature: 28.6
2015-08-13_12:47:18 Wetterstation windDirRange: 67.5
2015-08-13_12:47:18 Wetterstation windDirection: 80
2015-08-13_12:47:18 Wetterstation windSpeed: 70</pre>

=== Anwendungsbeispiele ===
==== Anbindung an OpenWeathermap ====
Das hier verwendete "inoffizielle" 98_openweathermap.pm-Modul muss manuell aus dem [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib]-Verzeichnis des Fhem-SVN heruntergeladen und in das Modulverzeichnis der eigenen Fhem-Installation kopiert werden.

Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_myUtils anlegen (abgeleitet von einer Funktion zur [[Gleitende Mittelwerte berechnen und loggen|Mittelwertberechnung]]):

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
} </nowiki>

Danach in der fhem.cfg folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
} </nowiki>

Dann können die Werte mit dem 98_openweathermap.pm - Modul aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib] übertragen werden:
<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

==== Sturmerkennung ====
Die Sensor-interne Sturmerkennung hat den Vorteil, dass bei Über-/Unterschreiten von konfigurierbaren Schwellwerten sofort ein Event generiert wird bzw. ein gepeerter Aktor sofort getriggert wird und somit eine Sturmerkennung nicht nachgelagert über das Reading "windSpeed" erfolgen muss (der Sensor sendet seine Werte sonst nur ca. alle 2-3 Minuten).

Folgende Schritte zur Nutzung und Anpassung der internen Sturmerkennung sind durchzuführen:

1. Peeren des Kanal 1 des Sensors (WGEG_SENW) mit einem Aktor (VCCU_Chan03, in diesem Beispiel also der virtuelle Kanal 3 einer VCCU):

<nowiki>set WGEG_SENW peerChan 1 VCCU_Chan03 single set</nowiki>

Damit werden neben der Peerkonfiguration auch folgende Readings im Sensor-Device erzeugt

<nowiki>R-VCCU_Chan03-stormLowThresh 5
R-VCCU_Chan03-stormUpThresh 25</nowiki>

2. Diese Schwellwerte können nun mit z.B.

<nowiki>set WGEG_SENW regSet stormUpThresh 15 VCCU_Chan03</nowiki>

angepaßt werden (s. Commandref zu [http://fhem.de/commandref.html#CUL_HMregSet regSet]).

== Bekannte Probleme ==
Der Zähler sunshine läuft nach gut 4 Stunden über, an Sonnentagen läuft dieser Zähler u.U. sogar mehr als einmal über.

Fhem hat bislang (noch) nicht die Möglichkeit implementiert, die Mengenmessung zu justieren. In Einzelfällen sind im Werksauslieferungszustand konstante Messabweichungen von 10% beobachtet worden.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf Montage- und Bedienungsanleitung]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf Produktdatenblatt]
* [http://forum.fhem.de/index.php/topic,6106.msg24524.html#msg24524 Thread] im Forum

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]
[[Kategorie:Wetterstationen]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2015-08-13T10:59:49Z

Scooty: Einträge für FHEM.CFG hinzugefügt

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=Bild und Daten müssen noch ergänzt werden
|HWProtocol=
|HWType=
|HWCategory=
|HWComm=
|HWChannels=
|HWVoltage=
|HWPowerConsumption=
|HWPoweredBy=
|HWSize=
|HWDeviceFHEM=
|HWManufacturer=
}}

Der '''Funk-Kombi-Sensor OC3 (HM-WDS100-C6-O)''' ist eine [[HomeMatic]] Funk-Wetterstation für den Außeneinsatz zur Messung von Temperatur, relativer Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.

== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Schwankung der Windrichtung 0°/22,5°/45°/67,5°
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Sturm-Soforterkennung
* Helligkeit gemessen über Photodiode mit einheitenlosen Wert 1-255
* Sonnenschein-Dauer gezählt als Minuten oberhalb der Helligkeitsschwelle von 30 (Default)
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus

== Hinweise zum Betrieb mit Fhem ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

=== Konfiguration (fhem.cfg) ===
<nowiki>define Wetterstation CUL_HM 338893
attr Wetterstation IODev CUL_HM
attr Wetterstation autoReadReg 5_readMissing
attr Wetterstation expert 2_full
attr Wetterstation firmware 1.4
attr Wetterstation model HM-WDS100-C6-O
attr Wetterstation serialNr LEQ1442799
attr Wetterstation stateFormat Temperatur: temperature °C, Feuchtigkeit: humidity %,<br>Taupunkt: dewpoint °C, Helligkeit: brightness,<br>Regen: rain mm/qm, Wind: windSpeed km/h,<br>Richtung: windDirectionText
attr Wetterstation subType THSensor</nowiki>

=== Event-Monitor ===

Wetterstation T: 17.5 H: 82 W: 0 R: 553.715 IR: 0 WD: 10 WDR: 67.5 S: 106 B: 16
Wetterstation temperature: 17.5
Wetterstation humidity: 82
Wetterstation windSpeed: 0
Wetterstation windDirection: 10
Wetterstation windDirRange: 67.5
Wetterstation rain: 553.715
Wetterstation isRaining: 0
Wetterstation sunshine: 106

=== Parameterliste ===
'''list: register | range | peer | description'''
0: intKeyVisib | literal | | visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | pairing to central
1: stormLowThresh | 0 to 255 | | Storm lower threshold
1: stormUpThresh | 0 to 255 | | Storm upper threshold

=== Log-Einträge ===

<nowiki>2015-08-13_12:47:18 Wetterstation T: 28.6 H: 57 W: 7 R: 145.14 IR: 0 WD: 80 WDR: 67.5 S: 8 B: 140
2015-08-13_12:47:18 Wetterstation brightness: 140
2015-08-13_12:47:18 Wetterstation humidity: 57
2015-08-13_12:47:18 Wetterstation isRaining: 0
2015-08-13_12:47:18 Wetterstation rain: 145.14
2015-08-13_12:47:18 Wetterstation sunshine: 8
2015-08-13_12:47:18 Wetterstation temperature: 28.6
2015-08-13_12:47:18 Wetterstation windDirRange: 67.5
2015-08-13_12:47:18 Wetterstation windDirection: 80
2015-08-13_12:47:18 Wetterstation windSpeed: 70</nowiki>

=== Anwendungsbeispiele ===
==== Anbindung an OpenWeathermap ====
Das hier verwendete "inoffizielle" 98_openweathermap.pm-Modul muss manuell aus dem [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib]-Verzeichnis des Fhem-SVN heruntergeladen und in das Modulverzeichnis der eigenen Fhem-Installation kopiert werden.

Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_myUtils anlegen (abgeleitet von einer Funktion zur [[Gleitende Mittelwerte berechnen und loggen|Mittelwertberechnung]]):

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
} </nowiki>

Danach in der fhem.cfg folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
} </nowiki>

Dann können die Werte mit dem 98_openweathermap.pm - Modul aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib] übertragen werden:
<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

==== Sturmerkennung ====
Die Sensor-interne Sturmerkennung hat den Vorteil, dass bei Über-/Unterschreiten von konfigurierbaren Schwellwerten sofort ein Event generiert wird bzw. ein gepeerter Aktor sofort getriggert wird und somit eine Sturmerkennung nicht nachgelagert über das Reading "windSpeed" erfolgen muss (der Sensor sendet seine Werte sonst nur ca. alle 2-3 Minuten).

Folgende Schritte zur Nutzung und Anpassung der internen Sturmerkennung sind durchzuführen:

1. Peeren des Kanal 1 des Sensors (WGEG_SENW) mit einem Aktor (VCCU_Chan03, in diesem Beispiel also der virtuelle Kanal 3 einer VCCU):

<nowiki>set WGEG_SENW peerChan 1 VCCU_Chan03 single set</nowiki>

Damit werden neben der Peerkonfiguration auch folgende Readings im Sensor-Device erzeugt

<nowiki>R-VCCU_Chan03-stormLowThresh 5
R-VCCU_Chan03-stormUpThresh 25</nowiki>

2. Diese Schwellwerte können nun mit z.B.

<nowiki>set WGEG_SENW regSet stormUpThresh 15 VCCU_Chan03</nowiki>

angepaßt werden (s. Commandref zu [http://fhem.de/commandref.html#CUL_HMregSet regSet]).

== Bekannte Probleme ==
Der Zähler sunshine läuft nach gut 4 Stunden über, an Sonnentagen läuft dieser Zähler u.U. sogar mehr als einmal über.

Fhem hat bislang (noch) nicht die Möglichkeit implementiert, die Mengenmessung zu justieren. In Einzelfällen sind im Werksauslieferungszustand konstante Messabweichungen von 10% beobachtet worden.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf Montage- und Bedienungsanleitung]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf Produktdatenblatt]
* [http://forum.fhem.de/index.php/topic,6106.msg24524.html#msg24524 Thread] im Forum

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]
[[Kategorie:Wetterstationen]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2015-08-13T10:55:41Z

Scooty:

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=Bild und Daten müssen noch ergänzt werden
|HWProtocol=
|HWType=
|HWCategory=
|HWComm=
|HWChannels=
|HWVoltage=
|HWPowerConsumption=
|HWPoweredBy=
|HWSize=
|HWDeviceFHEM=
|HWManufacturer=
}}

Der '''Funk-Kombi-Sensor OC3 (HM-WDS100-C6-O)''' ist eine [[HomeMatic]] Funk-Wetterstation für den Außeneinsatz zur Messung von Temperatur, relativer Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.

== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Schwankung der Windrichtung 0°/22,5°/45°/67,5°
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Sturm-Soforterkennung
* Helligkeit gemessen über Photodiode mit einheitenlosen Wert 1-255
* Sonnenschein-Dauer gezählt als Minuten oberhalb der Helligkeitsschwelle von 30 (Default)
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus

== Hinweise zum Betrieb mit Fhem ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

=== Konfiguration (fhem.cfg) ===
''Muss noch ergänzt werden''

=== Event-Monitor ===

Wetterstation T: 17.5 H: 82 W: 0 R: 553.715 IR: 0 WD: 10 WDR: 67.5 S: 106 B: 16
Wetterstation temperature: 17.5
Wetterstation humidity: 82
Wetterstation windSpeed: 0
Wetterstation windDirection: 10
Wetterstation windDirRange: 67.5
Wetterstation rain: 553.715
Wetterstation isRaining: 0
Wetterstation sunshine: 106

=== Parameterliste ===
'''list: register | range | peer | description'''
0: intKeyVisib | literal | | visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | pairing to central
1: stormLowThresh | 0 to 255 | | Storm lower threshold
1: stormUpThresh | 0 to 255 | | Storm upper threshold

=== Log-Einträge ===

<nowiki>2015-08-13_12:47:18 Wetterstation T: 28.6 H: 57 W: 7 R: 145.14 IR: 0 WD: 80 WDR: 67.5 S: 8 B: 140
2015-08-13_12:47:18 Wetterstation brightness: 140
2015-08-13_12:47:18 Wetterstation humidity: 57
2015-08-13_12:47:18 Wetterstation isRaining: 0
2015-08-13_12:47:18 Wetterstation rain: 145.14
2015-08-13_12:47:18 Wetterstation sunshine: 8
2015-08-13_12:47:18 Wetterstation temperature: 28.6
2015-08-13_12:47:18 Wetterstation windDirRange: 67.5
2015-08-13_12:47:18 Wetterstation windDirection: 80
2015-08-13_12:47:18 Wetterstation windSpeed: 70</nowiki>

=== Anwendungsbeispiele ===
==== Anbindung an OpenWeathermap ====
Das hier verwendete "inoffizielle" 98_openweathermap.pm-Modul muss manuell aus dem [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib]-Verzeichnis des Fhem-SVN heruntergeladen und in das Modulverzeichnis der eigenen Fhem-Installation kopiert werden.

Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_myUtils anlegen (abgeleitet von einer Funktion zur [[Gleitende Mittelwerte berechnen und loggen|Mittelwertberechnung]]):

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
} </nowiki>

Danach in der fhem.cfg folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
} </nowiki>

Dann können die Werte mit dem 98_openweathermap.pm - Modul aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib] übertragen werden:
<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

==== Sturmerkennung ====
Die Sensor-interne Sturmerkennung hat den Vorteil, dass bei Über-/Unterschreiten von konfigurierbaren Schwellwerten sofort ein Event generiert wird bzw. ein gepeerter Aktor sofort getriggert wird und somit eine Sturmerkennung nicht nachgelagert über das Reading "windSpeed" erfolgen muss (der Sensor sendet seine Werte sonst nur ca. alle 2-3 Minuten).

Folgende Schritte zur Nutzung und Anpassung der internen Sturmerkennung sind durchzuführen:

1. Peeren des Kanal 1 des Sensors (WGEG_SENW) mit einem Aktor (VCCU_Chan03, in diesem Beispiel also der virtuelle Kanal 3 einer VCCU):

<nowiki>set WGEG_SENW peerChan 1 VCCU_Chan03 single set</nowiki>

Damit werden neben der Peerkonfiguration auch folgende Readings im Sensor-Device erzeugt

<nowiki>R-VCCU_Chan03-stormLowThresh 5
R-VCCU_Chan03-stormUpThresh 25</nowiki>

2. Diese Schwellwerte können nun mit z.B.

<nowiki>set WGEG_SENW regSet stormUpThresh 15 VCCU_Chan03</nowiki>

angepaßt werden (s. Commandref zu [http://fhem.de/commandref.html#CUL_HMregSet regSet]).

== Bekannte Probleme ==
Der Zähler sunshine läuft nach gut 4 Stunden über, an Sonnentagen läuft dieser Zähler u.U. sogar mehr als einmal über.

Fhem hat bislang (noch) nicht die Möglichkeit implementiert, die Mengenmessung zu justieren. In Einzelfällen sind im Werksauslieferungszustand konstante Messabweichungen von 10% beobachtet worden.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf Montage- und Bedienungsanleitung]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf Produktdatenblatt]
* [http://forum.fhem.de/index.php/topic,6106.msg24524.html#msg24524 Thread] im Forum

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]
[[Kategorie:Wetterstationen]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2015-08-13T10:53:11Z

Scooty: Log-Einträge hinzugefügt

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=Bild und Daten müssen noch ergänzt werden
|HWProtocol=
|HWType=
|HWCategory=
|HWComm=
|HWChannels=
|HWVoltage=
|HWPowerConsumption=
|HWPoweredBy=
|HWSize=
|HWDeviceFHEM=
|HWManufacturer=
}}

Der '''Funk-Kombi-Sensor OC3 (HM-WDS100-C6-O)''' ist eine [[HomeMatic]] Funk-Wetterstation für den Außeneinsatz zur Messung von Temperatur, relativer Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.

== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Schwankung der Windrichtung 0°/22,5°/45°/67,5°
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Sturm-Soforterkennung
* Helligkeit gemessen über Photodiode mit einheitenlosen Wert 1-255
* Sonnenschein-Dauer gezählt als Minuten oberhalb der Helligkeitsschwelle von 30 (Default)
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus

== Hinweise zum Betrieb mit Fhem ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

=== Konfiguration (fhem.cfg) ===
''Muss noch ergänzt werden''

=== Event-Monitor ===

Wetterstation T: 17.5 H: 82 W: 0 R: 553.715 IR: 0 WD: 10 WDR: 67.5 S: 106 B: 16
Wetterstation temperature: 17.5
Wetterstation humidity: 82
Wetterstation windSpeed: 0
Wetterstation windDirection: 10
Wetterstation windDirRange: 67.5
Wetterstation rain: 553.715
Wetterstation isRaining: 0
Wetterstation sunshine: 106

=== Parameterliste ===
'''list: register | range | peer | description'''
0: intKeyVisib | literal | | visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | pairing to central
1: stormLowThresh | 0 to 255 | | Storm lower threshold
1: stormUpThresh | 0 to 255 | | Storm upper threshold

=== Log-Einträge ===

2015-08-13_12:47:18 Wetterstation T: 28.6 H: 57 W: 7 R: 145.14 IR: 0 WD: 80 WDR: 67.5 S: 8 B: 140
2015-08-13_12:47:18 Wetterstation brightness: 140
2015-08-13_12:47:18 Wetterstation humidity: 57
2015-08-13_12:47:18 Wetterstation isRaining: 0
2015-08-13_12:47:18 Wetterstation rain: 145.14
2015-08-13_12:47:18 Wetterstation sunshine: 8
2015-08-13_12:47:18 Wetterstation temperature: 28.6
2015-08-13_12:47:18 Wetterstation windDirRange: 67.5
2015-08-13_12:47:18 Wetterstation windDirection: 80
2015-08-13_12:47:18 Wetterstation windSpeed: 70

=== Anwendungsbeispiele ===
==== Anbindung an OpenWeathermap ====
Das hier verwendete "inoffizielle" 98_openweathermap.pm-Modul muss manuell aus dem [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib]-Verzeichnis des Fhem-SVN heruntergeladen und in das Modulverzeichnis der eigenen Fhem-Installation kopiert werden.

Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_myUtils anlegen (abgeleitet von einer Funktion zur [[Gleitende Mittelwerte berechnen und loggen|Mittelwertberechnung]]):

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
} </nowiki>

Danach in der fhem.cfg folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
} </nowiki>

Dann können die Werte mit dem 98_openweathermap.pm - Modul aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib] übertragen werden:
<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

==== Sturmerkennung ====
Die Sensor-interne Sturmerkennung hat den Vorteil, dass bei Über-/Unterschreiten von konfigurierbaren Schwellwerten sofort ein Event generiert wird bzw. ein gepeerter Aktor sofort getriggert wird und somit eine Sturmerkennung nicht nachgelagert über das Reading "windSpeed" erfolgen muss (der Sensor sendet seine Werte sonst nur ca. alle 2-3 Minuten).

Folgende Schritte zur Nutzung und Anpassung der internen Sturmerkennung sind durchzuführen:

1. Peeren des Kanal 1 des Sensors (WGEG_SENW) mit einem Aktor (VCCU_Chan03, in diesem Beispiel also der virtuelle Kanal 3 einer VCCU):

<nowiki>set WGEG_SENW peerChan 1 VCCU_Chan03 single set</nowiki>

Damit werden neben der Peerkonfiguration auch folgende Readings im Sensor-Device erzeugt

<nowiki>R-VCCU_Chan03-stormLowThresh 5
R-VCCU_Chan03-stormUpThresh 25</nowiki>

2. Diese Schwellwerte können nun mit z.B.

<nowiki>set WGEG_SENW regSet stormUpThresh 15 VCCU_Chan03</nowiki>

angepaßt werden (s. Commandref zu [http://fhem.de/commandref.html#CUL_HMregSet regSet]).

== Bekannte Probleme ==
Der Zähler sunshine läuft nach gut 4 Stunden über, an Sonnentagen läuft dieser Zähler u.U. sogar mehr als einmal über.

Fhem hat bislang (noch) nicht die Möglichkeit implementiert, die Mengenmessung zu justieren. In Einzelfällen sind im Werksauslieferungszustand konstante Messabweichungen von 10% beobachtet worden.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf Montage- und Bedienungsanleitung]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf Produktdatenblatt]
* [http://forum.fhem.de/index.php/topic,6106.msg24524.html#msg24524 Thread] im Forum

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]
[[Kategorie:Wetterstationen]]

Z-Wave-FIB FGRM-222-Rollladenaktor

2015-08-10T16:56:49Z

Scooty: Bild des Rolladenaktors aufgenommen

{{Infobox Hardware
|Bild=Z-Wave-FIB FGRM-222.JPG
|Bildbeschreibung=Fibaro FGRM-222
|HWProtocol=Z-Wave
|HWType=Sensor, Sender und Aktor, Empfänger
|HWCategory=Z-Wave
|HWComm=Funk 868MHz
|HWChannels=2
|HWVoltage=230V~
|HWPowerConsumption=<0,8W
|HWPoweredBy=230V~
|HWSize=42x37x17mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#ZWave Z-Wave]
|HWManufacturer=[http://www.fibaro.com/de Fibar Group]
}}

[[Z-Wave-FIB FGRM-222-Rollladenaktor]] ist ein Jalousiesteuereinsatz für die Steuerung von Rollos, Markisen, Jalousien, Garagentoren und anderen Einphasen-Wechselstrom-Geräten mit Energiemessfunktion

== Features ==
Der Jalousieaktor bietet Positionserkennung, spezielle Steuerkommandos für Lammellen (Winkelverstellung) und misst den Energieverbrauch.

== Hinweise zum Betrieb mit FHEM ==
=== Inklusion ===
Der Aktor wird bei der Inklusion und aktivierten autocreate vollautomatisch erkannt und definiert. Zur Steuerung von Lamellen von Jalousien muss das Kommando <code>get <device> model</code> erfolgreich ausgeführt worden sein, damit die speziellen Fibaro-Kommandos zur Lammellensteuerung bereitstehen.

=== Assoziation ===
Der Controller muss zur korrekten Funktion in die Assoziationsgruppe 3 des Aktors aufgenommen werden:
:<code>set <device> associationAdd 3 <Controller-NodeID></code>
Dies wird aufgrund der Informationen in der XML-Config-Datei für den FGRM-222 automatisch bei der Inklusion durchgeführt. Bitte die korrekte Verarbeitung des Befehls per <code>get <device> association 3</code> überprüfen.

=== Konfiguration ===
{{Randnotiz|RNText=Ab {{Link2Forum|Topic=37121|Message=294480|LinkText=Updatestand 15.05.2015}} wird bei der Inklusion von Geräten automatisch der Befehl <code>get <name> model</code> ausgeführt.}}
Das Gerät von Fhem einmalig durch folgenden Befehl identifizieren:
:<code>get <device> model</code>
Die Readings <code>model</code>, <code>modelID</code> und <code>modelConfig</code> werden dadurch erzeugt. In <code>model</code> steht nach korrekter Ausführung des Befehls der Klartextname des Gerätes "FIBARO System FGRM222 Roller Shutter Controller 2". Zudem sind dann spezielle set/get-Kommandos configXYZ des Gerätes im Auswahldialog der Detailansicht mit den zugehörigen Hilfetexten verfügbar.

Der Aktor muss anschließend kalibriert werden. Dazu Parameter 29 auf 1 setzen:
:<code>set <device> configByte 29 1</code>
oder
:<code>set <device> configForcedRollerShutterCalibration StartCalibrationProcess</code>

Der Aktor fährt die Rolllade zur Kalibrierung vollständig hoch, runter und wieder hoch.

==== Rollladen ====
Nach Kalibrierung kann die Rolllade sofort prozentual durch
:<code>set <device> dim <%> </code>
gesteuert werden. Weitere Parametereinstellung sind grundsätzlich nicht notwendig.

==== Jalousie mit Lammellen ====
Zur Steuerung von Jalousien mit Lammellen ist der Jalousiemodus mit Positionsunterstützung zu wählen:
:<code>set <device> configByte 10 2 </code>
oder
:<code>set <device> configRollerShutterOperatingModes VenetianBlindModeWithPositioning </code>

Der Jalousie-Positions-Report sollte als Fibaro Kommando an den Controller gesendet werden, da nur so der eingestellte Winkel vom Aktor an den Controller gesendet wird:
:<code>set <device> configByte 3 1 </code>
oder
:<code>set <device> configReportsType BlindPositionReportsSentToThe1 </code>

Zudem ist die Zeit für ein vollständiges Drehen der Lammellen einzustellen:
:<code><nowiki>set <device> configWord 12 <time></nowiki></code>
oder
:<code><nowiki>set <device> configInVenetianBlindModeTheParameter12 <time> </nowiki></code>

Nach dem Setzen dieser Parameter kann die Jalousie mit Lammellen folgermaßen gesteuert werden:
:<code>set <device> positionSlat <%> </code>
Fährt die Lammelle in den angegebenen Winkel.

:<code>set <device> positionBlind <%> </code>
Fährt die Jalousie zur angegebenen Position und fährt die Lammellen auf Position 0% (geschlossen).<br/>
Ausnahme: Bei sehr geringen Änderungen an der Ausgangsposition (ca. 1-3%) wird der zuletzt gewählt Winkel der Lammellen wieder hergestellt.

:<code>set <device> dim <%> </code>
Fährt die Jalousie zur angegebenen Position und fährt die Lammellen in den zuletzt per <code>set <device> positionSlat <%></code> gewählten Winkel.

Obige Hinweise beziehen sich auf einen Aktor ohne örtliche Steuerung durch Taster/Schalter. Auswirkungen einer örtlichen Steuerung auf die Fhem-Befehle (Winkeleinstellungen!) können daher nicht beurteilt werden.

=== Definition ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:
define ZWave_SWITCH_MULTILEVEL_4 ZWave e345c452 4
attr ZWave_SWITCH_MULTILEVEL_4 IODev ZWDongle_0
attr ZWave_SWITCH_MULTILEVEL_4 classes MANUFACTURER_SPECIFIC VERSION CONFIGURATION ASSOCIATION SWITCH_BINARY POWERLEVEL METER SENSOR_MULTILEVEL FIRMWARE_UPDATE_MD SWITCH_BINARY MANUFACTURER_PROPRIETARY PROTECTION MARK METER SENSOR_MULTILEVEL MANUFACTURER_PROPRIETARY SCENE_ACTIVATION SWITCH_MULTILEVEL SWITCH_BINARY
attr ZWave_SWITCH_MULTILEVEL_4 room ZWave
define FileLog_ZWave_SWITCH_MULTILEVEL_4 FileLog ./log/ZWave_SWITCH_MULTILEVEL_4-%Y.log ZWave_SWITCH_MULTILEVEL_4
attr FileLog_ZWave_SWITCH_MULTILEVEL_4 logtype text
attr FileLog_ZWave_SWITCH_MULTILEVEL_4 room ZWave

=== Logbeispiel ===
Log mit Parameter 3 auf 0 = Jalousie Positions Report wird als Z-Wave Kommando an Primärcontroller gesendet. (Standardeinstellung)

2014-09-27_13:41:46 ZWave_SWITCH_MULTILEVEL_4 power: 81.6 W
2014-09-27_13:42:36 ZWave_SWITCH_MULTILEVEL_4 power: 59.5 W
2014-09-27_13:42:41 ZWave_SWITCH_MULTILEVEL_4 power: 0.0 W
2014-09-27_13:42:41 ZWave_SWITCH_MULTILEVEL_4 dim 95
2014-09-27_13:42:41 ZWave_SWITCH_MULTILEVEL_4 reportedState: dim 95
2014-09-27_13:44:40 ZWave_SWITCH_MULTILEVEL_4 dim 53
2014-09-27_13:44:41 ZWave_SWITCH_MULTILEVEL_4 power: 85.1 W
2014-09-27_13:45:05 ZWave_SWITCH_MULTILEVEL_4 dim 53
2014-09-27_13:45:05 ZWave_SWITCH_MULTILEVEL_4 reportedState: dim 53
2014-09-27_13:45:05 ZWave_SWITCH_MULTILEVEL_4 power: 0.0 W
2014-09-27_13:45:20 ZWave_SWITCH_MULTILEVEL_4 dim 0
2014-09-27_13:45:21 ZWave_SWITCH_MULTILEVEL_4 power: 85.8 W
2014-09-27_13:45:55 ZWave_SWITCH_MULTILEVEL_4 off
2014-09-27_13:45:55 ZWave_SWITCH_MULTILEVEL_4 reportedState: off
2014-09-27_14:54:46 ZWave_SWITCH_MULTILEVEL_4 energy: 0.01 kWh

Log mit Parameter 3 auf 1 = Jalousie Positions Report wird als Fibaro Kommando an Primärcontroller gesendet.
2014-09-28_14:33:55 ZWave_SWITCH_MULTILEVEL_4 positionBlinds 15
2014-09-28_14:34:01 ZWave_SWITCH_MULTILEVEL_4 position: Blinds 15 Slat 25
2014-09-28_14:34:01 ZWave_SWITCH_MULTILEVEL_4 power: 0.0 W

== Links ==
* Hersteller-Anleitung: [http://www.fibaro.com/manuals/en/FGRM-222-Roller-Shutter/FGRM-222-Roller-Shutter-en-2.1-2.3.pdf PDF], englisch
* Zwaveeurope-Anleitung: [http://manuals.zwaveeurope.com/make.php?lang=de&type=&sku=FIB_FGRM-222 HTML], deutsch

[[Kategorie:Z-Wave Components]]
[[Kategorie:Rollladensteuerung]]
[[Kategorie:Energieverbrauchsmessung]]

Datei:Z-Wave-FIB FGRM-222.JPG

2015-08-10T16:54:28Z

Scooty:

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2015-06-30T10:28:20Z

Scooty: /* Sturmerkennung */

Der '''Funk-Kombi-Sensor OC3 (HM-WDS100-C6-O)''' ist eine [[HomeMatic]]Funk-Wetterstation für den Außeneinsatz zur Messung von Temperatur, relativer Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.

== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Schwankung der Windrichtung 0°/22,5°/45°/67,5°
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Sturm-Soforterkennung
* Helligkeit gemessen über Photodiode mit einheitenlosen Wert 1-255
* Sonnenschein-Dauer gezählt als Minuten oberhalb der Helligkeitsschwelle von 30 (Default)
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus

== Hinweise zum Betrieb mit Fhem ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

=== Konfiguration (fhem.cfg) ===
''Muss noch ergänzt werden''

=== Event-Monitor ===

Wetterstation T: 17.5 H: 82 W: 0 R: 553.715 IR: 0 WD: 10 WDR: 67.5 S: 106 B: 16
Wetterstation temperature: 17.5
Wetterstation humidity: 82
Wetterstation windSpeed: 0
Wetterstation windDirection: 10
Wetterstation windDirRange: 67.5
Wetterstation rain: 553.715
Wetterstation isRaining: 0
Wetterstation sunshine: 106

=== Parameterliste ===
'''list: register | range | peer | description'''
0: intKeyVisib | literal | | visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | pairing to central
1: stormLowThresh | 0 to 255 | | Storm lower threshold
1: stormUpThresh | 0 to 255 | | Storm upper threshold

=== Log-Einträge ===
''Muss noch ergänzt werden''

=== Anwendungsbeispiele ===
==== Anbindung an OpenWeathermap ====
Das hier verwendete "inoffizielle" 98_openweathermap.pm-Modul muss manuell aus dem [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib]-Verzeichnis des Fhem-SVN heruntergeladen und in das Modulverzeichnis der eigenen Fhem-Installation kopiert werden.

Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_myUtils anlegen (abgeleitet von einer Funktion zur [[Relative Mittelwerte berechnen und loggen|Mittelwertberechnung]]):

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
} </nowiki>

Danach in der fhem.cfg folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
} </nowiki>

Dann können die Werte mit dem 98_openweathermap.pm - Modul aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib] übertragen werden:
<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

==== Sturmerkennung ====
Die Sensor-interne Sturmerkennung hat den Vorteil, dass bei Über-/Unterschreiten von konfigurierbaren Schwellwerten sofort ein Event generiert wird bzw. ein gepeerter Aktor sofort getriggert wird und somit eine Sturmerkennung nicht nachgelagert über das Reading "windSpeed" erfolgen muss (der Sensor sendet seine Werte sonst nur ca. alle 2-3 Minuten).

Folgende Schritte zur Nutzung und Anpassung der internen Sturmerkennung sind durchzuführen:

1. Peeren des Kanal 1 des Sensors (WGEG_SENW) mit einem Aktor (VCCU_Chan03, in diesem Beispiel also der virtuelle Kanal 3 einer VCCU):

<nowiki>set WGEG_SENW peerChan 1 VCCU_Chan03 single set</nowiki>

Damit werden neben der Peerkonfiguration auch folgende Readings im Sensor-Device erzeugt

<nowiki>R-VCCU_Chan03-stormLowThresh 5
R-VCCU_Chan03-stormUpThresh 25</nowiki>

2. Diese Schwellwerte können nun mit z.B.

<nowiki>set WGEG_SENW regSet stormUpThresh 15 VCCU_Chan03</nowiki>

angepaßt werden (s. Commandref zu [http://fhem.de/commandref.html#CUL_HMregSet regSet]).

== Bekannte Probleme ==
Der Zähler sunshine läuft nach gut 4 Stunden über, an Sonnentagen läuft dieser Zähler u.U. sogar mehr als einmal über.

Fhem hat bislang (noch) nicht die Möglichkeit implementiert, die Mengenmessung zu justieren. In Einzelfällen sind im Werksauslieferungszustand konstante Messabweichungen von 10% beobachtet worden.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf Montage- und Bedienungsanleitung]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf Produktdatenblatt]
* [http://forum.fhem.de/index.php/topic,6106.msg24524.html#msg24524 Thread] im Forum

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]
[[Kategorie:Wetterstationen]]

HM-WDS100-C6-O Funk-Kombi-Sensor OC3

2015-06-25T19:56:19Z

Scooty: Sturmerkennung hinzugefügt

Der '''Funk-Kombi-Sensor OC3 (HM-WDS100-C6-O)''' ist eine [[HomeMatic]]Funk-Wetterstation für den Außeneinsatz zur Messung von Temperatur, relativer Luftfeuchte, Windrichtung, Windstärke, Regenmenge und Helligkeit.

== Features ==
* Batteriebetrieb (3 x Mignon/LR6/AA)
* Funkfrequenz 868,3 MHz
* Temperaturmessbereich -29,9°C bis 79,9°C (± 0,8°C)
* Relative Luftfeuchte 1 % bis 99 % (±5 %)
* Windgeschwindigkeit 1 km/h bis 199,9 km/h
* Windrichtungsmesser 0° bis 355° (±5°)
* Schwankung der Windrichtung 0°/22,5°/45°/67,5°
* Regenmengenmesser 0 mm bis 999 mm
* Regen-Soforterkennung
* Sturm-Soforterkennung
* Helligkeit gemessen über Photodiode mit einheitenlosen Wert 1-255
* Sonnenschein-Dauer gezählt als Minuten oberhalb der Helligkeitsschwelle von 30 (Default)
* Datenübermittlung alle 120 bis 180 Sekunden
* Übermittlung des Batteriestatus

== Hinweise zum Betrieb mit Fhem ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür muss die von außen erreichbare Anlerntaste betätigt werden.

=== Konfiguration (fhem.cfg) ===
''Muss noch ergänzt werden''

=== Event-Monitor ===

Wetterstation T: 17.5 H: 82 W: 0 R: 553.715 IR: 0 WD: 10 WDR: 67.5 S: 106 B: 16
Wetterstation temperature: 17.5
Wetterstation humidity: 82
Wetterstation windSpeed: 0
Wetterstation windDirection: 10
Wetterstation windDirRange: 67.5
Wetterstation rain: 553.715
Wetterstation isRaining: 0
Wetterstation sunshine: 106

=== Parameterliste ===
'''list: register | range | peer | description'''
0: intKeyVisib | literal | | visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | pairing to central
1: stormLowThresh | 0 to 255 | | Storm lower threshold
1: stormUpThresh | 0 to 255 | | Storm upper threshold

=== Log-Einträge ===
''Muss noch ergänzt werden''

=== Anwendungsbeispiele ===
==== Anbindung an OpenWeathermap ====
Das hier verwendete "inoffizielle" 98_openweathermap.pm-Modul muss manuell aus dem [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib]-Verzeichnis des Fhem-SVN heruntergeladen und in das Modulverzeichnis der eigenen Fhem-Installation kopiert werden.

Zunächst eine Funktion zur Berechnung der Differenz der gemessenen Regenmengen in 99_myUtils anlegen (abgeleitet von einer Funktion zur [[Relative Mittelwerte berechnen und loggen|Mittelwertberechnung]]):

<nowiki># myDiff
# berechnet die Differenz aus der ersten Zeile eines LogFiles und der letzten Zeile eines LogFiles über einen Zeitraum zwischen einem Zeitpunkt in der Vergangenheit und dem Zeitpunkt des Aufrufs
sub
myDiff($$$)
{
my ($offset,$logfile,$cspec) = @_;
my $period_s = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime(time-$offset);
my $period_e = strftime "%Y-%m-%d\x5f%H:%M:%S", localtime;
my $oll = $attr{global}{verbose};
$attr{global}{verbose} = 0;
my @logdata = split("\n", fhem("get $logfile - - $period_s $period_e $cspec"));
$attr{global}{verbose} = $oll;
my ($cnt, $first, $last, $diff) = (0)x4;
foreach (@logdata){
my @line = split(" ", $_);
if(defined $line[1] && "$line[1]" ne ""){
$cnt += 1;
if ($cnt == 1) {
$first = $line[1];
}
$last = $line[1];
}
}
$diff = $last - $first;
Log 4, ("myDiff: File: $logfile, Field: $cspec, Period: $period_s bis $period_e, First: $first, Last: $last, Diff: $diff");
return $diff;
} </nowiki>

Danach in der fhem.cfg folgendes hinzufügen (inklusive Umrechnung der Windmesswerte von km/h in m/s):

<nowiki>define RegenmengeOffset dummy
define RegenmengeTag dummy
define RegenmengeLast1Hours dummy
define RegenmengeLast3Hours dummy
define RegenmengeLast24Hours dummy
define WindSpeed_mps dummy

define RegenmengeNotify notify OC3:rain.* {\
my $menge = (ReadingsVal("OC3", "rain", 0) - ReadingsVal("RegenmengeOffset", "state", 0));;\
my $last1hours = myDiff("3600", "FileLog_OC3", "10:::");;\
my $last3hours = myDiff("10800", "FileLog_OC3", "10:::");;\
my $last24hours = myDiff("86400", "FileLog_OC3", "10:::");;\
fhem("set RegenmengeTag $menge");;\
fhem("set RegenmengeLast1Hours $last1hours");;\
fhem("set RegenmengeLast3Hours $last3hours");;\
fhem("set RegenmengeLast24Hours $last24hours");;\
}

define RegenmengeOffsetReset at *00:00:00 {\
my $offset = ReadingsVal("OC3", "rain", 0);;\
fhem("set RegenmengeOffset $offset");; \
}

define WindSpeedNotify notify OC3:windSpeed.* {\
my $windspeed = (ReadingsVal("OC3", "windSpeed", 0) / 3.6);;\
$windspeed = int(100 * $windspeed + 0.5) / 100;;\
fhem("set WindSpeed_mps $windspeed") \
} </nowiki>

Dann können die Werte mit dem 98_openweathermap.pm - Modul aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/ Contrib] übertragen werden:
<nowiki>...
attr owo owoSrc03 rain_today:RegenmengeTag:state
attr owo owoSrc04 wind_speed:WindSpeed_mps:state
attr owo owoSrc05 rain_1h:RegenmengeLast1Hours:state
attr owo owoSrc06 rain_24h:RegenmengeLast24Hours:state
...</nowiki>

==== Sturmerkennung ====
Die Sensor-interne Sturmerkennung hat den Vorteil, dass bei Über-/Unterschreiten von konfigurierbaren Schwellwerten sofort ein Event generiert wird bzw. ein gepeerter Aktor sofort getriggert wird und somit eine Sturmerkennung nicht nachgelagert über das Reading "windSpeed" erfolgen muss (der Sensor sendet seine Werte sonst nur ca. alle 2-3 Minuten).

Folgende Schritte zur Nutzung und Anpassung der internen Sturmerkennung sind durchzuführen:

1. Peeren des Kanal 1 des Sensors (WGEG_SENW) mit einem Aktor (VCCU_Chan03, in diesem Beispiel also der virtuelle Kanal 3 einer VCCU):

<nowiki>set <Wettersensor> peerChan 1 VCCU_Chan03 single set</nowiki>

Damit werden neben der Peerkonfiguration auch folgende Readings im Sensor-Device erzeugt

<nowiki>R-VCCU_Chan03-stormLowThresh 5
R-VCCU_Chan03-stormUpThresh 25</nowiki>

2. Diese Schwellwerte können nun mit z.B.

<nowiki>set WGEG_SENW regSet stormUpThresh 15 VCCU_Chan03</nowiki>

angepaßt werden (s. Commandref zu [http://fhem.de/commandref.html#CUL_HMregSet regSet]).

== Bekannte Probleme ==
Der Zähler sunshine läuft nach gut 4 Stunden über, an Sonnentagen läuft dieser Zähler u.U. sogar mehr als einmal über.

Fhem hat bislang (noch) nicht die Möglichkeit implementiert, die Mengenmessung zu justieren. In Einzelfällen sind im Werksauslieferungszustand konstante Messabweichungen von 10% beobachtet worden.

== Links ==
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-WDS100-C6-O_UM_G_eQ-3_090128.pdf Montage- und Bedienungsanleitung]
* [http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Kombisensor-OC-3_83346_Produktdatenblatt.pdf Produktdatenblatt]
* [http://forum.fhem.de/index.php/topic,6106.msg24524.html#msg24524 Thread] im Forum

[[Kategorie:HomeMatic Components]]
[[Kategorie:Feuchtesensoren]]
[[Kategorie:Temperatursensoren]]
[[Kategorie:Wetterstationen]]

WifiLight

2015-05-04T11:50:53Z

Scooty:

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=32_WifiLight.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}



FHEM Modul zum steuern diverser LED Leuchtmittel über WLAN wie Mi-Light, Limitless, IVY, sengled, LW12, LED Streifen, 2,4GHz E27 RGB Lampen ...

=== Basic Syntax ===
==== Definition ====
:<code>define <name> WifiLight <Leuchtmitteltyp> <bridgetyp>:<IP|FQDN></code>
''Für die Milight Typen die Gruppen unterstützen werden die Gruppen in der Reihenfolge der Definition automatisch erstellt.''

==== on / off ====
:<code>set <name> on|off</code>
''"on" schaltet weißes Licht mit 100% ein. (Ausnahme Milight/RGB(old) da dort kein weiß unterstützt wird: 100% rot)''

Erweiterte Parameter:
* ramp

==== dim ====
:<code>set <name> dim level</code>
''"dim" behält die aktuell gesetzte Farbe bei und so kann "dim 100" anstelle von "on" verwendet werden wenn die aktuelle Lichtfarbe beibehalten werden soll.''

erweiterte Parameter:
* ramp
* queue

==== HSV ====
:<code>set <name> HSV H,S,V</code>
''Farbangaben im Farbraum "HSV" sind vollständig und in der Regel intuitiver als RGB. H (HUE: 0..360) gibt die Grundfarbe in einem Farbkreis (Regenbogen) an. Rot liegt bei 0°, Grün bei 120° und blau bei 240°. S (Saturation/Sättigung: 0..100) steht für die Sättigung der Farbe. Eine Sättigung von 100 bedeutet die Farbe ist "rein" oder komplett gesättigt. Blau zum Beispiel mit 100% Sättigung entspricht RGB #0000FF. V (Value: 0..100) gibt die Helligkeit an. Ein V von 50 heist: "halbe Helligkeit"''

erweiterte Parameter:
* ramp
* queue
* direction
* event

==== RGB ====
:<code>set <name> RGB RRGGBB</code>
''RGB Angaben werden im 6 stelligen Hexadezimalen Format erwartet.''

erweiterte Parameter:
* ramp
* queue
* direction
* event

===== Unterschiede von Farbangaben HSV zu RGB =====
Angenommen das Ziel ist ein Farbverlauf Rot (ganz dunkel, Helligkeit 0) auf Blau sowie ein Farbverlauf von Grün (ebenfalls 0) auf Blau. Im RGB Farbraum starten beide Farbverläufe bei #000000 auf gehen dann auf #0000FF. Damit lassen sie sich nicht unterscheiden und anders als erwartet beginnt der Farbverlauf in beiden Fällen mit einem neutralen "Grau" (RGB #010101). Die entsprechende Beschreibung im HSV Farbraumraum ist hingegen eindeutig (120,100,0 -> 240,100,100 für GRÜN 0% auf BLAU 100%) und funktioniert wie erwartet.

==== Erweiterte Funktionen / Transitions ====
Das Modul unterstützt komplexe programmierbare Farbverläufe. Da diese im Modul berechnet werden hängt die flüssige Wiedergabe von einer ganzen Reihe von Faktoren ab:
* FHEM Host Hardware
* FHEM Auslastung und "Kooperation" von anderen Modulen
* verwendete Leuchtmittel
* Auslastung der ''Bridge''
Das Modul ist stark optimiert um die Farbverläufe flüssig wiedergeben zu können. Auf der anderen Seite reagiert das menschliche Auge sehr empfindlich. Deshalb sind gelegentliche "Sprünge" bei Farbverläufen unvermeidlich und sehr von der konkreten Umgebung abhängig.

== Unterstützte Wifi-Leuchtmittel ==

=== RGB LED (Streifen) am LW12 Wifi LED Controller ===

{{Randnotiz|RNTyp=Info|RNText=Achtung: Vom LW12 existieren mindestens zwei Ausführungen. Unterscheidbar am "eigenen" WLAN. LW12 spannt ein Netz mit der Bezeichnung "LEDNET..." auf. LW12 - HX001 spannt ein Netz mit der Bezeichnung "HX..." auf. Beide Typen werden unterstützt, müssen jedoch mit anderer Signatur definiert werden}}
[[Datei:LW12.JPG|mini|LW12 LED stripe WiFi Controller]]

Der LW12 vereint die LED Steuereinheit und den Wifi Empfänger. Zum Betrieb ist noch der LED Streifen mit gemeinsamer Anode sowie ein in Spannung und Leistung zum LED Streifen passendes Netzteil erforderlich. Alle Anschlüsse am Controller sind als Schraubklemmen ausgeführt.

==== Alternative Bezeichnungen ====
* WF200 Controller

Der Controller erstellt im Werkszustand ein WLAN mit eigener SSID und wird über die vom Hersteller gelieferte Smartphone App in das eigene Netzwerk eingebunden.
* Android Version im Google PlayStore [https://play.google.com/store/apps/details?id=com.Zengge.LEDWifiMagicColor&hl=de LED Magic Color Controller v2]
* Apple Version im Apple App-Store [https://itunes.apple.com/de/app/led-magic-color/id595148649?mt=8 LED Magic Color]

Die Definition erfolgt im Modul so:

LW12 (eigene SSID "LEDNET..."):
:<code>define <name> WifiLight RGB LW12:<IP|FQDN></code>
LW12 (eigene SSID "HX..."):
:<code>define <name> WifiLight RGB LW12HX:<IP|FQDN></code>

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils nur einen LED RGB Streifen.

Der LW12 erzeugt weißes Licht durch RGB Farbmischung und unterstützt beliebige Sättigungen sowie Helligkeiten. <strike>Deshalb und wegen seiner hohen Aktualisierungsrate, ist er für reine RGB Streifen die erste Wahl.</strike> Mittlerweile ist der (bessere) LD382 vom gleichen Hersteller verfügbar.

Zum Betrieb sind der LW12, ein RGB LED Streifen sowie passendes Netzteil (Klemmschrauben) erforderlich.

==== Bezug ====

* Zum Zeitpunkt der Erstellung dieses Artikels ist der LW12 bei eBay von diversen Händlern ab ca 30,- Euro erhältlich.
* [http://www.amazon.de/NEUER-STRIPS-CONTROLLER-iPhone-Android/dp/B00G55329A/ref=sr_1_1?ie=UTF8&qid=1390006342&sr=8-1&keywords=lw12+led LW12 RGB LED Stripecontroller Amazon]

=== RGB und RGBW LED (Streifen) am LD382 Wifi LED Controller ===

Der LD382 vereint die LED Steuereinheit und den Wifi Empfänger. Am LD382 können reine RGB Streifen, RGBW Streifen oder eine Kombination beider angeschlossen werden. Zum Betrieb ist noch der LED Streifen mit gemeinsamer Anode sowie ein in Spannung und Leistung zum LED Streifen passendes Netzteil erforderlich. Alle Anschlüsse am Controller sind als Schraubklemmen ausgeführt, das Netzteil verfügt zusätzlich über einen Steckeranschluss.

Der LD382 verfügt über einen WPS Button, kann also per "one-click" ins Netzwerk genommen werden.

==== Alternative Bezeichnungen ====
* LED Magic UFO (XCSOURCE)

Die Definition erfolgt im Modul so:

LD382 mit RGB Streifen (Weiß wird gemischt)
:<code>define <name> WifiLight RGB LD382:<IP|FQDN></code>
LD382 mit RGBW Streifen (oder Kombination aus RGB und separatem Weiß)
:<code>define <name> WifiLight RGBW LD382:<IP|FQDN></code>

=== RGBW LD316 LED-Lampe Wifi ===

Der LD316 vereint LED-Lampe (Fassung E27), Steuereinheit und Wifi Empfänger. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App (sh. LW12) kann LD316 gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen über den in LD316 vorhandenen Webserver möglich (Benutzer: admin, Kennwort: nimda).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight RGBW LD316:<IP|FQDN></code>

=== sengled Boost LED-Lampe Wifi ===
<gallery>
Sengled Boost.JPG|sengled Boost
</gallery>
Die sengled Boost vereint eine Weiß-LED-Lampe (Fassung E27), Wifi Empfänger und Steuereinheit und bietet eine Wifi Repeater Funktion. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App ("sengled Boost" unter [http://forum.fhem.de/index.php/topic,36811.0.html Android] oder [https://itunes.apple.com/de/app/sengled-boost/id848792893?mt=8 iOS]) kann die sengled Boost gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen (besonders zur Wifi Repeater Funktion) über den in der sengled Boost vorhandenen Webserver möglich (Benutzer: admin, Kennwort: admin).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight White SENGLED:<IP|FQDN></code>

Weitere Informationen können im entsprechenden {{Link2Forum|Topic=36811|LinkText=Forumsthema}} nachgelesen werden.

=== Milight Systeme für LED Streifen und E27 Leuchtmittel ===

Milight Leuchtmittel sind von diversen Herstellern unter diversen Handelsnamen erhältlich. Verfügbar sind preiswerte Ansteuerungen (RGB, RGB oder Weiß, RGB und Weiß, Warm- und Kaltweiß) für LED Streifen, Downlights sowie E27 Leuchtmittel. Die E27 Leuchtmittel haben den Empfänger integriert und können direkt in vorhandenen Fassungen eingesetzt werden.

Die Lampen / Controller sprechen ein proprietäres 2,4GHz Protokoll. Zur Ansteuerung mit fhem wird eine zusätzliche bridge benötigt.

==== Alternative Bezeichnungen ====
* Rocket LED
* Limitless LED
* Easybulb
* s`luce iLight
* iBulb
* Kreuzer
* ...

==== Milight WiFi bridge ====
aktuell sind vier bridge Versionen erschienen (v1 .. v4) wobei die v1 praktisch nicht mehr erhältlich ist und nicht unterstützt wird. Der bridge erstellen im Werkszustand ein WLAN mit eigener SSID und werden über eine Smartphone App in das eigene Netzwerk eingebunden. Zum Betrieb ist ein 5V USB Netzteil erforderlich. Ein Betrieb an den USB Ports des Host ist möglich, wegen eventueller Energiemanagement Funktionen des Host jedoch nicht empfohlen.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

===== Milight bridge v2 =====

Die v2 bridge hört auf UDP Port 50000 und ist typischerweise am blauen Etikett erkennbar. Eine v2 bridge kann ansteuern:
* ein RGB Leuchtmittel
ODER
* ein RGBW1 Leuchtmittel
UND
* vier Gruppen Warmwhite/Coldwhite (White)

===== Milight bridge v3 =====

Die v3 bridge hört auf UDP Port 8899 und hat typischerweise ein dunkles Etikett. Eine v3 bridge kann ansteuern:
* ein RGB Leuchtmittel
ODER
* ein RGBW1 Leuchtmittel

UND

* vier Gruppen Warmwhite/Coldwhite (White)
UND
* vier Gruppen RGB + White (RGBW2)

===== Milight bridge v4 =====

Die Funktionen der v4 entsprechen im wesentlichen der v3, allerdings ist das WLAN Modul ein anderes (Draft-N) und das Web Interface wurde entfernt.

==== Leuchtmittel ====

===== Milight Leuchtmitteltyp RGB =====

E27, LED Streifen Controller oder Downlight.

Dieser Typ RGB Leuchtmittel ist veraltet und von Neuanschaffungen wird abgeraten. Die Ansteuerung ist nur im Farbkreis möglich (keine volle RGB Mischung, keine Sättigung, kein Weiß). Das Protokoll zur Ansteuerung dieses Typ ist fehleranfällig und sehr langsam. Eine parallele Benutzung der FB oder der App verursacht ebenfalls Fehler.

Benötigt eine bridge ab v2.
<gallery>
Milight-RGB-Stripe.jpg|Milight RGB LED stripe Controller mit FB
Milight-RGB-e27.JPG|Milight RGB e27 mit FB
Milight-RGB-downlight.JPG|s'luce RGB Downlight
</gallery>

===== Milight Leuchtmitteltyp RGBW1 =====

LED Streifen Controller. (RGB mit separatem Weiß Kanal)

Dieser Typ RGB Leuchtmittel ist veraltet.

FHEM kann mit diesem Controller Farbe, Helligkeit und Sättigung komplett steuern. Durch den extra Weißkanal sind sehr angenehme Farbmischungen möglich allerdings ist das verwendete Protokoll wie beim RGB langsam und fehleranfällig. Daher eignet sich der Controller nicht für häufige dynamische Farbwechsel und nur bedingt für unbeaufsichtigten / automatischen Betrieb.

Die Sättigung wird durch die Balance des Weiß- und des Farbkanals erreicht. Bei einer Sättigung von 50% werden Weiß und Farbe jeweils voll angesteuert.

Benötigt eine bridge ab v2.
<gallery>
Milight-RGBW1.JPG|Milight RGBW LED stripe Controller mit FB
</gallery>

===== Milight Leuchtmitteltyp White =====

E27, LED Streifen Controller oder Downlight.

Pur weiße LED Leuchtmittel mit Unterstützung der Farbtemperatur (Kaltweiß/Warmweiß).

FHEM steuert die Helligkeit der Leuchtmittel. Ein Unterstützung der Farbtemperatur (Weiß Kelvin) ist noch nicht implementiert. Die Farbtemperatur sollte initial über die app eingestellt werden und wird von den Leuchtmitteln beibehalten. Die e27 Lampen sind zum Zeitpunkt der Erstellung dieses Artikels (04/14) ab etwa 11,- Euro bei eBay verfügbar. Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel). Die Lichtausbeute ist sehr gut.

Benötigt eine bridge ab v2. Eine bridge kann vier getrennte Gruppen White ansteuern. Wenn mehr als vier Gruppen eingesetzt werden sollen können weitere bridge eingebunden werden.
<gallery>
Milight-WWCW-FB.JPG|Milght Warmweiß/kaltweiß LED Streifen controller mit FB
Milight-E27-WWCW-OEM.JPG|Milight Warmweiß/kaltweiß 6 Watt E27 OEM
Milight-E27-WWCW-9W.JPG|Milight Warmweiß/kaltweiß 9 Watt E27
Milight-Downlight-WWCW.JPG|Milight Warmweiß/kaltweiß Downlight (IWY STAR 6 Watt)
</gallery>

===== Milight Leuchtmitteltyp RGBW2 =====

E27, LED Streifen Controller oder Downlight.

Aktuelle Typen mit neuem und robusterem Protokoll.

Dieser Typ Leuchtmittel gibt farbiges oder weißes Licht. Die Sättigung ist nicht stufenlos sondern 0% oder 100%. Die E27 Typen sind dabei wahlweise mit Warm- oder Kaltweiß bestellbar.

Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel).

Benötigt eine bridge ab v3. Eine bridge kann vier getrennte Gruppen RGBW2 ansteuern. Mehr als vier Gruppen können mit zusätzlichen bridge verwendet werden.

Die Sättigung wird wie folgt umgesetzt: S: 0..20 => 0% / S: 21..100 => 100%.

''Bei Farbverläufen (Sonnenaufgang) die bei einer Farbe beginnen und bei Weiß enden kann es sinnvoll sein in zwei Schritten zuerst auf 100% Gelb zu faden, dort auf 20%..40% Weiß (typenabhängig) umzuschalten und dann Weiß weiter auf 100% zu dimmen.''
<gallery>
Milight-rgbw2-LED.jpg|Milight RGB/Weiß LED Streifen Controller 4 Zonen
Milight-E27-RGBW2-OEM.JPG|Milight RGB/Weiß 6 Watt E27 OEM
Milight-E27-RGBW2-9Watt.JPG|Milight RGB/Weiß 9 Watt E27 mit FB
</gallery>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=Achtung: Das modul ist nicht Bestandteil der fhem Standardinstallation weil der dev lieber die Unterstützung neuer Controller einbaut anstelle die Doku zu schreiben :)}}
Das Modul wird bequem so installiert:
<code>update force https://raw.githubusercontent.com/herrmannj/wifilight/master/controls_wifilight.txt</code>

== Color-Picker aktivieren ==
Um den sog. "Color-Picker" zu aktivieren müssen die beiden folgenden Attribute gesetzt werden:
<pre>
attr <name> webCmd RGB
attr <name> widgetOverride RGB:colorpicker,RGB
</pre>
<gallery>
Wifiled_colorpicker.png|Colorpicker Beispiel
</gallery>

Weitere Informationen unter [http://www.fhemwiki.de/wiki/Color Color Wiki Artikel]

== Farbiges Icon ==
Weiterhin kann das Lampen-Icon auch farbig dargestellt werden. Dazu ist es erforderlich, das folgende Attribut zu setzen:
<pre>
attr <name> devStateIcon {Color_devStateIcon(ReadingsVal($name,"RGB","000000"))}
</pre>

== Links ==
* Thread über das Modul im [http://forum.fhem.de/index.php/topic,18958.0.html Fhem Forum]
* [http://www.ledsee.com/datasheet_ledsee/LED%20WiFi%20controller%20for%20home%20use_Hontech-wins__-EN.pdf LW12 Datasheet]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Code Snippets]]

WifiLight

2015-05-03T16:48:38Z

Scooty: Link zum Forumsthema sengled angepaßt

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=32_WifiLight.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}



FHEM Modul zum steuern diverser LED Leuchtmittel über WLAN wie Mi-Light, Limitless, IVY, LW12, LED Streifen, 2,4GHz E27 RGB Lampen ...

=== Basic Syntax ===
==== Definition ====
:<code>define <name> WifiLight <Leuchtmitteltyp> <bridgetyp>:<IP|FQDN></code>
''Für die Milight Typen die Gruppen unterstützen werden die Gruppen in der Reihenfolge der Definition automatisch erstellt.''

==== on / off ====
:<code>set <name> on|off</code>
''"on" schaltet weißes Licht mit 100% ein. (Ausnahme Milight/RGB(old) da dort kein weiß unterstützt wird: 100% rot)''

Erweiterte Parameter:
* ramp

==== dim ====
:<code>set <name> dim level</code>
''"dim" behält die aktuell gesetzte Farbe bei und so kann "dim 100" anstelle von "on" verwendet werden wenn die aktuelle Lichtfarbe beibehalten werden soll.''

erweiterte Parameter:
* ramp
* queue

==== HSV ====
:<code>set <name> HSV H,S,V</code>
''Farbangaben im Farbraum "HSV" sind vollständig und in der Regel intuitiver als RGB. H (HUE: 0..360) gibt die Grundfarbe in einem Farbkreis (Regenbogen) an. Rot liegt bei 0°, Grün bei 120° und blau bei 240°. S (Saturation/Sättigung: 0..100) steht für die Sättigung der Farbe. Eine Sättigung von 100 bedeutet die Farbe ist "rein" oder komplett gesättigt. Blau zum Beispiel mit 100% Sättigung entspricht RGB #0000FF. V (Value: 0..100) gibt die Helligkeit an. Ein V von 50 heist: "halbe Helligkeit"''

erweiterte Parameter:
* ramp
* queue
* direction
* event

==== RGB ====
:<code>set <name> RGB RRGGBB</code>
''RGB Angaben werden im 6 stelligen Hexadezimalen Format erwartet.''

erweiterte Parameter:
* ramp
* queue
* direction
* event

===== Unterschiede von Farbangaben HSV zu RGB =====
Angenommen das Ziel ist ein Farbverlauf Rot (ganz dunkel, Helligkeit 0) auf Blau sowie ein Farbverlauf von Grün (ebenfalls 0) auf Blau. Im RGB Farbraum starten beide Farbverläufe bei #000000 auf gehen dann auf #0000FF. Damit lassen sie sich nicht unterscheiden und anders als erwartet beginnt der Farbverlauf in beiden Fällen mit einem neutralen "Grau" (RGB #010101). Die entsprechende Beschreibung im HSV Farbraumraum ist hingegen eindeutig (120,100,0 -> 240,100,100 für GRÜN 0% auf BLAU 100%) und funktioniert wie erwartet.

==== Erweiterte Funktionen / Transitions ====
Das Modul unterstützt komplexe programmierbare Farbverläufe. Da diese im Modul berechnet werden hängt die flüssige Wiedergabe von einer ganzen Reihe von Faktoren ab:
* FHEM Host Hardware
* FHEM Auslastung und "Kooperation" von anderen Modulen
* verwendete Leuchtmittel
* Auslastung der ''Bridge''
Das Modul ist stark optimiert um die Farbverläufe flüssig wiedergeben zu können. Auf der anderen Seite reagiert das menschliche Auge sehr empfindlich. Deshalb sind gelegentliche "Sprünge" bei Farbverläufen unvermeidlich und sehr von der konkreten Umgebung abhängig.

== Unterstützte Wifi-Leuchtmittel ==

=== RGB LED (Streifen) am LW12 Wifi LED Controller ===

{{Randnotiz|RNTyp=Info|RNText=Achtung: Vom LW12 existieren mindestens zwei Ausführungen. Unterscheidbar am "eigenen" WLAN. LW12 spannt ein Netz mit der Bezeichnung "LEDNET..." auf. LW12 - HX001 spannt ein Netz mit der Bezeichnung "HX..." auf. Beide Typen werden unterstützt, müssen jedoch mit anderer Signatur definiert werden}}
[[Datei:LW12.JPG|mini|LW12 LED stripe WiFi Controller]]

Der LW12 vereint die LED Steuereinheit und den Wifi Empfänger. Zum Betrieb ist noch der LED Streifen mit gemeinsamer Anode sowie ein in Spannung und Leistung zum LED Streifen passendes Netzteil erforderlich. Alle Anschlüsse am Controller sind als Schraubklemmen ausgeführt.

==== Alternative Bezeichnungen ====
* WF200 Controller

Der Controller erstellt im Werkszustand ein WLAN mit eigener SSID und wird über die vom Hersteller gelieferte Smartphone App in das eigene Netzwerk eingebunden.
* Android Version im Google PlayStore [https://play.google.com/store/apps/details?id=com.Zengge.LEDWifiMagicColor&hl=de LED Magic Color Controller v2]
* Apple Version im Apple App-Store [https://itunes.apple.com/de/app/led-magic-color/id595148649?mt=8 LED Magic Color]

Die Definition erfolgt im Modul so:

LW12 (eigene SSID "LEDNET..."):
:<code>define <name> WifiLight RGB LW12:<IP|FQDN></code>
LW12 (eigene SSID "HX..."):
:<code>define <name> WifiLight RGB LW12HX:<IP|FQDN></code>

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils nur einen LED RGB Streifen.

Der LW12 erzeugt weißes Licht durch RGB Farbmischung und unterstützt beliebige Sättigungen sowie Helligkeiten. <strike>Deshalb und wegen seiner hohen Aktualisierungsrate, ist er für reine RGB Streifen die erste Wahl.</strike> Mittlerweile ist der (bessere) LD382 vom gleichen Hersteller verfügbar.

Zum Betrieb sind der LW12, ein RGB LED Streifen sowie passendes Netzteil (Klemmschrauben) erforderlich.

==== Bezug ====

* Zum Zeitpunkt der Erstellung dieses Artikels ist der LW12 bei eBay von diversen Händlern ab ca 30,- Euro erhältlich.
* [http://www.amazon.de/NEUER-STRIPS-CONTROLLER-iPhone-Android/dp/B00G55329A/ref=sr_1_1?ie=UTF8&qid=1390006342&sr=8-1&keywords=lw12+led LW12 RGB LED Stripecontroller Amazon]

=== RGB und RGBW LED (Streifen) am LD382 Wifi LED Controller ===

Der LD382 vereint die LED Steuereinheit und den Wifi Empfänger. Am LD382 können reine RGB Streifen, RGBW Streifen oder eine Kombination beider angeschlossen werden. Zum Betrieb ist noch der LED Streifen mit gemeinsamer Anode sowie ein in Spannung und Leistung zum LED Streifen passendes Netzteil erforderlich. Alle Anschlüsse am Controller sind als Schraubklemmen ausgeführt, das Netzteil verfügt zusätzlich über einen Steckeranschluss.

Der LD382 verfügt über einen WPS Button, kann also per "one-click" ins Netzwerk genommen werden.

==== Alternative Bezeichnungen ====
* LED Magic UFO (XCSOURCE)

Die Definition erfolgt im Modul so:

LD382 mit RGB Streifen (Weiß wird gemischt)
:<code>define <name> WifiLight RGB LD382:<IP|FQDN></code>
LD382 mit RGBW Streifen (oder Kombination aus RGB und separatem Weiß)
:<code>define <name> WifiLight RGBW LD382:<IP|FQDN></code>

=== RGBW LD316 LED-Lampe Wifi ===

Der LD316 vereint LED-Lampe (Fassung E27), Steuereinheit und Wifi Empfänger. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App (sh. LW12) kann LD316 gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen über den in LD316 vorhandenen Webserver möglich (Benutzer: admin, Kennwort: nimda).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight RGBW LD316:<IP|FQDN></code>

=== sengled Boost LED-Lampe Wifi ===
<gallery>
Sengled Boost.JPG|sengled Boost
</gallery>
Die sengled Boost vereint eine Weiß-LED-Lampe (Fassung E27), Wifi Empfänger und Steuereinheit und bietet eine Wifi Repeater Funktion. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App ("sengled Boost" unter [http://forum.fhem.de/index.php/topic,36811.0.html Android] oder [https://itunes.apple.com/de/app/sengled-boost/id848792893?mt=8 iOS]) kann die sengled Boost gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen (besonders zur Wifi Repeater Funktion) über den in der sengled Boost vorhandenen Webserver möglich (Benutzer: admin, Kennwort: admin).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight White SENGLED:<IP|FQDN></code>

Weitere Informationen können im entsprechenden {{Link2Forum|Topic=36811|LinkText=Forumsthema}} nachgelesen werden.

=== Milight Systeme für LED Streifen und E27 Leuchtmittel ===

Milight Leuchtmittel sind von diversen Herstellern unter diversen Handelsnamen erhältlich. Verfügbar sind preiswerte Ansteuerungen (RGB, RGB oder Weiß, RGB und Weiß, Warm- und Kaltweiß) für LED Streifen, Downlights sowie E27 Leuchtmittel. Die E27 Leuchtmittel haben den Empfänger integriert und können direkt in vorhandenen Fassungen eingesetzt werden.

Die Lampen / Controller sprechen ein proprietäres 2,4GHz Protokoll. Zur Ansteuerung mit fhem wird eine zusätzliche bridge benötigt.

==== Alternative Bezeichnungen ====
* Rocket LED
* Limitless LED
* Easybulb
* s`luce iLight
* iBulb
* Kreuzer
* ...

==== Milight WiFi bridge ====
aktuell sind vier bridge Versionen erschienen (v1 .. v4) wobei die v1 praktisch nicht mehr erhältlich ist und nicht unterstützt wird. Der bridge erstellen im Werkszustand ein WLAN mit eigener SSID und werden über eine Smartphone App in das eigene Netzwerk eingebunden. Zum Betrieb ist ein 5V USB Netzteil erforderlich. Ein Betrieb an den USB Ports des Host ist möglich, wegen eventueller Energiemanagement Funktionen des Host jedoch nicht empfohlen.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

===== Milight bridge v2 =====

Die v2 bridge hört auf UDP Port 50000 und ist typischerweise am blauen Etikett erkennbar. Eine v2 bridge kann ansteuern:
* ein RGB Leuchtmittel
ODER
* ein RGBW1 Leuchtmittel
UND
* vier Gruppen Warmwhite/Coldwhite (White)

===== Milight bridge v3 =====

Die v3 bridge hört auf UDP Port 8899 und hat typischerweise ein dunkles Etikett. Eine v3 bridge kann ansteuern:
* ein RGB Leuchtmittel
ODER
* ein RGBW1 Leuchtmittel

UND

* vier Gruppen Warmwhite/Coldwhite (White)
UND
* vier Gruppen RGB + White (RGBW2)

===== Milight bridge v4 =====

Die Funktionen der v4 entsprechen im wesentlichen der v3, allerdings ist das WLAN Modul ein anderes (Draft-N) und das Web Interface wurde entfernt.

==== Leuchtmittel ====

===== Milight Leuchtmitteltyp RGB =====

E27, LED Streifen Controller oder Downlight.

Dieser Typ RGB Leuchtmittel ist veraltet und von Neuanschaffungen wird abgeraten. Die Ansteuerung ist nur im Farbkreis möglich (keine volle RGB Mischung, keine Sättigung, kein Weiß). Das Protokoll zur Ansteuerung dieses Typ ist fehleranfällig und sehr langsam. Eine parallele Benutzung der FB oder der App verursacht ebenfalls Fehler.

Benötigt eine bridge ab v2.
<gallery>
Milight-RGB-Stripe.jpg|Milight RGB LED stripe Controller mit FB
Milight-RGB-e27.JPG|Milight RGB e27 mit FB
Milight-RGB-downlight.JPG|s'luce RGB Downlight
</gallery>

===== Milight Leuchtmitteltyp RGBW1 =====

LED Streifen Controller. (RGB mit separatem Weiß Kanal)

Dieser Typ RGB Leuchtmittel ist veraltet.

FHEM kann mit diesem Controller Farbe, Helligkeit und Sättigung komplett steuern. Durch den extra Weißkanal sind sehr angenehme Farbmischungen möglich allerdings ist das verwendete Protokoll wie beim RGB langsam und fehleranfällig. Daher eignet sich der Controller nicht für häufige dynamische Farbwechsel und nur bedingt für unbeaufsichtigten / automatischen Betrieb.

Die Sättigung wird durch die Balance des Weiß- und des Farbkanals erreicht. Bei einer Sättigung von 50% werden Weiß und Farbe jeweils voll angesteuert.

Benötigt eine bridge ab v2.
<gallery>
Milight-RGBW1.JPG|Milight RGBW LED stripe Controller mit FB
</gallery>

===== Milight Leuchtmitteltyp White =====

E27, LED Streifen Controller oder Downlight.

Pur weiße LED Leuchtmittel mit Unterstützung der Farbtemperatur (Kaltweiß/Warmweiß).

FHEM steuert die Helligkeit der Leuchtmittel. Ein Unterstützung der Farbtemperatur (Weiß Kelvin) ist noch nicht implementiert. Die Farbtemperatur sollte initial über die app eingestellt werden und wird von den Leuchtmitteln beibehalten. Die e27 Lampen sind zum Zeitpunkt der Erstellung dieses Artikels (04/14) ab etwa 11,- Euro bei eBay verfügbar. Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel). Die Lichtausbeute ist sehr gut.

Benötigt eine bridge ab v2. Eine bridge kann vier getrennte Gruppen White ansteuern. Wenn mehr als vier Gruppen eingesetzt werden sollen können weitere bridge eingebunden werden.
<gallery>
Milight-WWCW-FB.JPG|Milght Warmweiß/kaltweiß LED Streifen controller mit FB
Milight-E27-WWCW-OEM.JPG|Milight Warmweiß/kaltweiß 6 Watt E27 OEM
Milight-E27-WWCW-9W.JPG|Milight Warmweiß/kaltweiß 9 Watt E27
Milight-Downlight-WWCW.JPG|Milight Warmweiß/kaltweiß Downlight (IWY STAR 6 Watt)
</gallery>

===== Milight Leuchtmitteltyp RGBW2 =====

E27, LED Streifen Controller oder Downlight.

Aktuelle Typen mit neuem und robusterem Protokoll.

Dieser Typ Leuchtmittel gibt farbiges oder weißes Licht. Die Sättigung ist nicht stufenlos sondern 0% oder 100%. Die E27 Typen sind dabei wahlweise mit Warm- oder Kaltweiß bestellbar.

Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel).

Benötigt eine bridge ab v3. Eine bridge kann vier getrennte Gruppen RGBW2 ansteuern. Mehr als vier Gruppen können mit zusätzlichen bridge verwendet werden.

Die Sättigung wird wie folgt umgesetzt: S: 0..20 => 0% / S: 21..100 => 100%.

''Bei Farbverläufen (Sonnenaufgang) die bei einer Farbe beginnen und bei Weiß enden kann es sinnvoll sein in zwei Schritten zuerst auf 100% Gelb zu faden, dort auf 20%..40% Weiß (typenabhängig) umzuschalten und dann Weiß weiter auf 100% zu dimmen.''
<gallery>
Milight-rgbw2-LED.jpg|Milight RGB/Weiß LED Streifen Controller 4 Zonen
Milight-E27-RGBW2-OEM.JPG|Milight RGB/Weiß 6 Watt E27 OEM
Milight-E27-RGBW2-9Watt.JPG|Milight RGB/Weiß 9 Watt E27 mit FB
</gallery>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=Achtung: Das modul ist nicht Bestandteil der fhem Standardinstallation weil der dev lieber die Unterstützung neuer Controller einbaut anstelle die Doku zu schreiben :)}}
Das Modul wird bequem so installiert:
<code>update force https://raw.githubusercontent.com/herrmannj/wifilight/master/controls_wifilight.txt</code>

== Color-Picker aktivieren ==
Um den sog. "Color-Picker" zu aktivieren müssen die beiden folgenden Attribute gesetzt werden:
<pre>
attr <name> webCmd RGB
attr <name> widgetOverride RGB:colorpicker,RGB
</pre>
<gallery>
Wifiled_colorpicker.png|Colorpicker Beispiel
</gallery>

Weitere Informationen unter [http://www.fhemwiki.de/wiki/Color Color Wiki Artikel]

== Farbiges Icon ==
Weiterhin kann das Lampen-Icon auch farbig dargestellt werden. Dazu ist es erforderlich, das folgende Attribut zu setzen:
<pre>
attr <name> devStateIcon {Color_devStateIcon(ReadingsVal($name,"RGB","000000"))}
</pre>

== Links ==
* Thread über das Modul im [http://forum.fhem.de/index.php/topic,18958.0.html Fhem Forum]
* [http://www.ledsee.com/datasheet_ledsee/LED%20WiFi%20controller%20for%20home%20use_Hontech-wins__-EN.pdf LW12 Datasheet]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Code Snippets]]

WifiLight

2015-05-03T15:48:45Z

Scooty: Foto sengled Boost

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=32_WifiLight.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}



FHEM Modul zum steuern diverser LED Leuchtmittel über WLAN wie Mi-Light, Limitless, IVY, LW12, LED Streifen, 2,4GHz E27 RGB Lampen ...

=== Basic Syntax ===
==== Definition ====
:<code>define <name> WifiLight <Leuchtmitteltyp> <bridgetyp>:<IP|FQDN></code>
''Für die Milight Typen die Gruppen unterstützen werden die Gruppen in der Reihenfolge der Definition automatisch erstellt.''

==== on / off ====
:<code>set <name> on|off</code>
''"on" schaltet weißes Licht mit 100% ein. (Ausnahme Milight/RGB(old) da dort kein weiß unterstützt wird: 100% rot)''

Erweiterte Parameter:
* ramp

==== dim ====
:<code>set <name> dim level</code>
''"dim" behält die aktuell gesetzte Farbe bei und so kann "dim 100" anstelle von "on" verwendet werden wenn die aktuelle Lichtfarbe beibehalten werden soll.''

erweiterte Parameter:
* ramp
* queue

==== HSV ====
:<code>set <name> HSV H,S,V</code>
''Farbangaben im Farbraum "HSV" sind vollständig und in der Regel intuitiver als RGB. H (HUE: 0..360) gibt die Grundfarbe in einem Farbkreis (Regenbogen) an. Rot liegt bei 0°, Grün bei 120° und blau bei 240°. S (Saturation/Sättigung: 0..100) steht für die Sättigung der Farbe. Eine Sättigung von 100 bedeutet die Farbe ist "rein" oder komplett gesättigt. Blau zum Beispiel mit 100% Sättigung entspricht RGB #0000FF. V (Value: 0..100) gibt die Helligkeit an. Ein V von 50 heist: "halbe Helligkeit"''

erweiterte Parameter:
* ramp
* queue
* direction
* event

==== RGB ====
:<code>set <name> RGB RRGGBB</code>
''RGB Angaben werden im 6 stelligen Hexadezimalen Format erwartet.''

erweiterte Parameter:
* ramp
* queue
* direction
* event

===== Unterschiede von Farbangaben HSV zu RGB =====
Angenommen das Ziel ist ein Farbverlauf Rot (ganz dunkel, Helligkeit 0) auf Blau sowie ein Farbverlauf von Grün (ebenfalls 0) auf Blau. Im RGB Farbraum starten beide Farbverläufe bei #000000 auf gehen dann auf #0000FF. Damit lassen sie sich nicht unterscheiden und anders als erwartet beginnt der Farbverlauf in beiden Fällen mit einem neutralen "Grau" (RGB #010101). Die entsprechende Beschreibung im HSV Farbraumraum ist hingegen eindeutig (120,100,0 -> 240,100,100 für GRÜN 0% auf BLAU 100%) und funktioniert wie erwartet.

==== Erweiterte Funktionen / Transitions ====
Das Modul unterstützt komplexe programmierbare Farbverläufe. Da diese im Modul berechnet werden hängt die flüssige Wiedergabe von einer ganzen Reihe von Faktoren ab:
* FHEM Host Hardware
* FHEM Auslastung und "Kooperation" von anderen Modulen
* verwendete Leuchtmittel
* Auslastung der ''Bridge''
Das Modul ist stark optimiert um die Farbverläufe flüssig wiedergeben zu können. Auf der anderen Seite reagiert das menschliche Auge sehr empfindlich. Deshalb sind gelegentliche "Sprünge" bei Farbverläufen unvermeidlich und sehr von der konkreten Umgebung abhängig.

== Unterstützte Wifi-Leuchtmittel ==

=== RGB LED (Streifen) am LW12 Wifi LED Controller ===

{{Randnotiz|RNTyp=Info|RNText=Achtung: Vom LW12 existieren mindestens zwei Ausführungen. Unterscheidbar am "eigenen" WLAN. LW12 spannt ein Netz mit der Bezeichnung "LEDNET..." auf. LW12 - HX001 spannt ein Netz mit der Bezeichnung "HX..." auf. Beide Typen werden unterstützt, müssen jedoch mit anderer Signatur definiert werden}}
[[Datei:LW12.JPG|mini|LW12 LED stripe WiFi Controller]]

Der LW12 vereint die LED Steuereinheit und den Wifi Empfänger. Zum Betrieb ist noch der LED Streifen mit gemeinsamer Anode sowie ein in Spannung und Leistung zum LED Streifen passendes Netzteil erforderlich. Alle Anschlüsse am Controller sind als Schraubklemmen ausgeführt.

==== Alternative Bezeichnungen ====
* WF200 Controller

Der Controller erstellt im Werkszustand ein WLAN mit eigener SSID und wird über die vom Hersteller gelieferte Smartphone App in das eigene Netzwerk eingebunden.
* Android Version im Google PlayStore [https://play.google.com/store/apps/details?id=com.Zengge.LEDWifiMagicColor&hl=de LED Magic Color Controller v2]
* Apple Version im Apple App-Store [https://itunes.apple.com/de/app/led-magic-color/id595148649?mt=8 LED Magic Color]

Die Definition erfolgt im Modul so:

LW12 (eigene SSID "LEDNET..."):
:<code>define <name> WifiLight RGB LW12:<IP|FQDN></code>
LW12 (eigene SSID "HX..."):
:<code>define <name> WifiLight RGB LW12HX:<IP|FQDN></code>

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils nur einen LED RGB Streifen.

Der LW12 erzeugt weißes Licht durch RGB Farbmischung und unterstützt beliebige Sättigungen sowie Helligkeiten. <strike>Deshalb und wegen seiner hohen Aktualisierungsrate, ist er für reine RGB Streifen die erste Wahl.</strike> Mittlerweile ist der (bessere) LD382 vom gleichen Hersteller verfügbar.

Zum Betrieb sind der LW12, ein RGB LED Streifen sowie passendes Netzteil (Klemmschrauben) erforderlich.

==== Bezug ====

* Zum Zeitpunkt der Erstellung dieses Artikels ist der LW12 bei eBay von diversen Händlern ab ca 30,- Euro erhältlich.
* [http://www.amazon.de/NEUER-STRIPS-CONTROLLER-iPhone-Android/dp/B00G55329A/ref=sr_1_1?ie=UTF8&qid=1390006342&sr=8-1&keywords=lw12+led LW12 RGB LED Stripecontroller Amazon]

=== RGB und RGBW LED (Streifen) am LD382 Wifi LED Controller ===

Der LD382 vereint die LED Steuereinheit und den Wifi Empfänger. Am LD382 können reine RGB Streifen, RGBW Streifen oder eine Kombination beider angeschlossen werden. Zum Betrieb ist noch der LED Streifen mit gemeinsamer Anode sowie ein in Spannung und Leistung zum LED Streifen passendes Netzteil erforderlich. Alle Anschlüsse am Controller sind als Schraubklemmen ausgeführt, das Netzteil verfügt zusätzlich über einen Steckeranschluss.

Der LD382 verfügt über einen WPS Button, kann also per "one-click" ins Netzwerk genommen werden.

==== Alternative Bezeichnungen ====
* LED Magic UFO (XCSOURCE)

Die Definition erfolgt im Modul so:

LD382 mit RGB Streifen (Weiß wird gemischt)
:<code>define <name> WifiLight RGB LD382:<IP|FQDN></code>
LD382 mit RGBW Streifen (oder Kombination aus RGB und separatem Weiß)
:<code>define <name> WifiLight RGBW LD382:<IP|FQDN></code>

=== RGBW LD316 LED-Lampe Wifi ===

Der LD316 vereint LED-Lampe (Fassung E27), Steuereinheit und Wifi Empfänger. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App (sh. LW12) kann LD316 gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen über den in LD316 vorhandenen Webserver möglich (Benutzer: admin, Kennwort: nimda).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight RGBW LD316:<IP|FQDN></code>

=== sengled Boost LED-Lampe Wifi ===
<gallery>
Sengled Boost.JPG|sengled Boost
</gallery>
Die sengled Boost vereint eine Weiß-LED-Lampe (Fassung E27), Wifi Empfänger und Steuereinheit und bietet eine Wifi Repeater Funktion. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App ("sengled Boost" unter [http://forum.fhem.de/index.php/topic,36811.0.html Android] oder [https://itunes.apple.com/de/app/sengled-boost/id848792893?mt=8 iOS]) kann die sengled Boost gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen (besonders zur Wifi Repeater Funktion) über den in der sengled Boost vorhandenen Webserver möglich (Benutzer: admin, Kennwort: admin).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight White SENGLED:<IP|FQDN></code>

Weitere Informationen können im entsprechenden [http://forum.fhem.de/index.php/topic,36811.0.html Forumsthema] nachgelesen werden.

=== Milight Systeme für LED Streifen und E27 Leuchtmittel ===

Milight Leuchtmittel sind von diversen Herstellern unter diversen Handelsnamen erhältlich. Verfügbar sind preiswerte Ansteuerungen (RGB, RGB oder Weiß, RGB und Weiß, Warm- und Kaltweiß) für LED Streifen, Downlights sowie E27 Leuchtmittel. Die E27 Leuchtmittel haben den Empfänger integriert und können direkt in vorhandenen Fassungen eingesetzt werden.

Die Lampen / Controller sprechen ein proprietäres 2,4GHz Protokoll. Zur Ansteuerung mit fhem wird eine zusätzliche bridge benötigt.

==== Alternative Bezeichnungen ====
* Rocket LED
* Limitless LED
* Easybulb
* s`luce iLight
* iBulb
* Kreuzer
* ...

==== Milight WiFi bridge ====
aktuell sind vier bridge Versionen erschienen (v1 .. v4) wobei die v1 praktisch nicht mehr erhältlich ist und nicht unterstützt wird. Der bridge erstellen im Werkszustand ein WLAN mit eigener SSID und werden über eine Smartphone App in das eigene Netzwerk eingebunden. Zum Betrieb ist ein 5V USB Netzteil erforderlich. Ein Betrieb an den USB Ports des Host ist möglich, wegen eventueller Energiemanagement Funktionen des Host jedoch nicht empfohlen.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

===== Milight bridge v2 =====

Die v2 bridge hört auf UDP Port 50000 und ist typischerweise am blauen Etikett erkennbar. Eine v2 bridge kann ansteuern:
* ein RGB Leuchtmittel
ODER
* ein RGBW1 Leuchtmittel
UND
* vier Gruppen Warmwhite/Coldwhite (White)

===== Milight bridge v3 =====

Die v3 bridge hört auf UDP Port 8899 und hat typischerweise ein dunkles Etikett. Eine v3 bridge kann ansteuern:
* ein RGB Leuchtmittel
ODER
* ein RGBW1 Leuchtmittel

UND

* vier Gruppen Warmwhite/Coldwhite (White)
UND
* vier Gruppen RGB + White (RGBW2)

===== Milight bridge v4 =====

Die Funktionen der v4 entsprechen im wesentlichen der v3, allerdings ist das WLAN Modul ein anderes (Draft-N) und das Web Interface wurde entfernt.

==== Leuchtmittel ====

===== Milight Leuchtmitteltyp RGB =====

E27, LED Streifen Controller oder Downlight.

Dieser Typ RGB Leuchtmittel ist veraltet und von Neuanschaffungen wird abgeraten. Die Ansteuerung ist nur im Farbkreis möglich (keine volle RGB Mischung, keine Sättigung, kein Weiß). Das Protokoll zur Ansteuerung dieses Typ ist fehleranfällig und sehr langsam. Eine parallele Benutzung der FB oder der App verursacht ebenfalls Fehler.

Benötigt eine bridge ab v2.
<gallery>
Milight-RGB-Stripe.jpg|Milight RGB LED stripe Controller mit FB
Milight-RGB-e27.JPG|Milight RGB e27 mit FB
Milight-RGB-downlight.JPG|s'luce RGB Downlight
</gallery>

===== Milight Leuchtmitteltyp RGBW1 =====

LED Streifen Controller. (RGB mit separatem Weiß Kanal)

Dieser Typ RGB Leuchtmittel ist veraltet.

FHEM kann mit diesem Controller Farbe, Helligkeit und Sättigung komplett steuern. Durch den extra Weißkanal sind sehr angenehme Farbmischungen möglich allerdings ist das verwendete Protokoll wie beim RGB langsam und fehleranfällig. Daher eignet sich der Controller nicht für häufige dynamische Farbwechsel und nur bedingt für unbeaufsichtigten / automatischen Betrieb.

Die Sättigung wird durch die Balance des Weiß- und des Farbkanals erreicht. Bei einer Sättigung von 50% werden Weiß und Farbe jeweils voll angesteuert.

Benötigt eine bridge ab v2.
<gallery>
Milight-RGBW1.JPG|Milight RGBW LED stripe Controller mit FB
</gallery>

===== Milight Leuchtmitteltyp White =====

E27, LED Streifen Controller oder Downlight.

Pur weiße LED Leuchtmittel mit Unterstützung der Farbtemperatur (Kaltweiß/Warmweiß).

FHEM steuert die Helligkeit der Leuchtmittel. Ein Unterstützung der Farbtemperatur (Weiß Kelvin) ist noch nicht implementiert. Die Farbtemperatur sollte initial über die app eingestellt werden und wird von den Leuchtmitteln beibehalten. Die e27 Lampen sind zum Zeitpunkt der Erstellung dieses Artikels (04/14) ab etwa 11,- Euro bei eBay verfügbar. Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel). Die Lichtausbeute ist sehr gut.

Benötigt eine bridge ab v2. Eine bridge kann vier getrennte Gruppen White ansteuern. Wenn mehr als vier Gruppen eingesetzt werden sollen können weitere bridge eingebunden werden.
<gallery>
Milight-WWCW-FB.JPG|Milght Warmweiß/kaltweiß LED Streifen controller mit FB
Milight-E27-WWCW-OEM.JPG|Milight Warmweiß/kaltweiß 6 Watt E27 OEM
Milight-E27-WWCW-9W.JPG|Milight Warmweiß/kaltweiß 9 Watt E27
Milight-Downlight-WWCW.JPG|Milight Warmweiß/kaltweiß Downlight (IWY STAR 6 Watt)
</gallery>

===== Milight Leuchtmitteltyp RGBW2 =====

E27, LED Streifen Controller oder Downlight.

Aktuelle Typen mit neuem und robusterem Protokoll.

Dieser Typ Leuchtmittel gibt farbiges oder weißes Licht. Die Sättigung ist nicht stufenlos sondern 0% oder 100%. Die E27 Typen sind dabei wahlweise mit Warm- oder Kaltweiß bestellbar.

Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel).

Benötigt eine bridge ab v3. Eine bridge kann vier getrennte Gruppen RGBW2 ansteuern. Mehr als vier Gruppen können mit zusätzlichen bridge verwendet werden.

Die Sättigung wird wie folgt umgesetzt: S: 0..20 => 0% / S: 21..100 => 100%.

''Bei Farbverläufen (Sonnenaufgang) die bei einer Farbe beginnen und bei Weiß enden kann es sinnvoll sein in zwei Schritten zuerst auf 100% Gelb zu faden, dort auf 20%..40% Weiß (typenabhängig) umzuschalten und dann Weiß weiter auf 100% zu dimmen.''
<gallery>
Milight-rgbw2-LED.jpg|Milight RGB/Weiß LED Streifen Controller 4 Zonen
Milight-E27-RGBW2-OEM.JPG|Milight RGB/Weiß 6 Watt E27 OEM
Milight-E27-RGBW2-9Watt.JPG|Milight RGB/Weiß 9 Watt E27 mit FB
</gallery>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=Achtung: Das modul ist nicht Bestandteil der fhem Standardinstallation weil der dev lieber die Unterstützung neuer Controller einbaut anstelle die Doku zu schreiben :)}}
Das Modul wird bequem so installiert:
<code>update force https://raw.githubusercontent.com/herrmannj/wifilight/master/controls_wifilight.txt</code>

== Color-Picker aktivieren ==
Um den sog. "Color-Picker" zu aktivieren müssen die beiden folgenden Attribute gesetzt werden:
<pre>
attr <name> webCmd RGB
attr <name> widgetOverride RGB:colorpicker,RGB
</pre>
<gallery>
Wifiled_colorpicker.png|Colorpicker Beispiel
</gallery>

Weitere Informationen unter [http://www.fhemwiki.de/wiki/Color Color Wiki Artikel]

== Farbiges Icon ==
Weiterhin kann das Lampen-Icon auch farbig dargestellt werden. Dazu ist es erforderlich, das folgende Attribut zu setzen:
<pre>
attr <name> devStateIcon {Color_devStateIcon(ReadingsVal($name,"RGB","000000"))}
</pre>

== Links ==
* Thread über das Modul im [http://forum.fhem.de/index.php/topic,18958.0.html Fhem Forum]
* [http://www.ledsee.com/datasheet_ledsee/LED%20WiFi%20controller%20for%20home%20use_Hontech-wins__-EN.pdf LW12 Datasheet]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Code Snippets]]

Datei:Sengled Boost.JPG

2015-05-03T15:45:20Z

Scooty: sengled Boost

sengled Boost