Développement FPGA pour Intel® oneAPI
Boîtes à outils avec Visual Studio Code sur Linux*
Guide de l'utilisateur

Kits d'outils oneAPI de développement FPGA avec Visual Studio Code sous Linux

Développement FPGA pour les kits d'outils Intel® oneAPI avec Visual Studio Code sur Linux
Vous pouvez intégrer la boîte à outils Intel® oneAPI Base avec Visual Studio (VS) Code sur Linux* pour prendre en charge un environnement de développement logiciel transparent. Vous pouvez utiliser le code VS pour le développement FPGA de la même manière que vous le feriez pour le CPU ou le GPU. Le processus est le même pour définir les variables d'environnement oneAPI, lancer VS Code, créer un projet à partir deampfichier et l'édition de code.
NOTE

• Si vous êtes un utilisateur Windows*, suivez les instructions de Développement d'un projet Visual Studio Code* pour le développement SSH sur le sous-système Windows pour Linux* pour configurer votre système, puis suivez les instructions fournies dans ce document.
• Si vous travaillez avec le Commencer | Intel® DevCloud, se référer à Utilisation de VSCode | Intel® DevCloud qui décrit également comment utiliser VS Code sampl'extension de navigateur dans Intel® DevCloud, y compris le flux de travail FPGA.
• Pour configurer votre environnement système et les paramètres des kits d'outils Intel oneAPI, installez le Configurateur d'environnement et de lancement pour les kits d'outils Intel® oneAPI extension pour Visual Studio Code.

Le flux de développement FPGA implique les étapes suivantes :

1. Paramétrage des variables d'environnement.
2. Construire et exécuter l'image d'émulation à l'aide de la méthode de compilation rapide.
3. Génération et viewle rapport d'optimisation HTML statique.
4. Construire et exécuter une image matérielle FPGA réelle.

Pour plus d'informations sur ce workflow, reportez-vous au Flux FPGA section du Guide de programmation Intel® oneAPI.
Prérequis
Téléchargez et installez le logiciel suivant :

• Boîte à outils de base Intel® oneAPI
• Code Visual Studio sur Linux*

Définir les variables d'environnement et lancer le code Visual Studio
Effectuez ces étapes pour définir les variables d'environnement :

1. Ouvrez une session de terminal.
2. Localisez le script setvars.sh. L'emplacement dépend de votre installation oneAPI, et ce sera l'un des suivants :
   • Si vous avez installé en tant que root ou sudo, recherchez le script dans le répertoire racine de votre installation oneAPI, qui est généralement /opt/intel/oneapi.
   • Si vous n'avez pas installé en tant que sudo ou root, recherchez le script dans le répertoire ~/intel/oneapi/.
   • Si vous avez personnalisé le dossier d'installation, recherchez le script dans votre dossier d'installation personnalisé.
3. Exécutez le script setvars.sh à partir de la ligne de commande à l'aide de la commande suivante : source /setvars.sh
   Pour plus d'informations, reportez-vous à Définir des variables d'environnement pour le développement CLI.
4. Dans la même session de terminal, lancez VS Code en exécutant la commande suivante : code
   NOTE
   L'avantage de rechercher le script oneAPI setvars.sh avant de lancer VS Code est que toutes les sessions de terminal et les processus enfants de VS Code incluent la configuration de l'environnement de développement oneAPI.

Installez le oneAPI Sampl'extension de navigateur

Vous pouvez parcourir et télécharger desampfichiers dans Visual Studio Code en utilisant le Sampl'extension de navigateur. Effectuez ces étapes pour installer l'extension :

1. Dans le code VS, cliquez sur le logo Extensions dans la navigation de gauche.
2. Localisez l'extension intitulée Sample Navigateur pour Intel oneAPI Toolkits ou visitez https://marketplace.visualstudio.com/publishers/intel-corporation pour parcourir les extensions disponibles.
3. Cliquez sur Installer.
4. Une fois l'extension installée, cliquez sur l'icône oneAPI pour view une liste des s disponiblesampfichiers dans le volet de navigation de gauche.

Pour une démonstration rapide, reportez-vous à Explorer oneAPI Samples avec le Sample navigateur dans Visual Studio Code.

Construire et exécuter l'image d'émulation FPGA pour une compilation rapide

L'image d'émulation FPGA est une compilation rapide qui peut vous aider à obtenir un code fonctionnellement correct. Pour des informations détaillées, reportez-vous à Types de compilation FPGA dans le Guide de programmation Intel® oneAPI. Vous pouvez compiler un FPGA de baseampfichier à la cible de l'émulateur FPGA en procédant comme suit :
NOTE
Pas toutes les oneAPIamples projets utilisent CMake. Le fichier README.md file pour chaque sample spécifie comment construire le sample. Pour sampqui utilisent CMake, Intel® vous recommande de consulter le Extension d'outils CMakeComment pour Visual Studio Article de code géré par Microsoft*.

1. Dans la section FPGA > Tutoriels, survolez les Compile Flow sample et cliquez sur + pour créer un projet.Vous êtes invité à sélectionner un dossier pour enregistrer le projet.
2. Enregistrez le projet. Une nouvelle session VS Code est maintenant ouverte avec les Compile Flow sample.
3. Ouvrez un terminal dans VS Code.
4. Exécutez la commande cd pour accéder au répertoire de niveau supérieur du projet nouvellement créé.
5. Exécutez la commande suivante pour créer un répertoire nommé build : mkdir build
6. Exécutez la commande cd pour accéder au répertoire de construction nouvellement créé.
7. Exécutez la commande suivante pour créer le sample. La construction du projet files sont écrits dans le répertoire de construction. cmake ..
8. Exécutez la commande suivante pour sélectionner la cible de construction de l'émulation : make fpga_emu
   NOTE Reportez-vous aux codes FPGAample README file pour trouver la bonne cible.
   Vous devriez maintenant observer un exécutable nommé compile_flow.fpga_emu dans votre répertoire. Utilisez ceci file en tant qu'émulateur exécutable pour la conception.
9. Exécutez la commande suivante pour lancer l'exécutable de l'émulateur : ./compile_flow.fpga_emu

Développement FPGA pour Intel® oneAPI Toolkits avec Visual Studio Code sur Linux*

Générer et View le rapport d'optimisation FPGA

Le rapport d'optimisation FPGA peut fournir des détails de haut niveau sur les performances de votre application avant même que vous n'exécutiez une image matérielle FPGA réelle.
NOTE
Le rapport est généré par le compilateur Intel® oneAPI DPC++/C++ sous la forme de pages HTML que vous pouvez view dans un web navigateur. Pour plus d'informations sur l'utilisation du rapport d'optimisation FPGA pour obtenir les meilleures performances, reportez-vous au Review le rapport.html section du Guide d'optimisation FPGA pour les kits d'outils Intel® oneAPI.

1. Assurez-vous que vous vous trouvez dans le répertoire de construction de la session de terminal VS Code.
2. Exécutez la commande suivante pour générer le rapport : make report
3. Accédez au répertoire compile_flow_report.prj/reports et localisez le rapport d'optimisation que vous avez généré. cd compile_flow_report.prj/reports
4. Utilisez la commande suivante pour lancer le rapport dans le navigateur Mozilla Firefox* : firefox report.html

Construire et exécuter l'image matérielle FPGA

Dans cette étape, vous créez un exécutable destiné à s'exécuter sur un matériel FPGA réel. Cela peut prendre plusieurs heures. Faire référence à Configuration système requise pour le compilateur Intel® oneAPI DPC++/C++ pour la configuration recommandée du système de génération. Les autres mises en garde incluent les suivantes :

• Pour construire l'image matérielle FPGA, exécutez la commande make fpga, qui est la cible make non par défaut. Reportez-vous aux codes FPGAample README file pour les étapes détaillées.
• Pour créer un exécutable, vous devez installer le logiciel Intel® Quartus® Prime Pro Edition et les BSP séparément. Pour plus d'informations, reportez-vous au Flux de développement Intel® FPGA pour oneAPI webpage et Guide d'installation des kits d'outils Intel oneAPI pour connaître les étapes d'installation du logiciel.
• Pour exécuter l'exécutable, vous avez besoin d'un matériel FPGA sur votre système. Pour plus d'informations sur la configuration du système, reportez-vous à la section Installer le logiciel pour Flux de développement Intel® FPGA.

Références

• Explorer oneAPI Samples avec le Sample navigateur dans Visual Studio Code
• Explorez SYCL* via Intel® FPGA Code Samples
• Guide d'installation des kits d'outils Intel® oneAPI
• Premiers pas avec la distribution Intel® pour GDB* sur l'hôte du système d'exploitation Linux*
• Premiers pas avec le kit d'outils de base Intel® oneAPI pour Linux*
• Guide de programmation Intel® oneAPI
• Guide d'optimisation FPGA pour les kits d'outils Intel® oneAPI

Avis et avis de non-responsabilité
Les technologies Intel peuvent nécessiter une activation matérielle, logicielle ou de service activée.

Développement FPGA pour les kits d'outils Intel® oneAPI avec Visual Studio Code sur Linux
Aucun produit ou composant ne peut être absolument sûr.
Vos coûts et vos résultats peuvent varier.
©Intel Corporation. Intel, le logo Intel et les autres marques Intel sont des marques commerciales d'Intel Corporation ou de ses filiales. D'autres noms et marques peuvent être revendiqués comme la propriété d'autrui.
Informations sur le produit et les performances
Les performances varient en fonction de l'utilisation, de la configuration et d'autres facteurs. En savoir plus sur www.Intel.com/PerformanceIndex.
Avis de révision #20201201
Sauf indication contraire, le code exampLes chiers contenus dans ce document vous sont fournis sous une licence MIT, dont les termes sont les suivants :
Copyright 2022 Intel® Corporation
L'autorisation est par la présente accordée, gratuitement, à toute personne obtenant une copie de ce logiciel et de la documentation associée. files (le « Logiciel »), d'exploiter le Logiciel sans restriction, y compris, sans limitation, les droits d'utilisation, de copie, de modification, de fusion, de publication, de distribution, de sous-licence et/ou de vente de copies du Logiciel, et de permettre aux personnes à qui le Logiciel est fourni de le faire, sous réserve des conditions suivantes :
L'avis de droit d'auteur ci-dessus et cet avis d'autorisation doivent être inclus dans toutes les copies ou parties substantielles du logiciel.
LE LOGICIEL EST FOURNI « EN L'ÉTAT », SANS AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, Y COMPRIS, MAIS SANS S'Y LIMITER, LES GARANTIES DE QUALITÉ MARCHANDE, D'ADÉQUATION À UN USAGE PARTICULIER ET DE NON-CONTREFAÇON. EN AUCUN CAS, LES AUTEURS OU LES TITULAIRES DES DROITS D'AUTEUR NE SERONT RESPONSABLES DE TOUTE RÉCLAMATION, DE TOUT DOMMAGE OU AUTRE RESPONSABILITÉ, QUE CE SOIT DANS LE CADRE D'UNE ACTION CONTRACTUELLE, DÉLICTUELLE OU AUTRE, DÉCOULANT DE, OU EN RELATION AVEC LE LOGICIEL OU L'UTILISATION OU D'AUTRES OPÉRATIONS RELATIVES AU LOGICIEL.

Documents / Ressources

Intel FPGA Development oneAPI Toolkits avec Visual Studio Code sur Linux [pdf] Guide de l'utilisateur Kits d'outils de développement FPGA oneAPI avec Visual Studio Code sur Linux, Kits d'outils de développement oneAPI avec Visual Studio Code sur Linux, Kits d'outils oneAPI avec Visual Studio Code sur Linux, Visual Studio Code sur Linux, Studio Code sur Linux, Code sur Linux, Linux

Références

• Manuel d'utilisation