ETS-Namen sind oft kryptisch - LI_EG_KÜ_Decke_1 - und einige Anfragen stellen Sie jeden Tag. Aliasse bringt dem SharKNX-Assistenten Ihre eigenen Wörter für Adressen und Anfragen bei und Skripte speichern Befehlssequenzen, die Sie nach Namen ausführen können.
| Aliase | Skripte | |
|---|---|---|
| Was | Ihre eigenen Namen für Gruppenadressen, Adressgruppen und Anfragen | Benannte Sequenzen exakter Befehle |
| Verwendet in | Eingabeaufforderungen in Klartext: turn off exterior lights | Genaue Befehle: sharknx secure house |
| Gehören zu | Ein ETS-Projekt - nur aktiv, während es geladen ist | Kein Projekt - immer aktiv |
| Erstellt | In der App oder durch Importieren einer YAML-Datei | Durch Importieren einer YAML-Datei |
Arten von Alias
| Art | Gibt | Beispiel |
|---|---|---|
| Phrase | Eine Abkürzung für eine längere Anfrage | good night führt turn all kitchen lights off aus |
| Adresse | Ein Name für eine Gruppenadresse | reading lamp für 1/2/3 - turn on the reading lamp |
| Gruppe | Ein Name für mehrere Gruppenadressen | exterior lights für jede Außenleuchte - turn off exterior lights schaltet sie alle |
| Raum | Ein eigener Raum, in dem jede Adresse als Licht, Jalousie, Temperatur usw. eingegeben wird | set home office temperature to 21 ändert nur die Temperaturadressen dieses Raums. Räume können nur aus einer Datei importiert werden - siehe Dateiformat für Aliase und Skripte. |
Eine Phrase durchläuft den Assistenten wie jede andere Anfrage, mit der gleichen Klärung und Bestätigung. Das Schreiben an eine Gruppe erfordert immer eine starke Bestätigung, da an mehrere Adressen gleichzeitig geschrieben wird.
Erstellen Sie einen Alias in der App
- Laden Sie das ETS-Projekt, für das der Alias bestimmt ist - siehe Ein ETS-Projekt laden.
- Öffnen Sie im Assistenten ☰ → Einstellungen → Erstellen.
- Geben Sie ein Name ein - die Wörter, die Sie im Chat verwenden werden.
- Wählen Sie den Typ:
- Phrase - Geben Sie die Anforderung ein, die es ausführt, z. B. turn off all kitchen lights.
- Adresse - Tippen Sie auf Adresse wählen und wählen Sie eine Gruppenadresse aus dem Projekt aus.
- Gruppe - tippen Sie auf Adressen wählen und wählen Sie mehrere aus. Sie müssen alle denselben Datenpunkttyp haben, da eine Gruppe in alle einen Wert schreibt.
- Tippen Sie auf Speichern.
Verwenden Sie es sofort - für eine Gruppe mit dem Namen Floor one temperature schreibt set Floor one temperature to 22 nach Ihrer Bestätigung 22 an jede darin enthaltene Adresse.
Ein Name darf nicht zweimal verwendet werden. Wenn es mit einem Namen in Ihrem ETS-Projekt übereinstimmt, fragt der Assistent, welchen Namen Sie meinen - ein importierter Alias kann mit
override: trueVorrang haben.
Aliase und Skripte aus einer Datei importieren
Eine YAML-Datei enthält viele Aliase und Skripte gleichzeitig - praktisch für ein großes Projekt, für Räume und Skripte oder zum Teilen mit Kollegen.
- Holen Sie sich eine Startdatei: Öffnen Sie im Assistenten ☰ → Hilfe → Aliase & Skripte und tippen Sie auf Vorlage herunterladen. Es enthält für alles ein Beispiel, wobei jedes Feld erklärt wird.
- Bearbeiten Sie es: Ersetzen Sie die Beispielnamen und -adressen durch Ihre eigenen und löschen Sie, was Sie nicht benötigen. Jedes Feld wird in Dateiformat für Aliase und Skripte beschrieben.
- Laden Sie das ETS-Projekt, für das die Aliase bestimmt sind. Eine Datei mit Aliasnamen kann nicht ohne Aliase importiert werden. Eine reine Skriptdatei kann.
- Öffnen Sie ☰ → Einstellungen → Importieren und tippen Sie auf YAML-Datei importieren.
- Überprüfen Sie den Import prüfen-Bericht:
- Darin steht, mit welchem Projekt die Aliase verknüpft werden.
- Vor dem Import beheben: listet Fehler auf, wenn möglich mit der Zeile. Korrigieren Sie die Datei und importieren Sie sie erneut.
- Gut zu wissen: listet Warnungen auf - beispielsweise eine Adresse, die nicht im geladenen Projekt enthalten ist. Sie können weiterhin importieren.
- Nicht in dieser Datei listet Aliase auf, die Sie jetzt haben, da die Datei sie nicht mehr enthält. Aktivieren Sie Beibehalten, um sie zu den importierten Aliasnamen hinzuzufügen. andernfalls werden sie entfernt.
- Tippen Sie auf Importieren.
Durch das Importieren von Aliasen wird der Aliassatz des Projekts ersetzt. Skripte werden zu Ihren Skripten hinzugefügt; Ein Skript mit demselben Namen wie ein vorhandenes ersetzt es. Ein erneuter Import derselben Datei ändert nichts.
Importierte Dateien werden unter Verlauf mit ihrem Alias und der Skriptanzahl aufgelistet - tippen Sie auf eine, um sie erneut zu importieren, beispielsweise nach einem Projektwechsel.
Führen Sie ein Skript aus
Geben Sie sharknx und den Namen des Skripts ein, zum Beispiel sharknx secure house - oder sharknx run secure house. Das Skript läuft als Plan: SharKNX zeigt seine Schritte an und bittet um Bestätigung, wo ein Schritt sie benötigt. Fügen Sie -y hinzu, um normale Bestätigungen zu überspringen; Schritte, die eine starke Bestätigung erfordern, werden dennoch gemeinsam bestätigt, bevor das Skript startet.
Skriptzeilen sind exakte Befehle mit Literaladressen - siehe Befehle des Assistenten.
Verwalten Sie Aliase und Skripte
Öffnen Sie ☰ → Einstellungen → Verwalten. (Die Karte oben in Assistent-Einstellungen zeigt bereits, wie viele Aliase und Skripte aktiv sind und aus welcher Datei sie stammen.)
Registerkarte Aliasse - die Aliase des geladenen Projekts:
- Der Schalten schaltet einen Alias aus oder ein, ohne ihn zu löschen. Ein in der Datei selbst deaktivierter Alias zeigt In der Datei deaktiviert an.
- Bearbeiten, Duplizieren und Löschen ändern einen Alias. Räume können nur in der Datei geändert werden.
- Set löschen entfernt jeden Alias des geladenen Projekts. Sie können die Datei erneut aus dem Verlauf importieren.
- Erneut exportieren speichert die Aliase des Projekts - einschließlich der von Ihnen in der App erstellten - als YAML-Datei.
Registerkarte Skripte - jedes Skript mit seinen Befehlszeilen:
- Der Schalten schaltet ein Skript aus oder ein.
- Skript löschen entfernt ein Skript; Die Schaltfläche neben einem Dateinamen entfernt jedes Skript aus dieser Datei.
Aliase, die Sie in der App erstellen, werden der Aliasdatei des Projekts hinzugefügt. Wenn eine importierte Datei eine Änderung nicht ohne Neuformatierung übernehmen kann, werden Sie von SharKNX aufgefordert, die Änderung in der Datei vorzunehmen und sie erneut zu importieren.
Fehlerbehebung
| Problem | Was zu überprüfen ist |
|---|---|
| Erstellen sagt ETS-Projekt muss geladen sein | Aliase gehören zu einem Projekt - laden Sie es zuerst. |
| Aliase funktionieren nicht | Sie sind nur aktiv, solange ihr Projekt geladen ist. Auf der Karte „Einstellungen“ ist angegeben, zu welchem Projekt sie gehören. |
| This project's alias file could not be read | Importieren Sie die Datei erneut. |
| These addresses don't share one DPT type | Eine Gruppe schreibt einen Wert an alle ihre Adressen - wählen Sie Adressen eines Datenpunkttyps aus. |
| Ein Aliasname stimmt auch mit einem Projektnamen überein | Der Assistent fragt, was Sie meinen. Legen Sie in einer Datei override: true fest, damit der Alias gewinnt. |
| Ein Skriptname wird abgelehnt | Skriptnamen dürfen nicht mit einem integrierten Befehl wie connect oder scan identisch sein. |