Sintaxis de filtros del monitor

El campo de búsqueda en la página Monitor hace más que buscar texto. Entiende un pequeño lenguaje de filtro, por lo que puedes comparar datos KNX exactos (direcciones de grupo, remitentes, servicios de telegramas, prioridad, recuento de saltos, valores decodificados) y combinarlos con AND, OR y NOT. Esta página es la referencia completa.

Al aplicar un filtro se comprueba una vez cada telegrama que ya está en el monitor; A continuación, se comprueban los nuevos telegramas a medida que llegan. El filtro sólo cambia lo que ves, no se elimina nada.

Ejemplos rápidos

Deje que los recolectores creen filtros para usted

No es necesario escribir filtros. El botón Buscar al lado del campo (direcciones de grupo y dispositivos de tu proyecto ETS) y Ver → Ver Grupo en la fila de la insignia (direcciones, tipos de telegramas, prioridad) los crean por usted: al elegir un remitente se obtiene src:1.1.5, al elegir Urgente se obtiene priority:urgent, y así sucesivamente.

Si un filtro ya está activo, SharKNX pregunta cómo agregar uno nuevo:

Con AND u OR, el filtro actual está entre paréntesis para que se mantenga tu significado; por ejemplo, ga:1/2/* | ga:2/1/* más Urgente con AND se convierte en:

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

El resultado aparece en el campo de búsqueda, para que puedas verlo, editarlo y aplicarlo nuevamente. Limpiar elimina el filtro y el texto.

Búsqueda de texto

El texto sin formato es una búsqueda que no distingue entre mayúsculas y minúsculas en todo lo que muestra una fila: dirección de origen y destino, nombre y descripción de la dirección de grupo, tipo de telegrama, valor decodificado, hexadecimal de carga útil, prioridad y etiquetas de eventos de bus.

read

Esto es deliberadamente amplio: coincide con un GroupValueRead, una dirección de grupo denominada Solicitud de lectura o un valor que contiene read. Para un tipo de telegrama exacto, utiliza apci: en tu lugar.

Los espacios no significan Y. living room busca la frase sala de estar. Para combinar dos condiciones, utiliza +.

Direcciones de grupo: ga:

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

Una dirección de grupo simple funciona por sí sola; el prefijo ga: lo hace explícito, lo que resulta más claro en filtros más largos. ga: solo coincide con telegramas enviados a una dirección de grupo.

• Nivel 3: 0-31 principal, 0-7 medio, 0-255 secundario
• Nivel 2: principal 0-31, sub 0-2047
• Un comodín * debe reemplazar una pieza completa: 1/2/* funciona, 1/2/2* no.

La coincidencia utiliza el valor bruto de la dirección, por lo que 1/2/3 y 1/515 son la misma dirección; cambiar la visualización entre el nivel 2 y el nivel 3 nunca cambia los resultados.

Remitentes: src:

1.1.5
1.1.*
src:1.*.*

Una simple dirección individual funciona por sí sola; src: lo hace explícito. Siempre coincide con el Emisor de un telegrama, nunca con tu destino.

• Área 0-15, línea 0-15, dispositivo 0-255
• Un comodín * debe reemplazar una pieza completa.

Tipo de telegrama: apci:

apci:GroupValueRead
apci:GroupValueResponse
apci:GroupValueWrite

Utiliza el nombre completo del servicio: las mayúsculas no importan, pero se rechaza apci:read. Para un servicio sin nombre, utiliza tu código en hexadecimal, de 0x0 a 0x3FF:

apci-code:0x155

Prioridad y recuento de saltos

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

La prioridad alta de KNX se denomina urgente: se rechaza priority:high. El recuento de saltos es un número entero desde 0 hasta 7.

Valores decodificados: value

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

• Sólo coinciden los telegramas con un valor numérico decodificado: cargue tu proyecto ETS para que se puedan decodificar los valores.
• Utiliza un punto para los decimales (1.5), sea cual sea el idioma de tu teléfono.
• Sin unidades, sin notación científica (1e3) y sin = - para obtener un valor exacto utiliza value>=20 + value<=20.
• Los valores se comparan como números, cualquiera que sea tu tipo de punto de datos, así que combine una condición de valor con una dirección de grupo para mantener claro tu significado:

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

Eventos de autobús: kind:

Además de los telegramas, el monitor registra otras observaciones. Filtrarlos por tipo:

Los espacios, guiones, guiones bajos y mayúsculas no importan: kind:Bus Control también funciona.

Combinando condiciones

NO se une más fuerte, luego Y, luego O. Entonces:

kind:gap | priority:urgent + hop:3

significa un intervalo o un telegrama urgente con recuento de saltos 3. En caso de duda, agregue paréntesis:

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

!(value>20) también muestra filas sin un valor decodificado, porque NOT simplemente invierte el resultado.

Buscando caracteres especiales

Para buscar texto que contenga +, |, ! o paréntesis, escríbalo entre comillas dobles:

"Alarm + Hall"
"Status (North)"

Escriba una cita dentro de un texto citado como \" y una barra invertida como \\. Las comillas también fuerzan una búsqueda de texto sin formato para cualquier cosa que parezca un filtro, como "unknown:value".

Cuando se rechaza un filtro

Si no se puede entender un filtro, SharKNX muestra el error y tu posición debajo del campo de búsqueda. El último filtro válido permanece activo, por lo que la lista no cambia hasta que corrijas el texto y lo apliques nuevamente.

¿Un filtro válido no muestra nada?

• ¿La dirección es un Emisor (src:) o una Dirección de grupo (GA) (ga:)?
• ¿Los telegramas tienen un valor decodificado? Cargue el proyecto ETS.
• ¿Está completo el nombre apci:?
• ¿Y/O necesita paréntesis?
• 1/2/3 1.1.5 es una búsqueda de texto, no dos condiciones - escriba ga:1/2/3 + src:1.1.5.

No es lo mismo que los filtros Shark Hunt

Las acciones Shark Hunt Monitor personalizado utilizan condiciones que creas en un formulario (hasta 10, unidas con AND u OR), no esta sintaxis escrita. Consulta Cómo crear una Shark Hunt.