Home Installation Konfiguration Betrieb Changelog FAQ

Willkommen bei Alexa-KNX!

Hinweis vom 8.12.2023: Zwingendes Update auf HomeServer Firmware >=4.6 erforderlich (somit leider kein Betrieb mehr auf HomeServer 2/3 möglich)!

Hinweis: aktuell wird ab der Firmware Version 4.12 der HTML-Code zur Darstellung der Alexa-KNX Links „escaped“ und somit als Text ausgegeben. D.h. die Verlinkung der „Logausgabe“, „JSON-Configuration“ und „CustomSkill Slot Types“ über die Debug-Seite funktioniert nicht mehr. Als Workaround muss bitte die im href-Attribute angegebene URL verwendet werden.

Was ist Alexa-KNX?

Alexa-KNX ist eine Software, welche eine Anbindung von Alexa™/Amazon Echo™ an den HomeServer™ der Firma GIRA ohne den Einsatz zusätzlicher Hardware ermöglicht.
Die Software besteht hierbei aus zwei Komponenten: einem GIRA Logikbaustein Alexa-KNX-LBS und einem zugehörigen Alexa Skill (KNX HomeServer Smart und/oder KNX HomeServer Custom). Somit können KNX-Geräte per Sprache gesteuert und abgefragt werden. Über die optionale Erweiterung HS2Alexa kann, ab der LBS Version 1.2.1, der HomeServer auch Alexa-Aktionen wie z.B. Sprachansagen auslösen.
Die Software richtet sich in erster Linie an KNX Systemintegratoren und KNX Business-Partner.
Für die Anbindung ist keine Portweiterleitung (Portforwarding) am eigenen Internet Router notwendig.

Warum gibt es zwei Alexa Skills und was sind deren Unterschiede?

Alexa unterstützt mit der Smart Home Skill API aktuell leider einen etwas eingeschränkten Umfang an Formulierungen und Befehlstypen, welche zur Steuerung/Abfrage von Geräten (KNX-Objekten) verwendet werden können. So kennt Alexa z.B. leider kein Sprachkommando wie "Fahre die Rollläden herunter", "Ist das Fenster im Wintergarten offen?" oder "Gib mir einen Statusbericht vom Haus".
Der Custom Skill versucht diese Lücke zu schließen und den Smart Home Skill um die fehlenden Formulierungen und Befehlstypen zu erweitern. Im Unterschied zum Smart Home Skill muss beim Custom Skill jedoch zusätzlich zum Aktivierungswort "Alexa" der Aufrufname "My Home" verwendet werden. Hinweis: Bei paralleler Verwendung beider Skills muss darauf geachtet werden, dass für Aktionen die nicht vom Smart Home Skill unterstützt werden, der Custom Skill mit dem Aufrufnamen "My Home" verwendet werden muss.

Smart Home Skill (KNX HomeServer Smart) zur Skillbeschreibung

Die möglichen Sprachkommandos und deren Formulierungen (Interaction Model), sowie die Formulierung der Antworten kommen von Amazon.

Basierend auf der Smart Home Skill API V3 von Amazon unterstützt der Skill die nachfolgenden Befehlstypen:
(Das kursiv geschriebene Kommando ist lediglich ein Beispiel für die möglichen Formulierungen des genannten Befehlstyps.)
Beispiele für Sprachkommandos mit dem Smart Home Skill:
Alexa, schalte das Licht im Büro aus.
Alexa, stelle das Licht im Büro auf 70 Prozent.
Alexa, fahre die Rollläden herunter.
...

Custom Skill (KNX HomeServer Custom) zur Skillbeschreibung

Die möglichen Sprachkommandos und deren Formulierungen (Interaction Model), sowie die Formulierung der Antworten kommen vom Custom Skill. Der Custom Skill versucht, anhand des gegebenen Kommandos eine grammatikalisch korrekte Antwort zu bestimmen.
Um den Custom Skill zu verwenden, muss zusätzlich zum Aktivierungswort "Alexa" der sogenannte Aufrufname "My Home" verwendet werden. Beachten Sie bitte auch die Hinweise unter Konfiguration - Custom Skill Listen.

Vom Custom Skill werden zusätzlich zu den oben aufgeführten Befehlstypen nachfolgende unterstützt:
(Das kursiv geschriebene Kommando ist lediglich ein Beispiel für die möglichen Formulierungen des genannten Befehlstyps.) Beispiele für Sprachkommandos mit dem Custom Skill:
Alexa, sage My Home schalte das Licht im Büro aus.
Alexa, sage My Home fahre die Rollläden herunter.
Alexa, sage My Home dieser Echo ist im Büro aufgestellt.
Alexa, frage My Home welche Räume sind definert.
Alexa, frage My Home welche Geräte sind im Raum Büro definiert.
...

Weitere Features:

HS2Alexa neue optionale Erweiterung ab der Logibaustein Version 1.2.1

Mit dieser optionalen Erweiterung können, in Verbindung mit den entsprechenden Adapter-Sublogikbausteinen, Alexa-Aktionen durch den HomeServer ausgelöst werden. D.h. im Gegensatz zur Steuerung des HomeServer über Alexa-Sprachbefehle, können jetzt Alexa-Geräte vom HomeServer "gesteuert" werden.

Beispiele für mögliche Steuermöglichkeiten ihrer Alexa-Geräte: Zur Realisierung ist zusätzlich eine weiterführende Konfiguration innerhalb der Alexa-App notwendig.

Hinweis: Die Steuermöglichkeiten sind bei Einsatz von nicht Amazon-Alexa-Geräten evtl. eingeschränkt. (z.B. bietet Sonos One aktuell keine Unterstützung von Sprachansagen oder der Türklingel-Funktion)

Welche Systemvorraussetzungen sind nötig?

Was kostet Alexa-KNX?

Die Lizenz für den Logikbaustein (inkl. Update HS-Firmware >= 4.9) zur Anbindung kostet: Für Lizenzen, die vor dem 23.12.2019 gekauft wurden, ist für den Einsatz unter der Gira HomeServer Firmware >= 4.9 das "Update HS-Firmware >= 4.9 €30,00 EUR" erforderlich.

Die Nutzungslizenz ist zeitlich unbefristet und beinhaltet eine Funktionsgarantie für 12 Monate ab Kaufdatum.
Sollte innerhalb dieses Zeitraums die Funktion von Alexa-KNX nicht mehr möglich sein, haben Sie das Recht auf zeitanteilige Rückerstattung des Kaufpreises (Kaufpreis geteilt durch 12 mal nicht genutzte Monate).

Für die Einrichtung einer 14 tägigen Testanbindung wird eine Gebühr von 15,00€ erhoben, die beim Kauf verrechnet wird.

Auf Wunsch biete ich die Möglichkeit, die Installation und Ersteinrichtung zu übernehmen. In diesem Fall kontaktieren Sie mich bitte unter info@alexa-knx.de.

Welche Schritte muss ich durchführen?

Um ihr Alexa-KNX Konto einrichten und den Logikbaustein für Sie bauen zu können, werden folgende Informationen benötigt:
  1. die E-Mail Adresse mit der sie sich an der Alexa-App/Alexa-Webseite anmelden
  2. die Ident-Nr. (auch als MAC-Adresse oder HS-Seriennummer bezeichnet) sowie die Firmware-Version (beides zu finden auf der Debug-Liste unter der Rubrik System) ihres Gira HomeServers
  3. ihre Alexa-KNX Skill spezifische Amazon Benutzerkennung
Damit ihre Alexa-KNX Skill spezifische Amazon Benutzerkennung von uns ermittelt werden kann, müssten sie bitte mindestens einen der beiden Alexa-KNX Skills aktivieren und die nachfolgende Kontoverknüpfung durchführen (dass die Kontoverknüpfung bei Verwendung des Smart Home Skills zu diesem Zeitpunkt noch fehlschlägt, ist leider technisch bedingt). Des Weiteren müssten sie bitte, falls sie hierfür den Custom Skill (My Home) verwenden, nach erfolgreicher Kontoverknüpfung, zu Alexa noch das Kommando Alexa, frage My Home wie ist meine Benutzerkennung? sagen.

Wichtiger Hinweis zur fehlschlagenden Kontoverknüpfung mit dem Smart Home Skill: Die erfolgreiche Kontoverknüpfung mit dem Smart Home Skill ist leider erst nach Einrichtung ihres Alexa-KNX Kontos möglich. D.h. falls sie den Smart Home Skill zur Übertragung ihrer Benutzerkennung verwenden sollten, dürfen sie bitte nicht vergessen, nach der Einrichtung ihres Alexa-KNX Kontos, die Kontoverknüpfung erfolgreich abzuschließen.

Bitte senden sie im Anschluss die Informationen aus Punkt 1. und 2. an info@alexa-knx.de

Hinweis: Die Auslieferung der Software erfolgt per Mail und besteht aus einem für Sie generierten Logikbaustein und einer zugehörigen Bibliothek. Im Allgemeinen erfolgt diese Auslieferung nach dem Erhalt aller benötigten Daten zeitnah (meist < 1Stunde). Nachdem es sich jedoch um einen manuellen Prozess handelt, kann nicht immer gewährleistet werden, dass die Auslieferung innerhalb weniger Stunden erfolgt.

Welche Zahlungsmöglichkeiten gibt es?

Sie können entweder vorab hier mit PayPal bezahlen, oder bekommen in der Auslieferungsmail der Software die Bankverbindung zur Zahlung mitgeteilt. Bei Zahlung per PayPal wird keine automatische Empfangsbestätigung versendet.

Bitte wählen:

Mit dem Einsatz der Alexa-KNX Software erklären sie sich mit der Datenschutzerklärung einverstanden und stimmen den Nutzungsbedingungen zu!

Impressum     Datenschutzerklärung     Nutzungsbedingungen