From 4ae29ae3f97ff19acd59d03b6bbf525654330752 Mon Sep 17 00:00:00 2001 From: Tiziano De Matteis Date: Thu, 27 Jul 2023 15:29:22 +0200 Subject: [PATCH 1/3] Docs: mention FPGA backend tested with Intel Quartus PRO --- doc/setup/installation.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/setup/installation.rst b/doc/setup/installation.rst index 6eb266dc7c..0bdfcc5a6b 100644 --- a/doc/setup/installation.rst +++ b/doc/setup/installation.rst @@ -21,7 +21,8 @@ however, it requires two more runtime dependencies to be installed and available **GPU**: For NVIDIA GPUs, the CUDA toolkit is also required, and AMD GPUs require HIP. :ref:`See more information on how to configure DaCe to use AMD GPUs `. You may (optionally) want to install `CuPy `_ for easy integration of GPU arrays in Python. -**FPGA**: Xilinx FPGAs require the Vitis suite and Intel FPGAs require the Intel FPGA SDK to be installed. +**FPGA**: Xilinx FPGAs require the Vitis suite and Intel FPGAs require the Intel FPGA SDK to be installed. +Note that DaCe has been tested with Intel FPGA SDK for OpenCL *Pro* edition (v19.1). It may partially support the *standard* edition of the SDK. **Distributed Computing**: If using multiple nodes, MPI has to be installed and available. From 1d7c744536e81232cb93b88a143ad7357f0c0bb1 Mon Sep 17 00:00:00 2001 From: Tiziano De Matteis Date: Wed, 2 Aug 2023 10:18:00 +0200 Subject: [PATCH 2/3] Improve troubleshooting for Intel FPGA --- dace/external/hlslib | 2 +- doc/setup/installation.rst | 9 ++++++++- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/dace/external/hlslib b/dace/external/hlslib index 1b5b3aee5d..1403cd016c 160000 --- a/dace/external/hlslib +++ b/dace/external/hlslib @@ -1 +1 @@ -Subproject commit 1b5b3aee5dab19adcc443fa9a7cd45244bd246b1 +Subproject commit 1403cd016ce63a9961eeb3899bea70c873a929ce diff --git a/doc/setup/installation.rst b/doc/setup/installation.rst index 0bdfcc5a6b..893f4a1688 100644 --- a/doc/setup/installation.rst +++ b/doc/setup/installation.rst @@ -22,7 +22,8 @@ however, it requires two more runtime dependencies to be installed and available You may (optionally) want to install `CuPy `_ for easy integration of GPU arrays in Python. **FPGA**: Xilinx FPGAs require the Vitis suite and Intel FPGAs require the Intel FPGA SDK to be installed. -Note that DaCe has been tested with Intel FPGA SDK for OpenCL *Pro* edition (v19.1). It may partially support the *standard* edition of the SDK. +DaCe has been tested with Intel FPGA SDK for OpenCL Pro edition v18.1 and v19.1, targeting Arria 10 and Stratix 10 devices, and Xilinx Vitis HLS v2020.x, v2021.x targeting u250 and u280 devices. + **Distributed Computing**: If using multiple nodes, MPI has to be installed and available. @@ -137,6 +138,12 @@ Common issues with the DaCe Python module * **Bug in DaCe**: If you suspect an issue happens within DaCe, see :ref:`debugging` for ways to pinpoint the source of the issue. + * **Intel FPGA libraries not found**: when targeting Intel FPGAs, the compilation process may fail due to missing OpenCL headers (CMake returns + a ``Could NOT find IntelFPGAOpenCL`` error). This is usually the case when Intel OpenCL compiler does not return the right path to OpenCL host headers. + DaCe relies on ``hlslib`` for compiling FPGA programs, which in turns relies on Intel's compiler to derive the right include path. Please verify that + the include path returned by the Intel compiler (using the ``aocl compile-config`` command) points to a directory that actually contains the OpenCL headers (namely ``cl.hpp`` and + ``cl2.hpp`` files). If this is not the case, please locate them under the Intel Quartus installation folder, and symlink (or copy) them in the ``aocl`` returned path. + .. _qa_vscode: Common issues with the Visual Studio Code extension From fc9f3e3ad664c42e3bde8c7c696e3c58eb61ebbb Mon Sep 17 00:00:00 2001 From: Tiziano De Matteis Date: Wed, 2 Aug 2023 10:21:46 +0200 Subject: [PATCH 3/3] hlslib updated --- dace/external/hlslib | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dace/external/hlslib b/dace/external/hlslib index 1403cd016c..1b5b3aee5d 160000 --- a/dace/external/hlslib +++ b/dace/external/hlslib @@ -1 +1 @@ -Subproject commit 1403cd016ce63a9961eeb3899bea70c873a929ce +Subproject commit 1b5b3aee5dab19adcc443fa9a7cd45244bd246b1