README.md

SYnergy

SYCL library for energy measurement and frequency scaling. SYnergy allows to get standard power-related features such as per-application and per-kernel energy measurements as well as frequency scaling capabilities, all with minimal configuration. Currently supported target architectures:

• NVIDIA GPUs supported through the NVML library.
• AMD GPUs supported through the ROCm SMI library
• Intel GPUs through the Sysman API

Build

Dependencies

• cmake (3.17 or newer)
• C++17 or newer compiler
• A supported SYCL implementation:
  • DPC++
  • OpenSYCL
• A supported target architecture
  • CUDA with NVML
  • ROCm with ROCm SMI
  • Level Zero with Sysman

To build SYnergy samples, type:

cd SYnergy
mkdir build && cd build/

# CUDA
cmake .. -DSYNERGY_BUILD_SAMPLES=ON -DSYNERGY_SYCL_IMPL=[OpenSYCL | DPC++] -DSYNERGY_CUDA_SUPPORT=ON
# ROCm
cmake .. -DSYNERGY_BUILD_SAMPLES=ON -DSYNERGY_SYCL_IMPL=[OpenSYCL | DPC++] -DSYNERGY_ROCM_SUPPORT=ON
# Level Zero
cmake .. -DSYNERGY_BUILD_SAMPLES=ON -DSYNERGY_SYCL_IMPL=[OpenSYCL | DPC++] -DSYNERGY_LZ_SUPPORT=ON

Usage

To use SYnergy, just swap your current sycl::queue with synergy::queue. Under the samples/ folder you can find an example of SYnergy usage.