Mit Hilfe von Befehlen werden u.a. die in der Konfiguration***1000 definierten Einstellungen abgerufen (z.B. eine Email versenden, ein Kamerabild archivieren oder eine Szene abrufen). Mit Hilfe folgender Komponenten werden diese Befehle ausgeführt:
Wichtig:
Die Ausführung mehrerer Befehle erfolgt in der gleichen Reihenfolge wie in der jeweiligen Konfiguration angezeigt (von oben nach unten). Die einzelnen Befehle werden jedoch asynchron ausgeführt, d.h. es wird i.d.R. nicht gewartet bis der vorherige Befehl auch tatsächlich vollständig ausgeführt worden ist.
Hinweis:
Bei Befehlen in Sequenzen***1000-90 kann eine Wartezeit (in Sekunden) bis zur Ausführung des nächsten Befehls angegeben werden.
Befehl
Beschreibung
Ausgangsboxen
Hinweis:
Diese Befehle sind nur für Ausgangsboxen***lbs_12000010 verfügbar. Die Ausführung des Befehls hängt vom Typ der Ausgangsbox und dessen Belegung ab.
KO: Eingangswert (Ausgangsbox) zuweisen
Das ausgewählte KO***1000-30 wird bei jedem neuen Telegramm am Eingang einer Ausgangsbox ggf. auf diesen Wert gesetzt.
Bei jedem neuen Telegramm am Eingang einer Ausgangsbox wird dieser Wert ggf. im ausgewählten Datenarchiv***1000-50 archiviert.
Der Zeitstempel des Archiveintrags kann optional angepasst werden, z.B. um im Tagesverlauf summierte Werte rückwirkend zu archivieren.
Bei jedem neuen Telegramm am Eingang einer Ausgangsbox wird dieser Wert ggf. im ausgewählten Meldungsarchiv***1000-60 archiviert.
Der Zeitstempel des Archiveintrags kann optional angepasst werden, z.B. um eine Meldung rückwirkend zu archivieren.
Kommunikationsobjekte
KO: Wert zuweisen
Das ausgewählte KO***1000-30 wird auf den angegebenen Wert gesetzt.
KO: Wert addieren
Der aktuelle Wert des ausgewählten KOs***1000-30 wird mit dem angegebenen Wert addiert (eine Subtraktion kann durch einen negativen Wert erreicht werden).
KO: Wert eines anderen KOs zuweisen
Das ausgewählte KO***1000-30 wird auf den aktuellen Wert eines anderen KOs gesetzt (es erfolgt kein(!) Read-Request).
KO: Wechseln zwischen 0 und Wert
Der aktuelle Wert des ausgewählten KOs***1000-30 wechselt beim jedem Aufruf dieses Befehls zwischen 0 und dem angegebenen Wert in Abhängigkeit vom aktuellen Wert des KOs (0 oder ≠0).
KO: Wechseln zwischen 0 und 1 (mit Status-KO)
Der aktuelle Wert des ausgewählten KOs***1000-30 wechselt beim jedem Aufruf dieses Befehls zwischen 0 und 1 in Abhängigkeit vom Wert des angegebenen Status-KOs (0 oder ≠0).
KO: Rasterwert addieren/subtrahieren
Der aktuelle Wert des ausgewählten KOs***1000-30 wird mit dem Raster-Wert des KOs addiert.
KO: Wertliste vor/zurück
Der aktuelle nummerische Wert des ausgewählten KOs***1000-30 wird auf einen Vorgänger/Nachfolger-Wert aus der konfigurierten Wertliste gesetzt.
Eine Schrittweite >0 führt zur Auswahl eines nachfolgenden Wertes, eine Schrittweite <0 zur Auswahl eines vorherigen Wertes.
Beispielweise führt eine Schrittweite von 3 zur Auswahl des dritten nachfolgenden Wertes aus der Wertliste. Ist der Anfang oder das Ende der Wertliste erreicht, wird der KO-Wert nicht verändert (das KO wird jedoch erneut auf den aktuellen Wert gesetzt).
Hinweis: Weitere Informationen zur Verwendung der Wertliste sind in der Hilfe zur KO-Konfiguration***1000-30 verfügbar.
KO: Abfragen (Read-Request)
Der aktuelle Wert des ausgewählten KOs***1000-30 wird vom KNX-Bus abgefragt (Read-Request), sofern eine entsprechend konfigurierte KNX-Gruppenadresse***1000-32 angegeben wurde.
Hinweis: Es wird nicht(!) auf die Antwort (Response) des Read-Requests gewartet. Das KNX-Endgerät wird bei korrekter Konfiguration (L-Flag) asynchron antworten.
Visualisierungen
Hinweis:
Die nachfolgenden Befehle werden asynchron an die Visualisierung übermittelt, d.h. in Abhängigkeit vom festgelegten Intervall in der Basis-Konfiguration***a-1 werden diese Befehle u.U. geringfügig verzögert ausgeführt.
Hinweis zur Tonausgabe/Sprachausgabe:
Auf einigen Endgeräten (z.B. iOS-basierten Geräten) ist unter Umständen die Tonausgabe und/oder die Sprachausgabe erst dann verfügbar, wenn diese einmalig mit einem Klick (Nutzerinteraktion) aktiviert wurde. In diesem Fall wird am oberen Bildschirmrand die Meldung "Tonausgabe aktivieren" angezeigt und sollte mit einem Klick bestätigt werden (siehe auch Visualisierung***b-0).
Visu/Visuaccount: Visuseite/Popup aufrufen
Die ausgewählte Visuseite***1000-22 (bzw. das Popup) wird auf allen Endgeräten aufgerufen, die mit dem gewählten Visuaccount***1000-23 in die zugehörige Visualisierung eingeloggt sind.
Wird kein Visuaccount angegeben, wird die ausgewählte Visuseite auf allen Endgeräten aufgerufen, die in die zugehörige Visualisierung mit einem beliebigen Account eingeloggt sind.
Visu/Visuaccount: Popup schließen
Das ausgewählte Popup wird auf allen Endgeräten geschlossen, die mit dem gewählten Visuaccount***1000-23 in die zugehörige Visualisierung eingeloggt sind.
Wird kein Visuaccount angegeben, wird das ausgewählte Popup auf allen Endgeräten geschlossen, die in die zugehörige Visualisierung mit einem beliebigen Account eingeloggt sind.
Hinweis: Ist die ausgewählte Visuseite***1000-22 kein Popup, wird dieser Befehl bei der Ausführung wirkungslos bleiben.
Visu/Visuaccount: Alle Popups schließen
In der ausgewählten Visualisierung werden alle Popups auf allen Endgeräten geschlossen, die mit dem gewählten Visuaccount***1000-23 in die zugehörige Visualisierung eingeloggt sind.
Wird kein Visuaccount angegeben, werden die Popups auf allen Endgeräten geschlossen, die in die zugehörige Visualisierung mit einem beliebigen Account eingeloggt sind.
Visu: Ton abspielen
Der ausgewählte Ton***1000-29 wird auf allen Endgeräten abgespielt, die in die ausgewählte Visualisierung***1000-21 mit einem beliebigen Account eingeloggt sind.
Wird kein Ton angegeben, wird eine laufende Ton-Wiedergabe abgebrochen.
Visuaccount: Ton abspielen
Der ausgewählte Ton***1000-29 wird auf allen Endgeräten abgespielt, die mit dem ausgewählten Visuaccount***1000-23 in eine beliebige Visualisierung eingeloggt sind.
Wird kein Ton angegeben, wird eine laufende Ton-Wiedergabe abgebrochen.
Visu: Sprachausgabe
Der angegebene Text wird auf allen Endgeräten per Sprachausgabe vorgelesen, die in die ausgewählte Visualisierung***1000-21 mit einem beliebigen Account eingeloggt sind.
Der Text kann folgende Variablen enthalten:
"{id}": Repräsentiert den Wert eines KOs mit dieser ID
z.B. "Es ist {5} Uhr" wird zu "Es ist 12:00:00 Uhr" (Systemzeit)
Hinweis: Existiert das KO nicht, wird der Ausdruck unverändert ausgegeben.
"{x/y/z}": Repräsentiert den Wert einer KNX-GA
z.B. "Die Temperatur beträgt {1/2/3} Grad" wird zu "Die Temperatur beträgt 21 Grad"
Hinweis: Existiert die KNX-GA nicht, wird der Ausdruck unverändert ausgegeben.
Optional können folgende Parameter vor dem Text angegeben und mit "***" abgeschlossen werden "<Sprache>/<Geschwindigkeit>/<Tonhöhe>***Text...":
Sprache:
de-DE: Deutsch
en-US: Englisch
es-ES: Spanisch
fr-FR: Französisch
Geschwindigkeit: ein Wert zwischen 0.1 und 10 (Standard ist 1)
Tonhöhe: ein Wert zwischen 0 und 2 (Standard ist 1)
Hinweis:
Es sind stets alle oder keine Parameter anzugeben! Ohne die Angabe von Parametern werden die Standardeinstellungen des Browser oder die zuletzt verwendeten Parameter (auch die des Visuelements Sprachausgabe***1002-31) angewendet.
Beispiele:
"de-DE/1/0.5***Dies ist ein Test": Der Text wird auf Deutsch mit der Geschwindigkeit 1 und der Tonhöhe 0.5 vorgelesen.
"Dies ist ein Test": Der Text wird mit den Standardeinstellungen des Browsers oder den zuletzt verwendeten Parametern vorgelesen.
Visuaccount: Sprachausgabe
Der angegebene Text wird auf allen Endgeräten per Sprachausgabe vorgelesen, die mit dem ausgewählten Visuaccount***1000-23 in eine beliebige Visualisierung eingeloggt sind.
(Variablen und Parameter wie beim Befehl "Visu: Sprachausgabe")
Visu/Visuaccount: Logout
Alle Endgeräte, die in die ausgewählte Visualisierung***1000-21 mit dem ausgewählten Visuaccount***1000-23 eingeloggt sind, werden aus der Visualisierung ausgeloggt.
Wird keine Visualisierung angegeben, sind sämtliche Visualisierungen betroffen in die die Endgeräte mit dem gewählten Visuaccount eingeloggt sind.
Wird kein Visuaccount angegeben, sind sämtliche Visualisierungen betroffen in die die Endgeräte mit einem beliebigen Visuaccount eingeloggt sind.
Ggf. wird das Status-KO des Visuaccounts (bzw. aller Visuaccounts) auf den Wert 0 gesetzt (dies wird u.U. einige Sekunden verzögert erfolgen).
Hinweis: Werden weder eine Visualisierung noch ein Visuaccount angegeben, werden alle Endgeräte aus allen Visualisierungen ausgeloggt.
Archive
Datenarchiv: Wert hinzufügen
Der angegebene Wert wird im ausgewählten Datenarchiv***1000-50 archiviert.
Datenarchiv: Eintrag entfernen
Ein oder mehrere Einträge werden aus dem ausgewählten Datenarchiv***1000-50 entfernt (gelöscht):
neusten Eintrag entfernen: der aktuellste Eintrag wird aus dem Archiv entfernt
ältesten Eintrag entfernen: der älteste Eintrag wird aus dem Archiv entfernt
alle Einträge entfernen: das Archiv wird vollständig geleert
Meldungsarchiv: Meldung hinzufügen
Der angegebene Wert wird im ausgewählten Meldungsarchiv***1000-60 archiviert.
Die Meldung kann folgende Variablen enthalten:
"{id}": Repräsentiert den Wert eines KOs mit dieser ID
z.B. "Es ist {5} Uhr" wird zu "Es ist 12:00:00 Uhr" (Systemzeit)
Hinweis: Existiert das KO nicht, wird der Ausdruck unverändert ausgegeben.
"{x/y/z}": Repräsentiert den Wert einer KNX-GA
z.B. "Die Temperatur beträgt {1/2/3} Grad" wird zu "Die Temperatur beträgt 21 Grad"
Hinweis: Existiert die KNX-GA nicht, wird der Ausdruck unverändert ausgegeben.
Meldungsarchiv: Meldung entfernen
Ein oder mehrere Meldungen werden aus dem ausgewählten Meldungsarchiv***1000-60 entfernt (gelöscht):
neuste Meldung entfernen: die aktuellste Meldung wird aus dem Archiv entfernt
älteste Meldung entfernen: die älteste Meldung wird aus dem Archiv entfernt
alle Meldungen entfernen: das Archiv wird vollständig geleert
Kameraarchiv: Kamerabild hinzufügen
Das aktuelle Livebild einer Kamera wird im ausgewählten Kameraarchiv***1000-82 archiviert.
Hinweis: Die Zuweisung der Kamera***1000-81 erfolgt im Kamerarchiv selbst.
Kameraarchiv: Kamerabild entfernen
Ein oder mehrere Kamerabilder werden aus dem ausgewählten Kameraarchiv***1000-82 entfernt (gelöscht):
neustes Kamerabild entfernen: das aktuellste Kamerabild wird aus dem Archiv entfernt
ältestes Kamerabild entfernen: das älteste Kamerabild wird aus dem Archiv entfernt
alle Kamerabilder entfernen: das Archiv wird vollständig geleert
Hinweis: Die eigentlichen Bilddateien werden erst bei einem EDOMI-Neustart, täglich um 00:00:00 Uhr oder bei einer Projekt-Aktivierung gelöscht.
Anrufarchiv: Eintrag entfernen
Ein oder mehrere Einträge werden aus dem ausgewählten Anrufarchiv***1000-127 entfernt (gelöscht):
neusten Eintrag entfernen: der aktuellste Eintrag wird aus dem Archiv entfernt
ältesten Eintrag entfernen: der älteste Eintrag wird aus dem Archiv entfernt
alle Einträge entfernen: das Archiv wird vollständig geleert
Sonstiges
Szene: Abrufen/lernen
Die ausgewählte Szene***1000-40 wird abgerufen bzw. angelernt.
Sequenz: Abrufen/stoppen
Die ausgewählte Sequenz***1000-90 wird abgerufen (ausgeführt) bzw. gestoppt (abgebrochen).
Hinweis: Wird eine Sequenz, die aktuell ausgeführt wird erneut abgerufen, wird dieser Befehl ignoriert (eine "laufende" Sequenz wird nicht neugestartet).
Makro: Ausführen
Das ausgewählte Makro***1000-95 wird ausgeführt.
HTTP/UDP/SHELL: Ausführen
Der ausgewählte HTTP/UDP/SHELL-Befehl***1000-70 wird ausgeführt.
Hinweis: Die Ausführung wird in einer Warteschlange organisiert, d.h. der Befehl wird u.U. nicht unmittelbar ausgeführt.
IR-Befehl: Senden
Der ausgewählte IR-Befehl***1000-75 wird über den gewählten Kanal gesendet (Modul "IRtrans***a-1-4" erforderlich).
Kanal 1: i.d.R. die interne IR-LED des IRtrans
Kanal 2: die optionalen externen IR-LEDs des IRtrans
Hinweis: Die Ausführung wird in einer Warteschlange organisiert, d.h. der Befehl wird u.U. nicht unmittelbar ausgeführt.
Email: Senden
Die ausgewählte Email***1000-120 wird gesendet.
Hinweis: Die Ausführung wird in einer Warteschlange organisiert, d.h. der Befehl wird u.U. nicht unmittelbar ausgeführt.
Telefonbucheintrag: Anrufen/auflegen
Der ausgewählte Telefonbucheintrag***1000-125 wird für die angegebene Anrufdauer angerufen (Modul "Telefonie-Gateway***a-1-2" erforderlich). Wird kein Telefonbucheintrag ausgewählt, wird eine ggf. bestehende Verbindung beendet ("auflegen").
Anrufdauer "unendlich": der Telefonbucheintrag wird angerufen, die Verbindung bleibt dauerhaft bestehen
Anrufdauer (Zeitangabe): der Telefonbucheintrag wird angerufen, die Verbindung wird nach der ausgewählten Zeit wieder beendet
Hinweis: Die Ausführung wird in einer Warteschlange organisiert, d.h. der Befehl wird u.U. nicht unmittelbar ausgeführt.
Wichtig:
Die Funktion "Auflegen" ist nur in Kombination mit einem vorherigen Anruf von "unendlicher Dauer" wirksam. Wird eine bestimmte Anrufdauer angegeben, bleibt das Auflegen ohne Wirkung, da dieser Befehl erst nach Ablauf der definierten Anrufdauer ausgeführt wird (der Anruf ist jedoch dann ohnehin bereits beendet).
EDOMI: Steuerung
Ermöglicht das Steuern von EDOMI***0-0 bzw. das Erstellen eines Autobackups***a-3.
Hinweis: Die Ausführung wird in einer Warteschlange organisiert, d.h. der Befehl wird u.U. nicht unmittelbar ausgeführt.