Talk2Fhem

Talk2Fhem
Zweck / Funktion
	Das Modul stellt eine Verbindung zwischen natürlicher Sprache und FHEM Befehlen her
Allgemein
Typ	undefiniert
Details
Dokumentation	ModUndef
Support (Forum)	Unterstützende Dienste
Modulname	39_Talk2Fhem.pm
Ersteller	Oliver Georgi
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

IN BEARBEITUNG

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

Voraussetzungen

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 hier [1] beschrieben.

Kenntnisse im Bereich Regulärer Ausdrücke (RegExp) in Perl sind hilfreich, aber nicht zwingend erforderlich.

Allgemeines

Das Modul Talk2Fhem stellt eine Verbindung zwischen natürlicher Sprache und FHEM Befehlen her. Die Konfiguration erfolgt dabei über das FHEM Webfrontend.

Bei der Analyse der Sprachbefehle erfolgt keine grammatikalische Analyse, sondern es wird auf definierte Schlüsselwörter reagiert. Das Modul erkennt von sich aus diverse Zeit- und Datumsangaben und löst bei Bedarf zu diesen Zeiten die FHEM Kommandos aus.

Funktionsweise

Die Zerlegung des Sprachbefehls erfolgt in mehreren Schritten.

Aufteilen des Sprachbefehls in einzelne Kommandos bei dem Wort UND
Erkennen von Zeit- und Datumsangaben und entfernen für die weitere Verarbeitung
Entfernung von unnötiger Wörter
Vergleich mit den definierten Schlüsselwörten
Konvertieren in ein FHEM Kommando
Zeitgebundenen auslösen des FHEM Kommandos

Anwendung

Installation

Solange das Modul noch nicht offiziell aufgenommen wurde, muss die Datei 39_Talk2Fhem.pm manuell in das Verzeichnis FHEM/ kopiert werden. Siehe Forumsbeitrag. [2]

Define

define talk Talk2Fhem

Zum testen der Konfiguration ist es Ratsam erst mal das Attribut disable auf 1 zu setzen. Hierbei wird die Auslösung der FHEM Kommandos unterdrückt.

attr talk disable 1

Konfiguration

Die Konfiguration des Moduls wird hauptsächlich über die Definition (DEF) vorgenommen. Eine Konfiguration beginnt immer mit der Definition der gesuchten Schlüsselwörtern gefolgt von einem Gleichheitszeichen (siehe Randnotiz). Diese werden Anhand von Regulären Ausdrücken (RegExp) beschrieben. Also z.B.:

garage auf =

Das bededutet, sobald die Wörter in der Reihenfolge "garage" und "auf" erkannt werden, wird der Kommandoteil der Konfiguration ausgeführt. Groß- und Kleinschreibung wird grundsätzlich ignoriert.

Wichtig

Vor und nach dem Gleichheitszeichen muss mindestens ein Trennzeichen vorhanden sein

Vor dem "=" mindestens ein Leer- oder Tabulatorzeichen
Nach dem "=" können zusätzlich auch Zeilenumbrüche eingefügt werden

Der Kommandoteil folgt dem Gleichheitszeichen (siehe Randnotiz). Und kann auf folgende Arten vorliegen.

FHEM Kommando
{ Perl Befehl }
( erweiterte Talk2Fhem Befehlskonfiguration )

Übersicht:

<regexp> = <command>

Im ganzen könnte die Konfiguration dann so aussehen:

Garage auf = set dev_garage open

Bei dem vorherigen Beispiel, würde der FHEM Befehl "set garage open" bei allen folgenden Sprachbefehlen ausgeführt werden.

Mach bitte die Garage auf
Das haus soll die Garage aufmachen
Garage in 5 Minuten auf
Die Garage soll in einer Stunde aufgemacht werden

Klammerüberführung

Es ist nicht notwendig für jeden Zustand oder jedes Gerät eine eigene Konfigurationzeile zu erzeugen. Hierfür gibt es die Möglichkeit, wie bei Regulären Ausdrücken üblich, Klammern "( )" im <regex>-Teil zu erfassen. Dies erfolgt über die Standartvariablen $1, $2, ..., $n. "n" steht hier für die Position der Klammer. Zusätzlich gibt es in Talk2Fhem die Möglichkeit die Klammern zu modifizieren.

Soll die Garage auf und zugemacht werden, lässt sich folgendermaßen beschreiben.

Beispiel:

garage (\S*) = set dev_garage $1

Der Satz: "Mach die Garage auf" ergibt dann als FHEM Kommando

set dev_garage auf

(\S*) Siehe hierzu "Häufig Verwendete RegExp".

Klammerüberführung und Modifikation

Da es in den meißten Fällen nicht gewünscht ist, nur das gefunde Wort in das FHEM Kommando zu überführen, lässt sich zusätzlich das gefundene Wort modifizieren.

garage (\S*) = set garage $1{true=>open,false=>close}