Implementing HDMI 2.1 FRL Support in the AMDGPU Linux Driver: A Developer's Guide

Overview

HDMI 2.1 brings a significant leap in bandwidth capabilities, enabling higher resolutions and refresh rates such as 4K at 120Hz or even 8K at 60Hz. A key component of this standard is Fixed Rate Link (FRL), which replaces the older Transition Minimized Differential Signaling (TMDS) to achieve the necessary data rates. AMD has recently submitted official patches to introduce HDMI FRL support in their AMDGPU kernel graphics driver, an essential step toward full HDMI 2.1 compliance on Linux systems. This guide walks through the patches, their purpose, how to apply them, and what to expect from the initial implementation.

Prerequisites

Before diving into the patches, ensure you have the following:

• A working Linux development environment with kernel build tools installed (gcc, make, flex, bison, libelf-dev, etc.)
• Access to the Linux kernel source tree (at least version 5.12 or later, where AMDGPU driver is actively maintained)
• An AMD Radeon graphics card that physically supports HDMI 2.1 (e.g., RDNA2 or newer architectures)
• Basic familiarity with kernel compilation and patching
• Patience: these are early-stage patches, not a final, polished feature

Step-by-Step Instructions

1. Retrieve the Patches

The patches were posted on the dri-devel mailing list by AMD engineers. They are not yet merged into mainline, so you need to fetch them directly. Use git am to apply them to your kernel source. For demonstration, assume you have downloaded the patch series as a single file or multiple .patch files.

cd /path/to/linux-source
# If patches are in a series file:
git am --signoff < patch-series.mbox
# Or apply individually:
git apply 0001-drm-amd-display-Add-HDMI-FRL-support.patch
git apply 0002-drm-amd-display-Add-HDMI-FRL-compute.patch
...

2. Understand the Key Changes

The patches modify several areas of the AMDGPU display driver:

• New FRL state machine: Addition of a finite state machine that handles link training for FRL modes (2, 3, or 4 lanes at higher bit rates).
• PHY configuration: Updates to the physical layer (PHY) to support FRL signaling voltages and equalization.
• Display mode validation: Enhanced logic to switch between TMDS (legacy) and FRL based on monitor capabilities and resolution/refresh requirements.
• Infoframe updates: HDMI 2.1 requires new Dynamic HDR metadata and FRL-specific infoframes.

These changes are primarily in drivers/gpu/drm/amd/display/ and drivers/gpu/drm/amd/display/dc/ directories.

3. Build the Modified Kernel

After applying patches, configure and compile the kernel.

make menuconfig
# Ensure CONFIG_DRM_AMDGPU is enabled (Device Drivers -> Graphics support -> AMD GPU)
# You may need to enable HDMI 2.1 support if a new Kconfig option appears
make -j$(nproc)
make modules_install
make install

Reboot into the new kernel.

4. Verify FRL Activation

Check dmesg for FRL-related messages. You should see lines indicating FRL training, such as:

[drm] FRL link training succeeded for connector HDMI-A-1
[drm] FRL mode: 4 lanes, 12 Gbps per lane

Use cat /sys/kernel/debug/dri/0/amdgpu_dm_connector_info (or similar debugfs path) to inspect link status.

5. Test with a Compatible Display

Connect a monitor that supports HDMI 2.1 and set a high refresh rate (e.g., 4K@120Hz) via your desktop environment or xrandr. If successful, you'll achieve the higher bandwidth without falling back to display stream compression (DSC) unless needed.

xrandr --output HDMI-1 --mode 3840x2160 --rate 120

Monitor /var/log/Xorg.0.log or journalctl -xe for any warnings.

Common Mistakes

Applying Patches Out of Order

The patch series has dependencies. Applying them in the wrong sequence can lead to conflicts. Always apply in the order posted, or use a git am on the whole mbox file.

Missing Firmware Blobs

HDMI 2.1 may require updated firmware for the display engine. Check linux-firmware package for AMD GPU firmware (e.g., amdgpu/navi10_*). If missing, the driver may fall back to TMDS.

Incorrect Kconfig Settings

The patches might introduce a new config option (e.g., CONFIG_DRM_AMD_DC_HDMI21). Ensure it is enabled in your kernel config.

Trying on Unsupported Hardware

Older AMD GPUs (pre-RDNA2) do not have the PHY capabilities for FRL. The patch will ignore them, but you might see error messages. Verify your hardware supports HDMI 2.1 physically.

Summary

AMD's official HDMI 2.1 FRL patches for the AMDGPU Linux driver mark a significant step toward complete HDMI 2.1 support on Linux. While still early and not yet in mainline, developers can apply them to gain preliminary FRL functionality on compatible hardware. The implementation includes a new state machine, PHY changes, and mode validation. By following the steps above—fetching patches, building the kernel, and testing with an HDMI 2.1 display—you can contribute to testing and feedback. Common pitfalls include patch ordering, missing firmware, and hardware limitations. As the patches mature, expect full HDMI 2.1 support to eventually land in the upstream kernel.