#######################################################
##                        LEEME                      ##
##~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~##
##                      28-02-2005                   ##
#######################################################

   Éste es un proyecto vacío de aplicación ARTIS. Se compone
de un conjunto de ficheros en lenguaje XML (class.xml, class.xsd,
control.xml, entities.xml, metaclass.xml), en los que se encuentran
especificadas las distintas componentes de la aplicación ARTIS, y un
conjunto de plantillas necesarias para compilar y ejecutar la
aplicación diseñada (main.c, Makefile y rtload).


- LOS FICHEROS XML

   Los ficheros en formato XML que se encuentran en el directorio
se encuentran inicialmente vacíos; es decir, que deben ser
completados antes de que se pueda generar el código C necesario
y que éste se pueda compilar y ejecutar. La forma más fácil de
escribir estos ficheros XML es empleando la herramienta TNT,
disponible también con esta versión de ARTIS, la cual puede ser
ejecutada simplemente invocando a runTNT desde un terminal; sin
embargo, es posible escribir el código XML a mano directamente,
evitando así tener que emplear TNT.

   
- GENERACIÓN DE CÓDIGO C Y COMPILACIÓN DEL MISMO

   Una vez se han completado los distintos ficheros XML, ha de generarse
el código C de la aplicación a partir de los mismos. Para ello sólo han
de invocarse los parsers correspondientes desde un terminal:

   artis_entities_parser entities.xml
   artis_kdm_parser class.xml
   artis_mrules_parser control.xml
   artis_metaclass_parser metaclass.xml

   En cualquier caso, el fichero Makefile está preparado para poder hacer
esto de manera automática, de modo que en realidad basta con ejecutar la
orden 'make parse' desde el mismo terminal para que automáticamente se parseen los
distintos ficheros.
 
   También es posible parsear y compilar haciendo 'make', aunque a veces es deseable
haber añadido el código necesario a los KS's.

- EJECUCIÓN DE LA APLICACIÓN ARTIS

   Para ejecutar la aplicación recién generada simplemente bastará con
invocar el script rtload (también disponible en el directorio de la misma).
Éste script se ocupa de insertar en el orden correcto los distintos módulos
que componen la aplicación y de lanzar el programa principal, así como también
se ocupa de parar la aplicación y descargar los distintos módulos de la misma
de manera ordenada.

   La forma de invocar a rtload es como sigue:
   
   rtload <tiempo de ejecución> <archivo_de_traza>
   
   El tiempo de ejecución se expresa en segundos y el archivo de traza es el fichero
donde se van a guardar los datos de traza de la ejecución de la aplicación ARTIS
(siempre que ARTIS  se haya compilado con el soporte para traza activado).

   El script rtload puede ser modificado para adaptarse mejor a la aplicación que se
esté diseñando, de modo que se inserten los módulos adicionales (como por ejemplo,
el driver para puerto serie de RT-Linux, rt_com).