3.2. Como usar el programa

Una vez escrito el archivo de proyecto de síntesis podemos invocar a la herramienta para que genere los archivos necesarios y realice la síntesis. Si en nuestro directorio de proyecto existe un único .xilprj podemos usar:

$ xil_project.pl make

Si poseemos más de uno será necesario especificar cual nos interesa:

$ xil_project.pl make proyecto.xilprj

Una vez generado el archivo de make es posible realizar nuevas síntesis utilizando el comando make.

3.2.1. Configuración

En el caso en que hayamos instalado las herramientas de Xilinx tal como se describe en Sección 1.2, y que esta herramienta se encuentre correctamente instalada, no sería necesario ajustar nada. Caso contrario poseemos las siguientes opciones.

3.2.1.1. Configuración de ISE

Si las herramientas de Xilinx no fueron instaladas en /usr/local/ISEWb y no es posible moverlas o enlazarlas con esa posición, podemos usar dos mecanismos:

  • La opción de línea de comandos --tool-dir=DIRECTORIO_ISE

  • Definir la variable de entorno XIL_TOOLS_ISE_DIR con este valor.

El archivo make generado asume que en dicho directorio se encuentra el shell script settings.sh que configura el entorno de trabajo de Xilinx. En caso de no existir, y de no ser posible copiar o enlazar dicho archivo, podemos definir el nombre del script con la variable de entorno XIL_TOOLS_SETTINGS.

3.2.1.2. Configuraciones de la placas soportadas

El programa asume que las mismas se encuentran en el directorio /usr/share/xiltools/boards. En el caso de no ser posible usar este directorio podemos especificar otro mediante dos mecanismos:

  • La opción de línea de comandos --data-dir=DIRECTORIO_DATOS

  • Definir la variable de entorno XIL_PROJECT_DATA con este valor.

3.2.2. Obteniendo ayuda sobre las placas soportadas

Es posible listar todas las placas soportadas usando la opción -L.

Si deseamos obtener más información sobre alguna de las placas en particular podemos usar la opción --show=PLACA. Esto abrirá un navegador y mostrará información sobre esa placa.

Atención

El script asume que el sistema cumple con los lineamientos de sistemas Debian GNU/Linux y que el comando x-www-browser corresponde al navegador.

3.2.3. Más de un proyecto en el mismo directorio

Normalmente xil_project.pl genera un archivo de make denominado Makefile. Cuando un mismo directorio alberga más de un proyecto de síntesis esto generaría un conflicto. En estos casos debe usarse la opción --no-standalone. Cuando se usa esta opción el archivo de make generado se denomina PROYECTO.mak, esto significa que luego deberemos usar make -f PROYECTO.mak.

3.2.4. Invocando xil_project desde un archivo make en otro directorio

Es posible agregar targets de síntesis a nuestro archivo de make principal. En este caso debemos tener en cuenta que es necesario cambiar el directorio de trabajo al del proyecto de síntesis. Para simplificar este proceso se recomienda usar la opción -C, la misma imita a la opción -C de make. En el Ejemplo 3-6 se ilustra como hacerlo para un proyecto denominado hello.

Ejemplo 3-6. Síntesis desde el makefile principal

         hello:
         	xil_project -C FPGA/hello make
         

3.2.5. Como eliminar los archivos generados

Para eliminar los archivos generados es posible utilizar el target clean incluido en el makefile generado, por ejemplo: make clean.

El problema con esto es que se asume que dicho archivo ya fue generado, en los casos en que no pueda asegurarse esta situación conviene usar: xil_project.pl clean. Esto primero generará los archivos necesarios y luego ejecutará el target clean. Esto implica que los mismos serán borrados, pero también implica que todos los otros archivos regenerables serán borrados.

3.2.6. Otras opciones

Copyright © 2006-2013 INTI - Ing. Salvador E. Tropea