Automation Manager

Was ist der Automation Manager?

Der NEO Automation Manager ist ein leistungsstarkes AIO CREATOR NEO Plugin zur Erzeugung automatisierter Abläufe über Regeln und Bedingungen. Mit ihm können alle in das AIO CREATOR NEO System integrierten Geräte der unterschiedlichen Hersteller und Smart Home Systeme plattform- und technologieübergreifend automatisiert werden

Was kann der Automation Manager?

Mit dem Automation Manager können Sie Ihre Smart Home Geräte über Herstellergrenzen hinweg untereinander automatisieren. Also z.B. auf die Meldung Ihres Fenstersensors, dass ein Fenster geöffnet ist, im Winter die Heizung herunterregeln. Zur Erzeugung der Automatik-Programme, den Tasks, verfügt der NEO Automation Manager über ein grafisches DIY-Benutzer-Frontend, den Blockeditor, zur einfachen Realisierung von logischen Regeln ohne Programmierkenntnisse. Darüber hinaus bietet er mit dem Skripteditor ein Profi-Frontend zur Erzeugung beliebig komplexer Zusammenhänge mittels JavaScript.

Wozu benötige ich den NEO Server oder ein V6 Plus/V5 Plus?

Das Programm NEO SERVER dient zur Überwachung der Ausführung der mit dem NEO Automation Manager erzeugten Tasks. Um diese Aufgabe wahrnehmen zu können, muss der NEO SERVER auf einem Rechner innerhalb des Netzwerks installiert und gestartet sein. Ist der Rechner (auf dem der NEO Server installiert ist) ausgeschaltet oder das Programm NEO SERVER läuft nicht im Hintergrund, können keinerlei Tasks ausgeführt werden. Der NEO SERVER muss sich im selben Netzwerk befinden wie die in NEO integrierten lokalen Geräte (Geräte, die über die Cloud eingebunden sind, sind hiervon ausgenommen). Auf dem AIO GATEWAY V6 Plus / V5 Plus ist NEO SERVER bereits vorinstalliert, muss aber unter Umständen erst noch aktiviert werden. Dies geht ebenfalls über den NEO Automation Manager. Auch auf der Homematic CCU3 ist der NEO Server bereits vorhanden, muß aber aktiviert werden.

Den NEO SERVER installieren

Um den Automation Manager nutzen zu können, benötigen Sie also zwingend einen NEO SERVER.

Wie Sie den NEO SERVER installieren oder updaten, können Sie im Doku-Bereich NEO SERVER nachlesen.

Tasks mit dem Automation Manager erstellen

Wichtiges vorab: Damit Sie Tasks erstellen können, müssen Sie Folgendes wissen

Öffnen Sie den NEO Automation Manager über das Hauptmenü

Auf der Startseite sehen Sie Ihren NEO SERVER bzw. Ihr V6 Plus.

Damit Ihre Tasks nachher funktonieren, müssen Sie zuvor folgendes beachten:

1. Alle Tasks und Skripte, die im NEO Automation Manager erstellt oder bearbeitet wurden, werden zunächst nur lokal im AIO CREATOR NEO gespeichert.
2. Damit die Tasks ausgeführt bzw. Veränderungen eines Tasks im NEO Server übernommen werden können, müssen diese auf den NEO SERVER / das V6 Plus übertragen werden. Hierfür müssen Sie auf der Startseite des Automation Manager den Übertragen-Button anklicken.

3. Wenn Sie Cloud-Geräte über ein Cloud-System in Tasks verwenden, müssen Sie für Ihren NEO SERVER/ Ihr V6 Plus festlegen, welches Cloud-Konto verwendet werden soll. Klicken Sie nach dem Auswählen auf Übernehmen.
4. Falls noch nicht geschehen, müssen Sie für Ihren NEO SERVER oder das V6 Plus den Cloudzugriff freischalten.

Nach der Übertragung wird die Ausführung der Tasks allein vom NEO SERVER / V6 Plus überwacht und durchgeführt (der AIO CREATOR NEO bzw. Automation Manager wird dazu nicht benötigt).

Tasks erstellen im Blockeditor

Tasks werden grundsätzlich im Blockeditor erzeugt.

Mit dem Blockeditor Erstellen Sie ganz einfach automatische Abläufen, die an Bedingungen und Regeln gekoppelt werden. Diese Abläufe werden als Tasks gespeichert. Tasks können aktiviert oder deaktiviert werden. Deaktivierte Tasks werden nicht ausgeführt. Zum Gestalten eines Tasks stehen die folgenden drei Basiskategorien zur Wahl:

1. Blöcke
2. Bedingungen
3. Aktionen

Blöcke

Die Blöcke bilden das Grundgerüst eines Tasks und dienen dazu, Bedingungen und Aktionen miteinander zu verbinden.

Dabei ist der Sobald-Block immer der Ausgangspunkt bzw. der grundsätzliche Auslöser (Trigger) des Tasks. Da sie eine Grundvoraussetzung sind, können Sobald-Blöcke nicht gelöscht werden.

In den Sobald-Block können folgende weitere Blöcke eingebettet werden:

Der Falls-Block und der Falls-Sonst-Block können als erweiternde Bedingung für den Sobald-Block oder andere Falls- bzw. Falls-Sonst-Blöcke eingesetzt werden. Dabei sind Falls-Blöcke immer über eine logische UND-Verknüpfung mit dem übergeordneten Block verbunden. Als erweiternde Bedingungen (in Falls/Falls-Sonst-Blöcken) oder als Aktionen können alle in NEO in-tegrierten Geräte verwendet werden.

Kurze Erläuterung der Blockfunktionalität

→ Sobald-Block bedeutet:

Sobald die zugeordneten Bedingungen eintreten, dann X

→ Falls-Block bedeutet:

Sofern die zugeordneten Bedingungen eintreten, dann X

→ Falls-Sonst-Block bedeutet:

Sofern die zugeordneten Bedingungen eintreten, dann X, wenn nicht, dann Y.

→ Dann-Block bedeutet:

Über den Dann-Block können Aktionen an die Sobald-, Falls- und Falls-Sonst-Blöcke gekoppelt werden.

Kombinieren von Blöcken: Blöcke lassen sich per Drag & Drop wie Puzzleteile miteinander verschachteln, indem sie an die gewünschte Position gezogen werden. Den äußeren Rahmen eines Tasks bildet immer der Sobald-Block. Alles, was sich außerhalb des Sobald-Blocks befindet, ist für den Task irrelevant (und wird beim Abspeichern gelöscht). Werden Blö cke ineinander verschachtelt, so werden sie in der Abfolge von außen nach innen geprüft bzw. abgearbeitet.

Zuweisen von Inhalten: Zur Festlegung der Funktionalität von Blöcken müssen Inhalte zugewiesen werden. Je nach Art des Blocks können Bedingungen oder Aktionen hinzugefügt werden. Das Hinzufügen erfolgt ebenfalls per Drag & Drop, indem eine Bedingung oder Aktion auf den jeweiligen Block gezogen wird.

Auslöser / Bedingungen

Sobald-, Falls- und Falls-Sonst-Blöcken können eine oder mehrere Bedingungen hinzugefügt werden.

Sobald-Block: Sind dem Sobald-Block mehrere Bedingungen zugeordnet, sind diese immer mit ODER logisch verknüpft.

Falls- und Falls-Sonst-Block:

Sind diesen Blöcken mehrere Bedingungen zugeordnet, so können die Bedingungen über die drei un-terschiedlichen logischen Verknüpfungen UND, ODER oder XOR miteinander kombiniert werden. Dabei ist die XOR-Verknüpfung ein „exklusives ODER“. D.h.:

ENTWEDER wenn Bedingung A eintritt ODER wenn Bedingung B eintritt, dann X. (D.h. treten Bedingung A und B gleichzeitig ein, passiert nichts.)

Folgende Bedingungen können im SOBALD oder FALLS-BLock gewählt werden:

1.Klammern: Die Klammer dient dazu mehrere Gerätestatusbedingungen miteinander direkt logisch zu verknüpfen, um das Ergebnis wiederum mit anderen Bedingungen verknüpfen zu können.

2.Gerätestatus:

Hier dient der Zustand eines Gerätes als Bedingung. Durch Anklicken des oberen Feldes (gewünschtes Gerät) und des unteren Feldes (jeweiliger Zustand) kann ein Status als Bedingung definiert werden.

3.Astro: Hier können Sie Astrodaten (Sonnenauf- & Sonnenuntergang) als Bedingung definieren.

4.Zeit: Hier können Sie zeitabhängige Bedingungen definieren.

5.Intervall:

Hier können Sie ein Zeit-Intervall definieren, in dem der Task ausgelöst wird. So ist es möglich, in regelmäßigen Abständen den Task auszulösen, um z.B. bestimmte Statuszustände regelmäßig zu überprüfen.

6.HTTP: Hier können Sie einen HTTP-Request als Bedingung definieren, der dann als GET-Anfrage auf dem NEO SERVER aufgerufen werden kann. Unter Vorschau sehen Sie die komplette URL des Requests.

7.IR: Mit der Bedingung IR wird es ermöglicht, IR-Signale als Auslöser zu verwenden. Dies funktioniert ausschließlich mit den AIO GATEWAYs V4/V4+/V5/V5+/V6-Serie. Mit anderen IR-basierten Gateways wie dem Harmony Hub geht dies nicht, da diese die empfangenen IR-Signale nicht über das Netzwerk mitteilen.

Aktionen

Dann-Blöcke führen immer Aktionen aus. Sollen beim Eintreten einer Bedingung mehrere Aktionen ausgelöst werden, so können mehrere Dann-Blöcke hintereinander in den Bedingungsblock eingefügt werden. Folgende unterschiedliche Aktionen stehen für Dann-Blöcke zur Verfügung:

1. Geräteaktion: Durch Anklicken des oberen Feldes (gewünschtes Gerät) und des unteren Feldes (jeweilige Aktion) kann die auszuführende Aktion definiert werden. Es sind hierbei alle im AIO CREATOR NEO angelegten Geräte auswählbar, die eine Aktion ausführen können.

2. E-Mail: Hier können Sie eine E-Mail-Adresse und einen Benachrichtigungstext als auszuführende Aktion eintragen. Die so erstellte E-Mail wird auf dem mediola Server hinterlegt und von dort verschickt.

3. Makro:

Durch Anklicken des oberen Feldes (Makrogruppe) und des unteren Feldes (Makro) kann die auszuführende Aktion definiert werden. Es sind hierbei alle angelegten Makros auswählbar.

4. Skript: Hier können Sie ein im Skripteditor gespeichertes Skript als auszuführende Aktion auswählen.

5. HTTP Hier können Sie einen HTTP-Request als Aktion definieren.

6. Warte Hier können Sie eine Pause mit einer definierten Dauer als auszuführende Aktion auswählen.

7. Seitenwechsel In diesem Block können Sie die Seite einer Fernbedienung definieren, zu der automatisch gewechselt wird, sobald das eingestellte Auslöse-Event eintritt.

8. Pop-up In diesem Block können Sie ein Pop-up definieren, zu dem automatisch gewechselt wird, sobald das eingestellte Auslöse-Event eintritt. Unter Einstellungsvorlagen können Sie aus Ihren gespeicherten Pop-up Einstellungsvorlagen wählen, die Sie beim Zuweisen eines Pop-ups zu einem Button festgelegt haben. Hier festgelegt sind Details zum Aufrufen des Pop-ups wie z. B. Einblendzeit, Effekte, Schlagschatten, Abrundungen u. v. m.

9. Audio In diesem Block können Sie Audiodateien über ein Abspielgerät (aktuell nur Sonos) wiedergeben, sobald das eingestellte Auslöse-Event eintritt. Hierbei können z. B. die vorinstallierten Töne vom AIO GATEWAY V6 Plus (benötigt wird Firmware 1.1.5 oder höher) oder vom NEO SERVER (ab Version 2.4.2) verwendet werden, indem unter Quelle AIO GATEWAY/NEO SERVER gewählt wird. Wählen Sie anschließend (anklicken) einen der vorinstallierten Alarmtöne, stellen Sie unter Wiederholen für die Abspieldauer ein und setzen Sie die gewünschte Lautstärke. Alternativ können Sie, wenn Sie als Quelle URL auswählen, auch eigene auf einem Server abgelegte und über URL zugängliche Sounddateien abspielen lassen. Wählen Sie zum Schluss noch das Gerät, auf welchem die Datei abgespielt werden soll (aktuell nur Sonos möglich).

Tasks Speichern und Öffnen

Task-Übersicht

In der Task-Übersicht werden alle gespeicherten Tasks angezeigt und können aktiv oder inaktiv geschaltet werden. Die beiden Spalten „lokal“ und „Server“ zeigen den jeweiligen Aktivierungsstatus eines Task an. Wenn der lokale Aktivierungs-Status geändert wurde, sind beide Status so lange asynchron, bis die Änderungen auf den NEO Server übertragen wurden. Außerdem kann hier ein Task zur Bearbeitung mit dem Blockeditor ausgewählt, der Name des Tasks geändert, der Task dupliziert oder gelöscht werden.

E-Mail-Übersicht

Hier werden Ihnen alle im Rahmen eines Tasks angelegten E-Mail-Benachrichtigungen angezeigt.

Der Skripteditor

Im Skripteditor können individuelle Skripte mittels JavaScript geschrieben werden. In der Menüleiste stehen diverse Optionen (wie Speichern, Öffnen, Status/Aktion einfügen) zur Verfügung.

Wie kann ich Skripte erstellen?

Der Skript-Editor im Automation Manager verwendet JavaScript, das in einer Node.js-Umgebung läuft. Weil dies eine geläufige Skriptsprache ist, die vielfach im Netz dokumentiert ist, gibt es hierzu von unserer Seite keine gesonderte Dokumentation. Die einzigen speziellen Befehle, die für den Automation Manager ergänzt wurden, lassen sich über die Code Snippets zusammenstellen (Status abfragen, Aktion ausführen).

Diese Code-Snippets für Statusabfragen und Aktionen lassen sich bequem über das Menü zusammenklicken.

Systemvariable-Verwaltung im Automation Manager

Nachdem Sie Ihren NEO SERVER / Ihr AIO Gateway V6 Plus/ V5 Plus ausgewählt haben, können Sie die auf diesem SERVER / Gateway bereits angelegten Systemvariablen direkt in NEO bearbeiten / löschen oder neue Systemvariablen anlegen.

Um eine Variable zu bearbeiten, klicken Sie zunächst auf Werte abfragen. Über das Stift-Symbol können Sie jetzt den Wert der Variable im Automation Manager direkt anpassen oder über das Mülleimer-Symbol die Variable löschen.

Über Neue Systemvariable können Sie eine neue Systemvariable auf dem aktuellen NEO SERVER / AIO GATEWAY anlegen.

Automation Manager Beispiele

Zur Verdeutlichung der Vorgehensweise sollen nachfolgend zwei Beispiele kurz erläutert werden. Dabei steht die Beschreibung der Kombinationsmöglichkeiten der Blöcke (und weniger die Sinnhaftigkeit des Beispiels) im Vordergrund.

Unterschiede Automation Manager, Taskmanager V6 bzw. Taskmanager Plus

Der NEO Automation Manager ist ein kostenpflichtiges Plugin für den AIO CREATOR NEO, mit dem die in NEO eingebundenen Smart Home Geräte herstellerübergreifend automatisiert werden können. Der Taskmanager V6 ist Bestandteil der AIO GATEWAYS der V6 Serie und ermöglicht die Erstellung von Tasks zur Automatisierung der an das AIO GATEWAY V6 angelernten Geräte. Da der Taskmanager V6 jedoch ursprünglich für den Einsatz mit IQONTROL NEO konzipiert wurde, stehen hier möglicherweise nicht alle Geräte, die mit dem CREATOR an das V6 angelernt wurden auch im Taskmanager V6 zur Verfügung. Das V5 Plus-Äquivalent dazu ist der Taskmanager Plus. In der Handhabung und dem Aufbau mit grafischem Programmier-Frontend sind Task Manager Plus und NEO Automation Manager sehr ähnlich, während der Taskmanager V6 sich vom Aufbau deutlich unterscheidet.

Mit dem Task Manager V6 und dem Taskmanager Plus können nur Geräte automatisiert werden, die an das AIO GATEWAY V6 Plus bzw. V5 Plus angelernt sind, während die Automatisierung mit dem NEO Automation Manager alle in NEO eingelesenen Geräte beinhaltet, also auch solche Geräte, die sich nicht über das AIO GATEWAY V6 Plus ansteuern lassen. Neben dem graphischen Programmier-Frontend bietet der NEO Automation Manager mit dem Skripteditor auch ein Profi-Frontend, indem mit Hilfe von JavaScript komplexere Skripte selbst erstellt werden. Der Task Manager Plus besitzt keinen Skripteditor.