1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* Texas Instruments Triple 8-/10-BIT 165-/110-MSPS Video and Graphics
3 * Digitizer with Horizontal PLL registers
5 * Copyright (C) 2009 Texas Instruments Inc
8 * This code is partially based upon the TVP5150 driver
11 * and the TVP7002 driver in the TI LSP 2.10.00.14. Revisions by
12 * Muralidharan Karicheri and Snehaprabha Narnakaje (TI).
14 #include <linux/delay.h>
15 #include <linux/i2c.h>
16 #include <linux/slab.h>
17 #include <linux/videodev2.h>
18 #include <linux/module.h>
20 #include <linux/of_graph.h>
21 #include <linux/v4l2-dv-timings.h>
22 #include <media/i2c/tvp7002.h>
23 #include <media/v4l2-async.h>
24 #include <media/v4l2-device.h>
25 #include <media/v4l2-common.h>
26 #include <media/v4l2-ctrls.h>
27 #include <media/v4l2-fwnode.h>
29 #include "tvp7002_reg.h"
31 MODULE_DESCRIPTION("TI TVP7002 Video and Graphics Digitizer driver");
33 MODULE_LICENSE("GPL");
35 /* I2C retry attempts */
36 #define I2C_RETRY_COUNT (5)
38 /* End of registers */
39 #define TVP7002_EOR 0x5c
41 /* Read write definition for registers */
42 #define TVP7002_READ 0
43 #define TVP7002_WRITE 1
44 #define TVP7002_RESERVED 2
46 /* Interlaced vs progressive mask and shift */
47 #define TVP7002_IP_SHIFT 5
48 #define TVP7002_INPR_MASK (0x01 << TVP7002_IP_SHIFT)
50 /* Shift for CPL and LPF registers */
51 #define TVP7002_CL_SHIFT 8
52 #define TVP7002_CL_MASK 0x0f
56 module_param(debug, bool, 0644);
57 MODULE_PARM_DESC(debug, "Debug level (0-2)");
59 /* Structure for register values */
60 struct i2c_reg_value {
67 * Register default values (according to tvp7002 datasheet)
68 * In the case of read-only registers, the value (0xff) is
69 * never written. R/W functionality is controlled by the
70 * writable bit in the register struct definition.
72 static const struct i2c_reg_value tvp7002_init_default[] = {
73 { TVP7002_CHIP_REV, 0xff, TVP7002_READ },
74 { TVP7002_HPLL_FDBK_DIV_MSBS, 0x67, TVP7002_WRITE },
75 { TVP7002_HPLL_FDBK_DIV_LSBS, 0x20, TVP7002_WRITE },
76 { TVP7002_HPLL_CRTL, 0xa0, TVP7002_WRITE },
77 { TVP7002_HPLL_PHASE_SEL, 0x80, TVP7002_WRITE },
78 { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
79 { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
80 { TVP7002_HSYNC_OUT_W, 0x60, TVP7002_WRITE },
81 { TVP7002_B_FINE_GAIN, 0x00, TVP7002_WRITE },
82 { TVP7002_G_FINE_GAIN, 0x00, TVP7002_WRITE },
83 { TVP7002_R_FINE_GAIN, 0x00, TVP7002_WRITE },
84 { TVP7002_B_FINE_OFF_MSBS, 0x80, TVP7002_WRITE },
85 { TVP7002_G_FINE_OFF_MSBS, 0x80, TVP7002_WRITE },
86 { TVP7002_R_FINE_OFF_MSBS, 0x80, TVP7002_WRITE },
87 { TVP7002_SYNC_CTL_1, 0x20, TVP7002_WRITE },
88 { TVP7002_HPLL_AND_CLAMP_CTL, 0x2e, TVP7002_WRITE },
89 { TVP7002_SYNC_ON_G_THRS, 0x5d, TVP7002_WRITE },
90 { TVP7002_SYNC_SEPARATOR_THRS, 0x47, TVP7002_WRITE },
91 { TVP7002_HPLL_PRE_COAST, 0x00, TVP7002_WRITE },
92 { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
93 { TVP7002_SYNC_DETECT_STAT, 0xff, TVP7002_READ },
94 { TVP7002_OUT_FORMATTER, 0x47, TVP7002_WRITE },
95 { TVP7002_MISC_CTL_1, 0x01, TVP7002_WRITE },
96 { TVP7002_MISC_CTL_2, 0x00, TVP7002_WRITE },
97 { TVP7002_MISC_CTL_3, 0x01, TVP7002_WRITE },
98 { TVP7002_IN_MUX_SEL_1, 0x00, TVP7002_WRITE },
99 { TVP7002_IN_MUX_SEL_2, 0x67, TVP7002_WRITE },
100 { TVP7002_B_AND_G_COARSE_GAIN, 0x77, TVP7002_WRITE },
101 { TVP7002_R_COARSE_GAIN, 0x07, TVP7002_WRITE },
102 { TVP7002_FINE_OFF_LSBS, 0x00, TVP7002_WRITE },
103 { TVP7002_B_COARSE_OFF, 0x10, TVP7002_WRITE },
104 { TVP7002_G_COARSE_OFF, 0x10, TVP7002_WRITE },
105 { TVP7002_R_COARSE_OFF, 0x10, TVP7002_WRITE },
106 { TVP7002_HSOUT_OUT_START, 0x08, TVP7002_WRITE },
107 { TVP7002_MISC_CTL_4, 0x00, TVP7002_WRITE },
108 { TVP7002_B_DGTL_ALC_OUT_LSBS, 0xff, TVP7002_READ },
109 { TVP7002_G_DGTL_ALC_OUT_LSBS, 0xff, TVP7002_READ },
110 { TVP7002_R_DGTL_ALC_OUT_LSBS, 0xff, TVP7002_READ },
111 { TVP7002_AUTO_LVL_CTL_ENABLE, 0x80, TVP7002_WRITE },
112 { TVP7002_DGTL_ALC_OUT_MSBS, 0xff, TVP7002_READ },
113 { TVP7002_AUTO_LVL_CTL_FILTER, 0x53, TVP7002_WRITE },
114 { 0x29, 0x08, TVP7002_RESERVED },
115 { TVP7002_FINE_CLAMP_CTL, 0x07, TVP7002_WRITE },
116 /* PWR_CTL is controlled only by the probe and reset functions */
117 { TVP7002_PWR_CTL, 0x00, TVP7002_RESERVED },
118 { TVP7002_ADC_SETUP, 0x50, TVP7002_WRITE },
119 { TVP7002_COARSE_CLAMP_CTL, 0x00, TVP7002_WRITE },
120 { TVP7002_SOG_CLAMP, 0x80, TVP7002_WRITE },
121 { TVP7002_RGB_COARSE_CLAMP_CTL, 0x8c, TVP7002_WRITE },
122 { TVP7002_SOG_COARSE_CLAMP_CTL, 0x04, TVP7002_WRITE },
123 { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
124 { 0x32, 0x18, TVP7002_RESERVED },
125 { 0x33, 0x60, TVP7002_RESERVED },
126 { TVP7002_MVIS_STRIPPER_W, 0xff, TVP7002_RESERVED },
127 { TVP7002_VSYNC_ALGN, 0x10, TVP7002_WRITE },
128 { TVP7002_SYNC_BYPASS, 0x00, TVP7002_WRITE },
129 { TVP7002_L_FRAME_STAT_LSBS, 0xff, TVP7002_READ },
130 { TVP7002_L_FRAME_STAT_MSBS, 0xff, TVP7002_READ },
131 { TVP7002_CLK_L_STAT_LSBS, 0xff, TVP7002_READ },
132 { TVP7002_CLK_L_STAT_MSBS, 0xff, TVP7002_READ },
133 { TVP7002_HSYNC_W, 0xff, TVP7002_READ },
134 { TVP7002_VSYNC_W, 0xff, TVP7002_READ },
135 { TVP7002_L_LENGTH_TOL, 0x03, TVP7002_WRITE },
136 { 0x3e, 0x60, TVP7002_RESERVED },
137 { TVP7002_VIDEO_BWTH_CTL, 0x01, TVP7002_WRITE },
138 { TVP7002_AVID_START_PIXEL_LSBS, 0x01, TVP7002_WRITE },
139 { TVP7002_AVID_START_PIXEL_MSBS, 0x2c, TVP7002_WRITE },
140 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x06, TVP7002_WRITE },
141 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x2c, TVP7002_WRITE },
142 { TVP7002_VBLK_F_0_START_L_OFF, 0x05, TVP7002_WRITE },
143 { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
144 { TVP7002_VBLK_F_0_DURATION, 0x1e, TVP7002_WRITE },
145 { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
146 { TVP7002_FBIT_F_0_START_L_OFF, 0x00, TVP7002_WRITE },
147 { TVP7002_FBIT_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
148 { TVP7002_YUV_Y_G_COEF_LSBS, 0xe3, TVP7002_WRITE },
149 { TVP7002_YUV_Y_G_COEF_MSBS, 0x16, TVP7002_WRITE },
150 { TVP7002_YUV_Y_B_COEF_LSBS, 0x4f, TVP7002_WRITE },
151 { TVP7002_YUV_Y_B_COEF_MSBS, 0x02, TVP7002_WRITE },
152 { TVP7002_YUV_Y_R_COEF_LSBS, 0xce, TVP7002_WRITE },
153 { TVP7002_YUV_Y_R_COEF_MSBS, 0x06, TVP7002_WRITE },
154 { TVP7002_YUV_U_G_COEF_LSBS, 0xab, TVP7002_WRITE },
155 { TVP7002_YUV_U_G_COEF_MSBS, 0xf3, TVP7002_WRITE },
156 { TVP7002_YUV_U_B_COEF_LSBS, 0x00, TVP7002_WRITE },
157 { TVP7002_YUV_U_B_COEF_MSBS, 0x10, TVP7002_WRITE },
158 { TVP7002_YUV_U_R_COEF_LSBS, 0x55, TVP7002_WRITE },
159 { TVP7002_YUV_U_R_COEF_MSBS, 0xfc, TVP7002_WRITE },
160 { TVP7002_YUV_V_G_COEF_LSBS, 0x78, TVP7002_WRITE },
161 { TVP7002_YUV_V_G_COEF_MSBS, 0xf1, TVP7002_WRITE },
162 { TVP7002_YUV_V_B_COEF_LSBS, 0x88, TVP7002_WRITE },
163 { TVP7002_YUV_V_B_COEF_MSBS, 0xfe, TVP7002_WRITE },
164 { TVP7002_YUV_V_R_COEF_LSBS, 0x00, TVP7002_WRITE },
165 { TVP7002_YUV_V_R_COEF_MSBS, 0x10, TVP7002_WRITE },
166 /* This signals end of register values */
167 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
170 /* Register parameters for 480P */
171 static const struct i2c_reg_value tvp7002_parms_480P[] = {
172 { TVP7002_HPLL_FDBK_DIV_MSBS, 0x35, TVP7002_WRITE },
173 { TVP7002_HPLL_FDBK_DIV_LSBS, 0xa0, TVP7002_WRITE },
174 { TVP7002_HPLL_CRTL, 0x02, TVP7002_WRITE },
175 { TVP7002_AVID_START_PIXEL_LSBS, 0x91, TVP7002_WRITE },
176 { TVP7002_AVID_START_PIXEL_MSBS, 0x00, TVP7002_WRITE },
177 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x0B, TVP7002_WRITE },
178 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x00, TVP7002_WRITE },
179 { TVP7002_VBLK_F_0_START_L_OFF, 0x03, TVP7002_WRITE },
180 { TVP7002_VBLK_F_1_START_L_OFF, 0x01, TVP7002_WRITE },
181 { TVP7002_VBLK_F_0_DURATION, 0x13, TVP7002_WRITE },
182 { TVP7002_VBLK_F_1_DURATION, 0x13, TVP7002_WRITE },
183 { TVP7002_ALC_PLACEMENT, 0x18, TVP7002_WRITE },
184 { TVP7002_CLAMP_START, 0x06, TVP7002_WRITE },
185 { TVP7002_CLAMP_W, 0x10, TVP7002_WRITE },
186 { TVP7002_HPLL_PRE_COAST, 0x03, TVP7002_WRITE },
187 { TVP7002_HPLL_POST_COAST, 0x03, TVP7002_WRITE },
188 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
191 /* Register parameters for 576P */
192 static const struct i2c_reg_value tvp7002_parms_576P[] = {
193 { TVP7002_HPLL_FDBK_DIV_MSBS, 0x36, TVP7002_WRITE },
194 { TVP7002_HPLL_FDBK_DIV_LSBS, 0x00, TVP7002_WRITE },
195 { TVP7002_HPLL_CRTL, 0x18, TVP7002_WRITE },
196 { TVP7002_AVID_START_PIXEL_LSBS, 0x9B, TVP7002_WRITE },
197 { TVP7002_AVID_START_PIXEL_MSBS, 0x00, TVP7002_WRITE },
198 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x0F, TVP7002_WRITE },
199 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x00, TVP7002_WRITE },
200 { TVP7002_VBLK_F_0_START_L_OFF, 0x00, TVP7002_WRITE },
201 { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
202 { TVP7002_VBLK_F_0_DURATION, 0x2D, TVP7002_WRITE },
203 { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
204 { TVP7002_ALC_PLACEMENT, 0x18, TVP7002_WRITE },
205 { TVP7002_CLAMP_START, 0x06, TVP7002_WRITE },
206 { TVP7002_CLAMP_W, 0x10, TVP7002_WRITE },
207 { TVP7002_HPLL_PRE_COAST, 0x03, TVP7002_WRITE },
208 { TVP7002_HPLL_POST_COAST, 0x03, TVP7002_WRITE },
209 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
212 /* Register parameters for 1080I60 */
213 static const struct i2c_reg_value tvp7002_parms_1080I60[] = {
214 { TVP7002_HPLL_FDBK_DIV_MSBS, 0x89, TVP7002_WRITE },
215 { TVP7002_HPLL_FDBK_DIV_LSBS, 0x80, TVP7002_WRITE },
216 { TVP7002_HPLL_CRTL, 0x98, TVP7002_WRITE },
217 { TVP7002_AVID_START_PIXEL_LSBS, 0x06, TVP7002_WRITE },
218 { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
219 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x8a, TVP7002_WRITE },
220 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x08, TVP7002_WRITE },
221 { TVP7002_VBLK_F_0_START_L_OFF, 0x02, TVP7002_WRITE },
222 { TVP7002_VBLK_F_1_START_L_OFF, 0x02, TVP7002_WRITE },
223 { TVP7002_VBLK_F_0_DURATION, 0x16, TVP7002_WRITE },
224 { TVP7002_VBLK_F_1_DURATION, 0x17, TVP7002_WRITE },
225 { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
226 { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
227 { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
228 { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
229 { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
230 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
233 /* Register parameters for 1080P60 */
234 static const struct i2c_reg_value tvp7002_parms_1080P60[] = {
235 { TVP7002_HPLL_FDBK_DIV_MSBS, 0x89, TVP7002_WRITE },
236 { TVP7002_HPLL_FDBK_DIV_LSBS, 0x80, TVP7002_WRITE },
237 { TVP7002_HPLL_CRTL, 0xE0, TVP7002_WRITE },
238 { TVP7002_AVID_START_PIXEL_LSBS, 0x06, TVP7002_WRITE },
239 { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
240 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x8a, TVP7002_WRITE },
241 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x08, TVP7002_WRITE },
242 { TVP7002_VBLK_F_0_START_L_OFF, 0x02, TVP7002_WRITE },
243 { TVP7002_VBLK_F_1_START_L_OFF, 0x02, TVP7002_WRITE },
244 { TVP7002_VBLK_F_0_DURATION, 0x16, TVP7002_WRITE },
245 { TVP7002_VBLK_F_1_DURATION, 0x17, TVP7002_WRITE },
246 { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
247 { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
248 { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
249 { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
250 { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
251 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
254 /* Register parameters for 1080I50 */
255 static const struct i2c_reg_value tvp7002_parms_1080I50[] = {
256 { TVP7002_HPLL_FDBK_DIV_MSBS, 0xa5, TVP7002_WRITE },
257 { TVP7002_HPLL_FDBK_DIV_LSBS, 0x00, TVP7002_WRITE },
258 { TVP7002_HPLL_CRTL, 0x98, TVP7002_WRITE },
259 { TVP7002_AVID_START_PIXEL_LSBS, 0x06, TVP7002_WRITE },
260 { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
261 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x8a, TVP7002_WRITE },
262 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x08, TVP7002_WRITE },
263 { TVP7002_VBLK_F_0_START_L_OFF, 0x02, TVP7002_WRITE },
264 { TVP7002_VBLK_F_1_START_L_OFF, 0x02, TVP7002_WRITE },
265 { TVP7002_VBLK_F_0_DURATION, 0x16, TVP7002_WRITE },
266 { TVP7002_VBLK_F_1_DURATION, 0x17, TVP7002_WRITE },
267 { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
268 { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
269 { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
270 { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
271 { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
272 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
275 /* Register parameters for 720P60 */
276 static const struct i2c_reg_value tvp7002_parms_720P60[] = {
277 { TVP7002_HPLL_FDBK_DIV_MSBS, 0x67, TVP7002_WRITE },
278 { TVP7002_HPLL_FDBK_DIV_LSBS, 0x20, TVP7002_WRITE },
279 { TVP7002_HPLL_CRTL, 0xa0, TVP7002_WRITE },
280 { TVP7002_AVID_START_PIXEL_LSBS, 0x47, TVP7002_WRITE },
281 { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
282 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x4B, TVP7002_WRITE },
283 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x06, TVP7002_WRITE },
284 { TVP7002_VBLK_F_0_START_L_OFF, 0x05, TVP7002_WRITE },
285 { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
286 { TVP7002_VBLK_F_0_DURATION, 0x2D, TVP7002_WRITE },
287 { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
288 { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
289 { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
290 { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
291 { TVP7002_HPLL_PRE_COAST, 0x00, TVP7002_WRITE },
292 { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
293 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
296 /* Register parameters for 720P50 */
297 static const struct i2c_reg_value tvp7002_parms_720P50[] = {
298 { TVP7002_HPLL_FDBK_DIV_MSBS, 0x7b, TVP7002_WRITE },
299 { TVP7002_HPLL_FDBK_DIV_LSBS, 0xc0, TVP7002_WRITE },
300 { TVP7002_HPLL_CRTL, 0x98, TVP7002_WRITE },
301 { TVP7002_AVID_START_PIXEL_LSBS, 0x47, TVP7002_WRITE },
302 { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
303 { TVP7002_AVID_STOP_PIXEL_LSBS, 0x4B, TVP7002_WRITE },
304 { TVP7002_AVID_STOP_PIXEL_MSBS, 0x06, TVP7002_WRITE },
305 { TVP7002_VBLK_F_0_START_L_OFF, 0x05, TVP7002_WRITE },
306 { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
307 { TVP7002_VBLK_F_0_DURATION, 0x2D, TVP7002_WRITE },
308 { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
309 { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
310 { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
311 { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
312 { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
313 { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
314 { TVP7002_EOR, 0xff, TVP7002_RESERVED }
317 /* Timings definition for handling device operation */
318 struct tvp7002_timings_definition {
319 struct v4l2_dv_timings timings;
320 const struct i2c_reg_value *p_settings;
321 enum v4l2_colorspace color_space;
322 enum v4l2_field scanmode;
329 /* Struct list for digital video timings */
330 static const struct tvp7002_timings_definition tvp7002_timings[] = {
332 V4L2_DV_BT_CEA_1280X720P60,
333 tvp7002_parms_720P60,
334 V4L2_COLORSPACE_REC709,
342 V4L2_DV_BT_CEA_1920X1080I60,
343 tvp7002_parms_1080I60,
344 V4L2_COLORSPACE_REC709,
345 V4L2_FIELD_INTERLACED,
352 V4L2_DV_BT_CEA_1920X1080I50,
353 tvp7002_parms_1080I50,
354 V4L2_COLORSPACE_REC709,
355 V4L2_FIELD_INTERLACED,
362 V4L2_DV_BT_CEA_1280X720P50,
363 tvp7002_parms_720P50,
364 V4L2_COLORSPACE_REC709,
372 V4L2_DV_BT_CEA_1920X1080P60,
373 tvp7002_parms_1080P60,
374 V4L2_COLORSPACE_REC709,
382 V4L2_DV_BT_CEA_720X480P59_94,
384 V4L2_COLORSPACE_SMPTE170M,
392 V4L2_DV_BT_CEA_720X576P50,
394 V4L2_COLORSPACE_SMPTE170M,
403 #define NUM_TIMINGS ARRAY_SIZE(tvp7002_timings)
405 /* Device definition */
407 struct v4l2_subdev sd;
408 struct v4l2_ctrl_handler hdl;
409 const struct tvp7002_config *pdata;
414 const struct tvp7002_timings_definition *current_timings;
415 struct media_pad pad;
419 * to_tvp7002 - Obtain device handler TVP7002
420 * @sd: ptr to v4l2_subdev struct
422 * Returns device handler tvp7002.
424 static inline struct tvp7002 *to_tvp7002(struct v4l2_subdev *sd)
426 return container_of(sd, struct tvp7002, sd);
429 static inline struct v4l2_subdev *to_sd(struct v4l2_ctrl *ctrl)
431 return &container_of(ctrl->handler, struct tvp7002, hdl)->sd;
435 * tvp7002_read - Read a value from a register in an TVP7002
436 * @sd: ptr to v4l2_subdev struct
437 * @addr: TVP7002 register address
438 * @dst: pointer to 8-bit destination
440 * Returns value read if successful, or non-zero (-1) otherwise.
442 static int tvp7002_read(struct v4l2_subdev *sd, u8 addr, u8 *dst)
444 struct i2c_client *c = v4l2_get_subdevdata(sd);
448 for (retry = 0; retry < I2C_RETRY_COUNT; retry++) {
449 error = i2c_smbus_read_byte_data(c, addr);
456 msleep_interruptible(10);
458 v4l2_err(sd, "TVP7002 read error %d\n", error);
463 * tvp7002_read_err() - Read a register value with error code
464 * @sd: pointer to standard V4L2 sub-device structure
465 * @reg: destination register
466 * @val: value to be read
467 * @err: pointer to error value
469 * Read a value in a register and save error value in pointer.
470 * Also update the register table if successful
472 static inline void tvp7002_read_err(struct v4l2_subdev *sd, u8 reg,
476 *err = tvp7002_read(sd, reg, dst);
480 * tvp7002_write() - Write a value to a register in TVP7002
481 * @sd: ptr to v4l2_subdev struct
482 * @addr: TVP7002 register address
483 * @value: value to be written to the register
485 * Write a value to a register in an TVP7002 decoder device.
486 * Returns zero if successful, or non-zero otherwise.
488 static int tvp7002_write(struct v4l2_subdev *sd, u8 addr, u8 value)
490 struct i2c_client *c;
494 c = v4l2_get_subdevdata(sd);
496 for (retry = 0; retry < I2C_RETRY_COUNT; retry++) {
497 error = i2c_smbus_write_byte_data(c, addr, value);
502 v4l2_warn(sd, "Write: retry ... %d\n", retry);
503 msleep_interruptible(10);
505 v4l2_err(sd, "TVP7002 write error %d\n", error);
510 * tvp7002_write_err() - Write a register value with error code
511 * @sd: pointer to standard V4L2 sub-device structure
512 * @reg: destination register
513 * @val: value to be written
514 * @err: pointer to error value
516 * Write a value in a register and save error value in pointer.
517 * Also update the register table if successful
519 static inline void tvp7002_write_err(struct v4l2_subdev *sd, u8 reg,
523 *err = tvp7002_write(sd, reg, val);
527 * tvp7002_write_inittab() - Write initialization values
528 * @sd: ptr to v4l2_subdev struct
529 * @regs: ptr to i2c_reg_value struct
531 * Write initialization values.
532 * Returns zero or -EINVAL if read operation fails.
534 static int tvp7002_write_inittab(struct v4l2_subdev *sd,
535 const struct i2c_reg_value *regs)
539 /* Initialize the first (defined) registers */
540 while (TVP7002_EOR != regs->reg) {
541 if (TVP7002_WRITE == regs->type)
542 tvp7002_write_err(sd, regs->reg, regs->value, &error);
549 static int tvp7002_s_dv_timings(struct v4l2_subdev *sd,
550 struct v4l2_dv_timings *dv_timings)
552 struct tvp7002 *device = to_tvp7002(sd);
553 const struct v4l2_bt_timings *bt = &dv_timings->bt;
556 if (dv_timings->type != V4L2_DV_BT_656_1120)
558 for (i = 0; i < NUM_TIMINGS; i++) {
559 const struct v4l2_bt_timings *t = &tvp7002_timings[i].timings.bt;
561 if (!memcmp(bt, t, &bt->standards - &bt->width)) {
562 device->current_timings = &tvp7002_timings[i];
563 return tvp7002_write_inittab(sd, tvp7002_timings[i].p_settings);
569 static int tvp7002_g_dv_timings(struct v4l2_subdev *sd,
570 struct v4l2_dv_timings *dv_timings)
572 struct tvp7002 *device = to_tvp7002(sd);
574 *dv_timings = device->current_timings->timings;
579 * tvp7002_s_ctrl() - Set a control
580 * @ctrl: ptr to v4l2_ctrl struct
582 * Set a control in TVP7002 decoder device.
583 * Returns zero when successful or -EINVAL if register access fails.
585 static int tvp7002_s_ctrl(struct v4l2_ctrl *ctrl)
587 struct v4l2_subdev *sd = to_sd(ctrl);
592 tvp7002_write_err(sd, TVP7002_R_FINE_GAIN, ctrl->val, &error);
593 tvp7002_write_err(sd, TVP7002_G_FINE_GAIN, ctrl->val, &error);
594 tvp7002_write_err(sd, TVP7002_B_FINE_GAIN, ctrl->val, &error);
601 * tvp7002_query_dv() - query DV timings
602 * @sd: pointer to standard V4L2 sub-device structure
603 * @index: index into the tvp7002_timings array
605 * Returns the current DV timings detected by TVP7002. If no active input is
606 * detected, returns -EINVAL
608 static int tvp7002_query_dv(struct v4l2_subdev *sd, int *index)
610 const struct tvp7002_timings_definition *timings = tvp7002_timings;
620 /* Return invalid index if no active input is detected */
621 *index = NUM_TIMINGS;
623 /* Read standards from device registers */
624 tvp7002_read_err(sd, TVP7002_L_FRAME_STAT_LSBS, &lpf_lsb, &error);
625 tvp7002_read_err(sd, TVP7002_L_FRAME_STAT_MSBS, &lpf_msb, &error);
630 tvp7002_read_err(sd, TVP7002_CLK_L_STAT_LSBS, &cpl_lsb, &error);
631 tvp7002_read_err(sd, TVP7002_CLK_L_STAT_MSBS, &cpl_msb, &error);
636 /* Get lines per frame, clocks per line and interlaced/progresive */
637 lpfr = lpf_lsb | ((TVP7002_CL_MASK & lpf_msb) << TVP7002_CL_SHIFT);
638 cpln = cpl_lsb | ((TVP7002_CL_MASK & cpl_msb) << TVP7002_CL_SHIFT);
639 progressive = (lpf_msb & TVP7002_INPR_MASK) >> TVP7002_IP_SHIFT;
641 /* Do checking of video modes */
642 for (*index = 0; *index < NUM_TIMINGS; (*index)++, timings++)
643 if (lpfr == timings->lines_per_frame &&
644 progressive == timings->progressive) {
645 if (timings->cpl_min == 0xffff)
647 if (cpln >= timings->cpl_min && cpln <= timings->cpl_max)
651 if (*index == NUM_TIMINGS) {
652 v4l2_dbg(1, debug, sd, "detection failed: lpf = %x, cpl = %x\n",
657 /* Update lines per frame and clocks per line info */
658 v4l2_dbg(1, debug, sd, "detected timings: %d\n", *index);
662 static int tvp7002_query_dv_timings(struct v4l2_subdev *sd,
663 struct v4l2_dv_timings *timings)
666 int err = tvp7002_query_dv(sd, &index);
670 *timings = tvp7002_timings[index].timings;
674 #ifdef CONFIG_VIDEO_ADV_DEBUG
676 * tvp7002_g_register() - Get the value of a register
677 * @sd: ptr to v4l2_subdev struct
678 * @reg: ptr to v4l2_dbg_register struct
680 * Get the value of a TVP7002 decoder device register.
681 * Returns zero when successful, -EINVAL if register read fails or
682 * access to I2C client fails.
684 static int tvp7002_g_register(struct v4l2_subdev *sd,
685 struct v4l2_dbg_register *reg)
690 ret = tvp7002_read(sd, reg->reg & 0xff, &val);
699 * tvp7002_s_register() - set a control
700 * @sd: ptr to v4l2_subdev struct
701 * @reg: ptr to v4l2_dbg_register struct
703 * Get the value of a TVP7002 decoder device register.
704 * Returns zero when successful, -EINVAL if register read fails.
706 static int tvp7002_s_register(struct v4l2_subdev *sd,
707 const struct v4l2_dbg_register *reg)
709 return tvp7002_write(sd, reg->reg & 0xff, reg->val & 0xff);
714 * tvp7002_s_stream() - V4L2 decoder i/f handler for s_stream
715 * @sd: pointer to standard V4L2 sub-device structure
716 * @enable: streaming enable or disable
718 * Sets streaming to enable or disable, if possible.
720 static int tvp7002_s_stream(struct v4l2_subdev *sd, int enable)
722 struct tvp7002 *device = to_tvp7002(sd);
725 if (device->streaming == enable)
728 /* low impedance: on, high impedance: off */
729 error = tvp7002_write(sd, TVP7002_MISC_CTL_2, enable ? 0x00 : 0x03);
731 v4l2_dbg(1, debug, sd, "Fail to set streaming\n");
735 device->streaming = enable;
740 * tvp7002_log_status() - Print information about register settings
741 * @sd: ptr to v4l2_subdev struct
743 * Log register values of a TVP7002 decoder device.
744 * Returns zero or -EINVAL if read operation fails.
746 static int tvp7002_log_status(struct v4l2_subdev *sd)
748 struct tvp7002 *device = to_tvp7002(sd);
749 const struct v4l2_bt_timings *bt;
752 /* Find my current timings */
753 tvp7002_query_dv(sd, &detected);
755 bt = &device->current_timings->timings.bt;
756 v4l2_info(sd, "Selected DV Timings: %ux%u\n", bt->width, bt->height);
757 if (detected == NUM_TIMINGS) {
758 v4l2_info(sd, "Detected DV Timings: None\n");
760 bt = &tvp7002_timings[detected].timings.bt;
761 v4l2_info(sd, "Detected DV Timings: %ux%u\n",
762 bt->width, bt->height);
764 v4l2_info(sd, "Streaming enabled: %s\n",
765 device->streaming ? "yes" : "no");
767 /* Print the current value of the gain control */
768 v4l2_ctrl_handler_log_status(&device->hdl, sd->name);
773 static int tvp7002_enum_dv_timings(struct v4l2_subdev *sd,
774 struct v4l2_enum_dv_timings *timings)
776 if (timings->pad != 0)
779 /* Check requested format index is within range */
780 if (timings->index >= NUM_TIMINGS)
783 timings->timings = tvp7002_timings[timings->index].timings;
787 static const struct v4l2_ctrl_ops tvp7002_ctrl_ops = {
788 .s_ctrl = tvp7002_s_ctrl,
792 * tvp7002_enum_mbus_code() - Enum supported digital video format on pad
793 * @sd: pointer to standard V4L2 sub-device structure
794 * @cfg: pad configuration
795 * @code: pointer to subdev enum mbus code struct
797 * Enumerate supported digital video formats for pad.
800 tvp7002_enum_mbus_code(struct v4l2_subdev *sd,
801 struct v4l2_subdev_state *sd_state,
802 struct v4l2_subdev_mbus_code_enum *code)
804 /* Check requested format index is within range */
805 if (code->index != 0)
808 code->code = MEDIA_BUS_FMT_YUYV10_1X20;
814 * tvp7002_get_pad_format() - get video format on pad
815 * @sd: pointer to standard V4L2 sub-device structure
816 * @cfg: pad configuration
817 * @fmt: pointer to subdev format struct
819 * get video format for pad.
822 tvp7002_get_pad_format(struct v4l2_subdev *sd,
823 struct v4l2_subdev_state *sd_state,
824 struct v4l2_subdev_format *fmt)
826 struct tvp7002 *tvp7002 = to_tvp7002(sd);
828 fmt->format.code = MEDIA_BUS_FMT_YUYV10_1X20;
829 fmt->format.width = tvp7002->current_timings->timings.bt.width;
830 fmt->format.height = tvp7002->current_timings->timings.bt.height;
831 fmt->format.field = tvp7002->current_timings->scanmode;
832 fmt->format.colorspace = tvp7002->current_timings->color_space;
838 * tvp7002_set_pad_format() - set video format on pad
839 * @sd: pointer to standard V4L2 sub-device structure
840 * @cfg: pad configuration
841 * @fmt: pointer to subdev format struct
843 * set video format for pad.
846 tvp7002_set_pad_format(struct v4l2_subdev *sd,
847 struct v4l2_subdev_state *sd_state,
848 struct v4l2_subdev_format *fmt)
850 return tvp7002_get_pad_format(sd, sd_state, fmt);
853 /* V4L2 core operation handlers */
854 static const struct v4l2_subdev_core_ops tvp7002_core_ops = {
855 .log_status = tvp7002_log_status,
856 #ifdef CONFIG_VIDEO_ADV_DEBUG
857 .g_register = tvp7002_g_register,
858 .s_register = tvp7002_s_register,
862 /* Specific video subsystem operation handlers */
863 static const struct v4l2_subdev_video_ops tvp7002_video_ops = {
864 .g_dv_timings = tvp7002_g_dv_timings,
865 .s_dv_timings = tvp7002_s_dv_timings,
866 .query_dv_timings = tvp7002_query_dv_timings,
867 .s_stream = tvp7002_s_stream,
870 /* media pad related operation handlers */
871 static const struct v4l2_subdev_pad_ops tvp7002_pad_ops = {
872 .enum_mbus_code = tvp7002_enum_mbus_code,
873 .get_fmt = tvp7002_get_pad_format,
874 .set_fmt = tvp7002_set_pad_format,
875 .enum_dv_timings = tvp7002_enum_dv_timings,
878 /* V4L2 top level operation handlers */
879 static const struct v4l2_subdev_ops tvp7002_ops = {
880 .core = &tvp7002_core_ops,
881 .video = &tvp7002_video_ops,
882 .pad = &tvp7002_pad_ops,
885 static struct tvp7002_config *
886 tvp7002_get_pdata(struct i2c_client *client)
888 struct v4l2_fwnode_endpoint bus_cfg = { .bus_type = 0 };
889 struct tvp7002_config *pdata = NULL;
890 struct device_node *endpoint;
893 if (!IS_ENABLED(CONFIG_OF) || !client->dev.of_node)
894 return client->dev.platform_data;
896 endpoint = of_graph_get_next_endpoint(client->dev.of_node, NULL);
900 if (v4l2_fwnode_endpoint_parse(of_fwnode_handle(endpoint), &bus_cfg))
903 pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
907 flags = bus_cfg.bus.parallel.flags;
909 if (flags & V4L2_MBUS_HSYNC_ACTIVE_HIGH)
910 pdata->hs_polarity = 1;
912 if (flags & V4L2_MBUS_VSYNC_ACTIVE_HIGH)
913 pdata->vs_polarity = 1;
915 if (flags & V4L2_MBUS_PCLK_SAMPLE_RISING)
916 pdata->clk_polarity = 1;
918 if (flags & V4L2_MBUS_FIELD_EVEN_HIGH)
919 pdata->fid_polarity = 1;
921 if (flags & V4L2_MBUS_VIDEO_SOG_ACTIVE_HIGH)
922 pdata->sog_polarity = 1;
925 of_node_put(endpoint);
930 * tvp7002_probe - Probe a TVP7002 device
931 * @c: ptr to i2c_client struct
932 * @id: ptr to i2c_device_id struct
934 * Initialize the TVP7002 device
935 * Returns zero when successful, -EINVAL if register read fails or
936 * -EIO if i2c access is not available.
938 static int tvp7002_probe(struct i2c_client *c)
940 struct tvp7002_config *pdata = tvp7002_get_pdata(c);
941 struct v4l2_subdev *sd;
942 struct tvp7002 *device;
943 struct v4l2_dv_timings timings;
950 dev_err(&c->dev, "No platform data\n");
954 /* Check if the adapter supports the needed features */
955 if (!i2c_check_functionality(c->adapter,
956 I2C_FUNC_SMBUS_READ_BYTE | I2C_FUNC_SMBUS_WRITE_BYTE_DATA))
959 device = devm_kzalloc(&c->dev, sizeof(struct tvp7002), GFP_KERNEL);
965 device->pdata = pdata;
966 device->current_timings = tvp7002_timings;
968 /* Tell v4l2 the device is ready */
969 v4l2_i2c_subdev_init(sd, c, &tvp7002_ops);
970 v4l_info(c, "tvp7002 found @ 0x%02x (%s)\n",
971 c->addr, c->adapter->name);
973 error = tvp7002_read(sd, TVP7002_CHIP_REV, &revision);
977 /* Get revision number */
978 v4l2_info(sd, "Rev. %02x detected.\n", revision);
979 if (revision != 0x02)
980 v4l2_info(sd, "Unknown revision detected.\n");
982 /* Initializes TVP7002 to its default values */
983 error = tvp7002_write_inittab(sd, tvp7002_init_default);
988 /* Set polarity information after registers have been set */
989 polarity_a = 0x20 | device->pdata->hs_polarity << 5
990 | device->pdata->vs_polarity << 2;
991 error = tvp7002_write(sd, TVP7002_SYNC_CTL_1, polarity_a);
995 polarity_b = 0x01 | device->pdata->fid_polarity << 2
996 | device->pdata->sog_polarity << 1
997 | device->pdata->clk_polarity;
998 error = tvp7002_write(sd, TVP7002_MISC_CTL_3, polarity_b);
1002 /* Set registers according to default video mode */
1003 timings = device->current_timings->timings;
1004 error = tvp7002_s_dv_timings(sd, &timings);
1006 #if defined(CONFIG_MEDIA_CONTROLLER)
1007 device->pad.flags = MEDIA_PAD_FL_SOURCE;
1008 device->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
1009 device->sd.entity.function = MEDIA_ENT_F_ATV_DECODER;
1011 error = media_entity_pads_init(&device->sd.entity, 1, &device->pad);
1016 v4l2_ctrl_handler_init(&device->hdl, 1);
1017 v4l2_ctrl_new_std(&device->hdl, &tvp7002_ctrl_ops,
1018 V4L2_CID_GAIN, 0, 255, 1, 0);
1019 sd->ctrl_handler = &device->hdl;
1020 if (device->hdl.error) {
1021 error = device->hdl.error;
1024 v4l2_ctrl_handler_setup(&device->hdl);
1026 error = v4l2_async_register_subdev(&device->sd);
1033 v4l2_ctrl_handler_free(&device->hdl);
1034 #if defined(CONFIG_MEDIA_CONTROLLER)
1035 media_entity_cleanup(&device->sd.entity);
1041 * tvp7002_remove - Remove TVP7002 device support
1042 * @c: ptr to i2c_client struct
1044 * Reset the TVP7002 device
1047 static void tvp7002_remove(struct i2c_client *c)
1049 struct v4l2_subdev *sd = i2c_get_clientdata(c);
1050 struct tvp7002 *device = to_tvp7002(sd);
1052 v4l2_dbg(1, debug, sd, "Removing tvp7002 adapter"
1053 "on address 0x%x\n", c->addr);
1054 v4l2_async_unregister_subdev(&device->sd);
1055 #if defined(CONFIG_MEDIA_CONTROLLER)
1056 media_entity_cleanup(&device->sd.entity);
1058 v4l2_ctrl_handler_free(&device->hdl);
1061 /* I2C Device ID table */
1062 static const struct i2c_device_id tvp7002_id[] = {
1066 MODULE_DEVICE_TABLE(i2c, tvp7002_id);
1068 #if IS_ENABLED(CONFIG_OF)
1069 static const struct of_device_id tvp7002_of_match[] = {
1070 { .compatible = "ti,tvp7002", },
1073 MODULE_DEVICE_TABLE(of, tvp7002_of_match);
1076 /* I2C driver data */
1077 static struct i2c_driver tvp7002_driver = {
1079 .of_match_table = of_match_ptr(tvp7002_of_match),
1080 .name = TVP7002_MODULE_NAME,
1082 .probe_new = tvp7002_probe,
1083 .remove = tvp7002_remove,
1084 .id_table = tvp7002_id,
1087 module_i2c_driver(tvp7002_driver);