intel RN-OCL004 FPGA SDK for OpenCL Pro Edition
Intel® FPGA SDK for OpenCL™ Pro Edition Version 22.4 Release Notes
The Intel® FPGA SDK for OpenCL™ Pro Edition Release Notes provides late-breaking information about the Intel FPGA Software Development Kit (SDK) for OpenCL(1)(2) Pro Edition and the Intel FPGA Runtime Environment (RTE) for OpenCL Pro Edition Version 22.4.
New Features and Enhancements
No new features added in this release of the Intel FPGA SDK for OpenCL Pro Edition and the Intel FPGA RTE for OpenCL Pro Edition.
Operating System Support
Information about OS support for the Intel FPGA SDK for OpenCL is available on the Operating System Support page of the Intel FPGA website.
Related Information
Operating System Support
Changes to Software Behavior
No changes to the software behavior were made in the current release of the Intel FPGA SDK for OpenCL and the Intel FPGA RTE for OpenCL.
Related Information
OpenCL 2.0 Headers
Known Issues and Workarounds
This section provides information about known issues that affect the Intel FPGA SDK for OpenCL and the Intel FPGA RTE for OpenCL Version 22.4.
- OpenCL and the OpenCL logo are trademarks of Apple Inc. used by permission of the Khronos Group™.
- The Intel FPGA SDK for OpenCL is based on a published Khronos Specification, and has passed the Khronos Conformance Testing Process. Current conformance status can be found at www.khronos.org/conformance.
| Description | Workaround |
| When compiling an OpenCL kernel containing calls to library functions containing HLS tasks, incremental compile may trigger recompilation for unaffected kernels. | No known workaround. However, this is not a functional bug. It may result in a more conservative incremental compile. |
| The emulator runtime emits an assertion error if a kernel is enqueued 16,000 times. | Do not enqueue a kernel more than 16,000 times. |
| OpenCL kernels with names longer than 61 characters might fail in the Intel Quartus® Prime Pro Edition compiler with an error similar to the following error: | Reduce the size of the OpenCL kernel name. |
Error (16045): Instance "...| <long_kernel_name>_cra_slave_inst" instantiates undefined entity "<long_kernel_name>_function_cra_slave" File: <filename> Line: <linenumber> |
|
OpenCL kernel pipes cannot be passed as arguments in some cases. The symptom is the runtime receives a CL_INVALID_BUFFER_SIZE (-61) error when you enqueue your kernel. |
Modify your design to use channels instead of pipes. |
| When alternatively using sub-buffers and their parent buffers, changes written to one might not be reflected in the other. | Unmapping and mapping a buffer forces the sub-buffers and their parent buffers to be synced. Unmapping and mapping a buffer between buffer uses should prevent this issue. |
This section provides information about known issues that affect the current release of the Intel FPGA SDK for OpenCL Custom Platform Toolkit and Reference Platforms. These issues might also affect Custom Platforms you create for use with the Intel FPGA SDK for OpenCL.
| Description | Workaround |
For Windows, when the host application queries the number of devices, calls to clGetDeviceIDs return 128 devices regardless of the actual number of devices present.
Note: You can find the actual available devices at the beginning of the device list returned by |
Perform one of the following workarounds:
• Rewrite the host application to limit the query for
• Rewrite the host application to use • Rewrite the host application to only call • Set the environment variable
correct number of devices. Doing so fixes the erroneous behavior of |
Latest Known Intel FPGA SDK for OpenCL Software Issues
For additional known issue information for the current Intel FPGA SDK for OpenCL version and for previous versions, refer to the Knowledge Base web page.
Related Information
Knowledge Base
Software Issues Resolved
No software issues were reported, corrected or otherwise resolved in the Intel FPGA SDK for OpenCL and the Intel FPGA RTE for OpenCL Version 22.4.
Software Patches Included in this Release
No software patches included in this release.
Intel FPGA SDK for OpenCL Pro Edition Release Notes Archives
For the latest and previous versions of this release notes, refer to Intel FPGA SDK for OpenCL Pro Edition Release Notes. If a software version is not listed, the guide for the previous software version applies.
Document Revision History of the Intel FPGA SDK for OpenCL Pro Edition Release Notes
| Document Version | Intel Quartus Prime Version | Changes |
| 2022.12.19 | 22.4 | Initial release. |
Documents / Resources
 |
intel RN-OCL004 FPGA SDK for OpenCL Pro Edition [pdf] User Guide RN-OCL004, RN-OCL004 FPGA SDK for OpenCL Pro Edition, FPGA SDK for OpenCL Pro Edition, SDK for OpenCL Pro Edition, OpenCL Pro Edition, Edition |
