 Utilización del Gestor de Librerías

Las librerías de ISaGRAF proporcionan una interfase estándar entre el desarrollo de automatizaciones y las capacidades de software y hardware del sistema ISaGRAF objeto. Existe una librería para cada tipo de interfase. El Gestor de Librerías del banco de trabajo ISaGRAF está orientado al proveedor de hardware o al ingeniero de software, quienes utilizan el gestor de librerías para describir la interfase de programación ISaGRAF de los objetos que crean.

Gestión de elementos de librería

Configuración de E/S

Equipos complejos de E/S

Tarjetas de E/S

Funciones y bloques escritos en lenguajes IEC

Funciones y bloques de función "C"

Funciones de conversión

Archivar los elementos de librería

El Gestor de Librerías del banco de trabajo ISaGRAF muestra los elementos que contiene una de las librerías ISaGRAF. En la parte izquierda de la ventana se encuentra la lista de elementos de la librería seleccionada. En la parte derecha se encuentran las notas técnicas (manual del usuario) del elemento que está seleccionado en la lista de elementos. Los menús del Gestor de Librerías contienen los comandos necesarios para crear, definir o modificar los elementos de la librería activa. El comando "Fichero / Otra librería" permite la selección de una de las librerías ISaGRAF. También se puede utilizar la ventana desplegable situada a la izquierda de la barra de herramientas para seleccionar una librería:


Gestión de elementos de librería

Utilizar los comandos del menú "Fichero" para crear elementos y trabajar con elementos existentes en la librería abierta.

Creación de elementos nuevos

Trabajar con elementos existentes

Configuración de protección por contraseña

Compilación de funciones y bloques de función

Notas técnicas

Parámetros

Código fuente "C"


Creación de elementos nuevos

El comando "Nuevo" del menú "Fichero" añade un elemento nuevo a la librería seleccionada. Se introduce el nombre del elemento nuevo, con base en las siguientes normas de denominación:

- la longitud máxima de un nombre es de 8 caracteres

- el primer carácter tiene que ser una letra

- los restantes caracteres tienen que ser letras, dígitos o el carácter de subrayado '_'

- los nombres de los elementos de librería son insensibles al uso de mayúsculas o minúsculas

Se asocia un comentario de texto a cada elemento de librería. Se introduce este comentario a la hora de crear el elemento. Cuando se crea un elemento nuevo, se tiene que introducir lo siguiente:

- su definición para una configuración de E/S,

- sus parámetros para una tarjeta de E/S, y

- su interfase de usuario para una función o un bloque de función.

Cuando se crea una conversión "C", una función "C" o un bloque de función "C", se genera automáticamente un marco completo de código fuente.


Trabajar con elementos existentes

El comando "Fichero / Renombrar" permite al usuario cambiar el nombre o el comentario del elemento que ha seleccionado en la lista de elementos. El comando "Fichero / Copiar" permite al usuario copiar el elemento que está seleccionado en la librería activa sobre otro elemento de la misma librería. Si el elemento destino ya existe, todo su contenido queda sobrescrito. Si el elemento destino no existe, se crea automáticamente. El comando "Fichero / Borrar" elimina el elemento seleccionado de la librería activa. Los siguientes componentes del elemento están gestionados por los comandos "Renombrar", "Copiar" y "Borrar":

- notas técnicas

- definición completa para una configuración de E/S

- parámetros para una tarjeta de E/S o un equipo complejo

- definición de interfase para una función o un bloque de función

- código fuente para una función o un bloque de función, escrito en un lenguaje IEC

- código fuente para una conversión "C", una función o un bloque de función

 Si el elemento es una conversión "C", una función "C" o un bloque de función "C", los comandos "Renombrar" o "Copiar" no actualizan el nombre automáticamente en el código fuente asociado.

 Si el elemento es una función escrita en un lenguaje IEC, los comandos "Renombrar" o "Copiar" no cambian el nombre del parámetro de retorno.


Configuración de protección por contraseña

El comando "Fichero / Establecer contraseña" permite al usuario definir la protección por contraseña del elemento seleccionado en la librería que está abierta. Para mayor información sobre los niveles de contraseña y la protección de datos, véase la sección titulada "Protección por contraseñas", localizada al final de la primera parte de este manual. Las contraseñas sólo guardan relación con el elemento seleccionado. No influyen en otros elementos de las librerías ISaGRAF.


Compilación de funciones y bloques de función

Cuando se selecciona la librería de funciones o bloques de función escritos en lenguajes IEC, se utiliza el comando "Verificar (compilar)" del menú "Fichero" para comprobar la sintaxis del elemento seleccionado y crear su código objeto. Las funciones y los bloques de función escritos en lenguajes IEC tienen que compilarse sin errores antes de que puedan ser utilizados en un proyecto ISaGRAF. Este comando no tiene efecto si se ha seleccionado otra librería.


Notas técnicas

El comando "Edición / Nota técnica" permite al usuario introducir las notas técnicas relativas al elemento que está seleccionado en la librería activa. Se introducen las notas técnicas con el editor de textos ISaGRAF. Las notas técnicas de un elemento son la guía del usuario y serán consultadas por el usuario del elemento durante su integración en un proyecto ISaGRAF. Las notas técnicas sobre cómo utilizar el elemento deben contener la descripción de sus funciones principales y una explicación detallada de su interfase de programación y parámetros, así como de su contexto y sus límites.

El comando "Herramientas / Formato estándar de nota " le permite al usuario definir un formato estándar de texto para todos los elementos de la librería seleccionada. Cuando se editan las notas técnicas para un elemento nuevo, se utiliza este formato como marco principal. Esto permite al usuario la optimización de sus tareas de edición de notas técnicas.


Parámetros

Los parámetros de un elemento describen la interfase que existe entre las operaciones de cómputo que proporciona el elemento y el uso del elemento en una aplicación ISaGRAF. Los parámetros tienen un significado diferente para cada tipo de elemento de librería.

Los parámetros de una configuración de E/S definen el conjunto completo de tarjetas de E/S de la configuración y los nombres de variables por defecto que se utilizan para los canales de E/S. Los parámetros de una tarjeta de E/S o un equipo complejo definen la configuración física y lógica de la tarjeta. Los parámetros de una función o un bloque de función definen la interfase del elemento, de acuerdo con las convenciones de llamada del lenguaje ST. No existen parámetros para una función de conversión, ya que utiliza una interfase estándar predefinida.


Código fuente "C"

El banco de trabajo ISaGRAF permite al programador gestionar el código fuente de una conversión, función o bloque de función procedente de la librería. El código fuente de una función o de un bloque de función escrito en un lenguaje IEC es un texto o un diagrama descrito en el lenguaje asociado a la función. El código fuente de los componentes "C" (funciones "C", bloques de función "C" y funciones de conversión) se dividen en dos ficheros independientes: una cabecera de fuente C que contiene la definición exacta de la interfase, de acuerdo con la definición de parámetros del elemento, y un fichero de código fuente C que contiene la implementación operativa del elemento.

El banco de trabajo ISaGRAF genera el fichero de código fuente cuando se crea un nuevo elemento de librería. También crea y actualiza la cabecera de fuente, basado en la definición de los parámetros. El programador puede utilizar el editor de textos ISaGRAF para completar el fichero de código fuente.


Configuración de E/S

La librería ISaGRAF de configuración de E/S proporciona una forma sencilla de inicializar los nuevos proyectos ISaGRAF con una configuración de E/S predefinida. Una configuración de E/S define:

- un conjunto de tarjetas de E/S

- los valores por defecto de los parámetros de las tarjetas de E/S

- los nombres por defecto de los canales de E/S

Cuando se crea un nuevo proyecto ISaGRAF con una configuración de E/S procedente de la librería, se establece automáticamente la conexión de E/S correspondiente y las variables de E/S que correspondan a los nombres de canales se declaran automáticamente en el diccionario del proyecto.

 Para realizar la definición de una configuración de E/S, se utiliza la herramienta de Conexión de E/S de ISaGRAF (la misma herramienta que se utiliza dentro de un proyecto). Para mayor información sobre la manera de utilizar esta herramienta, véase la sección titulada "Conexiones de E/S", de este manual. Cuando se inserta una nueva tarjeta de E/S en la configuración, se declaran todos los canales de la tarjeta nueva  con nombres estándares por defecto. El nombre estándar por defecto de un canal de E/S tiene el siguiente formato:

<dirección><tipo><número_ranura>_<número_canal>

El primer carácter indica la dirección del canal de E/S:

"I"	canal de entrada

"O"	canal de salida

El segundo carácter indica el tipo de canal de E/S:

"X"	booleano

"D"	analógico

"M"	mensajes

A continuación se muestran algunos ejemplos de nombres estándares de canal de E/S:

IX0_7	entrada booleana - tarjeta #0 - canal #7

QD2_4	salida valores enteros - tarjeta #2 - canal #4

Se utiliza el comando "Definir canal / parámetro " del Editor de Conexiones de E/S para modificar el nombre por defecto que se asocia a un canal de E/S.


Equipos complejos de E/S

Todos los canales de un única tarjeta son del mismo tipo (booleanos, analógicos o mensaje) y dirección (entrada o salida). Un equipo complejo de E/S representa un dispositivo de E/S con canales de diferentes tipos o direcciones. Los equipos complejos de E/S están representados en forma de una lista de tarjetas individuales de E/S. Utiliza una sola ranura en la lista del chasis de conexiones de E/S.

 Para definir un equipo complejo de E/S, el usuario tiene que especificar la lista de tarjetas individuales que define al equipo de E/S. También tiene que introducir los parámetros detallados de cada tarjeta individual. Se introduce la lista de tarjetas individuales de E/S por medio de una ventana de diálogo.

Se utiliza el botón "Añadir" para añadir una tarjeta individual al final de la lista actual. El botón "Insertar" se utiliza para insertar una tarjeta nueva delante de la selección actual en la lista. El botón "Borrar" elimina de la lista la tarjeta que está seleccionada. Los botones "Renombrar" y "Parámetros" se utilizan para cambiar el nombre y los parámetros de la tarjeta individual que está seleccionada. Para una explicación completa de los parámetros de una tarjeta individual, véase la siguiente sección. Un equipo complejo de E/S puede agrupar hasta 16 tarjetas individuales de E/S. El nombre de una tarjeta individual (dentro de un equipo de E/S) no puede superar los 8 caracteres.


Tarjetas de E/S

La librería ISaGRAF de tarjetas de E/S define una interfase estándar entre las variables de una aplicación y el hardware objeto. Durante la descripción de la aplicación, se conectan todas las variables de E/S a los canales de las tarjetas objeto de E/S. Se definen las tarjetas ISaGRAF de E/S con un nombre y una "clave OEM" que identifica al proveedor. Existen otros parámetros que describen la topología de la tarjeta de E/S (número de canales, dirección y tipo de canal) y su configuración hardware y software.

Parámetros de tarjetas de E/S

Parámetros OEM


Parámetros de tarjetas de E/S

Existen dos tipos diferentes de parámetros para una tarjeta de E/S: los parámetros comunes que se definen para cualquier tarjeta de la librería ISaGRAF, y los parámetros OEM que son específicos para la implementación de la tarjeta, facilitados por el proveedor del hardware. Los parámetros comunes se introducen en la parte superior de la ventana en la que se definen los parámetros de la tarjeta de E/S. Estos parámetros (junto con el nombre de la tarjeta de E/S) identifican la interfase ISaGRAF estándar de las tarjetas de E/S.

La "Clave OEM" es un número simple que define al proveedor del hardware. Todas las tarjetas que estén definidas por el mismo proveedor tienen que tener la misma clave OEM. La Clave OEM es una palabra sin signo de 16 bits que se introduce en formato hexadecimal. La Clave OEM que se ha reservado para CJ International es "1".

Los parámetros principales definen la topología de la tarjeta de E/S. El número de canales define el número de canales disponibles en la tarjeta. El tipo de la tarjeta es el tipo de variables que pueden conectarse a los canales de la tarjeta. La dirección define si las variables que se conectan a la tarjeta son variables de entrada o de salida.

Nota:	No se pueden agrupar las variables de E/S de diferentes tipos o direcciones en una misma tarjeta ISaGRAF de E/S. Para ello se requiere un equipo complejo de E/S.


Parámetros OEM

Se introducen los parámetros OEM en la parte inferior de la ventana de definición de los parámetros de la tarjeta de E/S. Estos parámetros están definidos por el proveedor de la tarjeta de E/S y son específicos para ésta. Una tarjeta puede tener un máximo de 16 parámetros OEM, aunque también existe la posibilidad de que no tenga ninguno. El Gestor de Librerías ISaGRAF le permite al proveedor que defina la identificación y el formato de cada parámetro, así como la manera en la que el programador de automatización debe introducirlo.

La subventana de la izquierda contiene la lista de parámetros OEM. Cada parámetro está identificado con un nombre y un número lógico entre 0 y 15. La zona de la derecha contiene la descripción detallada del parámetro que está seleccionado en la lista. Se selecciona un parámetro en la lista para poder acceder a su descripción completa. Pulsar el botón "Borrar" para volver a iniciar la descripción del parámetro y eliminarlo de la lista de parámetros. Advertencia: no se puede "deshacer" este comando.

Se utiliza el nombre de un parámetro para identificar el campo de entrada correspondiente durante la conexión de una tarjeta de E/S, si el campo tiene que estar definido por el operador de la automatización. Los nombres de los parámetros tienen que cumplir con las siguientes normas:

- la longitud del nombre no puede superar los 16 caracteres

- el primer carácter tiene que ser una letra

- los restantes caracteres tienen que ser letras, dígitos o caracteres de subrayado '_'

El tipo de un parámetro define el formato interno del parámetro y su formato de entrada durante la conexión de E/S de la aplicación. Se dispone de los siguiente formatos internos:

word	palabra de 16 bits, sin signo

long	palabra de 32 bits, sin signo

word hexa	palabra de 16 bits, sin signo

long hexa	palabra de 32 bits, sin signo

booleano	palabra de 16 bits, sin signo (sólo se usa el bit más bajo)

carácter	palabra de 16 bits, sin signo (sólo se usa el byte más bajo)

cadena	matriz de 16 bytes que contiene una cadena de terminación nula

flotante	valor flotante de 32 bits, de simple precisión

Se dispone de los siguientes formatos de entrada:

word	palabra decimal, sin signo

long	palabra decimal larga

word hexa	palabra hexadecimal, sin signo

long hexa	palabra hexadecimal larga, sin signo

booleano	"verdadero" o "falso"

carácter	carácter simple

cadena	cadena ASCII (sólo 15 caracteres como máximo)

flotante	valor flotante de simple precisión

Se utiliza la subventana "Acceso" para definir la manera que tiene el usuario final de acceder al parámetro. Si se selecciona la opción "Definido por usuario ", se muestra el parámetro como un campo de entrada durante la conexión de la tarjeta de E/S. Se utiliza el valor por defecto de los parámetros OEM como el valor por defecto para la edición de parámetros. Si se selecciona la opción "Oculto", el parámetro es una constante y no aparece en la ventana de conexión de la tarjeta de E/S. El valor por defecto de los parámetros OEM define el valor del parámetro constante. La opción "Solo lectura" indica que el parámetro es visible para el usuario, pero no puede ser modificado. Se utiliza su valor por defecto como un valor constante.


Funciones y bloques escritos en lenguajes IEC

ISaGRAF maneja una librería de funciones y bloques de función escritos en lenguajes IEC. Se dispone de los siguientes lenguajes para describir estas funciones o bloques de función: FBD (Diagrama de Bloques de función), LD (Diagrama de Escalera (Contactos)), ST (Texto Estructurado) o IL (Lista de Instrucciones). Se pueden mezclar los lenguajes LD y FBD en un mismo diagrama. No se puede utilizar el lenguaje SFC (Diagrama de Funciones Secuenciales) para describir una función o un bloque de función en una librería. Se selecciona el lenguaje asociado a un elemento de librería cuando se crea la función, y no se puede cambiar posteriormente.

Compilación

Introducción de código fuente

Diccionario de variables locales

Definición de la interfase


Compilación

Las funciones y los bloques de función que están definidos en la librería tienen que ser compilados (verificados) antes de que puedan ser utilizados en un proyecto ISaGRAF. No hay que realizar más cambios a nivel de librería en relación a funciones y bloques de función. Los elementos de la librería aparecerán automáticamente en el menú de selección cuando se utiliza el editor de gráficos LD/FBD en un proyecto.

 	Las funciones definidas en la librería pueden invocar a otras funciones de la librería. Sin embargo, el sistema ISaGRAF no soporta la recursividad en la invocación de funciones. Un bloque de función escrito en lenguaje IEC no puede invocar a otros bloques de función (ni en lenguaje IEC ni en lenguaje "C").


Introducción de código fuente

Se introduce el código fuente de una función o un bloque de función de la librería por medio de las herramientas ISaGRAF estándares: el editor de gráficos para los programas LD o FBD y el editor de textos para los programas ST o IL. Para mayor información sobre estas herramientas, véanse las secciones correspondientes de este manual. Se puede invocar al Generador de Código ISaGRAF directamente desde la ventana de edición de gráficos o texto, con la finalidad de compilar el código fuente de una función o bloque de función de la librería.


Diccionario de variables locales

Una función o bloque de función de librería puede tener variables locales y palabras definidas locales. Para acceder a la declaración variable, el usuario tiene que ejecutar las ordenes del comando "Diccionario" del menú "Fichero", en la ventana de edición, mientras edita el código fuente de la función.

 Una función o bloque de función de la librería no puede acceder a las variables globales o a las instancias de los bloque de función. Se tienen que inicializar las variables locales de una función en el cuerpo de la función.

Las variables locales de un bloque de función escrito en lenguaje IEC son copiadas (instanciadas) cada vez que se utiliza el bloque en un proyecto. Las variables locales de una instancia mantienen sus valores entre una invocación y otra.


Definición de la interfase

Las funciones y los bloques de función pueden poseer hasta 32 parámetros (de entrada o salida). Una función siempre tiene un único parámetro de retorno, que debe tener el mismo nombre que la función para cumplir con las normas de escritura del lenguaje ST.

La lista que aparece en la parte superior izquierda de la ventana muestra los parámetros, ordenados de acuerdo con el modelo de invocación: los parámetros de llamada en primer lugar y los de retorno en el último lugar. La parte inferior de la ventana muestra una descripción detallada del parámetro que está seleccionado en la lista. Se puede utilizar cualquiera de los tipos de datos ISaGRAF para un parámetro. Los parámetros de retorno tienen que estar ubicados después de los de llamada, dentro de la lista. Los nombres de los parámetros tienen que cumplir con las siguientes normas:

- la longitud máxima de un nombre es de 16 caracteres

- el primer carácter tiene que ser una letra

- los restantes caracteres tienen que ser letras, dígitos o el carácter de subrayado '_'

- los nombres son insensibles al uso de mayúsculas o minúsculas

Se utiliza el comando "Insertar" para insertar un parámetro nuevo delante del parámetro seleccionado. Se utiliza el comando "Borrar" para borrar el parámetro seleccionado. El comando "Ordenar" reordena (clasifica) los parámetros de forma automática, colocando los parámetros de retorno al final de la lista.


Funciones y bloques de función "C"

Las funciones y los bloques de función "C" son funciones de cómputo que se invocan desde la aplicación de automatización, según la interfase de invocación de funciones del lenguaje ST.

Las funciones son procesos síncronos. Se suspende la aplicación ISaGRAF objeto durante la ejecución de funciones. Los bloques de función asocian operaciones y datos estáticos ocultos. Por ejemplo, un bloque de función de "contador" representa tanto la operación de contaje como su resultado. Se pueden utilizar las funciones y los bloques de función para completar las capacidades estándares de los lenguajes de automatización, o para acceder a los recursos del sistema.

 Se utiliza la ventana de definición de parámetros para definir el nombre y tipo de cada parámetro de llamada o retorno de la función o bloque de función. Se utilizan los comandos del menú "Edición" para definir los parámetros de la función o el bloque de función seleccionado. Una función puede tener hasta 31 parámetros de llamada, y siempre tiene un único parámetro de retorno. Un bloque de función puede tener hasta 32 parámetros y cualquier combinación de parámetros de llamada y retorno. A continuación se muestra la correspondencia entre tipos ISaGRAF y tipos "C":

BOOLEANO	unsigned long	palabra de 32 bits, sin signo: 1=verdadero / 0=falso
ANALOGICO	long	palabra entera de 32 bits, con signo
REAL	float	valor flotante, simple precisión
TEMPORIZADOR	unsigned long	palabra entera de 32 bits, sin signo (la unidad es 1 ms)
MENSAJE	char *	cadena de caracteres

Cuando se transmite un valor de mensaje a una función o un bloque de función "C", no puede contener caracteres nulos. La cadena que se transmite al código "C" tiene la terminación nula.

Para mayor información sobre la manera de gestionar el código fuente en "C" de una función o un bloque de función y de cómo integrar un elemento nuevo en el sistema objeto de ISaGRAF, véase la Guía de Usuario de Objeto ISaGRAF.


Funciones de conversión

Una función de conversión es una función "C" que invoca el Gestor de E/S de ISaGRAF cada vez que se da de entrada al, o salida del, proyecto a las variables analógicas que utilizan esta conversión.

La función crea la relación entre el valor eléctrico de la variable (el valor leído por el sensor de entradas o enviado al dispositivo de salida) y su valor físico (el valor utilizado en las sentencias de la aplicación). La función se divide, por tanto, en dos partes: la conversión de entradas y la conversión de salidas. El Gestor de Librerías de ISaGRAF le permite al usuario controlar el código fuente en "C" de una función de conversión.

Se puede utilizar la función de conversión para las variables analógicas enteras o reales. Esto implica que la interfase de la función de conversión siempre esté definida por valores flotantes. La interfase es siempre la misma para cualquier función de conversión. Se realiza la definición en "C" de esta interfase en el fichero de definición "TACN0DEF.H".

Para mayor información sobre la manera de gestionar el código fuente en "C" de una función de conversión y de cómo integrar un elemento nuevo en el sistema objeto de ISaGRAF, véase la Guía de Usuario de Objeto ISaGRAF.


Archivar los elementos de librería

El comando de menú "Herramientas / Archivo" ejecuta el gestor de archivos de ISaGRAF para guardar, gestionar o recuperar elementos de librería. Primero se necesita seleccionar una librería antes de ejecutar el comando "Archivo". El gestor de archivos muestra la lista de elementos para una única librería al mismo tiempo.