Attention

You are viewing an older version of the documentation. The latest version is v3.3.

Install Linux Desktop Environment

The ECI core images core-bullseye and core-jammy do not have a graphical desktop environment installed by default, neither do minimal or server variants of Debian/Ubuntu.

To install a graphical desktop environment on your system, do the following:

1. Setup the ECI APT repository.

2. Install the desktop environment Deb packages and dependencies. Run the following commands, replacing the <environment> placeholder with one of the Desktop Environments listed in the following table.

   $ export DEBIAN_FRONTEND=noninteractive
   $ sudo -E apt install task-desktop task-<environment>-desktop
   

   Package	Description
   task-mate-desktop	Installs the MATE Desktop
   task-gnome-desktop	Installs the GNOME Desktop
   task-xfce-desktop	Installs the XFCE Desktop
   task-lxde-desktop	Installs the LXDE Desktop
   task-cinnamon-desktop	Installs the Cinnamon Desktop
   task-kde-desktop	Installs the KDE Desktop

Enable GuC/HuC Firmware Loading

From Gen 9th Intel® Graphics (Skylake and later), Intel introduced Graphics microcontroller (GuC) and HEVC/H.265 microcontroller (HuC), which provide the following functionalities:

• Offloading some media decoding functionality from the CPU to HuC (only applicable if using Intel media driver for hardware video acceleration).

• Low-level graphics context scheduling and context submission (GuC submission).

• Tracking business and making frequency and power gating decisions while scheduling.

To use this functionality, the GuC or HuC firmware must be loaded by setting the kernel module parameters:

i915 Kernel Module Parameters	Description
enable_guc=1	GuC submission and power management
enable_guc=2	HuC authentication only
enable_guc=3	Combine HuC and GuC
enable_guc=7	Combine HuC and GuC and SR-IOV PF mode support ONLY available for i915/*_guc_70.0.3.bin and i915/*_huc_7.9.3.bin on Intel firmware mentioned here for 11th Gen Intel® Core™ U-Series processors and 11th Gen Intel® Core™ P-Series processors [Tiger Lake] and 12th Gen Intel® Core™ S-Series processors and 12th Gen Intel® Core™ P-Series processors [Alder Lake]

For more details, refer to Intel® Graphics for Linux* and Linux gpu/i915.

1. Install GuC and HuC Linux firmware available from the ECI APT repository to follow both the official Linux distribution package release and Out-of-Tree (OOT) SR-IOV Physical Function (PF) mode support.

   $ sudo apt-cache policy firmware-misc-nonfree
   

   For example, on Debian* 11 (Bullseye) distribution, using the ECI APT repository should display:

   firmware-misc-nonfree:
   Installed: 20220209-1-intel-iotg
   Candidate: 20220209-1-intel-iotg
   Version table:
   *** 20220209-1-intel-iotg 1000
         1000 http://192.168.1.171:8080 isar/main amd64 Packages
         100 /var/lib/dpkg/status
      20210315-3 500
         500 http://deb.debian.org/debian bullseye/non-free amd64 Packages
   

   $ sudo apt install firmware-misc-nonfree
   

   Note: On Ubuntu* 22.04 (Jammy), Linux distribution linux-firmware package provides Intel® Graphics GuC and HuC firmware:

   $ sudo apt install linux-firmware
   

2. Enable GuC/HuC firmware loading by adding the i915 kernel module input parameter:

   $ echo "options i915 enable_guc=3"| sudo tee -a /etc/modprobe.d/i915.conf
   

3. After the installation is complete, reboot the system:

   $ sudo reboot
   

   When the system reboots, it should present the graphical desktop environment running Intel® Graphics with HuC / GuC enabled.

   

   Verify that the GuC / HuC modules are enabled:

   $ dmesg | grep i915
   

   ...
   [    5.633743] i915 0000:00:02.0: [drm] GuC firmware i915/tgl_guc_70.0.3.bin version 70.0
   [    5.650994] i915 0000:00:02.0: [drm] GuC submission enabled
   [    5.650996] i915 0000:00:02.0: [drm] GuC SLPC enabled
   [    5.651344] i915 0000:00:02.0: [drm] GuC RC: enabled
   ...
   [    5.633745] i915 0000:00:02.0: [drm] HuC firmware i915/tgl_huc_7.9.3.bin version 7.9
   [    5.649831] i915 0000:00:02.0: [drm] HuC authenticated
   

Note: To know whether an end-user can install Intel® Graphics Compute Runtime for oneAPI Level Zero and OpenCL™ on the Debian 11.x (Bullseye) desktop environment, refer to the tutorial.