1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2/*
3 * Media Bus API header
4 *
5 * Copyright (C) 2009, Guennadi Liakhovetski <g.liakhovetski@gmx.de>
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
10 */
11
12#ifndef __LINUX_MEDIA_BUS_FORMAT_H
13#define __LINUX_MEDIA_BUS_FORMAT_H
14
15/*
16 * These bus formats uniquely identify data formats on the data bus. Format 0
17 * is reserved, MEDIA_BUS_FMT_FIXED shall be used by host-client pairs, where
18 * the data format is fixed. Additionally, "2X8" means that one pixel is
19 * transferred in two 8-bit samples, "BE" or "LE" specify in which order those
20 * samples are transferred over the bus: "LE" means that the least significant
21 * bits are transferred first, "BE" means that the most significant bits are
22 * transferred first, and "PADHI" and "PADLO" define which bits - low or high,
23 * in the incomplete high byte, are filled with padding bits.
24 *
25 * The bus formats are grouped by type, bus_width, bits per component, samples
26 * per pixel and order of subsamples. Numerical values are sorted using generic
27 * numerical sort order (8 thus comes before 10).
28 *
29 * As their value can't change when a new bus format is inserted in the
30 * enumeration, the bus formats are explicitly given a numerical value. The next
31 * free values for each category are listed below, update them when inserting
32 * new pixel codes.
33 */
34
35#define MEDIA_BUS_FMT_FIXED 0x0001
36
37/* RGB - next is 0x1028 */
38#define MEDIA_BUS_FMT_RGB444_1X12 0x1016
39#define MEDIA_BUS_FMT_RGB444_2X8_PADHI_BE 0x1001
40#define MEDIA_BUS_FMT_RGB444_2X8_PADHI_LE 0x1002
41#define MEDIA_BUS_FMT_RGB555_2X8_PADHI_BE 0x1003
42#define MEDIA_BUS_FMT_RGB555_2X8_PADHI_LE 0x1004
43#define MEDIA_BUS_FMT_RGB565_1X16 0x1017
44#define MEDIA_BUS_FMT_BGR565_2X8_BE 0x1005
45#define MEDIA_BUS_FMT_BGR565_2X8_LE 0x1006
46#define MEDIA_BUS_FMT_RGB565_2X8_BE 0x1007
47#define MEDIA_BUS_FMT_RGB565_2X8_LE 0x1008
48#define MEDIA_BUS_FMT_RGB666_1X18 0x1009
49#define MEDIA_BUS_FMT_RGB666_2X9_BE 0x1025
50#define MEDIA_BUS_FMT_BGR666_1X18 0x1023
51#define MEDIA_BUS_FMT_RBG888_1X24 0x100e
52#define MEDIA_BUS_FMT_RGB666_1X24_CPADHI 0x1015
53#define MEDIA_BUS_FMT_BGR666_1X24_CPADHI 0x1024
54#define MEDIA_BUS_FMT_RGB565_1X24_CPADHI 0x1022
55#define MEDIA_BUS_FMT_RGB666_1X7X3_SPWG 0x1010
56#define MEDIA_BUS_FMT_BGR888_1X24 0x1013
57#define MEDIA_BUS_FMT_BGR888_3X8 0x101b
58#define MEDIA_BUS_FMT_GBR888_1X24 0x1014
59#define MEDIA_BUS_FMT_RGB888_1X24 0x100a
60#define MEDIA_BUS_FMT_RGB888_2X12_BE 0x100b
61#define MEDIA_BUS_FMT_RGB888_2X12_LE 0x100c
62#define MEDIA_BUS_FMT_RGB888_3X8 0x101c
63#define MEDIA_BUS_FMT_RGB888_3X8_DELTA 0x101d
64#define MEDIA_BUS_FMT_RGB888_1X7X4_SPWG 0x1011
65#define MEDIA_BUS_FMT_RGB888_1X7X4_JEIDA 0x1012
66#define MEDIA_BUS_FMT_RGB666_1X30_CPADLO 0x101e
67#define MEDIA_BUS_FMT_RGB888_1X30_CPADLO 0x101f
68#define MEDIA_BUS_FMT_ARGB8888_1X32 0x100d
69#define MEDIA_BUS_FMT_RGB888_1X32_PADHI 0x100f
70#define MEDIA_BUS_FMT_RGB101010_1X30 0x1018
71#define MEDIA_BUS_FMT_RGB101010_1X7X5_SPWG 0x1026
72#define MEDIA_BUS_FMT_RGB101010_1X7X5_JEIDA 0x1027
73#define MEDIA_BUS_FMT_RGB666_1X36_CPADLO 0x1020
74#define MEDIA_BUS_FMT_RGB888_1X36_CPADLO 0x1021
75#define MEDIA_BUS_FMT_RGB121212_1X36 0x1019
76#define MEDIA_BUS_FMT_RGB161616_1X48 0x101a
77
78/* YUV (including grey) - next is 0x202f */
79#define MEDIA_BUS_FMT_Y8_1X8 0x2001
80#define MEDIA_BUS_FMT_UV8_1X8 0x2015
81#define MEDIA_BUS_FMT_UYVY8_1_5X8 0x2002
82#define MEDIA_BUS_FMT_VYUY8_1_5X8 0x2003
83#define MEDIA_BUS_FMT_YUYV8_1_5X8 0x2004
84#define MEDIA_BUS_FMT_YVYU8_1_5X8 0x2005
85#define MEDIA_BUS_FMT_UYVY8_2X8 0x2006
86#define MEDIA_BUS_FMT_VYUY8_2X8 0x2007
87#define MEDIA_BUS_FMT_YUYV8_2X8 0x2008
88#define MEDIA_BUS_FMT_YVYU8_2X8 0x2009
89#define MEDIA_BUS_FMT_Y10_1X10 0x200a
90#define MEDIA_BUS_FMT_Y10_2X8_PADHI_LE 0x202c
91#define MEDIA_BUS_FMT_UYVY10_2X10 0x2018
92#define MEDIA_BUS_FMT_VYUY10_2X10 0x2019
93#define MEDIA_BUS_FMT_YUYV10_2X10 0x200b
94#define MEDIA_BUS_FMT_YVYU10_2X10 0x200c
95#define MEDIA_BUS_FMT_Y12_1X12 0x2013
96#define MEDIA_BUS_FMT_UYVY12_2X12 0x201c
97#define MEDIA_BUS_FMT_VYUY12_2X12 0x201d
98#define MEDIA_BUS_FMT_YUYV12_2X12 0x201e
99#define MEDIA_BUS_FMT_YVYU12_2X12 0x201f
100#define MEDIA_BUS_FMT_Y14_1X14 0x202d
101#define MEDIA_BUS_FMT_Y16_1X16 0x202e
102#define MEDIA_BUS_FMT_UYVY8_1X16 0x200f
103#define MEDIA_BUS_FMT_VYUY8_1X16 0x2010
104#define MEDIA_BUS_FMT_YUYV8_1X16 0x2011
105#define MEDIA_BUS_FMT_YVYU8_1X16 0x2012
106#define MEDIA_BUS_FMT_YDYUYDYV8_1X16 0x2014
107#define MEDIA_BUS_FMT_UYVY10_1X20 0x201a
108#define MEDIA_BUS_FMT_VYUY10_1X20 0x201b
109#define MEDIA_BUS_FMT_YUYV10_1X20 0x200d
110#define MEDIA_BUS_FMT_YVYU10_1X20 0x200e
111#define MEDIA_BUS_FMT_VUY8_1X24 0x2024
112#define MEDIA_BUS_FMT_YUV8_1X24 0x2025
113#define MEDIA_BUS_FMT_UYYVYY8_0_5X24 0x2026
114#define MEDIA_BUS_FMT_UYVY12_1X24 0x2020
115#define MEDIA_BUS_FMT_VYUY12_1X24 0x2021
116#define MEDIA_BUS_FMT_YUYV12_1X24 0x2022
117#define MEDIA_BUS_FMT_YVYU12_1X24 0x2023
118#define MEDIA_BUS_FMT_YUV10_1X30 0x2016
119#define MEDIA_BUS_FMT_UYYVYY10_0_5X30 0x2027
120#define MEDIA_BUS_FMT_AYUV8_1X32 0x2017
121#define MEDIA_BUS_FMT_UYYVYY12_0_5X36 0x2028
122#define MEDIA_BUS_FMT_YUV12_1X36 0x2029
123#define MEDIA_BUS_FMT_YUV16_1X48 0x202a
124#define MEDIA_BUS_FMT_UYYVYY16_0_5X48 0x202b
125
126/* Bayer - next is 0x3021 */
127#define MEDIA_BUS_FMT_SBGGR8_1X8 0x3001
128#define MEDIA_BUS_FMT_SGBRG8_1X8 0x3013
129#define MEDIA_BUS_FMT_SGRBG8_1X8 0x3002
130#define MEDIA_BUS_FMT_SRGGB8_1X8 0x3014
131#define MEDIA_BUS_FMT_SBGGR10_ALAW8_1X8 0x3015
132#define MEDIA_BUS_FMT_SGBRG10_ALAW8_1X8 0x3016
133#define MEDIA_BUS_FMT_SGRBG10_ALAW8_1X8 0x3017
134#define MEDIA_BUS_FMT_SRGGB10_ALAW8_1X8 0x3018
135#define MEDIA_BUS_FMT_SBGGR10_DPCM8_1X8 0x300b
136#define MEDIA_BUS_FMT_SGBRG10_DPCM8_1X8 0x300c
137#define MEDIA_BUS_FMT_SGRBG10_DPCM8_1X8 0x3009
138#define MEDIA_BUS_FMT_SRGGB10_DPCM8_1X8 0x300d
139#define MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_BE 0x3003
140#define MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_LE 0x3004
141#define MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_BE 0x3005
142#define MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_LE 0x3006
143#define MEDIA_BUS_FMT_SBGGR10_1X10 0x3007
144#define MEDIA_BUS_FMT_SGBRG10_1X10 0x300e
145#define MEDIA_BUS_FMT_SGRBG10_1X10 0x300a
146#define MEDIA_BUS_FMT_SRGGB10_1X10 0x300f
147#define MEDIA_BUS_FMT_SBGGR12_1X12 0x3008
148#define MEDIA_BUS_FMT_SGBRG12_1X12 0x3010
149#define MEDIA_BUS_FMT_SGRBG12_1X12 0x3011
150#define MEDIA_BUS_FMT_SRGGB12_1X12 0x3012
151#define MEDIA_BUS_FMT_SBGGR14_1X14 0x3019
152#define MEDIA_BUS_FMT_SGBRG14_1X14 0x301a
153#define MEDIA_BUS_FMT_SGRBG14_1X14 0x301b
154#define MEDIA_BUS_FMT_SRGGB14_1X14 0x301c
155#define MEDIA_BUS_FMT_SBGGR16_1X16 0x301d
156#define MEDIA_BUS_FMT_SGBRG16_1X16 0x301e
157#define MEDIA_BUS_FMT_SGRBG16_1X16 0x301f
158#define MEDIA_BUS_FMT_SRGGB16_1X16 0x3020
159
160/* JPEG compressed formats - next is 0x4002 */
161#define MEDIA_BUS_FMT_JPEG_1X8 0x4001
162
163/* Vendor specific formats - next is 0x5002 */
164
165/* S5C73M3 sensor specific interleaved UYVY and JPEG */
166#define MEDIA_BUS_FMT_S5C_UYVY_JPEG_1X8 0x5001
167
168/* HSV - next is 0x6002 */
169#define MEDIA_BUS_FMT_AHSV8888_1X32 0x6001
170
171/*
172 * This format should be used when the same driver handles
173 * both sides of the link and the bus format is a fixed
174 * metadata format that is not configurable from userspace.
175 * Width and height will be set to 0 for this format.
176 */
177#define MEDIA_BUS_FMT_METADATA_FIXED 0x7001
178
179/* Generic line based metadata formats for serial buses. Next is 0x8008. */
180#define MEDIA_BUS_FMT_META_8 0x8001
181#define MEDIA_BUS_FMT_META_10 0x8002
182#define MEDIA_BUS_FMT_META_12 0x8003
183#define MEDIA_BUS_FMT_META_14 0x8004
184#define MEDIA_BUS_FMT_META_16 0x8005
185#define MEDIA_BUS_FMT_META_20 0x8006
186#define MEDIA_BUS_FMT_META_24 0x8007
187
188#endif /* __LINUX_MEDIA_BUS_FORMAT_H */
189