Sviluppo FPGA per Intel® oneAPI
Toolkit con Visual Studio Code su Linux*
Guida per l'utente

Sviluppo FPGA oneAPI Toolkit con Visual Studio Code su Linux

Sviluppo FPGA per toolkit Intel® oneAPI con Visual Studio Code su Linux
È possibile integrare il toolkit Intel® oneAPI Base con Visual Studio (VS) Code su Linux* per supportare un ambiente di sviluppo software senza soluzione di continuità. Puoi utilizzare il codice VS per lo sviluppo FPGA nello stesso modo in cui lo utilizzeresti per CPU o GPU. Il processo è lo stesso per l'impostazione delle variabili di ambiente oneAPI, l'avvio di VS Code, la creazione di un progetto da asample e la modifica del codice.
NOTA

• Se sei un utente Windows*, esegui le istruzioni in Sviluppo di un progetto Visual Studio Code* per lo sviluppo SSH su sottosistema Windows per Linux* per configurare il sistema, quindi seguire le istruzioni fornite in questo documento.
• Se stai lavorando con il Inizia | Intel® DevCloud, fare riferimento a Utilizzo di VSCode | Intel® DevCloud che descrive anche come utilizzare VS Code sample estensione del browser in Intel® DevCloud incluso il flusso di lavoro FPGA.
• Per configurare l'ambiente di sistema e le impostazioni per i toolkit Intel oneAPI, installare il file Configuratore di ambiente e avvio per i toolkit Intel® oneAPI estensione per il codice di Visual Studio.

Il flusso di sviluppo FPGA prevede i seguenti passaggi:

1. Impostazione delle variabili d'ambiente.
2. Creazione ed esecuzione dell'immagine di emulazione utilizzando il metodo di compilazione rapida.
3. Generazione e viewing il rapporto di ottimizzazione HTML statico.
4. Creazione ed esecuzione di un'immagine hardware FPGA effettiva.

Per ulteriori informazioni su questo flusso di lavoro, fare riferimento a Flusso FPGA sezione nella Guida alla programmazione Intel ® oneAPI.
Prerequisiti
Scaricare e installare il seguente software:

• Toolkit di base Intel® oneAPI
• Codice di Visual Studio su Linux*

Imposta le variabili d'ambiente e avvia il codice di Visual Studio
Eseguire questi passaggi per impostare le variabili di ambiente:

1. Aprire una sessione terminale.
2. Individua lo script setvars.sh. La posizione dipende dall'installazione di oneAPI e sarà una delle seguenti:
   • Se hai installato come root o sudo, trova lo script nella directory root dell'installazione di oneAPI, che in genere è /opt/intel/oneapi.
   • Se non hai installato come sudo o root, trova lo script nella directory ~/intel/oneapi/.
   • Se hai personalizzato la cartella di installazione, trova lo script nella cartella di installazione personalizzata.
3. Eseguire lo script setvars.sh dalla riga di comando utilizzando il seguente comando: source /setvars.sh
   Per ulteriori informazioni, fare riferimento a Impostare le variabili d'ambiente per lo sviluppo della CLI.
4. Nella stessa sessione del terminale, avvia VS Code eseguendo il seguente comando: code
   NOTA
   Il vantaggio dell'approvvigionamento dello script oneAPI setvars.sh prima di avviare VS Code è che tutte le sessioni terminali e i processi figlio di VS Code includono la configurazione dell'ambiente di sviluppo oneAPI.

Installa oneAPI Sampl'estensione del browser

Puoi sfogliare e scaricare sample in Visual Studio Code utilizzando Sample Estensione del browser. Eseguire questi passaggi per installare l'estensione:

1. In VS Code, fai clic sul logo delle estensioni nella barra di navigazione a sinistra.
2. Individua l'estensione intitolata Sample Browser per Intel oneAPI Toolkit o visitare https://marketplace.visualstudio.com/publishers/intel-corporation per sfogliare le estensioni disponibili.
3. Fare clic su Installa.
4. Dopo l'installazione dell'estensione, fai clic sull'icona oneAPI per view un elenco di s disponibiliample nel riquadro di navigazione a sinistra.

Per una rapida dimostrazione, fare riferimento a Esplorare una API Samples con la Sample Browser nel codice di Visual Studio.

Crea ed esegui l'immagine di emulazione FPGA per una compilazione rapida

L'immagine di emulazione FPGA è una compilazione ad esecuzione rapida che può aiutarti a ottenere codice funzionalmente corretto. Per informazioni dettagliate, fare riferimento a Tipi di compilazione FPGA nella Guida alla programmazione Intel ® oneAPI. È possibile compilare un FPGA di baseample alla destinazione dell'emulatore FPGA eseguendo quanto segue:
NOTA
Non tutte le oneAPIampi progetti usano CMake. Il file README.md file per ogni sample specifica come costruire la sample. Per sample che utilizzano CMake, Intel® consiglia di fare riferimento a Estensione degli strumenti CMake per Visual Studio Articolo di codice gestito da Microsoft*.

1. Nella sezione FPGA > Tutorial, passa il mouse sopra Compile Flow sample e fare clic su + per creare un progetto.Ti viene chiesto di selezionare una cartella per salvare il progetto.
2. Salva il progetto. È ora aperta una nuova sessione VS Code con Compile Flow samplui.
3. Apri un terminale in VS Code.
4. Eseguire il comando cd per spostarsi nella directory di primo livello del progetto appena creato.
5. Eseguire il seguente comando per creare una directory denominata build: mkdir build
6. Esegui il comando cd per spostarti nella directory di build appena creata.
7. Eseguire il comando seguente per creare il file sample. Il progetto costruisce files sono scritti nella directory build. cmq..
8. Eseguire il comando seguente per selezionare la destinazione della build dell'emulazione: make fpga_emu
   NOTA Fare riferimento ai codici FPGAample LEGGIMI file per trovare il giusto target di marca.
   Ora dovresti osservare un eseguibile chiamato compile_flow.fpga_emu nella tua directory. Usa questo file come eseguibile dell'emulatore per il progetto.
9. Eseguire il comando seguente per eseguire l'eseguibile dell'emulatore: ./compile_flow.fpga_emu

Sviluppo FPGA per toolkit Intel® oneAPI con Visual Studio Code su Linux*

Genera e View il rapporto di ottimizzazione FPGA

Il report di ottimizzazione FPGA può fornire dettagli di alto livello sulle prestazioni dell'applicazione anche prima di eseguire un'immagine hardware FPGA effettiva.
NOTA
Il report viene generato dal compilatore Intel® oneAPI DPC++/C++ sotto forma di pagine HTML che è possibile view in un web navigatore. Per ulteriori informazioni sull'utilizzo del report di ottimizzazione FPGA per ottenere le migliori prestazioni, fare riferimento a Review il report.html nella sezione FPGA Optimization Guide for Intel® oneAPI Toolkits.

1. Assicurati di essere nella directory di compilazione nella sessione del terminale VS Code.
2. Eseguire il seguente comando per generare il report: make report
3. Spostati nella directory compile_flow_report.prj/reports e individua il report di ottimizzazione che hai generato. cd compile_flow_report.prj/reports
4. Utilizzare il seguente comando per avviare il report nel browser Mozilla Firefox*: firefox report.html

Crea ed esegui l'immagine hardware FPGA

In questo passaggio, crei un eseguibile destinato a essere eseguito su un vero hardware FPGA. Potrebbero essere necessarie diverse ore per il completamento. Fare riferimento a Requisiti di sistema del compilatore Intel ® oneAPI DPC++/C++ per la configurazione del sistema di compilazione consigliata. Altri avvertimenti includono quanto segue:

• Per costruire l'immagine hardware FPGA, esegui il comando make fpga, che è il make target non predefinito. Fare riferimento ai codici FPGAample LEGGIMI file per i passaggi dettagliati.
• Per creare un eseguibile, è necessario installare separatamente il software Intel® Quartus® Prime Pro Edition e i BSP. Per ulteriori informazioni, consultare il Flusso di sviluppo Intel ® FPGA per oneAPI webpagina e Guida all'installazione per i toolkit Intel oneAPI per la procedura di installazione del software.
• Per eseguire l'eseguibile, è necessario un hardware FPGA sul sistema. Per ulteriori informazioni su come configurare il sistema, fare riferimento a Installazione del software per Flusso di sviluppo Intel® FPGA.

Riferimenti

• Esplorare una API Samples con la Sample Browser nel codice di Visual Studio
• Esplora SYCL* tramite Intel® FPGA Code Samples
• Guida all'installazione per i toolkit Intel® oneAPI
• Inizia con la distribuzione Intel® per GDB* su host del sistema operativo Linux*
• Inizia con Intel® oneAPI Base Toolkit per Linux*
• Guida alla programmazione Intel® oneAPI
• Guida all'ottimizzazione FPGA per i toolkit Intel® oneAPI

Avvisi e dichiarazioni di non responsabilità
Le tecnologie Intel potrebbero richiedere l'attivazione di hardware, software o servizi abilitati.

Sviluppo FPGA per toolkit Intel® oneAPI con Visual Studio Code su Linux
Nessun prodotto o componente può essere assolutamente sicuro.
I tuoi costi e risultati possono variare.
© Intel Corporation. Intel, il logo Intel e altri marchi Intel sono marchi di Intel Corporation o delle sue consociate. Altri nomi e marchi possono essere rivendicati come proprietà di altri.
Informazioni sul prodotto e sulle prestazioni
Le prestazioni variano in base all'uso, alla configurazione e ad altri fattori. Ulteriori informazioni su www.Intel.com/PerformanceIndex.
Avviso revisione n. 20201201
Salvo diversa indicazione, il codice exampi le in questo documento sono forniti con una licenza MIT, i cui termini sono i seguenti:
Copyright 2022 Intel® Corporation
Con la presente si concede l'autorizzazione, gratuita, a chiunque ottenga una copia di questo software e della documentazione associata files (il "Software"), di trattare il Software senza restrizioni, inclusi, senza limitazioni, i diritti di utilizzare, copiare, modificare, unire, pubblicare, distribuire, concedere in sublicenza e/o vendere copie del Software, e di consentire alle persone a cui il Software è fornito di fare lo stesso, a condizione delle seguenti condizioni:
La suddetta nota di copyright e la presente nota di autorizzazione dovranno essere incluse in tutte le copie o parti sostanziali del Software.
IL SOFTWARE VIENE FORNITO "COSÌ COM'È", SENZA GARANZIA DI ALCUN TIPO, ESPRESSA O IMPLICITA, COMPRESE, SENZA LIMITAZIONI, LE GARANZIE DI COMMERCIABILITÀ, IDONEITÀ PER UNO SCOPO PARTICOLARE E NON VIOLAZIONE. IN NESSUN CASO GLI AUTORI O I TITOLARI DEL COPYRIGHT SARANNO RESPONSABILI PER QUALSIASI RECLAMO, DANNO O ALTRA RESPONSABILITÀ, SIA IN UN'AZIONE DI CONTRATTO, ILLECITO CIVILE O ALTRO, DERIVANTE DA, DA O IN RELAZIONE CON IL SOFTWARE O L'USO O ALTRE OPERAZIONI NEL SOFTWARE.

Documenti / Risorse

intel FPGA Sviluppo oneAPI Toolkit con Visual Studio Code su Linux [pdf] Guida utente Sviluppo FPGA di oneAPI Toolkit con Visual Studio Code su Linux, sviluppo di oneAPI Toolkit con Visual Studio Code su Linux, oneAPI Toolkit con Visual Studio Code su Linux, Visual Studio Code su Linux, Studio Code su Linux, Code su Linux, Linux

Riferimenti

• Manuale d'uso