Referencia de bloques lógicos

Referencia de bloques

El catálogo incluye 33 bloques divididos en siete grupos, en el orden en que los muestra la paleta: Enlaces, Cálculos, Lógica y selección, Comparaciones, Temporización, Memoria y contadores, Control. En la ficha de referencia inferior encontrará tablas compactas para cada bloque; esta sección describe cada uno de ellos. Cada bloque incluye también su propia explicación en el panel de administración; abra la ayuda del bloque desde la paleta o desde la ficha.

Enlaces

Enlace directo — transfiere un valor desde su entrada hacia su salida, con opción de transformarlo. Puertos: In → Out (cualquier tipo). Ajustes: Modo de envío (solo cuando el valor cambia / cada telegrama entrante), Invertir (booleanos), Mapeo de valores (reasigna valores específicos; se aplica antes de la inversión). Ejemplo: reenviar un pulsador de escalera a una luz en otro protocolo, invertido porque el pulsador envía un 0 al ser presionado.

Filtro — reenvía un valor únicamente si cumple las condiciones configuradas. No altera el valor recibido: la salida entrega exactamente la entrada o nada en absoluto. Mientras que el Enlace directo sirve para corregir un valor a su paso, el Filtro sirve para definir cuánto pasa, y ambos están pensados para usarse juntos.

• Puertos: In (cualquier tipo, obligatorio) y Enable → Out. No se envía nada al bloquear un telegrama: el extremo receptor simplemente conserva el valor previo.
• Condiciones — independientes, desactivadas por defecto; todas las que active deben cumplirse a la vez para que el valor pase: El valor debe ser (Solo ON, Solo OFF, Por encima/Por debajo de un nivel, Dentro/Fuera de un rango — un número se considera ON siempre que sea distinto de 0); Reenviar cuando (Cada telegrama, Solo cuando cambia, Varía al menos…, Conmuta a ON o Conmuta a OFF); Tiempo de estabilización (el valor debe mantenerse estable durante este tiempo; ideal para sensores analógicos ruidosos); Límite de tasa (como máximo un valor por intervalo, ya sea descartando lo que llegue dentro de la ventana o reteniendo el último para enviarlo en cuanto la ventana se abra); Heartbeat (reenvía el último valor transmitido tras este tiempo de inactividad, para destinos que requieren actualización cíclica).
• Un detalle importante: solo cuando cambia y variación mínima se evalúan respecto al último valor reenviado — responden a si el destino ya lo tiene. Flanco ascendente y flanco descendente se evalúan respecto al último valor recibido, ya que el flanco pertenece al flujo entrante: un telegrama bloqueado por una regla de valor cuenta como recibido a estos efectos.
• Comportamiento a tener en cuenta: el modo descartar puede perder una transición de forma permanente, mientras que retener el último no pierde nada y el desfase temporal es como máximo el intervalo fijado, lo que lo convierte en el modo adecuado para controlar actuadores o cargas. El estado no se conserva tras un reinicio: después de reiniciar, el primer telegrama supera siempre la regla de cambio para evitar que el filtro se niegue a refrescar un destino que retiene el valor previo a la caída del servidor.
• Ejemplo: un sensor de luminosidad que transmite cada dos segundos satura el bus. Al pasarlo por un Filtro configurado para retener el último, máximo uno cada 60 s, la lógica de control de persianas recibe una lectura por minuto en lugar de treinta, manteniendo siempre la más reciente.

Selector — conmuta uno de varios valores hacia la salida según un índice numérico. Recibe varias entradas, un número selecciona cuál se transmite y esta sale intacta: una selección de consignas, no una fórmula.

• Puertos: Select (número, obligatorio; puede quedar interno con valor por defecto de 1) y Valor 1…n (cualquier tipo, de 2 a 8 entradas) → Out.
• Ajustes principales: Número de valores; Cuando Select está fuera de rango — No enviar nada — el destino mantiene su valor (por defecto) o Enviar 0. Un valor de Select igual a 1 elige la primera entrada, 2 la segunda; un 0, un valor negativo o un número superior al total de entradas queda fuera de rango. Una entrada no cableada tampoco envía nada al ser seleccionada.
• Comportamiento a tener en cuenta: mantenga valores del mismo tipo en las entradas (todo consignas o todo señales de conmutación); el bloque transfiere lo que recibe y no procesa tipos mixtos. La opción de no enviar nada cuando Select está fuera de rango es deliberada: un selector de modo que transite por 0 al cambiar de estado no borrará una consigna activa.
• Ejemplo: un modo de vivienda (1 = en casa, 2 = ausente, 3 = noche) procedente de una función de Botones de radio controla la entrada Select; los tres valores corresponden a tres consignas de calefacción; la salida alimenta la entrada Consigna del Termostato. Sin este bloque, conmutar entre tres valores requeriría tres comparadores y tres filtros.

Cálculos

Valor calculado — combina entre 1 y 8 entradas numéricas en un único resultado. Puertos: Entrada 1…n → Resultado. Ajustes: Operación — Suma, Media, Mínimo, Máximo, Diferencia (in1 − in2), Producto, Suma ponderada, Escalado + offset (in1 × factor + offset) o una Fórmula libre; además de Decimales y Unidad de visualización. Ejemplo: promediar tres sensores de temperatura ambiente en una sola lectura para alimentar la entrada Medición de un Termostato.

Contador de energía — transforma lecturas de potencia (o caudal) en registros acumulados de energía, pensado para dispositivos que solo reportan potencia instantánea. Muchos contadores de pinza, actuadores con medición de corriente y sensores de Home Assistant informan vatios pero carecen de contador de kWh; sin embargo, todos los gráficos de la aplicación (barras semanales/mensuales/anuales, totales, balance energético) leen contadores acumulados. Este bloque genera esos registros.

• Puertos: Potencia (obligatorio) → Consumida y Producida — dos registros crecientes en kWh (o m³ para agua y gas).
• Ajustes principales: Dirección — Con signo (potencia positiva incrementa Consumida, negativa incrementa Producida; contador de red y baterías), Solo consumida (cargas, cargadores, agua, gas), Solo producida (inversores); Invertir signo para contadores con cableado invertido; Unidad de entrada (W → kWh, kW → kWh, l/h → m³, m³/h → m³); un Límite de plausibilidad para descartar picos anómalos; los Valores iniciales de Consumida/Producida — valores de arranque de los registros; modificar un valor inicial reinicia ambos registros a dicho valor, método utilizado para sincronizar el bloque con la lectura del contador físico; Decimales de salida.
• Conexionado: vincule Potencia al objeto 1 del widget del contador, y las salidas a los objetos de energía (2 y 3) del mismo widget en modo "Definir estado". Los registros se almacenan, grafican y totalizan exactamente igual que si los enviara el propio dispositivo. Un objeto de energía solo puede ser "definido" si no tiene una dirección asignada; si más adelante se le asigna una dirección de grupo, la función indicará el conflicto hasta que se elimine uno de los dos orígenes.
• Comportamiento a tener en cuenta: entre lecturas consecutivas, se retiene la última potencia y se integra al menos una vez por minuto, permitiendo un cálculo acumulativo preciso en equipos de transmisión lenta. Un dispositivo inactivo durante un tiempo superior al watchdog de entrada (15 minutos por defecto en el enlace) congela los registros para evitar contabilizar indefinidamente el último valor recibido. El tiempo de inactividad del servidor nunca genera energía ficticia: ante un corte, el error siempre será por defecto.
• Ejemplo: un contador de pinza KNX en el cuadro del taller envía vatios en la dirección 14/6/1. Cree un widget de contador de tipo Consumo con dicha dirección en el objeto 1 y el objeto 2 vacío, inserte una función Contador de energía en modo Solo consumida, enlace Potencia → objeto 1 y Consumida → objeto 2, e introduzca en el valor inicial la lectura del contador físico. El taller dispondrá de potencia en tiempo real y consumos diarios/mensuales/anuales en la app.

Media móvil — suaviza señales con fluctuaciones para facilitar la toma de decisiones lógicas. Un sensor de luminosidad con nubes pasajeras, un medidor de potencia con picos por el arranque del frigorífico o un anemómetro con rachas de viento oscilarían continuamente si se conectan directo a un comparador; al filtrarlos previamente con este bloque, la señal se estabiliza.

• Puertos: In (número, obligatorio), Reset → Smoothed.
• Ajustes principales: Promediar según — Una ventana de tiempo (por defecto; Ventana 300 s, ponderando cada valor por su duración real en el bus; ideal para valores transmitidos por cambio), Un número de muestras (Muestras, para sensores con transmisión cíclica fija) o Una constante de tiempo (Constante de tiempo 300 s: cada nueva lectura aproxima la salida progresivamente hacia el nuevo valor, logrando el mayor filtrado); Decimales; Unidad de visualización.
• Comportamiento a tener en cuenta: el filtrado introduce retardo por definición: una ventana de cinco minutos acumula de media un desfase de dos minutos y medio respecto a la lectura real, lo cual es adecuado para la gestión de persianas pero inadmisible para una alarma de helada. La ventana o la constante de tiempo van descartando valores antiguos mientras el sensor no transmite; tras un reinicio, la ventana se recalcula desde cero.
• Ejemplo: la luminosidad de la estación meteorológica promediada durante 5 minutos conectada a la entrada Luminosidad del bloque de Persianas automáticas: las nubes transitorias dejan de accionar los motores.

Punto de rocío — calcula la temperatura a la que el aire ambiente comenzará a condensar a partir de la temperatura y la humedad relativa y, si se conecta un sensor de temperatura superficial, determina el riesgo de condensación sobre el elemento físico.

• Puertos: Temperatura y Humedad (ambos obligatorios), Temperatura de superficie (elemento frío: techo radiante, fancoil, acristalamiento) → Punto de rocío (°C), Riesgo de condensación (activo mientras la superficie esté dentro del margen de seguridad respecto al punto de rocío), Margen (K — margen térmico restante).
• Ajustes principales: Margen de seguridad (2 K), Histéresis (1 K — distancia adicional antes de desactivar la señal de riesgo), Decimales. Si no se conecta la temperatura de superficie, el bloque entrega el punto de rocío y omite el estado de riesgo.
• Ejemplo: a 24 °C y 60 % de HR, el punto de rocío es de 15,7 °C; un techo radiante alimentado con agua a 14 °C activará Riesgo de condensación — conéctelo a la habilitación de la válvula de frío mediante una puerta NOT, o use el Margen para regular la temperatura de impulsión antes de que corte por seguridad.

Lógica y selección

AND — la salida se activa únicamente cuando todas las entradas (2–8) están activas. Ejemplo: "demanda de calefacción AND ventana cerrada" antes de abrir una válvula.

OR — la salida se activa cuando al menos una de las entradas (2–8) está activa. Ejemplo: la detección de presencia en cualquiera de tres sensores de pasillo enciende la iluminación.

XOR — la salida se activa cuando un número impar de entradas (2–8) está activo. Ejemplo: conmutación cruzada a partir de dos entradas de pulsador basculante.

NOT — invierte el estado de su única entrada booleana. Ejemplo: transformar el contacto "ventana abierta" en señal de habilitación "ventana cerrada".

Botones de radio — múltiples entradas, exactamente una salida activa; la última señal recibida define el estado. Al activar la opción 3, se enciende Out 3 y se apagan las demás, funcionando igual que las presintonías de una radio.

• Puertos: Opción 1…n (booleano, 2–8, todas opcionales, activación por flanco), Select (número — salta a dicha posición al cambiar el valor; 0 o fuera de rango borra la selección), Clear → Posición (número) y Out 1…8 (booleano; las salidas por encima del número configurado existen pero nunca conmutan a ON).
• Ajustes principales: Número de opciones; Posición inicial en función nueva (0 = ninguna seleccionada; a partir de ahí conserva la última posición memorizada).
• Comportamiento a tener en cuenta: la selección se mantiene tras un reinicio. Al garantizar que solo una salida puede estar activa a la vez, se evita que ocurran dos estados simultáneos sin necesidad de añadir lógica de enclavamiento adicional.
• Ejemplo: modos calefacción / refrigeración / apagado con exclusión mutua: tres pulsadores de pared a las opciones, Out 1 a la habilitación de calor, Out 2 a la habilitación de frío. O un modo de vivienda cuya Posición comanda un Selector.

Secuenciador — un único pulso recorre cíclicamente hasta ocho salidas de forma secuencial: cada pulso en Next activa la salida siguiente y apaga las demás. Es el equivalente secuencial de los Botones de radio: aquel dispone de una entrada por opción y define "cuál activar"; este dispone de un único disparador y avanza a "la siguiente".

• Puertos: Next (obligatorio), Previous, Reset, Enable (en OFF ignora disparos y retiene el paso actual) → Posición y Out 1…8.
• Ajustes principales: Número de pasos; Incluir paso todo apagado (activo: la secuencia es 0, 1, 2, 3 y vuelve a 0, permitiendo apagar todo con una pulsación adicional); Comportamiento cíclico al final; Posición tras reset.
• Comportamiento a tener en cuenta: la posición se conserva tras un reinicio; Enable congela la secuencia sin perder el paso actual.
• Ejemplo: un único pulsador recorre tres escenas de iluminación y apagado: conecte cada salida Out a un escenario como destino de acción (ver “Configuración de funciones y salidas”).

Decodificador de bits — descompone un número (0–255) en sus ocho bits individuales: un byte de estado de un actuador KNX, un registro de alarma de una pasarela Modbus o flags de un equipo HTTP. Puertos: Value → Bit 0 (1) … Bit 7 (128) — el peso de cada bit figura indicado en el puerto para cotejarlo directamente con la hoja de datos. Los valores se truncan al rango 0–255; cablee únicamente los bits necesarios. Ejemplo: el bit 3 del byte de estado de un actuador genera la señal de "sobrecarga" para una acción de notificación.

Codificador de bits — la función inversa: hasta ocho entradas booleanas se combinan en su valor numérico resultante (bits 0 y 2 en ON → 5). Puertos: Bit 0 (1) … Bit 7 (128) → Value. Un bit sin conectar equivale a 0, permitiendo gestionar dispositivos de cuatro bits sin requerir los ocho. La salida se actualiza al cambiar cualquier bit; intercale un Filtro con un breve tiempo de estabilización si varios bits conmutan a la vez. Ejemplo: una unidad de ventilación cuyo modo se comanda mediante un byte empaquetado.

Comparaciones

Comparador — compara un valor numérico con un umbral. Puertos: Value, entrada opcional Threshold → booleano Out. Ajustes: Comparación (>, >=, <, <=, ==, !=), Umbral fijo (utilizado si no se conecta la entrada Threshold) y una Banda muerta para evitar oscilaciones cerca del umbral. Ejemplo: potencia > 5000 W activa un aviso de sobrecarga.

Histéresis — conmutación con doble umbral: activa por encima del Umbral superior, desactiva por debajo del Umbral inferior, sin cambios en la zona intermedia; Invertir invierte la salida. Ejemplo: encender el deshumidificador del sótano al alcanzar el 70 % de humedad y apagarlo al bajar del 60 %.

Temporización

Retardo a la conexión — la salida pasa a ON tras mantenerse la entrada en ON durante el tiempo de Retardo configurado (por defecto 10 s); la desconexión a OFF es inmediata. Ejemplo: ignorar detecciones de presencia inferiores a 30 s antes de activar la ventilación.

Retardo a la desconexión — la salida pasa a ON al instante pero permanece activa durante el tiempo de Retardo (por defecto 30 s) tras pasar la entrada a OFF. Ejemplo: mantener el extractor del baño encendido 5 minutos después de apagar la luz.

Temporizador de escalera — un pulso activa la salida durante el tiempo de Duración (por defecto 180 s) y luego se apaga automáticamente. Ajustes: Reiniciar con nueva pulsación (redisparo) y Una desconexión finaliza antes. Ejemplo: control tradicional de alumbrado de escalera.

Pulso — convierte cualquier señal de entrada en un pulso único calibrado de Duración de pulso en segundos (por defecto 1 s). Ejemplo: enviar un impulso de 1 s al contacto de la puerta de garaje desde una escena.

Tiempo mínimo de marcha — impone un Tiempo mínimo encendido y un Tiempo mínimo apagado (por defecto 300 s cada uno) sobre una orden de conmutación. Ejemplo: proteger el compresor de una bomba de calor frente a ciclos cortos de encendido, intercalado entre la salida Calor del Termostato y el actuador.

Programador horario — programa semanal que entrega una señal booleana; no requiere entradas. Ajustes: Puntos de conmutación semanales e Invertir. Salida: Activo. Ejemplo: "horario comercial" (lunes a sábado de 08:30 a 18:30) condicionando el encendido del escaparate mediante una puerta AND.

Multipulsación — discrimina entre pulsación simple, doble, triple, cuádruple y pulsación larga sobre un mismo botón, permitiendo gobernar hasta cinco funciones desde un único mecanismo: una solución clave en reformas.

• Puertos: Botón (booleano, obligatorio) → Simple, Doble, Triple, Cuádruple, Pulsación larga (cada uno entrega un pulso corto) y Pulsaciones (el número total reconocido, para controlar un Selector).
• Ajustes principales: Pulsaciones a reconocer (por defecto 2 — pulsaciones más rápidas se cuentan hasta este límite); Intervalo entre pulsaciones (0,35 s — determina también el retardo en las salidas de pulsación); Pulsación larga tras (0,8 s, medidos desde el inicio de la presión para disparar mientras el pulsador sigue presionado; 0 desactiva la pulsación larga y acelera la detección de la pulsación simple); Duración del pulso de salida.
• Comportamiento a tener en cuenta: funciona por flancos, por lo que el pulsador debe enviar tanto la pulsación como la liberación (en ETS: enviar 1 al pulsar y 0 al soltar). Si no responde al doble clic, compruebe este ajuste en primer lugar. El estado no se conserva tras un reinicio.
• Ejemplo: pulsador de cocina: una pulsación conmuta la luz del techo (mediante un Telerruptor), doble pulsación lanza la escena "Cena" (destino de acción, ver “Configuración de funciones y salidas”), pulsación larga ejecuta el apagado general.

Generador de pulsos — base de tiempos: mientras Enable esté en ON, la salida se activa durante el tiempo Encendido durante, se desactiva durante Apagado durante (por defecto 1 s / 59 s) y repite el ciclo continuamente sin requerir entradas. Ajuste: Iniciar ciclo en ON u OFF. Reactivar Enable reinicia el ciclo desde el principio; la fase se calcula respecto al tiempo de arranque para evitar desvíos temporales y preservar la sincronía tras un reinicio. Ninguna de las dos fases puede ser inferior a 0,5 s y la suma debe ser de al menos 2 s para cumplir con la protección anti-bucle del motor lógico (ver “Validación, supervisión y seguridad lógica”). Ejemplo: señal de heartbeat para supervisión externa o parpadeo de señalización durante una alarma.

Rampa — evoluciona hacia un valor de consigna de forma progresiva en lugar de aplicar saltos bruscos: un regulador que atenúa en diez segundos, una consigna que sube de forma suave para no forzar la caldera o un ventilador que acelera progresivamente.

• Puertos: Target (número, obligatorio), Hold (congela la salida en el valor actual; la rampa continúa al liberarse), Reset (salta inmediatamente al valor inicial) → Out y Moving.
• Ajustes principales: Tasa (unidades por segundo: 10 en un regulador de 0–100 equivale a una transición de diez segundos; 0,05 para temperatura en grados), Paso cada (1 s — cada paso genera un telegrama), Valor inicial, Mínimo / Máximo, Decimales (reducir decimales evita transmitir micropasos idénticos), Unidad de visualización.
• Comportamiento a tener en cuenta: un reinicio no reanuda la rampa en curso: la salida vuelve a partir del valor inicial y avanza hacia la consigna activa.
• Ejemplo: intercalada entre un Selector de niveles de iluminación nocturna y el actuador regulador, una Rampa con tasa 10 transforma el cambio de escena en una transición progresiva.

Memoria y contadores

Báscula (Latch): memoriza activado o desactivado. Algo la activa, otra cosa la desactiva y, mientras tanto, mantiene su estado; justo lo que ningún otro bloque podía hacer. Conecte un pulsador de pared a Toggle y dispondrá de un interruptor gestionado por la vivienda en lugar de por el actuador.

• Puertos: Set, Reset, Toggle (siempre por flanco), Enable (en off ignora los tres anteriores y retiene la salida: un bloqueo infantil) → Out.
• Ajustes principales: Set and reset act — The moment they arrive (flanco, por defecto: adecuado para pulsadores) o For as long as they are on (nivel: adecuado para enclavamientos; un comparador conectado a Reset mantiene la báscula a cero mientras se cumpla su condición); If set and reset act together — Reset wins (por defecto) o Set wins; Value before anything has happened.
• Comportamiento a tener en cuenta: el valor se mantiene tras un reinicio; un «modo vacaciones» o una «alarma confirmada» no deben borrarse tras un corte de corriente. Una pulsación recibida con Enable desactivado se descarta, no se pone en cola.
• Ejemplo: «Modo vacaciones»: un Set desde la marca virtual de la app, un Reset procedente de la apertura del contacto de la puerta principal tras el periodo vacacional, con Out reduciendo la consigna de cada termostato a través de sus entradas de User mode.

Memoria de valor (Value memory): captura un valor cuando se le ordena y lo retiene hasta una nueva instrucción: la respuesta a «¿cuál era el valor anterior?».

• Puertos: In (cualquier tipo, obligatorio), Sample (booleano, obligatorio), Reset → Held (del mismo tipo que In).
• Ajustes principales: Capture when Sample goes On / Off / Either way; Value on reset (déjelo vacío y Reset solo borrará la memoria sin escribir ningún dato; introduzca un valor y Reset escribirá ese valor).
• Comportamiento a tener en cuenta: antes del primer muestreo no escribe nada (una memoria a la que nunca se le asignó un valor carece de dato, y asumir un 0 enviaría un comando real al bus). El valor memorizado se conserva tras un reinicio.
• Ejemplo: muestrear la luminosidad del salón cuando salta la alarma y todas las luces se fuerzan al 100 %; al restablecerse la alarma, el valor retenido restaura el nivel anterior.

Contador (Counter): suma uno a un número cada vez que se dispara Count up, resta uno con Count down y memoriza el total: aperturas de puertas, ciclos completados, arranques de bombas.

• Puertos: Count up, Count down, Reset, Enable (en off detiene el recuento; Reset sigue funcionando) → Count (número) y At limit (booleano).
• Ajustes principales: Step (1, en ambas direcciones); Value after a reset; Minimum / Maximum (opcionales e independientes); Wrap round at the limits (requiere ambos límites definidos; al superar el valor máximo, el recuento salta al mínimo, convirtiendo el bloque en un selector: máximo 4, recirculación activada, un pulsador alterna secuencialmente 1, 2, 3, 4, 1); Decimals; Unit de visualización.
• Comportamiento a tener en cuenta: ambas entradas de recuento actúan en el instante en que reciben el evento, por lo que un contacto mantenido cerrado solo cuenta una vez. Reset siempre tiene prioridad sobre un recuento en la misma evaluación. El valor del recuento se conserva tras un reinicio.
• Ejemplo: contar los ciclos de una puerta de garaje y emitir una notificación de mantenimiento (destino de acción) a los 5 000 ciclos mediante un comparador.

Contador de horas de funcionamiento (Runtime counter): calcula el tiempo total de funcionamiento de un equipo y activa una marca de mantenimiento pendiente: horas de bombas, compresores, lámparas UV o filtros.

• Puertos: Running (booleano, obligatorio), Service done, Reset everything → Total runtime, Since service, Until service, Service due (booleano), Starts (número de maniobras de encendido: los ciclos cortos desgastan un compresor más rápido que el funcionamiento continuo).
• Ajustes principales: Unit (Seconds, Minutes, Hours [por defecto], Days), Service interval (0 desactiva las salidas de servicio), Decimals (mostrar horas con un decimal actualiza el dato cada seis minutos; con dos decimales, cada 36 segundos; en un bus KNX esto marca la diferencia entre una lectura periódica y una saturación del bus).
• Comportamiento a tener en cuenta: el tiempo se acumula en minutos reales; una interrupción superior a dos minutos se considera tiempo de parada y se ignora en lugar de estimarse. Service done solo restablece el contador de mantenimiento; el acumulado total del equipo continúa incrementándose.
• Ejemplo: la señal de marcha de la unidad de ventilación conectada a Running, intervalo de mantenimiento en 2 000 h, Service due vinculado a una acción de correo electrónico (consulte «Configuración de funciones y salidas»): la instalación solicita de forma autónoma su propio cambio de filtro.

Mín / máx (Min / max): calcula el valor mínimo, máximo y promedio desde el inicio del periodo: la temperatura más baja de la noche anterior, el pico de potencia de este mes o el nivel máximo de CO₂ alcanzado en la sala de reuniones esta semana.

• Puertos: In (número, obligatorio), Reset → Minimum, Maximum, Average.
• Ajustes principales: Start again — Never — only on the Reset input (registro histórico continuo), Every day (por defecto), Every week, on Monday, Every month, on the 1st; At (hora de reinicio: fijarlo a las 6 de la mañana ajusta «hoy» a la jornada real de uso); Decimals; Unit de visualización.
• Comportamiento a tener en cuenta: el promedio está ponderado por tiempo (cada valor cuenta en proporción al tiempo exacto durante el que estuvo activo; por tanto, un pico de cinco minutos de un sensor que transmite por cambio no distorsiona el cálculo frente a once horas de reposo). Antes de la primera lectura no escribe ningún dato; el bloque se activa automáticamente al inicio de cada periodo.
• Ejemplo: vincular la salida Maximum de la potencia del contador de red como «Pico de hoy» (consulte «Configuración de funciones y salidas») y ubicarlo en la vista de Energía.

Control

Termostato (Thermostat): controlador completo de temperatura ambiente. Puede gestionar calefacción, refrigeración o ambos modos, y puede configurarse como el controlador asociado a un dispositivo de climatización, de modo que la interfaz del termostato en la app (modos, consigna, boost) controle directamente esta función.

• Entradas: Measurement (temperatura ambiente: obligatoria), Setpoint, User mode (confort/standby/noche), Season, Enable, Window (contacto de ventana que reduce la consigna tras el retardo Window delay mientras esté abierta).
• Salidas: Heat y Cool (conmutación), Heat % y Cool % (0–100 % para control proporcional/PWM), Effective setpoint, retroalimentación de User mode, State.
• Ajustes principales: Season (Heating, Cooling, Auto (both) con una banda muerta Auto deadband entre ambos modos); gestión de modos (el modo confort utiliza la propia consigna; Standby offset y Night offset ajustan la reducción térmica por modo; Frost protection y Heat protection actúan como límites de seguridad); Output (Switching (on/off) con Hysteresis, Proportional (0–100 %) con una banda proporcional Proportional band, o PWM (duty cycle) con un periodo PWM period); Minimum switching interval; Setpoint minimum/maximum.
• Ejemplo: asigne Measurement al sensor de estancia KNX, conecte Heat al actuador de válvulas, configure en la función la estancia correspondiente y la categoría Heating, y vincúlela al widget de climatización de la estancia: la app del usuario controlará este regulador y la función Boost responderá según lo descrito en «Termostatos, climatización y ventilación».

Persiana automática (Automatic shutter): lógica de protección solar para una fachada. Aplica sombreado cuando el sol incide directamente sobre la fachada con alta luminosidad (y, opcionalmente, con temperatura elevada), y repliega las protecciones al cesar las condiciones.

• Entradas: Brightness (obligatoria), Temperature, Presence, Wind alarm, Enable.
• Salidas: Position y Slats (0–100 %), listas para conectar al widget de persianas.
• Ajustes principales: Brightness threshold + Brightness hysteresis (valores por defecto: 40 000 / 10 000 lux); Temperature threshold (sombrear solo con temperatura alta); criterio de presencia Presence (Ignore presence / Shade only when nobody is in / Shade only when someone is in); Shading position y Shading slat angle frente a Rest position / Rest slat angle; retardo Confirmation delay (300 s por defecto) para evitar maniobras continuas por nubes pasajeras; geometría de la fachada: Facade from/to (rango de acimut) y Minimum sun elevation, evaluados mediante el reloj astronómico; cierre opcional Close at dusk con una posición nocturna Night position; y posición de seguridad frente al viento Wind-alarm position forzada mientras la entrada de viento permanezca activa.
• Ejemplo: fachada sur: luminosidad procedente de la estación meteorológica, alarma de viento desde el objeto de grupo de alarma meteorológica KNX con un watchdog de 60 s configurado en force off: si el anemómetro deja de transmitir datos, las persianas se repliegan automáticamente a la posición de seguridad.

⚠️ Advertencia: Conecte siempre una entrada física real para Wind alarm en persianas expuestas y asóciele un watchdog. El confort de sombreado es opcional; la protección frente a viento es obligatoria.

Ficha de referencia de bloques lógicos

Ficha de consulta rápida para cada bloque del motor lógico: los 33 bloques del catálogo, complementaria al desglose detallado anterior. Los valores predeterminados corresponden al estado inicial de un bloque recién insertado. «Ajustable por el usuario» enumera los parámetros que el integrador puede exponer en la app (consulte «Configuración de funciones y salidas»); ningún parámetro se muestra a menos que el integrador lo autorice explícitamente en la función.

📘 Nota: Una entrada sin asignar adopta un valor 0 (en números) o desactivado/off (en booleanos), a menos que la ficha indique lo contrario. Los bloques temporizadores marcados como «no sobrevive a un reinicio» restablecen su temporizador a cero tras reiniciar el servidor de forma deliberada.

Enlaces

Enlace directo (Direct link): transfiere un objeto directamente a otro, permitiendo correcciones intermedias opcionales.

💡 Consejo: Los pulsadores requieren la opción every incoming telegram: dos pulsaciones idénticas son dos comandos reales, y un enlace configurado solo por cambio ignoraría la segunda pulsación.

Filtro (Filter): transmite un valor únicamente cuando cumple las condiciones fijadas. Nunca altera el dato.

💡 Consejo: Las condiciones Only when it changes y minimum change se evalúan respecto al último valor transmitido (comprueban si el receptor final ya dispone de ese valor). Rising y falling se evalúan respecto al último valor recibido, ya que el flanco corresponde a la señal de entrada.

📘 Nota: La opción Discard puede descartar un cambio de estado de forma definitiva; hold the latest asegura su envío posterior. Utilice retención siempre que el valor gobierne un actuador que no deba perder ninguna conmutación. No sobrevive a un reinicio: el primer telegrama recibido tras reiniciar siempre supera la regla de cambio.

Selector (Selector): transmite uno de varios valores a la salida según un índice numérico.

Cálculos

Valor calculado — combina hasta 8 números en uno solo.

📘 Nota: Una entrada no vinculada cuenta como 0; una media de tres entradas con una entrada libre divide entre tres. Ajuste el número de entradas al que realmente cablee.

Contador de energía — acumula una lectura de potencia en registros de energía acumulativa.

Media móvil — suaviza un valor con ruido.

Punto de rocío — punto de rocío a partir de temperatura y humedad, con indicador de riesgo de condensación.

Lógica y selección

AND · OR · XOR — puertas booleanas múltiples.

NOT — invierte un booleano.

Botones de opción — varias entradas, exactamente una salida activa; la última en activarse tiene prioridad.

Secuenciador — un único disparador avanza a través de hasta ocho salidas.

Decodificador de bits — divide un número en sus ocho bits.

Codificador de bits — empaqueta hasta ocho booleanos en un solo número.

Comparaciones

Comparador — convierte un número en un sí/no.

📘 Nota: La banda muerta evita conmutaciones continuas: con "> 21" y una banda muerta de 0,5, la salida se activa a 21,5 y debe caer por debajo de 21 para desactivarse de nuevo.

Histéresis — un interruptor de dos umbrales.

Temporización

Retardo a la conexión (On-delay) — transfiere un ON solo cuando la entrada ha permanecido encendida durante todo el retardo.

Retardo a la desconexión (Off-delay) — sigue a un ON inmediatamente y luego lo mantiene después de que la entrada caiga.

Temporizador de escalera — una pulsación activa la salida durante un tiempo fijo.

Impulso — cada flanco ascendente produce un impulso ON de longitud fija.

Tiempo mínimo de funcionamiento — garantiza que cada estado dure lo suficiente.

Programación horaria — un programa semanal que controla un booleano.

Multipulsación — distingue entre pulsaciones simples, dobles, triples, cuádruples y largas.

Generador de impulsos — conmuta su salida entre encendido y apagado de forma continua en un ciclo fijo.

Rampa — sigue un valor objetivo a una velocidad limitada.

Control

Termostato — control de temperatura ambiente; calefacción, refrigeración o ambos. También puede actuar como el controlador detrás de un widget de climatización: enlace los objetos de consigna, temperatura y modo del widget a los puertos del bloque, y su consigna efectiva y retorno de modo de nuevo al widget; el selector, el modo Boost y la programación semanal del widget controlarán entonces el bloque.

📘 Nota: La protección antihelada y contra sobrecalentamiento prevalecen sobre el ajuste: siguen aplicándose en modo protección y siempre que la regulación se detenga mediante la entrada Enable o por una ventana abierta.

Persiana automática — protección solar y térmica para una fachada.

Memoria y contadores

La paleta muestra este grupo entre Temporización y Control.

Báscula (Latch) — recuerda encendido o apagado.

Memoria de valor — captura un valor cuando se le indica y lo retiene.

Contador — cuenta eventos hacia arriba y hacia abajo.

Contador de tiempo de funcionamiento — suma el tiempo que algo ha estado funcionando, con un indicador de mantenimiento pendiente.

Mín / máx — mínimo, máximo y media ponderada en el tiempo desde el último reset.