Build and Run a Sample Project Using the
- Locate a sample project using the oneAPI CLI Samples Browser.
- Build and run a sample project usingMicrosoft Build*.
Download Samples using the oneAPI CLI Samples Browser
- Create a folder where you want to store your sample. For example,C:\samples\vector-add
- Open acommandwindow.
- Setsystem variables byrunningsetvars:The command above assumes you installed to the default folder. If you customized the installation folder,"C:\Program Files (x86)\Intel\oneAPI\setvars.bat"For Windows PowerShell* users, execute this command:cmd.exe "/K" '"C:\Program Files (x86)\Intel\oneAPI\setvars.bat" && powershell'setvars.batis in your custom folder.Thesetvars.batscript can be managed using a configuration file, which is especially helpful if you need to initialize specific versions of libraries or the compiler, rather than defaulting to the "latest" version. For more details, see Using a Configuration File to Manage Setvars.bat.SeeoneAPI Development Environment Setup for more configuration options.
- In the samecommandwindow, run the application :The oneAPI CLI menu appears:oneapi-cli.exe
- Use the up and down arrow keys to selectCreate a project, then pressEnter
- Move the arrow key down to selectCreate a project, then pressEnter. The language selection will appear. If you want to run samples from a toolkit other than theIntel® oneAPI Base Toolkit, install the domain-specific toolkit before proceeding.
- Select the language for your sample. For your first project, selectcpp, then pressEnter. The toolkit samples list appears.
- Select theVector Addsample. Vector Add is a simple test application that will help verify that the tools are setup correctly and can access your system's GPU:
- After you select a sample, pressEnter.
- Specify the location for the project. The default location includes the path from where the utility was run and the name of the project.
- PressTabto select Create, then pressEnter:
Build and Run a CPU or GPU Sample Using Microsoft Build*
- Using the same command prompt window where you ransetvars.bat, navigate to the folder where you downloaded the sample (where the .sln file is located).
- Build the program:MSBuild vector-add.sln /t:Rebuild /p:Configuration="Release"
- Navigate to the Release folder (example:x64/Release)
- Run the program:vector-add-buffers.exe
Compile and run a sample for FPGA
- Emulation:Verifies the code correctness. Compilation completes in few seconds. Use this mode if you are using theIntel® oneAPI Base Toolkit
- Report:Generates a static optimization report for design analysis. Compilation can take a few minutes to complete. When completed, you can find the reports in<project_name>.prj\reports\report.html. This can be used with theIntel® oneAPI Base Toolkit. For more information about the reports, refer to the FPGA Optimization Guide for Intel® oneAPI Toolkits.
- Hardware:Generates the actual bitstream on an FPGA device. Compilation can take few hours to complete. Use this mode to measure performance. To use this mode, download the Intel® Quartus® Prime Pro Edition software and third-party vendor-provided BSPs separately. For more information, refer to the Intel® FPGA Add-On for oneAPI Base Toolkit web page.
- Using the same command prompt window where you ransetvars.bat, navigate to the folder where you downloaded the sample (where the .sln file is located).cd <vector-add directory on the same system>
- View theREADME.mdfile in the sample folder for instructions on how to build and run the sample.