Skip to content

Latest commit

 

History

History
156 lines (123 loc) · 5.08 KB

README_vanilla.md

File metadata and controls

156 lines (123 loc) · 5.08 KB
Raw

Supported Vanilla LTS kernels

This repository contains the 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

Our current backport supports the following Vanilla LTS kernels.

OS Distribution Kernel Version
Vanilla 6.6 LTS
Vanilla 6.1 LTS
Vanilla 5.15 LTS
Vanilla 5.10 LTS

Prerequisite

Debian based package:

We have dependencies on the following packages

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

RPM based package:

We have dependencies on the following packages:

  • make
  • lsb-release
  • rpm-build
  • glibc-devel
  • flex
  • bison
  • gawk
$ sudo dnf install make glibc-devel lsb-release rpm-build bison flex gawk

For DKMS modules, we need to install dkms package too.

$ sudo apt install dkms
or
$ sudo dnf install dkms

Dependencies

These drivers have a dependency on Intel® GPU firmware and few more kernel mode drivers may be needed based on specific use cases, platforms, and distributions. The source code of additional drivers should be available at Intel GPU

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

Package creation

We have 2 kinds of backport packages, depending on the target OS Kernel version

  • Build with i915 and drm. Ex: Vanilla 5.10 LTS
  • Build with i915 alone. Ex: Vanilla 6.6 LTS

Both Debian based and rpm based packages are supported.

OS Distribution Kernel Version DKMS Package Target (RPM/Debian) Binary Package Target (RPM/Debian)
Vanilla 6.6 LTS i915dkmsrpm-pkg / i915dkmsdeb-pkg binrpm-pkg / i915bindeb-pkg
Vanilla 6.1 LTS i915dkmsrpm-pkg / i915dkmsdeb-pkg binrpm-pkg / i915bindeb-pkg
Vanilla 5.15 LTS i915dkmsrpm-pkg / i915dkmsdeb-pkg binrpm-pkg / i915bindeb-pkg
Vanilla 5.10 LTS dkmsrpm-pkg / dkmsdeb-pkg binrpm-pkg / i915bindeb-pkg

Dynamic Kernel Module Support(DKMS)

Creating i915 DKMS packages

$ make <Build Options> <DKMS Package Target>

Example:
	$ make i915dkmsdeb-pkg

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

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

DKMS Kernel Headers Requirement

The kernel header used at the time of backporting may not be compatible with the latest version at the time of installation which can lead to installation issues. Please refer Version file to check value of VANILLA_6.6LTS_KERNEL_VERSION VANILLA_6.1LTS_KERNEL_VERSION or VANILLA_5.15LTS_KERNEL_VERSION or VANILLA_5.10LTS_KERNEL_VERSION for Vanilla. It will point to the kernel version which is being used during backporting.

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

Binary package creation:

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

$ make KLIB=<Header Path> KLIB_BUILD=<Header Path>/build/ <Binary Package Target>

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

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

Above command will create Debian package in parent folder. intel-i915-<release version>.<kernel-version>.deb

Vanilla 5.10LTS:

Prerequisite

dmabuf backport will be added in package so we need to disable loading of base kernel dmabuf using kernel command line. "initcall_blacklist=sync_debugfs_init,dma_buf_init".

Build Options

Build options provide a list of different arguments which can be passed during package creation or build.

Please refer to README_common for the full list of Build options.

Installation and Verification

$ sudo dpkg -i intel-i915*.deb

or

$ sudo rpm -ivh intel-i915*.rpm

Reboot the device after installation of all packages.

$ sudo reboot

For 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

Please refer to README_backport_version for different verification processes.

Uninstallation

$ sudo dpkg -r intel-i915*

or

$ sudo rpm -e intel-i915*

Reboot the device after uninstallation of all packages.

$ sudo reboot