Xe Device Wedging

Xe driver uses drm device wedged uevent as documented inUserland interfaces.When device is in wedged state, every IOCTL will be blocked and GT cannotbe used. The conditions under which the driver declares the device wedgeddepend on the wedged mode configuration (seeenumxe_wedged_mode). Thedefault recovery method for a wedged state is rebind/bus-reset.

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

Case: Firmware Flash

Identification Hint

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

Recovery Procedure

OnceWEDGED=vendor-specific drm device wedged uevent is received, followthe 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 flashfirmware and restore device to normal operation.