4.13.3.4.1. Media Bus Formats¶
-
v4l2_mbus_framefmt
¶
__u32 |
|
Image width in pixels. |
__u32 |
|
Image height in pixels. If |
__u32 |
|
Format code, from enum v4l2_mbus_pixelcode. |
__u32 |
|
Field order, from enum |
__u32 |
|
Image colorspace, from enum |
union { |
(anonymous) |
|
__u16 |
|
Y’CbCr encoding, from enum |
__u16 |
|
HSV encoding, from enum |
} |
||
__u16 |
|
Quantization range, from enum |
__u16 |
|
Transfer function, from enum |
__u16 |
|
flags See: :ref:v4l2-mbus-framefmt-flags |
__u16 |
|
Reserved for future extensions. Applications and drivers must set the array to zero. |
|
0x0001 |
Set by the application. It is only used for source pads and is
ignored for sink pads. If set, then request the subdevice to do
colorspace conversion from the received colorspace to the requested
colorspace values. If the colorimetry field ( To check which conversions are supported by the hardware for the current media bus frame format, see Subdev Media Bus Code Enumerate Flags. |
4.13.3.4.1.1. Media Bus Pixel Codes¶
The media bus pixel codes describe image formats as flowing over physical buses (both between separate physical components and inside SoC devices). This should not be confused with the V4L2 pixel formats that describe, using four character codes, image formats as stored in memory.
While there is a relationship between image formats on buses and image formats in memory (a raw Bayer image won’t be magically converted to JPEG just by storing it to memory), there is no one-to-one correspondence between them.
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 parallel format that transfers a sample on a single clock cycle is used. For instance, both MEDIA_BUS_FMT_BGR888_1X24 and MEDIA_BUS_FMT_BGR888_3X8 are used on parallel busses for transferring an 8 bits per sample BGR data, whereas on serial busses the data in this format is only referred to using MEDIA_BUS_FMT_BGR888_1X24. This is because there is effectively only a single way to transport that format on the serial busses.
4.13.3.4.1.1.1. Packed RGB Formats¶
Those formats transfer pixel data as red, green and blue components. The format code is made of the following information.
The red, green and blue components order code, as encoded in a pixel sample. Possible values are RGB and BGR.
The number of bits per component, for each component. The values can be different for all components. Common values are 555 and 565.
The number of bus samples per pixel. Pixels that are wider than the bus width must be transferred in multiple samples. Common values are 1 and 2.
The bus width.
For formats where the total number of bits per pixel is smaller than the number of bus samples per pixel times the bus width, a padding value stating if the bytes are padded in their most high order bits (PADHI) or low order bits (PADLO). A “C” prefix is used for component-wise padding in the most high order bits (CPADHI) or low order bits (CPADLO) of each separate component.
For formats where the number of bus samples per pixel is larger than 1, an endianness value stating if the pixel is transferred MSB first (BE) or LSB first (LE).
For instance, a format where pixels are encoded as 5-bits red, 5-bits
green and 5-bit blue values padded on the high bit, transferred as 2
8-bit samples per pixel with the most significant bits (padding, red and
half of the green value) transferred first will be named
MEDIA_BUS_FMT_RGB555_2X8_PADHI_BE
.
The following tables list existing packed RGB formats.
Identifier |
Code |
Data organization |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
31 |
30 |
29 |
28 |
27 |
26 |
25 |
24 |
23 |
22 |
21 |
20 |
19 |
18 |
17 |
16 |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
||
MEDIA_BUS_FMT_RGB444_1X12 |
0x1016 |
r3 |
r2 |
r1 |
r0 |
g3 |
g2 |
g1 |
g0 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||
MEDIA_BUS_FMT_RGB444_2X8_PADHI_BE |
0x1001 |
0 |
0 |
0 |
0 |
r3 |
r2 |
r1 |
r0 |
|||||||||||||||||||||||||
g3 |
g2 |
g1 |
g0 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_RGB444_2X8_PADHI_LE |
0x1002 |
g3 |
g2 |
g1 |
g0 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||
0 |
0 |
0 |
0 |
r3 |
r2 |
r1 |
r0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_RGB555_2X8_PADHI_BE |
0x1003 |
0 |
r4 |
r3 |
r2 |
r1 |
r0 |
g4 |
g3 |
|||||||||||||||||||||||||
g2 |
g1 |
g0 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_RGB555_2X8_PADHI_LE |
0x1004 |
g2 |
g1 |
g0 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||
0 |
r4 |
r3 |
r2 |
r1 |
r0 |
g4 |
g3 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_RGB565_1X16 |
0x1017 |
r4 |
r3 |
r2 |
r1 |
r0 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||
MEDIA_BUS_FMT_BGR565_2X8_BE |
0x1005 |
b4 |
b3 |
b2 |
b1 |
b0 |
g5 |
g4 |
g3 |
|||||||||||||||||||||||||
g2 |
g1 |
g0 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_BGR565_2X8_LE |
0x1006 |
g2 |
g1 |
g0 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||||||||||||||||||
b4 |
b3 |
b2 |
b1 |
b0 |
g5 |
g4 |
g3 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_RGB565_2X8_BE |
0x1007 |
r4 |
r3 |
r2 |
r1 |
r0 |
g5 |
g4 |
g3 |
|||||||||||||||||||||||||
g2 |
g1 |
g0 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_RGB565_2X8_LE |
0x1008 |
g2 |
g1 |
g0 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||
r4 |
r3 |
r2 |
r1 |
r0 |
g5 |
g4 |
g3 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_RGB666_1X18 |
0x1009 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||
MEDIA_BUS_FMT_RBG888_1X24 |
0x100e |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||
MEDIA_BUS_FMT_RGB666_1X24_CPADHI |
0x1015 |
0 |
0 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
0 |
0 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
0 |
0 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||
MEDIA_BUS_FMT_BGR888_1X24 |
0x1013 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||
MEDIA_BUS_FMT_BGR888_3X8 |
0x101b |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||||||||||||||||||||
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_GBR888_1X24 |
0x1014 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||
MEDIA_BUS_FMT_RGB888_1X24 |
0x100a |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||
MEDIA_BUS_FMT_RGB888_2X12_BE |
0x100b |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g7 |
g6 |
g5 |
g4 |
|||||||||||||||||||||
g3 |
g2 |
g1 |
g0 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||
MEDIA_BUS_FMT_RGB888_2X12_LE |
0x100c |
g3 |
g2 |
g1 |
g0 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g7 |
g6 |
g5 |
g4 |
|||||||||||||||||||||||
MEDIA_BUS_FMT_RGB888_3X8 |
0x101c |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||||||||||||||||||
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||||||||||||||||||||
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_ARGB888_1X32 |
0x100d |
a7 |
a6 |
a5 |
a4 |
a3 |
a2 |
a1 |
a0 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|
MEDIA_BUS_FMT_RGB888_1X32_PADHI |
0x100f |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
0 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|
MEDIA_BUS_FMT_RGB101010_1X30 |
0x1018 |
0 |
0 |
r9 |
r8 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
The following table list existing packed 36bit wide RGB formats.
Identifier |
Code |
Data organization |
||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
35 |
34 |
33 |
32 |
31 |
30 |
29 |
28 |
27 |
26 |
25 |
24 |
23 |
22 |
21 |
20 |
19 |
18 |
17 |
16 |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
||
MEDIA_BUS_FMT_RGB121212_1X36 |
0x1019 |
r11 |
r10 |
r9 |
r8 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b11 |
b10 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
The following table list existing packed 48bit wide RGB formats.
Identifier |
Code |
Data organization |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
47 |
46 |
45 |
44 |
43 |
42 |
41 |
40 |
39 |
38 |
37 |
36 |
35 |
34 |
33 |
32 |
||||||||||||||||||
31 |
30 |
29 |
28 |
27 |
26 |
25 |
24 |
23 |
22 |
21 |
20 |
19 |
18 |
17 |
16 |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
|||
MEDIA_BUS_FMT_RGB161616_1X48 |
0x101a |
r15 |
r14 |
r13 |
r12 |
r11 |
r10 |
r9 |
r8 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||||||||||
g15 |
g14 |
g13 |
g12 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
b15 |
b14 |
b13 |
b12 |
b11 |
b10 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
On LVDS buses, usually each sample is transferred serialized in seven
time slots per pixel clock, on three (18-bit) or four (24-bit)
differential data pairs at the same time. The remaining bits are used
for control signals as defined by SPWG/PSWG/VESA or JEIDA standards. The
24-bit RGB format serialized in seven time slots on four lanes using
JEIDA defined bit mapping will be named
MEDIA_BUS_FMT_RGB888_1X7X4_JEIDA
, for example.
Identifier |
Code |
Data organization |
|||||
---|---|---|---|---|---|---|---|
Timeslot |
Lane |
3 |
2 |
1 |
0 |
||
MEDIA_BUS_FMT_RGB666_1X7X3_SPWG |
0x1010 |
0 |
d |
b1 |
g0 |
||
1 |
d |
b0 |
r5 |
||||
2 |
d |
g5 |
r4 |
||||
3 |
b5 |
g4 |
r3 |
||||
4 |
b4 |
g3 |
r2 |
||||
5 |
b3 |
g2 |
r1 |
||||
6 |
b2 |
g1 |
r0 |
||||
MEDIA_BUS_FMT_RGB888_1X7X4_SPWG |
0x1011 |
0 |
d |
d |
b1 |
g0 |
|
1 |
b7 |
d |
b0 |
r5 |
|||
2 |
b6 |
d |
g5 |
r4 |
|||
3 |
g7 |
b5 |
g4 |
r3 |
|||
4 |
g6 |
b4 |
g3 |
r2 |
|||
5 |
r7 |
b3 |
g2 |
r1 |
|||
6 |
r6 |
b2 |
g1 |
r0 |
|||
MEDIA_BUS_FMT_RGB888_1X7X4_JEIDA |
0x1012 |
0 |
d |
d |
b3 |
g2 |
|
1 |
b1 |
d |
b2 |
r7 |
|||
2 |
b0 |
d |
g7 |
r6 |
|||
3 |
g1 |
b7 |
g6 |
r5 |
|||
4 |
g0 |
b6 |
g5 |
r4 |
|||
5 |
r1 |
b5 |
g4 |
r3 |
|||
6 |
r0 |
b4 |
g3 |
r2 |
4.13.3.4.1.1.2. Bayer Formats¶
Those formats transfer pixel data as red, green and blue components. The format code is made of the following information.
The red, green and blue components order code, as encoded in a pixel sample. The possible values are shown in Figure 4.8 Bayer Patterns.
The number of bits per pixel component. All components are transferred on the same number of bits. Common values are 8, 10 and 12.
The compression (optional). If the pixel components are ALAW- or DPCM-compressed, a mention of the compression scheme and the number of bits per compressed pixel component.
The number of bus samples per pixel. Pixels that are wider than the bus width must be transferred in multiple samples. Common values are 1 and 2.
The bus width.
For formats where the total number of bits per pixel is smaller than the number of bus samples per pixel times the bus width, a padding value stating if the bytes are padded in their most high order bits (PADHI) or low order bits (PADLO).
For formats where the number of bus samples per pixel is larger than 1, an endianness value stating if the pixel is transferred MSB first (BE) or LSB first (LE).
For instance, a format with uncompressed 10-bit Bayer components
arranged in a red, green, green, blue pattern transferred as 2 8-bit
samples per pixel with the least significant bits transferred first will
be named MEDIA_BUS_FMT_SRGGB10_2X8_PADHI_LE
.
The following table lists existing packed Bayer formats. The data organization is given as an example for the first pixel only.
Identifier |
Code |
Data organization |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
||
MEDIA_BUS_FMT_SBGGR8_1X8 |
0x3001 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||
MEDIA_BUS_FMT_SGBRG8_1X8 |
0x3013 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||
MEDIA_BUS_FMT_SGRBG8_1X8 |
0x3002 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||
MEDIA_BUS_FMT_SRGGB8_1X8 |
0x3014 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||
MEDIA_BUS_FMT_SBGGR10_ALAW8_1X8 |
0x3015 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||
MEDIA_BUS_FMT_SGBRG10_ALAW8_1X8 |
0x3016 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||
MEDIA_BUS_FMT_SGRBG10_ALAW8_1X8 |
0x3017 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||
MEDIA_BUS_FMT_SRGGB10_ALAW8_1X8 |
0x3018 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||
MEDIA_BUS_FMT_SBGGR10_DPCM8_1X8 |
0x300b |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||
MEDIA_BUS_FMT_SGBRG10_DPCM8_1X8 |
0x300c |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||
MEDIA_BUS_FMT_SGRBG10_DPCM8_1X8 |
0x3009 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||||
MEDIA_BUS_FMT_SRGGB10_DPCM8_1X8 |
0x300d |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||||
MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_BE |
0x3003 |
0 |
0 |
0 |
0 |
0 |
0 |
b9 |
b8 |
|||||||||
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||||
MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_LE |
0x3004 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||||
0 |
0 |
0 |
0 |
0 |
0 |
b9 |
b8 |
|||||||||||
MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_BE |
0x3005 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
|||||||||
b1 |
b0 |
0 |
0 |
0 |
0 |
0 |
0 |
|||||||||||
MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_LE |
0x3006 |
b1 |
b0 |
0 |
0 |
0 |
0 |
0 |
0 |
|||||||||
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
|||||||||||
MEDIA_BUS_FMT_SBGGR10_1X10 |
0x3007 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||||
MEDIA_BUS_FMT_SGBRG10_1X10 |
0x300e |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||
MEDIA_BUS_FMT_SGRBG10_1X10 |
0x300a |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||||
MEDIA_BUS_FMT_SRGGB10_1X10 |
0x300f |
r9 |
r8 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||||
MEDIA_BUS_FMT_SBGGR12_1X12 |
0x3008 |
b11 |
b10 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||||
MEDIA_BUS_FMT_SGBRG12_1X12 |
0x3010 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||
MEDIA_BUS_FMT_SGRBG12_1X12 |
0x3011 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||||
MEDIA_BUS_FMT_SRGGB12_1X12 |
0x3012 |
r11 |
r10 |
r9 |
r8 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||||
MEDIA_BUS_FMT_SBGGR14_1X14 |
0x3019 |
b13 |
b12 |
b11 |
b10 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|||
MEDIA_BUS_FMT_SGBRG14_1X14 |
0x301a |
g13 |
g12 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||
MEDIA_BUS_FMT_SGRBG14_1X14 |
0x301b |
g13 |
g12 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|||
MEDIA_BUS_FMT_SRGGB14_1X14 |
0x301c |
r13 |
r12 |
r11 |
r10 |
r9 |
r8 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
|||
MEDIA_BUS_FMT_SBGGR16_1X16 |
0x301d |
b15 |
b14 |
b13 |
b12 |
b11 |
b10 |
b9 |
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
b0 |
|
MEDIA_BUS_FMT_SGBRG16_1X16 |
0x301e |
g15 |
g14 |
g13 |
g12 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|
MEDIA_BUS_FMT_SGRBG16_1X16 |
0x301f |
g15 |
g14 |
g13 |
g12 |
g11 |
g10 |
g9 |
g8 |
g7 |
g6 |
g5 |
g4 |
g3 |
g2 |
g1 |
g0 |
|
MEDIA_BUS_FMT_SRGGB16_1X16 |
0x3020 |
r15 |
r14 |
r13 |
r12 |
r11 |
r10 |
r9 |
r8 |
r7 |
r6 |
r5 |
r4 |
r3 |
r2 |
r1 |
r0 |
4.13.3.4.1.1.3. Packed YUV Formats¶
Those data formats transfer pixel data as (possibly downsampled) Y, U and V components. Some formats include dummy bits in some of their samples and are collectively referred to as “YDYC” (Y-Dummy-Y-Chroma) formats. One cannot rely on the values of these dummy bits as those are undefined.
The format code is made of the following information.
The Y, U and V components order code, as transferred on the bus. Possible values are YUYV, UYVY, YVYU and VYUY for formats with no dummy bit, and YDYUYDYV, YDYVYDYU, YUYDYVYD and YVYDYUYD for YDYC formats.
The number of bits per pixel component. All components are transferred on the same number of bits. Common values are 8, 10 and 12.
The number of bus samples per pixel. Pixels that are wider than the bus width must be transferred in multiple samples. Common values are 0.5 (encoded as 0_5; in this case two pixels are transferred per bus sample), 1, 1.5 (encoded as 1_5) and 2.
The bus width. When the bus width is larger than the number of bits per pixel component, several components are packed in a single bus sample. The components are ordered as specified by the order code, with components on the left of the code transferred in the high order bits. Common values are 8 and 16.
For instance, a format where pixels are encoded as 8-bit YUV values
downsampled to 4:2:2 and transferred as 2 8-bit bus samples per pixel in
the U, Y, V, Y order will be named MEDIA_BUS_FMT_UYVY8_2X8
.
YUV Formats lists existing packed YUV formats and describes the organization of each pixel data in each sample. When a format pattern is split across multiple samples each of the samples in the pattern is described.
The role of each bit transferred over the bus is identified by one of the following codes.
yx for luma component bit number x
ux for blue chroma component bit number x
vx for red chroma component bit number x
ax for alpha component bit number x
for non-available bits (for positions higher than the bus width)
d for dummy bits
Identifier |
Code |
Data organization |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
31 |
30 |
29 |
28 |
27 |
26 |
25 |
24 |
23 |
22 |
21 |
10 |
19 |
18 |
17 |
16 |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
||
MEDIA_BUS_FMT_Y8_1X8 |
0x2001 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
MEDIA_BUS_FMT_UV8_1X8 |
0x2015 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_UYVY8_1_5X8 |
0x2002 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_VYUY8_1_5X8 |
0x2003 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_YUYV8_1_5X8 |
0x2004 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_YVYU8_1_5X8 |
0x2005 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_UYVY8_2X8 |
0x2006 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_VYUY8_2X8 |
0x2007 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_YUYV8_2X8 |
0x2008 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_YVYU8_2X8 |
0x2009 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||||
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_Y10_1X10 |
0x200a |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
MEDIA_BUS_FMT_Y10_2X8_PADHI_LE |
0x202c |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
0 |
0 |
0 |
0 |
0 |
0 |
y9 |
y8 |
|||||||||||||||||||||||||||
MEDIA_BUS_FMT_UYVY10_2X10 |
0x2018 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
MEDIA_BUS_FMT_VYUY10_2X10 |
0x2019 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
MEDIA_BUS_FMT_YUYV10_2X10 |
0x200b |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||
MEDIA_BUS_FMT_YVYU10_2X10 |
0x200c |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||||
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||||
MEDIA_BUS_FMT_Y12_1X12 |
0x2013 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||
MEDIA_BUS_FMT_UYVY12_2X12 |
0x201c |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
MEDIA_BUS_FMT_VYUY12_2X12 |
0x201d |
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
MEDIA_BUS_FMT_YUYV12_2X12 |
0x201e |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||
MEDIA_BUS_FMT_YVYU12_2X12 |
0x201f |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||||||
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||||||
MEDIA_BUS_FMT_Y14_1X14 |
0x202d |
y13 |
y12 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||
MEDIA_BUS_FMT_UYVY8_1X16 |
0x200f |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||
MEDIA_BUS_FMT_VYUY8_1X16 |
0x2010 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||||
MEDIA_BUS_FMT_YUYV8_1X16 |
0x2011 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||
MEDIA_BUS_FMT_YVYU8_1X16 |
0x2012 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||
MEDIA_BUS_FMT_YDYUYDYV8_1X16 |
0x2014 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
d |
d |
d |
d |
d |
d |
d |
d |
|||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
d |
d |
d |
d |
d |
d |
d |
d |
|||||||||||||||||||
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||
MEDIA_BUS_FMT_UYVY10_1X20 |
0x201a |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||
MEDIA_BUS_FMT_VYUY10_1X20 |
0x201b |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||
MEDIA_BUS_FMT_YUYV10_1X20 |
0x200d |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||
MEDIA_BUS_FMT_YVYU10_1X20 |
0x200e |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||
MEDIA_BUS_FMT_VUY8_1X24 |
0x201a |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||
MEDIA_BUS_FMT_YUV8_1X24 |
0x2025 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||
MEDIA_BUS_FMT_UYYVYY8_0_5X24 |
0x2026 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||
MEDIA_BUS_FMT_UYVY12_1X24 |
0x2020 |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||
MEDIA_BUS_FMT_VYUY12_1X24 |
0x2021 |
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||
MEDIA_BUS_FMT_YUYV12_1X24 |
0x2022 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||
MEDIA_BUS_FMT_YVYU12_1X24 |
0x2023 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||
MEDIA_BUS_FMT_YUV10_1X30 |
0x2016 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||
MEDIA_BUS_FMT_UYYVYY10_0_5X30 |
0x2027 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||
MEDIA_BUS_FMT_AYUV8_1X32 |
0x2017 |
a7 |
a6 |
a5 |
a4 |
a3 |
a2 |
a1 |
a0 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
The following table list existing packed 36bit wide YUV formats.
Identifier |
Code |
Data organization |
||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
35 |
34 |
33 |
32 |
31 |
30 |
29 |
28 |
27 |
26 |
25 |
24 |
23 |
22 |
21 |
10 |
19 |
18 |
17 |
16 |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
||
MEDIA_BUS_FMT_UYYVYY12_0_5X36 |
0x2028 |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||
MEDIA_BUS_FMT_YUV12_1X36 |
0x2029 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
The following table list existing packed 48bit wide YUV formats.
Identifier |
Code |
Data organization |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
47 |
46 |
45 |
44 |
43 |
42 |
41 |
40 |
39 |
38 |
37 |
36 |
35 |
34 |
33 |
32 |
||||||||||||||||||
31 |
30 |
29 |
28 |
27 |
26 |
25 |
24 |
23 |
22 |
21 |
10 |
19 |
18 |
17 |
16 |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
|||
MEDIA_BUS_FMT_YUV16_1X48 |
0x202a |
y15 |
y14 |
y13 |
y12 |
y11 |
y10 |
y8 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||||||||||||||||
u15 |
u14 |
u13 |
u12 |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
v15 |
v14 |
v13 |
v12 |
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||
MEDIA_BUS_FMT_UYYVYY16_0_5X48 |
0x202b |
u15 |
u14 |
u13 |
u12 |
u11 |
u10 |
u9 |
u8 |
u7 |
u6 |
u5 |
u4 |
u3 |
u2 |
u1 |
u0 |
|||||||||||||||||
y15 |
y14 |
y13 |
y12 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y15 |
y14 |
y13 |
y12 |
y11 |
y10 |
y8 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
|||
v15 |
v14 |
v13 |
v12 |
v11 |
v10 |
v9 |
v8 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
|||||||||||||||||||
y15 |
y14 |
y13 |
y12 |
y11 |
y10 |
y9 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
y15 |
y14 |
y13 |
y12 |
y11 |
y10 |
y8 |
y8 |
y7 |
y6 |
y5 |
y4 |
y3 |
y2 |
y1 |
y0 |
4.13.3.4.1.1.4. HSV/HSL Formats¶
Those formats transfer pixel data as RGB values in a cylindrical-coordinate system using Hue-Saturation-Value or Hue-Saturation-Lightness components. The format code is made of the following information.
The hue, saturation, value or lightness and optional alpha components order code, as encoded in a pixel sample. The only currently supported value is AHSV.
The number of bits per component, for each component. The values can be different for all components. The only currently supported value is 8888.
The number of bus samples per pixel. Pixels that are wider than the bus width must be transferred in multiple samples. The only currently supported value is 1.
The bus width.
For formats where the total number of bits per pixel is smaller than the number of bus samples per pixel times the bus width, a padding value stating if the bytes are padded in their most high order bits (PADHI) or low order bits (PADLO).
For formats where the number of bus samples per pixel is larger than 1, an endianness value stating if the pixel is transferred MSB first (BE) or LSB first (LE).
The following table lists existing HSV/HSL formats.
Identifier |
Code |
Data organization |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bit |
31 |
30 |
29 |
28 |
27 |
26 |
25 |
24 |
23 |
22 |
21 |
20 |
19 |
18 |
17 |
16 |
15 |
14 |
13 |
12 |
11 |
10 |
9 |
8 |
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
||
MEDIA_BUS_FMT_AHSV8888_1X32 |
0x6001 |
a7 |
a6 |
a5 |
a4 |
a3 |
a2 |
a1 |
a0 |
h7 |
h6 |
h5 |
h4 |
h3 |
h2 |
h1 |
h0 |
s7 |
s6 |
s5 |
s4 |
s3 |
s2 |
s1 |
s0 |
v7 |
v6 |
v5 |
v4 |
v3 |
v2 |
v1 |
v0 |
4.13.3.4.1.1.5. JPEG Compressed Formats¶
Those data formats consist of an ordered sequence of 8-bit bytes
obtained from JPEG compression process. Additionally to the _JPEG
postfix the format code is made of the following information.
The number of bus samples per entropy encoded byte.
The bus width.
For instance, for a JPEG baseline process and an 8-bit bus width the
format will be named MEDIA_BUS_FMT_JPEG_1X8
.
The following table lists existing JPEG compressed formats.
Identifier |
Code |
Remarks |
---|---|---|
MEDIA_BUS_FMT_JPEG_1X8 |
0x4001 |
Besides of its usage for the parallel bus this format is recommended for transmission of JPEG data over MIPI CSI bus using the User Defined 8-bit Data types. |
4.13.3.4.1.1.6. Vendor and Device Specific Formats¶
This section lists complex data formats that are either vendor or device specific.
The following table lists the existing vendor and device specific formats.
Identifier |
Code |
Comments |
---|---|---|
MEDIA_BUS_FMT_S5C_UYVY_JPEG_1X8 |
0x5001 |
Interleaved raw UYVY and JPEG image format with embedded meta-data used by Samsung S3C73MX camera sensors. |
4.13.3.4.1.1.7. Metadata Formats¶
This section lists all metadata formats.
The following table lists the existing metadata formats.
Identifier |
Code |
Comments |
---|---|---|
MEDIA_BUS_FMT_METADATA_FIXED |
0x7001 |
This format should be used when the same driver handles both sides of the link and the bus format is a fixed metadata format that is not configurable from userspace. Width and height will be set to 0 for this format. |