Intel Video: Difference between revisions

Latest revision as of 04:58, 9 May 2025

This page documents the graphics driver for Intel GMA on-board graphics cards and Intel iGPU and dedicated graphics cards (excluding PowerVR-based models). Install the following packages as needed:

mesa-dri-gallium: necessary Mesa drivers for all Intel Graphics.
mesa-va-gallium: Mesa vaapi drivers for all Intel video decoding acceleration.

You may want one of the below too. Enable community repository before proceeding further.

intel-media-driver: VAAPI driver, for hardware accelerated video encoding and decoding. What you want since Intel Broadwell.
libva-intel-driver: VAAPI driver, for processors older than Broadwell.
linux-firmware-i915: Needed if the i915 driver complains about firmware being missing in dmesg

Use environment variables

For all Intel Graphics up to Haswell, the user must manually select crocus Mesa driver in order to let the graphics work properly:

export MESA_LOADER_DRIVER_OVERRIDE=crocus

For newer Intel Graphics, if automatic driver selection does not work and bugs such as missing mouse cursor under Sway occur (no hardware graphics acceleration), the user can manually select iris driver:

export MESA_LOADER_DRIVER_OVERRIDE=iris

Legacy drivers

Legacy drivers like xf86-video-intel which have known Issues. Use these, only if nothing else works.

@@ Line 1: / Line 1: @@
-The following instructions are for modern Intel GPU chipsets covered by the i915 driver.
+This page documents the graphics driver for Intel GMA on-board graphics cards and Intel iGPU and dedicated graphics cards (excluding [https://en.wikipedia.org/wiki/List_of_Intel_graphics_processing_units#PowerVR_based PowerVR-based models]). Install the following packages as needed:
-See [[#Known working configurations]].
-== Setup Xorg/udev ==
+* {{Pkg|mesa-dri-gallium}}: '''necessary''' Mesa drivers for all Intel Graphics.
+* {{Pkg|mesa-va-gallium}}: Mesa vaapi drivers for all Intel video decoding acceleration.
-# Run the [[Alpine setup scripts#setup-xorg-base|setup-xorg-base]] script.
+You may want one of the below too. [[Repositories#Managing_repositories|Enable]] community repository before proceeding further.
-# Install the Xorg Intel video drivers: {{Cmd|apk add xf86-video-intel}}
+* {{Pkg|intel-media-driver}}: VAAPI driver, for hardware accelerated video encoding and decoding. What you want since Intel Broadwell.
-# Enable [[#Kernel Modesetting (KMS)]]. Specifically, the <code>fbcon</code> module is necessary, or leaving Xorg (via <code>Ctrl+Alt+F1</code> or quitting) will result in a black screen until the machine is power cycled. If you have already launch Xorg and don't want to experience this effect, you can <code>modprobe fbcon</code> while Xorg is running.
+* {{Pkg|libva-intel-driver}}: VAAPI driver, for processors older than Broadwell.
+* {{Pkg|linux-firmware-i915}}: Needed if the i915 driver complains about firmware being missing in dmesg
-== Kernel Modesetting (KMS) ==
+== Use environment variables ==
-To enable KMS at boot:
+For all Intel Graphics up to Haswell, the user must manually select '''crocus''' Mesa driver in order to let the graphics work properly:
-# Add the <code>i915</code> and <code>fbcon</code> modules to {{Path|/etc/modules}}: {{Cmd|$ echo i915 >> /etc/modules<br />$ echo fbcon >> /etc/modules}}
-# Install <code>mkinitfs</code>: {{Cmd|apk add mkinitfs}}
-# Enable the <code>kms</code> feature in the <code>mkinitfs</code> configuration by adding it to the <var>features</var> variable, e.g., {{cat|/etc/mkinitfs/mkinitfs.conf|features{{=}}"keymap cryptsetup kms ata base ide scsi usb virtio ext4"}}
-# Run <code>mkinitfs</code>.
-# Reboot to test the configuration.
-== Known working configurations ==
+<pre>
+export MESA_LOADER_DRIVER_OVERRIDE=crocus
+</pre>
-; Lenovo X1 Carbon (1st gen), <code>sys</code> installation
+For newer Intel Graphics, if automatic driver selection does not work and bugs such as missing mouse cursor under [[Sway]] occur (no hardware graphics acceleration), the user can manually select '''iris''' driver:
-<pre style="white-space: pre-wrap; word-wrap: break-word;"># lspci -s 02 -v
-:02.0 VGA compatible controller: Intel Corporation 3rd Gen Core processor Graphics Controller (rev 09) (prog-if 00 [VGA controller])
+<pre>
-        Subsystem: Lenovo Device 21f9
+export MESA_LOADER_DRIVER_OVERRIDE=iris
-        Flags: bus master, fast devsel, latency 0, IRQ 28
-        Memory at f0000000 (64-bit, non-prefetchable) [size=4M]
-        Memory at e0000000 (64-bit, prefetchable) [size=256M]
-        I/O ports at 4000 [size=64]
-        Expansion ROM at <unassigned> [disabled]
-        Capabilities: [90] MSI: Enable+ Count=1/1 Maskable- 64bit-
-        Capabilities: [d0] Power Management version 2
-        Capabilities: [a4] PCI Advanced Features
-        Kernel driver in use: i915
 </pre>
+== Legacy drivers ==
+{{Main|Xorg}}
+Legacy drivers like {{Pkg|xf86-video-intel}} which have [https://wiki.archlinux.org/title/Intel_graphics#Installation known Issues]. Use these, only if nothing else works.
+== See also ==
+* [[Kernel Modesetting]]
+* [https://wiki.archlinux.org/index.php/Intel_graphics Intel graphics on Arch Linux wiki]
+[[Category:Drivers]]
+[[Category:Graphics]]