Skip to content

Latest commit

 

History

History
139 lines (107 loc) · 4.5 KB

README_ubuntu.md

File metadata and controls

139 lines (107 loc) · 4.5 KB
Raw

Ubuntu Supported OS Kernel/Distribution

Our current backport supports the following OS Distribution.

OS Distribution OS Version Kernel Version
Ubuntu® 22.04 Desktop 6.2 generic
22.04 Server 5.15 generic

The kernel header used at the time of backporting may not be compatible with the latest version at the time of installation. Please refer Version file to check value of UBUNTU_22.04_DESKTOP_KERNEL_VERSION/UBUNTU_22.04_SERVER_KERNEL_VERSION for Ubuntu. It will point to the kernel version which is being used during backporting.

In case of an issue with the latest kernel, please install the kernel version mentioned in version file for appropriate OS version.

Ubuntu 22.04 Desktop:

$sudo apt install linux-headers-<UBUNTU_22.04_DESKTOP_KERNEL_VERSION> \
linux-image-unsigned-<UBUNTU_22.04_DESKTOP_KERNEL_VERSION>

Example:
       $sudo apt install linux-headers-6.2.0-26-generic \
       linux-image-unsigned-6.2.0-26-generic

Ubuntu 22.04 Server:

$sudo apt install linux-headers-<UBUNTU_22.04_SERVER_KERNEL_VERSION>\
linux-image-unsigned-<UBUNTU_22.04_SERVER_KERNEL_VERSION>

Example:
       $sudo apt install linux-headers-5.15.0-41-generic\
       linux-image-unsigned-5.15.0-41-generic

Please note that dkms installation will skip if the kernel headers are not installed.

Prerequisite

We have dependencies on the following packages

  • dkms
  • make
  • debhelper
  • devscripts
  • build-essential
  • flex
  • bison
  • mawk
$sudo apt install dkms make debhelper devscripts build-essential flex bison mawk

For dkms modules, we need to install dkms package also.

$sudo apt install dkms

Out of tree kernel drivers

This repository contains following drivers.

  1. Intel® Graphics Driver Backports(i915) - The main graphics driver (includes a compatible DRM subsystem and dmabuf if necessary)
  2. Intel® Converged Security Engine(cse) - Converged Security Engine
  3. Intel® Platform Monitoring Technology(pmt/vsec) - Intel Platform Telemetry

Dependencies

These drivers have dependency on Intel® GPU firmware and few more kernel mode drivers may be needed based on specific use cases, platform, and distributions. Source code of additional drivers should be available at https://github.com/intel-gpu

Each project is tagged consistently, so when pulling these repos, pull the same tag.

Package creation

Dynamic Kernel Module Support(DKMS)

There are two ways to create i915 dkms packages.

  1. Using default command :
$make i915dkmsdeb-pkg
Example:
        $make i915dkmsdeb-pkg

      Generated package name :
                intel-i915-dkms_1.23.6.24.230425.29+i1-1_all.deb

  1. OS distribution option:

    Adds OS kernel version as part of dkms pacakge name.

$make i915dkmsdeb-pkg OS_DISTRIBUTION=<os_distribution>
Example:
        $make i915dkmsdeb-pkg OS_DISTRIBUTION=UBUNTU_22.04_SERVER

      Generated package name :
		intel-i915-dkms_1.23.6.24.230425.29.5.15.0.53+i1-1_all.deb

Above cmd will create debain package in parent folder. intel-i915-dkms_<release version>.<kernel-version>.deb

Use below help command to get the list of supported os distributions.

$make dkms-pkg-help
To create the package with specific kernel version, pass the supported kernel name to OS_DISTRIBUTION option

##### List of supported osv kernel versions #####
UBUNTU_22.04_SERVER
UBUNTU_22.04_DESKTOP

Binary Package

Creation of binary debian can be done using the below command. By default it will use header of booted kernel, However it can be pointed to other headers via optional KLIB and KLIB_BUILD arguement

$make KLIB=<Header Path> KLIB_BUILD=<Header Path> bindeb-pkg

Exmaple:
$make KLIB=/lib/modules/$(uname -r) KLIB_BUILD=/lib/modules/$(uname -r) bindeb-pkg

Generated Files:
intel-i915-<version>.$(uname -r)-1.x86_64.deb

Installation

$sudo dpkg -i intel-i915*.deb

Reboot the device after installation of all packages.

$sudo reboot

Installation verification

Please grep backport from dmesg after reboot. you should see something like below

> sudo dmesg |grep -i backport
[    5.963854] COMPAT BACKPORTED INIT
[    5.968761] Loading modules backported from I915_23.6.24
[    5.976154] Backport generated by backports.git I915_23.6.24_PSB_230425.29
[    6.069699] [drm] I915 BACKPORTED INIT