Skip to content

Commit 6ab3828

Browse files
mripardpopcornmix
authored andcommitted
media: uapi: Clarify MBUS color component order for serial buses
Upstream series https://lore.kernel.org/linux-media/[email protected]/ 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 <[email protected]>
1 parent 852ab9e commit 6ab3828

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

Documentation/userspace-api/media/v4l/subdev-formats.rst

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -161,12 +161,14 @@ correspondence between them.
161161

162162
The media bus pixel codes document parallel formats. Should the pixel data be
163163
transported over a serial bus, the media bus pixel code that describes a
164-
parallel format that transfers a sample on a single clock cycle is used. For
165-
instance, both MEDIA_BUS_FMT_BGR888_1X24 and MEDIA_BUS_FMT_BGR888_3X8 are used
166-
on parallel busses for transferring an 8 bits per sample BGR data, whereas on
167-
serial busses the data in this format is only referred to using
168-
MEDIA_BUS_FMT_BGR888_1X24. This is because there is effectively only a single
169-
way to transport that format on the serial busses.
164+
parallel format that transfers a sample on a single clock cycle is used. The
165+
color component order used is the same used on the serial bus. For instance,
166+
both MEDIA_BUS_FMT_BGR888_1X24 and MEDIA_BUS_FMT_BGR888_3X8 are used on parallel
167+
busses for transferring an 8 bits per sample BGR data, whereas on serial busses
168+
the data in this format is only referred to using MEDIA_BUS_FMT_BGR888_1X24,
169+
with BGR meaning that the blue component is transmitted first, then green, then
170+
red. This is because there is effectively only a single way to transport that
171+
format on the serial busses.
170172

171173
Packed RGB Formats
172174
^^^^^^^^^^^^^^^^^^

0 commit comments

Comments
 (0)