Added SyclDevice.profiling_timer_resolution property

Author: oleksandr-pavlyk

dpctl/_backend.pxd

@@ -190,6 +190,7 @@ cdef extern from "syclinterface/dpctl_sycl_device_interface.h":
         const DPCTLSyclDeviceRef DRef,
         _partition_affinity_domain_type PartitionAffinityDomainTy)
     cdef DPCTLSyclDeviceRef DPCTLDevice_GetParentDevice(const DPCTLSyclDeviceRef DRef)
+    cdef size_t DPCTLDevice_GetProfilingTimerResolution(const DPCTLSyclDeviceRef DRef)
 
 
 cdef extern from "syclinterface/dpctl_sycl_device_manager.h":

dpctl/_sycl_device.pyx

@@ -57,6 +57,7 @@ from ._backend cimport (  # noqa: E211
     DPCTLDevice_GetPreferredVectorWidthInt,
     DPCTLDevice_GetPreferredVectorWidthLong,
     DPCTLDevice_GetPreferredVectorWidthShort,
+    DPCTLDevice_GetProfilingTimerResolution,
     DPCTLDevice_GetSubGroupIndependentForwardProgress,
     DPCTLDevice_GetVendor,
     DPCTLDevice_HasAspect,
@@ -924,6 +925,19 @@ cdef class SyclDevice(_SyclDevice):
             return None
         return SyclDevice._create(pDRef)
 
+    @property
+    def profiling_timer_resolution(self):
+        """ Profiling timer resolution.
+
+        Returns:
+            int: The resolution of device timer in nanoseconds.
+        """
+        cdef size_t timer_res = 0
+        timer_res = DPCTLDevice_GetProfilingTimerResolution(self._device_ref)
+        if (timer_res == 0):
+            raise RuntimeError("Failed to get device timer resolution.")
+        return timer_res
+
     cdef cpp_bool equals(self, SyclDevice other):
         """ Returns ``True`` if the :class:`dpctl.SyclDevice` argument has the
         same _device_ref as this SyclDevice.

dpctl/tests/test_sycl_device.py

@@ -485,6 +485,17 @@ def check_repr(device):
     assert type(repr(device)) is str
 
 
+def check_profiling_timer_resolution(device):
+    try:
+        resol = device.profiling_timer_resolution
+    except Exception:
+        pytest.fail(
+            "Encountered an exception inside "
+            "profiling_timer_resolution property."
+        )
+    assert isinstance(resol, int) and resol > 0
+
+
 list_of_checks = [
     check_get_max_compute_units,
     check_get_max_work_item_dims,