Biblioteca (Bloques de función + Funciones)

Visión general

La biblioteca de ForgeIEC es la colección central de todos los bloques reutilizables que un programa de aplicación puede invocar desde un proyecto .forge — abarcando tanto los bloques de función y funciones estandarizados de IEC 61131-3, como las extensiones específicas del proyecto o de ForgeIEC.

La biblioteca se muestra en el panel Biblioteca (acoplamiento predeterminado: barra lateral derecha). Pulse F1 mientras el panel Biblioteca tenga el foco para abrir esta página.

Library
+-- Standard Function Blocks    (Bistable, Edge, Counter, Timer, ...)
+-- Standard Functions          (Arithmetic, Comparison, Bitwise, ...)
+-- User Library                (project-specific blocks)

Actualmente la biblioteca incluye casi 100 bloques y algo más de 30 funciones. Cada entrada incluye:

• Nombre (p. ej. TON, JK_FF)
• Lista de pines (entradas + salidas con tipo y posición)
• Tipo (FUNCTION_BLOCK con estado, o FUNCTION sin estado)
• Descripción + texto de ayuda con notas de uso
• Ejemplo de código (visible en el panel de ayuda de la biblioteca)

Árbol de categorías

Bloques de función estándar

Funciones estándar

Biblioteca de usuario

Bloques de función y funciones definidos en el proyecto — todo lo declarado como FUNCTION_BLOCK o FUNCTION aterriza automáticamente en esta categoría y puede invocarse desde cualquier parte del proyecto, igual que los bloques estándar.

Panel Biblioteca — uso

Ejemplo 1 — Antirrebote de pulsador con DEBOUNCE

DEBOUNCE filtra impulsos cortos de ruido del contacto de un pulsador mecánico. Q solo cambia cuando IN permanece estable durante toda la duración T_Debounce — tanto en flanco ascendente como descendente.

Distribución de pines

Ejemplo de código

Cuerpo de PROGRAM que realiza el antirrebote de un pulsador en %IX0.0 y reenvía la señal sin rebotes como flanco único a un contactor con autorretención:

PROGRAM PLC_PRG
VAR
    button_raw      AT %IX0.0 : BOOL;       (* bouncing contact *)
    button_clean    : BOOL;                  (* after DEBOUNCE *)
    button_pressed  : BOOL;                  (* single-shot per press *)
    relay_lamp      AT %QX0.0 : BOOL;        (* lamp as self-hold *)
    fbDeb           : DEBOUNCE;              (* instance *)
    fbTrig          : R_TRIG;                (* edge detector *)
END_VAR

fbDeb(IN := button_raw, tDebounce := T#20ms);
button_clean := fbDeb.Q;

fbTrig(CLK := button_clean);
button_pressed := fbTrig.Q;

(* Self-hold: toggle on every rising edge *)
IF button_pressed THEN
    relay_lamp := NOT relay_lamp;
END_IF;
END_PROGRAM

DEBOUNCE se construye internamente con dos bloques TON (dirección alta y baja) — uno lleva Q a TRUE solo tras T_Debounce con IN activo, el otro lo lleva a FALSE solo tras T_Debounce con IN inactivo. Esto hace el filtro simétrico: ni el rebote del contacto al pulsar ni al soltar producen un fallo.

Uso típico: pulsadores mecánicos, finales de carrera, sensores basados en contacto. Para “un solo disparo por pulsación” — como se muestra arriba — encadene un R_TRIG después de Q.

Ejemplo 2 — Autorretención con anulación de modo (JK_FF)

JK_FF es un flipflop biestable con antirrebote de pulsador incorporado. En cada flanco ascendente estable de xButton conmuta Q entre TRUE y FALSE — de modo que un pulsador simple se convierte en un interruptor “on/off” sin que el programa de aplicación tenga que cablear a mano la lógica DEBOUNCE + R_TRIG + toggle.

Distribución de pines

Ejemplo de código

Un control de lámpara con tres pulsadores: T1 conmuta la lámpara, T_Mains la fuerza encendida (p. ej. “luz principal en todas partes”), T_Off apaga todo:

PROGRAM PLC_PRG
VAR
    bButtons     AT %IX0.0 : ARRAY [0..3] OF BOOL;
    relay_lamp   AT %QX0.0 : BOOL;
    fbToggle     : JK_FF;
END_VAR

fbToggle(
    xButton    := bButtons[0],   (* toggle button T1 *)
    tDebounce  := T#20ms,
    J          := bButtons[1],   (* main light ON while held *)
    K          := bButtons[2]    (* main light OFF while held *)
);

relay_lamp := fbToggle.Q;
END_PROGRAM

Tabla de verdad de las entradas J/K:

xStable permite implementar la lógica de “el pulsador está pulsado ahora” (p. ej. un LED que visualice la pulsación sin tener que esperar al efecto de conmutación).

Sincronización de la biblioteca entre editor y PLC

La biblioteca estándar reside en dos lugares:

• Lado del editor: editor/resources/library/standard_library.json (compilado en el .exe mediante el sistema de recursos de Qt).
• Lado del PLC: submódulo de anvild, mismo archivo JSON, incluido por el paso make sobre las fuentes C cargadas.

La sincronización de la biblioteca compara SHA-256 de ambas versiones al conectarse. En caso de divergencia aparece una nota en el panel de salida; la reacción es configurable:

• Preferences > Library > Auto-Push desactivado (predeterminado): push manual mediante Tools > Sync Library. Protege un runtime de producción contra una sobrescritura accidental por parte de un editor más antiguo.
• Preferences > Library > Auto-Push activado: la divergencia desencadena un push automático. Útil en configuraciones de desarrollo con un único programador.

Extensiones de ForgeIEC

Los siguientes bloques no están estandarizados en IEC 61131-3 pero se incluyen como parte de la biblioteca estándar porque su uso ha demostrado ser universalmente útil en la práctica:

Estos bloques se ubican en Standard Function Blocks / Application y están marcados como isStandard: true en el JSON fuente, identificándolos como “no eliminables” (es decir, no pueden eliminarse accidentalmente desde el panel Biblioteca).

Añadir sus propios bloques a la biblioteca de usuario

Toda declaración FUNCTION_BLOCK y FUNCTION en el proyecto actual aterriza automáticamente en User Library. Tiempos de visibilidad:

1. En el panel Biblioteca: inmediatamente tras declarar y guardar la POU.
2. En el autocompletado de código (Ctrl-Espacio): inmediatamente.
3. En el editor FBD/LD como bloque: inmediatamente.
4. En el PLC tras Compile + Upload.

Para reutilizar un bloque entre proyectos, exporte la POU mediante File > Export POU... como archivo .forge-pou e impórtelo en el proyecto de destino — una “biblioteca de espacio de trabajo” multiproyecto está en el backlog.

Temas relacionados

• Sintaxis de Structured Text — cómo se ve la llamada a un bloque en ST.
• Editor de Function Block Diagram — cómo se cablea un bloque gráficamente.
• Panel de variables — cómo el pool de direcciones ve la instancia.