feature: Add more APIs to L0 Sysman python binding

Added following APIs to python binding:

1. zesDevicePciGetProperties
2. zesDevicePciGetStats
3. zesDeviceEccAvailable
4. zesDeviceEccConfigurable
5. zesDeviceGetEccState
6. zesDeviceSetEccState
7. zesPowerGetLimitsExt
8. zesPowerSetLimitsExt
9. zesFrequencyGetAvailableClocks
10. zesFrequencyGetRange
11. zesFrequencySetRange
12. zesFrequencyGetThrottleTime
13. zesDevicePciGetState
14. zesPowerGetProperties
15. zesPowerGetUsage

Signed-off-by: Aviral Nigam <aviral.nigam@intel.com>

Author: aviralni

bindings/sysman/python/source/examples/pyzes_black_box_test.py

@@ -1036,6 +1036,17 @@ def test_power_module(device_handle, device_index):
         if not check_rc(f"zesPowerGetEnergyCounter(power {i}, second)", rc):
             continue
 
+        instant_power = c_uint32(0)
+        average_power = c_uint32(0)
+        rc = pz.zesPowerGetUsage(
+            power_handles[i], byref(instant_power), byref(average_power)
+        )
+        if not check_rc(f"zesPowerGetUsage(power {i})", rc):
+            continue
+
+        print_verbose(f"    Instant Power Usage: {instant_power.value} mW")
+        print_verbose(f"    Average Power Usage: {average_power.value} mW")
+
         energy_delta = energy_counter2.energy - energy_counter1.energy
         time_delta = energy_counter2.timestamp - energy_counter1.timestamp
         if time_delta > 0:

bindings/sysman/python/source/pyzes.py

@@ -67,7 +67,7 @@ def _LoadZeLibrary():
         # load the library
         libName = "ze_loader"
         if sys.platform.startswith("linux"):
-            libName = "/usr/lib/x86_64-linux-gnu/lib" + libName + ".so.1"
+            libName = "/usr/lib/x86_64-linux-gnu/lib" + libName + ".so"
         else:
             # Try multiple common locations for Windows Intel GPU drivers
             possible_paths = [
@@ -1178,6 +1178,32 @@ def zesPowerGetEnergyCounter(hPower, pEnergy):
     return retVal
 
 
+def zesPowerGetUsage(hPower, pInstantPower, pAveragePower):
+    """Wraps API:
+    ze_result_t zesPowerGetUsage(
+            zes_pwr_handle_t hPower,
+            uint32_t* pInstantPower,
+            uint32_t* pAveragePower)
+
+    Parameters:
+        hPower: power handle
+        pInstantPower: POINTER(c_uint32) - instant power usage in milliwatts
+        pAveragePower: POINTER(c_uint32) - average power usage in milliwatts
+    Returns:
+        ze_result_t - return code only, usage values are filled into the output pointers
+    """
+    funcPtr = getFunctionPointerList("zesPowerGetUsage")
+    funcPtr.argtypes = [
+        zes_pwr_handle_t,
+        POINTER(c_uint32),
+        POINTER(c_uint32),
+    ]
+    funcPtr.restype = ze_result_t
+
+    retVal = funcPtr(hPower, pInstantPower, pAveragePower)
+    return retVal
+
+
 def zesPowerGetProperties(hPower, pProperties):
     """Wraps API:
     ze_result_t zesPowerGetProperties(

bindings/sysman/python/test/unit_tests/test_power.py

@@ -73,6 +73,34 @@ def mock_get_energy(power_handle, energy_ptr):
         mock_get_func.assert_called_with("zesPowerGetEnergyCounter")
         mock_func.assert_called_once()
 
+    def test_GivenValidPowerHandleWhenCallingZesPowerGetUsageThenCallSucceedsWithUsageData(
+        self, mock_get_func
+    ):
+        mock_instant_power = 185000
+        mock_average_power = 172500
+
+        def mock_get_usage(power_handle, instant_power_ptr, average_power_ptr):
+            instant_power_ptr._obj.value = mock_instant_power
+            average_power_ptr._obj.value = mock_average_power
+            return self.pyzes.ZE_RESULT_SUCCESS
+
+        mock_func = MagicMock(side_effect=mock_get_usage)
+        mock_get_func.return_value = mock_func
+
+        power_handle = self.pyzes.zes_pwr_handle_t()
+        instant_power = c_uint32(0)
+        average_power = c_uint32(0)
+
+        result = self.pyzes.zesPowerGetUsage(
+            power_handle, byref(instant_power), byref(average_power)
+        )
+
+        self.assertEqual(result, self.pyzes.ZE_RESULT_SUCCESS)
+        self.assertEqual(instant_power.value, mock_instant_power)
+        self.assertEqual(average_power.value, mock_average_power)
+        mock_get_func.assert_called_with("zesPowerGetUsage")
+        mock_func.assert_called_once()
+
     def test_GivenValidPowerHandleWhenCallingZesPowerGetPropertiesThenCallSucceedsWithDomainData(
         self, mock_get_func
     ):