Intel® oneAPI Programming Guide

Programming Guide

Contents

Emulate Pipe Depth

When you compile your kernel for emulation, the default pipe depth is different from the default pipe depth generated when your kernel is compiled for hardware. You can change this behavior when you compile your kernel for emulation with the
CL_CONFIG_CHANNEL_DEPTH_EMULATION_MODE
 environment variable.
For pipes, you must set the
CL_CONFIG_CHANNEL_DEPTH_EMULATION_MODE
 environment variable before running the host program.
The
CL_CONFIG_CHANNEL_DEPTH_EMULATION_MODE
 environment variable accepts the following values:
CL_CONFIG_CHANNEL_DEPTH_EMULATION_MODE values
Environment Variable
Description
ignoredepth
All pipes are given a pipe depth chosen to provide the fastest execution time for your kernel emulation. Any explicitly set pipe depth attribute is ignored.
default
Pipes with an explicit depth attribute have their specified depth. Pipes without a specified depth are given a default pipe depth that is chosen to provide the fastest execution time for your kernel emulation.
strict
All pipe depths in the emulation are given a depth that matches the depth given for the FPGA compilation. If the specified depth is not given, the depth will be 1. This value is used by default if the CL_CONFIG_CHANNEL_DEPTH_EMULATION_MODE environment variable is not set.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.