1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * Media Bus API header
4 *
5 * Copyright (C) 2009, Guennadi Liakhovetski <g.liakhovetski@gmx.de>
6 */
7
8 #ifndef V4L2_MEDIABUS_H
9 #define V4L2_MEDIABUS_H
10
11 #include <linux/v4l2-mediabus.h>
12 #include <linux/bitops.h>
13
14 /* Parallel flags */
15 /*
16 * Can the client run in master or in slave mode. By "Master mode" an operation
17 * mode is meant, when the client (e.g., a camera sensor) is producing
18 * horizontal and vertical synchronisation. In "Slave mode" the host is
19 * providing these signals to the slave.
20 */
21 #define V4L2_MBUS_MASTER BIT(0)
22 #define V4L2_MBUS_SLAVE BIT(1)
23 /*
24 * Signal polarity flags
25 * Note: in BT.656 mode HSYNC, FIELD, and VSYNC are unused
26 * V4L2_MBUS_[HV]SYNC* flags should be also used for specifying
27 * configuration of hardware that uses [HV]REF signals
28 */
29 #define V4L2_MBUS_HSYNC_ACTIVE_HIGH BIT(2)
30 #define V4L2_MBUS_HSYNC_ACTIVE_LOW BIT(3)
31 #define V4L2_MBUS_VSYNC_ACTIVE_HIGH BIT(4)
32 #define V4L2_MBUS_VSYNC_ACTIVE_LOW BIT(5)
33 #define V4L2_MBUS_PCLK_SAMPLE_RISING BIT(6)
34 #define V4L2_MBUS_PCLK_SAMPLE_FALLING BIT(7)
35 #define V4L2_MBUS_DATA_ACTIVE_HIGH BIT(8)
36 #define V4L2_MBUS_DATA_ACTIVE_LOW BIT(9)
37 /* FIELD = 0/1 - Field1 (odd)/Field2 (even) */
38 #define V4L2_MBUS_FIELD_EVEN_HIGH BIT(10)
39 /* FIELD = 1/0 - Field1 (odd)/Field2 (even) */
40 #define V4L2_MBUS_FIELD_EVEN_LOW BIT(11)
41 /* Active state of Sync-on-green (SoG) signal, 0/1 for LOW/HIGH respectively. */
42 #define V4L2_MBUS_VIDEO_SOG_ACTIVE_HIGH BIT(12)
43 #define V4L2_MBUS_VIDEO_SOG_ACTIVE_LOW BIT(13)
44 #define V4L2_MBUS_DATA_ENABLE_HIGH BIT(14)
45 #define V4L2_MBUS_DATA_ENABLE_LOW BIT(15)
46
47 /* Serial flags */
48 /* How many lanes the client can use */
49 #define V4L2_MBUS_CSI2_1_LANE BIT(0)
50 #define V4L2_MBUS_CSI2_2_LANE BIT(1)
51 #define V4L2_MBUS_CSI2_3_LANE BIT(2)
52 #define V4L2_MBUS_CSI2_4_LANE BIT(3)
53 /* On which channels it can send video data */
54 #define V4L2_MBUS_CSI2_CHANNEL_0 BIT(4)
55 #define V4L2_MBUS_CSI2_CHANNEL_1 BIT(5)
56 #define V4L2_MBUS_CSI2_CHANNEL_2 BIT(6)
57 #define V4L2_MBUS_CSI2_CHANNEL_3 BIT(7)
58 /* Does it support only continuous or also non-continuous clock mode */
59 #define V4L2_MBUS_CSI2_CONTINUOUS_CLOCK BIT(8)
60 #define V4L2_MBUS_CSI2_NONCONTINUOUS_CLOCK BIT(9)
61
62 #define V4L2_MBUS_CSI2_LANES (V4L2_MBUS_CSI2_1_LANE | \
63 V4L2_MBUS_CSI2_2_LANE | \
64 V4L2_MBUS_CSI2_3_LANE | \
65 V4L2_MBUS_CSI2_4_LANE)
66 #define V4L2_MBUS_CSI2_CHANNELS (V4L2_MBUS_CSI2_CHANNEL_0 | \
67 V4L2_MBUS_CSI2_CHANNEL_1 | \
68 V4L2_MBUS_CSI2_CHANNEL_2 | \
69 V4L2_MBUS_CSI2_CHANNEL_3)
70
71 /**
72 * enum v4l2_mbus_type - media bus type
73 * @V4L2_MBUS_UNKNOWN: unknown bus type, no V4L2 mediabus configuration
74 * @V4L2_MBUS_PARALLEL: parallel interface with hsync and vsync
75 * @V4L2_MBUS_BT656: parallel interface with embedded synchronisation, can
76 * also be used for BT.1120
77 * @V4L2_MBUS_CSI1: MIPI CSI-1 serial interface
78 * @V4L2_MBUS_CCP2: CCP2 (Compact Camera Port 2)
79 * @V4L2_MBUS_CSI2_DPHY: MIPI CSI-2 serial interface, with D-PHY
80 * @V4L2_MBUS_CSI2_CPHY: MIPI CSI-2 serial interface, with C-PHY
81 */
82 enum v4l2_mbus_type {
83 V4L2_MBUS_UNKNOWN,
84 V4L2_MBUS_PARALLEL,
85 V4L2_MBUS_BT656,
86 V4L2_MBUS_CSI1,
87 V4L2_MBUS_CCP2,
88 V4L2_MBUS_CSI2_DPHY,
89 V4L2_MBUS_CSI2_CPHY,
90 };
91
92 /**
93 * struct v4l2_mbus_config - media bus configuration
94 * @type: in: interface type
95 * @flags: in / out: configuration flags, depending on @type
96 */
97 struct v4l2_mbus_config {
98 enum v4l2_mbus_type type;
99 unsigned int flags;
100 };
101
102 /**
103 * v4l2_fill_pix_format - Ancillary routine that fills a &struct
104 * v4l2_pix_format fields from a &struct v4l2_mbus_framefmt.
105 *
106 * @pix_fmt: pointer to &struct v4l2_pix_format to be filled
107 * @mbus_fmt: pointer to &struct v4l2_mbus_framefmt to be used as model
108 */
109 static inline void
v4l2_fill_pix_format(struct v4l2_pix_format * pix_fmt,const struct v4l2_mbus_framefmt * mbus_fmt)110 v4l2_fill_pix_format(struct v4l2_pix_format *pix_fmt,
111 const struct v4l2_mbus_framefmt *mbus_fmt)
112 {
113 pix_fmt->width = mbus_fmt->width;
114 pix_fmt->height = mbus_fmt->height;
115 pix_fmt->field = mbus_fmt->field;
116 pix_fmt->colorspace = mbus_fmt->colorspace;
117 pix_fmt->ycbcr_enc = mbus_fmt->ycbcr_enc;
118 pix_fmt->quantization = mbus_fmt->quantization;
119 pix_fmt->xfer_func = mbus_fmt->xfer_func;
120 }
121
122 /**
123 * v4l2_fill_pix_format - Ancillary routine that fills a &struct
124 * v4l2_mbus_framefmt from a &struct v4l2_pix_format and a
125 * data format code.
126 *
127 * @mbus_fmt: pointer to &struct v4l2_mbus_framefmt to be filled
128 * @pix_fmt: pointer to &struct v4l2_pix_format to be used as model
129 * @code: data format code (from &enum v4l2_mbus_pixelcode)
130 */
v4l2_fill_mbus_format(struct v4l2_mbus_framefmt * mbus_fmt,const struct v4l2_pix_format * pix_fmt,u32 code)131 static inline void v4l2_fill_mbus_format(struct v4l2_mbus_framefmt *mbus_fmt,
132 const struct v4l2_pix_format *pix_fmt,
133 u32 code)
134 {
135 mbus_fmt->width = pix_fmt->width;
136 mbus_fmt->height = pix_fmt->height;
137 mbus_fmt->field = pix_fmt->field;
138 mbus_fmt->colorspace = pix_fmt->colorspace;
139 mbus_fmt->ycbcr_enc = pix_fmt->ycbcr_enc;
140 mbus_fmt->quantization = pix_fmt->quantization;
141 mbus_fmt->xfer_func = pix_fmt->xfer_func;
142 mbus_fmt->code = code;
143 }
144
145 /**
146 * v4l2_fill_pix_format - Ancillary routine that fills a &struct
147 * v4l2_pix_format_mplane fields from a media bus structure.
148 *
149 * @pix_mp_fmt: pointer to &struct v4l2_pix_format_mplane to be filled
150 * @mbus_fmt: pointer to &struct v4l2_mbus_framefmt to be used as model
151 */
152 static inline void
v4l2_fill_pix_format_mplane(struct v4l2_pix_format_mplane * pix_mp_fmt,const struct v4l2_mbus_framefmt * mbus_fmt)153 v4l2_fill_pix_format_mplane(struct v4l2_pix_format_mplane *pix_mp_fmt,
154 const struct v4l2_mbus_framefmt *mbus_fmt)
155 {
156 pix_mp_fmt->width = mbus_fmt->width;
157 pix_mp_fmt->height = mbus_fmt->height;
158 pix_mp_fmt->field = mbus_fmt->field;
159 pix_mp_fmt->colorspace = mbus_fmt->colorspace;
160 pix_mp_fmt->ycbcr_enc = mbus_fmt->ycbcr_enc;
161 pix_mp_fmt->quantization = mbus_fmt->quantization;
162 pix_mp_fmt->xfer_func = mbus_fmt->xfer_func;
163 }
164
165 /**
166 * v4l2_fill_pix_format - Ancillary routine that fills a &struct
167 * v4l2_mbus_framefmt from a &struct v4l2_pix_format_mplane.
168 *
169 * @mbus_fmt: pointer to &struct v4l2_mbus_framefmt to be filled
170 * @pix_mp_fmt: pointer to &struct v4l2_pix_format_mplane to be used as model
171 */
172 static inline void
v4l2_fill_mbus_format_mplane(struct v4l2_mbus_framefmt * mbus_fmt,const struct v4l2_pix_format_mplane * pix_mp_fmt)173 v4l2_fill_mbus_format_mplane(struct v4l2_mbus_framefmt *mbus_fmt,
174 const struct v4l2_pix_format_mplane *pix_mp_fmt)
175 {
176 mbus_fmt->width = pix_mp_fmt->width;
177 mbus_fmt->height = pix_mp_fmt->height;
178 mbus_fmt->field = pix_mp_fmt->field;
179 mbus_fmt->colorspace = pix_mp_fmt->colorspace;
180 mbus_fmt->ycbcr_enc = pix_mp_fmt->ycbcr_enc;
181 mbus_fmt->quantization = pix_mp_fmt->quantization;
182 mbus_fmt->xfer_func = pix_mp_fmt->xfer_func;
183 }
184
185 #endif
186