Developer Guide

Intel® oneAPI DPC++/C++ Compiler Handbook for FPGAs

ID 785441
Date 10/24/2024
Public
Document Table of Contents

Installing the Intel oneAPI FPGA Development Environment

The Intel® oneAPI FPGA development environment requires the following software:

  • Intel® oneAPI Base Toolkit
  • FPGA Support Package for the Intel® oneAPI DPC++/C++ Compiler
  • Quartus® Prime software, including Questa*-Intel® FPGA Edition

    Quartus® Prime software is optional. It is required for only simulation and generating hardware.

  • CMake (CMake 3.7.2 or new is required):
    • Linux users: Install the CMake package for your Linux distribution, if required.
    • Windows users: Install Visual Studio* 2022 to get CMake.
  • [Recommended, but not required]Visual Studio* Code

Install the software for your Intel® oneAPI FPGA development environment in the following order:

  1. [Windows* only] Install Microsoft* Visual Studio*. Ensure that you install one of the following workloads to install CMake and the necessary C++ compiler headers on your system:
    • Desktop development with C++
    • Linux development with C++
  2. [Windows* only] Ensure that Microsoft* Visual Studio* is not running before moving on to the next step.

    If Visual Studio* is running when you complete the next step, the Intel® oneAPI Base Toolkit installer cannot install the oneAPI plug-ins for Visual Studio.

  3. Install and configure the Intel® oneAPI Base Toolkit and the FPGA Support Package. For instructions, review the following publications: Ensure that you install the following Intel® oneAPI Base Toolkit components:
    • Intel® Distribution for GDB
    • Intel® oneAPI DPC++ Library
    • Intel® oneAPI Threading Building Blocks
    • Intel® oneAPI DPC++/C++ Compiler
    • Intel®VTune™ Profiler
  4. [Optional] Install and configure Visual Studio* Code as follows:
    1. Install Visual Studio* Code according to one of the following instructions:
    2. Install the Microsoft C/C++ for Visual Studio* Code extension for Visual Studio* Code.
    3. Install the Code Sample Browser for Intel® oneAPI Toolkits extension for Visual Studio* Code.

      For more information about using Visual Studio* Code for developing your FPGA kernels, refer to FPGA Development for Intel oneAPI Toolkits with Visual Studio* Code.

  5. Set the required environment variables required for compiling, emulating, and generating the FPGA optimization report with a setvars or oneapi-vars script. For instructions on running these scripts, refer to the following topics in the Intel® oneAPI Programming Guide:
  6. [Optional] For simulating your kernel or generating hardware for your device, install and configure your Quartus® Prime software development environment:
    1. Install the version (or versions) of Quartus® Prime software for the device family or families that you want to target:
      Quartus® Prime Edition Required
      Target Device Family Quartus® Prime Edition
      • Agilex™ 5
      • Agilex™ 7
      • Stratix® 10
      • Arria® 10
      • Cyclone® 10 GX
      • Quartus® Prime Pro Edition Versions 22.1-24.1
      • Cyclone® V
      • Quartus® Prime Standard Edition Version 22.1std or 23.1std
      • Quartus® Prime Lite Edition Version 22.1std or 23.1std

      Install and license your copy of Quartus® Prime software according to the instructions in Intel® FPGA Software Installation and Licensing.

      For more information about installing and configuring Questa*-Intel® FPGA Edition separately from Quartus® Prime software, refer to Questa*-Intel® FPGA Edition Quick-Start Quartus® Prime Pro Edition.

    2. Set or update the Quartus® Prime environment variables by following the instructions in Setting Quartus® Prime Environment Variables in Intel® FPGA Software Installation and Licensing.