Talk2Fhem - Versionsgeschichte

Drhirn: Anker-Links auf Abschnitte innerhalb dieser Seite geändert

2019-11-27T10:30:53Z

Anker-Links auf Abschnitte innerhalb dieser Seite geändert

← Nächstältere Version		Version vom 27. November 2019, 12:30 Uhr
Zeile 14:		Zeile 14:
	Es ist sehr zu empfehlen, für die Konfiguration des Moduls, im Webfrontend von FHEM die Syntaxhervorhebung zu aktivieren. Die Aktivierung des erweiterten Editors ist [[Konfiguration#Syntaxhervorhebung\|hier]] beschrieben.		Es ist sehr zu empfehlen, für die Konfiguration des Moduls, im Webfrontend von FHEM die Syntaxhervorhebung zu aktivieren. Die Aktivierung des erweiterten Editors ist [[Konfiguration#Syntaxhervorhebung\|hier]] beschrieben.

	Kenntnisse im Bereich Regulärer Ausdrücke (RegExp) in Perl sind hilfreich, aber nicht zwingend erforderlich. Ein kurzer Einstieg kann hier eingesehen werden. [[~~Modul_Talk2Fhem~~#Häufig_verwendete_RegExp\|Häufig_verwendete_RegExp]]		Kenntnisse im Bereich Regulärer Ausdrücke (RegExp) in Perl sind hilfreich, aber nicht zwingend erforderlich. Ein kurzer Einstieg kann hier eingesehen werden. [[Talk2Fhem#Häufig_verwendete_RegExp\|Häufig_verwendete_RegExp]]

	== Allgemeines ==		== Allgemeines ==
	Das Modul Talk2Fhem stellt eine Verbindung zwischen natürlicher Sprache und FHEM Befehlen her. Es ist ein überaus flexibles und relativ einfach zu konfigurierendes Script mit dem man sehr natürlich kommunizieren kann. Die Konfiguration erfolgt dabei über das FHEM Webfrontend.		Das Modul Talk2Fhem stellt eine Verbindung zwischen natürlicher Sprache und FHEM Befehlen her. Es ist ein überaus flexibles und relativ einfach zu konfigurierendes Script mit dem man sehr natürlich kommunizieren kann. Die Konfiguration erfolgt dabei über das FHEM Webfrontend.

	Es werden diverse [[~~Modul_Talk2Fhem~~#Zeitenerkennung\|Zeit- und Datumsangaben]] erkannt. Außerdem ist es möglich [[~~Modul_Talk2Fhem~~#Eventenerkennung\|Ereignisse zu formulieren]], welche die Befehle mit einer Bedingung verknüpfen. Bei der weiteren Verarbeitung der Sprachbefehle wird die Sprache mit definierten regulären Ausdrücken verglichen.		Es werden diverse [[#Zeitenerkennung\|Zeit- und Datumsangaben]] erkannt. Außerdem ist es möglich [[#Eventenerkennung\|Ereignisse zu formulieren]], welche die Befehle mit einer Bedingung verknüpfen. Bei der weiteren Verarbeitung der Sprachbefehle wird die Sprache mit definierten regulären Ausdrücken verglichen.

	Es lassen sich Antworten generieren, die Abhängig von den gesendeten Sprachbefehlen sind. Das vom Author verfolgte Konzept ist aber: ''Erzeuge eine Meldung wenn etwas nicht verstanden oder fehlgeschlagen ist, ansonsten führe den Befehl mit einer kurzen Erfolgsmeldung wie "OK" oder "Gerne" aus.''		Es lassen sich Antworten generieren, die Abhängig von den gesendeten Sprachbefehlen sind. Das vom Author verfolgte Konzept ist aber: ''Erzeuge eine Meldung wenn etwas nicht verstanden oder fehlgeschlagen ist, ansonsten führe den Befehl mit einer kurzen Erfolgsmeldung wie "OK" oder "Gerne" aus.''

	Die Text Ein- sowie Ausgabe der natürlichen Sprache übernehmen andere Anwendungen. Hierzu gibt es eine Reihe von Möglichkeiten die unter [[~~Modul_Talk2Fhem~~#Anwendung\|Anwendung]] dargestellt sind. Funktionierende Lösungsansätze werden hier gerne mit aufgenommen.		Die Text Ein- sowie Ausgabe der natürlichen Sprache übernehmen andere Anwendungen. Hierzu gibt es eine Reihe von Möglichkeiten die unter [[#Anwendung\|Anwendung]] dargestellt sind. Funktionierende Lösungsansätze werden hier gerne mit aufgenommen.

	=== Funktionsweise ===		=== Funktionsweise ===
Zeile 230:		Zeile 230:

	=== Objektverundung ===		=== Objektverundung ===
	Es ist möglich Objekte in einer Auflistung in den Sätzen zu übergeben. Siehe hierzu [[~~Modul_Talk2Fhem~~#T2F_keywordlist\|T2F_keywordlist]].		Es ist möglich Objekte in einer Auflistung in den Sätzen zu übergeben. Siehe hierzu [[#T2F_keywordlist\|T2F_keywordlist]].
	Rollos im Wohnzimmer, Esszimmer und in der Küche auf 70		Rollos im Wohnzimmer, Esszimmer und in der Küche auf 70
	Schalte den Fernseher und die Soundanlage an		Schalte den Fernseher und die Soundanlage an
Zeile 251:		Zeile 251:
	Mach die garage zu '''wenn es draußen dunkel wird'''		Mach die garage zu '''wenn es draußen dunkel wird'''
	'''Wenn ich nach hause komme''' mach die Musik an		'''Wenn ich nach hause komme''' mach die Musik an
	siehe hierzu [[~~Modul_Talk2Fhem~~#T2F_if]]		siehe hierzu [[#T2F_if]]

	== Konfiguration ==		== Konfiguration ==
Zeile 265:		Zeile 265:
	=== RegExp-Teil ===		=== RegExp-Teil ===

	<RegExpPart> [[[~~Modul_Talk2Fhem~~#Mehrere_RegExps\|&&]] [[~~Modul_Talk2Fhem~~#RegExp_Optionen\|[?!]]]<RegExpPart_n>] =		<RegExpPart> [[[#Mehrere_RegExps\|&&]] [[#RegExp_Optionen\|[?!]]]<RegExpPart_n>] =

	Eine Konfiguration beginnt immer mit der Definition der gesuchten Schlüsselwörter, gefolgt von einem Gleichheitszeichen ''(siehe Randnotiz)''. Diese werden Anhand von regulären Ausdrücken (RegExp) beschrieben. Also z.B.:		Eine Konfiguration beginnt immer mit der Definition der gesuchten Schlüsselwörter, gefolgt von einem Gleichheitszeichen ''(siehe Randnotiz)''. Diese werden Anhand von regulären Ausdrücken (RegExp) beschrieben. Also z.B.:
Zeile 276:		Zeile 276:
	* FHEM Kommando		* FHEM Kommando
	* { Perl Befehl }		* { Perl Befehl }
	* ( [[~~Modul_Talk2Fhem~~#erweiterte_Befehlskonfiguration]] )		* ( [[#erweiterte_Befehlskonfiguration]] )
	Im ganzen könnten die Konfigurationen folgendermaßen aussehen:		Im ganzen könnten die Konfigurationen folgendermaßen aussehen:
	garage\S* auf = set dev_garage open		garage\S* auf = set dev_garage open
Zeile 540:		Zeile 540:
	In Talk2Fhem können Antworten, die das Modul ausgeben soll, definiert werden. Hier können Fragen verarbeitet werden oder auch der Erfolg eines Kommandos bestätigt werden. Die Antworten werden immer direkt ausgegeben ohne zeitlichen oder ereignisbehafteten Bezug.		In Talk2Fhem können Antworten, die das Modul ausgeben soll, definiert werden. Hier können Fragen verarbeitet werden oder auch der Erfolg eines Kommandos bestätigt werden. Die Antworten werden immer direkt ausgegeben ohne zeitlichen oder ereignisbehafteten Bezug.

	Über die [[~~Modul_Talk2Fhem~~#erweiterte_Befehlskonfiguration]], erhält der Parameter "answer" einen Perl Befehl. Die Rückgabe muss ein Text sein, der als Antwort dient.		Über die [[#erweiterte_Befehlskonfiguration]], erhält der Parameter "answer" einen Perl Befehl. Die Rückgabe muss ein Text sein, der als Antwort dient.

	==== Beispiel Erfolgsmeldung ====		==== Beispiel Erfolgsmeldung ====
Zeile 558:		Zeile 558:
	' "Die Temperatur beträgt ".ReadingsVal("tempdev", "temperature", "Fehler") '		' "Die Temperatur beträgt ".ReadingsVal("tempdev", "temperature", "Fehler") '
	)</syntaxhighlight>		)</syntaxhighlight>
	Für eine Raumbezogene Temperaturabfrage, siehe [[~~Modul_Talk2Fhem~~#Raumbezogene_Temperaturansage]]		Für eine Raumbezogene Temperaturabfrage, siehe [[#Raumbezogene_Temperaturansage]]

	=== Personalifizierung ===		=== Personalifizierung ===
Zeile 574:		Zeile 574:
	Jetzt wird dem Textbefehl immer der Name (msgPeer) und anschließendem "=" dem Befehl hinzugefügt und an talk gesendet. Dieser Text kann mit T2F_origin verarbeitet werden.		Jetzt wird dem Textbefehl immer der Name (msgPeer) und anschließendem "=" dem Befehl hinzugefügt und an talk gesendet. Dieser Text kann mit T2F_origin verarbeitet werden.

	siehe hierzu [[~~Modul_Talk2Fhem~~#T2F_origin]]		siehe hierzu [[#T2F_origin]]

	== Attribute ==		== Attribute ==
Zeile 669:		Zeile 669:
	flur\|gang\|diele,garage,garten,terrasse,balkon,		flur\|gang\|diele,garage,garten,terrasse,balkon,
	'eg\|erdgescho\S','og\|obergescho\S','\S*außen\|außer haus\|vor der tür'		'eg\|erdgescho\S','og\|obergescho\S','\S*außen\|außer haus\|vor der tür'
	Das '&' vor rooms ist eine Besonderheit der Objektverundung, und sollte nur bei ausgewählten Listen verwendet werden. Siehe [[~~Modul_Talk2Fhem~~#T2F_keywordlist\|T2F_keywordlist]]		Das '&' vor rooms ist eine Besonderheit der Objektverundung, und sollte nur bei ausgewählten Listen verwendet werden. Siehe [[#T2F_keywordlist\|T2F_keywordlist]]

	=== Einfaches schalten ===		=== Einfaches schalten ===
Zeile 703:		Zeile 703:

	<u>'''3. nach Benutzerdefinierten Räumen'''</u><br>		<u>'''3. nach Benutzerdefinierten Räumen'''</u><br>
	Ansonsten müssen wir dem Modul sagen in welchem Raum welches Device sitzt. Das hat dafür den Vorteil das die Räume als RegExp angegeben werden können.<br>Wir erzeugen eine Modwordlist ''rollos'' in der wir alle Rollladen "Devices" auflisten. Die Reihenfolge ist an der Keywordlist "rooms" ([[~~Modul_Talk2Fhem~~#Keywordlist]]) anzupassen.		Ansonsten müssen wir dem Modul sagen in welchem Raum welches Device sitzt. Das hat dafür den Vorteil das die Räume als RegExp angegeben werden können.<br>Wir erzeugen eine Modwordlist ''rollos'' in der wir alle Rollladen "Devices" auflisten. Die Reihenfolge ist an der Keywordlist "rooms" ([[#Keywordlist]]) anzupassen.
	rollos = <span style='color:red'>r_alle</span>,<span style='color:red'>r_wz</span>,<span style='color:red'>r_ez</span>,,<span style='color:red'>r_buero</span>,...		rollos = <span style='color:red'>r_alle</span>,<span style='color:red'>r_wz</span>,<span style='color:red'>r_ez</span>,,<span style='color:red'>r_buero</span>,...
	<br>'''Definition'''		<br>'''Definition'''
Zeile 728:		Zeile 728:
	Wie löst man das Problem mit dem Wort "ich" in Sätzen wie:		Wie löst man das Problem mit dem Wort "ich" in Sätzen wie:
	Wenn ich nach hause komme		Wenn ich nach hause komme
	Voraussetzung siehe [[~~Modul_Talk2Fhem~~#T2F_origin]]		Voraussetzung siehe [[#T2F_origin]]

	T2F_keywordlist @names mit den Namen:		T2F_keywordlist @names mit den Namen:
Zeile 1.272:		Zeile 1.272:
	== Ausgabemethoden ==		== Ausgabemethoden ==

	Siehe hierzu [[~~Modul_Talk2Fhem~~#Beispiel\|Anwendungsbeispiel]]		Siehe hierzu [[#Beispiel\|Anwendungsbeispiel]]


	[[Kategorie:Sprachsteuerung\|Talk2FHEM]]		[[Kategorie:Sprachsteuerung\|Talk2FHEM]]

Drhirn: li

2019-11-27T10:28:31Z

← Nächstältere Version		Version vom 27. November 2019, 12:28 Uhr
Zeile 285:		Zeile 285:
	}		}

	''\S* Siehe hierzu [[~~Modul_Talk2Fhem~~#Häufig_verwendete_RegExp\|Häufig verwendete RegExp]].''		''\S* Siehe hierzu [[#Häufig_verwendete_RegExp\|Häufig verwendete RegExp]].''

	Bei der ersten Konfiguration würde der FHEM Befehl "set garage open" bei den folgenden Sprachbefehlen ausgeführt werden.		Bei der ersten Konfiguration würde der FHEM Befehl "set garage open" bei den folgenden Sprachbefehlen ausgeführt werden.

Drhirn: Link zu Talk2Fhem geändert

2019-11-27T10:28:02Z

Link zu Talk2Fhem geändert

← Nächstältere Version		Version vom 27. November 2019, 12:28 Uhr
Zeile 522:		Zeile 522:
	*'''cmd''' => enthält das FHEM Kommando. Wie oben beschrieben. Wird bei bedarf Zeit- oder Ereignisgebunden ausgeführt.		*'''cmd''' => enthält das FHEM Kommando. Wie oben beschrieben. Wird bei bedarf Zeit- oder Ereignisgebunden ausgeführt.
	*'''answer''' => Ein Perl-Befehl der direkt ausgeführt wird und dessen Rückgabe ein Text sein sollte. Das Ergebnis wird in das Reading ''answer'' geschrieben. Der Befehl muss in einem der folgenden Zeichenpaaren eingeschlossen sein. ( ), { }, " " oder ' '. Zu empfehlen sind einfache Anführungszeichen, da dieses verwendet werden müssen wenn Kommazeichen benötigt werden.		*'''answer''' => Ein Perl-Befehl der direkt ausgeführt wird und dessen Rückgabe ein Text sein sollte. Das Ergebnis wird in das Reading ''answer'' geschrieben. Der Befehl muss in einem der folgenden Zeichenpaaren eingeschlossen sein. ( ), { }, " " oder ' '. Zu empfehlen sind einfache Anführungszeichen, da dieses verwendet werden müssen wenn Kommazeichen benötigt werden.
	*'''offset''' => Ganzzahliger Wert in Sekunden der dem Zeitpunkt addiert wird. Siehe [[~~Modul_Talk2Fhem~~#Zeitenmodifikation]]		*'''offset''' => Ganzzahliger Wert in Sekunden der dem Zeitpunkt addiert wird. Siehe [[#Zeitenmodifikation]]

	=== Zeitenmodifikation ===		=== Zeitenmodifikation ===

Drhirn: Link zu Talk2Fhem geändert

2019-11-27T10:27:37Z

Link zu Talk2Fhem geändert

← Nächstältere Version		Version vom 27. November 2019, 12:27 Uhr
Zeile 67:		Zeile 67:
	Schon kann mit FHEM gechattet werden... ;)		Schon kann mit FHEM gechattet werden... ;)

	Mit Telegram lässt sich auch leicht der Absender der Nachricht verarbeiten. Siehe hierzu [[~~Modul_Talk2Fhem~~#Personalifizierung]]		Mit Telegram lässt sich auch leicht der Absender der Nachricht verarbeiten. Siehe hierzu [[#Personalifizierung]]

	==== Google Home Geräte ====		==== Google Home Geräte ====

Drhirn: Drhirn verschob die Seite Modul Talk2Fhem nach Talk2Fhem: Damit die Seite gleich heißt, wie das Modul

2019-11-27T10:22:32Z

Drhirn verschob die Seite Modul Talk2Fhem nach Talk2Fhem: Damit die Seite gleich heißt, wie das Modul

← Nächstältere Version		Version vom 27. November 2019, 12:22 Uhr
(kein Unterschied)

Phill: /* Beispiel nach Vergleichsliste */

2018-11-26T22:53:51Z

Beispiel nach Vergleichsliste

← Nächstältere Version		Version vom 27. November 2018, 00:53 Uhr
Zeile 424:		Zeile 424:

	blendet && <span style='color:red'>(Wohnzimmer\|Esszimmer\|Küche)</span> = set <span style='color:red'>$1</span>[<span style='color:blue'>act_lvgroom, act_dinroom, act_kitchen</span>] 70		blendet && <span style='color:red'>(Wohnzimmer\|Esszimmer\|Küche)</span> = set <span style='color:red'>$1</span>[<span style='color:blue'>act_lvgroom, act_dinroom, act_kitchen</span>] 70
	<span style='color:gray'>~~\|__________\|_______\|___________________\|_____________\|____________\|~~</span>		<span style='color:gray'>1__________2_______3___________________1_____________2____________3</span>

	Ausgabe:		Ausgabe:

Ph1959de: Infobox ergänzt/korrigiert

2018-11-21T12:20:29Z

Infobox ergänzt/korrigiert

← Nächstältere Version		Version vom 21. November 2018, 14:20 Uhr
Zeile 1:		Zeile 1:
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Das Modul stellt eine Verbindung zwischen natürlicher Sprache und FHEM Befehlen her		\|ModPurpose=Das Modul stellt eine Verbindung zwischen natürlicher Sprache und FHEM Befehlen her
	\|ModType=h]		\|ModType=d
	\|ModCmdRef=Talk2Fhem		\|ModCmdRef=Talk2Fhem
	\|ModForumArea=~~Unterstützende Dienste~~		\|ModForumArea=Frontends/Sprachsteuerung
	\|ModTechName=39_Talk2Fhem.pm		\|ModTechName=39_Talk2Fhem.pm
	\|ModOwner=Oliver Georgi		\|ModOwner=Oliver Georgi ({{Link2FU\|10222\|Phill}})
	}}		}}

			Diese Seite beschreibt die Funktionsweise und Konfiguration des Moduls Talk2Fhem.

	Diese Seite beschreibt die Funktionsweise und Konfiguration des Moduls ~~39_Talk2Fhem~~.pm

	== Voraussetzungen ==		== Voraussetzungen ==

Phill: /* Beispiel Temperaturabfragen */

2018-09-16T19:09:09Z

Beispiel Temperaturabfragen

← Nächstältere Version		Version vom 16. September 2018, 21:09 Uhr
Zeile 560:		Zeile 560:
	' "Die Temperatur beträgt ".ReadingsVal("tempdev", "temperature", "Fehler") '		' "Die Temperatur beträgt ".ReadingsVal("tempdev", "temperature", "Fehler") '
	)</syntaxhighlight>		)</syntaxhighlight>
	Für eine Raumbezogene Temperaturabfrage, siehe [[Modul_Talk2Fhem#~~Anwendungsbeispiele_und_Vorlagen~~]]		Für eine Raumbezogene Temperaturabfrage, siehe [[Modul_Talk2Fhem#Raumbezogene_Temperaturansage]]

	=== Personalifizierung ===		=== Personalifizierung ===

Phill: /* Zeitenerkennung */

2018-03-17T21:21:59Z

Zeitenerkennung

← Nächstältere Version		Version vom 17. März 2018, 23:21 Uhr
Zeile 187:		Zeile 187:
	== Modulinterne Spracherkennung ==		== Modulinterne Spracherkennung ==
	=== Zeitenerkennung ===		=== Zeitenerkennung ===
	Die Zeit- und Datum Eingabe kann auf ~~viele~~ verschiedene Arten erfolgen.<br>		Die Zeit- und Datum Eingabe kann auf verschiedene Arten erfolgen.<br>
	Die Datumerkennung umfasst folgende Phrasen:		Die Datumerkennung umfasst folgende Phrasen:
	*morgen, übermorgen		*morgen, übermorgen
	*in ... Wochen, Monat, Jahr		*in ... Wochen, Monat, Jahr
			*in einem drei-,viertel,halben Jahr
	*nächste Woche, Monat, Jahr		*nächste Woche, Monat, Jahr
	*Wochentage		*Wochentage
Zeile 198:		Zeile 199:
	Die Zeiterkennung umfasst folgende Phrasen:		Die Zeiterkennung umfasst folgende Phrasen:
	*in,nach ... stunden,minuten,sekunden		*in,nach ... stunden,minuten,sekunden
			*in einer drei-,viertel,halben Stunde
	*um ... (Uhr) (...)		*um ... (Uhr) (...)
			*um drei-,viertel,halb,viertel vor/nach, 1-12
	*heute - entspricht 12:00		*heute - entspricht 12:00
	*früh - entspricht 9 Uhr		*früh - entspricht 9 Uhr
Zeile 211:		Zeile 214:
	*sofort		*sofort

	Datum und Zeitangaben können ~~natürlich~~ kombiniert werden.		Datum und Zeitangaben können kombiniert werden. '''Morgen abend um 8 Uhr'''
	<br>		<br>
	Wird eine Zeit erfolgreich erkannt erfolgt die Ausführung des FHEM-Kommandos über das Modul '''at'''. Es wird ein at Ereignis angelegt welches den Namen ''at_<modulname>_<zeitindex>'' erhält.		Wird eine Zeit erfolgreich erkannt erfolgt die Ausführung des FHEM-Kommandos über das Modul '''at'''. Es wird ein at Ereignis angelegt welches den Namen ''at_<modulname>_<zeitindex>'' erhält.

Phill: /* Frage Antwort */

2018-03-08T10:54:16Z

Frage Antwort

← Nächstältere Version		Version vom 8. März 2018, 12:54 Uhr
Zeile 821:		Zeile 821:
	answer => ("OK") )		answer => ("OK") )

	==== ~~Einfache Standardantwort (Zeit- und Ereignisabhängig)~~ ====		==== Schaltzustand als Feedback ====
	Da answer immer sofort ausgeführt wird, wird OK direkt gesetzt unabhängig davon ob beim Kommando eine Zeit- oder Eventbedingung mitgegeben wurde. Möchte man eine Antwort zum Zeitpunkt des Ausführens bekommen ist folgendes eine Möglichkeit.		Da answer immer sofort ausgeführt wird, wird OK direkt gesetzt unabhängig davon ob beim Kommando eine Zeit- oder Eventbedingung mitgegeben wurde. Möchte man eine Antwort zum Zeitpunkt des Ausführens bekommen, oder bei Dingen die kein offensichtliches Feedback erzeugen, ist folgendes eine Möglichkeit.
	schalte etwas (\S+) = (		schalte etwas (\S+) = (
	cmd =>		cmd =>
Zeile 829:		Zeile 829:
	setreading $NAME status answer",		setreading $NAME status answer",
	answer => ("OK") )		answer => ("OK") )

	~~==== Schaltzustand als Feedback ====~~
	~~Bei Dingen die kein offensichtliches Feedback erzeugen oder wo getoggelt wird, macht es eventuell Sinn eine Zustandsabhängige Antwort zu geben.~~
	~~schalte etwas (\S+) =~~
	~~set <span style='color:red'>etwas</span> $1{ true => on, false => off};~~
	~~defmod atdekofb at +00:00:01 IF ([<span style='color:red'>etwas</span>] eq "on")~~
	~~(setreading $NAME answers Angeschaltet.)~~
	~~ELSE~~
	~~(setreading $NAME answers Ausgeschaltet.);;~~
	~~setreading $NAME status answer~~

	==== Erfolgsmeldung ====		==== Erfolgsmeldung ====