added support for extended device state (#464)

Signed-off-by: Joshua Santosh Ranjan <joshua.santosh.ranjan@intel.com>

Author: joshuaranjan

scripts/sysman/EXT_DeviceState.rst

@@ -0,0 +1,73 @@
+<%
+import re
+from templates import helper as th
+%><%
+    OneApi=tags['$OneApi']
+    x=tags['$x']
+    X=x.upper()
+    s=tags['$s']
+    S=s.upper()
+%>
+:orphan:
+
+.. _ZES_extension_device_state:
+
+============================
+ Device State Extension
+============================
+
+API
+----
+
+* Enumerations
+    * ${s}_device_ext_state_version_t
+    * ${s}_device_state_ext_flags_t
+
+* Structures
+
+    * ${s}_device_ext_state_t
+
+
+Device State
+~~~~~~~~~~~~~~
+
+This extension provides additional device state information beyond the basic reset and repair status
+available through the standard ${s}DeviceGetState API. The extension allows applications to query
+extended device states including wedged condition, survivability mode, and flash override status.
+
+The ${s}_device_ext_state_t structure can be passed via the pNext chain of ${s}_device_state_t to
+retrieve these additional state flags.
+
+Multiple flags may be set simultaneously if the device is in multiple states.
+
+Usage Example
+~~~~~~~~~~~~~
+
+.. parsed-literal::
+
+    // Query basic device state
+    ${s}_device_state_t deviceState = {};
+    deviceState.stype = ${S}_STRUCTURE_TYPE_DEVICE_STATE;
+    deviceState.pNext = nullptr;
+    
+    // Add extended state structure to pNext chain
+    ${s}_device_ext_state_t extendedState = {};
+    extendedState.stype = ${S}_STRUCTURE_TYPE_DEVICE_EXT_STATE;
+    extendedState.pNext = nullptr;
+    deviceState.pNext = &extendedState;
+    
+    // Get device state including extended flags
+    ${s}DeviceGetState(hDevice, &deviceState);
+    
+    // Check extended device state flags
+    if (extendedState.flags & ${S}_DEVICE_EXT_STATE_FLAGS_WEDGED) {
+        // Device is wedged - recovery action needed
+    }
+    
+    if (extendedState.flags & ${S}_DEVICE_EXT_STATE_FLAGS_SURVIVABILITY) {
+        // Device is in survivability mode
+    }
+    
+    if (extendedState.flags & ${S}_DEVICE_EXT_STATE_FLAGS_FLASH_OVERRIDE) {
+        // Device has flash override enabled
+    }

scripts/sysman/common.yml

@@ -285,6 +285,10 @@ etors:
       value: "0x00020017"
       desc: $s_oem_serial_id_ext_properties_t
       version: "1.17"
+    - name: DEVICE_EXT_STATE
+      value: "0x00020018"
+      desc: $s_device_ext_state_t
+      version: "1.17"
 --- #-------------------------------------------------------------------------
 type: struct
 desc: "Base for all properties types"

scripts/sysman/device.yml

@@ -104,7 +104,7 @@ etors:
       desc: "Apply FLR reset"
 --- #--------------------------------------------------------------------------
 type: struct
-desc: "Device state"
+desc: "Device state. To retrieve the current device state, please use $s_device_ext_state_t as pNext."
 class: $sDevice
 name: $s_device_state_t
 base: $s_base_state_t

scripts/sysman/deviceState.yml

@@ -0,0 +1,55 @@
+#
+# Copyright (C) 2026 Intel Corporation
+#
+# SPDX-License-Identifier: MIT
+#
+# See YaML.md for syntax definition
+#
+--- #--------------------------------------------------------------------------
+type: header
+desc: "Intel $OneApi Level-Zero Sysman Extension APIs for Device State"
+version: "1.17"
+--- #--------------------------------------------------------------------------
+type: macro
+desc: "Device State Extension Name"
+version: "1.17"
+name: $S_DEVICE_EXT_STATE_NAME
+value: '"$S_extension_device_state"'
+--- #--------------------------------------------------------------------------
+type: enum
+desc: "Device State Extension Version(s)"
+version: "1.17"
+name: $s_device_ext_state_version_t
+etors:
+    - name: "1_0"
+      value: "$X_MAKE_VERSION( 1, 0 )"
+      desc: "version 1.0"
+--- #--------------------------------------------------------------------------
+type: enum
+desc: "Device state flags"
+version: "1.17"
+class: $sDevice
+name: $s_device_state_ext_flags_t
+etors:
+    - name: NORMAL
+      desc: "The device is operating normally"
+    - name: WEDGED
+      desc: "The device is wedged"
+    - name: SURVIVABILITY
+      desc: "The device is in survivability mode"
+    - name: FLASH_OVERRIDE
+      desc: "The device has flash override enabled"
+--- #--------------------------------------------------------------------------
+type: struct
+desc: "Extension properties for Device State"
+version: "1.17"
+class: $sDevice
+name: $s_device_ext_state_t
+base: $s_base_state_t
+members:
+    - type: $s_device_state_ext_flags_t
+      name: flags
+      desc: "[out] Device state flags. Returns 0 (if state cannot be determined) or a combination of $s_device_state_ext_flags_t"
+details:
+    - "This structure may be returned from $sDeviceGetState via the `pNext` member of $s_device_state_t"
+    - "Provides extended device state information including wedged state, survivability mode, and flash override status"