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	0x1026 */
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_RGB666_1X36_CPADLO	0x1020
72#define MEDIA_BUS_FMT_RGB888_1X36_CPADLO	0x1021
73#define MEDIA_BUS_FMT_RGB121212_1X36		0x1019
74#define MEDIA_BUS_FMT_RGB161616_1X48		0x101a
75
76/* YUV (including grey) - next is	0x202f */
77#define MEDIA_BUS_FMT_Y8_1X8			0x2001
78#define MEDIA_BUS_FMT_UV8_1X8			0x2015
79#define MEDIA_BUS_FMT_UYVY8_1_5X8		0x2002
80#define MEDIA_BUS_FMT_VYUY8_1_5X8		0x2003
81#define MEDIA_BUS_FMT_YUYV8_1_5X8		0x2004
82#define MEDIA_BUS_FMT_YVYU8_1_5X8		0x2005
83#define MEDIA_BUS_FMT_UYVY8_2X8			0x2006
84#define MEDIA_BUS_FMT_VYUY8_2X8			0x2007
85#define MEDIA_BUS_FMT_YUYV8_2X8			0x2008
86#define MEDIA_BUS_FMT_YVYU8_2X8			0x2009
87#define MEDIA_BUS_FMT_Y10_1X10			0x200a
88#define MEDIA_BUS_FMT_Y10_2X8_PADHI_LE		0x202c
89#define MEDIA_BUS_FMT_UYVY10_2X10		0x2018
90#define MEDIA_BUS_FMT_VYUY10_2X10		0x2019
91#define MEDIA_BUS_FMT_YUYV10_2X10		0x200b
92#define MEDIA_BUS_FMT_YVYU10_2X10		0x200c
93#define MEDIA_BUS_FMT_Y12_1X12			0x2013
94#define MEDIA_BUS_FMT_UYVY12_2X12		0x201c
95#define MEDIA_BUS_FMT_VYUY12_2X12		0x201d
96#define MEDIA_BUS_FMT_YUYV12_2X12		0x201e
97#define MEDIA_BUS_FMT_YVYU12_2X12		0x201f
98#define MEDIA_BUS_FMT_Y14_1X14			0x202d
99#define MEDIA_BUS_FMT_Y16_1X16			0x202e
100#define MEDIA_BUS_FMT_UYVY8_1X16		0x200f
101#define MEDIA_BUS_FMT_VYUY8_1X16		0x2010
102#define MEDIA_BUS_FMT_YUYV8_1X16		0x2011
103#define MEDIA_BUS_FMT_YVYU8_1X16		0x2012
104#define MEDIA_BUS_FMT_YDYUYDYV8_1X16		0x2014
105#define MEDIA_BUS_FMT_UYVY10_1X20		0x201a
106#define MEDIA_BUS_FMT_VYUY10_1X20		0x201b
107#define MEDIA_BUS_FMT_YUYV10_1X20		0x200d
108#define MEDIA_BUS_FMT_YVYU10_1X20		0x200e
109#define MEDIA_BUS_FMT_VUY8_1X24			0x2024
110#define MEDIA_BUS_FMT_YUV8_1X24			0x2025
111#define MEDIA_BUS_FMT_UYYVYY8_0_5X24		0x2026
112#define MEDIA_BUS_FMT_UYVY12_1X24		0x2020
113#define MEDIA_BUS_FMT_VYUY12_1X24		0x2021
114#define MEDIA_BUS_FMT_YUYV12_1X24		0x2022
115#define MEDIA_BUS_FMT_YVYU12_1X24		0x2023
116#define MEDIA_BUS_FMT_YUV10_1X30		0x2016
117#define MEDIA_BUS_FMT_UYYVYY10_0_5X30		0x2027
118#define MEDIA_BUS_FMT_AYUV8_1X32		0x2017
119#define MEDIA_BUS_FMT_UYYVYY12_0_5X36		0x2028
120#define MEDIA_BUS_FMT_YUV12_1X36		0x2029
121#define MEDIA_BUS_FMT_YUV16_1X48		0x202a
122#define MEDIA_BUS_FMT_UYYVYY16_0_5X48		0x202b
123
124/* Bayer - next is	0x3021 */
125#define MEDIA_BUS_FMT_SBGGR8_1X8		0x3001
126#define MEDIA_BUS_FMT_SGBRG8_1X8		0x3013
127#define MEDIA_BUS_FMT_SGRBG8_1X8		0x3002
128#define MEDIA_BUS_FMT_SRGGB8_1X8		0x3014
129#define MEDIA_BUS_FMT_SBGGR10_ALAW8_1X8		0x3015
130#define MEDIA_BUS_FMT_SGBRG10_ALAW8_1X8		0x3016
131#define MEDIA_BUS_FMT_SGRBG10_ALAW8_1X8		0x3017
132#define MEDIA_BUS_FMT_SRGGB10_ALAW8_1X8		0x3018
133#define MEDIA_BUS_FMT_SBGGR10_DPCM8_1X8		0x300b
134#define MEDIA_BUS_FMT_SGBRG10_DPCM8_1X8		0x300c
135#define MEDIA_BUS_FMT_SGRBG10_DPCM8_1X8		0x3009
136#define MEDIA_BUS_FMT_SRGGB10_DPCM8_1X8		0x300d
137#define MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_BE	0x3003
138#define MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_LE	0x3004
139#define MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_BE	0x3005
140#define MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_LE	0x3006
141#define MEDIA_BUS_FMT_SBGGR10_1X10		0x3007
142#define MEDIA_BUS_FMT_SGBRG10_1X10		0x300e
143#define MEDIA_BUS_FMT_SGRBG10_1X10		0x300a
144#define MEDIA_BUS_FMT_SRGGB10_1X10		0x300f
145#define MEDIA_BUS_FMT_SBGGR12_1X12		0x3008
146#define MEDIA_BUS_FMT_SGBRG12_1X12		0x3010
147#define MEDIA_BUS_FMT_SGRBG12_1X12		0x3011
148#define MEDIA_BUS_FMT_SRGGB12_1X12		0x3012
149#define MEDIA_BUS_FMT_SBGGR14_1X14		0x3019
150#define MEDIA_BUS_FMT_SGBRG14_1X14		0x301a
151#define MEDIA_BUS_FMT_SGRBG14_1X14		0x301b
152#define MEDIA_BUS_FMT_SRGGB14_1X14		0x301c
153#define MEDIA_BUS_FMT_SBGGR16_1X16		0x301d
154#define MEDIA_BUS_FMT_SGBRG16_1X16		0x301e
155#define MEDIA_BUS_FMT_SGRBG16_1X16		0x301f
156#define MEDIA_BUS_FMT_SRGGB16_1X16		0x3020
157
158/* JPEG compressed formats - next is	0x4002 */
159#define MEDIA_BUS_FMT_JPEG_1X8			0x4001
160
161/* Vendor specific formats - next is	0x5002 */
162
163/* S5C73M3 sensor specific interleaved UYVY and JPEG */
164#define MEDIA_BUS_FMT_S5C_UYVY_JPEG_1X8		0x5001
165
166/* HSV - next is	0x6002 */
167#define MEDIA_BUS_FMT_AHSV8888_1X32		0x6001
168
169/*
170 * This format should be used when the same driver handles
171 * both sides of the link and the bus format is a fixed
172 * metadata format that is not configurable from userspace.
173 * Width and height will be set to 0 for this format.
174 */
175#define MEDIA_BUS_FMT_METADATA_FIXED		0x7001
176
177#endif /* __LINUX_MEDIA_BUS_FORMAT_H */
178