linux.git/include/uapi/drm/drm_mode.h, branch v7.1

drm: Add CRTC background color property

2026-03-18T09:59:57+00:00

Some display controllers can be hardware programmed to show non-black
colors for pixels that are either not covered by any plane or are
exposed through transparent regions of higher planes.  This feature can
help reduce memory bandwidth usage, e.g. in compositors managing a UI
with a solid background color while using smaller planes to render the
remaining content.

To support this capability, introduce the BACKGROUND_COLOR standard DRM
mode property, which can be attached to a CRTC through the
drm_crtc_attach_background_color_property() helper function.

Additionally, define a 64-bit ARGB format value to be built with the
help of a couple of dedicated DRM_ARGB64_PREP*() helpers.  Individual
color components can be extracted with desired precision using the
corresponding DRM_ARGB64_GET*() macros.

Co-developed-by: Matt Roper 
Signed-off-by: Matt Roper 
Reviewed-by: Nícolas F. R. A. Prado 
Tested-by: Diederik de Haas 
Signed-off-by: Cristian Ciocaltea 
Link: https://patch.msgid.link/20260303-rk3588-bgcolor-v8-2-fee377037ad1@collabora.com
Signed-off-by: Daniel Stone

drm/connector: Add a new 'panel_type' property

2026-01-27T18:57:24+00:00

If the driver can make an assertion whether a connected panel is an OLED
panel or not then it can attach a property to the connector that userspace
can use as a hint for color schemes.

Reviewed-by: Leo Li 
Link: https://patch.msgid.link/20260106170017.68158-2-superm1@kernel.org
Signed-off-by: Mario Limonciello (AMD)

drm/colorop: Add 3D LUT support to color pipeline

2025-11-26T22:09:42+00:00

It is to be used to enable HDR by allowing userpace to create and pass
3D LUTs to kernel and hardware.

new drm_colorop_type: DRM_COLOROP_3D_LUT.

Reviewed-by: Simon Ser 
Signed-off-by: Alex Hung 
Reviewed-by: Daniel Stone 
Reviewed-by: Melissa Wen 
Reviewed-by: Sebastian Wick 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-46-alex.hung@amd.com

drm/colorop: Define LUT_1D interpolation

2025-11-26T22:09:14+00:00

We want to make sure userspace is aware of the 1D LUT
interpolation. While linear interpolation is common it
might not be supported on all HW. Give driver implementers
a way to specify their interpolation.

Reviewed-by: Simon Ser 
Signed-off-by: Alex Hung 
Signed-off-by: Harry Wentland 
Reviewed-by: Daniel Stone 
Reviewed-by: Melissa Wen 
Reviewed-by: Sebastian Wick 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-44-alex.hung@amd.com

drm/colorop: Add multiplier type

2025-11-26T22:03:35+00:00

This introduces a new drm_colorop_type: DRM_COLOROP_MULTIPLIER.

It's a simple multiplier to all pixel values. The value is
specified via a S31.32 fixed point provided via the
"MULTIPLIER" property.

Reviewed-by: Simon Ser 
Signed-off-by: Alex Hung 
Reviewed-by: Daniel Stone 
Reviewed-by: Melissa Wen 
Reviewed-by: Sebastian Wick 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-41-alex.hung@amd.com

drm/colorop: Add 1D Curve Custom LUT type

2025-11-26T22:03:35+00:00

We've previously introduced DRM_COLOROP_1D_CURVE for
pre-defined 1D curves. But we also have HW that supports
custom curves and userspace needs the ability to pass
custom curves, aka LUTs.

This patch introduces a new colorop type, called
DRM_COLOROP_1D_LUT that provides a SIZE property which
is used by a driver to advertise the supported SIZE
of the LUT, as well as a DATA property which userspace
uses to set the LUT.

DATA and size function in the same way as current drm_crtc
GAMMA and DEGAMMA LUTs.

Reviewed-by: Simon Ser 
Signed-off-by: Alex Hung 
Co-developed-by: Harry Wentland 
Signed-off-by: Harry Wentland 
Reviewed-by: Daniel Stone 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-38-alex.hung@amd.com

drm: Add Enhanced LUT precision structure

2025-11-26T22:03:35+00:00

Existing LUT precision structure drm_color_lut has only 16 bit
precision. This is not enough for upcoming enhanced hardwares
and advance usecases like HDR processing. Hence added a new
structure with 32 bit precision values.

Signed-off-by: Alex Hung 
Signed-off-by: Uma Shankar 
Signed-off-by: Chaitanya Kumar Borah 
Reviewed-by: Sebastian Wick 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-36-alex.hung@amd.com

drm/colorop: Add 3x4 CTM type

2025-11-26T22:03:33+00:00

This type is used to support a 3x4 matrix in colorops. A 3x4
matrix uses the last column as a "bias" column. Some HW exposes
support for 3x4. The calculation looks like:

 out   matrix    in
 |R|   |0  1  2  3 |   | R |
 |G| = |4  5  6  7 | x | G |
 |B|   |8  9  10 11|   | B |
                       |1.0|

This is also the first colorop where we need a blob property to
program the property. For that we'll introduce a new DATA
property that can be used by all colorop TYPEs requiring a
blob. The way a DATA blob is read depends on the TYPE of
the colorop.

We only create the DATA property for property types that
need it.

Reviewed-by: Simon Ser 
Reviewed-by: Louis Chauvet 
Signed-off-by: Alex Hung 
Signed-off-by: Harry Wentland 
Reviewed-by: Daniel Stone 
Reviewed-by: Melissa Wen 
Reviewed-by: Sebastian Wick 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-19-alex.hung@amd.com

drm/colorop: Add TYPE property

2025-11-26T22:03:31+00:00

Add a read-only TYPE property. The TYPE specifies the colorop
type, such as enumerated curve, 1D LUT, CTM, 3D LUT, PWL LUT,
etc.

For now we're only introducing an enumerated 1D LUT type to
illustrate the concept.

Reviewed-by: Simon Ser 
Reviewed-by: Louis Chauvet 
Signed-off-by: Alex Hung 
Signed-off-by: Harry Wentland 
Reviewed-by: Daniel Stone 
Reviewed-by: Melissa Wen 
Reviewed-by: Sebastian Wick 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-6-alex.hung@amd.com

drm/colorop: Introduce new drm_colorop mode object

2025-11-26T22:03:30+00:00

This patches introduces a new drm_colorop mode object. This
object represents color transformations and can be used to
define color pipelines.

We also introduce the drm_colorop_state here, as well as
various helpers and state tracking bits.

Reviewed-by: Simon Ser 
Signed-off-by: Alex Hung 
Signed-off-by: Harry Wentland 
Reviewed-by: Daniel Stone 
Reviewed-by: Melissa Wen 
Reviewed-by: Sebastian Wick 
Signed-off-by: Simon Ser 
Link: https://patch.msgid.link/20251115000237.3561250-5-alex.hung@amd.com