Skip to content

Commit 7c49e17

Browse files
mripard6by9
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 905d3e0 commit 7c49e17

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
@@ -160,12 +160,14 @@ correspondence between them.
160160

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

170172
Packed RGB Formats
171173
^^^^^^^^^^^^^^^^^^

0 commit comments

Comments
 (0)