Guía de inicio rápido para núcleos IP personalizados de Xillybus

Introducción

Esta página es una guía de inicio rápido para los núcleos IP personalizados (custom IP cores). Para obtener información más detallada sobre núcleos IP personalizados, consulta la Guide to defining a custom Xillybus IP core.

La forma correcta de empezar con Xillybus se explica en una página aparte. En concreto, el proyecto de arranque para la FPGA es un paquete de demostración (demo bundle), que se puede descargar desde la web de Xillybus.

En una fase posterior, puede que quieras modificar el núcleo IP. Por ejemplo, puede que quieras añadir varios flujos (streams) adecuados para tu aplicación. Este es el propósito de la IP Core Factory: es una aplicación web que te permite crear un núcleo IP personalizado según tus necesidades. El núcleo IP se configura con esta herramienta, y a continuación se descarga el paquete del núcleo IP como un archivo zip.

El significado de los parámetros de un núcleo IP se explica en detalle en la Guide to defining a custom Xillybus IP core.

Ten en cuenta que el mismo controlador para Linux o Microsoft Windows funciona con todos los núcleos IP personalizados. El controlador obtiene la información sobre el núcleo IP del propio núcleo IP durante la inicialización. Por lo tanto, no hace falta instalar nada nuevo en el ordenador después de la instalación inicial del controlador.

Ten en cuenta también que para usar el archivo zip de la IP Core Factory se necesita un paquete de demostración que sea compatible. Esta es una de las razones para empezar con el paquete de demostración, tal como se sugiere en una página aparte.

Integración del núcleo IP personalizado en el paquete de demostración

Después de descargar el núcleo IP personalizado de la IP Core Factory, hay que modificar el paquete de demostración para incluir este núcleo IP. Para ello solo hacen falta unos pocos pasos sencillos, que se indican a continuación.

Instrucciones similares se encuentran escritas en README.TXT, que forma parte del archivo zip de la IP Core Factory. Ese archivo README también contiene información útil adicional:

• El Core ID, que es un número de cinco dígitos. Este número es un identificador único del núcleo IP. Debes indicar el Core ID cuando solicites un presupuesto.
• Se enumeran los archivos de dispositivo (device files) del núcleo IP. También se muestran los detalles técnicos de cada archivo de dispositivo. Esta es la información exacta sobre las características reales del núcleo IP.

Para integrar el núcleo IP personalizado en el paquete de demostración, sigue estos pasos:

1. Reemplaza dos archivos del paquete de demostración por los archivos del paquete del núcleo IP: xillybus.v y xillybus_core.v (o xillybus_xl_core.v / xillybus_xxl_core.v).
2. Reemplaza también el propio núcleo IP. Este archivo está en el subdirectorio llamado core/ del paquete de demostración. El archivo a reemplazar tiene un nombre parecido a xillybus_core.ngc, xillybus_core.edf, xillybus_core.qxp o xillybus_core.vqm.
3. Edita xillydemo.v (o xillydemo.vhd) para integrar la aplicación deseada con este núcleo IP personalizado. Como orientación, busca en el directorio «instantiation templates» del paquete del núcleo IP. El archivo llamado template.v (o template.vhd) contiene la plantilla de instanciación (instantiation template) que debes seguir.

Ten en cuenta que en la plantilla de instanciación no hay FIFOs. Sin embargo, se recomienda usar FIFOs para la interacción con el núcleo IP de Xillybus, tal como se sugiere en la página sobre adquisición de datos (data acquisition).

Pautas generales

Esta es una lista de consejos generales que pueden ahorrarte tiempo al trabajar con núcleos IP personalizados:

• Lee la Guide to defining a custom Xillybus IP core.
• Usa la opción «Autoset internals» en la IP Core Factory. La posibilidad de desactivar esta opción está pensada para usuarios experimentados de Xillybus. De lo contrario, lo más probable es que las decisiones automáticas de la herramienta web sean mejores.
• No obstante, lee el archivo README para saber qué decisiones tomó la herramienta web.
• En particular, no hace falta que exista una relación entre el tamaño de cada búfer DMA y los datos que se pretenden transmitir. Si te sientes tentado a hacerlo, estas explicaciones sobre adquisición de datos pueden resultarte útiles.
• En la IP Core Factory, selecciona el valor «Use» (del menú desplegable) que mejor se ajuste a tu aplicación. Esto determina, entre otras cosas, si el archivo de dispositivo será un flujo síncrono (synchronous stream) o un flujo asíncrono (asynchronous stream). Estos términos se explican brevemente en una página aparte y con más detalle en la documentación.