Introduction
Cette page est un guide de démarrage rapide pour les cœurs IP personnalisés (custom IP cores). Vous trouverez des informations plus détaillées à leur sujet dans le Guide pour définir un cœur IP Xillybus personnalisé.
La bonne façon de démarrer avec Xillybus est expliquée sur une autre page. En particulier, le projet de démarrage pour le FPGA est un pack de démonstration (demo bundle), téléchargeable depuis le site web de Xillybus.
À un stade ultérieur, vous souhaiterez peut-être modifier le cœur IP (IP core). Par exemple, vous voudrez peut-être ajouter plusieurs flux adaptés à votre application. C’est précisément le rôle de l’IP Core Factory : il s’agit d’une application web qui vous permet de créer un cœur IP personnalisé (custom IP core) selon vos besoins. Le cœur IP est configuré à l’aide de cet outil, puis le pack de cœurs IP (IP core bundle) est téléchargé sous la forme d’un fichier zip.
La signification des paramètres d’un cœur IP est expliquée en détail dans le Guide pour définir un cœur IP Xillybus personnalisé.
Notez que le même pilote pour Linux ou Microsoft Windows fonctionne avec tous les cœurs IP personnalisés. Le pilote obtient les informations concernant le cœur IP directement de celui-ci, lors de l’initialisation. Il n’est donc pas nécessaire d’installer quoi que ce soit de nouveau sur l’ordinateur après l’installation initiale du pilote.
Il faut également noter qu’un pack de démonstration correspondant est nécessaire pour utiliser le fichier zip provenant de l’IP Core Factory. C’est l’une des raisons pour lesquelles il est recommandé de commencer par le pack de démonstration, comme suggéré sur une autre page.
Intégration du cœur IP personnalisé dans le pack de démonstration
Après avoir téléchargé le cœur IP personnalisé depuis l’IP Core Factory, il faut modifier le pack de démonstration pour y inclure ce cœur IP. Cela demande quelques étapes simples, détaillées ci-dessous.
Des instructions similaires figurent dans README.TXT, qui fait partie du fichier zip de l’IP Core Factory. Ce fichier README contient également d’autres informations utiles :
- Le Core ID, un nombre à cinq chiffres. Ce nombre est un identifiant unique pour le cœur IP. Le Core ID doit être mentionné lors de la demande de devis.
- Les fichiers de périphérique du cœur IP sont listés. Les détails techniques de chaque fichier de périphérique sont également indiqués. Ces informations décrivent avec précision les caractéristiques réelles du cœur IP.
Pour intégrer le cœur IP personnalisé au pack de démonstration, suivez ces étapes :
- Remplacez deux fichiers du pack de démonstration par les fichiers du pack de cœurs IP : xillybus.v et xillybus_core.v (ou xillybus_xl_core.v / xillybus_xxl_core.v).
- Remplacez ensuite le cœur IP lui-même. Ce fichier se trouve dans le sous-répertoire core/ du pack de démonstration. Le fichier à remplacer s’appelle par exemple xillybus_core.ngc, xillybus_core.edf, xillybus_core.qxp ou xillybus_core.vqm.
- Modifiez xillydemo.v (ou xillydemo.vhd) afin d’intégrer l’application souhaitée à ce cœur IP personnalisé. Pour vous guider, consultez le répertoire « instantiation templates » (modèles d’instanciation) du pack de cœurs IP. Le fichier template.v (ou template.vhd) contient le modèle d’instanciation (instantiation template) à suivre.
Notez que le modèle d’instanciation ne contient aucune FIFO. Il est néanmoins recommandé d’utiliser des FIFO pour l’interaction avec le cœur IP de Xillybus, comme le suggère la page consacrée à l’acquisition de données (data acquisition).
Recommandations générales
Voici une liste de conseils généraux qui peuvent faire gagner du temps lorsque vous travaillez avec des cœurs IP personnalisés :
- Lisez le Guide pour définir un cœur IP Xillybus personnalisé.
- Utilisez l’option « Autoset internals » dans l’IP Core Factory. La possibilité de désactiver cette option est destinée aux utilisateurs expérimentés de Xillybus. Dans le cas contraire, il y a de fortes chances que les décisions automatiques de l’outil web soient meilleures.
- Lisez néanmoins le fichier README afin de savoir quelles décisions l’outil web a prises.
- En particulier, il n’est pas nécessaire qu’il y ait un rapport entre la taille de chaque mémoire tampon DMA (DMA buffer) et les données destinées à la transmission. Si vous êtes tenté de faire ce lien, ces explications sur l’acquisition de données pourront vous aider.
- Dans l’IP Core Factory, choisissez l’option « Use » (dans le menu déroulant) qui correspond le mieux à votre application. Cela détermine, entre autres, si le fichier de périphérique sera un flux synchrone ou asynchrone. Ces termes sont expliqués brièvement sur une autre page, et plus en détail dans la documentation.