FPGA-utvikling for Intel® oneAPI
Verktøysett med Visual Studio Code på Linux*
Brukerveiledning

FPGA Development oneAPI Toolkits med Visual Studio Code på Linux

FPGA-utvikling for Intel® oneAPI Toolkits med Visual Studio Code på Linux
Du kan integrere Intel® oneAPI Base-verktøysettet med Visual Studio (VS) Code på Linux* for å støtte et sømløst programvareutviklingsmiljø. Du kan bruke VS-kode for FPGA-utvikling på samme måte som du ville brukt for CPU eller GPU. Prosessen er den samme for å sette oneAPI-miljøvariablene, starte VS-kode, lage et prosjekt fra asample, og koderedigering.
NOTE

• Hvis du er en Windows*-bruker, utfør instruksjonene i Utvikle et Visual Studio Code*-prosjekt for SSH-utvikling på Windows-undersystem for Linux* for å sette opp systemet ditt, og følg deretter instruksjonene i dette dokumentet.
• Hvis du jobber med Kom i gang | Intel® DevCloud, referer til Bruke VSCode | Intel® DevCloud som også beskriver hvordan du bruker VS Code sample nettleserutvidelsen i Intel® DevCloud inkludert FPGA-arbeidsflyten.
• For å konfigurere systemmiljøet og innstillingene for Intel oneAPI-verktøysett, installer Environment and Launch Configurator for Intel® oneAPI Toolkits utvidelse for Visual Studio Code.

FPGA-utviklingsflyt involverer følgende trinn:

1. Sette opp miljøvariablene.
2. Bygge og kjøre emuleringsbildet ved å bruke den raske kompileringsmetoden.
3. Genererer og viewden statiske HTML-optimaliseringsrapporten.
4. Bygge og kjøre et faktisk FPGA-maskinvarebilde.

For mer informasjon om denne arbeidsflyten, se FPGA Flow delen i Intel ® oneAPI-programmeringsveiledningen.
Forutsetninger
Last ned og installer følgende programvare:

• Intel® oneAPI Base Toolkit
• Visual Studio Code på Linux*

Still inn miljøvariablene og start Visual Studio Code
Utfør disse trinnene for å angi miljøvariablene:

1. Åpne en terminaløkt.
2. Finn setvars.sh-skriptet. Plasseringen avhenger av oneAPI-installasjonen din, og den vil være en av følgende:
   • Hvis du installerte som root eller sudo, så finn skriptet i rotkatalogen til oneAPI-installasjonen, som vanligvis er /opt/intel/oneapi.
   • Hvis du ikke installerte som sudo eller root, så finn skriptet i ~/intel/oneapi/-katalogen.
   • Hvis du tilpasset installasjonsmappen, finner du skriptet i din egendefinerte installasjonsmappe.
3. Kjør setvars.sh-skriptet fra kommandolinjen ved å bruke følgende kommando: source /setvars.sh
   For mer informasjon, se Angi miljøvariabler for CLI-utvikling.
4. I samme terminaløkt starter du VS Code ved å kjøre følgende kommando: code
   NOTE
   Fordelen med å skaffe oneAPI setvars.sh-skriptet før VS Code lanseres, er at alle terminalsesjoner og underordnede prosesser til VS Code inkluderer oppsettet for oneAPI-utviklingsmiljøet.

Installer oneAPI Sample nettleserutvidelse

Du kan bla gjennom og laste ned samples i Visual Studio Code ved å bruke Sample nettleserutvidelse. Utfør disse trinnene for å installere utvidelsen:

1. I VS-koden klikker du på Extensions-logoen i venstre navigering.
2. Finn utvidelsen med tittelen Sample Nettleser for Intel oneAPI Toolkits eller besøk https://marketplace.visualstudio.com/publishers/intel-corporation for å bla gjennom tilgjengelige utvidelser.
3. Klikk Installer.
4. Etter at utvidelsen er installert, klikker du på oneAPI-ikonet for å view en liste over tilgjengelige samples i venstre navigasjonsrute.

For en rask demonstrasjon, se Utforsker oneAPI Samples med Sampnettleseren i Visual Studio Code.

Bygg og kjør FPGA-emuleringsbildet for rask kompilering

FPGA-emuleringsbildet er en hurtiggående kompilering som kan hjelpe deg med å oppnå funksjonelt korrekt kode. For detaljert informasjon, se Typer FPGA-kompilering i Intel ® oneAPI-programmeringsveiledningen. Du kan kompilere en grunnleggende FPGA-erample til FPGA-emulatormålet ved å utføre følgende:
NOTE
Ikke alle oneAPI-erampLe prosjekter bruker CMake. README.md file for hver sample spesifiserer hvordan man bygger sample. For samples som bruker CMake, anbefaler Intel® at du refererer til CMake Tools Extension for Visual Studio Kodeartikkel som vedlikeholdes av Microsoft*.

1. Under delen FPGA > Veiledninger holder du musepekeren over Compile Flow-eneample og klikk på + for å opprette et prosjekt.Du blir oppgradert til å velge en mappe for å lagre prosjektet.
2. Lagre prosjektet. En ny VS-kodeøkt er nå åpen med Compile Flow-eneample.
3. Åpne en terminal i VS-kode.
4. Kjør cd-kommandoen for å flytte til toppnivåkatalogen til det nyopprettede prosjektet.
5. Kjør følgende kommando for å lage en katalog som heter build: mkdir build
6. Kjør cd-kommandoen for å flytte til den nyopprettede byggekatalogen.
7. Kjør følgende kommando for å bygge sample. Prosjektbygget files skrives inn i byggekatalogen. cmmake..
8. Kjør følgende kommando for å velge emuleringsmålet: make fpga_emu
   NOTE Se FPGA-kodeneample README file for å finne det rette målet.
   Du bør nå se en kjørbar fil kalt compile_flow.fpga_emu i katalogen din. Bruk denne file som kjørbar emulator for designet.
9. Kjør følgende kommando for å kjøre emulatorens kjørbare: ./compile_flow.fpga_emu

FPGA-utvikling for Intel® oneAPI Toolkits med Visual Studio Code på Linux*

Generer og View FPGA-optimaliseringsrapporten

FPGA-optimaliseringsrapporten kan gi detaljer på høyt nivå om applikasjonsytelsen din selv før du kjører et faktisk FPGA-maskinvarebilde.
NOTE
Rapporten er generert av Intel® oneAPI DPC++/C++-kompilatoren i form av HTML-sider som du kan view i en web nettleser. For mer informasjon om bruk av FPGA-optimaliseringsrapporten for å oppnå best ytelse, se Review rapporten.html delen i FPGA Optimization Guide for Intel® oneAPI Toolkits.

1. Sørg for at du er i byggekatalogen i VS Code-terminaløkten.
2. Kjør følgende kommando for å generere rapporten: lag rapport
3. Flytt til compile_flow_report.prj/reports-katalogen og finn optimaliseringsrapporten du genererte. cd compile_flow_report.prj/reports
4. Bruk følgende kommando for å starte rapporten i Mozilla Firefox*-nettleseren: firefox report.html

Bygg og kjør FPGA-maskinvarebildet

I dette trinnet bygger du en kjørbar fil som skal kjøres på en faktisk FPGA-maskinvare. Det kan ta flere timer å fullføre. Referere til Intel ® oneAPI DPC++/C++ kompilatorsystemkrav for den anbefalte byggesystemkonfigurasjonen. Andre forbehold inkluderer følgende:

• For å bygge FPGA-maskinvarebildet, utfør make fpga-kommandoen, som er ikke-standard make-målet. Se FPGA-kodeneample README file for detaljerte trinn.
• For å bygge en kjørbar fil må du installere Intel® Quartus® Prime Pro Edition-programvaren og BSP-er separat. For mer informasjon, se Intel ® FPGA-utviklingsflyt for oneAPI webside og Installasjonsveiledning for Intel oneAPI Toolkits for trinn for å installere programvaren.
• For å kjøre den kjørbare filen trenger du en FPGA-maskinvare på systemet ditt. For mer informasjon om hvordan du setter opp systemet, se Installer programvare for Intel® FPGA-utviklingsflyt.

Referanser

• Utforsker oneAPI Samples med Sampnettleseren i Visual Studio Code
• Utforsk SYCL* gjennom Intel® FPGA Code Samples
• Installasjonsveiledning for Intel® oneAPI Toolkits
• Kom i gang med Intel® Distribution for GDB* på Linux* OS Host
• Kom i gang med Intel® oneAPI Base Toolkit for Linux*
• Intel® oneAPI-programmeringsveiledning
• FPGA Optimization Guide for Intel® oneAPI Toolkits

Merknader og ansvarsfraskrivelser
Intel-teknologier kan kreve aktivert maskinvare-, programvare- eller tjenesteaktivering.

FPGA-utvikling for Intel® oneAPI Toolkits med Visual Studio Code på Linux
Ingen produkter eller komponenter kan være helt sikre.
Kostnadene og resultatene dine kan variere.
© Intel Corporation. Intel, Intel-logoen og andre Intel-merker er varemerker for Intel Corporation eller dets datterselskaper. Andre navn og merker kan gjøres krav på som andres eiendom.
Produkt- og ytelsesinformasjon
Ytelsen varierer etter bruk, konfigurasjon og andre faktorer. Lær mer på www.Intel.com/PerformanceIndex.
Varsel revisjon #20201201
Med mindre annet er oppgitt, er koden eksamplesene i dette dokumentet er gitt til deg under en MIT-lisens, hvis vilkår er som følger:
Copyright 2022 Intel® Corporation
Tillatelse gis herved, gratis, til enhver person som skaffer seg en kopi av denne programvaren og tilhørende dokumentasjon files ("Programvaren"), for å handle med Programvaren uten begrensning, inkludert uten begrensning rettighetene til å bruke, kopiere, modifisere, slå sammen, publisere, distribuere, underlisensiere og/eller selge kopier av Programvaren, og tillate personer å hvem programvaren er levert til å gjøre det, underlagt følgende betingelser:
Merknaden om opphavsrett ovenfor og denne tillatelseserklæringen skal inkluderes i alle kopier eller vesentlige deler av programvaren.
PROGRAMVAREN LEVERES "SOM DEN ER", UTEN GARANTI AV NOEN SLAG, UTTRYKKELIGE ELLER UNDERFORSTÅTT, INKLUDERT, MEN IKKE BEGRENSET TIL GARANTIER FOR SALGBARHET, EGNETHET FOR ET BESTEMT FORMÅL OG IKKE-KRENKELSE. UNDER INGEN OMSTENDIGHET SKAL FORFATTERNE ELLER OPPHAVSRETTIGHETER VÆRE ANSVARLIG FOR NOEN KRAV, SKADER ELLER ANNET ANSVAR, ENTEN I EN KONTRAKTSHANDLING, TORT ELLER ANNET, SOM STÅR AV, UT AV ELLER I FORBINDELSE MED DEN ANDRE PROGRAMVAREN. PROGRAMVARE.

Dokumenter / Ressurser

intel FPGA Development oneAPI Toolkits med Visual Studio Code på Linux [pdfBrukerhåndbok FPGA Development oneAPI Toolkits med Visual Studio Code på Linux, Development oneAPI Toolkits med Visual Studio Code på Linux, oneAPI Toolkits med Visual Studio Code på Linux, Visual Studio Code på Linux, Studio Code på Linux, Code på Linux, Linux

Referanser

• Brukerhåndbok