2024.2-1 OFS Release for oneAPI Accelerator Support Package (ofs-2024.2-2)

OFS 2024.2-1

Summary: OFS 2024.2-1 Release for Intel^® oneAPI Accelerator Support Package

Release notes:

oneAPI Accelerator Support Package is a collection of hardware and software components that enables oneAPI kernels to communicate with oneAPI runtime and other OFS hardware and software components.

Oneapi-asp repository contains the following reference ASPs:

1. oneAPI ASP reference design targeting Agilex® 7 FPGA device
2. oneAPI ASP reference design targeting Stratix® 10 FPGA device

The reference oneAPI ASPs use PCIe Attach reference FIMs. For more information about PCIe Attach FIMs, refer to OFS documentation page here. To get started with building oneAPI ASPs, please refer to the oneAPI ASP documentation here.

For more information about other OFS repositories, please visit the OFS Overview page and Discussions tab.

OFS 2024.2-1 Release Details:

• oneapi-asp release tag: ofs-2024.2-2
• For a full summary of OFS FIM release details refer to release notes linked below:
  * OFS 2024.2-1 Release for Agilex® 7 FPGA PCIe Attach shell targeting :
  - Intel® FPGA SmartNIC N6001-PL Development Platform
  - Agilex® 7 FPGA F-Series Development Kit (2x F-Tile)
  - Agilex® 7 FPGA I-Series Development Kit (2x R-Tile, F-Tile)
  Release Notes
  * OFS 2024.1-1 Release for Stratix® 10 FPGA PCIe Attach shell targeting Intel FPGA PAC D5005 Development Platform: Release Notes

Reference oneAPI ASP Features:

• Arm® AMBA® 4 AXI to Avalon® Protocol Translation
• Contiguous global memory configuration (multiple memory banks configured as a single global memory) with burst interleaving support
• DMA Engine for host to global memory data transfer
• Support for Unified Shared Memory (USM)
• I/O Pipes (available in reference ASP targeting Intel® FPGA SmartNIC N6001-PL Development Platform)
• Utilities to integrate into oneAPI runtime environment
• Diagnose utility to detect oneAPI ASP initialization status, board temperature and run a simple diagnostic test
• Debug variables in the Memory Mapped Device (MMD) Layer
• Editor tool to generate and customize the ASP

Known Issues:

ID	Known Issue	Workaround	Status
13010786164	When using oneAPI compiler, you may see a warning like below: The current version of the Intel (R) oneAPI compiler supports Intel (R) Quartus (R) Prime versions (versions supported). The version found on the PATH/QUARTUS_ROOTDIR_OVERRIDE, (quartus version) ,is not supported.	oneAPI compiler allows evaluation with unsupported version of Quartus Prime: If you are using a Quartus Prime version older than the supported range, please download a supported Quartus Prime version as indicated in the compiler warning. If you are using a Quartus Prime version newer than the supported range, please upgrade to a newer oneAPI compiler version when available. To see range of supported Quartus version, please see Intel® oneAPI DPC++/C++ Compiler System Requirements. Download the latest oneAPI base toolkit version here.
22019730669	AFU Simulation Flow (ASE) for oneapi-asp is not supported in this release	None	To be fixed in future release
14022242217	For SLES15 OS, when compiling an oneAPI design you may see a Quartus® assembler crash, with an error message like the following:: *** Fatal Error: Segment Violation: faulting address=(nil), PC=0x7fdb2640c50b : 0x7fdb2640c50b: tcmalloc!tcmalloc::ThreadCache::ReleaseToCentralCache(tcmalloc::ThreadCache::FreeList*, unsigned int, int) + 0xeb Module: quartus_asm	A patch is provided to solve this issue for Quartus® Prime Pro software version 24.1 in the following link.	To be fixed in future release of Quartus® Prime Pro Edition Software
14022423265 16024113690	In some rare cases, the oneAPI compiler may crash when you use any variant of the ivdep annotation (for example, [[intel::ivdep]], [[intel::ivdep(array)]], [[intel::ivdep(safelen)]], or [[intel::ivdep(array, safelen)]]) on a loop. A back trace of this crash contains the following line: llvm::AccessGroupInfo::hasIndependentAGsOrSafelen(llvm::Loop*, llvm::Instruction*, llvm::Instruction*, int&) + 195	A patch for the oneAPI compiler 2024.2 is provided to solve these issues in the following link	To be fixed in future release of the FPGA Support Package for the oneAPI DCP++/C++ Compiler
14023830020	When opening the oneAPI ASP Editor, the error of "Bad Parameter Name" appears	Edit the oneapi_asp_editor_hw.tcl file, remove the extra character "/" located in line 1054 in the lappend command creating "mem_dynamic_param" list.	To be fixed in future release

2024.2-1 OFS Release for oneAPI Accelerator Support Package (ofs-2024.2-1)

OFS 2024.2-1

Summary: OFS 2024.2-1 Release for Intel^® oneAPI Accelerator Support Package

Release notes:

oneAPI Accelerator Support Package is a collection of hardware and software components that enables oneAPI kernels to communicate with oneAPI runtime and other OFS hardware and software components.

Oneapi-asp repository contains the following reference ASPs:

1. oneAPI ASP reference design targeting Agilex® 7 FPGA device
2. oneAPI ASP reference design targeting Stratix® 10 FPGA device

The reference oneAPI ASPs use PCIe Attach reference FIMs. For more information about PCIe Attach FIMs, refer to OFS documentation page here. To get started with building oneAPI ASPs, please refer to the oneAPI ASP documentation here.

For more information about other OFS repositories, please visit the OFS Overview page and Discussions tab.

OFS 2024.2-1 Release Details:

• oneapi-asp release tag: ofs-2024.2-1
• For a full summary of OFS FIM release details refer to release notes linked below:
  * OFS 2024.2-1 Release for Agilex® 7 FPGA PCIe Attach shell targeting :
  - Intel® FPGA SmartNIC N6001-PL Development Platform
  - Agilex® 7 FPGA F-Series Development Kit (2x F-Tile)
  - Agilex® 7 FPGA I-Series Development Kit (2x R-Tile, F-Tile)
  Release Notes
  * OFS 2024.1-1 Release for Stratix® 10 FPGA PCIe Attach shell targeting Intel FPGA PAC D5005 Development Platform: Release Notes

Reference oneAPI ASP Features:

• Arm® AMBA® 4 AXI to Avalon® Protocol Translation
• Contiguous global memory configuration (multiple memory banks configured as a single global memory) with burst interleaving support
• DMA Engine for host to global memory data transfer
• Support for Unified Shared Memory (USM)
• I/O Pipes (available in reference ASP targeting Intel® FPGA SmartNIC N6001-PL Development Platform)
• Utilities to integrate into oneAPI runtime environment
• Diagnose utility to detect oneAPI ASP initialization status, board temperature and run a simple diagnostic test
• Debug variables in the Memory Mapped Device (MMD) Layer

Known Issues:

ID	Known Issue	Workaround	Status
13010786164	When using oneAPI compiler, you may see a warning like below: The current version of the Intel (R) oneAPI compiler supports Intel (R) Quartus (R) Prime versions (versions supported). The version found on the PATH/QUARTUS_ROOTDIR_OVERRIDE, (quartus version) ,is not supported.	oneAPI compiler allows evaluation with unsupported version of Quartus Prime: If you are using a Quartus Prime version older than the supported range, please download a supported Quartus Prime version as indicated in the compiler warning. If you are using a Quartus Prime version newer than the supported range, please upgrade to a newer oneAPI compiler version when available. To see range of supported Quartus version, please see Intel® oneAPI DPC++/C++ Compiler System Requirements. Download the latest oneAPI base toolkit version here.
22019730669	AFU Simulation Flow (ASE) for oneapi-asp is not supported in this release	None	To be fixed in future release
14022242217	For SLES15 OS, when compiling an oneAPI design you may see a Quartus® assembler crash, with an error message like the following:: *** Fatal Error: Segment Violation: faulting address=(nil), PC=0x7fdb2640c50b : 0x7fdb2640c50b: tcmalloc!tcmalloc::ThreadCache::ReleaseToCentralCache(tcmalloc::ThreadCache::FreeList*, unsigned int, int) + 0xeb Module: quartus_asm	A patch is provided to solve this issue for Quartus® Prime Pro software version 24.1 in the following link.	To be fixed in future release of Quartus® Prime Pro Edition Software
14022423265 16024113690	In some rare cases, the oneAPI compiler may crash when you use any variant of the ivdep annotation (for example, [[intel::ivdep]], [[intel::ivdep(array)]], [[intel::ivdep(safelen)]], or [[intel::ivdep(array, safelen)]]) on a loop. A back trace of this crash contains the following line: llvm::AccessGroupInfo::hasIndependentAGsOrSafelen(llvm::Loop*, llvm::Instruction*, llvm::Instruction*, int&) + 195	A patch for the oneAPI compiler 2024.2 is provided to solve these issues in the following link	To be fixed in future release of the FPGA Support Package for the oneAPI DCP++/C++ Compiler
14023182378	setup_permissions.sh script configures 1024 2M hugepages by default	Before running the setup_permissions.sh script set OFS_ASP_ENV_NUM_HUGEPAGES env variable to 2048 with the aim of configuring the default settings of the system to 2048 2M hugepages	To be fixed in future release

2024.1-1 OFS Release for oneAPI Accelerator Support Package (ofs-2024.1-1)

OFS 2024.1-1

Summary: OFS 2024.1-1 Release for Intel^® oneAPI Accelerator Support Package

Release notes:

oneAPI Accelerator Support Package is a collection of hardware and software components that enables oneAPI kernels to communicate with oneAPI runtime and other OFS hardware and software components.

Oneapi-asp repository contains the following reference ASPs:

1. oneAPI ASP reference design targeting Agilex® 7 FPGA device
2. oneAPI ASP reference design targeting Stratix® 10 FPGA device

The reference oneAPI ASPs use PCIe Attach reference FIMs. For more information about PCIe Attach FIMs, refer to OFS documentation page here. To get started with building oneAPI ASPs, please refer to the oneAPI ASP documentation here.

For more information about other OFS repositories, please visit the OFS Overview page and Discussions tab.

OFS 2024.1-1 Release Details:

• oneapi-asp release tag: ofs-2024.1-1
• For a full summary of OFS 2024.1-1 FIM release details refer to release notes linked below:
  * OFS 2024.1-1 Release for Agilex® 7 FPGA PCIe Attach shell targeting :
  - Intel® FPGA SmartNIC N6001-PL Development Platform
  - Agilex® 7 FPGA F-Series Development Kit (2x F-Tile)
  - Agilex® 7 FPGA I-Series Development Kit (2x R-Tile, F-Tile)
  Release Notes
  * OFS 2024.1-1 Release for Stratix® 10 FPGA PCIe Attach shell targeting Intel FPGA PAC D5005 Development Platform: Release Notes

Reference oneAPI ASP Features:

• Arm® AMBA® 4 AXI to Avalon® Protocol Translation
• Contiguous global memory configuration (multiple memory banks configured as a single global memory) with burst interleaving support
• DMA Engine for host to global memory data transfer
• Support for Unified Shared Memory (USM)
• I/O Pipes (available in reference ASP targeting Intel® FPGA SmartNIC N6001-PL Development Platform)
• Utilities to integrate into oneAPI runtime environment
• Diagnose utility to detect oneAPI ASP initialization status, board temperature and run a simple diagnostic test
• Debug variables in the Memory Mapped Device (MMD) Layer

Known Issues:

ID	Known Issue	Workaround	Status
13010786164	When using oneAPI compiler, you may see a warning like below: The current version of the Intel (R) oneAPI compiler supports Intel (R) Quartus (R) Prime versions (versions supported). The version found on the PATH/QUARTUS_ROOTDIR_OVERRIDE, (quartus version) ,is not supported.	oneAPI compiler allows evaluation with unsupported version of Quartus Prime: If you are using a Quartus Prime version older than the supported range, please download a supported Quartus Prime version as indicated in the compiler warning. If you are using a Quartus Prime version newer than the supported range, please upgrade to a newer oneAPI compiler version when available. To see range of supported Quartus version, please see Intel® oneAPI DPC++/C++ Compiler System Requirements. Download the latest oneAPI base toolkit version here.
22019730669	AFU Simulation Flow (ASE) for oneapi-asp is not supported in this release	None	To be fixed in future release

2023.3-2 OFS Release for oneAPI Accelerator Support Package (ofs-2023.3-2)

OFS 2023.3-2

Summary: OFS 2023.3-2 Release for Intel^® oneAPI Accelerator Support Package

Release notes:

oneAPI Accelerator Support Package is a collection of hardware and software components that enables oneAPI kernels to communicate with oneAPI runtime and other OFS hardware and software components.

Oneapi-asp repository contains the following reference ASPs:

1. oneAPI ASP reference design targeting Intel® Agilex® 7 FPGA device
2. oneAPI ASP reference design targeting Intel® Stratix® 10 FPGA device

The reference oneAPI ASPs use PCIe Attach reference FIMs. For more information about PCIe Attach FIMs, refer to OFS documentation page here. To get started with building oneAPI ASPs, please refer to the oneAPI ASP documentation here.

For more information about other OFS repositories, please visit the OFS Overview page and Discussions tab.

OFS 2023.3-2 Release Details:

• oneapi-asp release tag: ofs-2023.3-2
• For a full summary of OFS 2023.3-2 FIM release details refer to release notes linked below:
  * OFS 2023.3-2 Release for Intel® Agilex® 7 FPGA PCIe Attach shell targeting Intel® FPGA SmartNIC N6001-PL Development Platform: Release Notes
  * OFS 2023.3-1 Release for Intel® Stratix 10 FPGA PCIe Attach shell targeting Intel FPGA PAC D5005 Development Platform: Release Notes

Reference oneAPI ASP Features:

• Arm® AMBA® 4 AXI to Avalon® Protocol Translation
• Contiguous global memory configuration (multiple memory banks configured as a single global memory) with burst interleaving support
• DMA Engine for host to global memory data transfer
• Support for Unified Shared Memory (USM)
• I/O Pipes (available in reference ASP targeting Intel® Agilex® 7 FPGA device)
• Ability to control PR through PF and run solution in VM (when 2 PF FIM is used, for more information about FIM, refer to Release Notes)
• Utilities to integrate into oneAPI runtime environment
• Diagnose utility to detect oneAPI ASP initialization status, board temperature and run a simple diagnostic test

Known Issues:

ID	Known Issue	Workaround	Status
22019730669	AFU Simulation Flow (ASE) for oneapi-asp is not supported in this release	None	To be fixed in future release

Bug Fixes:
• Gzip and double buffering oneAPI code samples execute on oneAPI ASP reference design targeting Agilex® 7 FPGA device. (16021955446)

2023.3-1 OFS Release for oneAPI Accelerator Support Package (ofs-2023.3-1)

OFS 2023.3-1

Summary: OFS 2023.3-1 Release for Intel^® oneAPI Accelerator Support Package

Release notes:

oneAPI Accelerator Support Package is a collection of hardware and software components that enables oneAPI kernels to communicate with oneAPI runtime and other OFS hardware and software components.

Oneapi-asp repository contains the following reference ASPs:

1. oneAPI ASP reference design targeting Intel® Agilex® FPGA device
2. oneAPI ASP reference design targeting Intel® Stratix® 10 FPGA device

The reference oneAPI ASPs use PCIe Attach reference FIMs. For more information about PCIe Attach FIMs, refer to OFS documentation page here. To get started with building oneAPI ASPs, please refer to the oneAPI ASP documentation here.

For more information about other OFS repositories, please visit the OFS Overview page and Discussions tab.

OFS 2023.3-1 Release Details:

• oneapi-asp release tag: ofs-2023.3-1
• For a full summary of OFS 2023.3-1 FIM release details refer to release notes linked below:
  * OFS 2023.3-1 Release for Intel® Agilex® 7 FPGA PCIe Attach shell targeting Intel® FPGA SmartNIC N6001-PL Development Platform: Release Notes
  * OFS 2023.3-1 Release for Intel® Stratix 10 FPGA PCIe Attach shell targeting Intel FPGA PAC D5005 Development Platform: Release Notes

Reference oneAPI ASP Features:

• Arm® AMBA® 4 AXI to Avalon® Protocol Translation
• Contiguous global memory configuration (multiple memory banks configured as a single global memory) with burst interleaving support
• DMA Engine for host to global memory data transfer
• Support for Unified Shared Memory (USM)
• I/O Pipes (available in reference ASP targeting Intel® Agilex® 7 FPGA device)
• Utilities to integrate into oneAPI runtime environment
• Diagnose utility to detect oneAPI ASP initialization status, board temperature and run a simple diagnostic test

Known Issues:

ID	Known Issue	Workaround	Status
14020195965	oneapi-asp/Platform-Name/scripts/build-opae.sh clones to master branch by default.	As described in oneAPI Accelerator Support Package (ASP): Getting Started User Guide, please set “OPAE_SDK_REPO_BRANCH“environment variable before building oneapi-asp.	Fixed in a future version of oneapi-asp.
16021955446	Gzip and double buffering oneAPI code samples fail execution on oneAPI ASP reference design targeting Intel® Agilex® FPGA device.	If you require double buffering functionality, please use 2023.2 OFS Release for Intel Agilex 7.	Fixed in a future version of oneapi-asp.
22019730669	AFU Simulation Flow (ASE) for oneapi-asp is not supported in this release	None	To be fixed in future release

Bug Fixes:

• Diagnostic utility changes (22018737066) Displays BSP Diagnostics failure if VF required for PR is not created
• Initialization flow changes (14020322440) build-default-aocx.sh is replaced with build-default-binaries.sh to build oneAPI fat binary
instead of “aocx” bitstreams, initialize utility uses oneAPI fat binary for initialization

2023.2 OFS Release for oneAPI Accelerator Support Package (ofs-2023.2-1)

OFS 2023.2

Summary: OFS 2023.2 Release for Intel^® oneAPI Accelerator Support Package

Release notes:

oneAPI Accelerator Support Package is a collection of hardware and software components that enables oneAPI kernels to communicate with oneAPI runtime and other OFS hardware and software components.

Oneapi-asp repository contains the following reference ASPs:

1. oneAPI ASP reference design targeting Intel® Agilex® FPGA device
2. oneAPI ASP reference design targeting Intel® Stratix® 10 FPGA device

The reference oneAPI ASPs use PCIe Attach reference FIMs. For more information about PCIe Attach FIMs, refer to OFS documentation page here. To get started with building oneAPI ASPs, please refer to the oneAPI ASP documentation here.

For more information about other OFS repositories, please visit the OFS Overview page and Discussions tab.

OFS 2023.2 Release Details:

• oneapi-asp release tag: ofs-2023.2-1

• For a full summary of OFS 2023.2 FIM release details refer to release notes linked below:
  * OFS 2023.2 Release for Intel® Agilex® 7 FPGA PCIe Attach shell targeting Intel® FPGA SmartNIC N6001-PL Development Platform: Release Notes
  * OFS 2023.2 Release for Intel® Stratix 10 FPGA PCIe Attach shell targeting Intel FPGA PAC D5005 Development Platform: Release Notes

• Additional patch required for oneAPI ASP targeting Intel® Agilex® 7 FPGA device
  * Quartus Prime Pro Patch: Quartus 23.2 Patch 0.02. Download from assets here.

Reference oneAPI ASP Features:

• Arm® AMBA® 4 AXI to Avalon® Protocol Translation
• Contiguous global memory configuration (multiple memory banks configured as a single global memory) with burst interleaving support
• DMA Engine for host to global memory data transfer
• Support for Unified Shared Memory (USM)
• I/O Pipes (available in reference ASP targeting Intel® Agilex® 7 FPGA device) - NEW in OFS 2023.2
• Utilities to integrate into oneAPI runtime environment
• Diagnose utility to detect oneAPI ASP initialization status, board temperature and run a simple diagnostic test

Known Issues:

ID	Known Issue	Workaround	Status
13010786164, 14020143486	oneAPI compiler version 2023.2 does not support Intel Quartus Prime Pro version 23.2. Following error message is seen while compiling any oneAPI applications with oneAPI Base Toolkit version 2023.2 and Quartus Prime Pro version 23.2: The version found on the PATH/QUARTUS_ROOTDIR_OVERRIDE, 23.2, is not supported.	None	Fixed in a future version of oneAPI Base Toolkit.
14020195965	oneapi-asp/Platform-Name/scripts/build-opae.sh clones to master branch by default.	As described in oneAPI Accelerator Support Package (ASP): Getting Started User Guide, please set “OPAE_SDK_REPO_BRANCH“environment variable before building oneapi-asp.	Fixed in a future version of oneapi-asp.
22019730669	AFU Simulation Flow (ASE) for oneapi-asp is not supported in this release	None	To be fixed in future release

Bug Fixes:

• Missing permissions in setup_permissions.sh script fixed (14018513582)
• Resolved: the OneAPI Unified Shared Memory (USM) reference design is showing lower read bandwidth than expected (22016317880)
• Fixed diagnose utility failure when no BMC is present (22018519029)
• RTL code changes in hardware to remove hardcoded values, width fixes (14016777343, 14017664328)

ofs-2023.1-1

Release for 2023.1-1