Sintassi dei filtri del monitor

Il campo di ricerca nella pagina Monitor fa molto di più che trovare testo. Comprende un piccolo linguaggio di filtro, quindi puoi abbinare i fatti KNX esatti - indirizzi di gruppo, mittenti, servizi di telegramma, priorità, conteggio hop, valori decodificati - e combinarli con AND, OR e NOT. Questa pagina è il riferimento completo.

L'applicazione di un filtro controlla una volta ogni telegramma già presente nel monitor; i nuovi telegrammi vengono poi controllati man mano che arrivano. Il filtro modifica solo ciò che vedi: nulla viene eliminato.

Esempi rapidi

Lascia che i selezionatori creino filtri per te

Non è necessario digitare filtri. Il pulsante Cerca accanto al campo (indirizzi di gruppo e dispositivi dal tuo progetto ETS) e Visualizza → Visualizza Gruppo nella riga del badge (indirizzi, tipi di telegrammi, priorità) li crea per te: scegliendo un mittente dà src:1.1.5, scegliendo Urgente dà priority:urgent e così via.

Se un filtro è già attivo, SharKNX chiede come aggiungere quello nuovo:

Con AND o OR, il filtro corrente viene racchiuso tra parentesi in modo che il suo significato venga mantenuto, ad esempio ga:1/2/* | ga:2/1/* più Urgente con AND diventa:

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

Il risultato viene visualizzato nel campo di ricerca, quindi puoi vederlo, modificarlo e applicarlo nuovamente. Cancella rimuove il filtro e il testo.

Ricerca testuale

Il testo normale è una ricerca senza distinzione tra maiuscole e minuscole su tutto ciò che viene mostrato in una riga: indirizzo di origine e destinazione, nome e descrizione dell'indirizzo del gruppo, tipo di telegramma, valore decodificato, esadecimale del carico utile, priorità ed etichette degli eventi del bus.

read

Questo è volutamente ampio: corrisponde a GroupValueRead, a un indirizzo di gruppo denominato Richiesta di lettura o a un valore contenente read. Per un tipo di telegramma esatto, utilizzare invece apci:.

Gli spazi non significano AND. living room cerca la frase soggiorno. Per combinare due condizioni, utilizzare +.

Indirizzi di gruppo: ga:

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

Un indirizzo di gruppo semplice funziona da solo; il prefisso ga: lo rende esplicito, il che è più chiaro nei filtri più lunghi. ga: corrisponde solo ai telegrammi inviati a un indirizzo di gruppo.

• Livello 3: principale 0-31, intermedio 0-7, secondario 0-255
• Livello 2: principale 0-31, secondario 0-2047
• Un carattere jolly * deve sostituire un'intera parte: 1/2/* funziona, 1/2/2* no.

La corrispondenza utilizza il valore grezzo dell'indirizzo, quindi 1/2/3 e 1/515 sono lo stesso indirizzo: il passaggio della visualizzazione tra il livello 2 e il livello 3 non modifica mai i risultati.

Mittenti: src:

1.1.5
1.1.*
src:1.*.*

Un semplice indirizzo individuale funziona da solo; src: lo rende esplicito. Corrisponde sempre al Mittente di un telegramma, mai alla sua destinazione.

• Area 0-15, linea 0-15, dispositivo 0-255
• Un carattere jolly * deve sostituire un'intera parte.

Tipo di telegramma: apci:

apci:GroupValueRead
apci:GroupValueResponse
apci:GroupValueWrite

Utilizza il nome completo del servizio: le maiuscole non hanno importanza, ma apci:read viene rifiutato. Per un servizio senza nome, utilizzare il suo codice in esadecimale, da 0x0 a 0x3FF:

apci-code:0x155

Priorità e conteggio dei salti

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

L'alta priorità di KNX è chiamata urgente - priority:high viene rifiutato. Il conteggio dei luppoli è un numero intero da 0 a 7.

Valori decodificati: value

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

• Corrispondono solo i telegrammi con un valore numerico decodificato: carica il tuo progetto ETS in modo che i valori possano essere decodificati.
• Utilizza un punto per i decimali (1.5), qualunque sia la lingua del tuo telefono.
• Nessuna unità, nessuna notazione scientifica (1e3) e nessun = - per un valore esatto utilizzare value>=20 + value<=20.
• I valori vengono confrontati come numeri, qualunque sia il tipo di punto dati, quindi combina una condizione di valore con un indirizzo di gruppo per mantenerne chiaro il significato:

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

Eventi autobus: kind:

Oltre ai telegrammi, il monitor registra altre osservazioni. Filtrali per tipologia:

Spazi, trattini, caratteri di sottolineatura e maiuscole non contano: funziona anche kind:Bus Control.

Combinazione di condizioni

NOT si lega più forte, quindi AND, quindi OR. COSÌ:

kind:gap | priority:urgent + hop:3

significa un intervallo o un telegramma urgente con conteggio hop 3. In caso di dubbio, aggiungi parentesi:

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

!(value>20) mostra anche le righe senza un valore decodificato, perché NOT inverte semplicemente il risultato.

Ricerca di caratteri speciali

Per cercare testo contenente +, |, ! o parentesi, inserirlo tra virgolette doppie:

"Alarm + Hall"
"Status (North)"

Scrivi una citazione all'interno di un testo citato come \" e una barra rovesciata come \\. Le virgolette impongono inoltre una ricerca in testo semplice per qualsiasi cosa assomigli a un filtro, ad esempio "unknown:value".

Quando un filtro viene rifiutato

Se un filtro non viene interpretato, SharKNX mostra l'errore e la sua posizione sotto il campo di ricerca. L'ultimo filtro valido rimane attivo, quindi l'elenco non cambia finché non correggi il testo e lo applichi nuovamente.

Un filtro valido non mostra nulla?

• L'indirizzo è un Mittente (src:) o un Indirizzo di gruppo (GA) (ga:)?
• I telegrammi hanno un valore decodificato? Carica il progetto ETS.
• Il nome apci: è completo?
• AND/OR ha bisogno di parentesi?
• 1/2/3 1.1.5 è una ricerca di testo, non due condizioni: scrivi ga:1/2/3 + src:1.1.5.

Non è lo stesso dei filtri Shark Hunt

Le azioni Shark Hunt Monitor personalizzato utilizzano le condizioni create in un modulo (fino a 10, unite con AND o OR), non questa sintassi digitata. Vedi Come Creare una Shark Hunt.