Xe Device Wedging

Xe driver uses drm device wedged uevent as documented in Userland interfaces. When device is in wedged state, every IOCTL will be blocked and GT cannot be used. The conditions under which the driver declares the device wedged depend on the wedged mode configuration (see enum xe_wedged_mode). The default recovery method for a wedged state is rebind/bus-reset.

Another recovery method is vendor-specific. Below are the cases that send WEDGED=vendor-specific recovery method in drm device wedged uevent.

Case: Firmware Flash

Identification Hint

WEDGED=vendor-specific drm device wedged uevent with Runtime Survivability mode is used to notify admin/userspace consumer about the need for a firmware flash.

Recovery Procedure

Once WEDGED=vendor-specific drm device wedged uevent is received, follow the below steps

  • Check Runtime Survivability mode sysfs. If enabled, firmware flash is required to recover the device.

    /sys/bus/pci/devices/<device>/survivability_mode

  • Admin/userspace consumer can use firmware flashing tools like fwupd to flash firmware and restore device to normal operation.

GPU Health Indicator

On Intel Xe platforms that support the gpu health indicator interface, the driver exposes this sysfs attribute for in-band access to the gpu health state:

/sys/bus/pci/devices/<device>/gpu_health

Reading the attribute is available to all users and returns a single line containing the current gpu health state, whereas writing is restricted to administrative users and updates the state to one of the valid values.

Management tools and administrators use this interface to query the current gpu health state (e.g. for telemetry/monitoring) and to update it - for example, to mark the gpu as warning or critical after diagnostics, or reset it back to ok once remediated.

The valid values for the gpu health state are:

  • ok

    The gpu is healthy and operating within normal parameters.

  • warning

    The gpu is experiencing minor issues but remains operational.

  • critical

    The gpu is in a critical state and may not be operational.

See ABI file testing/sysfs-driver-intel-xe-ras for the ABI specification.