Quelltext der Seite Alexa und Mappings

Auf dieser Seite soll das Zusammenwirken zwischen Sensoren/Aktoren in FHEM, dem Programm Alexa-Fhem und den Amazon Web Services erläutern.

== Attribute der Sensoren/Aktoren ==
Die Sensoren/Aktoren werden über zwei Attribute mit der Sprachsteuerung verbunden.

===genericDeviceType===
Dieses Attribut kennt standardmäßig nur wenige Werte, die per Drop-Down-Liste ausgewählt werden können. Andere Werte müssen über das Befehlsfeld zugewiesen werden:
<code>attr meinSensor genericDeviceType <meinDeviceType></code>

===homebridgeMapping===
Dieses Attribut beinhaltet eine durch Leerzeichen getrennte Liste von Datenpaaren
 attr meinSensor homebridgeMapping clear <Characteristic1>=<reading1>[,values=<regex11>:<value11>[,<regex12>:<value12>]*]  [<Characteristic2>=<reading2>[,values=<regex21>:<value21>[,<regex22>:<value22>]*]*
*Das erste Schlüsselwort hat eine besondere Bedeutung: <code>clear</code>löscht Standardmappings - das wird in der Regel nicht notwendig sein, schadet aber nicht
*Der Begriff ''Characteristic'' ist der Homekit-Software entlehnt, er bezeichnet einen durch die Sprachsteuerung abfragbarne oder setzbaren Aspekt des Sensors/Aktors. <code><Characteristic1>=<reading1></code> verbindet diesen logischen Kanal (linke Seite) mit einem ''reading'' des Sensors/Aktors (rechte Seite).
*Die durch Semikolon getrennte Liste der möglichen Werte stellt eine Verbindung zwischen den möglichen Werten des FHEM-Readings (linke Seite, gematcht durch einen Regulären Ausdruck) und den von der ''Characteristic'' erwarteten Werten (rechte Seite) her. '''Achtung''': Auch wegen der Vertauschung der Seitenbezüge links-rechts ist das eine sehr gewöhnungsbedürftige und nicht konistente Notation.

==Attribute des Alexa-Devices==
===alexaMapping===
In diesem Attribut finden wir die abstrakten ''Charakteristics'' wieder - und zwar in der allgemeinen Form
 Characteristic1=<name11>=<value111>[;<value112>]*[,<name12>=<value121>[;<value122>]*]*
*<code><name1x></code> ist der Name eines Parameters, z.B. ''verb''
*Es folgt eine durch Semikolon getrennte Liste von möglichen Werten. Für ''verb'' könnte diese z.B. sein <code>verb=stelle;setze</code>
*Weitere Parameter/Wert-Listen werden durch ein Komma getrennt angehängt.
Jede ''Characteristic'' kann mehrfach auftauchen - nämlich für jede Aussprachemöglichkeit dieser ''Characteristic''. Beispiele:
 On=verb=schalte,valueOn=an;ein,valueOff=aus,valueToggle=um
 Hue=verb=stelle,valuePrefix=auf,values=rot:0;grün:128;blau:200
 Hue=verb=färbe,values=rot:0;grün:120;blau:220

==Beispiele==

=== Temperatur- und Feuchtesensor ===
Kombinierte Temperatur-Feuchtesensoren haben in der Regel Readings "humidity" und "temperature". Homekit unterstützt einen "HumiditySensor" Service. Dieser ist in homebridge-fhem nicht standardmäßig vorhanden (kann also nicht aus dem dropdown ausgewählt werden, sondern muss über das Befehlsfeld zugewiesen werden):
<code>attr meinSensor genericDeviceType HumiditySensor</code>

Im nächsten Schritt werden die Readings gemappt:

<code>attr meinSensor homebridgeMapping clear CurrentRelativeHumidity=humidity CurrentTemperature=temperature</code> 




















[[Kategorie:Sprachsteuerung]]