Owl Automata logo
  • Home
  • About Us
  • Services
  • Products
    Hotel As a Service
    Chameleon+
    Chameleon+From Room Design to Complete ETS Project - hotel automation made simple
    Fire Ant
    Fire AntAutomate the Tedious. Focus on What Matters
    Explore the HaaS concept
    Apps & Tools
    Pro Builder Ecosystem
    Pro Builder
    Pro BuilderETS app for importing generated .knxproj files into ETS.
    Application Template
    Application TemplateMicroapp for extracting, reusing, and sharing KNX application templates.
    SharkNX
    SharkNXConnect. Monitor. Control. ETS Mobile Toolkit on the Go
    View all products
  • Resources
  • Insights
  • Contact
Current versionv1.18.2
LanguageEnglishDeutschFrançaisEspañolItaliano
Documentation home

Erste Schritte mit SharKNX

Der SharKNX-AssistentETS-Projekte in SharKNXKNX Data SecureKNX IP SecureDas Shark-Hunt-Konzept

Aliase und Skripte des Assistenten verwendenVerbindung zu einem KNX-Gateway herstellenEinen Shark Hunt erstellenTelegramme exportierenKommunikationsobjekte eines Geräts auslesenEin ETS-Projekt ladenDie Physikalische Adresse eines Geräts programmierenDie Filtertabelle eines Kopplers lesenEine KNX-Buslinie scannenKNX-Befehle sendenKNX Data Secure einrichtenKNX IP Secure einrichtenDen Assistenten verwenden

ProjektverbindungenSeite VerbindenSeite DiagnoseDie Monitor-SeiteDie ProjektseiteDie Einstellungen-SeiteDie Shark-Hunts-SeiteSeite Assistent

Befehle des AssistentenDateiformat für Aliase und SkripteDashboard-DateiformatExportformateHäufig gestellte FragenGrenzwerteSeitenmenü und AktionenMonitor-FiltersyntaxEinstellungen - ReferenzAbonnementpläneUnterstützte Datapoint Types (DPTs)
Anleitung

Aliase und Skripte des Assistenten verwenden

Lehren Sie dem SharKNX-Assistenten Ihre eigenen Namen für KNX-Gruppenadressen, Gruppen und Anfragen und speichern Sie Befehlssequenzen als Skripte - erstellen Sie sie in der App oder importieren Sie eine YAML-Datei.

Auf dieser Seite
  1. Arten von Alias
  2. Erstellen Sie einen Alias ​​in der App
  3. Aliase und Skripte aus einer Datei importieren
  4. Führen Sie ein Skript aus
  5. Verwalten Sie Aliase und Skripte
  6. Fehlerbehebung

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

  1. Laden Sie das ETS-Projekt, für das der Alias ​​bestimmt ist - siehe Ein ETS-Projekt laden.
  2. Öffnen Sie im Assistenten ☰ → Einstellungen → Erstellen.
  3. Geben Sie ein Name ein - die Wörter, die Sie im Chat verwenden werden.
  4. 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.
  5. 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.

Erstellungsdialog mit dem Namen Floor one temperature, ausgewähltem Typ Gruppe und 2 ausgewählten Adressen set Floor one temperature to 22 wird zu einem Plan, der 22 an 0/2/0 und 0/2/1 schreibt und auf eine starke Bestätigung wartet

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: true Vorrang 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.

  1. 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.
  2. 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.
  3. 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.
  4. Öffnen Sie ☰ → Einstellungen → Importieren und tippen Sie auf YAML-Datei importieren.
  5. Ü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.
  6. 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.

Importieren Sie das Blatt nach einem erfolgreichen Import mit der Schaltfläche „Eine YAML-Datei importieren“ und einer Datei im Verlauf mit 3 Aliasen und 1 Skript

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.
Verwalten, Registerkarte „Aliase“: ein Adressalias mit „Bearbeiten“, „Duplizieren“ und „Löschen“, ein Raumalias und eine Phrase mit „Löschen festlegen“ und „Erneut exportieren“. Verwalten, Registerkarte Skripte: das Skript myTestStart mit connect, monitor start und scan 1.1, verbunden durch Semikolons

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.
ZurückDas Shark-Hunt-KonzeptWeiterVerbindung zu einem KNX-Gateway herstellen

Auf dieser Seite

  1. Arten von Alias
  2. Erstellen Sie einen Alias ​​in der App
  3. Aliase und Skripte aus einer Datei importieren
  4. Führen Sie ein Skript aus
  5. Verwalten Sie Aliase und Skripte
  6. Fehlerbehebung

← SharKNX product page

logo

Solutions

  • Services
  • Products
  • HaaS

Company

  • About Us
  • Contact

Legal

  • Privacy Policy
  • Cookie Policy
  • Terms & Conditions

Contact

  • info@owl-automata.com
  • Athens, Greece

© 2026 OWL-Automata.com. All rights reserved OWL Automata

  • Terms & Conditions
  • Privacy Policy
  • Cookie Policy