---
title: 'DG2 kernel driver installation for Ubuntu23.04'
disqus: hackmd
---

DG2 kernel driver installation for Ubuntu23.04
===
## Table of Contents

[TOC]

## dGPU installation guide

Ref:
https://dgpu-docs.intel.com/installation-guides/ubuntu/ubuntu-focal-arc.html
https://hub.docker.com/r/openvino/ubuntu20_dev
https://github.com/openvinotoolkit/docker_ci/blob/master/configure_gpu_ubuntu20.md
https://github.com/intel-sandbox/atsm-va-sample-demo/blob/main/system-setup.md

Pre-request BIOS settings for DG2/ATS-M
---
* **Intel Advanced Menu -> system Agent configuration -> ABove 4GB MMIO BIOS assignment (Enabled)**

* **Intel Advanced Menu -> system Agent configuration -> PCI Express Configuration -> PCIE Resizeable BAR Support (Enabled)**

Add package repository
---
For all client scenarios you must configure your system to install client (arc) packages. To add the Ubuntu 22.04 client package repository:

set up proxy for host env.

wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | \
  sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
echo "deb [arch=amd64,i386 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu jammy client" | \
  sudo tee /etc/apt/sources.list.d/intel-gpu-jammy.list
sudo apt-get update

Install Compute, Media, and Display runtimes
---

sudo apt-get install -y \
  intel-opencl-icd intel-level-zero-gpu level-zero \
  intel-media-va-driver-non-free libmfx1 libmfxgen1 libvpl2 \
  libegl-mesa0 libegl1-mesa libegl1-mesa-dev libgbm1 libgl1-mesa-dev libgl1-mesa-dri \
  libglapi-mesa libgles2-mesa-dev libglx-mesa0 libigdgmm12 libxatracker2 mesa-va-drivers \
  mesa-vdpau-drivers mesa-vulkan-drivers va-driver-all vainfo hwinfo clinfo

OPTIONAL: Install developer packages
---
If you will be doing development, you may want to install optional development packages. oneAPI users will need to install these packages for some of the oneAPI tools to function correctly:

sudo apt-get install -y \
  libigc-dev intel-igc-cm libigdfcl-dev libigfxcmrt-dev level-zero-dev

> Reboot system to be effective

Verify the installations
---

### Verify the device is working with i915 driver

sudo apt-get install hwinfo
hwinfo --display

Similar information will be showed as below:
>06: PCI 300.0: 0300 VGA compatible controller (VGA)
[Created at pci.386]
Unique ID: svHJ.8TfRU3RHJCA
Parent ID: GA8e.mr2N3fBJq5F
SysFS ID: /devices/pci0000:00/0000:00:01.0/0000:01:00.0/0000:02:01.0/0000:03:00.0
SysFS BusID: 0000:03:00.0
Hardware Class: graphics card
Model: "Intel VGA compatible controller"
Vendor: pci 0x8086 "Intel Corporation"
Device: pci 0x5693
SubVendor: pci 0x144a "Adlink Technology"
SubDevice: pci 0x4700
Revision: 0x05
Driver: "i915"
Driver Modules: "i915"
Memory Range: 0x51000000-0x51ffffff (rw,non-prefetchable)
Memory Range: 0x6000000000-0x60ffffffff (ro,non-prefetchable)
Memory Range: 0x52000000-0x521fffff (ro,non-prefetchable,disabled)
IRQ: 154 (115 events)
Module Alias: "pci:v00008086d00005693sv0000144Asd00004700bc03sc00i00"
Driver Info #0:
Driver Status: i915 is active
Driver Activation Cmd: "modprobe i915"
Config Status: cfg=new, avail=yes, need=no, active=unknown
Attached to: #26 (PCI bridge)

### Verify Media drivers installation

export DISPLAY=:0.0

sudo apt-get install vainfo
vainfo

Similar information will be showed as below:
>libva info: VA-API version 1.19.0
libva info: Trying to open /usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so
libva info: Found init function __vaDriverInit_1_19
libva info: va_openDriver() returns 0
vainfo: VA-API version: 1.19 (libva 2.19.0)
vainfo: Driver version: Intel iHD driver for Intel(R) Gen Graphics - 23.2.4 ()
vainfo: Supported profile and entrypoints

### Verify Computing drivers installation

sudo apt-get install clinfo
clinfo

Similar information will be showed as below:
>Number of platforms 2
Platform Name Intel(R) OpenCL HD Graphics
Platform Vendor Intel(R) Corporation
Platform Version OpenCL 3.0
Platform Profile FULL_PROFILE

### Verify 3D drivers installation
Below verification needs a running desktop UI on top of your Linux distribution.

sudo apt install mesa-utils
glxinfo |grep OpenGL

Similar information will be showed as below:
>OpenGL vendor string: Intel
OpenGL renderer string: Mesa Intel(R) Graphics (DG2)
OpenGL core profile version string: 4.6 (Core Profile) Mesa 22.2.0-devel (git-44289c46d9)
OpenGL core profile shading language version string: 4.60
OpenGL core profile context flags: (none)
OpenGL core profile profile mask: core profile
OpenGL core profile extensions:
OpenGL version string: 4.6 (Compatibility Profile) Mesa 22.2.0-devel (git-44289c46d9)

###### tags: `DG2` `BKC` `kernel` `installation`