Alexa und Mappings - Versionsgeschichte

Justme: /* Liste der unterstützten Characteristics und ihrer Parameter */

2021-02-16T08:09:46Z

Liste der unterstützten Characteristics und ihrer Parameter

← Nächstältere Version		Version vom 16. Februar 2021, 10:09 Uhr
Zeile 80:		Zeile 80:
	==Liste der unterstützten ''Characteristics'' und ihrer Parameter==		==Liste der unterstützten ''Characteristics'' und ihrer Parameter==
	Viele Namen für die ''Aspekte'' und ''Characteristics'' eines Gerätes entstammen dem Apple Homekit API.		Viele Namen für die ''Aspekte'' und ''Characteristics'' eines Gerätes entstammen dem Apple Homekit API.
	Welche Services mit welchen Characteristics es dort gibt ist hier zu finden: https://github.com/~~KhaosT~~/HAP-NodeJS/blob/master/lib/gen/~~HomeKitTypes~~.js		Welche Services mit welchen Characteristics es dort gibt ist hier zu finden: https://github.com/homebridge/HAP-NodeJS/blob/master/src/lib/gen/HomeKit.ts

	===''Characteristics''===		===''Characteristics''===

Pahenning: /* Beispiele */

2018-04-16T13:47:43Z

Beispiele

← Nächstältere Version		Version vom 16. April 2018, 15:47 Uhr
Zeile 178:		Zeile 178:

	Im nächsten Schritt werden die Readings gemappt:		Im nächsten Schritt werden die Readings gemappt:
	attr <meinSensor> homebridgeMapping clear CurrentRelativeHumidity=humidity CurrentTemperature=temperature		attr <meinSensor> homebridgeMapping clear CurrentRelativeHumidity=humidity CurrentTemperature=temperature

			=== Rolladen ===
			Ein Rolladen ist in Alexa-Fhem nicht auf oder zu, oben oder unten - sondern durch einen Positionswert 0 - 100 (Prozent) gekennzeichnet. Dabei kann je nach physikalischem Device 100% "offen" bedeuten oder "zu" (invertierte Datenwerte). Dem entsprechend muss er auch durch einen solchen Positionswert setbar sein, und zwar muss das zugeordnete Reading entweder ''position'' oder ''pct'' (Abk. für Prozent) heißen. Man kann auch einen entsprechenden Dummy verwenden, etwa
			define Alexa.Blind dummy
			attr Alexa.Blind alexaName rollladen
			attr Alexa.Blind alexaRoom alexaroom
			attr Alexa.Blind genericDeviceType blind
			attr Alexa.Blind readingList position
			attr Alexa.Blind setList position
			attr Alexa.Blind stateFormat position
			Durch die Auswahl des genericDeviceType=blind werden die beiden Characteristics CurrentPosition und TargetPosition voreingestellt.
			Bei den alexaMappings im Alexa-Device muss für die Characteristic TargetPosition vorhanden sein:
			TargetPosition=verb=mach:mache,articles=den,values=auf:100;zu:0
			TargetPosition=verb=stell:stelle,valuePrefix=auf,values=AMAZON.NUMBER,valueSuffix=prozent
			==== SmartHome Skill ====
			Dieses Mapping wird nun bereits durch den SmartHome Skill von Alexa erkannt.
			Konkret sind folgende Alexa-Befehle ausführbar
			* "Stell(e) den Rollladen auf xx Prozent" => position wird auf xx gesetzt
			* "Mach(e) den Rollladen hoch/runter" => position wird um 25% erhöht / erniedrigt.
			==== Custom Skill ====
			'''Achtung: In Bearbeitung'''
			* stell {article} {Device} {preposition} {Room} auf {pct} prozent
			* mach {article} {Device} {preposition} {Room} {TargetPosition_Value}

Pahenning: /* genericDeviceType */

2018-04-16T13:04:35Z

genericDeviceType

← Nächstältere Version		Version vom 16. April 2018, 15:04 Uhr
Zeile 30:		Zeile 30:
	\| light		\| light
	\|-		\|-
	\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\| ~~<ul><li>~~Wenn das Device einen set-Befehl ''position'' hat, wird gemappt<br/> CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position'' ~~<ul><li>~~ Wenn TYPE=''DUOFERN'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert. ~~</li><li>~~ Wenn TYPE=''SOMFY'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert, und das Kommando zum Setzen wird auf cmd=''pos'' geändert. ~~</li></ul></li><li>~~Ansonsten wird gemappt <br/> CurrentPosition => reading=''pct'', TargetPosition => reading=''pct'', cmd=''pct''~~<ul><li>~~Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte für CurrentPosition und TargetPosition invertiert.~~</li></ul></li></ul>~~		\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\|
			* Wenn das Device einen set-Befehl ''position'' hat, wird gemappt<br/> CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position''
			** Wenn TYPE=''DUOFERN'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert.
			** Wenn TYPE=''SOMFY'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert, und das Kommando zum Setzen wird auf cmd=''pos'' geändert.
			* Ansonsten wird gemappt <br/> CurrentPosition => reading=''pct'', TargetPosition => reading=''pct'', cmd=''pct''
			** Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte für CurrentPosition und TargetPosition invertiert.
	\|-		\|-
	\| thermometer		\| thermometer

Pahenning: /* Characteristics */

2018-04-16T13:03:17Z

Characteristics

← Nächstältere Version		Version vom 16. April 2018, 15:03 Uhr
Zeile 98:		Zeile 98:
	\| TargetTemperature		\| TargetTemperature
	\|-		\|-
	\| CurrentPosition \|\| Integer \|\|		\| CurrentPosition \|\| Integer \|\| position oder pct \|\|
	* Wenn das Device einen set-Befehl position hat: CurrentPosition => reading=position		* Wenn das Device einen set-Befehl position hat: CurrentPosition => reading=position
	** Wenn TYPE=DUOFERN, werden die Datenwerte invertiert.		** Wenn TYPE=DUOFERN, werden die Datenwerte invertiert.
Zeile 105:		Zeile 105:
	** Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte invertiert.		** Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte invertiert.
	\|-		\|-
	\| TargetPosition \|\| Integer \|\|		\| TargetPosition \|\| Integer \|\| position oder pct \|\|
	* Wenn das Device einen set-Befehl position hat: TargetPosition => reading=position, cmd=position		* Wenn das Device einen set-Befehl position hat: TargetPosition => reading=position, cmd=position
	** Wenn TYPE=DUOFERN, werden die Datenwerte invertiert.		** Wenn TYPE=DUOFERN, werden die Datenwerte invertiert.

Pahenning: /* Characteristics */

2018-04-16T13:02:24Z

Characteristics

@@ Zeile 97: / Zeile 97: @@
 |-
 | TargetTemperature
 |-
 | CurrentRelativeHumidity

Pahenning: /* genericDeviceType */

2018-04-16T12:25:15Z

genericDeviceType

← Nächstältere Version		Version vom 16. April 2018, 14:25 Uhr
Zeile 44:		Zeile 44:
	\| lock \|\| lock \|\| LockCurrentState/LockTargetState		\| lock \|\| lock \|\| LockCurrentState/LockTargetState
	\|}		\|}
	Andere Werte können über das Befehlsfeld zugewiesen werden, hiervon wird aber abgeraten, weil diese ggf. in Alexa-Fhem nicht ausgewertet werden.~~<br/>~~		Andere Werte des Attributes können über das Befehlsfeld zugewiesen werden, hiervon wird aber abgeraten, weil diese ggf. in Alexa-Fhem nicht ausgewertet werden.
	~~<code>attr meinSensor genericDeviceType <meinDeviceType></code>~~

	===homebridgeMapping===		===homebridgeMapping===

Pahenning: /* genericDeviceType */

2018-04-16T12:24:49Z

genericDeviceType

← Nächstältere Version		Version vom 16. April 2018, 14:24 Uhr
Zeile 44:		Zeile 44:
	\| lock \|\| lock \|\| LockCurrentState/LockTargetState		\| lock \|\| lock \|\| LockCurrentState/LockTargetState
	\|}		\|}
	Andere Werte können über das Befehlsfeld zugewiesen werden, hiervon wird aber abgeraten, weil diese ggf. in Alexa-Fhem nicht ausgewertet werden.		Andere Werte können über das Befehlsfeld zugewiesen werden, hiervon wird aber abgeraten, weil diese ggf. in Alexa-Fhem nicht ausgewertet werden.<br/>
	<code>attr meinSensor genericDeviceType <meinDeviceType></code>		<code>attr meinSensor genericDeviceType <meinDeviceType></code>

Pahenning: /* genericDeviceType */

2018-04-16T12:17:42Z

genericDeviceType

← Nächstältere Version		Version vom 16. April 2018, 14:17 Uhr
Zeile 30:		Zeile 30:
	\| light		\| light
	\|-		\|-
	\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\| <ul><li>Wenn das Device einen set-Befehl ''position'' hat, wird gemappt CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position'' <ul><li> Wenn TYPE=''DUOFERN'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert. </li><li> Wenn TYPE=''SOMFY'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert, und das Kommando zum Setzen wird auf cmd=''pos'' geändert. </li></ul></li><li>Ansonsten wird gemappt CurrentPosition => reading=''pct'', TargetPosition => reading=''pct'', cmd=''pct''<ul><li>Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte für CurrentPosition und TargetPosition invertiert.</li></ul></li></ul>		\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\| <ul><li>Wenn das Device einen set-Befehl ''position'' hat, wird gemappt<br/> CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position'' <ul><li> Wenn TYPE=''DUOFERN'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert. </li><li> Wenn TYPE=''SOMFY'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert, und das Kommando zum Setzen wird auf cmd=''pos'' geändert. </li></ul></li><li>Ansonsten wird gemappt <br/> CurrentPosition => reading=''pct'', TargetPosition => reading=''pct'', cmd=''pct''<ul><li>Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte für CurrentPosition und TargetPosition invertiert.</li></ul></li></ul>
	\|-		\|-
	\| thermometer		\| thermometer

Pahenning: /* genericDeviceType */

2018-04-16T12:16:43Z

genericDeviceType

← Nächstältere Version		Version vom 16. April 2018, 14:16 Uhr
Zeile 30:		Zeile 30:
	\| light		\| light
	\|-		\|-
	\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\| * Wenn das Device einen set-Befehl ''position'' hat, wird gemappt CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position'' Wenn TYPE=''DUOFERN'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert. Wenn TYPE=''SOMFY'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert, und das Kommando zum Setzen wird auf cmd=''pos'' geändert. * Ansonsten wird gemappt CurrentPosition => reading=''pct'', TargetPosition => reading=''pct'', cmd=''pct'' ** Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte für CurrentPosition und TargetPosition invertiert.		\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\| <ul><li>Wenn das Device einen set-Befehl ''position'' hat, wird gemappt CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position'' <ul><li> Wenn TYPE=''DUOFERN'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert. </li><li> Wenn TYPE=''SOMFY'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert, und das Kommando zum Setzen wird auf cmd=''pos'' geändert. </li></ul></li><li>Ansonsten wird gemappt CurrentPosition => reading=''pct'', TargetPosition => reading=''pct'', cmd=''pct''<ul><li>Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte für CurrentPosition und TargetPosition invertiert.</li></ul></li></ul>
	\|-		\|-
	\| thermometer		\| thermometer

Pahenning: /* genericDeviceType */

2018-04-16T12:14:57Z

genericDeviceType

← Nächstältere Version		Version vom 16. April 2018, 14:14 Uhr
Zeile 30:		Zeile 30:
	\| light		\| light
	\|-		\|-
	\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\| *Wenn das Device einen set-Befehl ''position'' hat, wird gemappt CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position''		\| blind \|\| blind \|\| CurrentPosition/TargetPosition \|\| * Wenn das Device einen set-Befehl ''position'' hat, wird gemappt CurrentPosition => reading=''position'', TargetPosition => reading=''position'', cmd=''position'' Wenn TYPE=''DUOFERN'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert. Wenn TYPE=''SOMFY'', werden die Datenwerte für CurrentPosition und TargetPosition invertiert, und das Kommando zum Setzen wird auf cmd=''pos'' geändert. * Ansonsten wird gemappt CurrentPosition => reading=''pct'', TargetPosition => reading=''pct'', cmd=''pct'' ** Wenn ein Attribut levelInverse gesetzt ist, werden die Datenwerte für CurrentPosition und TargetPosition invertiert.
	\|-		\|-
	\| thermometer		\| thermometer