FPGA: improve build instructions in the READMEs for samples that require IS_BSP

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/anr/README.md

@@ -166,7 +166,7 @@ The design uses the following generic header files.
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -209,7 +209,7 @@ The design uses the following generic header files.
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/cholesky/README.md

@@ -158,7 +158,7 @@ For `constexpr_math.hpp`, `memory_utils.hpp`, `metaprogramming_utils.hpp`, and `
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -201,7 +201,7 @@ For `constexpr_math.hpp`, `memory_utils.hpp`, `metaprogramming_utils.hpp`, and `
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/cholesky_inversion/README.md

@@ -180,7 +180,7 @@ Additionaly, the cmake build system can be configured using the following parame
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -223,7 +223,7 @@ Additionaly, the cmake build system can be configured using the following parame
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/decompress/README.md

@@ -325,7 +325,7 @@ For `constexpr_math.hpp`, `memory_utils.hpp`, `metaprogramming_utils.hpp`, `tupl
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -373,7 +373,7 @@ For `constexpr_math.hpp`, `memory_utils.hpp`, `metaprogramming_utils.hpp`, `tupl
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/gzip/README.md

@@ -159,7 +159,7 @@ Performance results are based on testing as of October 27, 2020.
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -205,7 +205,7 @@ Performance results are based on testing as of October 27, 2020.
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/merge_sort/README.md

@@ -133,7 +133,7 @@ For `constexpr_math.hpp`, `pipe_utils.hpp`, and `unrolled_loop.hpp` see the READ
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/mvdr_beamforming/README.md

@@ -136,7 +136,7 @@ The `DataProducer` kernel replaces the input IO pipe in the first image. The spl
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -179,7 +179,7 @@ The `DataProducer` kernel replaces the input IO pipe in the first image. The spl
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/qrd/README.md

@@ -148,7 +148,7 @@ Additionaly, the cmake build system can be configured using the following parame
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -191,7 +191,7 @@ Additionaly, the cmake build system can be configured using the following parame
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/ReferenceDesigns/qri/README.md

@@ -137,7 +137,7 @@ Additionaly, the cmake build system can be configured using the following parame
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -180,7 +180,7 @@ Additionaly, the cmake build system can be configured using the following parame
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/Tutorials/DesignPatterns/buffered_host_streaming/README.md

@@ -108,7 +108,7 @@ This sample demonstrates the following concepts:
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -151,7 +151,7 @@ This sample demonstrates the following concepts:
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/Tutorials/DesignPatterns/explicit_data_movement/README.md

@@ -122,7 +122,7 @@ Alternatively, there is a hybrid approach that uses some implicit data movement
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -164,7 +164,7 @@ Alternatively, there is a hybrid approach that uses some implicit data movement
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/Tutorials/DesignPatterns/io_streaming/README.md

@@ -151,7 +151,7 @@ Notice that the main kernel in the `SubmitSideChannelKernels` function in *src/S
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ``` 
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -194,7 +194,7 @@ Notice that the main kernel in the `SubmitSideChannelKernels` function in *src/S
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/Tutorials/DesignPatterns/simple_host_streaming/README.md

@@ -141,7 +141,6 @@ We are currently working on an API and tutorial to address both of these drawbac
 >
 > For more information on configuring environment variables, see [Use the setvars Script with Linux* or macOS*](https://www.intel.com/content/www/us/en/develop/documentation/oneapi-programming-guide/top/oneapi-development-environment-setup/use-the-setvars-script-with-linux-or-macos.html) or [Use the setvars Script with Windows*](https://www.intel.com/content/www/us/en/develop/documentation/oneapi-programming-guide/top/oneapi-development-environment-setup/use-the-setvars-script-with-windows.html).
 
-
 ### On Linux*
 
 1. Change to the sample directory.
@@ -158,7 +157,7 @@ We are currently working on an API and tutorial to address both of these drawbac
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command:
    >  ```
-   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ```
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -200,7 +199,7 @@ We are currently working on an API and tutorial to address both of these drawbac
    >
    > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command:
    >  ```
-   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+   >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
    >  ```
    >
    > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/Tutorials/DesignPatterns/zero_copy_data_transfer/README.md

@@ -102,7 +102,7 @@ This approach is not considered host streaming since the CPU and FPGA cannot (re
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -144,7 +144,7 @@ This approach is not considered host streaming since the CPU and FPGA cannot (re
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/Tutorials/Features/experimental/hostpipes/README.md

@@ -304,7 +304,7 @@ In the latter launch-collect test, the entire contents of the `in` vector are wr
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -346,7 +346,7 @@ In the latter launch-collect test, the entire contents of the `in` vector are wr
   >
   > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
   >  ```
-  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+  >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
   >  ``` 
   >
   > You will only be able to run an executable on the FPGA if you specified a BSP.

DirectProgramming/C++SYCL_FPGA/Tutorials/Features/experimental/invocation_interfaces/src/CMakeLists.txt

@@ -30,8 +30,22 @@ if(NOT DEFINED FPGA_DEVICE)
                     \nPlease refer to the README for information on target selection.")
 else()
     message(STATUS "Configuring the design with the following target: ${FPGA_DEVICE}")
+
+    # Check if the target is a BSP
+    if(IS_BSP MATCHES "1" OR FPGA_DEVICE MATCHES ".*pac_a10.*|.*pac_s10.*")
+        set(IS_BSP "1")
+    else()
+        set(IS_BSP "0")
+        message(STATUS "The selected target ${FPGA_DEVICE} is assumed to be an FPGA part number.")
+        message(STATUS "If the target is actually a BSP, run cmake with -DIS_BSP=1.")
+    endif()
+endif()
+
+if((IS_BSP STREQUAL "1"))
+    message(FATAL_ERROR "ERROR: This tutorial is only supported in the IP Authoring flow and therefore does not support BSPs as a target.")
 endif()
 
+
 # This is a Windows-specific flag that enables exception handling in host code
 if(WIN32)
     set(WIN_FLAG "/EHsc")

DirectProgramming/C++SYCL_FPGA/Tutorials/Features/printf/README.md

@@ -119,7 +119,7 @@ PRINTF("Hello: %d\n", 123);
     >
     > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
     >  ```
-    >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+    >  cmake .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
     >  ``` 
     >
     > You will only be able to run an executable on the FPGA if you specified a BSP.
@@ -161,7 +161,7 @@ PRINTF("Hello: %d\n", 123);
     >
     > Alternatively, you can target an explicit FPGA board variant and BSP by using the following command: 
     >  ```
-    >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant>
+    >  cmake -G "NMake Makefiles" .. -DFPGA_DEVICE=<board-support-package>:<board-variant> -DIS_BSP=1
     >  ``` 
     >
     > You will only be able to run an executable on the FPGA if you specified a BSP.