1 /*
2  * camera image capture (abstract) bus driver
3  *
4  * Copyright (C) 2008, Guennadi Liakhovetski <kernel@pengutronix.de>
5  *
6  * This driver provides an interface between platform-specific camera
7  * busses and camera devices. It should be used if the camera is
8  * connected not over a "proper" bus like PCI or USB, but over a
9  * special bus, like, for example, the Quick Capture interface on PXA270
10  * SoCs. Later it should also be used for i.MX31 SoCs from Freescale.
11  * It can handle multiple cameras and / or multiple busses, which can
12  * be used, e.g., in stereo-vision applications.
13  *
14  * This program is free software; you can redistribute it and/or modify
15  * it under the terms of the GNU General Public License version 2 as
16  * published by the Free Software Foundation.
17  */
18 
19 #include <linux/device.h>
20 #include <linux/err.h>
21 #include <linux/i2c.h>
22 #include <linux/init.h>
23 #include <linux/list.h>
24 #include <linux/module.h>
25 #include <linux/mutex.h>
26 #include <linux/of_graph.h>
27 #include <linux/platform_device.h>
28 #include <linux/pm_runtime.h>
29 #include <linux/regulator/consumer.h>
30 #include <linux/slab.h>
31 #include <linux/vmalloc.h>
32 
33 #include <media/soc_camera.h>
34 #include <media/drv-intf/soc_mediabus.h>
35 #include <media/v4l2-async.h>
36 #include <media/v4l2-clk.h>
37 #include <media/v4l2-common.h>
38 #include <media/v4l2-ioctl.h>
39 #include <media/v4l2-dev.h>
40 #include <media/v4l2-fwnode.h>
41 #include <media/videobuf2-v4l2.h>
42 
43 /* Default to VGA resolution */
44 #define DEFAULT_WIDTH	640
45 #define DEFAULT_HEIGHT	480
46 
47 #define MAP_MAX_NUM 32
48 static DECLARE_BITMAP(device_map, MAP_MAX_NUM);
49 static LIST_HEAD(hosts);
50 static LIST_HEAD(devices);
51 /*
52  * Protects lists and bitmaps of hosts and devices.
53  * Lock nesting: Ok to take ->host_lock under list_lock.
54  */
55 static DEFINE_MUTEX(list_lock);
56 
57 struct soc_camera_async_client {
58 	struct v4l2_async_subdev *sensor;
59 	struct v4l2_async_notifier notifier;
60 	struct platform_device *pdev;
61 	struct list_head list;		/* needed for clean up */
62 };
63 
64 static int soc_camera_video_start(struct soc_camera_device *icd);
65 static int video_dev_create(struct soc_camera_device *icd);
66 
soc_camera_power_on(struct device * dev,struct soc_camera_subdev_desc * ssdd,struct v4l2_clk * clk)67 int soc_camera_power_on(struct device *dev, struct soc_camera_subdev_desc *ssdd,
68 			struct v4l2_clk *clk)
69 {
70 	int ret;
71 	bool clock_toggle;
72 
73 	if (clk && (!ssdd->unbalanced_power ||
74 		    !test_and_set_bit(0, &ssdd->clock_state))) {
75 		ret = v4l2_clk_enable(clk);
76 		if (ret < 0) {
77 			dev_err(dev, "Cannot enable clock: %d\n", ret);
78 			return ret;
79 		}
80 		clock_toggle = true;
81 	} else {
82 		clock_toggle = false;
83 	}
84 
85 	ret = regulator_bulk_enable(ssdd->sd_pdata.num_regulators,
86 				    ssdd->sd_pdata.regulators);
87 	if (ret < 0) {
88 		dev_err(dev, "Cannot enable regulators\n");
89 		goto eregenable;
90 	}
91 
92 	if (ssdd->power) {
93 		ret = ssdd->power(dev, 1);
94 		if (ret < 0) {
95 			dev_err(dev,
96 				"Platform failed to power-on the camera.\n");
97 			goto epwron;
98 		}
99 	}
100 
101 	return 0;
102 
103 epwron:
104 	regulator_bulk_disable(ssdd->sd_pdata.num_regulators,
105 			       ssdd->sd_pdata.regulators);
106 eregenable:
107 	if (clock_toggle)
108 		v4l2_clk_disable(clk);
109 
110 	return ret;
111 }
112 EXPORT_SYMBOL(soc_camera_power_on);
113 
soc_camera_power_off(struct device * dev,struct soc_camera_subdev_desc * ssdd,struct v4l2_clk * clk)114 int soc_camera_power_off(struct device *dev, struct soc_camera_subdev_desc *ssdd,
115 			 struct v4l2_clk *clk)
116 {
117 	int ret = 0;
118 	int err;
119 
120 	if (ssdd->power) {
121 		err = ssdd->power(dev, 0);
122 		if (err < 0) {
123 			dev_err(dev,
124 				"Platform failed to power-off the camera.\n");
125 			ret = err;
126 		}
127 	}
128 
129 	err = regulator_bulk_disable(ssdd->sd_pdata.num_regulators,
130 				     ssdd->sd_pdata.regulators);
131 	if (err < 0) {
132 		dev_err(dev, "Cannot disable regulators\n");
133 		ret = ret ? : err;
134 	}
135 
136 	if (clk && (!ssdd->unbalanced_power || test_and_clear_bit(0, &ssdd->clock_state)))
137 		v4l2_clk_disable(clk);
138 
139 	return ret;
140 }
141 EXPORT_SYMBOL(soc_camera_power_off);
142 
soc_camera_power_init(struct device * dev,struct soc_camera_subdev_desc * ssdd)143 int soc_camera_power_init(struct device *dev, struct soc_camera_subdev_desc *ssdd)
144 {
145 	/* Should not have any effect in synchronous case */
146 	return devm_regulator_bulk_get(dev, ssdd->sd_pdata.num_regulators,
147 				       ssdd->sd_pdata.regulators);
148 }
149 EXPORT_SYMBOL(soc_camera_power_init);
150 
__soc_camera_power_on(struct soc_camera_device * icd)151 static int __soc_camera_power_on(struct soc_camera_device *icd)
152 {
153 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
154 	int ret;
155 
156 	ret = v4l2_subdev_call(sd, core, s_power, 1);
157 	if (ret < 0 && ret != -ENOIOCTLCMD && ret != -ENODEV)
158 		return ret;
159 
160 	return 0;
161 }
162 
__soc_camera_power_off(struct soc_camera_device * icd)163 static int __soc_camera_power_off(struct soc_camera_device *icd)
164 {
165 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
166 	int ret;
167 
168 	ret = v4l2_subdev_call(sd, core, s_power, 0);
169 	if (ret < 0 && ret != -ENOIOCTLCMD && ret != -ENODEV)
170 		return ret;
171 
172 	return 0;
173 }
174 
soc_camera_clock_start(struct soc_camera_host * ici)175 static int soc_camera_clock_start(struct soc_camera_host *ici)
176 {
177 	int ret;
178 
179 	if (!ici->ops->clock_start)
180 		return 0;
181 
182 	mutex_lock(&ici->clk_lock);
183 	ret = ici->ops->clock_start(ici);
184 	mutex_unlock(&ici->clk_lock);
185 
186 	return ret;
187 }
188 
soc_camera_clock_stop(struct soc_camera_host * ici)189 static void soc_camera_clock_stop(struct soc_camera_host *ici)
190 {
191 	if (!ici->ops->clock_stop)
192 		return;
193 
194 	mutex_lock(&ici->clk_lock);
195 	ici->ops->clock_stop(ici);
196 	mutex_unlock(&ici->clk_lock);
197 }
198 
soc_camera_xlate_by_fourcc(struct soc_camera_device * icd,unsigned int fourcc)199 const struct soc_camera_format_xlate *soc_camera_xlate_by_fourcc(
200 	struct soc_camera_device *icd, unsigned int fourcc)
201 {
202 	unsigned int i;
203 
204 	for (i = 0; i < icd->num_user_formats; i++)
205 		if (icd->user_formats[i].host_fmt->fourcc == fourcc)
206 			return icd->user_formats + i;
207 	return NULL;
208 }
209 EXPORT_SYMBOL(soc_camera_xlate_by_fourcc);
210 
211 /**
212  * soc_camera_apply_board_flags() - apply platform SOCAM_SENSOR_INVERT_* flags
213  * @ssdd:	camera platform parameters
214  * @cfg:	media bus configuration
215  * @return:	resulting flags
216  */
soc_camera_apply_board_flags(struct soc_camera_subdev_desc * ssdd,const struct v4l2_mbus_config * cfg)217 unsigned long soc_camera_apply_board_flags(struct soc_camera_subdev_desc *ssdd,
218 					   const struct v4l2_mbus_config *cfg)
219 {
220 	unsigned long f, flags = cfg->flags;
221 
222 	/* If only one of the two polarities is supported, switch to the opposite */
223 	if (ssdd->flags & SOCAM_SENSOR_INVERT_HSYNC) {
224 		f = flags & (V4L2_MBUS_HSYNC_ACTIVE_HIGH | V4L2_MBUS_HSYNC_ACTIVE_LOW);
225 		if (f == V4L2_MBUS_HSYNC_ACTIVE_HIGH || f == V4L2_MBUS_HSYNC_ACTIVE_LOW)
226 			flags ^= V4L2_MBUS_HSYNC_ACTIVE_HIGH | V4L2_MBUS_HSYNC_ACTIVE_LOW;
227 	}
228 
229 	if (ssdd->flags & SOCAM_SENSOR_INVERT_VSYNC) {
230 		f = flags & (V4L2_MBUS_VSYNC_ACTIVE_HIGH | V4L2_MBUS_VSYNC_ACTIVE_LOW);
231 		if (f == V4L2_MBUS_VSYNC_ACTIVE_HIGH || f == V4L2_MBUS_VSYNC_ACTIVE_LOW)
232 			flags ^= V4L2_MBUS_VSYNC_ACTIVE_HIGH | V4L2_MBUS_VSYNC_ACTIVE_LOW;
233 	}
234 
235 	if (ssdd->flags & SOCAM_SENSOR_INVERT_PCLK) {
236 		f = flags & (V4L2_MBUS_PCLK_SAMPLE_RISING | V4L2_MBUS_PCLK_SAMPLE_FALLING);
237 		if (f == V4L2_MBUS_PCLK_SAMPLE_RISING || f == V4L2_MBUS_PCLK_SAMPLE_FALLING)
238 			flags ^= V4L2_MBUS_PCLK_SAMPLE_RISING | V4L2_MBUS_PCLK_SAMPLE_FALLING;
239 	}
240 
241 	return flags;
242 }
243 EXPORT_SYMBOL(soc_camera_apply_board_flags);
244 
245 #define pixfmtstr(x) (x) & 0xff, ((x) >> 8) & 0xff, ((x) >> 16) & 0xff, \
246 	((x) >> 24) & 0xff
247 
soc_camera_try_fmt(struct soc_camera_device * icd,struct v4l2_format * f)248 static int soc_camera_try_fmt(struct soc_camera_device *icd,
249 			      struct v4l2_format *f)
250 {
251 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
252 	const struct soc_camera_format_xlate *xlate;
253 	struct v4l2_pix_format *pix = &f->fmt.pix;
254 	int ret;
255 
256 	dev_dbg(icd->pdev, "TRY_FMT(%c%c%c%c, %ux%u)\n",
257 		pixfmtstr(pix->pixelformat), pix->width, pix->height);
258 
259 	if (pix->pixelformat != V4L2_PIX_FMT_JPEG &&
260 	    !(ici->capabilities & SOCAM_HOST_CAP_STRIDE)) {
261 		pix->bytesperline = 0;
262 		pix->sizeimage = 0;
263 	}
264 
265 	ret = ici->ops->try_fmt(icd, f);
266 	if (ret < 0)
267 		return ret;
268 
269 	xlate = soc_camera_xlate_by_fourcc(icd, pix->pixelformat);
270 	if (!xlate)
271 		return -EINVAL;
272 
273 	ret = soc_mbus_bytes_per_line(pix->width, xlate->host_fmt);
274 	if (ret < 0)
275 		return ret;
276 
277 	pix->bytesperline = max_t(u32, pix->bytesperline, ret);
278 
279 	ret = soc_mbus_image_size(xlate->host_fmt, pix->bytesperline,
280 				  pix->height);
281 	if (ret < 0)
282 		return ret;
283 
284 	pix->sizeimage = max_t(u32, pix->sizeimage, ret);
285 
286 	return 0;
287 }
288 
soc_camera_try_fmt_vid_cap(struct file * file,void * priv,struct v4l2_format * f)289 static int soc_camera_try_fmt_vid_cap(struct file *file, void *priv,
290 				      struct v4l2_format *f)
291 {
292 	struct soc_camera_device *icd = file->private_data;
293 
294 	WARN_ON(priv != file->private_data);
295 
296 	/* Only single-plane capture is supported so far */
297 	if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
298 		return -EINVAL;
299 
300 	/* limit format to hardware capabilities */
301 	return soc_camera_try_fmt(icd, f);
302 }
303 
soc_camera_enum_input(struct file * file,void * priv,struct v4l2_input * inp)304 static int soc_camera_enum_input(struct file *file, void *priv,
305 				 struct v4l2_input *inp)
306 {
307 	struct soc_camera_device *icd = file->private_data;
308 
309 	if (inp->index != 0)
310 		return -EINVAL;
311 
312 	/* default is camera */
313 	inp->type = V4L2_INPUT_TYPE_CAMERA;
314 	inp->std = icd->vdev->tvnorms;
315 	strcpy(inp->name, "Camera");
316 
317 	return 0;
318 }
319 
soc_camera_g_input(struct file * file,void * priv,unsigned int * i)320 static int soc_camera_g_input(struct file *file, void *priv, unsigned int *i)
321 {
322 	*i = 0;
323 
324 	return 0;
325 }
326 
soc_camera_s_input(struct file * file,void * priv,unsigned int i)327 static int soc_camera_s_input(struct file *file, void *priv, unsigned int i)
328 {
329 	if (i > 0)
330 		return -EINVAL;
331 
332 	return 0;
333 }
334 
soc_camera_s_std(struct file * file,void * priv,v4l2_std_id a)335 static int soc_camera_s_std(struct file *file, void *priv, v4l2_std_id a)
336 {
337 	struct soc_camera_device *icd = file->private_data;
338 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
339 
340 	return v4l2_subdev_call(sd, video, s_std, a);
341 }
342 
soc_camera_g_std(struct file * file,void * priv,v4l2_std_id * a)343 static int soc_camera_g_std(struct file *file, void *priv, v4l2_std_id *a)
344 {
345 	struct soc_camera_device *icd = file->private_data;
346 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
347 
348 	return v4l2_subdev_call(sd, video, g_std, a);
349 }
350 
soc_camera_enum_framesizes(struct file * file,void * fh,struct v4l2_frmsizeenum * fsize)351 static int soc_camera_enum_framesizes(struct file *file, void *fh,
352 					 struct v4l2_frmsizeenum *fsize)
353 {
354 	struct soc_camera_device *icd = file->private_data;
355 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
356 
357 	return ici->ops->enum_framesizes(icd, fsize);
358 }
359 
soc_camera_reqbufs(struct file * file,void * priv,struct v4l2_requestbuffers * p)360 static int soc_camera_reqbufs(struct file *file, void *priv,
361 			      struct v4l2_requestbuffers *p)
362 {
363 	int ret;
364 	struct soc_camera_device *icd = file->private_data;
365 
366 	WARN_ON(priv != file->private_data);
367 
368 	if (icd->streamer && icd->streamer != file)
369 		return -EBUSY;
370 
371 	ret = vb2_reqbufs(&icd->vb2_vidq, p);
372 	if (!ret)
373 		icd->streamer = p->count ? file : NULL;
374 	return ret;
375 }
376 
soc_camera_querybuf(struct file * file,void * priv,struct v4l2_buffer * p)377 static int soc_camera_querybuf(struct file *file, void *priv,
378 			       struct v4l2_buffer *p)
379 {
380 	struct soc_camera_device *icd = file->private_data;
381 
382 	WARN_ON(priv != file->private_data);
383 
384 	return vb2_querybuf(&icd->vb2_vidq, p);
385 }
386 
soc_camera_qbuf(struct file * file,void * priv,struct v4l2_buffer * p)387 static int soc_camera_qbuf(struct file *file, void *priv,
388 			   struct v4l2_buffer *p)
389 {
390 	struct soc_camera_device *icd = file->private_data;
391 
392 	WARN_ON(priv != file->private_data);
393 
394 	if (icd->streamer != file)
395 		return -EBUSY;
396 
397 	return vb2_qbuf(&icd->vb2_vidq, p);
398 }
399 
soc_camera_dqbuf(struct file * file,void * priv,struct v4l2_buffer * p)400 static int soc_camera_dqbuf(struct file *file, void *priv,
401 			    struct v4l2_buffer *p)
402 {
403 	struct soc_camera_device *icd = file->private_data;
404 
405 	WARN_ON(priv != file->private_data);
406 
407 	if (icd->streamer != file)
408 		return -EBUSY;
409 
410 	return vb2_dqbuf(&icd->vb2_vidq, p, file->f_flags & O_NONBLOCK);
411 }
412 
soc_camera_create_bufs(struct file * file,void * priv,struct v4l2_create_buffers * create)413 static int soc_camera_create_bufs(struct file *file, void *priv,
414 			    struct v4l2_create_buffers *create)
415 {
416 	struct soc_camera_device *icd = file->private_data;
417 	int ret;
418 
419 	if (icd->streamer && icd->streamer != file)
420 		return -EBUSY;
421 
422 	ret = vb2_create_bufs(&icd->vb2_vidq, create);
423 	if (!ret)
424 		icd->streamer = file;
425 	return ret;
426 }
427 
soc_camera_prepare_buf(struct file * file,void * priv,struct v4l2_buffer * b)428 static int soc_camera_prepare_buf(struct file *file, void *priv,
429 				  struct v4l2_buffer *b)
430 {
431 	struct soc_camera_device *icd = file->private_data;
432 
433 	return vb2_prepare_buf(&icd->vb2_vidq, b);
434 }
435 
soc_camera_expbuf(struct file * file,void * priv,struct v4l2_exportbuffer * p)436 static int soc_camera_expbuf(struct file *file, void *priv,
437 			     struct v4l2_exportbuffer *p)
438 {
439 	struct soc_camera_device *icd = file->private_data;
440 
441 	if (icd->streamer && icd->streamer != file)
442 		return -EBUSY;
443 	return vb2_expbuf(&icd->vb2_vidq, p);
444 }
445 
446 /* Always entered with .host_lock held */
soc_camera_init_user_formats(struct soc_camera_device * icd)447 static int soc_camera_init_user_formats(struct soc_camera_device *icd)
448 {
449 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
450 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
451 	unsigned int i, fmts = 0, raw_fmts = 0;
452 	int ret;
453 	struct v4l2_subdev_mbus_code_enum code = {
454 		.which = V4L2_SUBDEV_FORMAT_ACTIVE,
455 	};
456 
457 	while (!v4l2_subdev_call(sd, pad, enum_mbus_code, NULL, &code)) {
458 		raw_fmts++;
459 		code.index++;
460 	}
461 
462 	if (!ici->ops->get_formats)
463 		/*
464 		 * Fallback mode - the host will have to serve all
465 		 * sensor-provided formats one-to-one to the user
466 		 */
467 		fmts = raw_fmts;
468 	else
469 		/*
470 		 * First pass - only count formats this host-sensor
471 		 * configuration can provide
472 		 */
473 		for (i = 0; i < raw_fmts; i++) {
474 			ret = ici->ops->get_formats(icd, i, NULL);
475 			if (ret < 0)
476 				return ret;
477 			fmts += ret;
478 		}
479 
480 	if (!fmts)
481 		return -ENXIO;
482 
483 	icd->user_formats =
484 		vmalloc(array_size(fmts,
485 				   sizeof(struct soc_camera_format_xlate)));
486 	if (!icd->user_formats)
487 		return -ENOMEM;
488 
489 	dev_dbg(icd->pdev, "Found %d supported formats.\n", fmts);
490 
491 	/* Second pass - actually fill data formats */
492 	fmts = 0;
493 	for (i = 0; i < raw_fmts; i++)
494 		if (!ici->ops->get_formats) {
495 			code.index = i;
496 			v4l2_subdev_call(sd, pad, enum_mbus_code, NULL, &code);
497 			icd->user_formats[fmts].host_fmt =
498 				soc_mbus_get_fmtdesc(code.code);
499 			if (icd->user_formats[fmts].host_fmt)
500 				icd->user_formats[fmts++].code = code.code;
501 		} else {
502 			ret = ici->ops->get_formats(icd, i,
503 						    &icd->user_formats[fmts]);
504 			if (ret < 0)
505 				goto egfmt;
506 			fmts += ret;
507 		}
508 
509 	icd->num_user_formats = fmts;
510 	icd->current_fmt = &icd->user_formats[0];
511 
512 	return 0;
513 
514 egfmt:
515 	vfree(icd->user_formats);
516 	return ret;
517 }
518 
519 /* Always entered with .host_lock held */
soc_camera_free_user_formats(struct soc_camera_device * icd)520 static void soc_camera_free_user_formats(struct soc_camera_device *icd)
521 {
522 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
523 
524 	if (ici->ops->put_formats)
525 		ici->ops->put_formats(icd);
526 	icd->current_fmt = NULL;
527 	icd->num_user_formats = 0;
528 	vfree(icd->user_formats);
529 	icd->user_formats = NULL;
530 }
531 
532 /* Called with .vb_lock held, or from the first open(2), see comment there */
soc_camera_set_fmt(struct soc_camera_device * icd,struct v4l2_format * f)533 static int soc_camera_set_fmt(struct soc_camera_device *icd,
534 			      struct v4l2_format *f)
535 {
536 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
537 	struct v4l2_pix_format *pix = &f->fmt.pix;
538 	int ret;
539 
540 	dev_dbg(icd->pdev, "S_FMT(%c%c%c%c, %ux%u)\n",
541 		pixfmtstr(pix->pixelformat), pix->width, pix->height);
542 
543 	/* We always call try_fmt() before set_fmt() or set_selection() */
544 	ret = soc_camera_try_fmt(icd, f);
545 	if (ret < 0)
546 		return ret;
547 
548 	ret = ici->ops->set_fmt(icd, f);
549 	if (ret < 0) {
550 		return ret;
551 	} else if (!icd->current_fmt ||
552 		   icd->current_fmt->host_fmt->fourcc != pix->pixelformat) {
553 		dev_err(icd->pdev,
554 			"Host driver hasn't set up current format correctly!\n");
555 		return -EINVAL;
556 	}
557 
558 	icd->user_width		= pix->width;
559 	icd->user_height	= pix->height;
560 	icd->bytesperline	= pix->bytesperline;
561 	icd->sizeimage		= pix->sizeimage;
562 	icd->colorspace		= pix->colorspace;
563 	icd->field		= pix->field;
564 
565 	dev_dbg(icd->pdev, "set width: %d height: %d\n",
566 		icd->user_width, icd->user_height);
567 
568 	/* set physical bus parameters */
569 	return ici->ops->set_bus_param(icd);
570 }
571 
soc_camera_add_device(struct soc_camera_device * icd)572 static int soc_camera_add_device(struct soc_camera_device *icd)
573 {
574 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
575 	int ret;
576 
577 	if (ici->icd)
578 		return -EBUSY;
579 
580 	if (!icd->clk) {
581 		ret = soc_camera_clock_start(ici);
582 		if (ret < 0)
583 			return ret;
584 	}
585 
586 	if (ici->ops->add) {
587 		ret = ici->ops->add(icd);
588 		if (ret < 0)
589 			goto eadd;
590 	}
591 
592 	ici->icd = icd;
593 
594 	return 0;
595 
596 eadd:
597 	if (!icd->clk)
598 		soc_camera_clock_stop(ici);
599 	return ret;
600 }
601 
soc_camera_remove_device(struct soc_camera_device * icd)602 static void soc_camera_remove_device(struct soc_camera_device *icd)
603 {
604 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
605 
606 	if (WARN_ON(icd != ici->icd))
607 		return;
608 
609 	if (ici->ops->remove)
610 		ici->ops->remove(icd);
611 	if (!icd->clk)
612 		soc_camera_clock_stop(ici);
613 	ici->icd = NULL;
614 }
615 
soc_camera_open(struct file * file)616 static int soc_camera_open(struct file *file)
617 {
618 	struct video_device *vdev = video_devdata(file);
619 	struct soc_camera_device *icd;
620 	struct soc_camera_host *ici;
621 	int ret;
622 
623 	/*
624 	 * Don't mess with the host during probe: wait until the loop in
625 	 * scan_add_host() completes. Also protect against a race with
626 	 * soc_camera_host_unregister().
627 	 */
628 	if (mutex_lock_interruptible(&list_lock))
629 		return -ERESTARTSYS;
630 
631 	if (!vdev || !video_is_registered(vdev)) {
632 		mutex_unlock(&list_lock);
633 		return -ENODEV;
634 	}
635 
636 	icd = video_get_drvdata(vdev);
637 	ici = to_soc_camera_host(icd->parent);
638 
639 	ret = try_module_get(ici->ops->owner) ? 0 : -ENODEV;
640 	mutex_unlock(&list_lock);
641 
642 	if (ret < 0) {
643 		dev_err(icd->pdev, "Couldn't lock capture bus driver.\n");
644 		return ret;
645 	}
646 
647 	if (!to_soc_camera_control(icd)) {
648 		/* No device driver attached */
649 		ret = -ENODEV;
650 		goto econtrol;
651 	}
652 
653 	if (mutex_lock_interruptible(&ici->host_lock)) {
654 		ret = -ERESTARTSYS;
655 		goto elockhost;
656 	}
657 	icd->use_count++;
658 
659 	/* Now we really have to activate the camera */
660 	if (icd->use_count == 1) {
661 		struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
662 		/* Restore parameters before the last close() per V4L2 API */
663 		struct v4l2_format f = {
664 			.type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
665 			.fmt.pix = {
666 				.width		= icd->user_width,
667 				.height		= icd->user_height,
668 				.field		= icd->field,
669 				.colorspace	= icd->colorspace,
670 				.pixelformat	=
671 					icd->current_fmt->host_fmt->fourcc,
672 			},
673 		};
674 
675 		/* The camera could have been already on, try to reset */
676 		if (sdesc->subdev_desc.reset)
677 			if (icd->control)
678 				sdesc->subdev_desc.reset(icd->control);
679 
680 		ret = soc_camera_add_device(icd);
681 		if (ret < 0) {
682 			dev_err(icd->pdev, "Couldn't activate the camera: %d\n", ret);
683 			goto eiciadd;
684 		}
685 
686 		ret = __soc_camera_power_on(icd);
687 		if (ret < 0)
688 			goto epower;
689 
690 		pm_runtime_enable(&icd->vdev->dev);
691 		ret = pm_runtime_resume(&icd->vdev->dev);
692 		if (ret < 0 && ret != -ENOSYS)
693 			goto eresume;
694 
695 		/*
696 		 * Try to configure with default parameters. Notice: this is the
697 		 * very first open, so, we cannot race against other calls,
698 		 * apart from someone else calling open() simultaneously, but
699 		 * .host_lock is protecting us against it.
700 		 */
701 		ret = soc_camera_set_fmt(icd, &f);
702 		if (ret < 0)
703 			goto esfmt;
704 
705 		ret = ici->ops->init_videobuf2(&icd->vb2_vidq, icd);
706 		if (ret < 0)
707 			goto einitvb;
708 		v4l2_ctrl_handler_setup(&icd->ctrl_handler);
709 	}
710 	mutex_unlock(&ici->host_lock);
711 
712 	file->private_data = icd;
713 	dev_dbg(icd->pdev, "camera device open\n");
714 
715 	return 0;
716 
717 	/*
718 	 * All errors are entered with the .host_lock held, first four also
719 	 * with use_count == 1
720 	 */
721 einitvb:
722 esfmt:
723 	pm_runtime_disable(&icd->vdev->dev);
724 eresume:
725 	__soc_camera_power_off(icd);
726 epower:
727 	soc_camera_remove_device(icd);
728 eiciadd:
729 	icd->use_count--;
730 	mutex_unlock(&ici->host_lock);
731 elockhost:
732 econtrol:
733 	module_put(ici->ops->owner);
734 
735 	return ret;
736 }
737 
soc_camera_close(struct file * file)738 static int soc_camera_close(struct file *file)
739 {
740 	struct soc_camera_device *icd = file->private_data;
741 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
742 
743 	mutex_lock(&ici->host_lock);
744 	if (icd->streamer == file) {
745 		if (ici->ops->init_videobuf2)
746 			vb2_queue_release(&icd->vb2_vidq);
747 		icd->streamer = NULL;
748 	}
749 	icd->use_count--;
750 	if (!icd->use_count) {
751 		pm_runtime_suspend(&icd->vdev->dev);
752 		pm_runtime_disable(&icd->vdev->dev);
753 
754 		__soc_camera_power_off(icd);
755 
756 		soc_camera_remove_device(icd);
757 	}
758 
759 	mutex_unlock(&ici->host_lock);
760 
761 	module_put(ici->ops->owner);
762 
763 	dev_dbg(icd->pdev, "camera device close\n");
764 
765 	return 0;
766 }
767 
soc_camera_read(struct file * file,char __user * buf,size_t count,loff_t * ppos)768 static ssize_t soc_camera_read(struct file *file, char __user *buf,
769 			       size_t count, loff_t *ppos)
770 {
771 	struct soc_camera_device *icd = file->private_data;
772 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
773 
774 	dev_dbg(icd->pdev, "read called, buf %p\n", buf);
775 
776 	if (ici->ops->init_videobuf2 && icd->vb2_vidq.io_modes & VB2_READ)
777 		return vb2_read(&icd->vb2_vidq, buf, count, ppos,
778 				file->f_flags & O_NONBLOCK);
779 
780 	dev_err(icd->pdev, "camera device read not implemented\n");
781 
782 	return -EINVAL;
783 }
784 
soc_camera_mmap(struct file * file,struct vm_area_struct * vma)785 static int soc_camera_mmap(struct file *file, struct vm_area_struct *vma)
786 {
787 	struct soc_camera_device *icd = file->private_data;
788 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
789 	int err;
790 
791 	dev_dbg(icd->pdev, "mmap called, vma=%p\n", vma);
792 
793 	if (icd->streamer != file)
794 		return -EBUSY;
795 
796 	if (mutex_lock_interruptible(&ici->host_lock))
797 		return -ERESTARTSYS;
798 	err = vb2_mmap(&icd->vb2_vidq, vma);
799 	mutex_unlock(&ici->host_lock);
800 
801 	dev_dbg(icd->pdev, "vma start=0x%08lx, size=%ld, ret=%d\n",
802 		(unsigned long)vma->vm_start,
803 		(unsigned long)vma->vm_end - (unsigned long)vma->vm_start,
804 		err);
805 
806 	return err;
807 }
808 
soc_camera_poll(struct file * file,poll_table * pt)809 static __poll_t soc_camera_poll(struct file *file, poll_table *pt)
810 {
811 	struct soc_camera_device *icd = file->private_data;
812 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
813 	__poll_t res = EPOLLERR;
814 
815 	if (icd->streamer != file)
816 		return EPOLLERR;
817 
818 	mutex_lock(&ici->host_lock);
819 	res = ici->ops->poll(file, pt);
820 	mutex_unlock(&ici->host_lock);
821 	return res;
822 }
823 
824 static const struct v4l2_file_operations soc_camera_fops = {
825 	.owner		= THIS_MODULE,
826 	.open		= soc_camera_open,
827 	.release	= soc_camera_close,
828 	.unlocked_ioctl	= video_ioctl2,
829 	.read		= soc_camera_read,
830 	.mmap		= soc_camera_mmap,
831 	.poll		= soc_camera_poll,
832 };
833 
soc_camera_s_fmt_vid_cap(struct file * file,void * priv,struct v4l2_format * f)834 static int soc_camera_s_fmt_vid_cap(struct file *file, void *priv,
835 				    struct v4l2_format *f)
836 {
837 	struct soc_camera_device *icd = file->private_data;
838 	int ret;
839 
840 	WARN_ON(priv != file->private_data);
841 
842 	if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) {
843 		dev_warn(icd->pdev, "Wrong buf-type %d\n", f->type);
844 		return -EINVAL;
845 	}
846 
847 	if (icd->streamer && icd->streamer != file)
848 		return -EBUSY;
849 
850 	if (vb2_is_streaming(&icd->vb2_vidq)) {
851 		dev_err(icd->pdev, "S_FMT denied: queue initialised\n");
852 		return -EBUSY;
853 	}
854 
855 	ret = soc_camera_set_fmt(icd, f);
856 
857 	if (!ret && !icd->streamer)
858 		icd->streamer = file;
859 
860 	return ret;
861 }
862 
soc_camera_enum_fmt_vid_cap(struct file * file,void * priv,struct v4l2_fmtdesc * f)863 static int soc_camera_enum_fmt_vid_cap(struct file *file, void  *priv,
864 				       struct v4l2_fmtdesc *f)
865 {
866 	struct soc_camera_device *icd = file->private_data;
867 	const struct soc_mbus_pixelfmt *format;
868 
869 	WARN_ON(priv != file->private_data);
870 
871 	if (f->index >= icd->num_user_formats)
872 		return -EINVAL;
873 
874 	format = icd->user_formats[f->index].host_fmt;
875 
876 	if (format->name)
877 		strlcpy(f->description, format->name, sizeof(f->description));
878 	f->pixelformat = format->fourcc;
879 	return 0;
880 }
881 
soc_camera_g_fmt_vid_cap(struct file * file,void * priv,struct v4l2_format * f)882 static int soc_camera_g_fmt_vid_cap(struct file *file, void *priv,
883 				    struct v4l2_format *f)
884 {
885 	struct soc_camera_device *icd = file->private_data;
886 	struct v4l2_pix_format *pix = &f->fmt.pix;
887 
888 	WARN_ON(priv != file->private_data);
889 
890 	if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
891 		return -EINVAL;
892 
893 	pix->width		= icd->user_width;
894 	pix->height		= icd->user_height;
895 	pix->bytesperline	= icd->bytesperline;
896 	pix->sizeimage		= icd->sizeimage;
897 	pix->field		= icd->field;
898 	pix->pixelformat	= icd->current_fmt->host_fmt->fourcc;
899 	pix->colorspace		= icd->colorspace;
900 	dev_dbg(icd->pdev, "current_fmt->fourcc: 0x%08x\n",
901 		icd->current_fmt->host_fmt->fourcc);
902 	return 0;
903 }
904 
soc_camera_querycap(struct file * file,void * priv,struct v4l2_capability * cap)905 static int soc_camera_querycap(struct file *file, void  *priv,
906 			       struct v4l2_capability *cap)
907 {
908 	struct soc_camera_device *icd = file->private_data;
909 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
910 
911 	WARN_ON(priv != file->private_data);
912 
913 	strlcpy(cap->driver, ici->drv_name, sizeof(cap->driver));
914 	return ici->ops->querycap(ici, cap);
915 }
916 
soc_camera_streamon(struct file * file,void * priv,enum v4l2_buf_type i)917 static int soc_camera_streamon(struct file *file, void *priv,
918 			       enum v4l2_buf_type i)
919 {
920 	struct soc_camera_device *icd = file->private_data;
921 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
922 	int ret;
923 
924 	WARN_ON(priv != file->private_data);
925 
926 	if (i != V4L2_BUF_TYPE_VIDEO_CAPTURE)
927 		return -EINVAL;
928 
929 	if (icd->streamer != file)
930 		return -EBUSY;
931 
932 	/* This calls buf_queue from host driver's videobuf2_queue_ops */
933 	ret = vb2_streamon(&icd->vb2_vidq, i);
934 	if (!ret)
935 		v4l2_subdev_call(sd, video, s_stream, 1);
936 
937 	return ret;
938 }
939 
soc_camera_streamoff(struct file * file,void * priv,enum v4l2_buf_type i)940 static int soc_camera_streamoff(struct file *file, void *priv,
941 				enum v4l2_buf_type i)
942 {
943 	struct soc_camera_device *icd = file->private_data;
944 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
945 	int ret;
946 
947 	WARN_ON(priv != file->private_data);
948 
949 	if (i != V4L2_BUF_TYPE_VIDEO_CAPTURE)
950 		return -EINVAL;
951 
952 	if (icd->streamer != file)
953 		return -EBUSY;
954 
955 	/*
956 	 * This calls buf_release from host driver's videobuf2_queue_ops for all
957 	 * remaining buffers. When the last buffer is freed, stop capture
958 	 */
959 	ret = vb2_streamoff(&icd->vb2_vidq, i);
960 
961 	v4l2_subdev_call(sd, video, s_stream, 0);
962 
963 	return ret;
964 }
965 
soc_camera_g_selection(struct file * file,void * fh,struct v4l2_selection * s)966 static int soc_camera_g_selection(struct file *file, void *fh,
967 				  struct v4l2_selection *s)
968 {
969 	struct soc_camera_device *icd = file->private_data;
970 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
971 
972 	/* With a wrong type no need to try to fall back to cropping */
973 	if (s->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
974 		return -EINVAL;
975 
976 	return ici->ops->get_selection(icd, s);
977 }
978 
soc_camera_s_selection(struct file * file,void * fh,struct v4l2_selection * s)979 static int soc_camera_s_selection(struct file *file, void *fh,
980 				  struct v4l2_selection *s)
981 {
982 	struct soc_camera_device *icd = file->private_data;
983 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
984 	int ret;
985 
986 	/* In all these cases cropping emulation will not help */
987 	if (s->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
988 	    (s->target != V4L2_SEL_TGT_COMPOSE &&
989 	     s->target != V4L2_SEL_TGT_CROP))
990 		return -EINVAL;
991 
992 	if (s->target == V4L2_SEL_TGT_COMPOSE) {
993 		/* No output size change during a running capture! */
994 		if (vb2_is_streaming(&icd->vb2_vidq) &&
995 		    (icd->user_width != s->r.width ||
996 		     icd->user_height != s->r.height))
997 			return -EBUSY;
998 
999 		/*
1000 		 * Only one user is allowed to change the output format, touch
1001 		 * buffers, start / stop streaming, poll for data
1002 		 */
1003 		if (icd->streamer && icd->streamer != file)
1004 			return -EBUSY;
1005 	}
1006 
1007 	if (s->target == V4L2_SEL_TGT_CROP &&
1008 	    vb2_is_streaming(&icd->vb2_vidq) &&
1009 	    ici->ops->set_liveselection)
1010 		ret = ici->ops->set_liveselection(icd, s);
1011 	else
1012 		ret = ici->ops->set_selection(icd, s);
1013 	if (!ret &&
1014 	    s->target == V4L2_SEL_TGT_COMPOSE) {
1015 		icd->user_width = s->r.width;
1016 		icd->user_height = s->r.height;
1017 		if (!icd->streamer)
1018 			icd->streamer = file;
1019 	}
1020 
1021 	return ret;
1022 }
1023 
soc_camera_g_parm(struct file * file,void * fh,struct v4l2_streamparm * a)1024 static int soc_camera_g_parm(struct file *file, void *fh,
1025 			     struct v4l2_streamparm *a)
1026 {
1027 	struct soc_camera_device *icd = file->private_data;
1028 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
1029 
1030 	if (ici->ops->get_parm)
1031 		return ici->ops->get_parm(icd, a);
1032 
1033 	return -ENOIOCTLCMD;
1034 }
1035 
soc_camera_s_parm(struct file * file,void * fh,struct v4l2_streamparm * a)1036 static int soc_camera_s_parm(struct file *file, void *fh,
1037 			     struct v4l2_streamparm *a)
1038 {
1039 	struct soc_camera_device *icd = file->private_data;
1040 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
1041 
1042 	if (ici->ops->set_parm)
1043 		return ici->ops->set_parm(icd, a);
1044 
1045 	return -ENOIOCTLCMD;
1046 }
1047 
1048 static int soc_camera_probe(struct soc_camera_host *ici,
1049 			    struct soc_camera_device *icd);
1050 
1051 /* So far this function cannot fail */
scan_add_host(struct soc_camera_host * ici)1052 static void scan_add_host(struct soc_camera_host *ici)
1053 {
1054 	struct soc_camera_device *icd;
1055 
1056 	mutex_lock(&list_lock);
1057 
1058 	list_for_each_entry(icd, &devices, list)
1059 		if (icd->iface == ici->nr) {
1060 			struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1061 			struct soc_camera_subdev_desc *ssdd = &sdesc->subdev_desc;
1062 
1063 			/* The camera could have been already on, try to reset */
1064 			if (ssdd->reset)
1065 				if (icd->control)
1066 					ssdd->reset(icd->control);
1067 
1068 			icd->parent = ici->v4l2_dev.dev;
1069 
1070 			/* Ignore errors */
1071 			soc_camera_probe(ici, icd);
1072 		}
1073 
1074 	mutex_unlock(&list_lock);
1075 }
1076 
1077 /*
1078  * It is invalid to call v4l2_clk_enable() after a successful probing
1079  * asynchronously outside of V4L2 operations, i.e. with .host_lock not held.
1080  */
soc_camera_clk_enable(struct v4l2_clk * clk)1081 static int soc_camera_clk_enable(struct v4l2_clk *clk)
1082 {
1083 	struct soc_camera_device *icd = clk->priv;
1084 	struct soc_camera_host *ici;
1085 
1086 	if (!icd || !icd->parent)
1087 		return -ENODEV;
1088 
1089 	ici = to_soc_camera_host(icd->parent);
1090 
1091 	if (!try_module_get(ici->ops->owner))
1092 		return -ENODEV;
1093 
1094 	/*
1095 	 * If a different client is currently being probed, the host will tell
1096 	 * you to go
1097 	 */
1098 	return soc_camera_clock_start(ici);
1099 }
1100 
soc_camera_clk_disable(struct v4l2_clk * clk)1101 static void soc_camera_clk_disable(struct v4l2_clk *clk)
1102 {
1103 	struct soc_camera_device *icd = clk->priv;
1104 	struct soc_camera_host *ici;
1105 
1106 	if (!icd || !icd->parent)
1107 		return;
1108 
1109 	ici = to_soc_camera_host(icd->parent);
1110 
1111 	soc_camera_clock_stop(ici);
1112 
1113 	module_put(ici->ops->owner);
1114 }
1115 
1116 /*
1117  * Eventually, it would be more logical to make the respective host the clock
1118  * owner, but then we would have to copy this struct for each ici. Besides, it
1119  * would introduce the circular dependency problem, unless we port all client
1120  * drivers to release the clock, when not in use.
1121  */
1122 static const struct v4l2_clk_ops soc_camera_clk_ops = {
1123 	.owner = THIS_MODULE,
1124 	.enable = soc_camera_clk_enable,
1125 	.disable = soc_camera_clk_disable,
1126 };
1127 
soc_camera_dyn_pdev(struct soc_camera_desc * sdesc,struct soc_camera_async_client * sasc)1128 static int soc_camera_dyn_pdev(struct soc_camera_desc *sdesc,
1129 			       struct soc_camera_async_client *sasc)
1130 {
1131 	struct platform_device *pdev;
1132 	int ret, i;
1133 
1134 	mutex_lock(&list_lock);
1135 	i = find_first_zero_bit(device_map, MAP_MAX_NUM);
1136 	if (i < MAP_MAX_NUM)
1137 		set_bit(i, device_map);
1138 	mutex_unlock(&list_lock);
1139 	if (i >= MAP_MAX_NUM)
1140 		return -ENOMEM;
1141 
1142 	pdev = platform_device_alloc("soc-camera-pdrv", i);
1143 	if (!pdev)
1144 		return -ENOMEM;
1145 
1146 	ret = platform_device_add_data(pdev, sdesc, sizeof(*sdesc));
1147 	if (ret < 0) {
1148 		platform_device_put(pdev);
1149 		return ret;
1150 	}
1151 
1152 	sasc->pdev = pdev;
1153 
1154 	return 0;
1155 }
1156 
soc_camera_add_pdev(struct soc_camera_async_client * sasc)1157 static struct soc_camera_device *soc_camera_add_pdev(struct soc_camera_async_client *sasc)
1158 {
1159 	struct platform_device *pdev = sasc->pdev;
1160 	int ret;
1161 
1162 	ret = platform_device_add(pdev);
1163 	if (ret < 0 || !pdev->dev.driver)
1164 		return NULL;
1165 
1166 	return platform_get_drvdata(pdev);
1167 }
1168 
1169 /* Locking: called with .host_lock held */
soc_camera_probe_finish(struct soc_camera_device * icd)1170 static int soc_camera_probe_finish(struct soc_camera_device *icd)
1171 {
1172 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1173 	struct v4l2_subdev_format fmt = {
1174 		.which = V4L2_SUBDEV_FORMAT_ACTIVE,
1175 	};
1176 	struct v4l2_mbus_framefmt *mf = &fmt.format;
1177 	int ret;
1178 
1179 	sd->grp_id = soc_camera_grp_id(icd);
1180 	v4l2_set_subdev_hostdata(sd, icd);
1181 
1182 	v4l2_subdev_call(sd, video, g_tvnorms, &icd->vdev->tvnorms);
1183 
1184 	ret = v4l2_ctrl_add_handler(&icd->ctrl_handler, sd->ctrl_handler, NULL);
1185 	if (ret < 0)
1186 		return ret;
1187 
1188 	ret = soc_camera_add_device(icd);
1189 	if (ret < 0) {
1190 		dev_err(icd->pdev, "Couldn't activate the camera: %d\n", ret);
1191 		return ret;
1192 	}
1193 
1194 	/* At this point client .probe() should have run already */
1195 	ret = soc_camera_init_user_formats(icd);
1196 	if (ret < 0)
1197 		goto eusrfmt;
1198 
1199 	icd->field = V4L2_FIELD_ANY;
1200 
1201 	ret = soc_camera_video_start(icd);
1202 	if (ret < 0)
1203 		goto evidstart;
1204 
1205 	/* Try to improve our guess of a reasonable window format */
1206 	if (!v4l2_subdev_call(sd, pad, get_fmt, NULL, &fmt)) {
1207 		icd->user_width		= mf->width;
1208 		icd->user_height	= mf->height;
1209 		icd->colorspace		= mf->colorspace;
1210 		icd->field		= mf->field;
1211 	}
1212 	soc_camera_remove_device(icd);
1213 
1214 	return 0;
1215 
1216 evidstart:
1217 	soc_camera_free_user_formats(icd);
1218 eusrfmt:
1219 	soc_camera_remove_device(icd);
1220 
1221 	return ret;
1222 }
1223 
1224 #ifdef CONFIG_I2C_BOARDINFO
soc_camera_i2c_init(struct soc_camera_device * icd,struct soc_camera_desc * sdesc)1225 static int soc_camera_i2c_init(struct soc_camera_device *icd,
1226 			       struct soc_camera_desc *sdesc)
1227 {
1228 	struct soc_camera_subdev_desc *ssdd;
1229 	struct i2c_client *client;
1230 	struct soc_camera_host *ici;
1231 	struct soc_camera_host_desc *shd = &sdesc->host_desc;
1232 	struct i2c_adapter *adap;
1233 	struct v4l2_subdev *subdev;
1234 	char clk_name[V4L2_CLK_NAME_SIZE];
1235 	int ret;
1236 
1237 	/* First find out how we link the main client */
1238 	if (icd->sasc) {
1239 		/* Async non-OF probing handled by the subdevice list */
1240 		return -EPROBE_DEFER;
1241 	}
1242 
1243 	ici = to_soc_camera_host(icd->parent);
1244 	adap = i2c_get_adapter(shd->i2c_adapter_id);
1245 	if (!adap) {
1246 		dev_err(icd->pdev, "Cannot get I2C adapter #%d. No driver?\n",
1247 			shd->i2c_adapter_id);
1248 		return -ENODEV;
1249 	}
1250 
1251 	ssdd = kmemdup(&sdesc->subdev_desc, sizeof(*ssdd), GFP_KERNEL);
1252 	if (!ssdd) {
1253 		ret = -ENOMEM;
1254 		goto ealloc;
1255 	}
1256 	/*
1257 	 * In synchronous case we request regulators ourselves in
1258 	 * soc_camera_pdrv_probe(), make sure the subdevice driver doesn't try
1259 	 * to allocate them again.
1260 	 */
1261 	ssdd->sd_pdata.num_regulators = 0;
1262 	ssdd->sd_pdata.regulators = NULL;
1263 	shd->board_info->platform_data = ssdd;
1264 
1265 	v4l2_clk_name_i2c(clk_name, sizeof(clk_name),
1266 			  shd->i2c_adapter_id, shd->board_info->addr);
1267 
1268 	icd->clk = v4l2_clk_register(&soc_camera_clk_ops, clk_name, icd);
1269 	if (IS_ERR(icd->clk)) {
1270 		ret = PTR_ERR(icd->clk);
1271 		goto eclkreg;
1272 	}
1273 
1274 	subdev = v4l2_i2c_new_subdev_board(&ici->v4l2_dev, adap,
1275 				shd->board_info, NULL);
1276 	if (!subdev) {
1277 		ret = -ENODEV;
1278 		goto ei2cnd;
1279 	}
1280 
1281 	client = v4l2_get_subdevdata(subdev);
1282 
1283 	/* Use to_i2c_client(dev) to recover the i2c client */
1284 	icd->control = &client->dev;
1285 
1286 	return 0;
1287 ei2cnd:
1288 	v4l2_clk_unregister(icd->clk);
1289 	icd->clk = NULL;
1290 eclkreg:
1291 	kfree(ssdd);
1292 ealloc:
1293 	i2c_put_adapter(adap);
1294 	return ret;
1295 }
1296 
soc_camera_i2c_free(struct soc_camera_device * icd)1297 static void soc_camera_i2c_free(struct soc_camera_device *icd)
1298 {
1299 	struct i2c_client *client =
1300 		to_i2c_client(to_soc_camera_control(icd));
1301 	struct i2c_adapter *adap;
1302 	struct soc_camera_subdev_desc *ssdd;
1303 
1304 	icd->control = NULL;
1305 	if (icd->sasc)
1306 		return;
1307 
1308 	adap = client->adapter;
1309 	ssdd = client->dev.platform_data;
1310 	v4l2_device_unregister_subdev(i2c_get_clientdata(client));
1311 	i2c_unregister_device(client);
1312 	i2c_put_adapter(adap);
1313 	kfree(ssdd);
1314 	v4l2_clk_unregister(icd->clk);
1315 	icd->clk = NULL;
1316 }
1317 
1318 /*
1319  * V4L2 asynchronous notifier callbacks. They are all called under a v4l2-async
1320  * internal global mutex, therefore cannot race against other asynchronous
1321  * events. Until notifier->complete() (soc_camera_async_complete()) is called,
1322  * the video device node is not registered and no V4L fops can occur. Unloading
1323  * of the host driver also calls a v4l2-async function, so also there we're
1324  * protected.
1325  */
soc_camera_async_bound(struct v4l2_async_notifier * notifier,struct v4l2_subdev * sd,struct v4l2_async_subdev * asd)1326 static int soc_camera_async_bound(struct v4l2_async_notifier *notifier,
1327 				  struct v4l2_subdev *sd,
1328 				  struct v4l2_async_subdev *asd)
1329 {
1330 	struct soc_camera_async_client *sasc = container_of(notifier,
1331 					struct soc_camera_async_client, notifier);
1332 	struct soc_camera_device *icd = platform_get_drvdata(sasc->pdev);
1333 
1334 	if (asd == sasc->sensor && !WARN_ON(icd->control)) {
1335 		struct i2c_client *client = v4l2_get_subdevdata(sd);
1336 
1337 		/*
1338 		 * Only now we get subdevice-specific information like
1339 		 * regulators, flags, callbacks, etc.
1340 		 */
1341 		if (client) {
1342 			struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1343 			struct soc_camera_subdev_desc *ssdd =
1344 				soc_camera_i2c_to_desc(client);
1345 			if (ssdd) {
1346 				memcpy(&sdesc->subdev_desc, ssdd,
1347 				       sizeof(sdesc->subdev_desc));
1348 				if (ssdd->reset)
1349 					ssdd->reset(&client->dev);
1350 			}
1351 
1352 			icd->control = &client->dev;
1353 		}
1354 	}
1355 
1356 	return 0;
1357 }
1358 
soc_camera_async_unbind(struct v4l2_async_notifier * notifier,struct v4l2_subdev * sd,struct v4l2_async_subdev * asd)1359 static void soc_camera_async_unbind(struct v4l2_async_notifier *notifier,
1360 				    struct v4l2_subdev *sd,
1361 				    struct v4l2_async_subdev *asd)
1362 {
1363 	struct soc_camera_async_client *sasc = container_of(notifier,
1364 					struct soc_camera_async_client, notifier);
1365 	struct soc_camera_device *icd = platform_get_drvdata(sasc->pdev);
1366 
1367 	icd->control = NULL;
1368 
1369 	if (icd->clk) {
1370 		v4l2_clk_unregister(icd->clk);
1371 		icd->clk = NULL;
1372 	}
1373 }
1374 
soc_camera_async_complete(struct v4l2_async_notifier * notifier)1375 static int soc_camera_async_complete(struct v4l2_async_notifier *notifier)
1376 {
1377 	struct soc_camera_async_client *sasc = container_of(notifier,
1378 					struct soc_camera_async_client, notifier);
1379 	struct soc_camera_device *icd = platform_get_drvdata(sasc->pdev);
1380 
1381 	if (to_soc_camera_control(icd)) {
1382 		struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
1383 		int ret;
1384 
1385 		mutex_lock(&list_lock);
1386 		ret = soc_camera_probe(ici, icd);
1387 		mutex_unlock(&list_lock);
1388 		if (ret < 0)
1389 			return ret;
1390 	}
1391 
1392 	return 0;
1393 }
1394 
1395 static const struct v4l2_async_notifier_operations soc_camera_async_ops = {
1396 	.bound = soc_camera_async_bound,
1397 	.unbind = soc_camera_async_unbind,
1398 	.complete = soc_camera_async_complete,
1399 };
1400 
scan_async_group(struct soc_camera_host * ici,struct v4l2_async_subdev ** asd,unsigned int size)1401 static int scan_async_group(struct soc_camera_host *ici,
1402 			    struct v4l2_async_subdev **asd, unsigned int size)
1403 {
1404 	struct soc_camera_async_subdev *sasd;
1405 	struct soc_camera_async_client *sasc;
1406 	struct soc_camera_device *icd;
1407 	struct soc_camera_desc sdesc = {.host_desc.bus_id = ici->nr,};
1408 	char clk_name[V4L2_CLK_NAME_SIZE];
1409 	unsigned int i;
1410 	int ret;
1411 
1412 	/* First look for a sensor */
1413 	for (i = 0; i < size; i++) {
1414 		sasd = container_of(asd[i], struct soc_camera_async_subdev, asd);
1415 		if (sasd->role == SOCAM_SUBDEV_DATA_SOURCE)
1416 			break;
1417 	}
1418 
1419 	if (i >= size || asd[i]->match_type != V4L2_ASYNC_MATCH_I2C) {
1420 		/* All useless */
1421 		dev_err(ici->v4l2_dev.dev, "No I2C data source found!\n");
1422 		return -ENODEV;
1423 	}
1424 
1425 	/* Or shall this be managed by the soc-camera device? */
1426 	sasc = devm_kzalloc(ici->v4l2_dev.dev, sizeof(*sasc), GFP_KERNEL);
1427 	if (!sasc)
1428 		return -ENOMEM;
1429 
1430 	/* HACK: just need a != NULL */
1431 	sdesc.host_desc.board_info = ERR_PTR(-ENODATA);
1432 
1433 	ret = soc_camera_dyn_pdev(&sdesc, sasc);
1434 	if (ret < 0)
1435 		goto eallocpdev;
1436 
1437 	sasc->sensor = &sasd->asd;
1438 
1439 	icd = soc_camera_add_pdev(sasc);
1440 	if (!icd) {
1441 		ret = -ENOMEM;
1442 		goto eaddpdev;
1443 	}
1444 
1445 	sasc->notifier.subdevs = asd;
1446 	sasc->notifier.num_subdevs = size;
1447 	sasc->notifier.ops = &soc_camera_async_ops;
1448 
1449 	icd->sasc = sasc;
1450 	icd->parent = ici->v4l2_dev.dev;
1451 
1452 	v4l2_clk_name_i2c(clk_name, sizeof(clk_name),
1453 			  sasd->asd.match.i2c.adapter_id,
1454 			  sasd->asd.match.i2c.address);
1455 
1456 	icd->clk = v4l2_clk_register(&soc_camera_clk_ops, clk_name, icd);
1457 	if (IS_ERR(icd->clk)) {
1458 		ret = PTR_ERR(icd->clk);
1459 		goto eclkreg;
1460 	}
1461 
1462 	ret = v4l2_async_notifier_register(&ici->v4l2_dev, &sasc->notifier);
1463 	if (!ret)
1464 		return 0;
1465 
1466 	v4l2_clk_unregister(icd->clk);
1467 eclkreg:
1468 	icd->clk = NULL;
1469 	platform_device_del(sasc->pdev);
1470 eaddpdev:
1471 	platform_device_put(sasc->pdev);
1472 eallocpdev:
1473 	devm_kfree(ici->v4l2_dev.dev, sasc);
1474 	dev_err(ici->v4l2_dev.dev, "group probe failed: %d\n", ret);
1475 
1476 	return ret;
1477 }
1478 
scan_async_host(struct soc_camera_host * ici)1479 static void scan_async_host(struct soc_camera_host *ici)
1480 {
1481 	struct v4l2_async_subdev **asd;
1482 	int j;
1483 
1484 	for (j = 0, asd = ici->asd; ici->asd_sizes[j]; j++) {
1485 		scan_async_group(ici, asd, ici->asd_sizes[j]);
1486 		asd += ici->asd_sizes[j];
1487 	}
1488 }
1489 #else
1490 #define soc_camera_i2c_init(icd, sdesc)	(-ENODEV)
1491 #define soc_camera_i2c_free(icd)	do {} while (0)
1492 #define scan_async_host(ici)		do {} while (0)
1493 #endif
1494 
1495 #ifdef CONFIG_OF
1496 
1497 struct soc_of_info {
1498 	struct soc_camera_async_subdev	sasd;
1499 	struct soc_camera_async_client	sasc;
1500 	struct v4l2_async_subdev	*subdev;
1501 };
1502 
soc_of_bind(struct soc_camera_host * ici,struct device_node * ep,struct device_node * remote)1503 static int soc_of_bind(struct soc_camera_host *ici,
1504 		       struct device_node *ep,
1505 		       struct device_node *remote)
1506 {
1507 	struct soc_camera_device *icd;
1508 	struct soc_camera_desc sdesc = {.host_desc.bus_id = ici->nr,};
1509 	struct soc_camera_async_client *sasc;
1510 	struct soc_of_info *info;
1511 	struct i2c_client *client;
1512 	char clk_name[V4L2_CLK_NAME_SIZE];
1513 	int ret;
1514 
1515 	/* allocate a new subdev and add match info to it */
1516 	info = devm_kzalloc(ici->v4l2_dev.dev, sizeof(struct soc_of_info),
1517 			    GFP_KERNEL);
1518 	if (!info)
1519 		return -ENOMEM;
1520 
1521 	info->sasd.asd.match.fwnode = of_fwnode_handle(remote);
1522 	info->sasd.asd.match_type = V4L2_ASYNC_MATCH_FWNODE;
1523 	info->subdev = &info->sasd.asd;
1524 
1525 	/* Or shall this be managed by the soc-camera device? */
1526 	sasc = &info->sasc;
1527 
1528 	/* HACK: just need a != NULL */
1529 	sdesc.host_desc.board_info = ERR_PTR(-ENODATA);
1530 
1531 	ret = soc_camera_dyn_pdev(&sdesc, sasc);
1532 	if (ret < 0)
1533 		goto eallocpdev;
1534 
1535 	sasc->sensor = &info->sasd.asd;
1536 
1537 	icd = soc_camera_add_pdev(sasc);
1538 	if (!icd) {
1539 		ret = -ENOMEM;
1540 		goto eaddpdev;
1541 	}
1542 
1543 	sasc->notifier.subdevs = &info->subdev;
1544 	sasc->notifier.num_subdevs = 1;
1545 	sasc->notifier.ops = &soc_camera_async_ops;
1546 
1547 	icd->sasc = sasc;
1548 	icd->parent = ici->v4l2_dev.dev;
1549 
1550 	client = of_find_i2c_device_by_node(remote);
1551 
1552 	if (client)
1553 		v4l2_clk_name_i2c(clk_name, sizeof(clk_name),
1554 				  client->adapter->nr, client->addr);
1555 	else
1556 		v4l2_clk_name_of(clk_name, sizeof(clk_name), remote);
1557 
1558 	icd->clk = v4l2_clk_register(&soc_camera_clk_ops, clk_name, icd);
1559 	if (IS_ERR(icd->clk)) {
1560 		ret = PTR_ERR(icd->clk);
1561 		goto eclkreg;
1562 	}
1563 
1564 	ret = v4l2_async_notifier_register(&ici->v4l2_dev, &sasc->notifier);
1565 	if (!ret)
1566 		return 0;
1567 
1568 	v4l2_clk_unregister(icd->clk);
1569 eclkreg:
1570 	icd->clk = NULL;
1571 	platform_device_del(sasc->pdev);
1572 eaddpdev:
1573 	platform_device_put(sasc->pdev);
1574 eallocpdev:
1575 	devm_kfree(ici->v4l2_dev.dev, info);
1576 	dev_err(ici->v4l2_dev.dev, "group probe failed: %d\n", ret);
1577 
1578 	return ret;
1579 }
1580 
scan_of_host(struct soc_camera_host * ici)1581 static void scan_of_host(struct soc_camera_host *ici)
1582 {
1583 	struct device *dev = ici->v4l2_dev.dev;
1584 	struct device_node *np = dev->of_node;
1585 	struct device_node *epn = NULL, *ren;
1586 	unsigned int i;
1587 
1588 	for (i = 0; ; i++) {
1589 		epn = of_graph_get_next_endpoint(np, epn);
1590 		if (!epn)
1591 			break;
1592 
1593 		ren = of_graph_get_remote_port(epn);
1594 		if (!ren) {
1595 			dev_notice(dev, "no remote for %pOF\n", epn);
1596 			continue;
1597 		}
1598 
1599 		/* so we now have a remote node to connect */
1600 		if (!i)
1601 			soc_of_bind(ici, epn, ren->parent);
1602 
1603 		of_node_put(ren);
1604 
1605 		if (i) {
1606 			dev_err(dev, "multiple subdevices aren't supported yet!\n");
1607 			break;
1608 		}
1609 	}
1610 
1611 	of_node_put(epn);
1612 }
1613 
1614 #else
scan_of_host(struct soc_camera_host * ici)1615 static inline void scan_of_host(struct soc_camera_host *ici) { }
1616 #endif
1617 
1618 /* Called during host-driver probe */
soc_camera_probe(struct soc_camera_host * ici,struct soc_camera_device * icd)1619 static int soc_camera_probe(struct soc_camera_host *ici,
1620 			    struct soc_camera_device *icd)
1621 {
1622 	struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1623 	struct soc_camera_host_desc *shd = &sdesc->host_desc;
1624 	struct device *control = NULL;
1625 	int ret;
1626 
1627 	dev_info(icd->pdev, "Probing %s\n", dev_name(icd->pdev));
1628 
1629 	/*
1630 	 * Currently the subdev with the largest number of controls (13) is
1631 	 * ov6550. So let's pick 16 as a hint for the control handler. Note
1632 	 * that this is a hint only: too large and you waste some memory, too
1633 	 * small and there is a (very) small performance hit when looking up
1634 	 * controls in the internal hash.
1635 	 */
1636 	ret = v4l2_ctrl_handler_init(&icd->ctrl_handler, 16);
1637 	if (ret < 0)
1638 		return ret;
1639 
1640 	/* Must have icd->vdev before registering the device */
1641 	ret = video_dev_create(icd);
1642 	if (ret < 0)
1643 		goto evdc;
1644 
1645 	/*
1646 	 * ..._video_start() will create a device node, video_register_device()
1647 	 * itself is protected against concurrent open() calls, but we also have
1648 	 * to protect our data also during client probing.
1649 	 */
1650 
1651 	/* Non-i2c cameras, e.g., soc_camera_platform, have no board_info */
1652 	if (shd->board_info) {
1653 		ret = soc_camera_i2c_init(icd, sdesc);
1654 		if (ret < 0 && ret != -EPROBE_DEFER)
1655 			goto eadd;
1656 	} else if (!shd->add_device || !shd->del_device) {
1657 		ret = -EINVAL;
1658 		goto eadd;
1659 	} else {
1660 		ret = soc_camera_clock_start(ici);
1661 		if (ret < 0)
1662 			goto eadd;
1663 
1664 		if (shd->module_name)
1665 			ret = request_module(shd->module_name);
1666 
1667 		ret = shd->add_device(icd);
1668 		if (ret < 0)
1669 			goto eadddev;
1670 
1671 		/*
1672 		 * FIXME: this is racy, have to use driver-binding notification,
1673 		 * when it is available
1674 		 */
1675 		control = to_soc_camera_control(icd);
1676 		if (!control || !control->driver || !dev_get_drvdata(control) ||
1677 		    !try_module_get(control->driver->owner)) {
1678 			shd->del_device(icd);
1679 			ret = -ENODEV;
1680 			goto enodrv;
1681 		}
1682 	}
1683 
1684 	mutex_lock(&ici->host_lock);
1685 	ret = soc_camera_probe_finish(icd);
1686 	mutex_unlock(&ici->host_lock);
1687 	if (ret < 0)
1688 		goto efinish;
1689 
1690 	return 0;
1691 
1692 efinish:
1693 	if (shd->board_info) {
1694 		soc_camera_i2c_free(icd);
1695 	} else {
1696 		shd->del_device(icd);
1697 		module_put(control->driver->owner);
1698 enodrv:
1699 eadddev:
1700 		soc_camera_clock_stop(ici);
1701 	}
1702 eadd:
1703 	if (icd->vdev) {
1704 		video_device_release(icd->vdev);
1705 		icd->vdev = NULL;
1706 	}
1707 evdc:
1708 	v4l2_ctrl_handler_free(&icd->ctrl_handler);
1709 	return ret;
1710 }
1711 
1712 /*
1713  * This is called on device_unregister, which only means we have to disconnect
1714  * from the host, but not remove ourselves from the device list. With
1715  * asynchronous client probing this can also be called without
1716  * soc_camera_probe_finish() having run. Careful with clean up.
1717  */
soc_camera_remove(struct soc_camera_device * icd)1718 static int soc_camera_remove(struct soc_camera_device *icd)
1719 {
1720 	struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1721 	struct video_device *vdev = icd->vdev;
1722 
1723 	v4l2_ctrl_handler_free(&icd->ctrl_handler);
1724 	if (vdev) {
1725 		video_unregister_device(vdev);
1726 		icd->vdev = NULL;
1727 	}
1728 
1729 	if (sdesc->host_desc.board_info) {
1730 		soc_camera_i2c_free(icd);
1731 	} else {
1732 		struct device *dev = to_soc_camera_control(icd);
1733 		struct device_driver *drv = dev ? dev->driver : NULL;
1734 		if (drv) {
1735 			sdesc->host_desc.del_device(icd);
1736 			module_put(drv->owner);
1737 		}
1738 	}
1739 
1740 	if (icd->num_user_formats)
1741 		soc_camera_free_user_formats(icd);
1742 
1743 	if (icd->clk) {
1744 		/* For the synchronous case */
1745 		v4l2_clk_unregister(icd->clk);
1746 		icd->clk = NULL;
1747 	}
1748 
1749 	if (icd->sasc)
1750 		platform_device_unregister(icd->sasc->pdev);
1751 
1752 	return 0;
1753 }
1754 
default_g_selection(struct soc_camera_device * icd,struct v4l2_selection * sel)1755 static int default_g_selection(struct soc_camera_device *icd,
1756 			       struct v4l2_selection *sel)
1757 {
1758 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1759 	struct v4l2_subdev_selection sdsel = {
1760 		.which = V4L2_SUBDEV_FORMAT_ACTIVE,
1761 		.target = sel->target,
1762 	};
1763 	int ret;
1764 
1765 	ret = v4l2_subdev_call(sd, pad, get_selection, NULL, &sdsel);
1766 	if (ret)
1767 		return ret;
1768 	sel->r = sdsel.r;
1769 	return 0;
1770 }
1771 
default_s_selection(struct soc_camera_device * icd,struct v4l2_selection * sel)1772 static int default_s_selection(struct soc_camera_device *icd,
1773 			       struct v4l2_selection *sel)
1774 {
1775 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1776 	struct v4l2_subdev_selection sdsel = {
1777 		.which = V4L2_SUBDEV_FORMAT_ACTIVE,
1778 		.target = sel->target,
1779 		.flags = sel->flags,
1780 		.r = sel->r,
1781 	};
1782 	int ret;
1783 
1784 	ret = v4l2_subdev_call(sd, pad, set_selection, NULL, &sdsel);
1785 	if (ret)
1786 		return ret;
1787 	sel->r = sdsel.r;
1788 	return 0;
1789 }
1790 
default_g_parm(struct soc_camera_device * icd,struct v4l2_streamparm * a)1791 static int default_g_parm(struct soc_camera_device *icd,
1792 			  struct v4l2_streamparm *a)
1793 {
1794 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1795 
1796 	return v4l2_g_parm_cap(icd->vdev, sd, a);
1797 }
1798 
default_s_parm(struct soc_camera_device * icd,struct v4l2_streamparm * a)1799 static int default_s_parm(struct soc_camera_device *icd,
1800 			  struct v4l2_streamparm *a)
1801 {
1802 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1803 
1804 	return v4l2_s_parm_cap(icd->vdev, sd, a);
1805 }
1806 
default_enum_framesizes(struct soc_camera_device * icd,struct v4l2_frmsizeenum * fsize)1807 static int default_enum_framesizes(struct soc_camera_device *icd,
1808 				   struct v4l2_frmsizeenum *fsize)
1809 {
1810 	int ret;
1811 	struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1812 	const struct soc_camera_format_xlate *xlate;
1813 	struct v4l2_subdev_frame_size_enum fse = {
1814 		.index = fsize->index,
1815 		.which = V4L2_SUBDEV_FORMAT_ACTIVE,
1816 	};
1817 
1818 	xlate = soc_camera_xlate_by_fourcc(icd, fsize->pixel_format);
1819 	if (!xlate)
1820 		return -EINVAL;
1821 	fse.code = xlate->code;
1822 
1823 	ret = v4l2_subdev_call(sd, pad, enum_frame_size, NULL, &fse);
1824 	if (ret < 0)
1825 		return ret;
1826 
1827 	if (fse.min_width == fse.max_width &&
1828 	    fse.min_height == fse.max_height) {
1829 		fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
1830 		fsize->discrete.width = fse.min_width;
1831 		fsize->discrete.height = fse.min_height;
1832 		return 0;
1833 	}
1834 	fsize->type = V4L2_FRMSIZE_TYPE_CONTINUOUS;
1835 	fsize->stepwise.min_width = fse.min_width;
1836 	fsize->stepwise.max_width = fse.max_width;
1837 	fsize->stepwise.min_height = fse.min_height;
1838 	fsize->stepwise.max_height = fse.max_height;
1839 	fsize->stepwise.step_width = 1;
1840 	fsize->stepwise.step_height = 1;
1841 	return 0;
1842 }
1843 
soc_camera_host_register(struct soc_camera_host * ici)1844 int soc_camera_host_register(struct soc_camera_host *ici)
1845 {
1846 	struct soc_camera_host *ix;
1847 	int ret;
1848 
1849 	if (!ici || !ici->ops ||
1850 	    !ici->ops->try_fmt ||
1851 	    !ici->ops->set_fmt ||
1852 	    !ici->ops->set_bus_param ||
1853 	    !ici->ops->querycap ||
1854 	    !ici->ops->init_videobuf2 ||
1855 	    !ici->ops->poll ||
1856 	    !ici->v4l2_dev.dev)
1857 		return -EINVAL;
1858 
1859 	if (!ici->ops->set_selection)
1860 		ici->ops->set_selection = default_s_selection;
1861 	if (!ici->ops->get_selection)
1862 		ici->ops->get_selection = default_g_selection;
1863 	if (!ici->ops->set_parm)
1864 		ici->ops->set_parm = default_s_parm;
1865 	if (!ici->ops->get_parm)
1866 		ici->ops->get_parm = default_g_parm;
1867 	if (!ici->ops->enum_framesizes)
1868 		ici->ops->enum_framesizes = default_enum_framesizes;
1869 
1870 	mutex_lock(&list_lock);
1871 	list_for_each_entry(ix, &hosts, list) {
1872 		if (ix->nr == ici->nr) {
1873 			ret = -EBUSY;
1874 			goto edevreg;
1875 		}
1876 	}
1877 
1878 	ret = v4l2_device_register(ici->v4l2_dev.dev, &ici->v4l2_dev);
1879 	if (ret < 0)
1880 		goto edevreg;
1881 
1882 	list_add_tail(&ici->list, &hosts);
1883 	mutex_unlock(&list_lock);
1884 
1885 	mutex_init(&ici->host_lock);
1886 	mutex_init(&ici->clk_lock);
1887 
1888 	if (ici->v4l2_dev.dev->of_node)
1889 		scan_of_host(ici);
1890 	else if (ici->asd_sizes)
1891 		/*
1892 		 * No OF, host with a list of subdevices. Don't try to mix
1893 		 * modes by initialising some groups statically and some
1894 		 * dynamically!
1895 		 */
1896 		scan_async_host(ici);
1897 	else
1898 		/* Legacy: static platform devices from board data */
1899 		scan_add_host(ici);
1900 
1901 	return 0;
1902 
1903 edevreg:
1904 	mutex_unlock(&list_lock);
1905 	return ret;
1906 }
1907 EXPORT_SYMBOL(soc_camera_host_register);
1908 
1909 /* Unregister all clients! */
soc_camera_host_unregister(struct soc_camera_host * ici)1910 void soc_camera_host_unregister(struct soc_camera_host *ici)
1911 {
1912 	struct soc_camera_device *icd, *tmp;
1913 	struct soc_camera_async_client *sasc;
1914 	LIST_HEAD(notifiers);
1915 
1916 	mutex_lock(&list_lock);
1917 	list_del(&ici->list);
1918 	list_for_each_entry(icd, &devices, list)
1919 		if (icd->iface == ici->nr && icd->sasc) {
1920 			/* as long as we hold the device, sasc won't be freed */
1921 			get_device(icd->pdev);
1922 			list_add(&icd->sasc->list, &notifiers);
1923 		}
1924 	mutex_unlock(&list_lock);
1925 
1926 	list_for_each_entry(sasc, &notifiers, list) {
1927 		/* Must call unlocked to avoid AB-BA dead-lock */
1928 		v4l2_async_notifier_unregister(&sasc->notifier);
1929 		put_device(&sasc->pdev->dev);
1930 	}
1931 
1932 	mutex_lock(&list_lock);
1933 
1934 	list_for_each_entry_safe(icd, tmp, &devices, list)
1935 		if (icd->iface == ici->nr)
1936 			soc_camera_remove(icd);
1937 
1938 	mutex_unlock(&list_lock);
1939 
1940 	v4l2_device_unregister(&ici->v4l2_dev);
1941 }
1942 EXPORT_SYMBOL(soc_camera_host_unregister);
1943 
1944 /* Image capture device */
soc_camera_device_register(struct soc_camera_device * icd)1945 static int soc_camera_device_register(struct soc_camera_device *icd)
1946 {
1947 	struct soc_camera_device *ix;
1948 	int num = -1, i;
1949 
1950 	mutex_lock(&list_lock);
1951 	for (i = 0; i < 256 && num < 0; i++) {
1952 		num = i;
1953 		/* Check if this index is available on this interface */
1954 		list_for_each_entry(ix, &devices, list) {
1955 			if (ix->iface == icd->iface && ix->devnum == i) {
1956 				num = -1;
1957 				break;
1958 			}
1959 		}
1960 	}
1961 
1962 	if (num < 0) {
1963 		/*
1964 		 * ok, we have 256 cameras on this host...
1965 		 * man, stay reasonable...
1966 		 */
1967 		mutex_unlock(&list_lock);
1968 		return -ENOMEM;
1969 	}
1970 
1971 	icd->devnum		= num;
1972 	icd->use_count		= 0;
1973 	icd->host_priv		= NULL;
1974 
1975 	/*
1976 	 * Dynamically allocated devices set the bit earlier, but it doesn't hurt setting
1977 	 * it again
1978 	 */
1979 	i = to_platform_device(icd->pdev)->id;
1980 	if (i < 0)
1981 		/* One static (legacy) soc-camera platform device */
1982 		i = 0;
1983 	if (i >= MAP_MAX_NUM) {
1984 		mutex_unlock(&list_lock);
1985 		return -EBUSY;
1986 	}
1987 	set_bit(i, device_map);
1988 	list_add_tail(&icd->list, &devices);
1989 	mutex_unlock(&list_lock);
1990 
1991 	return 0;
1992 }
1993 
1994 static const struct v4l2_ioctl_ops soc_camera_ioctl_ops = {
1995 	.vidioc_querycap	 = soc_camera_querycap,
1996 	.vidioc_try_fmt_vid_cap  = soc_camera_try_fmt_vid_cap,
1997 	.vidioc_g_fmt_vid_cap    = soc_camera_g_fmt_vid_cap,
1998 	.vidioc_s_fmt_vid_cap    = soc_camera_s_fmt_vid_cap,
1999 	.vidioc_enum_fmt_vid_cap = soc_camera_enum_fmt_vid_cap,
2000 	.vidioc_enum_input	 = soc_camera_enum_input,
2001 	.vidioc_g_input		 = soc_camera_g_input,
2002 	.vidioc_s_input		 = soc_camera_s_input,
2003 	.vidioc_s_std		 = soc_camera_s_std,
2004 	.vidioc_g_std		 = soc_camera_g_std,
2005 	.vidioc_enum_framesizes  = soc_camera_enum_framesizes,
2006 	.vidioc_reqbufs		 = soc_camera_reqbufs,
2007 	.vidioc_querybuf	 = soc_camera_querybuf,
2008 	.vidioc_qbuf		 = soc_camera_qbuf,
2009 	.vidioc_dqbuf		 = soc_camera_dqbuf,
2010 	.vidioc_create_bufs	 = soc_camera_create_bufs,
2011 	.vidioc_prepare_buf	 = soc_camera_prepare_buf,
2012 	.vidioc_expbuf		 = soc_camera_expbuf,
2013 	.vidioc_streamon	 = soc_camera_streamon,
2014 	.vidioc_streamoff	 = soc_camera_streamoff,
2015 	.vidioc_g_selection	 = soc_camera_g_selection,
2016 	.vidioc_s_selection	 = soc_camera_s_selection,
2017 	.vidioc_g_parm		 = soc_camera_g_parm,
2018 	.vidioc_s_parm		 = soc_camera_s_parm,
2019 };
2020 
video_dev_create(struct soc_camera_device * icd)2021 static int video_dev_create(struct soc_camera_device *icd)
2022 {
2023 	struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
2024 	struct video_device *vdev = video_device_alloc();
2025 
2026 	if (!vdev)
2027 		return -ENOMEM;
2028 
2029 	strlcpy(vdev->name, ici->drv_name, sizeof(vdev->name));
2030 
2031 	vdev->v4l2_dev		= &ici->v4l2_dev;
2032 	vdev->fops		= &soc_camera_fops;
2033 	vdev->ioctl_ops		= &soc_camera_ioctl_ops;
2034 	vdev->release		= video_device_release;
2035 	vdev->ctrl_handler	= &icd->ctrl_handler;
2036 	vdev->lock		= &ici->host_lock;
2037 
2038 	icd->vdev = vdev;
2039 
2040 	return 0;
2041 }
2042 
2043 /*
2044  * Called from soc_camera_probe() above with .host_lock held
2045  */
soc_camera_video_start(struct soc_camera_device * icd)2046 static int soc_camera_video_start(struct soc_camera_device *icd)
2047 {
2048 	const struct device_type *type = icd->vdev->dev.type;
2049 	int ret;
2050 
2051 	if (!icd->parent)
2052 		return -ENODEV;
2053 
2054 	video_set_drvdata(icd->vdev, icd);
2055 	if (icd->vdev->tvnorms == 0) {
2056 		/* disable the STD API if there are no tvnorms defined */
2057 		v4l2_disable_ioctl(icd->vdev, VIDIOC_G_STD);
2058 		v4l2_disable_ioctl(icd->vdev, VIDIOC_S_STD);
2059 		v4l2_disable_ioctl(icd->vdev, VIDIOC_ENUMSTD);
2060 	}
2061 	ret = video_register_device(icd->vdev, VFL_TYPE_GRABBER, -1);
2062 	if (ret < 0) {
2063 		dev_err(icd->pdev, "video_register_device failed: %d\n", ret);
2064 		return ret;
2065 	}
2066 
2067 	/* Restore device type, possibly set by the subdevice driver */
2068 	icd->vdev->dev.type = type;
2069 
2070 	return 0;
2071 }
2072 
soc_camera_pdrv_probe(struct platform_device * pdev)2073 static int soc_camera_pdrv_probe(struct platform_device *pdev)
2074 {
2075 	struct soc_camera_desc *sdesc = pdev->dev.platform_data;
2076 	struct soc_camera_subdev_desc *ssdd = &sdesc->subdev_desc;
2077 	struct soc_camera_device *icd;
2078 	int ret;
2079 
2080 	if (!sdesc)
2081 		return -EINVAL;
2082 
2083 	icd = devm_kzalloc(&pdev->dev, sizeof(*icd), GFP_KERNEL);
2084 	if (!icd)
2085 		return -ENOMEM;
2086 
2087 	/*
2088 	 * In the asynchronous case ssdd->num_regulators == 0 yet, so, the below
2089 	 * regulator allocation is a dummy. They are actually requested by the
2090 	 * subdevice driver, using soc_camera_power_init(). Also note, that in
2091 	 * that case regulators are attached to the I2C device and not to the
2092 	 * camera platform device.
2093 	 */
2094 	ret = devm_regulator_bulk_get(&pdev->dev, ssdd->sd_pdata.num_regulators,
2095 				      ssdd->sd_pdata.regulators);
2096 	if (ret < 0)
2097 		return ret;
2098 
2099 	icd->iface = sdesc->host_desc.bus_id;
2100 	icd->sdesc = sdesc;
2101 	icd->pdev = &pdev->dev;
2102 	platform_set_drvdata(pdev, icd);
2103 
2104 	icd->user_width		= DEFAULT_WIDTH;
2105 	icd->user_height	= DEFAULT_HEIGHT;
2106 
2107 	return soc_camera_device_register(icd);
2108 }
2109 
2110 /*
2111  * Only called on rmmod for each platform device, since they are not
2112  * hot-pluggable. Now we know, that all our users - hosts and devices have
2113  * been unloaded already
2114  */
soc_camera_pdrv_remove(struct platform_device * pdev)2115 static int soc_camera_pdrv_remove(struct platform_device *pdev)
2116 {
2117 	struct soc_camera_device *icd = platform_get_drvdata(pdev);
2118 	int i;
2119 
2120 	if (!icd)
2121 		return -EINVAL;
2122 
2123 	i = pdev->id;
2124 	if (i < 0)
2125 		i = 0;
2126 
2127 	/*
2128 	 * In synchronous mode with static platform devices this is called in a
2129 	 * loop from drivers/base/dd.c::driver_detach(), no parallel execution,
2130 	 * no need to lock. In asynchronous case the caller -
2131 	 * soc_camera_host_unregister() - already holds the lock
2132 	 */
2133 	if (test_bit(i, device_map)) {
2134 		clear_bit(i, device_map);
2135 		list_del(&icd->list);
2136 	}
2137 
2138 	return 0;
2139 }
2140 
2141 static struct platform_driver __refdata soc_camera_pdrv = {
2142 	.probe = soc_camera_pdrv_probe,
2143 	.remove  = soc_camera_pdrv_remove,
2144 	.driver  = {
2145 		.name	= "soc-camera-pdrv",
2146 	},
2147 };
2148 
2149 module_platform_driver(soc_camera_pdrv);
2150 
2151 MODULE_DESCRIPTION("Image capture bus driver");
2152 MODULE_AUTHOR("Guennadi Liakhovetski <kernel@pengutronix.de>");
2153 MODULE_LICENSE("GPL");
2154 MODULE_ALIAS("platform:soc-camera-pdrv");
2155