===== Intel Integrated Graphics (aka HD Graphics) =====

Intel HD Graphics refers to the class of graphics chips that are integrated on the same die as an Intel CPU.  [[https://en.wikipedia.org/wiki/Intel_Graphics_Technology|This]] Wikipedia entry provides a good overview of the various variations and names used for generations of Intel HD Graphics.  You will find Intel HD Graphics chips on many modern laptop and desktop systems that ship with an Intel processor.

:!: The tables included are **not** an exhaustive list of supported hardware. Hardware is only listed if and when it has been explicitly tested/confirmed by developers and/or users. Graphics hardware missing from these tables may or may not work. If you have tested hardware that is not on the list, please [[#Reporting|report the results]].

<callout type="warning">
**About GPU codenames vs. marketing names**

The entries below are misleading because they use the marketing names as the "key". This table needs to be rewritten using GPU codenames as the key.
</callout>

==== Hardware Support ====

Starting with %%FreeBSD%% 12.0-RELEASE, there are two generations of support for this platform:

  * ''%%drm-kmod%%''
  * ''%%drm-legacy-kmod%%''

Both are supplied as ports, and provide a kernel module to enable the integrated graphics chip on Intel CPUs.  Generally speaking if you have a system with one of these graphics adapters it is suggested to install the ''%%drm-kmod%%'' metaport, which should work well on systems starting with the **Broadwell** generation.  This code is under active development and allows us to track more closely the drivers present in the Linux kernel.  For **Haswell** based systems, if the ''%%drm-kmod%%'' port does not work, it is suggested to install the ''%%drm-legacy-kmod%%''.  This is based on our previous code that matched the Linux 3.8 kernel drivers.

[[Graphics/Intel-GPU-Matrix|This page]] contains a table should illustrate the state of various Intel chipsets.

Furthermore, if you notice high CPU usage or excessive tearing while viewing HD video it is reported that installing the ''%%libva-intel-driver%%'' is helpful, as it enables VAAPI support on these systems.  This package should be installed in addition to the ''%%drm-kmod%%'', ''%%mesa-libs%%'' and ''%%mesa-dri%%'' packages.

=== Example Configuration For Post Broadwell System ===

A common configuration is a user who has an Intel laptop with a Kabylake Intel ''%%i915%%'' HD Graphics chip.  To enable the chipset one would follow these instructions:

  * Install the [[https://www.freshports.org/graphics/drm-kmod/|drm-kmod]] package ''%%$ sudo pkg install drm-kmod%%''

  * Take note of the post-install package message as it contains important information - specifically add this to your /etc/rc.conf or /etc/rc.conf.d/intel file: ''%%kld_list="/boot/modules/i915kms.ko"%%''

  * Ensure that your UID is a member of the ''%%video%%'' group:
    * ''%%pw groupmod wheel -m <youruser>%%''

  * Restart your system; you should see the i915kms.ko get loaded and a flash on your console as we switch over to the new display driver.

  * Start Xorg via your usual method (i.e. startx, GDM, etc.)

**Note:** For systems that are able to take advantage of this updated DRM code you do not need to prepare an xorg.conf configuration file, and installing the ''%%xf86-video-intel%%'' port is optional.  Our Xorg should autodetect the driver, and utilize the [[https://www.x.org/wiki/ModeSetting/|modesetting]] Xorg driver and [[https://www.freedesktop.org/wiki/Software/Glamor/|glamor]] driver.