FHEMWiki - Benutzerbeiträge [de]

Balken & Slider

2017-01-06T14:06:06Z

Spiff: /* BRI-Slider */

{{SEITENTITEL:Balken & Slider}}
{{Infobox Modul
|ModPurpose=Erstellen von erweiterten Balken und Slidern als Widget
|ModType=h
|ModCmdRef=advancedSlider
|ModForumArea=Frontends
|ModTechName=fhemweb_advancedSlider.js
|ModOwner=Spiff ({{Link2FU|1289|Forum}} / [[Benutzer Diskussion:Spiff|Wiki]])}}

=== Info ===
!!!Seite noch im Aufbau!!!
Weitere Infos:
https://forum.fhem.de/index.php?topic=28318.0

=== Benutzung der Variablen ===
{| class="wikitable"
! colspan=4 | Balken-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|-
! colspan=4 | Slider-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| slider
| 0,1
| Fügt dem Balken die Slider-Funktionalität hinzu
| 0
|-
| sliderTechnology
| 0,1 
0 = noUiSlider 
1 = jQuery UI Slider
| Auswahl der zu benutzenden Slider-Technologie aus Kompatibilitätsgründen v.a. bei mobilen Endgeräten. Siehe Abschnitt Kompatiblilität
| 0
|-
| setDevice
| (Device-Name)
| Stellt ein, welches Device durch den Slider über "set" bedient werden soll
| $DEVICE
|-
| setTarget
| (Set-Funktion)
| Stellt ein, welche Funktion durch den Slider über "set" bedient werden soll
| - (=state)
|-
| disableNotify
| (Notify-Name)
| Deaktiviert das angegebene Notify (verhindert, dass der Balken im Konstrukt dummy+notify per longpoll ein Update bekommt, während der Slider bewegt wird) '''Bug: bei jeder Slidebewegung wird bisher kontinuierlich das Notify auf 'inactive' gesetzt, auch wenn es schon 'inactive' ist. Das kann dazu führen, dass in der Warteschleife so viele inactive-Events abgesetzt wurden, dass diese auch erst nach dem Loslassen des Sliders Anwendung finden. Dann bleibt das Notify 'inactive' und die Seite mit dem Slider muss aktualisiert werden.'''
| -
|-
| sliderHandleDesign
| 0,1
| Fügt dem Slider ein Handle hinzu
| 1
|}

== Beispiele ==

=== Default-Balken ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider</code>
| style="width:40%" | Standardeinstellungen des Balkens (ohne Slider).
| style="width:20%" | [[Datei:AdvancedSlider_default.png|thumb]]
|-
|}

=== Beispiel 1 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:200, color1:glossyGreen,borderSize:5,borderRadius:15, borderColor:999999,textSize:10, slider:1,sliderHandleDesign:0,setDevice:mp, setTarget:position,textValue:"",disableNotify:n_position_mp</code>
| style="width:40%" | Der Slider macht ein "set mp position (Sliderwert)".
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_example1.png|thumb]]
|-
| <code>define n_position_mp notify mp:position setreading slider1 $VALUE</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein. Über disableNotify wird das Notify für die Dauer des Slidens deaktiviert und danach wieder aktiviert.
|-
|}

=== Beispiel 2 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,slider:1, sliderHandleDesign:0, shadow:1,borderSize:5, borderRadius:15,borderColor:000000, length:500,width:50, color2:flat_FFFFFF, color1:gradient_00FF00_FF0000, overlay:/fhem/images/BalkenHorizontal.png, overlayStyle:relative,textValue:""</code>
| Balken mit Slider, abgerundeten Ecken, einem Rand, Overlay-Bild für die Skale, Hintergrundschatten und Farbgradient grün->rot
| [[Datei:AdvancedSlider_example2.png|thumb]]
|-
|}

=== HUE-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:300,borderSize:2, max:65535,color1:flat_FFFFFF,color2:flat_000000, opacity1:0,opacity2:0.75,textSize:0, slider:1,sliderHandleDesign:0,setDevice:HUEDevice4, setTarget:hue, underlay:/fhem/jscolor/hue_background.svg</code>
| Balken mit Slider, Underlay-Bild für die HUE-Skale, verdunkelt den rechten Regelbereich anstatt der Anzeige eines Handles
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_hue.png|thumb]]
|-
| <code>define n_adslider_hue notify HUEDevice4:hue.* setreading adslider_hue state $EVTPART1</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein.
|-
|}

=== BRI-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:300,borderSize:2, color1:gradient_000000_FFFFFF,color2:flat_000000, textSize:0,slider:1,sliderHandleDesign:0, setDevice:HUEDevice4,setTarget:bri</code>
| Balken mit Slider, Gradient für die Helligkeitsanzeige, schwärzt den rechten Regelbereich anstatt der Anzeige eines Handles
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_bri.png|thumb]]
|-
| <code>define n_adslider_bri notify HUEDevice4:bri.* setreading adslider_bri state $EVTPART1</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein.
|-
|}

== Kompatibilität==
Als Orientierung, welche Slidertechnologie ausgewählt werden sollte und was für Fehlerbilder möglich sind hier eine Übersicht über verschiedene mobile Endgeräte
{|class="wikitable mw-collapsible mw-collapsed"
! Gerät !! Betriebssystem !! Browser !! Slider Technologie !! Bemerkungen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| noUiSlider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| jQuery UI Slider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
|}

Balken & Slider

2017-01-06T14:00:43Z

Spiff:

{{SEITENTITEL:Balken & Slider}}
{{Infobox Modul
|ModPurpose=Erstellen von erweiterten Balken und Slidern als Widget
|ModType=h
|ModCmdRef=advancedSlider
|ModForumArea=Frontends
|ModTechName=fhemweb_advancedSlider.js
|ModOwner=Spiff ({{Link2FU|1289|Forum}} / [[Benutzer Diskussion:Spiff|Wiki]])}}

=== Info ===
!!!Seite noch im Aufbau!!!
Weitere Infos:
https://forum.fhem.de/index.php?topic=28318.0

=== Benutzung der Variablen ===
{| class="wikitable"
! colspan=4 | Balken-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|-
! colspan=4 | Slider-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| slider
| 0,1
| Fügt dem Balken die Slider-Funktionalität hinzu
| 0
|-
| sliderTechnology
| 0,1 
0 = noUiSlider 
1 = jQuery UI Slider
| Auswahl der zu benutzenden Slider-Technologie aus Kompatibilitätsgründen v.a. bei mobilen Endgeräten. Siehe Abschnitt Kompatiblilität
| 0
|-
| setDevice
| (Device-Name)
| Stellt ein, welches Device durch den Slider über "set" bedient werden soll
| $DEVICE
|-
| setTarget
| (Set-Funktion)
| Stellt ein, welche Funktion durch den Slider über "set" bedient werden soll
| - (=state)
|-
| disableNotify
| (Notify-Name)
| Deaktiviert das angegebene Notify (verhindert, dass der Balken im Konstrukt dummy+notify per longpoll ein Update bekommt, während der Slider bewegt wird) '''Bug: bei jeder Slidebewegung wird bisher kontinuierlich das Notify auf 'inactive' gesetzt, auch wenn es schon 'inactive' ist. Das kann dazu führen, dass in der Warteschleife so viele inactive-Events abgesetzt wurden, dass diese auch erst nach dem Loslassen des Sliders Anwendung finden. Dann bleibt das Notify 'inactive' und die Seite mit dem Slider muss aktualisiert werden.'''
| -
|-
| sliderHandleDesign
| 0,1
| Fügt dem Slider ein Handle hinzu
| 1
|}

== Beispiele ==

=== Default-Balken ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider</code>
| style="width:40%" | Standardeinstellungen des Balkens (ohne Slider).
| style="width:20%" | [[Datei:AdvancedSlider_default.png|thumb]]
|-
|}

=== Beispiel 1 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:200, color1:glossyGreen,borderSize:5,borderRadius:15, borderColor:999999,textSize:10, slider:1,sliderHandleDesign:0,setDevice:mp, setTarget:position,textValue:"",disableNotify:n_position_mp</code>
| style="width:40%" | Der Slider macht ein "set mp position (Sliderwert)".
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_example1.png|thumb]]
|-
| <code>define n_position_mp notify mp:position setreading slider1 $VALUE</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein. Über disableNotify wird das Notify für die Dauer des Slidens deaktiviert und danach wieder aktiviert.
|-
|}

=== Beispiel 2 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,slider:1, sliderHandleDesign:0, shadow:1,borderSize:5, borderRadius:15,borderColor:000000, length:500,width:50, color2:flat_FFFFFF, color1:gradient_00FF00_FF0000, overlay:/fhem/images/BalkenHorizontal.png, overlayStyle:relative,textValue:""</code>
| Balken mit Slider, abgerundeten Ecken, einem Rand, Overlay-Bild für die Skale, Hintergrundschatten und Farbgradient grün->rot
| [[Datei:AdvancedSlider_example2.png|thumb]]
|-
|}

=== HUE-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:300,borderSize:2, max:65535,color1:flat_FFFFFF,color2:flat_000000, opacity1:0,opacity2:0.75,textSize:0, slider:1,sliderHandleDesign:0,setDevice:HUEDevice4, setTarget:hue, underlay:/fhem/jscolor/hue_background.svg</code>
| Balken mit Slider, Underlay-Bild für die HUE-Skale, verdunkelt den rechten Regelbereich anstatt der Anzeige eines Handles
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_hue.png|thumb]]
|-
| <code>define n_adslider_hue notify HUEDevice4:hue.* setreading adslider_hue state $EVTPART1</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein.
|-
|}

=== BRI-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:300,borderSize:2, color1:gradient_000000_FFFFFF,color2:flat_000000, textSize:0,slider:1,sliderHandleDesign:0, setDevice:HUEDevice4,setTarget:bri</code>
| Balken mit Slider, Gradient für die Helligkeitsanzeige, schwärzt den rechten Regelbereich anstatt der Anzeige eines Handles
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_bri.png|thumb]]
|-
| <code>define n_adslider_bri notify HUEDevice4:hue.* setreading adslider_bri state $EVTPART1</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein.
|-
|}

== Kompatibilität==
Als Orientierung, welche Slidertechnologie ausgewählt werden sollte und was für Fehlerbilder möglich sind hier eine Übersicht über verschiedene mobile Endgeräte
{|class="wikitable mw-collapsible mw-collapsed"
! Gerät !! Betriebssystem !! Browser !! Slider Technologie !! Bemerkungen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| noUiSlider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| jQuery UI Slider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
|}

Balken & Slider

2017-01-06T13:53:08Z

Spiff: /* HUE-Slider */

{{SEITENTITEL:Balken & Slider}}
{{Infobox Modul
|ModPurpose=Erstellen von erweiterten Balken und Slidern als Widget
|ModType=h
|ModCmdRef=advancedSlider
|ModForumArea=Frontends
|ModTechName=fhemweb_advancedSlider.js
|ModOwner=Spiff ({{Link2FU|1289|Forum}} / [[Benutzer Diskussion:Spiff|Wiki]])}}

=== Info ===
!!!Seite noch im Aufbau!!!
Weitere Infos:
https://forum.fhem.de/index.php?topic=28318.0

=== Benutzung der Variablen ===
{| class="wikitable"
! colspan=4 | Balken-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|-
! colspan=4 | Slider-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| slider
| 0,1
| Fügt dem Balken die Slider-Funktionalität hinzu
| 0
|-
| sliderTechnology
| 0,1 
0 = noUiSlider 
1 = jQuery UI Slider
| Auswahl der zu benutzenden Slider-Technologie aus Kompatibilitätsgründen v.a. bei mobilen Endgeräten. Siehe Abschnitt Kompatiblilität
| 0
|-
| setDevice
| (Device-Name)
| Stellt ein, welches Device durch den Slider über "set" bedient werden soll
| $DEVICE
|-
| setTarget
| (Set-Funktion)
| Stellt ein, welche Funktion durch den Slider über "set" bedient werden soll
| - (=state)
|-
| disableNotify
| (Notify-Name)
| Deaktiviert das angegebene Notify (verhindert, dass der Balken im Konstrukt dummy+notify per longpoll ein Update bekommt, während der Slider bewegt wird) '''Bug: bei jeder Slidebewegung wird bisher kontinuierlich das Notify auf 'inactive' gesetzt, auch wenn es schon 'inactive' ist. Das kann dazu führen, dass in der Warteschleife so viele inactive-Events abgesetzt wurden, dass diese auch erst nach dem Loslassen des Sliders Anwendung finden. Dann bleibt das Notify 'inactive' und die Seite mit dem Slider muss aktualisiert werden.'''
| -
|-
| sliderHandleDesign
| 0,1
| Fügt dem Slider ein Handle hinzu
| 1
|}

== Beispiele ==

=== Default-Balken ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider</code>
| style="width:40%" | Standardeinstellungen des Balkens (ohne Slider).
| style="width:20%" | [[Datei:AdvancedSlider_default.png|thumb]]
|-
|}

=== Beispiel 1 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:200, color1:glossyGreen,borderSize:5,borderRadius:15, borderColor:999999,textSize:10, slider:1,sliderHandleDesign:0,setDevice:mp, setTarget:position,textValue:"",disableNotify:n_position_mp</code>
| style="width:40%" | Der Slider macht ein "set mp position (Sliderwert)".
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_example1.png|thumb]]
|-
| <code>define n_position_mp notify mp:position setreading slider1 $VALUE</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein. Über disableNotify wird das Notify für die Dauer des Slidens deaktiviert und danach wieder aktiviert.
|-
|}

=== Beispiel 2 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,slider:1, sliderHandleDesign:0, shadow:1,borderSize:5, borderRadius:15,borderColor:000000, length:500,width:50, color2:flat_FFFFFF, color1:gradient_00FF00_FF0000, overlay:/fhem/images/BalkenHorizontal.png, overlayStyle:relative,textValue:""</code>
| Balken mit Slider, abgerundeten Ecken, einem Rand, Overlay-Bild für die Skale, Hintergrundschatten und Farbgradient grün->rot
| [[Datei:AdvancedSlider_example2.png|thumb]]
|-
|}

=== HUE-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:300,borderSize:2, max:65535,color1:flat_FFFFFF,color2:flat_000000 ,opacity1:0,opacity2:0.75,textSize:0, slider:1,sliderHandleDesign:0,setDevice:HUEDevice4, setTarget:hue, underlay:/fhem/jscolor/hue_background.svg</code>
| Balken mit Slider, Underlay-Bild für die HUE-Skale, verdunkelt den rechten Regelbereich anstatt der Anzeige eines Handles
| [[Datei:AdvancedSlider_hue.png|thumb]]
|-
|}

=== BRI-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,widt....</code>
| Balken mit Slider, Gradient für die Helligkeitsanzeige, verdunkelt den rechten Regelbereich anstatt der Anzeige eines Handles
| [[Datei:AdvancedSlider_bri.png|thumb]]
|-
|}

== Kompatibilität==
Als Orientierung, welche Slidertechnologie ausgewählt werden sollte und was für Fehlerbilder möglich sind hier eine Übersicht über verschiedene mobile Endgeräte
{|class="wikitable mw-collapsible mw-collapsed"
! Gerät !! Betriebssystem !! Browser !! Slider Technologie !! Bemerkungen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| noUiSlider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| jQuery UI Slider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
|}

Datei:AdvancedSlider bri.png

2017-01-06T13:50:28Z

Spiff:

Datei:AdvancedSlider hue.png

2017-01-06T13:49:53Z

Spiff:

Balken & Slider

2017-01-06T13:49:03Z

Spiff:

{{SEITENTITEL:Balken & Slider}}
{{Infobox Modul
|ModPurpose=Erstellen von erweiterten Balken und Slidern als Widget
|ModType=h
|ModCmdRef=advancedSlider
|ModForumArea=Frontends
|ModTechName=fhemweb_advancedSlider.js
|ModOwner=Spiff ({{Link2FU|1289|Forum}} / [[Benutzer Diskussion:Spiff|Wiki]])}}

=== Info ===
!!!Seite noch im Aufbau!!!
Weitere Infos:
https://forum.fhem.de/index.php?topic=28318.0

=== Benutzung der Variablen ===
{| class="wikitable"
! colspan=4 | Balken-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|-
! colspan=4 | Slider-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| slider
| 0,1
| Fügt dem Balken die Slider-Funktionalität hinzu
| 0
|-
| sliderTechnology
| 0,1 
0 = noUiSlider 
1 = jQuery UI Slider
| Auswahl der zu benutzenden Slider-Technologie aus Kompatibilitätsgründen v.a. bei mobilen Endgeräten. Siehe Abschnitt Kompatiblilität
| 0
|-
| setDevice
| (Device-Name)
| Stellt ein, welches Device durch den Slider über "set" bedient werden soll
| $DEVICE
|-
| setTarget
| (Set-Funktion)
| Stellt ein, welche Funktion durch den Slider über "set" bedient werden soll
| - (=state)
|-
| disableNotify
| (Notify-Name)
| Deaktiviert das angegebene Notify (verhindert, dass der Balken im Konstrukt dummy+notify per longpoll ein Update bekommt, während der Slider bewegt wird) '''Bug: bei jeder Slidebewegung wird bisher kontinuierlich das Notify auf 'inactive' gesetzt, auch wenn es schon 'inactive' ist. Das kann dazu führen, dass in der Warteschleife so viele inactive-Events abgesetzt wurden, dass diese auch erst nach dem Loslassen des Sliders Anwendung finden. Dann bleibt das Notify 'inactive' und die Seite mit dem Slider muss aktualisiert werden.'''
| -
|-
| sliderHandleDesign
| 0,1
| Fügt dem Slider ein Handle hinzu
| 1
|}

== Beispiele ==

=== Default-Balken ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider</code>
| style="width:40%" | Standardeinstellungen des Balkens (ohne Slider).
| style="width:20%" | [[Datei:AdvancedSlider_default.png|thumb]]
|-
|}

=== Beispiel 1 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:200, color1:glossyGreen,borderSize:5,borderRadius:15, borderColor:999999,textSize:10, slider:1,sliderHandleDesign:0,setDevice:mp, setTarget:position,textValue:"",disableNotify:n_position_mp</code>
| style="width:40%" | Der Slider macht ein "set mp position (Sliderwert)".
| style="width:20%" rowspan=2 | [[Datei:AdvancedSlider_example1.png|thumb]]
|-
| <code>define n_position_mp notify mp:position setreading slider1 $VALUE</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein. Über disableNotify wird das Notify für die Dauer des Slidens deaktiviert und danach wieder aktiviert.
|-
|}

=== Beispiel 2 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,slider:1, sliderHandleDesign:0, shadow:1,borderSize:5, borderRadius:15,borderColor:000000, length:500,width:50, color2:flat_FFFFFF, color1:gradient_00FF00_FF0000, overlay:/fhem/images/BalkenHorizontal.png, overlayStyle:relative,textValue:""</code>
| Balken mit Slider, abgerundeten Ecken, einem Rand, Overlay-Bild für die Skale, Hintergrundschatten und Farbgradient grün->rot
| [[Datei:AdvancedSlider_example2.png|thumb]]
|-
|}

=== HUE-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,wid....</code>
| Balken mit Slider, Underlay-Bild für die HUE-Skale, verdunkelt den rechten Regelbereich anstatt der Anzeige eines Handles
| [[Datei:AdvancedSlider_hue.png|thumb]]
|-
|}

=== BRI-Slider ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,widt....</code>
| Balken mit Slider, Gradient für die Helligkeitsanzeige, verdunkelt den rechten Regelbereich anstatt der Anzeige eines Handles
| [[Datei:AdvancedSlider_bri.png|thumb]]
|-
|}

== Kompatibilität==
Als Orientierung, welche Slidertechnologie ausgewählt werden sollte und was für Fehlerbilder möglich sind hier eine Übersicht über verschiedene mobile Endgeräte
{|class="wikitable mw-collapsible mw-collapsed"
! Gerät !! Betriebssystem !! Browser !! Slider Technologie !! Bemerkungen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| noUiSlider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| jQuery UI Slider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
|}

Balken & Slider

2017-01-06T11:03:29Z

Spiff:

{{SEITENTITEL:Balken & Slider}}
{{Infobox Modul
|ModPurpose=Erstellen von erweiterten Balken und Slidern als Widget
|ModType=h
|ModCmdRef=advancedSlider
|ModForumArea=Frontends
|ModTechName=fhemweb_advancedSlider.js
|ModOwner=Spiff ({{Link2FU|1289|Forum}} / [[Benutzer Diskussion:Spiff|Wiki]])}}

=== Info ===
!!!Seite noch im Aufbau!!!
Weitere Infos:
https://forum.fhem.de/index.php?topic=28318.0

=== Benutzung der Variablen ===
{| class="wikitable"
! colspan=4 | Balken-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|-
! colspan=4 | Slider-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| slider
| 0,1
| Fügt dem Balken die Slider-Funktionalität hinzu
| 0
|-
| sliderTechnology
| 0,1 
0 = noUiSlider 
1 = jQuery UI Slider
| Auswahl der zu benutzenden Slider-Technologie aus Kompatibilitätsgründen v.a. bei mobilen Endgeräten. Siehe Abschnitt Kompatiblilität
| 0
|-
| setDevice
| (Device-Name)
| Stellt ein, welches Device durch den Slider über "set" bedient werden soll
| $DEVICE
|-
| setTarget
| (Set-Funktion)
| Stellt ein, welche Funktion durch den Slider über "set" bedient werden soll
| - (=state)
|-
| disableNotify
| (Notify-Name)
| Deaktiviert das angegebene Notify (verhindert, dass der Balken im Konstrukt dummy+notify per longpoll ein Update bekommt, während der Slider bewegt wird) '''Bug: bei jeder Slidebewegung wird bisher kontinuierlich das Notify auf 'inactive' gesetzt, auch wenn es schon 'inactive' ist. Das kann dazu führen, dass in der Warteschleife so viele inactive-Events abgesetzt wurden, dass diese auch erst nach dem Loslassen des Sliders Anwendung finden. Dann bleibt das Notify 'inactive' und die Seite mit dem Slider muss aktualisiert werden.'''
| -
|-
| sliderHandleDesign
| 0,1
| Fügt dem Slider ein Handle hinzu
| 1
|}

== Beispiele ==

=== Default-Balken ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider</code>
| Standardeinstellungen des Balkens (ohne Slider).
| [[Datei:AdvancedSlider_default.png|thumb]]
|-
|}

=== Beispiel 1 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:200, color1:glossyGreen,borderSize:5,borderRadius:15, borderColor:999999,textSize:10, slider:1,sliderHandleDesign:0,setDevice:mp, setTarget:position,textValue:"",disableNotify:n_position_mp</code>
| Der Slider macht ein "set mp position (Sliderwert)".
| rowspan=2 | [[Datei:AdvancedSlider_example1.png|thumb]]
|-
| <code>define n_position_mp notify mp:position setreading slider1 $VALUE</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein. Über disableNotify wird das Notify für die Dauer des Slidens deaktiviert und danach wieder aktiviert.
|-
|}

=== Beispiel 2 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,slider:1, sliderHandleDesign:0, shadow:1,borderSize:5, borderRadius:15,borderColor:000000, length:500,width:50, color2:flat_FFFFFF, color1:gradient_00FF00_FF0000, overlay:/fhem/images/BalkenHorizontal.png, overlayStyle:relative,textValue:""</code>
| Balken mit Slider, abgerundeten Ecken, einem Rand, Overlay-Bild für die Skale, Hintergrundschatten und Farbgradient grün->rot
| [[Datei:AdvancedSlider_example2.png|thumb]]
|-
|}

== Kompatibilität==
Als Orientierung, welche Slidertechnologie ausgewählt werden sollte und was für Fehlerbilder möglich sind hier eine Übersicht über verschiedene mobile Endgeräte
{|class="wikitable mw-collapsible mw-collapsed"
! Gerät !! Betriebssystem !! Browser !! Slider Technologie !! Bemerkungen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| noUiSlider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| jQuery UI Slider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
|}

Balken & Slider

2017-01-01T14:27:50Z

Spiff:

{{SEITENTITEL:Balken & Slider}}
{{Infobox Modul
|ModPurpose=Erstellen von erweiterten Balken und Slidern als Widget
|ModType=h
|ModCmdRef=advancedSlider
|ModForumArea=Frontends
|ModTechName=fhemweb_advancedSlider.js
|ModOwner=Spiff ({{Link2FU|1289|Forum}} / [[Benutzer Diskussion:Spiff|Wiki]])}}

=== Info ===
!!!Seite noch im Aufbau!!!
Weitere Infos:
https://forum.fhem.de/index.php?topic=28318.0

=== Benutzung der Variablen ===
{| class="wikitable"
! colspan=4 | Balken-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|-
! colspan=4 | Slider-Optionen
|-
! Parameter
! Werte
! Zweck
! Default
|-
| slider
| 0,1
| Fügt dem Balken die Slider-Funktionalität hinzu
| 0
|-
| sliderTechnology
| 0,1 
0 = noUiSlider 
1 = jQuery UI Slider
| Auswahl der zu benutzenden Slider-Technologie aus Kompatibilitätsgründen v.a. bei mobilen Endgeräten. Siehe Abschnitt Kompatiblilität
| 0
|-
| setDevice
| (Device-Name)
| Stellt ein, welches Device durch den Slider über "set" bedient werden soll
| $DEVICE
|-
| setTarget
| (Set-Funktion)
| Stellt ein, welche Funktion durch den Slider über "set" bedient werden soll
| - (=state)
|-
| disableNotify
| (Notify-Name)
| Deaktiviert das angegebene Notify (verhindert, dass der Balken im Konstrukt dummy+notify per longpoll ein Update bekommt, während der Slider bewegt wird)
| -
|-
| sliderHandleDesign
| 0,1
| Fügt dem Slider ein Handle hinzu
| 1
|}

== Beispiele ==

=== Default-Balken ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider</code>
| Standardeinstellungen des Balkens (ohne Slider).
| [[Datei:AdvancedSlider_default.png|thumb]]
|-
|}

=== Beispiel 1 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,width:30,length:200, color1:glossyGreen,borderSize:5,borderRadius:15, borderColor:999999,textSize:10, slider:1,sliderHandleDesign:0,setDevice:mp, setTarget:position,textValue:"",disableNotify:n_position_mp</code>
| Der Slider macht ein "set mp position (Sliderwert)".
| rowspan=2 | [[Datei:AdvancedSlider_example1.png|thumb]]
|-
| <code>define n_position_mp notify mp:position setreading slider1 $VALUE</code>
| Das notify stellt den Slider immer auf den Wert des Devices ein. Über disableNotify wird das Notify für die Dauer des Slidens deaktiviert und danach wieder aktiviert.
|-
|}

=== Beispiel 2 ===
{| class="wikitable"
! Definition !! Erläuterungen !! Aussehen
|-
| style="width:40%" |<code>state:adslider,slider:1, sliderHandleDesign:0, shadow:1,borderSize:5, borderRadius:15,borderColor:000000, length:500,width:50, color2:flat_FFFFFF, color1:gradient_00FF00_FF0000, overlay:/fhem/images/BalkenHorizontal.png, overlayStyle:relative,textValue:""</code>
| Balken mit Slider, abgerundeten Ecken, einem Rand, Overlay-Bild für die Skale, Hintergrundschatten und Farbgradient grün->rot
| [[Datei:AdvancedSlider_example2.png|thumb]]
|-
|}

== Kompatibilität==
Als Orientierung, welche Slidertechnologie ausgewählt werden sollte und was für Fehlerbilder möglich sind hier eine Übersicht über verschiedene mobile Endgeräte
{|class="wikitable mw-collapsible mw-collapsed"
! Gerät !! Betriebssystem !! Browser !! Slider Technologie !! Bemerkungen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| noUiSlider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
| style="width:40%" | Google Nexus 4
| Android 5
| WebViewControl
| jQuery UI Slider
| Hin und wieder Probleme vor allem bei vertikalen Slidern und wenn die Asicht gezoomt ist. Meist stimmt die Zuordnung von Finger und Rückgabewert nicht ganz zusammen
|-
|}

Balken & Slider

2017-01-01T13:35:14Z

Spiff: /* Benutzung der Variablen */

Balken & Slider

2016-12-31T18:40:44Z

Spiff:

Datei:AdvancedSlider default.png

2016-12-31T18:20:10Z

Spiff:

Datei:AdvancedSlider example2.png

2016-12-31T18:19:20Z

Spiff:

Datei:AdvancedSlider example1.png

2016-12-31T18:18:13Z

Spiff:

Balken & Slider

2016-12-31T18:09:36Z

Spiff:

Benutzer:Spiff

2016-12-12T14:42:00Z

Spiff: Die Seite wurde neu angelegt: „Moin!“

Moin!

Balken & Slider

2016-12-12T14:31:59Z

Spiff:

=== Info ===
https://forum.fhem.de/index.php?topic=28318.0

=== Benutzung der Variablen ===
{| class="wikitable"
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|}

Balken & Slider

2016-12-12T12:53:45Z

Spiff: Die Seite wurde neu angelegt: „=== Benutzung der Variablen === {| class="wikitable" ! Parameter ! Werte ! Zweck ! Default |- | length | Zahl (Pixel) | Länge des Balkens | 300 |- |…“

=== Benutzung der Variablen ===
{| class="wikitable"
! Parameter
! Werte
! Zweck
! Default
|-
| length
| Zahl (Pixel)
| Länge des Balkens
| 300
|-
| width
| Zahl (Pixel)
| Breite des Balkens
| 30
|-
| max
| Zahl
| maximal erreichbarer Wert des Readings
| 100
|-
| style
| horizontal, vertical
| Ausrichtung des Balkens
| horizontal
|-
| swapDirection
| 0,1
| Umkehren der Richtung 
horizontal: 
0=links->rechts 
1=rechts->links 
vertical: 
0=unten->oben 
1=oben->unten
| 0
|-
| offset1
| Zahl (Pixel)
| Erzeugt einen Abstand links bzw. unten
| 0
|-
| offset2
| Zahl (Pixel)
| Erzeugt einen Abstand rechts bzw. oben
| 0
|-
| color1
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des linken/unteren Balkens
| glossyBlue
|-
| color2
| glossyBlue, glossyRed, glossyCopper, glossyPink, glossyGreen, glossyYellow, glossyOrange, glossyBlack, glossyWhite 
gradient_RRGGBB_RRGGBB 
flat_RRGGBB 
eigenes CSS möglich
| Farbe des rechten/oberen Balkens
| glossyWhite
|-
| opacity1
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des linken/unteren Balkens
| 1
|-
| opacity2
| Zahl (0...1) 
0=transparent 
1=solid 
Zwischenschritt z.B. 0.75
| Transparenz des rechten/oberen Balkens
| 1
|-
| textValue
| (Textstring), Perl möglich
| mittig angezeigter Text
| $VALUE
|-
| textColor
| RRGGBB (HEX-Format)
| Farbe des Textes
| 000000
|-
| textSize
| Zahl (Pixel)
| Größe des Textes
| 20
|-
| overlay
| Link
| Overlay-Bild (Überdeckt Balken, nur sinnvoll mit Transparenz)
| (leer)
|-
| overlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| overlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| underlay
| Link
| Underlay-Bild (Hintergrundbild unter dem Balken)
| (leer)
|-
| underlayStyle
| absolute, relative
| Platzierung des Bildes mit Beachtung der Offsets (relative) oder über alles (absolute)
| absolute
|-
| underlayRotate
| 0,1
| Rotation des Overlay-Bildes 
horizontal: 90 Grad im Uhrzeigersinn 
vertical: 90° entgegen Uhrzeigersinn
| 0
|-
| borderRadius
| Zahl (Pixel)
| Verrundung der Ecken des Balkens
| 0
|-
| borderSize
| Zahl (Pixel)
| Rahmendicke um den Balken (der Balken bleibt immer in seinem durch length und width definierten Bereich)
| 0
|-
| borderColor
| RRGGBB (HEX-Format)
| Rahmenfarbe
| 000000
|-
| shadow
| 0,1
| Fügt einen Schatten hinter dem Balken hinzu (der Schatten verletzt den durch length und width definierten Bereich)
| 0
|}

PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung

2015-08-08T12:26:23Z

Spiff: Link korrigiert

{{Infobox Hardware
|Bild=PCA301.jpg
|Bildbeschreibung=PCA301 Funkschaltsteckdose
|HWProtocol=PCA
|HWType=Sender, Empfänger, Sensor
|HWCategory=PCA
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=230 V~
|HWPowerConsumption=Eigenverbrauch ca. 0,4 W
|HWPoweredBy=Netz
|HWSize=120*62*36(72) mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#PCA301 36_PCA301.pm]
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=430 Andre / justme1968]
|HWManufacturer=ELV / eQ-3
}}

Die '''PCA301''' ist eine über 868,40 MHz per Funk kommunizierende Schaltsteckdose (Zwischenstecker), die gleichzeitig auch den Energieverbrauch eines angeschlossenen Verbrauchers ermittelt und sendet.

Es gibt eine zu diesem System passende Anzeige- und Bedieneinheit (PSA301), mit der bis zu acht der PCA301 Steckdosen geschaltet und deren gemessene Energieverbrauchswerte angezeigt werden können.

== Features ==
* Schalten über Funk (PSA301 oder Fhem)
* Schalten über Taste am Gerät
* Messen des Energieverbrauchs und Übertragung der gemessenen Werte
* Die Anzeigeeinheit kann bis zu acht Schaltsteckdosen gleichzeitig verwalten

== Hinweise zum Betrieb mit Fhem ==
Die PCA301 Unterstützung in Fhem wird über [[JeeLink]] als [[Interface]] abgewickelt.
{{Infobox Modul
|ModPurpose=Modul zur Unterstützung der [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung]]
|ModType=d

|ModCmdRef=PCA301
|ModTechName=36_PCA301.pm
|ModOwner=justme1968
}}

Zum Betrieb mit FHEM ist die PCA eigene Anzeigeeinheit nicht nötig, kann aber gleichzeitig genutzt werden. Dabei ist jedoch zu beachten, dass die Anzeigeeinheit auch aktiv mit den Schaltsteckdosen kommuniziert und z. B. in regelmäßigen Abständen die kumulierten Verbrauchswerte zurücksetzt.

Die Beschränkung (der PSA301) auf den Betrieb von bis zu acht Schaltsteckdosen gleichzeitig gilt unter Fhem nicht. Das Fhem Modul kann eine größere Anzahl PCA301 gleichzeitig verwalten.

=== Definition in fhem.cfg ===
Das Gerät wird definiert mit
:<code>define <name> PCA301 <addr> <channel></code>
Bei aktiviertem "autocreate" werden die erforderlichen Definitionen von Fhem beim Erkennen eines entsprechenden Geräts automatisch angelegt.

== Bekannte Probleme ==
=== Verhalten nach Stromausfall ===
{{Randnotiz|RNTyp=r|RNText=Ein (natürlich mit Verlust der Gewährleistung verbundener) Umbau zum reinen Energieverbrauchsmesser durch Überbrückung des Relais ist im [http://forum.fhem.de/index.php/topic,11648.msg106468.html#msg106468 Forum] beschrieben. Nachbau - wie üblich - auf eigene Gefahr.}}
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) befindet sich der PCA301 im Zustand "Aus". Je nach Anwendungssituation (z. B. Einsatz als Verbrauchsmessgerät bei einem Kühlschrank) könnte das unerwünschte Auswirkungen haben. Um dem entgegenwirken zu können, gibt es für dieses Device die Möglichkeit mit
:<code>attr <name> forceOn 1</code>
den Status "On" zu erzwingen. Fhem versucht dann, das Gerät einzuschalten, sobald ein Zustand oder Schaltvorgang "Off" erkannt wird. Das setzt natürlich ein laufendes Fhem-System voraus.

=== Pairen der zweiten und weiterer Steckdosen ===
Werden weitere Steckdosen durch '''autocreate''' angelegt, stimmt unter Umständen die Kanalnummer nicht und die Steckdose ist von Fhem aus nicht schaltbar. In diesem Fall sollte das Gerät gelöscht werden (mit dem Befehl
:<code>delete PCA301_xxxxxx</code>
einzugeben im Befehlsfenster im Webinterface). Nach der erneuten automatischen Erkennung sollte das Gerät dann funktionieren.

Die Ursache für Unstimmigkeiten bei der Kanalzuornung sind in der Regel Dosen, die zuerst an fhem und dann an der Displayeinheit angelernt werden. Die nächste Version des fhem moduls wird automatisch geänderte Kanalnummern lernen und im Device aktualisieren. Das Problem sollte dann nicht mehr auftreten.

=== Häufiges Polling mit PCA Sketch pcaSerial10.0h ===
Mit Version 10.0h des pcaSerial Sketches wurden die definierten Geräte fälschlicherweise im Abstand von drei Sekunden gepollt. Dieses Problem wurde mit Version 10.0i behoben.

Nach Aufspielen der Version 10.0i auf den JeeLink müssen die folgenden Befehle abgesetzt werden (Eingabe in das Fhem-Befehlsfeld unter der Annahme, dass der JeeLink mit dem Namen ''myJeeLink'' definiert wurde):
:<code>set myJeeLink raw 0c set myJeeLink raw 2c</code>
um die Konfiguration im EEPROM des JeeLink neu zu füllen.

=== "Leerlaufanzeige" zwischen 20W und 35W ===
PCA301 der Charge, die ca. Anfang November 2013 ausgeliefert wurde, zeigen teilweise im Leerlauf (d.h. eingeschaltet aber ohne angeschlossenen oder eingeschalteten Verbraucher) eine konstante Leistungsaufnahe von 20 bis 35 Watt an. Exemplare mit dieser Fehlfunktion sind zu reklamieren und an der Lieferanten zurückzugeben.

Auch die Ende Januar 2014 ausgelieferte Charge hat offensichtlich eine Fehlerquote von bis zu 50%. ELV hat mittlerweile darauf reagiert und folgende Information herausgegeben:
:''Es ist korrekt, dass der Artikel aktuell nicht verfügbar ist. Es gab bei einigen Steckdosen eine fehlerhafte Anzeige im Leerlauf. Dieses Verhalten wird aktuell mit dem Hersteller geklärt und der Lagerbestand ist für diese Zeit gesperrt. Die Steckdosen werden jedoch nach Klärung dieses Sachverhalts wieder im ELV Shop angeboten.'' ([http://www.elv.de/topic/zusatz-steckdosen-fehlerhaft-und-derzeit-nicht-im-sortiment.html ELV])

=== Löschen von PCA301 Geräten erfordert Nacharbeiten ===
Zumindest derzeit (d.h. 02/2014 mit Version 10.0i des JeeLink Sketches) müssen nach dem Löschen von nicht mehr erwünschten PCA301 Geräten die beiden Befehle
:<code>set myJeeLink raw 0c set myJeeLink raw 2c</code>
abgesetzt werden. Anderenfalls werden die Steckdosen von der autocreate Funktion bei jedem Fhem-Neustart oder dem Neueinlesen der [[Konfiguration]] wieder angelegt.

=== Empfangsfrequenz korrigieren ===
Siehe [[JeeLink#PCA301 Sketch|PCA301 Sketch]].

== Links ==
* [http://www.elv-downloads.de/Assets/Produkte/10/1088/108894/Downloads/108894_funkschaltsteckdose_pca301_um.pdf Bedienungsanleitung] der Funkschaltsteckdose
* [http://www.elv-downloads.de/Assets/Produkte/10/1088/108893/Downloads/108893_pca301_um.pdf Bedienungsanleitung] (Steckdose und Bedien-/Anzeigeeinheit)
* [http://blog.moneybag.de/hausautomation-fhem-mit-funksteckdose-energiemessung-elv-pca-301/ Blog] zum Thema JeeLink zur Anbindung von PCA301 und von Lacrosse Temperatursensoren an Fhem
* [http://forum.fhem.de/index.php/topic,11648.0.html JeeLink / PCA301] - Analyse des Funkprotokolls; Anfänge der Entstehung der PCA301 Unterstützung in Fhem.

[[Kategorie:Other Components]]
[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:Schalter (Empfänger)]]

SYSSTAT

2014-04-18T23:46:54Z

Spiff: /* Einrichtung über SNMP unter Windows 7 */

Seit dem 06.02.2013 gibt es ein neues und offizielles FHEM-Modul namens '''sysstat'''. Es ermöglicht das Logging und die (grafische) Anzeige der Auslastung (load) ihres '''Linux'''-Systems, auf dem FHEM läuft. Daneben ermöglicht es auch die gleichen Auswertungsmöglichkeiten für die Belegung (in Bytes oder Prozent) einer von Ihnen anzugebenden Festplatten-Partition. Gleiches kann auch mit einem Remote-System durchgeführt werden (per SSH mittels Key).

Mit der aktuellen Version lassen sich auch CPU Temperatur und Frequenz eines Raspberry Pi lokal und remote überwachen, die Systemtemperatur einer Synology Diskstation sowie per SNMP praktisch alle UNIX basierten Systeme und auch Windows und viele andere.

Weitere Informationen zum Modul und zur Syntax finden Sie in der [http://fhem.de/commandref.html#SYSSTAT commandref].

== Beispiel ==
Die Definitionen und Eigenschaften (Attribute) müssen von Hand in der ''fhem.cfg'' eingetragen werden, da hier der ''autocreate''-Mechanismus nicht greift (greifen kann).

=== Definition ===
Aus der ''fhem.cfg'':

<nowiki>define BBxM SYSSTAT 120 600
attr BBxM filesystems /dev/mmcblk0p2
attr BBxM room <Ihr Raum>
attr BBxM showpercent 1</nowiki>

=== Anmerkungen ===

* Die Load-Daten werden alle 120 (Default-Wert: 60) '''Sekunden''' gelesen und es wird dabei die Partition ''/dev/mmcblk0p2'' alle 600 Sekunden überwacht. Die Belegung der Partition wird in Prozent angegeben. Wie die Partitionen auf ihrem Linux-System benannt sind erfahren Sie z.B. über den ''mount''-Befehl.
* Wird kein Auslese-Interval für die Partitionen angegeben, so wird dieses auf den ersten Wert <ins>mit 60 multipliziert</ins> gesetzt. So würde im o.a. Beispiel aus dem ersten Wert 120 (für das System-load) ein Auslesewert von 7.200 Sekunden, also 120 Minuten bzw. 2 Stunden.

Weitere Definitionen in der ''fhem.cfg'':

<nowiki>define FileLog_BBxM FileLog /opt/fhem/log/BBxM-%Y-%m.log BBxM
attr FileLog_BBxM archivedir /opt/fhem/archive/
attr FileLog_BBxM logtype sysstat:Plot,text
attr FileLog_BBxM nrarchive 1
attr FileLog_BBxM room <Ihr Raum>
define Stats_BBxM weblink fileplot FileLog_BBxM:mysysstat:CURRENT <<<==== siehe unten
attr Stats_BBxM alias Systemlast
attr Stats_BBxM label "Systemlast von BBxM Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr Stats_BBxM room <Ihr Raum></nowiki>

== Plot ==
Standard ist die Angabe von ''define Stats_BBxM weblink fileplot FileLog_BBxM:'''sysstat''':CURRENT''. Dadurch wird nur die Systemlast grafisch (Plot) dargestellt. Wenn Sie auch die Belegung einer Partition im Plot sehen wollen, können Sie folgende Datei (die Sie sich als ''mysysstat.gplot''unterhalb von ''<Ihr-FHEM-Verzeichnis>/www/gplot''speichern müssten, damit die o.a. Konfiguration greift) verwenden

=== Definition ===
<nowiki>############################
# Display the sysload and diskusage values
# Corresponding FileLog definition:
# define deviceLog FileLog ./log/device-%Y-%m.log device
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<L1>'
set ylabel "Load"
set y2label "/ belegt %"
set y2range [0:100]
#FileLog 4:load:0:
#FileLog 4:/\x3a:0:
plot "< awk '/load:/ {print $1, $4}' <IN>" using 1:2 ls l0 axes x1y1 title 'Load' with lines
plot "< awk '//:/ {print $1, $4}' <IN>" using 1:2 ls l2fill axes x1y2 title 'Disk' with lines</nowiki>

=== Anmerkungen ===
* Die Zeile "#FileLog 4:/\x3a:0:" muss evtl. an ihre Gegebenheiten angepasst werden, wenn Sie nicht das root-Volume überwachen (wollen).
* Beachten Sie, dass die Sequenz "\x3a" der vorgenannten Zeile den Filter auf "/:" legt. Eine Angabe wie "#FileLog 4:/:''':'''0:" funktioniert nicht, da der Doppelpunkt eine besondere Bedeutung hat. Er muss also "maskiert" werden. Die ''awk''-Sequenz ("awk '//:/") ist für die Plot-Ausgabe nicht relevant.
* Regulär würde ein "#FileLog 4:/:0:" für die root-Partition ausreichen (was den Filter auf "/" legt), aber spätestens, wenn Sie ein 2. Volume (z.B. "/mount/usb") im Plot anzeigen wollen, trifft der Filter "/" auf beide Volumes zu. Dies führt dann zu eigenartigen Effekten im Plot.

== Einrichtung über SNMP unter Windows 7 ==
Um SYSSTAT unter Windows verwenden zu können, muss
* der SNMP-Dienst installiert und aktiviert sein
<nowiki>Systemsteuerung -> Programme -> Windows-Funktionen aktivieren oder deaktivieren -> Simple Network Management-Protokoll (SNMP)</nowiki>
* ein Communityname '''public''' ohne Passwort und mit Leserechten eingerichtet sein
<nowiki>Computerverwaltung -> Dienste und Anwendungen -> Dienste -> Eigenschaften von SNMP-Dienst
-> Sicherheit -> Hinzufügen... -> Communityrechte: NUR LESEN; Communityname: public</nowiki>
* in der Perl-Installation das Paket Net::SNMP installiert sein
<nowiki>ActivePerl: Perl Package Manager -> View all packages -> Net-SNMP -> Mark for install -> Run marked actions</nowiki>
* in fhem das Attribut '''snmp 1''' gesetzt sein

Beispielkonfiguration:
<nowiki>define sysstat SYSSTAT 60 600
attr sysstat filesystems 1,4,6,7
attr sysstat room System
attr sysstat showpercent 1
attr sysstat snmp 1
attr sysstat uptime 1</nowiki>

Anmerkung: die IDs der zu loggenden Datenspeicher bekommt man mit "get sysstat filesystems" heraus.

== Links ==
* FHEM-Forum: [http://forum.fhem.de/index.php/topic,10573.0.html Inoffizielles Modul]
* FHEM-Forum: [http://forum.fhem.de/index.php/topic,10888.0.html Ankündigung als offizielles Modul]

[[Kategorie:Glossary]]

SYSSTAT

2014-04-18T23:44:11Z

Spiff:

Seit dem 06.02.2013 gibt es ein neues und offizielles FHEM-Modul namens '''sysstat'''. Es ermöglicht das Logging und die (grafische) Anzeige der Auslastung (load) ihres '''Linux'''-Systems, auf dem FHEM läuft. Daneben ermöglicht es auch die gleichen Auswertungsmöglichkeiten für die Belegung (in Bytes oder Prozent) einer von Ihnen anzugebenden Festplatten-Partition. Gleiches kann auch mit einem Remote-System durchgeführt werden (per SSH mittels Key).

Mit der aktuellen Version lassen sich auch CPU Temperatur und Frequenz eines Raspberry Pi lokal und remote überwachen, die Systemtemperatur einer Synology Diskstation sowie per SNMP praktisch alle UNIX basierten Systeme und auch Windows und viele andere.

Weitere Informationen zum Modul und zur Syntax finden Sie in der [http://fhem.de/commandref.html#SYSSTAT commandref].

== Beispiel ==
Die Definitionen und Eigenschaften (Attribute) müssen von Hand in der ''fhem.cfg'' eingetragen werden, da hier der ''autocreate''-Mechanismus nicht greift (greifen kann).

=== Definition ===
Aus der ''fhem.cfg'':

<nowiki>define BBxM SYSSTAT 120 600
attr BBxM filesystems /dev/mmcblk0p2
attr BBxM room <Ihr Raum>
attr BBxM showpercent 1</nowiki>

=== Anmerkungen ===

* Die Load-Daten werden alle 120 (Default-Wert: 60) '''Sekunden''' gelesen und es wird dabei die Partition ''/dev/mmcblk0p2'' alle 600 Sekunden überwacht. Die Belegung der Partition wird in Prozent angegeben. Wie die Partitionen auf ihrem Linux-System benannt sind erfahren Sie z.B. über den ''mount''-Befehl.
* Wird kein Auslese-Interval für die Partitionen angegeben, so wird dieses auf den ersten Wert <ins>mit 60 multipliziert</ins> gesetzt. So würde im o.a. Beispiel aus dem ersten Wert 120 (für das System-load) ein Auslesewert von 7.200 Sekunden, also 120 Minuten bzw. 2 Stunden.

Weitere Definitionen in der ''fhem.cfg'':

<nowiki>define FileLog_BBxM FileLog /opt/fhem/log/BBxM-%Y-%m.log BBxM
attr FileLog_BBxM archivedir /opt/fhem/archive/
attr FileLog_BBxM logtype sysstat:Plot,text
attr FileLog_BBxM nrarchive 1
attr FileLog_BBxM room <Ihr Raum>
define Stats_BBxM weblink fileplot FileLog_BBxM:mysysstat:CURRENT <<<==== siehe unten
attr Stats_BBxM alias Systemlast
attr Stats_BBxM label "Systemlast von BBxM Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr Stats_BBxM room <Ihr Raum></nowiki>

== Plot ==
Standard ist die Angabe von ''define Stats_BBxM weblink fileplot FileLog_BBxM:'''sysstat''':CURRENT''. Dadurch wird nur die Systemlast grafisch (Plot) dargestellt. Wenn Sie auch die Belegung einer Partition im Plot sehen wollen, können Sie folgende Datei (die Sie sich als ''mysysstat.gplot''unterhalb von ''<Ihr-FHEM-Verzeichnis>/www/gplot''speichern müssten, damit die o.a. Konfiguration greift) verwenden

=== Definition ===
<nowiki>############################
# Display the sysload and diskusage values
# Corresponding FileLog definition:
# define deviceLog FileLog ./log/device-%Y-%m.log device
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<L1>'
set ylabel "Load"
set y2label "/ belegt %"
set y2range [0:100]
#FileLog 4:load:0:
#FileLog 4:/\x3a:0:
plot "< awk '/load:/ {print $1, $4}' <IN>" using 1:2 ls l0 axes x1y1 title 'Load' with lines
plot "< awk '//:/ {print $1, $4}' <IN>" using 1:2 ls l2fill axes x1y2 title 'Disk' with lines</nowiki>

=== Anmerkungen ===
* Die Zeile "#FileLog 4:/\x3a:0:" muss evtl. an ihre Gegebenheiten angepasst werden, wenn Sie nicht das root-Volume überwachen (wollen).
* Beachten Sie, dass die Sequenz "\x3a" der vorgenannten Zeile den Filter auf "/:" legt. Eine Angabe wie "#FileLog 4:/:''':'''0:" funktioniert nicht, da der Doppelpunkt eine besondere Bedeutung hat. Er muss also "maskiert" werden. Die ''awk''-Sequenz ("awk '//:/") ist für die Plot-Ausgabe nicht relevant.
* Regulär würde ein "#FileLog 4:/:0:" für die root-Partition ausreichen (was den Filter auf "/" legt), aber spätestens, wenn Sie ein 2. Volume (z.B. "/mount/usb") im Plot anzeigen wollen, trifft der Filter "/" auf beide Volumes zu. Dies führt dann zu eigenartigen Effekten im Plot.

== Einrichtung über SNMP unter Windows 7 ==
Um SYSSTAT unter Windows verwenden zu können, muss
* der SNMP-Dienst installiert und aktiviert sein
<nowiki>Systemsteuerung -> Programme -> Windows-Funktionen aktivieren oder deaktivieren -> Simple Network management-Protokoll (SNMP)</nowiki>
* ein Communityname '''public''' ohne Passwort und mit Leserechten eingerichtet sein
<nowiki>Computerverwaltung -> Dienste und Anwendungen -> Dienste -> Eigenschaften von SNMP-Dienst
-> Sicherheit -> Hinzufügen... -> Communityrechte: NUR LESEN; Communityname: public</nowiki>
* in der Perl-Installation das Paket Net::SNMP installiert sein
<nowiki>ActivePerl: Perl Package Manager -> View all packages -> Net-SNMP -> Mark for Install -> Run Marked Actions</nowiki>
* in fhem das Attribut '''snmp 1''' gesetzt sein

Beispielkonfiguration:
<nowiki>define sysstat SYSSTAT 60 600
attr sysstat filesystems 1,4,6,7
attr sysstat room System
attr sysstat showpercent 1
attr sysstat snmp 1
attr sysstat uptime 1</nowiki>

Anmerkung: die IDs der zu loggenden Datenspeicher bekommt man mit "get sysstat filesystems" heraus.

== Links ==
* FHEM-Forum: [http://forum.fhem.de/index.php/topic,10573.0.html Inoffizielles Modul]
* FHEM-Forum: [http://forum.fhem.de/index.php/topic,10888.0.html Ankündigung als offizielles Modul]

[[Kategorie:Glossary]]

DMXControl

2014-01-26T18:19:18Z

Spiff: /* ECMD-Modul */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.

Ein ''set (ECMDDevice) rgb (Farbe RRGGBB)'' soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Der Postprozessor ist notwendig, um die Antwort von DMXControl in ein FHEM-gerechte Format zu konvertieren.

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB (hex). Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss er beispielsweise in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, müssen folgende Attribute gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:58:29Z

Spiff: /* Lightscene */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.

Ein ''set (ECMDDevice) rgb (Farbe RRGGBB)'' soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB (hex). Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss er beispielsweise in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, müssen folgende Attribute gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:57:58Z

Spiff: /* Colorpicker & readingsProxy */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.

Ein ''set (ECMDDevice) rgb (Farbe RRGGBB)'' soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB (hex). Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss er beispielsweise in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:55:56Z

Spiff: /* Colorpicker & readingsProxy */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.

Ein ''set (ECMDDevice) rgb (Farbe RRGGBB)'' soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB (hex). Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss er beispielsweise in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:54:39Z

Spiff: /* Colorpicker & readingsProxy */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.

Ein ''set (ECMDDevice) rgb (Farbe RRGGBB)'' soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB (hex). Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:52:46Z

Spiff: /* ECMD-Modul */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.

Ein ''set (ECMDDevice) rgb (Farbe RRGGBB)'' soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:52:14Z

Spiff: /* ECMD-Modul */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.

Ein ''set (ECMDDevice) rgb (Farbe RRGGBB)'' soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:49:03Z

Spiff: /* Funktionsbeschreibung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul emuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:46:48Z

Spiff: /* Einleitung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt des Erklärungstextes die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:43:57Z

Spiff: /* Danksagung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: '''Rudolf König''' stellvertretend für alle anderen Mitentwickler
* ECMD: '''Dr. Boris Neubert'''
* readingsProxy, Lightscene, Colorpicker: '''Andre (justme1968)''', ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: '''Matthias Klass''', auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: '''Stefan Krupop''' stellvertretend für alle anderen Mitentwickler
* Windows: '''Bill'''... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:42:40Z

Spiff: /* DMXControl */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]][[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:37:43Z

Spiff: /* DMXControl */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
[[Datei:DMXControl_Kanaele.png|thumb|DMXControl Kanalübersicht]]
[[Datei:DMXControl_Terminal.png|thumb|DMXControl Terminal]]
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "[http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

Datei:DMXControl Terminal.png

2014-01-26T17:35:38Z

Spiff:

Datei:DMXControl Kanaele.png

2014-01-26T17:35:21Z

Spiff:

DMXControl

2014-01-26T17:28:35Z

Spiff: /* Colorpicker & readingsProxy */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
[[Datei:FHEMWEB_Colorpicker.png|thumb|FHEMWEB-Colorpicker]]
[[Datei:andFHEM_Colorpicker.png|thumb|andFHEM-Colorpicker]]
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

Datei:FHEMWEB Colorpicker.png

2014-01-26T17:16:23Z

Spiff:

Datei:AndFHEM Colorpicker.png

2014-01-26T17:11:23Z

Spiff: Colorpicker in der Android-App andFHEM

Colorpicker in der Android-App andFHEM

DMXControl

2014-01-26T17:09:48Z

Spiff: /* Konfig-Zusammenfassung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen zum Initialisieren des Colorpickers)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T17:09:25Z

Spiff: /* Colorpicker & readingsProxy */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

Damit der Colorpicker überhaupt aktiviert wird, muss in der 99_myUtils.pm initialisiert werden, siehe [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung hier].

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:57:18Z

Spiff: /* Live-Colorpicker */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App [http://andfhem.klass.li andFHEM] verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:52:37Z

Spiff: /* Konfig-Zusammenfassung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

* 99_myUtils.pm (in '''fett''' die notwendigen Änderungen)
# start-of-template
package main;

use strict;
use warnings;
use POSIX;
##### wichtig, da die in Color; verwendete Variable $FW_ME sonst noch nicht definiert ist #####
'''use vars qw($FW_ME);'''
'''use Color;'''

sub
myUtils_Initialize($$)
{
my ($hash) = @_;
'''FHEM_colorpickerInit();'''
}

# start with your own functions below this line

# behind your last function, we need the following
1;
# end-of-template

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:46:53Z

Spiff: /* Konfig-Zusammenfassung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef:DMXControl_Effects=ECMD\DMXControl_Effects.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

* FHEM\ECMD\DMXControl_Effects.classdef ''(oben noch nicht beschrieben)''
# Notifcations
set Klingel cmd {"runcommand 7 17 3"}
set Tueroeffner cmd {"runcommand 7 18 3"}
set Nachricht cmd {"runcommand 7 19 3"}

#statische Beleuchtungs-Presets
set Licht_0 cmd {"runcommand 7 7 3"}
set Licht_1 cmd {"runcommand 7 8 3"}
set Licht_2 cmd {"runcommand 7 9 3"}
set Licht_3 cmd {"runcommand 7 10 3"}
set Licht_4 cmd {"runcommand 7 11 3"}
set Licht_5 cmd {"runcommand 7 12 3"}
set Licht_6 cmd {"runcommand 7 13 3"}
set Licht_7 cmd {"runcommand 7 14 3"}
set Licht_8 cmd {"runcommand 7 15 3"}
set Licht_9 cmd {"runcommand 7 16 3"}

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:39:33Z

Spiff: /* Konfig-Zusammenfassung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Konfiguration mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:34:33Z

Spiff: /* Einleitung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im [http://www.fhemwiki.de/wiki/DMXControl#Konfig-Zusammenfassung vorletzten Abschnitt] einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Config mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:33:26Z

Spiff: /* Konfig-Zusammenfassung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im vorletzten Abschnitt einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Config mit allen oben beschriebenen Funktionen:
* fhem.cfg
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S realtimePicker lightSceneParamsToSave

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 getList rgb
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}
attr LED1 realtimePicker 1
attr LED1 lightSceneParamsToSave RGB -> rgb

* FHEM\ECMD\DMXControl_Devices.classdef
params DMX_R DMX_G DMX_B DMX_M DMX_S

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:23:14Z

Spiff: /* Einleitung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

'''Hinweis: wer statt dem Erklärungstext die reine Konfiguration sucht, kann sie im vorletzten Abschnitt einsehen.'''

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Config mit allen oben beschriebenen Funktionen:
* fhem.cfg

* FHEM\ECMD\DMXControl_Devices.classdef

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T16:21:54Z

Spiff: /* ECMD-Modul */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst noch benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:
attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Config mit allen oben beschriebenen Funktionen:
* fhem.cfg

* FHEM\ECMD\DMXControl_Devices.classdef

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T15:59:46Z

Spiff: /* Einleitung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:

attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

----

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Config mit allen oben beschriebenen Funktionen:
* fhem.cfg

* FHEM\ECMD\DMXControl_Devices.classdef

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T15:59:26Z

Spiff: /* Einleitung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)
** [http://andfhem.klass.li andFHEM]

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:

attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

----

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Config mit allen oben beschriebenen Funktionen:
* fhem.cfg

* FHEM\ECMD\DMXControl_Devices.classdef

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)

DMXControl

2014-01-26T15:57:55Z

Spiff: /* Einleitung */

== Einleitung ==
Diese Seite zeigt, wie man die Integration von DMX-Geräten über die Windows-Software DMXControl in FHEM realisieren kann.

Funktionalität:
* Steuerung der DMX-Geräte via FHEMWEB oder der Android-App andFHEM mit Live-Colorpicker
* Abrufen von Effekten (z.B. Farbverläufe)

Benötigte Software & Module:
* FHEM
** [http://fhem.de/commandref.html#ECMD ECMD]
** [http://fhem.de/commandref.html#readingsProxy readingsProxy]
** [http://www.fhemwiki.de/wiki/Color Colorpicker]
** [http://fhem.de/commandref.html#LightScene Lightscene] (optional)

* [http://www.dmxcontrol.org DMXControl]
** [http://www.dmxcontrol.de/wiki/Terminal_Schnittstelle Terminal-Schnittstelle]

== Funktionsbeschreibung ==
In DMXControl werden die DMX-Geräte definiert und entsprechende Effekte wie Farbverläufe generiert.

FHEM stellt über das Modul ECMD eine Verbindung zur Terminal-Schnittstelle von DMXControl her.

Da im ECMD-Modul einige Befehle fehlen, werden diese über das readingsProxy-Modul simuliert. Dieses gibt die Befehle dann über das ECMD-Modul an DMXControl weiter.

Zur Bedienung von Farb-LEDs bietet sich der FHEMWEB-Colorpicker an, der auch über eine Live-Farbänderungsfunktion verfügt.

== DMXControl ==
In meiner Konfiguration hat jede RGB-LED 5 DMX-Kanäle:
* 1 = Rot
* 2 = Grün
* 3 = Blau
* 4 = Master (Helligkeit)
* 5 = Strobe (Blinken)

Das Modul "PDA-Fernsteuerung" aka "Terminal-Schnittstelle" muss aktiviert sein. Ich benutze die Standard-Konfiguration auf COM1, 115200 kbps und Port 2145.

== ECMD-Modul ==
Damit die Farben im Format RRGGBB gesendet werden können, müssen für jede Farbe und die sonst benötigten DMX-Kanäle eigene globale Userattribute erstellt werden. In alphabetischer Reihenfolge sieht das dann so aus:

attr global userattr DMX_B DMX_G DMX_M DMX_R DMX_S

----

Jedes ECMDDevice benötigt eine eigene Konfigurationsdatei, eine sog. classdef.
In ihr wird beschrieben, welche Attribute konfiguriert werden können sollen.
Für die DMX-Geräte heisst sie bei mir DMXControl_Devices.classdef und liegt im FHEM\ECMD-Verzeichnis.

Sie fängt so an:
params DMX_R DMX_G DMX_B DMX_M DMX_S

Dann kommt die Übersetzung der Befehle, die an die Terminal-Schnittstelle von DMXControl gesendet werden, jeweils für ein set und ein get.
ein set (ECMDDevice) rgb (Farbe RRGGBB) soll folgende Aktionen ausführen:

* Senden der Farbe Rot an den 1. Kanal der RGB-LED [in DMXControl: "sc (DMX-Kanal 1) (Rot-Wert)"]
* Senden der Farbe Grün an den 2. Kanal der RGB-LED
* Senden der Farbe Blau an den 3. Kanal der RGB-LED
* Einstellen auf maximale Helligkeit (da im Format RRGGBB die Helligkeitsinformation schon enthalten ist. Der Colorpicker funktioniert z.B. so.)

Die zu sendende Farbe wird vorher über den Colorpicker als oben beschriebene Attribute des jeweiligen Geräts eingestellt. Siehe unten.

# SET
set rgb cmd {"sc %DMX_R " . AttrVal("%NAME","DMX_R","") . "\nsc %DMX_G " . AttrVal("%NAME","DMX_G","") . "\nsc %DMX_B " . AttrVal("%NAME","DMX_B","") . "\nsc %DMX_M 255"}
set rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

# GET
get rgb cmd {"gc %DMX_R " . "\ngc %DMX_G " . "\ngc %DMX_B "}
get rgb postproc {sprintf("%%02x%%02x%%02x", (split(" ", "$_"))[2],(split(" ", "$_"))[5],(split(" ", "$_"))[8])}

Nun kann das ECMD-Modul zum Definieren von ECMD-Devices in der fhem.cfg definiert werden:
Hinweis: bei mir laufen DMXControl und FHEM auf einem Server, deswegen ist die IP "localhost".

define DMXControl ECMD telnet localhost:2145
attr DMXControl classdefs DMXControl_Devices=ECMD\DMXControl_Devices.classdef

Nun kann die erste RGB-LED in der fhem.cfg definiert werden:
define RGB1 ECMDDevice DMXControl_Devices 1 2 3 4 5
attr RGB1 DMX_B 0
attr RGB1 DMX_G 0
attr RGB1 DMX_M 0
attr RGB1 DMX_R 0
attr RGB1 DMX_S 0
attr RGB1 room hidden

Die zweite RGB-LED wäre bei mir:
define RGB2 ECMDDevice DMXControl_Devices 6 7 8 9 10
attr RGB2 DMX_B 0
attr RGB2 DMX_G 0
attr RGB2 DMX_M 0
attr RGB2 DMX_R 0
attr RGB2 DMX_S 0
attr RGB2 room hidden

== Colorpicker & readingsProxy ==
Eigentlich kann man jetzt schon die LEDs ansteuern. Man muss nur die Attribute des jeweiligen RGB-Geräts verändern und ein "set RGB1 rgb" ausführen.
Da man so aber keine Möglichkeit hat, die Farbe direkt in einem Farbfeld auszuwählen, fügen wir diese Funktionalität nun mit dem [http://www.fhemwiki.de/wiki/Color Colorpicker] hinzu.
Damit dem ECMD-Device die dafür erforderlichen Befehle "beigebracht" werden, muss das Modul [http://fhem.de/commandref.html#readingsProxy readingsProxy] zwischen das [http://fhem.de/commandref.html#ECMD ECMD-Modul] und den Colorpicker geschaltet werden.

Das Standard-Format für die Farbeinstellung im Colorpicker ist RRGGBB. Da DMXControl jede Farbe einzeln benötigt und das auch noch im Dezimal-Format, wird der readingsProxy so eingestellt, dass er bei einem "set (Readingsproxy) rgb RRGGBB" die Farben extrahiert, ins Dezimalformat umwandelt und sie als einzelne Attribute in das ECMD-Device (RGB1) schreibt.
Zum Schluss wird der Befehl gegeben, die jetzt als Attribut vorhandenen Farben über das ECMD-Modul an DMXControl zu senden.
Die darauffolgenden setreadings werden für die Iconfarbe benötigt, siehe unten.

define LED1 readingsProxy RGB1:state
attr LED1 setFn {fhem ("attr RGB1 DMX_R ".hex(substr($ARGS,0,2)));;fhem ("attr RGB1 DMX_G ".hex(substr($ARGS,2,2)));;fhem ("attr RGB1 DMX_B ".hex(substr($ARGS,4,2)));;fhem ("set RGB1 rgb");;fhem ("setreading $name RGB $ARGS");;fhem ("setreading $name rgb $ARGS");;return undef}
attr LED1 setList rgb:colorpicker,RGB on off
attr LED1 webCmd rgb:rgb FF0000:rgb C8FF12:rgb 0000FF:rgb 000000

=== Iconfarbe in LED-Farbe ===

Damit die Icon-Farbe automatisch die jeweils eingestellte LED-Farbe einnimmt, fügen wir folgende Attribute hinzu:
attr LED1 getList rgb
attr LED1 getFn {fhem ("get RGB1 rgb");;fhem ("setreading LED1a RGB ".ReadingsVal("RGB1","rgb","000000"));;(ReadingsVal($name,"RGB","000000"),1) }
attr LED1 devStateIcon {Color_devStateIcon (ReadingsVal($name,"RGB","000000"))}

Anmerkung: dies funktioniert nur mit den SVG-Icons!

=== Live-Colorpicker ===

Das i-Tüpfelchen ist jetzt der Live-Colorpicker, mit dem man über das Farbfeld fahren kann und die Farbe, die das Fadenkreuz markiert, sofort eingestellt wird.
Dazu benötigen wir ein globales Attribut:
attr global userattr realtimePicker

und schalten dieses auf den readingsProxy scharf:
attr LED1 realtimePicker 1

Die Android-App andFHEM verfügt ebenfalls über einen Live-Colorpicker, der automatisch erscheint, wenn man den Colorpicker in der fhem.cfg definiert hat.

== Lightscene ==
Damit die eingestellte Farbe auch mit dem [http://fhem.de/commandref.html#LightScene Lightscene-Modul] funktioniert, muss folgendes Attribut gesetzt werden:

Global:
attr global userattr lightSceneParamsToSave
Gerät:
attr LED1 lightSceneParamsToSave RGB -> rgb

== Konfig-Zusammenfassung ==
Zusammenfassung der Config mit allen oben beschriebenen Funktionen:
* fhem.cfg

* FHEM\ECMD\DMXControl_Devices.classdef

== Danksagung ==
Ich bedanke mich für die Bereitstellung der Software und die Hilfe bei:
* FHEM: Rudolf König stellvertretend für alle anderen Mitentwickler
* ECMD: Dr. Boris Neubert
* readingsProxy, Lightscene, Colorpicker: Andre (justme1968), ganz besonders, weil er viele meiner Wünsche nachträglich implementiert hat
* andFHEM: Matthias Klass, auch für meinen Wunsch des Live-Colorpickers in Verbindung mit ECMD-Devices
* DMXControl: Stefan Krupop stellvertretend für alle anderen Mitentwickler
* Windows: Bill... ach ne, doch nicht. :)