OPTIMA IoT-Module - Handbuch . 1
IoT-Module - Handbuch
Version 1.0
REV01-180716
OPTIMA IoT-Module - Handbuch . 2
ALLGEMEINE INFORMATIONEN
DIVUS GmbH
Pillhof 51
I-39057 Eppan (BZ) - Italien
Betriebsanleitungen, Handbücher und Software sind urheberrechtlich geschützt. Alle Rechte bleiben vorbehalten.
Das Kopieren, Vervielfältigen, Übersetzen, Umsetzen im Ganzen oder in Teilen ist nicht gestattet. Eine Ausnahme
gilt für die Anfertigung einer Sicherungskopie der Software für den eigenen Gebrauch.
Änderungen des Handbuchs behalten wir uns ohne Vorankündigung vor. Die Fehlerfreiheit und Richtigkeit der in
diesem Dokument und auf den mitgelieferten Speichermedien enthaltenen Daten können wir nicht garantieren.
Anregungen zu Verbesserungen sowie Hinweise auf Fehler sind uns jederzeit willkommen. Die Vereinbarungen
gelten auch für die speziellen Anhänge zu diesem Handbuch.
Die Bezeichnungen in diesem Dokument können Marken sein, deren Benutzung durch Dritte für eigene Zwecke
die Rechte der Inhaber verletzen können.
Benutzerhinweise: Bitte lesen Sie das Handbuch vor dem ersten Einsatz und bewahren Sie es zur späteren
Verwendung sorgfältig auf.
Zielgruppe: Das Handbuch ist für Anwender mit Vorkenntnissen in der PC- und Automatisierungstechnik
geschrieben.
DARSTELLUNGSKONVENTIONEN
[TASTE] Tasteneingaben des Benutzers werden in eckigen Klammern dargestellt, z.B. [STRG] oder
[ENTF]
COURIER Bildschirmausgaben werden in der Schriftart Courier beschrieben, z.B. C:\>
COURIER FETT Tastatureingaben durch den Benutzer sind in Schriftart Courier fett beschrieben, z.B. C:\>DIR
Namen von auszuwählenden Schaltflächen, Menüs oder anderen Bildschirmelementen werden
wiedergegeben.
PIKTOGRAMME Im Handbuch sind folgende Piktogramme zur Kennzeichnung bestimmter Textabschnitte ver-
wendet:
Achtung!
Möglicherweise gefährliche Situation. Sachschäden können die Folge sein.
Notizen
Tipps und ergänzende Hinweise
Neu
Kennzeichnet Änderungen und neue Features
OPTIMA IoT-Module - Handbuch . 3
INHALTSVERZEICHNIS
1 EINLEITUNG____________________________________________________________________________________ 4
1.1 VORWORT _________________________________________________________________________________ 4
1.2 DIE MODULE________________________________________________________________________________ 4
2 IFTTT __________________________________________________________________________________________ 6
2.1 ECKDATEN _________________________________________________________________________________ 6
2.2 KONFIGURATION EINES APPLETS IN IFTTT (ALLGEMEIN) ________________________________________ 6
2.3 KONFIGURATION INNERHALB VON OPTIMA ____________________________________________________ 8
2.4 KONFIGURATION EINES IFTTT-APPLETS FÜR OPTIMA (ALS EMPFÄNGER) ________________________ 10
2.5 KONFIGURATION EINES IFTTT-APPLETS FÜR OPTIMA (ALS AUSLÖSER) __________________________ 12
3 PHILIPS HUE __________________________________________________________________________________ 16
3.1 ECKDATEN ________________________________________________________________________________ 16
3.2 ERSTKONFIGURATION EINES PHILIPS HUE-SYSTEMS IN OPTIMA ________________________________ 16
4 TELEGRAM ___________________________________________________________________________________ 19
4.1 ECKDATEN ________________________________________________________________________________ 19
4.2 ERSTKONFIGURATION VON TELEGRAM FÜR OPTIMA __________________________________________ 19
4.3 KONFIGURATION VOM TELEGRAM-MODUL IN OPTIMA _________________________________________ 20
4.4 BEFEHLE FÜR TELEGRAM IN OPTIMA DEFINIEREN _____________________________________________ 21
5 VOXIOR ______________________________________________________________________________________ 24
5.1 ECKDATEN ________________________________________________________________________________ 24
5.2 KONFIGURATION DES OPTIMA-MODULS FÜR VOXIOR __________________________________________ 24
5.3 KONFIGURATION DES VOXIOR-ACCOUNTS FÜR OPTIMA _______________________________________ 25
5.4 KONFIGURATION EINES AMAZON ECHO-GERÄTS FÜR DIE SPRACHSTEUERUNG IN OPTIMA ________ 26
OPTIMA IoT-Module - Handbuch . 4
1 Einleitung
1.1 VORWORT
KNX CONTROL-Geräte bieten, neben der nativen Unterstützung von KNX-Systemen, auch die Unterstützung
anderer Technologien, die sich über eigene Module natlos in der OPTIMA-Visualisierung integrieren lassen.
Für allgemeine Informationen zum Umgang mit OPTIMA, der Visualisierungssoftware von DIVUS, wird auf das
Administrator-Handbuch verwiesen, das Sie von unserer Homepage herunterladen können.
Die Welt des Internet of Things (kurz IoT ) spielt hier auch eine wachsende Rolle, weshalb DIVUS mehrere Module
zur Unterstützung der beliebtesten IoT-Technologien anbietet.
Diese Module sind zwar funktionstüchtig, befinden sich aber in einem frühen Entwicklungstadium und werden
dementsprechend als BETA gekennzeichnet. Das bedeutet einerseits, dass man einzelne Bugs nicht ausschließen
kann, andererseits auch, dass die Weiterentwicklung der einzelnen Module zu Änderungen führen kann sei es
was das Lizenzierungsmodell anbelangt, als auch bezüglich Eigenschaften und Optionen.
1.2 DIE MODULE
Folgende IoT-Module sind zur Zeit verfügbar:
• IFTTT
• Philips Hue
• Telegram
• Voxior
In den folgenden Kapiteln werden sie im Detail erklärt. Mit der Ausnahme vom Voxior-Modul, welches ab OPTIMA-
Version 2.5.0 standardmäßig zu den aktivierten Modulen gehört, benötigen diese Module eine Freischaltung durch
einen eigenen Lizensschlüssel, den Sie (als Test-Lizenz) auf Anfrage an [email protected] erhalten können.
Dadurch wird der entsprechende Unterpunkt im Menü Technologien der OPTIMA-Administration sichtbar.
OPTIMA IoT-Module - Handbuch . 5
Den erhaltenen Lizenzschlüssel fügen Sie zu diesem Zweck unter Setup Lizenzen und Module im
entsprechenden Feld ein, speichern und laden zur Kontrolle erneut dieselbe Seite, wo dann unter dem Feld Lizenz
gültig bis 01/0X/201X stehen soll.
OPTIMA IoT-Module - Handbuch . 6
2 IFTTT
2.1 ECKDATEN
2.2 KONFIGURATION EINES APPLETS IN IFTTT (ALLGEMEIN)
1. Gehen Sie zur Webseite ifttt.com
2. Erstellen Sie einen neuen Account, oder melden Sie sich direkt an
NAME if this than that
TYP Automatisierungsplatform im Internet
WEB https://ifttt.com/
KONZEPT
oogle-
Dienste (Kalender, Gmail, Google Maps), Amazon Echo, Instagram und eine stetig wachsende
Menge anderer Dienste.
Man wählt ein Ereignis als Auslöser und eines (oder auch mehrere) als darauffolgende Aktion.
Benötig einen freien Account.
INTEGRATION IN
OPTIMA
Ähnlich wie mit Ausgehenden und Eingehenden Verknüpfungen, gibt es mit dem IFTTT-Modul
OPTIMA IoT-Module - Handbuch . 7
3. Klicken Sie auf My Applets und dann auf New Applet
4. Klicken Sie auf [+] this und wählen Sie den Dienst aus, der als Auslöser dienen
5. Klicken Sie nun auf [+] that und wählen Sie diesmal die Aktion, die beim
konfigurierten Ereignis ausgeführt werden soll z.B. eine E-Mail schicken. Je
nach ausgewähltem Dienst geben Sie dann die Konfigurationsdetails an.
6. Das neue Applet wird zuletzt überprüft und dann gleich aktiviert.
OPTIMA IoT-Module - Handbuch . 8
2.3 KONFIGURATION INNERHALB VON OPTIMA
1. Öffnen Sie unter Technologien das Menü IFTTT BETA und klicken Sie
darunter auf Webhooks.
2. ; gehen Sie auf ifttt.com
3. Klicken Sie auf das entsprechende Suchergebnis
4. -Taste.
5.
6. Kopieren Sie den letzten Teil der URL (siehe blau hervorgehobener Teil)
7. Fügen Sie nun die kopierte Zeichenfolge als IFTTT Key ein:
OPTIMA IoT-Module - Handbuch . 9
8. Ziehen Sie nun ein Objekt in den Bereich der Ereignisse, die an IFTTT
gesendet werden sollen
9. Geben Sie dem Ereignis einen eindeutigen Namen den brauchen Sie dann
für die Verknüpfung des Ereignisses mit IFTTT.
10. Wählen Sie die Bedingung.
OPTIMA IoT-Module - Handbuch . 10
2.4 KONFIGURATION EINES IFTTT-APPLETS FÜR OPTIMA (ALS EMPFÄNGER)
In den folgenden Schritten wird ein Beispiel für eine mögliche IFTTT-Automatisierung gezeigt. Für andere Dienste
sind gewisse Schritte unterschiedlich als die beschriebenen.
1. Legen Sie ein neues Applet an (siehe als Beispiel 2.2, Schritte 1-3). Wenn
nicht schon erledigt, führen Sie außerdem die Schritte 1-7 aus, die unter
1.3.3. beschrieben sind.
2. Wählen Sie als [+] this
.
OPTIMA IoT-Module - Handbuch . 11
3. Geben Sie den zuvor eingegebenen Ereignisnamen hier auch ein und klicken
4. Dann suchen Sie als [+] that den gewünschten Dienst aus z.B. SMS, um bei
diesem Ereignis eine SMS-Nachricht zu erhalten.
OPTIMA IoT-Module - Handbuch . 12
5. Drücken Sie zuletzt auf Finish, um die Prozedur abzuschließen und
gleichzeitig die neue Automation zu starten.
6. Testen Sie nun. Wenn alles klappt, erhalten Sie im obigen Beispielsfall nach
dem Auslösen des Ereignisses eine Nachricht auf Ihrem Smartphone.
2.5 KONFIGURATION EINES IFTTT-APPLETS FÜR OPTIMA (ALS AUSLÖSER)
Voraussetzung: Für diese Art von Automatisierung brauchen Sie eine öffentliche IP-Adresse oder einen DDNS-
Dienst, damit Ihr KNX CONTORL-Gerät vom Internet aus erreichbar ist. In den folgenden Schritten wird ein Beispiel
für eine mögliche IFTTT-Automatisierung gezeigt. Für andere Dienste sind gewisse Schritte unterschiedlich als die
beschriebenen.
OPTIMA IoT-Module - Handbuch . 13
1. Erstellen Sie ein Szenario oder wählen Sie ein Objekt in OPTIMA, welches über
IFTTT gesteuert werden soll und ziehen Sie es in den Bereich Ereignisse, die
von IFTTT empfangen werden
2. Geben Sie auch hier dem Ereignis einen eindeutigen Namen
3. Klicken Sie dann auf das violette Icon IFTTT-URL beziehen und folgen Sie den
Anweisungen.
Aus z.B.
https://{IP}:{PORT}/www/modules/ifttt/server.maker.php?key=mbDEdeg
8D2804tiFG5-C3ICQWW6y8_Xvq-2LKxkHdy9&event=Nachhause
machen Sie
https://meindivusknxserver.dyndns.org/www/modules/ifttt/server.maker.php?key=mbD
Edeg8D2804tiFG5-C3ICQWW6y8_Xvq-2LKxkHdy9&event=Nachhause
4. Gehen Sie auf ifttt.com
5. Erstellen Sie unter My Applets ein neues Applet.
6. Suchen Sie als [+] this
um Ihre GPS-Position zu verwenden
OPTIMA IoT-Module - Handbuch . 14
7. Wählen Sie unter Choose trigger
8. Geben Sie die gewünschte Adresse ein (im Beispielsfall ein gewisser Radius
rund um Ihr Zuhause)
9. Als [+] that verwenden Sie wieder den Webhooks-
web
OPTIMA IoT-Module - Handbuch . 15
10. Fügen Sie hier die IFTTT-URL ein, die Sie in Punkt 3. vorbereitet haben. Klicken
die anderen Felder können Sie auf den
Standardwerten belassen.
11. die Automatisierung ist dann sofort
aktiv. (Im Beispielsfall brauchen Sie die IFTTT-App auf Ihrem mobilen Gerät, um
dessen GPS-Position auszuwerten. Diese App ermöglicht über andere
interessante Ereignisse ihr Smart Home anzusteuern z.B., wenn Sie sich mit
Ihrem WIFI-Netzwerk verbinden).
OPTIMA IoT-Module - Handbuch . 16
3 Philips Hue
3.1 ECKDATEN
3.2 ERSTKONFIGURATION EINES PHILIPS HUE-SYSTEMS IN OPTIMA
Für die Konfiguration eines Philips HUE-Systems verwenden Sie die App für Android oder iOS. Dadurch finden Sie
die IP-Adresse der Bridge, die Sie dann in OPTIMA brauchen.
1. Gehen Sie in der OPTIMA-Administration auf
Philips HUE BETA
2. Fügen Sie mit der blauen ( + ) Taste ein neues Bridge-Gerät hinzu.
3. Öffnen Sie die Detailseite des Bridge-Geräts (grüne Taste unten
NAME Philips HUE
TYP WIFI-fähiges Beleuchtungssystem
WEB https://www2.meethue.com/de-de
KONZEPT
Ein Bridge-Gerät mit WIFI steuert einzelne Lampen an. Ein/Aus, Farbe und Helligkeit können
einzeln oder gruppiert bestimmt werden.
Ansteuerung über App oder auch HTTP. Native Integration in vielen anderen Systemen z.B.
Amazon Alexa, IFTTT, SmartThings usw.
INTEGRATION IN
OPTIMA
Nach eimaliger Konfiguration lassen sich HUE-Lampen als vorgefertigte Komplexe Objekte
(RGB) nahtlos in der Visualisierung integrieren.
OPTIMA IoT-Module - Handbuch . 17
4. Gehen Sie in der HUE-App in den Einstellungen auf die Bridge-Seite. Über das
kleine Info-Icon können Sie dessen IP-Adresse auslesen. Fügen Sie diese hier
im Feld IP-Adresse ein.
5. Klicken Sie auf KONFIGURIEREN.
6. Klicken Sie auf die Taste des Bridge-Geräts und dann im rechten Fenster auf
VERBINDEN. Das Benutzerfeld wird automatisch ausgefüllt
7. Nun können Sie einzelne Lampen manuell hinzufügen, oder mit der
ENTDECKEN-Taste automatisch beziehen. Um einzelne Lampen hinzuzufügen
gehen Sie auf Über (About) den letzten Punkt in den Einstellungen der App;
dort finden Sie eine Auflistung, die mit der Bridge startet und den verbundenen
Lampen fortläuft. Die Lampen haben vor dem Namen eine Nummer. Geben
Sie diese Nummer in das Feld Adresse der neu angelegten Lampe und schon
können Sie damit kommunizieren.
OPTIMA IoT-Module - Handbuch . 18
8. Die RGB-Lichter können Sie durch das kleine grüne Icon am Anfang der Zeile
aufrufen, um sie den Räumen zuzuordnen, von denen man sie ansteuern
können soll.
9. der Visualisierung sieht es dann so aus:
OPTIMA IoT-Module - Handbuch . 19
4 Telegram
4.1 ECKDATEN
4.2 ERSTKONFIGURATION VON TELEGRAM FÜR OPTIMA
1. Laden Sie auf Ihrem Mobilgerät die App Telegram (Icon mit dem Papierflieger)
2. Öffnen Sie die App und geben Sie im Suchfeld @BotFather ein.
3. Drücken Sie auf das Suchergebnis und dann auf START
4. Geben Sie /newbot ein und folgen Sie den Anweisungen: geben Sie Ihrem Bot
einen Namen z.B. OPTIMA
5. Geben Sie einen Benutzernamen ein, der mit bot enden muss z.B.
DIVUSOPTIMA_bot. Wenn der Name nicht schon vergeben ist, wird die
Prozedur abgeschlossen und Sie sehen den API-Schlüssel, den Sie später im
OPTIMA-Modul eintragen werden.
NAME Telegram
TYP Text-Kommunikations-App (ähnlich wie SMS od. WhatsApp)
WEB https://telegram.org
KONZEPT
Über einen besonderen Chat können Sie Ihrem Smart Home Befehle zuteilen. Dies braucht
keine Port-Weiterleitung, weil die Kommunikation über das Telegram-System verwaltet wird.
Personen ansprechen kann und auf bekannte Fragen entsprechende Antworten liefern kön-
nen. Durch einen solchen Bot lässt sich die Kommunikation mit OPTIMA realisieren.
Benötig einen freien Telegram-Account sowie die unten beschriebene Vorkonfiguration.
OPTIMA IoT-Module - Handbuch . 20
4.3 KONFIGURATION VOM TELEGRAM-MODUL IN OPTIMA
1. Gehen Sie in der OPTIMA-Administration auf
TELEGRAM BETA
2. Fügen Sie mit der blauen ( + ) Taste einen neuen Telegram-Bot hinzu.
3. Öffnen Sie die Detailseite des Telegram-Bot
4. Fügen Sie den zuerst erhaltenen API-Schlüssel ein
5. Starten Sie die Kommunikation mit dem Bot durch die gelbe Taste
6. Nun ist OPTIMA mit ihrem Bot verbunden. Sie können das testen, indem Sie in
der App den zuerst erstellten Bot suchen (mit dem @-Symbol vor dem Namen)
7. Starten Sie den Chat mit Hallo. Aus Sicherheitsgründen bekommen Sie
darauf die Antwort, dass der Chat in OPTIMA erst autorisiert werden muss.
OPTIMA IoT-Module - Handbuch . 21
8. Wechseln Sie zur Telegram-Seite von OPTIMA und drücken Sie rechts von
Chats den blauen AKTUALISIEREN-Button.
9. Der gestartete Chat wird dort nun angezeigt und Sie können ihn autorisieren
sowie dessen Benachrichtigungen aktivieren, falls gewünscht.
4.4 BEFEHLE FÜR TELEGRAM IN OPTIMA DEFINIEREN
Der Telegram-Bot nutzt die Technologie, die in OPTIMA für das Sprachassistent-Modul entwickelt wurde. Für
dieses Modul gibt es auf unserer Homepage ein eigenes Handbuch.
Die Befehle werden dort angelegt.
1. Gehen Sie in der OPTIMA-Administration auf
Sprachassistent BETA Personalisierte Befehle
OPTIMA IoT-Module - Handbuch . 22
2. Legen Sie mit der grünen HINZUFÜGEN-Taste einen neuen Sprachbefehl an.
3. Als Test-Objekt erstellen wir ein neues Virtuelles Objekt unter Erweiterte
Funktionen. Wir nennen es TELEGRAM TEST und ordnen es einem Raum zu
oder erstellen zuerst den Raum, wo wir es testen können. Falls Sie diesen Test
überspringen wollen, können Sie stattdessen direkt mit dem gewünschten
Objekt probieren.
4. In unserem Personalisierten Befehl ziehen wir das Objekt per Drag & Drop in
das Feld namens Objekt. Die anderen Felder füllen wir dann so aus:
5. Die ganze Prozedur wiederholen wir für den Befehl zum Einschalten:
SCHLÜSSELSÄTZE Schalte den Telegram-Schalter aus
WERT Aus
ANTWORT Der Telegram-Schalter wurde ausgeschaltet.
SCHLÜSSELSÄTZE Schalte den Telegram-Schalter ein
WERT Ein
ANTWORT Der Telegram-Schalter wurde eingeschaltet.
OPTIMA IoT-Module - Handbuch . 23
6. Die Befehle können Sie nun im Chat von Telegram mit Ihrem Bot testen,
während Sie in der OPTIMA-Visualisierung das Objekt im zugeordneten Raum
beobachten.
OPTIMA IoT-Module - Handbuch . 24
5 Voxior
5.1 ECKDATEN
5.2 KONFIGURATION DES OPTIMA-MODULS FÜR VOXIOR
1. Gehen Sie in der OPTIMA-Administration auf
Voxior BETA Optionen
2. Falls notwendig, aktivieren Sie den Remotezugriff
3. Wählen Sie das erste Objekt aus, das sprachgesteuert werden soll, indem Sie
es im Suchfeld eingeben. (Das %-Symbol als Suchbegriff findet alle
vorhandenen Objekte)
4. Öffnen Sie dessen Detailfenster durch die drei Punkte rechts vom Namen oder
durch die grüne Bearbeiten-Taste im linken unteren Eck.
5. Schalten Sie auf die Experten-Ansicht, sodass der Abschnitt Berechtigungen
des Objekts unter Darstellung sichtbar wird.
6. Aktivieren Sie das Objekt für die Sprachsteuerun In die
Cloud aufzeichnen
NAME Voxior
TYP Cloudplattform als Brücke zwischen lokalen Diensten und öffentlichen Sprachsteuerungs-
diensten wie Amazon Alexa, Google Assistant, Apple Siri
WEB https://www.voxior.com
KONZEPT
Voxior spielt den Mittelmann zwischen OPTIMA und dem Sprachsteuerungsdienst. Es holt sich
die zu steuernden Objekte aus OPTIMA und übernimmt den Rest der Kommunikation bis hin
also z.B. einem Amazon Echo Dot und wieder zurück.
Benötig einen kostenpflichtigen Voxior-Account sowie, je nach Sprachsteuerungsdienst, ei-
nen entsprechenden Account des Dienstes.
INTEGRATION IN
OPTIMA
Durch eine simple Checkbox lassen sich die zu sprachsteuernden Objekte in OPTIMA auswäh-
len. Für den Zugriff auf Ihr KNX CONTROL-Gerät brauchen Sie eine Portweiterleitung und ei-
nen DDNS-Dienst oder eine öffentliche fixe IP-Adresse.
OPTIMA IoT-Module - Handbuch . 25
7. Wiederholen Sie die Schritte 3. bis 6. für eventuelle weitere Objekte, die Sie
sprachsteuern wollen.
8. Aktivieren Sie, wenn nicht schon erledigt, den Fernzugriff auf Ihr KNX
CONTROL-Gerät. Dazu brauchen Sie entweder eine statische öffentliche IP-
Adresse oder einen DDNS-Dienst. Alternativ bietet Voxior ein eigenes Gerät für
diese Zwecke namens VoxiorLink, wodurch Sie keine Ports ihres Internet-
Routers von außen öffnen müssen.
5.3 KONFIGURATION DES VOXIOR-ACCOUNTS FÜR OPTIMA
1. Gehen Sie auf www.voxior.com.
2. Falls noch nicht erledigt, erstellen Sie einen Account.
3. Melden Sie sich über ihr Google- oder Amazon-Konto an.
4. Gehen Sie im Menü auf Gateways
5. Klicken Sie auf GATEWAY HINZUFÜGEN und
aus.
6. Füllen Sie die Felder mit den Daten aus, womit Sie sich auch über einen
Browser per Fernzugriff an Ihrem KNX CONTROL-Gerät anmelden können.
OPTIMA IoT-Module - Handbuch . 26
7. Drücken Sie die Speichern-Taste. Die Zugangsdaten werden sofort getestet
und sie erhalten sofort ein Feedback, ob die Verbindung erfolgreich war oder
nicht.
8. Unter Geräte finden Sie nun die Liste der aktivierten Geräte. Falls die Namen
zu kompliziert oder schwierig auszusprechen sind, können Sie sie hier ändern.
Die Namen müssen Sie zur Sprachsteuerung kennen und sie sollten sich
idealerweise klar voneinander unterscheiden.
5.4 KONFIGURATION EINES AMAZON ECHO-GERÄTS FÜR DIE SPRACHSTEUERUNG IN OPTIMA
1. Gehen Sie in der Alexa-App auf Skills und aktivieren Sie den Voxior-Skill.
2. Sagen Sie dann , Daraufhin sollten die neuen
Geräte erkannt werden. In der App finden Sie unter Smart Home immer die
Liste der ansprechbaren Geräte.
3. Nun ist es so weit! Durch Befehle wie können
Sie nun ihre Smart Home-Anlage sprachsteuern. In welcher Form Sie
unterschiedliche Gerätearten ansteuern können, finden Sie in der Geräte-Seite
Ihres Voxior-Accounts.
OPTIMA IoT-Module - Handbuch . 27
NOTIZEN
OPTIMA IoT-Module - Handbuch . 28