mt9t031.c revision 9aea470b399d797e88be08985c489855759c6c60
1/*
2 * Driver for MT9T031 CMOS Image Sensor from Micron
3 *
4 * Copyright (C) 2008, Guennadi Liakhovetski, DENX Software Engineering <lg@denx.de>
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
9 */
10
11#include <linux/device.h>
12#include <linux/i2c.h>
13#include <linux/log2.h>
14#include <linux/pm.h>
15#include <linux/slab.h>
16#include <linux/v4l2-mediabus.h>
17#include <linux/videodev2.h>
18#include <linux/module.h>
19
20#include <media/soc_camera.h>
21#include <media/v4l2-clk.h>
22#include <media/v4l2-subdev.h>
23#include <media/v4l2-ctrls.h>
24
25/*
26 * ATTENTION: this driver still cannot be used outside of the soc-camera
27 * framework because of its PM implementation, using the video_device node.
28 * If hardware becomes available for testing, alternative PM approaches shall
29 * be considered and tested.
30 */
31
32/*
33 * mt9t031 i2c address 0x5d
34 * The platform has to define struct i2c_board_info objects and link to them
35 * from struct soc_camera_host_desc
36 */
37
38/* mt9t031 selected register addresses */
39#define MT9T031_CHIP_VERSION		0x00
40#define MT9T031_ROW_START		0x01
41#define MT9T031_COLUMN_START		0x02
42#define MT9T031_WINDOW_HEIGHT		0x03
43#define MT9T031_WINDOW_WIDTH		0x04
44#define MT9T031_HORIZONTAL_BLANKING	0x05
45#define MT9T031_VERTICAL_BLANKING	0x06
46#define MT9T031_OUTPUT_CONTROL		0x07
47#define MT9T031_SHUTTER_WIDTH_UPPER	0x08
48#define MT9T031_SHUTTER_WIDTH		0x09
49#define MT9T031_PIXEL_CLOCK_CONTROL	0x0a
50#define MT9T031_FRAME_RESTART		0x0b
51#define MT9T031_SHUTTER_DELAY		0x0c
52#define MT9T031_RESET			0x0d
53#define MT9T031_READ_MODE_1		0x1e
54#define MT9T031_READ_MODE_2		0x20
55#define MT9T031_READ_MODE_3		0x21
56#define MT9T031_ROW_ADDRESS_MODE	0x22
57#define MT9T031_COLUMN_ADDRESS_MODE	0x23
58#define MT9T031_GLOBAL_GAIN		0x35
59#define MT9T031_CHIP_ENABLE		0xF8
60
61#define MT9T031_MAX_HEIGHT		1536
62#define MT9T031_MAX_WIDTH		2048
63#define MT9T031_MIN_HEIGHT		2
64#define MT9T031_MIN_WIDTH		18
65#define MT9T031_HORIZONTAL_BLANK	142
66#define MT9T031_VERTICAL_BLANK		25
67#define MT9T031_COLUMN_SKIP		32
68#define MT9T031_ROW_SKIP		20
69
70struct mt9t031 {
71	struct v4l2_subdev subdev;
72	struct v4l2_ctrl_handler hdl;
73	struct {
74		/* exposure/auto-exposure cluster */
75		struct v4l2_ctrl *autoexposure;
76		struct v4l2_ctrl *exposure;
77	};
78	struct v4l2_rect rect;	/* Sensor window */
79	struct v4l2_clk *clk;
80	u16 xskip;
81	u16 yskip;
82	unsigned int total_h;
83	unsigned short y_skip_top;	/* Lines to skip at the top */
84};
85
86static struct mt9t031 *to_mt9t031(const struct i2c_client *client)
87{
88	return container_of(i2c_get_clientdata(client), struct mt9t031, subdev);
89}
90
91static int reg_read(struct i2c_client *client, const u8 reg)
92{
93	return i2c_smbus_read_word_swapped(client, reg);
94}
95
96static int reg_write(struct i2c_client *client, const u8 reg,
97		     const u16 data)
98{
99	return i2c_smbus_write_word_swapped(client, reg, data);
100}
101
102static int reg_set(struct i2c_client *client, const u8 reg,
103		   const u16 data)
104{
105	int ret;
106
107	ret = reg_read(client, reg);
108	if (ret < 0)
109		return ret;
110	return reg_write(client, reg, ret | data);
111}
112
113static int reg_clear(struct i2c_client *client, const u8 reg,
114		     const u16 data)
115{
116	int ret;
117
118	ret = reg_read(client, reg);
119	if (ret < 0)
120		return ret;
121	return reg_write(client, reg, ret & ~data);
122}
123
124static int set_shutter(struct i2c_client *client, const u32 data)
125{
126	int ret;
127
128	ret = reg_write(client, MT9T031_SHUTTER_WIDTH_UPPER, data >> 16);
129
130	if (ret >= 0)
131		ret = reg_write(client, MT9T031_SHUTTER_WIDTH, data & 0xffff);
132
133	return ret;
134}
135
136static int get_shutter(struct i2c_client *client, u32 *data)
137{
138	int ret;
139
140	ret = reg_read(client, MT9T031_SHUTTER_WIDTH_UPPER);
141	*data = ret << 16;
142
143	if (ret >= 0)
144		ret = reg_read(client, MT9T031_SHUTTER_WIDTH);
145	*data |= ret & 0xffff;
146
147	return ret < 0 ? ret : 0;
148}
149
150static int mt9t031_idle(struct i2c_client *client)
151{
152	int ret;
153
154	/* Disable chip output, synchronous option update */
155	ret = reg_write(client, MT9T031_RESET, 1);
156	if (ret >= 0)
157		ret = reg_write(client, MT9T031_RESET, 0);
158	if (ret >= 0)
159		ret = reg_clear(client, MT9T031_OUTPUT_CONTROL, 2);
160
161	return ret >= 0 ? 0 : -EIO;
162}
163
164static int mt9t031_s_stream(struct v4l2_subdev *sd, int enable)
165{
166	struct i2c_client *client = v4l2_get_subdevdata(sd);
167	int ret;
168
169	if (enable)
170		/* Switch to master "normal" mode */
171		ret = reg_set(client, MT9T031_OUTPUT_CONTROL, 2);
172	else
173		/* Stop sensor readout */
174		ret = reg_clear(client, MT9T031_OUTPUT_CONTROL, 2);
175
176	if (ret < 0)
177		return -EIO;
178
179	return 0;
180}
181
182/* target must be _even_ */
183static u16 mt9t031_skip(s32 *source, s32 target, s32 max)
184{
185	unsigned int skip;
186
187	if (*source < target + target / 2) {
188		*source = target;
189		return 1;
190	}
191
192	skip = min(max, *source + target / 2) / target;
193	if (skip > 8)
194		skip = 8;
195	*source = target * skip;
196
197	return skip;
198}
199
200/* rect is the sensor rectangle, the caller guarantees parameter validity */
201static int mt9t031_set_params(struct i2c_client *client,
202			      struct v4l2_rect *rect, u16 xskip, u16 yskip)
203{
204	struct mt9t031 *mt9t031 = to_mt9t031(client);
205	int ret;
206	u16 xbin, ybin;
207	const u16 hblank = MT9T031_HORIZONTAL_BLANK,
208		vblank = MT9T031_VERTICAL_BLANK;
209
210	xbin = min(xskip, (u16)3);
211	ybin = min(yskip, (u16)3);
212
213	/*
214	 * Could just do roundup(rect->left, [xy]bin * 2); but this is cheaper.
215	 * There is always a valid suitably aligned value. The worst case is
216	 * xbin = 3, width = 2048. Then we will start at 36, the last read out
217	 * pixel will be 2083, which is < 2085 - first black pixel.
218	 *
219	 * MT9T031 datasheet imposes window left border alignment, depending on
220	 * the selected xskip. Failing to conform to this requirement produces
221	 * dark horizontal stripes in the image. However, even obeying to this
222	 * requirement doesn't eliminate the stripes in all configurations. They
223	 * appear "locally reproducibly," but can differ between tests under
224	 * different lighting conditions.
225	 */
226	switch (xbin) {
227	case 1:
228		rect->left &= ~1;
229		break;
230	case 2:
231		rect->left &= ~3;
232		break;
233	case 3:
234		rect->left = rect->left > roundup(MT9T031_COLUMN_SKIP, 6) ?
235			(rect->left / 6) * 6 : roundup(MT9T031_COLUMN_SKIP, 6);
236	}
237
238	rect->top &= ~1;
239
240	dev_dbg(&client->dev, "skip %u:%u, rect %ux%u@%u:%u\n",
241		xskip, yskip, rect->width, rect->height, rect->left, rect->top);
242
243	/* Disable register update, reconfigure atomically */
244	ret = reg_set(client, MT9T031_OUTPUT_CONTROL, 1);
245	if (ret < 0)
246		return ret;
247
248	/* Blanking and start values - default... */
249	ret = reg_write(client, MT9T031_HORIZONTAL_BLANKING, hblank);
250	if (ret >= 0)
251		ret = reg_write(client, MT9T031_VERTICAL_BLANKING, vblank);
252
253	if (yskip != mt9t031->yskip || xskip != mt9t031->xskip) {
254		/* Binning, skipping */
255		if (ret >= 0)
256			ret = reg_write(client, MT9T031_COLUMN_ADDRESS_MODE,
257					((xbin - 1) << 4) | (xskip - 1));
258		if (ret >= 0)
259			ret = reg_write(client, MT9T031_ROW_ADDRESS_MODE,
260					((ybin - 1) << 4) | (yskip - 1));
261	}
262	dev_dbg(&client->dev, "new physical left %u, top %u\n",
263		rect->left, rect->top);
264
265	/*
266	 * The caller provides a supported format, as guaranteed by
267	 * .try_mbus_fmt(), soc_camera_s_crop() and soc_camera_cropcap()
268	 */
269	if (ret >= 0)
270		ret = reg_write(client, MT9T031_COLUMN_START, rect->left);
271	if (ret >= 0)
272		ret = reg_write(client, MT9T031_ROW_START, rect->top);
273	if (ret >= 0)
274		ret = reg_write(client, MT9T031_WINDOW_WIDTH, rect->width - 1);
275	if (ret >= 0)
276		ret = reg_write(client, MT9T031_WINDOW_HEIGHT,
277				rect->height + mt9t031->y_skip_top - 1);
278	if (ret >= 0 && v4l2_ctrl_g_ctrl(mt9t031->autoexposure) == V4L2_EXPOSURE_AUTO) {
279		mt9t031->total_h = rect->height + mt9t031->y_skip_top + vblank;
280
281		ret = set_shutter(client, mt9t031->total_h);
282	}
283
284	/* Re-enable register update, commit all changes */
285	if (ret >= 0)
286		ret = reg_clear(client, MT9T031_OUTPUT_CONTROL, 1);
287
288	if (ret >= 0) {
289		mt9t031->rect = *rect;
290		mt9t031->xskip = xskip;
291		mt9t031->yskip = yskip;
292	}
293
294	return ret < 0 ? ret : 0;
295}
296
297static int mt9t031_s_crop(struct v4l2_subdev *sd, const struct v4l2_crop *a)
298{
299	struct v4l2_rect rect = a->c;
300	struct i2c_client *client = v4l2_get_subdevdata(sd);
301	struct mt9t031 *mt9t031 = to_mt9t031(client);
302
303	rect.width = ALIGN(rect.width, 2);
304	rect.height = ALIGN(rect.height, 2);
305
306	soc_camera_limit_side(&rect.left, &rect.width,
307		     MT9T031_COLUMN_SKIP, MT9T031_MIN_WIDTH, MT9T031_MAX_WIDTH);
308
309	soc_camera_limit_side(&rect.top, &rect.height,
310		     MT9T031_ROW_SKIP, MT9T031_MIN_HEIGHT, MT9T031_MAX_HEIGHT);
311
312	return mt9t031_set_params(client, &rect, mt9t031->xskip, mt9t031->yskip);
313}
314
315static int mt9t031_g_crop(struct v4l2_subdev *sd, struct v4l2_crop *a)
316{
317	struct i2c_client *client = v4l2_get_subdevdata(sd);
318	struct mt9t031 *mt9t031 = to_mt9t031(client);
319
320	a->c	= mt9t031->rect;
321	a->type	= V4L2_BUF_TYPE_VIDEO_CAPTURE;
322
323	return 0;
324}
325
326static int mt9t031_cropcap(struct v4l2_subdev *sd, struct v4l2_cropcap *a)
327{
328	a->bounds.left			= MT9T031_COLUMN_SKIP;
329	a->bounds.top			= MT9T031_ROW_SKIP;
330	a->bounds.width			= MT9T031_MAX_WIDTH;
331	a->bounds.height		= MT9T031_MAX_HEIGHT;
332	a->defrect			= a->bounds;
333	a->type				= V4L2_BUF_TYPE_VIDEO_CAPTURE;
334	a->pixelaspect.numerator	= 1;
335	a->pixelaspect.denominator	= 1;
336
337	return 0;
338}
339
340static int mt9t031_g_fmt(struct v4l2_subdev *sd,
341			 struct v4l2_mbus_framefmt *mf)
342{
343	struct i2c_client *client = v4l2_get_subdevdata(sd);
344	struct mt9t031 *mt9t031 = to_mt9t031(client);
345
346	mf->width	= mt9t031->rect.width / mt9t031->xskip;
347	mf->height	= mt9t031->rect.height / mt9t031->yskip;
348	mf->code	= V4L2_MBUS_FMT_SBGGR10_1X10;
349	mf->colorspace	= V4L2_COLORSPACE_SRGB;
350	mf->field	= V4L2_FIELD_NONE;
351
352	return 0;
353}
354
355static int mt9t031_s_fmt(struct v4l2_subdev *sd,
356			 struct v4l2_mbus_framefmt *mf)
357{
358	struct i2c_client *client = v4l2_get_subdevdata(sd);
359	struct mt9t031 *mt9t031 = to_mt9t031(client);
360	u16 xskip, yskip;
361	struct v4l2_rect rect = mt9t031->rect;
362
363	/*
364	 * try_fmt has put width and height within limits.
365	 * S_FMT: use binning and skipping for scaling
366	 */
367	xskip = mt9t031_skip(&rect.width, mf->width, MT9T031_MAX_WIDTH);
368	yskip = mt9t031_skip(&rect.height, mf->height, MT9T031_MAX_HEIGHT);
369
370	mf->code	= V4L2_MBUS_FMT_SBGGR10_1X10;
371	mf->colorspace	= V4L2_COLORSPACE_SRGB;
372
373	/* mt9t031_set_params() doesn't change width and height */
374	return mt9t031_set_params(client, &rect, xskip, yskip);
375}
376
377/*
378 * If a user window larger than sensor window is requested, we'll increase the
379 * sensor window.
380 */
381static int mt9t031_try_fmt(struct v4l2_subdev *sd,
382			   struct v4l2_mbus_framefmt *mf)
383{
384	v4l_bound_align_image(
385		&mf->width, MT9T031_MIN_WIDTH, MT9T031_MAX_WIDTH, 1,
386		&mf->height, MT9T031_MIN_HEIGHT, MT9T031_MAX_HEIGHT, 1, 0);
387
388	mf->code	= V4L2_MBUS_FMT_SBGGR10_1X10;
389	mf->colorspace	= V4L2_COLORSPACE_SRGB;
390
391	return 0;
392}
393
394#ifdef CONFIG_VIDEO_ADV_DEBUG
395static int mt9t031_g_register(struct v4l2_subdev *sd,
396			      struct v4l2_dbg_register *reg)
397{
398	struct i2c_client *client = v4l2_get_subdevdata(sd);
399
400	if (reg->reg > 0xff)
401		return -EINVAL;
402
403	reg->size = 1;
404	reg->val = reg_read(client, reg->reg);
405
406	if (reg->val > 0xffff)
407		return -EIO;
408
409	return 0;
410}
411
412static int mt9t031_s_register(struct v4l2_subdev *sd,
413			      const struct v4l2_dbg_register *reg)
414{
415	struct i2c_client *client = v4l2_get_subdevdata(sd);
416
417	if (reg->reg > 0xff)
418		return -EINVAL;
419
420	if (reg_write(client, reg->reg, reg->val) < 0)
421		return -EIO;
422
423	return 0;
424}
425#endif
426
427static int mt9t031_g_volatile_ctrl(struct v4l2_ctrl *ctrl)
428{
429	struct mt9t031 *mt9t031 = container_of(ctrl->handler,
430					       struct mt9t031, hdl);
431	const u32 shutter_max = MT9T031_MAX_HEIGHT + MT9T031_VERTICAL_BLANK;
432	s32 min, max;
433
434	switch (ctrl->id) {
435	case V4L2_CID_EXPOSURE_AUTO:
436		min = mt9t031->exposure->minimum;
437		max = mt9t031->exposure->maximum;
438		mt9t031->exposure->val =
439			(shutter_max / 2 + (mt9t031->total_h - 1) * (max - min))
440				/ shutter_max + min;
441		break;
442	}
443	return 0;
444}
445
446static int mt9t031_s_ctrl(struct v4l2_ctrl *ctrl)
447{
448	struct mt9t031 *mt9t031 = container_of(ctrl->handler,
449					       struct mt9t031, hdl);
450	struct v4l2_subdev *sd = &mt9t031->subdev;
451	struct i2c_client *client = v4l2_get_subdevdata(sd);
452	struct v4l2_ctrl *exp = mt9t031->exposure;
453	int data;
454
455	switch (ctrl->id) {
456	case V4L2_CID_VFLIP:
457		if (ctrl->val)
458			data = reg_set(client, MT9T031_READ_MODE_2, 0x8000);
459		else
460			data = reg_clear(client, MT9T031_READ_MODE_2, 0x8000);
461		if (data < 0)
462			return -EIO;
463		return 0;
464	case V4L2_CID_HFLIP:
465		if (ctrl->val)
466			data = reg_set(client, MT9T031_READ_MODE_2, 0x4000);
467		else
468			data = reg_clear(client, MT9T031_READ_MODE_2, 0x4000);
469		if (data < 0)
470			return -EIO;
471		return 0;
472	case V4L2_CID_GAIN:
473		/* See Datasheet Table 7, Gain settings. */
474		if (ctrl->val <= ctrl->default_value) {
475			/* Pack it into 0..1 step 0.125, register values 0..8 */
476			unsigned long range = ctrl->default_value - ctrl->minimum;
477			data = ((ctrl->val - ctrl->minimum) * 8 + range / 2) / range;
478
479			dev_dbg(&client->dev, "Setting gain %d\n", data);
480			data = reg_write(client, MT9T031_GLOBAL_GAIN, data);
481			if (data < 0)
482				return -EIO;
483		} else {
484			/* Pack it into 1.125..128 variable step, register values 9..0x7860 */
485			/* We assume qctrl->maximum - qctrl->default_value - 1 > 0 */
486			unsigned long range = ctrl->maximum - ctrl->default_value - 1;
487			/* calculated gain: map 65..127 to 9..1024 step 0.125 */
488			unsigned long gain = ((ctrl->val - ctrl->default_value - 1) *
489					       1015 + range / 2) / range + 9;
490
491			if (gain <= 32)		/* calculated gain 9..32 -> 9..32 */
492				data = gain;
493			else if (gain <= 64)	/* calculated gain 33..64 -> 0x51..0x60 */
494				data = ((gain - 32) * 16 + 16) / 32 + 80;
495			else
496				/* calculated gain 65..1024 -> (1..120) << 8 + 0x60 */
497				data = (((gain - 64 + 7) * 32) & 0xff00) | 0x60;
498
499			dev_dbg(&client->dev, "Set gain from 0x%x to 0x%x\n",
500				reg_read(client, MT9T031_GLOBAL_GAIN), data);
501			data = reg_write(client, MT9T031_GLOBAL_GAIN, data);
502			if (data < 0)
503				return -EIO;
504		}
505		return 0;
506
507	case V4L2_CID_EXPOSURE_AUTO:
508		if (ctrl->val == V4L2_EXPOSURE_MANUAL) {
509			unsigned int range = exp->maximum - exp->minimum;
510			unsigned int shutter = ((exp->val - exp->minimum) * 1048 +
511						 range / 2) / range + 1;
512			u32 old;
513
514			get_shutter(client, &old);
515			dev_dbg(&client->dev, "Set shutter from %u to %u\n",
516				old, shutter);
517			if (set_shutter(client, shutter) < 0)
518				return -EIO;
519		} else {
520			const u16 vblank = MT9T031_VERTICAL_BLANK;
521			mt9t031->total_h = mt9t031->rect.height +
522				mt9t031->y_skip_top + vblank;
523
524			if (set_shutter(client, mt9t031->total_h) < 0)
525				return -EIO;
526		}
527		return 0;
528	default:
529		return -EINVAL;
530	}
531	return 0;
532}
533
534/*
535 * Power Management:
536 * This function does nothing for now but must be present for pm to work
537 */
538static int mt9t031_runtime_suspend(struct device *dev)
539{
540	return 0;
541}
542
543/*
544 * Power Management:
545 * COLUMN_ADDRESS_MODE and ROW_ADDRESS_MODE are not rewritten if unchanged
546 * they are however changed at reset if the platform hook is present
547 * thus we rewrite them with the values stored by the driver
548 */
549static int mt9t031_runtime_resume(struct device *dev)
550{
551	struct video_device *vdev = to_video_device(dev);
552	struct v4l2_subdev *sd = soc_camera_vdev_to_subdev(vdev);
553	struct i2c_client *client = v4l2_get_subdevdata(sd);
554	struct mt9t031 *mt9t031 = to_mt9t031(client);
555
556	int ret;
557	u16 xbin, ybin;
558
559	xbin = min(mt9t031->xskip, (u16)3);
560	ybin = min(mt9t031->yskip, (u16)3);
561
562	ret = reg_write(client, MT9T031_COLUMN_ADDRESS_MODE,
563		((xbin - 1) << 4) | (mt9t031->xskip - 1));
564	if (ret < 0)
565		return ret;
566
567	ret = reg_write(client, MT9T031_ROW_ADDRESS_MODE,
568		((ybin - 1) << 4) | (mt9t031->yskip - 1));
569	if (ret < 0)
570		return ret;
571
572	return 0;
573}
574
575static const struct dev_pm_ops mt9t031_dev_pm_ops = {
576	.runtime_suspend	= mt9t031_runtime_suspend,
577	.runtime_resume		= mt9t031_runtime_resume,
578};
579
580static struct device_type mt9t031_dev_type = {
581	.name	= "MT9T031",
582	.pm	= &mt9t031_dev_pm_ops,
583};
584
585static int mt9t031_s_power(struct v4l2_subdev *sd, int on)
586{
587	struct i2c_client *client = v4l2_get_subdevdata(sd);
588	struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
589	struct video_device *vdev = soc_camera_i2c_to_vdev(client);
590	struct mt9t031 *mt9t031 = to_mt9t031(client);
591	int ret;
592
593	if (on) {
594		ret = soc_camera_power_on(&client->dev, ssdd, mt9t031->clk);
595		if (ret < 0)
596			return ret;
597		vdev->dev.type = &mt9t031_dev_type;
598	} else {
599		vdev->dev.type = NULL;
600		soc_camera_power_off(&client->dev, ssdd, mt9t031->clk);
601	}
602
603	return 0;
604}
605
606/*
607 * Interface active, can use i2c. If it fails, it can indeed mean, that
608 * this wasn't our capture interface, so, we wait for the right one
609 */
610static int mt9t031_video_probe(struct i2c_client *client)
611{
612	struct mt9t031 *mt9t031 = to_mt9t031(client);
613	s32 data;
614	int ret;
615
616	ret = mt9t031_s_power(&mt9t031->subdev, 1);
617	if (ret < 0)
618		return ret;
619
620	ret = mt9t031_idle(client);
621	if (ret < 0) {
622		dev_err(&client->dev, "Failed to initialise the camera\n");
623		goto done;
624	}
625
626	/* Read out the chip version register */
627	data = reg_read(client, MT9T031_CHIP_VERSION);
628
629	switch (data) {
630	case 0x1621:
631		break;
632	default:
633		dev_err(&client->dev,
634			"No MT9T031 chip detected, register read %x\n", data);
635		ret = -ENODEV;
636		goto done;
637	}
638
639	dev_info(&client->dev, "Detected a MT9T031 chip ID %x\n", data);
640
641	ret = v4l2_ctrl_handler_setup(&mt9t031->hdl);
642
643done:
644	mt9t031_s_power(&mt9t031->subdev, 0);
645
646	return ret;
647}
648
649static int mt9t031_g_skip_top_lines(struct v4l2_subdev *sd, u32 *lines)
650{
651	struct i2c_client *client = v4l2_get_subdevdata(sd);
652	struct mt9t031 *mt9t031 = to_mt9t031(client);
653
654	*lines = mt9t031->y_skip_top;
655
656	return 0;
657}
658
659static const struct v4l2_ctrl_ops mt9t031_ctrl_ops = {
660	.g_volatile_ctrl = mt9t031_g_volatile_ctrl,
661	.s_ctrl = mt9t031_s_ctrl,
662};
663
664static struct v4l2_subdev_core_ops mt9t031_subdev_core_ops = {
665	.s_power	= mt9t031_s_power,
666#ifdef CONFIG_VIDEO_ADV_DEBUG
667	.g_register	= mt9t031_g_register,
668	.s_register	= mt9t031_s_register,
669#endif
670};
671
672static int mt9t031_enum_fmt(struct v4l2_subdev *sd, unsigned int index,
673			    enum v4l2_mbus_pixelcode *code)
674{
675	if (index)
676		return -EINVAL;
677
678	*code = V4L2_MBUS_FMT_SBGGR10_1X10;
679	return 0;
680}
681
682static int mt9t031_g_mbus_config(struct v4l2_subdev *sd,
683				struct v4l2_mbus_config *cfg)
684{
685	struct i2c_client *client = v4l2_get_subdevdata(sd);
686	struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
687
688	cfg->flags = V4L2_MBUS_MASTER | V4L2_MBUS_PCLK_SAMPLE_RISING |
689		V4L2_MBUS_PCLK_SAMPLE_FALLING | V4L2_MBUS_HSYNC_ACTIVE_HIGH |
690		V4L2_MBUS_VSYNC_ACTIVE_HIGH | V4L2_MBUS_DATA_ACTIVE_HIGH;
691	cfg->type = V4L2_MBUS_PARALLEL;
692	cfg->flags = soc_camera_apply_board_flags(ssdd, cfg);
693
694	return 0;
695}
696
697static int mt9t031_s_mbus_config(struct v4l2_subdev *sd,
698				const struct v4l2_mbus_config *cfg)
699{
700	struct i2c_client *client = v4l2_get_subdevdata(sd);
701	struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
702
703	if (soc_camera_apply_board_flags(ssdd, cfg) &
704	    V4L2_MBUS_PCLK_SAMPLE_FALLING)
705		return reg_clear(client, MT9T031_PIXEL_CLOCK_CONTROL, 0x8000);
706	else
707		return reg_set(client, MT9T031_PIXEL_CLOCK_CONTROL, 0x8000);
708}
709
710static struct v4l2_subdev_video_ops mt9t031_subdev_video_ops = {
711	.s_stream	= mt9t031_s_stream,
712	.s_mbus_fmt	= mt9t031_s_fmt,
713	.g_mbus_fmt	= mt9t031_g_fmt,
714	.try_mbus_fmt	= mt9t031_try_fmt,
715	.s_crop		= mt9t031_s_crop,
716	.g_crop		= mt9t031_g_crop,
717	.cropcap	= mt9t031_cropcap,
718	.enum_mbus_fmt	= mt9t031_enum_fmt,
719	.g_mbus_config	= mt9t031_g_mbus_config,
720	.s_mbus_config	= mt9t031_s_mbus_config,
721};
722
723static struct v4l2_subdev_sensor_ops mt9t031_subdev_sensor_ops = {
724	.g_skip_top_lines	= mt9t031_g_skip_top_lines,
725};
726
727static struct v4l2_subdev_ops mt9t031_subdev_ops = {
728	.core	= &mt9t031_subdev_core_ops,
729	.video	= &mt9t031_subdev_video_ops,
730	.sensor	= &mt9t031_subdev_sensor_ops,
731};
732
733static int mt9t031_probe(struct i2c_client *client,
734			 const struct i2c_device_id *did)
735{
736	struct mt9t031 *mt9t031;
737	struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
738	struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
739	int ret;
740
741	if (!ssdd) {
742		dev_err(&client->dev, "MT9T031 driver needs platform data\n");
743		return -EINVAL;
744	}
745
746	if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA)) {
747		dev_warn(&adapter->dev,
748			 "I2C-Adapter doesn't support I2C_FUNC_SMBUS_WORD\n");
749		return -EIO;
750	}
751
752	mt9t031 = devm_kzalloc(&client->dev, sizeof(struct mt9t031), GFP_KERNEL);
753	if (!mt9t031)
754		return -ENOMEM;
755
756	v4l2_i2c_subdev_init(&mt9t031->subdev, client, &mt9t031_subdev_ops);
757	v4l2_ctrl_handler_init(&mt9t031->hdl, 5);
758	v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
759			V4L2_CID_VFLIP, 0, 1, 1, 0);
760	v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
761			V4L2_CID_HFLIP, 0, 1, 1, 0);
762	v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
763			V4L2_CID_GAIN, 0, 127, 1, 64);
764
765	/*
766	 * Simulated autoexposure. If enabled, we calculate shutter width
767	 * ourselves in the driver based on vertical blanking and frame width
768	 */
769	mt9t031->autoexposure = v4l2_ctrl_new_std_menu(&mt9t031->hdl,
770			&mt9t031_ctrl_ops, V4L2_CID_EXPOSURE_AUTO, 1, 0,
771			V4L2_EXPOSURE_AUTO);
772	mt9t031->exposure = v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
773			V4L2_CID_EXPOSURE, 1, 255, 1, 255);
774
775	mt9t031->subdev.ctrl_handler = &mt9t031->hdl;
776	if (mt9t031->hdl.error)
777		return mt9t031->hdl.error;
778
779	v4l2_ctrl_auto_cluster(2, &mt9t031->autoexposure,
780				V4L2_EXPOSURE_MANUAL, true);
781
782	mt9t031->y_skip_top	= 0;
783	mt9t031->rect.left	= MT9T031_COLUMN_SKIP;
784	mt9t031->rect.top	= MT9T031_ROW_SKIP;
785	mt9t031->rect.width	= MT9T031_MAX_WIDTH;
786	mt9t031->rect.height	= MT9T031_MAX_HEIGHT;
787
788	mt9t031->xskip = 1;
789	mt9t031->yskip = 1;
790
791	mt9t031->clk = v4l2_clk_get(&client->dev, "mclk");
792	if (IS_ERR(mt9t031->clk)) {
793		ret = PTR_ERR(mt9t031->clk);
794		goto eclkget;
795	}
796
797	ret = mt9t031_video_probe(client);
798	if (ret) {
799		v4l2_clk_put(mt9t031->clk);
800eclkget:
801		v4l2_ctrl_handler_free(&mt9t031->hdl);
802	}
803
804	return ret;
805}
806
807static int mt9t031_remove(struct i2c_client *client)
808{
809	struct mt9t031 *mt9t031 = to_mt9t031(client);
810
811	v4l2_clk_put(mt9t031->clk);
812	v4l2_device_unregister_subdev(&mt9t031->subdev);
813	v4l2_ctrl_handler_free(&mt9t031->hdl);
814
815	return 0;
816}
817
818static const struct i2c_device_id mt9t031_id[] = {
819	{ "mt9t031", 0 },
820	{ }
821};
822MODULE_DEVICE_TABLE(i2c, mt9t031_id);
823
824static struct i2c_driver mt9t031_i2c_driver = {
825	.driver = {
826		.name = "mt9t031",
827	},
828	.probe		= mt9t031_probe,
829	.remove		= mt9t031_remove,
830	.id_table	= mt9t031_id,
831};
832
833module_i2c_driver(mt9t031_i2c_driver);
834
835MODULE_DESCRIPTION("Micron MT9T031 Camera driver");
836MODULE_AUTHOR("Guennadi Liakhovetski <lg@denx.de>");
837MODULE_LICENSE("GPL v2");
838