Monitor-Filtersyntax

Das Suchfeld auf der Seite Überwachen bietet mehr als nur die Suche nach Text. Es versteht eine kleine Filtersprache, sodass Sie genaue KNX-Fakten – Gruppenadressen, Absender, Telegrammdienste, Priorität, Hop-Anzahl, dekodierte Werte – abgleichen und mit UND, ODER und NICHT kombinieren können. Diese Seite ist die vollständige Referenz.

Durch die Anwendung eines Filters wird jedes Telegramm, das sich bereits im Monitor befindet, einmal überprüft; Neue Telegramme werden dann bei Eintreffen überprüft. Der Filter ändert nur das, was Sie sehen – nichts wird gelöscht.

Kurze Beispiele

Lassen Sie die Kommissionierer Filter für Sie erstellen

Sie müssen keine Filter eingeben. Mit der Schaltfläche Suchen neben dem Feld (Gruppenadressen und Geräte aus Ihrem ETS-Projekt) und Ansicht → Gruppe anzeigen in der Badge-Zeile (Adressen, Telegrammtypen, Priorität) werden diese für Sie erstellt. Wenn Sie einen Absender auswählen, erhalten Sie src:1.1.5, bei Dringend erhalten Sie priority:urgent und so weiter.

Wenn ein Filter bereits aktiv ist, fragt SharKNX, wie der neue hinzugefügt werden kann:

Bei AND oder OR wird der aktuelle Filter in Klammern gesetzt, sodass seine Bedeutung erhalten bleibt – zum Beispiel wird ga:1/2/* | ga:2/1/* plus Dringend mit AND zu:

(ga:1/2/* | ga:2/1/*) + priority:urgent

Das Ergebnis erscheint im Suchfeld, sodass Sie es sehen, bearbeiten und erneut anwenden können. Löschen entfernt den Filter und den Text.

Textsuche

Beim Klartext handelt es sich um eine Suche ohne Berücksichtigung der Groß-/Kleinschreibung über alles, was in einer Zeile angezeigt wird: Quell- und Zieladresse, Gruppenadressenname und -beschreibung, Telegrammtyp, dekodierter Wert, Nutzdaten-Hexadezimalwert, Priorität und die Bezeichnungen von Busereignissen.

read

Dies ist bewusst weit gefasst – es entspricht einem GroupValueRead, einer Gruppenadresse namens Read request oder einem Wert, der read enthält. Für einen genauen Telegrammtyp verwenden Sie stattdessen apci:.

Leerzeichen bedeuten nicht UND. living room sucht nach dem Ausdruck Wohnzimmer. Um zwei Bedingungen zu kombinieren, verwenden Sie +.

Gruppenadressen: ga:

1/2/3
1/2/*
ga:1/*/*
1/515

Eine reine Gruppenadresse funktioniert eigenständig; Das Präfix ga: macht es explizit, was bei längeren Filtern klarer ist. ga: stimmt nur mit Telegrammen überein, die an eine Gruppenadresse gesendet werden.

• 3-Ebene: Haupt-0-31, Mittel-0-7, Unter-0-255
• 2-Ebene: Haupt-0-31, Unter-0-2047
• Ein Platzhalter * muss einen ganzen Teil ersetzen: 1/2/* funktioniert, 1/2/2* nicht.

Beim Abgleich wird der Rohwert der Adresse verwendet, sodass 1/2/3 und 1/515 dieselbe Adresse sind. Wenn die Anzeige zwischen der 2-Ebene und der 3-Ebene umgeschaltet wird, ändern sich die Ergebnisse nie.

Absender: src:

1.1.5
1.1.*
src:1.*.*

Eine bloße Einzeladresse funktioniert für sich allein; src: macht es explizit. Es entspricht immer dem Absender eines Telegramms, niemals seinem Ziel.

• Bereich 0-15, Linie 0-15, Gerät 0-255
• Ein Platzhalter * muss einen ganzen Teil ersetzen.

Telegrammtyp: apci:

apci:GroupValueRead
apci:GroupValueResponse
apci:GroupValueWrite

Verwenden Sie den vollständigen Dienstnamen. Die Groß- und Kleinschreibung spielt keine Rolle, apci:read wird jedoch abgelehnt. Für einen Dienst ohne Namen verwenden Sie seinen Code im Hexadezimalformat, von 0x0 bis 0x3FF:

apci-code:0x155

Priorität und Hop-Anzahl

priority:system
priority:urgent
priority:normal
priority:low
hop:3

Die hohe Priorität von KNX wird als „dringend“ bezeichnet – priority:high wird abgelehnt. Die Hop-Anzahl ist eine ganze Zahl von 0 bis 7.

Dekodierte Werte: value

value>20
value<20
value>=20
value<=20
value>=-2.5

• Nur Telegramme mit einem dekodierten Zahlenwert stimmen überein – laden Sie Ihr ETS-Projekt, damit Werte dekodiert werden können.
• Verwenden Sie einen Punkt für Dezimalzahlen (1.5), unabhängig von der Sprache Ihres Telefons.
• Keine Einheiten, keine wissenschaftliche Schreibweise (1e3) und kein = – für einen genauen Wert verwenden Sie value>=20 + value<=20.
• Werte werden unabhängig von ihrem Datenpunkttyp als Zahlen verglichen. Kombinieren Sie daher eine Wertbedingung mit einer Gruppenadresse, um ihre Bedeutung klar zu halten:

ga:1/2/3 + value>=20

Busereignisse: kind:

Neben Telegrammen zeichnet der Monitor auch andere Beobachtungen auf. Filtern Sie sie nach Art:

Leerzeichen, Bindestriche, Unterstriche und Großschreibung spielen keine Rolle: kind:Bus Control funktioniert auch.

Bedingungen kombinieren

NICHT bindet am stärksten, dann UND, dann ODER. Also:

kind:gap | priority:urgent + hop:3

bedeutet eine Lücke oder ein dringendes Telegramm mit Hop-Anzahl 3. Fügen Sie im Zweifelsfall Klammern hinzu:

ga:1/2/* + (apci:GroupValueWrite | apci:GroupValueResponse)
(src:1.1.* | src:1.2.*) + value>=20

!(value>20) zeigt auch Zeilen ohne einen dekodierten Wert an, da NOT das Ergebnis einfach invertiert.

Suche nach Sonderzeichen

Um nach Text zu suchen, der +, |, ! oder Klammern enthält, setzen Sie ihn in doppelte Anführungszeichen:

"Alarm + Hall"
"Status (North)"

Schreiben Sie ein Zitat in einen zitierten Text als \" und einen Backslash als \\. Anführungszeichen erzwingen auch eine Nur-Text-Suche nach allem, was wie ein Filter aussieht, wie z. B. "unknown:value".

Wenn ein Filter abgelehnt wird

Wenn ein Filter nicht verstanden werden kann, zeigt SharKNX den Fehler und seine Position unterhalb des Suchfelds an. Der letzte gültige Filter bleibt aktiv, sodass sich die Liste nicht ändert, bis Sie den Text korrigieren und erneut anwenden.

Ein gültiger Filter zeigt nichts an?

• Ist die Adresse ein Absender (src:) oder eine Gruppenadresse (ga:)?
• Haben die Telegramme einen dekodierten Wert? Laden Sie das ETS-Projekt.
• Ist der Name apci: vollständig?
• Benötigt AND/OR Klammern?
• 1/2/3 1.1.5 ist eine Textsuche, nicht zwei Bedingungen – schreiben Sie ga:1/2/3 + src:1.1.5.

Nicht dasselbe wie Shark Hunt-Filter

Shark Hunt Benutzerdef. Monitor-Aktionen verwenden Bedingungen, die Sie in einem Formular erstellen (bis 10, verknüpft mit AND oder OR), nicht diese typisierte Syntax. Siehe Einen Shark Hunt erstellen.