raspi/linux
1
0
Fork 1
mirror of https://github.com/raspberrypi/linux.git synced 2025-12-06 18:09:56 +00:00
Code Issues Projects Releases Wiki Activity

media: uapi: Clarify MBUS color component order for serial buses

Browse Source 
Upstream series https://lore.kernel.org/linux-media/20250917-csi-bgr-rgb-v3-0-0145571b3aa4@kernel.org/

The subdev format documentation has a subsection describing how to use
the media bus pixel codes for serial buses. While it describes the
sampling part well, it doesn't really describe the current convention
used for the components order.

Let's improve that.

Signed-off-by: Maxime Ripard <mripard@kernel.org>
This commit is contained in:
Maxime Ripard
2025-09-17 13:16:11 +02:00
committed by Dom Cobley
parent 15fee9f5f0
commit 8270057a6b
1 changed files with 8 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
Documentation/userspace-api/media/v4l/subdev-formats.rst
View File

@@ -160,12 +160,14 @@ correspondence between them.
The media bus pixel codes document parallel formats. Should the pixel data be The media bus pixel codes document parallel formats. Should the pixel data be
transported over a serial bus, the media bus pixel code that describes a transported over a serial bus, the media bus pixel code that describes a
parallel format that transfers a sample on a single clock cycle is used. For parallel format that transfers a sample on a single clock cycle is used. The
instance, both MEDIA_BUS_FMT_BGR888_1X24 and MEDIA_BUS_FMT_BGR888_3X8 are used color component order used is the same used on the serial bus. For instance,
on parallel busses for transferring an 8 bits per sample BGR data, whereas on both MEDIA_BUS_FMT_BGR888_1X24 and MEDIA_BUS_FMT_BGR888_3X8 are used on parallel
serial busses the data in this format is only referred to using busses for transferring an 8 bits per sample BGR data, whereas on serial busses
MEDIA_BUS_FMT_BGR888_1X24. This is because there is effectively only a single the data in this format is only referred to using MEDIA_BUS_FMT_BGR888_1X24,
way to transport that format on the serial busses. with BGR meaning that the blue component is transmitted first, then green, then
red. This is because there is effectively only a single way to transport that
format on the serial busses.
Packed RGB Formats Packed RGB Formats
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^