Manual Somachine

SoMachine
EIO0000000795 06/2017
SoMachine
Funciones y bibliotecas - Guía del usuario
06/2017
EIO0000000795.13
www.schneider-electric.com
La información que se ofrece en esta documentación contiene descripciones de carácter general
y/o características técnicas sobre el rendimiento de los productos incluidos en ella. La presente
documentación no tiene como objeto sustituir dichos productos para aplicaciones de usuario
específicas, ni debe emplearse para determinar su idoneidad o fiabilidad. Los usuarios o
integradores tienen la responsabilidad de llevar a cabo un análisis de riesgos adecuado y
completo, así como la evaluación y las pruebas de los productos en relación con la aplicación o el
uso de dichos productos en cuestión. Ni Schneider Electric ni ninguna de sus filiales o asociados
asumirán responsabilidad alguna por el uso inapropiado de la información contenida en este
documento. Si tiene sugerencias de mejoras o modificaciones o ha hallado errores en esta
publicación, le rogamos que nos lo notifique.
No se podrá reproducir este documento de ninguna forma, ni en su totalidad ni en parte, ya sea
por medios electrónicos o mecánicos, incluida la fotocopia, sin el permiso expreso y por escrito de
Schneider Electric.
Al instalar y utilizar este producto es necesario tener en cuenta todas las regulaciones sobre
seguridad correspondientes, ya sean regionales, locales o estatales. Por razones de seguridad y
para garantizar que se siguen los consejos de la documentación del sistema, las reparaciones solo
podrá realizarlas el fabricante.
Cuando se utilicen dispositivos para aplicaciones con requisitos técnicos de seguridad, siga las
instrucciones pertinentes.
Si con nuestros productos de hardware no se utiliza el software de Schneider Electric u otro
software aprobado, pueden producirse lesiones, daños o un funcionamiento incorrecto del equipo.
Si no se tiene en cuenta esta información, se pueden causar daños personales o en el equipo.
© 2017 Schneider Electric. Reservados todos los derechos.
2 EIO0000000795 06/2017
Tabla de materias
Información de seguridad . . . . . . . . . . . . . . . . . . . . . . . . 5
Acerca de este libro . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Capítulo 1 Descripción general de las bibliotecas . . . . . . . . . . . . . . 11
Conceptos generales acerca de las bibliotecas . . . . . . . . . . . . . . . . . 11
Capítulo 2 Administración de bibliotecas . . . . . . . . . . . . . . . . . . . . . 15
2.1 Métodos de referenciación de bibliotecas . . . . . . . . . . . . . . . . . . . . . . 16
Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Versión directa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Versión más reciente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Mecanismo de marcador de posición . . . . . . . . . . . . . . . . . . . . . . . . . 22
Bibliotecas compatibles con versiones posteriores . . . . . . . . . . . . . . . 24
2.2 Uso de bibliotecas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Diversas maneras de declarar una biblioteca en un proyecto . . . . . . 28
Adición de bibliotecas a un proyecto de SoMachine . . . . . . . . . . . . . . 29
Actualización de bibliotecas y referencias de las bibliotecas . . . . . . . 31
Creación de su propia biblioteca compatible con versiones posteriores 35
Capítulo 3 Editor del Administrador de bibliotecas . . . . . . . . . . . . . 37
Editor del Administrador de bibliotecas . . . . . . . . . . . . . . . . . . . . . . . 38
Agregar biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Propiedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Cargar de nuevo la biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Marcador de posición . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Repositorio de bibliotecas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Ficha Asignación de versiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Capítulo 4 Creación de la propia biblioteca . . . . . . . . . . . . . . . . . . . 61
Información general. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Paso 1: Configuración del proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Paso 2: Cumplimentación de la información del proyecto. . . . . . . . . . 64
Paso 3: Referencia a otras bibliotecas, si es necesario . . . . . . . . . . . 67
Paso 3.1: Uso de referencias de marcador de posición . . . . . . . . . . . 68
Paso 4: Diseño y programación de módulos de biblioteca . . . . . . . . . 69
Paso 5: Diseño de la interfaz. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Paso 6: Implementación de rutinas de tratamiento de errores . . . . . . 69
Paso 7: Configuración de una distribución razonable (restricción de
uso) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
EIO0000000795 06/2017 3
Capítulo 5 Descripción general de bibliotecas. . . . . . . . . . . . . . . . . . 71
Bibliotecas de Schneider Electric. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Otras bibliotecas utilizadas en SoMachine . . . . . . . . . . . . . . . . . . . . . 94
Capítulo 6 Representación de funciones y de bloques de funciones 97
Diferencias entre una función y un bloque de funciones . . . . . . . . . . . 98
Cómo utilizar una función o un bloque de funciones en lenguaje IL . . 99
Cómo utilizar una función o un bloque de funciones en lenguaje ST . 103
Glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Índice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
4 EIO0000000795 06/2017
Información de seguridad
Información importante
AVISO
Lea atentamente estas instrucciones y observe el equipo para familiarizarse con el dispositivo
antes de instalarlo, utilizarlo, revisarlo o realizar su mantenimiento. Los mensajes especiales que
se ofrecen a continuación pueden aparecer a lo largo de la documentación o en el equipo para
advertir de peligros potenciales, o para ofrecer información que aclara o simplifica los distintos
procedimientos.
EIO0000000795 06/2017 5
TENGA EN CUENTA LO SIGUIENTE:
La instalación, el manejo, las revisiones y el mantenimiento de equipos eléctricos deberán ser
realizados sólo por personal cualificado. Schneider Electric no se hace responsable de ninguna
de las consecuencias del uso de este material.
Una persona cualificada es aquella que cuenta con capacidad y conocimientos relativos a la
construcción, el funcionamiento y la instalación de equipos eléctricos, y que ha sido formada en
materia de seguridad para reconocer y evitar los riesgos que conllevan tales equipos.
6 EIO0000000795 06/2017
Acerca de este libro
Presentación
Objeto
En este documento se describen las bibliotecas, la gestión de bibliotecas y las implementaciones
de funciones en SoMachine.
Campo de aplicación
Este documento se ha actualizado para la publicación de SoMachine V4.3.
Información relativa al producto
ADVERTENCIA
PÉRDIDA DE CONTROL
 El diseñador del esquema de control debe tener en cuenta las posibles modalidades de fallo
de rutas de control y, para ciertas funciones de control críticas, proporcionar los medios para
lograr un estado seguro durante y después de un fallo de ruta. Algunas funciones de control
críticas son, por ejemplo, la parada de emergencia y la parada de sobrecarrera, un corte de
alimentación o un reinicio.
 Para las funciones de control críticas deben proporcionarse rutas de control separadas o
redundantes.
 Las rutas de control del sistema pueden incluir enlaces de comunicación. Deben tenerse en
cuenta las implicaciones de retardos de transmisión imprevistos o fallos del enlace.
 Tenga en cuenta todas las reglamentaciones para la prevención de accidentes y las
normativas de seguridad locales.1
 Cada instalación de este equipo debe probarse de forma individual y exhaustiva antes de
entrar en servicio.
El incumplimiento de estas instrucciones puede causar la muerte, lesiones serias o daño al
equipo.
1 Para obtener información adicional, consulte NEMA ICS 1.1 (última edición), "Safety Guidelines
for the Application, Installation, and Maintenance of Solid State Control" (Directrices de seguridad
para la aplicación, la instalación y el mantenimiento del control de estado estático) y NEMA ICS
7.1 (última edición), "Safety Standards for Construction and Guide for Selection, Installation and
Operation of Adjustable-Speed Drive Systems" (Estándares de seguridad para la construcción y
guía para la selección, instalación y utilización de sistemas de unidades de velocidad ajustable) o
su equivalente aplicable a la ubicación específica.
EIO0000000795 06/2017 7
ADVERTENCIA
FUNCIONAMIENTO IMPREVISTO DEL EQUIPO
 Utilice solo software aprobado por Schneider Electric para este equipo.
 Actualice el programa de aplicación siempre que cambie la configuración de hardware física.
equipo.
Terminología derivada de los estándares

Los términos técnicos, símbolos y las descripciones correspondientes del presente manual o que
aparecen en la parte interior o exterior de los propios productos se derivan, por lo general, de los
términos y las definiciones de estándares internacionales.
En el área de los sistemas de seguridad funcional, unidades y automatización general se incluyen,
pero sin limitarse a ellos, términos como seguridad, función de seguridad, estado de seguridad,
fallo, reinicio tras fallo, avería, funcionamiento incorrecto, error, mensaje de error, peligroso, etc.
Estos estándares incluyen, entre otros:
Estándar Descripción
EN 61131-2:2007 Controladores programables, parte 2: Requisitos y ensayos de los equipos.
ISO 13849-1:2008 Seguridad de la maquinaria: partes de seguridad de los sistemas de control.
Principios generales del diseño.
EN 61496-1:2013 Seguridad de la maquinaria: equipo de protección electrosensible.
Parte 1: Requisitos y ensayos generales.
ISO 12100:2010 Seguridad de las máquinas. Principios generales para el diseño. Evaluación del
riesgo y reducción del riesgo
EN 60204-1:2006 Seguridad de las máquinas. Equipo eléctrico de las máquinas. Parte 1:
Requisitos generales
EN 1088:2008 Seguridad de la maquinaria. Dispositivos de bloqueo asociados con
ISO 14119:2013 protecciones: principios de diseño y selección
ISO 13850:2006 Seguridad de la maquinaria. Parada de emergencia: principios de diseño
EN/IEC 62061:2005 Seguridad de la maquinaria. Seguridad funcional de los sistemas de control
programable de seguridad eléctrica y electrónica
IEC 61508-1:2010 Seguridad funcional de sistemas de seguridad programable eléctricos y
electrónicos: requisitos generales.
IEC 61508-2:2010 Seguridad funcional de los sistemas de seguridad electrónicos programables
eléctricos y electrónicos: requisitos de los sistemas de seguridad electrónicos
programables eléctricos y electrónicos.
IEC 61508-3:2010 Seguridad funcional de los sistemas de seguridad electrónicos programables
eléctricos y electrónicos: requisitos de software.
8 EIO0000000795 06/2017
IEC 61784-3:2008 Comunicación digital de datos para la medición y control: buses de campo de
seguridad funcional.
2006/42/EC Directiva de maquinaria
2014/30/EU Directiva de compatibilidad electromagnética
2014/35/EU Directiva de baja tensión
Además, los términos utilizados en este documento se pueden usar de manera tangencial porque
se obtienen de otros estándares como:
Serie IEC 60034 Máquinas eléctricas giratorias
Serie IEC 61800 Accionamientos eléctricos de potencia de velocidad variable
Serie IEC 61158 Comunicación digital de datos para la medición y control - Bus de campo para
su uso en Sistemas de control
Por último, el término zona de funcionamiento se puede utilizar junto con la descripción de peligros
específicos, y se define como tal para una zona de peligro o zona peligrosa en la Directiva de
maquinaria (2006/42/EC) y ISO 12100:2010.
NOTA: Los estándares mencionados anteriormente podrían o no aplicarse a los productos
específicos citados en la presente documentación. Para obtener más información en relación con
los diferentes estándares aplicables a los productos descritos en este documento, consulte las
tablas de características de las referencias de dichos productos.
EIO0000000795 06/2017 9
10 EIO0000000795 06/2017
SoMachine
Descripción general de las bibliotecas
EIO0000000795 06/2017
Capítulo 1
Conceptos generales acerca de las bibliotecas
Contenido de las bibliotecas

Las bibliotecas proporcionan los elementos siguientes que se ejecutan en el sistema en tiempo de
ejecución del controlador:
 funciones y bloques de funciones
 definiciones de tipos de datos
 variables globales
 variables de sistema
 objetos de visualización
La administración de las bibliotecas en un proyecto se realiza mediante los Administradores de

bibliotecas para todo el proyecto o bibliotecas con un controlador específico. La instalación de
bibliotecas se lleva a cabo durante la instalación de los elementos (dispositivos, soluciones,
controladores) que seleccione para instalar con SoMachine Configuration Manager. En el caso de
bibliotecas definidas por el usuario, el usuario las administra a través de SoMachine directamente.
EIO0000000795 06/2017 11
Información de bibliotecas
En el Administrador de bibliotecas encontrará las bibliotecas incluidas, y en el Repositorio de
bibliotecas encontrará las bibliotecas disponibles:
Información Descripción Ejemplo

Nombre nombre de la biblioteca Biblioteca Altivar
(ATV)
Versión versión de la biblioteca 1.0.1.8
Empresa El proveedor principal o el nombre de grupo Schneider Electric
definido por el proveedor principal de la biblioteca,
tal como se muestra en el cuadro de diálogo
Administrador de bibliotecas y Repositorio de
bibliotecas.
Espacio de Espacio de nombres predeterminado de la SEC
nombres biblioteca para acceder a las funciones de esta.
NOTA: Conviene utilizar siempre el espacio de
nombres predeterminado como espacio de
nombres usado en la aplicación.
Si después del espacio de nombres
predeterminado se muestra "qualified-access-
only" (sólo acceso cualificado), esto indica que el
uso del espacio de nombres en la aplicación es
obligatorio.
Categoría La categoría (o las categorías) a que pertenecen Dispositivos →
estas bibliotecas, tal como se muestra en el cuadro ATV31/ATV312
de diálogo Administrador de bibliotecas y
Repositorio de bibliotecas.
12 EIO0000000795 06/2017
Espacio de nombres
Un espacio de nombres de una biblioteca es un símbolo que permite un acceso exclusivo a los
componentes de biblioteca conectados (funciones, bloques de funciones, variables…). El espacio
de nombres es obligatorio cuando dos componentes de dos bibliotecas distintas usadas en el
mismo proyecto tienen el mismo nombre. El uso del espacio de nombres en la aplicación es
obligatorio si la biblioteca tiene establecido el atributo qualified-access-only . Para garantizar un
acceso exclusivo al componente correcto, use el formato de nombre completo
<namespace>.<component>, incluido el espacio de nombres.
Caso Descripción
1 Existe un bloque de funciones GEN en la biblioteca Servicio. El espacio de
nombre de la biblioteca Servicio es Servicio. Una instancia del bloque de
funciones GEN puede declararse con o sin el espacio de nombre de la
biblioteca si el nombre GEN es único dentro del proyecto:
MyGenerator: Servicio.GEN;
o MyGenerator: GEN;
2 Se ha creado un bloque de funciones GEN dentro del proyecto. El uso del
espacio de nombres de la biblioteca Servicio permitirá al sistema acceder al
bloque de funciones GEN de la biblioteca Servicio. Sin espacio de nombres,
se accederá al bloque de funciones del proyecto GEN:
MyGenerator_Servicio: Servicio.GEN;
MyGenerator_Project: GEN;
3 En el proyecto se declara otra biblioteca, que también contiene un bloque de
funciones llamado GEN, con el espacio de nombres NuevaBibl. El uso del
espacio de nombres se hace obligatorio para identificar el bloque de funciones
correcto GEN al que va a accederse:
MyGenerator_Servicio: Servicio.GEN;
MyGenerato_NuevaBibl: NuevaBibl.GEN;
Se define un espacio de nombres predeterminado para cada biblioteca.
Repositorio de bibliotecas
El Repositorio de biblioteca es el editor que gestiona bibliotecas instaladas en SoMachine. El
Repositorio de biblioteca permite instalar o eliminar bibliotecas definidas por el usuario. Una
biblioteca solo se puede utilizar en un proyecto de SoMachine si está instalada en el Repositorio
de biblioteca. Con la instalación de SoMachine, se instala un conjunto de bibliotecas de forma
predeterminada. Puede instalar nuevas bibliotecas o nuevas versiones de bibliotecas ya
existentes con el SoMachine Configuration Manager.
EIO0000000795 06/2017 13
Administración de bibliotecas mediante los administradores de bibliotecas

Las bibliotecas declaradas en un proyecto se administran con el editor del Administrador de
bibliotecas.
En un proyecto de SoMachine, hay disponibles dos administradores de bibliotecas distintos en
Herramientas (véase SoMachine, Guía de programación) para los diferentes casos de uso de las
bibliotecas:
Caso de uso Ubicación del Administrador de bibliotecas

bibliotecas disponibles En Herramientas, bajo el nodo Aplicación de cada controlador.
para un determinado
controlador
bibliotecas disponibles En Herramientas, bajo la sección Global, añada un
para un proyecto Administrador de bibliotecas.
Para obtener más información sobre la administración de bibliotecas, el Repositorio de bibliotecas

y el Editor del administrador de bibliotecas, consulte Administración de bibliotecas
(véase página 37).
Para obtener más información sobre cómo buscar una función o un bloque de funciones de
bibliotecas con el Buscador FFB, consulte Cómo encontrar una función o un bloque de funciones
con el buscador FFB (véase SoMachine, Guía de programación).
14 EIO0000000795 06/2017
SoMachine
Administración de bibliotecas
EIO0000000795 06/2017
Capítulo 2
Descripción general
En este capítulo encontrará información para gestionar las bibliotecas y las versiones de
bibliotecas de las bibliotecas referenciadas.
Contenido de este capítulo

Este capítulo contiene las siguientes secciones:
Sección Apartado Página
2.1 Métodos de referenciación de bibliotecas 16
2.2 Uso de bibliotecas 27
EIO0000000795 06/2017 15
Sección 2.1
Métodos de referenciación de bibliotecas
Métodos de referenciación de bibliotecas
Esta sección contiene información general sobre los métodos de referenciación de bibliotecas, sus
ventajas y desventajas, así como su uso en SoMachine.
Contenido de esta sección

Esta sección contiene los siguientes apartados:
Apartado Página
Introducción 17
Versión directa 18
Versión más reciente 20
Mecanismo de marcador de posición 22
Bibliotecas compatibles con versiones posteriores 24
16 EIO0000000795 06/2017
Introducción
Tanto los proyectos como las bibliotecas pueden usar funcionalidades externas que se almacenan
en otras bibliotecas independientes. Para utilizar tales funcionalidades, estas bibliotecas
independientes deberán incluirse en el proyecto del Administrador de bibliotecas como bibliotecas
referenciadas. Las bibliotecas referenciadas por bibliotecas usadas en un proyecto o una
biblioteca se denominan bibliotecas referenciadas indirectamente. Estas bibliotecas referenciadas
indirectamente se incluyen de forma automática al llevar a cabo la compilación y no deben
utilizarse en el propio proyecto.
Según el método de referenciación empleado, varían la posibilidad o el efecto de un cambio en la
versión de la biblioteca. Por ejemplo, no se puede cambiar la versión de una biblioteca
referenciada indirecta.
En cambio, los distintos mecanismos de gestión de bibliotecas cambian las versiones de las
bibliotecas. Debido a estos mecanismos, se utiliza una versión de biblioteca idéntica en todas las
referencias de todo el proyecto.
Las bibliotecas se pueden referenciar de modos distintos:
 Versión directa (véase página 18)
 Versión más reciente (véase página 20)
 Mecanismo de marcador de posición (véase página 22)
 Biblioteca compatible con versiones posteriores (véase página 24)
EIO0000000795 06/2017 17
Versión directa
La forma más sencilla de referenciar bibliotecas es definir explícitamente dentro del Administrador
de bibliotecas de un proyecto de aplicaciones o bibliotecas qué biblioteca y qué versión exacta de
la biblioteca deberían usarse.
Si una biblioteca X incorpora otra biblioteca Z con una referencia directa, la biblioteca Z se cargará
exactamente en la versión que incorpora la biblioteca X.
Esta circunstancia puede provocar que se carguen varias versiones de la misma biblioteca en el
Administrador de bibliotecas de un proyecto.
NOTA: Este método permite referenciar varias versiones de una biblioteca dentro del mismo
proyecto. Aunque este método es ventajoso para determinados tipos de bibliotecas, se debe tener
cuidado al aplicarlo a otros para evitar complicaciones. Por consiguiente, este método no se
recomienda generalmente, salvo cuando se indica lo contrario.
ADVERTENCIA
 Verifique si las versiones de las bibliotecas que contiene su programa son correctas, después
de actualizar el software.
 Verifique si las versiones de las bibliotecas actualizadas son coherentes con las especifica-
ciones de su aplicación.
equipo.
Ejemplo
Situación: Las siguientes bibliotecas se añaden al Administrador de bibliotecas:
Biblioteca Versión
Biblioteca X 1.0.0.0
Biblioteca Y 1.0.0.0
Biblioteca Z 1.0.0.0
Dependencias:
Biblioteca... Requiere la biblioteca Z en la versión...

X 1.0.1.0
Y 1.0.2.0
18 EIO0000000795 06/2017
Si se añadiese la biblioteca Z a todas las bibliotecas como una versión de biblioteca directa,
significaría que:
 La biblioteca Z se cargará en tres versiones distintas:
 Las POU del proyecto utilizan directamente las funcionalidades de la versión 1.0.0.0.
 Las POU de la biblioteca X utilizan las funcionalidades de la versión 1.0.1.0.
 Las POU de la biblioteca Y utilizan las funcionalidades de la versión 1.0.2.0.
 Esto puede provocar posibles errores en el compilador; por ejemplo, si el sistema intenta
intercambiar datos entre las POU de la biblioteca Z que utiliza la biblioteca X y entre las POU
de la biblioteca Z que utiliza la biblioteca Y. Esto puede suceder, incluso si la estructura de
datos es idéntica.
 Cuando la referencia de la biblioteca es una referencia de versión directa, no se pueden
cambiar las dependencias indirectas de la biblioteca tras crear la biblioteca.
EIO0000000795 06/2017 19
Versión más reciente
Este método de referenciación es similar al método de referenciación de versión directa.
En lugar de una versión exacta de la biblioteca, se define un símbolo (*) como versión de la
biblioteca referenciada. Cada vez que compila, la versión más reciente de una biblioteca instalada
en local se utiliza en el proyecto actual como versión de biblioteca referenciada.
NOTA: Cuando la versión nueva de una biblioteca se instala en el repositorio de la biblioteca,
todos los proyectos y bibliotecas que hacen referencia a esta biblioteca con la versión más
reciente cambiarán sin previo aviso cuando se compilen. Por lo general, este comportamiento no
es recomendable en la aplicación, pues puede introducir cambios no intencionados durante la
creación o ejecución del programa.
ADVERTENCIA
equipo.
20 EIO0000000795 06/2017
Ejemplo
Biblioteca Versión
Dependencias:
Biblioteca... Requiere la biblioteca Z en la versión...

X 1.0.1.0
Y 1.0.2.0
Además, la siguiente versión de la biblioteca está instalada en el Repositorio de biblioteca:
En el ordenador A En el ordenador B
Biblioteca Z. 1.0.3.0 Biblioteca Z. 1.0.2.0
Si se añadiese la biblioteca Z con el método de la versión más reciente, significaría:
En el ordenador A: En el ordenador B:
La biblioteca X utiliza la versión 1.0.3.0. La biblioteca X utiliza la versión 1.0.2.0.
La biblioteca Y utiliza la versión 1.0.3.0. La biblioteca Y utiliza la versión 1.0.2.0.
EIO0000000795 06/2017 21
Mecanismo de marcador de posición
El mecanismo de marcador de posición emplea una ubicación externa a la biblioteca, el llamado
marcador de posición, para referenciar otra biblioteca.
Cuando se actualizan los dispositivos o se instalan nuevos dispositivos, también se instala la
información relativa a qué versiones de la biblioteca son compatibles con la versión del dispositivo.
El compilador inserta esta información donde se usan los marcadores de posiciones.
Frente a una referencia de la versión más reciente, la referencia de un marcador de posición no
se cambia de forma accidental. La referencia del marcador de posición solamente se cambia
cuando pasa voluntariamente a una versión más nueva de los siguientes componentes:
 Perfil de biblioteca (según la versión del compilador)
 Descripción del dispositivo (para bibliotecas específicas del dispositivo)
 Perfil del proyecto (cuadro de diálogo Marcador de posición en el Administrador de bibliotecas)
El orden de búsqueda para la definición del marcador de posición es (primero la prioridad más
alta):
1. Cuadro de diálogo Marcador de posición
2. Descripción del dispositivo
3. Perfil de biblioteca
La resolución del marcador de posición ya se ha definido correctamente mediante la instalación
de SoMachine.
ADVERTENCIA
equipo.
NOTA: Las versiones del controlador definen los marcadores de posición. Cuando el usuario crea
una nueva biblioteca, no hay un marcador de posición definido por las versiones del controlador
para esta nueva biblioteca. Por ello, el mecanismo del marcador de posición no se puede utilizar
al añadir esta biblioteca personalizada al administrador de bibliotecas de dispositivos.
NOTA: Los nombres de las bibliotecas y las referencias de los marcadores de posición distinguen
entre mayúsculas y minúsculas.
22 EIO0000000795 06/2017
Ejemplo
Situación: Se añaden los siguientes marcadores de posición en el Administrador de bibliotecas en
lugar de las bibliotecas:
Marcador de posición Biblioteca

Marcador de posición X 1.0.0.0
Marcador de posición Y 1.0.0.0
Marcador de posición Z 1.0.0.0
Dependencias:
Biblioteca... Requiere la biblioteca Z por el marcador de

posición Z
X 1.0.1.0
Y 1.0.2.0
Además, los siguientes marcadores de posición se reemplazan por el controlador A:
Versión de la biblioteca definida en el Versión de la biblioteca predeterminada en

controlador A: la ficha Marcador de posición del
Administrador de bibliotecas:
Marcador de posición Z. 1.0.2.0 Biblioteca Z. 1.0.1.0
EIO0000000795 06/2017 23
Bibliotecas compatibles con versiones posteriores
Una biblioteca compatible con versiones posteriores se desarrolla de tal forma que sus funciona-
lidades son compatibles con versiones posteriores. Esto significa que cada versión de una
biblioteca compatible con versiones posteriores contiene todas las funcionalidades de la versión
anterior y una versión más reciente de la biblioteca, que puede usarse de forma sencilla en
proyectos ya existentes sin realizar ningún cambio.
Las dependencias para bibliotecas (la biblioteca X usa la biblioteca Z) se consideran como una
versión mínima compatible.
Si una biblioteca X requiere una biblioteca Z compatible con versiones posteriores (por ejemplo,
en la versión 1.0.0.0), la biblioteca X funcionará con la versión 1.0.0.0 o cualquier versión más
reciente de la biblioteca Z.
Solamente se selecciona y se utiliza una versión simple de una biblioteca compatible con
versiones posteriores en un proyecto de Administrador de bibliotecas previa solicitud (al hacer clic
en el botón Automático). Esta versión compatible de la biblioteca seleccionada en la ficha
Asignación de versiones del Administrador de bibliotecas (véase página 58) se usa en las
referencias directa e indirecta de las bibliotecas de este proyecto.
Este método de referenciación presenta las siguientes ventajas:
 Admite un proceso de desarrollo independiente y paralelo de varias bibliotecas.
 Facilita las actualizaciones de las bibliotecas mediante un conjunto de reglas de desarrollo
compatible con versiones posteriores.
Se supone que cuando se marca la versión de una biblioteca como biblioteca compatible con
versiones posteriores, todas las versiones futuras serán también compatibles con versiones
posteriores.
Para obtener más información sobre cómo crear bibliotecas compatibles con versiones
posteriores, consulte Creación de su propia biblioteca compatible con versiones posteriores
24 EIO0000000795 06/2017
Ejemplo
Biblioteca Versión
Dependencias:
Biblioteca... Requiere una versión mínima de la biblioteca

Z...
X 1.0.1.0
Y 1.0.2.0
Las siguientes versiones de la biblioteca Z están instaladas en el sistema local:

 1.0.0.0
 1.0.1.0
 1.0.2.0
 1.0.3.0
Si partimos de la base que las versiones instaladas de la biblioteca Z están marcadas como
compatibles con versiones posteriores:
 Solo se ha cargado una versión de la biblioteca Z.
 Las versiones compatibles de la biblioteca Z en este proyecto son 1.0.2.0 y 1.0.3.0, las cuales
cumplen con las dependencias mínimas exigidas.
 Puede configurar la versión que se va a utilizar en este caso (sin embargo, es recomendable
utilizar la versión compatible instalada más reciente).
 Tras hacer clic en el botón Automático en la ficha Asignación de versiones del proyecto, se
seleccionará la versión 1.0.3.0 de la biblioteca Z porque es la versión compatible instalada más
reciente.
 Las POU de los proyectos de las bibliotecas X e Y usan las mismas versiones de POU de la
biblioteca Z.
 Es posible realizar el intercambio de POU desde la biblioteca Z entre el proyecto y otras
bibliotecas.
EIO0000000795 06/2017 25
Ejemplo detallado
Situación:
 Una nueva versión 1.0.3.1 de la biblioteca Z utiliza algunas funciones de una biblioteca de
sistema referenciada a través del marcador de posición V.
 Esta biblioteca solo es compatible con el controlador A desde la versión 2.0.0.0. Esto se indica
en la versión 1.0.3.1 de la biblioteca Z mediante un requisito de firmware mínimo del controlador
Esto supondría que:
 Si un proyecto utiliza la versión 1.0.0.0 del controlador A, las siguientes bibliotecas serán
compatibles:
 1.0.2.0
 1.0.3.0
 Si un proyecto utiliza la versión 2.0.0.0 del controlador A, la siguiente biblioteca será

compatible:
 1.0.3.1
 Si el controlador A utilizado en el proyecto se ha actualizado a la versión 2.0.0.0, se

seleccionará la versión 1.0.3.1 de la biblioteca Z al hacer clic en el botón Automático de la ficha
Asignación de versiones.
De lo contrario, se seleccionará la versión 1.0.3.0 de la biblioteca Z.
26 EIO0000000795 06/2017
Sección 2.2
Uso de bibliotecas
Uso de bibliotecas
En esta sección se proporciona información sobre situaciones que puede encontrar al añadir
bibliotecas a un proyecto de SoMachine existente, al actualizar bibliotecas o al crear una biblioteca
compatible con versiones posteriores.
Contenido de esta sección

Esta sección contiene los siguientes apartados:
Apartado Página
Diversas maneras de declarar una biblioteca en un proyecto 28
Adición de bibliotecas a un proyecto de SoMachine 29
Actualización de bibliotecas y referencias de las bibliotecas 31
Creación de su propia biblioteca compatible con versiones posteriores 35
EIO0000000795 06/2017 27
Diversas maneras de declarar una biblioteca en un proyecto
Existen varias maneras de declarar una biblioteca en un proyecto. Las bibliotecas se declaran
automáticamente al añadir lo siguiente:
 un controlador:
 Bibliotecas básicas IEC 61131: Bibliotecas estándar y de servicio
 Biblioteca PLCSystem del controlador
 Otras bibliotecas para gestionar funciones de controlador incrustadas
 características específicas del controlador

 un administrador de buses de campo
 un dispositivo de bus de campo
Algunas bibliotecas se deben añadir manualmente.
NOTA: Algunas funciones y bloques de funciones no se han diseñado para utilizarse en su
programa, pero pueden ser necesarias para el sistema o un dispositivo. Debe utilizar solamente
funciones y bloques de funciones que estén documentados como aplicables para programas, o
funciones o bloques de funciones que haya probado exhaustivamente con su aplicación.
28 EIO0000000795 06/2017
Adición de bibliotecas a un proyecto de SoMachine
El diagrama de flujo y la tabla siguientes representan los mecanismos de referenciación que se
deben utilizar al añadir una biblioteca en el Administrador de bibliotecas a un proyecto de
SoMachine:
EIO0000000795 06/2017 29
Si la biblioteca es... y... utilice el...

Compatible con Pertenece a la categoría de versión directa:
versiones bibliotecas Solución 2) o es una  Define una versión de biblioteca explícita en el
posteriores 1) biblioteca definida por el Administrador de bibliotecas → ficha Biblioteca; por
usuario. ejemplo, Empaquetado, V.1.0.3.0 [Schneider Electric]).
 Para actualizar este tipo de biblioteca, pulse el botón
Automático de la ficha Asignación de versiones del
Administrador de bibliotecas.
Compatible con No pertenece a la categoría de Mecanismo de marcador de posición:
versiones bibliotecas Solución 2) y no es  Seleccione el marcador de posición correspondiente en
posteriores 1) una biblioteca definida por el la ficha Marcador de posición del Administrador de
usuario. bibliotecas; por ejemplo, SE_ToolboxAdvance para la
biblioteca Toolbox_Advance.
 Define una versión de biblioteca predeterminada en la
ficha Marcador de posición del Administrador de
bibliotecas. La versión de biblioteca predeterminada se
utilizará si no hay disponible ninguna descripción del
dispositivo.
 Para actualizar este tipo de biblioteca, pulse el botón
Automático de la ficha Asignación de versiones del
No es compatible con La biblioteca es compatible con Mecanismo de marcador de posición:
versiones el marcador de posición 1)  Seleccione el marcador de posición correspondiente en
posteriores 1) la ficha Marcador de posición del Administrador de
bibliotecas; por ejemplo, SE_ToolboxAdvance para la
biblioteca XBTGC PTOPWM.
 Define una versión de biblioteca predeterminada en la
ficha Marcador de posición del Administrador de
bibliotecas. La versión de biblioteca predeterminada se
utilizará si no hay disponible ninguna descripción del
dispositivo.
No es compatible con La biblioteca no es compatible versión directa:
versiones con el marcador de posición 1)  Define una versión de biblioteca explícita en el
posteriores 1) Administrador de bibliotecas → ficha Biblioteca; por
ejemplo, SE_Packaging, V.1.0.3.0).
1. Para comprobar si la biblioteca que desea añadir es compatible con versiones posteriores o con
marcadores de posición, consulte Bibliotecas de Schneider Electric (véase página 72) y Otras
bibliotecas utilizadas en SoMachine (véase página 94).
2. Para comprobar si la biblioteca que desea añadir pertenece a la categoría Solución, consulte
Bibliotecas de Schneider Electric (véase página 72).
NOTA: Si una biblioteca o versión posterior de la biblioteca es compatible con versiones
posteriores, SoMachine la reconocerá automáticamente y se respetará en el mecanismo de
actualización automático (botón Automático de la ficha Asignación de versiones).
30 EIO0000000795 06/2017
Actualización de bibliotecas y referencias de las bibliotecas
En este tema se describen situaciones que puede encontrar al actualizar bibliotecas.
Cuadro de diálogo Actualizar proyecto

Si uno de los siguientes elementos se ha instalado en el sistema local, cuando se abra un proyecto
existente en SoMachine, aparecerá el cuadro de diálogo Actualizar proyecto:
 una versión del compilador más reciente;
 una versión de visualización más reciente;
 una versión del dispositivo más reciente;
 una versión de la biblioteca más reciente de una de las bibliotecas usadas.
EIO0000000795 06/2017 31
Se producirán los siguientes efectos cuando actualice las bibliotecas mediante el cuadro de
diálogo Actualizar proyecto:
Si... Entonces...
La opción Actualizar todas las bibliotecas del  Se actualizarán todas las bibliotecas con referencias
cuadro de diálogo Actualizar proyecto está directas.
marcada y hace clic en Aceptar.  Todas las bibliotecas con, al menos, una versión de
biblioteca compatible con versiones posteriores instalada
en el Repositorio de biblioteca y la asignación de
versiones de versiones heredadas antiguas, se
actualizarán a la versión más reciente de bibliotecas
compatibles con versiones posteriores.
La opción Actualizar todas las bibliotecas del  No se modificará la referencia de bibliotecas existentes.
cuadro de diálogo Actualizar proyecto no está  Se podrá ejecutar una actualización manual de las
marcada y hace clic en Aceptar. bibliotecas en la ficha Asignación de versiones del
 Las bibliotecas heredadas aparecerán en la ficha
Asignación de versiones, pero se marcarán como
herencia si existe una versión más reciente de la
biblioteca compatible con versiones posteriores.
 Volverá a aparecer el cuadro de diálogo Actualizar
proyecto la próxima vez que abra este proyecto.
Puede omitirlo definiendo la opción No volver a mostrar
este cuadro de diálogo en el cuadro de diálogo Actualizar
proyecto en Configuración del proyecto.
Hace clic en Cancelar.  No se modificará la referencia de bibliotecas existentes.
 Las bibliotecas heredadas aparecerán en la ficha
Asignación de versiones, pero se marcarán como
herencia si existe una versión más reciente de la
 Se podrá ejecutar en el proyecto una actualización
manual de las bibliotecas, el dispositivo, la visualización o
el compilador.
 Volverá a aparecer el cuadro de diálogo Actualizar
proyecto la próxima vez que abra este proyecto.
Puede omitirlo definiendo la opción No volver a mostrar
este cuadro de diálogo en el cuadro de diálogo Actualizar
proyecto en Configuración del proyecto.
32 EIO0000000795 06/2017
Actualización manual de la biblioteca
Si Entonces...
Desea actualizar bibliotecas compatibles con Se podrá ejecutar esta actualización manual en la
versiones posteriores manualmente. ficha Asignación de versiones del Administrador de
bibliotecas.
Al utilizar el botón Automático para actualizar, se
producirán los siguientes efectos:
 Todas las bibliotecas compatibles con versiones
posteriores se actualizarán a la versión más
reciente de la biblioteca compatible con versiones
posteriores.
 Todas las bibliotecas heredadas pasarán a ser
bibliotecas compatibles con versiones posteriores
y se actualizarán a la versión más reciente de la
Para actualizar solo una biblioteca, haga clic con el
botón derecho del ratón en la biblioteca
correspondiente de la ficha Asignación de versiones
y seleccione Editar asignación de versiones
(biblioteca seleccionada).
Desea actualizar bibliotecas no compatibles con Se podrá ejecutar esta actualización manual en la
versiones posteriores manualmente. ficha Bibliotecas del Administrador de bibliotecas.
1. En la ficha Bibliotecas, deberá seleccionar una
biblioteca y hacer clic en Menú → Comandos →
Administrador de bibliotecas → Propiedades.
Resultado: Aparecerá el cuadro de diálogo
Propiedades.
2. En el cuadro de diálogo Propiedades, seleccione
una de las versiones instaladas en el sistema
local y haga clic en Aceptar.
Actualización manual del dispositivo

Al actualizar manualmente la descripción de un dispositivo con Actualizar dispositivo..., también
se actualizarán las siguientes bibliotecas:
 Bibliotecas que el dispositivo incluye automáticamente.
 Bibliotecas que se incluyen como marcadores de posición.
 Bibliotecas compatibles con versiones posteriores.
Para actualizar un dispositivo (véase SoMachine, Guía de programación), haga clic con el botón
derecho del ratón en el dispositivo del Árbol de dispositivos y seleccione Actualizar dispositivo....
EIO0000000795 06/2017 33
Proyecto creado con una versión anterior

En un proyecto creado con una versión anterior de software de SoMachine, las versiones de las
bibliotecas declaradas en el proyecto cambiarán de la siguiente manera:
 Las versiones de las bibliotecas no sufrirán modificaciones en las bibliotecas declaradas con
una versión directa (véase página 18).
 Se actualizarán automáticamente con la versión más reciente (véase página 20) en bibliotecas
declaradas que utilicen el método de versión más reciente (versión identificada con * en el
Administrador de bibliotecas).
 Se actualizarán automáticamente con las versiones definidas en el Archivo de descripción de
dispositivo del controlador después de un comando de actualización de dispositivos de
controlador para bibliotecas declaradas que usen el mecanismo de marcador de posición
34 EIO0000000795 06/2017
Creación de su propia biblioteca compatible con versiones posteriores
Al crear su propia biblioteca, se define de forma predeterminada como no compatible con
versiones posteriores.
Establezca el atributo ForwardCompatibleLibrary en la sección Información del proyecto de su
proyecto de biblioteca para crear su propia biblioteca compatible con versiones posteriores. Para
obtener más información, consulte el siguiente procedimiento.
NOTA: La configuración de la clave ForwardCompatibleLibrary significa que su biblioteca y las
versiones siguientes cumplen los siguientes requisitos:
La funcionalidad de una versión anterior está disponible en una versión posterior:
 Están disponibles todas las POU de la versión anterior.
 El comportamiento de las POU es idéntico en la versión anterior y posterior de su biblioteca.
 La visibilidad de las POU de la versión anterior es igual o superior que en la versión posterior.
 Los nombres y tipos de datos de sus entradas y salidas no se han modificado en las diferentes
versiones.
Además, se puede definir un atributo opcional (MinimumControllerFirmware) si existe
dependencia del dispositivo. El atributo indica la versión de firmware mínima necesaria para los
controladores compatibles. Solo es necesario si una biblioteca utiliza las POU de otra biblioteca
que está referenciada como marcador de posición y la resolución del marcador de posición no es
una biblioteca compatible con versiones posteriores.
El atributo MinimumControllerFirmware consta de un número de identificador del fabricante y
dispositivo, así como la versión de firmware mínima necesaria.
EIO0000000795 06/2017 35
Procedimiento
NOTA: En el siguiente procedimiento solo se describen los pasos adicionales necesarios para
crear una biblioteca compatible con versiones posteriores.
Paso Acción
1 Siga el procedimiento de Creación de su propia biblioteca (véase página 61) hasta el paso 3.
2 En el menú Proyecto → Información del proyecto, abra el cuadro de diálogo Información del
proyecto, seleccione la ficha Propiedades e introduzca o seleccione las siguientes entradas:
 Campo Clave: ForwardCompatibleLibrary
 Campo Tipo: Booleano
 Campo Valor: Verdadero
3 Haga clic en Añadir para añadir la clave a la Información del proyecto de su biblioteca.
4 En caso necesario, añada el atributo opcional MinimumControllerFirmware.
En el Archivo de proyecto → Información del proyecto introduzca o seleccione las siguientes
entradas:
 Campo Clave: MinimumControllerFirmware
 Campo Tipo: Texto
 Campo Valor: categoría del dispositivo “/” ID del dispositivo y proveedor “/” versión; por
ejemplo, 4096/1003 0082/1.33.2.0
Si se consideran varios dispositivos en el atributo MinimumControllerFirmware, deberán
introducirse los números de identificación juntos en el campo Valor, separados por |.
Por ejemplo:
 4096/1003 0082/1.33.2.0|4096/1003 009D/1.35.1.1
5 Continúe en el paso 3 del procedimiento de Creación de su propia biblioteca (véase página 61).
36 EIO0000000795 06/2017
SoMachine
Editor del Administrador de bibliotecas
EIO0000000795 06/2017
Capítulo 3

Este capítulo contiene los siguientes apartados:
Apartado Página
Editor del Administrador de bibliotecas 38
Agregar biblioteca 42
Propiedades 46
Cargar de nuevo la biblioteca 48
Marcador de posición 48
Repositorio de bibliotecas 50
Ficha Asignación de versiones 58
EIO0000000795 06/2017 37
Haga doble clic en un nodo de biblioteca en el árbol Herramientas para abrir el Administrador de
bibliotecas en una vista de editor.
Vista de editor del Administrador de bibliotecas, ficha Bibliotecas
38 EIO0000000795 06/2017
La vista de ventana del editor consta de 4 partes:

 la parte superior, que muestra las bibliotecas actualmente incluidas en el proyecto
 la parte inferior izquierda, que muestra los módulos concretos de la biblioteca seleccionada en
la parte superior
 la parte inferior derecha, que muestra más información sobre la biblioteca seleccionada en la
parte superior, en diferentes fichas
 una barra de herramientas con botones y comandos
Descripción de la parte superior

La parte superior de la vista muestra las bibliotecas que se incluyen actualmente en el proyecto.
Ofrece la información siguiente:
Parámetro Descripción
Nombre Indica el título, versión y, opcionalmente, el nombre de empresa como se
especifica en la ficha Resumen del cuadro de diálogo Información del
proyecto de la biblioteca.
Espacio de nombres La configuración predeterminada del espacio de nombre de una biblioteca es
<nombre de biblioteca>. Una excepción son las bibliotecas que tienen otro
espacio de nombre en su Información del proyecto. Utilice el espacio de
nombre (véase SoMachine, Guía de programación) de la biblioteca como
prefijo del identificador. Esta acción permite acceder al módulo que está
disponible de modo plural en el proyecto o, si el uso de este prefijo lo fuerza
la propiedad de la biblioteca LanguageModelAttribute Solo acceso
cualificado. Puede modificar el espacio de nombre estándar de una biblioteca
incluida para uso local (en el proyecto) mediante el cuadro de diálogo
(véase página 46) Propiedades.
Versión efectiva La versión efectiva es la versión de la biblioteca que se utiliza actualmente
debido a la definición en el cuadro de diálogo (véase página 46) Propiedades
de la biblioteca.
EIO0000000795 06/2017 39
Las bibliotecas que se han incluido automáticamente en un proyecto se muestran de color gris y
las que se han añadido manualmente (Agregar biblioteca...) se muestran de color negro.
Un icono antes del nombre de la biblioteca indica el tipo de biblioteca:
Icono Descripción
Biblioteca con información de versión.
Biblioteca referenciada (véase página 17).
El archivo de la biblioteca referenciada no se ha podido encontrar o no es una

biblioteca válida (consulte el mensaje correspondiente en la lista Administrador de
bibliotecas de la vista Mensajes). Para obtener más información, consulte la
descripción del comando Cargar de nuevo la biblioteca (véase página 48).
Biblioteca con licencia para la que actualmente no hay ninguna licencia válida
disponible.
Si una biblioteca tiene dependencias en otras bibliotecas (biblioteca referenciada

(véase página 17)), aquellas se incluirán automáticamente (si están disponibles) y se mostrarán
con el icono de biblioteca referenciada en un subárbol de la entrada. Para expandir o contraer un
subárbol, haga clic en el signo de más o de menos correspondiente.
Descripción de la parte inferior

En la parte inferior izquierda del editor, se muestran los módulos concretos de la biblioteca
seleccionada actualmente.
La parte inferior derecha del editor puede contener las fichas siguientes:
Ficha Descripción
Documentación Los componentes del módulo seleccionado actualmente en la parte de la izquierda se muestran
en una tabla, e indican el Nombre de la variable, el Tipo de datos y el Comentario que puede
haberse añadido a la declaración del componente cuando se creó la biblioteca. Si se selecciona
una carpeta, se muestra la documentación asociada. De este modo, la inserción de comentarios
es una manera muy fácil de proporcionar automáticamente la documentación del módulo.
Entradas/salidas Los componentes del módulo de biblioteca seleccionado actualmente se listan en una tabla con
el Nombre de la variable, el Tipo de datos, la Dirección, el valor Inicial y el Comentario, conforme
se han definido en la biblioteca.
Gráfica Representación gráfica del módulo.
Parámetros de Esta ficha sólo está disponible para bibliotecas que contienen una lista de parámetros. Puede
biblioteca editar los valores de los parámetros en la columna Valor (editable). Para obtener más
información, consulte el párrafo GVL para constantes configurables (lista de parámetros) en
bibliotecas (véase SoMachine, Guía de programación).
40 EIO0000000795 06/2017
Botones y comandos
Los comandos siguientes, que se proporcionan en la vista de editor cuando se han seleccionado
una o varias bibliotecas, se corresponden con los de las bibliotecas. De forma predeterminada,
están disponibles en la barra de menús mientras esté activo el editor del Administrador de
bibliotecas:
Ficha Descripción
Agregar biblioteca Para incluir una biblioteca en el proyecto.
La condición previa es que la biblioteca esté instalada en el sistema local. Si
intenta insertar una biblioteca que ya está disponible en el proyecto
(véase página 42), se mostrará el mensaje pertinente.
Borrar biblioteca La biblioteca que está seleccionada actualmente en la lista de bibliotecas se
elimina del proyecto.
Propiedades Se utiliza para la configuración del espacio de nombre y (por la posibilidad de
que la biblioteca más adelante esté disponible como biblioteca referenciada
en otro proyecto) para la configuración del tratamiento de la versión, la
visibilidad y el acceso. Consulte el capítulo Propiedades... (véase página 46)
Detalles Muestra un cuadro de diálogo con información detallada sobre la biblioteca
(información general, contenido, propiedades, información de licencia).
Marcador de posición Para redirigir cualquier marcador de posición y grupo de bibliotecas a una
versión diferente. Consulte el capítulo Marcador de posición
Repositorio de bibliotecas Para definir las ubicaciones de biblioteca y para instalar o desinstalar
bibliotecas. Consulte el capítulo Repositorio de bibliotecas
EIO0000000795 06/2017 41
Agregar biblioteca
En la vista de editor del Administrador de bibliotecas, haga clic en el botón Agregar biblioteca para
añadir bibliotecas que ya están instaladas en el sistema para el proyecto.
Se abre el cuadro de diálogo Agregar biblioteca. Consta de 2 fichas:
 La ficha Biblioteca, que permite añadir una biblioteca definida mediante la especificación de
una versión fija.
 La ficha Marcador de posición, que permite referenciar una biblioteca mediante un marcador
de posición.
Puede consultar también la información general sobre la administración de bibliotecas
Ficha Biblioteca
Ficha Biblioteca de la vista de editor del Administrador de bibliotecas
1 Categoría
2 Empresa
3 Título
4 Versión
42 EIO0000000795 06/2017
La ficha Agregar biblioteca permite buscar en todas las bibliotecas instaladas, por ejemplo un
bloque de funciones determinado. Escriba el texto que desea buscar en el cuadro de texto de la
parte superior del cuadro de diálogo. En las listas de las fichas Biblioteca y Marcador de posición
sólo se mostrarán aquellos objetos (nombres de biblioteca, POU, tipos de datos y comentarios
dentro de esos objetos) que contienen el texto buscado.
La ficha Biblioteca enumera las bibliotecas que están instaladas actualmente en el sistema con
título, versión, empresa y categoría, conforme se han definido en la información de proyecto de la
biblioteca. Puede filtrar la visualización con la definición de una determinada Empresa en la lista
de selección. (Todas las empresas) enumera todas las bibliotecas disponibles.
Si se activa la opción Agrupar por categoría, las bibliotecas de la empresa definida actualmente
se listan conforme a las categorías disponibles. Las categorías aparecen como nodos y las
bibliotecas (u otras categorías) se muestran con sangría debajo. Si la opción Agrupar por
categoría no está activada, las bibliotecas se muestran en orden alfabético.
NOTA: Para diseñar y referenciar bibliotecas, siga las instrucciones para crear bibliotecas
Elija la biblioteca que desee.
Si se activa la opción Mostrar todas las versiones (sólo para expertos), todas las versiones
instaladas de las bibliotecas se muestran con sangría debajo de la entrada de la biblioteca
seleccionada actualmente. Además de los identificadores de versión explícitos, se puede mostrar
un asterisco *, que significa la versión más reciente. Le permite elegir entre las diversas versiones.
De forma predeterminada, esta opción está desactivada y sólo se muestra la versión más reciente.
En ese caso, se puede realizar una selección múltiple de bibliotecas: mantenga pulsada la tecla
CTRL o MAYÚS mientras selecciona las bibliotecas.
Tras confirmar haciendo clic en Aceptar, las bibliotecas seleccionadas se añadirán a la lista en la
vista Administrador de bibliotecas.
Si desea incluir una biblioteca que todavía no está instalada en el sistema local, haga clic en el
botón Repositorio de bibliotecas. Se abre el cuadro de diálogo (véase página 50) Repositorio de
bibliotecas para realizar la instalación necesaria.
EIO0000000795 06/2017 43
Ficha Marcador de posición

Ficha Marcador de posición de la vista de editor del Administrador de bibliotecas
Utilice marcadores de posición en los casos siguientes:

 Para lograr la compatibilidad de proyectos en varios dispositivos de destino intercambiables.
 Si su proyecto es un proyecto de biblioteca que referencia a otras bibliotecas específicas de
dispositivo.
En esos casos, incluya las bibliotecas específicas en el administrador de bibliotecas mediante
marcadores de posición, que se han definido en las descripciones del dispositivo. Puede consultar
también las recomendaciones para crear su propia biblioteca (véase página 68).
NOTA: En caso de desarrollo de bibliotecas, el marcador de posición no se puede resolver. Se
tiene en cuenta la biblioteca predeterminada seleccionada.
NOTA: Tenga en cuenta también la asignación de resoluciones de marcador de posición de
biblioteca según la versión del compilador que se usa actualmente, definida en los perfiles de
biblioteca (véase página 56).
44 EIO0000000795 06/2017
Adición de una biblioteca mediante un marcador de posición

Escriba un nombre en el cuadro de texto Nombre del marcador de posición. Para garantizar la
inserción correcta del nombre, haga clic en el botón de flecha para abrir la lista de selección que
ofrece todos los nombres de marcador de posición definidos actualmente en las descripciones de
dispositivo.
Elija una biblioteca predeterminada a partir de las bibliotecas instaladas actualmente que se
muestran en la lista del área Estándar. Esta biblioteca predeterminada se utiliza si, por cualquier
motivo, no hay disponible ningún dispositivo. Permite realizar la compilación del proyecto de
biblioteca editado actualmente sin detectar errores. Seleccione una biblioteca predeterminada
siguiendo los mismos pasos que para añadir una biblioteca en la ficha Biblioteca. También puede
activar la opción Mostrar todas las versiones (sólo para expertos) para ver todas las versiones de
una biblioteca instaladas actualmente.
Cuando cierre la ficha Marcador de posición al hacer clic en Aceptar, la biblioteca del marcador
de posición se insertará en la estructura de árbol del Administrador de bibliotecas. Seleccione esta
entrada y abra el cuadro de diálogo (véase página 46) Propiedades para ver la información sobre
la biblioteca predeterminada configurada actualmente.
En el ejemplo siguiente, el marcador de posición todavía no se ha sustituido (resuelto). El nombre
y la versión de esta biblioteca específica de dispositivo se mostrarán en las columnas respectivas
en cuanto el Administrador de bibliotecas pertenezca a una aplicación de un dispositivo que
referencie a esa biblioteca.
Ejemplo de un marcador de posición de biblioteca insertado en un Administrador de bibliotecas
EIO0000000795 06/2017 45
Propiedades
En la vista de editor del Administrador de bibliotecas, haga clic en el botón Propiedades para abrir
el cuadro de diálogo Propiedades para la biblioteca seleccionada. En él puede configurar el
espacio de nombres, el tratamiento de la versión, la disponibilidad y la visibilidad de las referencias
de biblioteca.
Cuadro de diálogo Propiedades para una biblioteca
NOTA: Antes de trabajar en proyectos de biblioteca y modificar los ajustes de espacios de

nombres, versión y visibilidad, lea las instrucciones para crear bibliotecas (véase página 61).
Área General del cuadro de diálogo
Espacio de nombres Se muestra el espacio de nombres actual de la biblioteca. De forma
predeterminada, el espacio de nombres de una biblioteca es idéntico al
nombre de biblioteca, pero se ha definido otra cadena en Información del
proyecto al crear el proyecto de biblioteca.
Puede editar el espacio de nombres.
Para obtener más información, consulte la descripción (véase página 39) de
la vista de editor del Administrador de bibliotecas.
Estándar Si hay un marcador de posición de biblioteca seleccionado en Administrador
de bibliotecas, este campo contiene el nombre de la biblioteca que sustituye
al marcador de posición si no hay disponible ninguna biblioteca específica del
dispositivo. Consulte la ficha (véase página 44) Marcador de posición.
46 EIO0000000795 06/2017
Área Versión del cuadro de diálogo

Configure la versión de la biblioteca utilizada en el proyecto:
Versión exacta Introduzca la versión o selecciónela en la lista utilizada en el proyecto. Se utiliza para
bibliotecas de contenedor (véase página 63).
Siempre la versión más Se utiliza la última versión encontrada en el repositorio de bibliotecas. Los módulos
reciente utilizados pueden cambiar porque hay disponible una versión más reciente de la biblioteca.
Se utiliza para bibliotecas de interfaces (véase página 63).
Para bibliotecas comunes, no especifique ninguna limitación de versión; en su lugar, utilice
una referencia de marcador de posición (véase página 68).
Área Visibilidad del cuadro de diálogo

Estos ajustes son relevantes en cuanto se incluye la biblioteca y otra biblioteca hace referencia a
ella. De forma predeterminada, están desactivados:
Permitir solo acceso Si esta opción está activada, la utilización del espacio de nombres es obligatoria.
cualificado a todos
los identificadores
Tornar visibles Esta opción es relevante si una biblioteca B se ha añadido a una biblioteca A dentro de un
todos los símbolos proyecto que utiliza la biblioteca A:
IEC en el proyecto, Si la opción está activada, puede acceder a componentes de la biblioteca B utilizando el
como si esta espacio de nombres de la biblioteca A.
referencia aquí Ejemplo: NamespaceLibA.ComponentOfLibB
hubiese sido Si la opción está desactivada, debe escribir la ruta completa del espacio de nombres.
incorporada Ejemplo: NamespaceLibA.NamespaceLibB.ComponentOfLibB
directamente Consulte también el capítulo Administración de bibliotecas (véase página 15) para obtener
información general sobre la gestión de bibliotecas.
NOTA: Active esta opción sólo si desea utilizar bibliotecas de contenedor, que no contengan
módulos propios, sino que incluyan sólo otras bibliotecas para empaquetarlas. Este paquete
permite, por ejemplo, incluir a la vez varias bibliotecas en un proyecto con tan sólo incluir la
biblioteca contenedora. En este caso, puede ser recomendable tener determinadas bibliotecas
en el nivel superior del Administrador de bibliotecas del proyecto. Si los módulos se encuentran
en el nivel superior, se puede acceder directamente a ellos. El espacio de nombres de la
biblioteca contenedora se puede omitir. Para ello, active esta opción.
Ocultar esta Si esta opción está activada, la biblioteca actual no se mostrará posteriormente cuando la
referencia en el biblioteca padre se incluya en un proyecto. Esto permite incluir bibliotecas ocultas. Para ello,
árbol de debe procederse con precaución, porque si se emiten mensajes de error de biblioteca
dependencias detectada, puede resultar difícil identificar la biblioteca que causa este problema.
EIO0000000795 06/2017 47
Cargar de nuevo la biblioteca
Si una biblioteca incluida en un proyecto no está disponible por algún motivo en la ruta definida
cuando se abre el proyecto en el sistema de programación, se generará un mensaje apropiado.
Una vez que haya hecho que la biblioteca vuelva a estar disponible, ejecute el comando Cargar
de nuevo la biblioteca en la vista de editor del Administrador de bibliotecas cuando la entrada de
biblioteca esté seleccionada. El comando también está disponible en el menú contextual si hace
clic con el botón derecho en una entrada de biblioteca. Por tanto, la biblioteca se puede volver a
cargar sin que sea necesario dejar el proyecto:.
Marcador de posición
En la vista de editor del Administrador de bibliotecas, haga clic en el botón Marcador de posición
para redirigir cualquier marcador de posición (principalmente definido a través del perfil de
biblioteca y el dispositivo de destino) hacia una versión diferente. Esta función sólo está disponible
si la opción Activar gestión sencilla de bibliotecas no está activa.
NOTA: Considere cuidadosamente los posibles efectos que puede tener cambiar las referencias
de bibliotecas. Tenga en cuenta también las instrucciones para crear bibliotecas
48 EIO0000000795 06/2017
Resolución de marcador de Redirige la resolución del marcador de posición. Puede especificar la nueva
posición resolución manualmente o seleccionando (Examinar...). Esta acción abrirá
un cuadro de diálogo para seleccionar una de las bibliotecas disponibles.
Resolución predeterminada La resolución que se muestra aquí se aplica cuando el parámetro Resolución
para marcador de posición de marcador de posición se ha establecido en (Estándar).
Información de resolución: Información sobre dónde se ha definido la resolución actual del marcador de
posición (por descripción del dispositivo, por perfil de biblioteca, por biblioteca
estándar, por resolución de marcador de posición, etc.).
EIO0000000795 06/2017 49
Repositorio de bibliotecas
NOTA: Esta funcionalidad solo está disponible si se selecciona en el conjunto de características
usado actualmente (Opciones → Características → Conjunto predefinido de características).
Abra el cuadro de diálogo Repositorio de bibliotecas a través del comando Herramientas →
Opciones → Repositorio de bibliotecas... o haciendo clic en el botón Repositorio de bibliotecas en
el editor de Administrador de bibliotecas.
Para acceder al Repositorio de bibliotecas desde SoMachine Central, abra el cuadro de diálogo
Opciones del sistema haciendo clic en el botón Opciones del sistema en la barra de herramientas
o haciendo clic en el botón Configuración en la pantalla Versiones. En el cuadro de diálogo
Opciones del sistema, haga clic en el botón (véase SoMachine Central, Manual del usuario)
Repositorio de bibliotecas.
Un repositorio de bibliotecas es una base de datos para las bibliotecas que se han instalado en el
sistema local con el fin de estar disponibles para los proyectos de SoMachine.
NOTA: Un proyecto de biblioteca *.library, que se almacena en un repositorio de bibliotecas, no
se puede abrir allí para edición o visualización en el sistema de programación.
50 EIO0000000795 06/2017
Cuadro de diálogo Repositorio de bibliotecas
1 Categoría
2 Empresa
3 Nombre
4 Versión
El cuadro de diálogo muestra las ubicaciones (repositorios) de la biblioteca definida y las

bibliotecas instaladas actualmente.
Le permite:
 Añadir, modificar o eliminar repositorios.
 Instalar y desinstalar bibliotecas.
EIO0000000795 06/2017 51
El cuadro de diálogo Repositorio de bibliotecas contiene los siguientes elementos:
Lista Ubicación Seleccione un directorio en el sistema local donde se almacenen los archivos
de la biblioteca.
Seleccione Sistema para mostrar las bibliotecas estándar contenidas
SoMachine en la lista Bibliotecas instaladas.
Seleccione Usuario para mostrar sólo las bibliotecas que ha definido por su
cuenta en la lista Bibliotecas instaladas.
Lista Empresa Seleccione un nombre para visualizar sólo las bibliotecas proporcionadas por
un proveedor principal (o nombre de grupo definido por el proveedor
principal) en la lista de Bibliotecas instaladas.
Para mostrar todas las bibliotecas disponibles en la Ubicación seleccionada,
seleccione (Todas las empresas) de la lista.
Lista Bibliotecas instaladas La lista muestra las bibliotecas que están disponibles en la Ubicación
seleccionada de la Empresa seleccionada por sus nombres (título), número
de versión y nombre de la empresa según lo proporcionado por la
información del proyecto de la biblioteca.
Opción Agrupar por Active la opción Agrupar por categoría para ordenar la lista Bibliotecas
categoría instaladas según las categorías de bibliotecas. Los nombres de las
categorías se muestran como nodos que pueden plegarse o desplegarse
para mostrar u ocultar las bibliotecas.
Desactive esta opción para crear un listado alfabético de las bibliotecas.
Las categorías de bibliotecas se definen por archivos de descripción externos
*.libcat.xml (véase página 64).
Botón Modificar Consulte el párrafo Ubicaciones de biblioteca (repositorios)
ubicaciones... (véase página 53).
Botones Instalar... / Consulte el párrafo Instalación y desinstalación de la biblioteca
Desinstalar (véase página 54).
Botón Buscar... Consulte el párrafo Buscar bibliotecas (véase página 55).
Botones Detalles... / Consulte el párrafo Más información sobre bibliotecas concretas
Dependencias... (véase página 56).
Botón Perfiles de Consulte el párrafo Perfiles de biblioteca (véase página 56).
biblioteca…
52 EIO0000000795 06/2017
Ubicaciones de biblioteca (repositorios)

Puede utilizar varios repositorios para gestionar las bibliotecas. Los repositorios definidos se
muestran en la lista Ubicación. De forma predeterminada, contiene las entradas del Sistema para
las bibliotecas estándar ofrecidas por SoMachine y las del Usuario para aquellas bibliotecas
definidas por usted.
Para modificar la ruta o el nombre de un repositorio, pulse el botón Modificar ubicaciones...
El cuadro de diálogo Editar las ubicaciones de repositorio muestra:
El cuadro de diálogo Editar las ubicaciones de repositorio contiene los siguientes elementos:
Lista Repositorios Enumera las ubicaciones definidas. Se consultarán más adelante para
buscar una biblioteca en el orden dado de arriba abajo.
Botones Uno adelante/Uno Modifican el orden de las bibliotecas. La ubicación seleccionada se mueve
atrás hacia arriba o hacia abajo en la lista.
Tenga en cuenta que el ajuste Ubicación: <Todas las ubicaciones> muestra las bibliotecas de las
ubicaciones definidas anteriormente. No se puede realizar la instalación en esta vista.
EIO0000000795 06/2017 53
Definición de un nuevo repositorio o modificación de ruta y nombre de un repositorio existente

Haga clic en el botón Agregar... del cuadro de diálogo Editar las ubicaciones de repositorio para
añadir un nuevo repositorio. Aparecerá el cuadro de diálogo Ubicación para repositorio.
Para modificar un repositorio existente, seleccione la entrada correspondiente en el cuadro de
diálogo Editar las ubicaciones de repositorio y haga clic en el botón Editar. Aparecerá el cuadro
de diálogo Ubicación para repositorio.
El cuadro de diálogo Ubicación para repositorio contiene los siguientes elementos:
Cuadro de texto Ubicación Introduzca la ruta del nuevo repositorio o edite la ruta del repositorio
seleccionado.
Para buscar una carpeta o crear una nueva carpeta, haga clic en el botón ...
Compruebe que la carpeta seleccionada esté vacía.
Cuadro de texto Nombre Introduzca un nombre simbólico para la ubicación, por ejemplo Libraries for
System1.
NOTA: La carpeta que se selecciona como carpeta de repositorio tiene que estar vacía. El
repositorio Sistema no es editable. Esto se indica mediante la entrada que se muestra en cursiva.
Eliminación de un repositorio existente

Para eliminar un repositorio, selecciónelo en el cuadro de diálogo Editar las ubicaciones de
repositorio y haga clic en el botón Eliminar. Aparecerá un mensaje que le preguntará si sólo se
debe eliminar la entrada de la lista, o si también la carpeta que contiene los archivos de la
biblioteca se debe eliminar del sistema de archivos.
Instalación y desinstalación de la biblioteca

Sólo puede incluir en un proyecto las bibliotecas que se instalan en el sistema local (Repositorio
de bibliotecas). Como condición previa para la instalación, se debe asignar al menos un Título,
una información de Versión y un nombre de Empresa en la ficha Resumen del cuadro de diálogo
Información del proyecto.
Para instalar una biblioteca, seleccione el repositorio al que la biblioteca debe añadirse en el
cuadro de diálogo Repositorio de bibliotecas y haga clic en el botón Instalar...
Se abrirá el cuadro de diálogo Seleccionar biblioteca. Se trata de un cuadro de diálogo estándar
para la búsqueda de un archivo. De forma predeterminada, el filtro Archivos de tipo se establece
en Bibliotecas compiladas. Puede cambiar el filtro a Archivos de biblioteca o a Todos los archivos.
Seleccione la biblioteca que desee y haga clic en Abrir. La biblioteca se añade a la lista de
bibliotecas instaladas actualmente en el cuadro de diálogo Repositorio de bibliotecas.
Si selecciona una biblioteca que no se puede instalar porque no proporciona la Información del
proyecto obligatoria (título, versión, empresa), se mostrará un mensaje adecuado.
Para desinstalar una biblioteca, selecciónela en la lista de las bibliotecas instaladas actualmente
en el cuadro de diálogo Repositorio de bibliotecas y haga clic en el botón Desinstalar.
54 EIO0000000795 06/2017
Buscar bibliotecas
Para buscar una biblioteca en la ubicación de almacenamiento especificada, haga clic en el botón
Buscar en el cuadro de diálogo Repositorio de bibliotecas. Se abrirá el cuadro de diálogo Buscar
biblioteca. Permite realizar búsquedas de bloques de funciones y las bibliotecas correspondientes.
Cuadro de diálogo Buscar biblioteca
El cuadro de diálogo Buscar biblioteca contiene los siguientes elementos:
Cuadro de texto Buscar Introduzca la cadena de búsqueda para el bloque de funciones y las
bibliotecas correspondientes.
Además, también puede introducir los caracteres comodín * y ?.
Opción Mayúsculas y Active esta opción para ejecutar una búsqueda que distinga entre
minúsculas mayúsculas y minúsculas en referencia a la cadena de búsqueda.
Opción Incluir comentarios Active esta opción para explorar no sólo los nombres de los bloques de
en la búsqueda funciones, sino también los comentarios de dichos bloques.
EIO0000000795 06/2017 55
Más información sobre bibliotecas concretas

Para ver más detalles de la biblioteca seleccionada, seleccione la línea de la biblioteca que
contiene la versión y haga clic en el botón Detalles... Se mostrará el cuadro de diálogo Detalles,
que proporciona más información de la biblioteca en Información del proyecto. Para obtener
información más detallada si cabe, haga clic en el botón Más...
Para mostrar las dependencias relativas a otras bibliotecas para la biblioteca seleccionada,
seleccione la línea de la biblioteca que contiene la versión y haga clic en el botón Dependencias...
Se mostrará el cuadro de diálogo Dependencias con una lista de las bibliotecas que se incluyen
en la biblioteca seleccionada, indicando Título, Versión e información de la Empresa.
Las referencias que se utilizan a través de los marcadores de posición se enumeran de acuerdo
con la siguiente sintaxis:
#<nombre del marcador de posición>.
Para obtener más detalles sobre los marcadores de posición de la biblioteca, consulte el capítulo
Mecanismo de marcador de posición (véase página 22).
Perfiles de biblioteca
Un perfil de biblioteca define la versión de la biblioteca que se utiliza para resolver un marcador
de posición de la biblioteca cuando se ha establecido una determinada versión del compilador
para el proyecto. Para abrir el cuadro de diálogo Perfiles de biblioteca, haga clic en el botón
Perfiles de biblioteca… en el cuadro de diálogo Repositorio de bibliotecas.
Cuadro de diálogo Perfiles de biblioteca
56 EIO0000000795 06/2017
El cuadro de diálogo Perfiles de biblioteca contiene los siguientes elementos:
Botón Exportar Seleccione 1 o varias entradas del Marcador de posición mostrado o una sola
entrada de la Versión del compilador debajo de una entrada del Marcador de
posición. Haga clic en este botón para exportar las asignaciones entre el
marcador de posición y la versión de la biblioteca a un archivo XML con la
extensión *.libraryprofile.
Botón Importar Haga clic en este botón para importar un archivo XML con la extensión
*.libraryprofile.
Si la importación ofrece entradas de marcador de posición que ya están
disponibles, se le preguntará si dichas entradas se deben sobrescribir.
Tenga en cuenta que puede definir adicionalmente las resoluciones de marcadores de posición
por el dispositivo de destino establecido en la actualidad, e incluso por las reubicaciones
especificadas localmente en la ficha Marcador de posición del cuadro de diálogoAgregar
biblioteca (véase página 42).
EIO0000000795 06/2017 57
Ficha Asignación de versiones
La ficha Asignación de versiones del Administrador de bibliotecas le permite editar la asignación
de versiones para bibliotecas compatibles con versiones posteriores (FCL) (véase página 24).
Ficha Asignación de versiones del Administrador de bibliotecas:
58 EIO0000000795 06/2017
La ficha Asignación de versiones consta de dos tablas:

 La tabla superior enumera las bibliotecas compatibles con versiones posteriores que se
incluyen en el proyecto de SoMachine.
También muestra las bibliotecas heredadas si existe una versión más reciente compatible con
versiones posteriores de estas bibliotecas. Las bibliotecas heredadas son bibliotecas que se
han creado con una versión 3.1 o inferior de SoMachine y que aún no son compatibles con
versiones posteriores. Puede reconocer estas bibliotecas por la entrada Herencia en la
columna Versión configurada de la tabla.
 La parte inferior de la tabla ofrece más información sobre la biblioteca seleccionada en la tabla
superior. Muestra dependencias en otras bibliotecas compatibles con versiones posteriores y
descripciones de dispositivos.
Cambio de la versión de una biblioteca

La ficha Asignación de versiones del Administrador de bibliotecas le permite editar la asignación
de versiones de las bibliotecas de diferentes maneras:
 Se puede realizar de forma automática la asignación de versiones para todas las bibliotecas
que figuran en la tabla haciendo clic en el botón Automático. Esto tiene los siguientes efectos:
 Las bibliotecas compatibles con versiones posteriores se actualizan a la última versión
disponible de biblioteca compatible con versiones posteriores.
 Las bibliotecas heredadas se convierten en bibliotecas compatibles con versiones
posteriores y se actualizan a la última versión disponible de biblioteca compatible con
versiones posteriores.
 Puede realizar la asignación de versiones de forma automática para una biblioteca específica.
Para ello, haga clic con el botón derecho en la biblioteca y ejecute el comando Editar asignación
de versiones (biblioteca seleccionada).
 Puede editar la versión de cada biblioteca manualmente. Para ello, haga clic en la columna
Versión configurada para abrir una lista que muestre las versiones disponibles. Seleccione la
versión deseada en la lista.
Biblioteca con dependencias sin resolver

Las bibliotecas FCL con dependencias sin resolver se muestran con un fondo de color rojo en la
tabla superior. Seleccione esta biblioteca para mostrar más información en la tabla inferior sobre
las dependencias necesarias y las versiones compatibles. Las dependencias no resueltas se
marcan en rojo en la tabla inferior. Por ejemplo, si en el proyecto no se utiliza una versión del
dispositivo compatible, entonces se marcará en rojo la línea Descripciones aceptadas del
dispositivo. Si no se incluye una dependencia de biblioteca necesaria, entonces se marcará en
rojo la línea library dependencies y la dependencia de la biblioteca que no se haya incluido.
Dispositivos incompatibles
Si un dispositivo aparece como compatible en la tabla de detalles de las dependencias del
dispositivo, pero no está instalado en la versión de SoMachine que está utilizando, entonces se
mostrará el texto Unsupported device en la línea junto a la ID del dispositivo.
EIO0000000795 06/2017 59
60 EIO0000000795 06/2017
SoMachine
Creación de la propia biblioteca
EIO0000000795 06/2017
Capítulo 4

Apartado Página
Información general 62
Paso 1: Configuración del proyecto 63
Paso 2: Cumplimentación de la información del proyecto 64
Paso 3: Referencia a otras bibliotecas, si es necesario 67
Paso 3.1: Uso de referencias de marcador de posición 68
Paso 4: Diseño y programación de módulos de biblioteca 69
Paso 5: Diseño de la interfaz 69
Paso 6: Implementación de rutinas de tratamiento de errores 69
Paso 7: Configuración de una distribución razonable (restricción de uso) 70
EIO0000000795 06/2017 61
Información general
Por motivos de compatibilidad, cuando cree una biblioteca tenga en cuenta las instrucciones que
se describen en los capítulos siguientes.
Al crear una biblioteca, tenga en cuenta los elementos principales siguientes:
 Defina un nombre de biblioteca que sea coherente con el contenido de la biblioteca
(obligatorio).
 Utilice una estructura de proyecto común y tan coherente como sea posible (opcional).
 Llene los datos de Información del proyecto (obligatorio).
 Seleccione un espacio de nombres exclusivo para la biblioteca (obligatorio).
 Utilice el método adecuado para crear referencias a otras bibliotecas (obligatorio).
 Diseñe interfaces externas e internas utilizables (obligatorio).
 Implemente una rutina de tratamiento de errores (obligatorio).
 Utilice el método adecuado (protección) para la distribución (obligatorio).
 Siga una convención de nomenclatura del código que sea más fácil de leer y depurar
(opcional).
Cuando cree un proyecto de biblioteca, siga los pasos que se describen en los capítulos
siguientes.
62 EIO0000000795 06/2017
Paso 1: Configuración del proyecto
En SoMachine Central, cree un nuevo proyecto de biblioteca en la pantalla Empezar; para ello,
ejecute los comandos Nuevo proyecto → Nueva biblioteca. Defina valores en Nombre y Detalles
en el cuadro de diálogo Nueva biblioteca como se describe en la Guía del usuario
(véase SoMachine Central, Manual del usuario) de SoMachine Central.
EIO0000000795 06/2017 63
Paso 2: Cumplimentación de la información del proyecto
Especifique información sobre el proyecto en el cuadro de diálogo Proyecto → Información del
proyecto. Este cuadro de diálogo consta de varias fichas. La información necesaria para crear su
propia biblioteca se describe aquí.
Ficha Resumen
Especifique la información siguiente en la ficha Resumen del cuadro de diálogo Información del
proyecto:
Empresa Obligatorio: especifique una empresa para el proyecto.
Título Obligatorio: especifique un nombre para el proyecto.
Versión Obligatorio: especifique una versión para el proyecto.
Espacio predeterminado Le permite que cada símbolo sea exclusivo, aunque se utilice el mismo nombre de
para nombre símbolo en diferentes bibliotecas.
Si no define un espacio de nombres, el nombre de biblioteca se utilizará como tal. Es
mejor definir uno que sea exclusivo. Después de incluir la biblioteca en un proyecto,
todavía puede modificar el espacio de nombres en el cuadro de diálogo Propiedades
del Administrador de bibliotecas, si es necesario.
Para aplicar el espacio de nombres, consulte la sección correspondiente en este
capítulo.
Categorías de bibliotecas Ofrece una clasificación útil de las entradas que existen en el Repositorio de
biblioteca y en el Administrador de bibliotecas
Si es posible, especifique una categoría que no sea Varios de entre las categorías
siguientes:
 Aplicación: bibliotecas que deben insertarse explícitamente en un proyecto.
Diseñadas para el acceso directo desde el código del usuario final.
 Internas: bibliotecas que se insertan automáticamente en un proyecto y que
normalmente no deben insertarse o eliminarse manualmente.
 Sistema: bibliotecas que dependen directamente del sistema de tiempo de
ejecución o que implementan partes del mismo. No deben insertarse directamente
en el proyecto, sino que debe hacerse referencia a ellas mediante otras
bibliotecas. No están destinadas a incluirse en la aplicación de usuario
directamente. (No se proporciona gestión de recursos como, por ejemplo, eliminar
recursos en el controlador para cerrar interfaces serie antes de realizar una
posterior descarga).
Autor Introduzca el nombre del autor de este proyecto.
Descripción Introduzca una descripción corta del contenido de la biblioteca.
Crear POUs No utilizado.
automáticamente para el
NOTA: No debe utilizarlo dentro de bibliotecas, ya que se pueden producir errores
acceso a las propiedades
de aplicación.
64 EIO0000000795 06/2017
Aplicando el espacio de nombres

Puede aplicarse que el espacio de nombres debe preceder siempre que se acceda a variables o
módulos de biblioteca desde la aplicación o desde otra biblioteca. Con este fin, establezca la
propiedad LanguageModelAttribute (Text) :='qualified-access-only' en la ficha
Propiedades.
Nombre de la Clave: LanguageModelAttribute
Tipo: Text
Valor: qualified-access-only (véase la figura siguiente).
Se detectan errores de compilación si se utiliza un módulo de biblioteca o variable sin un espacio
de nombres que lo preceda.
Ficha Propiedades: valores para aplicar el espacio de nombres:
EIO0000000795 06/2017 65
Ficha Propiedades
Lista de propiedades configurables:
Propiedad Tipo Valor Descripción

Empresa Texto <nombre de empresa> Sirve para filtrar las
bibliotecas en el cuadro de
diálogo Agregar biblioteca.
Título Texto <nombre de biblioteca> # –
Versión Texto <versión de la biblioteca> –
Liberado Booleano TRUE|FALSE La biblioteca no debe
modificarse tras su
liberación.
Autor Texto <nombre del autor> Autor de la versión actual de
la biblioteca
DefaultNamespace Texto <espacio de nombres> Prefijo de espacio de
nombres global exclusivo
Descripción Texto <descripción> Descripción breve del
ámbito de la biblioteca
Marcador de posición Texto <marcador de posición> –
IsContainerLibrary Booleano TRUE|FALSE Esta biblioteca sigue las
reglas de una biblioteca
contenedora.
IsInterfaceLibrary Booleano TRUE|FALSE Esta biblioteca sigue las
reglas de una biblioteca
contenedora.
LanguageModelAttribute Texto 'qualified-access- Sólo puede accederse a los
only' símbolos de esta biblioteca
mediante el prefijo de
espacio de nombres.
IsEndUserLibrary Booleano TRUE|FALSE La biblioteca está
especialmente diseñada
según las necesidades de
un usuario final.
66 EIO0000000795 06/2017
Paso 3: Referencia a otras bibliotecas, si es necesario
Cuando incluya otras bibliotecas, defina su visibilidad y la versión que se debe utilizar.
Visibilidad
En las Propiedades (véase página 46) de cada biblioteca referenciada, defina el comportamiento
cuando se inserte en un proyecto junto con su biblioteca padre.
Elija si una biblioteca referenciada debe estar oculta (no visible en el Administrador de bibliotecas),
o si es útil para crear una biblioteca contenedora (un proyecto de biblioteca que contenga
referencias de biblioteca):
Biblioteca oculta Desactive la visibilidad de la biblioteca en el Administrador de

bibliotecas, debajo de la biblioteca padre, seleccionando la opción
Ocultar esta referencia en el árbol de dependencias en el cuadro de
diálogo Propiedades (véase página 46).
De este modo, las bibliotecas ocultas podrán estar disponibles en un
proyecto.
Biblioteca contenedora Una biblioteca contenedora (*_Cnt.library) es un proyecto de
biblioteca que no define módulos, sino que hace referencia a otras
bibliotecas. Con las bibliotecas contenedoras, se simplifica el acceso
a los módulos de estas bibliotecas.
Cree una biblioteca contenedora si desea incluir un conjunto de
bibliotecas en un proyecto al mismo tiempo, incluida dicha biblioteca
contenedora. En este caso, puede simplificar el acceso a los módulos
de esas bibliotecas convirtiéndolas en bibliotecas de nivel superior.
Esto le permite omitir el espacio de nombres de la biblioteca
contenedora en la ruta de acceso.
Para ello, seleccione la opción Tornar visibles todos los símbolos IEC
en el proyecto, como si esta referencia aquí hubiese sido incorporada
directamente en el cuadro de diálogo Propiedades
Seleccione esta opción sólo para una biblioteca contenedora.
EIO0000000795 06/2017 67
Restricciones de versión
 Las bibliotecas de interfaz se referencian con la restricción más reciente. Para ello, seleccione
* en lugar de una versión específica cuando incluya la biblioteca a través del cuadro de diálogo
Agregar biblioteca.
 Las bibliotecas contenedoras se referencian con una restricción de versión. Para ello,
seleccione una versión específica de la biblioteca en el cuadro de diálogo Agregar biblioteca.
 Las bibliotecas comunes se referencian mediante una referencia de marcador de posición. Esto
proporciona relaciones coherentes entre las diferentes bibliotecas. Una actualización de una
biblioteca a la que se hace referencia de modo indirecto no requiere modificaciones de cada
biblioteca afectada, sino sólo una modificación de la definición del marcador de posición
Paso 3.1: Uso de referencias de marcador de posición
Para referenciar bibliotecas comunes, utilice referencias de marcador de posición.
Utilice marcadores de posición de la biblioteca para hacer que un proyecto sea compatible para
los dispositivos de destino intercambiables o para distintas versiones de compilador. Al añadir una
biblioteca a un proyecto, considere el uso de un marcador de posición en lugar de una versión de
la biblioteca definida. A continuación, se referencia la versión actualmente requerida de una
biblioteca, de acuerdo con la definición válida actualmente de la resolución de marcador de
posición.
Para la definición de la resolución efectiva y definitiva, se consideran las siguientes ubicaciones
en orden ascendente. El elemento 3 tiene la máxima prioridad:
1. El perfil de la biblioteca, proporcionado de forma predeterminada con la instalación del sistema
de programación, define la resolución de un marcador de posición en función de la versión del
compilador. Para obtener más detalles, consulte la descripción de Perfiles de biblioteca
2. La descripción del dispositivo del destino establecido en la actualidad define la resolución de
marcador de posición específico del dispositivo (si no hay ningún dispositivo disponible, se
realiza la resolución predeterminada especificada para el marcador de posición).
3. En el cuadro de diálogo Marcador de posición (véase página 48), al que se accede desde el
Administrador de bibliotecas, puede modificar la resolución del marcador de posición específi-
camente para el proyecto actual.
NOTA: Esta es la resolución definitiva y efectiva. Puede editarlo sólo si la opción Activar gestión
sencilla de bibliotecas no está activada. Piénselo bien antes de modificarlo.
68 EIO0000000795 06/2017
Paso 4: Diseño y programación de módulos de biblioteca
Consideraciones
NOTA: Use la estructura de POU según se proporciona en la plantilla de biblioteca y no se olvide
de añadir documentación suficiente de los módulos de biblioteca.
Paso 5: Diseño de la interfaz
Básicamente hay 2 tipos de interfaces de biblioteca:
Interfaz Descripción
Interfaces externas (interfaces de usuario) Se accede desde la aplicación del usuario final.
Utilizan un conjunto reducido de tipos de parámetros
para que los demás programadores no tengan que
trabajar con tipos de datos problemáticos o
complicados, como punteros o el operador ADR().
Interfaces internas Todas las demás interfaces.
Las interfaces deben optimizarse para su uso con CFC.

Si es apropiado, reutilice el modelo de comportamiento común para generar las interfaces del
bloque de funciones de los usuarios finales.
Marque las bibliotecas diseñadas especialmente para que las utilicen usuarios finales con la
propiedad IsEndUserLibrary (consulte la información sobre el tipo de biblioteca End-User
Library que se describe en el capítulo Paso 1: Configuración del proyecto).
Paso 6: Implementación de rutinas de tratamiento de errores
Tenga en cuenta lo siguiente para crear rutinas de tratamiento de errores eficientes:
 Sólo se deben devolver los códigos de error que ha documentado.
 No se limite a devolver códigos de error que han pasado desde otras bibliotecas, sino que debe
documentarlos en sus rutinas y devolver un código adecuado como el origen documentado.
EIO0000000795 06/2017 69
Paso 7: Configuración de una distribución razonable (restricción de uso)
Para ayudar a proteger la fuente de la biblioteca, cree una protección adecuada y derechos de
acceso a la biblioteca. Después, utilice un tipo adecuado de restricción de uso.
 Alimente la biblioteca solo con formatos compilados (*.compiled-library). Por lo tanto, no se ha
podido restaurar el origen del proyecto. Para este propósito, utilice el comando Guardar
proyecto como... de la barra de herramientas (véase SoMachine Central, Manual del usuario)
de SoMachine Central.
 Aumente las restricciones para los derechos de acceso del usuario Everyone. Para obtener
más información, consulte el capítulo Administración de usuarios y derechos de acceso
(véase SoMachine, Guía de programación).
 Conserve el derecho a visualizar el contenido de los objetos Información del proyecto y
Administrador de bibliotecas. Para más información, consulte Control de acceso
(véase SoMachine, Comandos de menú, Ayuda en línea).
 Limite el uso de la biblioteca a determinadas plataformas o dispositivos: puede implementar un
código de verificación que haga que la biblioteca solo funcione si se usa el dispositivo
apropiado.
70 EIO0000000795 06/2017
SoMachine
Descripción general de bibliotecas
EIO0000000795 06/2017
Capítulo 5

Apartado Página
Bibliotecas de Schneider Electric 72
Otras bibliotecas utilizadas en SoMachine 94
EIO0000000795 06/2017 71
Bibliotecas de Schneider Electric
Introducción
A continuación se muestran todas las bibliotecas de Schneider Electric.
En la tabla siguiente se explica cómo usar las tablas que describen las bibliotecas de Schneider
Electric a continuación:
Categoría Categoría a la que pertenece esta biblioteca, como se

muestra en el cuadro de diálogo Administrador de
bibliotecas.
Espacio de nombres Espacio de nombres predeterminado de la biblioteca
para acceder a las funciones de esta.
NOTA: Conviene utilizar siempre el espacio de nombres
predeterminado como espacio de nombres usado en la
aplicación.
Si después del espacio de nombres de una biblioteca se
muestra Sólo acceso cualificado, esto indica que el uso
del espacio de nombres en la aplicación es obligatorio.
Para obtener más información, consulte Descripción
general de las bibliotecas (véase página 11).
Biblioteca de referencia Modo de añadir una referencia a la biblioteca:
 PH indica la inclusión de la biblioteca a través de un
mecanismo de marcador de posición
(véase página 22). En una lista se muestra el nombre
del marcador de posición correspondiente que se va
a utilizar para esta biblioteca.
 versión directa indica la inclusión de la biblioteca a
través de un mecanismo de versión directa
 FCL indica que se trata de una biblioteca compatible
con versiones posteriores (véase página 24).
USER  YES: Las funciones y los bloques de funciones de la
biblioteca se pueden utilizar en las aplicaciones
(programas) de los usuarios.
 NO: Solo para funciones de sistema o administrativas
específicas. Normalmente, estas funciones y bloques
de funciones no tienen documentación de usuario.
Para obtener más información sobre cómo añadir una biblioteca a un proyecto de SoMachine,
consulte Adición de una biblioteca (véase página 42).
Para obtener más información sobre el uso de bibliotecas y el mecanismo de referencia, consulte
Gestión de bibliotecas en SoMachine (véase página 15).
72 EIO0000000795 06/2017
Categoría: (Varios)
En la tabla siguiente se describe la biblioteca disponible en la categoría (Varios):
Nombre Espacio de nombres Biblioteca de Descripción USUAR

referencia IO
FeatureNotSupported FeatureNotSupported versión directa Biblioteca virtual vacía NO
usada por el sistema
Categoría: Aplicación
En la tabla siguiente se describe la biblioteca disponible en la categoría Aplicación:

referencia IO
PD_ETest PD_ETest versión directa (FCL) Contiene funciones que NO
Consulte Guía de la biblioteca se utilizan en ETEST
PD_ET (véase SoMachine, framework.
PD_ETest, Guía de la
biblioteca)
SE_LMC_Utility SE_LMC_Utility PH (FCL) Funciones de utilidades NO
SE_LMC_Utility usadas por la biblioteca
de esclavo de
PROFIBUS DP
NOTA: Para obtener las descripciones de otras bibliotecas, consulte las categorías Comunicación,
Solución y Util.
EIO0000000795 06/2017 73
Categoría: Comunicación
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Comunicación:

referencia IO
EMailHandling SE_Email versión directa (FCL) La biblioteca permite al SÍ
consulte Guía de la biblioteca (sólo acceso controlador enviar un
EMailHandling cualificado) mensaje de correo
(véase SoMachine, electrónico a uno o
EMailHandling, Guía de la varios destinatarios con
biblioteca) la posibilidad de
personalizar el
contenido. El tipo de
protocolo utilizado es
TCP como estándar
para tráfico de correo
electrónico.
También es posible
recibir o borrar
mensajes de correo
electrónico de un
servidor utilizando
POP3 (Post Office
Protocol 3).
NOTA: La
comunicación se
implementa mediante la
biblioteca
TcpUdpCommunication.
EtherNetIP Explicit EIPXM versión directa (FCL) Mensajes explícitos en SÍ
Messaging (sólo acceso EtherNet/IP para
Consulte SoMachine cualificado) comunicación con
Ethernet industrial - Guía del dispositivos genéricos
usuario (véase SoMachine (por ejemplo, cámaras),
Ethernet industrial, Guía del para los que SoMachine
usuario) no ofrece integración de
dispositivos.
EtherNetIP Remote Adapter EIPRA versión directa (FCL) Utilizado por objetos de NO
Consulte SoMachine (sólo acceso dispositivos EtherNet/IP
Ethernet industrial - Guía del cualificado) para dar soporte a
usuario (véase SoMachine parámetros de usuario y
Ethernet industrial, Guía del gestión de conexiones.
usuario)
74 EIO0000000795 06/2017

referencia IO
EtherNetIP Scanner EIPSC versión directa (FCL) Bloques de funciones SÍ
Consulte SoMachine para establecer y cerrar
Ethernet industrial - Guía del conexiones CIP y para
usuario (véase SoMachine crear peticiones de
Ethernet industrial, Guía del mensajes explícitos en
usuario) EtherNet/IP.
FtpRemoteFileHandling SE_FTP versión directa (FCL) La biblioteca ofrece SÍ
consulte Guía de la biblioteca (sólo acceso funciones de cliente FTP
FtpRemoteFileHandling cualificado) (File Transfer Protocol,
(véase SoMachine, protocolo de
FtpRemoteFileHandling, transferencia de
Guía de la biblioteca) archivos) a un
controlador para
acceder a archivos y
gestionarlos de forma
remota desde y hacia un
servidor FTP.
NOTA: La
comunicación se
biblioteca
IoDrvASI SEN_ASI PH (FCL) SE_ASi Funciones de gestión de SÍ
consulte Interfaz AS bus de Interfaz AS
(véase Modicon M238 Logic
Controller, Guía de
programación)
IoDrvDistributedIo SEN_DIO PH SE_Distributed_IO Funciones de gestión de NO
bus para E/S
distribuidas en
CANopen
IoDrvTM5PCDPS SEN_PROFIBUS PH (FCL) Biblioteca de esclavo de NO
IoDrvTM5PCDPS PROFIBUS DP
IoDrvTM4PDPS1 IoDrvTM4DPS1Lib versión directa (FCL) Biblioteca de esclavo de NO
PROFIBUS DP M241
M2xx Communication SEN_COM PH (FCL) Obtención y SÍ
consulte Funciones para SE_M2XXCommunica establecimiento de
obtener/establecer la tion configuración del puerto
configuración de línea serie de línea serie en los
(véase Modicon M238 Logic controladores M238,
Controller, Guía de M258 y LMC058
programación)
EIO0000000795 06/2017 75

referencia IO
Modem SE_MOD PH (FCL) SE_Modem Configuración del SÍ
consulte Biblioteca de modem en los
modems (véase SoMachine, controladores M238,
Funciones de modem, Guía M258 y LMC058
de la biblioteca de modems)
PLCCommunication SEN PH (FCL) Gestión de intercambios SÍ
consulte Biblioteca SE_PLCCommunicati de datos explícitos entre
PLCCommunication on el controlador y los
(véase SoMachine, dispositivos mediante
Funciones de los protocolos Modbus o
lectura/escritura Modbus y ASCII
ASCII, Guía de la biblioteca
NOTA: Esta biblioteca
PLCCommunication)
no es compatible con
ATV IMC Drive
Controller.
SE_NetVarUdp NetVarUdp versión directa (FCL) Intercambio de datos SÍ
consulte Biblioteca entre los controladores
SE_NetVarUdp dentro de una red a
(véase SoMachine, través de variables de
Configuración de variables red.
de red, SE_NetVarUdp - Guía
de la biblioteca)
76 EIO0000000795 06/2017

referencia IO
SnmpManager SE_SNMP versión directa (FCL) Esta biblioteca SÍ
consulte SnmpManager - (sólo acceso implementa un
Guía de la biblioteca cualificado) administrador del
(véase SoMachine, protocolo estándar de
SnmpManager, Guía de la Internet SNMP (Simple
biblioteca) Network Management
Protocol, protocolo
simple de
administración de
redes). El administrador
SNMP permite al
controlador recopilar y
organizar la información
acerca de los
dispositivos
administrados en las
redes IP (Internet
Protocol, protocolo de
Internet), así como
modificar esta
información con el
objetivo de cambiar la
configuración del
dispositivo.
NOTA: La
comunicación se
biblioteca
EIO0000000795 06/2017 77

referencia IO
SqlRemoteAccess SE_SQL versión directa (FCL) Esta biblioteca SÍ
consulte Guía de la biblioteca (sólo acceso proporciona bloques de
SqlRemoteAccess cualificado) funciones de cliente
(véase SoMachine, SQL (Structured Query
SqlRemoteAccess, Guía de Language, lenguaje de
la biblioteca) consulta estructurado)
que permiten al
controlador conectarse
a una base de datos
SQL con el fin de
ejecutar consultas SQL
para la lectura y
escritura de datos.
NOTA: La
comunicación se
biblioteca
ModbusTCPIOScanner SE_IOS versión directa (FCL) Proporciona bloques de NO
funciones de
Modbus TCP
IOScanner.
TcpUdpCommunication TCPUDP versión directa (FCL) Funcionalidad principal SÍ
Consulte la biblioteca para implementar
TcpUdpCommunication protocolos de
(véase SoMachine, comunicación basados
TcpUdpCommunication, en TCP (cliente y
Guía de la biblioteca) servidor) o UDP (que
incluye difusión y
multidifusión) a través
de Protocolo de Internet
versión 4 (IPv4).
78 EIO0000000795 06/2017

referencia IO
TimeSync TIMS versión directa (FCL) Esta biblioteca ofrece SÍ
Consulte Guía de la (sólo acceso servicios relacionados
biblioteca TimeSync cualificado) con la sincronización de
(véase SoMachine, tiempo. Con el cliente
TimeSync, Guía de la SNTP, el reloj del
biblioteca) controlador se puede
sincronizar con
servidores de hora en la
misma red con SNTP
(Simple Network Time
Protocol, protocolo
simple de hora de la
red).
NOTA: La
comunicación se
biblioteca
Categoría: Controlador
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Controlador:
Nombre Espacio de nombres Biblioteca de Descripción USUA

referencia RIO
DataLogging SEDL PH (FCL) Gestión de registro de SÍ
consulte Biblioteca SE_DataLogging datos de controladores
DataLogging que admiten
(véase SoMachine, operaciones de gestión
Funciones Data Logging, de archivos
Guía de la biblioteca
DataLogging)
EIO0000000795 06/2017 79
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Controlador →

ATV IMC:
Nombre Espacio de nombres Biblioteca de Descripción USUARI

referencia O
ATV- IMC HSC SEC_HSC PH (FCL) SE_HSC Gestión de contador de SÍ
consulte Contador de alta alta velocidad de ATV
velocidad (véase Altivar ATV IMC
IMC Drive Controller,
Contador de alta velocidad,
Guía de la biblioteca ATV-
IMC HSC)
ATV-IMC PLCSystem SEC PH (FCL) ATV IMC Funciones y SÍ
consulte Biblioteca SE_PLCSystem variables del sistema
PLCSystem (véase Altivar
ATV IMC Drive Controller,
Funciones y variables del
sistema, Guía de la biblioteca
ATV-IMC PLCSystem)
ATV-IMC SysLib V2.3 SEC_SL23 PH (FCL) Funciones y bloques de SÍ
SE_SysLibv23 funciones para la
compatibilidad con
aplicaciones Controller
Inside (CoDeSys v2.3)
ATV-IMC UserLib SEC_USER PH (FCL) SE_UserLib ATV IMC - Gestión de la SÍ
consulte Guía de la biblioteca interfaz del host de
UserLib de ATV IMC ATV71
(véase Altivar ATV IMC Drive
Controller, Guía de la
biblioteca ATV IMC UserLib)
80 EIO0000000795 06/2017

LMC058:

referencia IO
IoDrvTM5SEAISG SEC_TM5SEAISG PH IoDrvTM5SEAISG Biblioteca de SÍ
dispositivos
TM5SEAISG
Proporciona servicios de
calibración, tara y
medición calibrada
LMC058 Expert IO SEC_EXP PH (FCL) Gestión de E/S experta SÍ
 consulte Contador de alta SE_ExpertIO de LMC058
velocidad (véase Modicon
LMC058 Motion
Controller, Contador de
alta velocidad, Guía de la
biblioteca LMC058 de E/S
experta)
 consulte Modulación de
ancho de pulsos
(véase Modicon LMC058
Motion Controller,
Modulación de ancho de
pulsos, Guía de la
biblioteca LMC058 de E/S
experta)
LMC058 Motion SEC_MC PH (FCL) SE_Motion Funciones usadas para SÍ
consulte Contador de alta obtener un valor de eje
velocidad (véase Modicon de movimiento y para
LMC058 Motion Controller, restablecer el error
Contador de alta velocidad, detectado.
Guía de la biblioteca LMC058
de E/S experta)
LMC058 PLCSystem SEC PH (FCL) LMC058 Funciones y SÍ
PLCSystem (véase Modicon
LMC058 Motion Controller,
sistema, LMC058 Motion
Controller - Guía de la
biblioteca PLCSystem)
EIO0000000795 06/2017 81

referencia IO
Relocation Table SEC_RELOC PH (FCL) Biblioteca del sistema NO
SE_RelocationTable para la gestión de la
Tabla de reubicación
(véase Modicon
LMC058 Motion
Controller, Guía de
programación).
Ethernet Util SEC_ETH_UTIL PH (FCL) Biblioteca para servicios SÍ
SE_EthernetUtil de Ethernet.
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Controlador → M238:

referencia IO
M238 ASi Interface SEC_ASIITF PH (FCL) Biblioteca del sistema NO
SE_ASiInterface para la gestión del bus
AS-Interface
M238 HSC SEC_HSC PH (FCL) SE_HSC Gestión de contador de SÍ
consulte Contador de alta alta velocidad de M238
M238 Logic Controller,
Guía de la biblioteca M238
HSC )
M238 PLCSystem SEC PH (FCL) M238 Funciones y SÍ
M238 PLCSystem)
M238 PTOPWM SEC_PTOPWM PH (FCL) Gestión de PTO y PMW SÍ
consulte Salida de tren de SE_PTOPWM de M238
pulsos/Modulación de ancho
de pulsos (véase Modicon
M238 Logic Controller, Salida
de tren de pulsos,
modulación de ancho de
pulsos, Guía de la biblioteca
M238 PTOPWM)
82 EIO0000000795 06/2017

referencia RIO
M241 HSC SEC_HSC versión directa (FCL) Gestión de contador de SÍ
consulte la Guía de la alta velocidad de M241
biblioteca M241 HSC
Controller, High Speed
Counting, HSC Library Guide)
M241 PLCSystem SEC PH (FCL) Funciones y variables SÍ
consulte la Guía de la SE_PLCSystem del sistema M241
biblioteca M241 PLCSystem
Controller, Funciones y
variables del sistema, Guía
de la biblioteca PLCSystem)
M241 PTOPWM SEC_PTOPWM versión directa (FCL) Gestión de PTO y PWM SÍ
consulte la Guía de la de M241
biblioteca M241 PTOPWM
Controller, PTOPWM, Guía
de la biblioteca)

referencia RIO
M251 PLCSystem SEC PH (FCL) Funciones y variables SÍ
consulte la Guía de la SE_PLCSystem del sistema M251
biblioteca M251 PLCSystem
Controller, Funciones y

referencia IO
IoDrvTM5SEAISG SEC_TM5SEAISG PH IoDrvTM5SEAISG Biblioteca de SÍ
dispositivos
TM5SEAISG
Proporciona servicios de
calibración, tara y
medición calibrada
EIO0000000795 06/2017 83

referencia IO
M258 Expert IO SEC_EXP PH (FCL) Gestión de E/S experta SÍ
 consulte Contador de alta SE_ExpertIO de M258
Contador de alta
velocidad, Guía de la
biblioteca M258 de E/S
experta)
 consulte Modulación de
ancho de pulsos
(véase Modicon M258
Logic Controller,
Modulación de ancho de
pulsos, Guía de la
biblioteca M258 Expert
I/O)
M258 PLCSystem SEC PH (FCL) M258 Funciones y SÍ
M258 PLCSystem)
Ethernet Util SEC_ETH_UTIL PH (FCL) Biblioteca para servicios SÍ
SE_EthernetUtil de Ethernet.

XBTGC:

referencia RIO
XBTGC HSC SEC_HSC PH (FCL) SE_HSC Gestión de contador de SÍ
consulte Contador de alta alta velocidad de
velocidad (véase Magelis XBTGC
XBTGC HMI Controller,
XBTGC HSC - Guía de la
biblioteca)
84 EIO0000000795 06/2017

referencia RIO
XBT PLCSystem SEC PH (FCL) XBTGC Funciones y SÍ
PLCSystem (véase HMI
Controller Magelis XBTGC,
XBTGT, XBTGK, Funciones y
de la biblioteca XBT
PLCSystem)
XBT PTOPWM SEC_PTOPWM PH (FCL) Gestión de PTO y PMW SÍ
consulte Salida de tren de SE_PTOPWM de XBTGC
pulsos/Modulación de ancho
de pulsos (véase Magelis
XBTGC HMI Controller ,
Salida de tren de pulsos,
modulación de ancho de
pulsos, XBTGC PTOPWM -
Guía de la biblioteca)

HMISCU:

referencia RIO
HMISCU HSC HMISCU_HSC PH (FCL) Gestión de contador de SÍ
consulte HMISCU HSC HMISCU_HSC alta velocidad de
Library (véase Magelis SCU, HMISCU
HMI Controller, Guía de la
biblioteca HSC)
HMISCU PLCSystem SEC PH (FCL) HMISCU Funciones y SÍ
consulte HMISCU SE_PLCSystem variables del sistema
PLCSystem Library
(véase Magelis SCU, HMI
Controller, Guía de la
biblioteca PLCSystem)
HMISCU PTOPWM HMISCU_PTOPWM PH (FCL) Gestión de PTO y PMW SÍ
consulte HMISCU PTO/PWM HMISCU_PTOPWM de HMISCU
Library
SE_ModbusTCP_Slave MTS versión directa (FCL) Proporciona un bloque SÍ
consulte Magelis SCU HMI de funciones para
Controller Guía de administrar peticiones
programación (véase Magelis de ModbusTCP de
SCU, HMI Controller, Guía de cualquier cliente al
programación) controlador HMISCU.
EIO0000000795 06/2017 85
Categoría: Dispositivos
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Dispositivos:

referencia IO
Altivar Library SE_ATV PH (FCL) SE_Altivar Control de unidades de SÍ
consulte Guía de la biblioteca velocidad variable ATV.
Altivar
CANmotion Lexium Library SEM_LXM_SM versión directa (FCL) Funciones SÍ
consulte Guía de la biblioteca SM_Servo_Startup y
CANmotion Lexium SM_Stepper_Startup y
componentes asociados
de visualización para
facilitar la puesta en
marcha de los
accionamientos para
control de movimiento y
los motores paso a paso.
GMC Independent Altivar GIATV versión directa (FCL) Bloques de funciones SÍ
consulte Motion Control (sólo acceso específicos de Altivar,
Library Guide cualificado) para General Motion
(véase SoMachine, Guía de Control (GMC) de ejes
la biblioteca Motion Control) independientes a través
de Ethernet industrial.
GMC Independent Base GIB versión directa (FCL) Implementaciones NO
consulte Motion Control (sólo acceso básicas (reservadas
Library Guide cualificado) sólo para uso interno),
(véase SoMachine, Guía de para General Motion
la biblioteca Motion Control) Control (GMC) de ejes
independientes a través
GMC Independent Base GIBD versión directa (FCL) Implementaciones NO
Device (sólo acceso principales (reservadas
consulte Motion Control cualificado) sólo para uso interno),
Library Guide para General Motion
GMC Independent CANopen GICAN versión directa (FCL) Bloques de funciones NO
consulte Motion Control (sólo acceso PLCopen para control
Library Guide cualificado) de movimiento, para
(véase SoMachine, Guía de General Motion Control
la biblioteca Motion Control) (GMC) de ejes
independientes a través
de CANopen.
86 EIO0000000795 06/2017

referencia IO
GMC Independent GIEIP PH GMC Independent Backend EtherNet/IP NO
EtherNetIP (sólo acceso EtherNetIP (reservado sólo para uso
consulte Motion Control cualificado) interno), para General
Library Guide Motion Control (GMC)
(véase SoMachine, Guía de de ejes independientes.
la biblioteca Motion Control)
GMC Independent GIEIP PH GMC Independent Backend EtherNet/IP NO
EtherNetIP CIFX (sólo acceso EtherNetIP (reservado solo para uso
(véase SoMachine, Guía de de ejes independientes
la biblioteca Motion Control) con LMC078.
GMC Independent Interfaces GIITF versión directa (FCL) Interfaces (reservadas NO
consulte Motion Control (sólo acceso sólo para uso interno),
GMC Independent GITCP versión directa (FCL) Backend Modbus TCP NO
ModbusTCP (sólo acceso (reservado sólo para uso
(véase SoMachine, Guía de de ejes independientes.
la biblioteca Motion Control)
GMC Independent Lexium GILXM versión directa (FCL) Bloques de funciones SÍ
consulte Motion Control (sólo acceso específicos de Lexium,
GMC Independent PLCopen GIPLC versión directa (FCL) Bloques de funciones SÍ
MC (sólo acceso PLCopen para control
consulte Motion Control cualificado) de movimiento, para
Library Guide General Motion Control
(véase SoMachine, Guía de (GMC) de ejes
Integrated Lexium Library SEM_ILX PH (FCL) Control de unidades SÍ
consulte Guía de la biblioteca SE_IntegratedLexium Lexium integradas.
Lexium integrada
Lexium Library SEM_LXM PH (FCL) SE_Lexium Control de unidades SÍ
consulte Guía de la biblioteca Lexium 32, Lexium 05 y
Lexium Lexium SD3 en bus de
campo CANopen.
EIO0000000795 06/2017 87

referencia IO
Lexium 23 Library SEM_LXM23 versión directa (FCL) Control de unidades SÍ
consulte Guía de la biblioteca Lexium 23 en bus de
Lexium 23 campo CANopen.
Lexium 28 Library SEM_LXM28 versión directa (FCL) Control de unidades SÍ
consulte Guía de la biblioteca Lexium 28 en bus de
Lexium 28 campo CANopen.
Lexium 32i Library SEM_LXM32i versión directa (FCL) Control de unidades SÍ
Lexium32i en bus de
campo CANopen.
TeSys Library SE_TESYS versión directa (FCL) Control del arrancador SÍ
consulte Biblioteca TeSys controlador de motores
(véase SoMachine, TeSys U y del sistema
Funciones del arrancador del de gestión de motores
motor TeSys, Guía de la TeSys T.
biblioteca de TeSys) La biblioteca también
ofrece bloques de
funciones para el control
genérico de motores de
1 o 2 direcciones/1 o 2
velocidades.
Harmony ZBRN ZBRN versión directa (FCL) Proporciona la SÍ
consulte Harmony ZBRN funcionalidad de incluir
Library (véase SoMachine, botones pulsadores
Buscar botones vinculados a Harmony inalámbricos y
módulos ZBRN., Guía de la sin batería para el
biblioteca Harmony ZBRN) control remoto de la
aplicación.
FieldBusDevicesModbusTcp SEMFDM versión directa (FCL) Biblioteca de SÍ
(sólo acceso dispositivos del bus de
cualificado) campo con bus de
campo y bloques de
funciones específicos
del proveedor.
FieldBusDevicesPlcOpen SEMFDP versión directa (FCL) Biblioteca PLCopen SÍ
(sólo acceso para dispositivos del bus
cualificado) de campo con bloques
de funciones para el
control de movimiento.
TM3Safety TMSF versión directa (FCL) El módulo de seguridad SÍ
TM3 proporciona
funcionalidad de
seguridad incrustada en
el entorno TM3 de las
plataformas M2••.
88 EIO0000000795 06/2017

referencia IO
TM3TesysU TSU versión directa (FCL) Biblioteca de módulos SÍ
TeSys para
arrancadores de motor.
Categoría: Interna
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Interna → IoDrivers:

referencia IO
IoDrvEtherNetIPAdapter IoDrvEtherNetIPAdapte PH (FCL) Adaptador EtherNet/IP NO
r IoDrvEtherNetIP
Adapter
IoDrvPROFIBUSDPV1Slave IoDrvPROFIBUSDPV1 PH (FCL) Biblioteca de esclavo de NO
SlaveLib IoDrvPROFIBUSDPV PROFIBUS DP usada
1Slave para gestionar el módulo
TM5PCDPS
IoDrvSlave IoDrvSlaveLib PH (FCL) IoDrvSlave Biblioteca del dispositivo NO
esclavo ampliada por
IoDrvPROFIBUSDPV1S
lave
IoDrvModbusSerial IoDrvModbusSerial PH (FCL) Gestión de exploración NO
SE_ModbusIO de E/S de dispositivos
Scanner Modbus para el gestor
Modbus_IOScanner
(para obtener más
información sobre la
configuración del Gestor
Modbus, consulte la
ayuda online Editores de
dispositivos / Editor de
configuración Modbus /
Editor de configuración
Modbus / Editor de
dispositivos Modbus)
EIO0000000795 06/2017 89
Categoría: Solución
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Solución:

referencia IO
Hoisting SE_HOIST versión directa (FCL) Bloques de funciones SÍ
consulte Guía de la biblioteca para aplicaciones de
de elevación elevación
(véase SoMachine, Hoisting
Application Functions,
Hoisting Library Guide)
Hoisting_Basic SE_HOIST versión directa (FCL) Bloques de funciones SÍ
de elevación elevación principal
(véase SoMachine, Hoisting
Application Functions,
Hoisting Library Guide)
PackML PackML versión directa (FCL) Bloques de funciones, SÍ
Consulte la Biblioteca (sólo acceso estructuras y tramas de
PackML (véase PackML, cualificado) visualización para la
Guía de la biblioteca) gestión de datos y la
gestión de modalidad de
funcionamiento
conforme a PackML, tal
como lo define la norma
SA-TR88.00.02.
Packaging SE_PACK versión directa (FCL) Bloques de funciones SÍ
de embalaje empaquetado
(véase SoMachine,
Packaging Application
Functions, Packaging Library
Guide)
Pumping Pump versión directa Bloques de funciones SÍ
consulte Pumping Library para aplicaciones de
Guide (véase SoMachine, bombeo
Booster Pumping Application
Functions, Pumping Library
Guide)
EnergyEfficiencyToolbox EET versión directa (FCL) Bloques de funciones SÍ
consulte Guía de la biblioteca para recopilar datos
Energy Efficiency Toolbox sobre la energía de los
(véase Energy Efficiency equipos o dispositivos
Toolbox, Guía de la individuales y resumir el
biblioteca) consumo de la máquina.
90 EIO0000000795 06/2017

referencia IO
MachineEnergyDashboard MED versión directa (FCL) Información de MED, SÍ
consulte Guía de la biblioteca basada en los datos que
Machine Energy Dashboard ofrece la biblioteca
(véase SoMachine, Guía de EnergyEfficiencyToolbo
la biblioteca de escritorio x, que proporciona
digital sobre energía de mediciones
máquinas) significativas relativas a
la eficiencia energética
de una máquina.
ModbusEnergyEfficiencyTool MEET versión directa (FCL) Bloques de funciones SÍ
box para recopilar datos
consulte Guía de la biblioteca sobre la energía de los
Modbus Energy Efficiency equipos o dispositivos
Toolbox (véase Guía de la Modbus individuales y
biblioteca Modbus Energy, resumir el consumo de
Efficiency Toolbox) la máquina.
Categoría: Sistema
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Sistema:

referencia IO
FtpBase SE_FtpBase PH SE_FtpBase Funciones básicas para NO
FTP (File Transfer
Protocol). La interfaz de
usuario es la biblioteca
FtpRemoteFileHandling.
LMC078 PLCSystem SEC versión directa Funciones y variables SÍ
consulte LMC078 Motion del sistema LMC078
Controller - Guía de la
biblioteca PLCSystem
(véase Modicon LMC078
Motion Controller, Funciones
y variables del sistema, Guía
LMC078 Sercos3 S3 versión directa Biblioteca Sercos 3 para SÍ
LMC078
SystemConfigurationAddExt SystemConfigurationAd PH Ofrece NO
ends dExtends SystemConfiguration implementaciones
AddExtends básicas de POU de las
que se derivan los POU
de SystemConfiguration.
EIO0000000795 06/2017 91

referencia IO
SystemConfigurationItf SystemConfigurationItf PH Biblioteca de interfaz NO
SystemConfiguration para la configuración del
Itf sistema utilizada por la
biblioteca
IoDrvTM5PCDPS
SystemInterface SystemInterface PH SystemInterface Biblioteca del sistema NO
utilizada por la biblioteca
IoDrvTM5PCDPS
Categoría: Util
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Util:

referencia IO
FileFormatUtility FFU versión directa (FCL) La biblioteca ofrece SÍ
Consulte Biblioteca (sólo acceso funciones para generar
FileFormatUtility cualificado) o leer archivos
(véase SoMachine, codificados en
FileFormatUtility, Guía de la diferentes formatos
biblioteca) estructurados (p. ej.,
XML, CSV). Estos
archivos con formato se
pueden utilizar para
intercambiar datos entre
la aplicación del
controlador y los
sistemas externos (otros
controladores, servicios
web, Manufacturing
Enterprise System
[Sistema empresarial
para fabricación], etc.).
Toolbox SE_TBX versión directa (FCL) Conjunto de funciones y SÍ
consulte Guía de biblioteca bloques de funciones de
Toolbox (véase SoMachine, utilidad
Funciones varias, Guía de complementarios a las
biblioteca Toolbox) bibliotecas estándar e
Util declaradas
automáticamente
92 EIO0000000795 06/2017

referencia IO
Toolbox_Advance SE_TBXADV PH (FCL) Funciones usadas para SÍ
consulte Toolbox_Advance SE_ToolboxAdvance obtener y establecer el
(véase SoMachine, Gestión intervalo de una Tarea
de un intervalo de tareas cíclica.
cíclicas, Guía de la biblioteca
Toolbox_Advance)
FieldBusDevicesBase SEMFDB versión directa (FCL) Biblioteca base de NO
cualificado) campo
FieldBusDevicesItf SEMFDI versión directa (FCL) Biblioteca de interfaz de NO
cualificado) campo
TwidoEmulationSupport TES versión directa (FCL) Bloques de funciones NO
consulte Biblioteca (sólo acceso utilizados por proyectos
TwidoEmulationSupport cualificado) convertidos de
(véase Biblioteca Twido SoMachine Basic y
Emulation Support, Guía de Twido a SoMachine.
la biblioteca)
EIO0000000795 06/2017 93
Otras bibliotecas utilizadas en SoMachine
Introducción
A continuación se indican bibliotecas que no son de Schneider Electric que pueden resultar útiles.
Para obtener más información sobre cómo utilizar las siguientes tablas, consulte la introducción
de Bibliotecas de Schneider Electric (véase página 72).
Bibliotecas de 3S - Smart Software Solutions GmbH

Las bibliotecas disponibles en las categorías Intern y System son para uso interno del sistema y
no están disponibles para aplicaciones de usuario. Las bibliotecas se indican como tales en la
columna USUARIO de las tablas siguientes con la palabra NO. Las bibliotecas concebidas para
aplicaciones de usuario se indican con la palabra SÍ.
Bibliotecas disponibles en la categoría Casos de uso: bibliotecas de contenedor que recopilan
bibliotecas CAA acerca de un tema común (para obtener más información acerca de las funciones
CAA, consulte CoDeSys Libraries / Bibliotecas CAA).
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Intern → SoftMotion:
Nombre Espacio de Biblioteca de Descripción USUAR

nombres referencia IO
SM3_Basic SM3_Basic PH Funciones para la gestión básica de SÍ
SM3_Basic SoftMotion (para obtener más
información sobre la gestión básica,
consulte CoDeSys Libraries /
Bibliotecas SoftMotion)
NOTA: Esta biblioteca sólo se
admite en Modicon LMC058 Motion
Controller.
SM3_CNC SM3_CNC PH SM3_CNC Funciones para la gestión de CNC SÍ
de SoftMotion (para obtener más
información sobre la gestión de
CNC, consulte CoDeSys Libraries /
Bibliotecas SoftMotion)
NOTA: Esta biblioteca sólo se
admite en Modicon LMC058 Motion
Controller.
SM3_Drive_••• – – Bibliotecas de gestión del sistema NO
de SoftMotion (para obtener más
información, consulte Bibliotecas
CoDeSys/SoftMotion Libraries)
94 EIO0000000795 06/2017
Bibliotecas del sistema

En la tabla siguiente se describe la biblioteca disponible en la categoría (Varios):

CmpEventMgr CmpEventMgr PH Biblioteca de gestión de sistemas NO
CmpEventMgr de eventos
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Aplicación → Común:

Standard64 Standard64 PH Funciones para la gestión de SÍ
Standard64 cadenas de caracteres amplias y
para temporizadores de larga
duración
Standard Standard PH Standard Funciones y bloques de funciones SÍ
estándar de programación de IEC
(para obtener más información
sobre las funciones estándar,
Biblioteca estándar).
Util Util PH Util Funciones y bloques de funciones SÍ
adicionales de programación (para
obtener más información sobre
funciones adicionales, consulte
CoDeSys Libraries / Biblioteca Util)
Bibliotecas disponibles en la categoría Interna: algunas de estas bibliotecas son sólo para uso
interno del sistema.
En la tabla siguiente se describen las bibliotecas disponibles en la categoría Sistema → SysLibs:

Cmp••• – – Bibliotecas de gestión del sistema NO
Sys•••
ISys•••
SysTime SysTime PH SysTime Gestión del reloj de tiempo real SÍ
consulte Gestión del reloj
de tiempo real
(véase SoMachine,
Obtención y ajuste del reloj
en tiempo real, Guía de la
biblioteca SysTimeRtc y
SysTimeCore)
EIO0000000795 06/2017 95
En la tabla siguiente se describe la biblioteca disponible en la categoría Sistema → SysLibs23:
Nombre Espacio de Biblioteca de Descripción USUARI

nombres referencia O
Sys•••23 – – Bibliotecas de gestión del sistema NO
para la migración de proyectos de
CoDeSys v2.3
Bibliotecas del grupo de trabajo técnico CAA

En la tabla siguiente se describen las bibliotecas disponibles en la categoría Aplicación → CAA:

CAA••• – – Bibliotecas del grupo de trabajo de NO
CoDeSys Automation Alliance
acerca de las funciones CAA,
Bibliotecas CAA).
CAA CiA 405 CIA405 (sólo PH CAA Bloques de funciones para la SÍ
acceso CiA405 gestión del bus de campo
cualificado) CANopen desde la aplicación
En la tabla siguiente se describe la biblioteca disponible en la categoría Intern → CAA:

CAA••• – – Bibliotecas del grupo de trabajo de NO
CoDeSys Automation Alliance
acerca de las funciones CAA,
consulte Bibliotecas CoDeSys /
CAA Libraries).
CAA Net Base Services NBS PH Esta biblioteca implementa un SÍ *
(sólo acceso CAA NetBase servidor TCP, un cliente TCP y un
cualificado) Srv interlocutor UDP como una
colección de servicios básicos
para Ethernet.
* No utilice esta biblioteca junto con la biblioteca TcpUdpCommunication (Schneider Electric) o con
bibliotecas que implementan la biblioteca TcpUdpCommunication. Utilice la biblioteca
TcpUdpCommunication en lugar de la biblioteca CAA Net Base Services.
96 EIO0000000795 06/2017
SoMachine
Representación de funciones y de bloques de funciones
EIO0000000795 06/2017
Capítulo 6
Cada función se puede representar en los lenguajes siguientes:
 IL: Lista de instrucciones
 ST: Texto estructurado
 LD: Diagrama de contactos
 FBD: Diagrama de bloques de funciones
 CFC: Diagrama de función continua
En este capítulo se proporcionan funciones y ejemplos de representación de bloques de funciones

y se describe cómo utilizarlas en lenguajes IL y ST.

Apartado Página
Diferencias entre una función y un bloque de funciones 98
Cómo utilizar una función o un bloque de funciones en lenguaje IL 99
Cómo utilizar una función o un bloque de funciones en lenguaje ST 103
EIO0000000795 06/2017 97
Diferencias entre una función y un bloque de funciones
Función
Una función:
 Es una POU (Unidad de organización de programa) que devuelve un resultado inmediato.
 Se le llama directamente por su nombre (y no a través de una instancia).
 No tiene un estado persistente desde una llamada hasta la otra.
 Se puede utilizar como un operando en otras expresiones.
Ejemplos: operadores booleanos (AND), cálculos, conversión (BYTE_TO_INT)
Bloque de funciones
Bloque de funciones
 Es una POU (Unidad de organización de programa) que devuelve una o más salidas.
 Debe llamarse a través de una instancia (copia del bloque de funciones con nombre y variables
dedicados).
 Todas las instancias tienen un estado persistente (salidas y variables internas) de una llamada
a otra desde un bloque de funciones o programa.
Ejemplos: temporizadores, contadores
En el ejemplo, Timer_ON es una instancia del bloque de funciones TON:
98 EIO0000000795 06/2017
Cómo utilizar una función o un bloque de funciones en lenguaje IL
En esta sección se describe cómo implementar una función y un bloque de funciones en lenguaje
IL.
Las funciones IsFirstMastCycle y SetRTCDrift y el bloque de funciones TON se utilizan
como ejemplos para mostrar implementaciones.
Uso de una función en lenguaje IL

En este procedimiento se describe cómo insertar una función en lenguaje IL:
Paso Acción
1 Abra o cree una nueva POU en el lenguaje de Lista de instrucciones (IL).
NOTA: Aquí no se detalla el procedimiento para crear una POU. Para obtener más información,
consulte Adding and Calling POUs (véase SoMachine, Guía de programación).
2 Cree las variables que necesite la función.
3 Si la función tiene 1 o más entradas, empiece a cargar la primera entrada utilizando la instrucción
LD.
4 Inserte una nueva línea abajo y:
 escriba el nombre de la función en la columna de operadores (campo izquierdo); o
 utilice la opción Accesibilidad para seleccionar la función (seleccione Insertar llamada de módulo
en el menú contextual).
5 Si la función tiene más de una entrada y se utiliza Accesibilidad, se crea automáticamente el número
necesario de líneas con ??? en los campos de la derecha. Sustituya los ??? por el valor o la variable
adecuada que corresponda al orden de las entradas.
6 Inserte una línea nueva para almacenar el resultado de la función en la variable correspondiente:
escriba la instrucción ST en la columna del operador (campo de la izquierda) y el nombre de la
variable en el campo de la derecha.
Para ilustrar el procedimiento, considere las funciones IsFirstMastCycle (sin parámetro de

entrada) y SetRTCDrift (con parámetros de entrada) que se representan gráficamente a
continuación:
Función Representación gráfica

sin parámetros de entrada:
IsFirstMastCycle
EIO0000000795 06/2017 99

con parámetros de
entrada:
SetRTCDrift
En lenguaje IL, el nombre de la función se utiliza directamente en la columna de operadores:
Función Representación en el Editor IL de POU

Ejemplo en IL de una
función sin parámetros
de entrada:
IsFirstMastCycle
100 EIO0000000795 06/2017

Función Representación en el Editor IL de POU

Ejemplo en IL de una
función con parámetros
de entrada:
SetRTCDrift
Uso de un bloque de funciones en lenguaje IL

En este procedimiento se describe cómo insertar un bloque de funciones en lenguaje IL:
Paso Acción
1 Abra o cree una POU nueva en el lenguaje de Lista de instrucciones (IL).
2 Cree las variables que necesita el bloque de funciones, incluido el nombre de instancia.
3 Se llama a los bloques de funciones utilizando una instrucción CAL:
 Utilice la opción Accesibilidad para seleccionar el bloque de funciones (botón derecho del ratón y
seleccionar Insertar llamada de módulo en el menú contextual).
 La instrucción CAL y la E/S necesaria se crean automáticamente.
Cada parámetro (E/S) es una instrucción:

 Los valores de las entradas se establecen con ":=".
 Los valores de las salidas se establecen con "=>".
4 En el campo de la derecha CAL, sustituya ??? por el nombre de la instancia.

5 Sustituya otros ??? por una variable apropiada o un valor inmediato.
EIO0000000795 06/2017 101

Para ilustrar el procedimiento, considere este ejemplo con el bloque de funciones TON que se
representa gráficamente a continuación:
Bloque de funciones Representación gráfica

TON
En lenguaje IL, el nombre del bloque de funciones se utiliza directamente en la columna de

operadores:
Bloque de funciones Representación en el Editor IL de POU

TON
102 EIO0000000795 06/2017

Cómo utilizar una función o un bloque de funciones en lenguaje ST
En esta sección se describe el modo de implementar una función y un bloque de funciones en
lenguaje ST.
La función SetRTCDrift y el bloque de funciones TON se utilizan como ejemplos para mostrar
implementaciones.
Uso de una función en lenguaje ST

En este procedimiento se describe cómo insertar una función en lenguaje ST:
Paso Acción
1 Abra o cree una POU nueva en el lenguaje de Texto estructurado (ST).
2 Cree las variables que necesite la función.
3 Utilice la sintaxis general en el Editor POU ST para el lenguaje ST de una función. La sintaxis
general es:
FunctionResult:= FunctionName(VarInput1, VarInput2,.. VarInputx);
Para ilustrar el procedimiento, considere la función SetRTCDrift que se representa

gráficamente a continuación:

SetRTCDrift
EIO0000000795 06/2017 103

El lenguaje ST de esta función es este:
Función Representación en el editor POU ST de

SetRTCDrift PROGRAM MyProgram_ST
VAR myDrift: SINT(-29..29) := 5;
myDay: DAY_OF_WEEK := SUNDAY;
myHour: HOUR := 12;
myMinute: MINUTE;
myRTCAdjust: RTCDRIFT_ERROR;
END_VAR
myRTCAdjust:= SetRTCDrift(myDrift, myDay, myHour, myMinute);
Uso de un bloque de funciones en lenguaje ST

En este procedimiento se describe cómo insertar un bloque de funciones en lenguaje ST:
Paso Acción
1 Abra o cree una POU nueva en el lenguaje de Texto estructurado (ST).
NOTA: Aquí no se detalla el procedimiento para crear una POU. Para obtener más
información sobre la adición, declaración y llamadas de POU, consulte la
documentación (véase SoMachine, Guía de programación) relacionada.
2 Cree las variables de entrada y salida y la instancia requeridas para el bloque de
funciones:
 Las variables de entrada son los parámetros de entrada requeridos por el bloque
de funciones
 Las variables de salida reciben el valor devuelto por el bloque de funciones
3 Utilice la sintaxis general en el Editor POU ST para el lenguaje ST de un bloque de

funciones. La sintaxis general es:
FunctionBlock_InstanceName(Input1:=VarInput1,
Input2:=VarInput2,... Ouput1=>VarOutput1,
Ouput2=>VarOutput2,...);
Para ilustrar el procedimiento, considere este ejemplo con el bloque de funciones TON que se
representa gráficamente a continuación:
Bloque de Representación gráfica

funciones
TON
104 EIO0000000795 06/2017

En esta tabla se muestran ejemplos de una llamada de bloque de funciones en lenguaje ST:
Bloque de funciones Representación en el editor POU ST de

TON
EIO0000000795 06/2017 105

106 EIO0000000795 06/2017

SoMachine
Glosario
EIO0000000795 06/2017
Glosario
A
aplicación
Un programa que incluye datos de configuración, símbolos y documentación.
ASCII
(Código estándar estadounidense para el intercambio de información) Un protocolo que
representa caracteres alfanuméricos (letras, números y algunos caracteres gráficos y de control).
ATV
El prefijo de modelo para las unidades Altivar (por ejemplo, ATV312 hace referencia a la unidad
de velocidad variable Altivar 312).
B
bus de ampliación
Un bus de comunicación electrónico entre los módulos de E/S de ampliación y un controlador.
byte
Un tipo que está codificado en un formato de 8 bits que, en el formato hexadecimal, va de 00 hex
a FF hex.
C
cadena
Una variable que es una serie de caracteres ASCII.
calibración
El proceso de ajustar o conservar la precisión de un dispositivo de medición comparando su valor
con un estándar correcto conocido.
CFC
(diagrama de función continua) Un lenguaje de programación (una ampliación del estándar IEC
61131-3) basado en el lenguaje de diagrama de bloque de funciones (FBD) y que funciona como
un diagrama de flujo. Sin embargo, no se utiliza ninguna red y es posible un posicionamiento libre
de elementos gráficos, lo que permite bucles de realimentación. En cada bloque, las entradas se
sitúan a la izquierda y las salidas, a la derecha. Las salidas del bloque se pueden conectar a las
entradas de otros bloques para formar expresiones complejas.
CiA405
Interfaz y perfil de dispositivo de CANopen para controladores programables IEC 61131-3 .
EIO0000000795 06/2017 107

Glosario
configuración
Organización e interconexión de los componentes de hardware en un sistema y los parámetros
del hardware y software que determina las características operativas del sistema.
controlador
Automatiza procesos industriales (también conocido como controlador lógico programable o
controlador programable).
D
diagrama de bloques de funciones
Uno de los cinco lenguajes para lógica o control que cumplen con el estándar IEC 61131-3 para
sistemas de control. El diagrama de bloques de funciones es un lenguaje de programación
orientado gráficamente. Funciona con una lista de redes en la que cada red contiene una
estructura gráfica de cuadros y líneas de conexión que representa una expresión lógica o
aritmética, la llamada de un bloque de funciones, un salto o una instrucción de retorno.
E
E/S
(entrada/salida)
equipo
Una parte de la máquina que incluye subconjuntos tales como cintas transportadoras, plataformas
giratorias, etc.
F
FB
(bloque de funciones) Un práctico mecanismo de programación que consolida un grupo de
instrucciones de programación para realizar una acción específica y normalizada, por ejemplo, el
control de velocidad, el control de intervalo o el conteo. Un bloque de funciones se puede
componer de datos de configuración, un conjunto de parámetros de funcionamiento internos o
externos y, normalmente, una o diversas entradas y salidas de datos.
FCL
(biblioteca compatible con versiones posteriores) Una biblioteca compatible con versiones
posteriores se desarrolla de tal forma que sus funcionalidades sean compatibles con versiones
posteriores. Esto significa que cada versión de una biblioteca compatible con versiones
posteriores contiene todas las funcionalidades de la versión anterior y una versión más reciente
de la biblioteca, que puede usarse de forma sencilla en proyectos ya existentes sin realizar ningún
cambio.
108 EIO0000000795 06/2017

Glosario
FTP
(protocolo de transferencia de archivos) Un protocolo de red estándar incorporado en una
arquitectura de cliente-servidor que sirve para intercambiar y manipular archivos por redes
basadas en TCP/IP independientemente de su tamaño.
función
Una unidad de programación que dispone de una entrada y devuelve un resultado inmediato. No
obstante, a diferencia de los FBs, se llama directamente por su nombre (y no mediante una
instancia), no tiene un estado persistente desde una llamada hasta la siguiente y se puede utilizar
como un operando en otras expresiones de programación.
Ejemplos: operadores booleanos (AND), cálculos, conversiones (BYTE_TO_INT)
I
IEC
(International Electrotechnical Commission) Una organización de estándares internacional sin
ánimo de lucro y no gubernamental que prepara y publica estándares internacionales para todas
las tecnologías eléctricas, electrónicas y relacionadas.
IL
(lista de instrucciones) Un programa escrito en lenguaje que se compone de una serie de
instrucciones basadas en texto y ejecutadas secuencialmente por el controlador. Cada instrucción
incluye un número de línea, un código de instrucción y un operando (consulte IEC 61131-3).
INT
(entero) Un número entero con codificación de 16 bits.
IP
(protocolo de Internet) Parte de la familia de protocolos TCP/IP que hace un seguimiento de las
direcciones de Internet de los dispositivos, encamina los mensajes salientes y reconoce los
mensajes entrantes.
L
LD
(diagrama de contactos) Una representación gráfica de instrucciones de un programa de
controlador con símbolos para contactos, bobinas y bloques en una serie de escalones ejecutados
de forma secuencial por un controlador (consulte IEC 61131-3).
LMC
(Lexium Motion controller)
LMC058
Lexium motion controller Modicon Logic Controller.
EIO0000000795 06/2017 109

Glosario
M
M258
Modicon M258 Logic controller
máquina
Consta de diversas funciones o equipo.
Modbus
El protocolo de comunicaciones que permite las comunicaciones entre muchos dispositivos
conectados a la misma red.
P
POU
(unidad de organización de programas) Una declaración variable en el código fuente y el conjunto
de instrucciones correspondiente. Las POUs facilitan la reutilización modular de programas de
software, funciones y bloques de funciones. Una vez declaradas, cada una de las POUs está
disponible para las otras.
programa
El componente de una aplicación consistente en código fuente compilado capaz de poder ser
instalado en la memoria de un controlador lógico.
protocolo
Una convención o una definición de norma que controla o habilita la conexión, la comunicación y
la transferencia de datos entre dos sistemas o dispositivos informáticos.
PTO
(salidas de tren de pulsos) Una salida rápida que oscila entre apagado y encendido en un ciclo de
servicio fijo 50-50, que produce una forma de onda cuadrada. La PTO resulta especialmente útil
para aplicaciones como motores paso a paso, conversores de frecuencia, controles de
servomotor, etc.
PWM
(modulación de ancho de pulsos) Una salida rápida que oscila entre el apagado y el encendido en
un ciclo de servicio ajustable, que produce una forma de onda rectangular (aunque se puede
ajustar para que produzca una onda cuadrada).
R
red
Un sistema de dispositivos interconectados que comparten una ruta de datos común y un
protocolo de comunicaciones.
110 EIO0000000795 06/2017

Glosario
red de control
Red que contiene logic controllers, sistemas SCADA, PC, HMI, conmutadores, etc.
Se admiten dos tipos de topología:
 Plana: todos los módulos y dispositivos de esta red pertenecen a la misma subred.
 Dos niveles: la red se divide en una red operativa y en una red de controladores.
Estas dos redes pueden ser físicamente independientes, pero normalmente están conectadas
mediante un dispositivo de enrutamiento.
S
símbolo
Una cadena con un máximo de 32 caracteres alfanuméricos cuyo primer carácter es alfabético.
Permite personalizar un objeto del controlador para facilitar el mantenimiento de la aplicación.
SNMP
(protocolo simple de gestión de redes) Un protocolo que puede controlar una red de forma remota
consultando los dispositivos para conocer su estado, realizar pruebas de seguridad y ver
información sobre la transmisión de datos. También se puede utilizar para gestionar software y
bases de datos de forma remota. El protocolo también permite realizar tareas de gestión activas,
por ejemplo la modificación y aplicación de una nueva configuración.
SNTP
(simple network time protocol, protocolo simple de hora de la red) Una versión simplificada del
protocolo NTP (hora de la red). Se utiliza para sincronizar las horas de reloj de los ordenadores
de una red de ordenadores. Utiliza Hora universal coordinada (UTC) para sincronizar la hora de
los relojes de ordenador con precisión de milisegundo o, a veces, inferior al milisegundo.
SQL
SQL (del inglés Structured Query Language, lenguaje de consulta estructurado) es un lenguaje de
programación para gestionar datos almacenados en sistemas de gestión de bases de datos
relacionales.
ST
(texto estructurado) Un lenguaje que incluye instrucciones complejas y anidadas (por ejemplo,
bucles de repetición, ejecuciones condicionales o funciones). ST cumple con IEC 61131-3.
T
tarea cíclica
El tiempo de exploración cíclica tiene una duración fija (intervalo) especificada por el usuario. Si
el tiempo de exploración actual es más corto que el cíclico, el controlador espera hasta que
transcurre el tiempo de exploración cíclica antes de iniciar una nueva exploración.
EIO0000000795 06/2017 111

Glosario
TCP
(protocolo de control de transmisión) Un protocolo de capas de transporte basado en conexiones
que proporciona una transmisión de datos simultánea y bidireccional. TCP forma parte del
conjunto de protocolos TCP/IP.
U
UDP
(protocolo de datagramas de usuario) Un protocolo de modalidades sin conexión (definido por
IETF RFC 768) en el que los mensajes se entregan en un datagrama (telegrama de datos) a un
ordenador de destino de una red IP. El protocolo UDP generalmente se integra con el protocolo
de Internet. Los mensajes UDP/IP no necesitan una respuesta y, por lo tanto, son perfectos para
aplicaciones en las que los paquetes cerrados no requieren retransmisión (como redes y vídeos
que necesitan rendimiento en tiempo real).
V
variable
Una unidad de memoria direccionada y modificada por un programa.
variable del sistema
Una variable que proporciona datos del controlador e información de diagnóstico, y permite enviar
comandos al controlador.
112 EIO0000000795 06/2017

SoMachine
Índice
EIO0000000795 06/2017
Índice
A
administrador de bibliotecas, 11
B
bibliotecas, 11
F
funciones
cómo utilizar una función o un bloque de
funciones en lenguaje IL, 99
cómo utilizar una función o un bloque de
funciones en lenguaje ST, 103
diferencias entre una función y un bloque
de funciones, 98
L
LanguageModelAttribute, 39, 65
R
repositorio de bibliotecas, 11
EIO0000000795 06/2017 113

Manual Somachine

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual Somachine

Cargado por

Copyright:

Formatos disponibles

SoMachine

Información relativa al producto

Terminología derivada de los estándares

Descripción general de las bibliotecas

Conceptos generales acerca de las bibliotecas

Contenido de las bibliotecas

La administración de las bibliotecas en un proyecto se realiza mediante los Administradores de

Información Descripción Ejemplo

Se define un espacio de nombres predeterminado para cada biblioteca.

Administración de bibliotecas mediante los administradores de bibliotecas

Caso de uso Ubicación del Administrador de bibliotecas

Para obtener más información sobre la administración de bibliotecas, el Repositorio de bibliotecas

Contenido de este capítulo

Métodos de referenciación de bibliotecas

Contenido de esta sección

Biblioteca... Requiere la biblioteca Z en la versión...

Versión más reciente

Biblioteca... Requiere la biblioteca Z en la versión...

Además, la siguiente versión de la biblioteca está instalada en el Repositorio de biblioteca:

Si se añadiese la biblioteca Z con el método de la versión más reciente, significaría:

Mecanismo de marcador de posición

Marcador de posición Biblioteca

Biblioteca... Requiere la biblioteca Z por el marcador de

Además, los siguientes marcadores de posición se reemplazan por el controlador A:

Versión de la biblioteca definida en el Versión de la biblioteca predeterminada en

Bibliotecas compatibles con versiones posteriores

Biblioteca... Requiere una versión mínima de la biblioteca

Las siguientes versiones de la biblioteca Z están instaladas en el sistema local:

 Si un proyecto utiliza la versión 2.0.0.0 del controlador A, la siguiente biblioteca será

 Si el controlador A utilizado en el proyecto se ha actualizado a la versión 2.0.0.0, se

Contenido de esta sección

Diversas maneras de declarar una biblioteca en un proyecto

 características específicas del controlador

Adición de bibliotecas a un proyecto de SoMachine

Si la biblioteca es... y... utilice el...

Actualización de bibliotecas y referencias de las bibliotecas

Cuadro de diálogo Actualizar proyecto

Actualización manual de la biblioteca

Actualización manual del dispositivo

Proyecto creado con una versión anterior

Creación de su propia biblioteca compatible con versiones posteriores

Editor del Administrador de bibliotecas

Contenido de este capítulo

Editor del Administrador de bibliotecas

La vista de ventana del editor consta de 4 partes:

Descripción de la parte superior

Biblioteca referenciada (véase página 17).

El archivo de la biblioteca referenciada no se ha podido encontrar o no es una

Si una biblioteca tiene dependencias en otras bibliotecas (biblioteca referenciada

Descripción de la parte inferior

Ficha Marcador de posición

Utilice marcadores de posición en los casos siguientes:

Adición de una biblioteca mediante un marcador de posición

NOTA: Antes de trabajar en proyectos de biblioteca y modificar los ajustes de espacios de

Área General del cuadro de diálogo

Área Versión del cuadro de diálogo

Área Visibilidad del cuadro de diálogo

Cargar de nuevo la biblioteca

Cuadro de diálogo Repositorio de bibliotecas

El cuadro de diálogo muestra las ubicaciones (repositorios) de la biblioteca definida y las

El cuadro de diálogo Repositorio de bibliotecas contiene los siguientes elementos:

Ubicaciones de biblioteca (repositorios)

Definición de un nuevo repositorio o modificación de ruta y nombre de un repositorio existente

Eliminación de un repositorio existente