From Fedora Project Wiki

No edit summary
No edit summary
 
Line 2: Line 2:
|description=This test case verifies that the Intel Compute Runtime for OpenCL applications functions correctly on systems with Intel graphics hardware.
|description=This test case verifies that the Intel Compute Runtime for OpenCL applications functions correctly on systems with Intel graphics hardware.
|setup=
|setup=
# Ensure Fedora is installed on a system with Intel integrated graphics.
# Ensure Fedora is installed on a system with Intel integrated graphics (from roughly year 2014 (Broadwell) or newer).
# Install the "intel-compute-runtime" package using `sudo dnf install intel-compute-runtime`.
# Install the "intel-compute-runtime" package using `sudo dnf install intel-compute-runtime`.
# Additionally, install OpenCL utilities and development packages, e.g., `sudo dnf install clinfo opencl-headers`.
# Additionally, install OpenCL utilities and development packages, e.g., `sudo dnf install clinfo darktable opencl-headers`.
# Reboot the system to ensure all drivers are correctly loaded.
# Reboot the system to ensure all drivers are correctly loaded.
|actions=
|actions=


# Open a terminal.
# Open a terminal.
# Run `clinfo` to list all OpenCL platforms and devices detected on the system. Ensure Intel devices are listed.
# Run `clinfo` to list all OpenCL platforms and devices detected on the system. Ensure Intel devices are listed (Number of platforms reported is not 0).
# Compile and run a simple OpenCL application that performs a basic computation, for example, vector addition. You can find sample code in the OpenCL SDK or online tutorials.
# Compile and run a simple OpenCL application that performs a basic computation, for example, vector addition. You can find sample code in the OpenCL SDK or online tutorials. Or try a darktable-cltest.
# Monitor the system performance and stability while the OpenCL application is running, using system monitoring tools like `htop` or `intel_gpu_top`.
# Monitor the system performance and stability while the OpenCL application is running, using system monitoring tools like `htop` or `intel_gpu_top`.
|results=
|results=
The following must be true to consider this a successful test run.
The following must be true to consider this a successful test run.
# `clinfo` successfully lists Intel integrated graphics as an available OpenCL device.
# `clinfo` successfully lists Intel integrated graphics as an available OpenCL device (Number of platforms reported is not 0).
# The OpenCL application compiles without errors and runs successfully.
# The OpenCL application compiles without errors and runs successfully.
# For the darkatble-cltest, run `rm -rf ~/.cache/darktable/ && darktable-cltest` and watch out for `[opencl_init] FINALLY: opencl is AVAILABLE and ENABLED.` line near the end of the output.
# The application correctly utilizes the Intel GPU for computation, as evidenced by output validation and GPU activity monitors.
# The application correctly utilizes the Intel GPU for computation, as evidenced by output validation and GPU activity monitors.
# No system instability or crashes are observed during the execution of OpenCL applications.
# No system instability or crashes are observed during the execution of OpenCL applications.

Latest revision as of 08:25, 9 April 2024

Description

This test case verifies that the Intel Compute Runtime for OpenCL applications functions correctly on systems with Intel graphics hardware.

Setup

  1. Ensure Fedora is installed on a system with Intel integrated graphics (from roughly year 2014 (Broadwell) or newer).
  2. Install the "intel-compute-runtime" package using sudo dnf install intel-compute-runtime.
  3. Additionally, install OpenCL utilities and development packages, e.g., sudo dnf install clinfo darktable opencl-headers.
  4. Reboot the system to ensure all drivers are correctly loaded.

How to test

  1. Open a terminal.
  2. Run clinfo to list all OpenCL platforms and devices detected on the system. Ensure Intel devices are listed (Number of platforms reported is not 0).
  3. Compile and run a simple OpenCL application that performs a basic computation, for example, vector addition. You can find sample code in the OpenCL SDK or online tutorials. Or try a darktable-cltest.
  4. Monitor the system performance and stability while the OpenCL application is running, using system monitoring tools like htop or intel_gpu_top.

Expected Results

The following must be true to consider this a successful test run.

  1. clinfo successfully lists Intel integrated graphics as an available OpenCL device (Number of platforms reported is not 0).
  2. The OpenCL application compiles without errors and runs successfully.
  3. For the darkatble-cltest, run rm -rf ~/.cache/darktable/ && darktable-cltest and watch out for [opencl_init] FINALLY: opencl is AVAILABLE and ENABLED. line near the end of the output.
  4. The application correctly utilizes the Intel GPU for computation, as evidenced by output validation and GPU activity monitors.
  5. No system instability or crashes are observed during the execution of OpenCL applications.

Optional

Test with various OpenCL versions supported by the runtime, and try running more complex or GPU-intensive OpenCL applications to further evaluate performance and stability.