FHEMWiki - Benutzerbeiträge [de]

IR-WLAN-Gateway

2022-09-26T09:23:46Z

Pfriemler: /* NEC */ LG-TV-Codes ergänzt

{{Infobox Hardware|Bild=IR_WLAN_Gateway_Modul.jpg
|Bildbeschreibung=IR-WLAN-Gateway
|HWProtocol=HTTP
|HWType=Sender/Receiver
|HWCategory=Other
|HWComm=2,4 GHz
|HWChannels=1
|HWVoltage=5V
|HWPoweredBy=Kleinspannung
|HWPowerConsumption= ~0,2W(Standby)
|HWSize=55x20 mm (Durchm. x Höhe)
|HWDeviceFHEM=HTTP oder IR-Blaster (inoff.)
|HWManufacturer=HomeBrew}}

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.

Prinzipiell genügen sehr wenige externe Bauteile zum ESP8266 oder einem Entwicklermodul, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
address - (optional) additional device address (decimal!)
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal zweimal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Betrieb über MQTT ===
Die Einbindung als [[MQTT_DEVICE]] mit [[Remotecontrol|remotecontrol]] ist [[IR-MQTT-Gateway|hier]] dargestellt.

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von LG- und Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

LG-Fernseher verwenden ebenfalls NEC-Codes mit 32 bit, Syntax wie bei Yamaha-Receivern. Auch hier gibt es glücklicherweise extra ON- und OFF-Befehle, um gezielt ein- und auszuschalten (statt Toggle). (Natürlich lassen sich alle modernen Geräte auch via Netzwerk steuern, aber man spart ordentlich Standbystrom, wenn man die Connectivity im Standby deaktiviert und den TV stattdessen infrarot einschaltet). Vollständige Liste in den Links unten.
attr IRWz IR_LGTVPOWER_OFF [{"data":"20DFA35C","type":"NEC","length":32}]
attr IRWz IR_LGTVPOWER_ON [{"data":"20DF23DC","type":"NEC","length":32}]
attr IRWz IR_LGTVMUTE [{"data":"20DF906F","type":"NEC","length":32}]

==== Panasonic ====

Auch wenn sich ein Panasonic-TV (wie viele andere Geräte auch) optimal über Netzwerk steuern lässt, muss er zunächst ggf. aus dem deep standby geweckt werden. Leider gibt es hierfür keine dedizierten ON- und OFF-Befehle, sondern nur power toggle. Zum Einschalten muss der Befehl allerdings etwas länger gesendert werden (ebenso wie man den Knopf auf der Fernbedienung länger drücken muss), dies lässt sich durch zusätzliche 'pulse'- und 'pdelay'-Angaben erreichen:
IR_PanasonicTV_Power_long [{'data':'0100BCBD','address':'4004','type':'PANASONIC','length':48,'pulse':10,'pdelay':1}]
Für TV-Mute könnte ein Befehl lauten:
IR_PanasonicTV_Mute [{'data':'01004C4D','address':'4004','type':'PANASONIC','length':48}]
Auch diese Befehle zur Lautstärkesteuerung sind erprobt - durch Variation der 5 hinter pulse kann gesteuert, wie groß die Lautstärkeänderung ist:
IR_PanasonicTV_VolDown [{'data':'01008485','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
IR_PanasonicTV_VolUp [{'data':'01000405','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
''Bitte beachten: Die Adresse des Gerätes muss hexadezimal angegeben, also 4004 statt 16388

''Weitere Befehle finden sich über die Links am Ende des Artikels.

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'0C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.

IR_LeinwandAB [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,
421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandAUF [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,
421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandSTOP [{'data:
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,
421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

Die folgenden Codes steuern Lumix Weihnachtsbaumkerzen von der Firma Krinner (2. Generation). Diese gibts in verschiedenen Farben und unterschiedlichen Größen (AA vs AAA Batterien). Die Kerzen haben drei Kanäle, die folgenden Beispiele funktionieren für Kanal B:

LumixChanBFlicker
[{'data':[500,1000, 500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050,4900, 2050,1000, 500,1000,
500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBOFF
[{'data':[1100,1000, 500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000,
500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBON
[{'data':[500,1000, 500,1000, 500,1000, 500,1000, 500,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000, 500,1000,
500,1000, 500,1000, 500,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

ON = Anschalten volle Helligkeit, OFF = Aus, Flicker = Flackern. Die Kerzen können auch gedimmt werden - war mir aber nicht wichtig.

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}
* Tabellen mit Sony-Fernbediencodes: [http://www.hifi-remote.com/sony/ diverse SONY-Codes]
* Tabelle mit Panasonic-Fernbediencodes: [http://www.rhoads.nu/bjorn/hp48/remote/remotes/panasoni/panasoni.txt (Textdatei zum Herunterladen)]
* LIRC Codes für VIERA Plasmafernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]
* Codes für LG Fernseher: [https://gitlab.com/-/snippets/1690600 Github-Diskussion]

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Infrarot]]
[[Kategorie:MQTT]]

IR-WLAN-Gateway

2022-09-26T09:16:59Z

Pfriemler: /* Links */ Codelink-Beschreibung

{{Infobox Hardware|Bild=IR_WLAN_Gateway_Modul.jpg
|Bildbeschreibung=IR-WLAN-Gateway
|HWProtocol=HTTP
|HWType=Sender/Receiver
|HWCategory=Other
|HWComm=2,4 GHz
|HWChannels=1
|HWVoltage=5V
|HWPoweredBy=Kleinspannung
|HWPowerConsumption= ~0,2W(Standby)
|HWSize=55x20 mm (Durchm. x Höhe)
|HWDeviceFHEM=HTTP oder IR-Blaster (inoff.)
|HWManufacturer=HomeBrew}}

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.

Prinzipiell genügen sehr wenige externe Bauteile zum ESP8266 oder einem Entwicklermodul, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
address - (optional) additional device address (decimal!)
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal zweimal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Betrieb über MQTT ===
Die Einbindung als [[MQTT_DEVICE]] mit [[Remotecontrol|remotecontrol]] ist [[IR-MQTT-Gateway|hier]] dargestellt.

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

==== Panasonic ====

Auch wenn sich ein Panasonic-TV (wie viele andere Geräte auch) optimal über Netzwerk steuern lässt, muss er zunächst ggf. aus dem deep standby geweckt werden. Leider gibt es hierfür keine dedizierten ON- und OFF-Befehle, sondern nur power toggle. Zum Einschalten muss der Befehl allerdings etwas länger gesendert werden (ebenso wie man den Knopf auf der Fernbedienung länger drücken muss), dies lässt sich durch zusätzliche 'pulse'- und 'pdelay'-Angaben erreichen:
IR_PanasonicTV_Power_long [{'data':'0100BCBD','address':'4004','type':'PANASONIC','length':48,'pulse':10,'pdelay':1}]
Für TV-Mute könnte ein Befehl lauten:
IR_PanasonicTV_Mute [{'data':'01004C4D','address':'4004','type':'PANASONIC','length':48}]
Auch diese Befehle zur Lautstärkesteuerung sind erprobt - durch Variation der 5 hinter pulse kann gesteuert, wie groß die Lautstärkeänderung ist:
IR_PanasonicTV_VolDown [{'data':'01008485','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
IR_PanasonicTV_VolUp [{'data':'01000405','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
''Bitte beachten: Die Adresse des Gerätes muss hexadezimal angegeben, also 4004 statt 16388

''Weitere Befehle finden sich über die Links am Ende des Artikels.

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'0C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.

IR_LeinwandAB [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,
421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandAUF [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,
421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandSTOP [{'data:
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,
421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

Die folgenden Codes steuern Lumix Weihnachtsbaumkerzen von der Firma Krinner (2. Generation). Diese gibts in verschiedenen Farben und unterschiedlichen Größen (AA vs AAA Batterien). Die Kerzen haben drei Kanäle, die folgenden Beispiele funktionieren für Kanal B:

LumixChanBFlicker
[{'data':[500,1000, 500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050,4900, 2050,1000, 500,1000,
500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBOFF
[{'data':[1100,1000, 500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000,
500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBON
[{'data':[500,1000, 500,1000, 500,1000, 500,1000, 500,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000, 500,1000,
500,1000, 500,1000, 500,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

ON = Anschalten volle Helligkeit, OFF = Aus, Flicker = Flackern. Die Kerzen können auch gedimmt werden - war mir aber nicht wichtig.

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}
* Tabellen mit Sony-Fernbediencodes: [http://www.hifi-remote.com/sony/ diverse SONY-Codes]
* Tabelle mit Panasonic-Fernbediencodes: [http://www.rhoads.nu/bjorn/hp48/remote/remotes/panasoni/panasoni.txt (Textdatei zum Herunterladen)]
* LIRC Codes für VIERA Plasmafernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]
* Codes für LG Fernseher: [https://gitlab.com/-/snippets/1690600 Github-Diskussion]

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Infrarot]]
[[Kategorie:MQTT]]

IR-WLAN-Gateway

2022-09-26T09:15:47Z

Pfriemler: /* Links */ LG Code Link korrigiert

{{Infobox Hardware|Bild=IR_WLAN_Gateway_Modul.jpg
|Bildbeschreibung=IR-WLAN-Gateway
|HWProtocol=HTTP
|HWType=Sender/Receiver
|HWCategory=Other
|HWComm=2,4 GHz
|HWChannels=1
|HWVoltage=5V
|HWPoweredBy=Kleinspannung
|HWPowerConsumption= ~0,2W(Standby)
|HWSize=55x20 mm (Durchm. x Höhe)
|HWDeviceFHEM=HTTP oder IR-Blaster (inoff.)
|HWManufacturer=HomeBrew}}

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.

Prinzipiell genügen sehr wenige externe Bauteile zum ESP8266 oder einem Entwicklermodul, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
address - (optional) additional device address (decimal!)
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal zweimal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Betrieb über MQTT ===
Die Einbindung als [[MQTT_DEVICE]] mit [[Remotecontrol|remotecontrol]] ist [[IR-MQTT-Gateway|hier]] dargestellt.

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

==== Panasonic ====

Auch wenn sich ein Panasonic-TV (wie viele andere Geräte auch) optimal über Netzwerk steuern lässt, muss er zunächst ggf. aus dem deep standby geweckt werden. Leider gibt es hierfür keine dedizierten ON- und OFF-Befehle, sondern nur power toggle. Zum Einschalten muss der Befehl allerdings etwas länger gesendert werden (ebenso wie man den Knopf auf der Fernbedienung länger drücken muss), dies lässt sich durch zusätzliche 'pulse'- und 'pdelay'-Angaben erreichen:
IR_PanasonicTV_Power_long [{'data':'0100BCBD','address':'4004','type':'PANASONIC','length':48,'pulse':10,'pdelay':1}]
Für TV-Mute könnte ein Befehl lauten:
IR_PanasonicTV_Mute [{'data':'01004C4D','address':'4004','type':'PANASONIC','length':48}]
Auch diese Befehle zur Lautstärkesteuerung sind erprobt - durch Variation der 5 hinter pulse kann gesteuert, wie groß die Lautstärkeänderung ist:
IR_PanasonicTV_VolDown [{'data':'01008485','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
IR_PanasonicTV_VolUp [{'data':'01000405','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
''Bitte beachten: Die Adresse des Gerätes muss hexadezimal angegeben, also 4004 statt 16388

''Weitere Befehle finden sich über die Links am Ende des Artikels.

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'0C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.

IR_LeinwandAB [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,
421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandAUF [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,
421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandSTOP [{'data:
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,
421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

Die folgenden Codes steuern Lumix Weihnachtsbaumkerzen von der Firma Krinner (2. Generation). Diese gibts in verschiedenen Farben und unterschiedlichen Größen (AA vs AAA Batterien). Die Kerzen haben drei Kanäle, die folgenden Beispiele funktionieren für Kanal B:

LumixChanBFlicker
[{'data':[500,1000, 500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050,4900, 2050,1000, 500,1000,
500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBOFF
[{'data':[1100,1000, 500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000,
500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBON
[{'data':[500,1000, 500,1000, 500,1000, 500,1000, 500,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000, 500,1000,
500,1000, 500,1000, 500,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

ON = Anschalten volle Helligkeit, OFF = Aus, Flicker = Flackern. Die Kerzen können auch gedimmt werden - war mir aber nicht wichtig.

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}
* Tabellen mit Sony-Fernbediencodes: [http://www.hifi-remote.com/sony/ diverse SONY-Codes]
* Tabelle mit Panasonic-Fernbediencodes: [http://www.rhoads.nu/bjorn/hp48/remote/remotes/panasoni/panasoni.txt (Textdatei zum Herunterladen)]
* LIRC Codes für VIERA Plasmafernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]
* Codes für LG Fernseher: [https://gitlab.com/-/snippets/1690600]

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Infrarot]]
[[Kategorie:MQTT]]

IR-WLAN-Gateway

2022-09-26T09:14:32Z

Pfriemler: /* Links */ Link zu LG TV codes ergänzt

{{Infobox Hardware|Bild=IR_WLAN_Gateway_Modul.jpg
|Bildbeschreibung=IR-WLAN-Gateway
|HWProtocol=HTTP
|HWType=Sender/Receiver
|HWCategory=Other
|HWComm=2,4 GHz
|HWChannels=1
|HWVoltage=5V
|HWPoweredBy=Kleinspannung
|HWPowerConsumption= ~0,2W(Standby)
|HWSize=55x20 mm (Durchm. x Höhe)
|HWDeviceFHEM=HTTP oder IR-Blaster (inoff.)
|HWManufacturer=HomeBrew}}

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.

Prinzipiell genügen sehr wenige externe Bauteile zum ESP8266 oder einem Entwicklermodul, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
address - (optional) additional device address (decimal!)
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal zweimal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Betrieb über MQTT ===
Die Einbindung als [[MQTT_DEVICE]] mit [[Remotecontrol|remotecontrol]] ist [[IR-MQTT-Gateway|hier]] dargestellt.

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

==== Panasonic ====

Auch wenn sich ein Panasonic-TV (wie viele andere Geräte auch) optimal über Netzwerk steuern lässt, muss er zunächst ggf. aus dem deep standby geweckt werden. Leider gibt es hierfür keine dedizierten ON- und OFF-Befehle, sondern nur power toggle. Zum Einschalten muss der Befehl allerdings etwas länger gesendert werden (ebenso wie man den Knopf auf der Fernbedienung länger drücken muss), dies lässt sich durch zusätzliche 'pulse'- und 'pdelay'-Angaben erreichen:
IR_PanasonicTV_Power_long [{'data':'0100BCBD','address':'4004','type':'PANASONIC','length':48,'pulse':10,'pdelay':1}]
Für TV-Mute könnte ein Befehl lauten:
IR_PanasonicTV_Mute [{'data':'01004C4D','address':'4004','type':'PANASONIC','length':48}]
Auch diese Befehle zur Lautstärkesteuerung sind erprobt - durch Variation der 5 hinter pulse kann gesteuert, wie groß die Lautstärkeänderung ist:
IR_PanasonicTV_VolDown [{'data':'01008485','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
IR_PanasonicTV_VolUp [{'data':'01000405','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
''Bitte beachten: Die Adresse des Gerätes muss hexadezimal angegeben, also 4004 statt 16388

''Weitere Befehle finden sich über die Links am Ende des Artikels.

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'0C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.

IR_LeinwandAB [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,
421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandAUF [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,
421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandSTOP [{'data:
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,
421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

Die folgenden Codes steuern Lumix Weihnachtsbaumkerzen von der Firma Krinner (2. Generation). Diese gibts in verschiedenen Farben und unterschiedlichen Größen (AA vs AAA Batterien). Die Kerzen haben drei Kanäle, die folgenden Beispiele funktionieren für Kanal B:

LumixChanBFlicker
[{'data':[500,1000, 500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050,4900, 2050,1000, 500,1000,
500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBOFF
[{'data':[1100,1000, 500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000,
500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBON
[{'data':[500,1000, 500,1000, 500,1000, 500,1000, 500,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000, 500,1000,
500,1000, 500,1000, 500,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

ON = Anschalten volle Helligkeit, OFF = Aus, Flicker = Flackern. Die Kerzen können auch gedimmt werden - war mir aber nicht wichtig.

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}
* Tabellen mit Sony-Fernbediencodes: [http://www.hifi-remote.com/sony/ diverse SONY-Codes]
* Tabelle mit Panasonic-Fernbediencodes: [http://www.rhoads.nu/bjorn/hp48/remote/remotes/panasoni/panasoni.txt (Textdatei zum Herunterladen)]
* LIRC Codes für VIERA Plasmafernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]
* Codes für LG Fernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Infrarot]]
[[Kategorie:MQTT]]

IR-WLAN-Gateway

2022-09-26T08:30:00Z

Pfriemler: /* Panasonic */ Angabe der Geräteadresse muss hexadezimal erfolgen (4004), dezimal (16388) funktionierte bei mir nicht

{{Infobox Hardware|Bild=IR_WLAN_Gateway_Modul.jpg
|Bildbeschreibung=IR-WLAN-Gateway
|HWProtocol=HTTP
|HWType=Sender/Receiver
|HWCategory=Other
|HWComm=2,4 GHz
|HWChannels=1
|HWVoltage=5V
|HWPoweredBy=Kleinspannung
|HWPowerConsumption= ~0,2W(Standby)
|HWSize=55x20 mm (Durchm. x Höhe)
|HWDeviceFHEM=HTTP oder IR-Blaster (inoff.)
|HWManufacturer=HomeBrew}}

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.

Prinzipiell genügen sehr wenige externe Bauteile zum ESP8266 oder einem Entwicklermodul, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
address - (optional) additional device address (decimal!)
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal zweimal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Betrieb über MQTT ===
Die Einbindung als [[MQTT_DEVICE]] mit [[Remotecontrol|remotecontrol]] ist [[IR-MQTT-Gateway|hier]] dargestellt.

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

==== Panasonic ====

Auch wenn sich ein Panasonic-TV (wie viele andere Geräte auch) optimal über Netzwerk steuern lässt, muss er zunächst ggf. aus dem deep standby geweckt werden. Leider gibt es hierfür keine dedizierten ON- und OFF-Befehle, sondern nur power toggle. Zum Einschalten muss der Befehl allerdings etwas länger gesendert werden (ebenso wie man den Knopf auf der Fernbedienung länger drücken muss), dies lässt sich durch zusätzliche 'pulse'- und 'pdelay'-Angaben erreichen:
IR_PanasonicTV_Power_long [{'data':'0100BCBD','address':'4004','type':'PANASONIC','length':48,'pulse':10,'pdelay':1}]
Für TV-Mute könnte ein Befehl lauten:
IR_PanasonicTV_Mute [{'data':'01004C4D','address':'4004','type':'PANASONIC','length':48}]
Auch diese Befehle zur Lautstärkesteuerung sind erprobt - durch Variation der 5 hinter pulse kann gesteuert, wie groß die Lautstärkeänderung ist:
IR_PanasonicTV_VolDown [{'data':'01008485','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
IR_PanasonicTV_VolUp [{'data':'01000405','address':'4004','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
''Bitte beachten: Die Adresse des Gerätes muss hexadezimal angegeben, also 4004 statt 16388

''Weitere Befehle finden sich über die Links am Ende des Artikels.

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'0C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.

IR_LeinwandAB [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,
421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandAUF [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,
421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandSTOP [{'data:
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,
421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

Die folgenden Codes steuern Lumix Weihnachtsbaumkerzen von der Firma Krinner (2. Generation). Diese gibts in verschiedenen Farben und unterschiedlichen Größen (AA vs AAA Batterien). Die Kerzen haben drei Kanäle, die folgenden Beispiele funktionieren für Kanal B:

LumixChanBFlicker
[{'data':[500,1000, 500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050,4900, 2050,1000, 500,1000,
500,400, 1100,1000, 500,1000, 500,1000, 500,400, 1100,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBOFF
[{'data':[1100,1000, 500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000,
500,1000, 500,1000, 500,400, 1100,400, 1100,400, 2050], 'type':'raw', 'khz':38}]

LumixChanBON
[{'data':[500,1000, 500,1000, 500,1000, 500,1000, 500,400, 2050,4900, 2050,1000, 500,1000, 500,400, 1100,1000, 500,1000,
500,1000, 500,1000, 500,1000, 500,400, 2050], 'type':'raw', 'khz':38}]

ON = Anschalten volle Helligkeit, OFF = Aus, Flicker = Flackern. Die Kerzen können auch gedimmt werden - war mir aber nicht wichtig.

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}
* Tabellen mit Sony-Fernbediencodes: [http://www.hifi-remote.com/sony/ diverse SONY-Codes]
* Tabelle mit Panasonic-Fernbediencodes: [http://www.rhoads.nu/bjorn/hp48/remote/remotes/panasoni/panasoni.txt (Textdatei zum Herunterladen)]
* LIRC Codes für VIERA Plasmafernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Infrarot]]
[[Kategorie:MQTT]]

Intertechno Code Berechnung

2021-08-08T12:27:04Z

Pfriemler: /* me micro-electric AS 73 */ Ergänzung um COMAG-Außensteckdose IP44 mit abweichenden Schaltbefehlen

'''Intertechno''' Systemkomponenten sind kostengünstige und weit verbreitete Funkschalter/-dimmer im 433 MHz Bereich, die man in fast jedem Baumarkt unter den Markennamen Intertechno, düwi, KlikAanKlikUit usw. erhalten kann.

Es gibt eine Anzahl weiterer Hersteller/Handelsmarken mit ähnlicher Kodierung oder Einstellmöglichkeiten mit DIP Schaltern, die ebenfalls mit dem Intertechno Code geschaltet werden können. Dazu zählen von Usern bereits erfolgreich getestete Geräte von Elro AB440, FLS-100/m-e, Wetekom/Westfalia und weitere, theoretisch mögliche aber ungetestete Systeme wie Unitec oder Arctech Steckdosen (siehe [http://avr.börke.de/E-Funk.htm Börkes-HP])

== Voraussetzungen in FHEM ==
Schalten kann man die Intertechno Funkkomponenten in FHEM über verschiedene Wege. So z.B. über CUL/CUNO, Tellstick, [[AVR-NET-IO]].

Hier beschrieben ist die Ansteuerung über CUL/CUNO, dessen Firmware für Intertechno erweitert wurde (Danke an Olaf Droegehorn). Momentan ist in CUL/CUNO das SENDEN von Intertechno Funk implementiert. Die Firmware muss mindestens den Stand 1.44 haben (Kontrolle der Version in den FHEM Detaildaten zum [[CUL]]/[[CUNO]]). Die CUL433/CUNO433 haben dabei volle Reichweite, die Versionen CUL868/CUNO868 funktionieren ebenfalls, haben aufgrund der nicht optimalen Antennenlänge und falschen Abstimmung für den Frequenzbereich aber nur eine eingeschränkte Reichweite.

=== Definition ===
Die Definition des IT Gerätes in FHEM sieht für '''alte Geräte''' so aus:
<syntaxhighlight lang="text">
define myITSwitch IT <housecode><group_switch> <on-code> <off-code> [<dimup-code> <dimdown-code>]
attr myITSwitch IODev CUL_x (CUNO_x)
attr myITSwitch model itswitch
</syntaxhighlight>
Die weitere Anleitung soll die Bildung der Bitfolge für die Zusammensetzung des Schaltcodes erklären.
Wichtig zu wissen ist auch, dass es sich um einen 3state code handelt, d.h. jedes Bit kann '''0,1 oder F''' sein!

Die selbst '''lernenden''' neue '''Geräte''' definiert man in FHEM so:
<syntaxhighlight lang="text">
define <name> IT <26-Bit Adresse> <1-Bit Gruppen Bit> <4-Bit Gerät>
</syntaxhighlight>
Dabei kann man die 26-Bit Adresse frei wählen, so dass Kollisionen mit Nachbarn sehr unwahrscheinlich werden.
Einen GRR-3500 der über einen CUL gesteuert werden soll definiert man z.B. so
<syntaxhighlight lang="text">
define sw_it_outdoor IT 01010101010101010101010101 0 0000
attr myITSwitch IODev CUL_0
attr myITSwitch model itswitch
</syntaxhighlight>
Danach die {{Taste|CODE}}-Taste am Funkschalter betätigen (die LED blinkt) und über FHEM den Einschaltcode senden.

== Original Intertechno System ==

Durch Kombination von Hauscode und Geräetecode können maximal 256 Geräte verwendet werden. Dann würde allerdings alle Hauscodes belegt, was eventuell zu Störungen mit Nachbarinstallationen führen könnte.

=== Hauscode (die ersten vier Stellen (0-3) ===
Der Hauscode wird auf dem Drehschalter auf der Rückseite eingestellt und hat die Bezeichnung '''A-P'''

[[File:Img_3324_small.png|thumb|Intertechno Schalter]]
{| class="wikitable"
! Drehschalter !! Stelle 0-3
|-
| A || 0000
|-
| B || F000
|-
| C || 0F00
|-
| D || FF00
|-
| E || 00F0
|-
| F || F0F0
|-
| G || 0FF0
|-
| H || FFF0
|-
| I || 000F
|-
| J || F00F
|-
| K || 0F0F
|-
| L || FF0F
|-
| M || 00FF
|-
| N || F0FF
|-
| O || 0FFF
|-
| P || FFFF
|}

=== Gruppen-/Gerätecode (Stelle 4-7) ===
Der zweite Drehschalter ist mit den Zahlen von 1-16 beschriftet. Das ist eine Zusammensetzung von Gruppe und Gerätecode und ergibt die nächsten 4 Stellen. Die dritte Spalte in der Tabelle zeigt die Zuordnung einer Intertechno YCT-100 / ITS-150 Fernbedienung. Diese ist mit Drehschalter auf der Rückseite (A-P), einem Gruppenschalter (1-4) , und je vier ein-/aus-Tasten belegt.

[[File:Img_3325_small.png|right|thumb|Intertechno Fernbedienung]]

{| class="wikitable"
! Drehschalter !! Stelle 4-7 !! Fernbedienung Gruppe/Taste
|-
| 01 || 0000 || 1 - 1
|-
| 02 || F000 || 1 - 2
|-
| 03 || 0F00 || 1 - 3
|-
| 04 || FF00 || 1 - 4
|-
| 05 || 00F0 || 2 - 1
|-
| 06 || F0F0 || 2 - 2
|-
| 07 || 0FF0 || 2 - 3
|-
| 08 || FFF0 || 2 - 4
|-
| 09 || 000F || 3 - 1
|-
| 10 || F00F || 3 - 2
|-
| 11 || 0F0F || 3 - 3
|-
| 12 || FF0F || 3 - 4
|-
| 13 || 00FF || 4 - 1
|-
| 14 || F0FF || 4 - 2
|-
| 15 || 0FFF || 4 - 3
|-
| 16 || FFFF || 4 - 4
|}

=== Stellen 8-9 (Festwert 0F) ===
<nowiki>Die Positionen 8-9 sind immer fest auf '''0F'''zu stellen</nowiki>

=== Stellen 10-11 (Ein/Aus) ===
Bei den beiden letzten Stellen steht als Codierung für ON = FF und OFF = F0.

=== Beispiele ===
Drehschalter/Hauscode auf '''A'''
<nowiki> Schalter 1 -> 000000000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 1)
Schalter 2 -> 0000F0000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 2)
Schalter 3 -> 00000F000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 3)
Schalter 4 -> 0000FF000F FF F0 (entspricht Fernbedienung Gruppe I und Schalter 4)</nowiki>

Drehschalter/Hauscode auf '''L'''
<nowiki> Schalter 11 -> FF0F0F0F0F FF F0 (entspricht Fernbedienung Gruppe III und Schalter 3)
Schalter 16 -> FF0FFFFF0F FF F0 (entspricht Fernbedienung Gruppe IV und Schalter 4)</nowiki>
komplett für die fhem cfg also z.B. Hauscode A und Gruppe 1 Gerät/Schalter 1 und CUL Bezeichnung CUL1:

<nowiki> define schalter1 IT 000000000F FF F0
attr schalter1 IODev CUL1
attr schalter1 model itswitch</nowiki>

=== Selbstlernende Intertechno Funksteckdosen (z.B. ITR-1500) ===
Die selbst lernenden Intertechno Funksteckdosen haben ein neues erweitertes Protokoll bei dem ein 32-Bit Wort gesendet wird. Sie sind aber weiterhin kompatibel zum bisherigen 12-Bit Protokoll. In der culfw wird das alte Protokoll mit "Intertechno V1" und das neue mit "Intertechno V3" bezeichnet.

==== Mit altem Protokoll anlernen ====
{{Randnotiz|RNTyp=Fehl|RNText=Schon aus Gründen der Störsicherheit ist davon abzuraten bei neuen selbst lernenden Intertechno Geräten den alten 12-Bit Code zu verwenden. Dieser wird nur unterstützt um rückwärts kompatibel zu sein.}}
Zum Anlernen der selbst lernenden Funksteckdosen muss ein gültiger(!) ON-Befehl in den ersten fünf Sekunden nach dem Einstecken der Funksteckdose in eine normalen Steckdose gesendet werden. Die Funksteckdosen haben drei Speicherplätze, so dass man beispielsweise ein ITR-1500 Set zuerst mit der Fernbedienung anlernen und anschließend eigene Codes von FHEM senden lassen kann. Damit man einen gültigen Code sendet, sucht man sich einfach eine beliebige Kombination aus der obigen Tabelle aus (z.B. C-1, C-2 und C-3) und ergänzt entsprechend um die immer identischen Stellen 8 und 9 (0F) und den ON- und OFF-Code (FF/F0).
Das Senden der Codes von FHEM erfolgt am einfachsten, indem man sich die Steckdosen vorher in der Konfiguration so anlegt, wie man sie haben möchte und anschließend über die Weboberfläche den ON-Befehl gibt.

Mitunter funktioniert das reine Senden des ON Befehls aber nicht, da einige dieser Steckdosen einen längeren ON Befehl benötigen und die Sendedauer bei FHEM/CUL/CUNO nicht beeinflusst werden kann. In diesem Fall nimmt man eine YCT-100 oder ITS-150 Fernbedienung, an der die gewünschte Adresse eingestellt werden kann. Zum Anlernen drückt man nun etwas länger auf den passenden Einschaltknopf, danach kann die Dose von FHEM normal geschaltet werden.

==== Angelernten Code löschen ====
Hier gibt es zwei Möglichkeiten.
# Man sendet wie beim Anlernen innerhalb der ersten 5 Sekunden einen OFF-Befehl. Die Funksteckdosen quittiert diesen mit zweimaligem einschalten. Anschließend reagiert sie auf diesen Code nicht mehr.
# Manche neueren Intertechno Geräte (z.B. GRR-3500) haben eine {{Taste|CODE}}-Taste. Durch kurzes Drücken wird die Funksteckdose für 5 Sekunden in den Betrieb zum Anlernen gesetzt. Hält man diese Taste bis die LED hektisch blinkt, lässt sie dann los und drückt sie noch einmal kurz, so wird der gesamte Speicher für angelernte Codes gelöscht. Die Funksteckdose quittiert das wie üblich durch zweimaliges Einschalten.

==== Mit neuem Protokoll anlernen ====
Die neuen Funksteckdosen können laut Werbung ''"67 Millionen verschiedene Codes"'', das sind 26-Bits (2^26 = 67108864). Da hat die Werbung tatsächlich mal untertrieben. Tatsächlich arbeitet das neue Protokoll mit einem 32-Bit Wort. Jede neue Fernbedienung (z.B. ITT-1500) bekommt ab Werk einen fest einprogrammierten (und hoffentlich weltweit eindeutigen) ID-Code aus 26 Bits. Daran hängt sie ein 2-Bit Kommando und eine 4-Bit Geräte bzw. Tastenpaar Nummer:
{| class="wikitable" style="border-style:solid; border-width:4px"
|-
| style="border-style:solid; border-width:4px" | 26-Bit ID des steuernden Geräts (Fernbedienung)
| style="border-style:solid; border-width:4px" | 2-Bit Kommando
| style="border-style:solid; border-width:4px" | 4-Bit Kanal-ID (Tastenpaar)
|-
|}
Das 2-Bit Kommando ist ein ON oder OFF Befehl an ein einzelnes Gerät oder eine Gruppe.
{| class="wikitable"
|-
! Befehl !! Bedeutung
|-
| 0 0 || Ein Gerät einschalten
|-
| 0 1 || Ein Gerät ausschalten
|-
| 1 0 || Alle Geräte (dieser Gruppe) einschalten
|-
| 1 1 || Alle Geräte (dieser Gruppe) ausschalten
|-
|}
Die ITT-1500 hat zwar eine {{Taste|ALL OFF}}-Taste aber keine {{Taste|ALL ON}}.
Ob das Einschalten als Gruppe generell unterstützt wird ist nicht bekannt.
Einen gültiger Einschaltbefehl kann man am [[CUL]] z.B. mit diesem Kommando senden:
<syntaxhighlight lang="text">
is01010010101011101000000110010011
</syntaxhighlight>
Im Gegensatz zum alten Protokoll (Intertechno V1) wird das Binärwort hier nicht mit 0 und '''F''' sondern 0 und '''1''' gesendet.
{| class="wikitable" style="border-style:solid; border-width:4px"
|-
| style="border-style:solid; border-width:4px" | '''is''' ''(Sende Intertechno Kommando)''
| style="border-style:solid; border-width:4px" | '''01010010101011101000000110''' ''(Gerätecode Fernbedienung)''
| style="border-style:solid; border-width:4px" | '''01''' ''(Kommando ON)''
| style="border-style:solid; border-width:4px" | '''0011''' ''(Tastenpaar 4)''
|-
|}
Die culfw unterscheidet anhand der Kommandolänge ob es sich um einen alten (12 Zeichen) oder neuen (32 Zeichen) Intertechno Befehl handelt.
Genauso unterscheidet das IT-Modul in FHEM die beiden Formate:
define <name> IT <10-bit-housecode> <off-code> <on-code> [<dimup-code>] [<dimdown-code>]
und
define <name> IT <26 bit Address> <1 bit group bit> <4 bit unit>
und setzt das Reading <code>protocol</code> auf <code>V3</code>.

== FLS 100 ==
[[File:FLS100.jpg|right|thumb|FLS100 - konfiguriert auf IV/3]]

Beim FLS 100 von m-e.de gibt es nur 4 mögliche Einstellungen: '''I, II, III und IV'''. Dies entspricht der Gruppe auf der Fernbedienung.

{| class="wikitable"
! Drehschalter !! Stelle 0-3
|-
| I || 0FFF
|-
| II || F0FF
|-
| III || FF0F
|-
| IV || FFF0
|}

Die nächsten vier Stellen geben die Geräte ID an; diese ist identisch mit der Taste an der Fernbedienung.
{| class="wikitable"
! Drehschalter !! Stelle 4-7 !! Fernbedienung Taste
|-
| 1 || 0FFF || 1
|-
| 2 || F0FF || 2
|-
| 3 || FF0F || 3
|-
| 4 || FFF0 || 4
|}

Beim FLS 100 ist nur die letzte Stelle relevant, mit ON: F oder OFF: 0

== Renkforce RSL366R ==
Die Renkfoce (Typ RSL366R) Funksteckdosen sind baugleich der oben genannten FLS 100.
Bei Conrad auch im Set mit Artikel Nummer 1208454 zu finden. Stand 2017-12-03

Folgende Einstellungen haben sich bei mir als Funktionsfähig erwiesen:
(Achtung 0FFF0FFF muss auf die Einstellungen am Drehschalter siehe oben angepasst werden)
Erste 4 Stellen sind der FB Gruppe und die darauf folgenden 4 Stellen sind die Fernbedienungstaste

<nowiki> define Renkforce IT 0FFF0FFF FFFF 0000
attr model itswitch
attr ITrepetition 15</nowiki>

ITrepetition ist auszuprobieren, wann die Steckdose zuverlässig schaltet. Bei mir war es der Wert 15

Nachteil: Es sind maximal 16 Funksteckdosen dieses Typs einsetzbar.
Es gibt keinen Rückkanal.

== REV Telecontrol ==
[[File:Rev-funksteckdose-telecontrol-3500-w-008345.png|right|thumb|REV Telecontrol]]

Die REV Telecontrol haben einen Dreh-Wahlschalter auf der Rückseite, mit dem sich der Hauscode (A - D) und der Gerätecode (1 - 3) bestimmen lässt.

Die Codierung ist dabei:
{| class="wikitable"
! Hauscode !! Stelle 1-4
|-
| A || 1FFF
|-
| B || F1FF
|-
| C || FF1F
|-
| D || FFF1
|}

{| class="wikitable"
! Gerätecode !! Stelle 5-7
|-
| 1 || 1FF
|-
| 2 || F1F
|-
| 3 || FF1
|}

Dazu (Stelle 8+9+10) noch drei statische Werte: 0FF.

Der Code für '''An''' ist FF, für '''Aus''' 00.

Beispiel:
:<code>define My_Switch IT 1FFF1FF0FF FF 00 für A1</code>
Erfolgreich getestet mit CULfw V 1.49 CUL868.

== Elro AB440 ==
=== Möglichkeit 1: zu Intertechno-Codes umdippen ===
[[File:ELRO-AB440_Funkschalter.jpg|right|thumb|Élro AB440 Funkschalter]]

Günstige ELRO Funkschalter/Dimmer der Serie 440 lassen sich auch problemlos auf Intertechno Codierung "umdippen" und damit voll kompatibel mit allen möglichen A-P / 1-16 Intertechno Schaltcodes von FHEM aus nutzen. Dazu müssen die Dipschalter-Stellungen entsprechend Intertechno umgerechnet und gesetzt werden (1=ON, 0=OFF).

Beispiele:
{| class="wikitable"
! Intertechno !! Elro Hauscode<br>1234 !! Elro Gerätecode<br>5ABCDE
|-
| A1 || 1111 || 111110
|-
| A2 || 1111 || 011110
|-
| A3 || 1111 || 101110
|-
| A4 || 1111 || 001110
|-
| A5 || 1111 || 110110
|-
| A6 || 1111 || 010110
|-
| A7 || 1111 || 100110
|-
| A8 || 1111 || 000110
|-
| A9 || 1111 || 111010
|-
| A10 || 1111 || 011010
|-
| A16 || 1111 || 000010
|-
| C1 || 1011 || 111110
|-
| C2 || 1011 || 011110
|}

Weitere Erklärungen sind z.B. im [http://isn-systems.com/tools/it2elro Tool] der Fa. ISN-systems online verfügbar (berechnen lassen etc.).

Einziger Nachteil: Die originale Elro Fernbedienung funktioniert dann nicht mehr uneingeschränkt mit den Funkschaltern (eine Intertechno Fernbedienung funktioniert uneingeschränkt). Wenn man den Hauscode an der Fernbedienung einstellt, kann man durch Drücken von z.T. mehreren Tasten gleichzeitig auch Intertechno schalten. Das ist aber nur was für den Notfall oder für Handakrobaten.

<nowiki>15/16 -> D
13/14 -> A+D
11/12 -> B+D
09/10 -> A+B+D
07/08 -> C+D
05/06 -> A+C+D
03/04 -> B+C+D
01/02 -> A+B+C+D</nowiki>

=== Möglichkeit 2: aus der vorhanden DIP-Schalterstellung den entsprechenden 10-digit InterTechno Code bestimmen ===
Das ist prinzipiell ganz einfach. Hat man folgende DIP-Schalter-Stellung so muss man von links nach rechts einfach für jeden DIP gleich "ON" eine "0" und für "OFF" ein "F" definieren. Für die dargestellte DIP-Einstellung ergibt sich damit der darunterstehende InterTechno Code:

[[File:ELRO_0100101111.png]]

<code>0F00F0FFFF</code>

Analog dazu ergeben sich für den gleichen Hauscode (Schalter 1-5) folgende Codes für die Funksteckdosen B bis E, wobei die Dose E mit der Originalfernbedienung nicht adressierbar ist, sich mit FHEM aber wunderbar schalten lässt.

[[File:ELRO_0100110111.png]]

<code>0F00FF0FFF</code>

[[File:ELRO_0100111011.png]]

<code>0F00FFF0FF</code>

[[File:ELRO_0100111101.png]]

<code>0F00FFFF0F</code>

[[File:ELRO_0100111110.png]]

<code>0F00FFFFF0</code>

Dazu noch die Codes für AN = FF und AUS = F0 schaut eine vollständige Definition eines ELRO440 Funkschalters dann bsw. so aus:

<nowiki> define ELRO_10110_A IT 0F00F0FFFF FF F0
attr ELRO_10110_A IODev CUL_0
attr ELRO_10110_A alias Stehlampe
attr ELRO_10110_A fp_Grundriss 340,50,1,Stehlampe
attr ELRO_10110_A group Schalter
attr ELRO_10110_A model itswitch
attr ELRO_10110_A room Wohnzimmer</nowiki>

[[File:b1-Funksteckdose-von-Toom.jpg|right|thumb|b1 Funksteckdose von Toom]]
== b1 / Toom ==
Das "Funksteckdosen-Set" der Marke b1 aus dem Toom-Baumarkt (3 Funksteckdosen + 1 Fernbedienung mit 4x ein/aus) funktioniert exakt wie ELRO, auch die DIP-Schalter sind genauso belegt.

== Wetekom/Westfalia ==
[[File:Westfalia-Funksteckdose.jpg|right|thumb|Westfalia Funksteckdose ZTC-S316A.]]
Der eingestellte Hauscode ist F00F0FFF0F.

In den Westfalia-Baumärkten gibt es Funksteckdosen mit Westfalia-Branding. Auf der Bedienungsanleitung steht aber Wetekom.

Die Funksteckdosen selbst haben zehn DIP-Switches: 1234FEDCBA, während die Fernbedienung nur sechs hat: ABCDEF. Damit die Fernbedienung mit den Funksteckdosen funktioniert, darf man nur einen der DIP-Switches 1234 pro Funksteckdose auf ON schalten.

Die Schaltung der DIP-Switches ABCDEF4321 entspricht direkt und in dieser Reihenfolge (also andersrum als direkt an der Funksteckdose) dem Hauscode und zwar entspricht ein Switch auf OFF einem F im Hauscode und ein Switch auf ON einer 0 im Hauscode.

Die Steckdosen werden dann mit 01 ein- und mit 10 ausgeschaltet.

Beispiel:
define wf_steckdose IT F00F0FFF0F 01 10

== Pollin Funksteckdosen ==

Vom Aussehen sind die Steckdosen von Pollin (z.B. 3fach Set 550666) mit den Westfalia ZTC identisch, aber:

* die DIP Schalter sind beschriftet von 0 bis 10;
* der Adresscode entspricht dem invertierten ELRO 440 Code ->also (0=ON, 1=OFF)
* der Code für "An" ist 0F, für "Aus" F0

Beispiel für Adresse C2:

define IT_C2 IT 0F00F0000F 0F F0

== me micro-electric AS 73 / COMAG IP44 ==

[[Datei:Me_AS_73.JPG|right|thumb|micro-electric Funksteckdose AS 73]]

Die micro-electric Funksteckdosen haben 10 DIP-Schalter: 123456ABCD.

Der Hauscode wird an Sender und Steckdose mit 1-6 eingestellt, der Empfängercode A-D entspricht den Kanälen auf dem Handsender.

DIP-Schalterstellung OFF entspricht F und ON entspricht 0.

Die Steckdosen werden mit F0 ein- und mit 0F ausgeschaltet.

Empfängercodes:
{| class="wikitable"
! Kanal !! Position 7-10
|-
| A || 0FFF
|-
| B || F0FF
|-
| C || FFF0 (Achtung: bei C und D sind die Codes vertauscht)
|-
| D || FF0F
|}

Beispiel:
:<code>define Schalter_ME_A IT 0F0F000FFF F0 0F</code>
:<code>attr Schalter_ME_A IODev CUL1</code>
:<code>attr Schalter_ME_A model itswitch</code>

Die vom Gehäuse her ähnliche (Knick und Lage der DIP-Schalter) COMAG-Außensteckdose mit IP44 verwendet einen mit 1-10 beschrifteten DIP-Schalter, wird aber mit 0F ein- und F0 ausgeschaltet:
:<code>define COMAG_IP44 IT 0FF00FF00F 0F F0</code>

== Conrad / McPower Funkschaltset 3+1 ==
Dieses Funkschaltset wird unter mehreren Namen in verschiedenen Bau- und Heimwerkermärkten sowie bei Conrad (Best Nr. 640475 - 62) vertrieben. Teilweise auch mit unterschiedlichen Schaltleistungen.
Die Konfiguration funktioniert genauso wie beim [[Intertechno_Code_Berechnung#FLS_100|FLS100]]

== CMI / OBI / LUX IP44-Funkschaltset 2+1 ==
[[File:RCS_14G_Funksteckdose_Obi_klein.png|right|thumb|Rückansicht der OBI / Lux Funksteckdose]]
Dieses Set wird u.a. bei OBI verkauft, als Hersteller wird die Emil Lux GmbH angegeben. Typennummer RCS-14G, Artikel Nummer 308555
Die Steckdosen sind IP44 geschützt und damit auch für den Außeneinsatz geeignet.
Die Steckdosen verfügen lediglich über einen Kanal-Schalter von 1-4. Diese Kanal-Nummern korrespondieren mit der folgenden Übersetzung:

{| class="wikitable"
! Kanal !! Code (Stelle 1-10)
|-
| 1 || 000FF0F0FF
|-
| 2 || 000FFF00FF
|-
| 3 || 000F0FF0FF
|-
| 4 || 0000FFF0FF
|}

Die Steckdosen werden dann mit FF ein- und mit F0 ausgeschaltet.

Beispiel:
:<code>define Schalter_OBI_Code_1 IT 000FF0F0FF FF F0</code>
:<code>attr Schalter_OBI_Code_1 IODev CUL1</code>
:<code>attr Schalter_OBI_Code_1 model itswitch</code>

== Noch nicht aufgeführte Geräte ==
Wer ein Intertechno-ähnliches Gerät besitzt, das in dieser Liste noch nicht aufgeführt ist, muss die Kodierung selbst bestimmen. Dazu gibt es verschiedene Möglichkeiten, die in diesem Abschnitt aufgeführt werden. Die Ergebnisse bitte hier eintragen, um Nachfolgern die Arbeit zu ersparen!

=== Audio-Eingang zur Messung ===
Hier wird die Fernbedienung oder der Empfänger mit einer entsprechenden Schaltung an den Mikrofon-Eingang eines Rechners angeschlossen und mit einem Audio-Programm werden die Signalverläufe aufgenommen. Diese Methode wird [http://avr.börke.de/E-Funk.htm hier] näher erläutert.

=== Platine analysieren ===
[[File:Westfalia-Funkfernbedienung-hinten.jpg|right|thumb|Platine der Westfalia Funkfernbedienung ZTC-TC von hinten.]]
[[File:Westfalia-Funkfernbedienung-vorne.jpg|right|thumb|Platine der Westfalia Funkfernbedienung ZTC-TC von vorne.]]

Platine der Fernbedienung oder des Empfängers betrachten und so die Beschaltung des Decoder/Encoder Chips ermitteln. Bei der Wetekom-Fernbedienung wird beispielsweise der Chip LP801b verwendet, der funktional identisch zum PT2262 ist. Im [http://www.escol.com.my/Datasheets_specs/pt2262_1.pdf Datenblatt des PT2262] kann man dann die Beschaltung nachsehen. Nun betrachtet man den Verlauf der Leiterbahnen auf der Platine, um die Beschaltung des Chips zu ermitteln. So kann man beispielsweise bei der Wetekom-Fernbedienung sehen, dass die DIP-Switches A bis F auf die Eingänge A0 bis A5 geschaltet sind. Außerdem sieht man, mit welchen Eingängen die einzelnen Taster verbunden sind.

Nun kann man messen, zwischen welchen Chip-Eingängen und Batteriepolen eine Spannung anliegt, bzw. (ohne Batterie) zwischen welchen Chip-Eingängen und Batteriepolen es einen Durchgang gibt, um zu ermitteln, wie die DIP-Switches schalten. Im Fall der Wetekom-Fernbedienung liegt keine Spannung zwischen den Eingängen und den beiden Batteriepolen an, wenn die DIP-Switches auf OFF stehen: Der Eingang liegt also auf F (Float). Wenn die DIP-Switches auf ON stehen, liegt nur eine Spannung zwischen dem Pluspol der Batterie und dem Eingang an, es gibt also einen Durchgang zwischen dem Minuspol und dem Eingang, so dass der Eingang auf V_SS liegt und damit 0 eingestellt ist.

Bei den Eingängen D0 und D1 sieht man, dass der Batterie-Pluspol immer über einen Widerstand mit dem Dateneingang verbunden ist, also normalerweise 1 anliegt. Ist aber ein Ein-Taster gedrückt, wird der Eingang D1 direkt mit dem Minuspol der Batterie verbunden, bei den Aus-Tastern der Eingang D0 (die Verbindung der Aus-Taster ist auf den Bildern nicht besonders gut zu erkennen). Durch diese Verbindung wird der Eingang auf V_SS heruntergezogen und damit ist 0 eingestellt.

=== Mit [[CUL]] im Debug-Modus Rohsignale empfangen und analysieren ===
* Wurde im {{Link2Forum|Topic=5599|LinkText=Forum}} diskutiert.
Ein 433MHz CUL kann mit dem Befehl <code>X67</code> Intertechno Kommandos mitlesen.
Allerdings funktioniert das bei der "üblichen" Firmware nur lückenhaft.
Dazu wurde bereits eine spezielle Variante der culfw entwickelt (siehe {{Link2Forum|Topic=24436|Message=105|LinkText=Forum}}).
Die Ausgaben sind aber dann als doppelt so langes Binärwort im Hex-Format.
Man muss quasi jedes zweite Bit streichen, da die einzelnen Bits als steigende bzw. fallende Flanken übertragen werden.
Man kann aber damit auch einer neuen ITT-1500 ihre Kommandos und vor allem ihre 26-Bit ID entlocken.

==== Mit CUL868 433MHz mitlesen ====
Man kann auch mit der 868MHz Version des CUL Fernbedienungen von Intertechno mitlesen.
Dazu die gewünschte Trägerfrequenz 433.92MHz * 2^16 / 26MHz = 1093745 = 0x10B071 als 24-Bit Teiler in die Register <code>FREQ[2-0]</code> schreiben und einen Reset ausführen.
W0F10
W10B0
W1171
B
Danach kann man mit <code>X67</code> auf der Frequenz mitlesen. Mit <code>e</code> kann der EEPROM wieder auf den Default 0x21656A, 868.30MHz gestellt werden.

[[Kategorie:Intertechno]]
[[Kategorie:HOWTOS]]
[[Kategorie:433MHz]]

HM-MOD-Re-8 8-Kanal-Empfangsmodul

2020-11-08T18:30:19Z

Pfriemler: Modul im Nov. 20 offenbar doch wieder lieferbar

{{Infobox Hardware
|Bild=HM-MOD-Re-8.jpg
|Bildbeschreibung=Empfangsmodul
|HWProtocol=HomeMatic
|HWType=Empfänger
|HWCategory=HomeMatic
|HWComm=Funk 868MHz
|HWChannels=8
|HWVoltage=2-3,3V o. 3,5-12V
|HWPowerConsumption=100µA
|HWPoweredBy=Batterie oder Kleinspannung
|HWSize=42x22x17mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}

[[HM-MOD-Re-8]] ist ein Modul mit acht Schaltaktoren (Transistoren) zum Einbau in eigene Hardwareentwicklungen, ähnlich dem Sendemodul [[HM-MOD-EM-8]].
Im Oktober 2020 meldete ELV auf seiner Website, dass das Modul nicht mehr lieferbar ist - im November 2020 war es mit einer Woche Lieferzeit wieder verfügbar. Es ist wohl damit zu rechnen, dass das Modul mittelfristig nicht mehr lieferbar sein wird. Leider ist es im Produktfolio alternativlos - ein ähnliches Modul gibt es nur in der Homematic-IP-Variante oder im Eigenbau (Homebrew).

== Features ==
Offenes (gehäuseloses) Einbaumodul mit 8 Ausgängen (open-collector-Transistorstufen, keine MOSFETs)
* 8 Taster für lokales Schalten (Toggeln) der Ausgänge
* 8 Eingänge für externe Taster zum Schalten der Ausgänge
* 8 aktivierbare rote LED zum Anzeigen des Schaltzustandes

Das Modul wird im Zusammenhang mit dem Sendemodul auch für die Realisierung sicherer (weil quittierter) einfacher Fernsteuerungen beworben, abseits von CCU und FHEM.

'''Weitere technische Daten:'''

* Stromaufnahme: 100 µA bei deaktiven Ausgängen und deaktivierter Schaltzustandsanzeige
* Belastbarkeit der Ausgänge: max. 20V / 100 mA DC
* Höchstwiderstand an den Tastereingängen: 21 kOhm (experimentell ermittelt) - '''Achtung:''' ungeschützte Mikroprozessorports!

Aktuelle Firmware: 1.2 (Stand Oktober 2015). 1.1. sollte Probleme mit einem individuellen Sicherheitsschlüssel beseitigen, hatte aber neue Probleme mit dem Anlernen gebracht, die jetzt in 1.2 gefixt sein sollen.

== Hinweise zu Inbetriebnahme und Installation ==
Das Modul war nur als ARR-Bausatz erhältlich. Es ist auf einer Leiterplatte mit Steckkontakten untergebracht, das auf eigene Schaltungen gesockelt werden kann. Es verfügt über 8 Ausgänge mit open-collector-Transistoren, Eingänge für 8 Taster sowie onboard-Taster. Das Modul besitzt weiterhin 8 LED, die für die Anzeige des Schaltzustandes aktiviert werden können (default aus, zur Stromersparnis). Eine zusätzliche zweifarbige Status-LED ist nicht vorhanden.

Onboard-Taster und Tastereingänge sind intern parallelgeschaltet und funktionsgleich, sie dienen zum lokalen Ein-/Ausschalten (Toggeln) sowie bei längerem Druck zum Verknüpfen (Peeren) ohne Zentralenunterstützung (sofern keine Zentrale angemeldet ist). Laut Anleitung dient die Taste des Kanals 1 zudem zum Zurücksetzen des Moduls in den Auslieferungszustand.

Das Modul besitzt zudem interne Freilaufdioden, deren Katoden gemeinsam an einem Anschluss herausgeführt werden. So ist die sichere Ansteuerung von Relais auch mit abweichender Versorgungsspannung als der des Moduls möglich.

Die Stromversorgung erfolgt über Batterie (2-3,3 V) oder Kleinspannung 3,5-12 V.

== Betrieb mit FHEM ==
Das Modul befindet sich gewöhnlich im Stromsparmodus und muss zur Konfiguration und zum Schalten vom Sender per Burst "aufgeweckt" werden. Eine für manche Einsatzvariante wünschenswerte '''Umschaltung in einen non-burst-Modus ist nach Auskunft von ELV nicht verfügbar''' (und wird auch in CCU2 und Konfigurator nicht angeboten).

Das Anlernen erfolgt in FHEM wie üblich per Seriennummer oder im einstellbaren Zeitfenster, der Aktor ist (z.B. über die Kanaltaste 1, siehe Handbuch) in den Konfigurationsmodus zu versetzen. Danach stellt das Gerät 8 Kanäle bereit, die wie jeder Aktor mit anderen Fernbedienungen oder Sensoren gepeert oder FHEM-intern angesteuert werden können. Konfigurationsanforderungen der Zentrale verarbeitet das Modul wie bei Aktoren üblich ohne lokal erforderliche Bedienung.

Auf Device-Ebene lassen sich durch Setzen des Registers '''ledMode''' die onboard-LEDs als Schaltzustandsanzeige ein- bzw. ausschalten: <code>set ''Re-8-Device'' regSet ledMode on</code> bzw. <code>off</code>. Außerdem lässt sich wie bei vielen Aktoren für Batteriebetrieb eine Warnschwelle für die Versorgungsspannung einstellen. Ein Programmieren ist offenbar, wie beim Sendemodul, erst möglich, wenn die Konfiguration zumindest einmal vollständig abgefragt wurde: <code>set ''Re-8-Device'' getConfig</code>

== Bekannte Probleme ==
1. Das Timing für '''on-for-timer''' ist nicht korrekt, die Ausgänge bleiben ca. 30% länger aktiviert als der Befehl vorgibt. Das ist kein Problem von FHEM, sondern tritt auch bei Direktverknüpfungen etwa mit dem Homematic-Konfigurator auf.

2. Das Verhalten beim Setzen der Warnschwelle für niedrige Betriebsspannung ist ungeklärt. Der set-Befehl wird zwar offensichtlich ausgeführt, aber die korrekte Rückmeldung fehlt, so dass das Register '''R-lowBatLimitBA3''' im Zustand "set_..." verbleibt. Die eingestellte Schaltschwelle lässt sich auch mit dem Homematic-Konfigurator nicht auslesen.

3. Bei Verwendung des CUL-USB-Dongle mit älteren culfw-Firmwareversionen ist das Setzen der Ausgänge nicht möglich. Ggf. ist die Firmware zu aktualsieren. Ab der Version culfw 1.60 ist das Problem behoben.

== Links ==
* [http://files.elv.de/Assets/Produkte/13/1321/132143/Downloads/132143_HM-MOD-Re-8_data.pdf Datenblatt bei ELV]
* {{Link2Forum|Topic=25719|LinkText=Diskussion im Forum}}

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

HM-MOD-EM-8 8-Kanal-Sendemodul

2020-10-31T11:49:58Z

Pfriemler: Hinweis auf Produktionsende / Nichtverfügbarkeit

{{Infobox Hardware
|Bild=HM-MOD-EM-8.jpg
|Bildbeschreibung=8-Kanal Sendemodul
|HWProtocol=HomeMatic
|HWType=Sender (Sensor oder Remote)
|HWCategory=HomeMatic
|HWComm=Funk 868MHz
|HWChannels=8
|HWVoltage=2-3,3V bzw. 3,5-12V
|HWPowerConsumption=3 bzw. 20µA
|HWPoweredBy=Batterie oder Kleinspannung
|HWSize=42x22x17mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}


[[HM-MOD-EM-8]] ist ein Modul für eigene Hardware-Entwicklungen (ähnlich dem Empfangsmodul [[HM-MOD-Re-8]] oder dem Sendemodul mit 8-bit-Dateneingang [[HM-MOD-EM-8bit]]) zum Übermitteln von Schaltbefehlen oder Kontaktzuständen. '''Die Produktion wurde eingestellt, seit Oktober 2020 ist es nicht mehr lieferbar'''. Gerade die variable Einstellmöglichkeit der Eingänge hinsichtlich ihres Verhaltens ist im Sortiment alternativlos. Es gibt vergleichbare Module nur noch für Homematic IP oder im Eigenbau (Homebrew).

== Features ==
Offenes (gehäuseloses) Einbaumodul mit 8 Eingangskanälen, mit einer Beschaltung von <br />
* 8 Eingänge für den Anschluss von Tastern oder Schaltern (gegen GND)<br /> oder/und
* 8 Eingänge für den Anschluss von Spannungen (2-24V gegen GND).

Beide Varianten können gleichzeitig benutzt werden und sind intern ODER-verknüpft.

Das Modul stellt drei Sende-Modi bereit, die einzeln per Kanal konfiguriert werden können.
* Fernbedienung bzw. ähnlich Unterputz-Taster-Modul [[HM-PBI-4-FM]]: bei Kontaktbetätigung kurze und lange Tastenbetätigungen (Auslieferungszustand)
* ähnlich [[HM-SwI-3-FM]]: Senden von kurzen Tastenbetätigungen bei Kontaktzustandsänderung
* ähnlich [[HM-SCI-3-FM]]: Übermitteln des Kontaktzustandes bei jeder Zustandsänderung

Das Modul wird im Zusammenhang mit dem Empfangsmodul auch für die Realisierung sicherer (weil quittierter) einfacher Fernsteuerungen beworben, abseits von CCU und FHEM.

'''Weitere technische Daten:'''

* Eingangsimpedanz der Spannungseingänge: 10 kOhm (und eine Basis-Emitter-Strecke eines Transistors)
* Mindestwerte für Eingänge für ein sicheres Erkennen: 5,6 µA (experimentell ermittelt) / 0,7 V / ca. 780 kOhm bei 5V
* Höchstwiderstand am Tastereingang: 33 kOhm (experimentell ermittelt)
* Gewicht: 9 g

Aktuelle Firmware: 1.1 (Stand Mai 2017). Die Firmware zum Update von 1.0 ist jedoch nicht verfügbar.

== Hinweise zu Inbetriebnahme und Installation ==
Das Modul ist nur als ARR-Bausatz erhältlich. Es ist auf einer Leiterplatte mit Steckkontakten untergebracht, das auf eigene Schaltungen gesockelt werden kann. Es verfügt über 8 Eingänge für Taster sowie 8 Eingänge für eine Spannung von 2-24V, die über Transistoren die Eingänge des Prozessors parallel zu den Tasteneingängen kurzschließen (ODER-Verknüpfung). Außerdem gibt es Ausgänge für drei Status-LEDs (rot, grün wie für HM als Sendequittung üblich sowie einen dritten Ausgang, der aktiv ist, solange das Modul selbst sendet). Das Gerät besitzt einen Konfigurationstaster und eine onboard-LED, die im Auslieferungszustand jedoch nur den Batteriestatus meldet (bei schwacher Batterie) und keine Sendedaten quittiert, um Strom zu sparen. Die LED kann aber über Register eingeschaltet werden und sendet dann wie üblich mit gelb und ggf. rot oder grün als Quittung.

Die Stromversorgung erfolgt über Batterie (2-3,3 V) oder Kleinspannung 3,5-12 V.

== Betrieb mit FHEM ==
Das Modul muss zur Pairen manuell in den Konfigurationsmodus versetzt werden (onboard-Taster), empfängt dann aber Konfigurationstelegramme im Zusammenhang mit Sendevorgängen, z.B. bei Statusänderungen an den Eingängen (sog. lazyConfig). Dies erleichtert die nachträgliche Konfiguration bereits eingebauter Module.
Das Anlernen erfolgt in FHEM wie üblich. Danach stellt das Gerät 8 Kanäle (_Btn01 bis _Btn08) bereit, die wie eine Fernbedienung mit anderen Aktoren gepeert oder FHEM-intern verarbeitet werden können.

Die Umstellung der Kanäle auf die alternativen Modi erfolgt durch setzen des Registers <code>triggerMode</code>:
* <code>set ''EM-8-channel'' regSet triggerMode button</code> schaltet in den Taster-Modus (wie PBI-4). Das Modul sendet lange und kurze Tastenbetätigungen je nach Kontaktdauer.
* <code>set ''EM-8-channel'' regSet triggerMode switch</code> schaltet in den Schalter-Modus (wie S'''W'''I-3). Hier sendet das Modul keine langen Betätigungen mehr, sondern wie eine kurze Tastenbetätigung bei jedem Statuswechsel
* <code>set ''EM-8-channel'' regSet triggerMode sensor</code> schaltet in den Sensor-Modus (wie S'''C'''I-3). Hier sendet das Modul einen Wert bei jedem Statuswechsel, der als "open" bzw. "closed" interpretiert wird.
* <code>set ''EM-8-channel'' regSet triggerMode off</code> schaltet den Kanal ganz ab.
Eine Umschaltung kann nur durchgeführt werden, wenn zuvor ein <code>getConfig</code> ausgelöst wurde. Zudem muss die Konfigurationstaste betätigt werden.

Auf Device-Ebene lässt sich durch Setzen des Registers <code>ledMode</code> die onboard-LED für Sendequittungen ein- bzw. ausschalten: <code>set ''EM-8-Device'' regSet ledMode on</code> bzw. <code>off</code>.

== Bekannte Probleme ==
Im Fernbedienungsmodus sendet das Modul an gepeerte Aktoren, die einen Burst verlangen, bei einer langen Tastenbetätigung sofort eine Quittungsanforderung. Nach dem erfolgten ACK des Empfängers sendet das Modul anschließend jedoch mit neuem "Tastenzähler" weiter, was der Empfänger als neuen Tastendruck interpretiert und entsprechend reagiert (d.h. ggf. toggelt). Non-Burst-Aktoren werden hingegen einwandfrei "bedient".

Das komplette Durchkonfigurieren eines Moduls (etwa das Umstellen von button- auf sensor-Modus) verursacht offenbar extrem viel Funklast - meist läuft das Funkinterface in "overload" bevor die Umstellungen abgeschlossen sind. Nach Wartezeit oder Reset werden die Konfigurationen aber i.d.R. problemlos nachgeholt.

== Links ==
* [http://files.elv.de/Assets/Produkte/13/1329/132939/Downloads/132939_hm_sendemodul_data.pdf Datenblatt bei ELV]
* [https://files.elv.com/Assets/Produkte/13/1329/132939/Downloads/132939_sendemodul_um.pdf Bedienungsanleitung bei ELV]
* {{Link2Forum|Topic=27536|LinkText=Diskussion im Forum}} (als das Modul neu war)

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]

HM-MOD-Re-8 8-Kanal-Empfangsmodul

2020-10-31T11:24:29Z

Pfriemler: Hinweis auf Produktionsende / Nichtverfügbarkeit

{{Infobox Hardware
|Bild=HM-MOD-Re-8.jpg
|Bildbeschreibung=Empfangsmodul
|HWProtocol=HomeMatic
|HWType=Empfänger
|HWCategory=HomeMatic
|HWComm=Funk 868MHz
|HWChannels=8
|HWVoltage=2-3,3V o. 3,5-12V
|HWPowerConsumption=100µA
|HWPoweredBy=Batterie oder Kleinspannung
|HWSize=42x22x17mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}

[[HM-MOD-Re-8]] ist ein Modul mit acht Schaltaktoren (Transistoren) zum Einbau in eigene Hardwareentwicklungen, ähnlich dem Sendemodul [[HM-MOD-EM-8]].
'''Die Produktion wurde eingestellt, seit Oktober 2020 ist es nicht mehr lieferbar'''. Ein vergleichbares Modul gibt es nur noch bei Homematic-IP oder im Eigenbau (Homebrew).

== Features ==
Offenes (gehäuseloses) Einbaumodul mit 8 Ausgängen (open-collector-Transistorstufen, keine MOSFETs)
* 8 Taster für lokales Schalten (Toggeln) der Ausgänge
* 8 Eingänge für externe Taster zum Schalten der Ausgänge
* 8 aktivierbare rote LED zum Anzeigen des Schaltzustandes

Das Modul wird im Zusammenhang mit dem Sendemodul auch für die Realisierung sicherer (weil quittierter) einfacher Fernsteuerungen beworben, abseits von CCU und FHEM.

'''Weitere technische Daten:'''

* Stromaufnahme: 100 µA bei deaktiven Ausgängen und deaktivierter Schaltzustandsanzeige
* Belastbarkeit der Ausgänge: max. 20V / 100 mA DC
* Höchstwiderstand an den Tastereingängen: 21 kOhm (experimentell ermittelt) - '''Achtung:''' ungeschützte Mikroprozessorports!

Aktuelle Firmware: 1.2 (Stand Oktober 2015). 1.1. sollte Probleme mit einem individuellen Sicherheitsschlüssel beseitigen, hatte aber neue Probleme mit dem Anlernen gebracht, die jetzt in 1.2 gefixt sein sollen.

== Hinweise zu Inbetriebnahme und Installation ==
Das Modul war nur als ARR-Bausatz erhältlich. Es ist auf einer Leiterplatte mit Steckkontakten untergebracht, das auf eigene Schaltungen gesockelt werden kann. Es verfügt über 8 Ausgänge mit open-collector-Transistoren, Eingänge für 8 Taster sowie onboard-Taster. Das Modul besitzt weiterhin 8 LED, die für die Anzeige des Schaltzustandes aktiviert werden können (default aus, zur Stromersparnis). Eine zusätzliche zweifarbige Status-LED ist nicht vorhanden.

Onboard-Taster und Tastereingänge sind intern parallelgeschaltet und funktionsgleich, sie dienen zum lokalen Ein-/Ausschalten (Toggeln) sowie bei längerem Druck zum Verknüpfen (Peeren) ohne Zentralenunterstützung (sofern keine Zentrale angemeldet ist). Laut Anleitung dient die Taste des Kanals 1 zudem zum Zurücksetzen des Moduls in den Auslieferungszustand.

Das Modul besitzt zudem interne Freilaufdioden, deren Katoden gemeinsam an einem Anschluss herausgeführt werden. So ist die sichere Ansteuerung von Relais auch mit abweichender Versorgungsspannung als der des Moduls möglich.

Die Stromversorgung erfolgt über Batterie (2-3,3 V) oder Kleinspannung 3,5-12 V.

== Betrieb mit FHEM ==
Das Modul befindet sich gewöhnlich im Stromsparmodus und muss zur Konfiguration und zum Schalten vom Sender per Burst "aufgeweckt" werden. Eine für manche Einsatzvariante wünschenswerte '''Umschaltung in einen non-burst-Modus ist nach Auskunft von ELV nicht verfügbar''' (und wird auch in CCU2 und Konfigurator nicht angeboten).

Das Anlernen erfolgt in FHEM wie üblich per Seriennummer oder im einstellbaren Zeitfenster, der Aktor ist (z.B. über die Kanaltaste 1, siehe Handbuch) in den Konfigurationsmodus zu versetzen. Danach stellt das Gerät 8 Kanäle bereit, die wie jeder Aktor mit anderen Fernbedienungen oder Sensoren gepeert oder FHEM-intern angesteuert werden können. Konfigurationsanforderungen der Zentrale verarbeitet das Modul wie bei Aktoren üblich ohne lokal erforderliche Bedienung.

Auf Device-Ebene lassen sich durch Setzen des Registers '''ledMode''' die onboard-LEDs als Schaltzustandsanzeige ein- bzw. ausschalten: <code>set ''Re-8-Device'' regSet ledMode on</code> bzw. <code>off</code>. Außerdem lässt sich wie bei vielen Aktoren für Batteriebetrieb eine Warnschwelle für die Versorgungsspannung einstellen. Ein Programmieren ist offenbar, wie beim Sendemodul, erst möglich, wenn die Konfiguration zumindest einmal vollständig abgefragt wurde: <code>set ''Re-8-Device'' getConfig</code>

== Bekannte Probleme ==
1. Das Timing für '''on-for-timer''' ist nicht korrekt, die Ausgänge bleiben ca. 30% länger aktiviert als der Befehl vorgibt. Das ist kein Problem von FHEM, sondern tritt auch bei Direktverknüpfungen etwa mit dem Homematic-Konfigurator auf.

2. Das Verhalten beim Setzen der Warnschwelle für niedrige Betriebsspannung ist ungeklärt. Der set-Befehl wird zwar offensichtlich ausgeführt, aber die korrekte Rückmeldung fehlt, so dass das Register '''R-lowBatLimitBA3''' im Zustand "set_..." verbleibt. Die eingestellte Schaltschwelle lässt sich auch mit dem Homematic-Konfigurator nicht auslesen.

3. Bei Verwendung des CUL-USB-Dongle mit älteren culfw-Firmwareversionen ist das Setzen der Ausgänge nicht möglich. Ggf. ist die Firmware zu aktualsieren. Ab der Version culfw 1.60 ist das Problem behoben.

== Links ==
* [http://files.elv.de/Assets/Produkte/13/1321/132143/Downloads/132143_HM-MOD-Re-8_data.pdf Datenblatt bei ELV]
* {{Link2Forum|Topic=25719|LinkText=Diskussion im Forum}}

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

HomeMatic Register programmieren

2020-07-13T11:13:50Z

Pfriemler: /* confBtnTime - Kurz oder lang und der Konfigurationsmodus */ Nachtrag auf unterstützende Firmware

{{Baustelle}}
Ein HomeMatic-Gerät besitzt mehr oder weniger umfangreiche Registersätze, mit denen das Verhalten des Gerätes vielfältig feinkonfiguriert werden kann. Die damit erreichbare Funktionsvielfalt geht weit über die standardisierten Vorgaben einer einfachen Direktverknüpfung ([[Peering_(HomeMatic)|Peering]]) hinaus.

== Grundlagen (in Auszügen) ==

Im folgenden werden nur exemplarisch einige Grundlagen und einfache Beispiele benannt, ohne jeden Anspruch auf Vollständigkeit.

FHEM unterstützt die Programmierung der Register mit dem Befehl ''regSet''. <peer> entfällt bei rein gerätebezogenen Programmierungen.
:<code>set <name> regSet <register> <value> [<peer>] </code>
Darüberhinaus gibt es vor- oder selbstdefinierte [[HomeMatic_HmInfo_Templates_erstellen|Templates]] (Vorlagen), die alle erforderlichen Änderungen für standardisierte Anwendungen wie Treppenhauslichtschalter beinhalten. Die Anwendung von Templates auf Geräte wird protokolliert und der Registerzustand kann überprüft werden. Für viele Anwendungen genügt jedoch auch die einmalige Anwendung einer direkten Programmierung. Das genaue Verständnis der Vorgänge und Zusammenhänge ist nicht trivial, das Erlernen wird aber mit einer enormen erreichbaren Funktionsvielfalt belohnt. Viele wissenswerte Zusammenhänge sind im Homematic-Anhang der bekannten Einsteiger-Dokumentation erläutert, deren Lektüre zu Recht immer wieder empfohlen wird. Dieser Beitrag ist auch nur als Ergänzung zu verstehen!

Die HomeMatic Aktoren (Schalter, Dimmer, ...) arbeiten so, wie es für verknüpften ([[Peering (HomeMatic)|peering]]) Sender vorgegeben ist. Sie nutzen Registersätze, die für jede Verknüpfung (peer) neu angelegt und gespeichert werden. Man kann also mit einem Taster ein- und ausschalten (toggeln), mit einem Tastenpaar gezielt ein- und ausschalten und mit einem weiteren Taster eine Zeitschaltung für 10 Sekunden starten. Dabei wird niemals der Taster oder der Schalter auf eine globale Aktion programmiert, sondern im Schalter (Aktor) die gewünschte Aktion für jeden verknüpften Taster separat gespeichert. Die auszulösende Aktion ist zudem abhängig vom aktuellen Zustand des Aktors und von der Länge des Tastendruckes (kurz oder länger - short or long).

Kleines Beispiel:
T1 schaltet S1 für 10 sec an
T2 schaltet S1 an oder aus
T3 schaltet S1 an
T4 schaltet S1 aus.

Diese Tabelle ist im Schalter S1 gespeichert.

Schaltet man mit T3 den S1 an und drückt dann nach beliebiger Zeit kurz T1 geht S1 nach weiteren 10 sec aus. Schaltet man mit T1 kurz den S1 für 10 sec an, aber innerhalb dieser Zeit mit T3 nochmal an, dann bleibt S1 nach Ablauf der 10 sec an.

Die verfügbaren Register unterscheiden sich im Gerät und in den jeweiligen Kanälen.
Eine kurze Beschreibung der Register inklusive der erlaubten Werte erhält man durch:
:<code>get <name> regList </code>
Dabei kann <name> ein Gerät oder ein separater Gerätekanal sein.

== Spezielle Register (Auswahl) ==
Im folgenden sollen einige Register vorgestellt werden, die in vielen Geräten vorhanden sind. ''Ergänzungen sind ausdrücklich erwünscht!''

=== Gerätebezogene Register ===
Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten '''List0''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_00.'' zu finden).

==== ''confBtnTime'' - Kurz oder lang und der Konfigurationsmodus ====
Nicht immer sind die internen Tasten eines Gerätes ohne weiteres mit Aktionen für kurzen und langen Tastendruck programmierbar. Bei allen Hutschienen-Aktoren sowie den Zwischensteckern (mit nur einem Bedienknopf) versetzt ein langer Tastendruck (4 Sekunden) den Schalter normalerweise in den Konfigurations- bzw. Anlern-Modus, bei den in Unterputzdosen versenkbaren Schalt- und Dimmaktoren (-FM ohne PBU in der Bezeichnung) ohne eigenen Konfigurations-Button gilt dies sogar für die zur normalen Funktion extern angeschlossenen Taster. Dieses Verhalten kann man mit dem Register ''confBtnTime'' beeinflussen. Bis zum Ablauf der dort einstellbaren Zeit (Achtung: unüblich hier '''in Minuten'''!) nach dem Versorgen mit Strom (powerUp) erreicht man den Konfigurationsmodus wie bisher, danach interpretiert der Aktor die Tastendrücke als kurz (short) oder lang (long), sofern die Firmware das unterstützt (bei den versenkbaren Schalt-, dimm- und Rollladenaktoren bspw. ist das offenbar erst ab Firmware 2.5 gegeben). Ein versehentlicher Reset sollte so aber in jedem Fall vermeidbar sein. Beispiel:
:<code>set <name> regSet confBtnTime 2</code>
Möchte man den Aktor später zurücksetzen oder lokal konfigurieren, so erreicht man das ursprüngliche Verhalten in diesem Beispiel für die ersten zwei Minuten, nachdem man den Aktor (ausreichend lange) stromlos gemacht hat.

==== ''intKeyVisib'' - Interne Tasten sichtbar machen ====
Die internen "Tasten" eines Aktors (z.B. die Schaltwippe bei Wandschaltern/-tastern, der Bedienknopf bei Zwischensteckern, aber auch die angeschlossenen externen Taster bei Aktoren für Unterputzdosen oder die von außen zugängliche "Notbedientaste" etwa bei Zwischendecken-Dimmern) sind logisch ebenso mit dem Aktor verknüpft wie externe Bedienelemente wie Funkfernbedienungen oder per Funk verknüpfte Wandtaster. Ihre Betätigung wird (außer mit präparierter Firmware) zwar nicht gesendet (und kann daher von FHEM nicht "gelesen" werden), die vom Hersteller vorgesehenen Funktionen lassen sich aber genauso frei programmieren. Allerdings sind diese internen Verknüpfungen zur Vermeidung versehentlicher Programmierungen zunächst verborgen und müssen daher explizit sichtbar gemacht werden.

Dies geschieht mit
set <name> regSet intKeyVisib visib
attr <name> expert 1
Anschließend sind der oder die internen Taste(n) mit der Bezeichnung self01 (self02, ...) sichtbar und ihre Aktionen können gezielt wie bei einem externen Peer umprogrammiert werden.

Wer nun auf die Idee kommt, man könne durch entsprechendes zusätzliches peering bei mehrkanaligen Geräten die (mehreren) internen Tasten beliebig zuweisen und so raffinierte Zusatzschaltungen auslösen, muss hier enttäuscht werden: Zwar kann man tatsächlich mit peerBulk bei den Aktorkanälen zusätzliche interne Peers eintragen und programmieren und mit einer Fernauslösung aus FHEM die neuen Verknüpfungen erfolgreich nutzen - das Gerät selbst reicht die Tastenbetätigungen aber immer nur an den ursprünglich dafür vorgesehenen Kanal weiter.

==== ''ledMode'' - Funktion der Onboard-LED bei Bausätzen ====
Die (batteriebetriebenen) -PCB-Aktoren und die 8-Kanal-Module haben kleine LED an Bord, die für Diagnosezwecke hilfreich sind, einem sparsamen Betrieb aber in der Regel entgegenstehen. Sie werden daher nur bei außergewöhnlichen Zuständen wie dem Anlernmodus, einem Reset, oder auch bei niedriger Batteriespannung als Hinweis an den Anwender benutzt und sind ansonsten ab Werk deaktiviert. Bei einer Dauerstromversorgung kann aber eine Schaltzustandsanzeige oder eine Quittung über eine Befehlsaussendung nicht nur zur Diagnose hilfreich sein.

Besitzt das Gerät das Register ''ledMode'', so kann man mit
:<code>set <device> regSet ledMode on</code>
die LED auch für die "normalen" Betriebszustände aktivieren. Sie zeigen dann bei Aktoren, ob der Aktor eingeschaltet ist (blinkend, wenn eine Einschaltzeitbegrenzung aktiv ist), und bei den Sensormodulen HM-Mod-EM8(bit) zeigt die zweifarbige LED den von Fernbedienungen bekannten Sendezustand mit gelb, dem dann ein grün oder rot folgt - je nachdem ob eine Quittung angefordert ist und ob sie erfolgreich empfangen wurde.

Leider lässt sich umgekehrt die bei Wandtastern oder Fensterkontakten mitunter gewünschte Deaktivierung der LED nicht so bewerkstelligen - diese Geräte haben das entsprechende Register nicht. Da hilft nur ein Eingriff ins Gerät mit Gaffa oder schwarzem Edding...

=== Kanalbezogene Register ===
Kanalbezogene Register existieren für jeden Kanal eines Gerätes einmal und werden in der sogenannten '''List1''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_01.'' zu finden).

==== ''powerUpAction'' - Automatischer Knopfdruck bei (wiederkehrender) Stromversorgung ====
Mit diesem Register (default ''off'') kann erreicht werden, dass ein Schaltaktor nach einem Stromausfall sich bei Wiederkehr der Versorgungsspannung automatisch einschaltet. Dies ist z.B. sinnvoll für Zwischenstecker mit Messfunktion ([[HM-ES-PMSw1-Pl Funk-Schaltaktor 1-fach mit Leistungsmessung|HM-ES-PMSw1-Pl]]), wenn dieser als Langzeitmonitor etwa für Kühlgeräte verwendet wird - nach einem Stromausfall bliebe der Kühlschrank sonst aus und der Inhalt würde verderben.
:<code>set <name> regSet powerUpAction on</code>
Achtung: Das Setzen dieses Registers auf ''on'' bedeutet nicht immer einen eingeschalteten Aktor nach der Wiederkehr der Stromversorgung. Vielmehr wird nur ein ''short''-Ereignis auf den zugehörigen internen Taster ausgelöst, was nur im Normalfall zum Einschalten des Aktors führt - nicht aber wenn die Funktion dieses kurzen Tastendruckes gezielt verändert wurde, denn dann wird eben diese Aktion ausgeführt! Das gilt zum Beispiel auch für zeitlich begrenztes Einschalten. Als Alternative für eine lokale Schaltmöglichkeit bietet sich in solchen Fällen der lange Tastendruck an, sofern er vom Aktor unterstützt wird (so lässt sich die Einschaltzeit bei langem Tastendruck mit ''lgOnTime'' begrenzen). Dessen Aktion wird bei powerUp nicht ausgeführt.

=== Verknüpfungsbezogene Register ===
Diese Register sind am umfangreichsten und werden für jeden Verknüpfungspartner einzeln separat angelegt in der '''List3''' (''RegL_03.<peer>''). Die grundsätzlichen Funktionen und ihre Zusammenhänge sind ausführlich in der Einsteigerdokumentation erklärt, inklusive Skizzen für die sogenannte ''state machine''. Hier sollen daher nur die in den folgenden Beispielen verwendeten Register erklärt werden.

==== ''shOnTime'' und ''lgOnTime'' - das interne ''on-for-timer'' von Schaltern oder Dimmern ====
Die wohl populärsten Register begrenzen die Einschaltzeit eines Aktors. Um z.B. eine Steckdose für 10 sec bei Knopfdruck lokal einzuschalten kann man folgendes programmieren:
:<code>set <name> regSet shOnTime 10 self01 </code>

''shOnTime'' ist dabei das zuständige Register für die Einschaltzeit bei kurzem (sh=short) Tastendruck, entsprechend gilt ''lgOnTime'' für einen langen Tastendruck.

In den Readings werden die Register mit dem jeweiligen verknüpften Taster angezeigt, in unserem Fall also:
:<code>R-self01-shOnTime </code>

Der Defaultwert für shOnTime ist 111600 und bedeutet unendlich (von FHEM mit "unused" dargestellt), d.h. die maximale einstellbare Zeit ist 111599 sec (knapp 31 Stunden). So kann man die Zeit löschen:
:<code>set <device> regSet shOnTime 111600 self01 </code>
oder
:<code>set <device> regSet shOnTime unused self01 </code>

Übrigens gibt es diese Register auch für die Ausschaltzeit.

==== ''shCtOn'' und ''shCtOff'' - Bedingtes Schalten mit Schwellwerten ====
Fernbedienungen (im weitesten Sinne, ''remote'') von HomeMatic übermitteln je nach Betätigungsdauer ''short''- oder ''long''-Trigger. Zustandsübermittelnde Sensoren (etwa ein Fensterkontakt oder Neigungssensor sowie Bewegungsmelder) senden ausschließlich ''short'', gekoppelt mit einem Wert zwischen 0 und 200, entsprechend 0-100% in 0,5-%-Schritten. Ob ein solcher Trigger vom Aktor verarbeitet wird, kann vom gesendeten Wert abhängen.

HomeMatic kennt dazu (für jeden Peer und Triggertyp (short/long) separat, festgelegt in den Registern shCtValLo, shCtValHi, lgCtValLo und lgCtValHi) zwei Schaltschwellen "Lo" und "Hi", die default bei 50 und 100 liegen. Ob ein Trigger in Relation zu diesen Schwellen verarbeitet wird, regeln u.a. die shCtxxx-Register. Wie auch bei den allgemeinen Schaltbedingungen stehen ''On'' und ''Off'' jeweils für den aktuellen Schaltzustand (Achtung: nicht den, der erreicht werden soll). Ihr Wert beträgt default "geLo" (greater or equal Lo), hier 50 und höher. Trigger für Werte darunter werden bei der Einstellung "ltLo" (less than Lo) verarbeitet. Diese Schwellen gibt es entsprechend auch für den Hi-Wert, also "geHi" oder "ltHi". Besonders interessant sind aber auch die Werte "outside" und "between", bezogen auf die beiden Schwellen Lo und Hi. In letzterem Fall wird der Trigger verarbeitet, wenn der Wert zwischen 50 und 100 liegt, bei "outside" entsprechend bei 0-49 oder 101-200.

Sogenannte Three-State-Sensoren wie Fensterkontakt- oder -griffsensoren senden 0 für "closed" (geschlossen), 100 für "tilted" (gekippt) und 200 für "open" (offen). Gleiches gilt für Schalterkontaktinterfaces, die den Zustand eines angeschlossenen Schaltkontaktes übermitteln. Im Grundzustand (Vergleichsbefehl auf "geLo") führt daher nur der Trigger "offen" (200) zu einer Aktion. Ändert man den Vergleichsbefehl auf "ltLo", so wird lediglich "closed" ausgewertet, bei "between" ist es "tilted". Mit "outside" führt sowohl "closed" als auch "open" zu einer Aktion.

Bei Bewegungsmeldern wird der mit übermittelte Helligkeitswert im Zusammenhang mit den (dann variabel einzustellenden) Schwellen als Kriterium für das Einschalten des Aktors mit herangezogen.

==== ''shSwJtOn'' & Co. - Was soll passieren? ====
Nachdem wir nun kennengelernt haben, wie man auswählt, '''welcher''' Anstoss von außen zu einer Aktion führt, hier ein kleiner Exkurs in die Beeinflussung, '''was''' daraufhin passieren soll. Diese Frage regelt die ''jump table'' und liefert damit das Regelwerk für die Abfolge der Aktionen, die ''state machine''. Ein HomeMatic-Aktor geht nämlich keineswegs einfach nur an oder aus. Vielmehr hangelt er sich nacheinander an einer Reihe von Zuständen entlang - auch das ist in der Einsteigerdokumentation erschöpfend beschrieben und soll hier nicht wiederholt werden. Ein Schalter durchläuft aber mindestens die Zustände
Aus > Einschaltverzögerung > Ein > Ausschaltverzögerung > Aus > (usw)
Hier soll reichen, dass am Ende jeder (Teil-)Kette in der Regel ein dauerstabiler Zustand bleibt, in der Regel ist das der Aus-Zustand und auch der Ein-Zustand, wenn dessen Laufzeit nicht durch ''shOnTime'' & Co. begrenzt ist. Ein- und Ausschaltverzögerung sind aber in der Regel 0 (Sekunden), so dass effektiv nur "Ein" und "Aus" übrig bleiben.

Das Register ''shSwJtOn'' regelt, wohin die Reise geht, wenn ein gültiger ''short''-Trigger im eingeschalteten Zustand eintrifft, sinngemäß ''...Off'' im Auszustand und ''lg...'' für die ''long''-Trigger. Für ''shSwJtOn'' ist normalerweise als nächstes die Ausschaltverzögerung "dlyOff" vorgesehen. Da die Ausschaltverzögerung in der Regel 0 ist, folgt darauf, in ''shSwJtDly'' festgelegt, "off" usw. Die Zustände bilden so quasi einen Kreis, dessen Durchlauf von außen gelegentlich "angeschubst" wird. Mit diesen Registern kann man den Kreislauf aber auch umbiegen oder sogar unterbrechen, so dass ein eintreffender Trigger eben nicht zu einer Aktion führt. Als Ziele bieten sich, quasi selbstsprechend, "on", "dlyOff", "off" und "dlyOn" an - oder eben "no", was nichts anderes bedeutet, als dass der betreffende Trigger an dieser Stelle zu keiner Aktion führt.

Bei einem Dimmer heißen die Register statt ''..Sw....'' nur ''..Dim....'' und es gibt ein paar mehr Bedingungen - die Funktion ist aber entsprechend gleich.

==== ''shActionType'' & ''lgActionType'' - ein weiterer Aktions-Hauptschalter ====
Das Regelwerk von shSwJtxx & Co. wird zudem von den ActionType-Registern generell beeinflusst. Für einen Schalter gibt es neben der Voreinstellung ''jmpToTarget'' (was nichts anderes bedeutet als dass die Sprungtabelle aus dem vorigen Kapitel verwendet wird) und der Einstellung ''off'' (die die Sprungtabelle komplett deaktiviert und somit keine Trigger dieses Typs mehr zulässt) noch ''toggleToCnt'' und ''toggleToCntInv''. Hierbei wird die fortlaufende Triggernummer für die Entscheidungsfindung berücksichtigt und etwa eine Umschaltaktion (toggle) mit geraden oder ungeraden Triggernummern synchronisiert. Jeder ausgesendete Trigger trägt nämlich eine ein Byte große Triggernummer (0...255), in FHEM zu erkennen etwa an "Short_7". Nützlich ist das eigentlich nur bei mehreren Aktoren, die man mit einer Taste synchron umschalten möchte. Ohne ''toggleTo...'' würden die Aktoren nämlich nur einfach umschalten, was anfangs sicher problemlos funktioniert, aber schon ein verlorener Funkbefehl oder eine andere manuelle Aktorschaltung zerstört die Synchronisierung. Schaltet man alle Aktoren nun in diesem Register gleich, so werden sie beim Eintreffen eines Triggers (natürlich nur von diesem Peer!) immer synchron bleiben - jeder Aktor, den man davon abweichend mit der anderen ''toggleTo...''-Einstellung versieht, wird entsprechend immer gegenläufig schalten.

Bei Dimmern gibt es zudem noch ''updim'', ''downDim'', ''toggelDim'' und die entsprechenden Synchronschalter ''toggelDimCnt'' und ''toggelDimCntInv''. Sie legen für Dimmer die Dimmrichtung fest (was durchaus auch für kurze Tastendrücke möglich ist, aber eigentlich nur für lange Tastendrücke - zusammen mit ''lgMultiExec = on'', was für eine kontinuierliche Wiederholung von Triggern sorgt, solange die Taste gedrückt bleibt - einen Sinn ergibt. ''(Anmerkung: toggelDim ist aktuell tatsächlich korrekt, aber Sicht des Autors dabei schlicht ein Schreibfehler ... toggleDim wäre richtiger)''

==== ''shOnDly'' und ''shOffDly'' - es muss nicht immer sofort sein! ====
Nicht nur welcher Anstoße welche Aktion auslöst, sondern auch wann oder wie schnell die Aktion ausgeführt wird, lässt sich in gewissen Grenzen einstellen. Die beiden genannten Register etwa regeln die Ein- oder Ausschaltverzögerung nach einem gültigen Trigger. So kann man nach einem Ausschaltbefehl einen Raum noch im Hellen verlassen, wenn das Licht noch ein paar Sekunden länger leuchtet.

Bei Dimmern gibt es zusätzlich auch bei Ein- und Ausschaltvorgängen durch eine neu eingerichtete Verknüpfung eine sogenannte Rampenzeit von 0,5 Sekunden, in der das Licht hoch- oder heruntergedimmt wird. Durch Programmierung von ''shRampOnTime'' und ''shRampOffTime'' kann man ein sehr augenschonendes langsames Ein- oder Ausschalten des Lichts wie im Kino erreichen. Zwar gibt es die Zeiten auch für long-Trigger, aber da machen sie im Normalfall wenig Sinn - der lange Tastendruck löst immer einen manuellen Dimmvorgang aus.

''(wird ergänzt)''

== Praktische Beispiele ==
Die folgenden Beispiele beschreiben nur in Kurzform die erforderlichen Aktionen. Weiterführende Informationen sind der Einsteigerdokumentation oder den o.g. Registerbeschreibungen zu entnehmen.
Übrigens: ein einmal konfigurierter Vorgang für eine Verknüpfung kann aus FHEM auch bequem fernausgelöst (bzw. simuliert) werden. Der Aktor führt dabei genau die Aktion aus, die für die benannte Verknüpfung vorgesehen ist. Der kurze Knopfdruck auf den internen Knopf eines Aktors wird beispielsweise so simuliert:
:<code>set <device> press short self01 </code>

=== Lokal bedienbarer Zeitschalter mit HomeMatic Aktoren: Pool für eine Stunde schalten ===
Ich habe einen HM-LC-SW4-DR und der channel_01 schaltet die Poolzirkulationspumpe. Dies passiert zeitgesteuert zweimal am Tag. Manchmal möchte ich im Keller diese Pumpe einfach für eine Stunde aktivieren, der Aktor ist bequem erreichbar an der Wand.
Die internen Tasten vom Hauptdevice (der Aktor hat vier Kanäle (channel), die in FHEM einzeln dargestellt werden) sichtbar machen:
set LichtKeSW1 regSet intKeyVisib visib
attr LichtKeSW1 expert 1

Jetzt sieht man im Channel 01 - LichtKeSW1_Sw01 den internen peer self01. (Channel 02 ist self02 usw.)
Also jetzt einfach die Zeit eintragen:
set LichtKeSW1 regSet shOnTime 3600 self01

Die Toggle Funktion der Taste bleibt erhalten. Ein zweiter Tastendruck schaltet die Pumpe auch sofort wieder aus. Während die Zeit läuft, blinkt die Status LED des Kanals.
Die Zeitbegrenzung funktioniert in diesem Beispiel ohne jedes Zutun von FHEM und damit auch bei einem Ausfall des Servers.

=== Es werde Licht! Automatisches Licht mit Tor oder Tür ===
Im Kühlschrank geht das Licht ja schon praktischerweise automatisch an und aus, aber es gibt auch andere Situationen, in denen ein automatisches Licht sehr nützlich sein kann - in dunklen Abstellräumen oder Garagen. Vor allem weil man nicht vergessen kann es auszuschalten, weil es auch von allein ausgeht. Eine solche Funktion, so könnte man meinen, wird ganz einfach erreicht, indem man das Licht mit einem Aktor schalten lässt und diesen mit einem Tür- oder Fensterkontakt verknüpft. Hat man die beiden dann mit ''peerChan'' verknüpft, so wird man feststellen, dass das Licht mitnichten das Gewünschte tut: es schaltet sich beim Öffnen der Tür abwechselnd ein und aus und ignoriert das Schließen der Tür komplett.

Verantwortlich für dieses "Fehlverhalten" sind die Register ''shCtOn'' und ''shCtOff''. Beide stehen nach der Verknüpfung auf "geLo". Wie bei den Registern oben erläutert, führt in diesem Fall nur die "offen"-Meldung des Türkontaktes zu einer Aktion. Das Öffnen der Tür soll den Aktor einschalten, das klappt. Das Schließen der Tür soll den eingeschalteten Aktor aber ausschalten. Also muss die Schaltbedingung im On-Zustand geändert werden (die Bezeichnungen natürlich durch die realen Namen des Schaltaktorkanals und des Türkontaktes ersetzen):
:<code>set <Schalter> regSet shCtOn ltLo <Türkontakt> </code>
Nun führt auch das Schließen der Tür wunschgemäß stets zu einem Abschalten des Lichts. ''shCtOff'' muss auf "geLo" bleiben!

Kombinieren ließe sich das noch mit einer Laufzeitbegrenzung etwa für eine Stunde - sollte man die Tür versehentlich offenlassen, so brennt das Licht nicht stundenlang. Vor allem geht das Licht dann auch aus, wenn aus welchem Grund auch immer die Schließmeldung verloren geht.
:<code>set <Schalter> regSet shOnTime 3600 <Türkontakt> </code>

=== Lampe mit Kippschalter(n) fernschalten - eindeutig oder als Wechselschaltung ===
Oft besteht der Wunsch, eine Lampe mit einem herkömmlichen Schalter (statt eines Tasters) fernzuschalten. So kann man einen herkömmlichen Schalter mit einer Schließerkontaktinterface wie dem [[HM-SCI-3-FM 3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]] ergänzen (oder einem Kanal des [[HM-MOD-EM-8 8-Kanal-Sendemodul|8-Kanal-Sendemoduls]] in der Betriebsart ''sensor'') und wiederum die Verknüpfung mit dem Lampen-Aktor setzen. Ganz ähnlich wie bei der vorgenannten Abstellraum-Aufgabe führt nun aber das Schließen des Schalters nicht zu einem Einschalten. Daher ist nun
:<code>set <Lampenaktor> regSet shCtOff ltLo <Sensorkontakt> </code>
das Mittel der Wahl, ''shCtOn'' muss dieses Mal auf "geLo" bleiben. Jetzt folgt der Aktor dem (sichtbaren) Schaltzustand des Schaltes - zumindest solange er nicht anderweitig ein- oder ausgeschaltet wird.

Nun kann man auch mehrere Schalter so mit der Lampe koppeln. Das ergibt aber keine Wechselschaltung im herkömmlichen Sinn - um eine Lampe ein- oder auszuschalten, muss man den Schalter möglicherweise einmal zusätzlich auf die aktuelle Schaltposition kippen, ehe die nächste Betätigung den gewünschten Effekt bringt. Für Wechselschaltungen bietet sich daher das Kontaktinterface [[HM-SwI-3-FM]] (oder das erwähnte 8-Kanal-Sendemodul in der Betriebsart ''switch'') an. Hier führt jede Zustands''änderung'' zu einem Schaltvorgang.

Hat man hingegen nur ein HM-SCI-3-FM zur Hand, lässt sich dieses Verhalten auch erreichen.
:<code>set <Lampenaktor> regSet shCtOn outside <Sensorkontakt> </code>
:<code>set <Lampenaktor> regSet shCtOff outside <Sensorkontakt> </code>
Wie oben erwähnt, liegen die Trigger mit den Werten 0 und 200 ja außerhalb des Bereichs zwischen Lo und Hi (50-100) und führen daher immer zu einer Aktion. Das Verhalten entspricht somit einem toggle-Befehl.

=== Gezieltes Schalten eines (unsichtbaren) Aktors mit nur einer Taste ===
Für so etwas braucht man gewöhnlich zwei Tasten. Koppelt man einen Schalt-Aktor mit nur einer Taste ("single" beim ''peerChan''-Kommando), so führt sowohl ein kurzer als auch ein langer Tastendruck immer nur zu einem Umschalten des Zustandes. Das ist unschön, wenn man den aktuellen Zustand nicht einsehen kann.

Üblicherweise sind die Schaltabfolgen für eine Eintasten-Verknüpfung sowohl für kurze als auch lange Betätigungen gleich (bei Dimmern wird auf langen Tastendruck hingegen abwechselnd auf- oder abgedimmt).
shSwJtOff = dlyOn # Ist Gerät aus, wird Einschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOff = dlyOn # dito, für lang
shSwJtOn = dlyOff # Ist Gerät an, wird Ausschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOn = dlyOff # dito, für lang
Hier kann man sich zunutze machen, dass man mit einem gezielten "no" oder "dlyOn" bzw. "dlyOff" im richtigen Register die Schaltfolge abbrechen oder umbiegen kann.
Möchte man das Gerät <aktor> mit einem kurzen Tastendruck auf <button> ein- und mit einem langen Tastendruck ausschalten, so ändere man:
:<code>set <aktor> regSet shSwJtOn dlyOn <button> </code>
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>
So laufen die entsprechenden Aktionen quasi ins Leere, wenn der Aktor bereits den gewünschten Zustand hat.

Den umgekehrten Effekt (lang schaltet ein, kurz aus) erreicht man entsprechend mit
:<code>set <aktor> regSet shSwJtOff dlyOff <button> </code>
:<code>set <aktor> regSet lgSwJtOn dlyOn <button> </code>

Welche Bedienhaptik man nun bevorzugt, muss man selbst entscheiden. In der Regel sollte die normale (sichere) Aktion "kurz" und die gefährlichere "lang" sein - eine PC-Stromversorgung mit einem kurzen Tastendruck versehentlich einzuschalten ist bestimmt besser als auszuschalten (das dann eben nur über lang) - für ein potentiell gefährliches Arbeitsgerät wie einen Heizofen wird es sicher andersherum sein.

Sinngemäß verwendet der Autor sozusagen eine Hälfte davon als "Sicherheitsaktion" für einen [[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach]] - der gewöhnliche Tastendruck auf die zugehörige Wippenseite schaltet den Aktor abwechselnd ein und aus, ein langer Tastendruck immer aus, dafür reicht:
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>

Übrigens: Nichts anderes wird normalerweise auch automatisch beim Verknüpfen eines Aktors mit einem Tastenpaar an der entsprechenden Stelle gemacht - ist eine Taste nur zum Ausschalten gedacht, so wird in beiden Schaltzuständen entsprechend "dlyOff" eingetragen. Als "Sprungziel" müsste aber genauso gut auch "no" funkionieren.

=== WARNUNG! - Selbsttätiges Blinken eines HM-Aktors ===
Statt einer separaten Warnleuchte kann es durchaus sinnvoll sein, eine vorhandene Lampe zu Warnzwecken periodisch ein- und auszuschalten. Leider beherrschen die HomeMatic-Aktoren keine direkt aus FHEM erreichbare Blinkfunktion (ähnlich dem on-for-timer für eine Zeitbegrenzung), und das rhythmische Ein- und Ausschalten aus FHEM erzeugt eine recht hohe Funklast.

Wir wissen aber, dass die Aktoren für jeden Peer nicht nur eine Ein-, sondern auch eine Ausschaltzeit speichern. Definiert man nun für einen Peer entsprechend beide Zeiten, so wird der Aktor bei einem Telegramm von diesem Peer sich entsprechend selbsttätig fortlaufend ein- und ausschalten. Jeder andere Schaltbefehl eines anderen Peers oder aus FHEM beendet die Schleife umgehend. So ließe sich das Blinken auch mit einer aktoreigenen Taste stoppen - oder starten, wenn man es entsprechend programmiert. Einen Zwischenstecker-Schalter beispielsweise kann man also (wenn man zuvor seine ''confBtnTime'' entsprechend setzt und so die langen Tastendrücke auswertbar macht) durch das Programmieren von ''lgOnTime'' und ''lgOffTime'' für den Peer "self01" wie gewohnt mit einem kurzen Tastendruck ein- und ausschalten und mit einem langen in den Blinkmodus versetzen.

Einen Haken hat die Sache aber: Der Aktor meldet seinen neuen Schaltzustand nach jeder Änderung mit einer gewissen Verzögerung, die man bei vielen Schaltaktoren (aber leider nicht bei allen wie etwa dem HM-Mod-Re-8) mit dem Register ''statusInfoMinDly'' tunen kann. Ändert der Aktor seinen Schaltzustand in längeren Intervallen, wird es also trotzdem wieder ein Funkfeuer geben. Ist das Delay noch nicht erreicht, erfolgt keine Zustandsübermittlung. Beim HM-Mod-Re-8 muss man also etwa unter 1 Sekunde pro Änderung bleiben.

Zum Steuern aus FHEM emfiehlt es sich, virtuelle Buttons (etwa einer VCCU oder eines virtuellen HM-Dummys) zum Ein- und Ausschalten der Blinkfunktion zu verwenden. "Opfert" man dafür zwei aufeinanderfolgende Kanäle, kann man die Aktoren mit "dual set" peeren und bekommt so einen Blink- und einen Deaktivierungsbutton ohne weitere Kopfstände. Anschließend passt man die short-Laufzeiten für den Einschaltkanal an.

Ein Beispiel für einen Dimmer (als virtuelle Buttons dienen vccu_Btn8 und vccuBtn9):

:<code>set <vccu_Btn8 peerChan 0 <dimmerkanal> dual set</code>

Nun kann man mit "set vccu_Btn9 press short" den Dimmer ein- und mit "set vccu_Btn8 press short" ausschalten. Das Blinken im Dimmer wird eingestellt mit

:<code>set dimmer regSet shOnTime 1 vccu_Btn9</code>
:<code>set dimmer regSet shOffTime 1 vccu_Btn9</code>
jeweils für die gewünschte Ein- und Ausschaltzeit.

Wird der Dimmer nun mit "set vccu_Btn9 press short" eingeschaltet, so blinkt er im 3-Sekunden-Takt: zu den jeweils 1 Sekunde Ein- und Auszeit gesellen sich noch 2x 0,5s Rampenzeit, sofern nichts anderes programmiert wurde.

Das funktioniert auch mit Schaltern: So würde 0.1 und 0.9 (Sekunden) ein kurzes Blitzen im Sekundentakt einstellen.

Natürlich kann man nun eine größere Anzahl von Aktoren mit den virtuellen Buttons peeren und so ein ganzes Feuerwerk zünden ... Eine zusätzlich zu Alarmsirenen wild blinkende Innenbeleuchtung in allen Räumen sorgt sicher für zusätzliche Aufmerksamkeit.

=== Einer nach dem Anderen! - Sequentielles Schalten mehrerer Aktoren ===
Eine großflächige Beleuchtung mit viel Leistung sollte man aus Lastgründen niemals zugleich einschalten. Auch LED-Lampen ziehen im Einschaltmoment, wennauch extrem kurz, beträchtliche Ströme, die die von gewöhnlichen Glühlampen deutlich übersteigen können. Schaltet man mehrere Aktoren gleichzeitig mit einer Taste, so hilft eine individuelle Verzögerung des Einschaltvorgangs in jedem Aktor, die Sicherung vor dem Herausfliegen zu bewahren. Oder man macht gezielt einen Effekt daraus. Der Phantasie sind wenig Grenzen gesetzt...

Hat man drei Aktoren "Aussenlicht1...3" mit dem Taster "Aussenlicht_Ein" gepeert, so erreicht man auf folgende Weise, dass sie beim Einschalten mit einer Verzögerung von jeweils einer Sekunde nacheinander einschalten.

:<code>set Aussenlicht2 regSet shOnDly 1 Aussenlicht_Ein</code>
:<code>set Aussenlicht3 regSet shOnDly 2 Aussenlicht_Ein</code> [[Kategorie:HomeMatic Components|1toolsAndWork]]

HomeMatic Register programmieren

2020-07-13T10:45:12Z

Pfriemler: Erweiterung um sh|lgActionType

{{Baustelle}}
Ein HomeMatic-Gerät besitzt mehr oder weniger umfangreiche Registersätze, mit denen das Verhalten des Gerätes vielfältig feinkonfiguriert werden kann. Die damit erreichbare Funktionsvielfalt geht weit über die standardisierten Vorgaben einer einfachen Direktverknüpfung ([[Peering_(HomeMatic)|Peering]]) hinaus.

== Grundlagen (in Auszügen) ==

Im folgenden werden nur exemplarisch einige Grundlagen und einfache Beispiele benannt, ohne jeden Anspruch auf Vollständigkeit.

FHEM unterstützt die Programmierung der Register mit dem Befehl ''regSet''. <peer> entfällt bei rein gerätebezogenen Programmierungen.
:<code>set <name> regSet <register> <value> [<peer>] </code>
Darüberhinaus gibt es vor- oder selbstdefinierte [[HomeMatic_HmInfo_Templates_erstellen|Templates]] (Vorlagen), die alle erforderlichen Änderungen für standardisierte Anwendungen wie Treppenhauslichtschalter beinhalten. Die Anwendung von Templates auf Geräte wird protokolliert und der Registerzustand kann überprüft werden. Für viele Anwendungen genügt jedoch auch die einmalige Anwendung einer direkten Programmierung. Das genaue Verständnis der Vorgänge und Zusammenhänge ist nicht trivial, das Erlernen wird aber mit einer enormen erreichbaren Funktionsvielfalt belohnt. Viele wissenswerte Zusammenhänge sind im Homematic-Anhang der bekannten Einsteiger-Dokumentation erläutert, deren Lektüre zu Recht immer wieder empfohlen wird. Dieser Beitrag ist auch nur als Ergänzung zu verstehen!

Die HomeMatic Aktoren (Schalter, Dimmer, ...) arbeiten so, wie es für verknüpften ([[Peering (HomeMatic)|peering]]) Sender vorgegeben ist. Sie nutzen Registersätze, die für jede Verknüpfung (peer) neu angelegt und gespeichert werden. Man kann also mit einem Taster ein- und ausschalten (toggeln), mit einem Tastenpaar gezielt ein- und ausschalten und mit einem weiteren Taster eine Zeitschaltung für 10 Sekunden starten. Dabei wird niemals der Taster oder der Schalter auf eine globale Aktion programmiert, sondern im Schalter (Aktor) die gewünschte Aktion für jeden verknüpften Taster separat gespeichert. Die auszulösende Aktion ist zudem abhängig vom aktuellen Zustand des Aktors und von der Länge des Tastendruckes (kurz oder länger - short or long).

Kleines Beispiel:
T1 schaltet S1 für 10 sec an
T2 schaltet S1 an oder aus
T3 schaltet S1 an
T4 schaltet S1 aus.

Diese Tabelle ist im Schalter S1 gespeichert.

Schaltet man mit T3 den S1 an und drückt dann nach beliebiger Zeit kurz T1 geht S1 nach weiteren 10 sec aus. Schaltet man mit T1 kurz den S1 für 10 sec an, aber innerhalb dieser Zeit mit T3 nochmal an, dann bleibt S1 nach Ablauf der 10 sec an.

Die verfügbaren Register unterscheiden sich im Gerät und in den jeweiligen Kanälen.
Eine kurze Beschreibung der Register inklusive der erlaubten Werte erhält man durch:
:<code>get <name> regList </code>
Dabei kann <name> ein Gerät oder ein separater Gerätekanal sein.

== Spezielle Register (Auswahl) ==
Im folgenden sollen einige Register vorgestellt werden, die in vielen Geräten vorhanden sind. ''Ergänzungen sind ausdrücklich erwünscht!''

=== Gerätebezogene Register ===
Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten '''List0''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_00.'' zu finden).

==== ''confBtnTime'' - Kurz oder lang und der Konfigurationsmodus ====
Nicht immer sind die internen Tasten eines Gerätes ohne weiteres mit Aktionen für kurzen und langen Tastendruck programmierbar. Bei allen Hutschienen-Aktoren sowie den Zwischensteckern (mit nur einem Bedienknopf) versetzt ein langer Tastendruck (4 Sekunden) den Schalter normalerweise in den Konfigurations- bzw. Anlern-Modus, bei den in Unterputzdosen versenkbaren Schalt- und Dimmaktoren (-FM ohne PBU in der Bezeichnung) ohne eigenen Konfigurations-Button gilt dies sogar für die zur normalen Funktion extern angeschlossenen Taster. Dieses Verhalten kann man mit dem Register ''confBtnTime'' beeinflussen. Bis zum Ablauf der dort einstellbaren Zeit (Achtung: unüblich hier '''in Minuten'''!) nach dem Versorgen mit Strom (powerUp) erreicht man den Konfigurationsmodus wie bisher, danach interpretiert der Aktor die Tastendrücke stets als kurz (short) oder lang (long). Beispiel:
:<code>set <name> regSet confBtnTime 2</code>
Möchte man den Aktor später zurücksetzen oder lokal konfigurieren, so erreicht man das ursprüngliche Verhalten in diesem Beispiel für die ersten zwei Minuten, nachdem man den Aktor (ausreichend lange) stromlos gemacht hat.

==== ''intKeyVisib'' - Interne Tasten sichtbar machen ====
Die internen "Tasten" eines Aktors (z.B. die Schaltwippe bei Wandschaltern/-tastern, der Bedienknopf bei Zwischensteckern, aber auch die angeschlossenen externen Taster bei Aktoren für Unterputzdosen oder die von außen zugängliche "Notbedientaste" etwa bei Zwischendecken-Dimmern) sind logisch ebenso mit dem Aktor verknüpft wie externe Bedienelemente wie Funkfernbedienungen oder per Funk verknüpfte Wandtaster. Ihre Betätigung wird (außer mit präparierter Firmware) zwar nicht gesendet (und kann daher von FHEM nicht "gelesen" werden), die vom Hersteller vorgesehenen Funktionen lassen sich aber genauso frei programmieren. Allerdings sind diese internen Verknüpfungen zur Vermeidung versehentlicher Programmierungen zunächst verborgen und müssen daher explizit sichtbar gemacht werden.

Dies geschieht mit
set <name> regSet intKeyVisib visib
attr <name> expert 1
Anschließend sind der oder die internen Taste(n) mit der Bezeichnung self01 (self02, ...) sichtbar und ihre Aktionen können gezielt wie bei einem externen Peer umprogrammiert werden.

Wer nun auf die Idee kommt, man könne durch entsprechendes zusätzliches peering bei mehrkanaligen Geräten die (mehreren) internen Tasten beliebig zuweisen und so raffinierte Zusatzschaltungen auslösen, muss hier enttäuscht werden: Zwar kann man tatsächlich mit peerBulk bei den Aktorkanälen zusätzliche interne Peers eintragen und programmieren und mit einer Fernauslösung aus FHEM die neuen Verknüpfungen erfolgreich nutzen - das Gerät selbst reicht die Tastenbetätigungen aber immer nur an den ursprünglich dafür vorgesehenen Kanal weiter.

==== ''ledMode'' - Funktion der Onboard-LED bei Bausätzen ====
Die (batteriebetriebenen) -PCB-Aktoren und die 8-Kanal-Module haben kleine LED an Bord, die für Diagnosezwecke hilfreich sind, einem sparsamen Betrieb aber in der Regel entgegenstehen. Sie werden daher nur bei außergewöhnlichen Zuständen wie dem Anlernmodus, einem Reset, oder auch bei niedriger Batteriespannung als Hinweis an den Anwender benutzt und sind ansonsten ab Werk deaktiviert. Bei einer Dauerstromversorgung kann aber eine Schaltzustandsanzeige oder eine Quittung über eine Befehlsaussendung nicht nur zur Diagnose hilfreich sein.

Besitzt das Gerät das Register ''ledMode'', so kann man mit
:<code>set <device> regSet ledMode on</code>
die LED auch für die "normalen" Betriebszustände aktivieren. Sie zeigen dann bei Aktoren, ob der Aktor eingeschaltet ist (blinkend, wenn eine Einschaltzeitbegrenzung aktiv ist), und bei den Sensormodulen HM-Mod-EM8(bit) zeigt die zweifarbige LED den von Fernbedienungen bekannten Sendezustand mit gelb, dem dann ein grün oder rot folgt - je nachdem ob eine Quittung angefordert ist und ob sie erfolgreich empfangen wurde.

Leider lässt sich umgekehrt die bei Wandtastern oder Fensterkontakten mitunter gewünschte Deaktivierung der LED nicht so bewerkstelligen - diese Geräte haben das entsprechende Register nicht. Da hilft nur ein Eingriff ins Gerät mit Gaffa oder schwarzem Edding...

=== Kanalbezogene Register ===
Kanalbezogene Register existieren für jeden Kanal eines Gerätes einmal und werden in der sogenannten '''List1''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_01.'' zu finden).

==== ''powerUpAction'' - Automatischer Knopfdruck bei (wiederkehrender) Stromversorgung ====
Mit diesem Register (default ''off'') kann erreicht werden, dass ein Schaltaktor nach einem Stromausfall sich bei Wiederkehr der Versorgungsspannung automatisch einschaltet. Dies ist z.B. sinnvoll für Zwischenstecker mit Messfunktion ([[HM-ES-PMSw1-Pl Funk-Schaltaktor 1-fach mit Leistungsmessung|HM-ES-PMSw1-Pl]]), wenn dieser als Langzeitmonitor etwa für Kühlgeräte verwendet wird - nach einem Stromausfall bliebe der Kühlschrank sonst aus und der Inhalt würde verderben.
:<code>set <name> regSet powerUpAction on</code>
Achtung: Das Setzen dieses Registers auf ''on'' bedeutet nicht immer einen eingeschalteten Aktor nach der Wiederkehr der Stromversorgung. Vielmehr wird nur ein ''short''-Ereignis auf den zugehörigen internen Taster ausgelöst, was nur im Normalfall zum Einschalten des Aktors führt - nicht aber wenn die Funktion dieses kurzen Tastendruckes gezielt verändert wurde, denn dann wird eben diese Aktion ausgeführt! Das gilt zum Beispiel auch für zeitlich begrenztes Einschalten. Als Alternative für eine lokale Schaltmöglichkeit bietet sich in solchen Fällen der lange Tastendruck an, sofern er vom Aktor unterstützt wird (so lässt sich die Einschaltzeit bei langem Tastendruck mit ''lgOnTime'' begrenzen). Dessen Aktion wird bei powerUp nicht ausgeführt.

=== Verknüpfungsbezogene Register ===
Diese Register sind am umfangreichsten und werden für jeden Verknüpfungspartner einzeln separat angelegt in der '''List3''' (''RegL_03.<peer>''). Die grundsätzlichen Funktionen und ihre Zusammenhänge sind ausführlich in der Einsteigerdokumentation erklärt, inklusive Skizzen für die sogenannte ''state machine''. Hier sollen daher nur die in den folgenden Beispielen verwendeten Register erklärt werden.

==== ''shOnTime'' und ''lgOnTime'' - das interne ''on-for-timer'' von Schaltern oder Dimmern ====
Die wohl populärsten Register begrenzen die Einschaltzeit eines Aktors. Um z.B. eine Steckdose für 10 sec bei Knopfdruck lokal einzuschalten kann man folgendes programmieren:
:<code>set <name> regSet shOnTime 10 self01 </code>

''shOnTime'' ist dabei das zuständige Register für die Einschaltzeit bei kurzem (sh=short) Tastendruck, entsprechend gilt ''lgOnTime'' für einen langen Tastendruck.

In den Readings werden die Register mit dem jeweiligen verknüpften Taster angezeigt, in unserem Fall also:
:<code>R-self01-shOnTime </code>

Der Defaultwert für shOnTime ist 111600 und bedeutet unendlich (von FHEM mit "unused" dargestellt), d.h. die maximale einstellbare Zeit ist 111599 sec (knapp 31 Stunden). So kann man die Zeit löschen:
:<code>set <device> regSet shOnTime 111600 self01 </code>
oder
:<code>set <device> regSet shOnTime unused self01 </code>

Übrigens gibt es diese Register auch für die Ausschaltzeit.

==== ''shCtOn'' und ''shCtOff'' - Bedingtes Schalten mit Schwellwerten ====
Fernbedienungen (im weitesten Sinne, ''remote'') von HomeMatic übermitteln je nach Betätigungsdauer ''short''- oder ''long''-Trigger. Zustandsübermittelnde Sensoren (etwa ein Fensterkontakt oder Neigungssensor sowie Bewegungsmelder) senden ausschließlich ''short'', gekoppelt mit einem Wert zwischen 0 und 200, entsprechend 0-100% in 0,5-%-Schritten. Ob ein solcher Trigger vom Aktor verarbeitet wird, kann vom gesendeten Wert abhängen.

HomeMatic kennt dazu (für jeden Peer und Triggertyp (short/long) separat, festgelegt in den Registern shCtValLo, shCtValHi, lgCtValLo und lgCtValHi) zwei Schaltschwellen "Lo" und "Hi", die default bei 50 und 100 liegen. Ob ein Trigger in Relation zu diesen Schwellen verarbeitet wird, regeln u.a. die shCtxxx-Register. Wie auch bei den allgemeinen Schaltbedingungen stehen ''On'' und ''Off'' jeweils für den aktuellen Schaltzustand (Achtung: nicht den, der erreicht werden soll). Ihr Wert beträgt default "geLo" (greater or equal Lo), hier 50 und höher. Trigger für Werte darunter werden bei der Einstellung "ltLo" (less than Lo) verarbeitet. Diese Schwellen gibt es entsprechend auch für den Hi-Wert, also "geHi" oder "ltHi". Besonders interessant sind aber auch die Werte "outside" und "between", bezogen auf die beiden Schwellen Lo und Hi. In letzterem Fall wird der Trigger verarbeitet, wenn der Wert zwischen 50 und 100 liegt, bei "outside" entsprechend bei 0-49 oder 101-200.

Sogenannte Three-State-Sensoren wie Fensterkontakt- oder -griffsensoren senden 0 für "closed" (geschlossen), 100 für "tilted" (gekippt) und 200 für "open" (offen). Gleiches gilt für Schalterkontaktinterfaces, die den Zustand eines angeschlossenen Schaltkontaktes übermitteln. Im Grundzustand (Vergleichsbefehl auf "geLo") führt daher nur der Trigger "offen" (200) zu einer Aktion. Ändert man den Vergleichsbefehl auf "ltLo", so wird lediglich "closed" ausgewertet, bei "between" ist es "tilted". Mit "outside" führt sowohl "closed" als auch "open" zu einer Aktion.

Bei Bewegungsmeldern wird der mit übermittelte Helligkeitswert im Zusammenhang mit den (dann variabel einzustellenden) Schwellen als Kriterium für das Einschalten des Aktors mit herangezogen.

==== ''shSwJtOn'' & Co. - Was soll passieren? ====
Nachdem wir nun kennengelernt haben, wie man auswählt, '''welcher''' Anstoss von außen zu einer Aktion führt, hier ein kleiner Exkurs in die Beeinflussung, '''was''' daraufhin passieren soll. Diese Frage regelt die ''jump table'' und liefert damit das Regelwerk für die Abfolge der Aktionen, die ''state machine''. Ein HomeMatic-Aktor geht nämlich keineswegs einfach nur an oder aus. Vielmehr hangelt er sich nacheinander an einer Reihe von Zuständen entlang - auch das ist in der Einsteigerdokumentation erschöpfend beschrieben und soll hier nicht wiederholt werden. Ein Schalter durchläuft aber mindestens die Zustände
Aus > Einschaltverzögerung > Ein > Ausschaltverzögerung > Aus > (usw)
Hier soll reichen, dass am Ende jeder (Teil-)Kette in der Regel ein dauerstabiler Zustand bleibt, in der Regel ist das der Aus-Zustand und auch der Ein-Zustand, wenn dessen Laufzeit nicht durch ''shOnTime'' & Co. begrenzt ist. Ein- und Ausschaltverzögerung sind aber in der Regel 0 (Sekunden), so dass effektiv nur "Ein" und "Aus" übrig bleiben.

Das Register ''shSwJtOn'' regelt, wohin die Reise geht, wenn ein gültiger ''short''-Trigger im eingeschalteten Zustand eintrifft, sinngemäß ''...Off'' im Auszustand und ''lg...'' für die ''long''-Trigger. Für ''shSwJtOn'' ist normalerweise als nächstes die Ausschaltverzögerung "dlyOff" vorgesehen. Da die Ausschaltverzögerung in der Regel 0 ist, folgt darauf, in ''shSwJtDly'' festgelegt, "off" usw. Die Zustände bilden so quasi einen Kreis, dessen Durchlauf von außen gelegentlich "angeschubst" wird. Mit diesen Registern kann man den Kreislauf aber auch umbiegen oder sogar unterbrechen, so dass ein eintreffender Trigger eben nicht zu einer Aktion führt. Als Ziele bieten sich, quasi selbstsprechend, "on", "dlyOff", "off" und "dlyOn" an - oder eben "no", was nichts anderes bedeutet, als dass der betreffende Trigger an dieser Stelle zu keiner Aktion führt.

Bei einem Dimmer heißen die Register statt ''..Sw....'' nur ''..Dim....'' und es gibt ein paar mehr Bedingungen - die Funktion ist aber entsprechend gleich.

==== ''shActionType'' & ''lgActionType'' - ein weiterer Aktions-Hauptschalter ====
Das Regelwerk von shSwJtxx & Co. wird zudem von den ActionType-Registern generell beeinflusst. Für einen Schalter gibt es neben der Voreinstellung ''jmpToTarget'' (was nichts anderes bedeutet als dass die Sprungtabelle aus dem vorigen Kapitel verwendet wird) und der Einstellung ''off'' (die die Sprungtabelle komplett deaktiviert und somit keine Trigger dieses Typs mehr zulässt) noch ''toggleToCnt'' und ''toggleToCntInv''. Hierbei wird die fortlaufende Triggernummer für die Entscheidungsfindung berücksichtigt und etwa eine Umschaltaktion (toggle) mit geraden oder ungeraden Triggernummern synchronisiert. Jeder ausgesendete Trigger trägt nämlich eine ein Byte große Triggernummer (0...255), in FHEM zu erkennen etwa an "Short_7". Nützlich ist das eigentlich nur bei mehreren Aktoren, die man mit einer Taste synchron umschalten möchte. Ohne ''toggleTo...'' würden die Aktoren nämlich nur einfach umschalten, was anfangs sicher problemlos funktioniert, aber schon ein verlorener Funkbefehl oder eine andere manuelle Aktorschaltung zerstört die Synchronisierung. Schaltet man alle Aktoren nun in diesem Register gleich, so werden sie beim Eintreffen eines Triggers (natürlich nur von diesem Peer!) immer synchron bleiben - jeder Aktor, den man davon abweichend mit der anderen ''toggleTo...''-Einstellung versieht, wird entsprechend immer gegenläufig schalten.

Bei Dimmern gibt es zudem noch ''updim'', ''downDim'', ''toggelDim'' und die entsprechenden Synchronschalter ''toggelDimCnt'' und ''toggelDimCntInv''. Sie legen für Dimmer die Dimmrichtung fest (was durchaus auch für kurze Tastendrücke möglich ist, aber eigentlich nur für lange Tastendrücke - zusammen mit ''lgMultiExec = on'', was für eine kontinuierliche Wiederholung von Triggern sorgt, solange die Taste gedrückt bleibt - einen Sinn ergibt. ''(Anmerkung: toggelDim ist aktuell tatsächlich korrekt, aber Sicht des Autors dabei schlicht ein Schreibfehler ... toggleDim wäre richtiger)''

==== ''shOnDly'' und ''shOffDly'' - es muss nicht immer sofort sein! ====
Nicht nur welcher Anstoße welche Aktion auslöst, sondern auch wann oder wie schnell die Aktion ausgeführt wird, lässt sich in gewissen Grenzen einstellen. Die beiden genannten Register etwa regeln die Ein- oder Ausschaltverzögerung nach einem gültigen Trigger. So kann man nach einem Ausschaltbefehl einen Raum noch im Hellen verlassen, wenn das Licht noch ein paar Sekunden länger leuchtet.

Bei Dimmern gibt es zusätzlich auch bei Ein- und Ausschaltvorgängen durch eine neu eingerichtete Verknüpfung eine sogenannte Rampenzeit von 0,5 Sekunden, in der das Licht hoch- oder heruntergedimmt wird. Durch Programmierung von ''shRampOnTime'' und ''shRampOffTime'' kann man ein sehr augenschonendes langsames Ein- oder Ausschalten des Lichts wie im Kino erreichen. Zwar gibt es die Zeiten auch für long-Trigger, aber da machen sie im Normalfall wenig Sinn - der lange Tastendruck löst immer einen manuellen Dimmvorgang aus.

''(wird ergänzt)''

== Praktische Beispiele ==
Die folgenden Beispiele beschreiben nur in Kurzform die erforderlichen Aktionen. Weiterführende Informationen sind der Einsteigerdokumentation oder den o.g. Registerbeschreibungen zu entnehmen.
Übrigens: ein einmal konfigurierter Vorgang für eine Verknüpfung kann aus FHEM auch bequem fernausgelöst (bzw. simuliert) werden. Der Aktor führt dabei genau die Aktion aus, die für die benannte Verknüpfung vorgesehen ist. Der kurze Knopfdruck auf den internen Knopf eines Aktors wird beispielsweise so simuliert:
:<code>set <device> press short self01 </code>

=== Lokal bedienbarer Zeitschalter mit HomeMatic Aktoren: Pool für eine Stunde schalten ===
Ich habe einen HM-LC-SW4-DR und der channel_01 schaltet die Poolzirkulationspumpe. Dies passiert zeitgesteuert zweimal am Tag. Manchmal möchte ich im Keller diese Pumpe einfach für eine Stunde aktivieren, der Aktor ist bequem erreichbar an der Wand.
Die internen Tasten vom Hauptdevice (der Aktor hat vier Kanäle (channel), die in FHEM einzeln dargestellt werden) sichtbar machen:
set LichtKeSW1 regSet intKeyVisib visib
attr LichtKeSW1 expert 1

Jetzt sieht man im Channel 01 - LichtKeSW1_Sw01 den internen peer self01. (Channel 02 ist self02 usw.)
Also jetzt einfach die Zeit eintragen:
set LichtKeSW1 regSet shOnTime 3600 self01

Die Toggle Funktion der Taste bleibt erhalten. Ein zweiter Tastendruck schaltet die Pumpe auch sofort wieder aus. Während die Zeit läuft, blinkt die Status LED des Kanals.
Die Zeitbegrenzung funktioniert in diesem Beispiel ohne jedes Zutun von FHEM und damit auch bei einem Ausfall des Servers.

=== Es werde Licht! Automatisches Licht mit Tor oder Tür ===
Im Kühlschrank geht das Licht ja schon praktischerweise automatisch an und aus, aber es gibt auch andere Situationen, in denen ein automatisches Licht sehr nützlich sein kann - in dunklen Abstellräumen oder Garagen. Vor allem weil man nicht vergessen kann es auszuschalten, weil es auch von allein ausgeht. Eine solche Funktion, so könnte man meinen, wird ganz einfach erreicht, indem man das Licht mit einem Aktor schalten lässt und diesen mit einem Tür- oder Fensterkontakt verknüpft. Hat man die beiden dann mit ''peerChan'' verknüpft, so wird man feststellen, dass das Licht mitnichten das Gewünschte tut: es schaltet sich beim Öffnen der Tür abwechselnd ein und aus und ignoriert das Schließen der Tür komplett.

Verantwortlich für dieses "Fehlverhalten" sind die Register ''shCtOn'' und ''shCtOff''. Beide stehen nach der Verknüpfung auf "geLo". Wie bei den Registern oben erläutert, führt in diesem Fall nur die "offen"-Meldung des Türkontaktes zu einer Aktion. Das Öffnen der Tür soll den Aktor einschalten, das klappt. Das Schließen der Tür soll den eingeschalteten Aktor aber ausschalten. Also muss die Schaltbedingung im On-Zustand geändert werden (die Bezeichnungen natürlich durch die realen Namen des Schaltaktorkanals und des Türkontaktes ersetzen):
:<code>set <Schalter> regSet shCtOn ltLo <Türkontakt> </code>
Nun führt auch das Schließen der Tür wunschgemäß stets zu einem Abschalten des Lichts. ''shCtOff'' muss auf "geLo" bleiben!

Kombinieren ließe sich das noch mit einer Laufzeitbegrenzung etwa für eine Stunde - sollte man die Tür versehentlich offenlassen, so brennt das Licht nicht stundenlang. Vor allem geht das Licht dann auch aus, wenn aus welchem Grund auch immer die Schließmeldung verloren geht.
:<code>set <Schalter> regSet shOnTime 3600 <Türkontakt> </code>

=== Lampe mit Kippschalter(n) fernschalten - eindeutig oder als Wechselschaltung ===
Oft besteht der Wunsch, eine Lampe mit einem herkömmlichen Schalter (statt eines Tasters) fernzuschalten. So kann man einen herkömmlichen Schalter mit einer Schließerkontaktinterface wie dem [[HM-SCI-3-FM 3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]] ergänzen (oder einem Kanal des [[HM-MOD-EM-8 8-Kanal-Sendemodul|8-Kanal-Sendemoduls]] in der Betriebsart ''sensor'') und wiederum die Verknüpfung mit dem Lampen-Aktor setzen. Ganz ähnlich wie bei der vorgenannten Abstellraum-Aufgabe führt nun aber das Schließen des Schalters nicht zu einem Einschalten. Daher ist nun
:<code>set <Lampenaktor> regSet shCtOff ltLo <Sensorkontakt> </code>
das Mittel der Wahl, ''shCtOn'' muss dieses Mal auf "geLo" bleiben. Jetzt folgt der Aktor dem (sichtbaren) Schaltzustand des Schaltes - zumindest solange er nicht anderweitig ein- oder ausgeschaltet wird.

Nun kann man auch mehrere Schalter so mit der Lampe koppeln. Das ergibt aber keine Wechselschaltung im herkömmlichen Sinn - um eine Lampe ein- oder auszuschalten, muss man den Schalter möglicherweise einmal zusätzlich auf die aktuelle Schaltposition kippen, ehe die nächste Betätigung den gewünschten Effekt bringt. Für Wechselschaltungen bietet sich daher das Kontaktinterface [[HM-SwI-3-FM]] (oder das erwähnte 8-Kanal-Sendemodul in der Betriebsart ''switch'') an. Hier führt jede Zustands''änderung'' zu einem Schaltvorgang.

Hat man hingegen nur ein HM-SCI-3-FM zur Hand, lässt sich dieses Verhalten auch erreichen.
:<code>set <Lampenaktor> regSet shCtOn outside <Sensorkontakt> </code>
:<code>set <Lampenaktor> regSet shCtOff outside <Sensorkontakt> </code>
Wie oben erwähnt, liegen die Trigger mit den Werten 0 und 200 ja außerhalb des Bereichs zwischen Lo und Hi (50-100) und führen daher immer zu einer Aktion. Das Verhalten entspricht somit einem toggle-Befehl.

=== Gezieltes Schalten eines (unsichtbaren) Aktors mit nur einer Taste ===
Für so etwas braucht man gewöhnlich zwei Tasten. Koppelt man einen Schalt-Aktor mit nur einer Taste ("single" beim ''peerChan''-Kommando), so führt sowohl ein kurzer als auch ein langer Tastendruck immer nur zu einem Umschalten des Zustandes. Das ist unschön, wenn man den aktuellen Zustand nicht einsehen kann.

Üblicherweise sind die Schaltabfolgen für eine Eintasten-Verknüpfung sowohl für kurze als auch lange Betätigungen gleich (bei Dimmern wird auf langen Tastendruck hingegen abwechselnd auf- oder abgedimmt).
shSwJtOff = dlyOn # Ist Gerät aus, wird Einschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOff = dlyOn # dito, für lang
shSwJtOn = dlyOff # Ist Gerät an, wird Ausschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOn = dlyOff # dito, für lang
Hier kann man sich zunutze machen, dass man mit einem gezielten "no" oder "dlyOn" bzw. "dlyOff" im richtigen Register die Schaltfolge abbrechen oder umbiegen kann.
Möchte man das Gerät <aktor> mit einem kurzen Tastendruck auf <button> ein- und mit einem langen Tastendruck ausschalten, so ändere man:
:<code>set <aktor> regSet shSwJtOn dlyOn <button> </code>
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>
So laufen die entsprechenden Aktionen quasi ins Leere, wenn der Aktor bereits den gewünschten Zustand hat.

Den umgekehrten Effekt (lang schaltet ein, kurz aus) erreicht man entsprechend mit
:<code>set <aktor> regSet shSwJtOff dlyOff <button> </code>
:<code>set <aktor> regSet lgSwJtOn dlyOn <button> </code>

Welche Bedienhaptik man nun bevorzugt, muss man selbst entscheiden. In der Regel sollte die normale (sichere) Aktion "kurz" und die gefährlichere "lang" sein - eine PC-Stromversorgung mit einem kurzen Tastendruck versehentlich einzuschalten ist bestimmt besser als auszuschalten (das dann eben nur über lang) - für ein potentiell gefährliches Arbeitsgerät wie einen Heizofen wird es sicher andersherum sein.

Sinngemäß verwendet der Autor sozusagen eine Hälfte davon als "Sicherheitsaktion" für einen [[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach]] - der gewöhnliche Tastendruck auf die zugehörige Wippenseite schaltet den Aktor abwechselnd ein und aus, ein langer Tastendruck immer aus, dafür reicht:
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>

Übrigens: Nichts anderes wird normalerweise auch automatisch beim Verknüpfen eines Aktors mit einem Tastenpaar an der entsprechenden Stelle gemacht - ist eine Taste nur zum Ausschalten gedacht, so wird in beiden Schaltzuständen entsprechend "dlyOff" eingetragen. Als "Sprungziel" müsste aber genauso gut auch "no" funkionieren.

=== WARNUNG! - Selbsttätiges Blinken eines HM-Aktors ===
Statt einer separaten Warnleuchte kann es durchaus sinnvoll sein, eine vorhandene Lampe zu Warnzwecken periodisch ein- und auszuschalten. Leider beherrschen die HomeMatic-Aktoren keine direkt aus FHEM erreichbare Blinkfunktion (ähnlich dem on-for-timer für eine Zeitbegrenzung), und das rhythmische Ein- und Ausschalten aus FHEM erzeugt eine recht hohe Funklast.

Wir wissen aber, dass die Aktoren für jeden Peer nicht nur eine Ein-, sondern auch eine Ausschaltzeit speichern. Definiert man nun für einen Peer entsprechend beide Zeiten, so wird der Aktor bei einem Telegramm von diesem Peer sich entsprechend selbsttätig fortlaufend ein- und ausschalten. Jeder andere Schaltbefehl eines anderen Peers oder aus FHEM beendet die Schleife umgehend. So ließe sich das Blinken auch mit einer aktoreigenen Taste stoppen - oder starten, wenn man es entsprechend programmiert. Einen Zwischenstecker-Schalter beispielsweise kann man also (wenn man zuvor seine ''confBtnTime'' entsprechend setzt und so die langen Tastendrücke auswertbar macht) durch das Programmieren von ''lgOnTime'' und ''lgOffTime'' für den Peer "self01" wie gewohnt mit einem kurzen Tastendruck ein- und ausschalten und mit einem langen in den Blinkmodus versetzen.

Einen Haken hat die Sache aber: Der Aktor meldet seinen neuen Schaltzustand nach jeder Änderung mit einer gewissen Verzögerung, die man bei vielen Schaltaktoren (aber leider nicht bei allen wie etwa dem HM-Mod-Re-8) mit dem Register ''statusInfoMinDly'' tunen kann. Ändert der Aktor seinen Schaltzustand in längeren Intervallen, wird es also trotzdem wieder ein Funkfeuer geben. Ist das Delay noch nicht erreicht, erfolgt keine Zustandsübermittlung. Beim HM-Mod-Re-8 muss man also etwa unter 1 Sekunde pro Änderung bleiben.

Zum Steuern aus FHEM emfiehlt es sich, virtuelle Buttons (etwa einer VCCU oder eines virtuellen HM-Dummys) zum Ein- und Ausschalten der Blinkfunktion zu verwenden. "Opfert" man dafür zwei aufeinanderfolgende Kanäle, kann man die Aktoren mit "dual set" peeren und bekommt so einen Blink- und einen Deaktivierungsbutton ohne weitere Kopfstände. Anschließend passt man die short-Laufzeiten für den Einschaltkanal an.

Ein Beispiel für einen Dimmer (als virtuelle Buttons dienen vccu_Btn8 und vccuBtn9):

:<code>set <vccu_Btn8 peerChan 0 <dimmerkanal> dual set</code>

Nun kann man mit "set vccu_Btn9 press short" den Dimmer ein- und mit "set vccu_Btn8 press short" ausschalten. Das Blinken im Dimmer wird eingestellt mit

:<code>set dimmer regSet shOnTime 1 vccu_Btn9</code>
:<code>set dimmer regSet shOffTime 1 vccu_Btn9</code>
jeweils für die gewünschte Ein- und Ausschaltzeit.

Wird der Dimmer nun mit "set vccu_Btn9 press short" eingeschaltet, so blinkt er im 3-Sekunden-Takt: zu den jeweils 1 Sekunde Ein- und Auszeit gesellen sich noch 2x 0,5s Rampenzeit, sofern nichts anderes programmiert wurde.

Das funktioniert auch mit Schaltern: So würde 0.1 und 0.9 (Sekunden) ein kurzes Blitzen im Sekundentakt einstellen.

Natürlich kann man nun eine größere Anzahl von Aktoren mit den virtuellen Buttons peeren und so ein ganzes Feuerwerk zünden ... Eine zusätzlich zu Alarmsirenen wild blinkende Innenbeleuchtung in allen Räumen sorgt sicher für zusätzliche Aufmerksamkeit.

=== Einer nach dem Anderen! - Sequentielles Schalten mehrerer Aktoren ===
Eine großflächige Beleuchtung mit viel Leistung sollte man aus Lastgründen niemals zugleich einschalten. Auch LED-Lampen ziehen im Einschaltmoment, wennauch extrem kurz, beträchtliche Ströme, die die von gewöhnlichen Glühlampen deutlich übersteigen können. Schaltet man mehrere Aktoren gleichzeitig mit einer Taste, so hilft eine individuelle Verzögerung des Einschaltvorgangs in jedem Aktor, die Sicherung vor dem Herausfliegen zu bewahren. Oder man macht gezielt einen Effekt daraus. Der Phantasie sind wenig Grenzen gesetzt...

Hat man drei Aktoren "Aussenlicht1...3" mit dem Taster "Aussenlicht_Ein" gepeert, so erreicht man auf folgende Weise, dass sie beim Einschalten mit einer Verzögerung von jeweils einer Sekunde nacheinander einschalten.

:<code>set Aussenlicht2 regSet shOnDly 1 Aussenlicht_Ein</code>
:<code>set Aussenlicht3 regSet shOnDly 2 Aussenlicht_Ein</code> [[Kategorie:HomeMatic Components|1toolsAndWork]]

HomeMatic Register programmieren

2020-07-13T10:08:31Z

Pfriemler: Ergänzungen für "outside" und Registernamen für Schwellenwerte

{{Baustelle}}
Ein HomeMatic-Gerät besitzt mehr oder weniger umfangreiche Registersätze, mit denen das Verhalten des Gerätes vielfältig feinkonfiguriert werden kann. Die damit erreichbare Funktionsvielfalt geht weit über die standardisierten Vorgaben einer einfachen Direktverknüpfung ([[Peering_(HomeMatic)|Peering]]) hinaus.

== Grundlagen (in Auszügen) ==

Im folgenden werden nur exemplarisch einige Grundlagen und einfache Beispiele benannt, ohne jeden Anspruch auf Vollständigkeit.

FHEM unterstützt die Programmierung der Register mit dem Befehl ''regSet''. <peer> entfällt bei rein gerätebezogenen Programmierungen.
:<code>set <name> regSet <register> <value> [<peer>] </code>
Darüberhinaus gibt es vor- oder selbstdefinierte [[HomeMatic_HmInfo_Templates_erstellen|Templates]] (Vorlagen), die alle erforderlichen Änderungen für standardisierte Anwendungen wie Treppenhauslichtschalter beinhalten. Die Anwendung von Templates auf Geräte wird protokolliert und der Registerzustand kann überprüft werden. Für viele Anwendungen genügt jedoch auch die einmalige Anwendung einer direkten Programmierung. Das genaue Verständnis der Vorgänge und Zusammenhänge ist nicht trivial, das Erlernen wird aber mit einer enormen erreichbaren Funktionsvielfalt belohnt. Viele wissenswerte Zusammenhänge sind im Homematic-Anhang der bekannten Einsteiger-Dokumentation erläutert, deren Lektüre zu Recht immer wieder empfohlen wird. Dieser Beitrag ist auch nur als Ergänzung zu verstehen!

Die HomeMatic Aktoren (Schalter, Dimmer, ...) arbeiten so, wie es für verknüpften ([[Peering (HomeMatic)|peering]]) Sender vorgegeben ist. Sie nutzen Registersätze, die für jede Verknüpfung (peer) neu angelegt und gespeichert werden. Man kann also mit einem Taster ein- und ausschalten (toggeln), mit einem Tastenpaar gezielt ein- und ausschalten und mit einem weiteren Taster eine Zeitschaltung für 10 Sekunden starten. Dabei wird niemals der Taster oder der Schalter auf eine globale Aktion programmiert, sondern im Schalter (Aktor) die gewünschte Aktion für jeden verknüpften Taster separat gespeichert. Die auszulösende Aktion ist zudem abhängig vom aktuellen Zustand des Aktors und von der Länge des Tastendruckes (kurz oder länger - short or long).

Kleines Beispiel:
T1 schaltet S1 für 10 sec an
T2 schaltet S1 an oder aus
T3 schaltet S1 an
T4 schaltet S1 aus.

Diese Tabelle ist im Schalter S1 gespeichert.

Schaltet man mit T3 den S1 an und drückt dann nach beliebiger Zeit kurz T1 geht S1 nach weiteren 10 sec aus. Schaltet man mit T1 kurz den S1 für 10 sec an, aber innerhalb dieser Zeit mit T3 nochmal an, dann bleibt S1 nach Ablauf der 10 sec an.

Die verfügbaren Register unterscheiden sich im Gerät und in den jeweiligen Kanälen.
Eine kurze Beschreibung der Register inklusive der erlaubten Werte erhält man durch:
:<code>get <name> regList </code>
Dabei kann <name> ein Gerät oder ein separater Gerätekanal sein.

== Spezielle Register (Auswahl) ==
Im folgenden sollen einige Register vorgestellt werden, die in vielen Geräten vorhanden sind. ''Ergänzungen sind ausdrücklich erwünscht!''

=== Gerätebezogene Register ===
Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten '''List0''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_00.'' zu finden).

==== ''confBtnTime'' - Kurz oder lang und der Konfigurationsmodus ====
Nicht immer sind die internen Tasten eines Gerätes ohne weiteres mit Aktionen für kurzen und langen Tastendruck programmierbar. Bei allen Hutschienen-Aktoren sowie den Zwischensteckern (mit nur einem Bedienknopf) versetzt ein langer Tastendruck (4 Sekunden) den Schalter normalerweise in den Konfigurations- bzw. Anlern-Modus, bei den in Unterputzdosen versenkbaren Schalt- und Dimmaktoren (-FM ohne PBU in der Bezeichnung) ohne eigenen Konfigurations-Button gilt dies sogar für die zur normalen Funktion extern angeschlossenen Taster. Dieses Verhalten kann man mit dem Register ''confBtnTime'' beeinflussen. Bis zum Ablauf der dort einstellbaren Zeit (Achtung: unüblich hier '''in Minuten'''!) nach dem Versorgen mit Strom (powerUp) erreicht man den Konfigurationsmodus wie bisher, danach interpretiert der Aktor die Tastendrücke stets als kurz (short) oder lang (long). Beispiel:
:<code>set <name> regSet confBtnTime 2</code>
Möchte man den Aktor später zurücksetzen oder lokal konfigurieren, so erreicht man das ursprüngliche Verhalten in diesem Beispiel für die ersten zwei Minuten, nachdem man den Aktor (ausreichend lange) stromlos gemacht hat.

==== ''intKeyVisib'' - Interne Tasten sichtbar machen ====
Die internen "Tasten" eines Aktors (z.B. die Schaltwippe bei Wandschaltern/-tastern, der Bedienknopf bei Zwischensteckern, aber auch die angeschlossenen externen Taster bei Aktoren für Unterputzdosen oder die von außen zugängliche "Notbedientaste" etwa bei Zwischendecken-Dimmern) sind logisch ebenso mit dem Aktor verknüpft wie externe Bedienelemente wie Funkfernbedienungen oder per Funk verknüpfte Wandtaster. Ihre Betätigung wird (außer mit präparierter Firmware) zwar nicht gesendet (und kann daher von FHEM nicht "gelesen" werden), die vom Hersteller vorgesehenen Funktionen lassen sich aber genauso frei programmieren. Allerdings sind diese internen Verknüpfungen zur Vermeidung versehentlicher Programmierungen zunächst verborgen und müssen daher explizit sichtbar gemacht werden.

Dies geschieht mit
set <name> regSet intKeyVisib visib
attr <name> expert 1
Anschließend sind der oder die internen Taste(n) mit der Bezeichnung self01 (self02, ...) sichtbar und ihre Aktionen können gezielt wie bei einem externen Peer umprogrammiert werden.

Wer nun auf die Idee kommt, man könne durch entsprechendes zusätzliches peering bei mehrkanaligen Geräten die (mehreren) internen Tasten beliebig zuweisen und so raffinierte Zusatzschaltungen auslösen, muss hier enttäuscht werden: Zwar kann man tatsächlich mit peerBulk bei den Aktorkanälen zusätzliche interne Peers eintragen und programmieren und mit einer Fernauslösung aus FHEM die neuen Verknüpfungen erfolgreich nutzen - das Gerät selbst reicht die Tastenbetätigungen aber immer nur an den ursprünglich dafür vorgesehenen Kanal weiter.

==== ''ledMode'' - Funktion der Onboard-LED bei Bausätzen ====
Die (batteriebetriebenen) -PCB-Aktoren und die 8-Kanal-Module haben kleine LED an Bord, die für Diagnosezwecke hilfreich sind, einem sparsamen Betrieb aber in der Regel entgegenstehen. Sie werden daher nur bei außergewöhnlichen Zuständen wie dem Anlernmodus, einem Reset, oder auch bei niedriger Batteriespannung als Hinweis an den Anwender benutzt und sind ansonsten ab Werk deaktiviert. Bei einer Dauerstromversorgung kann aber eine Schaltzustandsanzeige oder eine Quittung über eine Befehlsaussendung nicht nur zur Diagnose hilfreich sein.

Besitzt das Gerät das Register ''ledMode'', so kann man mit
:<code>set <device> regSet ledMode on</code>
die LED auch für die "normalen" Betriebszustände aktivieren. Sie zeigen dann bei Aktoren, ob der Aktor eingeschaltet ist (blinkend, wenn eine Einschaltzeitbegrenzung aktiv ist), und bei den Sensormodulen HM-Mod-EM8(bit) zeigt die zweifarbige LED den von Fernbedienungen bekannten Sendezustand mit gelb, dem dann ein grün oder rot folgt - je nachdem ob eine Quittung angefordert ist und ob sie erfolgreich empfangen wurde.

Leider lässt sich umgekehrt die bei Wandtastern oder Fensterkontakten mitunter gewünschte Deaktivierung der LED nicht so bewerkstelligen - diese Geräte haben das entsprechende Register nicht. Da hilft nur ein Eingriff ins Gerät mit Gaffa oder schwarzem Edding...

=== Kanalbezogene Register ===
Kanalbezogene Register existieren für jeden Kanal eines Gerätes einmal und werden in der sogenannten '''List1''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_01.'' zu finden).

==== ''powerUpAction'' - Automatischer Knopfdruck bei (wiederkehrender) Stromversorgung ====
Mit diesem Register (default ''off'') kann erreicht werden, dass ein Schaltaktor nach einem Stromausfall sich bei Wiederkehr der Versorgungsspannung automatisch einschaltet. Dies ist z.B. sinnvoll für Zwischenstecker mit Messfunktion ([[HM-ES-PMSw1-Pl Funk-Schaltaktor 1-fach mit Leistungsmessung|HM-ES-PMSw1-Pl]]), wenn dieser als Langzeitmonitor etwa für Kühlgeräte verwendet wird - nach einem Stromausfall bliebe der Kühlschrank sonst aus und der Inhalt würde verderben.
:<code>set <name> regSet powerUpAction on</code>
Achtung: Das Setzen dieses Registers auf ''on'' bedeutet nicht immer einen eingeschalteten Aktor nach der Wiederkehr der Stromversorgung. Vielmehr wird nur ein ''short''-Ereignis auf den zugehörigen internen Taster ausgelöst, was nur im Normalfall zum Einschalten des Aktors führt - nicht aber wenn die Funktion dieses kurzen Tastendruckes gezielt verändert wurde, denn dann wird eben diese Aktion ausgeführt! Das gilt zum Beispiel auch für zeitlich begrenztes Einschalten. Als Alternative für eine lokale Schaltmöglichkeit bietet sich in solchen Fällen der lange Tastendruck an, sofern er vom Aktor unterstützt wird (so lässt sich die Einschaltzeit bei langem Tastendruck mit ''lgOnTime'' begrenzen). Dessen Aktion wird bei powerUp nicht ausgeführt.

=== Verknüpfungsbezogene Register ===
Diese Register sind am umfangreichsten und werden für jeden Verknüpfungspartner einzeln separat angelegt in der '''List3''' (''RegL_03.<peer>''). Die grundsätzlichen Funktionen und ihre Zusammenhänge sind ausführlich in der Einsteigerdokumentation erklärt, inklusive Skizzen für die sogenannte ''state machine''. Hier sollen daher nur die in den folgenden Beispielen verwendeten Register erklärt werden.

==== ''shOnTime'' und ''lgOnTime'' - das interne ''on-for-timer'' von Schaltern oder Dimmern ====
Die wohl populärsten Register begrenzen die Einschaltzeit eines Aktors. Um z.B. eine Steckdose für 10 sec bei Knopfdruck lokal einzuschalten kann man folgendes programmieren:
:<code>set <name> regSet shOnTime 10 self01 </code>

''shOnTime'' ist dabei das zuständige Register für die Einschaltzeit bei kurzem (sh=short) Tastendruck, entsprechend gilt ''lgOnTime'' für einen langen Tastendruck.

In den Readings werden die Register mit dem jeweiligen verknüpften Taster angezeigt, in unserem Fall also:
:<code>R-self01-shOnTime </code>

Der Defaultwert für shOnTime ist 111600 und bedeutet unendlich (von FHEM mit "unused" dargestellt), d.h. die maximale einstellbare Zeit ist 111599 sec (knapp 31 Stunden). So kann man die Zeit löschen:
:<code>set <device> regSet shOnTime 111600 self01 </code>
oder
:<code>set <device> regSet shOnTime unused self01 </code>

Übrigens gibt es diese Register auch für die Ausschaltzeit.

==== ''shCtOn'' und ''shCtOff'' - Bedingtes Schalten mit Schwellwerten ====
Fernbedienungen (im weitesten Sinne, ''remote'') von HomeMatic übermitteln je nach Betätigungsdauer ''short''- oder ''long''-Trigger. Zustandsübermittelnde Sensoren (etwa ein Fensterkontakt oder Neigungssensor sowie Bewegungsmelder) senden ausschließlich ''short'', gekoppelt mit einem Wert zwischen 0 und 200, entsprechend 0-100% in 0,5-%-Schritten. Ob ein solcher Trigger vom Aktor verarbeitet wird, kann vom gesendeten Wert abhängen.

HomeMatic kennt dazu (für jeden Peer und Triggertyp (short/long) separat, festgelegt in den Registern shCtValLo, shCtValHi, lgCtValLo und lgCtValHi) zwei Schaltschwellen "Lo" und "Hi", die default bei 50 und 100 liegen. Ob ein Trigger in Relation zu diesen Schwellen verarbeitet wird, regeln u.a. die shCtxxx-Register. Wie auch bei den allgemeinen Schaltbedingungen stehen ''On'' und ''Off'' jeweils für den aktuellen Schaltzustand (Achtung: nicht den, der erreicht werden soll). Ihr Wert beträgt default "geLo" (greater or equal Lo), hier 50 und höher. Trigger für Werte darunter werden bei der Einstellung "ltLo" (less than Lo) verarbeitet. Diese Schwellen gibt es entsprechend auch für den Hi-Wert, also "geHi" oder "ltHi". Besonders interessant sind aber auch die Werte "outside" und "between", bezogen auf die beiden Schwellen Lo und Hi. In letzterem Fall wird der Trigger verarbeitet, wenn der Wert zwischen 50 und 100 liegt, bei "outside" entsprechend bei 0-49 oder 101-200.

Sogenannte Three-State-Sensoren wie Fensterkontakt- oder -griffsensoren senden 0 für "closed" (geschlossen), 100 für "tilted" (gekippt) und 200 für "open" (offen). Gleiches gilt für Schalterkontaktinterfaces, die den Zustand eines angeschlossenen Schaltkontaktes übermitteln. Im Grundzustand (Vergleichsbefehl auf "geLo") führt daher nur der Trigger "offen" (200) zu einer Aktion. Ändert man den Vergleichsbefehl auf "ltLo", so wird lediglich "closed" ausgewertet, bei "between" ist es "tilted". Mit "outside" führt sowohl "closed" als auch "open" zu einer Aktion.

Bei Bewegungsmeldern wird der mit übermittelte Helligkeitswert im Zusammenhang mit den (dann variabel einzustellenden) Schwellen als Kriterium für das Einschalten des Aktors mit herangezogen.

==== ''shSwJtOn'' & Co. - Was soll passieren? ====
Nachdem wir nun kennengelernt haben, wie man auswählt, '''welcher''' Anstoss von außen zu einer Aktion führt, hier ein kleiner Exkurs in die Beeinflussung, '''was''' daraufhin passieren soll. Diese Frage regelt die ''jump table'' und liefert damit das Regelwerk für die Abfolge der Aktionen, die ''state machine''. Ein HomeMatic-Aktor geht nämlich keineswegs einfach nur an oder aus. Vielmehr hangelt er sich nacheinander an einer Reihe von Zuständen entlang - auch das ist in der Einsteigerdokumentation erschöpfend beschrieben und soll hier nicht wiederholt werden. Ein Schalter durchläuft aber mindestens die Zustände
Aus > Einschaltverzögerung > Ein > Ausschaltverzögerung > Aus > (usw)
Hier soll reichen, dass am Ende jeder (Teil-)Kette in der Regel ein dauerstabiler Zustand bleibt, in der Regel ist das der Aus-Zustand und auch der Ein-Zustand, wenn dessen Laufzeit nicht durch ''shOnTime'' & Co. begrenzt ist. Ein- und Ausschaltverzögerung sind aber in der Regel 0 (Sekunden), so dass effektiv nur "Ein" und "Aus" übrig bleiben.

Das Register ''shSwJtOn'' regelt, wohin die Reise geht, wenn ein gültiger ''short''-Trigger im eingeschalteten Zustand eintrifft, sinngemäß ''...Off'' im Auszustand und ''lg...'' für die ''long''-Trigger. Für ''shSwJtOn'' ist normalerweise als nächstes die Ausschaltverzögerung "dlyOff" vorgesehen. Da die Ausschaltverzögerung in der Regel 0 ist, folgt darauf, in ''shSwJtDly'' festgelegt, "off" usw. Die Zustände bilden so quasi einen Kreis, dessen Durchlauf von außen gelegentlich "angeschubst" wird. Mit diesen Registern kann man den Kreislauf aber auch umbiegen oder sogar unterbrechen, so dass ein eintreffender Trigger eben nicht zu einer Aktion führt. Als Ziele bieten sich, quasi selbstsprechend, "on", "dlyOff", "off" und "dlyOn" an - oder eben "no", was nichts anderes bedeutet, als dass der betreffende Trigger an dieser Stelle zu keiner Aktion führt.

Bei einem Dimmer heißen die Register statt ''..Sw....'' nur ''..Dim....'' und es gibt ein paar mehr Bedingungen - die Funktion ist aber entsprechend gleich.

==== ''shOnDly'' und ''shOffDly'' - es muss nicht immer sofort sein! ====
Nicht nur welcher Anstoße welche Aktion auslöst, sondern auch wann oder wie schnell die Aktion ausgeführt wird, lässt sich in gewissen Grenzen einstellen. Die beiden genannten Register etwa regeln die Ein- oder Ausschaltverzögerung nach einem gültigen Trigger. So kann man nach einem Ausschaltbefehl einen Raum noch im Hellen verlassen, wenn das Licht noch ein paar Sekunden länger leuchtet.

Bei Dimmern gibt es zusätzlich auch bei Ein- und Ausschaltvorgängen durch eine neu eingerichtete Verknüpfung eine sogenannte Rampenzeit von 0,5 Sekunden, in der das Licht hoch- oder heruntergedimmt wird. Durch Programmierung von ''shRampOnTime'' und ''shRampOffTime'' kann man ein sehr augenschonendes langsames Ein- oder Ausschalten des Lichts wie im Kino erreichen. Zwar gibt es die Zeiten auch für long-Trigger, aber da machen sie im Normalfall wenig Sinn - der lange Tastendruck löst immer einen manuellen Dimmvorgang aus.

''(wird ergänzt)''

== Praktische Beispiele ==
Die folgenden Beispiele beschreiben nur in Kurzform die erforderlichen Aktionen. Weiterführende Informationen sind der Einsteigerdokumentation oder den o.g. Registerbeschreibungen zu entnehmen.
Übrigens: ein einmal konfigurierter Vorgang für eine Verknüpfung kann aus FHEM auch bequem fernausgelöst (bzw. simuliert) werden. Der Aktor führt dabei genau die Aktion aus, die für die benannte Verknüpfung vorgesehen ist. Der kurze Knopfdruck auf den internen Knopf eines Aktors wird beispielsweise so simuliert:
:<code>set <device> press short self01 </code>

=== Lokal bedienbarer Zeitschalter mit HomeMatic Aktoren: Pool für eine Stunde schalten ===
Ich habe einen HM-LC-SW4-DR und der channel_01 schaltet die Poolzirkulationspumpe. Dies passiert zeitgesteuert zweimal am Tag. Manchmal möchte ich im Keller diese Pumpe einfach für eine Stunde aktivieren, der Aktor ist bequem erreichbar an der Wand.
Die internen Tasten vom Hauptdevice (der Aktor hat vier Kanäle (channel), die in FHEM einzeln dargestellt werden) sichtbar machen:
set LichtKeSW1 regSet intKeyVisib visib
attr LichtKeSW1 expert 1

Jetzt sieht man im Channel 01 - LichtKeSW1_Sw01 den internen peer self01. (Channel 02 ist self02 usw.)
Also jetzt einfach die Zeit eintragen:
set LichtKeSW1 regSet shOnTime 3600 self01

Die Toggle Funktion der Taste bleibt erhalten. Ein zweiter Tastendruck schaltet die Pumpe auch sofort wieder aus. Während die Zeit läuft, blinkt die Status LED des Kanals.
Die Zeitbegrenzung funktioniert in diesem Beispiel ohne jedes Zutun von FHEM und damit auch bei einem Ausfall des Servers.

=== Es werde Licht! Automatisches Licht mit Tor oder Tür ===
Im Kühlschrank geht das Licht ja schon praktischerweise automatisch an und aus, aber es gibt auch andere Situationen, in denen ein automatisches Licht sehr nützlich sein kann - in dunklen Abstellräumen oder Garagen. Vor allem weil man nicht vergessen kann es auszuschalten, weil es auch von allein ausgeht. Eine solche Funktion, so könnte man meinen, wird ganz einfach erreicht, indem man das Licht mit einem Aktor schalten lässt und diesen mit einem Tür- oder Fensterkontakt verknüpft. Hat man die beiden dann mit ''peerChan'' verknüpft, so wird man feststellen, dass das Licht mitnichten das Gewünschte tut: es schaltet sich beim Öffnen der Tür abwechselnd ein und aus und ignoriert das Schließen der Tür komplett.

Verantwortlich für dieses "Fehlverhalten" sind die Register ''shCtOn'' und ''shCtOff''. Beide stehen nach der Verknüpfung auf "geLo". Wie bei den Registern oben erläutert, führt in diesem Fall nur die "offen"-Meldung des Türkontaktes zu einer Aktion. Das Öffnen der Tür soll den Aktor einschalten, das klappt. Das Schließen der Tür soll den eingeschalteten Aktor aber ausschalten. Also muss die Schaltbedingung im On-Zustand geändert werden (die Bezeichnungen natürlich durch die realen Namen des Schaltaktorkanals und des Türkontaktes ersetzen):
:<code>set <Schalter> regSet shCtOn ltLo <Türkontakt> </code>
Nun führt auch das Schließen der Tür wunschgemäß stets zu einem Abschalten des Lichts. ''shCtOff'' muss auf "geLo" bleiben!

Kombinieren ließe sich das noch mit einer Laufzeitbegrenzung etwa für eine Stunde - sollte man die Tür versehentlich offenlassen, so brennt das Licht nicht stundenlang. Vor allem geht das Licht dann auch aus, wenn aus welchem Grund auch immer die Schließmeldung verloren geht.
:<code>set <Schalter> regSet shOnTime 3600 <Türkontakt> </code>

=== Lampe mit Kippschalter(n) fernschalten - eindeutig oder als Wechselschaltung ===
Oft besteht der Wunsch, eine Lampe mit einem herkömmlichen Schalter (statt eines Tasters) fernzuschalten. So kann man einen herkömmlichen Schalter mit einer Schließerkontaktinterface wie dem [[HM-SCI-3-FM 3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]] ergänzen (oder einem Kanal des [[HM-MOD-EM-8 8-Kanal-Sendemodul|8-Kanal-Sendemoduls]] in der Betriebsart ''sensor'') und wiederum die Verknüpfung mit dem Lampen-Aktor setzen. Ganz ähnlich wie bei der vorgenannten Abstellraum-Aufgabe führt nun aber das Schließen des Schalters nicht zu einem Einschalten. Daher ist nun
:<code>set <Lampenaktor> regSet shCtOff ltLo <Sensorkontakt> </code>
das Mittel der Wahl, ''shCtOn'' muss dieses Mal auf "geLo" bleiben. Jetzt folgt der Aktor dem (sichtbaren) Schaltzustand des Schaltes - zumindest solange er nicht anderweitig ein- oder ausgeschaltet wird.

Nun kann man auch mehrere Schalter so mit der Lampe koppeln. Das ergibt aber keine Wechselschaltung im herkömmlichen Sinn - um eine Lampe ein- oder auszuschalten, muss man den Schalter möglicherweise einmal zusätzlich auf die aktuelle Schaltposition kippen, ehe die nächste Betätigung den gewünschten Effekt bringt. Für Wechselschaltungen bietet sich daher das Kontaktinterface [[HM-SwI-3-FM]] (oder das erwähnte 8-Kanal-Sendemodul in der Betriebsart ''switch'') an. Hier führt jede Zustands''änderung'' zu einem Schaltvorgang.

Hat man hingegen nur ein HM-SCI-3-FM zur Hand, lässt sich dieses Verhalten auch erreichen.
:<code>set <Lampenaktor> regSet shCtOn outside <Sensorkontakt> </code>
:<code>set <Lampenaktor> regSet shCtOff outside <Sensorkontakt> </code>
Wie oben erwähnt, liegen die Trigger mit den Werten 0 und 200 ja außerhalb des Bereichs zwischen Lo und Hi (50-100) und führen daher immer zu einer Aktion. Das Verhalten entspricht somit einem toggle-Befehl.

=== Gezieltes Schalten eines (unsichtbaren) Aktors mit nur einer Taste ===
Für so etwas braucht man gewöhnlich zwei Tasten. Koppelt man einen Schalt-Aktor mit nur einer Taste ("single" beim ''peerChan''-Kommando), so führt sowohl ein kurzer als auch ein langer Tastendruck immer nur zu einem Umschalten des Zustandes. Das ist unschön, wenn man den aktuellen Zustand nicht einsehen kann.

Üblicherweise sind die Schaltabfolgen für eine Eintasten-Verknüpfung sowohl für kurze als auch lange Betätigungen gleich (bei Dimmern wird auf langen Tastendruck hingegen abwechselnd auf- oder abgedimmt).
shSwJtOff = dlyOn # Ist Gerät aus, wird Einschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOff = dlyOn # dito, für lang
shSwJtOn = dlyOff # Ist Gerät an, wird Ausschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOn = dlyOff # dito, für lang
Hier kann man sich zunutze machen, dass man mit einem gezielten "no" oder "dlyOn" bzw. "dlyOff" im richtigen Register die Schaltfolge abbrechen oder umbiegen kann.
Möchte man das Gerät <aktor> mit einem kurzen Tastendruck auf <button> ein- und mit einem langen Tastendruck ausschalten, so ändere man:
:<code>set <aktor> regSet shSwJtOn dlyOn <button> </code>
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>
So laufen die entsprechenden Aktionen quasi ins Leere, wenn der Aktor bereits den gewünschten Zustand hat.

Den umgekehrten Effekt (lang schaltet ein, kurz aus) erreicht man entsprechend mit
:<code>set <aktor> regSet shSwJtOff dlyOff <button> </code>
:<code>set <aktor> regSet lgSwJtOn dlyOn <button> </code>

Welche Bedienhaptik man nun bevorzugt, muss man selbst entscheiden. In der Regel sollte die normale (sichere) Aktion "kurz" und die gefährlichere "lang" sein - eine PC-Stromversorgung mit einem kurzen Tastendruck versehentlich einzuschalten ist bestimmt besser als auszuschalten (das dann eben nur über lang) - für ein potentiell gefährliches Arbeitsgerät wie einen Heizofen wird es sicher andersherum sein.

Sinngemäß verwendet der Autor sozusagen eine Hälfte davon als "Sicherheitsaktion" für einen [[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach]] - der gewöhnliche Tastendruck auf die zugehörige Wippenseite schaltet den Aktor abwechselnd ein und aus, ein langer Tastendruck immer aus, dafür reicht:
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>

Übrigens: Nichts anderes wird normalerweise auch automatisch beim Verknüpfen eines Aktors mit einem Tastenpaar an der entsprechenden Stelle gemacht - ist eine Taste nur zum Ausschalten gedacht, so wird in beiden Schaltzuständen entsprechend "dlyOff" eingetragen. Als "Sprungziel" müsste aber genauso gut auch "no" funkionieren.

=== WARNUNG! - Selbsttätiges Blinken eines HM-Aktors ===
Statt einer separaten Warnleuchte kann es durchaus sinnvoll sein, eine vorhandene Lampe zu Warnzwecken periodisch ein- und auszuschalten. Leider beherrschen die HomeMatic-Aktoren keine direkt aus FHEM erreichbare Blinkfunktion (ähnlich dem on-for-timer für eine Zeitbegrenzung), und das rhythmische Ein- und Ausschalten aus FHEM erzeugt eine recht hohe Funklast.

Wir wissen aber, dass die Aktoren für jeden Peer nicht nur eine Ein-, sondern auch eine Ausschaltzeit speichern. Definiert man nun für einen Peer entsprechend beide Zeiten, so wird der Aktor bei einem Telegramm von diesem Peer sich entsprechend selbsttätig fortlaufend ein- und ausschalten. Jeder andere Schaltbefehl eines anderen Peers oder aus FHEM beendet die Schleife umgehend. So ließe sich das Blinken auch mit einer aktoreigenen Taste stoppen - oder starten, wenn man es entsprechend programmiert. Einen Zwischenstecker-Schalter beispielsweise kann man also (wenn man zuvor seine ''confBtnTime'' entsprechend setzt und so die langen Tastendrücke auswertbar macht) durch das Programmieren von ''lgOnTime'' und ''lgOffTime'' für den Peer "self01" wie gewohnt mit einem kurzen Tastendruck ein- und ausschalten und mit einem langen in den Blinkmodus versetzen.

Einen Haken hat die Sache aber: Der Aktor meldet seinen neuen Schaltzustand nach jeder Änderung mit einer gewissen Verzögerung, die man bei vielen Schaltaktoren (aber leider nicht bei allen wie etwa dem HM-Mod-Re-8) mit dem Register ''statusInfoMinDly'' tunen kann. Ändert der Aktor seinen Schaltzustand in längeren Intervallen, wird es also trotzdem wieder ein Funkfeuer geben. Ist das Delay noch nicht erreicht, erfolgt keine Zustandsübermittlung. Beim HM-Mod-Re-8 muss man also etwa unter 1 Sekunde pro Änderung bleiben.

Zum Steuern aus FHEM emfiehlt es sich, virtuelle Buttons (etwa einer VCCU oder eines virtuellen HM-Dummys) zum Ein- und Ausschalten der Blinkfunktion zu verwenden. "Opfert" man dafür zwei aufeinanderfolgende Kanäle, kann man die Aktoren mit "dual set" peeren und bekommt so einen Blink- und einen Deaktivierungsbutton ohne weitere Kopfstände. Anschließend passt man die short-Laufzeiten für den Einschaltkanal an.

Ein Beispiel für einen Dimmer (als virtuelle Buttons dienen vccu_Btn8 und vccuBtn9):

:<code>set <vccu_Btn8 peerChan 0 <dimmerkanal> dual set</code>

Nun kann man mit "set vccu_Btn9 press short" den Dimmer ein- und mit "set vccu_Btn8 press short" ausschalten. Das Blinken im Dimmer wird eingestellt mit

:<code>set dimmer regSet shOnTime 1 vccu_Btn9</code>
:<code>set dimmer regSet shOffTime 1 vccu_Btn9</code>
jeweils für die gewünschte Ein- und Ausschaltzeit.

Wird der Dimmer nun mit "set vccu_Btn9 press short" eingeschaltet, so blinkt er im 3-Sekunden-Takt: zu den jeweils 1 Sekunde Ein- und Auszeit gesellen sich noch 2x 0,5s Rampenzeit, sofern nichts anderes programmiert wurde.

Das funktioniert auch mit Schaltern: So würde 0.1 und 0.9 (Sekunden) ein kurzes Blitzen im Sekundentakt einstellen.

Natürlich kann man nun eine größere Anzahl von Aktoren mit den virtuellen Buttons peeren und so ein ganzes Feuerwerk zünden ... Eine zusätzlich zu Alarmsirenen wild blinkende Innenbeleuchtung in allen Räumen sorgt sicher für zusätzliche Aufmerksamkeit.

=== Einer nach dem Anderen! - Sequentielles Schalten mehrerer Aktoren ===
Eine großflächige Beleuchtung mit viel Leistung sollte man aus Lastgründen niemals zugleich einschalten. Auch LED-Lampen ziehen im Einschaltmoment, wennauch extrem kurz, beträchtliche Ströme, die die von gewöhnlichen Glühlampen deutlich übersteigen können. Schaltet man mehrere Aktoren gleichzeitig mit einer Taste, so hilft eine individuelle Verzögerung des Einschaltvorgangs in jedem Aktor, die Sicherung vor dem Herausfliegen zu bewahren. Oder man macht gezielt einen Effekt daraus. Der Phantasie sind wenig Grenzen gesetzt...

Hat man drei Aktoren "Aussenlicht1...3" mit dem Taster "Aussenlicht_Ein" gepeert, so erreicht man auf folgende Weise, dass sie beim Einschalten mit einer Verzögerung von jeweils einer Sekunde nacheinander einschalten.

:<code>set Aussenlicht2 regSet shOnDly 1 Aussenlicht_Ein</code>
:<code>set Aussenlicht3 regSet shOnDly 2 Aussenlicht_Ein</code> [[Kategorie:HomeMatic Components|1toolsAndWork]]

HomeMatic Register programmieren

2020-07-13T09:41:46Z

Pfriemler: /* confBtnTime - Kurz oder lang und der Konfigurationsmodus */ Hinweis auf Minuten für korrekte Angabe verdeutlicht

{{Baustelle}}
Ein HomeMatic-Gerät besitzt mehr oder weniger umfangreiche Registersätze, mit denen das Verhalten des Gerätes vielfältig feinkonfiguriert werden kann. Die damit erreichbare Funktionsvielfalt geht weit über die standardisierten Vorgaben einer einfachen Direktverknüpfung ([[Peering_(HomeMatic)|Peering]]) hinaus.

== Grundlagen (in Auszügen) ==

Im folgenden werden nur exemplarisch einige Grundlagen und einfache Beispiele benannt, ohne jeden Anspruch auf Vollständigkeit.

FHEM unterstützt die Programmierung der Register mit dem Befehl ''regSet''. <peer> entfällt bei rein gerätebezogenen Programmierungen.
:<code>set <name> regSet <register> <value> [<peer>] </code>
Darüberhinaus gibt es vor- oder selbstdefinierte [[HomeMatic_HmInfo_Templates_erstellen|Templates]] (Vorlagen), die alle erforderlichen Änderungen für standardisierte Anwendungen wie Treppenhauslichtschalter beinhalten. Die Anwendung von Templates auf Geräte wird protokolliert und der Registerzustand kann überprüft werden. Für viele Anwendungen genügt jedoch auch die einmalige Anwendung einer direkten Programmierung. Das genaue Verständnis der Vorgänge und Zusammenhänge ist nicht trivial, das Erlernen wird aber mit einer enormen erreichbaren Funktionsvielfalt belohnt. Viele wissenswerte Zusammenhänge sind im Homematic-Anhang der bekannten Einsteiger-Dokumentation erläutert, deren Lektüre zu Recht immer wieder empfohlen wird. Dieser Beitrag ist auch nur als Ergänzung zu verstehen!

Die HomeMatic Aktoren (Schalter, Dimmer, ...) arbeiten so, wie es für verknüpften ([[Peering (HomeMatic)|peering]]) Sender vorgegeben ist. Sie nutzen Registersätze, die für jede Verknüpfung (peer) neu angelegt und gespeichert werden. Man kann also mit einem Taster ein- und ausschalten (toggeln), mit einem Tastenpaar gezielt ein- und ausschalten und mit einem weiteren Taster eine Zeitschaltung für 10 Sekunden starten. Dabei wird niemals der Taster oder der Schalter auf eine globale Aktion programmiert, sondern im Schalter (Aktor) die gewünschte Aktion für jeden verknüpften Taster separat gespeichert. Die auszulösende Aktion ist zudem abhängig vom aktuellen Zustand des Aktors und von der Länge des Tastendruckes (kurz oder länger - short or long).

Kleines Beispiel:
T1 schaltet S1 für 10 sec an
T2 schaltet S1 an oder aus
T3 schaltet S1 an
T4 schaltet S1 aus.

Diese Tabelle ist im Schalter S1 gespeichert.

Schaltet man mit T3 den S1 an und drückt dann nach beliebiger Zeit kurz T1 geht S1 nach weiteren 10 sec aus. Schaltet man mit T1 kurz den S1 für 10 sec an, aber innerhalb dieser Zeit mit T3 nochmal an, dann bleibt S1 nach Ablauf der 10 sec an.

Die verfügbaren Register unterscheiden sich im Gerät und in den jeweiligen Kanälen.
Eine kurze Beschreibung der Register inklusive der erlaubten Werte erhält man durch:
:<code>get <name> regList </code>
Dabei kann <name> ein Gerät oder ein separater Gerätekanal sein.

== Spezielle Register (Auswahl) ==
Im folgenden sollen einige Register vorgestellt werden, die in vielen Geräten vorhanden sind. ''Ergänzungen sind ausdrücklich erwünscht!''

=== Gerätebezogene Register ===
Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten '''List0''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_00.'' zu finden).

==== ''confBtnTime'' - Kurz oder lang und der Konfigurationsmodus ====
Nicht immer sind die internen Tasten eines Gerätes ohne weiteres mit Aktionen für kurzen und langen Tastendruck programmierbar. Bei allen Hutschienen-Aktoren sowie den Zwischensteckern (mit nur einem Bedienknopf) versetzt ein langer Tastendruck (4 Sekunden) den Schalter normalerweise in den Konfigurations- bzw. Anlern-Modus, bei den in Unterputzdosen versenkbaren Schalt- und Dimmaktoren (-FM ohne PBU in der Bezeichnung) ohne eigenen Konfigurations-Button gilt dies sogar für die zur normalen Funktion extern angeschlossenen Taster. Dieses Verhalten kann man mit dem Register ''confBtnTime'' beeinflussen. Bis zum Ablauf der dort einstellbaren Zeit (Achtung: unüblich hier '''in Minuten'''!) nach dem Versorgen mit Strom (powerUp) erreicht man den Konfigurationsmodus wie bisher, danach interpretiert der Aktor die Tastendrücke stets als kurz (short) oder lang (long). Beispiel:
:<code>set <name> regSet confBtnTime 2</code>
Möchte man den Aktor später zurücksetzen oder lokal konfigurieren, so erreicht man das ursprüngliche Verhalten in diesem Beispiel für die ersten zwei Minuten, nachdem man den Aktor (ausreichend lange) stromlos gemacht hat.

==== ''intKeyVisib'' - Interne Tasten sichtbar machen ====
Die internen "Tasten" eines Aktors (z.B. die Schaltwippe bei Wandschaltern/-tastern, der Bedienknopf bei Zwischensteckern, aber auch die angeschlossenen externen Taster bei Aktoren für Unterputzdosen oder die von außen zugängliche "Notbedientaste" etwa bei Zwischendecken-Dimmern) sind logisch ebenso mit dem Aktor verknüpft wie externe Bedienelemente wie Funkfernbedienungen oder per Funk verknüpfte Wandtaster. Ihre Betätigung wird (außer mit präparierter Firmware) zwar nicht gesendet (und kann daher von FHEM nicht "gelesen" werden), die vom Hersteller vorgesehenen Funktionen lassen sich aber genauso frei programmieren. Allerdings sind diese internen Verknüpfungen zur Vermeidung versehentlicher Programmierungen zunächst verborgen und müssen daher explizit sichtbar gemacht werden.

Dies geschieht mit
set <name> regSet intKeyVisib visib
attr <name> expert 1
Anschließend sind der oder die internen Taste(n) mit der Bezeichnung self01 (self02, ...) sichtbar und ihre Aktionen können gezielt wie bei einem externen Peer umprogrammiert werden.

Wer nun auf die Idee kommt, man könne durch entsprechendes zusätzliches peering bei mehrkanaligen Geräten die (mehreren) internen Tasten beliebig zuweisen und so raffinierte Zusatzschaltungen auslösen, muss hier enttäuscht werden: Zwar kann man tatsächlich mit peerBulk bei den Aktorkanälen zusätzliche interne Peers eintragen und programmieren und mit einer Fernauslösung aus FHEM die neuen Verknüpfungen erfolgreich nutzen - das Gerät selbst reicht die Tastenbetätigungen aber immer nur an den ursprünglich dafür vorgesehenen Kanal weiter.

==== ''ledMode'' - Funktion der Onboard-LED bei Bausätzen ====
Die (batteriebetriebenen) -PCB-Aktoren und die 8-Kanal-Module haben kleine LED an Bord, die für Diagnosezwecke hilfreich sind, einem sparsamen Betrieb aber in der Regel entgegenstehen. Sie werden daher nur bei außergewöhnlichen Zuständen wie dem Anlernmodus, einem Reset, oder auch bei niedriger Batteriespannung als Hinweis an den Anwender benutzt und sind ansonsten ab Werk deaktiviert. Bei einer Dauerstromversorgung kann aber eine Schaltzustandsanzeige oder eine Quittung über eine Befehlsaussendung nicht nur zur Diagnose hilfreich sein.

Besitzt das Gerät das Register ''ledMode'', so kann man mit
:<code>set <device> regSet ledMode on</code>
die LED auch für die "normalen" Betriebszustände aktivieren. Sie zeigen dann bei Aktoren, ob der Aktor eingeschaltet ist (blinkend, wenn eine Einschaltzeitbegrenzung aktiv ist), und bei den Sensormodulen HM-Mod-EM8(bit) zeigt die zweifarbige LED den von Fernbedienungen bekannten Sendezustand mit gelb, dem dann ein grün oder rot folgt - je nachdem ob eine Quittung angefordert ist und ob sie erfolgreich empfangen wurde.

Leider lässt sich umgekehrt die bei Wandtastern oder Fensterkontakten mitunter gewünschte Deaktivierung der LED nicht so bewerkstelligen - diese Geräte haben das entsprechende Register nicht. Da hilft nur ein Eingriff ins Gerät mit Gaffa oder schwarzem Edding...

=== Kanalbezogene Register ===
Kanalbezogene Register existieren für jeden Kanal eines Gerätes einmal und werden in der sogenannten '''List1''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_01.'' zu finden).

==== ''powerUpAction'' - Automatischer Knopfdruck bei (wiederkehrender) Stromversorgung ====
Mit diesem Register (default ''off'') kann erreicht werden, dass ein Schaltaktor nach einem Stromausfall sich bei Wiederkehr der Versorgungsspannung automatisch einschaltet. Dies ist z.B. sinnvoll für Zwischenstecker mit Messfunktion ([[HM-ES-PMSw1-Pl Funk-Schaltaktor 1-fach mit Leistungsmessung|HM-ES-PMSw1-Pl]]), wenn dieser als Langzeitmonitor etwa für Kühlgeräte verwendet wird - nach einem Stromausfall bliebe der Kühlschrank sonst aus und der Inhalt würde verderben.
:<code>set <name> regSet powerUpAction on</code>
Achtung: Das Setzen dieses Registers auf ''on'' bedeutet nicht immer einen eingeschalteten Aktor nach der Wiederkehr der Stromversorgung. Vielmehr wird nur ein ''short''-Ereignis auf den zugehörigen internen Taster ausgelöst, was nur im Normalfall zum Einschalten des Aktors führt - nicht aber wenn die Funktion dieses kurzen Tastendruckes gezielt verändert wurde, denn dann wird eben diese Aktion ausgeführt! Das gilt zum Beispiel auch für zeitlich begrenztes Einschalten. Als Alternative für eine lokale Schaltmöglichkeit bietet sich in solchen Fällen der lange Tastendruck an, sofern er vom Aktor unterstützt wird (so lässt sich die Einschaltzeit bei langem Tastendruck mit ''lgOnTime'' begrenzen). Dessen Aktion wird bei powerUp nicht ausgeführt.

=== Verknüpfungsbezogene Register ===
Diese Register sind am umfangreichsten und werden für jeden Verknüpfungspartner einzeln separat angelegt in der '''List3''' (''RegL_03.<peer>''). Die grundsätzlichen Funktionen und ihre Zusammenhänge sind ausführlich in der Einsteigerdokumentation erklärt, inklusive Skizzen für die sogenannte ''state machine''. Hier sollen daher nur die in den folgenden Beispielen verwendeten Register erklärt werden.

==== ''shOnTime'' und ''lgOnTime'' - das interne ''on-for-timer'' von Schaltern oder Dimmern ====
Die wohl populärsten Register begrenzen die Einschaltzeit eines Aktors. Um z.B. eine Steckdose für 10 sec bei Knopfdruck lokal einzuschalten kann man folgendes programmieren:
:<code>set <name> regSet shOnTime 10 self01 </code>

''shOnTime'' ist dabei das zuständige Register für die Einschaltzeit bei kurzem (sh=short) Tastendruck, entsprechend gilt ''lgOnTime'' für einen langen Tastendruck.

In den Readings werden die Register mit dem jeweiligen verknüpften Taster angezeigt, in unserem Fall also:
:<code>R-self01-shOnTime </code>

Der Defaultwert für shOnTime ist 111600 und bedeutet unendlich (von FHEM mit "unused" dargestellt), d.h. die maximale einstellbare Zeit ist 111599 sec (knapp 31 Stunden). So kann man die Zeit löschen:
:<code>set <device> regSet shOnTime 111600 self01 </code>
oder
:<code>set <device> regSet shOnTime unused self01 </code>

Übrigens gibt es diese Register auch für die Ausschaltzeit.

==== ''shCtOn'' und ''shCtOff'' - Bedingtes Schalten mit Schwellwerten ====
Fernbedienungen (im weitesten Sinne, ''remote'') von HomeMatic übermitteln je nach Betätigungsdauer ''short''- oder ''long''-Trigger. Zustandsübermittelnde Sensoren (etwa ein Fensterkontakt oder Neigungssensor sowie Bewegungsmelder) senden ausschließlich ''short'', gekoppelt mit einem Wert zwischen 0 und 200, entsprechend 0-100% in 0,5-%-Schritten. Ob ein solcher Trigger vom Aktor verarbeitet wird, kann vom gesendeten Wert abhängen.

HomeMatic kennt dazu (für jeden Peer und Triggertyp (short/long) separat) zwei Schaltschwellen Lo und Hi, die default bei 50 und 100 liegen. Ob ein Trigger in Relation zu diesen Schwellen verarbeitet wird, regeln u.a. die shCtxxx-Register. Wie auch bei den allgemeinen Schaltbedingungen stehen ''On'' und ''Off'' jeweils für den aktuellen Schaltzustand (Achtung: nicht den, der erreicht werden soll). Ihr Wert beträgt default "geLo" (greater or equal Lo), hier 50 und höher. Trigger für Werte darunter werden bei der Einstellung "ltLo" (less than Lo) verarbeitet. Diese Schwellen gibt es entsprechend auch für den Hi-Wert, also "geHi" oder "ltHi". Besonders interessant sind aber auch die Werte "outside" und "between", bezogen auf die beiden Schwellen Lo und Hi. In letzterem Fall wird der Trigger verarbeitet, wenn der Wert zwischen 50 und 100 liegt, bei "outside" entsprechend bei 0-49 oder 101-200.

Sogenannte Three-State-Sensoren wie Fensterkontakt- oder -griffsensoren senden 0 für "closed" (geschlossen), 100 für "tilted" (gekippt) und 200 für "open" (offen). Gleiches gilt für Schalterkontaktinterfaces, die den Zustand eines angeschlossenen Schaltkontaktes übermitteln. Im Grundzustand (Vergleichsbefehl auf "geLo") führt daher nur der Trigger "offen" (200) zu einer Aktion. Ändert man den Vergleichsbefehl auf "ltLo", so wird lediglich "closed" ausgewertet, bei "between" ist es "tilted". Mit "outside" führt sowohl "closed" als auch "open" zu einer Aktion.

Bei Bewegungsmeldern wird der mit übermittelte Helligkeitswert im Zusammenhang mit den (dann variabel einzustellenden) Schwellen als Kriterium für das Einschalten des Aktors mit herangezogen.

==== ''shSwJtOn'' & Co. - Was soll passieren? ====
Nachdem wir nun kennengelernt haben, wie man auswählt, '''welcher''' Anstoss von außen zu einer Aktion führt, hier ein kleiner Exkurs in die Beeinflussung, '''was''' daraufhin passieren soll. Diese Frage regelt die ''jump table'' und liefert damit das Regelwerk für die Abfolge der Aktionen, die ''state machine''. Ein HomeMatic-Aktor geht nämlich keineswegs einfach nur an oder aus. Vielmehr hangelt er sich nacheinander an einer Reihe von Zuständen entlang - auch das ist in der Einsteigerdokumentation erschöpfend beschrieben und soll hier nicht wiederholt werden. Ein Schalter durchläuft aber mindestens die Zustände
Aus > Einschaltverzögerung > Ein > Ausschaltverzögerung > Aus > (usw)
Hier soll reichen, dass am Ende jeder (Teil-)Kette in der Regel ein dauerstabiler Zustand bleibt, in der Regel ist das der Aus-Zustand und auch der Ein-Zustand, wenn dessen Laufzeit nicht durch ''shOnTime'' & Co. begrenzt ist. Ein- und Ausschaltverzögerung sind aber in der Regel 0 (Sekunden), so dass effektiv nur "Ein" und "Aus" übrig bleiben.

Das Register ''shSwJtOn'' regelt, wohin die Reise geht, wenn ein gültiger ''short''-Trigger im eingeschalteten Zustand eintrifft, sinngemäß ''...Off'' im Auszustand und ''lg...'' für die ''long''-Trigger. Für ''shSwJtOn'' ist normalerweise als nächstes die Ausschaltverzögerung "dlyOff" vorgesehen. Da die Ausschaltverzögerung in der Regel 0 ist, folgt darauf, in ''shSwJtDly'' festgelegt, "off" usw. Die Zustände bilden so quasi einen Kreis, dessen Durchlauf von außen gelegentlich "angeschubst" wird. Mit diesen Registern kann man den Kreislauf aber auch umbiegen oder sogar unterbrechen, so dass ein eintreffender Trigger eben nicht zu einer Aktion führt. Als Ziele bieten sich, quasi selbstsprechend, "on", "dlyOff", "off" und "dlyOn" an - oder eben "no", was nichts anderes bedeutet, als dass der betreffende Trigger an dieser Stelle zu keiner Aktion führt.

Bei einem Dimmer heißen die Register statt ''..Sw....'' nur ''..Dim....'' und es gibt ein paar mehr Bedingungen - die Funktion ist aber entsprechend gleich.

==== ''shOnDly'' und ''shOffDly'' - es muss nicht immer sofort sein! ====
Nicht nur welcher Anstoße welche Aktion auslöst, sondern auch wann oder wie schnell die Aktion ausgeführt wird, lässt sich in gewissen Grenzen einstellen. Die beiden genannten Register etwa regeln die Ein- oder Ausschaltverzögerung nach einem gültigen Trigger. So kann man nach einem Ausschaltbefehl einen Raum noch im Hellen verlassen, wenn das Licht noch ein paar Sekunden länger leuchtet.

Bei Dimmern gibt es zusätzlich auch bei Ein- und Ausschaltvorgängen durch eine neu eingerichtete Verknüpfung eine sogenannte Rampenzeit von 0,5 Sekunden, in der das Licht hoch- oder heruntergedimmt wird. Durch Programmierung von ''shRampOnTime'' und ''shRampOffTime'' kann man ein sehr augenschonendes langsames Ein- oder Ausschalten des Lichts wie im Kino erreichen. Zwar gibt es die Zeiten auch für long-Trigger, aber da machen sie im Normalfall wenig Sinn - der lange Tastendruck löst immer einen manuellen Dimmvorgang aus.

''(wird ergänzt)''

== Praktische Beispiele ==
Die folgenden Beispiele beschreiben nur in Kurzform die erforderlichen Aktionen. Weiterführende Informationen sind der Einsteigerdokumentation oder den o.g. Registerbeschreibungen zu entnehmen.
Übrigens: ein einmal konfigurierter Vorgang für eine Verknüpfung kann aus FHEM auch bequem fernausgelöst (bzw. simuliert) werden. Der Aktor führt dabei genau die Aktion aus, die für die benannte Verknüpfung vorgesehen ist. Der kurze Knopfdruck auf den internen Knopf eines Aktors wird beispielsweise so simuliert:
:<code>set <device> press short self01 </code>

=== Lokal bedienbarer Zeitschalter mit HomeMatic Aktoren: Pool für eine Stunde schalten ===
Ich habe einen HM-LC-SW4-DR und der channel_01 schaltet die Poolzirkulationspumpe. Dies passiert zeitgesteuert zweimal am Tag. Manchmal möchte ich im Keller diese Pumpe einfach für eine Stunde aktivieren, der Aktor ist bequem erreichbar an der Wand.
Die internen Tasten vom Hauptdevice (der Aktor hat vier Kanäle (channel), die in FHEM einzeln dargestellt werden) sichtbar machen:
set LichtKeSW1 regSet intKeyVisib visib
attr LichtKeSW1 expert 1

Jetzt sieht man im Channel 01 - LichtKeSW1_Sw01 den internen peer self01. (Channel 02 ist self02 usw.)
Also jetzt einfach die Zeit eintragen:
set LichtKeSW1 regSet shOnTime 3600 self01

Die Toggle Funktion der Taste bleibt erhalten. Ein zweiter Tastendruck schaltet die Pumpe auch sofort wieder aus. Während die Zeit läuft, blinkt die Status LED des Kanals.
Die Zeitbegrenzung funktioniert in diesem Beispiel ohne jedes Zutun von FHEM und damit auch bei einem Ausfall des Servers.

=== Es werde Licht! Automatisches Licht mit Tor oder Tür ===
Im Kühlschrank geht das Licht ja schon praktischerweise automatisch an und aus, aber es gibt auch andere Situationen, in denen ein automatisches Licht sehr nützlich sein kann - in dunklen Abstellräumen oder Garagen. Vor allem weil man nicht vergessen kann es auszuschalten, weil es auch von allein ausgeht. Eine solche Funktion, so könnte man meinen, wird ganz einfach erreicht, indem man das Licht mit einem Aktor schalten lässt und diesen mit einem Tür- oder Fensterkontakt verknüpft. Hat man die beiden dann mit ''peerChan'' verknüpft, so wird man feststellen, dass das Licht mitnichten das Gewünschte tut: es schaltet sich beim Öffnen der Tür abwechselnd ein und aus und ignoriert das Schließen der Tür komplett.

Verantwortlich für dieses "Fehlverhalten" sind die Register ''shCtOn'' und ''shCtOff''. Beide stehen nach der Verknüpfung auf "geLo". Wie bei den Registern oben erläutert, führt in diesem Fall nur die "offen"-Meldung des Türkontaktes zu einer Aktion. Das Öffnen der Tür soll den Aktor einschalten, das klappt. Das Schließen der Tür soll den eingeschalteten Aktor aber ausschalten. Also muss die Schaltbedingung im On-Zustand geändert werden (die Bezeichnungen natürlich durch die realen Namen des Schaltaktorkanals und des Türkontaktes ersetzen):
:<code>set <Schalter> regSet shCtOn ltLo <Türkontakt> </code>
Nun führt auch das Schließen der Tür wunschgemäß stets zu einem Abschalten des Lichts. ''shCtOff'' muss auf "geLo" bleiben!

Kombinieren ließe sich das noch mit einer Laufzeitbegrenzung etwa für eine Stunde - sollte man die Tür versehentlich offenlassen, so brennt das Licht nicht stundenlang. Vor allem geht das Licht dann auch aus, wenn aus welchem Grund auch immer die Schließmeldung verloren geht.
:<code>set <Schalter> regSet shOnTime 3600 <Türkontakt> </code>

=== Lampe mit Kippschalter(n) fernschalten - eindeutig oder als Wechselschaltung ===
Oft besteht der Wunsch, eine Lampe mit einem herkömmlichen Schalter (statt eines Tasters) fernzuschalten. So kann man einen herkömmlichen Schalter mit einer Schließerkontaktinterface wie dem [[HM-SCI-3-FM 3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]] ergänzen (oder einem Kanal des [[HM-MOD-EM-8 8-Kanal-Sendemodul|8-Kanal-Sendemoduls]] in der Betriebsart ''sensor'') und wiederum die Verknüpfung mit dem Lampen-Aktor setzen. Ganz ähnlich wie bei der vorgenannten Abstellraum-Aufgabe führt nun aber das Schließen des Schalters nicht zu einem Einschalten. Daher ist nun
:<code>set <Lampenaktor> regSet shCtOff ltLo <Sensorkontakt> </code>
das Mittel der Wahl, ''shCtOn'' muss dieses Mal auf "geLo" bleiben. Jetzt folgt der Aktor dem (sichtbaren) Schaltzustand des Schaltes - zumindest solange er nicht anderweitig ein- oder ausgeschaltet wird.

Nun kann man auch mehrere Schalter so mit der Lampe koppeln. Das ergibt aber keine Wechselschaltung im herkömmlichen Sinn - um eine Lampe ein- oder auszuschalten, muss man den Schalter möglicherweise einmal zusätzlich auf die aktuelle Schaltposition kippen, ehe die nächste Betätigung den gewünschten Effekt bringt. Für Wechselschaltungen bietet sich daher das Kontaktinterface [[HM-SwI-3-FM]] (oder das erwähnte 8-Kanal-Sendemodul in der Betriebsart ''switch'') an. Hier führt jede Zustands''änderung'' zu einem Schaltvorgang.

Hat man hingegen nur ein HM-SCI-3-FM zur Hand, lässt sich dieses Verhalten auch erreichen:
:<code>set <Lampenaktor> regSet shCtOn outside <Sensorkontakt> </code>
:<code>set <Lampenaktor> regSet shCtOff outside <Sensorkontakt> </code>

=== Gezieltes Schalten eines (unsichtbaren) Aktors mit nur einer Taste ===
Für so etwas braucht man gewöhnlich zwei Tasten. Koppelt man einen Schalt-Aktor mit nur einer Taste ("single" beim ''peerChan''-Kommando), so führt sowohl ein kurzer als auch ein langer Tastendruck immer nur zu einem Umschalten des Zustandes. Das ist unschön, wenn man den aktuellen Zustand nicht einsehen kann.

Üblicherweise sind die Schaltabfolgen für eine Eintasten-Verknüpfung sowohl für kurze als auch lange Betätigungen gleich (bei Dimmern wird auf langen Tastendruck hingegen abwechselnd auf- oder abgedimmt).
shSwJtOff = dlyOn # Ist Gerät aus, wird Einschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOff = dlyOn # dito, für lang
shSwJtOn = dlyOff # Ist Gerät an, wird Ausschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOn = dlyOff # dito, für lang
Hier kann man sich zunutze machen, dass man mit einem gezielten "no" oder "dlyOn" bzw. "dlyOff" im richtigen Register die Schaltfolge abbrechen oder umbiegen kann.
Möchte man das Gerät <aktor> mit einem kurzen Tastendruck auf <button> ein- und mit einem langen Tastendruck ausschalten, so ändere man:
:<code>set <aktor> regSet shSwJtOn dlyOn <button> </code>
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>
So laufen die entsprechenden Aktionen quasi ins Leere, wenn der Aktor bereits den gewünschten Zustand hat.

Den umgekehrten Effekt (lang schaltet ein, kurz aus) erreicht man entsprechend mit
:<code>set <aktor> regSet shSwJtOff dlyOff <button> </code>
:<code>set <aktor> regSet lgSwJtOn dlyOn <button> </code>

Welche Bedienhaptik man nun bevorzugt, muss man selbst entscheiden. In der Regel sollte die normale (sichere) Aktion "kurz" und die gefährlichere "lang" sein - eine PC-Stromversorgung mit einem kurzen Tastendruck versehentlich einzuschalten ist bestimmt besser als auszuschalten (das dann eben nur über lang) - für ein potentiell gefährliches Arbeitsgerät wie einen Heizofen wird es sicher andersherum sein.

Sinngemäß verwendet der Autor sozusagen eine Hälfte davon als "Sicherheitsaktion" für einen [[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach]] - der gewöhnliche Tastendruck auf die zugehörige Wippenseite schaltet den Aktor abwechselnd ein und aus, ein langer Tastendruck immer aus, dafür reicht:
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>

Übrigens: Nichts anderes wird normalerweise auch automatisch beim Verknüpfen eines Aktors mit einem Tastenpaar an der entsprechenden Stelle gemacht - ist eine Taste nur zum Ausschalten gedacht, so wird in beiden Schaltzuständen entsprechend "dlyOff" eingetragen. Als "Sprungziel" müsste aber genauso gut auch "no" funkionieren.

=== WARNUNG! - Selbsttätiges Blinken eines HM-Aktors ===
Statt einer separaten Warnleuchte kann es durchaus sinnvoll sein, eine vorhandene Lampe zu Warnzwecken periodisch ein- und auszuschalten. Leider beherrschen die HomeMatic-Aktoren keine direkt aus FHEM erreichbare Blinkfunktion (ähnlich dem on-for-timer für eine Zeitbegrenzung), und das rhythmische Ein- und Ausschalten aus FHEM erzeugt eine recht hohe Funklast.

Wir wissen aber, dass die Aktoren für jeden Peer nicht nur eine Ein-, sondern auch eine Ausschaltzeit speichern. Definiert man nun für einen Peer entsprechend beide Zeiten, so wird der Aktor bei einem Telegramm von diesem Peer sich entsprechend selbsttätig fortlaufend ein- und ausschalten. Jeder andere Schaltbefehl eines anderen Peers oder aus FHEM beendet die Schleife umgehend. So ließe sich das Blinken auch mit einer aktoreigenen Taste stoppen - oder starten, wenn man es entsprechend programmiert. Einen Zwischenstecker-Schalter beispielsweise kann man also (wenn man zuvor seine ''confBtnTime'' entsprechend setzt und so die langen Tastendrücke auswertbar macht) durch das Programmieren von ''lgOnTime'' und ''lgOffTime'' für den Peer "self01" wie gewohnt mit einem kurzen Tastendruck ein- und ausschalten und mit einem langen in den Blinkmodus versetzen.

Einen Haken hat die Sache aber: Der Aktor meldet seinen neuen Schaltzustand nach jeder Änderung mit einer gewissen Verzögerung, die man bei vielen Schaltaktoren (aber leider nicht bei allen wie etwa dem HM-Mod-Re-8) mit dem Register ''statusInfoMinDly'' tunen kann. Ändert der Aktor seinen Schaltzustand in längeren Intervallen, wird es also trotzdem wieder ein Funkfeuer geben. Ist das Delay noch nicht erreicht, erfolgt keine Zustandsübermittlung. Beim HM-Mod-Re-8 muss man also etwa unter 1 Sekunde pro Änderung bleiben.

Zum Steuern aus FHEM emfiehlt es sich, virtuelle Buttons (etwa einer VCCU oder eines virtuellen HM-Dummys) zum Ein- und Ausschalten der Blinkfunktion zu verwenden. "Opfert" man dafür zwei aufeinanderfolgende Kanäle, kann man die Aktoren mit "dual set" peeren und bekommt so einen Blink- und einen Deaktivierungsbutton ohne weitere Kopfstände. Anschließend passt man die short-Laufzeiten für den Einschaltkanal an.

Ein Beispiel für einen Dimmer (als virtuelle Buttons dienen vccu_Btn8 und vccuBtn9):

:<code>set <vccu_Btn8 peerChan 0 <dimmerkanal> dual set</code>

Nun kann man mit "set vccu_Btn9 press short" den Dimmer ein- und mit "set vccu_Btn8 press short" ausschalten. Das Blinken im Dimmer wird eingestellt mit

:<code>set dimmer regSet shOnTime 1 vccu_Btn9</code>
:<code>set dimmer regSet shOffTime 1 vccu_Btn9</code>
jeweils für die gewünschte Ein- und Ausschaltzeit.

Wird der Dimmer nun mit "set vccu_Btn9 press short" eingeschaltet, so blinkt er im 3-Sekunden-Takt: zu den jeweils 1 Sekunde Ein- und Auszeit gesellen sich noch 2x 0,5s Rampenzeit, sofern nichts anderes programmiert wurde.

Das funktioniert auch mit Schaltern: So würde 0.1 und 0.9 (Sekunden) ein kurzes Blitzen im Sekundentakt einstellen.

Natürlich kann man nun eine größere Anzahl von Aktoren mit den virtuellen Buttons peeren und so ein ganzes Feuerwerk zünden ... Eine zusätzlich zu Alarmsirenen wild blinkende Innenbeleuchtung in allen Räumen sorgt sicher für zusätzliche Aufmerksamkeit.

=== Einer nach dem Anderen! - Sequentielles Schalten mehrerer Aktoren ===
Eine großflächige Beleuchtung mit viel Leistung sollte man aus Lastgründen niemals zugleich einschalten. Auch LED-Lampen ziehen im Einschaltmoment, wennauch extrem kurz, beträchtliche Ströme, die die von gewöhnlichen Glühlampen deutlich übersteigen können. Schaltet man mehrere Aktoren gleichzeitig mit einer Taste, so hilft eine individuelle Verzögerung des Einschaltvorgangs in jedem Aktor, die Sicherung vor dem Herausfliegen zu bewahren. Oder man macht gezielt einen Effekt daraus. Der Phantasie sind wenig Grenzen gesetzt...

Hat man drei Aktoren "Aussenlicht1...3" mit dem Taster "Aussenlicht_Ein" gepeert, so erreicht man auf folgende Weise, dass sie beim Einschalten mit einer Verzögerung von jeweils einer Sekunde nacheinander einschalten.

:<code>set Aussenlicht2 regSet shOnDly 1 Aussenlicht_Ein</code>
:<code>set Aussenlicht3 regSet shOnDly 2 Aussenlicht_Ein</code> [[Kategorie:HomeMatic Components|1toolsAndWork]]

HomeMatic Devices pairen

2020-07-09T09:45:14Z

Pfriemler: /* Pairing lösen */ Hinweis auf RT-DN mit peerBulk entfernt, da es in diesem Artikel um Pairen, nicht um Peeren geht!

HomeMatic Geräte müssen mit dem für das HomeMatic-Protokoll eingesetzten IO-Device ([[HomeMatic|Homematic IO's]]) ''[[Pairing (HomeMatic)|gepairt]]'' (deutsch: "gepaart") werden, damit sie von FHEM gesteuert oder ausgelesen werden können.

Die Adresse eines HomeMatic Gerätes ist nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben. Da die HM-Geräte über eine sehr komplexe Kanalstruktur verfügen, empfiehlt es sich daher, die Geräte in FHEM per ''autocreate'' Funktion anlegen zu lassen, Eine nachträgliche Umbenennung oder manuelle Bearbeitung der erzeugten Konfigurationsdaten ist problemlos möglich.

Zunächst muss man einen [[HomeMatic_Installieren|Homematic IO installieren]].

Einige Geräte werden mit aktivierter [[AES Encryption]] ausgeliefert (meistens, aber nicht immer mit SEC im Namen). Das Anlernen an originalen Homematic IO's funktioniert ohne Probleme, für alle CUL Derivate muss unbedingt der Hinweis im Artikel AES Encryption im Abschnitt [[AES_Encryption#I.2FO-Device_←→_Gerät|I/O-Device ←→ Gerät]] beachtet werden. '''Die dort beschriebene Installation sollte generell vorgenommen werden!'''

Danach geht es hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät genau einem IO-Device zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

'''Achtung:''' Ist ein Device gepairt, werden Konfigurationsänderungen über die Zentrale (FHEM) vorgenommen. Man kann u.a. keine Kanäle mehr ''direkt'' peeren (verknüpfen). Stattdessen verwendet man Kommandos in FHEM. Siehe <u>[[Homematic_Peering_Beispiele|peeren]]</u>

=hmId=

'''Achtung wichtig - Sicherheit!!'''

Zu bemerken ist, dass ein IO-Device eventuell standardmäßig eine ID wie F10000, F11234 oder F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringend zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL|HMLAN1|AndererIODeviceTyp> hmId <6-stellige Hexadresse>

zu individualisieren.

Diese ist ein 3-Byte hexadezimal-Wert, somit eine 6-stellige Zeichenfolge in '''Großbuchstaben'''. 000000 und FFFFFF sind ungültig.
Wenn HM-Geräte mit der Zentrale [[Pairing (HomeMatic)|gepairt]] werden, wird ihnen diese hmId eingetragen. Wechselt man die hmId müssen '''alle''' damit gepairten Geräte neu gepairt werden.

Die Adresse wird in Grossbuchstaben eingegeben.

= IO-Device in den Pairing-Modus versetzen =
* IO-Device in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <Name des IO-Device> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <Name des IO-Device> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.

Falls das Gerät einen separaten Anlernknopf hat, ist der normalerweise nur ganz kurz zu drücken.
Danach beginnt die LED regelmäßig zu blinken. Eine Ausnahme sind Geräte, bei denen eine Taste im regulären Betrieb für andere Zwecke verwendet wird. Bei einem [[HM-CC-RT-DN Funk-Heizkörperthermostat|Heizkörperthermostat]] z.B. muss die Boost-Taste (Mitte) für mindestens 3 Sekunden gedrückt gehalten werden.

{{Randnotiz|RNText=Hinweis: Das genaue Vorgehen ist vom Gerätetyp abhängig -> unbedingt das Handbuch genau lesen: Stichwort "Anlernen".}}
Hat das Gerät keinen separaten Anlernknopf, muss in der Regel eine Taste solange gedrückt werden, bis die LED anfängt regelmäßig zu blinken.

Kommt der Anlernvorgang in Gang, wird dies durch ein wechselndes, schnelles Blinken signalisiert. Kommt kein Anlernvorgang zustande, blinkt die LED regelmäßig für einen bestimmten Zeitraum (ca. 20 sec).
Ist das Gerät schon angelernt, werden bei batteriebetriebenen Geräten eventuell auch noch nicht übertragene Daten gesendet. Dabei blinkt die LED auch unregelmäßig.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register <code>pairCentral</code> im Device gesetzt.

Ein <code>save</code> danach sichert die neu angelernten Geräte in der Konfiguration.

Hinweis: Auch mit <code>hmPairForSec</code> kann jeweils nur '''ein''' Gerät angelernt werden. Für mehrere Geräte den Vorgang bitte wiederholen.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts
* die Anlerntaste / Configtaste / irgendeine Taste am Gerät (hängt vom konkreten Device ab) wiederholt drücken um die Datenübertragung anzustoßen.

Alternativ kann man auch mit HMInfo einen Config check durchführen:

define hm HMInfo
get hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft Knopf mindestens 5 Sekunden drücken, bis es blinkt, dann loslassen und nochmals 5 Sekunden drücken, bis es schneller blinkt) und danach erneut pairen.

Alternativ kann Auflösung/Reset des Pairings per Befehl in FHEM erfolgen. Siehe dazu unten.

Wenn das zu pairende Geräte ein Empfänger ist, kann mit FHEM per Telnet oder in der Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <Name des IO-Device> hmPairSerial <10-stellige Seriennummer>

Die 10-stellige Seriennummer ist beim Empfängern idR. auf der Rückseite des Geräte aufgedruckt. Die Seriennummer fängt normalerweise mit Buchstaben an und endet mit Zahlen.

Es gilt auch sicherzustellen, dass das zu pairende Gerät nicht bereits zuvor mit der HomeMatic Config Software gepairt wurde. Ist dies der Fall, so sollte das Pairing in der HomeMatic Config Software gelöscht und das Pairing in FHEM erneut durchgeführt werden.

Beim Pairen ist, wie im normalen Betrieb auch, ein Mindestabstand (etwa 1-2 Meter) zwischen dem Sender der Zentrale (CUL, HMLAN etc.) einzuhalten, da die Funkempfänger sonst mit Übersteuerung reagieren und keine Kommunikation zustande kommt.
Außerdem kann die Funklast beim Auslesen einer umfangreichen Konfiguration eines Gerätes bereits nach wenigen Versuchen das Limit der [[1%25_Regel]] erreichen. Sollte also scheinbar keine Kommunikation stattfinden können, ist auch zu prüfen, ob der Zentralensender sich deswegen temporär deaktiviert hat.

Wer einen CUL für HomeMatic verwendet, sollte eine speziell für den Betrieb mit HomeMatic optimierte CUL-firmware ([https://forum.fhem.de/index.php/topic,24436.0.html TimeStamp Firmware]) verwenden.

Die Webseite [https://www.christian-luetgens.de/homematic/hintergrund/ablernen/Ablernen.htm#chapter_3 Anlernen, ablernen, entfernen und zurücksetzen von Geräten] scheint allerdings nötige Maßnahmen/Probleme beim Pairen deutlich präziser/detaillierter zu beschreiben.

= Gezieltes Pairing =
Bei bereits bekanntem HM-Gerät kann man mit:

set <Name HM-Gerät> pair

das Pairing überschreiben. Es funktioniert aber nur, wenn schon ein IO-Device eingetragen ist.

= Pairing lösen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden.
[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

HM-LC-SW2-FM Schaltaktor 2-fach UP

2020-05-03T18:11:00Z

Pfriemler: Hinweis auf externe Taster, Anlernmodus bei Fehlbedienung und Korrektur

{{Infobox Hardware
|Bild=HM-LC-Sw2-FM.jpg
|Bildbeschreibung=HomeMatic Funk-Schaltaktor 2-fach (Unterputz)
|HWProtocol=HomeMatic
|HWType=Empfänger, Aktor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=2
|HWVoltage=230 V~
|HWPowerConsumption=Eigenverbrauch ca. 0,5 W
|HWPoweredBy=Netz
|HWSize=53 x 53 x 30 mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

[[HM-LC-SW2-FM Schaltaktor 2-fach UP]] ist ein zweikanaliger Homematic Funk-Schaltaktor für die Unterputzmontage.

== Features ==
Unabhängiges Schalten von zwei Verbrauchern mittels FHEM ([[Interface]]: [[CUL]], [[CUN]], [[HMLAN Konfigurator]]) oder über angeschlossene(n) Taster.

Das maximale Schaltvermögen liegt bei 5 A (Summe beider Kanäle, ohmsche Last). Diese Begrenzung ist sehr ernst zu nehmen, da sonst eine Sicherung durchbrennt und ersetzt werden muss. Für ein Schaltvermögen von bis zu 16 A ist der [[HM-LC-SW1-FM Schaltaktor 1-fach UP|einkanalige HM-LC-SW1]] eine Alternative.

== Hardware-Installation ==

Wie auch die bauähnlichen 1-kanaligen Schaltaktoren, -dimmer und der Rolladenaktor sind zum Ansteuern des Aktors mit externen Tasten ausschließlich Taster verwendbar.
Aber auch bei Tastern kann es bei einer Tastenbetätigung >4 Sekunden passieren, dass der Aktor in den Anlernmodus versetzt wird und auch in diesem verbleibt oder bei einer erneuten Betätigung sogar zurückgesetzt wird. Dies kann durch eine einmalige Registermanipulation korrigiert werden - danach ist der Anlernmodus nach einer kurzen Zeit gesperrt, stattdessen stehen weitere Schaltfunktionen über einen langen Tastendruck zur Verfügung, wie es auch mit verknüpften externen Tastern möglich ist. Details dazu sind [[HomeMatic_Register_programmieren#confBtnTime_-_Kurz_oder_lang_und_der_Konfigurationsmodus|hier]] zu finden.

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

=== FHEM Config-Auszug ===
Bei eingeschaltetem Autocreate werden die erforderlichen Definitionen beim Pairen selbstständig erstellt. Ein exemplarischer Auszug aus der fhem.cfg (Seriennummer anonymisiert):
<pre>
define HM_Sw2_Garage CUL_HM 2D38E9
attr HM_Sw2_Garage IODev MyHMLAN
attr HM_Sw2_Garage autoReadReg 4_reqStatus
attr HM_Sw2_Garage expert 2_full
attr HM_Sw2_Garage firmware 1.12
attr HM_Sw2_Garage model HM-LC-SW2-FM
attr HM_Sw2_Garage room CUL_HM
attr HM_Sw2_Garage serialNr LEQ0xxxxxx
attr HM_Sw2_Garage subType switch
attr HM_Sw2_Garage webCmd getConfig:clear msgEvents

define HM_Sw2_GarageLicht1 CUL_HM 2D38E901
attr HM_Sw2_GarageLicht1 model HM-LC-SW2-FM
attr HM_Sw2_GarageLicht1 peerIDs 00000000,
attr HM_Sw2_GarageLicht1 room CUL_HM
attr HM_Sw2_GarageLicht1 webCmd statusRequest:toggle:on:off

define HM_Sw2_GarageLicht2 CUL_HM 2D38E902
attr HM_Sw2_GarageLicht2 model HM-LC-SW2-FM
attr HM_Sw2_GarageLicht2 peerIDs 00000000,
attr HM_Sw2_GarageLicht2 room CUL_HM
attr HM_Sw2_GarageLicht2 webCmd statusRequest:toggle:on:off
</pre>

{{Randnotiz|RNTyp=y|RNText='''Firmware''' - Versionen / Update
Bei diesem Aktor kann durch den Endbenutzer '''kein''' [[HomeMatic Firmware Update|Firmware Update]] durchgeführt werden. Es sind aber Geräte mit unterschiedlichen Firmware Versionen in Umlauf:
* 1.12 (Seriennr. LEQ0...)
* 1.9 (Seriennr. KEQ10..)
* 2.5 (Seriennr. LEQ1...)
}}
=== Mögliche Schaltoperationen ===
Der Aktor versteht folgende Aktionen:
<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet und ein ausgeschalteter Aktor wird eingeschaltet
</pre>

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-SW2-FM folgendes Log zu sehen:
<pre>
2012.02.05 15:29:04 2: CUL_HM set LichtSchreibtisch on
2012.02.05 15:29:09 2: CUL_HM set LichtSchreibtisch off
2012.02.12 19:04:42 2: CUL_HM set LichtSchreibtisch toggle
</pre>

== Einsatzbeispiel ==
[[Bild:HM-LC-Sw1-FM_aufHutschiene.jpg|thumb|right|LC-Sw2-FM als Ersatz für (zwei) "Eltako" Stromstoßrelais]]
Im gezeigten Bild werden zwei Eltako-Stromstoßrelais durch den Zweikanal-Schaltaktor ersetzt. Hierbei sind nur die vorhandenen Verbindungen auf den LC-Sw2-FM umzuklemmen. Sämtliche Taster funktionieren unverändert wie vorher, zusätzlich sind die angeschlossenen Leuchten damit über Funk (FHEM, HomeMatic-Fernbedienung etc.) direkt oder auch zeitgesteuert schaltbar.

Zur Vereinfachung der Montage in einem Hutschienenverteiler ist das Schaltmodul mit Kabelbindern in einem Hutschienengehäuse (Breite: 73 mm) fixiert.

Die gezeigte Verschaltung ist möglich, da die Tastereingänge S1 und S2 mit Netzspannung (und damit wie ein herkömmliches Stromstoßrelais) angesteuert werden können.

Mittlerweile (seit Mitte 2015, als Bausatz) gibt es auch den originär für Hutschienenmontage vorgesehenen einkanaligen Aktor HM-LC-Sw1-DR, Breite 18 mm (entspricht 1 TE), mit einer maximalen Schaltleistung (ohmsche Last) von 1380 W.

== Bekannte Probleme ==
* Durch die relativ geringe Belastbarkeit der Relais kann es leicht zum sogenannten "Verkleben" der Relais kommen. Dieses Problem inklusive einiger Hinweise zur Reparatur durch Ersatz eines defekten Relais sind in {{Link2Forum|Topic=43914|LinkText=diesem Forenthema}} beschrieben.

Bei Überlastung oder Kurzschluss durch externe Verbraucher (wie auch durch durchbrennende Glühlampen im Einschaltmoment) stirbt im Aktor eine spezielle, steckbar ausgeführte Schmelzsicherung, die nur durch Öffnen des Gehäuses ausgetauscht werden kann.

== Links ==
* Ein Integrationsbeispiel ist in [[Jalousie und Beleuchtung in mehreren Räumen]] zu finden.
* Anleitung (PDF {{DocLink|elv|/service/manuals/76793_HM_Unterputzschalter_UM.pdf}})

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

HM-LC-SW1-FM Schaltaktor 1-fach UP

2020-05-03T17:54:51Z

Pfriemler: /* Hinweise zur Hardware-Installation */ Hinweis auf confBtnTime

Homematic Funk-Schaltaktor 1-fach (Unterputz)
{{Infobox Hardware
|Bild=HM-LC-SW1-FM.jpg
|Bildbeschreibung=HomeMatic Funk-Schaltaktor
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=1
|HWVoltage=230V AC
|HWPowerConsumption=0,5W
|HWPoweredBy=Netzspannung
|HWSize=53x53x30mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
== Features ==

Schalten eines angeschlossenen Verbrauchers mittels [[CUL]]/[[CUN]]/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

== Hinweise zur Hardware-Installation ==

'''WICHTIG''': die Installation von Komponenten mit Netzspannung darf nur von Fachpersonal durchgeführt werden.

Will man die Funk-Schaltaktoren auch manuell betreiben, d.h. man upgradet eine vorhandene Elektroinstallation, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zu Taster umgebaut werden, Tastschalter sind leider nicht geeignet.

Aber auch bei Tastern kann es bei einer Tastenbetätigung >4 Sekunden passieren, dass der Aktor in den Anlernmodus versetzt wird und auch in diesem verbleibt oder bei einer erneuten Betätigung sogar zurückgesetzt wird. Dies kann durch eine einmalige Registermanipulation erreicht werden - danach ist der Anlernmodus nach einer kurzen Zeit gesperrt, stattdessen stehen weitere Schaltfunktionen über einen langen Tastendruck zur Verfügung, wie es auch mit verknüpften externen Tastern möglich ist. Details zu dem Eingriff sind [[HomeMatic Register programmieren#confBtnTime - Kurz oder lang und der Konfigurationsmodus|hier]] zu finden.

Je nach vorhandenen Schalterdosen empfiehlt es sich bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ könnte man den Aktor auch in eine zusätzliche Schalterdosen unterbringen und diese mit einem Federdeckel abschließen. Dies hat den Vorteil, dass man auch durch relativ dicke Tapete die LED und somit den Zustand des Aktors ablesen kann.

Der Aktor kann auch gänzlich ohne Taster, also nur per ''set''-Befehlen durch FHEM oder per gepeerten Geräten gesteuert werden, jedoch muss zumindest für das Anlernen zeitweise ein Taster angeschlossen werden.

== Hinweise zum Betrieb mit FHEM ==

Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt.

# Sicherstellen, dass ''autocreate'' aktiv ist
# Am CUL/HMLAN o.ä. <code>set HMLAN hmPairForSec 60</code>
# Binnen 60 Sekunden Aktor in Anlernmodus bringen (Taster 4s festhalten bis LED blinkt) -> Device wird in fhem angelegt, z.B. als CUL_HM_HM_LC_SW1_FM_2BAD45
# <code>rename <Aktor> <AktorNameNeu></code> -> richtigen Namen zuordnen

=== FHEM Config-Auszug ===

Ein exemplarischer Auszug aus der fhem.cfg:

<pre>
define LichtTerasse CUL_HM 17AEA6
attr LichtTerasse devInfo 010100
attr LichtTerasse firmware 1.9
attr LichtTerasse hmClass receiver
attr LichtTerasse model HM-LC-SW1-FM
attr LichtTerasse room Terasse
attr LichtTerasse serialNr IEQ00xxxx
attr LichtTerasse subType switch
</pre>

=== Mögliche Schaltoperationen ===

Der Aktor versteht folgende Aktionen:
<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet
</pre>

=== Log-Auszug ===

In FHEM ist nach dem Schalten des HM-LC-SW1-FM folgendes Log zu sehen:
<pre>
2012.02.05 16:51:44 2: CUL_HM set LichtTerasse on
2012.02.05 16:52:14 2: CUL_HM set LichtTerasse off
2012.02.05 16:52:15 2: CUL_HM set LichtTerasse toggle
</pre>

== Nützliches Zubehör ==

Wer den Schaltaktor im Sicherungskasten selbst einbauen möchte, z.B. um einen Stromstossschalter zu ersetzen, dem kann folgendes Zubehör empfohlen werden: Hutschienengehäuse CNMB-4V-Kit, Bestellnr. 532659 bei conrad. Das ist zwar sicher auch nicht VdE-konform, aber besser wie ohne. Alternativ kann auch der [[HM-LC-Sw1-DR 1fach Schaltaktor Hutschiene]] zur direkten Montage auf Hutschienen eingesetzt werde.

== Probleme ==

Um den HM-LC-SW1-FM in den Anlernmodus zu versetzen, soll man lt. Anleitung den (temporär) angeschlossenen Taster für 4 Sekunden gedrückt halten. Falls dies bei Ihnen nicht funktioniert, so versuchen Sie den Taster einfach mal ca. 7 bis 8 Sekunden gedrückt zu halten (bis die LED des SW1-FM kurz aufleuchtet).

Wenn das Pairing nicht komplett durchläuft (Device zeigt als Status MissingACK und kann nicht von FHEM aus gesteuert werden), dann hilft ggf. ein weiteres Pairing über hmPairSerial.

== Links ==

Ein Integrationsbeispiel ist in [[Jalousie und Beleuchtung in mehreren Räumen]] zu finden.

[http://files.elv.de/Assets/Produkte/7/767/76793/Downloads/76793_HM_LC_Sw1_FM_um.pdf Anleitung (PDF)]

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

HM-LC-DIM1T-FM 1-Kanal-Dimmer UP

2020-05-03T17:49:41Z

Pfriemler: /* Hinweise zur Hardware-Installation */ Hinweis auf confBtnTime für Dimmfunktion und Sperre des Anlernmodus bei lokalen Tastern

Homematic Funk 1-Kanal-Dimmer, Phasenabschnitt (Unterputz)

= Features =

Schalten eines angeschlossenen Verbrauchers mittels [[CUL]]/[[CUN]]/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

Schaltdoseneinsatz zusätzlich zu vorhandenem Taster (erfordert evtl. tiefere Schaltdose).

'''Technische Daten:'''
* Schaltvermögen: 180VA 230V/50Hz
* Art: Phasenabschnittdimmer
* Standby Verbrauch: 1W
* Maße(BxHxT): 53x53x30mm

= Hinweise zur Hardware-Installation =

Will man die Funk-Schaltaktoren auch manuell betreiben, d.h. man upgradet eine vorhandene Elektroinstallation, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zu Taster umgebaut werden, Tastschalter sind leider nicht geeignet.

Ab Werk sind Dimmfunktionen über angeschlossene Taster nicht möglich. Stattdessen kann es sogar passieren, dass der Dimmer bei einer Tastenbetätigung >4 Sekunden in den Anlernmodus versetzt wird und auch in diesem verbleibt.Man kann beides korrigieren, indem man ein Register im Aktor einmalig manipuliert - danach sind Dimmfunktionen möglich und der Anlernmodus gesperrt. Details dazu sind [[HomeMatic Register programmieren#confBtnTime - Kurz oder lang und der Konfigurationsmodus|hier]] zu finden.

Je nach vorhandenen Schalterdosen empfiehlt es sich bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ könnte man den Aktorauch in eine zusätzliche Schalterdosen unterbringen und diese mit einem Federdeckel abschließen. Dies hat den Vorteil, dass man auch durch relativ dicke Tapete die LED und somit den Zustand des Aktors ablesen kann.

= Kompatible Leuchtmittel =

Hier eine Übersicht über die Kompatibilität des HM-LC-DIM1T-FM mit diversen Leuchtmitteln:

{| cellspacing="0" border="1"
| '''Art'''
| '''Bezeichnung'''
| '''Sockel'''
| '''Verbrauch'''
| '''Farbtemperatur'''
| '''Laut Hersteller geeignet für'''
| '''Funktion'''
| '''Einschränkungen'''
| '''Kompatibilitätsliste'''
| '''Hersteller Link'''
|-
| Glühlampe
| Glühlampe
|
|
|
| An-/Abschnitt
| ja
| nein
|
|
|-
| Energiesparlampe
| Osram Dulux Intelligent Dim Globe
|
|
|
| Anschnitt
| vermutlich nein
| ?
|
| [http://www.osram.de/osram_de/produkte/lampen/kompaktleuchtstofflampen/osram-dulux-intelligent/osram-dulux-intelligent-dim-globe/index.jsp]
|-
| Energiesparlampe
| Osram Dulux Intelligent Dim Stick
|
|
|
| Anschnitt
| vermutlich nein
| ?
|
| [http://www.osram.de/osram_de/produkte/lampen/kompaktleuchtstofflampen/osram-dulux-intelligent/osram-dulux-intelligent-dim-stick/index.jsp]
|-
| Energiesparlampe
| Phlilips Softone Dimmable
|
|
|
| An-/Abschnitt
| ?
| ?
|
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/energiesparlampen/energiesparlampen-gluehlampenform/softone-dimmable/20165/cat/]
|-
| Energiesparlampe
| Phlilips MASTER PL-Electronic Dimmable
|
|
|
| An-/Abschnitt
| ?
| ?
|
| [http://www.ecat.lighting.philips.at/l/professionelle-lampen/energiesparlampen/energiesparlampen-roehrenform/master-pl-electronic-dimmable/18109/cat/]
|-
| Energiesparlampe
| Phlilips TORNADO ESaver Dimmable
|
|
|
| Anschnitt
| vermutlich nein
| ?
|
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/energiesparlampen/energiesparlampen-spezialform/tornado-esaver-dimmable/19666/cat/]
|-
| LED
| Delock Lighting
| GU10
| 6W
| 3000K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1075/107524/Downloads/107524_delock.pdf}}
| [http://www.delock-lighting.de/produkte/G_46327/merkmale.html]
|-
| LED
| Ledon LED-Spot MR16
| GU10
| 5W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1026/102699/Downloads/102699_ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_MR16_5W_GU10_DIM.htm]
|-
| LED
| Ledon Tropfenform
| E14
| 5W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/9/995/99557/Downloads/099557_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_P45_5W_E14_DIM.htm]
|-
| LED
| Ledon Kerzenform klar B35/C
| E14
| 5W
| 2700K
| k.A.
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/9/995/99554/Downloads/099554_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_B35_C_5W_E14%20DIM.htm]
|-
| LED
| Ledon Globe G80
| E27
| 6W
| 2800K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/9/995/99586/Downloads/099586_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_G80_6W_E27_DIM.htm]
|-
| LED
| Ledon A65
| E27
| 10W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1000/100026/Downloads/100026_Ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_A65_10W_E27_DIM.htm]
|-
| LED
| Ledon G95
| E27
| 10W
| 2700K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1022/102273/Downloads/102273_ledon.pdf}}
| [http://www.ledon-lamp.com/de/ledon_led-lampe_G95_10W_E27_DIM.htm]
|-
| LED
| LG LED-Glühbirne A19
| E27
| 12,8W
| 2700K
| k.A.
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1020/102043/Downloads/102043_LG.pdf}}
| [http://www.lg.com/de/innenbeleuchtung/lg-A1912GD0GE1.C0AASAA-gluehbirne]
|-
| LED
| Osram IVIOS LED III
| k.A.
| 2x 5,5W
| 3000K
| Abschnitt
| ja
|
|
| [http://www.osram.de/osram_de/produkte/led-technologie/innenraum-led-leuchten/downlights/ivios-led-iii/index.jsp]
|-
| LED
| Osram SUPERSTAR PAR 16
| GU10
| 5,5W
| 3000K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1025/102569/Downloads/102569_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-reflektorlampen/led-superstar-par-16/index.jsp]
|-
| LED
| Osram PARATHOM PRO PAR 16 advanced 50
| GU10
| 9W
| 4000K
| k.A.
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1083/108338/Downloads/108338_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-reflektorlampen/parathom-pro-par-16-advanced/index.jsp]
|-
| LED
| Osram PARATHOM PRO PAR 16 advanced 35
| GU10
| 5,2W
| 4000K
| k.A.
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1083/108337/Downloads/108337_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-reflektorlampen/parathom-pro-par-16-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A50
| E27
| 12W
| 3000K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A40
| E27
| 8,5W
| 2700K
| k.A.
| nein
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1082/108212/Downloads/108212_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A60
| E27
| 12W
| 2700K
| k.A.
| nein
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1077/107748/Downloads/107748_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram LED Superstar Classic A75
| E27
| 14,5W
| 2700K
| k.A.
| nein
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1077/107749/Downloads/107749_osram.pdf}}
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/consumer-led-lampen-mit-klassischen-kolbenformen/led-superstar-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 50
| E27
| 12W
| 3000K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 60
| E27
| 12W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 60
| E27
| 13W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC A advanced 75
| E27
| 14,5W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-a-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC P advanced 25
| E14
| 4,5W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-p-advanced/index.jsp]
|-
| LED
| Osram PARATHOM CLASSIC P advanced 25
| E25
| 4,5W
| 2700K
| k.A.
|
|
|
| [http://www.osram.de/osram_de/produkte/lampen/led-lampen/professional-led-lampen-mit-klassischen-kolbenformen/parathom-classic-p-advanced/index.jsp]
|-
| LED
| Philips MASTER LEDspot HV
| GU10
| 4W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1065/106561/Downloads/106561_philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/oem/led-systems/led-retrofit-lampen/master-ledspot-hv/929000212702_eu/]
|-
| LED
| Philips MASTER LEDspot BBL
| GU10
| 7W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1018/101863/Downloads/101863_Philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-led-dimtone/61144/cat/]
|-
| LED
| Philips MASTER LEDbulb Designer
| E27
| 7W
| 2700k
| Anschnitt/Universal (RL/RLC)
|
|
|
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb-designer/61143/cat/]
|-
| LED
| Philips MASTER LEDlamps DimTone
| E27
| 8W
| 2200-2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1027/102789/Downloads/102789_philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-komponenten/led-lampen/master-ledlamps-dimtone/929000215102_eu/]
|-
| LED
| Philips MASTER LEDbulb D
| E27
| 8W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1022/102239/Downloads/102239_Philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb/19890/cat/]
|-
| LED
| Philips MASTER LEDbulb D
| E27
| 12W
| 2700K
| Anschnitt/Universal (RL/RLC)
| eingeschränkt
| Dimmbereich
| ELV {{DocLink|elv|/Assets/Produkte/10/1006/100657/Downloads/100657_Philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb/19890/cat/]
|-
| LED
| Philips MASTER LEDbulb D
| E27
| 17W
| 2700K
| Anschnitt/Universal (RL/RLC)
| ja
|
| ELV {{DocLink|elv|/Assets/Produkte/10/1060/106098/Downloads/106098_philips.pdf}}
| [http://www.ecat.lighting.philips.de/l/professionelle-lampen/led-lampen-und-komponenten/led-lampen/master-ledbulb/19890/cat/]
|-
| LED
| Philips LED Reflektor
| GU5.3
| 6.3W
| 2700K
| k.A.
| ja
|
|
| [http://www.philips.de/c-p/8718696490334/led-reflektor/technische-daten]
|-
| LED
| Philips CorePro LEDspotLV
| GU5.3
| 5.5W
| 2700K
| k.A.
| eingeschränkt
| Dimmbereich
|
| [http://www.lighting.philips.de/prof/professionelle-lampen/led-lampen/led-lampen/corepro-ledspot-mr16-niedervolt-reflektorlampen/929001146232_EU/product]
|}

== Wichtiger Hinweis zum Betrieb eines Phasenabschnittdimmers ==

Der Dimmer ist nur mit folgenden Lampen zu betreiben:
* Hochvolt-Halogenlampen
* Niedervolt- Halogenlampen mit elektronischem Trafo
* Glühlampen
* dimmbare Energiesparlampen

Im Zweifel vorher beim Hersteller nachhaken, bevor es zu Flackern oder Brummen kommt.

= Hinweise zum Betrieb mit FHEM =

Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt. Im Gegensatz zu den Schaltaktoren, muss der Phasenabschnittdimmer innerhalb der ersten 5 Minuten nach Zuschalten der Netzspannung erfolgen. Nach dieser Zeitspanne ist ein Anlernen nicht mehr möglich. Darum sollte zum Anlernen des HM-LC-DIM1T-FM zuerst die Netzspannung ab- und zugeschaltet werden, d.h. praktischerweise Sicherung kurz raus und nach einer Minute wieder rein. Bitte auch zuvor alle angeschlossenen Geräte von der Sicherung trennen oder ausschalten.

== FHEM Config-Auszug ==

Ein exemplarischer Auszug aus der fhem.cfg:

<pre>
define LichtWohnzimmerDimmer CUL_HM 184436
attr LichtWohnzimmerDimmer devInfo 110100
attr LichtWohnzimmerDimmer firmware 1.2
attr LichtWohnzimmerDimmer hmClass receiver
attr LichtWohnzimmerDimmer model HM-LC-DIM1T-FM
attr LichtWohnzimmerDimmer room Wohnzimmer
attr LichtWohnzimmerDimmer serialNr IEQ0xxxxxx
attr LichtWohnzimmerDimmer subType dimmer
</pre>

== Mögliche Schaltoperationen ==

Der Aktor versteht folgende Aktionen:
<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> up -> Helligkeitswert erhöhen
set <name> down -> Helligkeitswert verringern
set <name> toggle -> Ein eingeschalteter Dimmer wird ausgeschaltet und ein ausgeschalteter Dimmer wird auf den letztgenutzten Wert hochgedimmt.
set <name> <Helligkeit> [<Einschaltdauer>] [<Rampenzeit>] -> Schaltet den Aktor ein und dimmt dabei auf <Helligkeit>%,
100% entspricht dabei einem "on". Optional kann als Einschaltdauer die Zeit in Sekunden angegeben werden,
bis der Dimmer wieder automatisch abschalten soll (Bereich 0.00-111600 Sekunden). Optional kann weiterhin angegeben werden,
dass der Dimmer über eine angegebene Zeit in Sekunden (Rampenzeit) auf die angegebene Helligkeit hochdimmt
(Bereich 0.00 Sekunden - 111600 Sekunden) abgeschaltet wird.
</pre>

== Log-Auszug ==
In FHEM ist nach dem Schalten des HM-LC-DIM1T-FM folgendes Log zu sehen:
<pre>
2012.02.05 23:09:19 2: CUL_HM set LichtWohnzimmerDimmer on
2012.02.05 23:09:21 2: CUL_HM set LichtWohnzimmerDimmer off
2012.02.06 22:40:15 2: CUL_HM set LichtWohnzimmerDimmer toggle
2012.02.06 22:41:15 2: CUL_HM set LichtWohnzimmerDimmer 32
</pre>

= Links =
* Ein Integrationsbeispiel ist in [[Jalousie und Beleuchtung in mehreren Räumen]] zu finden.
* Anleitung [http://www.eq-3.de/Downloads/eq3/pdf_produkte/HM-LC-Dim1T-FM_UM_GE_eQ-3_100422.pdf] PDF

[[Kategorie:HomeMatic Components]]
[[Kategorie:Dimmer]]

HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP

2020-05-03T17:38:14Z

Pfriemler: /* Mögliche Hardwaredefekte */ kleine Korrekturen/Ergänzungen

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Dimmer|Dimmer]]
|HWCategory=[[:Kategorie:Dimmer|Dimmer]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=1 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
Der '''HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP''' ist ein Phasenabschnitts-Dimmer für die Unterputzmontage. Er verfügt über eine Schalterwippe, die sich mit einem Adapter in einige Schalterprogramme verschiedener Hersteller integrieren lässt. Der Dimmer kann sowohl vor Ort über die Schalterwippe als auch per Funk gesteuert werden.

== Features ==

Schaltdoseneinsatz als Ersatz für vorhandenen Dimmer-Einsatz (erfordert keine tiefere Schaltdose). Kann mittels Adapter in bestehende Schalterserien wie Busch Jäger, Gira usw. integriert werden.

=== Technische Daten ===

* Versorgungsspannung: 230 V / 50 Hz
* Minimallast: 10 VA
* Minimalstrom: 40 mA
* Maximale Schaltleistung: 180 VA
* Standby-Verbrauch: 1 W
* Dimmverfahren: Phasenabschnitt
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5 °C bis +35 °C
* Abmessungen (BxHxT): 71x71x37 mm
* Gewicht: 43 g

=== Schalter ===

Der HM-LC-Dim1TPBU-FM besitzt zwei Schalter, die über eine Wippe angewählt werden können. Das Standard-Verhalten entspricht im Prinzip dem [[HM-LC-Bl1PBU-FM Unterputz-Jalousieaktor]]:

* Ein kurzer Druck nach oben Schaltet den Verbraucher ein (100 % Leistung).
* Ein kurzer Durck nach unten Schaltet den Verbraucher aus (0 % Leistung).
* Ein langer Druck nach oben erhöht die Leistung bis der Schalter losgelassen wird.
* Ein langer Druck nach unten verringert die Leistung bis der Schalter losgelassen wird.

== Hinweise zur Hardware-Installation ==

Der HM-LC-Dim1TPBU-FM verfügt über vier Anschlussklemmen: Phase, gedimmte Phase und zwei kurzgeschlossene Klemmen für den Neutralleiter. Das heißt, dass der Neutralleiter "durchgeschleift" werden kann.

Der HM-LC-Dim1TPBU-FM füllt die Schalterdose links und rechts nahezu aus. Wenn möglich ist eine Zuführung der Leitungen von oben oder unten zu bevorzugen.

== Kompatible Leuchtmittel ==

In der Detailansicht vieler LED-Lampen auf der Webseite von ELV.de lässt sich eine Dimmer-Kompatibilitätsliste für das jeweilige Modell herunterladen.

== Mögliche Hardwaredefekte ==

Wenn der Dimmer zwischendurch immer wieder neu startet, beim Hochdimmen oder kurz danach spontan abschaltet, sich nur noch lokal, aber nicht mehr per Fernbedienung steuern lässt, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C7. (ein vergleichbarer Defekt tritt auch häufig beim Dimmer [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] oder dem Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, Rastermaß (RM) 2,5 (mm) radial (stehend), 10µ/25V (Ersatz mit höherer Spannung natürlich unproblematisch möglich). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L2) und dem dreipoligen IC2 (Linearregler). Die Platine hat Bestückungsdruck, C7 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

Siehe auch die Diskussion im Forum: --> https://forum.fhem.de/index.php/topic,55149.msg346499/topicseen.html

''Hinweis:'' In jüngerer Zeit setzt ELV offenbar auf geänderte Bauteile: Auf der ELV Seite für den Bausatz des ähnlich aufgebauten [[HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach|HM-LC-Sw1PBU-FM]] findet sich ein Hinweis, Kondensatoren anders zu bestücken:

"Folgende Kondensatoren sind abweichend zur Bedienungsanleitung Version 1.7 wie folgt zu bestücken:
* C3 und C11 10µF/25V (kleine Bauform)
* C22 und '''C26''' 10µF/'''35'''V" - In diesem Dimmaktor hat C7 die gleiche Funktion wie der C26 im Schaltaktor, es empfiehlt sich also, ein entsprechendes Exemplar auch hier einzubauen.
Generell ist der Einsatz von Kondensatoren mit höherer Spannungsfestigkeit kein Problem, solange der Platz dafür reicht. Wenn möglich, ist ein Exemplar mit niedrigem Serienwiderstand und hoher Temperaturfestigkeit zu bevorzugen. Zum alternativen Einsatz von keramischen Vielschichtkondensatoren an dieser Stelle liegen noch keine Praxiserfahrungen vor.

== Links ==

* Anleitung: http://files.elv.de/Assets/Produkte/10/1030/103020/Downloads/103020_FunkDimmaktor_um.pdf

[[Kategorie:HomeMatic Components]]
[[Kategorie:Dimmer]]
[[Kategorie:868MHz]]

HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter

2020-05-03T17:33:24Z

Pfriemler: /* Mögliche Hardwaredefekte */ kleine Ergänzungen

{{Infobox Hardware
|Bild=HM-LC-Bl1PBU-FM.jpg
|Bildbeschreibung=HM-LC-Bl1PBU-FM montiert, ohne Adapter
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Blind|Blind]]
|HWCategory=[[:Kategorie:Rollladensteuerung|Rollladensteuerung]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=0,5 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
== Features ==

Schalten eines angeschlossenen Jalousiemotors mittels CUL/CUN/HMLAN Konfigurator und über lokalen, in bestehendes Schalterprogramm integrierte Schaltwippe.

'''Technische Daten:'''
* Gerätebezeichnung: HM-LC-Bl1PBU-FM
* Versorgungsspannung: 230 V / 50 Hz
* Maximale Schaltleistung: 230 VA (Motorlast)
* Standby-Verbrauch: 0,5 W
* Schaltvermögen: 1 A (Motorlast)
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5°C bis +35°C
* Abmessungen (B x H x T): 71 x 71 x 37 mm
* Gewicht: 43 g

== Hinweise zur Hardware-Installation ==

Der Schaltaktor ersetzt den Unterputzschalter der bestehenden Elektroinstallation. Arbeiten am 230 V Netz dürfen nur von einer Elektrofachkraft durchgeführt werden! Sicherheitsregeln anwenden:

* Freischalten (Sicherung abschalten),
* gegen Wiedereinschalten sichern,
* Spannungsfreiheit feststellen, (Messgerät vor und '''nach''' Messung auf Funktion überprüfen)
* Erden und Kurzschließen,
* benachbarte, unter Spannung stehende Teile abdecken.

Zur Integration in ein bestehendes Schalterprogramm bitte den entsprechenden Adapter mit bestellen.

<gallery>
Datei:HM-LC-BL1PBU schritt 01.jpg|Ausgangssituation
Datei:HM-LC-BL1PBU schritt 02.jpg|Schalter abbauen, Rahmen entfernen, Unterputzschalter lösen
Datei:HM-LC-BL1PBU schritt 03.jpg|Bestehender Anschluss
Datei:HM-LC-BL1PBU schritt 04.jpg|Neuer Anschluss. Achtung: zusätzlicher Nullleiteranschluss!
Datei:HM-LC-BL1PBU schritt 05.jpg|Einbau ohne Adapter
Datei:HM-LC-BL1PBU schritt 06.jpg|Adapter aufsetzen
Datei:HM-LC-BL1PBU schritt 07.jpg|Fertig eingebauter HM-LC-BL1PBU-FM
</gallery>

== Hinweise zum Betrieb mit FHEM ==

Der Schalter wird seit FHEM 5.3 unterstützt. Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Dazu wird der Config-Taster kurz gedrückt.
Zur Darstellung im Webfrontend siehe [[Slider für HM-Rolladensteuerung anzeigen]].

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

define WZ_Rollo_Links CUL_HM ABCDEF
attr WZ_Rollo_Links devInfo 010100
attr WZ_Rollo_Links eventMap on:hoch off:runter stop:stop
attr WZ_Rollo_Links firmware 2.1
attr WZ_Rollo_Links hmClass receiver
attr WZ_Rollo_Links model HM-LC-Bl1PBU-FM
attr WZ_Rollo_Links room Wohnzimmer
attr WZ_Rollo_Links serialNr JEQxxxxxxx
attr WZ_Rollo_Links subType blindActuator
attr WZ_Rollo_Links webCmd pct

=== Variablen===
==== Attribute====
Dem Device können neben den Allgemeinen auch spezielle Attribute gesetzt werden.
* '''param levelInverse''': HM Blind Aktoren stehen auf 100% wenn sie offen sind und auf 0% wenn sie geschlossen sind. Das ist oftmals nicht intuitiv. In FHEM kann man dies "drehen" durch dieses Attribut. Damit dreht sich auch die Bedeutung von On und Off.
Zur optimalen Anbindung an Homebridge-/HomeKit empfiehlt es sich, die beiden folgenden Attribute zu setzen:
: '''genericDeviceType''': blind
: '''subType''': blindActuator

Desweiteren empfehlen sich die üblichen Homematic Attribute (wie autoReadReg, event-on-change-reading, expert) zu setzten. Weitere Informationen dazu unter [[HomeMatic#Attribute]]

==== Readings====
*'''level''' numerischer Wert der den Stand des Rollo wiedergibt. Achtung: Der Aktor kennt nicht den Stand des Rollos sondern errechnet diesen aus den Fahrzeiten. Nach einem powerUp wird ein Stand von 50% angenommen.
*'''motor''': zeigt den Zustand des Motors an, ob er steht oder in welche Richtung er fährt
*'''pct''': analog "level"

== Konfiguration==
Die Konfiguration des Devices betrifft Register und Peerings. Dies sind Werte, die zwar über FHEM gesetzt werden, aber im Device im Flash gespeichert werden.
Man kann die Devices mit Sensoren und Tastern [[Peering (HomeMatic)|peeren]]

===Fahrzeiten kalibrieren===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese 3 Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden

=== Tasterverhalten ===
Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung:

* Die internen Taster sichtbar schalten und die config abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (alte Variante via Register)
set <device> regBulk RegL_03:self01 0B:94 0D:63 8B:94
set <device> regBulk RegL_03:self02 0B:18 0D:63 8B:18

* Die Taster konfigurieren (neue Variante via Template, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self02:short
set <HMinfo> templateSet <device> BlStopDnSh self01:short
set <device> getConfig

* Die internen Taster unsichtbar schalten und die config überprüfen
set <device> regSet intKeyVisib invisib
set <device> getConfig

Wichtig: bei der alten Variante nach jedem Schritt jeweils die Anlern-Taste drücken und in den Internals schauen ob die kommandos ohne Fehler abgearbeitet wurden.

== Mögliche Schaltoperationen ==

Der Aktor versteht folgende Befehle:
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors.
set <name> <Prozentangabe[0 bis 100]> -> Öffnet die Jalousie auf absolut prozentuale Öffnungsposition, berechnet aus definierter Laufzeit.
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%

== Log-Auszug ==
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:
2013.02.26 07:00:12 2: CUL_HM set WZ_Rollo_Rechts on rxt:1

== Mögliche Hardwaredefekte ==

Wenn der Rolladenaktor nur noch lokal reagiert oder den Rolladen nur für ein kurzes Stück fährt und aus FHEM nur mit fortgesetzten Schwierigkeiten zu erreichen ist, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C26. (Einen vergleichbarer Defekt tritt auch häufig beim Schaltaktor [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf.)

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, Rastermaß (RM) 2,5 (mm) radial (stehend), 10µ/25V (Ersatz mit höherer Spannung natürlich unproblematisch möglich). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L21) und der Diode D20. Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

''Hinweis:'' In jüngerer Zeit setzt ELV offenbar auf geänderte Bauteile: Auf der ELV Seite für den Bausatz des ähnlich aufgebauten [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] findet sich ein Hinweis, Kondensatoren anders zu bestücken:

"Folgende Kondensatoren sind abweichend zur Bedienungsanleitung Version 1.7 wie folgt zu bestücken:
* C3 und C11 10µF/25V (kleine Bauform)
* C22 und '''C26''' 10µF/35V"
Der Einsatz von Kondensatoren mit höherer Spannungsfestigkeit ist kein Problem, solange der Platz dafür reicht. Wenn möglich, ist ein Exemplar mit niedrigem Serienwiderstand und hoher Temperaturfestigkeit zu bevorzugen. Zum alternativen Einsatz von keramischen Vielschichtkondensatoren an dieser Stelle liegen noch keine Praxiserfahrungen vor.

== Links ==
* [http://www.elv-downloads.de/Assets/Produkte/10/1030/103038/Downloads/103038_FunkRollladenaktor_um.pdf Bedienungsanleitung (PDF)]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]
[[Kategorie:868MHz]]

HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach

2020-05-03T17:28:55Z

Pfriemler: /* Mögliche Hardwaredefekte */ kleine Verbesserungen

{{Infobox Hardware|Bild=HM-LC-Sw1PBU-FM_Front.jpg
|Bildbeschreibung=HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach für Markenschalter
|HWProtocol=HomeMatic
|HWType=Aktor / Sender
|HWCategory=HomeMatic
|HWComm=868,3MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=0,5W (Standby)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=eQ-3}}

[[HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach]] ist ein einkanaliger Funk-Schaltaktor "für Markenschalter", der mittels entsprechender Installationsadapter mit Tasterwippen diverser renommierter Hersteller versehen werden kann und sich dadurch nahtlos in bestehende Elektroinstallationen einfügt.

== Features ==
Das besondere an diesem Schalter ist, dass er den vorhandenen Unterputzeinsatz vollständig ersetzt. Dabei kann die Wippe des vorhandenen Schalters - je nach Hersteller - mit einer entsprechenden Adapterplatte weiterverwendet werden.

Es handelt sich hierbei nur um einen Aktor. Es ist nicht möglich die Taster mit anderen Homematic Geräten zu peeren. Man kann nur andere Taster mit dem Aktor peeren und diesen fernsteuern.

== Technische Daten ==

{|
| Art
| Unterputz
|-
| Typ
| 1fach
|-
| Stand-by-Verbrauch
| 0,5 W (lt. Bedienungsanleitung, S. 31, Stand 02/2012, 1 W)
|-
| Versorgungsspannung
| 230 V
|-
| Abmessungen (B x H x T)
| 71 x 71 x 37 mm
|-
| Farbe
| Grau
|-
| Max. Schaltleistung
| 1000 W
|-
| Relaistyp
| Wechsler
|-
| Funkfrequenz
| 868,3 MHz
|-
| Empfängerklasse
| SRD Class 2
|-
| Sicherung (intern)
| Rundsicherung 5 A, träge
|-
| Max. Sendeleistung
| 10 mW
|-
| IP-Schutzgrad
| IP 20
|-
| Umgebungstemperaturbereich
| 5–35 °C
|}

== Hinweise zur Hardware-Installation ==
Der vorhandene Schalter muss ersetzt werden. Dabei sind ein paar Dinge zu beachten:

* Der (neue) Schalter benötigt neben dem L-Leiter auch einen N-Leiter für die Stromversorgung.
* Die Befestigung ist nicht wie bei dem System z.B. von Merten durch Spreizen von Klammern möglich. Der Schalter muss in die Löcher in der Dose geschraubt werden (Schrauben im Lieferumfang enthalten).
* Die "Frontplatte" bzw. der Befestigungsrahmen ist etwas dicker als der Rahmen eines normalen Schalters. Dadurch kann es sein, dass der vorhandene Rahmen des Schalters nicht mehr ganz an der Wand anliegt.
* Um die bereits vorhandene Schalter-Wippe weiter nutzen zu können, muss ein passender Adapter verwendet werden.

{{Randnotiz|RNText='''Info zum Bausatz'''
Das Gerät ist als Bausatz verfügbar, es sind die folgenden bedrahteten Bauteile einzulöten:
* 6 Kondensatoren
* 3 Stiftleisten/Fassungen (insgesamt 16 Pole)
* 1 Spannungsregler, 1 Diode
* 1 Relais (8 Pole)
* 1 Induktivität
* 1 Widerstand, 1 Varistor
Die zu lötenden Bauteile sind relativ unproblematisch, die Lötstellen befinden sich jedoch in drei Fällen sehr nah an bzw. zwischen vorbestückten SMD-Bauteilen.}}
== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:

<pre>
define LichtWohnzimmer CUL_HM 197764
attr LichtWohnzimmer devInfo 010100
attr LichtWohnzimmer firmware 2.1
attr LichtWohnzimmer hmClass receiver
attr LichtWohnzimmer model unknown
attr LichtWohnzimmer room Wohnzimmer
attr LichtWohnzimmer serialNr JEQ0xxxxxx
attr LichtWohnzimmer subType switch
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet
</pre>

Zusätzliche Funktionen wie ein direkter Zugriff auf die integrierten Taster (self01 und self02) des Schalters können durch Programmieren der [[HomeMatic_Register_programmieren | HomeMatic Register]] realisiert werden.

Dabei entspricht self01 dem Ausschalter des Wippschalters und self02 dem Einschalter des Wippschalters. Settings, die man also für den self01 Schalter einstellt, werden beim Ausschalten des Lichts (im Standard) angewandt und umgekehrt.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-Sw1PBU-FM folgendes Log zu sehen:
<pre>
2012-06-05_00:09:22 LichtWohnzimmer deviceMsg: off
2012-06-05_00:09:22 LichtWohnzimmer off
2012-06-05_07:40:51 LichtWohnzimmer on
2012-06-05_07:40:51 LichtWohnzimmer deviceMsg: on
</pre>

Beim Einrichten des Schalters kommt folgender Auszug (Stand: 06.2012)
<pre>
2012.06.04 23:12:27 2: CUL_HM pair: CUL_HM_switch_197764 is a switch, model unknown serialNr JEQ0xxxxxx
</pre>

=== Funktion als Treppenlichtschalter ===
Um dafür zu sorgen, dass z.B. ein durch den HM-LC-Sw1PBU-FM eingeschaltetes Licht automatisch von FHEM nach 10 Minuten ausgeschaltet wird, kann folgende Definition verwendet werden:
:<code>define Beleuchtung_an notify Beleuchtung:on* define Beleuchtung_aus at +00:10:00 set Beleuchtung off </code>
Das Licht kann auch direkt über den Schalter nach 10 Minuten ausgeschaltet werden. Dies hat den Vorteil, dass die Funktion auch ohne FHEM funktioniert und keinen Funkverkehr verursacht. Wert ist in Sekunden also 60*10 für 10 Minuten. Es gibt zwei Schaltoperationen long press (lg) und short press (sh), short press ist ein kurzes antippen, long press ist den Schalter für ca. 1 Sekunde oder mehr gedrückt halten.
set <device> regSet shOnTime 600 self01
set <device> regSet lgOnTime 600 self01
set <device> regSet shOnTime 600 self02
set <device> regSet lgOnTime 600 self02

=== Workaround um den Taster in FHEM zu nutzen ===
Man kann den Taster in der Originalfirmware nicht mit anderen Geräten peeren. Allerdings kann man mit folgendem Workaround den Taster in FHEM nutzen. Das hat jedoch eine Verzögerung zwischen drei und acht Sekunden zur Folge. Dabei ist es trotzdem möglich, den Aktor per FHEM oder gepeertem Gerät weiter zu steuern. Der Taster beeinflusst den Aktor nicht mehr. Das ganze funktioniert, weil der HM-LC-Sw1PBU-FM bei jedem Tastendruck das reading für state aktualisiert, auch wenn sich der Wert nicht ändert.

Zuerst setzt man ein event auf event-on-change-reading:

attr HM-LC-Sw1PBU-FM event-on-change-reading state
attr HM-LC-Sw1PBU-FM event-on-update-reading state

Weiterhin wird der Schalter deaktiviert (hier nur für kurzen Tastendruck; mit lgSwJtXXX wird dieser Effekt auch für den langen Tastendruck erzielt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOn on self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self02
set HM-LC-Sw1PBU-FM regSet exec shSwJtOn on self02

Nun setzt man einen Notify auf das Reading:
:<code>define HM-LC-Sw1PBU-FM-TasterPressed notify HM-LC-Sw1PBU-FM {set YourOtherDevice toggle}</code>

=== Alternative Firmware ===
Um die beiden Taster als Remote und den Aktor getrennt zu nutzen gibt es alternative Firmware, deren Funktion und Benutzung auf der Seite [[HM-LC-Sw1PBU-FM Alternative Firmware]] im Detail beschrieben ist.

=== Schalter immer toggeln lassen ===
Im Werkszustand schaltet die Wippe bei Druck auf der einen Seite ein, auf der anderen Seite aus. Möchte man, dass bei jedem Tastendruck einfach der Zustand geändert wird, kann man das wie folgt erreichen (unten nur für den kurzen Tastendruck dargestellt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self01
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self01
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self01
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self02
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self02
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self02

Um den Werkszustand bezüglich Schaltwippe wiederherzustellen (eine Seite schaltet aus, die andere wieder ein) entsprechen folgende Einstellungen dem Werkszustand:
set <device> regSet shSwJtOn dlyOff self01
set <device> regSet shSwJtOff off self01
set <device> regSet shSwJtDlyOn off self01
set <device> regSet shSwJtDlyOff off self01
set <device> regSet shSwJtOn on self02
set <device> regSet shSwJtOff dlyOn self02
set <device> regSet shSwJtDlyOn on self02
set <device> regSet shSwJtDlyOff on self02

=== on-for-timer Ersatz ===
Der HM-LC-Sw1PBU-FM kennt kein <code>set on-for-timer</code>. Um den HM-LC-Sw1PBU-FM trotzdem für einige Zeit anschalten zu können (z. B. wenn ein Fensteröffner dranhängt und das Fenster nur für eine gewisse Zeit geöffnet werden soll), muss ein Button der vccu mit dem HM-LC-Sw1PBU-FM gepeered werden:
set vccu_Btn4 peerChan 0 HM-LC-Sw1PBU-FM dual set

Danach wären (in diesem Fall mit vccu_Btn4) die virtuellen Buttons 4 und 5 mit dem HM-LC-Sw1PBU-FM gepeered. Das Fenster könnte dann über <code>set vccu_Btn4 press short</code> für die vorher über <code>set HM-LC-Sw1PBU-FM regSet shOnTime [Dauer] vccu_Btn4</code> die Öffnungszeit eingestellt werden kann.

== Mögliche Hardwaredefekte ==

Wenn der Schalter zwischendurch immer wieder neu startet, bei lokaler Bedienung sofort wieder ausschaltet und aus FHEM kaum oder nicht ansprechbar und auch auf verknüpfte Sender nicht reagiert, kann ein Kondensator defekt sein, hier C26. (Ein vergleichbarer Defekt tritt auch häufig beim Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, Rastermaß (RM) 2,5 (mm) radial (stehend), 10µ/25V (Ersatz mit höherer Spannung natürlich unproblematisch möglich). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen neben einer Spule (L21). Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

In jüngerer Zeit setzt ELV offenbar auf geänderte Bauteile: Auf der ELV Seite für den Bausatz findet sich ein Hinweis Kondensatoren anders zu bestücken:

"Folgende Kondensatoren sind abweichend zur Bedienungsanleitung Version 1.7 wie folgt zu bestücken:
* C3 und C11 10µF/25V (kleine Bauform)
* C22 und C26 10µF/35V"
Der Einsatz von Kondensatoren mit höherer Spannungsfestigkeit ist kein Problem, solange der Platz dafür reicht. Wenn möglich, ist ein Exemplar mit niedrigem Serienwiderstand und hoher Temperaturfestigkeit zu bevorzugen. Zum alternativen Einsatz von keramischen Vielschichtkondensatoren an dieser Stelle liegen noch keine Praxiserfahrungen vor.

== Links ==
* Anleitung (PDF {{DocLink|elv|/Assets/Produkte/10/1030/103029/Downloads/103029_FunkSchaltaktor_um.pdf}})
* Produktwebseite bei [http://www.elv.de/output/controller.aspx?cid=74&detail=10&detail2=37991 ELV]
* [[HM-LC-Sw1PBU-FM Alternative_Firmware|Alternative Firmware]]

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

HM-LC-BL1-FM Funk-Jalousieaktor

2020-04-26T13:33:21Z

Pfriemler: Hinweis auf mögliche Fehlbedienungen bei längerem Tastendruck, Trennung der beiden Einstellungen für das Tasterverhalten

{{Infobox Hardware
|Bild=HM-LC-BL1-FM-Ansicht.jpeg
|Bildbeschreibung=HomeMatic Unterputz Funk Rollladenaktor
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=<0,5W (Ruhebetrieb)
|HWPoweredBy=Netz
|HWSize=53x53x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

Homematic Funk-Jalousieaktor 1-fach (Unterputz)

== Features ==
Schalten eines angeschlossenen Jalousiemotors mittels [[CUL]]/CUN/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

'''Technische Daten:'''
* Schaltvermögen: 250W Motorlast 230V/50Hz
* Relais: 1x Schließer und 1 Wechsler
* Standby Verbrauch: 0,5W
* Maße(BxHxT): 53x53x30mm

== Installation ==
Will man die Funk-Schaltaktoren auch manuell betreiben, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zum Taster umgebaut werden, Tastschalter oder Schalter sind nicht geeignet, da die Funktion sonst dauerhaft gestört sein kann.

Um zu verhindern, dass der Aktor bei längerer Betätigung eines Tasters versehentlich in den Anlernmodus versetzt oder gar zurückgesetzt wird, muss das Register ''confBtnTime'' geändert werden. Die nötige Änderung ist im Absatz '''Tasterverhalten''' beschrieben.

Je nach vorhandenen Schalterdosen empfiehlt es sich, bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ kann der Aktor auch in einer zusätzlichen Schalterdosen untergebracht und diese mit einem Federdeckel verschlossen werden. Dies hat den Vorteil, dass auch durch eine relativ dicke Tapete die LED und somit der Zustand des Aktors erkannt werden kann.

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt oder es erfolgt über FHEM mittels der Seriennummer.

=== Konfiguration ===
Ein exemplarischer Auszug aus der [[Konfiguration]] (fhem.cfg):

<pre>
define JalousieWohnzimmer CUL_HM 17E43C
attr JalousieWohnzimmer devInfo 010100
attr JalousieWohnzimmer firmware 1.5
attr JalousieWohnzimmer hmClass receiver
attr JalousieWohnzimmer model HM-LC-BL1-FM
attr JalousieWohnzimmer room Wohnzimmer
attr JalousieWohnzimmer serialNr IEQ0xxxxxx
attr JalousieWohnzimmer subType blindActuator
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet. Im Falle der 10% geöffneten Jalousie wird diese geschlossen.
set <name> <Zweistellige Zahl> -> Schaltet den Aktor ein und öffnet die Jalousie um <Zweistellige Zahl>%. 100% entspricht dabei einem "on"
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%
</pre>

=== Fahrtzeiten kalibrieren ===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen, um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese drei Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:

<pre>
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden
</pre>

Ob alles geklappt hat, kann überprüft werden mit:
<pre>
set <name> getConfig
get <name> reg all
</pre>
Dort sollten dann die Werte stehen, z.B.
<pre>
WZ_Jal_Rechts type:blindActuator -
list:peer register :value
0: intKeyVisib :invisib
0: pairCentral :0xE1F88A
1: driveDown :27 s
1: driveTurn :0.5 s
1: driveUp :27 s
1: refRunCounter :0
1: sign :off
</pre>

Wenn ihr die Konfiguration des Schalters für Euch als Textdatei speichern wollt, dann hilft Euch ein
:<code>get <name> saveConfig <dateiname></code>

Das legt dann eine Datei in Eurem fhem-"root" Verzeichnis ab, in der alle Werte stehen.

=== Tasterverhalten ===

==== Verhinderung von Fehlbedienungen bei längerem Tastendruck ====

Wie oben beschrieben führt eine dauerhafte Ansteuerung der Eingänge durch einen Schalter oder ein sehr langer Tastendruck (länger als 4 Sekunden) normalerweise dazu, dass der Aktor in den Anlernmodus versetzt wird. Es ist jedoch auch möglich, ein dem [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor|HM-LC-Bl1PBU-FM]] oder einem gepeerten Taster gleiches Tasterverhalten einzustellen (langes Drücken fährt dann den Rolladen nur so lange wie man drückt). Dazu begrenzt man die Verfügbarkeit des Anlernmodus auf eine wählbare Zeit (in Minuten) nach dem Einschalten des Stromes. Nach dieser Zeit ist der Anlernmodus gesperrt und kurze und längere Tastendrücke resultieren dann in unterschiedlichem Fahrverhalten.
set <device> regSet confBtnTime 5
Benötigt man den lokalen Anlernmodus wieder, so reicht es, den Aktor stromlos zu machen (Ausschalten der betreffenden Sicherung). Danach steht im obigen Beispiel der Anlernmodus durch langen Tastendruck in den ersten fünf Minuten zur Verfügung.
set <device> regSet confBtnTime permanent
macht die Änderung rückgängig.

==== Verbesserung der Bedienung zum Stoppen des laufenden Antriebs ====

Ab Werk kann der durch einen kurzen Tastendruck gestartete Rolladen vor dem Erreichen der Endlage nur durch einen Tastendruck auf die entgegengesetzte Richtung gestoppt werden. Üblich bei vielen Rolladenantrieben sind aber beliebige kurze Tastendrücke. Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung, ist folgendermaßen vorzugehen:

* Wenn noch nicht geschehen, die internen Taster sichtbar schalten und die aktuelle Konfiguration abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (Nutzung von Templates, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self01:short
set <HMinfo> templateSet <device> BlStopDnSh self02:short
set <device> getConfig

* nun ggf. die internen Taster wieder unsichtbar schalten und die Konfiguration in FHEM aktualisieren
set <device> regSet intKeyVisib invisib
set <device> getConfig

''Hinweis: Dies entspricht dem Vorgehen beim [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor#Tasterverhalten|HM-LC-Bl1PBU-FM]], allerdings ist zu beachten, dass Ausgänge und Tasten bei diesem Aktor vertauscht sind, entsprechend sind die Templates auf die richtigen internen Tasten anzuwenden, wie oben beschrieben. Die Templates definieren (bzw. korrigieren) das gesamte Tasterverhalten auf Werkseinstellung, zusätzlich wird die sog. Sprungtabelle modifiziert, so dass ein fahrender Rolladen gestoppt wird (aufwärts: BlJtRampOn: rampOn -> on, abwärts: BlJtRampOff: rampoff -> off)''

=== Peeren mit einem HM-PB-2-WM55 ===

Um bei einem Ausfall von FHEM den Rollladenaktor ersatzweise mit einem Schalter bedienen zu können, kann auch ein [[HM-PB-2-WM55_2fach-Funk-Wandtaster|HM-PB-2-WM55]] gewählt werden, der direkt mit dem Rolladenaktor [[Peering (HomeMatic)|gepeert]] wird.

Mittels des Befehls

set <HM-PB-2-WM55>_01 peerChan 0 <HM-LC-BL1-FM>

werden gleich beide Taster (rauf/runter) mit dem Rolladenaktor gepeert. Der Channel 02 des Tasters übernimmt dann die Rauf-Funktion, der Channel 01 die Runter-Funktion. Mittels kurzem Druck des entsprechenden Tasters wird der Rolladen komplett hoch- bzw. runtergefahren (stopp mit dem jeweils anderen Taster). Ein langer Druck erzeugt eine Fahrt des Rolladen in die gewünschte Richtung '''für die Dauer''' des Tastendrucks.

Wünscht man das Stoppen des Rolladens bei kurzem Tastendruck auf eine beliebige Taste wie im Abschnitt zuvor beschrieben, dann ist entsprechend vorzugehen. Allerdings sind dann statt "self01" der Name des Kanals für die Aufwärtsfahrt und statt "self02" der Name des Kanals für die Abwärtsfahrt anzugeben.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:

<pre>
2012.02.12 17:53:08 2: CUL_HM set JalousieWohnzimmer on
2012.02.12 17:53:09 2: CUL_HM set JalousieWohnzimmer off
2012.02.12 21:25:14 2: CUL_HM set JalousieWohnzimmer 37
</pre>

= Links =
* [[Jalousie und Beleuchtung in mehreren Räumen]]
* [[Slider für HM-Rollladensteuerung anzeigen]]
* Bedienungsanleitung {{DocLink|elv|/service/manuals/76793_HM_Unterputzschalter_UM.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]
[[Kategorie:868MHz]]

HM-LC-BL1-FM Funk-Jalousieaktor

2020-04-26T13:25:56Z

Pfriemler: /* Installation */

{{Infobox Hardware
|Bild=HM-LC-BL1-FM-Ansicht.jpeg
|Bildbeschreibung=HomeMatic Unterputz Funk Rollladenaktor
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=<0,5W (Ruhebetrieb)
|HWPoweredBy=Netz
|HWSize=53x53x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

Homematic Funk-Jalousieaktor 1-fach (Unterputz)

== Features ==
Schalten eines angeschlossenen Jalousiemotors mittels [[CUL]]/CUN/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

'''Technische Daten:'''
* Schaltvermögen: 250W Motorlast 230V/50Hz
* Relais: 1x Schließer und 1 Wechsler
* Standby Verbrauch: 0,5W
* Maße(BxHxT): 53x53x30mm

== Installation ==
Will man die Funk-Schaltaktoren auch manuell betreiben, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zum Taster umgebaut werden, Tastschalter oder Schalter sind nicht geeignet, da die Funktion sonst dauerhaft gestört sein kann.

Um zu verhindern, dass der Aktor bei längerer Betätigung eines Tasters versehentlich in den Anlernmodus versetzt oder gar zurückgesetzt wird, muss das Register ''confBtnTime'' geändert werden. Die nötige Änderung ist im Absatz '''Tasterverhalten''' beschrieben.

Je nach vorhandenen Schalterdosen empfiehlt es sich, bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ kann der Aktor auch in einer zusätzlichen Schalterdosen untergebracht und diese mit einem Federdeckel verschlossen werden. Dies hat den Vorteil, dass auch durch eine relativ dicke Tapete die LED und somit der Zustand des Aktors erkannt werden kann.

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt oder es erfolgt über FHEM mittels der Seriennummer.

=== Konfiguration ===
Ein exemplarischer Auszug aus der [[Konfiguration]] (fhem.cfg):

<pre>
define JalousieWohnzimmer CUL_HM 17E43C
attr JalousieWohnzimmer devInfo 010100
attr JalousieWohnzimmer firmware 1.5
attr JalousieWohnzimmer hmClass receiver
attr JalousieWohnzimmer model HM-LC-BL1-FM
attr JalousieWohnzimmer room Wohnzimmer
attr JalousieWohnzimmer serialNr IEQ0xxxxxx
attr JalousieWohnzimmer subType blindActuator
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet. Im Falle der 10% geöffneten Jalousie wird diese geschlossen.
set <name> <Zweistellige Zahl> -> Schaltet den Aktor ein und öffnet die Jalousie um <Zweistellige Zahl>%. 100% entspricht dabei einem "on"
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%
</pre>

=== Fahrtzeiten kalibrieren ===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen, um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese drei Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:

<pre>
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden
</pre>

Ob alles geklappt hat, kann überprüft werden mit:
<pre>
set <name> getConfig
get <name> reg all
</pre>
Dort sollten dann die Werte stehen, z.B.
<pre>
WZ_Jal_Rechts type:blindActuator -
list:peer register :value
0: intKeyVisib :invisib
0: pairCentral :0xE1F88A
1: driveDown :27 s
1: driveTurn :0.5 s
1: driveUp :27 s
1: refRunCounter :0
1: sign :off
</pre>

Wenn ihr die Konfiguration des Schalters für Euch als Textdatei speichern wollt, dann hilft Euch ein
:<code>get <name> saveConfig <dateiname></code>

Das legt dann eine Datei in Eurem fhem-"root" Verzeichnis ab, in der alle Werte stehen.

=== Tasterverhalten ===

Ab Werk kann der durch einen kurzen Tastendruck gestartete Rolladen vor dem Erreichen der Endlage nur durch einen Tastendruck auf die entgegengesetzte Richtung gestoppt werden. Üblich bei vielen Rolladenantrieben sind aber beliebige kurze Tastendrücke. Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung, ist folgendermaßen vorzugehen:

* Wenn noch nicht geschehen, die internen Taster sichtbar schalten und die aktuelle Konfiguration abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (Nutzung von Templates, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self01:short
set <HMinfo> templateSet <device> BlStopDnSh self02:short
set <device> getConfig

* nun ggf. die internen Taster wieder unsichtbar schalten und die Konfiguration in FHEM aktualisieren
set <device> regSet intKeyVisib invisib
set <device> getConfig

''Hinweis: Dies entspricht dem Vorgehen beim [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor#Tasterverhalten|HM-LC-Bl1PBU-FM]], allerdings ist zu beachten, dass Ausgänge und Tasten bei diesem Aktor vertauscht sind, entsprechend sind die Templates auf die richtigen internen Tasten anzuwenden, wie oben beschrieben. Die Templates definieren (bzw. korrigieren) das gesamte Tasterverhalten auf Werkseinstellung, zusätzlich wird die sog. Sprungtabelle modifiziert, so dass ein fahrender Rolladen gestoppt wird (aufwärts: BlJtRampOn: rampOn -> on, abwärts: BlJtRampOff: rampoff -> off)''

Wie oben beschrieben führt eine dauerhafte Ansteuerung der Eingänge durch einen Schalter oder ein sehr langer Tastendruck (länger als 4 Sekunden) normalerweise dazu, dass der Aktor in den Anlernmodus versetzt wird. Es ist jedoch auch möglich, ein dem [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor|HM-LC-Bl1PBU-FM]] oder einem gepeerten Taster gleiches Tasterverhalten einzustellen (langes Drücken fährt dann den Rolladen nur so lange wie man drückt). Dazu begrenzt man die Verfügbarkeit des Anlernmodus auf eine wählbare Zeit (in Minuten) nach dem Einschalten des Stromes. Nach dieser Zeit ist der Anlernmodus gesperrt und kurze und längere Tastendrücke resultieren dann in unterschiedlichem Fahrverhalten.
set <device> regSet confBtnTime 5
Benötigt man den lokalen Anlernmodus wieder, so reicht es, den Aktor stromlos zu machen (Ausschalten der betreffenden Sicherung). Danach steht im obigen Beispiel der Anlernmodus durch langen Tastendruck in den ersten fünf Minuten zur Verfügung.
set <device> regSet confBtnTime permanent
macht die Änderung rückgängig.

=== Peeren mit einem HM-PB-2-WM55 ===

Um bei einem Ausfall von FHEM den Rollladenaktor ersatzweise mit einem Schalter bedienen zu können, kann auch ein [[HM-PB-2-WM55_2fach-Funk-Wandtaster|HM-PB-2-WM55]] gewählt werden, der direkt mit dem Rolladenaktor [[Peering (HomeMatic)|gepeert]] wird.

Mittels des Befehls

set <HM-PB-2-WM55>_01 peerChan 0 <HM-LC-BL1-FM>

werden gleich beide Taster (rauf/runter) mit dem Rolladenaktor gepeert. Der Channel 02 des Tasters übernimmt dann die Rauf-Funktion, der Channel 01 die Runter-Funktion. Mittels kurzem Druck des entsprechenden Tasters wird der Rolladen komplett hoch- bzw. runtergefahren (stopp mit dem jeweils anderen Taster). Ein langer Druck erzeugt eine Fahrt des Rolladen in die gewünschte Richtung '''für die Dauer''' des Tastendrucks.

Wünscht man das Stoppen des Rolladens bei kurzem Tastendruck auf eine beliebige Taste wie im Abschnitt zuvor beschrieben, dann ist entsprechend vorzugehen. Allerdings sind dann statt "self01" der Name des Kanals für die Aufwärtsfahrt und statt "self02" der Name des Kanals für die Abwärtsfahrt anzugeben.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:

<pre>
2012.02.12 17:53:08 2: CUL_HM set JalousieWohnzimmer on
2012.02.12 17:53:09 2: CUL_HM set JalousieWohnzimmer off
2012.02.12 21:25:14 2: CUL_HM set JalousieWohnzimmer 37
</pre>

= Links =
* [[Jalousie und Beleuchtung in mehreren Räumen]]
* [[Slider für HM-Rollladensteuerung anzeigen]]
* Bedienungsanleitung {{DocLink|elv|/service/manuals/76793_HM_Unterputzschalter_UM.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]
[[Kategorie:868MHz]]

HM-LC-BL1-FM Funk-Jalousieaktor

2020-04-26T13:25:38Z

Pfriemler: /* Installation */ Hinweis auf notwendige Registeränderung gegen Fehlbedienung

{{Infobox Hardware
|Bild=HM-LC-BL1-FM-Ansicht.jpeg
|Bildbeschreibung=HomeMatic Unterputz Funk Rollladenaktor
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=<0,5W (Ruhebetrieb)
|HWPoweredBy=Netz
|HWSize=53x53x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

Homematic Funk-Jalousieaktor 1-fach (Unterputz)

== Features ==
Schalten eines angeschlossenen Jalousiemotors mittels [[CUL]]/CUN/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

'''Technische Daten:'''
* Schaltvermögen: 250W Motorlast 230V/50Hz
* Relais: 1x Schließer und 1 Wechsler
* Standby Verbrauch: 0,5W
* Maße(BxHxT): 53x53x30mm

== Installation ==
Will man die Funk-Schaltaktoren auch manuell betreiben, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zum Taster umgebaut werden, Tastschalter oder Schalter sind nicht geeignet, da die Funktion sonst dauerhaft gestört sein kann.

Um zu verhindern, dass der Aktor bei längerer Betätigung eines Tasters versehentlich in den Anlernmodus versetzt oder gar zurückgesetzt wird, muss das Register ''confBtnTime'' geändert werden. Die nötige Änderung ist im Absatz '''Tasterverhalten''' beschrieben

Je nach vorhandenen Schalterdosen empfiehlt es sich, bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ kann der Aktor auch in einer zusätzlichen Schalterdosen untergebracht und diese mit einem Federdeckel verschlossen werden. Dies hat den Vorteil, dass auch durch eine relativ dicke Tapete die LED und somit der Zustand des Aktors erkannt werden kann.

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt oder es erfolgt über FHEM mittels der Seriennummer.

=== Konfiguration ===
Ein exemplarischer Auszug aus der [[Konfiguration]] (fhem.cfg):

<pre>
define JalousieWohnzimmer CUL_HM 17E43C
attr JalousieWohnzimmer devInfo 010100
attr JalousieWohnzimmer firmware 1.5
attr JalousieWohnzimmer hmClass receiver
attr JalousieWohnzimmer model HM-LC-BL1-FM
attr JalousieWohnzimmer room Wohnzimmer
attr JalousieWohnzimmer serialNr IEQ0xxxxxx
attr JalousieWohnzimmer subType blindActuator
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet. Im Falle der 10% geöffneten Jalousie wird diese geschlossen.
set <name> <Zweistellige Zahl> -> Schaltet den Aktor ein und öffnet die Jalousie um <Zweistellige Zahl>%. 100% entspricht dabei einem "on"
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%
</pre>

=== Fahrtzeiten kalibrieren ===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen, um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese drei Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:

<pre>
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden
</pre>

Ob alles geklappt hat, kann überprüft werden mit:
<pre>
set <name> getConfig
get <name> reg all
</pre>
Dort sollten dann die Werte stehen, z.B.
<pre>
WZ_Jal_Rechts type:blindActuator -
list:peer register :value
0: intKeyVisib :invisib
0: pairCentral :0xE1F88A
1: driveDown :27 s
1: driveTurn :0.5 s
1: driveUp :27 s
1: refRunCounter :0
1: sign :off
</pre>

Wenn ihr die Konfiguration des Schalters für Euch als Textdatei speichern wollt, dann hilft Euch ein
:<code>get <name> saveConfig <dateiname></code>

Das legt dann eine Datei in Eurem fhem-"root" Verzeichnis ab, in der alle Werte stehen.

=== Tasterverhalten ===

Ab Werk kann der durch einen kurzen Tastendruck gestartete Rolladen vor dem Erreichen der Endlage nur durch einen Tastendruck auf die entgegengesetzte Richtung gestoppt werden. Üblich bei vielen Rolladenantrieben sind aber beliebige kurze Tastendrücke. Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung, ist folgendermaßen vorzugehen:

* Wenn noch nicht geschehen, die internen Taster sichtbar schalten und die aktuelle Konfiguration abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (Nutzung von Templates, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self01:short
set <HMinfo> templateSet <device> BlStopDnSh self02:short
set <device> getConfig

* nun ggf. die internen Taster wieder unsichtbar schalten und die Konfiguration in FHEM aktualisieren
set <device> regSet intKeyVisib invisib
set <device> getConfig

''Hinweis: Dies entspricht dem Vorgehen beim [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor#Tasterverhalten|HM-LC-Bl1PBU-FM]], allerdings ist zu beachten, dass Ausgänge und Tasten bei diesem Aktor vertauscht sind, entsprechend sind die Templates auf die richtigen internen Tasten anzuwenden, wie oben beschrieben. Die Templates definieren (bzw. korrigieren) das gesamte Tasterverhalten auf Werkseinstellung, zusätzlich wird die sog. Sprungtabelle modifiziert, so dass ein fahrender Rolladen gestoppt wird (aufwärts: BlJtRampOn: rampOn -> on, abwärts: BlJtRampOff: rampoff -> off)''

Wie oben beschrieben führt eine dauerhafte Ansteuerung der Eingänge durch einen Schalter oder ein sehr langer Tastendruck (länger als 4 Sekunden) normalerweise dazu, dass der Aktor in den Anlernmodus versetzt wird. Es ist jedoch auch möglich, ein dem [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor|HM-LC-Bl1PBU-FM]] oder einem gepeerten Taster gleiches Tasterverhalten einzustellen (langes Drücken fährt dann den Rolladen nur so lange wie man drückt). Dazu begrenzt man die Verfügbarkeit des Anlernmodus auf eine wählbare Zeit (in Minuten) nach dem Einschalten des Stromes. Nach dieser Zeit ist der Anlernmodus gesperrt und kurze und längere Tastendrücke resultieren dann in unterschiedlichem Fahrverhalten.
set <device> regSet confBtnTime 5
Benötigt man den lokalen Anlernmodus wieder, so reicht es, den Aktor stromlos zu machen (Ausschalten der betreffenden Sicherung). Danach steht im obigen Beispiel der Anlernmodus durch langen Tastendruck in den ersten fünf Minuten zur Verfügung.
set <device> regSet confBtnTime permanent
macht die Änderung rückgängig.

=== Peeren mit einem HM-PB-2-WM55 ===

Um bei einem Ausfall von FHEM den Rollladenaktor ersatzweise mit einem Schalter bedienen zu können, kann auch ein [[HM-PB-2-WM55_2fach-Funk-Wandtaster|HM-PB-2-WM55]] gewählt werden, der direkt mit dem Rolladenaktor [[Peering (HomeMatic)|gepeert]] wird.

Mittels des Befehls

set <HM-PB-2-WM55>_01 peerChan 0 <HM-LC-BL1-FM>

werden gleich beide Taster (rauf/runter) mit dem Rolladenaktor gepeert. Der Channel 02 des Tasters übernimmt dann die Rauf-Funktion, der Channel 01 die Runter-Funktion. Mittels kurzem Druck des entsprechenden Tasters wird der Rolladen komplett hoch- bzw. runtergefahren (stopp mit dem jeweils anderen Taster). Ein langer Druck erzeugt eine Fahrt des Rolladen in die gewünschte Richtung '''für die Dauer''' des Tastendrucks.

Wünscht man das Stoppen des Rolladens bei kurzem Tastendruck auf eine beliebige Taste wie im Abschnitt zuvor beschrieben, dann ist entsprechend vorzugehen. Allerdings sind dann statt "self01" der Name des Kanals für die Aufwärtsfahrt und statt "self02" der Name des Kanals für die Abwärtsfahrt anzugeben.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:

<pre>
2012.02.12 17:53:08 2: CUL_HM set JalousieWohnzimmer on
2012.02.12 17:53:09 2: CUL_HM set JalousieWohnzimmer off
2012.02.12 21:25:14 2: CUL_HM set JalousieWohnzimmer 37
</pre>

= Links =
* [[Jalousie und Beleuchtung in mehreren Räumen]]
* [[Slider für HM-Rollladensteuerung anzeigen]]
* Bedienungsanleitung {{DocLink|elv|/service/manuals/76793_HM_Unterputzschalter_UM.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]
[[Kategorie:868MHz]]

Fehlerteufel

2019-10-07T18:11:04Z

Pfriemler: /* Rechtschreibung, Grammatik und Begrifflichkeiten */ Höfliche Anrede "Sie" durch korrektes Pronomen "sie" ersetzt

Auch wenn Rechtschreibung und Grammatik auf dem Rückzug sind, sollten wir zur Klarheit und Lesbarkeit der Dokumentation bestimmte Fehler vermeiden.
==Rechtschreibung, Grammatik und Begrifflichkeiten==
{|class="wikitable"
!|Fehler
!Korrektur
!Warum
|-
|'''Event monitor'''||Eventmonitor||[https://www.duden.de/sprachwissen/sprachratgeber/Zusammengesetzte-Substantive Zusammengesetzte Substantive] werden zusammengeschrieben, auch wenn sie aus einer Fremdsprache stammen.
|-
|'''Hacken'''||Haken||Wir setzen einen Haken - Bäume werden abgehackt
|-
|'''Packet'''||Paket||
|-
|'''Pearl'''||Perl||FHEM ist in Perl geschrieben, bei ''Pearl'' handelt es sich um eine '''andere''' Programmiersprache, einen Versandhandel, ein im Januar 1971 erschienenes Album von Janis Joplin oder sonst irgend etwas, das mit FHEM wenig zu tun hat.
|-
|'''Rolllade''' (oder schlimmer: Rollade)||Rollladen||DER Rollladen
|-
|'''Stati'''||Status||Die [https://de.wiktionary.org/wiki/Status Mehrzahl von Status] ist Status (mit etwas anderer Aussprache)
|-
|'''Standart'''||Standard||
|}

==Zeichensetzung==
{|class="wikitable"
!|Fehler
!Korrektur
!Warum
|-
|'''Handy's'''||Handys||Das Deutsche verwendet bei der Bildung von Mehrzahl oder Genitiv keinen Apostroph
|-
|'''Plenken'''||||Satzzeichen stehen niemals [https://de.wikipedia.org/wiki/Plenk getrennt] am Ende eines Satzes.
|}

[[Kategorie:Dokumentation]]

HomeMatic Register programmieren

2019-09-29T08:03:53Z

Pfriemler: /* WARNUNG! - Selbsttätiges Blinken eines HM-Aktors */

{{Baustelle}}
Ein HomeMatic-Gerät besitzt mehr oder weniger umfangreiche Registersätze, mit denen das Verhalten des Gerätes vielfältig feinkonfiguriert werden kann. Die damit erreichbare Funktionsvielfalt geht weit über die standardisierten Vorgaben einer einfachen Direktverknüpfung ([[Peering_(HomeMatic)|Peering]]) hinaus.

== Grundlagen (in Auszügen) ==

Im folgenden werden nur exemplarisch einige Grundlagen und einfache Beispiele benannt, ohne jeden Anspruch auf Vollständigkeit.

FHEM unterstützt die Programmierung der Register mit dem Befehl ''regSet''. <peer> entfällt bei rein gerätebezogenen Programmierungen.
:<code>set <name> regSet <register> <value> [<peer>] </code>
Darüberhinaus gibt es vor- oder selbstdefinierte [[HomeMatic_HmInfo_Templates_erstellen|Templates]] (Vorlagen), die alle erforderlichen Änderungen für standardisierte Anwendungen wie Treppenhauslichtschalter beinhalten. Die Anwendung von Templates auf Geräte wird protokolliert und der Registerzustand kann überprüft werden. Für viele Anwendungen genügt jedoch auch die einmalige Anwendung einer direkten Programmierung. Das genaue Verständnis der Vorgänge und Zusammenhänge ist nicht trivial, das Erlernen wird aber mit einer enormen erreichbaren Funktionsvielfalt belohnt. Viele wissenswerte Zusammenhänge sind im Homematic-Anhang der bekannten Einsteiger-Dokumentation erläutert, deren Lektüre zu Recht immer wieder empfohlen wird. Dieser Beitrag ist auch nur als Ergänzung zu verstehen!

Die HomeMatic Aktoren (Schalter, Dimmer, ...) arbeiten so, wie es für verknüpften ([[Peering (HomeMatic)|peering]]) Sender vorgegeben ist. Sie nutzen Registersätze, die für jede Verknüpfung (peer) neu angelegt und gespeichert werden. Man kann also mit einem Taster ein- und ausschalten (toggeln), mit einem Tastenpaar gezielt ein- und ausschalten und mit einem weiteren Taster eine Zeitschaltung für 10 Sekunden starten. Dabei wird niemals der Taster oder der Schalter auf eine globale Aktion programmiert, sondern im Schalter (Aktor) die gewünschte Aktion für jeden verknüpften Taster separat gespeichert. Die auszulösende Aktion ist zudem abhängig vom aktuellen Zustand des Aktors und von der Länge des Tastendruckes (kurz oder länger - short or long).

Kleines Beispiel:
T1 schaltet S1 für 10 sec an
T2 schaltet S1 an oder aus
T3 schaltet S1 an
T4 schaltet S1 aus.

Diese Tabelle ist im Schalter S1 gespeichert.

Schaltet man mit T3 den S1 an und drückt dann nach beliebiger Zeit kurz T1 geht S1 nach weiteren 10 sec aus. Schaltet man mit T1 kurz den S1 für 10 sec an, aber innerhalb dieser Zeit mit T3 nochmal an, dann bleibt S1 nach Ablauf der 10 sec an.

Die verfügbaren Register unterscheiden sich im Gerät und in den jeweiligen Kanälen.
Eine kurze Beschreibung der Register inklusive der erlaubten Werte erhält man durch:
:<code>get <name> regList </code>
Dabei kann <name> ein Gerät oder ein separater Gerätekanal sein.

== Spezielle Register (Auswahl) ==
Im folgenden sollen einige Register vorgestellt werden, die in vielen Geräten vorhanden sind. ''Ergänzungen sind ausdrücklich erwünscht!''

=== Gerätebezogene Register ===
Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten '''List0''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_00.'' zu finden).

==== ''confBtnTime'' - Kurz oder lang und der Konfigurationsmodus ====
Nicht immer sind die internen Tasten eines Gerätes ohne weiteres mit Aktionen für kurzen und langen Tastendruck programmierbar. Bei allen Hutschienen-Aktoren sowie den Zwischensteckern (mit nur einem Bedienknopf) versetzt ein langer Tastendruck (4 Sekunden) den Schalter normalerweise in den Konfigurations- bzw. Anlern-Modus, bei den in Unterputzdosen versenkbaren Schalt- und Dimmaktoren (-FM ohne PBU in der Bezeichnung) ohne eigenen Konfigurations-Button gilt dies sogar für die zur normalen Funktion extern angeschlossenen Taster. Dieses Verhalten kann man mit dem Register ''confBtnTime'' beeinflussen. Bis zum Ablauf der dort einstellbaren Zeit (in Minuten) nach dem Versorgen mit Strom (powerUp) erreicht man den Konfigurationsmodus wie bisher, danach interpretiert der Aktor die Tastendrücke stets als kurz (short) oder lang (long). Beispiel:
:<code>set <name> regSet confBtnTime 2</code>
Möchte man den Aktor später zurücksetzen oder lokal konfigurieren, so erreicht man das ursprüngliche Verhalten in diesem Beispiel für die ersten zwei Minuten, nachdem man den Aktor (ausreichend lange) stromlos gemacht hat.

==== ''intKeyVisib'' - Interne Tasten sichtbar machen ====
Die internen "Tasten" eines Aktors (z.B. die Schaltwippe bei Wandschaltern/-tastern, der Bedienknopf bei Zwischensteckern, aber auch die angeschlossenen externen Taster bei Aktoren für Unterputzdosen oder die von außen zugängliche "Notbedientaste" etwa bei Zwischendecken-Dimmern) sind logisch ebenso mit dem Aktor verknüpft wie externe Bedienelemente wie Funkfernbedienungen oder per Funk verknüpfte Wandtaster. Ihre Betätigung wird (außer mit präparierter Firmware) zwar nicht gesendet (und kann daher von FHEM nicht "gelesen" werden), die vom Hersteller vorgesehenen Funktionen lassen sich aber genauso frei programmieren. Allerdings sind diese internen Verknüpfungen zur Vermeidung versehentlicher Programmierungen zunächst verborgen und müssen daher explizit sichtbar gemacht werden.

Dies geschieht mit
set <name> regSet intKeyVisib visib
attr <name> expert 1
Anschließend sind der oder die internen Taste(n) mit der Bezeichnung self01 (self02, ...) sichtbar und ihre Aktionen können gezielt wie bei einem externen Peer umprogrammiert werden.

Wer nun auf die Idee kommt, man könne durch entsprechendes zusätzliches peering bei mehrkanaligen Geräten die (mehreren) internen Tasten beliebig zuweisen und so raffinierte Zusatzschaltungen auslösen, muss hier enttäuscht werden: Zwar kann man tatsächlich mit peerBulk bei den Aktorkanälen zusätzliche interne Peers eintragen und programmieren und mit einer Fernauslösung aus FHEM die neuen Verknüpfungen erfolgreich nutzen - das Gerät selbst reicht die Tastenbetätigungen aber immer nur an den ursprünglich dafür vorgesehenen Kanal weiter.

==== ''ledMode'' - Funktion der Onboard-LED bei Bausätzen ====
Die (batteriebetriebenen) -PCB-Aktoren und die 8-Kanal-Module haben kleine LED an Bord, die für Diagnosezwecke hilfreich sind, einem sparsamen Betrieb aber in der Regel entgegenstehen. Sie werden daher nur bei außergewöhnlichen Zuständen wie dem Anlernmodus, einem Reset, oder auch bei niedriger Batteriespannung als Hinweis an den Anwender benutzt und sind ansonsten ab Werk deaktiviert. Bei einer Dauerstromversorgung kann aber eine Schaltzustandsanzeige oder eine Quittung über eine Befehlsaussendung nicht nur zur Diagnose hilfreich sein.

Besitzt das Gerät das Register ''ledMode'', so kann man mit
:<code>set <device> regSet ledMode on</code>
die LED auch für die "normalen" Betriebszustände aktivieren. Sie zeigen dann bei Aktoren, ob der Aktor eingeschaltet ist (blinkend, wenn eine Einschaltzeitbegrenzung aktiv ist), und bei den Sensormodulen HM-Mod-EM8(bit) zeigt die zweifarbige LED den von Fernbedienungen bekannten Sendezustand mit gelb, dem dann ein grün oder rot folgt - je nachdem ob eine Quittung angefordert ist und ob sie erfolgreich empfangen wurde.

Leider lässt sich umgekehrt die bei Wandtastern oder Fensterkontakten mitunter gewünschte Deaktivierung der LED nicht so bewerkstelligen - diese Geräte haben das entsprechende Register nicht. Da hilft nur ein Eingriff ins Gerät mit Gaffa oder schwarzem Edding...

=== Kanalbezogene Register ===
Kanalbezogene Register existieren für jeden Kanal eines Gerätes einmal und werden in der sogenannten '''List1''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_01.'' zu finden).

==== ''powerUpAction'' - Automatischer Knopfdruck bei (wiederkehrender) Stromversorgung ====
Mit diesem Register (default ''off'') kann erreicht werden, dass ein Schaltaktor nach einem Stromausfall sich bei Wiederkehr der Versorgungsspannung automatisch einschaltet. Dies ist z.B. sinnvoll für Zwischenstecker mit Messfunktion ([[HM-ES-PMSw1-Pl Funk-Schaltaktor 1-fach mit Leistungsmessung|HM-ES-PMSw1-Pl]]), wenn dieser als Langzeitmonitor etwa für Kühlgeräte verwendet wird - nach einem Stromausfall bliebe der Kühlschrank sonst aus und der Inhalt würde verderben.
:<code>set <name> regSet powerUpAction on</code>
Achtung: Das Setzen dieses Registers auf ''on'' bedeutet nicht immer einen eingeschalteten Aktor nach der Wiederkehr der Stromversorgung. Vielmehr wird nur ein ''short''-Ereignis auf den zugehörigen internen Taster ausgelöst, was nur im Normalfall zum Einschalten des Aktors führt - nicht aber wenn die Funktion dieses kurzen Tastendruckes gezielt verändert wurde, denn dann wird eben diese Aktion ausgeführt! Das gilt zum Beispiel auch für zeitlich begrenztes Einschalten. Als Alternative für eine lokale Schaltmöglichkeit bietet sich in solchen Fällen der lange Tastendruck an, sofern er vom Aktor unterstützt wird (so lässt sich die Einschaltzeit bei langem Tastendruck mit ''lgOnTime'' begrenzen). Dessen Aktion wird bei powerUp nicht ausgeführt.

=== Verknüpfungsbezogene Register ===
Diese Register sind am umfangreichsten und werden für jeden Verknüpfungspartner einzeln separat angelegt in der '''List3''' (''RegL_03.<peer>''). Die grundsätzlichen Funktionen und ihre Zusammenhänge sind ausführlich in der Einsteigerdokumentation erklärt, inklusive Skizzen für die sogenannte ''state machine''. Hier sollen daher nur die in den folgenden Beispielen verwendeten Register erklärt werden.

==== ''shOnTime'' und ''lgOnTime'' - das interne ''on-for-timer'' von Schaltern oder Dimmern ====
Die wohl populärsten Register begrenzen die Einschaltzeit eines Aktors. Um z.B. eine Steckdose für 10 sec bei Knopfdruck lokal einzuschalten kann man folgendes programmieren:
:<code>set <name> regSet shOnTime 10 self01 </code>

''shOnTime'' ist dabei das zuständige Register für die Einschaltzeit bei kurzem (sh=short) Tastendruck, entsprechend gilt ''lgOnTime'' für einen langen Tastendruck.

In den Readings werden die Register mit dem jeweiligen verknüpften Taster angezeigt, in unserem Fall also:
:<code>R-self01-shOnTime </code>

Der Defaultwert für shOnTime ist 111600 und bedeutet unendlich (von FHEM mit "unused" dargestellt), d.h. die maximale einstellbare Zeit ist 111599 sec (knapp 31 Stunden). So kann man die Zeit löschen:
:<code>set <device> regSet shOnTime 111600 self01 </code>
oder
:<code>set <device> regSet shOnTime unused self01 </code>

Übrigens gibt es diese Register auch für die Ausschaltzeit.

==== ''shCtOn'' und ''shCtOff'' - Bedingtes Schalten mit Schwellwerten ====
Fernbedienungen (im weitesten Sinne, ''remote'') von HomeMatic übermitteln je nach Betätigungsdauer ''short''- oder ''long''-Trigger. Zustandsübermittelnde Sensoren (etwa ein Fensterkontakt oder Neigungssensor sowie Bewegungsmelder) senden ausschließlich ''short'', gekoppelt mit einem Wert zwischen 0 und 200, entsprechend 0-100% in 0,5-%-Schritten. Ob ein solcher Trigger vom Aktor verarbeitet wird, kann vom gesendeten Wert abhängen.

HomeMatic kennt dazu (für jeden Peer und Triggertyp (short/long) separat) zwei Schaltschwellen Lo und Hi, die default bei 50 und 100 liegen. Ob ein Trigger in Relation zu diesen Schwellen verarbeitet wird, regeln u.a. die shCtxxx-Register. Wie auch bei den allgemeinen Schaltbedingungen stehen ''On'' und ''Off'' jeweils für den aktuellen Schaltzustand (Achtung: nicht den, der erreicht werden soll). Ihr Wert beträgt default "geLo" (greater or equal Lo), hier 50 und höher. Trigger für Werte darunter werden bei der Einstellung "ltLo" (less than Lo) verarbeitet. Diese Schwellen gibt es entsprechend auch für den Hi-Wert, also "geHi" oder "ltHi". Besonders interessant sind aber auch die Werte "outside" und "between", bezogen auf die beiden Schwellen Lo und Hi. In letzterem Fall wird der Trigger verarbeitet, wenn der Wert zwischen 50 und 100 liegt, bei "outside" entsprechend bei 0-49 oder 101-200.

Sogenannte Three-State-Sensoren wie Fensterkontakt- oder -griffsensoren senden 0 für "closed" (geschlossen), 100 für "tilted" (gekippt) und 200 für "open" (offen). Gleiches gilt für Schalterkontaktinterfaces, die den Zustand eines angeschlossenen Schaltkontaktes übermitteln. Im Grundzustand (Vergleichsbefehl auf "geLo") führt daher nur der Trigger "offen" (200) zu einer Aktion. Ändert man den Vergleichsbefehl auf "ltLo", so wird lediglich "closed" ausgewertet, bei "between" ist es "tilted". Mit "outside" führt sowohl "closed" als auch "open" zu einer Aktion.

Bei Bewegungsmeldern wird der mit übermittelte Helligkeitswert im Zusammenhang mit den (dann variabel einzustellenden) Schwellen als Kriterium für das Einschalten des Aktors mit herangezogen.

==== ''shSwJtOn'' & Co. - Was soll passieren? ====
Nachdem wir nun kennengelernt haben, wie man auswählt, '''welcher''' Anstoss von außen zu einer Aktion führt, hier ein kleiner Exkurs in die Beeinflussung, '''was''' daraufhin passieren soll. Diese Frage regelt die ''jump table'' und liefert damit das Regelwerk für die Abfolge der Aktionen, die ''state machine''. Ein HomeMatic-Aktor geht nämlich keineswegs einfach nur an oder aus. Vielmehr hangelt er sich nacheinander an einer Reihe von Zuständen entlang - auch das ist in der Einsteigerdokumentation erschöpfend beschrieben und soll hier nicht wiederholt werden. Ein Schalter durchläuft aber mindestens die Zustände
Aus > Einschaltverzögerung > Ein > Ausschaltverzögerung > Aus > (usw)
Hier soll reichen, dass am Ende jeder (Teil-)Kette in der Regel ein dauerstabiler Zustand bleibt, in der Regel ist das der Aus-Zustand und auch der Ein-Zustand, wenn dessen Laufzeit nicht durch ''shOnTime'' & Co. begrenzt ist. Ein- und Ausschaltverzögerung sind aber in der Regel 0 (Sekunden), so dass effektiv nur "Ein" und "Aus" übrig bleiben.

Das Register ''shSwJtOn'' regelt, wohin die Reise geht, wenn ein gültiger ''short''-Trigger im eingeschalteten Zustand eintrifft, sinngemäß ''...Off'' im Auszustand und ''lg...'' für die ''long''-Trigger. Für ''shSwJtOn'' ist normalerweise als nächstes die Ausschaltverzögerung "dlyOff" vorgesehen. Da die Ausschaltverzögerung in der Regel 0 ist, folgt darauf, in ''shSwJtDly'' festgelegt, "off" usw. Die Zustände bilden so quasi einen Kreis, dessen Durchlauf von außen gelegentlich "angeschubst" wird. Mit diesen Registern kann man den Kreislauf aber auch umbiegen oder sogar unterbrechen, so dass ein eintreffender Trigger eben nicht zu einer Aktion führt. Als Ziele bieten sich, quasi selbstsprechend, "on", "dlyOff", "off" und "dlyOn" an - oder eben "no", was nichts anderes bedeutet, als dass der betreffende Trigger an dieser Stelle zu keiner Aktion führt.

Bei einem Dimmer heißen die Register statt ''..Sw....'' nur ''..Dim....'' und es gibt ein paar mehr Bedingungen - die Funktion ist aber entsprechend gleich.

==== ''shOnDly'' und ''shOffDly'' - es muss nicht immer sofort sein! ====
Nicht nur welcher Anstoße welche Aktion auslöst, sondern auch wann oder wie schnell die Aktion ausgeführt wird, lässt sich in gewissen Grenzen einstellen. Die beiden genannten Register etwa regeln die Ein- oder Ausschaltverzögerung nach einem gültigen Trigger. So kann man nach einem Ausschaltbefehl einen Raum noch im Hellen verlassen, wenn das Licht noch ein paar Sekunden länger leuchtet.

Bei Dimmern gibt es zusätzlich auch bei Ein- und Ausschaltvorgängen durch eine neu eingerichtete Verknüpfung eine sogenannte Rampenzeit von 0,5 Sekunden, in der das Licht hoch- oder heruntergedimmt wird. Durch Programmierung von ''shRampOnTime'' und ''shRampOffTime'' kann man ein sehr augenschonendes langsames Ein- oder Ausschalten des Lichts wie im Kino erreichen. Zwar gibt es die Zeiten auch für long-Trigger, aber da machen sie im Normalfall wenig Sinn - der lange Tastendruck löst immer einen manuellen Dimmvorgang aus.

''(wird ergänzt)''

== Praktische Beispiele ==
Die folgenden Beispiele beschreiben nur in Kurzform die erforderlichen Aktionen. Weiterführende Informationen sind der Einsteigerdokumentation oder den o.g. Registerbeschreibungen zu entnehmen.
Übrigens: ein einmal konfigurierter Vorgang für eine Verknüpfung kann aus FHEM auch bequem fernausgelöst (bzw. simuliert) werden. Der Aktor führt dabei genau die Aktion aus, die für die benannte Verknüpfung vorgesehen ist. Der kurze Knopfdruck auf den internen Knopf eines Aktors wird beispielsweise so simuliert:
:<code>set <device> press short self01 </code>

=== Lokal bedienbarer Zeitschalter mit HomeMatic Aktoren: Pool für eine Stunde schalten ===
Ich habe einen HM-LC-SW4-DR und der channel_01 schaltet die Poolzirkulationspumpe. Dies passiert zeitgesteuert zweimal am Tag. Manchmal möchte ich im Keller diese Pumpe einfach für eine Stunde aktivieren, der Aktor ist bequem erreichbar an der Wand.
Die internen Tasten vom Hauptdevice (der Aktor hat vier Kanäle (channel), die in FHEM einzeln dargestellt werden) sichtbar machen:
set LichtKeSW1 regSet intKeyVisib visib
attr LichtKeSW1 expert 1

Jetzt sieht man im Channel 01 - LichtKeSW1_Sw01 den internen peer self01. (Channel 02 ist self02 usw.)
Also jetzt einfach die Zeit eintragen:
set LichtKeSW1 regSet shOnTime 3600 self01

Die Toggle Funktion der Taste bleibt erhalten. Ein zweiter Tastendruck schaltet die Pumpe auch sofort wieder aus. Während die Zeit läuft, blinkt die Status LED des Kanals.
Die Zeitbegrenzung funktioniert in diesem Beispiel ohne jedes Zutun von FHEM und damit auch bei einem Ausfall des Servers.

=== Es werde Licht! Automatisches Licht mit Tor oder Tür ===
Im Kühlschrank geht das Licht ja schon praktischerweise automatisch an und aus, aber es gibt auch andere Situationen, in denen ein automatisches Licht sehr nützlich sein kann - in dunklen Abstellräumen oder Garagen. Vor allem weil man nicht vergessen kann es auszuschalten, weil es auch von allein ausgeht. Eine solche Funktion, so könnte man meinen, wird ganz einfach erreicht, indem man das Licht mit einem Aktor schalten lässt und diesen mit einem Tür- oder Fensterkontakt verknüpft. Hat man die beiden dann mit ''peerChan'' verknüpft, so wird man feststellen, dass das Licht mitnichten das Gewünschte tut: es schaltet sich beim Öffnen der Tür abwechselnd ein und aus und ignoriert das Schließen der Tür komplett.

Verantwortlich für dieses "Fehlverhalten" sind die Register ''shCtOn'' und ''shCtOff''. Beide stehen nach der Verknüpfung auf "geLo". Wie bei den Registern oben erläutert, führt in diesem Fall nur die "offen"-Meldung des Türkontaktes zu einer Aktion. Das Öffnen der Tür soll den Aktor einschalten, das klappt. Das Schließen der Tür soll den eingeschalteten Aktor aber ausschalten. Also muss die Schaltbedingung im On-Zustand geändert werden (die Bezeichnungen natürlich durch die realen Namen des Schaltaktorkanals und des Türkontaktes ersetzen):
:<code>set <Schalter> regSet shCtOn ltLo <Türkontakt> </code>
Nun führt auch das Schließen der Tür wunschgemäß stets zu einem Abschalten des Lichts. ''shCtOff'' muss auf "geLo" bleiben!

Kombinieren ließe sich das noch mit einer Laufzeitbegrenzung etwa für eine Stunde - sollte man die Tür versehentlich offenlassen, so brennt das Licht nicht stundenlang. Vor allem geht das Licht dann auch aus, wenn aus welchem Grund auch immer die Schließmeldung verloren geht.
:<code>set <Schalter> regSet shOnTime 3600 <Türkontakt> </code>

=== Lampe mit Kippschalter(n) fernschalten - eindeutig oder als Wechselschaltung ===
Oft besteht der Wunsch, eine Lampe mit einem herkömmlichen Schalter (statt eines Tasters) fernzuschalten. So kann man einen herkömmlichen Schalter mit einer Schließerkontaktinterface wie dem [[HM-SCI-3-FM 3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]] ergänzen (oder einem Kanal des [[HM-MOD-EM-8 8-Kanal-Sendemodul|8-Kanal-Sendemoduls]] in der Betriebsart ''sensor'') und wiederum die Verknüpfung mit dem Lampen-Aktor setzen. Ganz ähnlich wie bei der vorgenannten Abstellraum-Aufgabe führt nun aber das Schließen des Schalters nicht zu einem Einschalten. Daher ist nun
:<code>set <Lampenaktor> regSet shCtOff ltLo <Sensorkontakt> </code>
das Mittel der Wahl, ''shCtOn'' muss dieses Mal auf "geLo" bleiben. Jetzt folgt der Aktor dem (sichtbaren) Schaltzustand des Schaltes - zumindest solange er nicht anderweitig ein- oder ausgeschaltet wird.

Nun kann man auch mehrere Schalter so mit der Lampe koppeln. Das ergibt aber keine Wechselschaltung im herkömmlichen Sinn - um eine Lampe ein- oder auszuschalten, muss man den Schalter möglicherweise einmal zusätzlich auf die aktuelle Schaltposition kippen, ehe die nächste Betätigung den gewünschten Effekt bringt. Für Wechselschaltungen bietet sich daher das Kontaktinterface [[HM-SwI-3-FM]] (oder das erwähnte 8-Kanal-Sendemodul in der Betriebsart ''switch'') an. Hier führt jede Zustands''änderung'' zu einem Schaltvorgang.

Hat man hingegen nur ein HM-SCI-3-FM zur Hand, lässt sich dieses Verhalten auch erreichen:
:<code>set <Lampenaktor> regSet shCtOn outside <Sensorkontakt> </code>
:<code>set <Lampenaktor> regSet shCtOff outside <Sensorkontakt> </code>

=== Gezieltes Schalten eines (unsichtbaren) Aktors mit nur einer Taste ===
Für so etwas braucht man gewöhnlich zwei Tasten. Koppelt man einen Schalt-Aktor mit nur einer Taste ("single" beim ''peerChan''-Kommando), so führt sowohl ein kurzer als auch ein langer Tastendruck immer nur zu einem Umschalten des Zustandes. Das ist unschön, wenn man den aktuellen Zustand nicht einsehen kann.

Üblicherweise sind die Schaltabfolgen für eine Eintasten-Verknüpfung sowohl für kurze als auch lange Betätigungen gleich (bei Dimmern wird auf langen Tastendruck hingegen abwechselnd auf- oder abgedimmt).
shSwJtOff = dlyOn # Ist Gerät aus, wird Einschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOff = dlyOn # dito, für lang
shSwJtOn = dlyOff # Ist Gerät an, wird Ausschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOn = dlyOff # dito, für lang
Hier kann man sich zunutze machen, dass man mit einem gezielten "no" oder "dlyOn" bzw. "dlyOff" im richtigen Register die Schaltfolge abbrechen oder umbiegen kann.
Möchte man das Gerät <aktor> mit einem kurzen Tastendruck auf <button> ein- und mit einem langen Tastendruck ausschalten, so ändere man:
:<code>set <aktor> regSet shSwJtOn dlyOn <button> </code>
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>
So laufen die entsprechenden Aktionen quasi ins Leere, wenn der Aktor bereits den gewünschten Zustand hat.

Den umgekehrten Effekt (lang schaltet ein, kurz aus) erreicht man entsprechend mit
:<code>set <aktor> regSet shSwJtOff dlyOff <button> </code>
:<code>set <aktor> regSet lgSwJtOn dlyOn <button> </code>

Welche Bedienhaptik man nun bevorzugt, muss man selbst entscheiden. In der Regel sollte die normale (sichere) Aktion "kurz" und die gefährlichere "lang" sein - eine PC-Stromversorgung mit einem kurzen Tastendruck versehentlich einzuschalten ist bestimmt besser als auszuschalten (das dann eben nur über lang) - für ein potentiell gefährliches Arbeitsgerät wie einen Heizofen wird es sicher andersherum sein.

Sinngemäß verwendet der Autor sozusagen eine Hälfte davon als "Sicherheitsaktion" für einen [[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach]] - der gewöhnliche Tastendruck auf die zugehörige Wippenseite schaltet den Aktor abwechselnd ein und aus, ein langer Tastendruck immer aus, dafür reicht:
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>

Übrigens: Nichts anderes wird normalerweise auch automatisch beim Verknüpfen eines Aktors mit einem Tastenpaar an der entsprechenden Stelle gemacht - ist eine Taste nur zum Ausschalten gedacht, so wird in beiden Schaltzuständen entsprechend "dlyOff" eingetragen. Als "Sprungziel" müsste aber genauso gut auch "no" funkionieren.

=== WARNUNG! - Selbsttätiges Blinken eines HM-Aktors ===
Statt einer separaten Warnleuchte kann es durchaus sinnvoll sein, eine vorhandene Lampe zu Warnzwecken periodisch ein- und auszuschalten. Leider beherrschen die HomeMatic-Aktoren keine direkt aus FHEM erreichbare Blinkfunktion (ähnlich dem on-for-timer für eine Zeitbegrenzung), und das rhythmische Ein- und Ausschalten aus FHEM erzeugt eine recht hohe Funklast.

Wir wissen aber, dass die Aktoren für jeden Peer nicht nur eine Ein-, sondern auch eine Ausschaltzeit speichern. Definiert man nun für einen Peer entsprechend beide Zeiten, so wird der Aktor bei einem Telegramm von diesem Peer sich entsprechend selbsttätig fortlaufend ein- und ausschalten. Jeder andere Schaltbefehl eines anderen Peers oder aus FHEM beendet die Schleife umgehend. So ließe sich das Blinken auch mit einer aktoreigenen Taste stoppen - oder starten, wenn man es entsprechend programmiert. Einen Zwischenstecker-Schalter beispielsweise kann man also (wenn man zuvor seine ''confBtnTime'' entsprechend setzt und so die langen Tastendrücke auswertbar macht) durch das Programmieren von ''lgOnTime'' und ''lgOffTime'' für den Peer "self01" wie gewohnt mit einem kurzen Tastendruck ein- und ausschalten und mit einem langen in den Blinkmodus versetzen.

Einen Haken hat die Sache aber: Der Aktor meldet seinen neuen Schaltzustand nach jeder Änderung mit einer gewissen Verzögerung, die man bei vielen Schaltaktoren (aber leider nicht bei allen wie etwa dem HM-Mod-Re-8) mit dem Register ''statusInfoMinDly'' tunen kann. Ändert der Aktor seinen Schaltzustand in längeren Intervallen, wird es also trotzdem wieder ein Funkfeuer geben. Ist das Delay noch nicht erreicht, erfolgt keine Zustandsübermittlung. Beim HM-Mod-Re-8 muss man also etwa unter 1 Sekunde pro Änderung bleiben.

Zum Steuern aus FHEM emfiehlt es sich, virtuelle Buttons (etwa einer VCCU oder eines virtuellen HM-Dummys) zum Ein- und Ausschalten der Blinkfunktion zu verwenden. "Opfert" man dafür zwei aufeinanderfolgende Kanäle, kann man die Aktoren mit "dual set" peeren und bekommt so einen Blink- und einen Deaktivierungsbutton ohne weitere Kopfstände. Anschließend passt man die short-Laufzeiten für den Einschaltkanal an.

Ein Beispiel für einen Dimmer (als virtuelle Buttons dienen vccu_Btn8 und vccuBtn9):

:<code>set <vccu_Btn8 peerChan 0 <dimmerkanal> dual set</code>

Nun kann man mit "set vccu_Btn9 press short" den Dimmer ein- und mit "set vccu_Btn8 press short" ausschalten. Das Blinken im Dimmer wird eingestellt mit

:<code>set dimmer regSet shOnTime 1 vccu_Btn9</code>
:<code>set dimmer regSet shOffTime 1 vccu_Btn9</code>
jeweils für die gewünschte Ein- und Ausschaltzeit.

Wird der Dimmer nun mit "set vccu_Btn9 press short" eingeschaltet, so blinkt er im 3-Sekunden-Takt: zu den jeweils 1 Sekunde Ein- und Auszeit gesellen sich noch 2x 0,5s Rampenzeit, sofern nichts anderes programmiert wurde.

Das funktioniert auch mit Schaltern: So würde 0.1 und 0.9 (Sekunden) ein kurzes Blitzen im Sekundentakt einstellen.

Natürlich kann man nun eine größere Anzahl von Aktoren mit den virtuellen Buttons peeren und so ein ganzes Feuerwerk zünden ... Eine zusätzlich zu Alarmsirenen wild blinkende Innenbeleuchtung in allen Räumen sorgt sicher für zusätzliche Aufmerksamkeit.

=== Einer nach dem Anderen! - Sequentielles Schalten mehrerer Aktoren ===
Eine großflächige Beleuchtung mit viel Leistung sollte man aus Lastgründen niemals zugleich einschalten. Auch LED-Lampen ziehen im Einschaltmoment, wennauch extrem kurz, beträchtliche Ströme, die die von gewöhnlichen Glühlampen deutlich übersteigen können. Schaltet man mehrere Aktoren gleichzeitig mit einer Taste, so hilft eine individuelle Verzögerung des Einschaltvorgangs in jedem Aktor, die Sicherung vor dem Herausfliegen zu bewahren. Oder man macht gezielt einen Effekt daraus. Der Phantasie sind wenig Grenzen gesetzt...

Hat man drei Aktoren "Aussenlicht1...3" mit dem Taster "Aussenlicht_Ein" gepeert, so erreicht man auf folgende Weise, dass sie beim Einschalten mit einer Verzögerung von jeweils einer Sekunde nacheinander einschalten.

:<code>set Aussenlicht2 regSet shOnDly 1 Aussenlicht_Ein</code>
:<code>set Aussenlicht3 regSet shOnDly 2 Aussenlicht_Ein</code>

[[Kategorie:HomeMatic Components|1toolsAndWork]]

HomeMatic Register programmieren

2019-09-29T08:01:48Z

Pfriemler: /* WARNUNG! - Selbsttätiges Blinken eines HM-Aktors */ Korrektur Codebeispiel

{{Baustelle}}
Ein HomeMatic-Gerät besitzt mehr oder weniger umfangreiche Registersätze, mit denen das Verhalten des Gerätes vielfältig feinkonfiguriert werden kann. Die damit erreichbare Funktionsvielfalt geht weit über die standardisierten Vorgaben einer einfachen Direktverknüpfung ([[Peering_(HomeMatic)|Peering]]) hinaus.

== Grundlagen (in Auszügen) ==

Im folgenden werden nur exemplarisch einige Grundlagen und einfache Beispiele benannt, ohne jeden Anspruch auf Vollständigkeit.

FHEM unterstützt die Programmierung der Register mit dem Befehl ''regSet''. <peer> entfällt bei rein gerätebezogenen Programmierungen.
:<code>set <name> regSet <register> <value> [<peer>] </code>
Darüberhinaus gibt es vor- oder selbstdefinierte [[HomeMatic_HmInfo_Templates_erstellen|Templates]] (Vorlagen), die alle erforderlichen Änderungen für standardisierte Anwendungen wie Treppenhauslichtschalter beinhalten. Die Anwendung von Templates auf Geräte wird protokolliert und der Registerzustand kann überprüft werden. Für viele Anwendungen genügt jedoch auch die einmalige Anwendung einer direkten Programmierung. Das genaue Verständnis der Vorgänge und Zusammenhänge ist nicht trivial, das Erlernen wird aber mit einer enormen erreichbaren Funktionsvielfalt belohnt. Viele wissenswerte Zusammenhänge sind im Homematic-Anhang der bekannten Einsteiger-Dokumentation erläutert, deren Lektüre zu Recht immer wieder empfohlen wird. Dieser Beitrag ist auch nur als Ergänzung zu verstehen!

Die HomeMatic Aktoren (Schalter, Dimmer, ...) arbeiten so, wie es für verknüpften ([[Peering (HomeMatic)|peering]]) Sender vorgegeben ist. Sie nutzen Registersätze, die für jede Verknüpfung (peer) neu angelegt und gespeichert werden. Man kann also mit einem Taster ein- und ausschalten (toggeln), mit einem Tastenpaar gezielt ein- und ausschalten und mit einem weiteren Taster eine Zeitschaltung für 10 Sekunden starten. Dabei wird niemals der Taster oder der Schalter auf eine globale Aktion programmiert, sondern im Schalter (Aktor) die gewünschte Aktion für jeden verknüpften Taster separat gespeichert. Die auszulösende Aktion ist zudem abhängig vom aktuellen Zustand des Aktors und von der Länge des Tastendruckes (kurz oder länger - short or long).

Kleines Beispiel:
T1 schaltet S1 für 10 sec an
T2 schaltet S1 an oder aus
T3 schaltet S1 an
T4 schaltet S1 aus.

Diese Tabelle ist im Schalter S1 gespeichert.

Schaltet man mit T3 den S1 an und drückt dann nach beliebiger Zeit kurz T1 geht S1 nach weiteren 10 sec aus. Schaltet man mit T1 kurz den S1 für 10 sec an, aber innerhalb dieser Zeit mit T3 nochmal an, dann bleibt S1 nach Ablauf der 10 sec an.

Die verfügbaren Register unterscheiden sich im Gerät und in den jeweiligen Kanälen.
Eine kurze Beschreibung der Register inklusive der erlaubten Werte erhält man durch:
:<code>get <name> regList </code>
Dabei kann <name> ein Gerät oder ein separater Gerätekanal sein.

== Spezielle Register (Auswahl) ==
Im folgenden sollen einige Register vorgestellt werden, die in vielen Geräten vorhanden sind. ''Ergänzungen sind ausdrücklich erwünscht!''

=== Gerätebezogene Register ===
Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten '''List0''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_00.'' zu finden).

==== ''confBtnTime'' - Kurz oder lang und der Konfigurationsmodus ====
Nicht immer sind die internen Tasten eines Gerätes ohne weiteres mit Aktionen für kurzen und langen Tastendruck programmierbar. Bei allen Hutschienen-Aktoren sowie den Zwischensteckern (mit nur einem Bedienknopf) versetzt ein langer Tastendruck (4 Sekunden) den Schalter normalerweise in den Konfigurations- bzw. Anlern-Modus, bei den in Unterputzdosen versenkbaren Schalt- und Dimmaktoren (-FM ohne PBU in der Bezeichnung) ohne eigenen Konfigurations-Button gilt dies sogar für die zur normalen Funktion extern angeschlossenen Taster. Dieses Verhalten kann man mit dem Register ''confBtnTime'' beeinflussen. Bis zum Ablauf der dort einstellbaren Zeit (in Minuten) nach dem Versorgen mit Strom (powerUp) erreicht man den Konfigurationsmodus wie bisher, danach interpretiert der Aktor die Tastendrücke stets als kurz (short) oder lang (long). Beispiel:
:<code>set <name> regSet confBtnTime 2</code>
Möchte man den Aktor später zurücksetzen oder lokal konfigurieren, so erreicht man das ursprüngliche Verhalten in diesem Beispiel für die ersten zwei Minuten, nachdem man den Aktor (ausreichend lange) stromlos gemacht hat.

==== ''intKeyVisib'' - Interne Tasten sichtbar machen ====
Die internen "Tasten" eines Aktors (z.B. die Schaltwippe bei Wandschaltern/-tastern, der Bedienknopf bei Zwischensteckern, aber auch die angeschlossenen externen Taster bei Aktoren für Unterputzdosen oder die von außen zugängliche "Notbedientaste" etwa bei Zwischendecken-Dimmern) sind logisch ebenso mit dem Aktor verknüpft wie externe Bedienelemente wie Funkfernbedienungen oder per Funk verknüpfte Wandtaster. Ihre Betätigung wird (außer mit präparierter Firmware) zwar nicht gesendet (und kann daher von FHEM nicht "gelesen" werden), die vom Hersteller vorgesehenen Funktionen lassen sich aber genauso frei programmieren. Allerdings sind diese internen Verknüpfungen zur Vermeidung versehentlicher Programmierungen zunächst verborgen und müssen daher explizit sichtbar gemacht werden.

Dies geschieht mit
set <name> regSet intKeyVisib visib
attr <name> expert 1
Anschließend sind der oder die internen Taste(n) mit der Bezeichnung self01 (self02, ...) sichtbar und ihre Aktionen können gezielt wie bei einem externen Peer umprogrammiert werden.

Wer nun auf die Idee kommt, man könne durch entsprechendes zusätzliches peering bei mehrkanaligen Geräten die (mehreren) internen Tasten beliebig zuweisen und so raffinierte Zusatzschaltungen auslösen, muss hier enttäuscht werden: Zwar kann man tatsächlich mit peerBulk bei den Aktorkanälen zusätzliche interne Peers eintragen und programmieren und mit einer Fernauslösung aus FHEM die neuen Verknüpfungen erfolgreich nutzen - das Gerät selbst reicht die Tastenbetätigungen aber immer nur an den ursprünglich dafür vorgesehenen Kanal weiter.

==== ''ledMode'' - Funktion der Onboard-LED bei Bausätzen ====
Die (batteriebetriebenen) -PCB-Aktoren und die 8-Kanal-Module haben kleine LED an Bord, die für Diagnosezwecke hilfreich sind, einem sparsamen Betrieb aber in der Regel entgegenstehen. Sie werden daher nur bei außergewöhnlichen Zuständen wie dem Anlernmodus, einem Reset, oder auch bei niedriger Batteriespannung als Hinweis an den Anwender benutzt und sind ansonsten ab Werk deaktiviert. Bei einer Dauerstromversorgung kann aber eine Schaltzustandsanzeige oder eine Quittung über eine Befehlsaussendung nicht nur zur Diagnose hilfreich sein.

Besitzt das Gerät das Register ''ledMode'', so kann man mit
:<code>set <device> regSet ledMode on</code>
die LED auch für die "normalen" Betriebszustände aktivieren. Sie zeigen dann bei Aktoren, ob der Aktor eingeschaltet ist (blinkend, wenn eine Einschaltzeitbegrenzung aktiv ist), und bei den Sensormodulen HM-Mod-EM8(bit) zeigt die zweifarbige LED den von Fernbedienungen bekannten Sendezustand mit gelb, dem dann ein grün oder rot folgt - je nachdem ob eine Quittung angefordert ist und ob sie erfolgreich empfangen wurde.

Leider lässt sich umgekehrt die bei Wandtastern oder Fensterkontakten mitunter gewünschte Deaktivierung der LED nicht so bewerkstelligen - diese Geräte haben das entsprechende Register nicht. Da hilft nur ein Eingriff ins Gerät mit Gaffa oder schwarzem Edding...

=== Kanalbezogene Register ===
Kanalbezogene Register existieren für jeden Kanal eines Gerätes einmal und werden in der sogenannten '''List1''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_01.'' zu finden).

==== ''powerUpAction'' - Automatischer Knopfdruck bei (wiederkehrender) Stromversorgung ====
Mit diesem Register (default ''off'') kann erreicht werden, dass ein Schaltaktor nach einem Stromausfall sich bei Wiederkehr der Versorgungsspannung automatisch einschaltet. Dies ist z.B. sinnvoll für Zwischenstecker mit Messfunktion ([[HM-ES-PMSw1-Pl Funk-Schaltaktor 1-fach mit Leistungsmessung|HM-ES-PMSw1-Pl]]), wenn dieser als Langzeitmonitor etwa für Kühlgeräte verwendet wird - nach einem Stromausfall bliebe der Kühlschrank sonst aus und der Inhalt würde verderben.
:<code>set <name> regSet powerUpAction on</code>
Achtung: Das Setzen dieses Registers auf ''on'' bedeutet nicht immer einen eingeschalteten Aktor nach der Wiederkehr der Stromversorgung. Vielmehr wird nur ein ''short''-Ereignis auf den zugehörigen internen Taster ausgelöst, was nur im Normalfall zum Einschalten des Aktors führt - nicht aber wenn die Funktion dieses kurzen Tastendruckes gezielt verändert wurde, denn dann wird eben diese Aktion ausgeführt! Das gilt zum Beispiel auch für zeitlich begrenztes Einschalten. Als Alternative für eine lokale Schaltmöglichkeit bietet sich in solchen Fällen der lange Tastendruck an, sofern er vom Aktor unterstützt wird (so lässt sich die Einschaltzeit bei langem Tastendruck mit ''lgOnTime'' begrenzen). Dessen Aktion wird bei powerUp nicht ausgeführt.

=== Verknüpfungsbezogene Register ===
Diese Register sind am umfangreichsten und werden für jeden Verknüpfungspartner einzeln separat angelegt in der '''List3''' (''RegL_03.<peer>''). Die grundsätzlichen Funktionen und ihre Zusammenhänge sind ausführlich in der Einsteigerdokumentation erklärt, inklusive Skizzen für die sogenannte ''state machine''. Hier sollen daher nur die in den folgenden Beispielen verwendeten Register erklärt werden.

==== ''shOnTime'' und ''lgOnTime'' - das interne ''on-for-timer'' von Schaltern oder Dimmern ====
Die wohl populärsten Register begrenzen die Einschaltzeit eines Aktors. Um z.B. eine Steckdose für 10 sec bei Knopfdruck lokal einzuschalten kann man folgendes programmieren:
:<code>set <name> regSet shOnTime 10 self01 </code>

''shOnTime'' ist dabei das zuständige Register für die Einschaltzeit bei kurzem (sh=short) Tastendruck, entsprechend gilt ''lgOnTime'' für einen langen Tastendruck.

In den Readings werden die Register mit dem jeweiligen verknüpften Taster angezeigt, in unserem Fall also:
:<code>R-self01-shOnTime </code>

Der Defaultwert für shOnTime ist 111600 und bedeutet unendlich (von FHEM mit "unused" dargestellt), d.h. die maximale einstellbare Zeit ist 111599 sec (knapp 31 Stunden). So kann man die Zeit löschen:
:<code>set <device> regSet shOnTime 111600 self01 </code>
oder
:<code>set <device> regSet shOnTime unused self01 </code>

Übrigens gibt es diese Register auch für die Ausschaltzeit.

==== ''shCtOn'' und ''shCtOff'' - Bedingtes Schalten mit Schwellwerten ====
Fernbedienungen (im weitesten Sinne, ''remote'') von HomeMatic übermitteln je nach Betätigungsdauer ''short''- oder ''long''-Trigger. Zustandsübermittelnde Sensoren (etwa ein Fensterkontakt oder Neigungssensor sowie Bewegungsmelder) senden ausschließlich ''short'', gekoppelt mit einem Wert zwischen 0 und 200, entsprechend 0-100% in 0,5-%-Schritten. Ob ein solcher Trigger vom Aktor verarbeitet wird, kann vom gesendeten Wert abhängen.

HomeMatic kennt dazu (für jeden Peer und Triggertyp (short/long) separat) zwei Schaltschwellen Lo und Hi, die default bei 50 und 100 liegen. Ob ein Trigger in Relation zu diesen Schwellen verarbeitet wird, regeln u.a. die shCtxxx-Register. Wie auch bei den allgemeinen Schaltbedingungen stehen ''On'' und ''Off'' jeweils für den aktuellen Schaltzustand (Achtung: nicht den, der erreicht werden soll). Ihr Wert beträgt default "geLo" (greater or equal Lo), hier 50 und höher. Trigger für Werte darunter werden bei der Einstellung "ltLo" (less than Lo) verarbeitet. Diese Schwellen gibt es entsprechend auch für den Hi-Wert, also "geHi" oder "ltHi". Besonders interessant sind aber auch die Werte "outside" und "between", bezogen auf die beiden Schwellen Lo und Hi. In letzterem Fall wird der Trigger verarbeitet, wenn der Wert zwischen 50 und 100 liegt, bei "outside" entsprechend bei 0-49 oder 101-200.

Sogenannte Three-State-Sensoren wie Fensterkontakt- oder -griffsensoren senden 0 für "closed" (geschlossen), 100 für "tilted" (gekippt) und 200 für "open" (offen). Gleiches gilt für Schalterkontaktinterfaces, die den Zustand eines angeschlossenen Schaltkontaktes übermitteln. Im Grundzustand (Vergleichsbefehl auf "geLo") führt daher nur der Trigger "offen" (200) zu einer Aktion. Ändert man den Vergleichsbefehl auf "ltLo", so wird lediglich "closed" ausgewertet, bei "between" ist es "tilted". Mit "outside" führt sowohl "closed" als auch "open" zu einer Aktion.

Bei Bewegungsmeldern wird der mit übermittelte Helligkeitswert im Zusammenhang mit den (dann variabel einzustellenden) Schwellen als Kriterium für das Einschalten des Aktors mit herangezogen.

==== ''shSwJtOn'' & Co. - Was soll passieren? ====
Nachdem wir nun kennengelernt haben, wie man auswählt, '''welcher''' Anstoss von außen zu einer Aktion führt, hier ein kleiner Exkurs in die Beeinflussung, '''was''' daraufhin passieren soll. Diese Frage regelt die ''jump table'' und liefert damit das Regelwerk für die Abfolge der Aktionen, die ''state machine''. Ein HomeMatic-Aktor geht nämlich keineswegs einfach nur an oder aus. Vielmehr hangelt er sich nacheinander an einer Reihe von Zuständen entlang - auch das ist in der Einsteigerdokumentation erschöpfend beschrieben und soll hier nicht wiederholt werden. Ein Schalter durchläuft aber mindestens die Zustände
Aus > Einschaltverzögerung > Ein > Ausschaltverzögerung > Aus > (usw)
Hier soll reichen, dass am Ende jeder (Teil-)Kette in der Regel ein dauerstabiler Zustand bleibt, in der Regel ist das der Aus-Zustand und auch der Ein-Zustand, wenn dessen Laufzeit nicht durch ''shOnTime'' & Co. begrenzt ist. Ein- und Ausschaltverzögerung sind aber in der Regel 0 (Sekunden), so dass effektiv nur "Ein" und "Aus" übrig bleiben.

Das Register ''shSwJtOn'' regelt, wohin die Reise geht, wenn ein gültiger ''short''-Trigger im eingeschalteten Zustand eintrifft, sinngemäß ''...Off'' im Auszustand und ''lg...'' für die ''long''-Trigger. Für ''shSwJtOn'' ist normalerweise als nächstes die Ausschaltverzögerung "dlyOff" vorgesehen. Da die Ausschaltverzögerung in der Regel 0 ist, folgt darauf, in ''shSwJtDly'' festgelegt, "off" usw. Die Zustände bilden so quasi einen Kreis, dessen Durchlauf von außen gelegentlich "angeschubst" wird. Mit diesen Registern kann man den Kreislauf aber auch umbiegen oder sogar unterbrechen, so dass ein eintreffender Trigger eben nicht zu einer Aktion führt. Als Ziele bieten sich, quasi selbstsprechend, "on", "dlyOff", "off" und "dlyOn" an - oder eben "no", was nichts anderes bedeutet, als dass der betreffende Trigger an dieser Stelle zu keiner Aktion führt.

Bei einem Dimmer heißen die Register statt ''..Sw....'' nur ''..Dim....'' und es gibt ein paar mehr Bedingungen - die Funktion ist aber entsprechend gleich.

==== ''shOnDly'' und ''shOffDly'' - es muss nicht immer sofort sein! ====
Nicht nur welcher Anstoße welche Aktion auslöst, sondern auch wann oder wie schnell die Aktion ausgeführt wird, lässt sich in gewissen Grenzen einstellen. Die beiden genannten Register etwa regeln die Ein- oder Ausschaltverzögerung nach einem gültigen Trigger. So kann man nach einem Ausschaltbefehl einen Raum noch im Hellen verlassen, wenn das Licht noch ein paar Sekunden länger leuchtet.

Bei Dimmern gibt es zusätzlich auch bei Ein- und Ausschaltvorgängen durch eine neu eingerichtete Verknüpfung eine sogenannte Rampenzeit von 0,5 Sekunden, in der das Licht hoch- oder heruntergedimmt wird. Durch Programmierung von ''shRampOnTime'' und ''shRampOffTime'' kann man ein sehr augenschonendes langsames Ein- oder Ausschalten des Lichts wie im Kino erreichen. Zwar gibt es die Zeiten auch für long-Trigger, aber da machen sie im Normalfall wenig Sinn - der lange Tastendruck löst immer einen manuellen Dimmvorgang aus.

''(wird ergänzt)''

== Praktische Beispiele ==
Die folgenden Beispiele beschreiben nur in Kurzform die erforderlichen Aktionen. Weiterführende Informationen sind der Einsteigerdokumentation oder den o.g. Registerbeschreibungen zu entnehmen.
Übrigens: ein einmal konfigurierter Vorgang für eine Verknüpfung kann aus FHEM auch bequem fernausgelöst (bzw. simuliert) werden. Der Aktor führt dabei genau die Aktion aus, die für die benannte Verknüpfung vorgesehen ist. Der kurze Knopfdruck auf den internen Knopf eines Aktors wird beispielsweise so simuliert:
:<code>set <device> press short self01 </code>

=== Lokal bedienbarer Zeitschalter mit HomeMatic Aktoren: Pool für eine Stunde schalten ===
Ich habe einen HM-LC-SW4-DR und der channel_01 schaltet die Poolzirkulationspumpe. Dies passiert zeitgesteuert zweimal am Tag. Manchmal möchte ich im Keller diese Pumpe einfach für eine Stunde aktivieren, der Aktor ist bequem erreichbar an der Wand.
Die internen Tasten vom Hauptdevice (der Aktor hat vier Kanäle (channel), die in FHEM einzeln dargestellt werden) sichtbar machen:
set LichtKeSW1 regSet intKeyVisib visib
attr LichtKeSW1 expert 1

Jetzt sieht man im Channel 01 - LichtKeSW1_Sw01 den internen peer self01. (Channel 02 ist self02 usw.)
Also jetzt einfach die Zeit eintragen:
set LichtKeSW1 regSet shOnTime 3600 self01

Die Toggle Funktion der Taste bleibt erhalten. Ein zweiter Tastendruck schaltet die Pumpe auch sofort wieder aus. Während die Zeit läuft, blinkt die Status LED des Kanals.
Die Zeitbegrenzung funktioniert in diesem Beispiel ohne jedes Zutun von FHEM und damit auch bei einem Ausfall des Servers.

=== Es werde Licht! Automatisches Licht mit Tor oder Tür ===
Im Kühlschrank geht das Licht ja schon praktischerweise automatisch an und aus, aber es gibt auch andere Situationen, in denen ein automatisches Licht sehr nützlich sein kann - in dunklen Abstellräumen oder Garagen. Vor allem weil man nicht vergessen kann es auszuschalten, weil es auch von allein ausgeht. Eine solche Funktion, so könnte man meinen, wird ganz einfach erreicht, indem man das Licht mit einem Aktor schalten lässt und diesen mit einem Tür- oder Fensterkontakt verknüpft. Hat man die beiden dann mit ''peerChan'' verknüpft, so wird man feststellen, dass das Licht mitnichten das Gewünschte tut: es schaltet sich beim Öffnen der Tür abwechselnd ein und aus und ignoriert das Schließen der Tür komplett.

Verantwortlich für dieses "Fehlverhalten" sind die Register ''shCtOn'' und ''shCtOff''. Beide stehen nach der Verknüpfung auf "geLo". Wie bei den Registern oben erläutert, führt in diesem Fall nur die "offen"-Meldung des Türkontaktes zu einer Aktion. Das Öffnen der Tür soll den Aktor einschalten, das klappt. Das Schließen der Tür soll den eingeschalteten Aktor aber ausschalten. Also muss die Schaltbedingung im On-Zustand geändert werden (die Bezeichnungen natürlich durch die realen Namen des Schaltaktorkanals und des Türkontaktes ersetzen):
:<code>set <Schalter> regSet shCtOn ltLo <Türkontakt> </code>
Nun führt auch das Schließen der Tür wunschgemäß stets zu einem Abschalten des Lichts. ''shCtOff'' muss auf "geLo" bleiben!

Kombinieren ließe sich das noch mit einer Laufzeitbegrenzung etwa für eine Stunde - sollte man die Tür versehentlich offenlassen, so brennt das Licht nicht stundenlang. Vor allem geht das Licht dann auch aus, wenn aus welchem Grund auch immer die Schließmeldung verloren geht.
:<code>set <Schalter> regSet shOnTime 3600 <Türkontakt> </code>

=== Lampe mit Kippschalter(n) fernschalten - eindeutig oder als Wechselschaltung ===
Oft besteht der Wunsch, eine Lampe mit einem herkömmlichen Schalter (statt eines Tasters) fernzuschalten. So kann man einen herkömmlichen Schalter mit einer Schließerkontaktinterface wie dem [[HM-SCI-3-FM 3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]] ergänzen (oder einem Kanal des [[HM-MOD-EM-8 8-Kanal-Sendemodul|8-Kanal-Sendemoduls]] in der Betriebsart ''sensor'') und wiederum die Verknüpfung mit dem Lampen-Aktor setzen. Ganz ähnlich wie bei der vorgenannten Abstellraum-Aufgabe führt nun aber das Schließen des Schalters nicht zu einem Einschalten. Daher ist nun
:<code>set <Lampenaktor> regSet shCtOff ltLo <Sensorkontakt> </code>
das Mittel der Wahl, ''shCtOn'' muss dieses Mal auf "geLo" bleiben. Jetzt folgt der Aktor dem (sichtbaren) Schaltzustand des Schaltes - zumindest solange er nicht anderweitig ein- oder ausgeschaltet wird.

Nun kann man auch mehrere Schalter so mit der Lampe koppeln. Das ergibt aber keine Wechselschaltung im herkömmlichen Sinn - um eine Lampe ein- oder auszuschalten, muss man den Schalter möglicherweise einmal zusätzlich auf die aktuelle Schaltposition kippen, ehe die nächste Betätigung den gewünschten Effekt bringt. Für Wechselschaltungen bietet sich daher das Kontaktinterface [[HM-SwI-3-FM]] (oder das erwähnte 8-Kanal-Sendemodul in der Betriebsart ''switch'') an. Hier führt jede Zustands''änderung'' zu einem Schaltvorgang.

Hat man hingegen nur ein HM-SCI-3-FM zur Hand, lässt sich dieses Verhalten auch erreichen:
:<code>set <Lampenaktor> regSet shCtOn outside <Sensorkontakt> </code>
:<code>set <Lampenaktor> regSet shCtOff outside <Sensorkontakt> </code>

=== Gezieltes Schalten eines (unsichtbaren) Aktors mit nur einer Taste ===
Für so etwas braucht man gewöhnlich zwei Tasten. Koppelt man einen Schalt-Aktor mit nur einer Taste ("single" beim ''peerChan''-Kommando), so führt sowohl ein kurzer als auch ein langer Tastendruck immer nur zu einem Umschalten des Zustandes. Das ist unschön, wenn man den aktuellen Zustand nicht einsehen kann.

Üblicherweise sind die Schaltabfolgen für eine Eintasten-Verknüpfung sowohl für kurze als auch lange Betätigungen gleich (bei Dimmern wird auf langen Tastendruck hingegen abwechselnd auf- oder abgedimmt).
shSwJtOff = dlyOn # Ist Gerät aus, wird Einschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOff = dlyOn # dito, für lang
shSwJtOn = dlyOff # Ist Gerät an, wird Ausschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOn = dlyOff # dito, für lang
Hier kann man sich zunutze machen, dass man mit einem gezielten "no" oder "dlyOn" bzw. "dlyOff" im richtigen Register die Schaltfolge abbrechen oder umbiegen kann.
Möchte man das Gerät <aktor> mit einem kurzen Tastendruck auf <button> ein- und mit einem langen Tastendruck ausschalten, so ändere man:
:<code>set <aktor> regSet shSwJtOn dlyOn <button> </code>
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>
So laufen die entsprechenden Aktionen quasi ins Leere, wenn der Aktor bereits den gewünschten Zustand hat.

Den umgekehrten Effekt (lang schaltet ein, kurz aus) erreicht man entsprechend mit
:<code>set <aktor> regSet shSwJtOff dlyOff <button> </code>
:<code>set <aktor> regSet lgSwJtOn dlyOn <button> </code>

Welche Bedienhaptik man nun bevorzugt, muss man selbst entscheiden. In der Regel sollte die normale (sichere) Aktion "kurz" und die gefährlichere "lang" sein - eine PC-Stromversorgung mit einem kurzen Tastendruck versehentlich einzuschalten ist bestimmt besser als auszuschalten (das dann eben nur über lang) - für ein potentiell gefährliches Arbeitsgerät wie einen Heizofen wird es sicher andersherum sein.

Sinngemäß verwendet der Autor sozusagen eine Hälfte davon als "Sicherheitsaktion" für einen [[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach]] - der gewöhnliche Tastendruck auf die zugehörige Wippenseite schaltet den Aktor abwechselnd ein und aus, ein langer Tastendruck immer aus, dafür reicht:
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>

Übrigens: Nichts anderes wird normalerweise auch automatisch beim Verknüpfen eines Aktors mit einem Tastenpaar an der entsprechenden Stelle gemacht - ist eine Taste nur zum Ausschalten gedacht, so wird in beiden Schaltzuständen entsprechend "dlyOff" eingetragen. Als "Sprungziel" müsste aber genauso gut auch "no" funkionieren.

=== WARNUNG! - Selbsttätiges Blinken eines HM-Aktors ===
Statt einer separaten Warnleuchte kann es durchaus sinnvoll sein, eine vorhandene Lampe zu Warnzwecken periodisch ein- und auszuschalten. Leider beherrschen die HomeMatic-Aktoren keine direkt aus FHEM erreichbare Blinkfunktion (ähnlich dem on-for-timer für eine Zeitbegrenzung), und das rhythmische Ein- und Ausschalten aus FHEM erzeugt eine recht hohe Funklast.

Wir wissen aber, dass die Aktoren für jeden Peer nicht nur eine Ein-, sondern auch eine Ausschaltzeit speichern. Definiert man nun für einen Peer entsprechend beide Zeiten, so wird der Aktor bei einem Telegramm von diesem Peer sich entsprechend selbsttätig fortlaufend ein- und ausschalten. Jeder andere Schaltbefehl eines anderen Peers oder aus FHEM beendet die Schleife umgehend. So ließe sich das Blinken auch mit einer aktoreigenen Taste stoppen - oder starten, wenn man es entsprechend programmiert. Einen Zwischenstecker-Schalter beispielsweise kann man also (wenn man zuvor seine ''confBtnTime'' entsprechend setzt und so die langen Tastendrücke auswertbar macht) durch das Programmieren von ''lgOnTime'' und ''lgOffTime'' für den Peer "self01" wie gewohnt mit einem kurzen Tastendruck ein- und ausschalten und mit einem langen in den Blinkmodus versetzen.

Einen Haken hat die Sache aber: Der Aktor meldet seinen neuen Schaltzustand nach jeder Änderung mit einer gewissen Verzögerung, die man bei vielen Schaltaktoren (aber leider nicht bei allen wie etwa dem HM-Mod-Re-8) mit dem Register ''statusInfoMinDly'' tunen kann. Ändert der Aktor seinen Schaltzustand in längeren Intervallen, wird es also trotzdem wieder ein Funkfeuer geben. Ist das Delay noch nicht erreicht, erfolgt keine Zustandsübermittlung. Beim HM-Mod-Re-8 muss man also etwa unter 1 Sekunde pro Änderung bleiben.

Zum Steuern aus FHEM emfiehlt es sich, virtuelle Buttons (etwa einer VCCU oder eines virtuellen HM-Dummys) zum Ein- und Ausschalten der Blinkfunktion zu verwenden. "Opfert" man dafür zwei aufeinanderfolgende Kanäle, kann man die Aktoren mit "dual set" peeren und bekommt so einen Blink- und einen Deaktivierungsbutton ohne weitere Kopfstände. Anschließend passt man die short-Laufzeiten für den Einschaltkanal an.

Ein Beispiel für einen Dimmer (als virtuelle Buttons dienen vccu_Btn8 und vccuBtn9):

:<code>set <vccu_Btn8 peerChan 0 <dimmerkanal> dual set</code>

Nun kann man mit "set vccu_Btn8 press short" den Dimmer ein- und mit "set vccu_Btn7 press short" ausschalten. Das Blinken im Dimmer wird eingestellt mit

:<code>set dimmer regSet shOnTime 1 vccu_Btn8</code>
:<code>set dimmer regSet shOffTime 1 vccu_Btn8</code>
jeweils für die gewünschte Ein- und Ausschaltzeit.

Wird der Dimmer nun mit "set vccu_Btn9 press short" eingeschaltet, so blinkt er im 3-Sekunden-Takt: zu den jeweils 1 Sekunde Ein- und Auszeit gesellen sich noch 2x 0,5s Rampenzeit, sofern nichts anderes programmiert wurde.

Das funktioniert auch mit Schaltern: So würde 0.1 und 0.9 (Sekunden) ein kurzes Blitzen im Sekundentakt einstellen.

Natürlich kann man nun eine größere Anzahl von Aktoren mit den virtuellen Buttons peeren und so ein ganzes Feuerwerk zünden ... Ein zusätzlich zu Alarmsirenen wild blinkende Innenbeleuchtung in allen Räumen sorgt sicher für zusätzliche Aufmerksamkeit.

=== Einer nach dem Anderen! - Sequentielles Schalten mehrerer Aktoren ===
Eine großflächige Beleuchtung mit viel Leistung sollte man aus Lastgründen niemals zugleich einschalten. Auch LED-Lampen ziehen im Einschaltmoment, wennauch extrem kurz, beträchtliche Ströme, die die von gewöhnlichen Glühlampen deutlich übersteigen können. Schaltet man mehrere Aktoren gleichzeitig mit einer Taste, so hilft eine individuelle Verzögerung des Einschaltvorgangs in jedem Aktor, die Sicherung vor dem Herausfliegen zu bewahren. Oder man macht gezielt einen Effekt daraus. Der Phantasie sind wenig Grenzen gesetzt...

Hat man drei Aktoren "Aussenlicht1...3" mit dem Taster "Aussenlicht_Ein" gepeert, so erreicht man auf folgende Weise, dass sie beim Einschalten mit einer Verzögerung von jeweils einer Sekunde nacheinander einschalten.

:<code>set Aussenlicht2 regSet shOnDly 1 Aussenlicht_Ein</code>
:<code>set Aussenlicht3 regSet shOnDly 2 Aussenlicht_Ein</code>

[[Kategorie:HomeMatic Components|1toolsAndWork]]

HM-RC-4-2 Funkfernbedienung 4 Tasten

2019-09-10T12:38:22Z

Pfriemler: /* Auswertung */ Short- und Long-Abfragen präzisiert

HomeMatic Fernbedienung mit 4 Tasten in Form eines Schlüsselanhängers
==Features==
HomeMatic Fernbedienung mit 4 Tasten in Form eines Schlüsselanhängers, mit Status-LED, die in den Farben Grün, Rot und Orange leuchten bzw. blinken kann.
Robuster Aufbau, Batterie ist eine normale Microzelle (AAA), Nachkauf daher günstiger als bei Sendern mit Knopfzellen, allerdings bedingt die Microzelle auch ein grösseres Gehäuse.
Vorgänger der HM-RC-4-3.

==Hinweise zum Betrieb mit FHEM==

=== Anbindung der Fernbedienung an FHEM ===
Wie alle HomeMatic-Komponenten wird die Fernbedienung durch das Modul CUL_HM (oder eine echte CCU, s.u.) angebunden. Die Funkverbindung ist mittels eines [[HomeMatic]] IOs ("Funkschnittstelle") oder eines CUL/CUNx/COC etc. im HM-Mode möglich.
Obwohl kein SEC im Name auftaucht, ist bei dieser Fernbedienung im Auslieferungszustand AES aktiv. Das Pairen mit HM IOs funktioniert ohne Probleme, für alle CUL Derivate muss unbedingt der Hinweis im Artikel [[AES Encryption]] im Abschnitt I/O-Device <-> Gerät beachtet werden. '''Die dort beschrieben Installation muss durchgeführt werden!''' Wenn irgend möglich ist die Einrichtung einer [[Virtueller Controller VCCU|VCCU]] und das direkte pairen an die VCCU anstatt an eine physikalische Funkschnittstelle vorzuziehen.

=== Pairing der Fernbedienung mit FHEM ===
Pairen wie unter [[HomeMatic_Devices_pairen]] beschrieben. Die Taste zum pairen befindet sich hinter dem kleinen Loch auf der Rückseite der Fernbedienung. Mit aufgebogener Büroklammer oder ähnlich 3 Sekunden drücken.

Nach erfolgreichem Pairen sollte in etwa folgendes in der cfg stehen:

define CUL_HM_HM_RC_4_2_227C77 CUL_HM 227C77
attr CUL_HM_HM_RC_4_2_227C23 .devInfo 040000
attr CUL_HM_HM_RC_4_2_227C77 .stc 40
attr CUL_HM_HM_RC_4_2_227C77 firmware 1.1
attr CUL_HM_HM_RC_4_2_227C77 model HM-RC-4-2
attr CUL_HM_HM_RC_4_2_227C77 room CUL_HM
attr CUL_HM_HM_RC_4_2_227C77 serialNr KEQ0456756
attr CUL_HM_HM_RC_4_2_227C77 subType remote
define CUL_HM_HM_RC_4_2_227C77_Btn_01 CUL_HM 227C7701
attr CUL_HM_HM_RC_4_2_227C77_Btn_01 model HM-RC-4-2
attr CUL_HM_HM_RC_4_2_227C77_Btn_01 peerIDs
attr CUL_HM_HM_RC_4_2_227C77_Btn_01 room CUL_HM
define CUL_HM_HM_RC_4_2_227C77_Btn_02 CUL_HM 227C7702
attr CUL_HM_HM_RC_4_2_227C77_Btn_02 model HM-RC-4-2
attr CUL_HM_HM_RC_4_2_227C77_Btn_02 room CUL_HM
define CUL_HM_HM_RC_4_2_227C77_Btn_03 CUL_HM 227C7703
attr CUL_HM_HM_RC_4_2_227C77_Btn_03 model HM-RC-4-2
attr CUL_HM_HM_RC_4_2_227C77_Btn_03 room CUL_HM
define CUL_HM_HM_RC_4_2_227C77_Btn_04 CUL_HM 227C7704
attr CUL_HM_HM_RC_4_2_227C77_Btn_04 model HM-RC-4-2
attr CUL_HM_HM_RC_4_2_227C77_Btn_04 room CUL_HM

=== Auswertung ===
Das Betätigen des Senders löst in der Regel mindestens zwei Events aus, da auch der Batteriestatus bei jeder Tastenbetätigung mit übermittelt wird.

Eine unspezifische Abfrage der Art:

define act_on_Taste4 notify CUL_HM_HM_RC_4_2_227C77_Btn_04 set Aktor1 on

wird also den Befehl "set Aktor1 on" 2x senden. Es ist daher in der Regel sinnvoll, das Button-Event explizit abzufragen, z.b. so:

define act_on_Taste4 notify CUL_HM_HM_RC_4_2_227C77_Btn_04:Short.* set Aktor1 on

Kurze Tastendrücke generieren Events der Form "Short 1_x". Short ist immer Short_1, bei Long zählt dies bei längeren Tastendrücken hoch. x ist ein fortlaufender Zähler, der bei jedem Tastendruck erhöht (und nach 255 zurückgesetzt) wird.

Für die Reaktion auf einen langen Tastendruck empfiehlt es sich nicht, als Regex für das Event nur "Long.*" zu wählen. Der längere Tastendruck würde sonst 4x je Sekunde ein neues Event auslösen und das Notify mehrfach triggern, solange die Taste gedrückt wird. Besser ist, sich auf Event in den ersten 3 Sekunden zu beschränken:

define act_on_Taste4 notify CUL_HM_HM_RC_4_2_227C77_Btn_04:Long.1.* set Aktor1 on

"Long.1.*" entspricht der (ersten) Reaktion eines Homematic-Gerätes. Der Punkt . zwischen Long und der Zahl ist der erforderliche Platzhalter für das _ im Event.
Das Notify reagiert nach 3 Sekunden dann mehrfach auf alle Folgeevents wie Long_11, Long_12, Long_13 ...
"Long.9.*" würde entsprechend erst bei sehr viel längerem Druck reagieren.

Alternativ ist es möglich, auf das Event "LongRelease" zu reagieren - dieses entsteht aber nur, wenn der Taste ein peer zugewiesen ist:
define act_on_Taste4 notify CUL_HM_HM_RC_4_2_227C77_Btn_04:LongRelease.* set Aktor1 on

Dieses Event entsteht nur einmal beim Loslassen der (länger) gedrückten Taste, ist aber u.U. haptisch ungünstiger, weil die Aktion erst beginnt, wenn die Taste losgelassen wurde.

=== LED / Rückantwort ===
Ohne weitere Maßnahmen wird der Empfang eines Befehls nicht an die Fernbedienung zurück gemeldet, d.h. die LED der Fernbedienung leuchtet nach Tastendruck Orange auf, um zu zeigen, dass der Befehl abgesetzt wurde. Die Rückmeldung, ob der Befehl empfangen wurde, wird aber von einem gepeerten Aktor veranlasst. Der Einsatz der Fernbedienung ist im Zusammenhang mit FHEM auch ohne Peering möglich und womöglich der Regelfall. '''Pairing mit FHEM allein''' reicht nicht aus. Will man die Fernbedienung mit keinem Aktor direkt peeren, wird daher keine Entität den Empfang des Tastendrucks bestätigen. Um dieses Problem zu umgehen, bieten sich diverse Varianten an. Im folgenden seien zwei beschrieben:

==== Einrichten eines virtuellen HM Devices ====
Es lässt sich eine virtuelle HM Instanz/Device einrichten, dessen einziger Zweck es ist, peerbare Channels zur Verfügung zu stellen. Zum einen können diese Channels dazu genutzt werden virtuelle Buttons zu erzeugen, die man auf der WebGUI platzieren kann, und die bei Betätigung direkt gepeerte HM-Aktoren bedienen, vor allem aber kann man Fernbedienung (oder sonstige Sensoren) mit den virtuellen Channels peeren, um eine Rückantwort (ACK) zu erhalten. Die Funktion des virtuellen IDvices ist dann nur zu bestätigen, dass es den Tastendruck empfangen hat.

Hierzu zunächst ein virtuelles HM Device anlegen, diese benötigt eine eigne HMID:

define <Virtual_Irgendeinname> CUL_HM 654321
attr <Virtual_Irgendeinname> hmClass receiver
attr <Virtual_Irgendeinname> subType switch

Bei der Vergabe der HMIS ist zu beachten, dass der Code 6stellig hexadezimal ist. Werden Buchstaben als Bestandteil der HMIC gewählt, müssen diese als Großbuchstaben angegeben werden. Die HMID muss anders sein als die vorhandener echter Funkschnittstellen oder einer eventuell eingerichteten VCCU.

Anschliessend die Anzahl der Cannels festelegen (es sind maximal 50 möglich, weniger ist besser):
set <Virtual_Irgendeinname> virtual 5

Abschliessend einen Button der Fernbedienung mit einem Channel peeren. Zuerst die kleine Taste auf der Rückseite der HM-RC-4-2 Funkfernbedienung drücken, wenn die LED Grün leuchtet den Befehl

set <HM-RC-4-2>_Btn_01 peerChan 0 <Virtual_Irgendeinname>_Btn1 single

absetzen, dann die zu peerende Taste (hier Button 1) drücken.

Wenn das Peering erfolgreich war, sollte die LED an der HM-RC-4-2 mehrmals schnell blinken.

Anschliessend wird jeder Tastendruck bei Empfang mit grün bestätigt (ACK) oder bei fehlerhaftem Empfang mit roter LED quittiert (NACK).

Dies sagt nichts über die tatsächliche Aktion aus, die FHEM ausführt, diese hängt davon ab, welche Abfragen und Aktionen definiert sind. Es wird durch den virtuellen Channel rein der Empfang der Nachricht quittiert. Es ist daher bei grenzwertiger Funklage auch denkbar, dass die grüne LED nicht leuchtet oder gar ein NACK gemeldet wird, FHEM die konfigurierte Aktion aber trotzdem ausführt.

==== Nutzung einer VCCU ====

Alternativ zum obigen Vorgehen können auch die virtuell Channels eine VCCU genutzt werden. Dazu zuerst die Anzahl der virtuellen Channels setzen:

set <VCCU> virtual 5

(es sind maximal 50 möglich, weniger ist besser)

Abschliessend einen Button der Fernbedienung mit einem Channel peeren. Zuerst die kleine Taste auf der Rückseite der HM-RC-4-2 Funkfernbedienung drücken, wenn die LED Grün leuchtet den Befehl

set <HM-RC-4-2>_Btn_01 peerChan 0 <VCCU>_Btn1 single

absetzen, dann die zu peerende Taste (hier Button 1) drücken.

Wenn das Peering erfolgreich war, sollte die LED an der HM-RC-4-2 mehrmals schnell blinken.

Anschliessend wird jeder Tastendruck bei Empfang mit grün bestätigt (ACK) oder bei fehlerhaftem Empfang mit roter LED quittiert (NACK).

Dies sagt nichts über die tatsächliche Aktion aus, die FHEM ausführt, dies hängt davon ab, welche Abfragen und Aktionen definiert sind. Es wird durch den virtuellen cannel rein der Empfang der Nachricht quittiert. Es ist daher bei grenzwertiger Funklage auch denkbar, das die grüne LED nicht leuchtet oder gar ein NACK gemeldet wird, FHEM die konfigurierte Aktion aber trotzdem ausführt.

== Hinweis zum Anlegen der Channels bei der baugleichen ROTO_ZEL-STG-RM-HS-4 ==
Bei der baugleichen ROTO_ZEL-STG-RM-HS-4 wird mit Stand Januar 2016 von autocreate zwar das device selbst automatisch angelegt, jedoch nicht die 4 Kanäle für die 4 Tasten.
Die Kanäle müssen manuell angelegt werden. Startpunkt ist die HMID des device, z.B.
1907C9
Die Kanäle werden dann angelegt mit der HMID, an die die Kanalnummer 01...04 angehängt werden, also
1907C901
1907C902
1907C903
1907C904

Verwendet wird der reguläre define-Befehl, also
define <Kanalname> CUL_HM 1907C901
usw.
Die Channels werden danach regulär unter dem device angezeigt und können bei Bedarf regulär [[Peering (HomeMatic)|gepeert]] werden.

== Betrieb an einer CCU/CCU2/CCU3 ==
Neben der oben beschriebenen Variante des Betriebs an einer VCCU/einem CUL kann der Handsender natürlich auch an einer "echten" CCU betrieben werden.
Dazu muss der Handsender zuerst über die Bedienoberfläche der CCU angelernt werden. Danach kann die Integration in FHEM erfolgen.
Die Herausforderungen sind ähnlich dem Betrieb an einer VCCU. Man möchte eine Rückmeldung (=grüne LED am Handsender) und eine Benachrichtigung (=Event) in FHEM.

Dazu gibt es Hinweise im Forum:
* {{Link2Forum|Topic=81871|Message=739551}}
* {{Link2Forum|Topic=79905}}

Ob die Events kommen, kann im Event Monitor von FHEM überprüft werden.

Wenn dort keine Events zu sehen sind oder nur das Event "hmstate:initialized" auftaucht, dann sollte bei dem CCU-Device, an das der Handsender anlegernt wurde, überprüft werden, ob das Attribut ccudev-readingfilter gesetzt wurde. Eventuell werden die Events des Handsenders deswegen weggefiltert. Zum Testen das Attribut einfach löschen.

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]

Peering (HomeMatic)

2019-09-10T12:15:04Z

Pfriemler: Konkretisierung: LongRelease entsteht nicht, wenn kein peer definiert ist.

Das '''Peering''' ist eine Funktion der Komponenten des ''HomeMatic'' Systems. Es ist nicht zu verwechseln mit dem [[Pairing (HomeMatic)|Pairing]]

Beim Peering (deutsch sinngemäß: Verbindung mit Gleichen) wird ein HomeMatic-Gerät mit einem oder mehreren '''anderen HomeMatic-Geräten''' so verknüpft, dass es mit diesen Daten direkt, also ohne jegliche Aktivität einer Zentrale wie FHEM oder CCU, austauschen kann. Dabei kann es sich sowohl um Zahlenwerte handeln (z.B. die Solltemperatur), als auch um Kommandos (z.B. Schaltzustände).

Ein direktes Peering zweier HomeMatic-Geräte ist nur möglich, wenn keines zuvor gepairt wurde. Anderenfalls ist das Peering nur noch indirekt, d.h. über die Zentrale (in diesem Falle also FHEM) möglich.

Näheres zum Peering siehe unter [[Homematic Peering Beispiele]].

{{Hinweis|Das Peering von HomeMatic-Komponenten sollte frühzeitig geplant und umgesetzt werden, da sich die Events unter Umständen vor und nach dem Peering unterscheiden. So entfällt z.B. bei einem Taster das Event ''LongRelease'', wenn diese Taste nicht (mehr) mit einem Gerät oder einem virtuellen Aktor/Button in FHEM gepeert ist. Prüfen Sie daher nach dem Peering, ob Änderungen der [[Eventhandler]] erforderlich wurden, die Events der beteiligten Devices auswerten.}}

[[Kategorie:Glossary]]

HomeMatic Register programmieren

2019-02-14T20:59:02Z

Pfriemler: /* WARNUNG! - Selbsttätiges Blinken eines HM-Aktors */ Funkfeuer durch Statusmeldungen vermeiden, angepasste Beispiele

{{Baustelle}}
Ein HomeMatic-Gerät besitzt mehr oder weniger umfangreiche Registersätze, mit denen das Verhalten des Gerätes vielfältig feinkonfiguriert werden kann. Die damit erreichbare Funktionsvielfalt geht weit über die standardisierten Vorgaben einer einfachen Direktverknüpfung ([[Peering_(HomeMatic)|Peering]]) hinaus.

== Grundlagen (in Auszügen) ==

Im folgenden werden nur exemplarisch einige Grundlagen und einfache Beispiele benannt, ohne jeden Anspruch auf Vollständigkeit.

FHEM unterstützt die Programmierung der Register mit dem Befehl ''regSet''. <peer> entfällt bei rein gerätebezogenen Programmierungen.
:<code>set <name> regSet <register> <value> [<peer>] </code>
Darüberhinaus gibt es vor- oder selbstdefinierte [[HomeMatic_HmInfo_Templates_erstellen|Templates]] (Vorlagen), die alle erforderlichen Änderungen für standardisierte Anwendungen wie Treppenhauslichtschalter beinhalten. Die Anwendung von Templates auf Geräte wird protokolliert und der Registerzustand kann überprüft werden. Für viele Anwendungen genügt jedoch auch die einmalige Anwendung einer direkten Programmierung. Das genaue Verständnis der Vorgänge und Zusammenhänge ist nicht trivial, das Erlernen wird aber mit einer enormen erreichbaren Funktionsvielfalt belohnt. Viele wissenswerte Zusammenhänge sind im Homematic-Anhang der bekannten Einsteiger-Dokumentation erläutert, deren Lektüre zu Recht immer wieder empfohlen wird. Dieser Beitrag ist auch nur als Ergänzung zu verstehen!

Die HomeMatic Aktoren (Schalter, Dimmer, ...) arbeiten so, wie es für verknüpften ([[Peering (HomeMatic)|peering]]) Sender vorgegeben ist. Sie nutzen Registersätze, die für jede Verknüpfung (peer) neu angelegt und gespeichert werden. Man kann also mit einem Taster ein- und ausschalten (toggeln), mit einem Tastenpaar gezielt ein- und ausschalten und mit einem weiteren Taster eine Zeitschaltung für 10 Sekunden starten. Dabei wird niemals der Taster oder der Schalter auf eine globale Aktion programmiert, sondern im Schalter (Aktor) die gewünschte Aktion für jeden verknüpften Taster separat gespeichert. Die auszulösende Aktion ist zudem abhängig vom aktuellen Zustand des Aktors und von der Länge des Tastendruckes (kurz oder länger - short or long).

Kleines Beispiel:
T1 schaltet S1 für 10 sec an
T2 schaltet S1 an oder aus
T3 schaltet S1 an
T4 schaltet S1 aus.

Diese Tabelle ist im Schalter S1 gespeichert.

Schaltet man mit T3 den S1 an und drückt dann nach beliebiger Zeit kurz T1 geht S1 nach weiteren 10 sec aus. Schaltet man mit T1 kurz den S1 für 10 sec an, aber innerhalb dieser Zeit mit T3 nochmal an, dann bleibt S1 nach Ablauf der 10 sec an.

Die verfügbaren Register unterscheiden sich im Gerät und in den jeweiligen Kanälen.
Eine kurze Beschreibung der Register inklusive der erlaubten Werte erhält man durch:
:<code>get <name> regList </code>
Dabei kann <name> ein Gerät oder ein separater Gerätekanal sein.

== Spezielle Register (Auswahl) ==
Im folgenden sollen einige Register vorgestellt werden, die in vielen Geräten vorhanden sind. ''Ergänzungen sind ausdrücklich erwünscht!''

=== Gerätebezogene Register ===
Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten '''List0''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_00.'' zu finden).

==== ''confBtnTime'' - Kurz oder lang und der Konfigurationsmodus ====
Nicht immer sind die internen Tasten eines Gerätes ohne weiteres mit Aktionen für kurzen und langen Tastendruck programmierbar. Bei allen Hutschienen-Aktoren sowie den Zwischensteckern (mit nur einem Bedienknopf) versetzt ein langer Tastendruck (4 Sekunden) den Schalter normalerweise in den Konfigurations- bzw. Anlern-Modus, bei den in Unterputzdosen versenkbaren Schalt- und Dimmaktoren (-FM ohne PBU in der Bezeichnung) ohne eigenen Konfigurations-Button gilt dies sogar für die zur normalen Funktion extern angeschlossenen Taster. Dieses Verhalten kann man mit dem Register ''confBtnTime'' beeinflussen. Bis zum Ablauf der dort einstellbaren Zeit (in Minuten) nach dem Versorgen mit Strom (powerUp) erreicht man den Konfigurationsmodus wie bisher, danach interpretiert der Aktor die Tastendrücke stets als kurz (short) oder lang (long). Beispiel:
:<code>set <name> regSet confBtnTime 2</code>
Möchte man den Aktor später zurücksetzen oder lokal konfigurieren, so erreicht man das ursprüngliche Verhalten in diesem Beispiel für die ersten zwei Minuten, nachdem man den Aktor (ausreichend lange) stromlos gemacht hat.

==== ''intKeyVisib'' - Interne Tasten sichtbar machen ====
Die internen "Tasten" eines Aktors (z.B. die Schaltwippe bei Wandschaltern/-tastern, der Bedienknopf bei Zwischensteckern, aber auch die angeschlossenen externen Taster bei Aktoren für Unterputzdosen oder die von außen zugängliche "Notbedientaste" etwa bei Zwischendecken-Dimmern) sind logisch ebenso mit dem Aktor verknüpft wie externe Bedienelemente wie Funkfernbedienungen oder per Funk verknüpfte Wandtaster. Ihre Betätigung wird (außer mit präparierter Firmware) zwar nicht gesendet (und kann daher von FHEM nicht "gelesen" werden), die vom Hersteller vorgesehenen Funktionen lassen sich aber genauso frei programmieren. Allerdings sind diese internen Verknüpfungen zur Vermeidung versehentlicher Programmierungen zunächst verborgen und müssen daher explizit sichtbar gemacht werden.

Dies geschieht mit
set <name> regSet intKeyVisib visib
attr <name> expert 1
Anschließend sind der oder die internen Taste(n) mit der Bezeichnung self01 (self02, ...) sichtbar und ihre Aktionen können gezielt wie bei einem externen Peer umprogrammiert werden.

Wer nun auf die Idee kommt, man könne durch entsprechendes zusätzliches peering bei mehrkanaligen Geräten die (mehreren) internen Tasten beliebig zuweisen und so raffinierte Zusatzschaltungen auslösen, muss hier enttäuscht werden: Zwar kann man tatsächlich mit peerBulk bei den Aktorkanälen zusätzliche interne Peers eintragen und programmieren und mit einer Fernauslösung aus FHEM die neuen Verknüpfungen erfolgreich nutzen - das Gerät selbst reicht die Tastenbetätigungen aber immer nur an den ursprünglich dafür vorgesehenen Kanal weiter.

==== ''ledMode'' - Funktion der Onboard-LED bei Bausätzen ====
Die (batteriebetriebenen) -PCB-Aktoren und die 8-Kanal-Module haben kleine LED an Bord, die für Diagnosezwecke hilfreich sind, einem sparsamen Betrieb aber in der Regel entgegenstehen. Sie werden daher nur bei außergewöhnlichen Zuständen wie dem Anlernmodus, einem Reset, oder auch bei niedriger Batteriespannung als Hinweis an den Anwender benutzt und sind ansonsten ab Werk deaktiviert. Bei einer Dauerstromversorgung kann aber eine Schaltzustandsanzeige oder eine Quittung über eine Befehlsaussendung nicht nur zur Diagnose hilfreich sein.

Besitzt das Gerät das Register ''ledMode'', so kann man mit
:<code>set <device> regSet ledMode on</code>
die LED auch für die "normalen" Betriebszustände aktivieren. Sie zeigen dann bei Aktoren, ob der Aktor eingeschaltet ist (blinkend, wenn eine Einschaltzeitbegrenzung aktiv ist), und bei den Sensormodulen HM-Mod-EM8(bit) zeigt die zweifarbige LED den von Fernbedienungen bekannten Sendezustand mit gelb, dem dann ein grün oder rot folgt - je nachdem ob eine Quittung angefordert ist und ob sie erfolgreich empfangen wurde.

Leider lässt sich umgekehrt die bei Wandtastern oder Fensterkontakten mitunter gewünschte Deaktivierung der LED nicht so bewerkstelligen - diese Geräte haben das entsprechende Register nicht. Da hilft nur ein Eingriff ins Gerät mit Gaffa oder schwarzem Edding...

=== Kanalbezogene Register ===
Kanalbezogene Register existieren für jeden Kanal eines Gerätes einmal und werden in der sogenannten '''List1''' gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter ''RegL_01.'' zu finden).

==== ''powerUpAction'' - Automatischer Knopfdruck bei (wiederkehrender) Stromversorgung ====
Mit diesem Register (default ''off'') kann erreicht werden, dass ein Schaltaktor nach einem Stromausfall sich bei Wiederkehr der Versorgungsspannung automatisch einschaltet. Dies ist z.B. sinnvoll für Zwischenstecker mit Messfunktion ([[HM-ES-PMSw1-Pl Funk-Schaltaktor 1-fach mit Leistungsmessung|HM-ES-PMSw1-Pl]]), wenn dieser als Langzeitmonitor etwa für Kühlgeräte verwendet wird - nach einem Stromausfall bliebe der Kühlschrank sonst aus und der Inhalt würde verderben.
:<code>set <name> regSet powerUpAction on</code>
Achtung: Das Setzen dieses Registers auf ''on'' bedeutet nicht immer einen eingeschalteten Aktor nach der Wiederkehr der Stromversorgung. Vielmehr wird nur ein ''short''-Ereignis auf den zugehörigen internen Taster ausgelöst, was nur im Normalfall zum Einschalten des Aktors führt - nicht aber wenn die Funktion dieses kurzen Tastendruckes gezielt verändert wurde, denn dann wird eben diese Aktion ausgeführt! Das gilt zum Beispiel auch für zeitlich begrenztes Einschalten. Als Alternative für eine lokale Schaltmöglichkeit bietet sich in solchen Fällen der lange Tastendruck an, sofern er vom Aktor unterstützt wird (so lässt sich die Einschaltzeit bei langem Tastendruck mit ''lgOnTime'' begrenzen). Dessen Aktion wird bei powerUp nicht ausgeführt.

=== Verknüpfungsbezogene Register ===
Diese Register sind am umfangreichsten und werden für jeden Verknüpfungspartner einzeln separat angelegt in der '''List3''' (''RegL_03.<peer>''). Die grundsätzlichen Funktionen und ihre Zusammenhänge sind ausführlich in der Einsteigerdokumentation erklärt, inklusive Skizzen für die sogenannte ''state machine''. Hier sollen daher nur die in den folgenden Beispielen verwendeten Register erklärt werden.

==== ''shOnTime'' und ''lgOnTime'' - das interne ''on-for-timer'' von Schaltern oder Dimmern ====
Die wohl populärsten Register begrenzen die Einschaltzeit eines Aktors. Um z.B. eine Steckdose für 10 sec bei Knopfdruck lokal einzuschalten kann man folgendes programmieren:
:<code>set <name> regSet shOnTime 10 self01 </code>

''shOnTime'' ist dabei das zuständige Register für die Einschaltzeit bei kurzem (sh=short) Tastendruck, entsprechend gilt ''lgOnTime'' für einen langen Tastendruck.

In den Readings werden die Register mit dem jeweiligen verknüpften Taster angezeigt, in unserem Fall also:
:<code>R-self01-shOnTime </code>

Der Defaultwert für shOnTime ist 111600 und bedeutet unendlich (von FHEM mit "unused" dargestellt), d.h. die maximale einstellbare Zeit ist 111599 sec (knapp 31 Stunden). So kann man die Zeit löschen:
:<code>set <device> regSet shOnTime 111600 self01 </code>
oder
:<code>set <device> regSet shOnTime unused self01 </code>

Übrigens gibt es diese Register auch für die Ausschaltzeit.

==== ''shCtOn'' und ''shCtOff'' - Bedingtes Schalten mit Schwellwerten ====
Fernbedienungen (im weitesten Sinne, ''remote'') von HomeMatic übermitteln je nach Betätigungsdauer ''short''- oder ''long''-Trigger. Zustandsübermittelnde Sensoren (etwa ein Fensterkontakt oder Neigungssensor sowie Bewegungsmelder) senden ausschließlich ''short'', gekoppelt mit einem Wert zwischen 0 und 200, entsprechend 0-100% in 0,5-%-Schritten. Ob ein solcher Trigger vom Aktor verarbeitet wird, kann vom gesendeten Wert abhängen.

HomeMatic kennt dazu (für jeden Peer und Triggertyp (short/long) separat) zwei Schaltschwellen Lo und Hi, die default bei 50 und 100 liegen. Ob ein Trigger in Relation zu diesen Schwellen verarbeitet wird, regeln u.a. die shCtxxx-Register. Wie auch bei den allgemeinen Schaltbedingungen stehen ''On'' und ''Off'' jeweils für den aktuellen Schaltzustand (Achtung: nicht den, der erreicht werden soll). Ihr Wert beträgt default "geLo" (greater or equal Lo), hier 50 und höher. Trigger für Werte darunter werden bei der Einstellung "ltLo" (less than Lo) verarbeitet. Diese Schwellen gibt es entsprechend auch für den Hi-Wert, also "geHi" oder "ltHi". Besonders interessant sind aber auch die Werte "outside" und "between", bezogen auf die beiden Schwellen Lo und Hi. In letzterem Fall wird der Trigger verarbeitet, wenn der Wert zwischen 50 und 100 liegt, bei "outside" entsprechend bei 0-49 oder 101-200.

Sogenannte Three-State-Sensoren wie Fensterkontakt- oder -griffsensoren senden 0 für "closed" (geschlossen), 100 für "tilted" (gekippt) und 200 für "open" (offen). Gleiches gilt für Schalterkontaktinterfaces, die den Zustand eines angeschlossenen Schaltkontaktes übermitteln. Im Grundzustand (Vergleichsbefehl auf "geLo") führt daher nur der Trigger "offen" (200) zu einer Aktion. Ändert man den Vergleichsbefehl auf "ltLo", so wird lediglich "closed" ausgewertet, bei "between" ist es "tilted". Mit "outside" führt sowohl "closed" als auch "open" zu einer Aktion.

Bei Bewegungsmeldern wird der mit übermittelte Helligkeitswert im Zusammenhang mit den (dann variabel einzustellenden) Schwellen als Kriterium für das Einschalten des Aktors mit herangezogen.

==== ''shSwJtOn'' & Co. - Was soll passieren? ====
Nachdem wir nun kennengelernt haben, wie man auswählt, '''welcher''' Anstoss von außen zu einer Aktion führt, hier ein kleiner Exkurs in die Beeinflussung, '''was''' daraufhin passieren soll. Diese Frage regelt die ''jump table'' und liefert damit das Regelwerk für die Abfolge der Aktionen, die ''state machine''. Ein HomeMatic-Aktor geht nämlich keineswegs einfach nur an oder aus. Vielmehr hangelt er sich nacheinander an einer Reihe von Zuständen entlang - auch das ist in der Einsteigerdokumentation erschöpfend beschrieben und soll hier nicht wiederholt werden. Ein Schalter durchläuft aber mindestens die Zustände
Aus > Einschaltverzögerung > Ein > Ausschaltverzögerung > Aus > (usw)
Hier soll reichen, dass am Ende jeder (Teil-)Kette in der Regel ein dauerstabiler Zustand bleibt, in der Regel ist das der Aus-Zustand und auch der Ein-Zustand, wenn dessen Laufzeit nicht durch ''shOnTime'' & Co. begrenzt ist. Ein- und Ausschaltverzögerung sind aber in der Regel 0 (Sekunden), so dass effektiv nur "Ein" und "Aus" übrig bleiben.

Das Register ''shSwJtOn'' regelt, wohin die Reise geht, wenn ein gültiger ''short''-Trigger im eingeschalteten Zustand eintrifft, sinngemäß ''...Off'' im Auszustand und ''lg...'' für die ''long''-Trigger. Für ''shSwJtOn'' ist normalerweise als nächstes die Ausschaltverzögerung "dlyOff" vorgesehen. Da die Ausschaltverzögerung in der Regel 0 ist, folgt darauf, in ''shSwJtDly'' festgelegt, "off" usw. Die Zustände bilden so quasi einen Kreis, dessen Durchlauf von außen gelegentlich "angeschubst" wird. Mit diesen Registern kann man den Kreislauf aber auch umbiegen oder sogar unterbrechen, so dass ein eintreffender Trigger eben nicht zu einer Aktion führt. Als Ziele bieten sich, quasi selbstsprechend, "on", "dlyOff", "off" und "dlyOn" an - oder eben "no", was nichts anderes bedeutet, als dass der betreffende Trigger an dieser Stelle zu keiner Aktion führt.

Bei einem Dimmer heißen die Register statt ''..Sw....'' nur ''..Dim....'' und es gibt ein paar mehr Bedingungen - die Funktion ist aber entsprechend gleich.

==== ''shOnDly'' und ''shOffDly'' - es muss nicht immer sofort sein! ====
Nicht nur welcher Anstoße welche Aktion auslöst, sondern auch wann oder wie schnell die Aktion ausgeführt wird, lässt sich in gewissen Grenzen einstellen. Die beiden genannten Register etwa regeln die Ein- oder Ausschaltverzögerung nach einem gültigen Trigger. So kann man nach einem Ausschaltbefehl einen Raum noch im Hellen verlassen, wenn das Licht noch ein paar Sekunden länger leuchtet.

Bei Dimmern gibt es zusätzlich auch bei Ein- und Ausschaltvorgängen durch eine neu eingerichtete Verknüpfung eine sogenannte Rampenzeit von 0,5 Sekunden, in der das Licht hoch- oder heruntergedimmt wird. Durch Programmierung von ''shRampOnTime'' und ''shRampOffTime'' kann man ein sehr augenschonendes langsames Ein- oder Ausschalten des Lichts wie im Kino erreichen. Zwar gibt es die Zeiten auch für long-Trigger, aber da machen sie im Normalfall wenig Sinn - der lange Tastendruck löst immer einen manuellen Dimmvorgang aus.

''(wird ergänzt)''

== Praktische Beispiele ==
Die folgenden Beispiele beschreiben nur in Kurzform die erforderlichen Aktionen. Weiterführende Informationen sind der Einsteigerdokumentation oder den o.g. Registerbeschreibungen zu entnehmen.
Übrigens: ein einmal konfigurierter Vorgang für eine Verknüpfung kann aus FHEM auch bequem fernausgelöst (bzw. simuliert) werden. Der Aktor führt dabei genau die Aktion aus, die für die benannte Verknüpfung vorgesehen ist. Der kurze Knopfdruck auf den internen Knopf eines Aktors wird beispielsweise so simuliert:
:<code>set <device> press short self01 </code>

=== Lokal bedienbarer Zeitschalter mit HomeMatic Aktoren: Pool für eine Stunde schalten ===
Ich habe einen HM-LC-SW4-DR und der channel_01 schaltet die Poolzirkulationspumpe. Dies passiert zeitgesteuert zweimal am Tag. Manchmal möchte ich im Keller diese Pumpe einfach für eine Stunde aktivieren, der Aktor ist bequem erreichbar an der Wand.
Die internen Tasten vom Hauptdevice (der Aktor hat vier Kanäle (channel), die in FHEM einzeln dargestellt werden) sichtbar machen:
set LichtKeSW1 regSet intKeyVisib visib
attr LichtKeSW1 expert 1

Jetzt sieht man im Channel 01 - LichtKeSW1_Sw01 den internen peer self01. (Channel 02 ist self02 usw.)
Also jetzt einfach die Zeit eintragen:
set LichtKeSW1 regSet shOnTime 3600 self01

Die Toggle Funktion der Taste bleibt erhalten. Ein zweiter Tastendruck schaltet die Pumpe auch sofort wieder aus. Während die Zeit läuft, blinkt die Status LED des Kanals.
Die Zeitbegrenzung funktioniert in diesem Beispiel ohne jedes Zutun von FHEM und damit auch bei einem Ausfall des Servers.

=== Es werde Licht! Automatisches Licht mit Tor oder Tür ===
Im Kühlschrank geht das Licht ja schon praktischerweise automatisch an und aus, aber es gibt auch andere Situationen, in denen ein automatisches Licht sehr nützlich sein kann - in dunklen Abstellräumen oder Garagen. Vor allem weil man nicht vergessen kann es auszuschalten, weil es auch von allein ausgeht. Eine solche Funktion, so könnte man meinen, wird ganz einfach erreicht, indem man das Licht mit einem Aktor schalten lässt und diesen mit einem Tür- oder Fensterkontakt verknüpft. Hat man die beiden dann mit ''peerChan'' verknüpft, so wird man feststellen, dass das Licht mitnichten das Gewünschte tut: es schaltet sich beim Öffnen der Tür abwechselnd ein und aus und ignoriert das Schließen der Tür komplett.

Verantwortlich für dieses "Fehlverhalten" sind die Register ''shCtOn'' und ''shCtOff''. Beide stehen nach der Verknüpfung auf "geLo". Wie bei den Registern oben erläutert, führt in diesem Fall nur die "offen"-Meldung des Türkontaktes zu einer Aktion. Das Öffnen der Tür soll den Aktor einschalten, das klappt. Das Schließen der Tür soll den eingeschalteten Aktor aber ausschalten. Also muss die Schaltbedingung im On-Zustand geändert werden (die Bezeichnungen natürlich durch die realen Namen des Schaltaktorkanals und des Türkontaktes ersetzen):
:<code>set <Schalter> regSet shCtOn ltLo <Türkontakt> </code>
Nun führt auch das Schließen der Tür wunschgemäß stets zu einem Abschalten des Lichts. ''shCtOff'' muss auf "geLo" bleiben!

Kombinieren ließe sich das noch mit einer Laufzeitbegrenzung etwa für eine Stunde - sollte man die Tür versehentlich offenlassen, so brennt das Licht nicht stundenlang. Vor allem geht das Licht dann auch aus, wenn aus welchem Grund auch immer die Schließmeldung verloren geht.
:<code>set <Schalter> regSet shOnTime 3600 <Türkontakt> </code>

=== Lampe mit Kippschalter(n) fernschalten - eindeutig oder als Wechselschaltung ===
Oft besteht der Wunsch, eine Lampe mit einem herkömmlichen Schalter (statt eines Tasters) fernzuschalten. So kann man einen herkömmlichen Schalter mit einer Schließerkontaktinterface wie dem [[HM-SCI-3-FM 3-Kanal-Funk-Schließerkontakt-Interface|HM-SCI-3-FM]] ergänzen (oder einem Kanal des [[HM-MOD-EM-8 8-Kanal-Sendemodul|8-Kanal-Sendemoduls]] in der Betriebsart ''sensor'') und wiederum die Verknüpfung mit dem Lampen-Aktor setzen. Ganz ähnlich wie bei der vorgenannten Abstellraum-Aufgabe führt nun aber das Schließen des Schalters nicht zu einem Einschalten. Daher ist nun
:<code>set <Lampenaktor> regSet shCtOff ltLo <Sensorkontakt> </code>
das Mittel der Wahl, ''shCtOn'' muss dieses Mal auf "geLo" bleiben. Jetzt folgt der Aktor dem (sichtbaren) Schaltzustand des Schaltes - zumindest solange er nicht anderweitig ein- oder ausgeschaltet wird.

Nun kann man auch mehrere Schalter so mit der Lampe koppeln. Das ergibt aber keine Wechselschaltung im herkömmlichen Sinn - um eine Lampe ein- oder auszuschalten, muss man den Schalter möglicherweise einmal zusätzlich auf die aktuelle Schaltposition kippen, ehe die nächste Betätigung den gewünschten Effekt bringt. Für Wechselschaltungen bietet sich daher das Kontaktinterface [[HM-SwI-3-FM]] (oder das erwähnte 8-Kanal-Sendemodul in der Betriebsart ''switch'') an. Hier führt jede Zustands''änderung'' zu einem Schaltvorgang.

Hat man hingegen nur ein HM-SCI-3-FM zur Hand, lässt sich dieses Verhalten auch erreichen:
:<code>set <Lampenaktor> regSet shCtOn outside <Sensorkontakt> </code>
:<code>set <Lampenaktor> regSet shCtOff outside <Sensorkontakt> </code>

=== Gezieltes Schalten eines (unsichtbaren) Aktors mit nur einer Taste ===
Für so etwas braucht man gewöhnlich zwei Tasten. Koppelt man einen Schalt-Aktor mit nur einer Taste ("single" beim ''peerChan''-Kommando), so führt sowohl ein kurzer als auch ein langer Tastendruck immer nur zu einem Umschalten des Zustandes. Das ist unschön, wenn man den aktuellen Zustand nicht einsehen kann.

Üblicherweise sind die Schaltabfolgen für eine Eintasten-Verknüpfung sowohl für kurze als auch lange Betätigungen gleich (bei Dimmern wird auf langen Tastendruck hingegen abwechselnd auf- oder abgedimmt).
shSwJtOff = dlyOn # Ist Gerät aus, wird Einschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOff = dlyOn # dito, für lang
shSwJtOn = dlyOff # Ist Gerät an, wird Ausschaltverzögerung gewählt (die aber normal 0 ist)
lgSwJtOn = dlyOff # dito, für lang
Hier kann man sich zunutze machen, dass man mit einem gezielten "no" oder "dlyOn" bzw. "dlyOff" im richtigen Register die Schaltfolge abbrechen oder umbiegen kann.
Möchte man das Gerät <aktor> mit einem kurzen Tastendruck auf <button> ein- und mit einem langen Tastendruck ausschalten, so ändere man:
:<code>set <aktor> regSet shSwJtOn dlyOn <button> </code>
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>
So laufen die entsprechenden Aktionen quasi ins Leere, wenn der Aktor bereits den gewünschten Zustand hat.

Den umgekehrten Effekt (lang schaltet ein, kurz aus) erreicht man entsprechend mit
:<code>set <aktor> regSet shSwJtOff dlyOff <button> </code>
:<code>set <aktor> regSet lgSwJtOn dlyOn <button> </code>

Welche Bedienhaptik man nun bevorzugt, muss man selbst entscheiden. In der Regel sollte die normale (sichere) Aktion "kurz" und die gefährlichere "lang" sein - eine PC-Stromversorgung mit einem kurzen Tastendruck versehentlich einzuschalten ist bestimmt besser als auszuschalten (das dann eben nur über lang) - für ein potentiell gefährliches Arbeitsgerät wie einen Heizofen wird es sicher andersherum sein.

Sinngemäß verwendet der Autor sozusagen eine Hälfte davon als "Sicherheitsaktion" für einen [[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach]] - der gewöhnliche Tastendruck auf die zugehörige Wippenseite schaltet den Aktor abwechselnd ein und aus, ein langer Tastendruck immer aus, dafür reicht:
:<code>set <aktor> regSet lgSwJtOff dlyOff <button> </code>

Übrigens: Nichts anderes wird normalerweise auch automatisch beim Verknüpfen eines Aktors mit einem Tastenpaar an der entsprechenden Stelle gemacht - ist eine Taste nur zum Ausschalten gedacht, so wird in beiden Schaltzuständen entsprechend "dlyOff" eingetragen. Als "Sprungziel" müsste aber genauso gut auch "no" funkionieren.

=== WARNUNG! - Selbsttätiges Blinken eines HM-Aktors ===
Statt einer separaten Warnleuchte kann es durchaus sinnvoll sein, eine vorhandene Lampe zu Warnzwecken periodisch ein- und auszuschalten. Leider beherrschen die HomeMatic-Aktoren keine direkt aus FHEM erreichbare Blinkfunktion (ähnlich dem on-for-timer für eine Zeitbegrenzung), und das rhythmische Ein- und Ausschalten aus FHEM erzeugt eine recht hohe Funklast.

Wir wissen aber, dass die Aktoren für jeden Peer nicht nur eine Ein-, sondern auch eine Ausschaltzeit speichern. Definiert man nun für einen Peer entsprechend beide Zeiten, so wird der Aktor bei einem Telegramm von diesem Peer sich entsprechend selbsttätig fortlaufend ein- und ausschalten. Jeder andere Schaltbefehl eines anderen Peers oder aus FHEM beendet die Schleife umgehend. So ließe sich das Blinken auch mit einer aktoreigenen Taste stoppen - oder starten, wenn man es entsprechend programmiert. Einen Zwischenstecker-Schalter beispielsweise kann man also (wenn man zuvor seine ''confBtnTime'' entsprechend setzt und so die langen Tastendrücke auswertbar macht) durch das Programmieren von ''lgOnTime'' und ''lgOffTime'' für den Peer "self01" wie gewohnt mit einem kurzen Tastendruck ein- und ausschalten und mit einem langen in den Blinkmodus versetzen.

Einen Haken hat die Sache aber: Der Aktor meldet seinen neuen Schaltzustand nach jeder Änderung mit einer gewissen Verzögerung, die man bei vielen Schaltaktoren (aber leider nicht bei allen wie etwa dem HM-Mod-Re-8) mit dem Register ''statusInfoMinDly'' tunen kann. Ändert der Aktor seinen Schaltzustand in längeren Intervallen, wird es also trotzdem wieder ein Funkfeuer geben. Ist das Delay noch nicht erreicht, erfolgt keine Zustandsübermittlung. Beim HM-Mod-Re-8 muss man also etwa unter 1 Sekunde pro Änderung bleiben.

Zum Steuern aus FHEM emfiehlt es sich, virtuelle Buttons (etwa einer VCCU oder eines virtuellen HM-Dummys) zum Ein- und Ausschalten der Blinkfunktion zu verwenden. "Opfert" man dafür zwei aufeinanderfolgende Kanäle, kann man die Aktoren mit "dual set" peeren und bekommt so einen Blink- und einen Deaktivierungsbutton ohne weitere Kopfstände. Anschließend passt man die short-Laufzeiten für den Einschaltkanal an.

Ein Beispiel für einen Dimmer (als virtuelle Buttons dienen vccu_Btn8 und vccuBtn9):

:<code>set <vccu_Btn7> peerChan 0 <dimmerkanal> dual set</code>

Nun kann man mit "set vccu_Btn8 press short" den Dimmer ein- und mit "set vccu_Btn7 press short" ausschalten. Das Blinken im Dimmer wird eingestellt mit

:<code>set dimmer regSet shOnTime 1 vccu_Btn8</code>
:<code>set dimmer regSet shOffTime 1 vccu_Btn8</code>
jeweils für die gewünschte Ein- und Ausschaltzeit.

Wird der Dimmer nun mit "set vccu_Btn9 press short" eingeschaltet, so blinkt er im 3-Sekunden-Takt: zu den jeweils 1 Sekunde Ein- und Auszeit gesellen sich noch 2x 0,5s Rampenzeit, sofern nichts anderes programmiert wurde.

Das funktioniert auch mit Schaltern: So würde 0.1 und 0.9 (Sekunden) ein kurzes Blitzen im Sekundentakt einstellen.

Natürlich kann man nun eine größere Anzahl von Aktoren mit den virtuellen Buttons peeren und so ein ganzes Feuerwerk zünden ... Ein zusätzlich zu Alarmsirenen wild blinkende Innenbeleuchtung in allen Räumen sorgt sicher für zusätzliche Aufmerksamkeit.

=== Einer nach dem Anderen! - Sequentielles Schalten mehrerer Aktoren ===
Eine großflächige Beleuchtung mit viel Leistung sollte man aus Lastgründen niemals zugleich einschalten. Auch LED-Lampen ziehen im Einschaltmoment, wennauch extrem kurz, beträchtliche Ströme, die die von gewöhnlichen Glühlampen deutlich übersteigen können. Schaltet man mehrere Aktoren gleichzeitig mit einer Taste, so hilft eine individuelle Verzögerung des Einschaltvorgangs in jedem Aktor, die Sicherung vor dem Herausfliegen zu bewahren. Oder man macht gezielt einen Effekt daraus. Der Phantasie sind wenig Grenzen gesetzt...

Hat man drei Aktoren "Aussenlicht1...3" mit dem Taster "Aussenlicht_Ein" gepeert, so erreicht man auf folgende Weise, dass sie beim Einschalten mit einer Verzögerung von jeweils einer Sekunde nacheinander einschalten.

:<code>set Aussenlicht2 regSet shOnDly 1 Aussenlicht_Ein</code>
:<code>set Aussenlicht3 regSet shOnDly 2 Aussenlicht_Ein</code>

[[Kategorie:HomeMatic Components|1toolsAndWork]]

HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter

2018-09-24T09:25:19Z

Pfriemler: /* Mögliche Hardwaredefekte */

{{Infobox Hardware
|Bild=HM-LC-Bl1PBU-FM.jpg
|Bildbeschreibung=HM-LC-Bl1PBU-FM montiert, ohne Adapter
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Blind|Blind]]
|HWCategory=[[:Kategorie:Rollladensteuerung|Rollladensteuerung]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=0,5 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
== Features ==

Schalten eines angeschlossenen Jalousiemotors mittels CUL/CUN/HMLAN Konfigurator und über lokalen, in bestehendes Schalterprogramm integrierte Schaltwippe.

'''Technische Daten:'''
* Gerätebezeichnung: HM-LC-Bl1PBU-FM
* Versorgungsspannung: 230 V / 50 Hz
* Maximale Schaltleistung: 230 VA (Motorlast)
* Standby-Verbrauch: 0,5 W
* Schaltvermögen: 1 A (Motorlast)
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5°C bis +35°C
* Abmessungen (B x H x T): 71 x 71 x 37 mm
* Gewicht: 43 g

== Hinweise zur Hardware-Installation ==

Der Schaltaktor ersetzt den Unterputzschalter der bestehenden Elektroinstallation. Arbeiten am 230 V Netz dürfen nur von einer Elektrofachkraft durchgeführt werden! Sicherheitsregeln anwenden:

* Freischalten (Sicherung abschalten),
* gegen Wiedereinschalten sichern,
* Spannungsfreiheit feststellen, (Messgerät vor und '''nach''' Messung auf Funktion überprüfen)
* Erden und Kurzschließen,
* benachbarte, unter Spannung stehende Teile abdecken.

Zur Integration in ein bestehendes Schalterprogramm bitte den entsprechenden Adapter mit bestellen.

<gallery>
Datei:HM-LC-BL1PBU schritt 01.jpg|Ausgangssituation
Datei:HM-LC-BL1PBU schritt 02.jpg|Schalter abbauen, Rahmen entfernen, Unterputzschalter lösen
Datei:HM-LC-BL1PBU schritt 03.jpg|Bestehender Anschluss
Datei:HM-LC-BL1PBU schritt 04.jpg|Neuer Anschluss. Achtung: zusätzlicher Nullleiteranschluss!
Datei:HM-LC-BL1PBU schritt 05.jpg|Einbau ohne Adapter
Datei:HM-LC-BL1PBU schritt 06.jpg|Adapter aufsetzen
Datei:HM-LC-BL1PBU schritt 07.jpg|Fertig eingebauter HM-LC-BL1PBU-FM
</gallery>

== Hinweise zum Betrieb mit FHEM ==

Der Schalter wird seit FHEM 5.3 unterstützt. Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Dazu wird der Config-Taster kurz gedrückt.
Zur Darstellung im Webfrontend siehe [[Slider für HM-Rolladensteuerung anzeigen]].

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

define WZ_Rollo_Links CUL_HM ABCDEF
attr WZ_Rollo_Links devInfo 010100
attr WZ_Rollo_Links eventMap on:hoch off:runter stop:stop
attr WZ_Rollo_Links firmware 2.1
attr WZ_Rollo_Links hmClass receiver
attr WZ_Rollo_Links model HM-LC-Bl1PBU-FM
attr WZ_Rollo_Links room Wohnzimmer
attr WZ_Rollo_Links serialNr JEQxxxxxxx
attr WZ_Rollo_Links subType blindActuator
attr WZ_Rollo_Links webCmd pct

=== Variablen===
==== Attribute====
Dem Device können neben den Allgemeinen auch spezielle Attribute gesetzt werden.
* '''param levelInverse''': HM Blind Aktoren stehen auf 100% wenn sie offen sind und auf 0% wenn sie geschlossen sind. Das ist oftmals nicht intuitiv. In FHEM kann man dies "drehen" durch dieses Attribut. Damit dreht sich auch die Bedeutung von On und Off.
Zur optimalen Anbindung an Homebridge-/HomeKit empfiehlt es sich, die beiden folgenden Attribute zu setzen:
: '''genericDeviceType''': blind
: '''subType''': blindActuator

Desweiteren empfehlen sich die üblichen Homematic Attribute (wie autoReadReg, event-on-change-reading, expert) zu setzten. Weitere Informationen dazu unter [[HomeMatic#Attribute]]

==== Readings====
*'''level''' numerischer Wert der den Stand des Rollo wiedergibt. Achtung: Der Aktor kennt nicht den Stand des Rollos sondern errechnet diesen aus den Fahrzeiten. Nach einem powerUp wird ein Stand von 50% angenommen.
*'''motor''': zeigt den Zustand des Motors an, ob er steht oder in welche Richtung er fährt
*'''pct''': analog "level"

== Konfiguration==
Die Konfiguration des Devices betrifft Register und Peerings. Dies sind Werte, die zwar über FHEM gesetzt werden, aber im Device im Flash gespeichert werden.
Man kann die Devices mit Sensoren und Tastern [[Peering (HomeMatic)|peeren]]

===Fahrzeiten kalibrieren===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese 3 Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden

=== Tasterverhalten ===
Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung:

* Die internen Taster sichtbar schalten und die config abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (alte Variante via Register)
set <device> regBulk RegL_03:self01 0B:94 0D:63 8B:94
set <device> regBulk RegL_03:self02 0B:18 0D:63 8B:18

* Die Taster konfigurieren (neue Variante via Template, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self02:short
set <HMinfo> templateSet <device> BlStopDnSh self01:short
set <device> getConfig

* Die internen Taster unsichtbar schalten und die config überprüfen
set <device> regSet intKeyVisib invisib
set <device> getConfig

Wichtig: bei der alten Variante nach jedem Schritt jeweils die Anlern-Taste drücken und in den Internals schauen ob die kommandos ohne Fehler abgearbeitet wurden.

== Mögliche Schaltoperationen ==

Der Aktor versteht folgende Befehle:
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors.
set <name> <Prozentangabe[0 bis 100]> -> Öffnet die Jalousie auf absolut prozentuale Öffnungsposition, berechnet aus definierter Laufzeit.
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%

== Log-Auszug ==
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:
2013.02.26 07:00:12 2: CUL_HM set WZ_Rollo_Rechts on rxt:1

== Mögliche Hardwaredefekte ==

Wenn der Rolladenaktor nur noch lokal reagiert oder den Rolladen nur für ein kurzes Stück fährt und aus FHEM nur mit fortgesetzten Schwierigkeiten zu erreichen ist, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C26. (Einen vergleichbarer Defekt tritt auch häufig beim Schaltaktor [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf.)

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, Rastermaß (RM) 2,5 (mm) radial (stehend), 10µ/25V (Ersatz mit höherer Spannung natürlich unproblematisch möglich). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L21) und der Diode D20. Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

== Links ==
* [http://www.elv-downloads.de/Assets/Produkte/10/1030/103038/Downloads/103038_FunkRollladenaktor_um.pdf Bedienungsanleitung (PDF)]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]
[[Kategorie:868MHz]]

HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach

2018-09-24T09:24:58Z

Pfriemler: /* Mögliche Hardwaredefekte */

{{Infobox Hardware|Bild=HM-LC-Sw1PBU-FM_Front.jpg
|Bildbeschreibung=HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach für Markenschalter
|HWProtocol=HomeMatic
|HWType=Aktor / Sender
|HWCategory=HomeMatic
|HWComm=868,3MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=0,5W (Standby)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=eQ-3}}

[[HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach]] ist ein einkanaliger Funk-Schaltaktor "für Markenschalter", der mittels entsprechender Installationsadapter mit Tasterwippen diverser renommierter Hersteller versehen werden kann und sich dadurch nahtlos in bestehende Elektroinstallationen einfügt.

== Features ==
Das besondere an diesem Schalter ist, dass er den vorhandenen Unterputzeinsatz vollständig ersetzt. Dabei kann die Wippe des vorhandenen Schalters - je nach Hersteller - mit einer entsprechenden Adapterplatte weiterverwendet werden.

Es handelt sich hierbei nur um einen Aktor. Es ist nicht möglich die Taster mit anderen Homematic Geräten zu peeren. Man kann nur andere Taster mit dem Aktor peeren und diesen fernsteuern.

== Technische Daten ==

{|
| Art
| Unterputz
|-
| Typ
| 1fach
|-
| Stand-by-Verbrauch
| 0,5 W (lt. Bedienungsanleitung, S. 31, Stand 02/2012, 1 W)
|-
| Versorgungsspannung
| 230 V
|-
| Abmessungen (B x H x T)
| 71 x 71 x 37 mm
|-
| Farbe
| Grau
|-
| Max. Schaltleistung
| 1000 W
|-
| Relaistyp
| Wechsler
|-
| Funkfrequenz
| 868,3 MHz
|-
| Empfängerklasse
| SRD Class 2
|-
| Sicherung (intern)
| Rundsicherung 5 A, träge
|-
| Max. Sendeleistung
| 10 mW
|-
| IP-Schutzgrad
| IP 20
|-
| Umgebungstemperaturbereich
| 5–35 °C
|}

== Hinweise zur Hardware-Installation ==
Der vorhandene Schalter muss ersetzt werden. Dabei sind ein paar Dinge zu beachten:

* Der (neue) Schalter benötigt neben dem L-Leiter auch einen N-Leiter für die Stromversorgung.
* Die Befestigung ist nicht wie bei dem System z.B. von Merten durch Spreizen von Klammern möglich. Der Schalter muss in die Löcher in der Dose geschraubt werden (Schrauben im Lieferumfang enthalten).
* Die "Frontplatte" bzw. der Befestigungsrahmen ist etwas dicker als der Rahmen eines normalen Schalters. Dadurch kann es sein, dass der vorhandene Rahmen des Schalters nicht mehr ganz an der Wand anliegt.
* Um die bereits vorhandene Schalter-Wippe weiter nutzen zu können, muss ein passender Adapter verwendet werden.

{{Randnotiz|RNText='''Info zum Bausatz'''
Das Gerät ist als Bausatz verfügbar, es sind die folgenden bedrahteten Bauteile einzulöten:
* 6 Kondensatoren
* 3 Stiftleisten/Fassungen (insgesamt 16 Pole)
* 1 Spannungsregler, 1 Diode
* 1 Relais (8 Pole)
* 1 Induktivität
* 1 Widerstand, 1 Varistor
Die zu lötenden Bauteile sind relativ unproblematisch, die Lötstellen befinden sich jedoch in drei Fällen sehr nah an bzw. zwischen vorbestückten SMD-Bauteilen.}}
== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:

<pre>
define LichtWohnzimmer CUL_HM 197764
attr LichtWohnzimmer devInfo 010100
attr LichtWohnzimmer firmware 2.1
attr LichtWohnzimmer hmClass receiver
attr LichtWohnzimmer model unknown
attr LichtWohnzimmer room Wohnzimmer
attr LichtWohnzimmer serialNr JEQ0xxxxxx
attr LichtWohnzimmer subType switch
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet
</pre>

Zusätzliche Funktionen wie ein direkter Zugriff auf die integrierten Taster (self01 und self02) des Schalters können durch Programmieren der [[HomeMatic_Register_programmieren | HomeMatic Register]] realisiert werden.

Dabei entspricht self01 dem Ausschalter des Wippschalters und self02 dem Einschalter des Wippschalters. Settings, die man also für den self01 Schalter einstellt, werden beim Ausschalten des Lichts (im Standard) angewandt und umgekehrt.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-Sw1PBU-FM folgendes Log zu sehen:
<pre>
2012-06-05_00:09:22 LichtWohnzimmer deviceMsg: off
2012-06-05_00:09:22 LichtWohnzimmer off
2012-06-05_07:40:51 LichtWohnzimmer on
2012-06-05_07:40:51 LichtWohnzimmer deviceMsg: on
</pre>

Beim Einrichten des Schalters kommt folgender Auszug (Stand: 06.2012)
<pre>
2012.06.04 23:12:27 2: CUL_HM pair: CUL_HM_switch_197764 is a switch, model unknown serialNr JEQ0xxxxxx
</pre>

=== Funktion als Treppenlichtschalter ===
Um dafür zu sorgen, dass z.B. ein durch den HM-LC-Sw1PBU-FM eingeschaltetes Licht automatisch von FHEM nach 10 Minuten ausgeschaltet wird, kann folgende Definition verwendet werden:
:<code>define Beleuchtung_an notify Beleuchtung:on* define Beleuchtung_aus at +00:10:00 set Beleuchtung off </code>
Das Licht kann auch direkt über den Schalter nach 10 Minuten ausgeschaltet werden. Dies hat den Vorteil, dass die Funktion auch ohne FHEM funktioniert und keinen Funkverkehr verursacht. Wert ist in Sekunden also 60*10 für 10 Minuten. Es gibt zwei Schaltoperationen long press (lg) und short press (sh), short press ist ein kurzes antippen, long press ist den Schalter für ca. 1 Sekunde oder mehr gedrückt halten.
set <device> regSet shOnTime 600 self01
set <device> regSet lgOnTime 600 self01
set <device> regSet shOnTime 600 self02
set <device> regSet lgOnTime 600 self02

=== Workaround um den Taster in FHEM zu nutzen ===
Man kann den Taster in der Originalfirmware nicht mit anderen Geräten peeren. Allerdings kann man mit folgendem Workaround den Taster in FHEM nutzen. Das hat jedoch eine Verzögerung zwischen drei und acht Sekunden zur Folge. Dabei ist es trotzdem möglich, den Aktor per FHEM oder gepeertem Gerät weiter zu steuern. Der Taster beeinflusst den Aktor nicht mehr. Das ganze funktioniert, weil der HM-LC-Sw1PBU-FM bei jedem Tastendruck das reading für state aktualisiert, auch wenn sich der Wert nicht ändert.

Zuerst setzt man ein event auf event-on-change-reading:

attr HM-LC-Sw1PBU-FM event-on-change-reading state
attr HM-LC-Sw1PBU-FM event-on-update-reading state

Weiterhin wird der Schalter deaktiviert (hier nur für kurzen Tastendruck; mit lgSwJtXXX wird dieser Effekt auch für den langen Tastendruck erzielt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOn on self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self02
set HM-LC-Sw1PBU-FM regSet exec shSwJtOn on self02

Nun setzt man einen Notify auf das Reading:
:<code>define HM-LC-Sw1PBU-FM-TasterPressed notify HM-LC-Sw1PBU-FM {set YourOtherDevice toggle}</code>

=== Alternative Firmware ===
Um die beiden Taster als Remote und den Aktor getrennt zu nutzen gibt es alternative Firmware, deren Funktion und Benutzung auf der Seite [[HM-LC-Sw1PBU-FM Alternative Firmware]] im Detail beschrieben ist.

=== Schalter immer toggeln lassen ===
Im Werkszustand schaltet die Wippe bei Druck auf der einen Seite ein, auf der anderen Seite aus. Möchte man, dass bei jedem Tastendruck einfach der Zustand geändert wird, kann man das wie folgt erreichen (unten nur für den kurzen Tastendruck dargestellt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self01
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self01
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self01
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self02
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self02
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self02

Um den Werkszustand bezüglich Schaltwippe wiederherzustellen (eine Seite schaltet aus, die andere wieder ein) entsprechen folgende Einstellungen dem Werkszustand:
set <device> regSet shSwJtOn dlyOff self01
set <device> regSet shSwJtOff off self01
set <device> regSet shSwJtDlyOn off self01
set <device> regSet shSwJtDlyOff off self01
set <device> regSet shSwJtOn on self02
set <device> regSet shSwJtOff dlyOn self02
set <device> regSet shSwJtDlyOn on self02
set <device> regSet shSwJtDlyOff on self02

=== on-for-timer Ersatz ===
Der HM-LC-Sw1PBU-FM kennt kein <code>set on-for-timer</code>. Um den HM-LC-Sw1PBU-FM trotzdem für einige Zeit anschalten zu können (z. B. wenn ein Fensteröffner dranhängt und das Fenster nur für eine gewisse Zeit geöffnet werden soll), muss ein Button der vccu mit dem HM-LC-Sw1PBU-FM gepeered werden:
set vccu_Btn4 peerChan 0 HM-LC-Sw1PBU-FM dual set

Danach wären (in diesem Fall mit vccu_Btn4) die virtuellen Buttons 4 und 5 mit dem HM-LC-Sw1PBU-FM gepeered. Das Fenster könnte dann über <code>set vccu_Btn4 press short</code> für die vorher über <code>set HM-LC-Sw1PBU-FM regSet shOnTime [Dauer] vccu_Btn4</code> die Öffnungszeit eingestellt werden kann.

== Mögliche Hardwaredefekte ==

Wenn der Schalter zwischendurch immer wieder neu startet, bei lokaler Bedienung sofort wieder ausschaltet und aus FHEM kaum oder nicht ansprechbar und auch auf verknüpfte Sender nicht reagiert, kann ein Kondensator defekt sein, hier C26. (Ein vergleichbarer Defekt tritt auch häufig beim Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, Rastermaß (RM) 2,5 (mm) radial (stehend), 10µ/25V (Ersatz mit höherer Spannung natürlich unproblematisch möglich). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen neben einer Spule (L21). Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

== Links ==
* Anleitung (PDF {{DocLink|elv|/Assets/Produkte/10/1030/103029/Downloads/103029_FunkSchaltaktor_um.pdf}})
* Produktwebseite bei [http://www.elv.de/output/controller.aspx?cid=74&detail=10&detail2=37991 ELV]
* [[HM-LC-Sw1PBU-FM Alternative_Firmware|Alternative Firmware]]

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

HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP

2018-09-24T09:24:27Z

Pfriemler: /* Mögliche Hardwaredefekte */

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Dimmer|Dimmer]]
|HWCategory=[[:Kategorie:Dimmer|Dimmer]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=1 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
Der '''HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP''' ist ein Phasenabschnitts-Dimmer für die Unterputzmontage. Er verfügt über eine Schalterwippe, die sich mit einem Adapter in einige Schalterprogramme verschiedener Hersteller integrieren lässt. Der Dimmer kann sowohl vor Ort über die Schalterwippe als auch per Funk gesteuert werden.

== Features ==

Schaltdoseneinsatz als Ersatz für vorhandenen Dimmer-Einsatz (erfordert keine tiefere Schaltdose). Kann mittels Adapter in bestehende Schalterserien wie Busch Jäger, Gira usw. integriert werden.

=== Technische Daten ===

* Versorgungsspannung: 230 V / 50 Hz
* Minimallast: 10 VA
* Minimalstrom: 40 mA
* Maximale Schaltleistung: 180 VA
* Standby-Verbrauch: 1 W
* Dimmverfahren: Phasenabschnitt
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5 °C bis +35 °C
* Abmessungen (BxHxT): 71x71x37 mm
* Gewicht: 43 g

=== Schalter ===

Der HM-LC-Dim1TPBU-FM besitzt zwei Schalter, die über eine Wippe angewählt werden können. Das Standard-Verhalten entspricht im Prinzip dem [[HM-LC-Bl1PBU-FM Unterputz-Jalousieaktor]]:

* Ein kurzer Druck nach oben Schaltet den Verbraucher ein (100 % Leistung).
* Ein kurzer Durck nach unten Schaltet den Verbraucher aus (0 % Leistung).
* Ein langer Druck nach oben erhöht die Leistung bis der Schalter losgelassen wird.
* Ein langer Druck nach unten verringert die Leistung bis der Schalter losgelassen wird.

== Hinweise zur Hardware-Installation ==

Der HM-LC-Dim1TPBU-FM verfügt über vier Anschlussklemmen: Phase, gedimmte Phase und zwei kurzgeschlossene Klemmen für den Neutralleiter. Das heißt, dass der Neutralleiter "durchgeschleift" werden kann.

Der HM-LC-Dim1TPBU-FM füllt die Schalterdose links und rechts nahezu aus. Wenn möglich ist eine Zuführung der Leitungen von oben oder unten zu bevorzugen.

== Kompatible Leuchtmittel ==

In der Detailansicht vieler LED-Lampen auf der Webseite von ELV.de lässt sich eine Dimmer-Kompatibilitätsliste für das jeweilige Modell herunterladen.

== Mögliche Hardwaredefekte ==

Wenn der Dimmer zwischendurch immer wieder neu startet, beim Hochdimmen oder kurz danach spontan abschaltet, sich nur noch lokal, aber nicht mehr per Fernbedienung steuern lässt, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C7. (ein vergleichbarer Defekt tritt auch häufig beim Dimmer [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] oder dem Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, Rastermaß (RM) 2,5 (mm) radial (stehend), 10µ/25V (Ersatz mit höherer Spannung natürlich unproblematisch möglich). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L2) und dem dreipoligen IC2 (Linearregler). Die Platine hat Bestückungsdruck, C7 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

Siehe auch die Diskussion im Forum: --> https://forum.fhem.de/index.php/topic,55149.msg346499/topicseen.html

== Links ==

* Anleitung: http://files.elv.de/Assets/Produkte/10/1030/103020/Downloads/103020_FunkDimmaktor_um.pdf

[[Kategorie:HomeMatic Components]]
[[Kategorie:Dimmer]]
[[Kategorie:868MHz]]

HomeMatic Namen verstehen

2018-07-25T10:01:22Z

Pfriemler: kleine Korrekturen, mehr zu inkonsistenter Namensgebung

[[HomeMatic]] Sender und Aktoren sind oft mit den Bezeichnungen des Herstellers (die ELV Tochtergesellschaft eQ-3) benannt.

Da es sich um Buchstaben und Zahlenkürzel handelt, ist nicht immer sofort erkennbar, um was für ein Gerät es sich handelt.

== Namensschema ==
Die Namen sind jedoch meist nach einem Schema aufgebaut, der Aufbau ist:

Medientyp - Generelle Funktion - Sensor/Sender/Aktorfunktion [mit Taster] - [Montageart]

also z. B. HM-LC-SW1-FM

Die Gross- und Kleinschreibung wird nicht durchgängig stringent eingehalten. So wird die Aktorfunktion Schalter mal mit SW, mal mit Sw bezeichnet.
[ ] umschliessen optionale Bestandteile

Ferner hält sich ELV nicht vollumfänglich an sein Namenschema.
Die LED Statusanzeige heisst z. B. HM-OU-LED16, müsste nach Namenschema aber eigentlich HM-Dis-16 heissen.
Zudem sind ähnliche Geräte mit Zusatzfunktionen völlig anders benannt (siehe Beispiele).

Es bedeuten (Liste unvollständig):

== Medientyp ==
* HM = HomeMatic Funk
* HMW = HomeMatic Wired
* HB = [[HomeBrew]] = HomeMatic Eigenentwicklungen, Nachbauten und Erweiterungen
* HBW = [[HomeBrew]] = HomeMatic-Wired Eigenentwicklungen, Nachbauten und Erweiterungen

== Funktion ==
* CC = Heizungssteuerung (Climate Control)
* CFG = Konfiguration (Configuration)
* Dis = Anzeige (Display)
* ES = Energieversorgung (Energy Systems)
* IO = Eingang/Ausgang (Input/Output, nur bei HomeMatic Wired)
* LC = Licht/Strom (Light Control)
* LGW = LAN-Schnittstelle (LAN Gateway)
* MOD = Modul (Module)
* OU = Klang (evtl. allgemein als Output Unit, ?)
* PB[U] = Wandtaster (Push Button [Unit, z.B. Unterputzaktoren mit integrierten Tastern (Schalterersatz)])
* PBI = Tasterschnittstelle (Push Button Interface)
* RC = Fernbedienung (Remote Control)
* SCI = Schalterzustandserkennung (Shutter Contact Interface)
* SEC = Sicherheit/Überwachung (Security) (teilweise auch Sec)
* Sen = Sensor
* SwI = Schalterinterface (Switch Interface)
* Sys = Systemerweiterung (nur vom Repeater bekannt)
* TC = Temperatursteuerung (temperature control), eigentlich eine Untergruppe von CC
* UW = Umweltsensor (nur bei HomeBrew)
* WDSxx = Feuchte- und/oder Temperatursensor
* 1W = Ankopplung an [[:Kategorie:1-Wire|1-Wire Komponenten]]

== Sensor/Sender/Aktorfunktion ==
* BLx = Jalousieaktor mit x Kanälen (Blind) (oft auch Blx)
* CF[M] = Gong und Blitz/Licht (und Klang-Speicher) (Chime with Flash (and Memory))
* DB = Türklingel (Door Bell)
* DimxT = Dimmer mit x Kanälen mit Phasen'''ab'''schnittsteuerung ('''t'''railing edge, für ohmsche und elektronische Lasten)
* DimxL = Dimmer mit x Kanälen mit Phasen'''an'''schnittsteuerung ('''l'''eading edge, für ohmsche und induktive Lasten)
* EM = Sender (Emitter, ?)
* EP = (Sensor für) Elektrische Impulse
* KEY = Schließsystem
* Px = Paniksender mit x Kanälen (Panic)
* T = Temperatursensor
* TH = Temperatur und Feuchtesensor (Temperature & Humidity)
* TiS = Neigungssensor (Tilt Sensor)
* Re = Empfänger (Receiver, ?)
* RT = Heizkörperthermostat (Radiator Thermostat)
* SC[o] = Tür- / Fenster / Schliesserkontakt (Shutter Contact (optical))
* SCD = Luftgütesensor (Sensor Carbon Dioxide)
* SFA = Sirenen- und Blitz-Aktor (sirene and flash actuator)
* SWx = Schaltaktor mit x Kanälen (Switch) (oft auch Swx)
* VD = Stellantrieb (Ventile Drive)
* WDS = Wassermelder
* MDIR = Infrarot Bewegungsmelder (Motion Detector Infrared)
* 1 = Einkanal
* 2 = Zweikanal
* 4 = Vierkanal
* 8 = Achtkanal
* 12 = Zwölfkanal
* 16 = Sechzehnkanal
* 19 = Neunzehnkanal

== Montageart ==
Optional, nur soweit bedeutsam, z. B. um Geräte ansonsten gleicher Funktion zu unterscheiden, wird die Montageart angefügt:

* CV = Zwischendeckenmontage (Ceiling mount)
* DN = Heizkörpermontage (???)
* DR = Hutschienenmontage (DIN Rail)
* FM = Unterputz (Floating Mount)
* PL = Zwischenstecker (Plug) (oft auch Pl)
* SM = Aufputz (Surface Mount)
* WM = beliebige Festmontage, meist Aufklebegerät (Wall Mount)
* I = Innenmontage (Indoor)
* O = Aussenmontage (Outdoor)
* T = Frei aufstellbares Gerät (eventuell von "Tabletop")

==Sonstiges==

* B = schwarz
* W = weiss (auch SW?)
* PCB = Bausatz / Platinenversion

== Beispiel ==
[[HM-LC-SW1-FM Schaltaktor 1-fach UP|HM-LC-SW1-FM]] = HomeMatic Funk - Licht/Strom - Schaltaktor mit einem Kanal - Unterputzmontage

[[HM-LC-Sw2PB-FM Schaltaktor mit Tasteraufsatz 2fach|HM-LC-Sw2PB-FM]] = HomeMatic Funk - Licht/Strom - Schaltaktor mit zwei Kanälen UND Tastern - Unterputzmontage

[[HM-LC-Sw1-Pl2_Funk-Zwischenstecker-Schaltaktor_1fach|HM-LC-Sw1-Pl2]] = HomeMatic Funk - Licht/Strom - Schaltaktor mit einem Kanal - Zwischenstecker (auch als HM-LC-Sw1-Pl-DN-R1 erhätlich

[[HM-ES-PMSw1-Pl_Funk-Schaltaktor_1-fach_mit_Leistungsmessung|HM-ES-PMSw1-Pl]] = HomeMatic Funk - Energiesysteme - Leistungsmessung+Schaltaktor mit einem Kanal - Zwischenstecker (eben nicht HM-'''LC'''-'''PM'''Sw1-Pl, im Vergleich dazu)

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

HM-SEC-SD Rauchmelder

2018-07-13T10:37:30Z

Pfriemler: /* Nützliche Notifies */ und noch einen übersehen gehabt ...

{{Infobox Hardware
|Bild=HM-SEC-SD o.jpeg 
|Bildbeschreibung=HomeMatic HM-SEC-SD Rauchmelder Oberseite
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=
|HWVoltage=9V
|HWPowerConsumption= W im Standby
|HWPoweredBy=3 x 1,5 V LR6/AA
|HWSize=120x44mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD]] ist ein VdS-zertifizierter Rauchmelder. Mehrere Rauchmelder können unabhängig von einer Zentrale zu einer Gruppe zusammengefasst werden. Auch ohne FHEM-Zentrale meldet ein Rauchmelder seinen Alarm immer an die anderen vernetzten Rauchmelder weiter.

Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD-2]] ist die neue Version seit 2016. Auch dieser Melder wird in FHEM unterstützt. ''Das Gerät kann ausschließlich in Gruppen mit Rauchwarnmeldern des gleichen Typs (HM-Sec-SD-2) und nicht in einer Gruppe mit anderen Rauchwarnmeldern (z. B. HM-Sec-SD) genutzt werden.''<ref>[http://www.eq-3.de/produkte/homematic/sicherheit-und-ueberwachung/homematic-funk-rauchwarnmelder-293.html#beschreibung "Highlights" bei der Produktbeschreibung auf der EQ3-Site]</ref>

[[Datei: HM-SEC-SD-2.jpg|300px|thumb|right|HM-SEC-SD-2]]

== Hinweise zum Betrieb mit FHEM ==
Der HM-SEC-SD Rauchmelder beherrscht kein AES. Der Betrieb ist mit [[HMLAN Konfigurator]] oder mit [[CUL]] möglich. Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

Der HM-SEC-SD-2 Rauchmelder arbeitet mit aesCBC, er benötigt dafür zwingend das Modul libcrypt-rijndael-perl unabhängig vom IO Device, auch für den HM-CFG-LAN!

=== Teams ===
Rauchmelder können mittels [[Peering (HomeMatic)|Peering]] in Teams gruppiert werden. Jeder SD kann einem Team angehören - und das sollte man auch einrichten. Nutzt man nur einen SD sollte man diesen mit sich selbst peeren.

Beispiele:
nutzt man einen SD und will diesen nicht mit anderen in einem Team haben peert man ihn mit sich selbst. Damit ist der SD sein eigener TeamLead.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor</code>

Hat man mehrere SDs, die in einem Team zusammengefasst werden sollen, wird der TeamLead festgelegt und alle SDs werden mit ihm gepeert. Das Team kann jederzeit erweitert werden.
<pre>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_KZ single set actor </pre>

Nutzt man einen virtuellen TeamLead - (siehe [[#virtueller TeamLead|virtueller TeamLead]]) - werden alle realen SDs mit diesem gepeert
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_KZ single set actor
</pre>

Ein SD kann aus einem Team mittels unset entfernt werden.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single unset actor </code>

Um einen SD von einem Team in ein anderes zu transferieren, muss man ihn erst mit ''unset'' aus dem Team entfernen, dann mit ''set'' in das neue Team eintragen. Einen physkalischen TeamLead kann man nur aus dem Team nehmen, indem man ihn aus allen Teammitgliedern entfernt.

Die korrekte Gruppierung sollte nach der Konfiguration durch einen Teamcall geprüft werden.

Der Betrieb mehrer Teams ist möglich, ein SD kann aber nur einem Team angehören. Will man einen SD von einem Team in ein anderes umhängen, muss man ihn erst aus dem ersten Team entfernen und dann in das Neue aufnehmen.

=== TeamLead ===
Für ein Team muss immer ein TeamLead festgelegt werden. Anders als der Name suggeriert, gibt es hier keinen Master. Sinn und Zweck ist einzig, eine Team-Adresse (HMId) festzulegen, unter der man alle SDs eines Teams ansprechen kann. Diese muss, wie alle HMIds, einzig im System sein. Um dies zu erreichen, verwendet HM beim Teamen ohne Zentrale die HMId eines der SDs. Verwendet man eine Zentrale (FHEM) kann man dies auch entzerren und einen virtuellen SD als TeamLead nutzen. Siehe hierzu [[#virtueller TeamLead|virtueller TeamLead]].

Nutzt man nur einen einzelnen SD, sollte man diesen mit sich selbst peeren.

=== Kommandos ===
Es gibt Team-Nachrichten, die jeder SD senden kann und auf die jeder SD im Team reagiert. Jeder SD kann somit einen Teamcall auslösen oder einen Alarm ausgeben. Die Kommandos werden '''nicht''' von einem SD zum anderen weitergereicht. Auch der TeamLead hat '''keine''' Sonderfunktion. Der einzelne SD sendet seine Nachricht an das Team und jeder im Team reagiert darauf.

Es ist somit darauf zu achten, dass auch die entferntesten SDs sich gegenseitig erreichen können.

Die Kommandos können von der Zentrale getriggert werden. Da sie unter der Team-ID gesendet werden, stehen sie nur bei der Komponente des TeamLeads zu Verfügung.

Dazu gehören teamCall, teamCallBat, alarmOn und alarmOff.

Sie stehen nur für die Entity des TeamLeads zu Verfügung.
<pre>set EurerTeamLeader alarmOn
set EurerTeamLeader alarmOff
set EurerTeamLeader teamCall
set EurerTeamLeader teamCallBat ## nur für alte SDs
</pre>

'''teamCall''' testet die Zugehörigkeit und Erreichbarkeit aller SDs im Team. Alle SDs sollten 10 mal leise piepen. '''teamCallBat''' erzeugt einen kürzeren Teamcall mit anderer Signalfolge, wie er bei schwacher Batterie eines Melders automatisch ausgelöst wird.

Einzelne SDs kann man mit "statusRequest" abfragen.

== virtueller TeamLead ==
Nutzt man nur einen einzelnen SD, kann/sollte man diesen mit sich selbst teamen (peerChan). In allen andere Fällen braucht man einen TeamLead um eine Team-ID zu erhalten. Man kann hierzu einen der SDs nutzen. Wird dieser einmal ausgewechselt, hat man allerdings seine Team-ID verloren.

Wenn man mit Zentrale (FHEM) arbeitet, gibt es eigentlich keinen vernünftigen Grund (ausser 1-SD-Teams), einen der SDs als Lead zu nutzen. Man kann genauso gut einen virtuellen Aktor bauen und diesen zum Lead machen. Das ergibt eine sauberere Struktur.

Erzeugen eines virtuellen TeamLeads könnte so aussehen. Es wird ein virtuelles Gerät und ein virtueller Kanal definiert und mit einem sprechenden Namen versehen:
<pre>define TeamDev CUL_HM 111111
set TeamDev virtual 1
rename TeamDev_Btn1 Rauchmelder_Team</pre>

Bitte beachten: '''die HMID''' (im obigen Beispiel 111111)''' muss für die gesamte Installation einmalig sein und es darf nur Btn1 (HM Channel ID xxxxxx01) als TeamLead verwendet werden.''' Man kann auch den '''ersten''' Kanal einer VCCU verwenden.

Nach der Definition bitte überprüfen, dass TeamDev das Attribut ('''attr''') '''IODev''' bzw. '''IOgrp''' gesetzt hat (das sollte normalerweise automatisch passieren)! Am Besten die Konfiguration mit HMinfo '''configCheck''' prüfen, die ordnungsgemäße Funktion des TeamDev ist wichtig für den Erfolg des folgenden Peerings der Rauchmelder.

Jeder Rauchmelder muss jetzt in das Team aufgenommen werden:
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
...
save</pre>

Hierbei ist "Rauchmelder_Team" der Name des virtuellen TeamLeaders und "Rauchmelder_Flur" der Name des jeweiligen Rauchmelders.

Das "save" ist notwendig, um auch die Einstellungen des virtuellen SDs in der [[Konfiguration]] zu sichern.

Bei jedem Rauchmelder sollte der Name des virtuellen TeamLeaders in der peerList stehen und beim virtuellen TeamLeader jeder Rauchmelder.

Mit teamCall sollte man die korrekte Funktion des Teams prüfen, wer will auch mit alarmOn.

== Variablen ==
=== Internals ===
Keine Spezifischen.

=== Readings ===
Für '''jeden''' SD sind folgende Readings relevant:

teamCall from <name>:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
battery:[ok|low]
level:<0..200>

*'''count''' ist ein Zähler, den das Gerät liefert um neue Alarme unterscheiden zu können
*'''level''' ist ein Wert zwischen 0 und 200. 200 ist Alarm, 199 bedeutet Alarm, aber die Sirene ist abgeschaltet.

Beim '''TeamLead''' laufen alle Alarme auf

teamCall: from <name>:<count>
recentAlarm:<von_name>
level:<0..200>
eventNo:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
SDteam:[add_<name>|remove_<name>]

*'''von_name''' ist der Name des SD, der gemeldet hat.
*'''smoke_detect''' ist der aktuelle Alarm, während '''recentAlarm''' die letzte Alarmquelle anzeigt, auch wenn der Alarm schon behoben ist.
*'''SDteam''' kommt gelegentlich bei Konfigurationsereignissen zum Tragen.

=== Attribute ===
Besondere Attribute
* '''msgRepeat''' sollte auf 1 stehen. SD ist ein burst device, wiederholen von Nachrichten belastet das HMLAN besonders. Die Team-Kommandos sind hiervon nicht beeinflusst, also auch nicht das Auslösen eines Alarms.
* '''actCycle''' wird auf 99 Stunden gesetzt. Ein SD meldet sich alle 3 Tage bei der Zentrale, was der ActionDetector prüft.
* '''msgRepeat''' 1
Allgemein vorgeschlagen
:'''IODev''' [HMLAN/HMUSB/CUL]
:'''autoReadReg''' 5_readMissing
:'''event-on-change-reading''' .*
Optional, nur als Anregung zu verstehen
:'''devStateIcon''' off:general_ok .*:secur_alarm
:'''group''' smokeDetect
:'''icon''' secur_smoke_detector
Ebenfalls optional, jedoch nützlich für Homebridge-/Homekit-Anbindung:
:'''genericDeviceType''' security

== Alarme ==
Meldet ein SD einen Alarm, wird dieser in dem SD und im TeamLead angezeigt.

Nutzt man [[HomeMatic HMInfo|HMinfo]], wird ein Rauchalarm auch hier als "Error" gemeldet. In HMinfo wird dies für alle SD-Teams im System gemacht.

== Probleme beim SD-2 ==

Das Senden von TeamCall-/Alarmkommandos an die SD2 ist leider fragil. Bei jedem Befehl muss entweder der MessageCounter der Nachricht größer sein als der letzte oder (falls dies nicht der Fall ist) der Generationenzähler inkrementiert werden. Beide Werte werden in dem Reading aesCBCCounter des Teamleads abgelegt:

<pre>
aesCBCCounter GGGGMM
</pre>

Hierbei ist GGGG der Generationenzähler in Hex und MM der Messagecounter in Hex. Sollte dieses Reading gelöscht werden, reagieren die SD2 nicht mehr, da sie denken, eine alte Nachricht empfangen zu haben. Leider kann man die aktuellen Werte auch nicht mehr aus den SD2 auslesen...

Falls die SD2 also nicht mehr reagieren, kann man mal probieren den Generationenzähler per Hand zu inkrementieren und den MessageCounter auf 0 zu setzen (aesCBCCounter hier vorher 0000XX):

<pre>
setreading TeamLead aesCBCCounter 000100
</pre>

Falls das Reading komplett gelöscht wurde, bitte langsam rantasten und den Generationenzähler immer nur um 1 erhöhen, denn was passiert, wenn der Generationencounter nach FFFF überläuft hat bisher noch niemand ausprobiert...

== Nützliche Notifies ==
Codefragmente, die man einsetzen kann. Ggf. muss man etwas anpassen, zumindest können sie als Anregung nützlich sein.
* Bei Alarm E-Mail schicken und Licht im Flur anschalten
<pre>
define sd.nf.report notify Rauchmelder_Team:.*smoke-Alarm.* {\
<Mail versenden>;;
fhem("set LichtTreppenhaus on");;
}\
</pre>

* Bei Alarm alle SDs des Teams stumm schalten durch Stummschalten eines einzelnen
:<code>define sd.nf.quiet notify Rauchmelder_Team:.*level:.199 set Rauchmelder_Team alarmOff</code>

== Links ==
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-Sec-SD_GE_UM_V1.5_150407.pdf Montage- und Inbetriebnahmeanleitung HM-SEC-SD (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-Sec-SD-2_UM_eQ-3_GE_web.pdf Montage- und Inbetriebnahmeanleitung HM-SEC-SD-2 (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/pdb/Funk-Rauchwarnmelder_131408_Produktdatenblatt_V1.7.pdf Produktdatenblatt HM-SEC-SD-2 (PDF)]

== Quellen ==
<references />

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rauchmelder]]

HM-SEC-SD Rauchmelder

2018-07-13T10:36:49Z

Pfriemler: /* Nützliche Notifies */ Bezeichnung des TeamLeads vereinheitlicht von 'sdTeam' auf 'Rauchmelder_Team'

{{Infobox Hardware
|Bild=HM-SEC-SD o.jpeg 
|Bildbeschreibung=HomeMatic HM-SEC-SD Rauchmelder Oberseite
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=
|HWVoltage=9V
|HWPowerConsumption= W im Standby
|HWPoweredBy=3 x 1,5 V LR6/AA
|HWSize=120x44mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD]] ist ein VdS-zertifizierter Rauchmelder. Mehrere Rauchmelder können unabhängig von einer Zentrale zu einer Gruppe zusammengefasst werden. Auch ohne FHEM-Zentrale meldet ein Rauchmelder seinen Alarm immer an die anderen vernetzten Rauchmelder weiter.

Der [[HM-SEC-SD Rauchmelder|HM-SEC-SD-2]] ist die neue Version seit 2016. Auch dieser Melder wird in FHEM unterstützt. ''Das Gerät kann ausschließlich in Gruppen mit Rauchwarnmeldern des gleichen Typs (HM-Sec-SD-2) und nicht in einer Gruppe mit anderen Rauchwarnmeldern (z. B. HM-Sec-SD) genutzt werden.''<ref>[http://www.eq-3.de/produkte/homematic/sicherheit-und-ueberwachung/homematic-funk-rauchwarnmelder-293.html#beschreibung "Highlights" bei der Produktbeschreibung auf der EQ3-Site]</ref>

[[Datei: HM-SEC-SD-2.jpg|300px|thumb|right|HM-SEC-SD-2]]

== Hinweise zum Betrieb mit FHEM ==
Der HM-SEC-SD Rauchmelder beherrscht kein AES. Der Betrieb ist mit [[HMLAN Konfigurator]] oder mit [[CUL]] möglich. Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

Der HM-SEC-SD-2 Rauchmelder arbeitet mit aesCBC, er benötigt dafür zwingend das Modul libcrypt-rijndael-perl unabhängig vom IO Device, auch für den HM-CFG-LAN!

=== Teams ===
Rauchmelder können mittels [[Peering (HomeMatic)|Peering]] in Teams gruppiert werden. Jeder SD kann einem Team angehören - und das sollte man auch einrichten. Nutzt man nur einen SD sollte man diesen mit sich selbst peeren.

Beispiele:
nutzt man einen SD und will diesen nicht mit anderen in einem Team haben peert man ihn mit sich selbst. Damit ist der SD sein eigener TeamLead.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor</code>

Hat man mehrere SDs, die in einem Team zusammengefasst werden sollen, wird der TeamLead festgelegt und alle SDs werden mit ihm gepeert. Das Team kann jederzeit erweitert werden.
<pre>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Flur peerChan 0 Rauchmelder_KZ single set actor </pre>

Nutzt man einen virtuellen TeamLead - (siehe [[#virtueller TeamLead|virtueller TeamLead]]) - werden alle realen SDs mit diesem gepeert
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_SZ single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_KZ single set actor
</pre>

Ein SD kann aus einem Team mittels unset entfernt werden.
:<code>set Rauchmelder_Flur peerChan 0 Rauchmelder_Flur single unset actor </code>

Um einen SD von einem Team in ein anderes zu transferieren, muss man ihn erst mit ''unset'' aus dem Team entfernen, dann mit ''set'' in das neue Team eintragen. Einen physkalischen TeamLead kann man nur aus dem Team nehmen, indem man ihn aus allen Teammitgliedern entfernt.

Die korrekte Gruppierung sollte nach der Konfiguration durch einen Teamcall geprüft werden.

Der Betrieb mehrer Teams ist möglich, ein SD kann aber nur einem Team angehören. Will man einen SD von einem Team in ein anderes umhängen, muss man ihn erst aus dem ersten Team entfernen und dann in das Neue aufnehmen.

=== TeamLead ===
Für ein Team muss immer ein TeamLead festgelegt werden. Anders als der Name suggeriert, gibt es hier keinen Master. Sinn und Zweck ist einzig, eine Team-Adresse (HMId) festzulegen, unter der man alle SDs eines Teams ansprechen kann. Diese muss, wie alle HMIds, einzig im System sein. Um dies zu erreichen, verwendet HM beim Teamen ohne Zentrale die HMId eines der SDs. Verwendet man eine Zentrale (FHEM) kann man dies auch entzerren und einen virtuellen SD als TeamLead nutzen. Siehe hierzu [[#virtueller TeamLead|virtueller TeamLead]].

Nutzt man nur einen einzelnen SD, sollte man diesen mit sich selbst peeren.

=== Kommandos ===
Es gibt Team-Nachrichten, die jeder SD senden kann und auf die jeder SD im Team reagiert. Jeder SD kann somit einen Teamcall auslösen oder einen Alarm ausgeben. Die Kommandos werden '''nicht''' von einem SD zum anderen weitergereicht. Auch der TeamLead hat '''keine''' Sonderfunktion. Der einzelne SD sendet seine Nachricht an das Team und jeder im Team reagiert darauf.

Es ist somit darauf zu achten, dass auch die entferntesten SDs sich gegenseitig erreichen können.

Die Kommandos können von der Zentrale getriggert werden. Da sie unter der Team-ID gesendet werden, stehen sie nur bei der Komponente des TeamLeads zu Verfügung.

Dazu gehören teamCall, teamCallBat, alarmOn und alarmOff.

Sie stehen nur für die Entity des TeamLeads zu Verfügung.
<pre>set EurerTeamLeader alarmOn
set EurerTeamLeader alarmOff
set EurerTeamLeader teamCall
set EurerTeamLeader teamCallBat ## nur für alte SDs
</pre>

'''teamCall''' testet die Zugehörigkeit und Erreichbarkeit aller SDs im Team. Alle SDs sollten 10 mal leise piepen. '''teamCallBat''' erzeugt einen kürzeren Teamcall mit anderer Signalfolge, wie er bei schwacher Batterie eines Melders automatisch ausgelöst wird.

Einzelne SDs kann man mit "statusRequest" abfragen.

== virtueller TeamLead ==
Nutzt man nur einen einzelnen SD, kann/sollte man diesen mit sich selbst teamen (peerChan). In allen andere Fällen braucht man einen TeamLead um eine Team-ID zu erhalten. Man kann hierzu einen der SDs nutzen. Wird dieser einmal ausgewechselt, hat man allerdings seine Team-ID verloren.

Wenn man mit Zentrale (FHEM) arbeitet, gibt es eigentlich keinen vernünftigen Grund (ausser 1-SD-Teams), einen der SDs als Lead zu nutzen. Man kann genauso gut einen virtuellen Aktor bauen und diesen zum Lead machen. Das ergibt eine sauberere Struktur.

Erzeugen eines virtuellen TeamLeads könnte so aussehen. Es wird ein virtuelles Gerät und ein virtueller Kanal definiert und mit einem sprechenden Namen versehen:
<pre>define TeamDev CUL_HM 111111
set TeamDev virtual 1
rename TeamDev_Btn1 Rauchmelder_Team</pre>

Bitte beachten: '''die HMID''' (im obigen Beispiel 111111)''' muss für die gesamte Installation einmalig sein und es darf nur Btn1 (HM Channel ID xxxxxx01) als TeamLead verwendet werden.''' Man kann auch den '''ersten''' Kanal einer VCCU verwenden.

Nach der Definition bitte überprüfen, dass TeamDev das Attribut ('''attr''') '''IODev''' bzw. '''IOgrp''' gesetzt hat (das sollte normalerweise automatisch passieren)! Am Besten die Konfiguration mit HMinfo '''configCheck''' prüfen, die ordnungsgemäße Funktion des TeamDev ist wichtig für den Erfolg des folgenden Peerings der Rauchmelder.

Jeder Rauchmelder muss jetzt in das Team aufgenommen werden:
<pre>set Rauchmelder_Team peerChan 0 Rauchmelder_Flur single set actor
set Rauchmelder_Team peerChan 0 Rauchmelder_WZ single set actor
...
save</pre>

Hierbei ist "Rauchmelder_Team" der Name des virtuellen TeamLeaders und "Rauchmelder_Flur" der Name des jeweiligen Rauchmelders.

Das "save" ist notwendig, um auch die Einstellungen des virtuellen SDs in der [[Konfiguration]] zu sichern.

Bei jedem Rauchmelder sollte der Name des virtuellen TeamLeaders in der peerList stehen und beim virtuellen TeamLeader jeder Rauchmelder.

Mit teamCall sollte man die korrekte Funktion des Teams prüfen, wer will auch mit alarmOn.

== Variablen ==
=== Internals ===
Keine Spezifischen.

=== Readings ===
Für '''jeden''' SD sind folgende Readings relevant:

teamCall from <name>:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
battery:[ok|low]
level:<0..200>

*'''count''' ist ein Zähler, den das Gerät liefert um neue Alarme unterscheiden zu können
*'''level''' ist ein Wert zwischen 0 und 200. 200 ist Alarm, 199 bedeutet Alarm, aber die Sirene ist abgeschaltet.

Beim '''TeamLead''' laufen alle Alarme auf

teamCall: from <name>:<count>
recentAlarm:<von_name>
level:<0..200>
eventNo:<count>
state:[off|smoke-Alarm_<count>]
smoke_detect:<von_name>
SDteam:[add_<name>|remove_<name>]

*'''von_name''' ist der Name des SD, der gemeldet hat.
*'''smoke_detect''' ist der aktuelle Alarm, während '''recentAlarm''' die letzte Alarmquelle anzeigt, auch wenn der Alarm schon behoben ist.
*'''SDteam''' kommt gelegentlich bei Konfigurationsereignissen zum Tragen.

=== Attribute ===
Besondere Attribute
* '''msgRepeat''' sollte auf 1 stehen. SD ist ein burst device, wiederholen von Nachrichten belastet das HMLAN besonders. Die Team-Kommandos sind hiervon nicht beeinflusst, also auch nicht das Auslösen eines Alarms.
* '''actCycle''' wird auf 99 Stunden gesetzt. Ein SD meldet sich alle 3 Tage bei der Zentrale, was der ActionDetector prüft.
* '''msgRepeat''' 1
Allgemein vorgeschlagen
:'''IODev''' [HMLAN/HMUSB/CUL]
:'''autoReadReg''' 5_readMissing
:'''event-on-change-reading''' .*
Optional, nur als Anregung zu verstehen
:'''devStateIcon''' off:general_ok .*:secur_alarm
:'''group''' smokeDetect
:'''icon''' secur_smoke_detector
Ebenfalls optional, jedoch nützlich für Homebridge-/Homekit-Anbindung:
:'''genericDeviceType''' security

== Alarme ==
Meldet ein SD einen Alarm, wird dieser in dem SD und im TeamLead angezeigt.

Nutzt man [[HomeMatic HMInfo|HMinfo]], wird ein Rauchalarm auch hier als "Error" gemeldet. In HMinfo wird dies für alle SD-Teams im System gemacht.

== Probleme beim SD-2 ==

Das Senden von TeamCall-/Alarmkommandos an die SD2 ist leider fragil. Bei jedem Befehl muss entweder der MessageCounter der Nachricht größer sein als der letzte oder (falls dies nicht der Fall ist) der Generationenzähler inkrementiert werden. Beide Werte werden in dem Reading aesCBCCounter des Teamleads abgelegt:

<pre>
aesCBCCounter GGGGMM
</pre>

Hierbei ist GGGG der Generationenzähler in Hex und MM der Messagecounter in Hex. Sollte dieses Reading gelöscht werden, reagieren die SD2 nicht mehr, da sie denken, eine alte Nachricht empfangen zu haben. Leider kann man die aktuellen Werte auch nicht mehr aus den SD2 auslesen...

Falls die SD2 also nicht mehr reagieren, kann man mal probieren den Generationenzähler per Hand zu inkrementieren und den MessageCounter auf 0 zu setzen (aesCBCCounter hier vorher 0000XX):

<pre>
setreading TeamLead aesCBCCounter 000100
</pre>

Falls das Reading komplett gelöscht wurde, bitte langsam rantasten und den Generationenzähler immer nur um 1 erhöhen, denn was passiert, wenn der Generationencounter nach FFFF überläuft hat bisher noch niemand ausprobiert...

== Nützliche Notifies ==
Codefragmente, die man einsetzen kann. Ggf. muss man etwas anpassen, zumindest können sie als Anregung nützlich sein.
* Bei Alarm E-Mail schicken und Licht im Flur anschalten
<pre>
define sd.nf.report notify Rauchmelder_Team:.*smoke-Alarm.* {\
<Mail versenden>;;
fhem("set LichtTreppenhaus on");;
}\
</pre>

* Bei Alarm alle SDs des Teams stumm schalten durch Stummschalten eines einzelnen
:<code>define sd.nf.quiet notify sdTeam:.*level:.199 set Rauchmelder_Team alarmOff</code>

== Links ==
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-Sec-SD_GE_UM_V1.5_150407.pdf Montage- und Inbetriebnahmeanleitung HM-SEC-SD (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/bda/HM-Sec-SD-2_UM_eQ-3_GE_web.pdf Montage- und Inbetriebnahmeanleitung HM-SEC-SD-2 (PDF)]
* [http://www.eq-3.de/Downloads/eq3/downloads_produktkatalog/homematic/pdb/Funk-Rauchwarnmelder_131408_Produktdatenblatt_V1.7.pdf Produktdatenblatt HM-SEC-SD-2 (PDF)]

== Quellen ==
<references />

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rauchmelder]]

IR-WLAN-Gateway

2018-07-02T20:24:10Z

Pfriemler: /* Panasonic */ Ergänzung von Lautstärkesteuerbefehlen

{{Infobox Hardware|Bild=IR_WLAN_Gateway_Modul.jpg
|Bildbeschreibung=IR-WLAN-Gateway
|HWProtocol=HTTP
|HWType=Sender/Receiver
|HWCategory=Other
|HWComm=2,4 GHz
|HWChannels=1
|HWVoltage=5V
|HWPoweredBy=Kleinspannung
|HWPowerConsumption= ~0,2W(Standby)
|HWSize=55x20 mm (Durchm. x Höhe)
|HWDeviceFHEM=HTTP oder IR-Blaster (inoff.)
|HWManufacturer=HomeBrew}}

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.

Prinzipiell genügen sehr wenige externe Bauteile zum ESP8266 oder einem Entwicklermodul, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
address - (optional) additional device address (decimal!)
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal zweimal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Betrieb über MQTT ===
Die Einbindung als [[MQTT_DEVICE]] mit [[Remotecontrol|remotecontrol]] ist [[IR-MQTT-Gateway|hier]] dargestellt.

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

==== Panasonic ====

Auch wenn sich ein Panasonic-TV (wie viele andere Geräte auch) optimal über Netzwerk steuern lässt, muss er zunächst ggf. aus dem deep standby geweckt werden. Leider gibt es hierfür keine dedizierten ON- und OFF-Befehle, sondern nur power toggle. Zum Einschalten muss der Befehl allerdings etwas länger gesendert werden (ebenso wie man den Knopf auf der Fernbedienung länger drücken muss), dies lässt sich durch zusätzliche 'pulse'- und 'pdelay'-Angaben erreichen:
IR_PanasonicTV_Power_long [{'data':'0100BCBD','address':'16388','type':'PANASONIC','length':48,'pulse':10,'pdelay':1}]
Für TV-Mute könnte ein Befehl lauten:
IR_PanasonicTV_Mute [{'data':'01004C4D','address':'16388','type':'PANASONIC','length':48}]
Auch diese Befehle zur Lautstärkesteuerung sind erprobt - durch Variation der 5 hinter pulse kann gesteuert, wie groß die Lautstärkeänderung ist:
IR_PanasonicTV_VolDown [{'data':'01008485','address':'16388','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
IR_PanasonicTV_VolUp [{'data':'01000405','address':'16388','type':'PANASONIC','length':48,'pulse':5,'pdelay':1}]
Weitere Befehle finden sich über die Links am Ende des Artikels.

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'0C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.

IR_LeinwandAB [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,
421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandAUF [{'data':
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,
421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]

IR_LeinwandSTOP [{'data:
[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,
421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,
421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,
421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}
* Tabellen mit Sony-Fernbediencodes: [http://www.hifi-remote.com/sony/ diverse SONY-Codes]
* Tabelle mit Panasonic-Fernbediencodes: [http://www.rhoads.nu/bjorn/hp48/remote/remotes/panasoni/panasoni.txt (Textdatei zum Herunterladen)]
* LIRC Codes für VIERA Plasmafernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Infrarot]]

HM-PB-4DIS-WM Funk-Wandtaster mit Display

2018-05-17T09:33:34Z

Pfriemler: /* Beschriftung */ Sonderzeichentabelle

[[HM-PB-4DIS-WM Funk-Wandtaster mit Display]] ist ein 10-kanaliger Funk-Sender, der dank Batteriebetrieb (3 x AAA) frei im Raum positioniert werden kann (schrauben oder kleben). Der Taster lässt sich in alle vier Richtungen drücken, wobei man mit links/rechts den Kanal wählt, den man dann mit unten/oben schaltet.

Für jeden der 10 Kanäle (Positionen) können bis zu 10 Geräte angelernt werden, so dass auch ohne Zentrale theoretisch 100 Geräte steuerbar sind. Die Texte auf dem insgesamt 4 Zeilen umfassenden Display sind (auch über FHEM) anpassbar.

== Technische Daten ==
* Versorgungsspannung: 3x LR03/Micro/AAA
* Typ. Funk-Freifeldreichweite: > 100 m
* Batterielebensdauer: 2 Jahre (10 Bestätigungen/Tag)
* Display: OLED Vollgrafik-Display
* Schutzart: IP20
* Abmessungen (B x H x T): 83 x 83 x 18 mm
* Gewicht: 100 g (inkl. Batterien)

== Hinweise zum Betrieb mit FHEM ==
=== Anlernen ===
Nach dem Einlegen der Batterien sollte man die als Vierfach-Wippe ausgelegte, innere dunkle Fläche nach links oder rechts gekippt halten, bis man in das Menü gelangt. Dann einmal runter auf "Anlernen". Dann nach links, bis in der Mitte "Zentrale" steht: Damit lernt man auch wirklich das komplette Device an FHEM an. In FHEM dann das Pairing aktivieren (hmPairForSec), "Auswählen" und dann "Starten" drücken.

Aktionen auf einzelnen Kanälen scheinen nicht zu funktionieren.

Danach sollte das Device mit 20 Kanälen in FHEM erscheinen. Bitte darauf achten, dass <code>CMDs_done</code> im Device in FHEM steht.

=== FHEM Config ===
(siehe in der {{Link2CmdRef|Lang=de|Anker=CUL_HM}})

''Nach jeder dieser Eingaben in FHEM steht der Device jeweils auf <code>CMDs_pending</code>. Zum Anlernen wieder auf den Anlernmodus "Zentrale" (s.o.) gehen, '''nicht''' "Position" anlernen!''

Einen Button (Taste nach oben '''oder''' nach unten) mit einem Aktor verknüpfen:
<pre>set Displaytaster_Btn_01 peerChan 0 Aktor_01 single set</pre>
Nun ist auf dem Button 1 (Position 1 – Druck nach unten) eine Art toggle-Funktion auf den Aktor gegeben.

Eine komplette Position (Taste nach oben '''und''' nach unten) mit einem Aktor verknüpfen:
<pre>set Displaytaster_Btn_01 peerChan 0 Aktor_01 dual set</pre>
Nun ist auf der Position 1 on nach oben und off nach unten auf kurzem Tastendruck. Für z.B. Dimmer geht auch langer Tastendruck.

==== Verwendung ohne direkten peer ====
Der Schalter gibt die einzelnen Schaltpaare im Display nur frei, wenn diese auch gepeert sind. Möchte man aber keinen realen Aktuator peeren, bleibt einem nur ein virtueller Aktuator. Dieser hat in diesem Zusammenhang den Nachteil, dass er in Zusammenarbeit mit diesem Schalter nur toggelt, nicht aber schaltet. Das führt dazu, dass man virtuell mit Button1 ein- und ausschalten kann, was an sich, da virtuell noch kein Problem darstellt. Leider wird dieser Schaltzustand auf dem Display mit "0%" oder "100%" zurückgemeldet, was zunächst recht verwirrend ist. Das koppelt der beiden ersten Buttons 1 (runter) und 2 (rauf) mit dual beim peerchan führt leider ebenfalls nicht zum gewünschten Ergebnis. [https://forum.fhem.de/index.php?topic=29679.0 Forum].
Einzige Möglichkeit ist, den Schalter direkt an einen HMLAN zu pairen und von dem ein ACK zu erhalten. [[HM-RC-12_Funkfernbedienung_12_Tasten#Pairing_an_HMLAN_Konfigurator]]. Das Ack wird bei erfolgreicher Durchführung grün bestätigt.

==== Beschriftung ====
Das Display hat vier Zeilen (meinText1 ... meinText4, von oben nach unten) , wobei die beiden inneren von den äußeren durch eine feine Linie getrennt sind. Man wird also i.d.R. die inneren gut als Beschriftung der Position (z.B. "Stehlampe Wohnraum") und die äußeren als die Aktion (z.B. "An" bzw. "Aus") verstehen. Der Befehl <pre>set <button> text ErsterText ZweiterText</pre> befüllt jeweils zwei Textzeilen.
Damit wären dann bei
<pre>set Displaytaster_Btn_01 peerChan 0 Wohnraum_Stehlampe dual set
set Displaytaster_Btn_02 text An Stehlampe
set Displaytaster_Btn_01 text Wohnraum Aus</pre>
die Beschriftung für die Position 1 "Stehlampe Wohnraum" mit "An" nach oben und "Aus" nach unten für den Aktor "Wohnraum_Stehlampe" korrekt definiert und beschriftet.

Das Display unterstützt ein paar Sonderzeichen. So kann man mit
<pre>set Displaytaster_Btn_02 text > Stehlampe
set Displaytaster_Btn_01 text Wohnraum @</pre>
eine Beschriftung erreichen, bei der statt An und Aus zwei Winkel/Pfeile erscheinen, was bspw. für Dimmer oder Rolläden intuitiver ist. Weiterhin gibt es das geschützte Leerzeichen "\_", mit dem man den Text einer Zeile mit Leerzeichen versehen kann:
<pre>set <button> text Wz\_Rollo\_li auf/ab</pre>
z.B. beim einkanaligen Betrieb eines Buttons (toggle).

Umlaute werden ebenfalls unterstützt. Alles auf einen Blick (tbc):
<pre>"{" = "ä" "[" = "Ä"
"|" = "ö" "#" = "Ö"
"}" = "ü" "\$" = "Ü"
"'" = "=" "_" = "ß" "]" = "&"
">" = Pfeil nach oben
"@" = Pfeil nach unten
"\_" = Leerzeichen</pre>

== Persönliche Meinung ==
Das Teil hat leider beim Auspacken nicht die wertige Anmutung, wie man auf den Bildern von EQ-3 denken könnte: Das Display umfasst nur einen kleinen Teil des schwarzen Innen-Teils, und der weiße Rahmen ist altweiß statt reinweiß.
Weiterhin habe ich es nicht geschafft, größere Änderungen der Belegung durch z.B. "peerChan ... unset" zu erreichen. Das ging nur durch kompletten Reset auf Werkseinstellungen und Neueingabe. Ebenso schlug die Übertragung umfangreicherer Eingaben an den Schalter stets fehl. Wenn man maximal ein Button-Paar ändert und dann die Änderungen jedes Mal überträgt, geht es aber.

== Links ==
[http://www.eq-3.de/produkt-detail-46/items/hm-pb-4dis-wm.html Detailseite bei eQ-3]

[http://www.eq-3.de/Downloads/eq3/pdf_produkte/Funk-Display-Wandtaster-Aufputzmontage_85975_Produktdatenblatt.pdf Produktdatenblatt]

[http://www.eq-3.de/Downloads/eq3/pdf_produkte/140924_HM-PB-4Dis-WM-2_UM_GE_eQ-3_140731_web.pdf Bedienungsanleitung]
[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]

IR-WLAN-Gateway

2018-03-14T12:27:59Z

Pfriemler: Hardwarebox, Panasonic-Infos und Links, Bild

{{Infobox Hardware|Bild=IR_WLAN_Gateway_Modul.jpg
|Bildbeschreibung=IR-WLAN-Gateway
|HWProtocol=HTTP
|HWType=Sender/Receiver
|HWCategory=Other
|HWComm=2,4 GHz
|HWChannels=1
|HWVoltage=5V
|HWPoweredBy=Kleinspannung
|HWPowerConsumption= ~0,2W(Standby)
|HWSize=55x20 mm (Durchm. x Höhe)
|HWDeviceFHEM=HTTP oder IR-Blaster (inoff.)
|HWManufacturer=HomeBrew}}

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.

Prinzipiell genügen sehr wenige externe Bauteile zum ESP8266 oder einem Entwicklermodul, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
address - (optional) additional device address (decimal!)
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal zweimal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

==== Panasonic ====

Auch wenn sich ein Panasonic-TV (wie viele andere Geräte auch) optimal über Netzwerk steuern lässt, muss er zunächst ggf. aus dem deep standby geweckt werden. Leider gibt es hierfür keine dedizierten ON- und OFF-Befehle, sondern nur power toggle. Zum Einschalten muss der Befehl allerdings etwas länger gesendert werden (ebenso wie man den Knopf auf der Fernbedienung länger drücken muss), dies lässt sich durch zusätzliche 'pulse'- und 'pdelay'-Angaben erreichen:
IR_PanasonicTVPOWER_long [{'data':'0100BCBD','address':'16388','type':'PANASONIC','length':48,'pulse':10,'pdelay':1}]
Weitere Befehle finden sich über die Links am Ende des Artikels. Für TV-Mute könnte ein Befehl lauten:
IR_PanasonicTVMUTE [{'data':'01004C4D','address':'16388','type':'PANASONIC','length':48}]

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'0C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.
IR_LeinwandAB [{'data':[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]
IR_LeinwandAUF [{'data':[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]
IR_LeinwandSTOP [{'data':[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}
* Tabellen mit Sony-Fernbediencodes: [http://www.hifi-remote.com/sony/ diverse SONY-Codes]
* Tabelle mit Panasonic-Fernbediencodes: [http://www.rhoads.nu/bjorn/hp48/remote/remotes/panasoni/panasoni.txt (Textdatei zum Herunterladen)]
* LIRC Codes für VIERA Plasmafernseher: [http://lirc.sourceforge.net/remotes/panasonic/Viera-42PZ700U lirc.sourceforge.net]

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Infrarot]]

Datei:IR WLAN Gateway Modul.jpg

2018-03-14T12:23:18Z

Pfriemler: mit Genehmigung des Users gloob

mit Genehmigung des Users gloob

HM-LC-BL1-FM Funk-Jalousieaktor

2018-02-12T19:19:07Z

Pfriemler: /* Peeren mit einem HM-PB-2-WM55 */

{{Infobox Hardware
|Bild=HM-LC-BL1-FM-Ansicht.jpeg
|Bildbeschreibung=HomeMatic Unterputz Funk Rollladenaktor
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=<0,5W (Ruhebetrieb)
|HWPoweredBy=Netz
|HWSize=53x53x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

Homematic Funk-Jalousieaktor 1-fach (Unterputz)

== Features ==
Schalten eines angeschlossenen Jalousiemotors mittels [[CUL]]/CUN/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

'''Technische Daten:'''
* Schaltvermögen: 250W Motorlast 230V/50Hz
* Relais: 1x Schließer und 1 Wechsler
* Standby Verbrauch: 0,5W
* Maße(BxHxT): 53x53x30mm

== Installation ==
Will man die Funk-Schaltaktoren auch manuell betreiben, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zum Taster umgebaut werden, Tastschalter sind nicht geeignet. Schalter und Tastschalter führen dazu, dass der Aktor nach Betätigung des Schalters in den Anlernmodus versetzt wird und auch in diesem verbleibt.

Je nach vorhandenen Schalterdosen empfiehlt es sich, bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ kann der Aktor auch in einer zusätzlichen Schalterdosen untergebracht und diese mit einem Federdeckel verschlossen werden. Dies hat den Vorteil, dass auch durch eine relativ dicke Tapete die LED und somit der Zustand des Aktors erkannt werden kann.

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt oder es erfolgt über FHEM mittels der Seriennummer.

=== Konfiguration ===
Ein exemplarischer Auszug aus der [[Konfiguration]] (fhem.cfg):

<pre>
define JalousieWohnzimmer CUL_HM 17E43C
attr JalousieWohnzimmer devInfo 010100
attr JalousieWohnzimmer firmware 1.5
attr JalousieWohnzimmer hmClass receiver
attr JalousieWohnzimmer model HM-LC-BL1-FM
attr JalousieWohnzimmer room Wohnzimmer
attr JalousieWohnzimmer serialNr IEQ0xxxxxx
attr JalousieWohnzimmer subType blindActuator
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet. Im Falle der 10% geöffneten Jalousie wird diese geschlossen.
set <name> <Zweistellige Zahl> -> Schaltet den Aktor ein und öffnet die Jalousie um <Zweistellige Zahl>%. 100% entspricht dabei einem "on"
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%
</pre>

=== Fahrtzeiten kalibrieren ===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen, um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese drei Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:

<pre>
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden
</pre>

Ob alles geklappt hat, kann überprüft werden mit:
<pre>
set <name> getConfig
get <name> reg all
</pre>
Dort sollten dann die Werte stehen, z.B.
<pre>
WZ_Jal_Rechts type:blindActuator -
list:peer register :value
0: intKeyVisib :invisib
0: pairCentral :0xE1F88A
1: driveDown :27 s
1: driveTurn :0.5 s
1: driveUp :27 s
1: refRunCounter :0
1: sign :off
</pre>

Wenn ihr die Konfiguration des Schalters für Euch als Textdatei speichern wollt, dann hilft Euch ein
:<code>get <name> saveConfig <dateiname></code>

Das legt dann eine Datei in Eurem fhem-"root" Verzeichnis ab, in der alle Werte stehen.

=== Tasterverhalten ===

Ab Werk kann der durch einen kurzen Tastendruck gestartete Rolladen vor dem Erreichen der Endlage nur durch einen Tastendruck auf die entgegengesetzte Richtung gestoppt werden. Üblich bei vielen Rolladenantrieben sind aber beliebige kurze Tastendrücke. Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung, ist folgendermaßen vorzugehen:

* Wenn noch nicht geschehen, die internen Taster sichtbar schalten und die aktuelle Konfiguration abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (Nutzung von Templates, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self01:short
set <HMinfo> templateSet <device> BlStopDnSh self02:short
set <device> getConfig

* nun ggf. die internen Taster wieder unsichtbar schalten und die Konfiguration in FHEM aktualisieren
set <device> regSet intKeyVisib invisib
set <device> getConfig

''Hinweis: Dies entspricht dem Vorgehen beim [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor#Tasterverhalten|HM-LC-Bl1PBU-FM]], allerdings ist zu beachten, dass Ausgänge und Tasten bei diesem Aktor vertauscht sind, entsprechend sind die Templates auf die richtigen internen Tasten anzuwenden, wie oben beschrieben. Die Templates definieren (bzw. korrigieren) das gesamte Tasterverhalten auf Werkseinstellung, zusätzlich wird die sog. Sprungtabelle modifiziert, so dass ein fahrender Rolladen gestoppt wird (aufwärts: BlJtRampOn: rampOn -> on, abwärts: BlJtRampOff: rampoff -> off)''

Wie oben beschrieben führt eine dauerhafte Ansteuerung der Eingänge durch einen Schalter oder ein sehr langer Tastendruck (länger als 4 Sekunden) normalerweise dazu, dass der Aktor in den Anlernmodus versetzt wird. Es ist jedoch auch möglich, ein dem [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor|HM-LC-Bl1PBU-FM]] oder einem gepeerten Taster gleiches Tasterverhalten einzustellen (langes Drücken fährt dann den Rolladen nur so lange wie man drückt). Dazu begrenzt man die Verfügbarkeit des Anlernmodus auf eine wählbare Zeit (in Minuten) nach dem Einschalten des Stromes. Nach dieser Zeit ist der Anlernmodus gesperrt und kurze und längere Tastendrücke resultieren dann in unterschiedlichem Fahrverhalten.
set <device> regSet confBtnTime 5
Benötigt man den lokalen Anlernmodus wieder, so reicht es, den Aktor stromlos zu machen (Ausschalten der betreffenden Sicherung). Danach steht im obigen Beispiel der Anlernmodus durch langen Tastendruck in den ersten fünf Minuten zur Verfügung.
set <device> regSet confBtnTime permanent
macht die Änderung rückgängig.

=== Peeren mit einem HM-PB-2-WM55 ===

Um bei einem Ausfall von FHEM den Rollladenaktor ersatzweise mit einem Schalter bedienen zu können, kann auch ein [[HM-PB-2-WM55_2fach-Funk-Wandtaster|HM-PB-2-WM55]] gewählt werden, der direkt mit dem Rolladenaktor [[Peering (HomeMatic)|gepeert]] wird.

Mittels des Befehls

set <HM-PB-2-WM55>_01 peerChan 0 <HM-LC-BL1-FM>

werden gleich beide Taster (rauf/runter) mit dem Rolladenaktor gepeert. Der Channel 02 des Tasters übernimmt dann die Rauf-Funktion, der Channel 01 die Runter-Funktion. Mittels kurzem Druck des entsprechenden Tasters wird der Rolladen komplett hoch- bzw. runtergefahren (stopp mit dem jeweils anderen Taster). Ein langer Druck erzeugt eine Fahrt des Rolladen in die gewünschte Richtung '''für die Dauer''' des Tastendrucks.

Wünscht man das Stoppen des Rolladens bei kurzem Tastendruck auf eine beliebige Taste wie im Abschnitt zuvor beschrieben, dann ist entsprechend vorzugehen. Allerdings sind dann statt "self01" der Name des Kanals für die Aufwärtsfahrt und statt "self02" der Name des Kanals für die Abwärtsfahrt anzugeben.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:

<pre>
2012.02.12 17:53:08 2: CUL_HM set JalousieWohnzimmer on
2012.02.12 17:53:09 2: CUL_HM set JalousieWohnzimmer off
2012.02.12 21:25:14 2: CUL_HM set JalousieWohnzimmer 37
</pre>

= Links =
* [[Jalousie und Beleuchtung in mehreren Räumen]]
* [[Slider für HM-Rollladensteuerung anzeigen]]
* Bedienungsanleitung {{DocLink|elv|/service/manuals/76793_HM_Unterputzschalter_UM.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]

HM-LC-BL1-FM Funk-Jalousieaktor

2018-02-12T19:09:17Z

Pfriemler: /* Tasterverhalten */ Möglichkeit zur Angleichung des Tastverhaltens an die PBU-Variante oder gepeerte Taster

{{Infobox Hardware
|Bild=HM-LC-BL1-FM-Ansicht.jpeg
|Bildbeschreibung=HomeMatic Unterputz Funk Rollladenaktor
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=<0,5W (Ruhebetrieb)
|HWPoweredBy=Netz
|HWSize=53x53x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

Homematic Funk-Jalousieaktor 1-fach (Unterputz)

== Features ==
Schalten eines angeschlossenen Jalousiemotors mittels [[CUL]]/CUN/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

'''Technische Daten:'''
* Schaltvermögen: 250W Motorlast 230V/50Hz
* Relais: 1x Schließer und 1 Wechsler
* Standby Verbrauch: 0,5W
* Maße(BxHxT): 53x53x30mm

== Installation ==
Will man die Funk-Schaltaktoren auch manuell betreiben, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zum Taster umgebaut werden, Tastschalter sind nicht geeignet. Schalter und Tastschalter führen dazu, dass der Aktor nach Betätigung des Schalters in den Anlernmodus versetzt wird und auch in diesem verbleibt.

Je nach vorhandenen Schalterdosen empfiehlt es sich, bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ kann der Aktor auch in einer zusätzlichen Schalterdosen untergebracht und diese mit einem Federdeckel verschlossen werden. Dies hat den Vorteil, dass auch durch eine relativ dicke Tapete die LED und somit der Zustand des Aktors erkannt werden kann.

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt oder es erfolgt über FHEM mittels der Seriennummer.

=== Konfiguration ===
Ein exemplarischer Auszug aus der [[Konfiguration]] (fhem.cfg):

<pre>
define JalousieWohnzimmer CUL_HM 17E43C
attr JalousieWohnzimmer devInfo 010100
attr JalousieWohnzimmer firmware 1.5
attr JalousieWohnzimmer hmClass receiver
attr JalousieWohnzimmer model HM-LC-BL1-FM
attr JalousieWohnzimmer room Wohnzimmer
attr JalousieWohnzimmer serialNr IEQ0xxxxxx
attr JalousieWohnzimmer subType blindActuator
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet. Im Falle der 10% geöffneten Jalousie wird diese geschlossen.
set <name> <Zweistellige Zahl> -> Schaltet den Aktor ein und öffnet die Jalousie um <Zweistellige Zahl>%. 100% entspricht dabei einem "on"
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%
</pre>

=== Fahrtzeiten kalibrieren ===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen, um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese drei Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:

<pre>
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden
</pre>

Ob alles geklappt hat, kann überprüft werden mit:
<pre>
set <name> getConfig
get <name> reg all
</pre>
Dort sollten dann die Werte stehen, z.B.
<pre>
WZ_Jal_Rechts type:blindActuator -
list:peer register :value
0: intKeyVisib :invisib
0: pairCentral :0xE1F88A
1: driveDown :27 s
1: driveTurn :0.5 s
1: driveUp :27 s
1: refRunCounter :0
1: sign :off
</pre>

Wenn ihr die Konfiguration des Schalters für Euch als Textdatei speichern wollt, dann hilft Euch ein
:<code>get <name> saveConfig <dateiname></code>

Das legt dann eine Datei in Eurem fhem-"root" Verzeichnis ab, in der alle Werte stehen.

=== Tasterverhalten ===

Ab Werk kann der durch einen kurzen Tastendruck gestartete Rolladen vor dem Erreichen der Endlage nur durch einen Tastendruck auf die entgegengesetzte Richtung gestoppt werden. Üblich bei vielen Rolladenantrieben sind aber beliebige kurze Tastendrücke. Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung, ist folgendermaßen vorzugehen:

* Wenn noch nicht geschehen, die internen Taster sichtbar schalten und die aktuelle Konfiguration abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (Nutzung von Templates, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self01:short
set <HMinfo> templateSet <device> BlStopDnSh self02:short
set <device> getConfig

* nun ggf. die internen Taster wieder unsichtbar schalten und die Konfiguration in FHEM aktualisieren
set <device> regSet intKeyVisib invisib
set <device> getConfig

''Hinweis: Dies entspricht dem Vorgehen beim [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor#Tasterverhalten|HM-LC-Bl1PBU-FM]], allerdings ist zu beachten, dass Ausgänge und Tasten bei diesem Aktor vertauscht sind, entsprechend sind die Templates auf die richtigen internen Tasten anzuwenden, wie oben beschrieben. Die Templates definieren (bzw. korrigieren) das gesamte Tasterverhalten auf Werkseinstellung, zusätzlich wird die sog. Sprungtabelle modifiziert, so dass ein fahrender Rolladen gestoppt wird (aufwärts: BlJtRampOn: rampOn -> on, abwärts: BlJtRampOff: rampoff -> off)''

Wie oben beschrieben führt eine dauerhafte Ansteuerung der Eingänge durch einen Schalter oder ein sehr langer Tastendruck (länger als 4 Sekunden) normalerweise dazu, dass der Aktor in den Anlernmodus versetzt wird. Es ist jedoch auch möglich, ein dem [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor|HM-LC-Bl1PBU-FM]] oder einem gepeerten Taster gleiches Tasterverhalten einzustellen (langes Drücken fährt dann den Rolladen nur so lange wie man drückt). Dazu begrenzt man die Verfügbarkeit des Anlernmodus auf eine wählbare Zeit (in Minuten) nach dem Einschalten des Stromes. Nach dieser Zeit ist der Anlernmodus gesperrt und kurze und längere Tastendrücke resultieren dann in unterschiedlichem Fahrverhalten.
set <device> regSet confBtnTime 5
Benötigt man den lokalen Anlernmodus wieder, so reicht es, den Aktor stromlos zu machen (Ausschalten der betreffenden Sicherung). Danach steht im obigen Beispiel der Anlernmodus durch langen Tastendruck in den ersten fünf Minuten zur Verfügung.
set <device> regSet confBtnTime permanent
macht die Änderung rückgängig.

=== Peeren mit einem HM-PB-2-WM55 ===

Um bei einem Ausfall von FHEM den Rollladenaktor ersatzweise mit einem Schalter bedienen zu können, kann auch ein [[HM-PB-2-WM55_2fach-Funk-Wandtaster|HM-PB-2-WM55]] gewählt werden, der direkt mit dem Rolladenaktor [[Peering (HomeMatic)|gepeert]] wird.

Mittels des Befehls

set <HM-PB-2-WM55>_01 peerChan 0 <HM-LC-BL1-FM>

werden gleich beide Taster (rauf/runter) mit dem Rolladenaktor gepeert. Der Channel 02 des Tasters übernimmt dann die Rauf-Funktion, der Channel 01 die Runter-Funktion. Mittels kurzem Druck des entsprechenden Tasters wird der Rolladen komplett hoch- bzw. runtergefahren (stopp mit dem jeweils anderen Taster). Ein langer Druck erzeugt eine Fahrt des Rolladen in die gewünschte Richtung '''für die Dauer''' des Tastendrucks.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:

<pre>
2012.02.12 17:53:08 2: CUL_HM set JalousieWohnzimmer on
2012.02.12 17:53:09 2: CUL_HM set JalousieWohnzimmer off
2012.02.12 21:25:14 2: CUL_HM set JalousieWohnzimmer 37
</pre>

= Links =
* [[Jalousie und Beleuchtung in mehreren Räumen]]
* [[Slider für HM-Rollladensteuerung anzeigen]]
* Bedienungsanleitung {{DocLink|elv|/service/manuals/76793_HM_Unterputzschalter_UM.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]

HM-LC-BL1-FM Funk-Jalousieaktor

2018-02-12T18:52:22Z

Pfriemler: /* Tasterverhalten */ Hinweis auf korrekte Anwendung der Templates BlStopUpSh und BlStopDnSh gegenüber dem HM-LC-Bl1PBU-FM

{{Infobox Hardware
|Bild=HM-LC-BL1-FM-Ansicht.jpeg
|Bildbeschreibung=HomeMatic Unterputz Funk Rollladenaktor
|HWProtocol=HomeMatic
|HWType=Aktor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=<0,5W (Ruhebetrieb)
|HWPoweredBy=Netz
|HWSize=53x53x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

Homematic Funk-Jalousieaktor 1-fach (Unterputz)

== Features ==
Schalten eines angeschlossenen Jalousiemotors mittels [[CUL]]/CUN/[[HMLAN Konfigurator]] und über einen mechanischen spannungsfesten Taster.

'''Technische Daten:'''
* Schaltvermögen: 250W Motorlast 230V/50Hz
* Relais: 1x Schließer und 1 Wechsler
* Standby Verbrauch: 0,5W
* Maße(BxHxT): 53x53x30mm

== Installation ==
Will man die Funk-Schaltaktoren auch manuell betreiben, so sind Taster notwendig. Schalter können notfalls mittels einer zusätzlichen Feder zum Taster umgebaut werden, Tastschalter sind nicht geeignet. Schalter und Tastschalter führen dazu, dass der Aktor nach Betätigung des Schalters in den Anlernmodus versetzt wird und auch in diesem verbleibt.

Je nach vorhandenen Schalterdosen empfiehlt es sich, bestehende Schalterdosen nach hinten auszuweiten, d.h. die Abdeckung nach hinten heraus zu brechen, da die Aktoren und Kabel nicht gerade sparsam mit dem Platz umgehen. Alternativ kann der Aktor auch in einer zusätzlichen Schalterdosen untergebracht und diese mit einem Federdeckel verschlossen werden. Dies hat den Vorteil, dass auch durch eine relativ dicke Tapete die LED und somit der Zustand des Aktors erkannt werden kann.

== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Hierfür wird ein am Aktor temporär angeschlossener spannungsfester Taster zwingend benötigt oder es erfolgt über FHEM mittels der Seriennummer.

=== Konfiguration ===
Ein exemplarischer Auszug aus der [[Konfiguration]] (fhem.cfg):

<pre>
define JalousieWohnzimmer CUL_HM 17E43C
attr JalousieWohnzimmer devInfo 010100
attr JalousieWohnzimmer firmware 1.5
attr JalousieWohnzimmer hmClass receiver
attr JalousieWohnzimmer model HM-LC-BL1-FM
attr JalousieWohnzimmer room Wohnzimmer
attr JalousieWohnzimmer serialNr IEQ0xxxxxx
attr JalousieWohnzimmer subType blindActuator
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet. Im Falle der 10% geöffneten Jalousie wird diese geschlossen.
set <name> <Zweistellige Zahl> -> Schaltet den Aktor ein und öffnet die Jalousie um <Zweistellige Zahl>%. 100% entspricht dabei einem "on"
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%
</pre>

=== Fahrtzeiten kalibrieren ===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen, um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese drei Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:

<pre>
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden
</pre>

Ob alles geklappt hat, kann überprüft werden mit:
<pre>
set <name> getConfig
get <name> reg all
</pre>
Dort sollten dann die Werte stehen, z.B.
<pre>
WZ_Jal_Rechts type:blindActuator -
list:peer register :value
0: intKeyVisib :invisib
0: pairCentral :0xE1F88A
1: driveDown :27 s
1: driveTurn :0.5 s
1: driveUp :27 s
1: refRunCounter :0
1: sign :off
</pre>

Wenn ihr die Konfiguration des Schalters für Euch als Textdatei speichern wollt, dann hilft Euch ein
:<code>get <name> saveConfig <dateiname></code>

Das legt dann eine Datei in Eurem fhem-"root" Verzeichnis ab, in der alle Werte stehen.

=== Tasterverhalten ===

Ab Werk kann der durch einen kurzen Tastendruck gestartete Rolladen vor dem Erreichen der Endlage nur durch einen Tastendruck auf die entgegengesetzte Richtung gestoppt werden. Üblich bei vielen Rolladenantrieben sind aber beliebige kurze Tastendrücke. Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung, ist folgendermaßen vorzugehen:

* Wenn noch nicht geschehen, die internen Taster sichtbar schalten und die aktuelle Konfiguration abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (Nutzung von Templates, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self01:short
set <HMinfo> templateSet <device> BlStopDnSh self02:short
set <device> getConfig

* nun ggf. die internen Taster wieder unsichtbar schalten und die Konfiguration in FHEM aktualisieren
set <device> regSet intKeyVisib invisib
set <device> getConfig

''Hinweis: Dies entspricht dem Vorgehen beim [[HM-LC-Bl1PBU-FM_Unterputz-Jalousieaktor#Tasterverhalten|HM-LC-Bl1PBU-FM]], allerdings ist zu beachten, dass Ausgänge und Tasten bei diesem Aktor vertauscht sind, entsprechend sind die Templates auf die richtigen internen Tasten anzuwenden, wie oben beschrieben. Die Templates definieren (bzw. korrigieren) das gesamte Tasterverhalten auf Werkseinstellung, zusätzlich wird die sog. Sprungtabelle modifiziert, so dass ein fahrender Rolladen gestoppt wird (aufwärts: BlJtRampOn: rampOn -> on, abwärts: BlJtRampOff: rampoff -> off)''

=== Peeren mit einem HM-PB-2-WM55 ===

Um bei einem Ausfall von FHEM den Rollladenaktor ersatzweise mit einem Schalter bedienen zu können, kann auch ein [[HM-PB-2-WM55_2fach-Funk-Wandtaster|HM-PB-2-WM55]] gewählt werden, der direkt mit dem Rolladenaktor [[Peering (HomeMatic)|gepeert]] wird.

Mittels des Befehls

set <HM-PB-2-WM55>_01 peerChan 0 <HM-LC-BL1-FM>

werden gleich beide Taster (rauf/runter) mit dem Rolladenaktor gepeert. Der Channel 02 des Tasters übernimmt dann die Rauf-Funktion, der Channel 01 die Runter-Funktion. Mittels kurzem Druck des entsprechenden Tasters wird der Rolladen komplett hoch- bzw. runtergefahren (stopp mit dem jeweils anderen Taster). Ein langer Druck erzeugt eine Fahrt des Rolladen in die gewünschte Richtung '''für die Dauer''' des Tastendrucks.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:

<pre>
2012.02.12 17:53:08 2: CUL_HM set JalousieWohnzimmer on
2012.02.12 17:53:09 2: CUL_HM set JalousieWohnzimmer off
2012.02.12 21:25:14 2: CUL_HM set JalousieWohnzimmer 37
</pre>

= Links =
* [[Jalousie und Beleuchtung in mehreren Räumen]]
* [[Slider für HM-Rollladensteuerung anzeigen]]
* Bedienungsanleitung {{DocLink|elv|/service/manuals/76793_HM_Unterputzschalter_UM.pdf}})

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]

Diskussion:IR-WLAN-Gateway

2018-02-06T10:06:10Z

Pfriemler: Die Seite wurde neu angelegt: „Erste Version. Mir fehlen noch ein schönes Bild vom Modul. Mein Eigenaufbau ist nicht so vorzeigbar ... Frage 1: Codebeispiele im fertigen Code oder vielleich…“

Erste Version. Mir fehlen noch ein schönes Bild vom Modul. Mein Eigenaufbau ist nicht so vorzeigbar ...
Frage 1: Codebeispiele im fertigen Code oder vielleicht mehr Tabellen von Geräten. Ich finde meine Attributbezeichnungen (also "SonyBeamerON") recht selbstsprechend, aber vielleicht gibt es eine bessere Idee.
Rächtschreipfehla sind noch genug drin, merze ich später aus.--[[Benutzer:Pfriemler|Pfriemler]] ([[Benutzer Diskussion:Pfriemler|Diskussion]]) 11:06, 6. Feb. 2018 (CET)

IR-WLAN-Gateway

2018-02-05T21:20:55Z

Pfriemler: Ersterstellung

Das '''IR-WLAN-Gateway''' ist ein ESP8266-basierter Sender und Empfänger für Infrarotsignale zur Steuerung von Unterhaltungselektronik.
{{Baustelle}}
Prinzipiell genügen sehr wenige Bauteile, besondere Verbreitung hat jedoch ein Projekt gefunden, das auch unter dem Namen '''IRBlaster''' bekannt ist. Eine Zusatzplatine zu einem WEMOS-D1-Modul mit bis zu sechs Infrarot-Sendedioden und optionalen Status-LED benötigt insgesamt nur eine 5-Volt-Versorgung, etwa aus einem Handynetzteil. Durch die hohe Sendeleistung werden auch ungünstig platzierte Geräte per Streulicht oft besser erreicht als mit den originalen Fernbedienungen.

== Eigenschaften ==
* direkte Unterstützung zahlreicher Hersteller-Protokolle
* indirekte Unterstützung diverser anderer Hardware durch RAW-Protokoll
* Integrierter Webserver u.a. mit Analyse empfangener IR-Codes inkl. Zuordnung zu Protokollen, Liste zuletzt empfangener und gesendeter Codes, diverse Einstellungen
* Aussendung von IR-Codes mittels einzeiliger Aufrufe (aus FHEM mit getHttp, inkl. Rückmeldung)
* over-the-air (OTA) Firmware-Update möglich

== Spezifikationen ==
* Eingangsspannung: 5V, max. 1A
* Maße: ca. 55 x 20 mm (Durchmesser x Höhe)
* Netzwerk-Anschluss: WLAN, 2,4 Ghz

== Weitere Informationen ==

Einen sehr umfänglichen Artikel gibt es im ESP8266-Unterforum der Bastelecke (Link s.u.), in welchem Aufbau, Verwendung in FHEM sowie Firmwareversionen fortlaufend diskutiert und weiterentwickelt werden. Die Informationen dort sind i.d.R. aktueller als in diesem Artikel.

Fertige WLAN-Interfaces oder Leiterplatten werden gelegentlich in wechselnden Threads im Marktplatz - Güter angeboten.

Die Entwicklung ist derzeit (Januar 2018) noch im Gange, weitere Funktionen werden noch eingebaut.

== Hinweise zum Betrieb mit FHEM ==

=== Betrieb über GetHttpFile-Aufrufe ===

Man kann einen Dummy definieren:

define IR_Command dummy
attr IR_Command room IR_Remote
attr IR_Command setList TV_1 TV_2 TV_12 TV_Power
attr IR_Command webCmd TV_1:TV_2:TV_12:TV_Power

und auf dessen Änderung mit einem DOIF reagieren:

define IR_Remote DOIF ([IR_Command] eq "TV_1") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_2") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_12") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")})\
DOELSEIF ([IR_Command] eq "TV_Power") ({GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E040BF','type':'SAMSUNG','length':32}]")})
attr IR_Remote do always
attr IR_Remote room IR_Remote
attr IR_Remote verbose 0

Der JSON Part kann folgende Parameter enthalten:

data - IR code data, may be simple HEX code such as "A90" or an array of int values when transmitting a RAW sequence
type - Type of signal transmitted. Example "SONY", "RAW", "Delay" or "Roomba" (and many others)
length - (conditional) Bit length, example 12. Parameter does not need to be specified for RAW or Roomba signals
pulse - (optional) Repeat a signal rapidly. Default 1
pdelay - (optional) Delay between pulses in milliseconds. Default 100
repeat - (optional) Number of times to send the signal. Default 1. Useful for emulating multiple button presses for functions like large volume adjustments or sleep timer
rdelay - (optional) Delay between repeats in milliseconds. Default 1000
khz - (conditional) Transmission frequency in kilohertz. Default 38. Only required when transmitting RAW signal

Zwei oder mehr unterschiedliche Signale können in einem Kommando gesendet werden:

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32},{'data':'E0E0A05F','type':'SAMSUNG','length':32}]")}

Soll das gleiche Signal 2 mal gesendet werden, gibt es dafür den Parameter "repeat"

{GetHttpFile("192.168.1.27","/json?plain=[{'data':'E0E020DF','type':'SAMSUNG','length':32,'repeat':2}]")}

=== Betrieb über eigenes FHEM-Modul 84_IRBlaster ===

Wesentlich komfortabler und einrichtungsfreundlicher ist das Modul 84_IrBlaster.pm (Link s.u.). Das Modul kann die Erreichbarkeit der Hardware prüfen, Codes werden per <code>set <IrBlaster> add <Codename> [{'data...}]</code> als Attribute hinterlegt und gepflegt, der Aufruf erfolgt dann mit <code>set <IrBlaster> send <Codename></code>. Mehrfache oder wiederholte Codes sind entsprechend ebenso möglich. Die Modulhilfe erläutert umfassend Einrichtung und Einsatz. Eine Beispieldefinition:
defmod IRWz IrBlaster 192.168.178.60 IR_ ## IR_ ist ein definierte Präfix für alle Attribute, kann selbst bestimmt werden
attr IRWz userattr IR_.* ... ## diese Userattribute werden vom Modul IR_PhilipsTVON IR_PhilipsTVPOWER IR_SonyBeamer2XPOWER IR_SonyBeamerOFF IR_SonyBeamerON IR_SonyBeamerPOWER IR_SonyBlurayEJECT
attr IRWz icon IR
attr IRWz interval 60 ## das Gateway wird jede Minute angepingt
attr IRWz maxRetries 0 ## Anzahl der Wiederholungen, wenn das Gateway nicht reagiert
...
attr IRWz IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
attr IRWz IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}] ... usw. siehe Codebeispiele!

=== Anzeige empfangerer Codes mit KeyValueProtokoll ===

FHEM kann die empfangenen Codes, die das Hardware-Modul per UDP broadcastet, anzeigen. Zunächst definiert man ein KVP-Device, z.B.:

defmod myKVPUDP KVPUDP
attr myKVPUDP group Schnittstellen
attr myKVPUDP room System

Empfängt das WLAN-Modul innerhalb von 2 Minuten zwei oder mehrere IR-Codes, legt myKVPUDP automatisch ein passendes Gerät an, z.B.:

defmod KeyValueProtocol_IR_Blaster_1440790 KeyValueProtocol IR_Blaster 1440790
attr KeyValueProtocol_IR_Blaster_1440790 IODev myKVPUDP

in dessen Readings dann die letzten fünf empfangenen Codes gelistet werden:

2018-02-05 19:06:22 CR01_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3522,298,468,354,5316,272], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR02_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1116,1478,510,550,586], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR03_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[776,1292,482,2910,350], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR04_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[1432,1004,432,1106,664,1534,484,1184,324,5450,302,824,276], 'type':'raw', 'khz':38}]
2018-02-05 19:06:22 CR05_Json_Local_IP http://192.168.178.60:80/json?plain=[{'data':[588,3280,302,8356,380], 'type':'raw', 'khz':38}]
2018-01-31 23:03:43 ChipID 1440790
2018-01-31 23:03:43 FlashChipId 1458400
2018-01-31 23:03:43 MAC 60:01:94:xx:xx:xx
2018-01-31 23:03:43 ResetURL http://192.168.178.60:80/reset
2018-01-31 23:03:43 UpdateURL http://192.168.178.60:80/upload
2018-01-31 23:03:43 Version v2.7.3beta

Auf die Änderungen von <code>CR0x_JSON_...</code> kann dann entsprechend reagiert werden. Die Funktion ist aber derzeit noch nicht wirklich stabil und vor allem für eine zeitnahe Auswertung von empfangenen Codes zu langsam, zudem ist der Code-Interpreter im ESP8266 nicht sehr sicher und liefert viele Fake-Codes. Dessen Funktion ist eigentlich auch nur zur einmaligen Ermittlung von IR-Codes vorhandener Fernbedienungen gedacht.

=== Ermittlung von IR-Codes vorhandener Fernbedienungen ===

Hat man ein KVP-Device definiert, lassen sich die letzten fünf empfangenen Codes von Fernbedienungen anzeigen. Alternativ kann man direkt im Webinterface des Moduls nachsehen, welches man mit <code>http://<IP-Adresse-des-Moduls</code> aufruft, ggf. nach einem Browser-Refresh. Dort lassen sich auch definitionsfreundliche JSON-Blöcke direkt kopieren.

Beim Anlernen ist Fingerspitzengefühl gefragt, manche Codes werden bei längerem, manche bei sehr kurzem Tastendruck besser erkannt. Taucht ein Code besonders regelmäßig oder häufig in der Liste auf, ist er wahrscheinlich der richtige. Ein Test kann direkt aus dem Browser erfolgen, dazu einfach eine angezeigte Zeile in ein separates Fenster kopieren und abschicken.

=== Erzeugung eigener Codes und Beispiele ===

''Nachfolgend werden Details und Beispiele zu einzelnen Code-Familien vorgestellt, bitte die Liste ergänzen!''

==== SONY ====

Für SONY-Geräte gibt es derzeit verschiedene Codes mit verschiedenen Bitlängen und Formaten:
* 12-bit-Folgen bestehen aus 5 Adress- und 7 Befehlsbits.
* 15-bit-Folgen bestehen aus 8 Adress- und 7 Befehlsbits.
* 20-bit-Folgen bestehen aus 8 Extension-, 5 Adress- und 7 Befehlsbits.

Sony sendet LSB first, die Bitfolgen müssen also invertiert werden. Das IR-Gateway wird immer mit Bytes befüttert, im Falle von 15-bit-Folgen setzt man dazu eine 0 vor die gespiegelte Folge.

Konstruktionsbeispiele:
Beamer (Gerätecode 84, Befehl 47 = POWER OFF)
-> Adresse 84 (8 bit) ist hex "54" oder "01010100", Befehl ist 47, hex "2F", aber nur sieben bits, also "0101111", zusammen also "01010100,0101111".
spiegeln und noch eine 0 davor setzen und gruppiert für die Optik: 0,111 1010,0010 1010 = hexadezimal "7A2A".

SONY-TV (Gerät 1, Befehl 47 = POWER OFF)
-> Adresse (5 bit) "00001", Befehl "2F" bzw. "0101111", zusammen also "00001,0101111"
gespiegelt "1111 010,1 0000", 12 bits, ohne Füllbit = "F50"

SONY-Bluray-Player (Gerät 26, Extension 226, Befehl 47 = POWER OFF)
-> Extension (8bit) hex E2h bzw. "1110 0010", Adresse (5 bit) hex 1Ah bzw. "11010", Befehl "2F" bzw. "0101111", zusammen also "11100010,11010,0101111"
gespiegelt "1111 010,0 1011,0100 0111", kein Füllbit nötig, "F4B47"

Ein fertiger Befehl wäre dann zum Beispiel
<code> {GetHttpFile("192.168.178.60","/json?plain=[{'data':'7A2A','type':'SONY','length':15}]")}</code>

Fertige Codes aus der 84_IrBlaster-Definition zur Nachnutzung:
IR_SonyBeamerOFF [{'data':'7A2A','type':'SONY','length':15}]
IR_SonyBeamerON [{'data':'3A2A','type':'SONY','length':15}]
IR_SonyBlurayEJECT [{'data':'68B47','type':'SONY','length':20}]
IR_SonyBlurayOFF [{'data':'F4B47','type':'SONY','length':20}]
IR_SonyBlurayON [{'data':'74B47','type':'SONY','length':20}]

==== NEC ====

NEC-Codes werden unter anderem von Yamaha-Geräten, aber auch von Dingen wie infrarotgesteuerte LED-Wachs- oder Baumkerzen verwendet. Es werden 16-, 24- und 32-bit Codes unterschieden, deren Konstruktion einfachen Regeln folgt - unter anderem werden die Informationen oft zu 32-bit-Folgen ergänzt

16-bit Codes werden byteweise negiert wiederholt. Ein gesendeter Code "00FF807F" setzt sich eigentlich aus "00" und "80" zusammen, die jeweils von den bitweise negierten Bytes gefolgt werden: Auf ''0000 0000'' folgt ''1111 1111'', auf ''1000 0000'' entsprechend ''0111 1111''.

IR_BaumkerzenAN [{'data':'FF807F','type':'NEC','length':32}]
IR_BaumkerzenAUS [{'data':'FF906F','type':'NEC','length':32}]
IR_KerzenAN [{'data':'FF10EF','type':'NEC','length':32}]
IR_KerzenAUS [{'data':'FF20DF','type':'NEC','length':32}]

Diese Codes wurden mit dem Gateway ermittelt. Allerdings gibt es eine gegenseitige Beeinflussung, so führt jeder Baumkerzenbefehl zu einem Einschalten der Wachskerzen, und ein anderer Befehl toggelt sie. Amn muss in diesem Fall eben stets zwei Codes senden.

Ein Yamaha-AVR-Receiver wird mit 16-, 24- und 32-bit-Befehlen gesteuert. Die in den Codetabellen (etwa in Servicehandbüchern) gelisteten Befehle gehorchen einem Schema xx-xx, xx-xxxx, xxxx-xx oder xxxx-xxxx. Auch hier wird eine xx-Gruppe negiert wiederholt, bei xxxx-Angaben jedoch nicht. Außerdem werden die Bytes jeweils gespiegelt gesendet (LSB->MSB).

Der Code "7A-1C" (Mute) wird wie folgt umgerechnet:
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 1C entspricht 0001 1100, gespiegelt 0011 1000, negiert 1100 0111, zusammengesetzt = 38C7, beides zusammen ergibt als Befehlscode <code>[{'data':'5EA138C7','type':'NEC','length':32}]</code>

Der Code "7A-4738" (Eingang HDMI-1 bei einem RX-V 667 und kompatiblen) wird entsprechend
* 7A entspricht 0111 1010, gespiegelt 0101 1110, negiert 1010 0001, zusammengesetzt = 5EA1
* 47 entspricht 0100 0111, gespiegelt 1110 0010, nicht negiert wiederholt, = E2
* 38 entspricht 0011 1000, gespiegelt 0001 1100 = 1C, alles zusammen wird <code>[{'data':'5EA1E21C','type':'NEC','length':32}]</code>

Nur wenig dokumentiert sind hier die wertvollen diskreten ON- und OFF-Befehle statt des üblichen Power-Toggle. Sie funktionieren aber zum Glück auch hier:
IR_YamahaReceiverHDMI1 [{'data':'5EA1E21C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI2 [{'data':'5EA152AC','type':'NEC','length':32}]
IR_YamahaReceiverHDMI3 [{'data':'5EA1B24C','type':'NEC','length':32}]
IR_YamahaReceiverHDMI4 [{'data':'5EA10AF4','type':'NEC','length':32}]
IR_YamahaReceiverMUTE [{'data':'5EA138C7','type':'NEC','length':32}]
IR_YamahaReceiverOFF [{'data':'7E81FE01','type':'NEC','length':32}]
IR_YamahaReceiverON [{'data':'7E817E81','type':'NEC','length':32}]
IR_YamahaReceiverPOWER [{'data':'7E8154AB','type':'NEC','length':32}]

==== RC5 und RC6 ====

Mit dem Gateway ermittelte und getestete Codebeispiele für einen Philips-Fernseher des 2010er Baujahres
IR_PhilipsTVAmbilight [{'data':'8F','type':'RC6','length':20}]
IR_PhilipsTVMUTE [{'data':'D','type':'RC6','length':20}]
IR_PhilipsTVOFF [{'data':'3D','type':'RC6','length':20}]
IR_PhilipsTVON [{'data':'3F','type':'RC6','length':20}]
IR_PhilipsTVPOWER [{'data':'1000C','type':'RC6','length':20}]

''Hinweis: Hier fehlen noch Hinweise, wie man RC5- und RC6-Codes mit zusätzlichen Adressen (etwa RC5 3,56) korrekt umrechnet.''

==== RAW-Codes ====
Die folgenden Codes steuern eine Motorleinwand von EliteScreens. Die Codes wurden vom Gateway als RAW erkannt und nachträglich im Timing etwas gerichtet. Die krummen Zahlen entsprechen den umgerechneten Timing-Angaben aus der Herstellerdokumentation.
IR_LeinwandAB [{'data':[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,1263,421,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]
IR_LeinwandAUF [{'data':[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,421,1263,1263,421,421,1263,421,1263,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,1263,421,1263,421,421,1263,1263,421,421,1263,1263,421,421,1263,421,1263,1263],'type':'raw','khz':38}]
IR_LeinwandSTOP [{'data':[1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421,1263,421,1263,421,1263,421,1263,421,1263,1263,421,421,1263,1263,421,421,1263,1263,421,1263,421,1263,421,421,1263,421,1263,1263,421,1263,421,421,1263,421,1263,421,1263,1263,421,1263,421,1263,421,1263,421,421,1263,421,1263,421],'type':'raw','khz':38}]

== Bekannte Probleme ==
Das etwas problematische Erkennen wurde bereits beschrieben.

== Links ==
* Hardwarebeschreibung: [https://github.com/emc2cube/MySWeMosIRShield Platinenlayout, Bauteileliste]
* Infos zur Hardware und Firmware: {{Link2Forum|Topic=72950|LinkText=360 Grad IR WLAN Gateway}}
* Infos zum FHEM-Modul: {{Link2Forum|Topic=80579|LinkText=84_IrBlaster - Modul zur Ansteuerung des (360 Grad) IR WLAN Gateways}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]

IR-WLAN-Gateway

2018-02-05T15:51:38Z

Pfriemler: Erste Vorbaustelle, siehe Diskussion!

HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP

2017-12-15T20:48:48Z

Pfriemler: /* Mögliche Hardwaredefekte */ kleine Korrekturen und Ergänzungen

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Dimmer|Dimmer]]
|HWCategory=[[:Kategorie:Dimmer|Dimmer]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=1 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
Der '''HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP''' ist ein Phasenabschnitts-Dimmer für die Unterputzmontage. Er verfügt über eine Schalterwippe, die sich mit einem Adapter in einige Schalterprogramme verschiedener Hersteller integrieren lässt. Der Dimmer kann sowohl vor Ort über die Schalterwippe als auch per Funk gesteuert werden.

== Features ==

Schaltdoseneinsatz als Ersatz für vorhandenen Dimmer-Einsatz (erfordert keine tiefere Schaltdose). Kann mittels Adapter in bestehende Schalterserien wie Busch Jäger, Gira usw. integriert werden.

=== Technische Daten ===

* Versorgungsspannung: 230 V / 50 Hz
* Minimallast: 10 VA
* Minimalstrom: 40 mA
* Maximale Schaltleistung: 180 VA
* Standby-Verbrauch: 1 W
* Dimmverfahren: Phasenabschnitt
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5 °C bis +35 °C
* Abmessungen (BxHxT): 71x71x37 mm
* Gewicht: 43 g

=== Schalter ===

Der HM-LC-Dim1TPBU-FM besitzt zwei Schalter, die über eine Wippe angewählt werden können. Das Standard-Verhalten entspricht im Prinzip dem [[HM-LC-Bl1PBU-FM Unterputz-Jalousieaktor]]:

* Ein kurzer Druck nach oben Schaltet den Verbraucher ein (100 % Leistung).
* Ein kurzer Durck nach unten Schaltet den Verbraucher aus (0 % Leistung).
* Ein langer Druck nach oben erhöht die Leistung bis der Schalter losgelassen wird.
* Ein langer Druck nach unten verringert die Leistung bis der Schalter losgelassen wird.

== Hinweise zur Hardware-Installation ==

Der HM-LC-Dim1TPBU-FM verfügt über vier Anschlussklemmen: Phase, gedimmte Phase und zwei kurzgeschlossene Klemmen für den Neutralleiter. Das heißt, dass der Neutralleiter "durchgeschleift" werden kann.

Der HM-LC-Dim1TPBU-FM füllt die Schalterdose links und rechts nahezu aus. Wenn möglich ist eine Zuführung der Leitungen von oben oder unten zu bevorzugen.

== Kompatible Leuchtmittel ==

In der Detailansicht vieler LED-Lampen auf der Webseite von ELV.de lässt sich eine Dimmer-Kompatibilitätsliste für das jeweilige Modell herunterladen.

== Mögliche Hardwaredefekte ==

Wenn der Dimmer zwischendruch immer wieder neu startet, beim Hochdimmen oder kurz danach spontan abschaltet, sich nur noch lokal, aber nicht mehr per Fernbedienung steuern lässt, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C7. (Einen vergleichbarer Defekt tritt auch häufig beim Dimmer [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] oder dem Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, RM 2,5 radial, 10µ/25V (Ersatz mit höherer Spannung unproblematisch). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L2) und dem dreipoligen IC2 (Linearregler). Die Platine hat Bestückungsdruck, C7 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

Siehe auch die Diskussion im Forum: --> https://forum.fhem.de/index.php/topic,55149.msg346499/topicseen.html

== Links ==

* Anleitung: http://files.elv.de/Assets/Produkte/10/1030/103020/Downloads/103020_FunkDimmaktor_um.pdf

[[Kategorie:HomeMatic Components]]
[[Kategorie:Dimmer]]

HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach

2017-12-15T20:48:13Z

Pfriemler: /* Mögliche Hardware Defekte */

{{Infobox Hardware|Bild=HM-LC-Sw1PBU-FM_Front.jpg
|Bildbeschreibung=HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach für Markenschalter
|HWProtocol=HomeMatic
|HWType=Aktor / Sender
|HWCategory=HomeMatic
|HWComm=868,3MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=0,5W (Standby)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=eQ-3}}

[[HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach]] ist ein einkanaliger Funk-Schaltaktor "für Markenschalter", der mittels entsprechender Installationsadapter mit Tasterwippen diverser renommierter Hersteller versehen werden kann und sich dadurch nahtlos in bestehende Elektroinstallationen einfügt.

== Features ==
Das besondere an diesem Schalter ist, dass er den vorhandenen Unterputzeinsatz vollständig ersetzt. Dabei kann die Wippe des vorhandenen Schalters - je nach Hersteller - mit einer entsprechenden Adapterplatte weiterverwendet werden.

Es handelt sich hierbei nur um einen Aktor. Es ist nicht möglich die Taster mit anderen Homematic Geräten zu peeren. Man kann nur andere Taster mit dem Aktor peeren und diesen fernsteuern.

== Technische Daten ==

{|
| Art
| Unterputz
|-
| Typ
| 1fach
|-
| Stand-by-Verbrauch
| 0,5 W (lt. Bedienungsanleitung, S. 31, Stand 02/2012, 1 W)
|-
| Versorgungsspannung
| 230 V
|-
| Abmessungen (B x H x T)
| 71 x 71 x 37 mm
|-
| Farbe
| Grau
|-
| Max. Schaltleistung
| 1000 W
|-
| Relaistyp
| Wechsler
|-
| Funkfrequenz
| 868,3 MHz
|-
| Empfängerklasse
| SRD Class 2
|-
| Sicherung (intern)
| Rundsicherung 5 A, träge
|-
| Max. Sendeleistung
| 10 mW
|-
| IP-Schutzgrad
| IP 20
|-
| Umgebungstemperaturbereich
| 5–35 °C
|}

== Hinweise zur Hardware-Installation ==
Der vorhandene Schalter muss ersetzt werden. Dabei sind ein paar Dinge zu beachten:

* Der (neue) Schalter benötigt neben dem L-Leiter auch einen N-Leiter für die Stromversorgung.
* Die Befestigung ist nicht wie bei dem System z.B. von Merten durch spreizen von Klammern möglich. Der Schalter muss in die Löcher in der Dose geschraubt werden (Schrauben im Lieferumfang enthalten).
* Die "Frontplatte" bzw. der Befestigungsrahmen ist etwas dicker, als der Rahmen eines normalen Schalters. Dadurch kann es sein, dass der vorhandene Rahmen des Schalters nicht mehr ganz an der Wand anliegt.
* Um die bereits vorhandene Schalter-Wippe weiter nutzen zu können, muss ein passender Adapter verwendet werden.

{{Randnotiz|RNText='''Info zum Bausatz'''
Das Gerät ist als Bausatz verfügbar, es sind die folgenden bedrahteten Bauteile einzulöten:
* 6 Kondensatoren
* 3 Stiftleisten/Fassungen (insgesamt 16 Pole)
* 1 Spannungsregler, 1 Diode
* 1 Relais (8 Pole)
* 1 Induktivität
* 1 Widerstand, 1 Varistor
Die zu lötenden Bauteile sind relativ unproblematisch, die Lötstellen befinden sich jedoch in drei Fällen sehr nah an bzw. zwischen vorbestückten SMD-Bauteilen.}}
== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:

<pre>
define LichtWohnzimmer CUL_HM 197764
attr LichtWohnzimmer devInfo 010100
attr LichtWohnzimmer firmware 2.1
attr LichtWohnzimmer hmClass receiver
attr LichtWohnzimmer model unknown
attr LichtWohnzimmer room Wohnzimmer
attr LichtWohnzimmer serialNr JEQ0xxxxxx
attr LichtWohnzimmer subType switch
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet
</pre>

Zusätzliche Funktionen wie ein direkter Zugriff auf die integrierten Taster (self01 und self02) des Schalters können durch Programmieren der [[HomeMatic_Register_programmieren | HomeMatic Register]] realisiert werden.

Dabei entspricht self01 dem Ausschalter des Wippschalters und self02 dem Einschalter des Wippschalters. Settings, die man also für den self01 Schalter einstellt, werden beim Ausschalten des Lichts (im Standard) angewandt und umgekehrt.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-Sw1PBU-FM folgendes Log zu sehen:
<pre>
2012-06-05_00:09:22 LichtWohnzimmer deviceMsg: off
2012-06-05_00:09:22 LichtWohnzimmer off
2012-06-05_07:40:51 LichtWohnzimmer on
2012-06-05_07:40:51 LichtWohnzimmer deviceMsg: on
</pre>

Beim Einrichten des Schalters kommt folgender Auszug (Stand: 06.2012)
<pre>
2012.06.04 23:12:27 2: CUL_HM pair: CUL_HM_switch_197764 is a switch, model unknown serialNr JEQ0xxxxxx
</pre>

=== Funktion als Treppenlichtschalter ===
Um dafür zu sorgen, dass z.B. ein durch den HM-LC-Sw1PBU-FM eingeschaltetes Licht automatisch von FHEM nach 10 Minuten ausgeschaltet wird, kann folgende Definition verwendet werden:
:<code>define Beleuchtung_an notify Beleuchtung:on* define Beleuchtung_aus at +00:10:00 set Beleuchtung off </code>
Das Licht kann auch direkt über den Schalter nach 10 Minuten ausgeschaltet werden. Dies hat den Vorteil, dass die Funktion auch ohne FHEM funktioniert und keinen Funkverkehr verursacht. Wert ist in Sekunden also 60*10 für 10 Minuten. Es gibt zwei Schaltoperationen long press (lg) und short press (sh), short press ist ein kurzes antippen, long press ist den Schalter für ca. 1 Sekunde oder mehr gedrückt halten.
set <device> regSet shOnTime 600 self01
set <device> regSet lgOnTime 600 self01
set <device> regSet shOnTime 600 self02
set <device> regSet lgOnTime 600 self02

=== Workaround um den Taster in FHEM zu nutzen ===
Man kann den Taster in der Originalfirmware nicht mit anderen Geräten peeren. Allerdings kann man mit folgendem Workaround den Taster in FHEM nutzen. Das hat jedoch eine Verzögerung zwischen drei und acht Sekunden zur Folge. Dabei ist es trotzdem möglich, den Aktor per FHEM oder gepeertem Gerät weiter zu steuern. Der Taster beeinflusst den Aktor nicht mehr. Das ganze funktioniert, weil der HM-LC-Sw1PBU-FM bei jedem Tastendruck das reading für state aktualisiert, auch wenn sich der Wert nicht ändert.

Zuerst setzt man ein event auf event-on-change-reading:

attr HM-LC-Sw1PBU-FM event-on-change-reading state
attr HM-LC-Sw1PBU-FM event-on-update-reading state

Weiterhin wird der Schalter deaktiviert (hier nur für kurzen Tastendruck; mit lgSwJtXXX wird dieser Effekt auch für den langen Tastendruck erzielt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOn on self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self02
set HM-LC-Sw1PBU-FM regSet exec shSwJtOn on self02

Nun setzt man einen Notify auf das Reading:
:<code>define HM-LC-Sw1PBU-FM-TasterPressed notify HM-LC-Sw1PBU-FM {set YourOtherDevice toggle}</code>

=== Alternative Firmware ===
Um die beiden Taster als Remote und den Aktor getrennt zu nutzen gibt es alternative Firmware, deren Funktion und Benutzung auf der Seite [[HM-LC-Sw1PBU-FM Alternative Firmware]] im Detail beschrieben ist.

=== Schalter immer toggeln lassen ===
Im Werkszustand schaltet die Wippe bei Druck auf der einen Seite ein, auf der anderen Seite aus. Möchte man, dass bei jedem Tastendruck einfach der Zustand geändert wird, kann man das wie folgt erreichen (unten nur für den kurzen Tastendruck dargestellt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self01
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self01
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self01
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self02
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self02
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self02

Um den Werkszustand bezüglich Schaltwippe wiederherzustellen (eine Seite schaltet aus, die andere wieder ein) entsprechen folgende Einstellungen dem Werkszustand:
set <device> regSet shSwJtOn dlyOff self01
set <device> regSet shSwJtOff off self01
set <device> regSet shSwJtDlyOn off self01
set <device> regSet shSwJtDlyOff off self01
set <device> regSet shSwJtOn on self02
set <device> regSet shSwJtOff dlyOn self02
set <device> regSet shSwJtDlyOn on self02
set <device> regSet shSwJtDlyOff on self02

=== on-for-timer Ersatz ===
Der HM-LC-Sw1PBU-FM kennt kein <code>set on-for-timer</code>. Um den HM-LC-Sw1PBU-FM trotzdem für einige Zeit anschalten zu können (z. B. wenn ein Fensteröffner dranhängt und das Fenster nur für eine gewisse Zeit geöffnet werden soll), muss ein Button der vccu mit dem HM-LC-Sw1PBU-FM gepeered werden:
set vccu_Btn4 peerChan 0 HM-LC-Sw1PBU-FM dual set

Danach wären (in diesem Fall mit vccu_Btn4) die virtuellen Buttons 4 und 5 mit dem HM-LC-Sw1PBU-FM gepeered. Das Fenster könnte dann über <code>set vccu_Btn4 press short</code> für die vorher über <code>set HM-LC-Sw1PBU-FM regSet shOnTime [Dauer] vccu_Btn4</code> die Öffnungszeit eingestellt werden kann.

== Mögliche Hardwaredefekte ==

Wenn der Schalter zwischendruch immer wieder neu startet, bei lokaler Bedienung sofort wieder ausschaltet und aus FHEM kaum oder nicht ansprechbar und auch auf verknüpfte Sender nicht reagiert, kann ein Kondensator defekt sein, hier C26. (Einen vergleichbarer Defekt tritt auch häufig beim Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, RM 2,5 radial, 10µ/25V (Ersatz mit höherer Spannung unproblematisch). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen neben einer Spule (L21). Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

== Links ==
* Anleitung (PDF {{DocLink|elv|/Assets/Produkte/10/1030/103029/Downloads/103029_FunkSchaltaktor_um.pdf}})
* Produktwebseite bei [http://www.elv.de/output/controller.aspx?cid=74&detail=10&detail2=37991 ELV]
* [[HM-LC-Sw1PBU-FM Alternative_Firmware|Alternative Firmware]]

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

HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach

2017-12-15T20:48:03Z

Pfriemler: /* Mögliche Hardware Defekte */ Kleine Ergänzungen in Analogie zu den anderen Geräten gleicher Bauart

{{Infobox Hardware|Bild=HM-LC-Sw1PBU-FM_Front.jpg
|Bildbeschreibung=HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach für Markenschalter
|HWProtocol=HomeMatic
|HWType=Aktor / Sender
|HWCategory=HomeMatic
|HWComm=868,3MHz
|HWChannels=1
|HWVoltage=230V
|HWPowerConsumption=0,5W (Standby)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=eQ-3}}

[[HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach]] ist ein einkanaliger Funk-Schaltaktor "für Markenschalter", der mittels entsprechender Installationsadapter mit Tasterwippen diverser renommierter Hersteller versehen werden kann und sich dadurch nahtlos in bestehende Elektroinstallationen einfügt.

== Features ==
Das besondere an diesem Schalter ist, dass er den vorhandenen Unterputzeinsatz vollständig ersetzt. Dabei kann die Wippe des vorhandenen Schalters - je nach Hersteller - mit einer entsprechenden Adapterplatte weiterverwendet werden.

Es handelt sich hierbei nur um einen Aktor. Es ist nicht möglich die Taster mit anderen Homematic Geräten zu peeren. Man kann nur andere Taster mit dem Aktor peeren und diesen fernsteuern.

== Technische Daten ==

{|
| Art
| Unterputz
|-
| Typ
| 1fach
|-
| Stand-by-Verbrauch
| 0,5 W (lt. Bedienungsanleitung, S. 31, Stand 02/2012, 1 W)
|-
| Versorgungsspannung
| 230 V
|-
| Abmessungen (B x H x T)
| 71 x 71 x 37 mm
|-
| Farbe
| Grau
|-
| Max. Schaltleistung
| 1000 W
|-
| Relaistyp
| Wechsler
|-
| Funkfrequenz
| 868,3 MHz
|-
| Empfängerklasse
| SRD Class 2
|-
| Sicherung (intern)
| Rundsicherung 5 A, träge
|-
| Max. Sendeleistung
| 10 mW
|-
| IP-Schutzgrad
| IP 20
|-
| Umgebungstemperaturbereich
| 5–35 °C
|}

== Hinweise zur Hardware-Installation ==
Der vorhandene Schalter muss ersetzt werden. Dabei sind ein paar Dinge zu beachten:

* Der (neue) Schalter benötigt neben dem L-Leiter auch einen N-Leiter für die Stromversorgung.
* Die Befestigung ist nicht wie bei dem System z.B. von Merten durch spreizen von Klammern möglich. Der Schalter muss in die Löcher in der Dose geschraubt werden (Schrauben im Lieferumfang enthalten).
* Die "Frontplatte" bzw. der Befestigungsrahmen ist etwas dicker, als der Rahmen eines normalen Schalters. Dadurch kann es sein, dass der vorhandene Rahmen des Schalters nicht mehr ganz an der Wand anliegt.
* Um die bereits vorhandene Schalter-Wippe weiter nutzen zu können, muss ein passender Adapter verwendet werden.

{{Randnotiz|RNText='''Info zum Bausatz'''
Das Gerät ist als Bausatz verfügbar, es sind die folgenden bedrahteten Bauteile einzulöten:
* 6 Kondensatoren
* 3 Stiftleisten/Fassungen (insgesamt 16 Pole)
* 1 Spannungsregler, 1 Diode
* 1 Relais (8 Pole)
* 1 Induktivität
* 1 Widerstand, 1 Varistor
Die zu lötenden Bauteile sind relativ unproblematisch, die Lötstellen befinden sich jedoch in drei Fällen sehr nah an bzw. zwischen vorbestückten SMD-Bauteilen.}}
== Hinweise zum Betrieb mit FHEM ==
Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der [[Konfiguration]]:

<pre>
define LichtWohnzimmer CUL_HM 197764
attr LichtWohnzimmer devInfo 010100
attr LichtWohnzimmer firmware 2.1
attr LichtWohnzimmer hmClass receiver
attr LichtWohnzimmer model unknown
attr LichtWohnzimmer room Wohnzimmer
attr LichtWohnzimmer serialNr JEQ0xxxxxx
attr LichtWohnzimmer subType switch
</pre>

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

<pre>
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den Zustand des Aktors, d.h. ein eingeschalteter Aktor wird ausgeschaltet
</pre>

Zusätzliche Funktionen wie ein direkter Zugriff auf die integrierten Taster (self01 und self02) des Schalters können durch Programmieren der [[HomeMatic_Register_programmieren | HomeMatic Register]] realisiert werden.

Dabei entspricht self01 dem Ausschalter des Wippschalters und self02 dem Einschalter des Wippschalters. Settings, die man also für den self01 Schalter einstellt, werden beim Ausschalten des Lichts (im Standard) angewandt und umgekehrt.

=== Log-Auszug ===
In FHEM ist nach dem Schalten des HM-LC-Sw1PBU-FM folgendes Log zu sehen:
<pre>
2012-06-05_00:09:22 LichtWohnzimmer deviceMsg: off
2012-06-05_00:09:22 LichtWohnzimmer off
2012-06-05_07:40:51 LichtWohnzimmer on
2012-06-05_07:40:51 LichtWohnzimmer deviceMsg: on
</pre>

Beim Einrichten des Schalters kommt folgender Auszug (Stand: 06.2012)
<pre>
2012.06.04 23:12:27 2: CUL_HM pair: CUL_HM_switch_197764 is a switch, model unknown serialNr JEQ0xxxxxx
</pre>

=== Funktion als Treppenlichtschalter ===
Um dafür zu sorgen, dass z.B. ein durch den HM-LC-Sw1PBU-FM eingeschaltetes Licht automatisch von FHEM nach 10 Minuten ausgeschaltet wird, kann folgende Definition verwendet werden:
:<code>define Beleuchtung_an notify Beleuchtung:on* define Beleuchtung_aus at +00:10:00 set Beleuchtung off </code>
Das Licht kann auch direkt über den Schalter nach 10 Minuten ausgeschaltet werden. Dies hat den Vorteil, dass die Funktion auch ohne FHEM funktioniert und keinen Funkverkehr verursacht. Wert ist in Sekunden also 60*10 für 10 Minuten. Es gibt zwei Schaltoperationen long press (lg) und short press (sh), short press ist ein kurzes antippen, long press ist den Schalter für ca. 1 Sekunde oder mehr gedrückt halten.
set <device> regSet shOnTime 600 self01
set <device> regSet lgOnTime 600 self01
set <device> regSet shOnTime 600 self02
set <device> regSet lgOnTime 600 self02

=== Workaround um den Taster in FHEM zu nutzen ===
Man kann den Taster in der Originalfirmware nicht mit anderen Geräten peeren. Allerdings kann man mit folgendem Workaround den Taster in FHEM nutzen. Das hat jedoch eine Verzögerung zwischen drei und acht Sekunden zur Folge. Dabei ist es trotzdem möglich, den Aktor per FHEM oder gepeertem Gerät weiter zu steuern. Der Taster beeinflusst den Aktor nicht mehr. Das ganze funktioniert, weil der HM-LC-Sw1PBU-FM bei jedem Tastendruck das reading für state aktualisiert, auch wenn sich der Wert nicht ändert.

Zuerst setzt man ein event auf event-on-change-reading:

attr HM-LC-Sw1PBU-FM event-on-change-reading state
attr HM-LC-Sw1PBU-FM event-on-update-reading state

Weiterhin wird der Schalter deaktiviert (hier nur für kurzen Tastendruck; mit lgSwJtXXX wird dieser Effekt auch für den langen Tastendruck erzielt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOn on self01
set HM-LC-Sw1PBU-FM regSet prep shSwJtOff off self02
set HM-LC-Sw1PBU-FM regSet exec shSwJtOn on self02

Nun setzt man einen Notify auf das Reading:
:<code>define HM-LC-Sw1PBU-FM-TasterPressed notify HM-LC-Sw1PBU-FM {set YourOtherDevice toggle}</code>

=== Alternative Firmware ===
Um die beiden Taster als Remote und den Aktor getrennt zu nutzen gibt es alternative Firmware, deren Funktion und Benutzung auf der Seite [[HM-LC-Sw1PBU-FM Alternative Firmware]] im Detail beschrieben ist.

=== Schalter immer toggeln lassen ===
Im Werkszustand schaltet die Wippe bei Druck auf der einen Seite ein, auf der anderen Seite aus. Möchte man, dass bei jedem Tastendruck einfach der Zustand geändert wird, kann man das wie folgt erreichen (unten nur für den kurzen Tastendruck dargestellt):
set HM-LC-Sw1PBU-FM regSet intKeyVisib visib
set HM-LC-Sw1PBU-FM getConfig
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self01
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self01
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self01
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self01
set HM-LC-Sw1PBU-FM regSet shActionType jmpToTarget self02
set HM-LC-Sw1PBU-FM regSet shSwJtOn dlyOff self02
set HM-LC-Sw1PBU-FM regSet shSwJtOff dlyOn self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOn on self02
set HM-LC-Sw1PBU-FM regSet shSwJtDlyOff off self02

Um den Werkszustand bezüglich Schaltwippe wiederherzustellen (eine Seite schaltet aus, die andere wieder ein) entsprechen folgende Einstellungen dem Werkszustand:
set <device> regSet shSwJtOn dlyOff self01
set <device> regSet shSwJtOff off self01
set <device> regSet shSwJtDlyOn off self01
set <device> regSet shSwJtDlyOff off self01
set <device> regSet shSwJtOn on self02
set <device> regSet shSwJtOff dlyOn self02
set <device> regSet shSwJtDlyOn on self02
set <device> regSet shSwJtDlyOff on self02

=== on-for-timer Ersatz ===
Der HM-LC-Sw1PBU-FM kennt kein <code>set on-for-timer</code>. Um den HM-LC-Sw1PBU-FM trotzdem für einige Zeit anschalten zu können (z. B. wenn ein Fensteröffner dranhängt und das Fenster nur für eine gewisse Zeit geöffnet werden soll), muss ein Button der vccu mit dem HM-LC-Sw1PBU-FM gepeered werden:
set vccu_Btn4 peerChan 0 HM-LC-Sw1PBU-FM dual set

Danach wären (in diesem Fall mit vccu_Btn4) die virtuellen Buttons 4 und 5 mit dem HM-LC-Sw1PBU-FM gepeered. Das Fenster könnte dann über <code>set vccu_Btn4 press short</code> für die vorher über <code>set HM-LC-Sw1PBU-FM regSet shOnTime [Dauer] vccu_Btn4</code> die Öffnungszeit eingestellt werden kann.

== Mögliche Hardware Defekte ==

Wenn der Schalter zwischendruch immer wieder neu startet, bei lokaler Bedienung sofort wieder ausschaltet und aus FHEM kaum oder nicht ansprechbar und auch auf verknüpfte Sender nicht reagiert, kann ein Kondensator defekt sein, hier C26. (Einen vergleichbarer Defekt tritt auch häufig beim Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, RM 2,5 radial, 10µ/25V (Ersatz mit höherer Spannung unproblematisch). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen neben einer Spule (L21). Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

== Links ==
* Anleitung (PDF {{DocLink|elv|/Assets/Produkte/10/1030/103029/Downloads/103029_FunkSchaltaktor_um.pdf}})
* Produktwebseite bei [http://www.elv.de/output/controller.aspx?cid=74&detail=10&detail2=37991 ELV]
* [[HM-LC-Sw1PBU-FM Alternative_Firmware|Alternative Firmware]]

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

HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter

2017-12-15T20:43:03Z

Pfriemler: Mögliche Hardwaredefekte ergänzt, in Analogie zum Dimmer und Schalter gleicher Bauart.

{{Infobox Hardware
|Bild=HM-LC-Bl1PBU-FM.jpg
|Bildbeschreibung=HM-LC-Bl1PBU-FM montiert, ohne Adapter
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Blind|Blind]]
|HWCategory=[[:Kategorie:Rollladensteuerung|Rollladensteuerung]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=0,5 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
== Features ==

Schalten eines angeschlossenen Jalousiemotors mittels CUL/CUN/HMLAN Konfigurator und über lokalen, in bestehendes Schalterprogramm integrierte Schaltwippe.

'''Technische Daten:'''
* Gerätebezeichnung: HM-LC-Bl1PBU-FM
* Versorgungsspannung: 230 V / 50 Hz
* Maximale Schaltleistung: 230 VA (Motorlast)
* Standby-Verbrauch: 0,5 W
* Schaltvermögen: 1 A (Motorlast)
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5°C bis +35°C
* Abmessungen (B x H x T): 71 x 71 x 37 mm
* Gewicht: 43 g

== Hinweise zur Hardware-Installation ==

Der Schaltaktor ersetzt den Unterputzschalter der bestehenden Elektroinstallation. Arbeiten am 230 V Netz dürfen nur von einer Elektrofachkraft durchgeführt werden! Sicherheitsregeln anwenden:

* Freischalten (Sicherung abschalten),
* gegen Wiedereinschalten sichern,
* Spannungsfreiheit feststellen, (Messgerät vor und '''nach''' Messung auf Funktion überprüfen)
* Erden und Kurzschließen,
* benachbarte, unter Spannung stehende Teile abdecken.

Zur Integration in ein bestehendes Schalterprogramm bitte den entsprechenden Adapter mit bestellen.

<gallery>
Datei:HM-LC-BL1PBU schritt 01.jpg|Ausgangssituation
Datei:HM-LC-BL1PBU schritt 02.jpg|Schalter abbauen, Rahmen entfernen, Unterputzschalter lösen
Datei:HM-LC-BL1PBU schritt 03.jpg|Bestehender Anschluss
Datei:HM-LC-BL1PBU schritt 04.jpg|Neuer Anschluss. Achtung: zusätzlicher Nullleiteranschluss!
Datei:HM-LC-BL1PBU schritt 05.jpg|Einbau ohne Adapter
Datei:HM-LC-BL1PBU schritt 06.jpg|Adapter aufsetzen
Datei:HM-LC-BL1PBU schritt 07.jpg|Fertig eingebauter HM-LC-BL1PBU-FM
</gallery>

== Hinweise zum Betrieb mit FHEM ==

Der Schalter wird seit FHEM 5.3 unterstützt. Das [[Pairing (HomeMatic)|Pairing]] sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Dazu wird der Config-Taster kurz gedrückt.
Zur Darstellung im Webfrontend siehe [[Slider für HM-Rolladensteuerung anzeigen]].

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

define WZ_Rollo_Links CUL_HM ABCDEF
attr WZ_Rollo_Links devInfo 010100
attr WZ_Rollo_Links eventMap on:hoch off:runter stop:stop
attr WZ_Rollo_Links firmware 2.1
attr WZ_Rollo_Links hmClass receiver
attr WZ_Rollo_Links model HM-LC-Bl1PBU-FM
attr WZ_Rollo_Links room Wohnzimmer
attr WZ_Rollo_Links serialNr JEQxxxxxxx
attr WZ_Rollo_Links subType blindActuator
attr WZ_Rollo_Links webCmd pct

=== Variablen===
==== Attribute====
Dem Device können neben den Allgemeinen auch spezielle Attribute gesetzt werden.
* '''param levelInverse''': HM Blind Aktoren stehen auf 100% wenn sie offen sind und auf 0% wenn sie geschlossen sind. Das ist oftmals nicht intuitiv. In FHEM kann man dies "drehen" durch dieses Attribut. Damit dreht sich auch die Bedeutung von On und Off.

Desweiteren empfehlen sich die üblichen Homematic Attribute (wie autoReadReg, event-on-change-reading, expert) zu setzten. Weitere Informationen dazu unter [[HomeMatic#Attribute]]

==== Readings====
*'''level''' numerischer Wert der den Stand des Rollo wiedergibt. Achtung: Der Aktor kennt nicht den Stand des Rollos sondern errechnet diesen aus den Fahrzeiten. Nach einem powerUp wird ein Stand von 50% angenommen.
*'''motor''': zeigt den Zustand des Motors an, ob er steht oder in welche Richtung er fährt
*'''pct''': analog "level"

== Konfiguration==
Die Konfiguration des Devices betrifft Register und Peerings. Dies sind Werte, die zwar über FHEM gesetzt werden, aber im Device im Flash gespeichert werden.
Man kann die Devices mit Sensoren und Tastern [[Peering (HomeMatic)|peeren]]

===Fahrzeiten kalibrieren===
Um die Jalousie mit Prozentangaben auf eine bestimmte Position fahren zu lassen, muss der Aktor die Fahrtzeiten kennen um daraus die relativen Positionen erechnen zu können. Dazu müssen 3 Werte manuell mit einer Stoppuhr gemessen werden.

* Fahrtzeit nach oben
* Fahrtzeit nach unten (ist meistens identisch mit der Fahrzeit nach oben bei herkömlichen Jalousiemotoren)
* Wechsel der Fahrtrichtung

Diese 3 Zeiten werden in Sekunden gemessen und anschließend einmalig mit den folgenden Befehlen eingestellt:
set <name> regSet driveUp 27.0 # Fahrtzeit nach oben in Sekunden
set <name> regSet driveDown 27.0 # Fahrtzeit nach unten in Sekunden
set <name> regSet driveTurn 0.5 # Die Zeit die gebraucht wird um die Fahrtrichtung zu wechseln in Sekunden

=== Tasterverhalten ===
Um den fahrenden Rollladen bei jedem Tastendruck anzuhalten und nicht nur bei Druck auf die entgegengesetzte Richtung:

* Die internen Taster sichtbar schalten und die config abfragen
set <device> regSet intKeyVisib visib
set <device> getConfig

* Die Taster konfigurieren (alte Variante via Register)
set <device> regBulk RegL_03:self01 0B:94 0D:63 8B:94
set <device> regBulk RegL_03:self02 0B:18 0D:63 8B:18

* Die Taster konfigurieren (neue Variante via Template, dazu muss ein [[HomeMatic_HMInfo]] Device anglegt sein)
set <HMinfo> templateSet <device> BlStopUpSh self02:short
set <HMinfo> templateSet <device> BlStopDnSh self01:short
set <device> getConfig

* Die internen Taster unsichtbar schalten und die config überprüfen
set <device> regSet intKeyVisib invisib
set <device> getConfig

Wichtig: bei der alten Variante nach jedem Schritt jeweils die Anlern-Taste drücken und in den Internals schauen ob die kommandos ohne Fehler abgearbeitet wurden.

== Mögliche Schaltoperationen ==

Der Aktor versteht folgende Befehle:
set <name> on -> Schaltet den Aktor ein
set <name> off -> Schaltet den Aktor aus
set <name> toggle -> Ändert den logischen Zustand des Aktors.
set <name> <Prozentangabe[0 bis 100]> -> Öffnet die Jalousie auf absolut prozentuale Öffnungsposition, berechnet aus definierter Laufzeit.
set <name> up/down <Prozentangabe[0 bis 100]> -> Öffnet oder schließt die Jalousie um den prozentualen Wert, berechnet aus definierter Laufzeit. Keine Angabe => 10%

== Log-Auszug ==
In FHEM ist nach dem Schalten des HM-LC-BL1-FM folgendes Log zu sehen:
2013.02.26 07:00:12 2: CUL_HM set WZ_Rollo_Rechts on rxt:1

== Mögliche Hardwaredefekte ==

Wenn der Rolladenaktor nur noch lokal reagiert oder den Rolladen nur für ein kurzes Stück fährt und aus FHEM nur mit fortgesetzten Schwierigkeiten zu erreichen ist, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C26. (Einen vergleichbarer Defekt tritt auch häufig beim Schaltaktor [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] und dem Dimmer [[HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP|HM-LC-Dim1TPBU-FM]] auf.)

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, RM 2,5 radial, 10µ/25V (Ersatz mit höherer Spannung unproblematisch). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L21) und der Diode D20. Die Platine hat Bestückungsdruck, C26 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

== Links ==
* [http://www.elv-downloads.de/Assets/Produkte/10/1030/103038/Downloads/103038_FunkRollladenaktor_um.pdf Bedienungsanleitung (PDF)]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Rollladensteuerung]]

HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP

2017-12-15T20:32:40Z

Pfriemler: /* Mögliche Hardware Defekte */

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=[[HomeMatic Type Dimmer|Dimmer]]
|HWCategory=[[:Kategorie:Dimmer|Dimmer]]
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=230 V
|HWPowerConsumption=1 W (Stand-by)
|HWPoweredBy=Netz
|HWSize=71x71x37 mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
Der '''HM-LC-Dim1TPBU-FM 1-Kanal-Dimmer UP''' ist ein Phasenabschnitts-Dimmer für die Unterputzmontage. Er verfügt über eine Schalterwippe, die sich mit einem Adapter in einige Schalterprogramme verschiedener Hersteller integrieren lässt. Der Dimmer kann sowohl vor Ort über die Schalterwippe als auch per Funk gesteuert werden.

== Features ==

Schaltdoseneinsatz als Ersatz für vorhandenen Dimmer-Einsatz (erfordert keine tiefere Schaltdose). Kann mittels Adapter in bestehende Schalterserien wie Busch Jäger, Gira usw. integriert werden.

=== Technische Daten ===

* Versorgungsspannung: 230 V / 50 Hz
* Minimallast: 10 VA
* Minimalstrom: 40 mA
* Maximale Schaltleistung: 180 VA
* Standby-Verbrauch: 1 W
* Dimmverfahren: Phasenabschnitt
* Funkfrequenz: 868,3 MHz
* Empfängerklasse: SRD Class 2
* Maximale Sendeleistung: 10 mW
* Schutzart: IP20
* Schutzklasse: II
* Umgebungstemperatur: +5 °C bis +35 °C
* Abmessungen (BxHxT): 71x71x37 mm
* Gewicht: 43 g

=== Schalter ===

Der HM-LC-Dim1TPBU-FM besitzt zwei Schalter, die über eine Wippe angewählt werden können. Das Standard-Verhalten entspricht im Prinzip dem [[HM-LC-Bl1PBU-FM Unterputz-Jalousieaktor]]:

* Ein kurzer Druck nach oben Schaltet den Verbraucher ein (100 % Leistung).
* Ein kurzer Durck nach unten Schaltet den Verbraucher aus (0 % Leistung).
* Ein langer Druck nach oben erhöht die Leistung bis der Schalter losgelassen wird.
* Ein langer Druck nach unten verringert die Leistung bis der Schalter losgelassen wird.

== Hinweise zur Hardware-Installation ==

Der HM-LC-Dim1TPBU-FM verfügt über vier Anschlussklemmen: Phase, gedimmte Phase und zwei kurzgeschlossene Klemmen für den Neutralleiter. Das heißt, dass der Neutralleiter "durchgeschleift" werden kann.

Der HM-LC-Dim1TPBU-FM füllt die Schalterdose links und rechts nahezu aus. Wenn möglich ist eine Zuführung der Leitungen von oben oder unten zu bevorzugen.

== Kompatible Leuchtmittel ==

In der Detailansicht vieler LED-Lampen auf der Webseite von ELV.de lässt sich eine Dimmer-Kompatibilitätsliste für das jeweilige Modell herunterladen.

== Mögliche Hardwaredefekte ==

Wenn der Dimmer zwischendruch immer wieder neu startet, beim Hochdimmen oder kurz danach spontan abschaltet, sich nur noch lokal, aber nicht mehr per Fernbedienung steuern lässt, dann kann ein Kondensator defekt sein, der nach dem internen Schaltnetzteil für eine erste Glättung verantwortlich ist, hier C7. (Einen vergleichbarer Defekt tritt auch häufig beim Schaltaktor [[HM-LC-Sw1PBU-FM_Unterputz-Schaltaktor_1-fach|HM-LC-Sw1PBU-FM]] oder dem Rolladenaktor [[HM-LC-Bl1PBU-FM Funk-Rollladenaktor für Markenschalter|HM-LC-Bl1PBU-FM]] auf).

Es handelt sich um einen kleinen Elektrolytkondensator herkömmlicher Bauart, RM 2,5 radial, 10µ/25V (Ersatz mit höherer Spannung unproblematisch). Er sitzt auf der Leistungsplatine gegenüber den Anschlussklemmen an einer Ecke neben einer Spule (L2) und dem dreipoligen IC2 (Linearregler). Die Platine hat Bestückungsdruck, C7 ist also problemlos zu identifizieren. Die Schwierigkeit des Austausches liegt auf dem üblichen Bausatzniveau.

Siehe auch die Diskussion im Forum: --> https://forum.fhem.de/index.php/topic,55149.msg346499/topicseen.html

== Links ==

* Anleitung: http://files.elv.de/Assets/Produkte/10/1030/103020/Downloads/103020_FunkDimmaktor_um.pdf

[[Kategorie:HomeMatic Components]]
[[Kategorie:Dimmer]]