You are on page 1of 11

Sistema RTUQM

Manual del Usuario

Versión 2.3

1 INTRODUCCIÓN .................................................................................................................................... 2

2 ARQUITECTURA.................................................................................................................................... 2
2.1 MÓDULO CONSOLA ............................................................................................................................. 3
2.2 MÓDULO BASE DE DATOS (BD)........................................................................................................... 3
2.3 MÓDULOS DRIVER .............................................................................................................................. 3
2.4 MÓDULOS PROTOCOLO....................................................................................................................... 3
2.5 MÓDULOS GPS.................................................................................................................................. 3
2.6 MÓDULO PLC .................................................................................................................................... 3
2.7 ADMINISTRADOR ................................................................................................................................. 4
3 ARCHIVOS.............................................................................................................................................. 4
3.1 ARCHIVOS EJECUTABLES .................................................................................................................... 4
3.2 ARCHIVOS DE CONFIGURACIÓN ............................................................................................................ 4
3.3 ARCHIVOS DE BLOQUEO ...................................................................................................................... 4
3.3.1 Puertos seriales ........................................................................................................................ 4
3.3.2 Consola y base de datos .......................................................................................................... 5
3.3.3 Borrado de archivos de bloqueo............................................................................................... 5
4 LICENCIAMIENTO ................................................................................................................................. 6
4.1 FUNCIONAMIENTO ...............................................................................................................................6
4.2 DETECCIÓN DE ERRORES .................................................................................................................... 6
5 COMUNICACIÓN ENTRE MÓDULOS................................................................................................... 7
5.1 PARÁMETROS DE CONFIGURACIÓN....................................................................................................... 7
5.1.1 Carpeta General ....................................................................................................................... 7
5.2 RECOMENDACIONES PARA LOS TAMAÑOS DE LAS COLAS DE MENSAJES .................................................. 7
5.3 ARCHIVO DE CONFIGURACIÓN DEL SISTEMA .......................................................................................... 8
5.3.1 Sección Global.......................................................................................................................... 8
5.3.2 Sección General ....................................................................................................................... 8
5.4 EJEMPLO ........................................................................................................................................... 9
6 COMANDOS DE TERMINAL COMUNES............................................................................................10

7 REVISIONES.........................................................................................................................................11

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 1/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
1 Introducción
El sistema de aplicación RTUQM es un conjunto de programas que implementa las funcionalidades de una
unidad remota de telecontrol. El presente documento define su arquitectura general y se complementa con
la documentación particular de cada uno de los módulos del sistema.

2 Arquitectura
El sistema funciona sobre el sistema operativo QNX V6.2.1 en plataforma Intel. Esta compuesto por el
funcionamiento concurrente de varios módulos, los cuales se muestran en el siguiente diagrama.

PLC

Sistema SCADA
Drivers Base de
Hardware de Datos
adquisición

Protocolos

GPS

Consola

RTU

Administrador

El corazón del software del la RTU consiste en dos módulos, la base de datos y la consola. Ambos deben
ejecutarse y debe haber una única instancia de cada uno funcionando sobre la RTU.

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 2/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
2.1 Módulo Consola
El módulo consola es primero ejecutado y es el que ejecuta a todos los demás módulos. La consola se
encarga, entre otras cosas, de:

• Ejecución de los módulos de la RTU.


• Supervisar el funcionamiento de la RTU y resetear el watchdog de hardware permitiendo el
reinicio del sistema ante una falla de alguno de los módulos.
• Proporcionar una interface hacia el programa administrador de RTU mediante la cual se puede
configurar el funcionamiento y monitorear el estado de la misma.
• Sincronizar la hora de la RTU según señales de sincronización recibidas desde los otros
módulos.

2.2 Módulo Base de Datos (BD)


La base de datos mantiene una base de datos en memoria de todos los puntos de la RTU. El estado de los
puntos es adquirido desde el hardware a través de los módulos driver y presentado al sistema SCADA a
través de los módulos protocolo.

2.3 Módulos Driver


La principal finalidad de los drivers es realizar la adquisición de datos desde el hardware. Cada tipo de
hardware empleado dispone de un driver (Bus 485C, Modbus, etc.). Pueden haber varios drivers distintos
y/o varias instancias del mismo driver funcionando simultáneamente. El driver adquiere los datos desde el
hardware y los presenta a la base de datos, para ello los mismos asocian cada una de las entradas y
salidas del hardware con un punto de la base de datos.

2.4 Módulos Protocolo


Cada módulo de protocolo implementa un protocolo de comunicaciones específico para transferir estados y
comandos con un sistema scada. Pueden haber varias instancias de módulos protocolo funcionando
simultáneamente y cada una exporta una RTU lógica hacia el exterior (LRU). Una LRU define una vista
particular de la RTU exportando un conjunto de puntos lógicos que se mapean de alguna forma con los
puntos reales del módulo de base de datos.

2.5 Módulos GPS


Estos módulos permiten sincronizar la hora de la RTU mediante un receptor GPS. El módulo a usar
dependerá del modelo de GPS elegido.

2.6 Módulo PLC


El módulo permite a la RTU ejecutar lógica programable por el usuario. El mismo toma los puntos de la
base de datos, los procesa y se los devuelve a la misma.

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 3/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
2.7 Administrador
Es un programa que corre sobre MS Windows en una computadora independiente y permite administrar,
configurar y supervisar el funcionamiento de la RTU.

3 Archivos

El sistema de aplicación esta compuesto por un conjunto de archivos ejecutables y de archivos de


configuración. Todos los archivos de la aplicación RTUQM se almacenan bajo el directorio /rtu

3.1 Archivos ejecutables


Los archivos ejecutables se almacenan bajo el directorio /rtu/exe. En general para los distintos módulos
que conforman el sistema puede haber mas de una instancia de cada uno funcionando simultáneamente
con diferentes archivos de configuración.

3.2 Archivos de configuración


Los archivos de configuración se almacenan bajo el directorio /rtu/config. Los archivos de configuración
son de formato texto estructurado compuesto por registros ordenados por secciones. Cada comienzo de
sección se marca con su nombre entre corchetes [Seccion] los registros de la sección se marcan con su
nombre seguido por el símbolo =.
Por ejemplo

[Seccion1]
Registro1_seccion1=11243
Registro2_seccion1=Texto libre
Descripcion=Ejemplo de archivo de configuración

[SeccionSiguiente]
RegistroA =21
RegistroB =des

3.3 Archivos de bloqueo


El sistema RTUQM maneja un conjunto de archivos de bloqueo para controlar el acceso a los puertos
seriales y para evitar que se ejecute mas de una instancia de los módulos de consola y base de datos.
Dichos archivos se almacenan bajo el directorio /rtu/lock.

3.3.1 Puertos seriales


Cada vez que un módulo necesita abrir el puerto serial X verifica previamente al archivo /rtu/lock/serX.
Si el archivo no existe lo crea, lo bloquea y abre el puerto serial.
Si el archivo existe y no está bloqueado, lo bloquea y abre el puerto serial

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 4/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
Si el archivo existe y está bloqueado se asume que el puerto está abierto por otro módulo por lo tanto no
intenta abrirlo y registra el error en el registro de errores del módulo.
Cuando un módulo termina su ejecución se desbloquean los archivos de bloqueo correspondientes a los
puertos abiertos por el mismo.

3.3.2 Consola y base de datos


Cada vez que se inicia el módulo consola se verifica el archivo /rtu/lock/consola.
Si el archivo no existe lo crea, lo bloquea y ejecuta normalmente.
Si el archivo existe y no está bloqueado, lo bloquea y ejecuta normalmente.
Si el archivo existe y está bloqueado se asume que ya hay un módulo consola ejecutándose por lo tanto el
programa termina.
Cuando la consola termina su ejecución se desbloquea el archivo de bloqueo correspondiente.
El módulo base de datos utiliza el archivo de bloqueo /rtu/lock/bd.

3.3.3 Borrado de archivos de bloqueo


Dado que es posible que la RTU se apague sin cerrar ordenadamente el software de aplicación es posible
que los archivos de bloqueo queden abiertos. Para evitar esta circunstancia el contenido del directorio lock
debe borrarse cada vez que se inicia el sistema operativo.

El instalador del sistema RTUQM agrega la siguiente línea al archivo de comandos /etc/cleanup (que es
llamado desde /etc/config/sysinit.1):

rm -rf /rtu/lock/*

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 5/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
4 Licenciamiento
El sistema RTUQM implementa un esquema de licenciamiento a través de una llave de hardware y de un
archivo de licencia.
Este licenciamiento determina:
- Cuantos puntos admite la base de datos
- Que módulos se pueden ejecutar
- Cuántas instancias de cada uno de los módulos se pueden ejecutar

4.1 Funcionamiento
La CPU lleva instalado en su puerto paralelo (generalmente interno) un dongle o dispositivo de seguridad.
Este dongle es interrogado por el módulo “llave” del sistema RTUQM para obtener el número de serie
grabado en el mismo.

Cada módulo que ejecuta el sistema lee el archivo de licencia “/rtuqm/config/licencia.txt” e interroga al
módulo llave para obtener el número de serie del dongle instalado.
Si el numero de serie de la llave corresponde con alguno de los números de serie habilitados en el archivo
de licencia el módulo lee el resto del archivo para determinar si esta autorizado a ejecutarse y si no se ha
alcanzado la cantidad máxima de instancias permitidas. El modulo solo ejecuta si todo lo anterior se ha
cumplido.

Un mismo archivo de licencia puede tener registradas varias llaves de forma de poder usar el mismo
archivo en un conjunto de sistemas idénticos.

4.2 Detección de errores


Es posible interrogar al módulo llave para ver si éste detecta un dongle instalado y qué numero de serie
tiene el mismo. Para ello se debe dar el siguiente comando de consola QNX:

/rtuqm/exe/llave –n –p378

El mismo interroga al puerto paralelo 0x378 (LPT1) y, de encontrar un dongle instalado en el mismo,
devuelve su número de serie.

Este número de serie puede ser contrastado con los números registrados en el archivo
/rtuqm/config/licencia.txt el que puede ser abierto con un editor de textos.

El modulo consola brinda a través del administrador información acerca del sistema de licenciamiento.
En la carpeta Información general se dan detalles acerca de la llave instalada y si la misma es válida o no.
Mediante el comando licencia de la ventana de debug del módulo consola es posible obtener información
adicional acerca del contenido del archivo licencia.txt tal como llaves y cantidad de módulos autorizados.
Mediante el comando licencia de la ventana de debug del módulo base de datos es posible obtener
información acerca de la cantidad de puntos autorizados.

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 6/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
5 Comunicación entre módulos

Toda la comunicación entre los módulos de la RTU se realiza mediante colas de mensajes no bloqueantes
(según la especificación POSIX). Para ello cada módulo implementa una cola de recepción de mensajes de
una determinada capacidad.

Existen restricciones en cuanto a la capacidad de las colas de mensajes:

• La memoria disponible del sistema nos impone un límite superior en cuanto a la cantidad de
memoria que podemos asignar a cada cola de mensajes.
• El flujo de mensajes intercambiados entre los procesos nos ponen un límite inferior en cuanto a la
capacidad mínima necesaria para que las colas puedan contener efectivamente los mensajes ha
intercambiar.
• La cantidad de los mensajes intercambiados depende de la configuración particular de cada RTU,
cuanto mas puntos configurados hayan, mas mensajes se necesitarán intercambiar.

Lo que se necesita es poder definir la capacidad de cada cola de mensajes de acuerdo a la configuración
de cada RTU en particular. Para ello se utiliza un archivo de configuración especial de la RTU, el archivo
de configuración del sistema /rtu/config/rtu.ini, en el cual se definen los tamaños de las colas de
mensajes de cada uno de los módulos de la RTU.

5.1 Parámetros de configuración


El archivo de configuración del sistema se edita mediante el administrador de RTU. A continuación se
describen las distintas opciones.

5.1.1 Carpeta General


- Descripción: Texto libre que describe la configuración del módulo.
- Tamaños de las colas de comunicaciones: Para cada tipo de módulo soportado se especifica el
tamaño de la cola de comunicaciones a usar.

5.2 Recomendaciones para los tamaños de las colas de mensajes

A continuación se muestran los tamaños recomendados de las colas de mensajes para cada módulo. Para
aquellos módulos cuya capacidad de cola dependa de los puntos configurados se muestra la misma para
una configuración de 1Kpuntos (1024 puntos). Los tamaños crecerán en forma directamente proporcional a
la cantidad de puntos configurados. Todos los tamaños expresados son valores mínimos
independientemente de las configuraciones de los módulos.

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 7/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
Módulo Configuración Factor de Factor de Tamaño recomendado
multiplicación corrección
bd 1kpuntos 20 1.3 26 Kbytes
drivers 20 Kbytes
protocolos 1kpuntos 20 1.5 30 Kbytes
gps 5 Kbytes
consola 20 Kbytes

El factor de multiplicación de la tabla representa el tamaño promedio de todos los puntos configurados. Los
tamaños de cada tipo de punto se representan en la siguiente tabla:

Tipos de puntos Tamaño (en bytes)


bool 20
int 20
float 20
string 20 + largo del string

El factor de corrección de la tabla es un valor experimental obtenido de las pruebas realizadas a la RTU y
surge de considerar el aumento del flujo de mensajes y la disminución de la capacidad de procesamiento
de cada módulo, debido a la ejecución concurrente de varios módulos de la RTU.

5.3 Archivo de configuración del sistema


En el archivo de configuración del sistema se definen todos aquellos parámetros necesarios para la
configuración del sistema de RTU. El mismo se edita mediante la interfaz gráfica del administrador de RTU
aunque puede ser editado directamente con un editor de textos En dicho archivo se identifican las
siguientes secciones y campos:

5.3.1 Sección Global

Sección Descripción
Global En esta sección se definen los datos globales que deben tener todos los archivos de
configuración (obligatorio).
Campo Tipo de dato Descripción
Tipo TipoModulo Indica el tipo de configuración, y el valor correspondiente es
MODULO_SISTEMA.
Descripcion String Descripción de la configuración (opcional). Valor por defecto
Configuracion del sistema

5.3.2 Sección General

Sección Descripción

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 8/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
Colas En esta sección se definen la capacidad máxima en KBytes de las colas de mensajes
utilizadas por los diferentes módulos de la RTU (obligatorio).
Campo Tipo de dato Descripción
MODULO_BD Número entero > 0 Capacidad máxima para la cola del módulo de Base de Datos.
Valor por defecto 26.
MODULO_CON Número entero > 0 Capacidad máxima para la cola del módulo Consola. Valor por
SOLA defecto 20.
MODULO_DRIV Número entero > 0 Capacidad máxima para la cola de los módulos Driver 485. Valor
ER_485 por defecto 20.
MODULO_PRO Número entero > 0 Capacidad máxima para la cola de los módulos Protocolo 101.
TOCOLO_101 Valor por defecto 30.
MODULO_GPS Número entero > 0 Capacidad máxima para la cola del módulo Gps Oncore. Valor
_ONCORE por defecto 5.
MODULO_GPS Número entero > 0 Capacidad máxima para la cola del módulo Gps Meinberg. Valor
_MEINBERG por defecto 5.

5.4 Ejemplo
[Global]
Tipo=MODULO_SISTEMA
Version=1.6
Descripcion=Configuracion del sistema RTU A-1

[Colas]
MODULO_BD=26
MODULO_CONSOLA=20
MODULO_DRIVER_101=20
MODULO_DRIVER_485=20
MODULO_DRIVER_DPU=10
MODULO_DRIVER_SMOR=10
MODULO_DRIVER_MODBUS=20
MODULO_GPS_MEINBERG=5
MODULO_GPS_ONCORE=5
MODULO_PLC=10
MODULO_PROTOCOLO_101=30

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 9/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
6 Comandos de terminal comunes
Se detallan a continuación los comandos de terminal comunes para todos los módulos. Los mismos
pueden ser enviados mediante la carpeta consola de debug del administrador de RTU o, con el módulo
ejecutado desde línea de comandos, directamente desde el teclado.

help
Uso: help ó ?
Descripción: Muestra la lista de los comandos disponibles. Help (ó ?) seguido por el nombre de un
comando muestra la ayuda del comando en cuestión.

clear
Uso: clear
Descripción: Borra la pantalla

clearerrores
Uso: clearerrores
Descripción: Borra la lista de errores en memoria.

debuglevel
Uso: debuglevel d
d = Nuevo nivel de debug
Descripción: Fija el nivel de debug a mostrar en la consola de QNX cuando el programa se ejecuta en
modo debug. Los niveles de debug van de 1 (errores) hasta 4 (información general) Los
mensajes mostrados son aquellos que tienen su nivel de debug en un valor igual o menor
que el valor configurado. Debuglevel 0 detiene el despliege de información de debug.

errores
Uso: errores [-f file]
Descripción: Muestra la lista de errores en memoria.
-f file = Redirecciona la salida al archivo file

estadistica
Uso: estadistica [-r | -f file]
Descripción: Muestra información estadística de mensajes intercambiados con el resto de los módulos
de la RTU.
-r = Resetea el cálculo estadístico.
-f file = Redirecciona la salida al archivo file

quit
Uso: quit
Descripción: Termina la ejecución del programa.

reiniciar
Uso: reiniciar
Descripción: Reinicia el programa leyendo nuevamente la configuración desde disco.

showconfig

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 10/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com
Uso: showconfig
Descripción: Muestra el archivo de configuración en uso

showdebug
Uso: showdebug d
Descripción: Fija el nivel de debug a mostrar en la administrador de RTUQM. Tiene un comportamiento
similar a debuglevel.

showinfo
Uso: showinfo
Descripción: Muestra la información reportada a la carpeta Información General del Administrador de
RTU.

7 Revisiones

Versión 1.0 – 02/04/2001


• Primera versión del documento.

Versión 2.0 – 11/01/2002


• Se actualiza con los cambios realizados software.

Versión 2.1 – 24/07/2002


• Se actualiza con los cambios realizados software.

Versión 2.2 – 08/08/2002


• Se agrega información sobre el directorio lock.

Versión 2.3 – 01/06/2003
• Se agrega información de licenciamiento.

RTUQM, Manual del Usuario


RTUQM 00 - General V2_2.doc 11/11 06/09/a

AVENIDA RIVERA 3314


CONTROLES S. A. 11300 MONTEVIDEO, URUGUAY
TEL +598 ( 2) 622 0651
ELECTRÓNICA INDUSTRIAL Y TELECOMUNICACIONES FAX +598 (2) 622 2048
E-MAIL info@controles.com

You might also like